Класс SampleModel

protected int width

protected int height

protected int numBands

protected int dataType

См. также:

• DataBuffer

public SampleModel(int dataType, int w, int h, int numBands)

Параметры:

dataType — тип данных DataBuffer, в котором хранятся данные пикселей.

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

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

numBands — количество каналов данных изображения.

Исключения:

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

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

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

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

public final int getWidth()

Возвращает:

ширину в пикселях области данных изображения, описываемой этим SampleModel.

public final int getHeight()

Возвращает:

высоту в пикселях области данных изображения, описываемой этим SampleModel.

public final int getNumBands()

Возвращает:

количество каналов данных изображения, описываемых этим SampleModel.

public abstract int getNumDataElements()

Возвращает:

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

См. также:

• getDataElements(int, int, Object, DataBuffer)
• getDataElements(int, int, int, int, Object, DataBuffer)
• setDataElements(int, int, Object, DataBuffer)
• setDataElements(int, int, int, int, Object, DataBuffer)
• getTransferType()

public final int getDataType()

Возвращает:

тип данных.

public int getTransferType()

Возвращает:

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

См. также:

• getDataElements(int, int, Object, DataBuffer)
• getDataElements(int, int, int, int, Object, DataBuffer)
• setDataElements(int, int, Object, DataBuffer)
• setDataElements(int, int, int, int, Object, DataBuffer)
• getNumDataElements()
• DataBuffer

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

Параметры:

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

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

iArray — если не null, отсчеты возвращаются в этот массив

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

Возвращает:

отсчеты указанного пикселя.

Исключения:

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

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

См. также:

• setPixel(int, int, int[], DataBuffer)

public abstract Object getDataElements(int x, int y, Object obj, DataBuffer data)

      SampleModel sm1, sm2;
      DataBuffer db1, db2;
      sm2.setDataElements(x, y, sm1.getDataElements(x, y, null, db1), db2);

Параметры:

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

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

obj — если не null, примитивный массив, в который возвращаются данные пикселя.

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

Возвращает:

элементы данных указанного пикселя.

Исключения:

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

ArrayIndexOutOfBoundsException — если координаты выходят за допустимые границы или obj слишком мал для хранения результата.

См. также:

• getNumDataElements()
• getTransferType()
• DataBuffer
• setDataElements(int, int, Object, DataBuffer)

public Object getDataElements(int x, int y, int w, int h, Object obj, DataBuffer data)

      SampleModel sm1, sm2;
      DataBuffer db1, db2;
      sm2.setDataElements(x, y, w, h, sm1.getDataElements(x, y, w,
                          h, null, db1), db2);

Параметры:

x — минимальная координата X прямоугольника пикселей.

y — минимальная координата Y прямоугольника пикселей.

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

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

obj — если не null, примитивный массив, в который возвращаются данные пикселей.

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

Возвращает:

элементы данных указанной области пикселей.

Исключения:

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

ArrayIndexOutOfBoundsException — если координаты выходят за допустимые границы, w или h отрицательно либо obj слишком мал для хранения результата.

См. также:

• getNumDataElements()
• getTransferType()
• setDataElements(int, int, int, int, Object, DataBuffer)
• DataBuffer

public abstract void setDataElements(int x, int y, Object obj, DataBuffer data)

      SampleModel sm1, sm2;
      DataBuffer db1, db2;
      sm2.setDataElements(x, y, sm1.getDataElements(x, y, null, db1),
                          db2);

Параметры:

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

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

obj - Примитивный массив, содержащий данные пикселя.

data - DataBuffer, содержащий данные изображения.

Исключения:

NullPointerException - если obj или data равно null.

ArrayIndexOutOfBoundsException - если координаты выходят за допустимые границы или obj слишком мал для хранения входных данных.

См. также:

• getNumDataElements()
• getTransferType()
• getDataElements(int, int, Object, DataBuffer)
• DataBuffer

public void setDataElements(int x, int y, int w, int h, Object obj, DataBuffer data)

      SampleModel sm1, sm2;
      DataBuffer db1, db2;
      sm2.setDataElements(x, y, w, h, sm1.getDataElements(x, y, w, h,
                          null, db1), db2);

