[ Leksykon ] [ JavaScript ] [ Metody ] [ canvas ] [ OffscreenCanvas() ]

OffscreenCanvas.convertToBlob()

[_] [A] [B] [C] [D] [E] [F] [G] [H] [I] [J] [K] [L] [M] [N] [O] [P] [Q] [R] [S] [T] [U] [V] [W] [X] [Y] [Z]

convertToBlob()
convertToBlob(options)

Przykłady: 

const offscreen = new OffscreenCanvas(300, 300);
const gloff = offscreen.getContext("webgl");

gloff; // WebGLRenderingContext
gloff.canvas; // OffscreenCanvas
offscreen.convertToBlob().then((blob) => console.log(blob));

const offscreen = new OffscreenCanvas(300, 300);
const ctxoff = offscreen.getContext("2d");

ctxoff; // OffscreenCanvasRenderingContext2D
ctxoff.canvas; // OffscreenCanvas
offscreen.convertToBlob().then((blob) => console.log(blob));

Opis:
Metoda OffscreenCanvas.convertToBlob() tworzy Blob obiekt reprezentujący obraz zawarty w canvas. Można określić żądany format pliku i jakość obrazu. Jeżeli format pliku nie zostanie określony lub dany format nie jest obsługiwany, dane zostaną wyeksportowane w formacie image/png. Przeglądarki są wymagane do obsługi image/png; wiele z nich będzie obsługiwać dodatkowe formaty, w tym image/jpegi image/webp. Utworzony obraz będzie miał rozdzielczość 96 dpi dla formatów plików obsługujących metadane rozdzielczości kodowania. 

Parametry options - jest opcjonalny, Obiekt o następujących właściwościach: type - ciąg wskazujący format obrazu. Domyślny typ to image/png; ten format obrazu będzie również używany, jeśli określony typ nie jest obsługiwany. quality - Number pomiędzy 0 i 1 wskazujący jakość obrazu używaną podczas tworzenia obrazów przy użyciu formatów plików obsługujących kompresję stratną, takich jak image/jpeglub image/webp. Klient użytkownika użyje domyślnej wartości jakości, jeśli ta opcja nie zostanie określona lub jeśli liczba będzie poza dozwolonym zakresem. Wartość zwracana Promise obiekt Blob reprezentujący obraz zawarty w kanwie. Wyjątki może zostać odrzucone z następującymi wyjątkami: InvalidStateError DOMException - nie jest OffscreenCanvas odłączony; innymi słowy, nadal jest powiązany z DOM, a nie z bieżącym procesem roboczym. SecurityError DOMException - tryb kontekstu płótna to 2d, a mapa bitowa nie jest czysta w oryginale, przynajmniej część jego zawartości została lub mogła zostać załadowana z witryny innej niż ta, z której załadowano sam dokument. IndexSizeError DOMException - bitmapa płótna nie zawiera pikseli, wymiar poziomy lub pionowy wynosi zero. EncodingError DOMException - Nie można utworzyć obiektu BLOB z powodu błędu kodowania.

Zobacz też:
ImageBitmap() - reprezentuje obraz bitmapowy, który można narysować canvas bez zbędnych opóźnień
Promise.then() -