JavaTM Platform
Standard Ed. 6

java.awt.image
클래스 BufferedImage

java.lang.Object 
  상위를 확장 java.awt.Image 
      상위를 확장 java.awt.image.BufferedImage
모든 구현된 인터페이스:
RenderedImage , WritableRenderedImage , Transparency


public class BufferedImage
extends Image
implements WritableRenderedImage , Transparency

BufferedImage 서브 클래스는, 이미지 데이터의 액세스 가능한 버퍼를 갖춘 Image 를 기술합니다. BufferedImage 는,ColorModel 및 이미지 데이터 Raster 로 구성되어 있습니다. Raster SampleModel 밴드수 및 형태는, 색성분 및 알파 성분을 나타내기 위해서(때문에) ColorModel 에 의해 요구되는 수 및 형태와 일치하고 있을 필요가 있습니다. 모든 BufferedImage 객체의 좌상구석의 좌표는 (0,  0)입니다. 이 때문에,BufferedImage 의 작성에 사용되는 Raster 는 minX=0 및 minY=0 가 아니면 안됩니다.

이 클래스는,Raster 의 데이터의 취득 방법과 설정 방법법, 및 ColorModel 의 색의 기술 방법으로 의존합니다.

관련 항목:
ColorModel , Raster , WritableRaster

필드의 개요
static int TYPE_3BYTE_BGR
          청, 초록, 및 빨강이 3 바이트에 포함된 8 비트 RGB 색성분 (Windows 스타일의 BGR 칼라 모델에 대응)에 의한 이미지를 나타냅니다.
static int TYPE_4BYTE_ABGR
          청, 초록, 및 빨강이 3 바이트에 포함되어 1 바이트의 알파를 가지는 8 비트 RGBA 색성분에 의한 이미지를 나타냅니다.
static int TYPE_4BYTE_ABGR_PRE
          청, 초록, 및 빨강이 3 바이트에 포함되어 1 바이트의 알파를 가지는 8 비트 RGBA 색성분에 의한 이미지를 나타냅니다.
static int TYPE_BYTE_BINARY
          불투명한 byte 팩의 1, 2, 또는 4 비트 이미지를 나타냅니다.
static int TYPE_BYTE_GRAY
          부호 없음 byte 그레이 스케일 이미지 (인덱스 없음)를 나타냅니다.
static int TYPE_BYTE_INDEXED
          인덱스 첨부 byte 이미지를 나타냅니다.
static int TYPE_CUSTOM
          이미지형이 인식되지 않기 때문에, 이미지는 반드시 커스터마이즈 되고 있습니다.
static int TYPE_INT_ARGB
          정수형 픽셀에 팩 된 8 비트 RGBA 색성분에 의한 이미지를 나타냅니다.
static int TYPE_INT_ARGB_PRE
          정수형 픽셀에 팩 된 8 비트 RGBA 색성분에 의한 이미지를 나타냅니다.
static int TYPE_INT_BGR
          청, 초록, 및 빨강이 정수형 픽셀에 팩 된 8 비트 RGB 색성분 (Windows 스타일 또는 Solaris 스타일의 BGR 칼라 모델에 대응)에 의한 이미지를 나타냅니다.
static int TYPE_INT_RGB
          정수형 픽셀에 팩 된 8 비트 RGB 색성분에 의한 이미지를 나타냅니다.
static int TYPE_USHORT_555_RGB
          알파 없음의 5-5-5 RGB 색성분 (5 비트의 빨강, 5 비트의 초록, 5 비트의 파랑)에 의한 이미지를 나타냅니다.
static int TYPE_USHORT_565_RGB
          알파 없음의 5-6-5 RGB 색성분 (5 비트의 빨강, 6 비트의 초록, 5 비트의 파랑)에 의한 이미지를 나타냅니다.
static int TYPE_USHORT_GRAY
          부호 없음 short 그레이 스케일 이미지 (인덱스 없음)를 나타냅니다.
 
클래스 java.awt. Image 로부터 상속된 필드
accelerationPriority , SCALE_AREA_AVERAGING , SCALE_DEFAULT , SCALE_FAST , SCALE_REPLICATE , SCALE_SMOOTH , UndefinedProperty
 
인터페이스 java.awt. Transparency 로부터 상속된 필드
BITMASK , OPAQUE , TRANSLUCENT
 
생성자 의 개요
BufferedImage (ColorModel  cm, WritableRaster  raster, boolean isRasterPremultiplied, Hashtable <?,?> properties)
          ColorModelRaster 를 지정해, 새로운 BufferedImage 를 구축합니다.
BufferedImage (int width, int height, int imageType)
          정의가 끝난 이미지형안의 1 개로 BufferedImage 를 구축합니다.
BufferedImage (int width, int height, int imageType, IndexColorModel  cm)
          정의가 끝난 이미지형의 TYPE_BYTE_BINARY 또는 TYPE_BYTE_INDEXED 의 어느 쪽인지로 BufferedImage 를 구축합니다.
 
