База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / JavaScript

Canvas 2D: изчистване, рисуване и редактиране на пиксели

Разграничи операциите за рисуване в 2D контекста от директното четене и записване на пикселите в растерното изображение.

Версия: ECMAScript 2024 and the current web platform; runtime support varies

Синтаксис

const ctx = canvas.getContext('2d');

ctx.clearRect(x, y, width, height);

ctx.drawImage(image, dx, dy);
ctx.drawImage(image, dx, dy, dw, dh);
ctx.drawImage(image, sx, sy, sw, sh, dx, dy, dw, dh);

const snapshot = ctx.getImageData(sx, sy, sw, sh);
const configuredSnapshot = ctx.getImageData(sx, sy, sw, sh, settings);

ctx.putImageData(imageData, dx, dy);
ctx.putImageData(imageData, dx, dy, dirtyX, dirtyY, dirtyWidth, dirtyHeight);

clearRect, drawImage, getImageData и putImageData са методи на контекста, върнат от canvas.getContext('2d'). Те са част от уеб API, а не от ECMAScript 2024. clearRect() се съобразява с текущата трансформация и областта на изрязване. Методът задава пикселите на прозрачно черно (непрозрачно черно при alpha: false), без да нулира състоянието за рисуване или текущия контур. За нов контур извикай beginPath().

drawImage() приема готов източник от тип CanvasImageSource, например изображение или друго платно, но не ImageData. Вариантът с 3 аргумента рисува целия източник в естествения му размер; този с 5 задава размера на целта; този с 9 съпоставя правоъгълник от източника с целеви правоъгълник. Отрицателните размери разширяват правоъгълника в обратна посока, без да обръщат изображението. Рисуването се съобразява с трансформацията, изрязването и композирането. Ако изображението още се зарежда и не е готово за използване, drawImage() не го рисува. Напълно достъпно изображение, което може да се декодира, може да бъде нарисувано без предварително извикване на decode() или предварително декодиран кадър. Платно източник с нулев размер по някоя ос предизвиква InvalidStateError.

getImageData() чете пиксели от растера независимо от трансформацията и изрязването. Връща независимо копие ImageData: промяната на data не променя платното. Масивът съдържа RGBA стойности по редове; първият канал на пиксела (x, y) в копието е на индекс (y * imageData.width + x) * 4. Извън растера се връща прозрачно черно. Отрицателни sw или sh разширяват правоъгълника в обратна посока; нулев размер предизвиква IndexSizeError.

putImageData() заменя пиксели без мащабиране, трансформация, изрязване от контекста или смесване. Вариантът със 7 аргумента избира подобласт в ImageData, а не в целта: пикселът (x, y) се записва на (dx + x, dy + y). Отделен буфер предизвиква InvalidStateError. Преобразуването на цветовото пространство и предварителното умножение по алфа могат да променят стойностите при повторно четене, особено за полупрозрачни пиксели.

Рисуването на ресурс от друг произход без разрешение чрез CORS може да премахне статуса origin-clean на растера. Тогава четенето предизвиква SecurityError дори след clearRect(). За ресурси от друг произход използвай CORS заявка с подходящо разрешение от сървъра. Стандартният формат за четене rgba-unorm8 използва Uint8ClampedArray; провери поддръжката на настройки като display-p3 или rgba-float16 (Float16Array) в целевите браузъри.

Примери

<!doctype html>
<meta charset="utf-8">
<title>Canvas 2D pixel readback</title>
<canvas id="source" width="2" height="1" hidden></canvas>
<canvas id="destination" width="2" height="1" hidden></canvas>
<script>
  const source = document.getElementById('source');
  const canvas = document.getElementById('destination');
  const src = source.getContext('2d');
  const ctx = canvas.getContext('2d');
  src.fillStyle = '#ff0000';
  src.fillRect(0, 0, 2, 1);
  ctx.drawImage(source, 0, 0);
  ctx.clearRect(0, 0, 1, 1);

  const snapshot = ctx.getImageData(0, 0, 2, 1);
  console.log(snapshot.data.join(','));
  snapshot.data.set([0, 0, 255, 255], 4);
  ctx.putImageData(snapshot, -1, 0, 1, 0, 1, 1);
  console.log(ctx.getImageData(0, 0, 2, 1).data.join(','));
</script>

Резултат

0,0,0,0,255,0,0,255
0,0,255,255,255,0,0,255

Първият ред показва изчистения ляв пиксел и червения десен. Кодът променя десния пиксел в копието на син и записва само него с `dx = -1`. Вторият ред показва син ляв пиксел и все още червен десен.

Свързани уроци

  • JavaScript · Урок 33 · Напреднало · Версия: 4

Източници