Bezeichnung
  ccontext:SelectFontFace -- Wählt die Schriftart aus
Übersicht

      ccontext:SelectFontFace(family$, slant, weight)

Beschreibung
  Hinweis: Der Funktionsaufruf `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().

Eingaben
  family$
    ein Schriftfamilienname
  slant
    die Neigung für die Schriftart (siehe oben)
  weight
    die Stärke der Schriftart (siehe oben)

Navigation zeigen