메소드의 개요
 void addTileObserver (TileObserver  to)
          타일 옵저버를 추가합니다.
 void coerceData (boolean isAlphaPremultiplied)
          isAlphaPremultiplied 변수로 지정된 상태에 데이터를 일치시킵니다.
 WritableRaster copyData (WritableRaster  outRaster)
          BufferedImage 의 임의의 구형 영역을 계산해, 지정된 WritableRaster 에 카피합니다.
 Graphics2D createGraphics ()
          이 BufferedImage 에 draw 하기 위해서 사용할 수 있는 Graphics2D 를 작성합니다.
 WritableRaster getAlphaRaster ()
          다른 공간 알파 채널을 지원하는 ColorModel 객체 (ComponentColorModelDirectColorModel 등)로 BufferedImage 의 알파 채널을 나타내는 WritableRaster 를 돌려줍니다.
 ColorModel getColorModel ()
          ColorModel 를 돌려줍니다.
 Raster getData ()
          이미지를 1 개의 큰 타일로서 돌려줍니다.
 Raster getData (Rectangle  rect)
          BufferedImage 의 임의의 영역을 계산해 돌려줍니다.
 Graphics getGraphics ()
          이 메소드는 Graphics2D 를 돌려줍니다만, 여기에서는 하위 호환을 위해서(때문에) 제공됩니다.
 int getHeight ()
          BufferedImage 의 높이를 돌려줍니다.
 int getHeight (ImageObserver  observer)
          BufferedImage 의 높이를 돌려줍니다.
 int getMinTileX ()
          x 방향의 최소 타일 인덱스를 돌려줍니다.
 int getMinTileY ()
          y 방향의 최소 타일 인덱스를 돌려줍니다.
 int getMinX ()
          이 BufferedImage 의 최소 x 좌표를 돌려줍니다.
 int getMinY ()
          이 BufferedImage 의 최소 y 좌표를 돌려줍니다.
 int getNumXTiles ()
          x 방향의 타일의 수를 돌려줍니다.
 int getNumYTiles ()
          y 방향의 타일의 수를 돌려줍니다.
 Object getProperty (String  name)
          이미지의 프로퍼티을 이름으로 돌려줍니다.
 Object getProperty (String  name, ImageObserver  observer)
          이미지의 프로퍼티을 이름으로 돌려줍니다.
 String [] getPropertyNames ()
          getProperty(String) 가 인식하는 이름의 배열을 돌려줍니다.
 WritableRaster getRaster ()
          WritableRaster 를 돌려줍니다.
 int getRGB (int x, int y)
          디폴트 RGB 칼라 모델 (TYPE_INT_ARGB) 및 디폴트 sRGB 칼라 스페이스에서 정수형 픽셀을 돌려줍니다.
 int[] getRGB (int startX, int startY, int w, int h, int[] rgbArray, int offset, int scansize)
          디폴트 RGB 칼라 모델 (TYPE_INT_ARGB) 및 디폴트 sRGB 칼라 스페이스에서 이미지 데이터의 일부로부터 정수형 픽셀의 배열을 돌려줍니다.
 SampleModel getSampleModel ()
          이 BufferedImage 에 관련지을 수 있었던 SampleModel 를 돌려줍니다.
 ImageProducer getSource ()
          이미지의 픽셀을 생성하는 객체를 돌려줍니다.
 Vector <RenderedImage > getSources ()
          이 BufferedImage 의 이미지 데이터의 직접적인 소스 (직접적인 소스의 소스는 아니다)인 RenderedImage 객체 Vector 를 돌려줍니다.
 BufferedImage getSubimage (int x, int y, int w, int h)
          지정된 구형 영역에서 정의되는 서브 이미지를 돌려줍니다.
 Raster getTile (int tileX, int tileY)
          타일 (tileX,  tileY)을 돌려줍니다.
 int getTileGridXOffset ()
          원점을 기준에 타일 구라두의 x 오프셋(offset)를 돌려줍니다.
 int getTileGridYOffset ()
          원점을 기준에 타일 구라두의 y 오프셋(offset)를 돌려줍니다.
 int getTileHeight ()
          타일의 높이를 픽셀 단위로 돌려줍니다.
 int getTileWidth ()
          타일의 폭을 픽셀 단위로 돌려줍니다.
 int getTransparency ()
          투명도를 돌려줍니다.
 int getType ()
          이미지형을 돌려줍니다.
 int getWidth ()
          BufferedImage 의 폭을 돌려줍니다.
 int getWidth (ImageObserver  observer)
          BufferedImage 의 폭을 돌려줍니다.
 WritableRaster getWritableTile (int tileX, int tileY)
          기입을 위해서(때문에) 타일을 체크아웃 합니다.
 Point [] getWritableTileIndices ()
          어느 타일이 기입을 위해서(때문에) 체크아웃 되고 있는지를 나타내는 Point 객체의 배열을 돌려줍니다.
 boolean hasTileWriters ()
          타일이 기입해용으로 체크아웃 되고 있는지 어떤지를 돌려줍니다.
 boolean isAlphaPremultiplied ()
          알파가 미리 곱셈되고 있는지 어떤지를 돌려줍니다.
 boolean isTileWritable (int tileX, int tileY)
          타일이 기입해용으로 체크아웃 되고 있는지 어떤지를 돌려줍니다.
 void releaseWritableTile (int tileX, int tileY)
          타일에 기입하기 위한 액세스권을 방폐합니다.
 void removeTileObserver (TileObserver  to)
          타일 옵저버를 삭제합니다.
 void setData (Raster  r)
          이미지의 구형 영역이 지정된 Rasterr 의 내용으로 설정합니다.
 void setRGB (int x, int y, int rgb)
          이 BufferedImage 의 픽셀을, 지정된 RGB 치로 설정합니다.
 void setRGB (int startX, int startY, int w, int h, int[] rgbArray, int offset, int scansize)
          디폴트 RGB 칼라 모델 (TYPE_INT_ARGB) 및 디폴트 sRGB 칼라 스페이스에서, int 픽셀의 배열을 이미지 데이터의 일부로 설정합니다.
 String toString ()
          이 BufferedImage 객체와 그 값의 String 표현을 돌려줍니다.
 
클래스 java.awt. Image 로부터 상속된 메소드
flush , getAccelerationPriority , getCapabilities , getScaledInstance , setAccelerationPriority
 
클래스 java.lang. Object 로부터 상속된 메소드
clone , equals , finalize , getClass , hashCode , notify , notifyAll , wait , wait , wait
 

필드의 상세

TYPE_CUSTOM

public static final int TYPE_CUSTOM
이미지형이 인식되지 않기 때문에, 이미지는 반드시 커스터마이즈 되고 있습니다. 이 형태는, getType() 메소드의 반환값으로서만 사용됩니다.

관련 항목:
정수 필드치

TYPE_INT_RGB

public static final int TYPE_INT_RGB
정수형 픽셀에 팩 된 8 비트 RGB 색성분에 의한 이미지를 나타냅니다. 이 이미지는 DirectColorModel (알파 없음)를 가집니다. 불투명하지 않은 알파를 가지는 데이터를 이 형태의 이미지에 포함하는 경우,AlphaComposite 의 설명대로, 칼라 데이터를 미리 곱셈되어 있지 않은 형식에 조정해, 알파를 파기할 필요가 있습니다.

