Класс Raster

protected SampleModel sampleModel

protected DataBuffer dataBuffer

protected int minX

protected int minY

protected int width

protected int height

protected int sampleModelTranslateX

protected int sampleModelTranslateY

protected int numBands

protected int numDataElements

protected Raster parent

protected Raster(SampleModel sampleModel, Point origin)

Параметры:

sampleModel — SampleModel, задающая компоновку

origin — Point, задающая начало координат

Исключения:

RasterFormatException — если вычисление origin.x + sampleModel.getWidth() или origin.y + sampleModel.getHeight() приводит к переполнению целого числа

NullPointerException — если sampleModel или origin равен null

protected Raster(SampleModel sampleModel, DataBuffer dataBuffer, Point origin)

Параметры:

sampleModel — SampleModel, задающая компоновку

dataBuffer — DataBuffer, содержащий данные изображения

origin — Point, задающая начало координат

Исключения:

RasterFormatException — если вычисление origin.x + sampleModel.getWidth() или origin.y + sampleModel.getHeight() приводит к переполнению целого числа

NullPointerException — если sampleModel или origin равен null

protected Raster(SampleModel sampleModel, DataBuffer dataBuffer, Rectangle aRegion, Point sampleModelTranslate, Raster parent)

Параметры:

sampleModel — SampleModel, задающая компоновку

dataBuffer — DataBuffer, содержащий данные изображения

aRegion — Rectangle, задающий область изображения

sampleModelTranslate — Point, задающая преобразование координат из SampleModel в Raster

parent — родительский объект этого Raster (если есть)

Исключения:

NullPointerException — если любой из объектов sampleModel, dataBuffer, aRegion или sampleModelTranslate равен null

RasterFormatException — если ширина или высота aRegion меньше или равна нулю либо вычисление aRegion.x + aRegion.width или aRegion.y + aRegion.height приводит к переполнению целого числа

public static WritableRaster createInterleavedRaster(int dataType, int w, int h, int bands, Point location)

Параметры:

dataType — тип данных для хранения отсчетов

w — ширина данных изображения в пикселях

h — высота данных изображения в пикселях

bands — количество каналов

location — верхний левый угол Raster

Возвращает:

объект WritableRaster с заданными типом данных, шириной, высотой и количеством каналов.

Исключения:

IllegalArgumentException — если dataType не относится к поддерживаемым типам данных

IllegalArgumentException — если bands меньше 1

IllegalArgumentException — если w и h не оба больше 0

IllegalArgumentException — если произведение w и h больше Integer.MAX_VALUE

RasterFormatException — если вычисление location.x + w или location.y + h приводит к переполнению целого числа

public static WritableRaster createInterleavedRaster(int dataType, int w, int h, int scanlineStride, int pixelStride, int[] bandOffsets, Point location)

Параметры:

dataType — тип данных для хранения отсчетов

w — ширина данных изображения в пикселях

h — высота данных изображения в пикселях

scanlineStride — шаг строки данных изображения

pixelStride — шаг пикселя данных изображения

bandOffsets — смещения всех каналов

location — верхний левый угол Raster

Возвращает:

объект WritableRaster с заданными типом данных, шириной, высотой, шагом строки, шагом пикселя и смещениями каналов.

Исключения:

IllegalArgumentException — если dataType не относится к поддерживаемым типам данных: DataBuffer.TYPE_BYTE или DataBuffer.TYPE_USHORT.

IllegalArgumentException — если w и h не оба больше 0

IllegalArgumentException — если произведение w и h больше Integer.MAX_VALUE

RasterFormatException — если вычисление location.x + w или location.y + h приводит к переполнению целого числа

IllegalArgumentException — если scanlineStride меньше 0

IllegalArgumentException — если pixelStride меньше 0

NullPointerException — если bandOffsets равен null

public static WritableRaster createBandedRaster(int dataType, int w, int h, int bands, Point location)

Параметры:

dataType — тип данных для хранения отсчетов

w — ширина данных изображения в пикселях

h — высота данных изображения в пикселях

bands — количество каналов

location — верхний левый угол Raster

Возвращает:

объект WritableRaster с заданными типом данных, шириной, высотой и количеством каналов.

