CanvasRenderingContext2D: createPattern() Methode
Baseline
Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since Juli 2015.
Die CanvasRenderingContext2D.createPattern() Methode der Canvas 2D API erstellt ein Muster unter Verwendung des angegebenen Bildes und der Wiederholung.
Diese Methode gibt ein CanvasPattern zurück.
Diese Methode zeichnet nichts direkt auf die Leinwand.
Das erstellte Muster muss den Eigenschaften CanvasRenderingContext2D.fillStyle oder CanvasRenderingContext2D.strokeStyle zugewiesen werden, danach wird es auf alle nachfolgenden Zeichnungen angewendet.
Syntax
createPattern(image, repetition)
Parameter
image-
Ein Bild, das als Musterbild verwendet werden soll. Dies kann eines der folgenden sein:
HTMLImageElement(<img>)SVGImageElement(<image>)HTMLVideoElement(<video>, durch die Erfassung des Videos)HTMLCanvasElement(<canvas>)ImageBitmapOffscreenCanvasVideoFrame
repetition-
Ein String, der angibt, wie das Musterbild wiederholt werden soll. Mögliche Werte sind:
"repeat"(beide Richtungen)"repeat-x"(nur horizontal)"repeat-y"(nur vertikal)"no-repeat"(keine Richtung)
Ein
nullWert wird wie der leere String ("") behandelt: Beide sind Synonyme von"repeat".
Rückgabewert
Ein undurchsichtiges CanvasPattern, das ein Muster beschreibt.
Wenn das image nicht vollständig geladen ist (HTMLImageElement.complete ist false), wird null zurückgegeben.
Beispiele
Erstellen eines Musters aus einem Bild
In diesem Beispiel wird die createPattern() Methode verwendet, um ein CanvasPattern mit einem sich wiederholenden Quellbild zu erstellen.
Nachdem es erstellt wurde, wird das Muster dem Füllstil des Canvas-Kontextes zugewiesen und auf ein Rechteck angewendet.
Das ursprüngliche Bild sieht so aus:
HTML
<canvas id="canvas" width="300" height="300"></canvas>
JavaScript
const canvas = document.getElementById("canvas");
const ctx = canvas.getContext("2d");
const img = new Image();
img.src = "canvas_create_pattern.png";
// Only use the image after it's loaded
img.onload = () => {
const pattern = ctx.createPattern(img, "repeat");
ctx.fillStyle = pattern;
ctx.fillRect(0, 0, 300, 300);
};
Erstellen eines Musters aus einer Leinwand
In diesem Beispiel erstellen wir ein Muster aus dem Inhalt einer Offscreen-Leinwand. Wir wenden es dann auf den Füllstil unserer primären Leinwand an und füllen diese Leinwand mit dem Muster.
JavaScript
// Create a pattern, offscreen
const patternCanvas = document.createElement("canvas");
const patternContext = patternCanvas.getContext("2d");
// Give the pattern a width and height of 50
patternCanvas.width = 50;
patternCanvas.height = 50;
// Give the pattern a background color and draw an arc
patternContext.fillStyle = "#ffeecc";
patternContext.fillRect(0, 0, patternCanvas.width, patternCanvas.height);
patternContext.arc(0, 0, 50, 0, 0.5 * Math.PI);
patternContext.stroke();
// Create our primary canvas and fill it with the pattern
const canvas = document.createElement("canvas");
const ctx = canvas.getContext("2d");
const pattern = ctx.createPattern(patternCanvas, "repeat");
ctx.fillStyle = pattern;
ctx.fillRect(0, 0, canvas.width, canvas.height);
// Add our primary canvas to the webpage
document.body.appendChild(canvas);
Ergebnis
Spezifikationen
| Specification |
|---|
| HTML # dom-context-2d-createpattern-dev |
Browser-Kompatibilität
Siehe auch
- Das Interface, das diese Methode definiert:
CanvasRenderingContext2D CanvasPattern