관련 항목:
정수 필드치

TYPE_INT_ARGB

public static final int TYPE_INT_ARGB
정수형 픽셀에 팩 된 8 비트 RGBA 색성분에 의한 이미지를 나타냅니다. 이 이미지는,DirectColorModel (알파 있어)를 가집니다. 이 이미지의 칼라 데이터에는, 알파가 미리 곱셈되고 있지 않습니다. 이 형태가 BufferedImage 생성자 에의 imageType 인수로서 사용되는 경우, 작성되는 이미지는 JDK 1.1 이전의 릴리스로 작성되는 이미지와 일관성이 있습니다.

관련 항목:
정수 필드치

TYPE_INT_ARGB_PRE

public static final int TYPE_INT_ARGB_PRE
정수형 픽셀에 팩 된 8 비트 RGBA 색성분에 의한 이미지를 나타냅니다. 이 이미지는,DirectColorModel (알파 있어)를 가집니다. 이 이미지의 칼라 데이터에는, 알파가 미리 곱셈되고 있습니다.

관련 항목:
정수 필드치

TYPE_INT_BGR

public static final int TYPE_INT_BGR
청, 초록, 및 빨강이 정수형 픽셀에 팩 된 8 비트 RGB 색성분 (Windows 스타일 또는 Solaris 스타일의 BGR 칼라 모델에 대응)에 의한 이미지를 나타냅니다. 알파는 없습니다. 이미지는 DirectColorModel 를 가집니다. 불투명하지 않은 알파를 가지는 데이터를 이 형태의 이미지에 포함하는 경우,AlphaComposite 의 설명대로, 칼라 데이터를 미리 곱셈되어 있지 않은 형식에 조정해, 알파를 파기할 필요가 있습니다.

관련 항목:
정수 필드치

TYPE_3BYTE_BGR

public static final int TYPE_3BYTE_BGR
청, 초록, 및 빨강이 3 바이트에 포함된 8 비트 RGB 색성분 (Windows 스타일의 BGR 칼라 모델에 대응)에 의한 이미지를 나타냅니다. 알파는 없습니다. 이미지는 ComponentColorModel 를 가집니다. 불투명하지 않은 알파를 가지는 데이터를 이 형태의 이미지에 포함하는 경우,AlphaComposite 의 설명대로, 칼라 데이터를 미리 곱셈되어 있지 않은 형식에 조정해, 알파를 파기할 필요가 있습니다.

관련 항목:
정수 필드치

TYPE_4BYTE_ABGR

public static final int TYPE_4BYTE_ABGR
청, 초록, 및 빨강이 3 바이트에 포함되어 1 바이트의 알파를 가지는 8 비트 RGBA 색성분에 의한 이미지를 나타냅니다. 이 이미지는,ComponentColorModel (알파 있어)를 가집니다. 이 이미지의 칼라 데이터에는, 알파가 미리 곱셈되고 있지 않습니다. byte 데이터는, 각 픽셀의 byte 주소의 작은 (분)편으로부터 A, B, G, R 의 순서로 단일 byte 배열에 인타리브 됩니다.

관련 항목:
정수 필드치

TYPE_4BYTE_ABGR_PRE

public static final int TYPE_4BYTE_ABGR_PRE
청, 초록, 및 빨강이 3 바이트에 포함되어 1 바이트의 알파를 가지는 8 비트 RGBA 색성분에 의한 이미지를 나타냅니다. 이 이미지는,ComponentColorModel (알파 있어)를 가집니다. 이 이미지의 칼라 데이터에는, 알파가 미리 곱셈되고 있습니다. byte 데이터는, 각 픽셀의 byte 주소의 작은 (분)편으로부터 A, B, G, R 의 순서로 단일 byte 배열에 인타리브 됩니다.

관련 항목:
정수 필드치

TYPE_USHORT_565_RGB

public static final int TYPE_USHORT_565_RGB
알파 없음의 5-6-5 RGB 색성분 (5 비트의 빨강, 6 비트의 초록, 5 비트의 파랑)에 의한 이미지를 나타냅니다. 이 이미지는 DirectColorModel 를 가집니다. 불투명하지 않은 알파를 가지는 데이터를 이 형태의 이미지에 포함하는 경우,AlphaComposite 의 설명대로, 칼라 데이터를 미리 곱셈되어 있지 않은 형식에 조정해, 알파를 파기할 필요가 있습니다.

관련 항목:
정수 필드치

TYPE_USHORT_555_RGB

public static final int TYPE_USHORT_555_RGB
알파 없음의 5-5-5 RGB 색성분 (5 비트의 빨강, 5 비트의 초록, 5 비트의 파랑)에 의한 이미지를 나타냅니다. 이 이미지는 DirectColorModel 를 가집니다. 불투명하지 않은 알파를 가지는 데이터를 이 형태의 이미지에 포함하는 경우,AlphaComposite 의 설명대로, 칼라 데이터를 미리 곱셈되어 있지 않은 형식에 조정해, 알파를 파기할 필요가 있습니다.

관련 항목:
정수 필드치

TYPE_BYTE_GRAY

public static final int TYPE_BYTE_GRAY
부호 없음 byte 그레이 스케일 이미지 (인덱스 없음)를 나타냅니다. 이 이미지는, CS_GRAY ColorSpace 를 가지는 ComponentColorModel 를 가집니다. 불투명하지 않은 알파를 가지는 데이터를 이 형태의 이미지에 포함하는 경우,AlphaComposite 의 설명대로, 칼라 데이터를 미리 곱셈되어 있지 않은 형식에 조정해, 알파를 파기할 필요가 있습니다.

관련 항목:
정수 필드치

TYPE_USHORT_GRAY

public static final int TYPE_USHORT_GRAY
부호 없음 short 그레이 스케일 이미지 (인덱스 없음)를 나타냅니다. 이 이미지는, CS_GRAY ColorSpace 를 가지는 ComponentColorModel 를 가집니다. 불투명하지 않은 알파를 가지는 데이터를 이 형태의 이미지에 포함하는 경우,AlphaComposite 의 설명대로, 칼라 데이터를 미리 곱셈되어 있지 않은 형식에 조정해, 알파를 파기할 필요가 있습니다.

