JavaTM Platform
Standard Ed. 6

java.awt.image
클래스 Raster

java.lang.Object 
  상위를 확장 java.awt.image.Raster
직계의 기존의 서브 클래스:
WritableRaster


public class Raster
extends Object

픽셀로 구성되는 구형 배열을 표현하는 클래스입니다. Raster 는, 샘플치가 포함되고 있는 DataBuffer 와 지정된 샘플치를 DataBuffer 로부터 검출할 방법이 기술되고 있는 SampleModel 를 캡슐화합니다.  

Raster 는, 평면상의 특정의 구형 영역 (반드시 (0, 0)를 포함하지 않아도 좋다)를 차지하는 픽셀의 값을 정의합니다. 이 구형은, Raster 의 경계의 구형으로 불려 getBounds 메소드에 의해 취득되어 minX, minY, width, height 의 값에 의해 정의됩니다. minX 와 minY 의 값은, Raster 의 좌상구석의 좌표를 정의합니다. 경계의 구형외의 픽셀을 참조하면(자), 예외가 throw 되거나 Raster 의 관련 DataBuffer 의 의도하지 않는 요소가 참조되게 됩니다. Raster 를 사용할 때는, 이러한 범위외의 액세스는 실시하지 않게 해 주세요.  

SampleModel 는, Raster 의 샘플이 DataBuffer 의 프리미티브(primitive) 배열 요소에 포함되는 방법을 기술합니다. 샘플은, PixelInterleavedSampleModel 이나 BandedSampleModel 와 같이 데이터 요소 마다 1 개(살)씩 포함하는 일도, SinglePixelPackedSampleModel 나 MultiPixelPackedSampleModel 와 같이 복수의 요소를 1 개로 정리해 포함할 수도 있습니다. SampleModel 는, 샘플이 부호 첨부 확장 형식인가 어떤가도 제어합니다. 이것에 의해, 부호 없음 데이터를 byte, short, int 등의, Java 의 부호 첨부 데이터형으로서 포함할 수 있습니다.  

Raster 는 평면상의 어디에라도 존재할 수 있습니다만, SampleModel 는 (0, 0)으로부터 시작되는 간이 좌표 체계를 이용합니다. 이 때문에, Raster 는, Raster 의 좌표 체계와 SampleModel 의 좌표 체계의 사이에 픽셀 위치를 매핑 할 수 있도록(듯이) 하는 변환계수를 가지고 있습니다. SampleModel 의 좌표 체계로부터 Raster 의 좌표 체계에의 변환은, getSampleModelTranslateX 메소드와 getSampleModelTranslateY 메소드로 취득할 수 있습니다.  

Raster 는 다른 Raster 와 DataBuffer 를 공유할 수 있습니다만, 이 때문에는, 이러한 Raster 를 명시적으로 구축하는지, createChild 메소드와 createTranslatedChild 메소드를 사용합니다. 이러한 메소드에 의해 구축된 Raster 에 대해서 getParent 메소드를 사용하면(자), 구축원의 Raster 에의 참조를 취득할 수 있습니다. createTranslatedChild 나 createChild 의 호출에 의해 구축된 Raster 가 아닌 경우, getParent 는 null 를 돌려줍니다.  

createTranslatedChild 메소드는, 현재의 Raster 의 모든 데이터를 공유하는 새로운 Raster 를 돌려줍니다. 새로운 Raster 는, 현재의 Raster 와 같은 폭과 높이의 경계의 구형을 차지합니다만, 개시점이 다릅니다. 예를 들어, 부모의 Raster 가 (10, 10)로부터 (100, 100)까지의 영역을 차지하는 경우, 변환 후의 Raster 의 영역의 시점을 (50, 50)에 정의하면(자), 부모의 픽셀 (20, 20)과 아이의 픽셀 (60, 60)은 이것들 2 개의 Raster 로 공유되는 DataBuffer 로 같은 위치를 차지합니다. 대응하는 SampleModel 좌표를 취득하는 경우, 부모의 Raster 에서는 픽셀 좌표에 (-10, -10)가 가산되는데 대해, 변환 후의 Raster 에서는 (-50, -50)이 가산됩니다.  

부모의 sampleModelTranslateX 와 sampleModelTranslateY 의 값으로부터, 아이의 sampleModelTranslateX 와 sampleModelTranslateY 의 값을 감산하는 것으로, Raster 의 부모와 자식 사이의 변환이 가능합니다.  

createChild 메소드를 사용하면(자), 부모의 경계의 구형의 부분집합만을 차지해 같은 좌표 체계 또는 변환 후의 좌표 체계를 가지는 새로운 Raster 나, 부모의 밴드의 부분집합을 가지는 새로운 Raster 를 생성할 수 있습니다.  

생성자 은 모두 보호되고 있습니다. Raster 를 생성하는 올바른 방법은, 이 클래스에서 정의되고 있는 정적인 create 메소드의 1 개를 사용하는 것입니다. 이러한 메소드를 사용하면(자), 표준의 인타리브화 된 SampleModel, 밴드화 된 SmpleModel, 및 팩 된 SampleModel 를 사용하는 Raster 의 인스턴스가 생성되어 외부에서 생성된 SampleModel 와 DataBuffer 를 결합해 생성되는 경우와 비교해 효율적으로 처리할 수 있습니다.

관련 항목:
DataBuffer , SampleModel , PixelInterleavedSampleModel , BandedSampleModel , SinglePixelPackedSampleModel , MultiPixelPackedSampleModel

필드의 개요
protected  DataBuffer dataBuffer
          이미지 데이터를 포함하는 DataBuffer 입니다.
protected  int height
          이 Raster 의 높이입니다.
protected  int minX
          이 Raster 의 좌상구석의 픽셀의 X 좌표입니다.
protected  int minY
          이 Raster 의 좌상구석의 픽셀의 Y 좌표입니다.
protected  int numBands
          Raster 내의 밴드수입니다.
protected  int numDataElements
          1 픽셀 근처의 DataBuffer 데이터 요소의 수입니다.
protected  Raster parent
          이 Raster 의 부모, 또는 null 입니다.
protected  SampleModel sampleModel
          이 Raster 의 픽셀이 DataBuffer 에 포함되는 방법을 기술하는 SampleModel 입니다.
protected  int sampleModelTranslateX
          Raster 의 SampleModel 의 좌표 공간으로부터 Raster 의 좌표 공간에의 X 변환입니다.
protected  int sampleModelTranslateY
          Raster 의 SampleModel 의 좌표 공간으로부터 Raster 의 좌표 공간에의 Y 변환입니다.
protected  int width
          이 Raster 의 폭입니다.
 
생성자 의 개요
protected Raster (SampleModel  sampleModel, DataBuffer  dataBuffer, Point  origin)
          지정된 SampleModel 및 DataBuffer 를 가지는 Raster 를 구축합니다.
protected Raster (SampleModel  sampleModel, DataBuffer  dataBuffer, Rectangle  aRegion, Point  sampleModelTranslate, Raster  parent)
          지정된 SampleModel, DataBuffer, 및 부모를 사용해 Raster 를 구축합니다.
protected Raster (SampleModel  sampleModel, Point  origin)
          지정된 SampleModel 를 가지는 Raster 를 구축합니다.
 
메소드의 개요
static WritableRaster createBandedRaster (DataBuffer  dataBuffer, int w, int h, int scanlineStride, int[] bankIndices, int[] bandOffsets, Point  location)
          지정된 DataBuffer, 폭, 높이, 주사선 보폭, 뱅크 인덱스, 및 뱅크 오프셋(offset)을 가지는, BandedSampleModel 에 근거한 Raster 를 생성합니다.
static WritableRaster createBandedRaster (int dataType, int w, int h, int scanlineStride, int[] bankIndices, int[] bandOffsets, Point  location)
          지정된 데이터형, 폭, 높이, 주사선 보폭, 뱅크 인덱스, 밴드 오프셋(offset)을 가지는, BandedSampleModel 에 근거한 Raster 를 생성합니다.
