Wählen Sie oben rechts eine andere Programmiersprache aus.

Wählen Sie oben rechts eine andere Programmiersprache aus.

Wählen Sie oben rechts eine andere Programmiersprache aus.

Wählen Sie oben rechts eine andere Programmiersprache aus.

Wählen Sie oben rechts eine andere Programmiersprache aus.

dev_disp_textdev_disp_textDevDispTextdev_disp_textDevDispTextDevDispText (Operator)

Name

dev_disp_textdev_disp_textDevDispTextdev_disp_textDevDispTextDevDispText — Ausgabe von Text in einem Grafikfenster.

Signatur

Beschreibung

dev_disp_textdev_disp_textDevDispTextdev_disp_textDevDispTextDevDispText gibt Text im aktiven Grafikfenster an der Position (RowRowRowRowRowrow,ColumnColumnColumnColumnColumncolumn) aus.

Wird nur eine Position übergeben, wird für jedes Element in StringStringStringStringStringstringVal eine Textzeile ausgegeben. Außerdem wird auch '\n'"\n""\n""\n""\n""\n" als Zeilenumbruch interpretiert.

Werden mehrere Positionen übergeben, ist nur ein einzelner String oder ein String für jede Position zulässig. In diesem Fall kann ein Zeilenumbruch nur über '\n'"\n""\n""\n""\n""\n" erreicht werden.

Zeilenumbrüche ('\n'"\n""\n""\n""\n""\n") am Ende von StringStringStringStringStringstringVal werden ignoriert.

Die Position des Texts kann in Fensterkoordinaten (CoordSystemCoordSystemCoordSystemCoordSystemCoordSystemcoordSystem = 'window'"window""window""window""window""window") oder in Bildkoordinaten (CoordSystemCoordSystemCoordSystemCoordSystemCoordSystemcoordSystem = 'image'"image""image""image""image""image"), was für gezoomte Bilder nützlich ist, angegeben werden.

Zusätzlich zu (RowRowRowRowRowrow,ColumnColumnColumnColumnColumncolumn) Koordinaten können auch vordefinierte Werte an RowRowRowRowRowrow und ColumnColumnColumnColumnColumncolumn übergeben werden um Text an festen Positionen im Fenster anzuzeigen (nur für CoordSystemCoordSystemCoordSystemCoordSystemCoordSystemcoordSystem = 'window'"window""window""window""window""window").:

Der Parameter ColorColorColorColorColorcolor akzeptiert auch Farben-Tupel. In diesem Fall werden die Farben zyklisch für jede neue Textposition (oder für jede Textzeile wenn nur eine Position angegeben wurde) verwendet.

Generische Parameter

disp_textdisp_textDispTextdisp_textDispTextDispText kann den StringStringStringStringStringstringVal innerhalb einer Box anzeigen. Dieses Verhalten und das Aussehen der Box wird mit den generischen Parametern in GenParamNameGenParamNameGenParamNameGenParamNameGenParamNamegenParamName und GenParamValueGenParamValueGenParamValueGenParamValueGenParamValuegenParamValue beeinflusst.

'box'

Ist 'box'"box""box""box""box""box" auf 'true'"true""true""true""true""true" gesetzt, wird der Text innerhalb einer Box angezeigt. Die folgenden Parameter beeinflussen das Aussehen dieser Box und des optionalen Schattens der Box.

Mögliche Werte: 'true'"true""true""true""true""true" und 'false'"false""false""false""false""false"

Vorgegebener Wert: 'true'"true""true""true""true""true"

'box_color'

Setzt die Farbe der Box.

Mögliche Werte: Ein String mit dem Namen der Farbe (z.B. 'white'"white""white""white""white""white", 'red'"red""red""red""red""red" oder '#aa00bba0'"#aa00bba0""#aa00bba0""#aa00bba0""#aa00bba0""#aa00bba0")

Vorgegebener Wert: '#fce9d4'"#fce9d4""#fce9d4""#fce9d4""#fce9d4""#fce9d4" (ein helles Orange)

'shadow'