관련 항목:
정수 필드치

TYPE_BYTE_BINARY

public static final int TYPE_BYTE_BINARY
불투명한 byte 팩의 1, 2, 또는 4 비트 이미지를 나타냅니다. 이 이미지는,IndexColorModel (알파 없음)를 가집니다. imageType 인수를 취해 ColorModel 인수를 취하지 않는 BufferedImage 생성자 의 imageType 인수로서 이 형태를 사용하는 경우,IndexColorModel 은 디폴트 sRGB ColorSpace 의 2 개의 색 ({0,  0,  0} 및 {255,  255,  255})으로 작성됩니다.  

적절한 맵 사이즈의 ColorModel 를 제공하는 것으로써,ColorModel 인수를 취하는 BufferedImage 생성자 을 개입시켜, 픽셀 근처의 비트수가 2 또는 4 의 이미지를 구축합니다.  

픽셀 근처의 비트수가 8 의 이미지는,ColorModel 에 응해 TYPE_BYTE_INDEXED 또는 TYPE_BYTE_GRAY 를 사용합니다.  

색데이터를 이 형태의 이미지에 포함하는 경우,IndexColorModel 에 의해, 칼라 맵의 가장 가까운 색이 판단되어 결과의 인덱스가 포함됩니다. IndexColorModel 칼라 맵의 색에 따라서는, 알파 성분 또는 색성분의 근사 및 손실이 발생할 가능성이 있습니다.

관련 항목:
정수 필드치

TYPE_BYTE_INDEXED

public static final int TYPE_BYTE_INDEXED
인덱스 첨부 byte 이미지를 나타냅니다. imageType 인수를 취해 ColorModel 인수는 취하지 않는 BufferedImage 생성자 의 imageType 인수로서 이 형태가 사용되는 경우,IndexColorModel 는 디폴트 sRGB ColorSpace 의 256 색 6/6/6 칼라 큐브 팔레트 (216 ~ 255 이외의 색은 그레이 스케일치)로 작성됩니다.  

색데이터를 이 형태의 이미지에 포함하는 경우,IndexColorModel 에 의해, 칼라 맵의 가장 가까운 색이 판단되어 결과의 인덱스가 포함됩니다. IndexColorModel 칼라 맵의 색에 따라서는, 알파 성분 또는 색성분의 근사 및 손실이 발생할 가능성이 있습니다.

관련 항목:
정수 필드치
생성자 의 상세

BufferedImage

public BufferedImage(int width,
                     int height,
                     int imageType)
정의가 끝난 이미지형안의 1 개로 BufferedImage 를 구축합니다. 이미지의 ColorSpace 는, 디폴트의 sRGB 영역이 됩니다.

파라미터:
width - 작성된 이미지의 폭
height - 작성된 이미지의 높이
imageType - 작성된 이미지의 형식
관련 항목:
ColorSpace , TYPE_INT_RGB , TYPE_INT_ARGB , TYPE_INT_ARGB_PRE , TYPE_INT_BGR , TYPE_3BYTE_BGR , TYPE_4BYTE_ABGR , TYPE_4BYTE_ABGR_PRE , TYPE_BYTE_GRAY , TYPE_USHORT_GRAY , TYPE_BYTE_BINARY , TYPE_BYTE_INDEXED , TYPE_USHORT_565_RGB , TYPE_USHORT_555_RGB

BufferedImage

public BufferedImage(int width,
                     int height,
                     int imageType,
                     IndexColorModel  cm)
정의가 끝난 이미지형의 TYPE_BYTE_BINARY 또는 TYPE_BYTE_INDEXED 의 어느 쪽인지로 BufferedImage 를 구축합니다.  

이미지형이 TYPE_BYTE_BINARY 의 경우는, 이미지의 픽셀 근처의 비트수 (1, 2, 또는 4)의 결정에 칼라 모델내의 엔트리수가 사용됩니다. 칼라 모델내의 엔트리수가 1 또는 2 의 경우, 이미지의 픽셀 근처의 비트수는 1 이 되어, 엔트리수가 3 또는 4 의 경우는, 2 가 됩니다. 엔트리수가 5 ~ 16 의 경우는, 4 가 됩니다. 그렇지 않은 경우는, IllegalArgumentException 가 throw 됩니다.

파라미터:
width - 작성된 이미지의 폭
height - 작성된 이미지의 높이
imageType - 작성된 이미지의 형식
cm - 작성된 이미지의 IndexColorModel
예외:
IllegalArgumentException - imageType 가 TYPE_BYTE_BINARY 또는 TYPE_BYTE_INDEXED 가 아닌 경우, 혹은 imageType 가 TYPE_BYTE_BINARY 로, 칼라 맵이 16 을 넘는 엔트리를 가지는 경우
관련 항목:
TYPE_BYTE_BINARY , TYPE_BYTE_INDEXED

BufferedImage

public BufferedImage(ColorModel  cm,
                     WritableRaster  raster,
                     boolean isRasterPremultiplied,
                     Hashtable <?,?> properties)
ColorModelRaster 를 지정해, 새로운 BufferedImage 를 구축합니다. RasterSampleModel 의 밴드의 수 및 형태가, 색성분 및 알파 성분을 나타내기 위해서(때문에) ColorModel 에 의해 요구되는 수 및 형태와 일치하지 않는 경우는,RasterFormatException 가 throw 됩니다. 이 메소드는,ColorModelalphaPremultiplied 상태와 일치시키기 위해서(때문에) 색 Raster 데이터를 알파에서 곱셈 또는 제산할 수 있습니다. 이 BufferedImage 의 프로퍼티은,StringObject 의 페어 Hashtable 를 건네주는 것에 의해 확립할 수 있습니다.

파라미터:
cm - 새로운 이미지의 ColorModel
raster - 이미지 데이터의 Raster
isRasterPremultiplied - true 의 경우, 라스터의 데이터는 알파에 의해 미리 곱셈되고 있는
properties - StringObject 의 페어의 Hashtable
예외:
RasterFormatException - RasterSampleModel 의 밴드수 및 형태가, 색성분 및 알파 성분을 나타내기 위해서(때문에) ColorModel 에 의해 요구되는 수 및 형태와 일치하지 않는 경우
IllegalArgumentException - rastercm 에 대응하고 있지 않는 경우
관련 항목:
ColorModel , Raster , WritableRaster
메소드의 상세

