ClassesClassesClassesClasses | | | | Operators

draw_xlddraw_xldDrawXlddraw_xldDrawXldDrawXld (Operator)

Name

draw_xlddraw_xldDrawXlddraw_xldDrawXldDrawXld — Interactive drawing of a contour.

Signature

draw_xld( : ContOut : WindowHandle, Rotate, Move, Scale, KeepRatio : )

Herror draw_xld(Hobject* ContOut, const Hlong WindowHandle, const char* Rotate, const char* Move, const char* Scale, const char* KeepRatio)

Herror T_draw_xld(Hobject* ContOut, const Htuple WindowHandle, const Htuple Rotate, const Htuple Move, const Htuple Scale, const Htuple KeepRatio)

Herror draw_xld(Hobject* ContOut, const HTuple& WindowHandle, const HTuple& Rotate, const HTuple& Move, const HTuple& Scale, const HTuple& KeepRatio)

HXLDCont HXLDCont::DrawXld(const HTuple& WindowHandle, const HTuple& Rotate, const HTuple& Move, const HTuple& Scale, const HTuple& KeepRatio)

void DrawXld(HObject* ContOut, const HTuple& WindowHandle, const HTuple& Rotate, const HTuple& Move, const HTuple& Scale, const HTuple& KeepRatio)

void HXLDCont::DrawXld(const HWindow& WindowHandle, const HString& Rotate, const HString& Move, const HString& Scale, const HString& KeepRatio)

void HXLDCont::DrawXld(const HWindow& WindowHandle, const char* Rotate, const char* Move, const char* Scale, const char* KeepRatio)

HXLDCont HWindow::DrawXld(const HString& Rotate, const HString& Move, const HString& Scale, const HString& KeepRatio) const

HXLDCont HWindow::DrawXld(const char* Rotate, const char* Move, const char* Scale, const char* KeepRatio) const

void HOperatorSetX.DrawXld(
[out] IHUntypedObjectX*ContOut, [in] VARIANT WindowHandle, [in] VARIANT Rotate, [in] VARIANT Move, [in] VARIANT Scale, [in] VARIANT KeepRatio)

void HXLDContX.DrawXld(
[in] IHWindowX* WindowHandle, [in] BSTR Rotate, [in] BSTR Move, [in] BSTR Scale, [in] BSTR KeepRatio)

IHXLDContX* HWindowX.DrawXld(
[in] BSTR Rotate, [in] BSTR Move, [in] BSTR Scale, [in] BSTR KeepRatio)

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

void HXLDCont.DrawXld(HWindow windowHandle, string rotate, string move, string scale, string keepRatio)

HXLDCont HWindow.DrawXld(string rotate, string move, string scale, string keepRatio)

Description

draw_xlddraw_xldDrawXlddraw_xldDrawXldDrawXld returns a contour, which has been created interactively by the user in the window.

Directly after calling draw_xlddraw_xldDrawXlddraw_xldDrawXldDrawXld you can add contour points by clicking with the left mouse button in the window at the desired positions. You delete the point appended last by pressing the Ctrl key. As soon as you add three contour points, 5 so-called pick points are displayed, one in the middle and 4 at the corners of the surrounding rectangle. By clicking on a pick point you can close the contour or open it again. If the contour is closed, the pick points are displayed in form of squares, otherwise they are shaped like a 'u'.

If the contour is closed you can

By pressing the Shift key, you can switch into the transformation mode. In this mode you can rotate, move, and scale the contour as a whole, but only if you set the parameters RotateRotateRotateRotateRotaterotate, MoveMoveMoveMoveMovemove, and ScaleScaleScaleScaleScalescale, respectively, to 'true'"true""true""true""true""true". Instead of the pick points, 3 symbols are displayed with the contour: 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".

You can

Pressing the right mouse button terminates the procedure. On Mac OS X draw_xlddraw_xldDrawXlddraw_xldDrawXldDrawXld can also be terminated by pressing the escape key.

Parallelization

Parameters

ContOutContOutContOutContOutContOutcontOut (output_object)  xld_cont objectHXLDContHXLDContHXLDContHXLDContXHobject *

Modified contour.

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

Window identifier.

RotateRotateRotateRotateRotaterotate (input_control)  string HTupleHTupleHTupleVARIANTHtuple (string) (string) (HString) (char*) (BSTR) (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 HTupleHTupleHTupleVARIANTHtuple (string) (string) (HString) (char*) (BSTR) (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 HTupleHTupleHTupleVARIANTHtuple (string) (string) (HString) (char*) (BSTR) (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"

KeepRatioKeepRatioKeepRatioKeepRatioKeepRatiokeepRatio (input_control)  string HTupleHTupleHTupleVARIANTHtuple (string) (string) (HString) (char*) (BSTR) (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"

Result

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

Possible Predecessors

open_windowopen_windowOpenWindowopen_windowOpenWindowOpenWindow

Possible Successors

reduce_domainreduce_domainReduceDomainreduce_domainReduceDomainReduceDomain, disp_regiondisp_regionDispRegiondisp_regionDispRegionDispRegion, set_coloredset_coloredSetColoredset_coloredSetColoredSetColored, set_line_widthset_line_widthSetLineWidthset_line_widthSetLineWidthSetLineWidth, set_drawset_drawSetDrawset_drawSetDrawSetDraw, set_insertset_insertSetInsertset_insertSetInsertSetInsert

Alternatives

draw_rectangle2draw_rectangle2DrawRectangle2draw_rectangle2DrawRectangle2DrawRectangle2, draw_rectangle1draw_rectangle1DrawRectangle1draw_rectangle1DrawRectangle1DrawRectangle1, draw_rectangle2draw_rectangle2DrawRectangle2draw_rectangle2DrawRectangle2DrawRectangle2, draw_regiondraw_regionDrawRegiondraw_regionDrawRegionDrawRegion

See also

gen_rectangle2gen_rectangle2GenRectangle2gen_rectangle2GenRectangle2GenRectangle2, draw_circledraw_circleDrawCircledraw_circleDrawCircleDrawCircle, draw_ellipsedraw_ellipseDrawEllipsedraw_ellipseDrawEllipseDrawEllipse, set_insertset_insertSetInsertset_insertSetInsertSetInsert

Module

Foundation


ClassesClassesClassesClasses | | | | Operators