attr = pango.Attribute(type$[, ...])

Die folgenden Typen werden derzeit unterstützt:

AllowBreaks

Erstellt ein neues Attribut "Pausen zulassen". Sie müssen ein zusätzliches boolesches Argument übergeben, das angibt, ob Pausen zulässig sind. Bei deaktivierten Pausen wird die Reichweite soweit wie möglich in einem einzigen Lauf gehalten.

Background

Erstellt ein neues Hintergrundfarbattribut. Sie müssen die drei zusätzlichen Argumente übergeben, die die roten, grünen und blauen Komponenten der Hintergrundfarbe angeben und jeweils zwischen 0 und 65535 liegen müssen.

BackgroundAlpha

Erstellt ein neues Alpha-Hintergrund-Attribut. Sie müssen das zusätzliche Argument alpha übergeben, das den Alpha-Hintergrundwert angibt und zwischen 0 und 65535 liegen muss.

Fallback

Erstellt ein neues Schriftarten-Fallback-Attribut. Sie müssen ein zusätzliches boolesches Argument übergeben, das angibt, ob Fallback aktiviert oder deaktiviert werden soll. Wenn das Fallback deaktiviert ist, werden nur Zeichen aus der am besten passenden Schriftart im System verwendet. Es wird kein Fallback auf andere Schriftarten im System durchgeführt, die möglicherweise die Zeichen im Text enthalten.

Family

Erstellt ein neues Schriftfamilienattribut. Sie müssen eine Zeichenkette übergeben, die den Familiennamen oder eine durch Kommas getrennte Liste von Familien enthält.

FontDesc

Erstellt ein neues Schriftbeschreibungsattribut. Als zusätzliches Argument benötigen Sie ein Pango-Schriftbeschreibungsobjekt. Dieses Attribut ermöglicht das gleichzeitige Setzen der Attribute Family, Style, Weight, Variant, Stretch und Size.

Foreground

Erstellt ein neues Vordergrundfarbattribut. Sie müssen die drei zusätzlichen Argumente übergeben, die die roten, grünen und blauen Komponenten der Vordergrundfarbe angeben und jeweils zwischen 0 und 65535 liegen müssen.

ForegroundAlpha

Erstellt ein neues Alpha-Vordergrund-Attribut. Sie müssen einen zusätzlichen Wert übergeben, der den Alpha-Vordergrundwert angibt und zwischen 0 und 65535 liegen muss.

Gravity

Erstellt ein neues Ausrichtungsattribut. Sie müssen ein zusätzliches Argument übergeben, das die Ausrichtung angibt. Eine Liste der Ausrichtungskonstanten finden Sie unter pcontext:SetBaseGravity().

GravityHint

Erstellt ein neues Ausrichtungshinweis-Attribut. Sie müssen ein zusätzliches Argument übergeben, das den Ausrichtungshinweis angibt. Eine Liste mit Hinweisen zur Ausrichtung finden Sie unter pcontext:SetGravityHint().

InsertHyphens

Erstellt ein neues Attribut "Bindestriche einfügen". Pango fügt Bindestriche ein, wenn Zeilen in der Mitte eines Wortes umgebrochen werden. Setzen Sie dieses Attribut auf False, um den Bindestrich zu unterdrücken.

Language

Erstellt ein neues Sprach-Tag-Attribut. Sie müssen ein zusätzliches Argument übergeben, das ein Pango-Sprachobjekt enthält.

LetterSpacing

Erstellt ein neues Attribut für den Buchstabenabstand. Sie müssen ein zusätzliches Argument übergeben, das den zusätzlichen Abstand angibt, der zwischen den Graphem des Textes hinzugefügt werden soll (in Pango-Einheiten).

Rise

Erstellt ein neues Attribut für die Grundlinienverschiebung. Sie müssen ein zusätzliches Argument übergeben, das den Betrag angibt, um den der Text vertikal verschoben werden soll, in Pango-Einheiten. Positive Werte verschieben den Text nach oben.

Scale

Erstellt ein neues Skalierungsattribut für die Schriftgröße. Die Größe der Basisschriftart für den betroffenen Text wird mit dem Skalierungsfaktor multipliziert, der als zusätzliches Argument an dieses Attribut übergeben wird.

Shape

Erstellt ein neues Formattribut. Eine Form wird verwendet, um dem Ergebnis der Formung einer bestimmten Glyphe eine bestimmte Einfärbung und ein logisches Rechteck aufzuerlegen. Dies kann beispielsweise zum Einbetten eines Bildes oder eines Widgets in ein Pango-Layout verwendet werden. Sie müssen zwei zusätzliche Tabellenargumente übergeben: Das erste ist das Einfärberechteck, das jedem Zeichen zugewiesen wird, das zweite ist das logische Rechteck, das jedem Zeichen zugewiesen wird. Beide Argumente müssen Tabellen mit den initialisierten Feldern x, y, width und height sein. Darüber hinaus können Sie ein optionales drittes Argument übergeben, das als Benutzerdaten gilt und einen beliebigen Typ haben kann.

Show

Erstellt ein neues Attribut, das beeinflusst, wie unsichtbare Zeichen dargestellt werden. Sie müssen ein zusätzliches Argument übergeben, das auf eines der folgenden Flags gesetzt werden kann:

