disp_textT_disp_textDispTextdisp_textDispTextDispText (Operator)

Name

disp_textT_disp_textDispTextdisp_textDispTextDispText — Ausgabe von Text in ein Fenster.

Signatur

Beschreibung

disp_textdisp_textDispTextdisp_textDispTextDispText gibt Text im Grafikfenster WindowHandleWindowHandleWindowHandleWindowHandleWindowHandlewindowHandle 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

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

Parallelisierung

• 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_windowOpenWindowopen_windowOpenWindowOpenWindow, set_fontset_fontSetFontset_fontSetFontSetFont, get_string_extentsget_string_extentsGetStringExtentsget_string_extentsGetStringExtentsGetStringExtents

Alternativen

write_stringwrite_stringWriteStringwrite_stringWriteStringWriteString

Siehe auch

get_string_extentsget_string_extentsGetStringExtentsget_string_extentsGetStringExtentsGetStringExtents, set_fontset_fontSetFontset_fontSetFontSetFont

Modul

Foundation