Исключения:

IllegalArgumentException — если dataType не относится к поддерживаемым типам данных: DataBuffer.TYPE_BYTE, DataBuffer.TYPE_USHORT или DataBuffer.TYPE_INT

IllegalArgumentException — если w и h не оба больше 0

IllegalArgumentException — если произведение w и h больше Integer.MAX_VALUE

IllegalArgumentException — если вычисление location.x + w или location.y + h приводит к переполнению целого числа

ArrayIndexOutOfBoundsException — если bands меньше 1

public static WritableRaster createBandedRaster(int dataType, int w, int h, int scanlineStride, int[] bankIndices, int[] bandOffsets, Point location)

Параметры:

dataType — тип данных для хранения отсчетов

w — ширина данных изображения в пикселях

h — высота данных изображения в пикселях

scanlineStride — шаг строки данных изображения

bankIndices — индексы банков для каждого канала

bandOffsets — смещения всех каналов

location — верхний левый угол Raster

Возвращает:

объект WritableRaster с заданными типом данных, шириной, высотой, шагом строки, индексами банков и смещениями каналов.

Исключения:

IllegalArgumentException — если dataType не относится к поддерживаемым типам данных: DataBuffer.TYPE_BYTE, DataBuffer.TYPE_USHORT или DataBuffer.TYPE_INT

IllegalArgumentException — если w и h не оба больше 0

IllegalArgumentException — если произведение w и h больше Integer.MAX_VALUE

IllegalArgumentException — если вычисление location.x + w или location.y + h приводит к переполнению целого числа

IllegalArgumentException — если scanlineStride меньше 0

ArrayIndexOutOfBoundsException — если bankIndices равен null

NullPointerException — если bandOffsets равен null

public static WritableRaster createPackedRaster(int dataType, int w, int h, int[] bandMasks, Point location)

Параметры:

dataType — тип данных для хранения отсчетов

w — ширина данных изображения в пикселях

h — высота данных изображения в пикселях

bandMasks — массив, содержащий элемент для каждого канала

location — верхний левый угол Raster

Возвращает:

объект WritableRaster с заданными типом данных, шириной, высотой и масками каналов.

Исключения:

RasterFormatException — если w или h меньше либо равен нулю или вычисление location.x + w или location.y + h приводит к переполнению целого числа

IllegalArgumentException — если dataType не относится к поддерживаемым типам данных: DataBuffer.TYPE_BYTE, DataBuffer.TYPE_USHORT или DataBuffer.TYPE_INT

public static WritableRaster createPackedRaster(int dataType, int w, int h, int bands, int bitsPerBand, Point location)

Параметры:

dataType — тип данных для хранения отсчетов

w — ширина данных изображения в пикселях

h — высота данных изображения в пикселях

bands — количество каналов

bitsPerBand — количество бит на канал

location — верхний левый угол Raster

Возвращает:

объект WritableRaster с заданными типом данных, шириной, высотой, количеством каналов и количеством бит на канал.

Исключения:

RasterFormatException — если w или h меньше либо равен нулю или вычисление location.x + w или location.y + h приводит к переполнению целого числа

IllegalArgumentException — если произведение bitsPerBand и bands больше количества бит, содержащихся в dataType

IllegalArgumentException — если bitsPerBand или bands не больше нуля

IllegalArgumentException — если dataType не относится к поддерживаемым типам данных: DataBuffer.TYPE_BYTE, DataBuffer.TYPE_USHORT или DataBuffer.TYPE_INT

public static WritableRaster createInterleavedRaster(DataBuffer dataBuffer, int w, int h, int scanlineStride, int pixelStride, int[] bandOffsets, Point location)

Параметры:

dataBuffer — DataBuffer, содержащий данные изображения

w — ширина данных изображения в пикселях

h — высота данных изображения в пикселях

scanlineStride — шаг строки данных изображения

pixelStride — шаг пикселя данных изображения

bandOffsets — смещения всех каналов

location — верхний левый угол Raster

Возвращает:

объект WritableRaster с заданными DataBuffer, шириной, высотой, шагом строки, шагом пикселя и смещениями каналов.

