draw_nurbs_modT_draw_nurbs_modDrawNurbsModdraw_nurbs_modDrawNurbsModDrawNurbsMod (Operator)

Name

draw_nurbs_modT_draw_nurbs_modDrawNurbsModdraw_nurbs_modDrawNurbsModDrawNurbsMod — Interactive modification of a NURBS curve.

Signature

Description

draw_nurbs_moddraw_nurbs_modDrawNurbsModdraw_nurbs_modDrawNurbsModDrawNurbsMod returns the contour ContOutContOutContOutContOutContOutcontOut and control information (RowsRowsRowsRowsRowsrows, ColsColsColsColsColscols, and WeightsWeightsWeightsWeightsWeightsweights) of a NURBS curve of degree DegreeDegreeDegreeDegreeDegreedegree, which has been interactively modified by the user in the window WindowHandleWindowHandleWindowHandleWindowHandleWindowHandlewindowHandle. For additional information concerning NURBS curves, see the documentation of gen_contour_nurbs_xldgen_contour_nurbs_xldGenContourNurbsXldgen_contour_nurbs_xldGenContourNurbsXldGenContourNurbsXld. To use the control information RowsRowsRowsRowsRowsrows, ColsColsColsColsColscols, and WeightsWeightsWeightsWeightsWeightsweights in a subsequent call to the operator gen_contour_nurbs_xldgen_contour_nurbs_xldGenContourNurbsXldgen_contour_nurbs_xldGenContourNurbsXldGenContourNurbsXld, the knot vector KnotsKnotsKnotsKnotsKnotsknots should be set to 'auto'"auto""auto""auto""auto""auto".

The input NURBS curve is specified by its control polygon (RowsInRowsInRowsInRowsInRowsInrowsIn, ColsInColsInColsInColsInColsIncolsIn), its weight vector WeightsInWeightsInWeightsInWeightsInWeightsInweightsIn and its degree DegreeDegreeDegreeDegreeDegreedegree. The knot vector is assumed to be uniform (i.e. 'auto'"auto""auto""auto""auto""auto" in gen_contour_nurbs_xldgen_contour_nurbs_xldGenContourNurbsXldgen_contour_nurbs_xldGenContourNurbsXldGenContourNurbsXld).

You can modify the curve in two ways: by editing the control polygon, e.g., by inserting or moving control points, or by transforming the contour as a whole, e.g., by rotating moving or scaling it. Note that you can only edit the control polygon 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_moddraw_nurbs_modDrawNurbsModdraw_nurbs_modDrawNurbsModDrawNurbsMod 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 control polygon. Start and end point are marked by an additional square and the point which was handled last is surrounded by a circle representing its weight. You can perform the following modifications:

• To append control 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 control polygon, click on the desired position on the polygon.

• To close respectively open the curve, click on the first or on the last control point.

• You can modify the weight of a control point by first clicking on the point itself (if it is not already the point which was modified or created last) and then dragging the circle around the point.

Pressing the right mouse button terminates the procedure. On Mac OS X draw_nurbs_moddraw_nurbs_modDrawNurbsModdraw_nurbs_modDrawNurbsModDrawNurbsMod 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 control polygon 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.

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_nurbs_moddraw_nurbs_modDrawNurbsModdraw_nurbs_modDrawNurbsModDrawNurbsMod returns 2 (H_MSG_TRUE), if the window is valid. If necessary, an exception is raised.

Possible Predecessors

open_windowopen_windowOpenWindowopen_windowOpenWindowOpenWindow

Possible Successors

set_coloredset_coloredSetColoredset_coloredSetColoredSetColored, set_line_widthset_line_widthSetLineWidthset_line_widthSetLineWidthSetLineWidth, set_drawset_drawSetDrawset_drawSetDrawSetDraw, set_insertset_insertSetInsertset_insertSetInsertSetInsert

Alternatives

draw_nurbs_interp_moddraw_nurbs_interp_modDrawNurbsInterpModdraw_nurbs_interp_modDrawNurbsInterpModDrawNurbsInterpMod, draw_xld_moddraw_xld_modDrawXldModdraw_xld_modDrawXldModDrawXldMod

See also

draw_nurbsdraw_nurbsDrawNurbsdraw_nurbsDrawNurbsDrawNurbs, draw_nurbs_interpdraw_nurbs_interpDrawNurbsInterpdraw_nurbs_interpDrawNurbsInterpDrawNurbsInterp, gen_contour_nurbs_xldgen_contour_nurbs_xldGenContourNurbsXldgen_contour_nurbs_xldGenContourNurbsXldGenContourNurbsXld

Module

Foundation