ClassesClassesClassesClasses | | | | Operators

new_extern_windownew_extern_windowNewExternWindownew_extern_windowNewExternWindowNewExternWindow (Operator)

Name

new_extern_windownew_extern_windowNewExternWindownew_extern_windowNewExternWindowNewExternWindow — Create a virtual graphics window under Windows.

Signature

new_extern_window( : : WINHWnd, Row, Column, Width, Height : WindowHandle)

Herror new_extern_window(const Hlong WINHWnd, const Hlong Row, const Hlong Column, const Hlong Width, const Hlong Height, Hlong* WindowHandle)

Herror T_new_extern_window(const Htuple WINHWnd, const Htuple Row, const Htuple Column, const Htuple Width, const Htuple Height, Htuple* WindowHandle)

Herror new_extern_window(const HTuple& WINHWnd, const HTuple& Row, const HTuple& Column, const HTuple& Width, const HTuple& Height, Hlong* WindowHandle)

Hlong HWindow::NewExternWindow(const HTuple& WINHWnd, const HTuple& Row, const HTuple& Column, const HTuple& Width, const HTuple& Height) const

void NewExternWindow(const HTuple& WINHWnd, const HTuple& Row, const HTuple& Column, const HTuple& Width, const HTuple& Height, HTuple* WindowHandle)

void HWindow::NewExternWindow(void* WINHWnd, Hlong Row, Hlong Column, Hlong Width, Hlong Height)

void HOperatorSetX.NewExternWindow(
[in] VARIANT WINHWnd, [in] VARIANT Row, [in] VARIANT Column, [in] VARIANT Width, [in] VARIANT Height, [out] VARIANT* WindowHandle)

void HWindowX.NewExternWindow(
[in] Hlong WINHWnd, [in] Hlong Row, [in] Hlong Column, [in] Hlong Width, [in] Hlong Height)

static void HOperatorSet.NewExternWindow(HTuple WINHWnd, HTuple row, HTuple column, HTuple width, HTuple height, out HTuple windowHandle)

void HWindow.NewExternWindow(IntPtr WINHWnd, int row, int column, int width, int height)

Description

new_extern_windownew_extern_windowNewExternWindownew_extern_windowNewExternWindowNewExternWindow opens a new virtual window. Note that this only works on Windows systems and drawing objects are not supported.

Virtual means that a new window will not be created, but the window whose window handle is given in the parameter WINHWndWINHWndWINHWndWINHWndWINHWndWINHWnd is used to perform output of gray value data, regions, graphics as well as to perform textual output.

All operators that allow the user to define graphical primitives through mouse interactions, like for example draw_rectangle1, do not work on external windows. The following operators can be used:

You may query current set values by calling operators like get_shapeget_shapeGetShapeget_shapeGetShapeGetShape. As some parameters are specified through the hardware (Resolution/Colors), you may query current available resources by calling operators like query_colorquery_colorQueryColorquery_colorQueryColorQueryColor.

The parameter WINHWndWINHWndWINHWndWINHWndWINHWndWINHWnd is used to pass the window handle of the window in which output should be done.

The origin of the coordinate system of the window resides in the upper left corner (coordinates: (0,0)). The row index grows downward (maximum: HeightHeightHeightHeightHeightheight-1), the column index grows to the right (maximal: WidthWidthWidthWidthWidthwidth-1).

You may use the value -1 for parameters WidthWidthWidthWidthWidthwidth and HeightHeightHeightHeightHeightheight. This means, that the corresponding value is chosen automatically. In particular, this is important if the aspect ratio of the pixels is not 1.0 (see set_systemset_systemSetSystemset_systemSetSystemSetSystem). If one of the two parameters is set to -1, it will be chosen through the size which results out of the aspect ratio of the pixels. If both parameters are set to -1, they will be set to the current image format.

The position and size of a window may change during runtime of a program, e.g., through external influences (window manager). With the operator set_window_extentsset_window_extentsSetWindowExtentsset_window_extentsSetWindowExtentsSetWindowExtents, you can change the size of the (external) widow via the program. Note that set_window_extentsset_window_extentsSetWindowExtentsset_window_extentsSetWindowExtentsSetWindowExtents offers to change the position as well, but you cannot change the position of an external window under Windows.