getType

public int getType()
이미지형을 돌려줍니다. 다만, 불명형의 경우는, TYPE_CUSTOM 가 돌려주어집니다.

반환값:
BufferedImage 의 이미지형
관련 항목:
TYPE_INT_RGB , TYPE_INT_ARGB , TYPE_INT_ARGB_PRE , TYPE_INT_BGR , TYPE_3BYTE_BGR , TYPE_4BYTE_ABGR , TYPE_4BYTE_ABGR_PRE , TYPE_BYTE_GRAY , TYPE_BYTE_BINARY , TYPE_BYTE_INDEXED , TYPE_USHORT_GRAY , TYPE_USHORT_565_RGB , TYPE_USHORT_555_RGB , TYPE_CUSTOM

getColorModel

public ColorModel  getColorModel()
ColorModel 를 돌려줍니다.

정의:
인터페이스 RenderedImage 내의 getColorModel
반환값:
BufferedImageColorModel

getRaster

public WritableRaster  getRaster()
WritableRaster 를 돌려줍니다.

반환값:
BufferedImageWriteableRaster

getAlphaRaster

public WritableRaster  getAlphaRaster()
다른 공간 알파 채널을 지원하는 ColorModel 객체 (ComponentColorModelDirectColorModel 등)로 BufferedImage 의 알파 채널을 나타내는 WritableRaster 를 돌려줍니다. 이 이미지의 ColorModel 와 관련한 알파 채널이 없는 경우에는 null 를 돌려줍니다. IndexColorModel 를 제외하는 모든 ColorModel 객체에 관계되어,ColorModel 가 알파를 지원하는 경우, 이 메소드는, 이미지 데이터의 마지막 밴드에 다른 알파 채널이 포함되고 있다고 봅니다. 이미지가 룩업테이블에 알파를 가지는 IndexColorModel 를 사용하는 경우, 공간적으로 분리한 알파 채널이 존재하지 않기 때문에, 이 메소드는 null 를 돌려줍니다. 이 메소드는 새로운 WritableRaster 를 작성합니다만, 데이터 배열은 공유하게 됩니다.

반환값:
WritableRaster. 이 BufferedImageColorModel 와 관련한 알파 채널을 가지지 않는 경우는 null

getRGB

public int getRGB(int x,
                  int y)
디폴트 RGB 칼라 모델 (TYPE_INT_ARGB) 및 디폴트 sRGB 칼라 스페이스에서 정수형 픽셀을 돌려줍니다. 디폴트 모델이 이미지 ColorModel 와 일치하지 않는 경우에는 색변환을 합니다. 이 메소드를 사용하는 경우, 반환된 데이터의 각 색성분의 정밀도는 불과 8 비트입니다.

좌표가 경계내에 없는 경우는,ArrayOutOfBoundsException 가 throw 되는 일이 있습니다. 다만, 명시적인 경계 체크는 반드시 실행되지 않습니다.

파라미터:
x - 디폴트 RGB 칼라 모델 및 sRGB 칼라 스페이스에서의 취득 대상 픽셀의 X 좌표
y - 디폴트 RGB 칼라 모델 및 sRGB 칼라 스페이스에서의 취득 대상 픽셀의 Y 좌표
반환값:
디폴트 RGB 칼라 모델 및 디폴트 sRGB 칼라 스페이스의 정수형 픽셀
관련 항목:
setRGB(int, int, int) , setRGB(int, int, int, int, int[], int, int)

getRGB

public int[] getRGB(int startX,
                    int startY,
                    int w,
                    int h,
                    int[] rgbArray,
                    int offset,
                    int scansize)
디폴트 RGB 칼라 모델 (TYPE_INT_ARGB) 및 디폴트 sRGB 칼라 스페이스에서 이미지 데이터의 일부로부터 정수형 픽셀의 배열을 돌려줍니다. 디폴트 모델이 이미지 ColorModel 와 일치하지 않는 경우는 색변환을 합니다. 이 메소드를 사용하는 경우, 반환된 데이터의 각 색성분의 정밀도는 불과 8 비트입니다. 이미지의 좌표 (x,  y)를 지정했을 경우, ARGB 픽셀에는 다음과 같이 해 액세스 할 수 있습니다.

    pixel   = rgbArray[offset + (y-startY) *scansize + (x-startX)]; 

영역이 경계내에 없는 경우는,ArrayOutOfBoundsException 가 throw 되는 일이 있습니다. 다만, 명시적인 경계 체크는 반드시 실행되지 않습니다.

파라미터:
startX - 시점의 X 좌표
startY - 시점의 Y 좌표
w - 영역의 폭
h - 영역의 높이
rgbArray - null 가 아닌 경우, rgb 픽셀은 여기에 기입해지는
offset - rgbArray 에의 오프셋(offset)
scansize - rgbArray 의 주사선 보폭
반환값:
RGB 픽셀의 배열
관련 항목:
setRGB(int, int, int) , setRGB(int, int, int, int, int[], int, int)

setRGB

public void setRGB(int x,
                   int y,
                   int rgb)
BufferedImage 의 픽셀을, 지정된 RGB 치로 설정합니다. 픽셀은, 디폴트 RGB 칼라 모델 (TYPE_INT_ARGB) 및 디폴트 sRGB 칼라 스페이스에 있다고 보여집니다. IndexColorModel 를 가지는 이미지의 경우, 가장 가까운 색의 인덱스가 선택됩니다.

좌표가 경계내에 없는 경우는,ArrayOutOfBoundsException 가 throw 되는 일이 있습니다. 다만, 명시적인 경계 체크는 반드시 실행되지 않습니다.

파라미터:
x - 설정되는 픽셀의 X 좌표
y - 설정되는 픽셀의 Y 좌표
rgb - RGB 치
관련 항목:
getRGB(int, int) , getRGB(int, int, int, int, int[], int, int)

setRGB

