SampleModel (Java 2 Platform SE 5.0)

개요

패키지

클래스

사용

계층 트리

비추천 API

색인

헬프

Java^TM 2 Platform
Standard Ed. 5.0

이전 클래스 다음 클래스

프레임으로 프레임 없이

개요: NESTED | 필드 | constructor | 메서드

상세: 필드 | 생성자 | 메서드

java.awt.image
클래스 SampleModel

java.lang.Object 
  java.awt.image.SampleModel

알려진 직계 서브 클래스:: ComponentSampleModel, MultiPixelPackedSampleModel, SinglePixelPackedSampleModel

public abstract class SampleModel
extends Object
extends Object

이 추상 클래스는 이미지에 있는 픽셀의 샘플을 추출하는 인터페이스를 정의합니다. 이미지 데이터는 모두, 픽셀의 컬렉션으로서 표현됩니다. 각 픽셀은 다수의 샘플로 구성됩니다. 샘플은 이미지의 1 밴드의 데이터입니다. 밴드는 이미지에 있는 특정의 타입의 모든 샘플로 구성됩니다. 예를 들어 픽셀이, 적색 성분, 녹색 성분, 청색 성분을 나타내는 3개의 샘플을 포함하고 있다고 합니다. 이 픽셀을 포함한 이미지에는 3개의 밴드가 있습니다. 1개의 밴드는 이미지의 모든 픽셀의 모든 적색 샘플로 구성됩니다. 2번째의 밴드는 모든 녹색 샘플로 구성되어 나머지의 밴드는 모든 청색 샘플로 구성됩니다. 픽셀은 다양한 형식에서 포함할 수 있습니다. 예를 들어 특정의 밴드의 모든 샘플을 연속해 포함하거나 단일의 픽셀의 모든 샘플을 연속해 포함하거나 할 수 있습니다.

SampleModel 서브 클래스는 unsigned 8-bit byte, signed 16-bit short 등의, 표현 가능한 샘플의 데이터형을 지정합니다. 메모리상에서의 샘플의 배치 방법도 지정 가능합니다. Java 2D(TM) API 에서는 빌트인형의 이미지 처리 연산자에서는 사용 가능한 모든 샘플 데이터형의 연산을 실시하지 않고, 16 비트 아래의 부호 없음 정수의 샘플의 연산만을 실행합니다. 연산자에 따라서는 보다 많은 샘플 데이터형에 대응하고 있는 것도 있습니다.

픽셀의 집합은 DataBuffer 과 SampleModel 로 구성되는 Raster 로서 나타내집니다. SampleModel를 사용하면, DataBuffer 내의 샘플에 액세스 할 수 있습니다. 또, DataBuffer 로 샘플 및 픽셀을 직접 조작하기 위해서 프로그래머가 사용할 수 있는 저레벨의 정보를 제공합니다.

이 클래스는 일반적으로는 이미지 처리를 위한 폴 백 메서드입니다. 보다 효율적으로 코드를 기술하면, 적절한 서브 클래스에 SampleModel를 캐스트 해, DataBuffer 픽셀을 직접 조작하기 위해서 필요한 정보를 추출할 수 있습니다.

관련 항목:: @see java.awt.image.Raster @see java.awt.image.ComponentSampleModel @see java.awt.image.PixelInterleavedSampleModel @see java.awt.image.BandedSampleModel @see java.awt.image.MultiPixelPackedSampleModel @see java.awt.image.SinglePixelPackedSampleModel

필드 개요
`protected int`	`dataType` 픽셀 데이터를 포함하는 DataBuffer 데이터형 @see java.awt.image.DataBuffer
`protected int`	`height` 이 SampleModel가 기술하는 이미지 데이터의 영역의 높이 (단위는 픽셀)입니다.
`protected int`	`numBands` 이 SampleModel가 기술하는 이미지 데이터의 밴드수입니다.
`protected int`	`width` 이 SampleModel가 기술하는 이미지 데이터의 영역의넓이 (단위는 픽셀)입니다.

생성자 개요
`SampleModel (int dataType, int w, int h, int numBands)` 지정된 파라미터를 사용해 SampleModel를 구축합니다.

