Skip to content

draw_nurbs_interp_moddraw_nurbs_interp_modDrawNurbsInterpModDrawNurbsInterpModdraw_nurbs_interp_modT_draw_nurbs_interp_mod🔗

Short description🔗

draw_nurbs_interp_moddraw_nurbs_interp_modDrawNurbsInterpModDrawNurbsInterpModdraw_nurbs_interp_modT_draw_nurbs_interp_mod — Interactive modification of a NURBS curve using interpolation.

Warning🔗

This operator does not work in an HDevelop graphics window opened with dev_open_window.

Signature🔗

draw_nurbs_interp_mod( out xld_cont ContOut, window WindowHandle, string Rotate, string Move, string Scale, string KeepRatio, string Edit, integer Degree, coordinates.y RowsIn, coordinates.x ColsIn, real TangentsIn, out coordinates.y ControlRows, out coordinates.x ControlCols, out real Knots, out coordinates.y Rows, out coordinates.x Cols, out real Tangents )draw_nurbs_interp_mod( : ContOut : WindowHandle, Rotate, Move, Scale, KeepRatio, Edit, Degree, RowsIn, ColsIn, TangentsIn : ControlRows, ControlCols, Knots, Rows, Cols, 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 )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 )def draw_nurbs_interp_mod( window_handle: HHandle, rotate: str, move: str, scale: str, keep_ratio: str, edit: str, degree: int, rows_in: Sequence[float], cols_in: Sequence[float], tangents_in: Sequence[float] ) -> Tuple[HObject, Sequence[float], Sequence[float], Sequence[float], Sequence[float], Sequence[float], Sequence[float]]

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 )

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 )

void HXLDCont::DrawNurbsInterpMod( const HWindow& WindowHandle, const wchar_t* Rotate, const wchar_t* Move, const wchar_t* Scale, const wchar_t* KeepRatio, const wchar_t* Edit, Hlong Degree, const HTuple& RowsIn, const HTuple& ColsIn, const HTuple& TangentsIn, HTuple* ControlRows, HTuple* ControlCols, HTuple* Knots, HTuple* Rows, HTuple* Cols, HTuple* Tangents ) (Windows only)

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

HXLDCont HWindow::DrawNurbsInterpMod( const wchar_t* Rotate, const wchar_t* Move, const wchar_t* Scale, const wchar_t* KeepRatio, const wchar_t* 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 (Windows only)

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 )

Description🔗

draw_nurbs_interp_modDrawNurbsInterpMod returns the contour ContOutcontOutcont_out of a NURBS curve of degree Degreedegreedegree, which has been modified interactively by the user in the window WindowHandlewindowHandlewindow_handle.

In addition to ContOutcontOutcont_out the control information of the curve (ControlRowscontrolRowscontrol_rows, ControlColscontrolColscontrol_cols, and Knotsknotsknots), the interpolation points (Rowsrowsrows, Colscolscols) specified by the user and the tangents at the first and the last point (Tangentstangentstangents) are returned. Tangentstangentstangents 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" as weight vector, if the control information is used in a subsequent call to the operator gen_contour_nurbs_xldGenContourNurbsXld. For more information on NURBS see the documentation of gen_contour_nurbs_xldGenContourNurbsXld.

The input curve is specified by the interpolation points (RowsInrowsInrows_in, ColsIncolsIncols_in), its degree Degreedegreedegree and the tangents TangentsIntangentsIntangents_in, such that draw_nurbs_interp_modDrawNurbsInterpMod can be applied to the output data of draw_nurbs_interpDrawNurbsInterp.

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 Editeditedit is set to 'true'"true". Similarly, you can only rotate, move or scale it if Rotaterotaterotate, Movemovemove, and Scalescalescale, respectively, are set to 'true'"true".

draw_nurbs_interp_modDrawNurbsInterpMod 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 Rotaterotaterotate is set to 'true'"true", and a double-headed arrow to the upper right if Scalescalescale is set to '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🔗

In this mode a NURBS curve can be rotated, moved and scaled, as long as the respective parameter Rotaterotaterotate, Movemovemove and Scalescalescale are set to 'true'"true". The NURBS curve is displayed along with a cross in its center, an arrow pointing to the right (if Rotaterotaterotate is set to 'true'"true"), and a double arrow (if Scalescalescale is set to 'true'"true").

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