static WritableRaster createBandedRaster (int dataType, int w, int h, int bands, Point  location)
          지정된 데이터형, 폭, 높이, 밴드수를 가지는, BandedSampleModel 에 근거한 Raster 를 생성합니다.
 Raster createChild (int parentX, int parentY, int width, int height, int childMinX, int childMinY, int[] bandList)
          이 Raster 의 DataBuffer 의 모두 또는 일부를 공유하는 새로운 Raster 를 돌려줍니다.
 WritableRaster createCompatibleWritableRaster ()
          이 Raster 와 같은 SampleModel 와 초기화된 새로운 DataBuffer 를 가져, 이 Raster 와 같은 사이즈로 호환성이 있는 WritableRaster 를 생성합니다.
 WritableRaster createCompatibleWritableRaster (int w, int h)
          지정된 사이즈, 새로운 SampleModel, 및 초기화된 새로운 DataBuffer 를 가져, 호환성이 있는 WritableRaster 를 생성합니다.
 WritableRaster createCompatibleWritableRaster (int x, int y, int w, int h)
          지정된 위치 (minX, minY)와 사이즈 (width, height), 새로운 SampleModel, 및 초기화된 새로운 DataBuffer 를 가져, 호환성이 있는 WritableRaster 를 생성합니다.
 WritableRaster createCompatibleWritableRaster (Rectangle  rect)
          rect 에 의해 지정되는 위치 (minX, minY)와 사이즈 (width, height), 새로운 SampleModel, 및 초기화된 새로운 DataBuffer 를 가져, 호환성이 있는 WritableRaster 를 생성합니다.
static WritableRaster createInterleavedRaster (DataBuffer  dataBuffer, int w, int h, int scanlineStride, int pixelStride, int[] bandOffsets, Point  location)
          지정된 DataBuffer, 폭, 높이, 주사선 보폭, 픽셀 보폭, 및 밴드 오프셋(offset)를 가지는, PixelInterleavedSampleModel 에 근거한 Raster 를 생성합니다.
static WritableRaster createInterleavedRaster (int dataType, int w, int h, int scanlineStride, int pixelStride, int[] bandOffsets, Point  location)
          지정된 데이터형, 폭, 높이, 주사선 보폭, 픽셀 보폭, 및 밴드 오프셋(offset)를 가지는, PixelInterleavedSampleModel 에 근거한 Raster 를 생성합니다.
static WritableRaster createInterleavedRaster (int dataType, int w, int h, int bands, Point  location)
          지정된 데이터형, 폭, 높이, 및 밴드수를 가지는, PixelInterleavedSampleModel 에 근거한 Raster 를 생성합니다.
static WritableRaster createPackedRaster (DataBuffer  dataBuffer, int w, int h, int scanlineStride, int[] bandMasks, Point  location)
          지정된 DataBuffer, 폭, 높이, 주사선 보폭, 및 밴드 마스크를 가지는, SinglePixelPackedSampleModel 에 근거한 Raster 를 생성합니다.
static WritableRaster createPackedRaster (DataBuffer  dataBuffer, int w, int h, int bitsPerPixel, Point  location)
          지정된 DataBuffer, 폭, 높이, 및 1 픽셀 근처의 비트수를 가지는, MultiPixelPackedSampleModel 에 근거한 Raster 를 생성합니다.
static WritableRaster createPackedRaster (int dataType, int w, int h, int[] bandMasks, Point  location)
          지정된 데이터형, 폭, 높이, 및 밴드 마스크를 가지는, SinglePixelPackedSampleModel 에 근거한 Raster 를 생성합니다.
static WritableRaster createPackedRaster (int dataType, int w, int h, int bands, int bitsPerBand, Point  location)
          지정된 데이터형, 폭, 높이, 밴드수, 및 1 밴드 근처의 비트수를 가지는, 팩 된 SampleModel 에 근거한 Raster 를 생성합니다.
static Raster createRaster (SampleModel  sm, DataBuffer  db, Point  location)
          지정된 SampleModel 와 DataBuffer 을 가지는 Raster 를 생성합니다.
 Raster createTranslatedChild (int childMinX, int childMinY)
          이 Raster 와 같은 사이즈, SampleModel, 및 DataBuffer 를 가져, 위치가 다른 Raster 를 생성합니다.
static WritableRaster createWritableRaster (SampleModel  sm, DataBuffer  db, Point  location)
          지정된 SampleModel 와 DataBuffer 를 가지는 WritableRaster 를 생성합니다.
static WritableRaster createWritableRaster (SampleModel  sm, Point  location)
          지정된 SampleModel 를 가지는 WritableRaster 를 생성합니다.
 Rectangle getBounds ()
          이 Raster 의 경계의 Rectangle 를 돌려줍니다.
 DataBuffer getDataBuffer ()
          이 Raster 에 관련한 DataBuffer 를 돌려줍니다.
 Object getDataElements (int x, int y, int w, int h, Object  outData)
          TransferType 형의 프리미티브(primitive) 배열의, 지정된 픽셀 구형의 픽셀 데이터를 돌려줍니다.
 Object getDataElements (int x, int y, Object  outData)
          transferType 형의 프리미티브(primitive) 배열내의 1 개의 픽셀의 데이터를 돌려줍니다.
 int getHeight ()
          Raster 의 높이를 픽셀 단위로 돌려줍니다.
 int getMinX ()
          Raster 의 유효한 최소의 X 좌표를 돌려줍니다.
 int getMinY ()
          Raster 의 유효한 최소의 Y 좌표를 돌려줍니다.
 int getNumBands ()
          이 Raster 내의 밴드수 (1 픽셀 근처의 샘플수)를 돌려줍니다.
 int getNumDataElements ()
          getDataElements 메소드 및 setDataElements 메소드를 사용해 1 픽셀 전송 하는데 필요한 데이터 요소의 수를 돌려줍니다.
 Raster getParent ()
          이 Raster 의 친 Raster 가 있으면 그것을 돌려줍니다.
 double[] getPixel (int x, int y, double[] dArray)
          지정된 픽셀의 샘플을 double 배열로서 돌려줍니다.
 float[] getPixel (int x, int y, float[] fArray)
          지정된 픽셀의 샘플을 float 배열로서 돌려줍니다.
 int[] getPixel (int x, int y, int[] iArray)
          지정된 픽셀의 샘플을 int 배열로서 돌려줍니다.
 double[] getPixels (int x, int y, int w, int h, double[] dArray)
          구형의 픽셀의 샘플 모든 것을, 배열 요소 마다 1 개의 샘플이 포함되고 있는 double 배열로서 돌려줍니다.
 float[] getPixels (int x, int y, int w, int h, float[] fArray)
          구형의 픽셀의 샘플 모든 것을, 배열 요소 마다 1 개의 샘플이 포함되고 있는 float 배열로서 돌려줍니다.
 int[] getPixels (int x, int y, int w, int h, int[] iArray)
          구형의 픽셀의 샘플 모든 것을, 배열 요소 마다 1 개의 샘플이 포함되고 있는 int 배열로서 돌려줍니다.
 int getSample (int x, int y, int b)
          (x, y)에 위치하는 픽셀의 지정된 밴드내의 샘플을 int 로서 돌려줍니다.
 double getSampleDouble (int x, int y, int b)
          (x, y)에 위치하는 픽셀의 지정된 밴드내의 샘플을 double 로서 돌려줍니다.
 float getSampleFloat (int x, int y, int b)
          (x, y)에 위치하는 픽셀의 지정된 밴드내의 샘플을 float 로서 돌려줍니다.
 SampleModel getSampleModel ()
          이미지 데이터의 레이아웃을 기술하는 SampleModel 를 돌려줍니다.
 int getSampleModelTranslateX ()
          SampleModel 의 좌표 체계로부터 Raster 의 좌표 체계에의 X 변환을 돌려줍니다.
 int getSampleModelTranslateY ()
          SampleModel 의 좌표 체계로부터 Raster 의 좌표 체계에의 Y 변환을 돌려줍니다.
 double[] getSamples (int x, int y, int w, int h, int b, double[] dArray)
          double 배열내의 지정된 픽셀 구형의, 지정된 밴드의 샘플을 돌려줍니다.
 float[] getSamples (int x, int y, int w, int h, int b, float[] fArray)
          float 배열내의 지정된 픽셀 구형의, 지정된 밴드의 샘플을 돌려줍니다.
 int[] getSamples (int x, int y, int w, int h, int b, int[] iArray)
          int 배열의 지정된 픽셀의 구형의, 지정된 밴드의 샘플을 돌려줍니다.
 int getTransferType ()
          getDataElements 메소드와 setDataElements 메소드로, 1 개의 픽셀을 전송 하기 위해서 필요한 데이터 요소의 수를 돌려줍니다.
 int getWidth ()
          Raster 의 폭을 픽셀 단위로 돌려줍니다.
 