Параметры:

x - Минимальная координата X прямоугольной области пикселей.

y - Минимальная координата Y прямоугольной области пикселей.

w - Ширина прямоугольной области пикселей.

h - Высота прямоугольной области пикселей.

obj - Примитивный массив, содержащий данные пикселей.

data - DataBuffer, содержащий данные изображения.

Исключения:

NullPointerException - если obj или data равно null.

ArrayIndexOutOfBoundsException - если координаты выходят за допустимые границы или obj слишком мал для хранения входных данных.

См. также:

• getNumDataElements()
• getTransferType()
• getDataElements(int, int, int, int, Object, DataBuffer)
• DataBuffer

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

Параметры:

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

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

fArray - Если значение не равно null, отсчеты возвращаются в этот массив.

data - DataBuffer, содержащий данные изображения.

Возвращает:

отсчеты указанного пикселя.

Исключения:

NullPointerException - если data равно null.

ArrayIndexOutOfBoundsException - если координаты выходят за допустимые границы или fArray слишком мал для хранения выходных данных.

См. также:

• setPixel(int, int, float[], DataBuffer)

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

Параметры:

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

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

dArray - Если значение не равно null, отсчеты возвращаются в этот массив.

data - DataBuffer, содержащий данные изображения.

Возвращает:

отсчеты указанного пикселя.

Исключения:

NullPointerException - если data равно null.

ArrayIndexOutOfBoundsException - если координаты выходят за допустимые границы или dArray слишком мал для хранения выходных данных.

См. также:

• setPixel(int, int, double[], DataBuffer)

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

Параметры:

x - Координата X положения пикселя в верхнем левом углу.

y - Координата Y положения пикселя в верхнем левом углу.

w - Ширина прямоугольной области пикселей.

h - Высота прямоугольной области пикселей.

iArray - Если значение не равно null, отсчеты возвращаются в этот массив.

data - DataBuffer, содержащий данные изображения.

Возвращает:

отсчеты указанной области пикселей.

Исключения:

NullPointerException - если data равно null.

ArrayIndexOutOfBoundsException - если координаты выходят за допустимые границы, w или h отрицательно либо iArray слишком мал для хранения выходных данных.

См. также:

• setPixels(int, int, int, int, int[], DataBuffer)

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

Параметры:

x - Координата X положения пикселя в верхнем левом углу.

y - Координата Y положения пикселя в верхнем левом углу.

w - Ширина прямоугольной области пикселей.

h - Высота прямоугольной области пикселей.

fArray - Если значение не равно null, отсчеты возвращаются в этот массив.

data - DataBuffer, содержащий данные изображения.

Возвращает:

отсчеты указанной области пикселей.

Исключения:

NullPointerException - если data равно null.

ArrayIndexOutOfBoundsException - если координаты выходят за допустимые границы, w или h отрицательно либо fArray слишком мал для хранения выходных данных.

См. также:

• setPixels(int, int, int, int, float[], DataBuffer)

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

Параметры:

x - Координата X положения пикселя в верхнем левом углу.

y - Координата Y положения пикселя в верхнем левом углу.

w - Ширина прямоугольной области пикселей.

h - Высота прямоугольной области пикселей.

dArray - Если значение не равно null, отсчеты возвращаются в этот массив.

data - DataBuffer, содержащий данные изображения.

Возвращает:

отсчеты указанной области пикселей.

Исключения:

NullPointerException - если data равно null.

ArrayIndexOutOfBoundsException - если координаты выходят за допустимые границы, w или h отрицательно либо dArray слишком мал для хранения выходных данных.

См. также:

• setPixels(int, int, int, int, double[], DataBuffer)

public abstract int getSample(int x, int y, int b, DataBuffer data)

Параметры:

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

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

b - Полоса, отсчет которой требуется вернуть.

data - DataBuffer, содержащий данные изображения.

Возвращает:

отсчет в указанной полосе указанного пикселя.