메서드 개요
`abstract SampleModel`	`createCompatibleSampleModel (int w, int h)` 이 SampleModel 형식에서 데이터가 기술되고 있는 폭과 높이가 다른 SampleModel를 생성합니다.
`abstract DataBuffer`	`createDataBuffer ()` 이 SampleModel에 대응하는 DataBuffer를 생성합니다.
`abstract SampleModel`	`createSubsetSampleModel (int[] bands)` 이 SampleModel 밴드의 부분집합을 사용해 새로운 SampleModel를 생성합니다.
`Object`	`getDataElements (int x, int y, int w, int h, Object obj, DataBuffer data)` TransferType 형의 원시적 배열의, 지정된 픽셀 구형의 픽셀 데이터를 리턴합니다.
`abstract Object`	`getDataElements (int x, int y, Object obj, DataBuffer data)` transferType 형의 원시적 배열내의 1개의 픽셀의 데이터를 리턴합니다.
`int`	`getDataType ()` 픽셀 데이터가 포함되고 있는 DataBuffer 데이터형을 리턴합니다.
`int`	`getHeight ()` 높이를 픽셀수로 리턴합니다.
`int`	`getNumBands ()` 이미지 데이터의 밴드의 총수를 리턴합니다.
`abstract int`	`getNumDataElements ()` getDataElements 메서드와 setDataElements 메서드로 1개의 픽셀을 전송 하기 위해서 필요한 데이터 요소의 수를 리턴합니다.
`double[]`	`getPixel (int x, int y, double[] dArray, DataBuffer data)` double 배열내의 지정된 픽셀의 샘플을 리턴합니다.
`float[]`	`getPixel (int x, int y, float[] fArray, DataBuffer data)` float 배열내의 지정된 픽셀의 샘플을 리턴합니다.
`int[]`	`getPixel (int x, int y, int[] iArray, DataBuffer data)` int 배열내의 지정된 픽셀의 샘플을 리턴합니다.
`double[]`	`getPixels (int x, int y, int w, int h, double[] dArray, DataBuffer data)` double 배열의 픽셀 구형의 모든 샘플을 리턴합니다.
`float[]`	`getPixels (int x, int y, int w, int h, float[] fArray, DataBuffer data)` float 배열의 픽셀 구형의 모든 샘플을 리턴합니다.
`int[]`	`getPixels (int x, int y, int w, int h, int[] iArray, DataBuffer data)` int 배열의 픽셀 구형의 모든 샘플을 리턴합니다.
`abstract int`	`getSample (int x, int y, int b, DataBuffer data)` (x, y)에 위치하는 픽셀의 지정된 밴드내의 샘플을 int 로서 리턴합니다.
`double`	`getSampleDouble (int x, int y, int b, DataBuffer data)` (x, y)에 위치하는 픽셀의 지정된 밴드내의 샘플을 double 로서 리턴합니다.
`float`	`getSampleFloat (int x, int y, int b, DataBuffer data)` (x, y)에 위치하는 픽셀의 지정된 밴드내의 샘플을 float 로서 리턴합니다.
`double[]`	`getSamples (int x, int y, int w, int h, int b, double[] dArray, DataBuffer data)` double 배열내의 지정된 픽셀 구형의, 지정된 밴드의 샘플을 리턴합니다.
`float[]`	`getSamples (int x, int y, int w, int h, int b, float[] fArray, DataBuffer data)` float 배열내의 지정된 픽셀 구형의, 지정된 밴드의 샘플을 리턴합니다.
`int[]`	`getSamples (int x, int y, int w, int h, int b, int[] iArray, DataBuffer data)` int 배열의 지정된 픽셀의 구형의, 지정된 밴드의 샘플을 리턴합니다.
`abstract int[]`	`getSampleSize ()` 모든 밴드에 대해, 샘플의 사이즈를 비트 단위로 리턴합니다.
`abstract int`	`getSampleSize (int band)` 지정된 밴드의 샘플의 사이즈를 비트 단위로 리턴합니다.
`int`	`getTransferType ()` getDataElements 메서드와 setDataElements 메서드로 1개의 픽셀을 전송 하기 위해서 필요한 데이터 요소의 수를 리턴합니다.
`int`	`getWidth ()` 넓이를 픽셀수로 리턴합니다.
`void`	`setDataElements (int x, int y, int w, int h, Object obj, DataBuffer data)` TransferType 형의 원시적 배열로부터, 지정된 DataBuffer 내의 픽셀 구형의 데이터를 설정합니다.
`abstract void`	`setDataElements (int x, int y, Object obj, DataBuffer data)` TransferType 형의 원시적 배열로부터의, 지정된 DataBuffer 내의 1개의 픽셀의 데이터를 설정합니다.
`void`	`setPixel (int x, int y, double[] dArray, DataBuffer data)` 샘플의 double 배열을 입력으로서 DataBuffer 내의 픽셀을 설정합니다.
`void`	`setPixel (int x, int y, float[] fArray, DataBuffer data)` 샘플의 float 배열을 입력으로서 DataBuffer 내의 픽셀을 설정합니다.
`void`	`setPixel (int x, int y, int[] iArray, DataBuffer data)` 샘플의 int 배열을 입력으로서 DataBuffer 내의 픽셀을 설정합니다.
`void`	`setPixels (int x, int y, int w, int h, double[] dArray, DataBuffer data)` 배열 요소 마다 1개의 샘플이 포함되고 있는 double 배열로부터, 픽셀의 구형의 모든 샘플을 설정합니다.
`void`	`setPixels (int x, int y, int w, int h, float[] fArray, DataBuffer data)` 배열 요소 마다 1개의 샘플이 포함되고 있는 float 배열로부터, 픽셀의 구형의 모든 샘플을 설정합니다.
`void`	`setPixels (int x, int y, int w, int h, int[] iArray, DataBuffer data)` 배열 요소 마다 1개의 샘플이 포함되고 있는 int 배열로부터, 픽셀의 구형의 모든 샘플을 설정합니다.
`void`	`setSample (int x, int y, int b, double s, DataBuffer data)` double를 입력으로 해, DataBuffer 내의 것 (x, y)에 위치하는 픽셀의, 지정된 밴드내의 샘플을 설정합니다.
`void`	`setSample (int x, int y, int b, float s, DataBuffer data)` float를 입력으로 해, DataBuffer 내의 것 (x, y)에 위치하는 픽셀의, 지정된 밴드내의 샘플을 설정합니다.
`abstract void`	`setSample (int x, int y, int b, int s, DataBuffer data)` int를 입력으로 해, DataBuffer 내의 것 (x, y)에 위치하는 픽셀의, 지정한 밴드내의 샘플을 설정합니다.
`void`	`setSamples (int x, int y, int w, int h, int b, double[] dArray, DataBuffer data)` 배열 요소 마다 1개의 샘플이 포함되고 있는 double 배열로부터, 지정된 픽셀의 구형의 지정된 밴드내의 샘플을 설정합니다.
`void`	`setSamples (int x, int y, int w, int h, int b, float[] fArray, DataBuffer data)` 배열 요소 마다 1개의 샘플이 포함되고 있는 float 배열로부터, 지정된 픽셀의 구형의 지정된 밴드내의 샘플을 설정합니다.
`void`	`setSamples (int x, int y, int w, int h, int b, int[] iArray, DataBuffer data)` 배열 요소 마다 1개의 샘플이 포함되고 있는 int 배열로부터, 지정된 픽셀의 구형의 지정된 밴드내의 샘플을 설정합니다.