클래스 java.lang. Object 로부터 상속된 메소드
clone , equals , finalize , getClass , hashCode , notify , notifyAll , toString , wait , wait , wait
 

필드의 상세

sampleModel

protected SampleModel  sampleModel
이 Raster 의 픽셀이 DataBuffer 에 포함되는 방법을 기술하는 SampleModel 입니다.


dataBuffer

protected DataBuffer  dataBuffer
이미지 데이터를 포함하는 DataBuffer 입니다.


minX

protected int minX
이 Raster 의 좌상구석의 픽셀의 X 좌표입니다.


minY

protected int minY
이 Raster 의 좌상구석의 픽셀의 Y 좌표입니다.


width

protected int width
이 Raster 의 폭입니다.


height

protected int height
이 Raster 의 높이입니다.


sampleModelTranslateX

protected int sampleModelTranslateX
Raster 의 SampleModel 의 좌표 공간으로부터 Raster 의 좌표 공간에의 X 변환입니다.


sampleModelTranslateY

protected int sampleModelTranslateY
Raster 의 SampleModel 의 좌표 공간으로부터 Raster 의 좌표 공간에의 Y 변환입니다.


numBands

protected int numBands
Raster 내의 밴드수입니다.


numDataElements

protected int numDataElements
1 픽셀 근처의 DataBuffer 데이터 요소의 수입니다.


parent

protected Raster  parent
이 Raster 의 부모, 또는 null 입니다.

생성자 의 상세

Raster

protected Raster(SampleModel  sampleModel,
                 Point  origin)
지정된 SampleModel 를 가지는 Raster 를 구축합니다. Raster 는 좌상구석이 원점에서, 사이즈는 SampleModel 와 같습니다. Raster 를 기술하기 위해서 충분한 크기의 DataBuffer 가 자동적으로 생성됩니다.

파라미터:
sampleModel - 레이아웃을 지정하는 SampleModel
origin - 원점을 지정한 Point
예외:
RasterFormatException - origin.x + sampleModel.getWidth() 또는 origin.y + sampleModel.getHeight() 의 계산으로, 정수형 오버플로우가 발생했다 경우
NullPointerException - sampleModel 또는 origin 가 null 의 경우

Raster

protected Raster(SampleModel  sampleModel,
                 DataBuffer  dataBuffer,
                 Point  origin)
지정된 SampleModel 및 DataBuffer 를 가지는 Raster 를 구축합니다. Raster 는 좌상구석이 원점에서, 사이즈는 SampleModel 와 같습니다. DataBuffer 는 초기화되지 않고, SampleModel 에 준거하고 있을 필요가 있습니다.

파라미터:
sampleModel - 레이아웃을 지정하는 SampleModel
dataBuffer - 이미지 데이터를 포함하는 DataBuffer
origin - 원점을 지정하는 Point
예외:
RasterFormatException - origin.x + sampleModel.getWidth() 또는 origin.y + sampleModel.getHeight() 의 계산으로, 정수형 오버플로우가 발생했다 경우
NullPointerException - sampleModel 또는 origin 가 null 의 경우

Raster

protected Raster(SampleModel  sampleModel,
                 DataBuffer  dataBuffer,
                 Rectangle  aRegion,
                 Point  sampleModelTranslate,
                 Raster  parent)
지정된 SampleModel, DataBuffer, 및 부모를 사용해 Raster 를 구축합니다. aRegion 는 새로운 Raster 의 경계의 구형을 지정합니다. 기저 Raster 의 좌표계에 변환될 때, aRegion 는 기저 Raster 에 의해 포함 되고 있을 필요가 있습니다. 기저 Raster 는 Raster 의 상위 객체이며, 부모를 가지지 않습니다. sampleModelTranslate 은 새로운 Raster 의 sampleModelTranslateX 치 및 sampleModelTranslateY 치를 지정합니다. 이 생성자 은, 일반적으로, 다른 생성자 또는 create 메소드에 의해 불려 갑니다. 직접은 사용하지 않게 해 주세요.

파라미터:
sampleModel - 레이아웃을 지정하는 SampleModel
dataBuffer - 이미지 데이터를 포함하는 DataBuffer
aRegion - 이미지 영역을 지정하는 Rectangle
sampleModelTranslate - SampleModel 로부터 Raster 좌표에의 변환을 지정하는 Point
parent - 이 라스터의 부모 (존재하는 경우)
예외:
NullPointerException - sampleModel, dataBuffer,aRegion, sampleModelTranslate 중 한쪽이 null 의 경우
RasterFormatException - aRegion 의 폭 또는 높이가 제로 이하의 경우, 또는 aRegion.x + aRegion.widthaRegion.y + aRegion.height 의 몇개의 계산으로 정수형 오버플로우가 발생했을 경우
메소드의 상세

createInterleavedRaster

public static WritableRaster  createInterleavedRaster(int dataType,
                                                     int w,
                                                     int h,
                                                     int bands,
                                                     Point  location)
지정된 데이터형, 폭, 높이, 및 밴드수를 가지는, PixelInterleavedSampleModel 에 근거한 Raster 를 생성합니다.  

Raster 의 좌상구석은 location 인수에 의해 지정됩니다. location 가 null 의 경우는, (0, 0)가 사용됩니다. dataType 파라미터에는, DataBuffer 클래스 정의로 열거되는 값의 1 개를 지정합니다.  

인타리브화 된 DataBuffer.TYPE_INT Raster 는 지원되고 있지 않습니다. DataBuffer.TYPE_INT 형의 1 밴드의 Raster 를 생성하려면 , Raster.createPackedRaster()를 사용합니다.  

현재 지원되고 있는 dataType 는, TYPE_BYTE 와 TYPE_USHORT 뿐입니다.

파라미터:
dataType - 샘플 포함용의 데이터 형식
w - 이미지 데이터의 폭 (픽셀 단위)
h - 이미지 데이터의 높이 (픽셀 단위)
bands - 밴드수
location - Raster 의 좌상구석
반환값:
지정된 데이터형, 폭, 높이, 및 밴드수를 가진다 WritableRaster 객체
예외:
RasterFormatException - w 또는 h 가 제로 이하의 경우, 혹은 location.x + wlocation.y + h 의 몇개의 계산으로 정수형 오버플로우가 발생했을 경우

createInterleavedRaster

public static WritableRaster  createInterleavedRaster(int dataType,
                                                     int w,
                                                     int h,
                                                     int scanlineStride,
                                                     int pixelStride,
                                                     int[] bandOffsets,
                                                     Point  location)
지정된 데이터형, 폭, 높이, 주사선 보폭, 픽셀 보폭, 및 밴드 오프셋(offset)를 가지는, PixelInterleavedSampleModel 에 근거한 Raster 를 생성합니다. 밴드수는, bandOffsets.length 로부터 추정됩니다.  

Raster 의 좌상구석은 location 인수에 의해 지정됩니다. location 가 null 의 경우는, (0, 0)가 사용됩니다. dataType 파라미터에는, DataBuffer 클래스 정의로 열거되는 값의 1 개를 지정합니다.  

인타리브화 된 DataBuffer.TYPE_INT Raster 는 지원되고 있지 않습니다. DataBuffer.TYPE_INT 형의 1 밴드의 Raster 를 생성하려면 , Raster.createPackedRaster()를 사용합니다.  

현재 지원되고 있는 dataType 는, TYPE_BYTE 와 TYPE_USHORT 뿐입니다.

파라미터:
dataType - 샘플 포함용의 데이터 형식
w - 이미지 데이터의 폭 (픽셀 단위)
h - 이미지 데이터의 높이 (픽셀 단위)
scanlineStride - 이미지 데이터의 주사선 보폭
pixelStride - 이미지 데이터의 픽셀 보폭
bandOffsets - 모든 밴드의 오프셋(offset)
location - Raster 의 좌상구석
반환값:
지정된 데이터형, 폭, 높이, 주사선 보폭, 픽셀 보폭, 및 밴드 오프셋(offset)를 가진다 WritableRaster 객체
예외:
RasterFormatException - w 또는 h 가 제로 이하의 경우, 혹은 location.x + wlocation.y + h 의 몇개의 계산으로 정수형 오버플로우가 발생했을 경우
IllegalArgumentException - dataType 가 지원되고 있는 데이터형 DataBuffer.TYPE_BYTE 또는 DataBuffer.TYPE_USHORT 가 어느 쪽도 아닌 경우