Исключения:

IllegalArgumentException — если dataType не относится к поддерживаемым типам данных: DataBuffer.TYPE_BYTE, DataBuffer.TYPE_USHORT

NullPointerException — если dataBuffer равен null

IllegalArgumentException — если dataType не относится к поддерживаемым типам данных: DataBuffer.TYPE_BYTE или DataBuffer.TYPE_USHORT.

RasterFormatException — если dataBuffer содержит более одного банка.

IllegalArgumentException — если w и h не оба больше 0

IllegalArgumentException — если произведение w и h больше Integer.MAX_VALUE

RasterFormatException — если вычисление location.x + w или location.y + h приводит к переполнению целого числа

IllegalArgumentException — если scanlineStride меньше 0

IllegalArgumentException — если pixelStride меньше 0

NullPointerException — если bandOffsets равен null

public static WritableRaster createBandedRaster(DataBuffer dataBuffer, int w, int h, int scanlineStride, int[] bankIndices, int[] bandOffsets, Point location)

Параметры:

dataBuffer — DataBuffer, содержащий данные изображения

w — ширина данных изображения в пикселях

h — высота данных изображения в пикселях

scanlineStride — шаг строки данных изображения

bankIndices — индексы банков для каждого канала

bandOffsets — смещения всех каналов

location — верхний левый угол Raster

Возвращает:

объект WritableRaster с заданными DataBuffer, шириной, высотой, шагом строки, индексами банков и смещениями каналов.

Исключения:

NullPointerException — если dataBuffer равен null, или bankIndices равен null, или bandOffsets равен null

IllegalArgumentException — если dataType не относится к поддерживаемым типам данных: DataBuffer.TYPE_BYTE, DataBuffer.TYPE_USHORT или DataBuffer.TYPE_INT, либо если w или h меньше либо равен нулю, либо если произведение w и h больше Integer.MAX_VALUE, либо если scanlineStride меньше нуля, либо если длина bankIndices не равна длине bandOffsets

RasterFormatException — если вычисление location.x + w или location.y + h приводит к переполнению целого числа

public static WritableRaster createPackedRaster(DataBuffer dataBuffer, int w, int h, int scanlineStride, int[] bandMasks, Point location)

Параметры:

dataBuffer — DataBuffer, содержащий данные изображения

w — ширина данных изображения в пикселях

h — высота данных изображения в пикселях

scanlineStride — шаг строки данных изображения

bandMasks — массив, содержащий элемент для каждого канала

location — верхний левый угол Raster

Возвращает:

объект WritableRaster с заданными DataBuffer, шириной, высотой, шагом строки и масками каналов.

Исключения:

RasterFormatException — если w или h меньше либо равен нулю или вычисление location.x + w или location.y + h приводит к переполнению целого числа

IllegalArgumentException — если dataBuffer не относится к поддерживаемым типам данных: DataBuffer.TYPE_BYTE, DataBuffer.TYPE_USHORT или DataBuffer.TYPE_INT

RasterFormatException — если dataBuffer содержит более одного банка.

NullPointerException — если dataBuffer равен null

public static WritableRaster createPackedRaster(DataBuffer dataBuffer, int w, int h, int bitsPerPixel, Point location)

Параметры:

dataBuffer — DataBuffer, содержащий данные изображения

w — ширина данных изображения в пикселях

h — высота данных изображения в пикселях

bitsPerPixel — количество бит на пиксель

location — верхний левый угол Raster

Возвращает:

объект WritableRaster с заданными DataBuffer, шириной, высотой и количеством бит на пиксель.

Исключения:

RasterFormatException — если w или h меньше либо равен нулю или вычисление location.x + w или location.y + h приводит к переполнению целого числа

IllegalArgumentException — если dataType не относится к поддерживаемым типам данных: DataBuffer.TYPE_BYTE, DataBuffer.TYPE_USHORT или DataBuffer.TYPE_INT

RasterFormatException — если dataBuffer содержит более одного банка.

NullPointerException — если dataBuffer равен null

public static Raster createRaster(SampleModel sm, DataBuffer db, Point location)

Параметры:

sm — заданная SampleModel

db — заданный DataBuffer

