draw_nurbs_interpT_draw_nurbs_interpDrawNurbsInterpDrawNurbsInterpdraw_nurbs_interp (算子)
名称
draw_nurbs_interpT_draw_nurbs_interpDrawNurbsInterpDrawNurbsInterpdraw_nurbs_interp — 使用插值交互式绘制 NURBS 曲线。
警告
This operator does not work in an HDevelop graphics window opened with
dev_open_window.
签名
draw_nurbs_interp( : ContOut : WindowHandle, Rotate, Move, Scale, KeepRatio, Degree : ControlRows, ControlCols, Knots, Rows, Cols, Tangents)
Herror T_draw_nurbs_interp(Hobject* ContOut, const Htuple WindowHandle, const Htuple Rotate, const Htuple Move, const Htuple Scale, const Htuple KeepRatio, const Htuple Degree, Htuple* ControlRows, Htuple* ControlCols, Htuple* Knots, Htuple* Rows, Htuple* Cols, Htuple* Tangents)
void DrawNurbsInterp(HObject* ContOut, const HTuple& WindowHandle, const HTuple& Rotate, const HTuple& Move, const HTuple& Scale, const HTuple& KeepRatio, const HTuple& Degree, HTuple* ControlRows, HTuple* ControlCols, HTuple* Knots, HTuple* Rows, HTuple* Cols, HTuple* Tangents)
void HXLDCont::DrawNurbsInterp(const HWindow& WindowHandle, const HString& Rotate, const HString& Move, const HString& Scale, const HString& KeepRatio, Hlong Degree, HTuple* ControlRows, HTuple* ControlCols, HTuple* Knots, HTuple* Rows, HTuple* Cols, HTuple* Tangents)
void HXLDCont::DrawNurbsInterp(const HWindow& WindowHandle, const char* Rotate, const char* Move, const char* Scale, const char* KeepRatio, Hlong Degree, HTuple* ControlRows, HTuple* ControlCols, HTuple* Knots, HTuple* Rows, HTuple* Cols, HTuple* Tangents)
void HXLDCont::DrawNurbsInterp(const HWindow& WindowHandle, const wchar_t* Rotate, const wchar_t* Move, const wchar_t* Scale, const wchar_t* KeepRatio, Hlong Degree, HTuple* ControlRows, HTuple* ControlCols, HTuple* Knots, HTuple* Rows, HTuple* Cols, HTuple* Tangents)
(
Windows only)
HXLDCont HWindow::DrawNurbsInterp(const HString& Rotate, const HString& Move, const HString& Scale, const HString& KeepRatio, Hlong Degree, HTuple* ControlRows, HTuple* ControlCols, HTuple* Knots, HTuple* Rows, HTuple* Cols, HTuple* Tangents) const
HXLDCont HWindow::DrawNurbsInterp(const char* Rotate, const char* Move, const char* Scale, const char* KeepRatio, Hlong Degree, HTuple* ControlRows, HTuple* ControlCols, HTuple* Knots, HTuple* Rows, HTuple* Cols, HTuple* Tangents) const
HXLDCont HWindow::DrawNurbsInterp(const wchar_t* Rotate, const wchar_t* Move, const wchar_t* Scale, const wchar_t* KeepRatio, Hlong Degree, HTuple* ControlRows, HTuple* ControlCols, HTuple* Knots, HTuple* Rows, HTuple* Cols, HTuple* Tangents) const
(
Windows only)
static void HOperatorSet.DrawNurbsInterp(out HObject contOut, HTuple windowHandle, HTuple rotate, HTuple move, HTuple scale, HTuple keepRatio, HTuple degree, out HTuple controlRows, out HTuple controlCols, out HTuple knots, out HTuple rows, out HTuple cols, out HTuple tangents)
void HXLDCont.DrawNurbsInterp(HWindow windowHandle, string rotate, string move, string scale, string keepRatio, int degree, out HTuple controlRows, out HTuple controlCols, out HTuple knots, out HTuple rows, out HTuple cols, out HTuple tangents)
HXLDCont HWindow.DrawNurbsInterp(string rotate, string move, string scale, string keepRatio, int degree, out HTuple controlRows, out HTuple controlCols, out HTuple knots, out HTuple rows, out HTuple cols, out HTuple tangents)
def draw_nurbs_interp(window_handle: HHandle, rotate: str, move: str, scale: str, keep_ratio: str, degree: int) -> Tuple[HObject, Sequence[float], Sequence[float], Sequence[float], Sequence[float], Sequence[float], Sequence[float]]
描述
draw_nurbs_interpdraw_nurbs_interpDrawNurbsInterpDrawNurbsInterpDrawNurbsInterpdraw_nurbs_interp returns the contour ContOutContOutContOutContOutcontOutcont_out of a
NURBS curve of degree DegreeDegreeDegreeDegreedegreedegree, which has been created
interactively by the user in the window WindowHandleWindowHandleWindowHandleWindowHandlewindowHandlewindow_handle using
interpolation. That means, that the user specifies a set of points and
the operator computes the parameters of a NURBS curve that includes
this points. By contrast, using the Operator draw_nurbsdraw_nurbsDrawNurbsDrawNurbsDrawNurbsdraw_nurbs it is
possible to create a NURBS curve by drawing its control polygon.
In addition to ContOutContOutContOutContOutcontOutcont_out, the control information of the curve
(ControlRowsControlRowsControlRowsControlRowscontrolRowscontrol_rows, ControlColsControlColsControlColsControlColscontrolColscontrol_cols, 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_xldGenContourNurbsXldGenContourNurbsXldGenContourNurbsXldgen_contour_nurbs_xld。For more information on NURBS see the
documentation of gen_contour_nurbs_xldgen_contour_nurbs_xldGenContourNurbsXldGenContourNurbsXldGenContourNurbsXldgen_contour_nurbs_xld。
Directly after calling draw_nurbs_interpdraw_nurbs_interpDrawNurbsInterpDrawNurbsInterpDrawNurbsInterpdraw_nurbs_interp, you can add interpolation
points by clicking with the left mouse button in the window at the desired
positions. If enough points are specified (at least DegreeDegreeDegreeDegreedegreedegree-1),
a NURBS curve that goes through all specified points (in the
order of their generation) is computed and displayed.
When there are three points or more, the first and the last point will be
marked with an additional square. By clicking on them
you can close the curve or open it again. You delete the point appended last
by pressing the Ctrl key.
The tangents (i.e. the first derivative of the curve) of the first
and the last point are displayed as lines. They can be modified by dragging
their ends using the mouse.
Existing points can be moved by dragging them with the mouse. Further
new points on the curve can be inserted by a left click on the desired
position on the curve.
By pressing the Shift key, you can switch into the transformation mode.
In this mode you can rotate, move, and scale the curve 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
and the two tangents, 3 symbols are displayed with the curve: 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
-
move the curve by clicking the left mouse button on the cross in
the center and then dragging it to the new position,
-
rotate it by clicking with the left mouse button on the arrow and
then dragging it, till the curve has the right direction, and
-
scale it by dragging the double arrow. To keep the ratio, the
parameter KeepRatioKeepRatioKeepRatioKeepRatiokeepRatiokeep_ratio has to be set to 'true'"true""true""true""true""true".
By pressing the Shift key again you can switch back to the edit mode.
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_colorset_colorSetColorSetColorSetColorset_color, set_coloredset_coloredSetColoredSetColoredSetColoredset_colored,
set_line_widthset_line_widthSetLineWidthSetLineWidthSetLineWidthset_line_width, and set_line_styleset_line_styleSetLineStyleSetLineStyleSetLineStyleset_line_style。The tangents and all
handles are displayed in the second color set by set_colorset_colorSetColorSetColorSetColorset_color or
set_coloredset_coloredSetColoredSetColoredSetColoredset_colored。Their line width is fixed to 1 and their line style is
fixed to a drawn-through line.
注意
In contrast to draw_nurbsdraw_nurbsDrawNurbsDrawNurbsDrawNurbsdraw_nurbs, 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.
执行信息
- 多线程类型：可重入（与非独占算子并行运行）。
- 多线程作用域：全局（可从任何线程调用）。
- 未采用并行化处理。
参数
ContOutContOutContOutContOutcontOutcont_out (输出对象) xld_cont → objectHXLDContHObjectHXLDContHobject *
Contour of the curve.
WindowHandleWindowHandleWindowHandleWindowHandlewindowHandlewindow_handle (输入控制) window → HWindow, HTupleHHandleHTupleHtuple (handle) (IntPtr) (HHandle) (handle)
窗口句柄。
RotateRotateRotateRotaterotaterotate (输入控制) string → HTuplestrHTupleHtuple (string) (string) (HString) (char*)
Enable rotation?
默认值：
'true'
"true"
"true"
"true"
"true"
"true"
值列表：
'false'"false""false""false""false""false", 'true'"true""true""true""true""true"
MoveMoveMoveMovemovemove (输入控制) string → HTuplestrHTupleHtuple (string) (string) (HString) (char*)
Enable moving?
默认值：
'true'
"true"
"true"
"true"
"true"
"true"
值列表：
'false'"false""false""false""false""false", 'true'"true""true""true""true""true"
ScaleScaleScaleScalescalescale (输入控制) string → HTuplestrHTupleHtuple (string) (string) (HString) (char*)
Enable scaling?
默认值：
'true'
"true"
"true"
"true"
"true"
"true"
值列表：
'false'"false""false""false""false""false", 'true'"true""true""true""true""true"
KeepRatioKeepRatioKeepRatioKeepRatiokeepRatiokeep_ratio (输入控制) string → HTuplestrHTupleHtuple (string) (string) (HString) (char*)
Keep ratio while scaling?
默认值：
'true'
"true"
"true"
"true"
"true"
"true"
值列表：
'false'"false""false""false""false""false", 'true'"true""true""true""true""true"
DegreeDegreeDegreeDegreedegreedegree (输入控制) integer → HTupleintHTupleHtuple (integer) (int / long) (Hlong) (Hlong)
The degree p of the NURBS curve.
Reasonable values are 3 to 5.
默认值：
3
建议值：
2, 3, 4, 5
限制：
Degree >= 2 && Degree <= 9
ControlRowsControlRowsControlRowsControlRowscontrolRowscontrol_rows (输出控制) coordinates.y-array → HTupleSequence[float]HTupleHtuple (real) (double) (double) (double)
Row coordinates of the control polygon.
ControlColsControlColsControlColsControlColscontrolColscontrol_cols (输出控制) coordinates.x-array → HTupleSequence[float]HTupleHtuple (real) (double) (double) (double)
Column coordinates of the control polygon.
KnotsKnotsKnotsKnotsknotsknots (输出控制) real-array → HTupleSequence[float]HTupleHtuple (real) (double) (double) (double)
Knot vector.
RowsRowsRowsRowsrowsrows (输出控制) coordinates.y-array → HTupleSequence[float]HTupleHtuple (real) (double) (double) (double)
Row coordinates of the points specified by the user.
ColsColsColsColscolscols (输出控制) coordinates.x-array → HTupleSequence[float]HTupleHtuple (real) (double) (double) (double)
Column coordinates of the points specified by the user.
TangentsTangentsTangentsTangentstangentstangents (输出控制) real-array → HTupleSequence[float]HTupleHtuple (real) (double) (double) (double)
Tangents specified by the user.
结果
draw_nurbs_interpdraw_nurbs_interpDrawNurbsInterpDrawNurbsInterpDrawNurbsInterpdraw_nurbs_interp returns 2 (
H_MSG_TRUE)
, if the window is valid。如有必要，则抛出异常。
可能的前趋
open_windowopen_windowOpenWindowOpenWindowOpenWindowopen_window
可能的后继
set_coloredset_coloredSetColoredSetColoredSetColoredset_colored,
set_line_widthset_line_widthSetLineWidthSetLineWidthSetLineWidthset_line_width,
set_drawset_drawSetDrawSetDrawSetDrawset_draw,
set_insertset_insertSetInsertSetInsertSetInsertset_insert
替代
draw_xlddraw_xldDrawXldDrawXldDrawXlddraw_xld,
draw_nurbsdraw_nurbsDrawNurbsDrawNurbsDrawNurbsdraw_nurbs
另见
draw_nurbs_interp_moddraw_nurbs_interp_modDrawNurbsInterpModDrawNurbsInterpModDrawNurbsInterpModdraw_nurbs_interp_mod,
draw_nurbsdraw_nurbsDrawNurbsDrawNurbsDrawNurbsdraw_nurbs,
gen_contour_nurbs_xldgen_contour_nurbs_xldGenContourNurbsXldGenContourNurbsXldGenContourNurbsXldgen_contour_nurbs_xld
模块
基础