Opening a window causes the assignment of a default font. It is used in connection with operators like write_stringwrite_stringWriteStringwrite_stringWriteStringWriteString and you may change it by performing set_fontset_fontSetFontset_fontSetFontSetFont after calling open_windowopen_windowOpenWindowopen_windowOpenWindowOpenWindow. On the other hand, you have the possibility to specify a default font by calling set_system(::'default_font',<Fontname>:)set_system("default_font",<Fontname>)SetSystem("default_font",<Fontname>)set_system("default_font",<Fontname>)SetSystem("default_font",<Fontname>)SetSystem("default_font",<Fontname>) before opening a window (and all following windows; see also query_fontquery_fontQueryFontquery_fontQueryFontQueryFont).

You may set the color of graphics and font, which is used for output operators like disp_regiondisp_regionDispRegiondisp_regionDispRegionDispRegion or disp_circledisp_circleDispCircledisp_circleDispCircleDispCircle, by calling set_rgbset_rgbSetRgbset_rgbSetRgbSetRgb, set_hsiset_hsiSetHsiset_hsiSetHsiSetHsi or set_grayset_graySetGrayset_graySetGraySetGray. Calling set_insertset_insertSetInsertset_insertSetInsertSetInsert specifies how graphics is combined with the content of the image repeat memory. Thereto you may achieve by calling, e.g., set_insertset_insertSetInsertset_insertSetInsertSetInsert(::'not':) to eliminate the font after writing text twice at the same position.

The content of the window is not saved, if other windows overlap the window. This must be done in the program code that handles the window in the calling program.

For graphical output (disp_imagedisp_imageDispImagedisp_imageDispImageDispImage,disp_regiondisp_regionDispRegiondisp_regionDispRegionDispRegion, etc.) you may adjust the window by calling the operator set_partset_partSetPartset_partSetPartSetPart in order to represent a logical clipping of the image format. In particular this implies that only this part (appropriately scaled) of images and regions is displayed. Before you close your window, you have to close the HALCON-window.

Attention

Note that parameters as RowRowRowRowRowrow, ColumnColumnColumnColumnColumncolumn, WidthWidthWidthWidthWidthwidth and HeightHeightHeightHeightHeightheight are constrained through the output device, i.e., the size of the Windows NT desktop. Furthermore, be aware that all operators that allow the user to define graphical primitives through mouse interactions, like for example draw_rectangle1, do not work on external windows.

Parallelization

This operator returns a handle. Note that the state of an instance of this handle type may be changed by specific operators even though the handle is used as an input parameter by those operators.

Parameters

WINHWndWINHWndWINHWndWINHWndWINHWndWINHWnd (input_control)  pointer HTupleHTupleHTupleVARIANTHtuple (integer) (IntPtr) (Hlong) (Hlong) (Hlong) (Hlong)

Windows window handle of a previously created window.

Restriction: WINHWnd != 0

RowRowRowRowRowrow (input_control)  rectangle.origin.y HTupleHTupleHTupleVARIANTHtuple (integer) (int / long) (Hlong) (Hlong) (Hlong) (Hlong)

Row coordinate of upper left corner.

Default value: 0

Restriction: Row >= 0

ColumnColumnColumnColumnColumncolumn (input_control)  rectangle.origin.x HTupleHTupleHTupleVARIANTHtuple (integer) (int / long) (Hlong) (Hlong) (Hlong) (Hlong)

Column coordinate of upper left corner.

Default value: 0

Restriction: Column >= 0

WidthWidthWidthWidthWidthwidth (input_control)  rectangle.extent.x HTupleHTupleHTupleVARIANTHtuple (integer) (int / long) (Hlong) (Hlong) (Hlong) (Hlong)

Width of the window.

Default value: 512

Restriction: Width > 0 || Width == -1

HeightHeightHeightHeightHeightheight (input_control)  rectangle.extent.y HTupleHTupleHTupleVARIANTHtuple (integer) (int / long) (Hlong) (Hlong) (Hlong) (Hlong)

Height of the window.