클래스 java.lang. Object 로부터 상속된 메서드
`clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait`

필드의 상세

width

protected int width

이 SampleModel가 기술하는 이미지 데이터의 영역의넓이 (단위는 픽셀)입니다.

height

protected int height

이 SampleModel가 기술하는 이미지 데이터의 영역의 높이 (단위는 픽셀)입니다.

numBands

protected int numBands

이 SampleModel가 기술하는 이미지 데이터의 밴드수입니다.

dataType

protected int dataType

픽셀 데이터를 포함하는 DataBuffer 데이터형 @see java.awt.image.DataBuffer

생성자 상세

SampleModel

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

지정된 파라미터를 사용해 SampleModel를 구축합니다.

파라미터:: dataType - 픽셀 데이터를 포함하는 DataBuffer 데이터형; w - 이미지 데이터의 영역의넓이 (단위는 픽셀); h - 이미지 데이터의 영역의 높이 (단위는 픽셀); numBands - 이미지 데이터의 밴드수
예외:: IllegalArgumentException - w 또는 h가 제로 아래의 경우; IllegalArgumentException - w와 h 적이 Integer.MAX_VALUE 보다 큰 경우; IllegalArgumentException - dataType가 지원되어 있지 않은 경우

메서드의 상세

getWidth

public final int getWidth()

넓이를 픽셀수로 리턴합니다. @return 이 SampleModel가 기술하는 이미지 데이터의 영역의넓이 (단위는 픽셀)

getHeight

public final int getHeight()

높이를 픽셀수로 리턴합니다. @return 이 SampleModel가 기술하는 이미지 데이터의 영역의 높이 (단위는 픽셀)

getNumBands

public final int getNumBands()

이미지 데이터의 밴드의 총수를 리턴합니다. @return 이 SampleModel가 기술하는 이미지 데이터의 밴드수

getNumDataElements

public abstract int getNumDataElements()

getDataElements 메서드와 setDataElements 메서드로 1개의 픽셀을 전송 하기 위해서 필요한 데이터 요소의 수를 리턴합니다. 이러한 메서드에서는 픽셀이 팩 된 형식에서 전송 되는 경우와 unpack 된 형식에서 전송 되는 경우가 있어, 이것은 SampleModel 구현에 의해 정해집니다. 이러한 메서드를 사용하면, 픽셀은 getTransferType()에 의해 지정되는 원시형의 getNumDataElements() 요소의 배열로서 전송 됩니다. TransferType는 DataBuffer 스토리지 데이터형과 같아도, 차이가 나도 괜찮습니다. @return 데이터 요소수 @see #getDataElements(int, int, Object, DataBuffer) @see #getDataElements(int, int, int, int, Object, DataBuffer) @see #setDataElements(int, int, Object, DataBuffer) @see #setDataElements(int, int, int, int, Object, DataBuffer) @see #getTransferType

getDataType

public final int getDataType()

픽셀 데이터가 포함되고 있는 DataBuffer 데이터형을 리턴합니다. @return 데이터형

getTransferType

public int getTransferType()

getDataElements 메서드와 setDataElements 메서드로 1개의 픽셀을 전송 하기 위해서 필요한 데이터 요소의 수를 리턴합니다. 이러한 메서드에서는 픽셀이 팩 된 형식에서 전송 되는 경우와 unpack 된 형식에서 전송 되는 경우가 있어, 이것은 SampleModel 구현에 의해 정해집니다. 이러한 메서드를 사용하면, 픽셀은 getTransferType()에 의해 지정되는 원시형의 getNumDataElements() 요소의 배열로서 전송 됩니다. TransferType는 스토리지 DataType와 같아도, 차이가 나도 괜찮습니다. TransferType는 DataBuffer 로 정의되고 있는 형태의 어떤 것인가가 됩니다. @return 데이터 요소수 @see #getDataElements(int, int, Object, DataBuffer) @see #getDataElements(int, int, int, int, Object, DataBuffer) @see #setDataElements(int, int, Object, DataBuffer) @see #setDataElements(int, int, int, int, Object, DataBuffer) @see #getNumDataElements @see java.awt.image.DataBuffer

getPixel

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

int 배열내의 지정된 픽셀의 샘플을 리턴합니다. 배열 요소 마다 1개의 샘플이 리턴됩니다 . 좌표가 경계내에 없는 경우는 ArrayIndexOutOfBoundsException가 발생 됩니다.

파라미터:: x, y - 픽셀 위치의 좌표; iArray - null이 아닌 경우, 이 배열내의 샘플을 돌려주는; data - 이미지 데이터를 포함하는 DataBuffer
반환값:: 지정된 픽셀의 샘플
예외:: NullPointerException - 데이터가 null인 경우; ArrayIndexOutOfBoundsException - 좌표가 경계내에 없는 경우, 또는 iArray가 너무 작아 출력을 보관 유지할 수 없는 경우
관련 항목:: setPixel(int, int, int[], DataBuffer)

getDataElements

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

transferType 형의 원시적 배열내의 1개의 픽셀의 데이터를 리턴합니다. Java 2D API에 의해 지원되고 있는 이미지 데이터의 경우는 DataBuffer.TYPE_BYTE, DataBuffer.TYPE_USHORT, DataBuffer.TYPE_INT, DataBuffer.TYPE_SHORT, DataBuffer.TYPE_FLOAT, 또는 DataBuffer.TYPE_DOUBLE 어떤 것인가가 됩니다. 데이터는 팩 된 형식에서 리턴된 일도 있어, 그 경우, 데이터 전송의 효율이 오릅니다. 일반적으로 객체가 적절한 원시적 데이터형으로 자동적으로 생성되도록, obj에는 null을 건네줍니다.

