disp_textT_disp_textDispTextDispText (Operator)

Name

disp_textT_disp_textDispTextDispText — Ausgabe von Text in ein Fenster.

Signatur

Beschreibung

disp_textdisp_textDispTextDispTextDispText gibt Text im Grafikfenster WindowHandleWindowHandleWindowHandleWindowHandlewindowHandle an der Position (RowRowRowRowrow,ColumnColumnColumnColumncolumn) aus.

Wird nur eine Position übergeben, wird für jedes Element in StringStringStringStringstringVal eine Textzeile ausgegeben. Außerdem wird auch '\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" erreicht werden.

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

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

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

Der Parameter ColorColorColorColorcolor 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_textDispTextDispTextDispText kann den StringStringStringStringstringVal innerhalb einer Box anzeigen. Dieses Verhalten und das Aussehen der Box wird mit den generischen Parametern in GenParamNameGenParamNameGenParamNameGenParamNamegenParamName und GenParamValueGenParamValueGenParamValueGenParamValuegenParamValue beeinflusst.

'box'

Ist 'box'"box""box""box""box" auf '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" und 'false'"false""false""false""false"

Vorgegebener Wert: '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", 'red'"red""red""red""red" oder '#aa00bba0'"#aa00bba0""#aa00bba0""#aa00bba0""#aa00bba0")

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

'shadow'

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

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

Vorgegebener Wert: 'true'"true""true""true""true" wenn 'box_color'"box_color""box_color""box_color""box_color" auf eine Farbe ohne Alphawert gesetzt wurde, ansonsten '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", 'red'"red""red""red""red" oder '#aa00bba0'"#aa00bba0""#aa00bba0""#aa00bba0""#aa00bba0")

Vorgegebener Wert: '#f28d26'"#f28d26""#f28d26""#f28d26""#f28d26" (ein dunkleres Orange) wenn 'box_color'"box_color""box_color""box_color""box_color" nicht gesetzt wurde, ansonsten '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") und Zeilenrichtung ('shadow_dy'"shadow_dy""shadow_dy""shadow_dy""shadow_dy") in Pixeln.

Mögliche Werte: reelle Zahlen

Vorgegebener Wert: 2

Achtung

disp_textdisp_textDispTextDispTextDispText benötigt die Bibliothek libcanvas, die auf Embedded-Systemen möglicherweise nicht verfügbar ist.

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

Beispiel (HDevelop)

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

Vorgänger

open_windowopen_windowOpenWindowOpenWindowOpenWindow, set_fontset_fontSetFontSetFontSetFont, get_string_extentsget_string_extentsGetStringExtentsGetStringExtentsGetStringExtents

Alternativen

write_stringwrite_stringWriteStringWriteStringWriteString

Siehe auch

get_string_extentsget_string_extentsGetStringExtentsGetStringExtentsGetStringExtents, set_fontset_fontSetFontSetFontSetFont

Modul

Foundation