createBandedRaster

public static WritableRaster  createBandedRaster(int dataType,
                                                int w,
                                                int h,
                                                int bands,
                                                Point  location)
지정된 데이터형, 폭, 높이, 밴드수를 가지는, BandedSampleModel 에 근거한 Raster 를 생성합니다.  

Raster 의 좌상구석은 location 인수에 의해 지정됩니다. location 가 null 의 경우는, (0, 0)가 사용됩니다. dataType 파라미터에는, DataBuffer 클래스 정의로 열거되는 값의 1 개를 지정합니다.  

현재 지원되고 있는 dataType 는, TYPE_BYTE, TYPE_USHORT, 및 TYPE_INT 뿐입니다.

파라미터:
dataType - 샘플 포함용의 데이터 형식
w - 이미지 데이터의 폭 (픽셀 단위)
h - 이미지 데이터의 높이 (픽셀 단위)
bands - 밴드수
location - Raster 의 좌상구석
반환값:
지정된 데이터형, 폭, 높이, 및 밴드수를 가진다 WritableRaster 객체
예외:
RasterFormatException - w 또는 h 가 제로 이하의 경우, 혹은 location.x + wlocation.y + h 의 몇개의 계산으로 정수형 오버플로우가 발생했을 경우
ArrayIndexOutOfBoundsException - bands 가 1 보다 작은 경우

createBandedRaster

public static WritableRaster  createBandedRaster(int dataType,
                                                int w,
                                                int h,
                                                int scanlineStride,
                                                int[] bankIndices,
                                                int[] bandOffsets,
                                                Point  location)
지정된 데이터형, 폭, 높이, 주사선 보폭, 뱅크 인덱스, 밴드 오프셋(offset)을 가지는, BandedSampleModel 에 근거한 Raster 를 생성합니다. 밴드수는, bankIndices.length 와 bandOffsets.length 로부터 추정됩니다. 이것들 2 개(살)의 길이는 같지 않으면 안됩니다.  

Raster 의 좌상구석은 location 인수에 의해 지정됩니다. dataType 파라미터에는, DataBuffer 클래스 정의로 열거되는 값의 1 개를 지정합니다.  

현재 지원되고 있는 dataType 는, TYPE_BYTE, TYPE_USHORT, 및 TYPE_INT 뿐입니다.

파라미터:
dataType - 샘플 포함용의 데이터 형식
w - 이미지 데이터의 폭 (픽셀 단위)
h - 이미지 데이터의 높이 (픽셀 단위)
scanlineStride - 이미지 데이터의 주사선 보폭
bankIndices - 각 밴드의 뱅크 인덱스
bandOffsets - 모든 밴드의 오프셋(offset)
location - Raster 의 좌상구석
반환값:
지정된 데이터형, 폭, 높이, 주사선 보폭, 뱅크 인덱스, 및 밴드 오프셋(offset)를 가진다 WritableRaster 객체
예외:
RasterFormatException - w 또는 h 가 제로 이하의 경우, 혹은 location.x + wlocation.y + h 의 몇개의 계산으로 정수형 오버플로우가 발생했을 경우
IllegalArgumentException - dataType 가 지원되고 있는 데이터형 DataBuffer.TYPE_BYTE, DataBuffer.TYPE_USHORT, DataBuffer.TYPE_INT 의 머지않아도 아닌 경우
ArrayIndexOutOfBoundsException - bankIndices 또는 bandOffsetsnull 의 경우

createPackedRaster

public static WritableRaster  createPackedRaster(int dataType,
                                                int w,
                                                int h,
                                                int[] bandMasks,
                                                Point  location)
지정된 데이터형, 폭, 높이, 및 밴드 마스크를 가지는, SinglePixelPackedSampleModel 에 근거한 Raster 를 생성합니다. 밴드수는 bandMasks.length 로부터 추정됩니다.  

Raster 의 좌상구석은 location 인수에 의해 지정됩니다. location 가 null 의 경우는, (0, 0)가 사용됩니다. dataType 파라미터에는, DataBuffer 클래스 정의로 열거되는 값의 1 개를 지정합니다.  

현재 지원되고 있는 dataType 는, TYPE_BYTE, TYPE_USHORT, 및 TYPE_INT 뿐입니다.

파라미터:
dataType - 샘플 포함용의 데이터 형식
w - 이미지 데이터의 폭 (픽셀 단위)
h - 이미지 데이터의 높이 (픽셀 단위)
bandMasks - 각 뱅크의 엔트리를 포함하는 배열
location - Raster 의 좌상구석
반환값:
지정된 데이터형, 폭, 높이, 및 밴드 마스크를 가진다 WritableRaster 객체
예외:
RasterFormatException - w 또는 h 가 제로 이하의 경우, 혹은 location.x + wlocation.y + h 의 몇개의 계산으로 정수형 오버플로우가 발생했을 경우
IllegalArgumentException - dataType 가 지원되고 있는 데이터형 DataBuffer.TYPE_BYTE, DataBuffer.TYPE_USHORT, DataBuffer.TYPE_INT 의 머지않아도 아닌 경우

createPackedRaster

public static WritableRaster  createPackedRaster(int dataType,
                                                int w,
                                                int h,
                                                int bands,
                                                int bitsPerBand,
                                                Point  location)
지정된 데이터형, 폭, 높이, 밴드수, 및 1 밴드 근처의 비트수를 가지는, 팩 된 SampleModel 에 근거한 Raster 를 생성합니다. 밴드수가 1 의 경우, SampleModel 는 MultiPixelPackedSampleModel 가 됩니다.  

밴드수가 복수의 경우, SampleModel 는 각 밴드가 bitsPerBand 비트를 가지는 SinglePixelPackedSampleModel 가 됩니다. 어느 쪽의 경우도, 대응하는 SampleModel 가 요구하는 dataType 와 bitsPerBand 에 관한 요건을 채우지 않으면 안됩니다.  

Raster 의 좌상구석은 location 인수에 의해 지정됩니다. location 가 null 의 경우는, (0, 0)가 사용됩니다. dataType 파라미터에는, DataBuffer 클래스 정의로 열거되는 값의 1 개를 지정합니다.  

현재 지원되고 있는 dataType 는, TYPE_BYTE, TYPE_USHORT, 및 TYPE_INT 뿐입니다.

파라미터:
dataType - 샘플 포함용의 데이터 형식
w - 이미지 데이터의 폭 (픽셀 단위)
h - 이미지 데이터의 높이 (픽셀 단위)
bands - 밴드수
bitsPerBand - 밴드마다의 비트수
location - Raster 의 좌상구석
반환값:
지정된 데이터형, 폭, 높이, 밴드수, 및 밴드마다의 비트수를 가지는 WritableRaster 객체
예외:
RasterFormatException - w 또는 h 가 제로 이하의 경우, 혹은 location.x + wlocation.y + h 의 몇개의 계산으로 정수형 오버플로우가 발생했을 경우
IllegalArgumentException - bitsPerBandbands 의 적이, dataType 가 보관 유지하는 비트수부터 큰 경우
IllegalArgumentException - bitsPerBand 또는 bands 가 0 이하인 경우
IllegalArgumentException - dataType 가 지원되고 있는 데이터형 DataBuffer.TYPE_BYTE, DataBuffer.TYPE_USHORT, DataBuffer.TYPE_INT 의 머지않아도 아닌 경우

createInterleavedRaster

public static WritableRaster  createInterleavedRaster(DataBuffer  dataBuffer,
                                                     int w,
                                                     int h,
                                                     int scanlineStride,
                                                     int pixelStride,
                                                     int[] bandOffsets,
                                                     Point  location)
지정된 DataBuffer, 폭, 높이, 주사선 보폭, 픽셀 보폭, 및 밴드 오프셋(offset)를 가지는, PixelInterleavedSampleModel 에 근거한 Raster 를 생성합니다. 밴드수는, bandOffsets.length 로부터 추정됩니다. Raster 의 좌상구석은 location 인수에 의해 지정됩니다. location 가 null 의 경우는, (0, 0)가 사용됩니다.  

인타리브화 된 DataBuffer.TYPE_INT Raster 는 지원되고 있지 않습니다. DataBuffer.TYPE_INT 형의 1 밴드의 Raster 를 생성하려면 , Raster.createPackedRaster()를 사용합니다.