Исключения:

NullPointerException - если data равно null.

ArrayIndexOutOfBoundsException - если координаты или индекс полосы выходят за допустимые границы.

См. также:

• setSample(int, int, int, int, DataBuffer)

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

Параметры:

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

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

b - Полоса, отсчет которой требуется вернуть.

data - DataBuffer, содержащий данные изображения.

Возвращает:

отсчет в указанной полосе указанного пикселя.

Исключения:

NullPointerException - если data равно null.

ArrayIndexOutOfBoundsException - если координаты или индекс полосы выходят за допустимые границы.

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

Параметры:

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

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

b - Полоса, отсчет которой требуется вернуть.

data - DataBuffer, содержащий данные изображения.

Возвращает:

отсчет в указанной полосе указанного пикселя.

Исключения:

NullPointerException - если data равно null.

ArrayIndexOutOfBoundsException - если координаты или индекс полосы выходят за допустимые границы.

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

Параметры:

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

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

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

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

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

iArray — если значение не равно null, отсчёты возвращаются в этом массиве.

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

Возвращает:

отсчёты указанной полосы для заданной области пикселей.

Выбрасывает:

NullPointerException — если data равно null.

ArrayIndexOutOfBoundsException — если координаты или индекс полосы выходят за допустимые границы, w или h отрицательно либо iArray слишком мал для размещения результата.

См. также:

• setSamples(int, int, int, int, int, int[], DataBuffer)

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

Параметры:

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

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

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

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

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

fArray — если значение не равно null, отсчёты возвращаются в этом массиве.

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

Возвращает:

отсчёты указанной полосы для заданной области пикселей.

Выбрасывает:

NullPointerException — если data равно null.

ArrayIndexOutOfBoundsException — если координаты или индекс полосы выходят за допустимые границы, w или h отрицательно либо iArray слишком мал для размещения результата.

См. также:

• setSamples(int, int, int, int, int, float[], DataBuffer)

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

Параметры:

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

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

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

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

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

dArray — если значение не равно null, отсчёты возвращаются в этом массиве.

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

Возвращает:

отсчёты указанной полосы для заданной области пикселей.

Выбрасывает:

NullPointerException — если data равно null.

ArrayIndexOutOfBoundsException — если координаты или индекс полосы выходят за допустимые границы, w или h отрицательно либо dArray слишком мал для размещения результата.

См. также:

• setSamples(int, int, int, int, int, double[], DataBuffer)

public void setPixel(int x, int y, int[] iArray, DataBuffer data)

Параметры:

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

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

iArray — входные отсчёты в массиве int.

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

Выбрасывает:

NullPointerException — если iArray или {code data} равно null.

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

См. также:

• getPixel(int, int, int[], DataBuffer)

public void setPixel(int x, int y, float[] fArray, DataBuffer data)

Параметры:

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

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

fArray — входные отсчёты в массиве float.

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

Выбрасывает:

NullPointerException — если fArray или data равно null.

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

См. также:

• getPixel(int, int, float[], DataBuffer)

public void setPixel(int x, int y, double[] dArray, DataBuffer data)

Параметры:

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

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

dArray — входные отсчёты в массиве double.

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

Выбрасывает:

NullPointerException — если dArray или data равно null.

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

См. также:

• getPixel(int, int, double[], DataBuffer)

public void setPixels(int x, int y, int w, int h, int[] iArray, DataBuffer data)

Параметры:

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

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

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

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

iArray — входные отсчёты в массиве int.

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

Выбрасывает:

NullPointerException — если iArray или data равно null.

ArrayIndexOutOfBoundsException — если координаты выходят за допустимые границы, w или h отрицательно либо iArray слишком мал для размещения входных данных.

См. также:

• getPixels(int, int, int, int, int[], DataBuffer)

public void setPixels(int x, int y, int w, int h, float[] fArray, DataBuffer data)

Параметры:

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

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

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

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

fArray — входные отсчёты в массиве float.

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

Выбрасывает:

NullPointerException — если fArray или data равно null.