다음의 코드는 SampleModel sm1에 의해 스토리지 레이아웃이 기술되고 있는 DataBuffer db1로 부터, SampleModel sm2에 의해 스토리지 레이아웃이 기술되고 있는 DataBuffer db2에 1 픽셀의 데이터를 전송 하는 예입니다. 보통, 이 전송은 getPixel/setPixel를 사용하는 것보다도 효율적입니다.


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

SampleModel 밴드수가 같아, 대응하는 밴드의 샘플 근처의 비트수가 같아, TransferType가 같은 경우, 2개의 DataBuffer/SampleModel 간의 전송에는 getDataElements/setDataElements를 사용하는 것이 적절합니다.

obj가 null이 아닌 경우는 TransferType 형의 원시적 배열이 됩니다. 그렇지 않은 경우는 ClassCastException가 발생 됩니다. 좌표가 경계내에 없는 경우, 또는 obj가 null이 아니고, 픽셀 데이터를 포함하기 위해서 충분한 사이즈가 아닌 경우는 ArrayIndexOutOfBoundsException가 발생 됩니다.

파라미터:: x - 픽셀 위치의 X 좌표; y - 픽셀 위치의 Y 좌표; obj - null이 아닌 경우는 픽셀 데이터가 리턴된 원시적 배열; data - 이미지 데이터를 포함하는 DataBuffer
반환값:: 지정된 픽셀의 데이터 요소
예외:: NullPointerException - 데이터가 null인 경우; ArrayIndexOutOfBoundsException - 좌표가 경계내에 없는 경우, 또는 obj가 너무 작아 출력을 보관 유지할 수 없는 경우
관련 항목:: getNumDataElements(), getTransferType(), DataBuffer, setDataElements(int, int, Object, DataBuffer)

getDataElements

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

TransferType 형의 원시적 배열의, 지정된 픽셀 구형의 픽셀 데이터를 리턴합니다. Java 2D API에 의해 지원되고 있는 이미지 데이터의 경우는 DataBuffer.TYPE_BYTE, DataBuffer.TYPE_USHORT, DataBuffer.TYPE_INT, DataBuffer.TYPE_SHORT, DataBuffer.TYPE_FLOAT, 또는 DataBuffer.TYPE_DOUBLE 어떤 것인가가 됩니다. 데이터는 팩 된 형식에서 리턴된 일도 있어, 그 경우, 데이터 전송의 효율이 오릅니다. 일반적으로 객체가 올바른 원시적 데이터형으로 자동적으로 생성되도록, obj에는 null을 건네줍니다.

다음의 코드는 SampleModel sm1에 의해 스토리지 레이아웃이 기술되고 있는 DataBuffer db1로 부터, SampleModel sm2에 의해 스토리지 레이아웃이 기술되고 있는 DataBuffer db2에 픽셀의 구형 영역의 데이터를 전송 하는 예입니다. 보통, 이 전송은 getPixels/setPixels를 사용하는 것보다도 효율적입니다.


             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 - 데이터가 null인 경우; ArrayIndexOutOfBoundsException - 좌표가 경계내에 없는 경우, 또는 obj가 너무 작아 출력을 보관 유지할 수 없는 경우
관련 항목:: getNumDataElements(), getTransferType(), setDataElements(int, int, int, int, Object, DataBuffer), DataBuffer

setDataElements

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

TransferType 형의 원시적 배열로부터의, 지정된 DataBuffer 내의 1개의 픽셀의 데이터를 설정합니다. Java 2D API에 의해 지원되고 있는 이미지 데이터의 경우, DataBuffer.TYPE_BYTE, DataBuffer.TYPE_USHORT, DataBuffer.TYPE_INT, DataBuffer.TYPE_SHORT, DataBuffer.TYPE_FLOAT, 또는 DataBuffer.TYPE_DOUBLE 어떤 것인가가 됩니다. 배열내의 데이터는 팩 된 형식이 될 수도 있어, 그 경우, 데이터 전송의 효율이 오릅니다.


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

obj는 TransferType 형의 원시적 배열이 아니면 안됩니다. 그렇지 않은 경우는 ClassCastException가 발생 됩니다. 좌표가 경계내에 없는 경우, 또는 obj가 픽셀 데이터를 포함하기 위해서 충분한 사이즈가 아닌 경우는 ArrayIndexOutOfBoundsException가 발생 됩니다.

파라미터:: x - 픽셀 위치의 X 좌표; y - 픽셀 위치의 Y 좌표; obj - 픽셀 데이터를 포함하는 원시적 배열; data - 이미지 데이터를 포함하는 DataBuffer
예외:: NullPointerException - 데이터가 null인 경우; ArrayIndexOutOfBoundsException - 좌표가 경계내에 없는 경우, 또는 obj가 너무 작아 입력을 보관 유지할 수 없는 경우
관련 항목:: getNumDataElements(), getTransferType(), getDataElements(int, int, Object, DataBuffer), DataBuffer

setDataElements

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

TransferType 형의 원시적 배열로부터, 지정된 DataBuffer 내의 픽셀 구형의 데이터를 설정합니다. Java 2D API에 의해 지원되고 있는 이미지 데이터의 경우, DataBuffer.TYPE_BYTE, DataBuffer.TYPE_USHORT, DataBuffer.TYPE_INT, DataBuffer.TYPE_SHORT, DataBuffer.TYPE_FLOAT, 또는 DataBuffer.TYPE_DOUBLE 어떤 것인가가 됩니다. 배열내의 데이터는 팩 된 형식이 될 수도 있어, 그 경우, 데이터 전송의 효율이 오릅니다.


             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 - 데이터가 null인 경우; ArrayIndexOutOfBoundsException - 좌표가 경계내에 없는 경우, 또는 obj가 너무 작아 입력을 보관 유지할 수 없는 경우