public void setRGB(int startX,
                   int startY,
                   int w,
                   int h,
                   int[] rgbArray,
                   int offset,
                   int scansize)
디폴트 RGB 칼라 모델 (TYPE_INT_ARGB) 및 디폴트 sRGB 칼라 스페이스에서, int 픽셀의 배열을 이미지 데이터의 일부로 설정합니다. 디폴트 모델이 이미지 ColorModel 와 일치하지 않는 경우는 색변환을 합니다. 이 메소드를 사용하는 경우, 반환된 데이터의 각 색성분의 정밀도는 불과 8 비트입니다. 이 이미지의 좌표 (x,  y)를 지정했을 경우, ARGB 픽셀에는 다음과 같이 해 액세스 할 수 있습니다.
    pixel   = rgbArray[offset + (y-startY) *scansize + (x-startX)];
 
경고:디저링은 행해지지 않습니다.

영역이 경계내에 없는 경우는,ArrayOutOfBoundsException 가 throw 되는 일이 있습니다. 다만, 명시적인 경계 체크는 반드시 실행되지 않습니다.

파라미터:
startX - 시점의 X 좌표
startY - 시점의 Y 좌표
w - 영역의 폭
h - 영역의 높이
rgbArray - rgb 픽셀
offset - rgbArray 에의 오프셋(offset)
scansize - rgbArray 의 주사선 보폭
관련 항목:
getRGB(int, int) , getRGB(int, int, int, int, int[], int, int)

getWidth

public int getWidth()
BufferedImage 의 폭을 돌려줍니다.

정의:
인터페이스 RenderedImage 내의 getWidth
반환값:
BufferedImage 의 폭

getHeight

public int getHeight()
BufferedImage 의 높이를 돌려줍니다.

정의:
인터페이스 RenderedImage 내의 getHeight
반환값:
BufferedImage 의 높이

getWidth

public int getWidth(ImageObserver  observer)
BufferedImage 의 폭을 돌려줍니다.

정의:
클래스 Image 내의 getWidth
파라미터:
observer - 무시된다
반환값:
BufferedImage 의 폭
관련 항목:
Image.getHeight(java.awt.image.ImageObserver) , ImageObserver

getHeight

public int getHeight(ImageObserver  observer)
BufferedImage 의 높이를 돌려줍니다.

정의:
클래스 Image 내의 getHeight
파라미터:
observer - 무시된다
반환값:
BufferedImage 의 높이
관련 항목:
Image.getWidth(java.awt.image.ImageObserver) , ImageObserver

getSource

public ImageProducer  getSource()
이미지의 픽셀을 생성하는 객체를 돌려줍니다.

정의:
클래스 Image 내의 getSource
반환값:
이 이미지의 픽셀 생성에 사용한다 ImageProducer
관련 항목:
ImageProducer

getProperty

public Object  getProperty(String  name,
                          ImageObserver  observer)
이미지의 프로퍼티을 이름으로 돌려줍니다. 각 프로퍼티명은, 다양한 이미지의 형식에서 정의됩니다. 특정의 이미지로 프로퍼티이 정의되어 있지 않은 경우, 이 메소드는 UndefinedProperty 필드를 돌려줍니다. 이 이미지의 프로퍼티이 불명한 경우, 이 메소드는 null 를 돌려주어,ImageObserver 객체는 나중에 통지를 받겠습니다. 프로퍼티명 「comment」는, 이미지, 소스, 및 작성자의 설명으로서 사용자에게 제시할 수가 있는 임의의 코멘트를 포함하기 위해서 사용됩니다.

정의:
클래스 Image 내의 getProperty
파라미터:
name - 프로퍼티명
observer - 이미지 정보에 관한 통지를 받는 ImageObserver
반환값:
지정된 name 로 나타내지는 프로퍼티이다 Object , 또는 이 이미지의 프로퍼티이 정의되어 있지 않은 경우는 null
예외:
NullPointerException - 프로퍼티명이 null 의 경우
관련 항목:
ImageObserver , Image.UndefinedProperty

getProperty

public Object  getProperty(String  name)
이미지의 프로퍼티을 이름으로 돌려줍니다.

정의:
인터페이스 RenderedImage 내의 getProperty
파라미터:
name - 프로퍼티명
반환값:
지정된 name 로 나타내지는 프로퍼티이다 Object
예외:
NullPointerException - 프로퍼티명이 null 의 경우
관련 항목:
Image.UndefinedProperty

getGraphics

public Graphics  getGraphics()
이 메소드는 Graphics2D 를 돌려줍니다만, 여기에서는 하위 호환을 위해서(때문에) 제공됩니다. Graphics2D 를 돌려주도록(듯이) 선언되고 있기 (위해)때문에,createGraphics 가 편리합니다.

정의:
클래스 Image 내의 getGraphics
반환값:
이 이미지에의 draw에 사용된다 Graphics2D
관련 항목:
Graphics , Component.createImage(int, int)

createGraphics

public Graphics2D  createGraphics()
BufferedImage 에 draw 하기 위해서 사용할 수 있는 Graphics2D 를 작성합니다.

반환값:
이 이미지에의 draw에 사용된다 Graphics2D

getSubimage

public BufferedImage  getSubimage(int x,
                                 int y,
                                 int w,
                                 int h)
지정된 구형 영역에서 정의되는 서브 이미지를 돌려줍니다. 반환되는 BufferedImage 는, 오리지날 이미지와 같은 데이터 배열을 공유합니다.

파라미터:
x - 지정된 구형 영역의 좌상구석의 X 좌표
y - 지정된 구형 영역의 좌상구석의 Y 좌표
w - 지정된 구형 영역의 폭
h - 지정된 구형 영역의 높이
반환값:
BufferedImage 의 서브 이미지를 나타낸다 BufferedImage
예외:
RasterFormatException - 지정되었다 영역이 이 BufferedImage 내에 포함되지 않은 경우

isAlphaPremultiplied

public boolean isAlphaPremultiplied()
알파가 미리 곱셈되고 있는지 어떤지를 돌려줍니다. 알파가 없는 경우는 false 를 돌려줍니다.

반환값:
알파가 미리 곱셈되고 있는 경우는 true, 그렇지 않은 경우는 false