#PANGO_SHOW_NONE

Keine Sonderbehandlung für unsichtbare Zeichen.

#PANGO_SHOW_SPACES

Macht Leerzeichen, Tabulatoren und Zeilenumbrüche sichtbar.

#PANGO_SHOW_LINE_BREAKS

Macht Zeilenumbrüche sichtbar.

#PANGO_SHOW_IGNORABLES

Macht standardmäßig ignorierbare Unicode-Zeichen sichtbar.

Size

Erstellt ein neues Schriftgrößenattribut in Bruchteilen. Sie müssen ein zusätzliches Argument übergeben, das die Schriftgröße in #PANGO_SCALE-teln eines Punktes angibt.

SizeAbsolute

Erstellt ein neues Schriftgrößenattribut in Gerätepunkten. Sie müssen ein zusätzliches Argument übergeben, das die Schriftgröße in #PANGO_SCALE-teln einer Geräteeinheit angibt.

Stretch

Erstellt ein neues Attribut zur Dehnung der Schriftart. Sie müssen ein zusätzliches Argument übergeben, das den Schriftart-Dehnungsmodus angibt. Eine Liste der Pango-Dehnungsmodi finden Sie unter pfontdesc:SetStretch().

Strikethrough

Erstellt ein neues Durchgestrichen-Attribut. Sie müssen ein zusätzliches boolesches Argument übergeben, das angibt, ob der Text durchgestrichen werden soll.

StrikethroughColor

Erstellt ein neues durchgestrichenes Farbattribut. Sie müssen die drei zusätzlichen Argumente red, green, blue übergeben, die die durchgestrichene Farbe angeben und für jeden Wert zwischen 0 und 65535 liegen müssen.

Style

Erstellt ein neues Stilattribut für die Schriftartschräge. Sie müssen ein zusätzliches Argument übergeben, das den Schriftschnittstil angibt. Eine Liste der Pango-Stile finden Sie unter pfontdesc:SetStyle().

Underline

Erstellt ein neues Attribut im Unterstreichungsstil. Sie müssen ein zusätzliches Argument übergeben, das den Unterstreichungsstil angibt. Die folgenden Unterstreichungsstile werden derzeit unterstützt:

#PANGO_UNDERLINE_NONE

Es sollte keine Unterstreichung gezeichnet werden.

#PANGO_UNDERLINE_SINGLE

Es sollte eine einzelne Unterstreichung gezeichnet werden.

#PANGO_UNDERLINE_DOUBLE

Es sollte eine doppelte Unterstreichung gezeichnet werden.

#PANGO_UNDERLINE_LOW

Eine einzelne Unterstreichung sollte an einer Position unterhalb der Freihandbereiche des zu unterstreichenden Textes gezeichnet werden. Dies sollte nur zum Unterstreichen einzelner Zeichen verwendet werden, beispielsweise für Tastaturkürzel. #PANGO_UNDERLINE_SINGLE sollte für längere Textteile verwendet werden.

#PANGO_UNDERLINE_ERROR

Unten sollte ein Unterstrich gezeichnet werden, der auf einen Fehler hinweist. Der genaue Darstellungsstil hängt vom verwendeten PangoRenderer ab, typische Stile umfassen jedoch wellenförmige oder gepunktete Linien. Diese Unterstreichung wird normalerweise verwendet, um auf einen Fehler wie etwa einen möglichen Schreibfehler hinzuweisen. In einigen Fällen kann automatisch eine Kontrastfarbe verwendet werden.

#PANGO_UNDERLINE_SINGLE_LINE

Wie PANGO_UNDERLINE_SINGLE, jedoch kontinuierlich über mehrere Läufe hinweg gezeichnet.

#PANGO_UNDERLINE_DOUBLE_LINE

Wie PANGO_UNDERLINE_DOUBLE, jedoch kontinuierlich über mehrere Läufe hinweg gezeichnet.

#PANGO_UNDERLINE_ERROR_LINE

Wie PANGO_UNDERLINE_ERROR, aber kontinuierlich über mehrere Läufe hinweg gezeichnet.

UnderlineColor

Erstellt ein neues Unterstreichungsfarbattribut. Sie müssen die drei zusätzlichen Argumente red, green, blue übergeben, die die Unterstreichungsfarbe angeben und für jeden Wert zwischen 0 und 65535 liegen müssen.

Variant

Erstellt ein neues Schriftartvariantenattribut. Sie müssen ein zusätzliches Argument übergeben, das den Stil der Schriftartvariante angibt. Eine Liste der Pango-Varianten finden Sie unter pfontdesc:SetVariant().

Weight

Erstellt ein neues Attribut für die Schriftstärke. Sie müssen ein zusätzliches Argument übergeben, das die Schriftstärke angibt. Dies kann eine Zahl oder eine der vordefinierten Schriftstärken sein. Eine Liste der Pango-Schriftstärken finden Sie unter pfontdesc:SetWeight().

Diese Funktion gibt das neu zugewiesene Pango-Attribut zurück, das mit pattribute:Free() gelöscht werden sollte.

attr

das neu zugewiesene Pango-Attribut