관련 항목:: getNumDataElements(), getTransferType(), getDataElements(int, int, int, int, Object, DataBuffer), DataBuffer

getPixel

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

float 배열내의 지정된 픽셀의 샘플을 리턴합니다. 좌표가 경계내에 없는 경우는 ArrayIndexOutOfBoundsException가 발생 됩니다.

파라미터:: x - 픽셀 위치의 X 좌표; y - 픽셀 위치의 Y 좌표; fArray - null이 아닌 경우, 이 배열내의 샘플을 돌려주는; data - 이미지 데이터를 포함하는 DataBuffer
반환값:: 지정된 픽셀의 샘플
예외:: NullPointerException - 데이터가 null인 경우; ArrayIndexOutOfBoundsException - 좌표가 경계내에 없는 경우, 또는 fArray가 너무 작아 출력을 보관 유지할 수 없는 경우
관련 항목:: setPixel(int, int, float[], DataBuffer)

getPixel

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

double 배열내의 지정된 픽셀의 샘플을 리턴합니다. 좌표가 경계내에 없는 경우는 ArrayIndexOutOfBoundsException가 발생 됩니다.

파라미터:: x - 픽셀 위치의 X 좌표; y - 픽셀 위치의 Y 좌표; dArray - null이 아닌 경우, 이 배열내의 샘플을 돌려주는; data - 이미지 데이터를 포함하는 DataBuffer
반환값:: 지정된 픽셀의 샘플
예외:: NullPointerException - 데이터가 null인 경우; ArrayIndexOutOfBoundsException - 좌표가 경계내에 없는 경우, 또는 dArray가 너무 작아 출력을 보관 유지할 수 없는 경우
관련 항목:: setPixel(int, int, double[], DataBuffer)

getPixels

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

int 배열의 픽셀 구형의 모든 샘플을 리턴합니다. 배열 요소 마다 1개의 샘플이 리턴됩니다 . 좌표가 경계내에 없는 경우는 ArrayIndexOutOfBoundsException가 발생 됩니다.

파라미터:: x - 좌상의 픽셀 위치의 X 좌표; y - 좌상의 픽셀 위치의 Y 좌표; w - 픽셀 구형의 폭; h - 픽셀 구형의 높이; iArray - null이 아닌 경우, 이 배열내의 샘플을 돌려주는; data - 이미지 데이터를 포함하는 DataBuffer
반환값:: 지정된 픽셀 영역의 샘플
예외:: NullPointerException - 데이터가 null인 경우; ArrayIndexOutOfBoundsException - 좌표가 경계내에 없는 경우, 또는 iArray가 너무 작아 출력을 보관 유지할 수 없는 경우
관련 항목:: setPixels(int, int, int, int, int[], DataBuffer)

getPixels

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

float 배열의 픽셀 구형의 모든 샘플을 리턴합니다. 배열 요소 마다 1개의 샘플이 리턴됩니다 . 좌표가 경계내에 없는 경우는 ArrayIndexOutOfBoundsException가 발생 됩니다.

파라미터:: x - 좌상의 픽셀 위치의 X 좌표; y - 좌상의 픽셀 위치의 Y 좌표; w - 픽셀 구형의 폭; h - 픽셀 구형의 높이; fArray - null이 아닌 경우, 이 배열내의 샘플을 돌려주는; data - 이미지 데이터를 포함하는 DataBuffer
반환값:: 지정된 픽셀 영역의 샘플
예외:: NullPointerException - 데이터가 null인 경우; ArrayIndexOutOfBoundsException - 좌표가 경계내에 없는 경우, 또는 fArray가 너무 작아 출력을 보관 유지할 수 없는 경우
관련 항목:: setPixels(int, int, int, int, float[], DataBuffer)

getPixels

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

double 배열의 픽셀 구형의 모든 샘플을 리턴합니다. 배열 요소 마다 1개의 샘플이 리턴됩니다 . 좌표가 경계내에 없는 경우는 ArrayIndexOutOfBoundsException가 발생 됩니다.

파라미터:: x - 좌상의 픽셀 위치의 X 좌표; y - 좌상의 픽셀 위치의 Y 좌표; w - 픽셀 구형의 폭; h - 픽셀 구형의 높이; dArray - null이 아닌 경우, 이 배열내의 샘플을 돌려주는; data - 이미지 데이터를 포함하는 DataBuffer
반환값:: 지정된 픽셀 영역의 샘플
예외:: NullPointerException - 데이터가 null인 경우; ArrayIndexOutOfBoundsException - 좌표가 경계내에 없는 경우, 또는 dArray가 너무 작아 출력을 보관 유지할 수 없는 경우
관련 항목:: setPixels(int, int, int, int, double[], DataBuffer)

getSample

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

(x, y)에 위치하는 픽셀의 지정된 밴드내의 샘플을 int 로서 리턴합니다. 좌표가 경계내에 없는 경우는 ArrayIndexOutOfBoundsException가 발생 됩니다.

파라미터:: x - 픽셀 위치의 X 좌표; y - 픽셀 위치의 Y 좌표; b - 리턴된 밴드; data - 이미지 데이터를 포함하는 DataBuffer
반환값:: 지정된 픽셀에 대한 지정된 밴드의 샘플
예외:: NullPointerException - 데이터가 null인 경우; ArrayIndexOutOfBoundsException - 좌표 또는 밴드 인덱스가 경계내에 없는 경우
관련 항목:: setSample(int, int, int, int, DataBuffer)

getSampleFloat

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