location — верхний левый угол Raster

Возвращает:

Raster с заданными SampleModel, DataBuffer и location.

Исключения:

RasterFormatException — если вычисление location.x + sm.getWidth() или location.y + sm.getHeight() приводит к переполнению целого числа

RasterFormatException — если db содержит более одного банка, а sm является PixelInterleavedSampleModel, SinglePixelPackedSampleModel или MultiPixelPackedSampleModel.

NullPointerException — если SampleModel или DataBuffer равен null

public static WritableRaster createWritableRaster(SampleModel sm, Point location)

Параметры:

sm — заданная SampleModel

location — верхний левый угол WritableRaster

Возвращает:

WritableRaster с заданными SampleModel и location.

Исключения:

RasterFormatException — если вычисление location.x + sm.getWidth() или location.y + sm.getHeight() приводит к переполнению целого числа

public static WritableRaster createWritableRaster(SampleModel sm, DataBuffer db, Point location)

Параметры:

sm — заданная SampleModel

db — заданный DataBuffer

location — верхний левый угол WritableRaster

Возвращает:

WritableRaster с заданными SampleModel, DataBuffer и location.

Исключения:

RasterFormatException — если вычисление location.x + sm.getWidth() или location.y + sm.getHeight() приводит к переполнению целого числа

RasterFormatException — если db содержит более одного банка, а sm является PixelInterleavedSampleModel, SinglePixelPackedSampleModel или MultiPixelPackedSampleModel.

NullPointerException — если SampleModel или DataBuffer равен null

public Raster getParent()

Возвращает:

родительский Raster или null.

public final int getSampleModelTranslateX()

Возвращает:

смещение по X из пространства координат SampleModel объекта Raster в пространство координат Raster.

public final int getSampleModelTranslateY()

Возвращает:

смещение по Y из пространства координат SampleModel объекта Raster в пространство координат Raster.

public WritableRaster createCompatibleWritableRaster()

Возвращает:

совместимый WritableRaster с той же моделью образцов и новым буфером данных.

public WritableRaster createCompatibleWritableRaster(int w, int h)

Параметры:

w — заданная ширина нового WritableRaster

h — заданная высота нового WritableRaster

Возвращает:

совместимый WritableRaster указанного размера с новой моделью образцов и новым буфером данных.

Вызывает:

RasterFormatException — если ширина или высота меньше либо равна нулю.

public WritableRaster createCompatibleWritableRaster(Rectangle rect)

Параметры:

rect — Rectangle, задающий размер и расположение WritableRaster

Возвращает:

совместимый WritableRaster с заданными размером и расположением, а также новой моделью образцов и новым буфером данных.

Вызывает:

RasterFormatException — если rect имеет ширину или высоту меньше либо равную нулю или вычисление rect.x + rect.width либо rect.y + rect.height приводит к переполнению целого числа

NullPointerException — если rect имеет значение null

public WritableRaster createCompatibleWritableRaster(int x, int y, int w, int h)

Параметры:

x — координата X верхнего левого угла WritableRaster

y — координата Y верхнего левого угла WritableRaster

w — заданная ширина WritableRaster

h — заданная высота WritableRaster

Возвращает:

совместимый WritableRaster с заданными размером и расположением, а также новой моделью образцов и новым буфером данных.

Вызывает:

RasterFormatException — если w или h меньше либо равен нулю или вычисление x + w либо y + h приводит к переполнению целого числа

public Raster createTranslatedChild(int childMinX, int childMinY)

Параметры:

childMinX — координата X верхнего левого угла нового Raster

childMinY — координата Y верхнего левого угла нового Raster

Возвращает:

новый Raster того же размера, с той же моделью SampleModel и тем же DataBuffer, что и этот Raster, но с заданным расположением.

Вызывает:

RasterFormatException — если вычисление childMinX + this.getWidth() либо childMinY + this.getHeight() приводит к переполнению целого числа

public Raster createChild(int parentX, int parentY, int width, int height, int childMinX, int childMinY, int[] bandList)

Параметры:

parentX — координата X верхнего левого угла в системе координат этого Raster

parentY — координата Y верхнего левого угла в системе координат этого Raster

