ccontext:SelectFontFace(family$, slant, weight)
ccontext:SelectFontFace() ist Teil dessen,
was die Cairoer Designer als "Toy"-Text-API bezeichnen. Es ist praktisch
für kurze Demos und einfache Programme, wird aber voraussichtlich nicht für
ernsthafte Textanwendungen geeignet sein.
Wählt eine Familie und einen Schriftstil aus einer vereinfachten Beschreibung wie Familienname, Neigung und Stärke aus. Cairo bietet keine Funktion zum Auflisten verfügbarer Familiennamen im System (dies ist ein "Toy", denken Sie daran), aber die standardmäßigen generischen CSS2-Familiennamen ("serif", "sans-serif", "cursive", "fantasy", "Monospace") funktionieren wahrscheinlich wie erwartet.
Wenn family$ mit der Zeichenkette "cairo:" beginnt oder keine nativen
Schriftarten-Backends kompiliert sind, verwendet Cairo eine interne
Schriftartenfamilie. Die interne Schriftfamilie erkennt viele Modifikatoren in
der Zeichenkette family$, insbesondere die Zeichenkette "monospace". Das
heißt, der Familienname "cairo:monospace" verwendet die Monospace-Version
der internen Schriftfamilie.
Informationen zur "echten" Schriftartenauswahl finden Sie in den Schriftarten-Backend-spezifischen Schriftarten-Erstellungsfunktionen für das Schriftarten-Backend, das Sie verwenden, z.B. cairo.FontFace(). Die resultierende Schriftart könnte dann mit cairo.ScaledFont() und ccontext:SetScaledFont() verwendet werden.
Ebenso können Sie bei Verwendung der "echten" Schriftartenunterstützung direkt das zugrunde liegende Schriftartensystem aufrufen, z.B. "fontconfig" oder "freetype", um Vorgänge wie das Auflisten verfügbarer Schriftarten usw. durchzuführen.
Es wird erwartet, dass die meisten Anwendungen eine umfassendere Schriftartenverarbeitungs- und Textlayoutbibliothek (z.B. Pango) in Verbindung mit Cairo verwenden müssen.
Wenn Text ohne einen Aufruf von ccontext:SelectFontFace(),
ccontext:SetFontFace() oder ccontext:SetScaledFont()
gezeichnet wird, ist die Standardfamilie plattformspezifisch, aber im
Wesentlichen "serifenlos".
Der slant-Parameter kann eine der folgenden Konstanten sein:
#CAIRO_FONT_SLANT_NORMAL #CAIRO_FONT_SLANT_ITALIC #CAIRO_FONT_SLANT_OBLIQUE |
Der weight-Parameter kann eine der folgenden Konstanten sein:
#CAIRO_FONT_WEIGHT_NORMAL #CAIRO_FONT_WEIGHT_BOLD |
Die Standardneigung ist #CAIRO_FONT_SLANT_NORMAL und die Standardstärke
ist #CAIRO_FONT_WEIGHT_NORMAL.
Diese Funktion entspricht einem Aufruf von cairo.ToyFontFace() gefolgt von ccontext:SetFontFace().