(x, y)에 위치하는 픽셀의 지정된 밴드내의 샘플을 float 로서 리턴합니다. 좌표가 경계내에 없는 경우는 ArrayIndexOutOfBoundsException가 발생 됩니다.

파라미터:: x - 픽셀 위치의 X 좌표; y - 픽셀 위치의 Y 좌표; b - 리턴된 밴드; data - 이미지 데이터를 포함하는 DataBuffer
반환값:: 지정된 픽셀에 대한 지정된 밴드의 샘플
예외:: NullPointerException - 데이터가 null인 경우; ArrayIndexOutOfBoundsException - 좌표 또는 밴드 인덱스가 경계내에 없는 경우

getSampleDouble

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

(x, y)에 위치하는 픽셀의 지정된 밴드내의 샘플을 double 로서 리턴합니다. 좌표가 경계내에 없는 경우는 ArrayIndexOutOfBoundsException가 발생 됩니다.

파라미터:: x - 픽셀 위치의 X 좌표; y - 픽셀 위치의 Y 좌표; b - 리턴된 밴드; data - 이미지 데이터를 포함하는 DataBuffer
반환값:: 지정된 픽셀에 대한 지정된 밴드의 샘플
예외:: NullPointerException - 데이터가 null인 경우; ArrayIndexOutOfBoundsException - 좌표 또는 밴드 인덱스가 경계내에 없는 경우

getSamples

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

int 배열의 지정된 픽셀의 구형의, 지정된 밴드의 샘플을 리턴합니다. 배열 요소 마다 1개의 샘플이 리턴됩니다 . 좌표가 경계내에 없는 경우는 ArrayIndexOutOfBoundsException가 발생 됩니다.

파라미터:: x - 좌상의 픽셀 위치의 X 좌표; y - 좌상의 픽셀 위치의 Y 좌표; w - 픽셀 구형의 폭; h - 픽셀 구형의 높이; b - 리턴된 밴드; iArray - null이 아닌 경우, 이 배열내의 샘플을 돌려주는; data - 이미지 데이터를 포함하는 DataBuffer
반환값:: 지정된 픽셀 영역의 지정된 밴드의 샘플
예외:: NullPointerException - 데이터가 null인 경우; ArrayIndexOutOfBoundsException - 좌표 또는 밴드 인덱스가 경계내에 없는 경우, 또는 iArray가 너무 작아 출력을 보관 유지할 수 없는 경우
관련 항목:: setSamples(int, int, int, int, int, int[], DataBuffer)

getSamples

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

float 배열내의 지정된 픽셀 구형의, 지정된 밴드의 샘플을 리턴합니다. 배열 요소 마다 1개의 샘플이 리턴됩니다 . 좌표가 경계내에 없는 경우는 ArrayIndexOutOfBoundsException가 발생 됩니다.

파라미터:: x - 좌상의 픽셀 위치의 X 좌표; y - 좌상의 픽셀 위치의 Y 좌표; w - 픽셀 구형의 폭; h - 픽셀 구형의 높이; b - 리턴된 밴드; fArray - null이 아닌 경우, 이 배열내의 샘플을 돌려주는; data - 이미지 데이터를 포함하는 DataBuffer
반환값:: 지정된 픽셀 영역의 지정된 밴드의 샘플
예외:: NullPointerException - 데이터가 null인 경우; ArrayIndexOutOfBoundsException - 좌표 또는 밴드 인덱스가 경계내에 없는 경우, 또는 fArray가 너무 작아 출력을 보관 유지할 수 없는 경우
관련 항목:: setSamples(int, int, int, int, int, float[], DataBuffer)

getSamples

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

double 배열내의 지정된 픽셀 구형의, 지정된 밴드의 샘플을 리턴합니다. 배열 요소 마다 1개의 샘플이 리턴됩니다 . 좌표가 경계내에 없는 경우는 ArrayIndexOutOfBoundsException가 발생 됩니다.

파라미터:: x - 좌상의 픽셀 위치의 X 좌표; y - 좌상의 픽셀 위치의 Y 좌표; w - 픽셀 구형의 폭; h - 픽셀 구형의 높이; b - 리턴된 밴드; dArray - null이 아닌 경우, 이 배열내의 샘플을 돌려주는; data - 이미지 데이터를 포함하는 DataBuffer
반환값:: 지정된 픽셀 영역의 지정된 밴드의 샘플
예외:: NullPointerException - 데이터가 null인 경우; ArrayIndexOutOfBoundsException - 좌표 또는 밴드 인덱스가 경계내에 없는 경우, 또는 dArray가 너무 작아 출력을 보관 유지할 수 없는 경우
관련 항목:: setSamples(int, int, int, int, int, double[], DataBuffer)

setPixel

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

샘플의 int 배열을 입력으로서 DataBuffer 내의 픽셀을 설정합니다. 좌표가 경계내에 없는 경우는 ArrayIndexOutOfBoundsException가 발생 됩니다.

파라미터:: x - 픽셀 위치의 X 좌표; y - 픽셀 위치의 Y 좌표; iArray - int 배열 형식의 입력 샘플; data - 이미지 데이터를 포함하는 DataBuffer
예외:: NullPointerException - iArray 또는 데이터가 null인 경우; ArrayIndexOutOfBoundsException - 좌표가 경계내에 없는 경우, 또는 iArray가 너무 작아 입력을 보관 유지할 수 없는 경우
관련 항목:: getPixel(int, int, int[], DataBuffer)

setPixel

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

샘플의 float 배열을 입력으로서 DataBuffer 내의 픽셀을 설정합니다. 좌표가 경계내에 없는 경우는 ArrayIndexOutOfBoundsException가 발생 됩니다.