Default value: 512

Restriction: Height > 0 || Height == -1

WindowHandleWindowHandleWindowHandleWindowHandleWindowHandlewindowHandle (output_control)  window HWindow, HTupleHTupleHTupleHWindowX, VARIANTHtuple (integer) (IntPtr) (Hlong) (Hlong) (Hlong) (Hlong)

Window handle.

Example (C++ (HALCON 5.0-10.0))

// Needs to be embedded into an application framework,
// see examples/cpp/mfc/MatchingExtWin.

Result

If the values of the specified parameters are correct new_extern_windownew_extern_windowNewExternWindownew_extern_windowNewExternWindowNewExternWindow returns 2 (H_MSG_TRUE). If necessary, an exception is raised.

Possible Predecessors

reset_obj_dbreset_obj_dbResetObjDbreset_obj_dbResetObjDbResetObjDb

Possible Successors

set_colorset_colorSetColorset_colorSetColorSetColor, query_window_typequery_window_typeQueryWindowTypequery_window_typeQueryWindowTypeQueryWindowType, get_window_typeget_window_typeGetWindowTypeget_window_typeGetWindowTypeGetWindowType, set_window_typeset_window_typeSetWindowTypeset_window_typeSetWindowTypeSetWindowType, get_mpositionget_mpositionGetMpositionget_mpositionGetMpositionGetMposition, set_tpositionset_tpositionSetTpositionset_tpositionSetTpositionSetTposition, set_tshapeset_tshapeSetTshapeset_tshapeSetTshapeSetTshape, set_window_extentsset_window_extentsSetWindowExtentsset_window_extentsSetWindowExtentsSetWindowExtents, get_window_extentsget_window_extentsGetWindowExtentsget_window_extentsGetWindowExtentsGetWindowExtents, query_colorquery_colorQueryColorquery_colorQueryColorQueryColor, set_checkset_checkSetCheckset_checkSetCheckSetCheck, set_systemset_systemSetSystemset_systemSetSystemSetSystem

Alternatives

open_windowopen_windowOpenWindowopen_windowOpenWindowOpenWindow

See also

open_windowopen_windowOpenWindowopen_windowOpenWindowOpenWindow, disp_regiondisp_regionDispRegiondisp_regionDispRegionDispRegion, disp_imagedisp_imageDispImagedisp_imageDispImageDispImage, disp_colordisp_colorDispColordisp_colorDispColorDispColor, set_lutset_lutSetLutset_lutSetLutSetLut, query_colorquery_colorQueryColorquery_colorQueryColorQueryColor, set_colorset_colorSetColorset_colorSetColorSetColor, set_rgbset_rgbSetRgbset_rgbSetRgbSetRgb, set_hsiset_hsiSetHsiset_hsiSetHsiSetHsi, set_pixelset_pixelSetPixelset_pixelSetPixelSetPixel, set_grayset_graySetGrayset_graySetGraySetGray, set_partset_partSetPartset_partSetPartSetPart, set_part_styleset_part_styleSetPartStyleset_part_styleSetPartStyleSetPartStyle, query_window_typequery_window_typeQueryWindowTypequery_window_typeQueryWindowTypeQueryWindowType, get_window_typeget_window_typeGetWindowTypeget_window_typeGetWindowTypeGetWindowType, set_window_typeset_window_typeSetWindowTypeset_window_typeSetWindowTypeSetWindowType, get_mpositionget_mpositionGetMpositionget_mpositionGetMpositionGetMposition, set_tpositionset_tpositionSetTpositionset_tpositionSetTpositionSetTposition, set_window_extentsset_window_extentsSetWindowExtentsset_window_extentsSetWindowExtentsSetWindowExtents, get_window_extentsget_window_extentsGetWindowExtentsget_window_extentsGetWindowExtentsGetWindowExtents, set_window_attrset_window_attrSetWindowAttrset_window_attrSetWindowAttrSetWindowAttr, set_checkset_checkSetCheckset_checkSetCheckSetCheck, set_systemset_systemSetSystemset_systemSetSystemSetSystem

Module

Foundation


ClassesClassesClassesClasses | | | | Operators