Wird 'shadow'"shadow""shadow""shadow""shadow""shadow" auf 'true'"true""true""true""true""true" gesetzt, wird zusätzlich ein Schatten zu der Box angezeigt.

Mögliche Werte: 'true'"true""true""true""true""true" und 'false'"false""false""false""false""false"

Vorgegebener Wert: 'true'"true""true""true""true""true" wenn 'box_color'"box_color""box_color""box_color""box_color""box_color" auf eine Farbe ohne Alphawert gesetzt wurde, ansonsten 'false'"false""false""false""false""false"

'shadow_color'

Setzt die Farbe des Schattens.

Mögliche Werte: Ein String mit dem Namen der Farbe (z.B. 'black'"black""black""black""black""black", 'red'"red""red""red""red""red" oder '#aa00bba0'"#aa00bba0""#aa00bba0""#aa00bba0""#aa00bba0""#aa00bba0")

Vorgegebener Wert: '#f28d26'"#f28d26""#f28d26""#f28d26""#f28d26""#f28d26" (ein dunkleres Orange) wenn 'box_color'"box_color""box_color""box_color""box_color""box_color" nicht gesetzt wurde, ansonsten 'white'"white""white""white""white""white"

'border_radius'

Setzt die Abrundung der Ecken der Box. Für scharfe Ecken muss dieser Parameter auf 0, für abgerundete Ecken auf höhere Werte gesetzt werden.

Mögliche Werte: positive reelle Zahl oder 0

Vorgegebener Wert: 2

'box_padding'

Bestimmt, wie stark die Box über den Text hinaus geht.

Mögliche Werte: positive reelle Zahl

Vorgegebener Wert: 0

'shadow_sigma'

Bestimmt, wie stark der Schatten hinter der Box weichgezeichnet wird. Für scharfe Schatten muss dieser Parameter auf 0 gesetzt werden.

Mögliche Werte: positive reelle Zahl oder 0

Vorgegebener Wert: 1.5

'shadow_dx' and 'shadow_dy'

Der Offset des Schattens in Spalten- ('shadow_dx'"shadow_dx""shadow_dx""shadow_dx""shadow_dx""shadow_dx") und Zeilenrichtung ('shadow_dy'"shadow_dy""shadow_dy""shadow_dy""shadow_dy""shadow_dy") in Pixeln.

Mögliche Werte: reelle Zahlen

Vorgegebener Wert: 2

Achtung

Beim Export von HDevelop-Programmen ist zu beachten, dass der für diesen Operator generierte Code sich anders verhalten kann, als der entsprechende HALCON-Operator. Eine detaillierte Beschreibung der Besonderheiten, die beim Export von grafischen HDevelop-Operatoren zu beachten sind, findet sich im „HDevelop User's Guide“ im Kapitel Code Export -> General Aspects of Code Generation -> Graphics Windows.

Parameter

Beispiel (HDevelop)

dev_open_window (0, 0, 512, 512, 'black', WindowHandle)
dev_disp_text ('Display some text in a box', 'window', 12, 12, \
               'black', [], [])

Ergebnis

Sind die Parameterwerte korrekt, dann liefert dev_disp_textdev_disp_textDevDispTextdev_disp_textDevDispTextDevDispText den Wert 2 (H_MSG_TRUE). Andernfalls wird eine Fehlerbehandlung durchgeführt und ein Fehlercode zurückgeliefert.

Vorgänger

dev_open_windowdev_open_windowDevOpenWindowdev_open_windowDevOpenWindowDevOpenWindow, set_fontset_fontSetFontset_fontSetFontSetFont, get_string_extentsget_string_extentsGetStringExtentsget_string_extentsGetStringExtentsGetStringExtents

Alternativen

disp_textdisp_textDispTextdisp_textDispTextDispText, write_stringwrite_stringWriteStringwrite_stringWriteStringWriteString

Siehe auch

get_string_extentsget_string_extentsGetStringExtentsget_string_extentsGetStringExtentsGetStringExtents, set_fontset_fontSetFontset_fontSetFontSetFont

Modul

Foundation