파라미터:
dataBuffer - 이미지 데이터를 포함한다 DataBuffer
w - 이미지 데이터의 폭 (픽셀 단위)
h - 이미지 데이터의 높이 (픽셀 단위)
scanlineStride - 이미지 데이터의 주사선 보폭
pixelStride - 이미지 데이터의 픽셀 보폭
bandOffsets - 모든 밴드의 오프셋(offset)
location - Raster 의 좌상구석
반환값:
지정된 DataBuffer, 폭, 높이, 주사선 보폭, 픽셀 보폭, 및 밴드 오프셋(offset)를 가진다 WritableRaster 객체
예외:
RasterFormatException - w 또는 h 가 제로 이하의 경우, 혹은 location.x + wlocation.y + h 의 몇개의 계산으로 정수형 오버플로우가 발생했을 경우
IllegalArgumentException - dataType 가 지원되고 있는 데이터형 DataBuffer.TYPE_BYTEDataBuffer.TYPE_USHORT 가 어느 쪽도 아닌 경우
RasterFormatException - dataBuffer 가 복수의 뱅크를 가지는 경우
NullPointerException - dataBuffer 가 null 의 경우

createBandedRaster

public static WritableRaster  createBandedRaster(DataBuffer  dataBuffer,
                                                int w,
                                                int h,
                                                int scanlineStride,
                                                int[] bankIndices,
                                                int[] bandOffsets,
                                                Point  location)
지정된 DataBuffer, 폭, 높이, 주사선 보폭, 뱅크 인덱스, 및 뱅크 오프셋(offset)을 가지는, BandedSampleModel 에 근거한 Raster 를 생성합니다. 밴드수는 bankIndices.length 와 bandOffsets.length 로부터 추정됩니다. 이것들 2 개(살)의 길이는 같지 않으면 안됩니다. Raster 의 좌상구석은 location 인수에 의해 지정됩니다. location 가 null 의 경우는, (0, 0)가 사용됩니다.

파라미터:
dataBuffer - 이미지 데이터를 포함한다 DataBuffer
w - 이미지 데이터의 폭 (픽셀 단위)
h - 이미지 데이터의 높이 (픽셀 단위)
scanlineStride - 이미지 데이터의 주사선 보폭
bankIndices - 각 밴드의 뱅크 인덱스
bandOffsets - 모든 밴드의 오프셋(offset)
location - Raster 의 좌상구석
반환값:
지정된 DataBuffer, 폭, 높이, 주사선 보폭, 뱅크 인덱스, 및 밴드 오프셋(offset)를 가진다 WritableRaster 객체
예외:
RasterFormatException - w 또는 h 가 제로 이하의 경우, 혹은 location.x + wlocation.y + h 의 몇개의 계산으로 정수형 오버플로우가 발생했을 경우
IllegalArgumentException - dataType 가 지원되고 있는 데이터형 DataBuffer.TYPE_BYTE, DataBuffer.TYPE_USHORT, DataBuffer.TYPE_INT 의 머지않아도 아닌 경우
NullPointerException - dataBuffer 가 null 의 경우

createPackedRaster

public static WritableRaster  createPackedRaster(DataBuffer  dataBuffer,
                                                int w,
                                                int h,
                                                int scanlineStride,
                                                int[] bandMasks,
                                                Point  location)
지정된 DataBuffer, 폭, 높이, 주사선 보폭, 및 밴드 마스크를 가지는, SinglePixelPackedSampleModel 에 근거한 Raster 를 생성합니다. 밴드수는 bandMasks.length 로부터 추정됩니다. Raster 의 좌상구석은 location 인수에 의해 지정됩니다. location 가 null 의 경우는, (0, 0)가 사용됩니다.

파라미터:
dataBuffer - 이미지 데이터를 포함한다 DataBuffer
w - 이미지 데이터의 폭 (픽셀 단위)
h - 이미지 데이터의 높이 (픽셀 단위)
scanlineStride - 이미지 데이터의 주사선 보폭
bandMasks - 각 뱅크의 엔트리를 포함하는 배열
location - Raster 의 좌상구석
반환값:
지정된 DataBuffer, 폭, 높이, 주사선 보폭, 및 밴드 마스크를 가진다 WritableRaster 객체
예외:
RasterFormatException - w 또는 h 가 제로 이하의 경우, 혹은 location.x + wlocation.y + h 의 몇개의 계산으로 정수형 오버플로우가 발생했을 경우
IllegalArgumentException - dataType 가 지원되고 있는 데이터형 DataBuffer.TYPE_BYTE, DataBuffer.TYPE_USHORT, DataBuffer.TYPE_INT 의 머지않아도 아닌 경우
RasterFormatException - dataBuffer 가 복수의 뱅크를 가지는 경우
NullPointerException - dataBuffer 가 null 의 경우

createPackedRaster

public static WritableRaster  createPackedRaster(DataBuffer  dataBuffer,
                                                int w,
                                                int h,
                                                int bitsPerPixel,
                                                Point  location)
지정된 DataBuffer, 폭, 높이, 및 1 픽셀 근처의 비트수를 가지는, MultiPixelPackedSampleModel 에 근거한 Raster 를 생성합니다. Raster 의 좌상구석은 location 인수에 의해 지정됩니다. location 가 null 의 경우는, (0, 0)가 사용됩니다.

파라미터:
dataBuffer - 이미지 데이터를 포함한다 DataBuffer
w - 이미지 데이터의 폭 (픽셀 단위)
h - 이미지 데이터의 높이 (픽셀 단위)
bitsPerPixel - 각 픽셀의 비트수
location - Raster 의 좌상구석
반환값:
지정된 DataBuffer, 폭, 높이, 및 픽셀 근처의 비트수를 가진다 WritableRaster 객체
예외:
RasterFormatException - w 또는 h 가 제로 이하의 경우, 혹은 location.x + wlocation.y + h 의 몇개의 계산으로 정수형 오버플로우가 발생했을 경우
IllegalArgumentException - dataType 가 지원되고 있는 데이터형 DataBuffer.TYPE_BYTE, DataBuffer.TYPE_USHORT, DataBuffer.TYPE_INT 의 머지않아도 아닌 경우
RasterFormatException - dataBuffer 가 복수의 뱅크를 가지는 경우
NullPointerException - dataBuffer 가 null 의 경우

createRaster

public static Raster  createRaster(SampleModel  sm,
                                  DataBuffer  db,
                                  Point  location)
지정된 SampleModel 와 DataBuffer 를 가지는 Raster 를 생성합니다. Raster 의 좌상구석은 location 인수에 의해 지정됩니다. location 가 null 의 경우는, (0, 0)가 사용됩니다.

파라미터:
sm - 지정된 SampleModel
db - 지정된 DataBuffer
location - Raster 의 좌상구석
반환값:
지정된 SampleModel, DataBuffer, 및 위치를 가진다 Raster
예외:
RasterFormatException - location.x + sm.getWidth()location.y + sm.getHeight() 의 몇개의 계산으로 정수형 오버플로우가 발생했을 경우
RasterFormatException - dataBuffer 가 복수의 뱅크를 가져,sampleModel 가 PixelInterleavedSampleModel, SinglePixelPackedSampleModel, 또는 MultiPixelPackedSampleModel 의 경우
NullPointerException - SampleModel 또는 DataBuffer 가 null 의 경우

createWritableRaster

public static WritableRaster  createWritableRaster(SampleModel  sm,
                                                  Point  location)
지정된 SampleModel 를 가지는 WritableRaster 를 생성합니다. Raster 의 좌상구석은 location 인수에 의해 지정됩니다. location 가 null 의 경우는, (0, 0)가 사용됩니다.

파라미터:
sm - 지정된 SampleModel
location - WritableRaster 의 좌상구석
반환값:
지정된 SampleModel, 및 위치를 가진다 WritableRaster
예외:
RasterFormatException - location.x + sm.getWidth()location.y + sm.getHeight() 의 몇개의 계산으로 정수형 오버플로우가 발생했을 경우

createWritableRaster

public static WritableRaster  createWritableRaster(SampleModel  sm,
                                                  DataBuffer  db,
                                                  Point  location)
지정된 SampleModel 와 DataBuffer 를 가지는 WritableRaster 를 생성합니다. Raster 의 좌상구석은 location 인수에 의해 지정됩니다. location 가 null 의 경우는, (0, 0)가 사용됩니다.