coerceData

public void coerceData(boolean isAlphaPremultiplied)
isAlphaPremultiplied 변수로 지정된 상태에 데이터를 일치시킵니다. 이 메소드는, 칼라 라스터 데이터를 알파에서 곱셈 또는 제산합니다. 데이터가 올바른 상태에 있는 경우에는, 처리는 실시하지 않습니다.

파라미터:
isAlphaPremultiplied - 알파가 미리 곱셈되고 있는 경우는 true, 그렇지 않은 경우는 false

toString

public String  toString()
BufferedImage 객체와 그 값의 String 표현을 돌려줍니다.

오버라이드(override):
클래스 Object 내의 toString
반환값:
BufferedImage 를 나타낸다 String

getSources

public Vector <RenderedImage > getSources()
BufferedImage 의 이미지 데이터의 직접적인 소스 (직접적인 소스의 소스는 아니다)인 RenderedImage 객체 Vector 를 돌려줍니다. BufferedImage 에 직접적인 소스에 대한 정보가 없는 경우, 이 메소드는 null 를 돌려줍니다. BufferedImage 가 직접적인 소스를 가지지 않는 경우는, 빈 상태(empty)의 Vector 를 돌려줍니다.

정의:
인터페이스 RenderedImage 내의 getSources
반환값:
BufferedImage 객체의 이미지 데이터의 직접적인 소스를 포함하고 있는 Vector. 이 BufferedImage 가 직접적인 소스에 대한 정보를 가지지 않는 경우는 null. 이 BufferedImage 가 직접적인 소스를 가지지 않는 경우는 빈 상태(empty)의 Vector

getPropertyNames

public String [] getPropertyNames()
getProperty(String) 가 인식하는 이름의 배열을 돌려줍니다. 프로퍼티명이 인식되지 않는 경우는 null 를 돌려줍니다.

정의:
인터페이스 RenderedImage 내의 getPropertyNames
반환값:
getProperty(String) 가 인식하는 모든 프로퍼티명을 포함한 String 배열. 프로퍼티명이 인식되지 않는 경우는 null

getMinX

public int getMinX()
BufferedImage 의 최소 x 좌표를 돌려줍니다. 이것은 항상 0 이 됩니다.

정의:
인터페이스 RenderedImage 내의 getMinX
반환값:
BufferedImage 의 최소 x 좌표

getMinY

public int getMinY()
BufferedImage 의 최소 y 좌표를 돌려줍니다. 이것은 항상 0 이 됩니다.

정의:
인터페이스 RenderedImage 내의 getMinY
반환값:
BufferedImage 의 최소 y 좌표

getSampleModel

public SampleModel  getSampleModel()
BufferedImage 에 관련지을 수 있었던 SampleModel 를 돌려줍니다.

정의:
인터페이스 RenderedImage 내의 getSampleModel
반환값:
BufferedImageSampleModel

getNumXTiles

public int getNumXTiles()
x 방향의 타일의 수를 돌려줍니다. 이것은 항상 1 이 됩니다.

정의:
인터페이스 RenderedImage 내의 getNumXTiles
반환값:
x 방향의 타일수

getNumYTiles

public int getNumYTiles()
y 방향의 타일의 수를 돌려줍니다. 이것은 항상 1 이 됩니다.

정의:
인터페이스 RenderedImage 내의 getNumYTiles
반환값:
y 방향의 타일수

getMinTileX

public int getMinTileX()
x 방향의 최소 타일 인덱스를 돌려줍니다. 이것은 항상 0 이 됩니다.

정의:
인터페이스 RenderedImage 내의 getMinTileX
반환값:
x 방향의 최소 타일 인덱스

getMinTileY

public int getMinTileY()
y 방향의 최소 타일 인덱스를 돌려줍니다. 이것은 항상 0 이 됩니다.

정의:
인터페이스 RenderedImage 내의 getMinTileY
반환값:
y 방향의 최소 타일 인덱스

getTileWidth

public int getTileWidth()
타일의 폭을 픽셀 단위로 돌려줍니다.

정의:
인터페이스 RenderedImage 내의 getTileWidth
반환값:
픽셀 단위의 타일폭

getTileHeight

public int getTileHeight()
타일의 높이를 픽셀 단위로 돌려줍니다.

정의:
인터페이스 RenderedImage 내의 getTileHeight
반환값:
픽셀 단위의 타일의 높이

getTileGridXOffset

public int getTileGridXOffset()
원점을 기준에 타일 구라두의 x 오프셋(offset)를 돌려줍니다. 예를 들어, 타일의 위치 (0,  0)의 x 좌표입니다. 이것은 항상 0 이 됩니다.

정의:
인터페이스 RenderedImage 내의 getTileGridXOffset
반환값:
타일 구라두의 x 오프셋(offset)

getTileGridYOffset

public int getTileGridYOffset()
원점을 기준에 타일 구라두의 y 오프셋(offset)를 돌려줍니다. 예를 들어, 타일의 위치 (0,  0)의 y 좌표입니다. 이것은 항상 0 이 됩니다.

정의:
인터페이스 RenderedImage 내의 getTileGridYOffset
반환값:
타일 구라두의 y 오프셋(offset)

getTile

public Raster  getTile(int tileX,
                      int tileY)
타일 (tileX,  tileY)을 돌려줍니다. tileXtileY 는, 타일 배열의 인덱스이며, 픽셀의 위치가 아닙니다. 반환되는 Raster 는 액티브하고, 이미지가 변경되면(자) 갱신됩니다.

정의:
인터페이스 RenderedImage 내의 getTile
파라미터:
tileX - 타일 배열에 있는 요구된 타일의 x 인덱스
tileY - 타일 배열에 있는 요구된 타일의 y 인덱스
반환값:
tileXtileY 인수로 정의된다 타일을 나타내는 Raster
예외:
ArrayIndexOutOfBoundsException - tileXtileY 의 양쪽 모두가 0 이 아닌 경우

getData

public Raster  getData()
이미지를 1 개의 큰 타일로서 돌려줍니다. 반환된 Raster 는 이미지 데이터의 카피이며, 이미지가 변경되어도 갱신되지 않습니다.