파라미터:: x - 픽셀 위치의 X 좌표; y - 픽셀 위치의 Y 좌표; fArray - float 배열의 입력 샘플; data - 이미지 데이터를 포함하는 DataBuffer
예외:: NullPointerException - fArray 또는 데이터가 null인 경우; ArrayIndexOutOfBoundsException - 좌표가 경계내에 없는 경우, 또는 fArray가 너무 작아 입력을 보관 유지할 수 없는 경우
관련 항목:: getPixel(int, int, float[], DataBuffer)

setPixel

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

샘플의 double 배열을 입력으로서 DataBuffer 내의 픽셀을 설정합니다.

파라미터:: x - 픽셀 위치의 X 좌표; y - 픽셀 위치의 Y 좌표; dArray - double 배열의 입력 샘플; data - 이미지 데이터를 포함하는 DataBuffer
예외:: NullPointerException - dArray 또는 데이터가 null인 경우; ArrayIndexOutOfBoundsException - 좌표가 경계내에 없는 경우, 또는 fArray가 너무 작아 입력을 보관 유지할 수 없는 경우
관련 항목:: getPixel(int, int, double[], DataBuffer)

setPixels

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

배열 요소 마다 1개의 샘플이 포함되고 있는 int 배열로부터, 픽셀의 구형의 모든 샘플을 설정합니다. 좌표가 경계내에 없는 경우는 ArrayIndexOutOfBoundsException가 발생 됩니다.

파라미터:: x - 좌상의 픽셀 위치의 X 좌표; y - 좌상의 픽셀 위치의 Y 좌표; w - 픽셀 구형의 폭; h - 픽셀 구형의 높이; iArray - int 배열 형식의 입력 샘플; data - 이미지 데이터를 포함하는 DataBuffer
예외:: NullPointerException - iArray 또는 데이터가 null인 경우; ArrayIndexOutOfBoundsException - 좌표가 경계내에 없는 경우, 또는 iArray가 너무 작아 입력을 보관 유지할 수 없는 경우
관련 항목:: getPixels(int, int, int, int, int[], DataBuffer)

setPixels

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

배열 요소 마다 1개의 샘플이 포함되고 있는 float 배열로부터, 픽셀의 구형의 모든 샘플을 설정합니다. 좌표가 경계내에 없는 경우는 ArrayIndexOutOfBoundsException가 발생 됩니다.

파라미터:: x - 좌상의 픽셀 위치의 X 좌표; y - 좌상의 픽셀 위치의 Y 좌표; w - 픽셀 구형의 폭; h - 픽셀 구형의 높이; fArray - float 배열의 입력 샘플; data - 이미지 데이터를 포함하는 DataBuffer
예외:: NullPointerException - fArray 또는 데이터가 null인 경우; ArrayIndexOutOfBoundsException - 좌표가 경계내에 없는 경우, 또는 fArray가 너무 작아 입력을 보관 유지할 수 없는 경우
관련 항목:: getPixels(int, int, int, int, float[], DataBuffer)

setPixels

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

배열 요소 마다 1개의 샘플이 포함되고 있는 double 배열로부터, 픽셀의 구형의 모든 샘플을 설정합니다. 좌표가 경계내에 없는 경우는 ArrayIndexOutOfBoundsException가 발생 됩니다.

파라미터:: x - 좌상의 픽셀 위치의 X 좌표; y - 좌상의 픽셀 위치의 Y 좌표; w - 픽셀 구형의 폭; h - 픽셀 구형의 높이; dArray - double 배열의 입력 샘플; data - 이미지 데이터를 포함하는 DataBuffer
예외:: NullPointerException - dArray 또는 데이터가 null인 경우; ArrayIndexOutOfBoundsException - 좌표가 경계내에 없는 경우, 또는 dArray가 너무 작아 입력을 보관 유지할 수 없는 경우
관련 항목:: getPixels(int, int, int, int, double[], DataBuffer)

setSample

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

int를 입력으로 해, DataBuffer 내의 것 (x, y)에 위치하는 픽셀의, 지정한 밴드내의 샘플을 설정합니다. 좌표가 경계내에 없는 경우는 ArrayIndexOutOfBoundsException가 발생 됩니다.

파라미터:: x - 픽셀 위치의 X 좌표; y - 픽셀 위치의 Y 좌표; b - 설정되는 밴드; s - int 입력 샘플; data - 이미지 데이터를 포함하는 DataBuffer
예외:: NullPointerException - 데이터가 null인 경우; ArrayIndexOutOfBoundsException - 좌표 또는 밴드 인덱스가 경계내에 없는 경우
관련 항목:: getSample(int, int, int, DataBuffer)

setSample

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

float를 입력으로 해, DataBuffer 내의 것 (x, y)에 위치하는 픽셀의, 지정된 밴드내의 샘플을 설정합니다. 좌표가 경계내에 없는 경우는 ArrayIndexOutOfBoundsException가 발생 됩니다.

파라미터:: x - 픽셀 위치의 X 좌표; y - 픽셀 위치의 Y 좌표; b - 설정되는 밴드; s - float 입력 샘플; data - 이미지 데이터를 포함하는 DataBuffer
예외:: NullPointerException - 데이터가 null인 경우; ArrayIndexOutOfBoundsException - 좌표 또는 밴드 인덱스가 경계내에 없는 경우
관련 항목:: getSample(int, int, int, DataBuffer)

setSample

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

double를 입력으로 해, DataBuffer 내의 것 (x, y)에 위치하는 픽셀의, 지정된 밴드내의 샘플을 설정합니다. 좌표가 경계내에 없는 경우는 ArrayIndexOutOfBoundsException가 발생 됩니다.

파라미터:: x - 픽셀 위치의 X 좌표; y - 픽셀 위치의 Y 좌표; b - 설정되는 밴드; s - double 입력 샘플; data - 이미지 데이터를 포함하는 DataBuffer
예외:: NullPointerException - 데이터가 null인 경우; ArrayIndexOutOfBoundsException - 좌표 또는 밴드 인덱스가 경계내에 없는 경우
관련 항목:: getSample(int, int, int, DataBuffer)