파라미터:
sm - 지정된 SampleModel
db - 지정된 DataBuffer
location - WritableRaster 의 좌상구석
반환값:
지정된 SampleModel, DataBuffer, 및 위치를 가진다 WritableRaster
예외:
RasterFormatException - location.x + sm.getWidth()location.y + sm.getHeight() 의 몇개의 계산으로 정수형 오버플로우가 발생했을 경우
RasterFormatException - dataBuffer 가 복수의 뱅크를 가져,sampleModel 가 PixelInterleavedSampleModel, SinglePixelPackedSampleModel, 또는 MultiPixelPackedSampleModel 의 경우
NullPointerException - SampleModel 또는 DataBuffer 가 null 의 경우

getParent

public Raster  getParent()
이 Raster 의 친 Raster 가 있으면 그것을 돌려줍니다. 부모가 없는 경우는, null 를 돌려줍니다.

반환값:
친 Raster 또는 null

getSampleModelTranslateX

public final int getSampleModelTranslateX()
SampleModel 의 좌표 체계로부터 Raster 의 좌표 체계에의 X 변환을 돌려줍니다. 픽셀의 X 좌표를 Raster 의 좌표 체계로부터 SampleModel 의 좌표 체계로 변환하려면 , 이 값을 감산할 필요가 있습니다.

반환값:
Raster 의 SampleModel 의 좌표 공간으로부터 Raster 의 좌표 공간에의 X 변환

getSampleModelTranslateY

public final int getSampleModelTranslateY()
SampleModel 의 좌표 체계로부터 Raster 의 좌표 체계에의 Y 변환을 돌려줍니다. 픽셀의 Y 좌표를 Raster 의 좌표 체계로부터 SampleModel 의 좌표 체계로 변환하려면 , 이 값을 감산할 필요가 있습니다.

반환값:
Raster 의 SampleModel 의 좌표 공간으로부터 Raster 의 좌표 공간에의 Y 변환

createCompatibleWritableRaster

public WritableRaster  createCompatibleWritableRaster()
이 Raster 와 같은 SampleModel 와 초기화된 새로운 DataBuffer 를 가져, 이 Raster 와 같은 사이즈로 호환성이 있는 WritableRaster 를 생성합니다.

반환값:
같은 샘플 모델과 새로운 데이터 버퍼를 가져, 호환성이 있다 WritableRaster

createCompatibleWritableRaster

public WritableRaster  createCompatibleWritableRaster(int w,
                                                     int h)
지정된 사이즈, 새로운 SampleModel, 및 초기화된 새로운 DataBuffer 를 가져, 호환성이 있는 WritableRaster 를 생성합니다.

파라미터:
w - 새로운 WritableRaster 의 지정된 폭
h - 새로운 WritableRaster 의 지정된 높이
반환값:
지정된 사이즈, 새로운 샘플 모델, 및 데이터 버퍼를 가져, 호환성이 있는 WritableRaster
예외:
RasterFormatException - 폭 또는 높이가 0 이하인 경우

createCompatibleWritableRaster

public WritableRaster  createCompatibleWritableRaster(Rectangle  rect)
rect 에 의해 지정되는 위치 (minX, minY)와 사이즈 (width, height), 새로운 SampleModel, 및 초기화된 새로운 DataBuffer 를 가져, 호환성이 있는 WritableRaster 를 생성합니다.

파라미터:
rect - WritableRaster 의 사이즈와 위치를 나타낸다 Rectangle
반환값:
지정된 사이즈, 위치, 새로운 샘플 모델, 및 데이터 버퍼를 가져, 호환성이 있는 WritableRaster
예외:
RasterFormatException - rect 의 폭 또는 높이가 제로 이하의 경우, 혹은 rect.x + rect.widthrect.y + rect.height 의 몇개의 계산으로 정수형 오버플로우가 발생했을 경우
NullPointerException - rect 가 null 의 경우

createCompatibleWritableRaster

public WritableRaster  createCompatibleWritableRaster(int x,
                                                     int y,
                                                     int w,
                                                     int h)
지정된 위치 (minX, minY)와 사이즈 (width, height), 새로운 SampleModel, 및 초기화된 새로운 DataBuffer 를 가져, 호환성이 있는 WritableRaster 를 생성합니다.

파라미터:
x - WritableRaster 의 좌상구석의 X 좌표
y - WritableRaster 의 좌상구석의 Y 좌표
w - WritableRaster 의 지정된 폭
h - WritableRaster 의 지정된 높이
반환값:
지정된 사이즈, 위치, 새로운 샘플 모델, 및 데이터 버퍼를 가져, 호환성이 있는 WritableRaster
예외:
RasterFormatException - w 또는 h 가 제로 이하의 경우, 혹은 x + wy + h 의 몇개의 계산으로 정수형 오버플로우가 발생했을 경우

createTranslatedChild

public Raster  createTranslatedChild(int childMinX,
                                    int childMinY)
이 Raster 와 같은 사이즈, SampleModel, 및 DataBuffer 를 가져, 위치가 다른 Raster 를 생성합니다. 새로운 Raster 는, getParent() 메소드에 의해 액세스 가능한, 현재의 Raster 에의 참조를 가집니다.

파라미터:
childMinX - 새로운 Raster 의 좌상구석의 X 좌표
childMinY - 새로운 Raster 의 좌상구석의 Y 좌표
반환값:
Raster 와 같은 사이즈, SampleModel, 및 데이터 버퍼를 가져, 지정된 위치를 가진다 새로운 Raster
예외:
RasterFormatException - childMinX + this.getWidth()childMinY + this.getHeight() 의 몇개의 계산으로 정수형 오버플로우가 발생했을 경우

createChild

public Raster  createChild(int parentX,
                          int parentY,
                          int width,
                          int height,
                          int childMinX,
                          int childMinY,
                          int[] bandList)
이 Raster 의 DataBuffer 의 모두 또는 일부를 공유하는 새로운 Raster 를 돌려줍니다. 새로운 Raster 는, getParent() 메소드에 의해 액세스 가능한, 현재의 Raster 에의 참조를 가집니다.  

parentX, parentY, width, height 의 각 파라미터에 의해 이 Raster 의 좌표 공간에 형성되는 Rectangle 가, 공유되는 픽셀 영역을 나타냅니다. 이 Rectangle 가 현재의 Raster 의 경계내에 없는 경우는, 에러가 throw 됩니다.  

새로운 Raster 는 게다가 같은 평면상으로 현재의 Raster 가 사용하는 좌표 체계와는 다른 좌표 체계로 변환할 수 있습니다. childMinX 파라미터와 childMinY 파라미터에 의해, 반환된 Raster 의 좌상구석의 픽셀의 새로운 좌표 (x, y)가 지정됩니다. 새로운 Raster 내의 좌표 (childMinX, childMinY)는, 현재의 Raster 내의 좌표 (parentX, parentY)와 같은 픽셀에 맵 됩니다.  

bandList 파라미터를 사용해, 새로운 Raster 가 현재의 Raster 의 밴드의 부분집합만을, 경우에 따라서는 순서를 변경해, 포함하도록(듯이) 정의할 수 있습니다. bandList 가 null 의 경우는, 현재의 Raster 의 모든 밴드가 현재와 같은 순서로 포함됩니다.  

현재의 Raster 의 부분 영역을 보관 유지하지만, 좌표 체계와 밴드는 현재의 Raster 와 공유하는 새로운 Raster 를 생성하려면 , childMinX 를 parentX 와 같은 값에, childMinY 를 parentY 와 같은 값에, bandList 를 null 에 각각 지정해, 이 메소드를 호출합니다.

파라미터:
parentX - 이 Raster 의 좌표로 좌상구석의 X 좌표
parentY - 이 Raster 의 좌표로 좌상구석의 Y 좌표
width - (parentX, parentY)로부터 시작되는 영역의 폭
height - (parentX, parentY)로부터 시작되는 영역의 높이
childMinX - 반환되는 Raster 의 좌상구석의 X 좌표
childMinY - 반환되는 Raster 의 좌상구석의 Y 좌표
bandList - 밴드 인덱스의 배열. 모든 밴드를 사용하는 경우는 null
반환값:
새로운 Raster
예외:
RasterFormatException - 지정된 부분 영역이 라스터 경계의 외측에 있는 경우
RasterFormatException - width 또는 height 가 제로 이하의 경우, 혹은 parentX + width,parentY + height, childMinX + width, childMinY + height 의 몇개의 계산으로 정수형 오버플로우가 발생했을 경우