width — ширина области, начинающейся в точке (parentX, parentY)

height — высота области, начинающейся в точке (parentX, parentY).

childMinX — координата X верхнего левого угла возвращаемого Raster

childMinY — координата Y верхнего левого угла возвращаемого Raster

bandList — массив индексов полос или null, чтобы использовать все полосы

Возвращает:

новый Raster.

Вызывает:

RasterFormatException — если заданная подобласть находится за пределами растра.

RasterFormatException — если width или height меньше либо равен нулю или вычисление любого из значений parentX + width, parentY + height, childMinX + width или childMinY + height приводит к переполнению целого числа

public Rectangle getBounds()

Возвращает:

ограничивающую рамку этого Raster.

public final int getMinX()

Возвращает:

минимальную координату x этого Raster.

public final int getMinY()

Возвращает:

минимальную координату y этого Raster.

public final int getWidth()

Возвращает:

ширину этого Raster.

public final int getHeight()

Возвращает:

высоту этого Raster.

public final int getNumBands()

Возвращает:

количество полос этого Raster.

public final int getNumDataElements()

Возвращает:

количество элементов данных.

public final int getTransferType()

Возвращает:

этот тип передачи.

public DataBuffer getDataBuffer()

Возвращает:

DataBuffer этого Raster.

public SampleModel getSampleModel()

Возвращает:

SampleModel этого Raster.

public Object getDataElements(int x, int y, Object outData)

Параметры:

x — координата X расположения пикселя

y — координата Y расположения пикселя

outData — ссылка на объект-массив типа, заданного методом getTransferType(), длиной getNumDataElements(). Если значение равно null, будет выделен массив подходящего типа и размера

Возвращает:

ссылку на объект-массив типа, заданного методом getTransferType(), с данными запрошенного пикселя.

Вызывает:

ArrayIndexOutOfBoundsException — если координаты находятся за пределами допустимой области или outData слишком мал для хранения результата.

См. также:

• SampleModel.getDataElements(int, int, Object, DataBuffer)

public Object getDataElements(int x, int y, int w, int h, Object outData)

Параметры:

x — координата X верхнего левого пикселя

y — координата Y верхнего левого пикселя

w — ширина прямоугольника пикселей

h — высота прямоугольника пикселей

outData — ссылка на объект-массив типа, заданного методом getTransferType(), длиной w*h*getNumDataElements(). Если значение равно null, будет выделен массив подходящего типа и размера.

Возвращает:

ссылку на объект-массив типа, заданного методом getTransferType(), с данными запрошенных пикселей.

Вызывает:

ArrayIndexOutOfBoundsException — если координаты находятся за пределами допустимой области или outData слишком мал для хранения результата.

См. также:

• SampleModel.getDataElements(int, int, int, int, Object, DataBuffer)

public int[] getPixel(int x, int y, int[] iArray)

Параметры:

x — координата X расположения пикселя

y — координата Y расположения пикселя

iArray — предварительно выделенный массив int (необязательно)

Возвращает:

образцы указанного пикселя.

Вызывает:

ArrayIndexOutOfBoundsException — если координаты находятся за пределами допустимой области или iArray слишком мал для хранения результата.

public float[] getPixel(int x, int y, float[] fArray)

Параметры:

x — координата X расположения пикселя

y — координата Y расположения пикселя

fArray — предварительно выделенный массив float (необязательно)

Возвращает:

образцы указанного пикселя.

Вызывает:

ArrayIndexOutOfBoundsException — если координаты находятся за пределами допустимой области или fArray слишком мал для хранения результата.

public double[] getPixel(int x, int y, double[] dArray)

Параметры:

x — координата X расположения пикселя

y — координата Y расположения пикселя

dArray — предварительно выделенный массив double (необязательно)

Возвращает:

образцы указанного пикселя.

Вызывает:

ArrayIndexOutOfBoundsException — если координаты находятся за пределами допустимой области или dArray слишком мал для хранения результата.

public int[] getPixels(int x, int y, int w, int h, int[] iArray)

Параметры:

x — координата X верхнего левого пикселя

y — координата Y верхнего левого пикселя

w — ширина прямоугольника пикселей

