Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / JavaScript

ImageData.data — čítanie a úprava pixelov RGBA

ImageData obsahuje obdĺžnikovú oblasť pixelov. Jej vlastnosť ImageData.data sprístupňuje jednorozmerné pole kanálov RGBA: jeho prvky možno meniť, hoci samotná vlastnosť je iba na čítanie. Spoznajte indexovanie pixelov a rozdiel medzi 8-bitovým a plávajúcim formátom.

Verzia: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Syntax

const imageData = new ImageData(width, height);
const pixels = imageData.data;
const i = 4 * (y * imageData.width + x);
pixels[i + 0] = red;
pixels[i + 1] = green;
pixels[i + 2] = blue;
pixels[i + 3] = alpha;

ImageData je rozhranie Web API, nie súčasť samotného ECMAScriptu. Predstavuje obdĺžnikovú oblasť pixelov. Možno ju vytvoriť pomocou new ImageData(width, height) alebo získať cez createImageData() či getImageData() z kontextu canvas 2D. Konštruktor bez poľa vytvorí priehľadné čierne pixely.

ImageData.data sprístupňuje kanály v poradí RGBA: červený, zelený, modrý a alfa. Pixely sú uložené po riadkoch od ľavého horného rohu. Pole obsahuje 4 * width * height prvkov. Pre celočíselné súradnice 0 <= x < width a 0 <= y < height je index červeného kanála 4 * (y * width + x); nasledujúce kanály majú posuny 1, 2, 3.

Predvolený formát "rgba-unorm8" používa Uint8ClampedArray s celočíselnými hodnotami od 0 do 255; alfa 0 znamená úplnú priehľadnosť a 255 úplnú nepriehľadnosť. Formát "rgba-float16" používa Float16Array, preto naň nepoužívajte bajtovú stupnicu. Podporu tohto formátu a experimentálnej vlastnosti pixelFormat overte osobitne v cieľových prehliadačoch.

Vlastnosť data je iba na čítanie, prvky vráteného poľa však nie: upravujte imageData.data[i] namiesto priradenia náhradného poľa do imageData.data. Zmena buffera canvas automaticky neaktualizuje; použite putImageData(imageData, 0, 0). Dostupnosť Node 24 nedokazuje podporu tohto API prehliadača.

Príklady

const imageData = new ImageData(2, 1);
const pixels = imageData.data;
pixels.set([255, 0, 0, 255, 0, 255, 0, 255]);

const x = 1;
const y = 0;
const i = 4 * (y * imageData.width + x);
pixels[i + 2] = 255;

console.log(`${imageData.width}x${imageData.height}; ${pixels.length}`);
console.log(Array.from(pixels).join(','));

Výsledok

2x1; 8
255,0,0,255,0,255,255,255

Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.

Zdroje