Класс Raster

public class Raster
extends Object

Класс, представляющий прямоугольный массив пикселей. Объект Raster encapsлирует DataBuffer, хранящий значения образцов, и SampleModel, описывающий способ определения значения заданного образца в DataBuffer.

Raster определяет значения пикселей, занимающих определённую прямоугольную область на плоскости, не обязательно включающую (0, 0). Прямоугольник, известный как ограничивающая прямоугольник Raster и доступный посредством метода getBounds, определяется значениями minX, minY, width и height. Значения minX и minY определяют координаты верхнего левого угла Raster. Ссылки на пиксели за пределами ограничивающей прямоугольника могут привести к выбрасыванию исключения или к ссылкам на непредназначенные элементы связанного с Raster DataBuffer. Пользователь несёт ответственность за избегание доступа к таким пикселям.

SampleModel описывает, как образцы Raster хранятся в элементах примитивного массива DataBuffer. Образцы могут храниться по одному на каждый элемент данных, как в PixelInterleavedSampleModel или BandedSampleModel, или упаковываться несколько в один элемент, как в SinglePixelPackedSampleModel или MultiPixelPackedSampleModel. SampleModel также управляет тем, расширяются ли образцы со знаком, что позволяет хранить беззнаковые данные в знаковых типах данных Java, таких как byte, short и int.

Хотя Raster может находиться где угодно на плоскости, SampleModel использует простую систему координат, начинающуюся с (0, 0). Поэтому Raster содержит коэффициент смещения, который позволяет отображать местоположения пикселей между системой координат Raster и SampleModel. Преобразование из системы координат SampleModel в систему координат Raster можно получить с помощью методов getSampleModelTranslateX и getSampleModelTranslateY.

Raster может совместно использовать DataBuffer с другим Raster, как явно при создании, так и с помощью методов createChild и createTranslatedChild. Rasters, созданные с помощью этих методов, могут возвращать ссылку на Raster, из которого они были созданы, с помощью метода getParent. Для Raster, который не был создан с помощью вызова createTranslatedChild или createChild, getParent вернёт null.

Метод createTranslatedChild возвращает новый Raster, который разделяет все данные текущего Raster, но занимает ограничивающую прямоугольник той же ширины и высоты, но с другой начальной точкой. Например, если родительский Raster занимал область от (10, 10) до (100, 100), а Raster, смещённый по координатам, был определён как начинающийся в (50, 50), то пиксель (20, 20) родителя и пиксель (60, 60) дочернего занимают то же место в DataBuffer, разделяемом двумя Rasters. В первом случае к координатам пикселя необходимо добавить (-10, -10) для получения соответствующих координат SampleModel, а во втором случае - (-50, -50).

Преобразование между родительским и дочерним Raster можно определить, вычитав значения sampleModelTranslateX и sampleModelTranslateY дочернего из значений родителя.

Метод createChild может использоваться для создания нового Raster, занимающего только подмножество ограничивающей прямоугольника родителя (с той же или смещённой системой координат) или с подмножеством полос родителя.

Все конструкторы защищены. Правильный способ создания Raster — использование одного из статических методов создания, определённых в этом классе. Эти методы создают экземпляры Raster, использующие стандартные Interleaved, Banded и Packed SampleModels и которые могут обрабатываться более эффективно, чем Raster, созданный путём объединения внешне сгенерированного SampleModel и DataBuffer.