h — высота прямоугольника пикселей

iArray — предварительно выделенный массив int (необязательно)

Возвращает:

образцы указанного прямоугольника пикселей.

Вызывает:

ArrayIndexOutOfBoundsException — если координаты находятся за пределами допустимой области или iArray слишком мал для хранения результата.

public float[] getPixels(int x, int y, int w, int h, float[] fArray)

Параметры:

x — координата X расположения пикселя

y — координата Y расположения пикселя

w — ширина прямоугольника пикселей

h — высота прямоугольника пикселей

fArray — предварительно выделенный массив float (необязательно)

Возвращает:

образцы указанного прямоугольника пикселей.

Вызывает:

ArrayIndexOutOfBoundsException — если координаты находятся за пределами допустимой области или fArray слишком мал для хранения результата.

public double[] getPixels(int x, int y, int w, int h, double[] dArray)

Параметры:

x — координата X верхнего левого пикселя

y — координата Y верхнего левого пикселя

w — ширина прямоугольника пикселей

h — высота прямоугольника пикселей

dArray — предварительно выделенный массив double (необязательно)

Возвращает:

образцы указанного прямоугольника пикселей.

Вызывает:

ArrayIndexOutOfBoundsException — если координаты находятся за пределами допустимой области или dArray слишком мал для хранения результата.

public int getSample(int x, int y, int b)

Параметры:

x — координата X расположения пикселя

y — координата Y расположения пикселя

b — возвращаемая полоса

Возвращает:

образец указанной полосы пикселя с заданными координатами.

Вызывает:

ArrayIndexOutOfBoundsException — если координаты или индекс полосы находятся за пределами допустимой области.

public float getSampleFloat(int x, int y, int b)

Параметры:

x — координата X расположения пикселя

y — координата Y расположения пикселя

b — возвращаемая полоса

Возвращает:

образец указанной полосы пикселя с заданными координатами.

Вызывает:

ArrayIndexOutOfBoundsException — если координаты или индекс полосы находятся за пределами допустимой области.

public double getSampleDouble(int x, int y, int b)

Параметры:

x — координата X расположения пикселя

y — координата Y расположения пикселя

b — возвращаемая полоса

Возвращает:

образец указанной полосы пикселя с заданными координатами.

Вызывает:

ArrayIndexOutOfBoundsException — если координаты или индекс полосы находятся за пределами допустимой области.

public int[] getSamples(int x, int y, int w, int h, int b, int[] iArray)

Параметры:

x — координата X верхнего левого пикселя

y — координата Y верхнего левого пикселя

w — ширина прямоугольника пикселей

h — высота прямоугольника пикселей

b — возвращаемая полоса

iArray — предварительно выделенный массив int (необязательно)

Возвращает:

образцы указанной полосы для заданного прямоугольника пикселей.

Вызывает:

ArrayIndexOutOfBoundsException — если координаты или индекс полосы находятся за пределами допустимой области либо iArray слишком мал для хранения результата.

public float[] getSamples(int x, int y, int w, int h, int b, float[] fArray)

Параметры:

x — координата X верхнего левого пикселя

y — координата Y верхнего левого пикселя

w — ширина прямоугольника пикселей

h — высота прямоугольника пикселей

b — возвращаемая полоса

fArray — предварительно выделенный массив float (необязательно)

Возвращает:

образцы указанной полосы для заданного прямоугольника пикселей.

Вызывает:

ArrayIndexOutOfBoundsException — если координаты или индекс полосы находятся за пределами допустимой области либо fArray слишком мал для хранения результата.

public double[] getSamples(int x, int y, int w, int h, int b, double[] dArray)

Параметры:

x — координата X верхнего левого пикселя

y — координата Y верхнего левого пикселя

w — ширина прямоугольника пикселей

h — высота прямоугольника пикселей

b — возвращаемая полоса

dArray — предварительно выделенный массив double (необязательно)

Возвращает:

образцы указанной полосы для заданного прямоугольника пикселей.

Вызывает:

ArrayIndexOutOfBoundsException — если координаты или индекс полосы находятся за пределами допустимой области либо dArray слишком мал для хранения результата.