HTMLCanvasElement

Proprietà

Eredita proprietà dalla interfaccia genitore, HTMLElement.

HTMLCanvasElement.height

Intero positivo che rispecchia l'attributo dell'elemento HTML height interpretato in unità pixel CSS. Quando l'attributo non è specificato, o se è impostato ad un valore non valido, come un numero negativo, è usato il valore di default 150.

HTMLCanvasElement.mozOpaque

Un Boolean che rispecchia l'attributo HTML moz-opaque dell'elemento <canvas>. Permette al canvas di sapere se la traslucenza sarà un fattore. Se il canvas sa che non ci sarà traslucenza, la prestazione del dipingere puo' essere ottimizzata.

HTMLCanvasElement.width

Intero positivo che rispecchia l'attributo HTML width dell'elemento <canvas> interpretato in unità pixel CSS. Quando l'attributo non è specificato, o se è impostato ad un valore non valido, ad esempio negativo, è usato il valore di default 300.

Metodi

Eredita dal proprio genitore, HTMLElement.

HTMLCanvasElement.captureStream()

Restituisce un oggetto CanvasCaptureMediaStream che è una capture video in tempo reale della superficie del canvas.

HTMLCanvasElement.getContext()

Restituisce un contesto di disegno sul canvas, oppure null se l'identificativo del contesto non ha supporto. Un contesto di disegno permette di disegnare sul canvas. Chiamare getContext con "2d" come parametro restituisce un oggetto CanvasRenderingContext2D, mentre chiamarlo con "experimental-webgl" (o "webgl") restituisce un oggetto WebGLRenderingContext. Questo contesto è disponibile solo su browsers che implementano WebGL.

HTMLCanvasElement.toDataURL()

Restituisce un URL dati contentente una rappresentazione della immagine nel formato specificato dal parametro tipo (il valore di default è png). L'immagine restituita ha una risoluzione di 96dpi.

HTMLCanvasElement.toBlob()

Crea un oggetto Blob che rappresenta l'immagine contenuta nel canvas; questo file puo' essere immagazzinato temporaneamente su disco oppure nella memoria a discrezione dell'agente per l'utente (user agent).

HTMLCanvasElement.transferControlToOffscreen()

Trasferisce il controllo ad un oggetto OffscreenCanvas, o nella thread principale oppure in una worker.

HTMLCanvasElement.mozGetAsFile()

Restituisce un oggetto File che rappresenta l'immagine contenuta nel canvas; questo è un file immagazzinato nella memoria, col nome indicato. Se il tipo del file non è specificato, il tipo di default per l'immagine è image/png.

Specifiche

Compatibilità coi Browsers

[1] Supporto parziale in Opera Mini 5.0 e successivi.

[2] Il supporto per il terzo parametro, è stato aggiunto solo con Gecko 25: quando viene usato col tipo "image/jpeg," questo argomento specifica la qualità dell'immagine.

[3] Da questa funzionalità dipende una impostazione di preferenza di funzionalità. Imposta come true gfx.offscreencanvas.enabled in about:config .

Vedi anche:

• elemento HTML che implementa questa interfaccia: <canvas>.