draw_xld_modT_draw_xld_modDrawXldModDrawXldModdraw_xld_mod (Operator)
Name
draw_xld_modT_draw_xld_modDrawXldModDrawXldModdraw_xld_mod — Interactive modification of a contour.
Signature
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 HXLDCont::DrawXldMod(const HWindow& WindowHandle, const wchar_t* Rotate, const wchar_t* Move, const wchar_t* Scale, const wchar_t* KeepRatio, const wchar_t* Edit) const
(Windows only)
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
HXLDCont HWindow::DrawXldMod(const HXLDCont& ContIn, const wchar_t* Rotate, const wchar_t* Move, const wchar_t* Scale, const wchar_t* KeepRatio, const wchar_t* Edit) const
(Windows only)
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)
Description
draw_xld_moddraw_xld_modDrawXldModDrawXldModDrawXldModdraw_xld_mod 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 EditEditEditEditeditedit is set to 'true'"true""true""true""true""true".
Similarly, you can only rotate, move or scale it if RotateRotateRotateRotaterotaterotate,
MoveMoveMoveMovemovemove, and ScaleScaleScaleScalescalescale, respectively, are set to 'true'"true""true""true""true""true".
draw_xld_moddraw_xld_modDrawXldModDrawXldModDrawXldModdraw_xld_mod 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 RotateRotateRotateRotaterotaterotate is set to 'true'"true""true""true""true""true", and a
double-headed arrow to the upper right if ScaleScaleScaleScalescalescale is set to
'true'"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
-
To move the contour, click with the left mouse button on the cross in the
center and then drag it to the new position, i.e., keep the mouse button
pressed while moving the mouse.
-
To rotate it, click with the left mouse button on the arrow and then drag it,
till the contour has the right direction.
-
Scaling is achieved by dragging the double arrow.
To keep the ratio the parameter KeepRatioKeepRatioKeepRatioKeepRatiokeepRatiokeep_ratio has to be set to 'true'"true""true""true""true""true".
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')
-
To append points, click with the left mouse button in the window and a new
point is added at this position.
-
You can delete the point appended last by pressing the Ctrl key.
-
To move or insert points, you must first close the contour by clicking on
one of the pick points.
Closed contours (square pick points)
-
To move a point, click with the left mouse button on a point marked by a
rectangle and then drag it to the new position.
-
To insert a point, click with the left mouse button in the vicinity of a
line and then move the mouse to the position where you want the new point
to be placed.
-
To delete a point, select the point which should be deleted with the left
mouse button and then press the Ctrl key.
Pressing the right mouse button terminates the procedure. On macOS
draw_xld_moddraw_xld_modDrawXldModDrawXldModDrawXldModdraw_xld_mod can also be terminated by pressing the escape key.
Attention
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
- Multithreading type: reentrant (runs in parallel with non-exclusive operators).
- Multithreading scope: global (may be called from any thread).
- Processed without parallelization.
Parameters
ContInContInContInContIncontIncont_in (input_object) xld_cont → objectHXLDContHObjectHXLDContHobject
Input contour.
ContOutContOutContOutContOutcontOutcont_out (output_object) xld_cont → objectHXLDContHObjectHXLDContHobject *
Modified contour.
WindowHandleWindowHandleWindowHandleWindowHandlewindowHandlewindow_handle (input_control) window → HWindow, HTupleHHandleHTupleHtuple (handle) (IntPtr) (HHandle) (handle)
Window handle.
RotateRotateRotateRotaterotaterotate (input_control) string → HTuplestrHTupleHtuple (string) (string) (HString) (char*)
Enable rotation?
Default value:
'true'
"true"
"true"
"true"
"true"
"true"
List of values: 'false'"false""false""false""false""false", 'true'"true""true""true""true""true"
MoveMoveMoveMovemovemove (input_control) string → HTuplestrHTupleHtuple (string) (string) (HString) (char*)
Enable moving?
Default value:
'true'
"true"
"true"
"true"
"true"
"true"
List of values: 'false'"false""false""false""false""false", 'true'"true""true""true""true""true"
ScaleScaleScaleScalescalescale (input_control) string → HTuplestrHTupleHtuple (string) (string) (HString) (char*)
Enable scaling?
Default value:
'true'
"true"
"true"
"true"
"true"
"true"
List of values: 'false'"false""false""false""false""false", 'true'"true""true""true""true""true"
KeepRatioKeepRatioKeepRatioKeepRatiokeepRatiokeep_ratio (input_control) string → HTuplestrHTupleHtuple (string) (string) (HString) (char*)
Keep ratio while scaling?
Default value:
'true'
"true"
"true"
"true"
"true"
"true"
List of values: 'false'"false""false""false""false""false", 'true'"true""true""true""true""true"
EditEditEditEditeditedit (input_control) string → HTuplestrHTupleHtuple (string) (string) (HString) (char*)
Enable editing?
Default value:
'true'
"true"
"true"
"true"
"true"
"true"
List of values: 'false'"false""false""false""false""false", 'true'"true""true""true""true""true"
Result
draw_xld_moddraw_xld_modDrawXldModDrawXldModDrawXldModdraw_xld_mod returns TRUE, if the window is valid and the
needed drawing mode (see set_insertset_insertSetInsertSetInsertSetInsertset_insert) is available.
If necessary, an exception is raised.
Possible Predecessors
open_windowopen_windowOpenWindowOpenWindowOpenWindowopen_window
Possible Successors
reduce_domainreduce_domainReduceDomainReduceDomainReduceDomainreduce_domain,
disp_regiondisp_regionDispRegionDispRegionDispRegiondisp_region,
set_coloredset_coloredSetColoredSetColoredSetColoredset_colored,
set_line_widthset_line_widthSetLineWidthSetLineWidthSetLineWidthset_line_width,
set_drawset_drawSetDrawSetDrawSetDrawset_draw,
set_insertset_insertSetInsertSetInsertSetInsertset_insert
Alternatives
draw_rectangle2draw_rectangle2DrawRectangle2DrawRectangle2DrawRectangle2draw_rectangle2,
draw_rectangle1draw_rectangle1DrawRectangle1DrawRectangle1DrawRectangle1draw_rectangle1,
draw_rectangle2draw_rectangle2DrawRectangle2DrawRectangle2DrawRectangle2draw_rectangle2,
draw_regiondraw_regionDrawRegionDrawRegionDrawRegiondraw_region
See also
gen_rectangle2gen_rectangle2GenRectangle2GenRectangle2GenRectangle2gen_rectangle2,
draw_circledraw_circleDrawCircleDrawCircleDrawCircledraw_circle,
draw_ellipsedraw_ellipseDrawEllipseDrawEllipseDrawEllipsedraw_ellipse,
set_insertset_insertSetInsertSetInsertSetInsertset_insert
Module
Foundation