The appearance of the curve while drawing is determined by the line width, size and color set via the operators set_colorSetColor, set_coloredSetColored, set_line_widthSetLineWidth, and set_line_styleSetLineStyle. The tangents and all handles are displayed in the second color set by set_colorSetColor or set_coloredSetColored. Their line width is fixed to 1 and their line style is fixed to a drawn-through line.

Attention🔗

In contrast to draw_nurbsDrawNurbs, 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.

Execution information🔗

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🔗

ContOutcontOutcont_out (output_object) xld_cont → objectobjectHObjectHXLDContHObjectHobject *

Contour of the modified curve.

WindowHandlewindowHandlewindow_handle (input_control) window → (handle)(handle)HTuple (HHandle)HWindow, HTuple (IntPtr)HHandleHtuple (handle)

Window handle.

Rotaterotaterotate (input_control) string → (string)(string)HTuple (HString)HTuple (string)strHtuple (char*)

Enable rotation?

Default: 'true'"true"
List of values: 'false', 'true'"false", "true"

Movemovemove (input_control) string → (string)(string)HTuple (HString)HTuple (string)strHtuple (char*)

Enable moving?

Default: 'true'"true"
List of values: 'false', 'true'"false", "true"

Scalescalescale (input_control) string → (string)(string)HTuple (HString)HTuple (string)strHtuple (char*)

Enable scaling?

Default: 'true'"true"
List of values: 'false', 'true'"false", "true"

KeepRatiokeepRatiokeep_ratio (input_control) string → (string)(string)HTuple (HString)HTuple (string)strHtuple (char*)

Keep ratio while scaling?

Default: 'true'"true"
List of values: 'false', 'true'"false", "true"

Editeditedit (input_control) string → (string)(string)HTuple (HString)HTuple (string)strHtuple (char*)

Enable editing?

Default: 'true'"true"
List of values: 'false', 'true'"false", "true"

Degreedegreedegree (input_control) integer → (integer)(integer)HTuple (Hlong)HTuple (int / long)intHtuple (Hlong)

The degree \(p\) of the NURBS curve. Reasonable values are 3 to 5.

Default: 33
Suggested values: 2, 3, 4, 52, 3, 4, 5
Restriction: Degree >= 2 && Degree <=9

RowsInrowsInrows_in (input_control) coordinates.y-array → (real)(real)HTuple (double)HTuple (double)Sequence[float]Htuple (double)

Row coordinates of the input interpolation points.

ColsIncolsIncols_in (input_control) coordinates.x-array → (real)(real)HTuple (double)HTuple (double)Sequence[float]Htuple (double)

Column coordinates of the input interpolation points.

TangentsIntangentsIntangents_in (input_control) real-array → (real)(real)HTuple (double)HTuple (double)Sequence[float]Htuple (double)

Input tangents.

ControlRowscontrolRowscontrol_rows (output_control) coordinates.y-array → (real)(real)HTuple (double)HTuple (double)Sequence[float]Htuple (double)

Row coordinates of the control polygon.

ControlColscontrolColscontrol_cols (output_control) coordinates.x-array → (real)(real)HTuple (double)HTuple (double)Sequence[float]Htuple (double)

Column coordinates of the control polygon.

Knotsknotsknots (output_control) real-array → (real)(real)HTuple (double)HTuple (double)Sequence[float]Htuple (double)

Knot vector.

Rowsrowsrows (output_control) coordinates.y-array → (real)(real)HTuple (double)HTuple (double)Sequence[float]Htuple (double)

Row coordinates of the points specified by the user.

Colscolscols (output_control) coordinates.x-array → (real)(real)HTuple (double)HTuple (double)Sequence[float]Htuple (double)

Column coordinates of the points specified by the user.

Tangentstangentstangents (output_control) real-array → (real)(real)HTuple (double)HTuple (double)Sequence[float]Htuple (double)

Tangents specified by the user.

Result🔗

draw_nurbs_interp_modDrawNurbsInterpMod returns 2 (H_MSG_TRUE) if the window is valid. If necessary, an exception is raised.

Combinations with other operators🔗

Combinations

Possible predecessors

open_windowOpenWindow

Possible successors

set_coloredSetColored, set_line_widthSetLineWidth, set_drawSetDraw

Alternatives

draw_xld_modDrawXldMod, draw_nurbs_modDrawNurbsMod

See also

draw_nurbs_interpDrawNurbsInterp, gen_contour_nurbs_xldGenContourNurbsXld

Module🔗

Foundation