Bezeichnung
  ccontext:SetDash -- Legt das Strichmuster fest
Übersicht

      ccontext:SetDash(offset[, dash1, ...])

Beschreibung
  Legt das Strichmuster fest, das von ccontext:Stroke() verwendet werden soll. Ein Strichmuster wird durch eine Reihe positiver Strichwerte angegeben, beginnend mit `dash1`. Jeder Wert gibt die Länge der abwechselnden "Ein"- und "Aus"-Abschnitte des Strichmusters an. Der `offset` gibt einen Versatz im Muster an, bei dem der Strich beginnt.

  Auf jedes "Ein"-Segment werden Obergrenzen angewendet, als wäre das Segment ein separater Unterpfad. Insbesondere ist es gültig, eine "Ein"-Länge von 0,0 mit `#CAIRO_LINE_CAP_ROUND` oder `#CAIRO_LINE_CAP_SQUARE` zu verwenden, um Punkte oder Quadrate entlang eines Pfads zu verteilen.

  Hinweis: Die Längenwerte sind in Benutzerbereicheinheiten angegeben, die zum Zeitpunkt des Zeichnens ausgewertet wurden. Dies ist nicht unbedingt derselbe wie der Benutzerbereich zum Zeitpunkt von `ccontext:SetDash()`.

  Wenn Sie die optionalen Argumente `dash1` usw. weglassen, ist die Strichelung deaktiviert.

  Wenn Sie nur einen einzelnen Strichmusterwert übergeben, wird ein symmetrisches Muster mit abwechselnd ein- und ausgeschalteten Teilen der Größe angenommen, die durch den einzelnen Wert in `dash1` angegeben wird.

  Wenn ein Strichmusterwert negativ ist oder alle Werte 0 sind, wird der Cairo-Kontext in einen Fehlerzustand mit dem Status `#CAIRO_STATUS_INVALID_DASH` versetzt.

Eingaben
  offset
    ein Versatz im Strichmuster, bei dem der Strich beginnen soll
  dash1
    Optional: Wert für den ersten Strichmusterabschnitt (im Abschnitt).
  ...
    Optional: Weitere Werte, die abwechselnde Längen der Ein- und Aus-Strichmusterabschnitte angeben

Navigation zeigen