getBounds

public Rectangle  getBounds()
이 Raster 의 경계의 Rectangle 를 돌려줍니다. 이 함수는, getMinX/MinY/Width/Height 와 같은 정보를 돌려줍니다.

반환값:
Raster 의 바운딩 박스

getMinX

public final int getMinX()
Raster 의 유효한 최소의 X 좌표를 돌려줍니다.

반환값:
Raster 의 최소 x 좌표

getMinY

public final int getMinY()
Raster 의 유효한 최소의 Y 좌표를 돌려줍니다.

반환값:
Raster 의 최소 y 좌표

getWidth

public final int getWidth()
Raster 의 폭을 픽셀 단위로 돌려줍니다.

반환값:
Raster 의 폭

getHeight

public final int getHeight()
Raster 의 높이를 픽셀 단위로 돌려줍니다.

반환값:
Raster 의 높이

getNumBands

public final int getNumBands()
이 Raster 내의 밴드수 (1 픽셀 근처의 샘플수)를 돌려줍니다.

반환값:
Raster 의 밴드수

getNumDataElements

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

반환값:
데이터 요소수

getTransferType

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

반환값:
이 TransferType

getDataBuffer

public DataBuffer  getDataBuffer()
이 Raster 에 관련한 DataBuffer 를 돌려줍니다.

반환값:
RasterDataBuffer

getSampleModel

public SampleModel  getSampleModel()
이미지 데이터의 레이아웃을 기술하는 SampleModel 를 돌려줍니다.

반환값:
RasterSampleModel

getDataElements

public Object  getDataElements(int x,
                              int y,
                              Object  outData)
transferType 형의 프리미티브(primitive) 배열내의 1 개의 픽셀의 데이터를 돌려줍니다. Java 2D(tm) API 에 의해 지원되고 있는 이미지 데이터의 경우는, DataBuffer.TYPE_BYTE, DataBuffer.TYPE_USHORT, DataBuffer.TYPE_INT, DataBuffer.TYPE_SHORT, DataBuffer.TYPE_FLOAT, 또는 DataBuffer.TYPE_DOUBLE 의 어느 쪽인가에 됩니다. 데이터는 팩 된 형식에서 반환되는 일도 있어, 그 경우, 데이터 전송의 효율이 오릅니다. 좌표가 경계내에 없는 경우는, ArrayIndexOutOfBoundsException 가 throw 됩니다. 다만, 명시적인 경계 체크는 반드시 실행되지 않습니다. 입력 객체가 null 가 아니고, TransferType 의 배열 이외의 것을 참조하는 경우, ClassCastException 가 throw 됩니다.

파라미터:
x - 픽셀 위치의 X 좌표
y - 픽셀 위치의 Y 좌표
outData - getTransferType()에 의해 정의된 형태와 getNumDataElements()에 의해 정의된 길이를 가지는 배열에의 객체 참조. null 의 경우는, 적절한 형태와 사이즈의 배열이 할당할 수 있다
반환값:
요구된 픽셀 데이터를 가져, getTransferType()에 의해 형태가 정의된 배열에의 객체 참조
예외:
ArrayIndexOutOfBoundsException - 좌표가 경계내에 존재하지 않는 경우, 또는 outData 가 너무 작아 출력을 보관 유지할 수 없는 경우
관련 항목:
SampleModel.getDataElements(int, int, Object, DataBuffer)

getDataElements

public Object  getDataElements(int x,
                              int y,
                              int w,
                              int h,
                              Object  outData)
TransferType 형의 프리미티브(primitive) 배열의, 지정된 픽셀 구형의 픽셀 데이터를 돌려줍니다. Java 2D API 에 의해 지원되고 있는 이미지 데이터의 경우는, DataBuffer.TYPE_BYTE, DataBuffer.TYPE_USHORT, DataBuffer.TYPE_INT, DataBuffer.TYPE_SHORT, DataBuffer.TYPE_FLOAT, 또는 DataBuffer.TYPE_DOUBLE 의 어느 쪽인가에 됩니다. 데이터는 팩 된 형식에서 반환되는 일도 있어, 그 경우, 데이터 전송의 효율이 오릅니다. 좌표가 경계내에 없는 경우는, ArrayIndexOutOfBoundsException 가 throw 됩니다. 다만, 명시적인 경계 체크는 반드시 실행되지 않습니다. 입력 객체가 null 가 아니고, TransferType 의 배열 이외의 것을 참조하는 경우, ClassCastException 가 throw 됩니다.

파라미터:
x - 좌상의 픽셀 위치의 X 좌표
y - 좌상의 픽셀 위치의 Y 좌표
w - 픽셀 구형의 폭
h - 픽셀 구형의 높이
outData - getTransferType()에 의해 형태가, w*h*getNumDataElements()에 의해 길이가 정의된 배열에의 객체 참조. null 의 경우는, 적절한 형태와 사이즈의 배열이 할당할 수 있다
반환값:
요구된 픽셀 데이터를 가져, getTransferType()에 의해 형태가 정의된 배열에의 객체 참조
예외:
ArrayIndexOutOfBoundsException - 좌표가 경계내에 존재하지 않는 경우, 또는 outData 가 너무 작아 출력을 보관 유지할 수 없는 경우
관련 항목:
SampleModel.getDataElements(int, int, int, int, Object, DataBuffer)

getPixel

public int[] getPixel(int x,
                      int y,
                      int[] iArray)
지정된 픽셀의 샘플을 int 배열로서 돌려줍니다. 좌표가 경계내에 없는 경우는, ArrayIndexOutOfBoundsException 가 throw 됩니다. 다만, 명시적인 경계 체크는 반드시 실행되지 않습니다.

파라미터:
x - 픽셀 위치의 X 좌표
y - 픽셀 위치의 Y 좌표
iArray - 필요에 따라서 사전에 할당할 수 있었던 int 배열
반환값:
지정된 픽셀의 샘플
예외:
ArrayIndexOutOfBoundsException - 좌표가 경계내에 존재하지 않는 경우, 또는 iArray 가 너무 작아 출력을 보관 유지할 수 없는 경우

getPixel

public float[] getPixel(int x,
                        int y,
                        float[] fArray)
지정된 픽셀의 샘플을 float 배열로서 돌려줍니다. 좌표가 경계내에 없는 경우는, ArrayIndexOutOfBoundsException 가 throw 됩니다. 다만, 명시적인 경계 체크는 반드시 실행되지 않습니다.

파라미터:
x - 픽셀 위치의 X 좌표
y - 픽셀 위치의 Y 좌표
fArray - 필요에 따라서 사전에 할당할 수 있었던 float 배열
반환값:
지정된 픽셀의 샘플
예외:
ArrayIndexOutOfBoundsException - 좌표가 경계내에 존재하지 않는 경우, 또는 fArray 가 너무 작아 출력을 보관 유지할 수 없는 경우

getPixel

public double[] getPixel(int x,
                         int y,
                         double[] dArray)
지정된 픽셀의 샘플을 double 배열로서 돌려줍니다. 좌표가 경계내에 없는 경우는, ArrayIndexOutOfBoundsException 가 throw 됩니다. 다만, 명시적인 경계 체크는 반드시 실행되지 않습니다.

파라미터:
x - 픽셀 위치의 X 좌표
y - 픽셀 위치의 Y 좌표
dArray - 필요에 따라서 사전에 할당할 수 있었던 double 배열
반환값:
지정된 픽셀의 샘플
예외:
ArrayIndexOutOfBoundsException - 좌표가 경계내에 존재하지 않는 경우, 또는 dArray 가 너무 작아 출력을 보관 유지할 수 없는 경우

getPixels

public int[] getPixels(int x,
                       int y,
                       int w,
                       int h,
                       int[] iArray)
구형의 픽셀의 샘플 모든 것을, 배열 요소 마다 1 개의 샘플이 포함되고 있는 int 배열로서 돌려줍니다. 좌표가 경계내에 없는 경우는, ArrayIndexOutOfBoundsException 가 throw 됩니다. 다만, 명시적인 경계 체크는 반드시 실행되지 않습니다.

