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.
Werteliste: 'true', 'false'.
Default: '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 Nachkommaanteil der Linienbreite
(siehe set_line_width) ignoriert.
Werteliste: 'low', 'good'.
Default: 'low'.
Setzt die Hintergrundfarbe des Fensters WindowHandle. Der
Operator clear_window benutzt diese Farbe, um das Fenster zu
leeren.
Wertevorschläge: ein String mit dem Namen einer Farbe (z.B. 'black').
Dieser Parameter erlaubt es, den Text in der Titelzeile eines HALCON Fensters zu ändern.
Beachten Sie, dass Sie 'window_title' nicht für Pufferfenster
setzen können.
Diese Einschränkung gilt auch für HDevelop-Fenster, d.h. Fenster, die
über dev_open_window geöffnet werden und die tatsächlich
Pufferfenster sind.
Wertebereich: ein String mit bis zu 1023 Zeichen.
Ist 'anti_aliasing' auf 'true' gesetzt, werden Konturen und Regionen mit Antialiasing dargestellt.
Werteliste: 'true', 'false'.
Default: '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.
Werteliste: 'true', 'false'.
Default: '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.
Wertevorschläge: positive Anzahl oder 'unlimited'.
Default: 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.
Wertevorschläge: Speichergrenze in Bytes oder 'unlimited'.
Default: 'unlimited'.
Aktiviert/deaktiviert das Pixelgitter. Ist das Pixelgitter aktiviert, wird ab einer ausreichend starken Vergrößerung des Bildausschnittes ein Gitter um die dargestellten Pixel gezeichnet (siehe 'pixel_grid_min_resolution'). Dieser Parameter ist erst wirksam sobald der Fensterinhalt aktualisiert wird.
Werteliste: 'true', 'false'.
Default: 'false'.
Restriktion:
Hat keinen Effekt, wenn die HDevelop Option
Pixel Grid aktiviert ist.
Gibt die minimal notwendige Auflösung eines Pixels im Grafikfenster an, welche notwendig ist, damit das Pixelgitter gezeichnet wird. Dieser Parameter zeigt nur Wirkung, wenn 'pixel_grid_enable' auf 'true' gesetzt worden ist. Angenommen dieser Wert wird auf 20 gesetzt, dann wird das Pixelgitter sichtbar, sobald ein Pixel des dargestellten Bildausschnittes mindestens 20 x 20 Pixel im Grafikfenster einnimmt. Außerdem ist dieser Parameter erst wirksam sobald der Fensterinhalt aktualisiert wird.
Wertevorschläge: Positive ganze Zahl (Integer).
Default: 20.
Gibt die Farbe der Linien des Pixelgitters an. Dieser Parameter zeigt nur Wirkung, wenn 'pixel_grid_enable' auf 'true' gesetzt worden ist. Außerdem ist dieser Parameter erst wirksam sobald der Fensterinhalt aktualisiert wird.
Wertevorschläge:
Farbwert, siehe set_color für eine
Übersicht.
Default: '#696969c0'.
Restriktion:
Hat keinen Effekt, wenn die HDevelop Option
Pixel Grid aktiviert ist.
Legt die Strichstärke in Pixeln fest, die zur Darstellung der Linien des Pixelgitters verwendet wird. Dieser Parameter zeigt nur Wirkung, wenn 'pixel_grid_enable' auf 'true' gesetzt worden ist. Außerdem ist dieser Parameter erst wirksam sobald der Fensterinhalt aktualisiert wird.
Wertebereich: [1.0, 2000.0].
Default: 1.0.
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.
Wertevorschläge: 'orthogonal' oder ein Winkel im Bogenmaß.
Default: 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.
Wertebereich: Tupel aus Strings mit bis zu 31 Zeichen.
Default: [' ',' ',' '].
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.
Wertevorschläge: ein String oder ein Tupel mit drei Strings mit dem Namen einer Farbe (z.B. 'black').
Default: '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.
Werteliste: 'low', 'medium', 'good', 'best'.
Default: '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.
Werteliste: 'true', 'false'.
Default: 'true'.
Ist 'display_grid' auf 'true' gesetzt, wird ein Gitter auf Höhe null eingeblendet.
Werteliste: 'true', 'false'.
Default: 'true'.
Ist 'display_axes' auf 'true' gesetzt, werden die Koordinatenachsen eingeblendet.
Werteliste: 'true', 'false'.
Default: '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.
Der Parameter 'window_title' kann nicht für Pufferfenster gesetzt werden.
WindowHandle (input_control) window → (handle)
Fenster-Handle.
Param (input_control) string → (string)
Name des Parameters.
Default: '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', 'pixel_grid_color', 'pixel_grid_enable', 'pixel_grid_line_width', 'pixel_grid_min_resolution', 'plot_quality', 'region_quality', 'scale_plot', 'window_title'
Value (input_control) string(-array) → (string / real / integer)
Zu setzender Wert.
Default: '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