Name
draw_nurbs_interp_modT_draw_nurbs_interp_modDrawNurbsInterpModdraw_nurbs_interp_modDrawNurbsInterpModDrawNurbsInterpMod — Interactive modification of a NURBS curve using interpolation.
draw_nurbs_interp_mod( : ContOut : WindowHandle, Rotate, Move, Scale, KeepRatio, Edit, Degree, RowsIn, ColsIn, TangentsIn : ControlRows, ControlCols, Knots, Rows, Cols, Tangents)
Herror T_draw_nurbs_interp_mod(Hobject* ContOut, const Htuple WindowHandle, const Htuple Rotate, const Htuple Move, const Htuple Scale, const Htuple KeepRatio, const Htuple Edit, const Htuple Degree, const Htuple RowsIn, const Htuple ColsIn, const Htuple TangentsIn, Htuple* ControlRows, Htuple* ControlCols, Htuple* Knots, Htuple* Rows, Htuple* Cols, Htuple* Tangents)
Herror draw_nurbs_interp_mod(Hobject* ContOut, const HTuple& WindowHandle, const HTuple& Rotate, const HTuple& Move, const HTuple& Scale, const HTuple& KeepRatio, const HTuple& Edit, const HTuple& Degree, const HTuple& RowsIn, const HTuple& ColsIn, const HTuple& TangentsIn, HTuple* ControlRows, HTuple* ControlCols, HTuple* Knots, HTuple* Rows, HTuple* Cols, HTuple* Tangents)
HXLDCont HXLDCont::DrawNurbsInterpMod(const HTuple& WindowHandle, const HTuple& Rotate, const HTuple& Move, const HTuple& Scale, const HTuple& KeepRatio, const HTuple& Edit, const HTuple& Degree, const HTuple& RowsIn, const HTuple& ColsIn, const HTuple& TangentsIn, HTuple* ControlRows, HTuple* ControlCols, HTuple* Knots, HTuple* Rows, HTuple* Cols, HTuple* Tangents)
void DrawNurbsInterpMod(HObject* ContOut, const HTuple& WindowHandle, const HTuple& Rotate, const HTuple& Move, const HTuple& Scale, const HTuple& KeepRatio, const HTuple& Edit, const HTuple& Degree, const HTuple& RowsIn, const HTuple& ColsIn, const HTuple& TangentsIn, HTuple* ControlRows, HTuple* ControlCols, HTuple* Knots, HTuple* Rows, HTuple* Cols, HTuple* Tangents)
void HXLDCont::DrawNurbsInterpMod(const HWindow& WindowHandle, const HString& Rotate, const HString& Move, const HString& Scale, const HString& KeepRatio, const HString& Edit, Hlong Degree, const HTuple& RowsIn, const HTuple& ColsIn, const HTuple& TangentsIn, HTuple* ControlRows, HTuple* ControlCols, HTuple* Knots, HTuple* Rows, HTuple* Cols, HTuple* Tangents)
void HXLDCont::DrawNurbsInterpMod(const HWindow& WindowHandle, const char* Rotate, const char* Move, const char* Scale, const char* KeepRatio, const char* Edit, Hlong Degree, const HTuple& RowsIn, const HTuple& ColsIn, const HTuple& TangentsIn, HTuple* ControlRows, HTuple* ControlCols, HTuple* Knots, HTuple* Rows, HTuple* Cols, HTuple* Tangents)
HXLDCont HWindow::DrawNurbsInterpMod(const HString& Rotate, const HString& Move, const HString& Scale, const HString& KeepRatio, const HString& Edit, Hlong Degree, const HTuple& RowsIn, const HTuple& ColsIn, const HTuple& TangentsIn, HTuple* ControlRows, HTuple* ControlCols, HTuple* Knots, HTuple* Rows, HTuple* Cols, HTuple* Tangents) const
HXLDCont HWindow::DrawNurbsInterpMod(const char* Rotate, const char* Move, const char* Scale, const char* KeepRatio, const char* Edit, Hlong Degree, const HTuple& RowsIn, const HTuple& ColsIn, const HTuple& TangentsIn, HTuple* ControlRows, HTuple* ControlCols, HTuple* Knots, HTuple* Rows, HTuple* Cols, HTuple* Tangents) const
void HOperatorSetX.DrawNurbsInterpMod(
[out] IHUntypedObjectX** ContOut, [in] VARIANT WindowHandle, [in] VARIANT Rotate, [in] VARIANT Move, [in] VARIANT Scale, [in] VARIANT KeepRatio, [in] VARIANT Edit, [in] VARIANT Degree, [in] VARIANT RowsIn, [in] VARIANT ColsIn, [in] VARIANT TangentsIn, [out] VARIANT* ControlRows, [out] VARIANT* ControlCols, [out] VARIANT* Knots, [out] VARIANT* Rows, [out] VARIANT* Cols, [out] VARIANT* Tangents)
VARIANT HXLDContX.DrawNurbsInterpMod(
[in] IHWindowX* WindowHandle, [in] BSTR Rotate, [in] BSTR Move, [in] BSTR Scale, [in] BSTR KeepRatio, [in] BSTR Edit, [in] Hlong Degree, [in] VARIANT RowsIn, [in] VARIANT ColsIn, [in] VARIANT TangentsIn, [out] VARIANT* ControlCols, [out] VARIANT* Knots, [out] VARIANT* Rows, [out] VARIANT* Cols, [out] VARIANT* Tangents)
IHXLDContX* HWindowX.DrawNurbsInterpMod(
[in] BSTR Rotate, [in] BSTR Move, [in] BSTR Scale, [in] BSTR KeepRatio, [in] BSTR Edit, [in] Hlong Degree, [in] VARIANT RowsIn, [in] VARIANT ColsIn, [in] VARIANT TangentsIn, [out] VARIANT* ControlRows, [out] VARIANT* ControlCols, [out] VARIANT* Knots, [out] VARIANT* Rows, [out] VARIANT* Cols, [out] VARIANT* Tangents)
static void HOperatorSet.DrawNurbsInterpMod(out HObject contOut, HTuple windowHandle, HTuple rotate, HTuple move, HTuple scale, HTuple keepRatio, HTuple edit, HTuple degree, HTuple rowsIn, HTuple colsIn, HTuple tangentsIn, out HTuple controlRows, out HTuple controlCols, out HTuple knots, out HTuple rows, out HTuple cols, out HTuple tangents)
void HXLDCont.DrawNurbsInterpMod(HWindow windowHandle, string rotate, string move, string scale, string keepRatio, string edit, int degree, HTuple rowsIn, HTuple colsIn, HTuple tangentsIn, out HTuple controlRows, out HTuple controlCols, out HTuple knots, out HTuple rows, out HTuple cols, out HTuple tangents)
HXLDCont HWindow.DrawNurbsInterpMod(string rotate, string move, string scale, string keepRatio, string edit, int degree, HTuple rowsIn, HTuple colsIn, HTuple tangentsIn, out HTuple controlRows, out HTuple controlCols, out HTuple knots, out HTuple rows, out HTuple cols, out HTuple tangents)
draw_nurbs_interp_moddraw_nurbs_interp_modDrawNurbsInterpModdraw_nurbs_interp_modDrawNurbsInterpModDrawNurbsInterpMod returns the contour ContOutContOutContOutContOutContOutcontOut of a
NURBS curve of degree DegreeDegreeDegreeDegreeDegreedegree, which has been modified
interactively by the user in the window WindowHandleWindowHandleWindowHandleWindowHandleWindowHandlewindowHandle.
In addition to ContOutContOutContOutContOutContOutcontOut the control information of
the curve (ControlRowsControlRowsControlRowsControlRowsControlRowscontrolRows, ControlColsControlColsControlColsControlColsControlColscontrolCols, and KnotsKnotsKnotsKnotsKnotsknots),
the interpolation points (RowsRowsRowsRowsRowsrows, ColsColsColsColsColscols) specified by the
user and the tangents at the first and the last point (TangentsTangentsTangentsTangentsTangentstangents)
are returned. TangentsTangentsTangentsTangentsTangentstangents consists of four values. The first two
values correspond to the y (row) and the x (column) value of the tangent at
the start of the curve and the second two values to the tangent at the end
of the curve, respectively.
The weight vector is not returned because it consists of
equal entries. As a consequence one can use 'auto'"auto""auto""auto""auto""auto" as weight vector,
if the control information is used in a subsequent call to the operator
gen_contour_nurbs_xldgen_contour_nurbs_xldGenContourNurbsXldgen_contour_nurbs_xldGenContourNurbsXldGenContourNurbsXld. For more information on NURBS see the
documentation of gen_contour_nurbs_xldgen_contour_nurbs_xldGenContourNurbsXldgen_contour_nurbs_xldGenContourNurbsXldGenContourNurbsXld.
The input curve is specified by the interpolation points (RowsInRowsInRowsInRowsInRowsInrowsIn,
ColsInColsInColsInColsInColsIncolsIn), its degree DegreeDegreeDegreeDegreeDegreedegree and the tangents
TangentsInTangentsInTangentsInTangentsInTangentsIntangentsIn, such that draw_nurbs_interp_moddraw_nurbs_interp_modDrawNurbsInterpModdraw_nurbs_interp_modDrawNurbsInterpModDrawNurbsInterpMod can be applied
to the output data of draw_nurbs_interpdraw_nurbs_interpDrawNurbsInterpdraw_nurbs_interpDrawNurbsInterpDrawNurbsInterp.
You can modify the curve in two ways: by editing the interpolation points,
e.g., by inserting or moving points, or by transforming the curve
as a whole, e.g., by rotating moving or scaling it. Note that you can only
edit the curve 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_nurbs_interp_moddraw_nurbs_interp_modDrawNurbsInterpModdraw_nurbs_interp_modDrawNurbsInterpModDrawNurbsInterpMod starts in the transformation mode. In this
mode, the curve 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 curve, 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 curve has the right direction.
-
Scaling is achieved by dragging the double arrow. To keep the
ratio, the parameter KeepRatioKeepRatioKeepRatioKeepRatioKeepRatiokeepRatio has to be set to
'true'"true""true""true""true""true".
Edit Mode
In this mode, the curve is displayed together with its interpolation
points and the start and end tangent.
Start and end point are marked by an additional square. You can
perform the following modifications:
-
To append new 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 a point, drag it with the mouse.
-
To insert a point on the curve, click on the desired
position on the curve.
-
To close respectively open the curve, click on the first or on
the last point.
Pressing the right mouse button terminates the procedure. On macOS
draw_nurbs_interp_moddraw_nurbs_interp_modDrawNurbsInterpModdraw_nurbs_interp_modDrawNurbsInterpModDrawNurbsInterpMod can also be terminated by pressing the escape
key.
The appearance of the curve while drawing is determined by the line width,
size and color set via the operators set_colorset_colorSetColorset_colorSetColorSetColor, set_coloredset_coloredSetColoredset_coloredSetColoredSetColored,
set_line_widthset_line_widthSetLineWidthset_line_widthSetLineWidthSetLineWidth, and set_line_styleset_line_styleSetLineStyleset_line_styleSetLineStyleSetLineStyle. The tangents and
all handles are displayed in the second color set by set_colorset_colorSetColorset_colorSetColorSetColor or
set_coloredset_coloredSetColoredset_coloredSetColoredSetColored. Their line width is fixed to 1 and their line style is
fixed to a drawn-through line.
In contrast to draw_nurbsdraw_nurbsDrawNurbsdraw_nurbsDrawNurbsDrawNurbs, each point specified by the user
influences the whole curve. Thus, if one point is moved, the whole curve can
and will change. To minimize this effects, it is recommended to use a small
degree (3-5) and to place the points such that they are approximately equally
spaced. In general, uneven degrees will perform slightly better than even
degrees.
- Multithreading type: reentrant (runs in parallel with non-exclusive operators).
- Multithreading scope: global (may be called from any thread).
- Processed without parallelization.
Contour of the modified curve.
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"
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"
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"
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"
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"
The degree p of the NURBS curve.
Reasonable values are 3 to 5.
Default value: 3
Suggested values: 2, 3, 4, 5
Restriction: Degree >= 2 && Degree <= 9
Row coordinates of the input interpolation points.
Column coordinates of the input interpolation points.
Row coordinates of the control polygon.
Column coordinates of the control polygon.
Row coordinates of the points specified by the user.
Column coordinates of the points specified by the user.
Tangents specified by the user.
draw_nurbs_interp_moddraw_nurbs_interp_modDrawNurbsInterpModdraw_nurbs_interp_modDrawNurbsInterpModDrawNurbsInterpMod returns 2 (H_MSG_TRUE), if the window is valid.
If necessary, an exception is raised.
open_windowopen_windowOpenWindowopen_windowOpenWindowOpenWindow
set_coloredset_coloredSetColoredset_coloredSetColoredSetColored,
set_line_widthset_line_widthSetLineWidthset_line_widthSetLineWidthSetLineWidth,
set_drawset_drawSetDrawset_drawSetDrawSetDraw,
set_insertset_insertSetInsertset_insertSetInsertSetInsert
draw_xld_moddraw_xld_modDrawXldModdraw_xld_modDrawXldModDrawXldMod,
draw_nurbs_moddraw_nurbs_modDrawNurbsModdraw_nurbs_modDrawNurbsModDrawNurbsMod
draw_nurbs_interpdraw_nurbs_interpDrawNurbsInterpdraw_nurbs_interpDrawNurbsInterpDrawNurbsInterp,
gen_contour_nurbs_xldgen_contour_nurbs_xldGenContourNurbsXldgen_contour_nurbs_xldGenContourNurbsXldGenContourNurbsXld
Foundation