ClassesClasses | | Operators

draw_xld_modT_draw_xld_modDrawXldModDrawXldMod (Operator)


draw_xld_modT_draw_xld_modDrawXldModDrawXldMod — Interactive modification of a contour.


draw_xld_mod(ContIn : ContOut : WindowHandle, Rotate, Move, Scale, KeepRatio, Edit : )

Herror T_draw_xld_mod(const Hobject ContIn, Hobject* ContOut, const Htuple WindowHandle, const Htuple Rotate, const Htuple Move, const Htuple Scale, const Htuple KeepRatio, const Htuple Edit)

void DrawXldMod(const HObject& ContIn, HObject* ContOut, const HTuple& WindowHandle, const HTuple& Rotate, const HTuple& Move, const HTuple& Scale, const HTuple& KeepRatio, const HTuple& Edit)

HXLDCont HXLDCont::DrawXldMod(const HWindow& WindowHandle, const HString& Rotate, const HString& Move, const HString& Scale, const HString& KeepRatio, const HString& Edit) const

HXLDCont HXLDCont::DrawXldMod(const HWindow& WindowHandle, const char* Rotate, const char* Move, const char* Scale, const char* KeepRatio, const char* Edit) const

HXLDCont HWindow::DrawXldMod(const HXLDCont& ContIn, const HString& Rotate, const HString& Move, const HString& Scale, const HString& KeepRatio, const HString& Edit) const

HXLDCont HWindow::DrawXldMod(const HXLDCont& ContIn, const char* Rotate, const char* Move, const char* Scale, const char* KeepRatio, const char* Edit) const

static void HOperatorSet.DrawXldMod(HObject contIn, out HObject contOut, HTuple windowHandle, HTuple rotate, HTuple move, HTuple scale, HTuple keepRatio, HTuple edit)

HXLDCont HXLDCont.DrawXldMod(HWindow windowHandle, string rotate, string move, string scale, string keepRatio, string edit)

HXLDCont HWindow.DrawXldMod(HXLDCont contIn, string rotate, string move, string scale, string keepRatio, string edit)


draw_xld_moddraw_xld_modDrawXldModDrawXldModDrawXldMod returns a contour, which has been interactively modified by the user in the window.

You can modify the contour in two ways: by editing the contour itself, e.g., by inserting or moving contour points, or by transforming the contour as a whole, e.g., by rotating moving or scaling it. Note that you can only edit a contour if EditEditEditEditedit is set to 'true'"true""true""true""true". Similarly, you can only rotate, move or scale it if RotateRotateRotateRotaterotate, MoveMoveMoveMovemove, and ScaleScaleScaleScalescale, respectively, are set to 'true'"true""true""true""true".

draw_xld_moddraw_xld_modDrawXldModDrawXldModDrawXldMod starts in the transformation mode. In this mode, the contour is displayed together with 3 symbols: a cross in the middle and an arrow to the right if RotateRotateRotateRotaterotate is set to 'true'"true""true""true""true", and a double-headed arrow to the upper right if ScaleScaleScaleScalescale is set to 'true'"true""true""true""true". To switch into the edit mode, press the Shift key; by pressing it again, you can switch back into the transformation mode.

Transformation Mode

Edit Mode In this mode, the contour is display together with 5 pick points, which are located in the middle and at the corners of the surrounding rectangle. If the contour is closed, the pick points are displayed as squares, otherwise shaped like a 'u'. By clicking on a pick point, you can close an open contour and vice versa. Depending on the state of the contour, you can perform different modifications. Open contours (pick points shaped like a 'u')

Closed contours (square pick points)

Pressing the right mouse button terminates the procedure. On macOS draw_xld_moddraw_xld_modDrawXldModDrawXldModDrawXldMod can also be terminated by pressing the escape key.


If used in a buffer window, mouse events have to be supplied by the application, while the draw operator must be run in another thread.

Execution Information


ContInContInContInContIncontIn (input_object)  xld_cont objectHXLDContHXLDContHobject

Input contour.

ContOutContOutContOutContOutcontOut (output_object)  xld_cont objectHXLDContHXLDContHobject *

Modified contour.

WindowHandleWindowHandleWindowHandleWindowHandlewindowHandle (input_control)  window HWindow, HTupleHTupleHtuple (handle) (IntPtr) (HHandle) (handle)

Window handle.

RotateRotateRotateRotaterotate (input_control)  string HTupleHTupleHtuple (string) (string) (HString) (char*)

Enable rotation?

Default value: 'true' "true" "true" "true" "true"

List of values: 'false'"false""false""false""false", 'true'"true""true""true""true"

MoveMoveMoveMovemove (input_control)  string HTupleHTupleHtuple (string) (string) (HString) (char*)

Enable moving?

Default value: 'true' "true" "true" "true" "true"

List of values: 'false'"false""false""false""false", 'true'"true""true""true""true"

ScaleScaleScaleScalescale (input_control)  string HTupleHTupleHtuple (string) (string) (HString) (char*)

Enable scaling?

Default value: 'true' "true" "true" "true" "true"

List of values: 'false'"false""false""false""false", 'true'"true""true""true""true"

KeepRatioKeepRatioKeepRatioKeepRatiokeepRatio (input_control)  string HTupleHTupleHtuple (string) (string) (HString) (char*)

Keep ratio while scaling?

Default value: 'true' "true" "true" "true" "true"

List of values: 'false'"false""false""false""false", 'true'"true""true""true""true"

EditEditEditEditedit (input_control)  string HTupleHTupleHtuple (string) (string) (HString) (char*)

Enable editing?

Default value: 'true' "true" "true" "true" "true"

List of values: 'false'"false""false""false""false", 'true'"true""true""true""true"


draw_xld_moddraw_xld_modDrawXldModDrawXldModDrawXldMod returns 2 (H_MSG_TRUE), if the window is valid and the needed drawing mode (see set_insertset_insertSetInsertSetInsertSetInsert) is available. If necessary, an exception is raised.

Possible Predecessors


Possible Successors

reduce_domainreduce_domainReduceDomainReduceDomainReduceDomain, disp_regiondisp_regionDispRegionDispRegionDispRegion, set_coloredset_coloredSetColoredSetColoredSetColored, set_line_widthset_line_widthSetLineWidthSetLineWidthSetLineWidth, set_drawset_drawSetDrawSetDrawSetDraw, set_insertset_insertSetInsertSetInsertSetInsert


draw_rectangle2draw_rectangle2DrawRectangle2DrawRectangle2DrawRectangle2, draw_rectangle1draw_rectangle1DrawRectangle1DrawRectangle1DrawRectangle1, draw_rectangle2draw_rectangle2DrawRectangle2DrawRectangle2DrawRectangle2, draw_regiondraw_regionDrawRegionDrawRegionDrawRegion

See also

gen_rectangle2gen_rectangle2GenRectangle2GenRectangle2GenRectangle2, draw_circledraw_circleDrawCircleDrawCircleDrawCircle, draw_ellipsedraw_ellipseDrawEllipseDrawEllipseDrawEllipse, set_insertset_insertSetInsertSetInsertSetInsert



ClassesClasses | | Operators