정의:
인터페이스 RenderedImage 내의 getData
반환값:
이미지 데이터의 카피인 Raster
관련 항목:
setData(Raster)

getData

public Raster  getData(Rectangle  rect)
BufferedImage 의 임의의 영역을 계산해 돌려줍니다. 반환된 Raster 는 이미지 데이터의 카피이며, 이미지가 변경되어도 갱신되지 않습니다.

정의:
인터페이스 RenderedImage 내의 getData
파라미터:
rect - 반환되는 BufferedImage 의 영역
반환값:
BufferedImage 의 지정된 영역의 이미지 데이터의 카피인 Raster
관련 항목:
setData(Raster)

copyData

public WritableRaster  copyData(WritableRaster  outRaster)
BufferedImage 의 임의의 구형 영역을 계산해, 지정된 WritableRaster 에 카피합니다. 계산되는 영역은, 지정된 WritableRaster 의 경계로부터 정해집니다. 지정된 WritableRaster 는, 이 이미지와 호환성이 있는 SampleModel 를 가질 필요가 있습니다. outRasternull 의 경우는, 적절한 WritableRaster 가 작성됩니다.

정의:
인터페이스 RenderedImage 내의 copyData
파라미터:
outRaster - 이미지가 반환된 부분을 보관 유지하는 WritableRaster, 또는 null
반환값:
공급 또는 생성되었다 WritableRaster 에의 참조

setData

public void setData(Raster  r)
이미지의 구형 영역이 지정된 Rasterr 의 내용으로 설정합니다. Raster r 는,BufferedImage 와 같은 좌표 공간에 있는 것과 가정됩니다. 이 오퍼레이션은,BufferedImage 의 경계에 클리핑 됩니다.

정의:
인터페이스 WritableRenderedImage 내의 setData
파라미터:
r - 지정한Raster
관련 항목:
getData() , getData(Rectangle)

addTileObserver

public void addTileObserver(TileObserver  to)
타일 옵저버를 추가합니다. 옵저버가 벌써 존재하는 경우는, 복수의 통지를 받습니다.

정의:
인터페이스 WritableRenderedImage 내의 addTileObserver
파라미터:
to - 지정된 TileObserver

removeTileObserver

public void removeTileObserver(TileObserver  to)
타일 옵저버를 삭제합니다. 옵저버가 등록되지 않았던 경우는, 아무것도 행해지지 않습니다. 옵저버가 복수의 통지를 대상으로 등록되어 있는 경우는, 등록 대상의 통지가 1 개 적게 됩니다.

정의:
인터페이스 WritableRenderedImage 내의 removeTileObserver
파라미터:
to - 지정된 TileObserver

isTileWritable

public boolean isTileWritable(int tileX,
                              int tileY)
타일이 기입해용으로 체크아웃 되고 있는지 어떤지를 돌려줍니다.

정의:
인터페이스 WritableRenderedImage 내의 isTileWritable
파라미터:
tileX - 타일의 x 인덱스
tileY - 타일의 y 인덱스
반환값:
지정의 인덱스에 의해 지정되는 타일이 기입해용으로 체크아웃 되고 있는 경우는 true, 그렇지 않은 경우는 false
예외:
ArrayIndexOutOfBoundsException - tileXtileY 의 양쪽 모두가 0 이 아니다 경우

getWritableTileIndices

public Point [] getWritableTileIndices()
어느 타일이 기입을 위해서(때문에) 체크아웃 되고 있는지를 나타내는 Point 객체의 배열을 돌려줍니다. 체크아웃 되고 있는 타일이 없는 경우는 null 를 돌려줍니다.

정의:
인터페이스 WritableRenderedImage 내의 getWritableTileIndices
반환값:
기입용으로 체크아웃 되고 있는 타일을 나타낸다 Point 배열. 기입용으로 체크아웃 되고 있다 타일이 없는 경우는 null

hasTileWriters

public boolean hasTileWriters()
타일이 기입해용으로 체크아웃 되고 있는지 어떤지를 돌려줍니다. 의미상은, 이하와 같습니다.
 (getWritableTileIndices() ! = null).
 

정의:
인터페이스 WritableRenderedImage 내의 hasTileWriters
반환값:
타일이 기입해용으로 체크아웃 되고 있는 경우는 true, 그렇지 않은 경우는 false

getWritableTile

public WritableRaster  getWritableTile(int tileX,
                                      int tileY)
기입을 위해서(때문에) 타일을 체크아웃 합니다. 타일이 라이터 없음 상태로부터 1 개의 라이터를 가지는 상태로 바뀌었을 때는, 등록되어 모든 TileObserver 가 통지를 받습니다.

정의:
인터페이스 WritableRenderedImage 내의 getWritableTile
파라미터:
tileX - 타일의 x 인덱스
tileY - 타일의 y 인덱스
반환값:
지정된 인덱스로 나타나 기입용으로 체크아웃 된다 타일을 나타내는 WritableRaster

releaseWritableTile

public void releaseWritableTile(int tileX,
                                int tileY)
타일에 기입하기 위한 액세스권을 방폐합니다. 호출측이 타일에의 기입을 계속했을 경우, 결과는 보증되지 않습니다. 이 메소드는,getWritableTile(int, int) 와 페어로 호출할 필요가 있습니다. 그 이외의 방법에서는 결국, 결과가 미정도리가 됩니다. 타일이 1 개의 라이터를 가지는 상태로부터 라이터 없음 상태로 바뀔 때는, 등록된 모든 TileObservers 가 통지를 받습니다.

정의:
인터페이스 WritableRenderedImage 내의 releaseWritableTile
파라미터:
tileX - 타일의 x 인덱스
tileY - 타일의 y 인덱스

getTransparency

public int getTransparency()
투명도를 돌려줍니다. OPAQUE, BITMASK, TRANSLUCENT 의 어느쪽이든을 돌려줍니다.

정의:
인터페이스 Transparency 내의 getTransparency
반환값:
BufferedImage 의 투명도
도입된 버젼:
1.5
관련 항목:
Transparency.OPAQUE , Transparency.BITMASK , Transparency.TRANSLUCENT

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 도 참조해 주세요.