dev_disp_textdev_disp_textDevDispTextDevDispText (Operator)
Name
dev_disp_textdev_disp_textDevDispTextDevDispText — Ausgabe von Text in einem Grafikfenster.
Signatur
Herror dev_disp_text(const char* String, const char* CoordSystem, const Hlong Row, const Hlong Column, const char* Color, const char* GenParamName, const char* GenParamValue)
Herror T_dev_disp_text(const Htuple String, const Htuple CoordSystem, const Htuple Row, const Htuple Column, const Htuple Color, const Htuple GenParamName, const Htuple GenParamValue)
void DevDispText(const HTuple& String, const HTuple& CoordSystem, const HTuple& Row, const HTuple& Column, const HTuple& Color, const HTuple& GenParamName, const HTuple& GenParamValue)
static void HWindow::DevDispText(const HTuple& String, const HString& CoordSystem, const HTuple& Row, const HTuple& Column, const HTuple& Color, const HTuple& GenParamName, const HTuple& GenParamValue)
static void HWindow::DevDispText(const HString& String, const HString& CoordSystem, Hlong Row, Hlong Column, const HString& Color, const HString& GenParamName, const HString& GenParamValue)
static void HWindow::DevDispText(const char* String, const char* CoordSystem, Hlong Row, Hlong Column, const char* Color, const char* GenParamName, const char* GenParamValue)
static void HWindow::DevDispText(const wchar_t* String, const wchar_t* CoordSystem, Hlong Row, Hlong Column, const wchar_t* Color, const wchar_t* GenParamName, const wchar_t* GenParamValue)
(Nur Windows)
static void HOperatorSet.DevDispText(HTuple stringVal, HTuple coordSystem, HTuple row, HTuple column, HTuple color, HTuple genParamName, HTuple genParamValue)
static void HWindow.DevDispText(HTuple stringVal, string coordSystem, HTuple row, HTuple column, HTuple color, HTuple genParamName, HTuple genParamValue)
static void HWindow.DevDispText(string stringVal, string coordSystem, int row, int column, string color, string genParamName, string genParamValue)
Beschreibung
dev_disp_textdev_disp_textDevDispTextDevDispTextDevDispText gibt Text im aktiven Grafikfenster 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").:
|
'top'"top""top""top""top", 'left'"left""left""left""left" |
'top'"top""top""top""top", 'center'"center""center""center""center" |
'top'"top""top""top""top", 'right'"right""right""right""right" |
|
'center'"center""center""center""center", 'left'"left""left""left""left" |
'center'"center""center""center""center", 'center'"center""center""center""center" |
'center'"center""center""center""center", 'right'"right""right""right""right" |
|
'bottom'"bottom""bottom""bottom""bottom", 'left'"left""left""left""left" |
'bottom'"bottom""bottom""bottom""bottom", 'center'"center""center""center""center" |
'bottom'"bottom""bottom""bottom""bottom", 'right'"right""right""right""right"
|
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
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
StringStringStringStringstringVal (input_control) string(-array) → HTupleHTupleHtuple (string) (string) (HString) (char*)
Ein Tupel von Strings mit den anzuzeigenden Texten.
Jeder String wird in einer Zeile ausgegeben.
Defaultwert:
'hello'
"hello"
"hello"
"hello"
"hello"
CoordSystemCoordSystemCoordSystemCoordSystemcoordSystem (input_control) string → HTupleHTupleHtuple (string) (string) (HString) (char*)
Koordinatensystem für die Textposition. 'window' steht für das
Fensterkoordinatensystem, 'image' für das
Bildkoordinatensystem.
Defaultwert:
'window'
"window"
"window"
"window"
"window"
Werteliste: 'image'"image""image""image""image", 'window'"window""window""window""window"
RowRowRowRowrow (input_control) point.y(-array) → HTupleHTupleHtuple (integer / real / string) (int / long / double / string) (Hlong / double / HString) (Hlong / double / char*)
Vertikale Textausrichtung oder Zeilenkoordinate der
Textposition.
Defaultwert: 12
Werteliste: 12, 'bottom'"bottom""bottom""bottom""bottom", 'center'"center""center""center""center", 'top'"top""top""top""top"
ColumnColumnColumnColumncolumn (input_control) point.x(-array) → HTupleHTupleHtuple (integer / real / string) (int / long / double / string) (Hlong / double / HString) (Hlong / double / char*)
Horizontale Textausrichtung oder Spaltenkoordinate der
Textposition.
Defaultwert: 12
Werteliste: 12, 'center'"center""center""center""center", 'left'"left""left""left""left", 'right'"right""right""right""right"
ColorColorColorColorcolor (input_control) string(-array) → HTupleHTupleHtuple (string) (string) (HString) (char*)
Ein Tupel von Strings für die Farben der Texte.
Defaultwert:
'black'
"black"
"black"
"black"
"black"
Werteliste: 'black'"black""black""black""black", 'blue'"blue""blue""blue""blue", 'coral'"coral""coral""coral""coral", 'cyan'"cyan""cyan""cyan""cyan", 'forest green'"forest green""forest green""forest green""forest green", 'green'"green""green""green""green", 'lime green'"lime green""lime green""lime green""lime green", 'magenta'"magenta""magenta""magenta""magenta", 'red'"red""red""red""red", 'slate blue'"slate blue""slate blue""slate blue""slate blue", 'yellow'"yellow""yellow""yellow""yellow"
GenParamNameGenParamNameGenParamNameGenParamNamegenParamName (input_control) attribute.name(-array) → HTupleHTupleHtuple (string) (string) (HString) (char*)
Namen der generischen Parameter.
Defaultwert: []
Werteliste: 'border_radius'"border_radius""border_radius""border_radius""border_radius", 'box'"box""box""box""box", 'box_color'"box_color""box_color""box_color""box_color", 'box_padding'"box_padding""box_padding""box_padding""box_padding", 'shadow'"shadow""shadow""shadow""shadow", 'shadow_color'"shadow_color""shadow_color""shadow_color""shadow_color", 'shadow_dx'"shadow_dx""shadow_dx""shadow_dx""shadow_dx", 'shadow_dy'"shadow_dy""shadow_dy""shadow_dy""shadow_dy", 'shadow_sigma'"shadow_sigma""shadow_sigma""shadow_sigma""shadow_sigma"
GenParamValueGenParamValueGenParamValueGenParamValuegenParamValue (input_control) attribute.value(-array) → HTupleHTupleHtuple (string / integer / real) (string / int / long / double) (HString / Hlong / double) (char* / Hlong / double)
Werte der generischen Parameter.
Defaultwert: []
Werteliste: 5.0, 'black'"black""black""black""black", 'blue'"blue""blue""blue""blue", 'false'"false""false""false""false", 'forest green'"forest green""forest green""forest green""forest green", 'red'"red""red""red""red", 'true'"true""true""true""true", 'white'"white""white""white""white"
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_textDevDispTextDevDispTextDevDispText den Wert 2 (H_MSG_TRUE).
Andernfalls wird eine Fehlerbehandlung durchgeführt und ein Fehlercode
zurückgeliefert.
Vorgänger
dev_open_windowdev_open_windowDevOpenWindowDevOpenWindowDevOpenWindow,
set_fontset_fontSetFontSetFontSetFont,
get_string_extentsget_string_extentsGetStringExtentsGetStringExtentsGetStringExtents
Alternativen
disp_textdisp_textDispTextDispTextDispText,
write_stringwrite_stringWriteStringWriteStringWriteString
Siehe auch
get_string_extentsget_string_extentsGetStringExtentsGetStringExtentsGetStringExtents,
set_fontset_fontSetFontSetFontSetFont
Modul
Foundation