파라미터:
x - 좌상의 픽셀 위치의 X 좌표
y - 좌상의 픽셀 위치의 Y 좌표
w - 픽셀 구형의 폭
h - 픽셀 구형의 높이
iArray - 필요에 따라서 사전에 할당할 수 있었던 int 배열
반환값:
지정된 픽셀 구형의 샘플
예외:
ArrayIndexOutOfBoundsException - 좌표가 경계내에 존재하지 않는 경우, 또는 iArray 가 너무 작아 출력을 보관 유지할 수 없는 경우

getPixels

public float[] getPixels(int x,
                         int y,
                         int w,
                         int h,
                         float[] fArray)
구형의 픽셀의 샘플 모든 것을, 배열 요소 마다 1 개의 샘플이 포함되고 있는 float 배열로서 돌려줍니다. 좌표가 경계내에 없는 경우는, ArrayIndexOutOfBoundsException 가 throw 됩니다. 다만, 명시적인 경계 체크는 반드시 실행되지 않습니다.

파라미터:
x - 픽셀 위치의 X 좌표
y - 픽셀 위치의 Y 좌표
w - 픽셀 구형의 폭
h - 픽셀 구형의 높이
fArray - 필요에 따라서 사전에 할당할 수 있었던 float 배열
반환값:
지정된 픽셀 구형의 샘플
예외:
ArrayIndexOutOfBoundsException - 좌표가 경계내에 존재하지 않는 경우, 또는 fArray 가 너무 작아 출력을 보관 유지할 수 없는 경우

getPixels

public double[] getPixels(int x,
                          int y,
                          int w,
                          int h,
                          double[] dArray)
구형의 픽셀의 샘플 모든 것을, 배열 요소 마다 1 개의 샘플이 포함되고 있는 double 배열로서 돌려줍니다. 좌표가 경계내에 없는 경우는, ArrayIndexOutOfBoundsException 가 throw 됩니다. 다만, 명시적인 경계 체크는 반드시 실행되지 않습니다.

파라미터:
x - 좌상의 픽셀 위치의 X 좌표
y - 좌상의 픽셀 위치의 Y 좌표
w - 픽셀 구형의 폭
h - 픽셀 구형의 높이
dArray - 필요에 따라서 사전에 할당할 수 있었던 double 배열
반환값:
지정된 픽셀 구형의 샘플
예외:
ArrayIndexOutOfBoundsException - 좌표가 경계내에 존재하지 않는 경우, 또는 dArray 가 너무 작아 출력을 보관 유지할 수 없는 경우

getSample

public int getSample(int x,
                     int y,
                     int b)
(x, y)에 위치하는 픽셀의 지정된 밴드내의 샘플을 int 로서 돌려줍니다. 좌표가 경계내에 없는 경우는, ArrayIndexOutOfBoundsException 가 throw 됩니다. 다만, 명시적인 경계 체크는 반드시 실행되지 않습니다.

파라미터:
x - 픽셀 위치의 X 좌표
y - 픽셀 위치의 Y 좌표
b - 반환되는 밴드
반환값:
지정된 좌표에 있는 픽셀의 지정된 밴드내의 샘플
예외:
ArrayIndexOutOfBoundsException - 좌표 또는 밴드 인덱스가 경계내에 없는 경우

getSampleFloat

public float getSampleFloat(int x,
                            int y,
                            int b)
(x, y)에 위치하는 픽셀의 지정된 밴드내의 샘플을 float 로서 돌려줍니다. 좌표가 경계내에 없는 경우는, ArrayIndexOutOfBoundsException 가 throw 됩니다. 다만, 명시적인 경계 체크는 반드시 실행되지 않습니다.

파라미터:
x - 픽셀 위치의 X 좌표
y - 픽셀 위치의 Y 좌표
b - 반환되는 밴드
반환값:
지정된 좌표에 있는 픽셀의 지정된 밴드내의 샘플
예외:
ArrayIndexOutOfBoundsException - 좌표 또는 밴드 인덱스가 경계내에 없는 경우

getSampleDouble

public double getSampleDouble(int x,
                              int y,
                              int b)
(x, y)에 위치하는 픽셀의 지정된 밴드내의 샘플을 double 로서 돌려줍니다. 좌표가 경계내에 없는 경우는, ArrayIndexOutOfBoundsException 가 throw 됩니다. 다만, 명시적인 경계 체크는 반드시 실행되지 않습니다.

파라미터:
x - 픽셀 위치의 X 좌표
y - 픽셀 위치의 Y 좌표
b - 반환되는 밴드
반환값:
지정된 좌표에 있는 픽셀의 지정된 밴드내의 샘플
예외:
ArrayIndexOutOfBoundsException - 좌표 또는 밴드 인덱스가 경계내에 없는 경우

getSamples

public int[] getSamples(int x,
                        int y,
                        int w,
                        int h,
                        int b,
                        int[] iArray)
int 배열의 지정된 픽셀의 구형의, 지정된 밴드의 샘플을 돌려줍니다. 배열 요소 마다 1 개의 샘플이 돌려주어집니다. 좌표가 경계내에 없는 경우는, ArrayIndexOutOfBoundsException 가 throw 됩니다. 다만, 명시적인 경계 체크는 반드시 실행되지 않습니다.

파라미터:
x - 좌상의 픽셀 위치의 X 좌표
y - 좌상의 픽셀 위치의 Y 좌표
w - 픽셀 구형의 폭
h - 픽셀 구형의 높이
b - 반환되는 밴드
iArray - 필요에 따라서 사전에 할당할 수 있었던 int 배열
반환값:
지정된 구형 픽셀의 지정된 밴드의 샘플
예외:
ArrayIndexOutOfBoundsException - 좌표 또는 밴드 인덱스가 경계내에 없는 경우, 또는 iArray 가 너무 작아 입력을 보관 유지할 수 없는 경우

getSamples

public float[] getSamples(int x,
                          int y,
                          int w,
                          int h,
                          int b,
                          float[] fArray)
float 배열내의 지정된 픽셀 구형의, 지정된 밴드의 샘플을 돌려줍니다. 배열 요소 마다 1 개의 샘플이 돌려주어집니다. 좌표가 경계내에 없는 경우는, ArrayIndexOutOfBoundsException 가 throw 됩니다. 다만, 명시적인 경계 체크는 반드시 실행되지 않습니다.

파라미터:
x - 좌상의 픽셀 위치의 X 좌표
y - 좌상의 픽셀 위치의 Y 좌표
w - 픽셀 구형의 폭
h - 픽셀 구형의 높이
b - 반환되는 밴드
fArray - 필요에 따라서 사전에 할당할 수 있었던 float 배열
반환값:
지정된 구형 픽셀의 지정된 밴드의 샘플
예외:
ArrayIndexOutOfBoundsException - 좌표 또는 밴드 인덱스가 경계내에 없는 경우, 또는 fArray 가 너무 작아 입력을 보관 유지할 수 없는 경우

getSamples

public double[] getSamples(int x,
                           int y,
                           int w,
                           int h,
                           int b,
                           double[] dArray)
double 배열내의 지정된 픽셀 구형의, 지정된 밴드의 샘플을 돌려줍니다. 배열 요소 마다 1 개의 샘플이 돌려주어집니다. 좌표가 경계내에 없는 경우는, ArrayIndexOutOfBoundsException 가 throw 됩니다. 다만, 명시적인 경계 체크는 반드시 실행되지 않습니다.

파라미터:
x - 좌상의 픽셀 위치의 X 좌표
y - 좌상의 픽셀 위치의 Y 좌표
w - 픽셀 구형의 폭
h - 픽셀 구형의 높이
b - 반환되는 밴드
dArray - 필요에 따라서 사전에 할당할 수 있었던 double 배열
반환값:
지정된 구형 픽셀의 지정된 밴드의 샘플
예외:
ArrayIndexOutOfBoundsException - 좌표 또는 밴드 인덱스가 경계내에 없는 경우, 또는 dArray 가 너무 작아 입력을 보관 유지할 수 없는 경우

JavaTM Platform
Standard Ed. 6

버그의 보고와 기능의 요청
한층 더 자세한 API 레퍼런스 및 개발자 문서에 대해서는,Java SE 개발자용 문서를 참조해 주세요. 개발자전용의 상세한 해설, 개념의 개요, 용어의 정의, 버그의 회피책, 및 코드 실례가 포함되어 있습니다.

Copyright 2006 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms . Documentation Redistribution Policy 도 참조해 주세요.