setSamples

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

배열 요소 마다 1개의 샘플이 포함되고 있는 int 배열로부터, 지정된 픽셀의 구형의 지정된 밴드내의 샘플을 설정합니다. 좌표가 경계내에 없는 경우는 ArrayIndexOutOfBoundsException가 발생 됩니다.

파라미터:: x - 좌상의 픽셀 위치의 X 좌표; y - 좌상의 픽셀 위치의 Y 좌표; w - 픽셀 구형의 폭; h - 픽셀 구형의 높이; b - 설정되는 밴드; iArray - int 배열 형식의 입력 샘플; data - 이미지 데이터를 포함하는 DataBuffer
예외:: NullPointerException - iArray 또는 데이터가 null인 경우; ArrayIndexOutOfBoundsException - 좌표 또는 밴드 인덱스가 경계내에 없는 경우, 또는 iArray가 너무 작아 입력을 보관 유지할 수 없는 경우
관련 항목:: getSamples(int, int, int, int, int, int[], DataBuffer)

setSamples

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

배열 요소 마다 1개의 샘플이 포함되고 있는 float 배열로부터, 지정된 픽셀의 구형의 지정된 밴드내의 샘플을 설정합니다. 좌표가 경계내에 없는 경우는 ArrayIndexOutOfBoundsException가 발생 됩니다.

파라미터:: x - 좌상의 픽셀 위치의 X 좌표; y - 좌상의 픽셀 위치의 Y 좌표; w - 픽셀 구형의 폭; h - 픽셀 구형의 높이; b - 설정되는 밴드; fArray - float 배열의 입력 샘플; data - 이미지 데이터를 포함하는 DataBuffer
예외:: NullPointerException - fArray 또는 데이터가 null인 경우; ArrayIndexOutOfBoundsException - 좌표 또는 밴드 인덱스가 경계내에 없는 경우, 또는 fArray가 너무 작아 입력을 보관 유지할 수 없는 경우
관련 항목:: getSamples(int, int, int, int, int, float[], DataBuffer)

setSamples

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

배열 요소 마다 1개의 샘플이 포함되고 있는 double 배열로부터, 지정된 픽셀의 구형의 지정된 밴드내의 샘플을 설정합니다. 좌표가 경계내에 없는 경우는 ArrayIndexOutOfBoundsException가 발생 됩니다.

파라미터:: x - 좌상의 픽셀 위치의 X 좌표; y - 좌상의 픽셀 위치의 Y 좌표; w - 픽셀 구형의 폭; h - 픽셀 구형의 높이; b - 설정되는 밴드; dArray - double 배열의 입력 샘플; data - 이미지 데이터를 포함하는 DataBuffer
예외:: NullPointerException - dArray 또는 데이터가 null인 경우; ArrayIndexOutOfBoundsException - 좌표 또는 밴드 인덱스가 경계내에 없는 경우, 또는 dArray가 너무 작아 입력을 보관 유지할 수 없는 경우
관련 항목:: getSamples(int, int, int, int, int, double[], DataBuffer)

createCompatibleSampleModel

public abstract SampleModel  createCompatibleSampleModel(int w,
                                                        int h)

이 SampleModel 형식에서 데이터가 기술되고 있는 폭과 높이가 다른 SampleModel를 생성합니다. @param w 이미지 데이터의넓이 @param h 이미지 데이터의 높이 @return 이 SampleModel 과 같은 이미지 데이터를 기술하지만, 사이즈가 다른 SampleModel

createSubsetSampleModel

public abstract SampleModel  createSubsetSampleModel(int[] bands)

이 SampleModel 밴드의 부분집합을 사용해 새로운 SampleModel를 생성합니다.

파라미터:: bands - 이 SampleModel 밴드의 부분집합
반환값:: 이 SampleModel 밴드의 부분집합을 가지는 SampleModel

createDataBuffer

public abstract DataBuffer  createDataBuffer()

이 SampleModel에 대응하는 DataBuffer를 생성합니다. DataBuffer 폭과 높이는 이 SampleModel 폭과 높이로 일치합니다.

반환값:: 이 SampleModel에 대응하는 DataBuffer

getSampleSize

public abstract int[] getSampleSize()

모든 밴드에 대해, 샘플의 사이즈를 비트 단위로 리턴합니다. @return 모든 밴드에 대한 샘플의 사이즈

getSampleSize

public abstract int getSampleSize(int band)

지정된 밴드의 샘플의 사이즈를 비트 단위로 리턴합니다. @param 지정된 밴드 @return 지정된 밴드의 샘플의 사이즈

개요

패키지

클래스

사용

계층 트리

비추천 API

색인

헬프

Java^TM 2 Platform
Standard Ed. 5.0

이전 클래스 다음 클래스

프레임으로 프레임 없이

개요: NESTED | 필드 | constructor | 메서드

상세: 필드 | 생성자 | 메서드

java.awt.image 클래스 SampleModel

width

height

numBands

dataType

SampleModel

getWidth

getHeight

getNumBands

getNumDataElements

getDataType

getTransferType

getPixel

getDataElements

getDataElements

setDataElements

setDataElements

getPixel

getPixel

getPixels

getPixels

getPixels

getSample

getSampleFloat

getSampleDouble

getSamples

getSamples

getSamples

setPixel

setPixel

setPixel

setPixels

setPixels

setPixels

setSample

setSample

setSample

setSamples

setSamples

setSamples

createCompatibleSampleModel

createSubsetSampleModel

createDataBuffer

getSampleSize

getSampleSize

java.awt.image
클래스 SampleModel