MDN wants to learn about developers like you: https://qsurvey.mozilla.com/s3/MDN-dev-survey

Перевод не завершен. Пожалуйста, помогите перевести эту статью с английского.

CanvasRenderingContext2D.getImageData() - метод Canvas 2D API, возвращает объект ImageData, представляющий базовые пиксельные данные для области холста, обозначенного прямоугольником, который начинается в точке (sx, sy) и имеет ширину sw и высоту sh.

Синтаксис

ImageData ctx.getImageData(sx, sy, sw, sh);

Параметры

sx
Координата x верхнего левого угла прямоугольника, из которого будет извлечен ImageData.
sy
Координата y верхнего левого угла прямоугольника, из которого будет извлечен ImageData.
sw
Ширина прямоугольника, из которого будет извлечен ImageData.
sh
Высота прямоугольника, из которого будет извлечен ImageData.

Возвращаемое значение

Объект ImageData, содержащий данные изображения для данного прямоугольника холста.

Выбрасываемые ошибки

IndexSizeError
Выбрасывает, если аргумент высоты или ширины равен нулю.

Примеры

Использование метода getImageData

Это всего лишь простой фрагмент кода, который использует метод getImageData. Для получения дополнительной информации см Pixel manipulation with canvas и объект ImageData.

HTML

<canvas id="canvas"></canvas>

JavaScript

var canvas = document.getElementById("canvas");
var ctx = canvas.getContext("2d");
ctx.rect(10, 10, 100, 100);
ctx.fill();

console.log(ctx.getImageData(50, 50, 100, 100));
// ImageData { width: 100, height: 100, data: Uint8ClampedArray[40000] }

Спецификации

Specification Status Comment
WHATWG HTML Living Standard
Определение 'CanvasRenderingContext2D.getImageData' в этой спецификации.
Живой стандарт  

Совместимость с браузерами

Feature Chrome Firefox (Gecko) Internet Explorer Opera Safari
Базовая поддержка (Да) (Да) [1] (Да) (Да) (Да)
Feature Android Chrome for Android Firefox Mobile (Gecko) IE Mobile Opera Mobile Safari Mobile
Базовая поддержка (Да) (Да) (Да) [1] (Да) (Да) (Да)

[1] Начинаяя с (Firefox 5.0 / Thunderbird 5.0 / SeaMonkey 2.2), getImageData() теперь корректно принимает прямоугольники, которые выходят за пределы холста; пиксели за пределами холста возвращаются в виде прозрачного черного и теперь также возвращает значение как минимум одного пикселя данных изображения, если задан прямоугольник менее, чем один пиксель.

См также

Метки документа и участники

 Внесли вклад в эту страницу: Faik-man
 Обновлялась последний раз: Faik-man,