set_window_param
— Setzen von Fensterparametern.
set_window_param( : : WindowHandle, Param, Value : )
Mit set_window_param
können verschieden Parameter eines
geöffneten Fensters verändert werden.
Allgemeine Fensterparameter:
Ist 'flush' auf 'true' gesetzt, wird der Fensterinhalt
nach Anzeige jedes Objektes aktualisiert. Ist es auf 'false'
gesetzt, muss der Fensterinhalt explizit mit dem Operator
flush_buffer
aktualisiert werden. Wenn Sie mit dem Inhalt des
Grafikfensters interagieren wollen (z. Bsp. den Inhalt zoomen oder
bewegen), müssen Sie vorher 'flush' auf 'true' setzen.
mögliche Werte: 'true', 'false'
vorgegebener Wert: 'true'
Beeinflusst die Qualität der Anzeige von Regionen. Besonders wenn Regionen
für die Visualisierung verkleinert werden müssen, liefert
'good' ein genaueres und ansprechenderes Ergebnis.
'low' ist in diesem Fall etwas ungenauer, dafür aber deutlich
schneller. Wird nur der Rand von Regionen dargestellt (siehe
set_draw
), wird der Nachkommanteil der Linienbreite
(siehe set_line_width
) ignoriert.
mögliche Werte: 'low', 'good'
vorgegebener Wert: 'low'
Setzt die Hintergrundfarbe des Fensters WindowHandle
. Der
Operator clear_window
benutzt diese Farbe, um das Fenster zu
leeren.
mögliche Werte: ein String mit dem Namen einer Farbe (z.B. 'black')
Dieser Parameter erlaubt es, den Text in der Titelzeile eines HALCON Fensters zu ändern.
mögliche Werte: ein String mit bis zu 1023 Zeichen
Ist 'anti_aliasing' auf 'true' gesetzt, werden Konturen und Regionen mit Antialiasing dargestellt.
mögliche Werte: 'true', 'false'
vorgegebener Wert: 'true'
Aktiviert/deaktiviert den Grafikstack des Fensters. Ist der Stack
aktiviert, werden beim Ändern des Fensterausschnitts mit
set_part
vorher dargestellte Objekte unter Berücksichtigung
des neuen Fensterausschnitts nochmals gezeichnet. Damit ist es einfach
möglich den Fensterinhalt zu skalieren oder zu verschieben.
Dieser Parameter hat keinen Einfluss auf den Grafikstack eines HDevelop
Grafikfensters.
mögliche Werte: 'true', 'false'
vorgegebener Wert: 'false'
Maximale Anzahl von Elementen im Grafikstack. Das entspricht der Anzahl der Visualisierungsoperationen die im Stack gespeichert werden. Dieser Parameter hat keinen Einfluss auf den Grafikstack eines HDevelop Grafikfensters und ist erst beim Aufruf des nächsten Visualisierungsoperators wirksam.
mögliche Werte: positive Anzahl oder 'unlimited'
vorgegebener Wert: 50
Limitiert den Speicher, welchen der Grafikstack verbraucht. Wird dieses Limit überschritten werden ältere Visualisierungsoperationen aus dem Stack entfernt. Dieser Parameter hat keinen Einfluss auf den Grafikstack eines HDevelop Grafikfensters und ist erst beim Aufruf des nächsten Visualisierungsoperators wirksam.
mögliche Werte: Speichergrenze in Bytes oder 'unlimited'
vorgegebener Wert 'unlimited'
Parameter die den '3d_plot' Plot (siehe set_paint
) betreffen:
Setzt den Öffnungswinkel der virtuellen Kamera, die für das Anzeigen des 3D-Plots verwendet wird. Der Winkel muss im Bogenmaß angegeben werden und im Intervall [0,PI) liegen. Ein Winkel von 0 entspricht der Orthogonalprojektion. Es kann auch der String 'orthogonal' übergeben werden, um Orthogonalprojektion auszuwählen.
mögliche Werte: 'orthogonal' oder ein Winkel im Bogenmaß
vorgegebener Wert: 1.22173 (entspricht 70 Grad)
Die Beschriftungen der Zeilen-, Spalten- und Höhenachse können gesetzt werden, indem diesem Parameter ein Tupel aus drei Strings übergeben wird. Die Reihenfolge der Strings ist Zeilenbeschriftung, Spaltenbeschriftung und Höhenbeschriftung.
mögliche Werte: Tupel aus Strings mit bis zu 31 Zeichen
vorgegebener Wert: [' ',' ',' ']
Die Farbe der Beschriftungen der Zeilen-, Spalten- und Höhenachse. Es kann entweder eine Farbe für alle drei Achsen oder ein Tupel mit individuellen Farben für jede Achse übergeben werden.
mögliche Werte: ein String oder ein Tupel mit drei Strings mit dem Namen einer Farbe (z.B. 'black')
vorgegebener Wert: 'black'
Beeinflusst die Qualität des 3D Plots. Abhängig von der Leistungsfähigkeit der Grafikkarte kann bessere Qualität zu einem signifikanten Anstieg der benötigten Rechenzeit für den 3D Plot führen.
mögliche Werte: 'low' , 'medium' , 'good' , 'best'
vorgegebener Wert: 'medium'
Ist 'scale_plot' auf 'true' gesetzt, werden die Höhenwerte eine Bildes vor dem Anzeigen in das Intervall [0,255] transformiert. Ist 'false' gesetzt, werden die Seitenverhältnisse zwischen Spalte, Zeile und Höhe berücksichtigt. Bilder des Typs 'byte', 'cyclic' oder 'direction' werden nicht skaliert, d.h. in deren Fall wird dieser Parameter ignoriert.
mögliche Werte: 'true' , 'false'
vorgegebener Wert: 'true'
Ist 'display_grid' auf 'true' gesetzt, wird ein Gitter auf Höhe null eingeblendet.
mögliche Werte: 'true' , 'false'
vorgegebener Wert: 'true'
Ist 'display_axes' auf 'true' gesetzt, werden die Koordinatenachsen eingeblendet.
mögliche Werte: 'true' , 'false'
vorgegebener Wert: 'true'
Die Parameter 'anti_aliasing' , 'flush' , 'graphics_stack' , 'graphics_stack_max_element_num' , 'graphics_stack_max_memory_size' und 'region_quality' benötigen die Bibliothek libcanvas, die auf Embedded-Systemen möglicherweise nicht verfügbar ist.
WindowHandle
(input_control) window →
(handle)
Fenster-Handle.
Param
(input_control) string →
(string)
Name des Parameters.
Defaultwert: 'flush'
Werteliste: 'angle_of_view' , 'anti_aliasing' , 'axis_captions' , 'background_color' , 'caption_color' , 'display_axes' , 'display_grid' , 'flush' , 'graphics_stack' , 'graphics_stack_max_element_num' , 'graphics_stack_max_memory_size' , 'plot_quality' , 'region_quality' , 'scale_plot' , 'window_title'
Value
(input_control) string(-array) →
(string / real / integer)
Zu setzender Wert.
Defaultwert: 'false'
Werteliste: 'best' , 'black' , 'blue' , 'false' , 'good' , 'green' , 'low' , 'medium' , 'orthogonal' , 'red' , 'true' , 'unlimited' , 'white'
get_window_param
,
set_window_attr
,
set_part_style
Foundation