draw_xld_moddraw_xld_moddraw_xld_modDrawXldModDrawXldMod (Operator)

Name

draw_xld_moddraw_xld_moddraw_xld_modDrawXldModDrawXldMod — Interactive modification of a contour.

Signature

Description

draw_xld_moddraw_xld_moddraw_xld_modDrawXldModDrawXldMod 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_moddraw_xld_modDrawXldModDrawXldMod 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

• 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 KeepRatioKeepRatioKeepRatioKeepRatiokeepRatio has to be set to '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.

Parallelization

• Multithreading type: reentrant (runs in parallel with non-exclusive operators).
• Multithreading scope: local (may only be called from the same thread in which the window, model, or tool instance was created).
• Processed without parallelization.

Parameters

Result

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

Possible Predecessors

open_windowopen_windowopen_windowOpenWindowOpenWindow

Possible Successors

reduce_domainreduce_domainreduce_domainReduceDomainReduceDomain, disp_regiondisp_regiondisp_regionDispRegionDispRegion, set_coloredset_coloredset_coloredSetColoredSetColored, set_line_widthset_line_widthset_line_widthSetLineWidthSetLineWidth, set_drawset_drawset_drawSetDrawSetDraw, set_insertset_insertset_insertSetInsertSetInsert

Alternatives

draw_rectangle2draw_rectangle2draw_rectangle2DrawRectangle2DrawRectangle2, draw_rectangle1draw_rectangle1draw_rectangle1DrawRectangle1DrawRectangle1, draw_rectangle2draw_rectangle2draw_rectangle2DrawRectangle2DrawRectangle2, draw_regiondraw_regiondraw_regionDrawRegionDrawRegion

See also

gen_rectangle2gen_rectangle2gen_rectangle2GenRectangle2GenRectangle2, draw_circledraw_circledraw_circleDrawCircleDrawCircle, draw_ellipsedraw_ellipsedraw_ellipseDrawEllipseDrawEllipse, set_insertset_insertset_insertSetInsertSetInsert

Module

Foundation