draw_nurbsT_draw_nurbsDrawNurbsDrawNurbsdraw_nurbs (Operator)
Name
draw_nurbsT_draw_nurbsDrawNurbsDrawNurbsdraw_nurbs — Interaktives Erstellen einer NURBS-Kurve.
Warnung
Dieser Operator kann nicht in HDevelop-Grafikfenstern verwendet werden, die
mit dev_open_window geöffnet wurden.
Signatur
void DrawNurbs(HObject* ContOut, const HTuple& WindowHandle, const HTuple& Rotate, const HTuple& Move, const HTuple& Scale, const HTuple& KeepRatio, const HTuple& Degree, HTuple* Rows, HTuple* Cols, HTuple* Weights)
void HXLDCont::DrawNurbs(const HWindow& WindowHandle, const HString& Rotate, const HString& Move, const HString& Scale, const HString& KeepRatio, Hlong Degree, HTuple* Rows, HTuple* Cols, HTuple* Weights)
void HXLDCont::DrawNurbs(const HWindow& WindowHandle, const char* Rotate, const char* Move, const char* Scale, const char* KeepRatio, Hlong Degree, HTuple* Rows, HTuple* Cols, HTuple* Weights)
void HXLDCont::DrawNurbs(const HWindow& WindowHandle, const wchar_t* Rotate, const wchar_t* Move, const wchar_t* Scale, const wchar_t* KeepRatio, Hlong Degree, HTuple* Rows, HTuple* Cols, HTuple* Weights)
(
Nur Windows)
HXLDCont HWindow::DrawNurbs(const HString& Rotate, const HString& Move, const HString& Scale, const HString& KeepRatio, Hlong Degree, HTuple* Rows, HTuple* Cols, HTuple* Weights) const
HXLDCont HWindow::DrawNurbs(const char* Rotate, const char* Move, const char* Scale, const char* KeepRatio, Hlong Degree, HTuple* Rows, HTuple* Cols, HTuple* Weights) const
HXLDCont HWindow::DrawNurbs(const wchar_t* Rotate, const wchar_t* Move, const wchar_t* Scale, const wchar_t* KeepRatio, Hlong Degree, HTuple* Rows, HTuple* Cols, HTuple* Weights) const
(
Nur Windows)
static void HOperatorSet.DrawNurbs(out HObject contOut, HTuple windowHandle, HTuple rotate, HTuple move, HTuple scale, HTuple keepRatio, HTuple degree, out HTuple rows, out HTuple cols, out HTuple weights)
void HXLDCont.DrawNurbs(HWindow windowHandle, string rotate, string move, string scale, string keepRatio, int degree, out HTuple rows, out HTuple cols, out HTuple weights)
HXLDCont HWindow.DrawNurbs(string rotate, string move, string scale, string keepRatio, int degree, out HTuple rows, out HTuple cols, out HTuple weights)
Beschreibung
draw_nurbsdraw_nurbsDrawNurbsDrawNurbsdraw_nurbs liefert die Kontur ContOutContOutContOutcontOutcont_out und
Kontrollinformationen (RowsRowsRowsrowsrows, ColsColsColscolscols und
WeightsWeightsWeightsweightsweights) einer NURBS-Kurve, die interaktiv durch den Benutzer
im Fenster WindowHandleWindowHandleWindowHandlewindowHandlewindow_handle erzeugt worden ist. Zusätzliche
Informationen über NURBS-Kurven finden sich in der Dokumentation des
Operators gen_contour_nurbs_xldgen_contour_nurbs_xldGenContourNurbsXldGenContourNurbsXldgen_contour_nurbs_xld. Um die Kontrollinformationen
RowsRowsRowsrowsrows, ColsColsColscolscols und WeightsWeightsWeightsweightsweights in einem Aufruf des
Operators gen_contour_nurbs_xldgen_contour_nurbs_xldGenContourNurbsXldGenContourNurbsXldgen_contour_nurbs_xld zu verwenden, muss dort der
Knotenvektor KnotsKnotsKnotsknotsknots auf 'auto'"auto""auto""auto""auto" gesetzt werden.
Die NURBS-Kurve wird durch Manipulation ihres Kontrollpolygons gezeichnet.
Dagegen wird die NURBS-Kurve mit dem Operator draw_nurbs_interpdraw_nurbs_interpDrawNurbsInterpDrawNurbsInterpdraw_nurbs_interp
durch Interpolation von Stützstellen (die interaktiv manipuliert werden
können) erzeugt.
Direkt nach dem Aufruf von draw_nurbsdraw_nurbsDrawNurbsDrawNurbsdraw_nurbs kann man durch Drücken der
linken Maustaste Punkte zum Kontrollpolygon hinzufügen.
Der zuletzt angehängte Punkt kann durch Drücken der Steuerungstaste
(Strg, Ctrl) gelöscht werden. Sobald das Kontrollpolygon aus 3 Punkten
besteht, werden der erste und der letzte Punkt mit einem zusätzlichen
Quadrat markiert.
Durch Klicken auf den ersten oder letzten Kontrollpunkt wird die Kurve
geschlossen bzw. wieder geöffnet. Sobald mehr als DegreeDegreeDegreedegreedegree
Kontrollpunkte vorhanden sind, wird die NURBS-Kurve
angezeigt, die durch das Kontrollpolygon und die Gewichte bestimmt ist.
Der zuletzt angefasste Kontrollpunkt wird von einem Kreis umgeben, der
das Gewicht dieses Punktes visualisiert. Die Größe des Kreises und damit
das Gewicht kann durch Ziehen der Kreislinie mit der Maus verändert werden.
Bestehende Kontrollpunkte können mit gedrückter Maustaste verschoben
werden. Außerdem können neue Punkte auf dem Kontrollpolygon eingefügt werden
(um dieses zu verfeinern), indem mit der Maus auf die gewünschte Stelle auf
dem Kontrollpolygon geklickt wird.
Durch Drücken der Umschalttaste kann in den Modus zum Transformieren der
Kurve gewechselt werden.
In diesem Modus kann die Kontur rotiert, verschoben und skaliert werden,
jedoch nur, wenn der entsprechende Parameter (RotateRotateRotaterotaterotate,
MoveMoveMovemovemove, ScaleScaleScalescalescale auf 'true'"true""true""true""true" gesetzt wurde. Die Kontur
wird zusammen mit einem Kreuz in der Mitte, einem Pfeil nach rechts, falls
RotateRotateRotaterotaterotate auf 'true'"true""true""true""true" gesetzt wurde, und einem Doppelpfeil,
falls ScaleScaleScalescalescale auf 'true'"true""true""true""true" gesetzt wurde, dargestellt.
Die Kurve kann
-
verschoben werden, indem man mit der linke Maustaste auf das Kreuz
im Mittelpunkt klickt und dann die Kurve an die neue Position schiebt.
-
rotiert werden, indem man mit der linken Maustaste auf den Pfeil
klickt und die Maus bewegt bis die Kurve die gewünschte Lage eingenommen
hat.
-
skaliert werden, indem der Doppelpfeil verschoben wird. Um das
Seitenverhältnis beim Skalieren beizubehalten, muss der Parameter
KeepRatioKeepRatioKeepRatiokeepRatiokeep_ratio auf 'true'"true""true""true""true" gesetzt werden.
Durch ein weiteres Drücken der Umschalttaste wechselt man zurück in den
Editiermodus. Ein Klick mit der rechten Maustaste beendet die Prozedur.
Das Aussehen der Kurve beim Zeichnen wird durch die Linienbreite, den
Linienstil und die Farbe bestimmt, die mit den Operatoren set_colorset_colorSetColorSetColorset_color,
set_coloredset_coloredSetColoredSetColoredset_colored, set_line_widthset_line_widthSetLineWidthSetLineWidthset_line_width und set_line_styleset_line_styleSetLineStyleSetLineStyleset_line_style
gesetzt werden können. Das Kontrollpolygon und alle Anfasser werden in
der zweiten Farbe gezeichnet, die via set_colorset_colorSetColorSetColorset_color oder
set_coloredset_coloredSetColoredSetColoredset_colored gesetzt wurde. Ihre Linienbreite ist fest auf 1 gesetzt,
außerdem werden ihre Linien durchgezogen gezeichnet.
Ausführungsinformationen
- Multithreading-Typ: reentrant (läuft parallel zu nicht-exklusiven Operatoren).
- Multithreading-Bereich: global (kann von jedem Thread aufgerufen werden).
- Wird ohne Parallelisierung verarbeitet.
Parameter
ContOutContOutContOutcontOutcont_out (output_object) xld_cont → objectHXLDContHObjectHObjectHobject *
Kontur der NURBS-Kurve.
WindowHandleWindowHandleWindowHandlewindowHandlewindow_handle (input_control) window → HWindow, HTupleHHandleHTupleHtuple (handle) (IntPtr) (HHandle) (handle)
Fenster-Handle.
RotateRotateRotaterotaterotate (input_control) string → HTuplestrHTupleHtuple (string) (string) (HString) (char*)
Rotation ermöglichen?
Default:
'true'
"true"
"true"
"true"
"true"
Werteliste:
'false'"false""false""false""false", 'true'"true""true""true""true"
MoveMoveMovemovemove (input_control) string → HTuplestrHTupleHtuple (string) (string) (HString) (char*)
Verschieben ermöglichen?
Default:
'true'
"true"
"true"
"true"
"true"
Werteliste:
'false'"false""false""false""false", 'true'"true""true""true""true"
ScaleScaleScalescalescale (input_control) string → HTuplestrHTupleHtuple (string) (string) (HString) (char*)
Skalieren ermöglichen?
Default:
'true'
"true"
"true"
"true"
"true"
Werteliste:
'false'"false""false""false""false", 'true'"true""true""true""true"
KeepRatioKeepRatioKeepRatiokeepRatiokeep_ratio (input_control) string → HTuplestrHTupleHtuple (string) (string) (HString) (char*)
Seitenverhältnis beim Skalieren beibehalten?
Default:
'true'
"true"
"true"
"true"
"true"
Werteliste:
'false'"false""false""false""false", 'true'"true""true""true""true"
DegreeDegreeDegreedegreedegree (input_control) integer → HTupleintHTupleHtuple (integer) (int / long) (Hlong) (Hlong)
Grad p der Kurve. Vernünftige Werte liegen zwischen 3
und 25.
Default:
3
Wertevorschläge:
2, 3, 4, 5
Restriktion:
Degree >= 2
RowsRowsRowsrowsrows (output_control) coordinates.y-array → HTupleSequence[float]HTupleHtuple (real) (double) (double) (double)
Zeilenkoordinaten des Kontrollpolygons.
ColsColsColscolscols (output_control) coordinates.x-array → HTupleSequence[float]HTupleHtuple (real) (double) (double) (double)
Spaltenkoordinaten des Kontrollpolygons.
WeightsWeightsWeightsweightsweights (output_control) real-array → HTupleSequence[float]HTupleHtuple (real) (double) (double) (double)
Gewichtsvektor.
Ergebnis
draw_nurbsdraw_nurbsDrawNurbsDrawNurbsdraw_nurbs liefert den Wert 2 (
H_MSG_TRUE)
, falls das Fenster gültig ist.
Ansonsten wird eine Fehlerbehandlung durchgeführt.
Vorgänger
open_windowopen_windowOpenWindowOpenWindowopen_window
Nachfolger
set_coloredset_coloredSetColoredSetColoredset_colored,
set_line_widthset_line_widthSetLineWidthSetLineWidthset_line_width,
set_drawset_drawSetDrawSetDrawset_draw
Alternativen
draw_xlddraw_xldDrawXldDrawXlddraw_xld,
draw_nurbs_interpdraw_nurbs_interpDrawNurbsInterpDrawNurbsInterpdraw_nurbs_interp
Siehe auch
draw_nurbs_moddraw_nurbs_modDrawNurbsModDrawNurbsModdraw_nurbs_mod,
draw_nurbs_interpdraw_nurbs_interpDrawNurbsInterpDrawNurbsInterpdraw_nurbs_interp,
gen_contour_nurbs_xldgen_contour_nurbs_xldGenContourNurbsXldGenContourNurbsXldgen_contour_nurbs_xld
Modul
Foundation