ArrayIndexOutOfBoundsException — если координаты выходят за допустимые границы, w или h отрицательно либо fArray слишком мал для размещения входных данных.

См. также:

• getPixels(int, int, int, int, float[], DataBuffer)

public void setPixels(int x, int y, int w, int h, double[] dArray, DataBuffer data)

Параметры:

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

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

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

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

dArray — входные отсчёты в массиве double.

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

Выбрасывает:

NullPointerException — если dArray или data равно null.

ArrayIndexOutOfBoundsException — если координаты выходят за допустимые границы, w или h отрицательно либо dArray слишком мал для размещения входных данных.

См. также:

• getPixels(int, int, int, int, double[], DataBuffer)

public abstract void setSample(int x, int y, int b, int s, DataBuffer data)

Параметры:

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

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

b — задаваемая полоса.

s — входной отсчёт типа int.

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

Выбрасывает:

NullPointerException — если data равно null.

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

См. также:

• getSample(int, int, int, DataBuffer)

public void setSample(int x, int y, int b, float s, DataBuffer data)

Параметры:

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

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

b — задаваемая полоса.

s — входной отсчёт типа float.

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

Выбрасывает:

NullPointerException — если data равно null.

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

См. также:

• getSample(int, int, int, DataBuffer)

public void setSample(int x, int y, int b, double s, DataBuffer data)

Параметры:

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

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

b — канал, значение которого требуется установить.

s — входное значение отсчёта типа double.

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

Выбрасывает:

NullPointerException — если data равно null.

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

См. также:

• getSample(int, int, int, DataBuffer)

public void setSamples(int x, int y, int w, int h, int b, int[] iArray, DataBuffer data)

Параметры:

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

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

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

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

b — канал, значения которого требуется установить.

iArray — входные значения отсчётов в массиве int.

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

Выбрасывает:

NullPointerException — если iArray или data равно null.

ArrayIndexOutOfBoundsException — если координаты или индекс канала выходят за допустимые пределы, либо w или h имеет отрицательное значение, либо iArray слишком мал для хранения входных данных.

См. также:

• getSamples(int, int, int, int, int, int[], DataBuffer)

public void setSamples(int x, int y, int w, int h, int b, float[] fArray, DataBuffer data)

Параметры:

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

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

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

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

b — канал, значения которого требуется установить.

fArray — входные значения отсчётов в массиве float.

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

Выбрасывает:

NullPointerException — если fArray или data равно null.

ArrayIndexOutOfBoundsException — если координаты или индекс канала выходят за допустимые пределы, либо w или h имеет отрицательное значение, либо fArray слишком мал для хранения входных данных.

См. также:

• getSamples(int, int, int, int, int, float[], DataBuffer)

public void setSamples(int x, int y, int w, int h, int b, double[] dArray, DataBuffer data)

Параметры:

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

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

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

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

b — канал, значения которого требуется установить.

dArray — входные значения отсчётов в массиве double.

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

Выбрасывает:

NullPointerException — если dArray или data равно null.

ArrayIndexOutOfBoundsException — если координаты или индекс канала выходят за допустимые пределы, либо w или h имеет отрицательное значение, либо dArray слишком мал для хранения входных данных.

См. также:

• getSamples(int, int, int, int, int, double[], DataBuffer)

public abstract SampleModel createCompatibleSampleModel(int w, int h)

Параметры:

w — ширина данных изображения

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

Возвращает:

SampleModel, описывающую те же данные изображения, что и эта SampleModel, но с другим размером.

public abstract SampleModel createSubsetSampleModel(int[] bands)

Параметры:

bands — подмножество каналов этой SampleModel

Возвращает:

SampleModel с подмножеством каналов этой SampleModel.

public abstract DataBuffer createDataBuffer()

Возвращает:

DataBuffer, соответствующий этой SampleModel.

public abstract int[] getSampleSize()

Возвращает:

размер отсчётов для всех каналов.

public abstract int getSampleSize(int band)

Параметры:

band — указанный канал

Возвращает:

размер отсчётов указанного канала.