playout:SetMarkup(text$[, length])

Mit der Auszeichnungssprache Pango können Sie Textformatierungen mithilfe von XML-Tags vornehmen. Das am häufigsten verwendete Tag in der Pango-Auszeichnungssprache ist das Tag <span>. Damit können Sie eine Reihe von Zeichen formatieren. Das Tag <span> unterstützt die folgenden Attribute:

font

font_desc

Eine Zeichenkette zur Beschreibung der Schriftart, z.B. "Sans Italic 12". Siehe pango.FontDescription() für eine Beschreibung des Formats der Zeichenketten-Darstellung. Beachten Sie, dass alle anderen <span>-Attribute diese Beschreibung überschreiben. Wenn Sie also "Sans Italic" und auch ein Attribut style="normal" haben, erhalten Sie Sans normal, nicht kursiv.

font_family

face

Der Name einer Schriftartenfamilie.

font_size

size

Schriftgröße in 1024stel eines Punktes oder in Punkten (z.B. "12.5pt") oder eine der absoluten Größen "xx-small", "x-small", "small", "medium", "large", "x-large", "xx-large" oder ein Prozentsatz (z.B. "200%") oder eine der relativen Größen "smaller" oder "larger". Wenn Sie eine absolute Größe angeben wollen, ist es in der Regel einfacher, die Möglichkeit zu nutzen, mit "font" eine partielle Schriftbeschreibung anzugeben; Sie können font="12.5" statt size="12800" oder size="12.5pt" verwenden.

font_style

style

Eine der Optionen "normal", "oblique", "italic".

font_weight

weight

Eine der Optionen "ultralight", "light", "normal", "bold", "ultrabold", "heavy" oder eine numerische Stärke.

font_variant

variant

Eine der Optionen "normal", "small-caps", "all-small-caps", "petite-caps", "all-petite-caps", "unicase", "title-caps".

font_stretch

stretch

Eine der Optionen "ultracondensed", "extracondensed", "condensed", "semicondensed", "normal", "semiexpanded", "expanded", "extraexpanded", "ultraexpanded".

font_features

Eine durch Kommata getrennte Liste von Einstellungen für OpenType-Schriftarten, in der gleichen Syntax, wie sie von CSS akzeptiert wird. Z.B.: font_features='dlig=1, -kern, afrc on'.

foreground

fgcolor

color

Eine RGB-Farbangabe wie "#00FF00" oder ein Farbname wie "red". Eine RGBA-Farbspezifikation wie "#00FF007F" wird so interpretiert, dass sie sowohl eine Vordergrundfarbe als auch ein Vordergrund-Alpha angibt.

background

bgcolor

Eine RGB-Farbangabe wie "#00FF00" oder ein Farbname wie "red". Eine RGBA-Farbspezifikation wie "#00FF007F" wird so interpretiert, dass sie sowohl eine Hintergrundfarbe als auch ein Hintergrund-Alpha angibt.

alpha

fgalpha

Ein Alphawert für die Vordergrundfarbe, entweder eine einfache ganze Zahl zwischen 1 und 65536 oder ein Prozentwert wie "50%".

background_alpha

bgalpha

Ein Alphawert für die Hintergrundfarbe, entweder eine einfache ganze Zahl zwischen 1 und 65536 oder ein Prozentwert wie "50%".

underline

Eine der Optionen "none", "single", "double", "low", "error".

underline_color

Die Farbe der Unterstreichungen; eine RGB-Farbangabe wie "#00FF00" oder ein Farbname wie "red".

overline

Eine der Optionen "none" oder "single".

overline_color

Die Farbe der Überschriften; eine RGB-Farbangabe wie "#00FF00" oder ein Farbname wie "red".

rise

Vertikale Verschiebung, in Pango-Einheiten oder in Punkten (z.B. "5pt"). Kann für tiefgestellter Schrift negativ, für hochgestellter Schrift positiv sein.

baseline_shift

Vertikale Verschiebung. Im Gegensatz zu "rise" sind die Attribute "baseline_shift" kumulativ. Der Wert kann in Pango-Einheiten oder in Punkten (z.B. "5pt") oder "superscript" oder "subscript" sein.

font_scale

Ändert die Schriftgröße. Die möglichen Werte sind "superscript", "subscript" oder "small-caps". Dies ähnelt den Werten von font_size wie "smaller" oder "larger", verwendet jedoch Schriftmetriken, um die neue Größe zu ermitteln.

strikethrough

"true" oder "false", ob der Text durchgestrichen werden soll oder nicht.

strikethrough_color

Die Farbe der durchgestrichenen Zeile; eine RGB-Farbangabe wie "#00FF00" oder ein Farbname wie "red".

fallback

"true" oder "false" ob Fallback aktiviert werden soll oder nicht. Wenn diese Option deaktiviert ist, werden nur Zeichen aus der am besten passenden Schriftart auf dem System verwendet. Es wird kein Fallback auf andere Schriftarten auf dem System durchgeführt, die die Zeichen im Text enthalten könnten. Fallback ist standardmäßig aktiviert. Die meisten Anwendungen sollten Fallback nicht deaktivieren.

lang

Ein Sprachcode, der die Textsprache angibt.

letter_spacing

Abstand zwischen den Buchstaben in 1024stel eines Punktes.

gravity

Eine der Optionen "south", "east", "north", "west", "auto".

gravity_hint

Eine der Optionen "natural", "strong", "line".

show

Gibt an, welche Sonderzeichen sichtbar angezeigt werden sollen. Der Wert kann "none" oder eine Kombination aus "spaces", "line-breaks" und "ignorables" sein, welche durch "|" getrennt sind.

insert_hyphens

"true" oder "false" um anzugeben, ob beim Zeilenumbruch in der Mitte von Wörtern Bindestriche eingefügt werden sollen oder nicht.

allow_breaks

"true" oder "false" um anzugeben, ob ein Zeilenumbruch erlaubt ist oder nicht.

line_height

Setzt die Zeilenhöhe. Der Wert kann entweder ein Faktor (< 1024) sein, der zum Hochskalieren der logischen Ausdehnung von Läufen verwendet wird, oder ein absoluter Wert (in 1024stel eines Punktes).

text_transform

Gibt an, wie Zeichen während der Formgebung umgewandelt werden. Die Werte können "none", "lowercase", "uppercase" oder "capitalize" sein.

segment

Setzt die Wort- oder Satzgrenzen. Der Wert kann "word" oder "sentence" sein, um anzugeben, dass die Spanne als ein einzelnes Wort oder ein Satz behandelt werden soll. Sich überschneidende Segmente werden entsprechend aufgeteilt und die Zeilenumbrüche werden entsprechend angepasst.

Neben dem Tag <span> unterstützt die Auszeichnungssprache Pango auch die folgenden Komfort-Tags:

<b>

Fett

<big>

Vergrößert die Schrift relativ, entspricht <span size="larger">.

<i>

Italic

<s>

Durchgestrichen

<sub>

Tiefgestellt

<sup>

Hochgestellt

<small>

Verkleinert die Schrift relativ, entspricht <span size="smaller">.

<tt>

Schriftart Monospace

<u>

Unterstrichen

Hier ist ein Beispiel für formatierten Text:

<span foreground="blue" size="x-large">Blue text</span> is <i>cool</i>.

Beachten Sie, dass Sie auch XML-Funktionen wie numerische Zeichenentitäten verwenden können, z.B. können Sie © für das Copyright-Zeichen usw. verwenden.

text$

formatierter Text

length

optional: Länge des formatierten Textes in Bytes (Standardwert ist -1, was bedeutet, dass die Länge der Zeichenkette verwendet wird)