java.awt.image
인터페이스 RenderedImage

기존의 서브 인터페이스의 일람:

WritableRenderedImage

기존의 구현 클래스의 일람:

BufferedImage

public interface RenderedImage

RenderedImage 는, Raster 형식에서의 이미지 데이터 포함이나 작성이 가능한 객체를 위한 공통 인터페이스입니다. 이미지 데이터는 1 개의 타일 또는 타일의 규칙 올바른 배열로서 포함 또는 작성됩니다.

메소드의 개요

WritableRaster	copyData (WritableRaster raster) RenderedImage 의 임의의 구형 영역을 계산해, 호출측이 제공한 WritableRaster 에 카피합니다.
ColorModel	getColorModel () 이 이미지에 관련한 ColorModel 를 돌려줍니다.
Raster	getData () 이미지를 1 개의 큰 타일로서 돌려줍니다.
Raster	getData (Rectangle rect) RenderedImage 의 임의의 영역을 계산해 돌려줍니다.
int	getHeight () RenderedImage 의 높이를 돌려줍니다.
int	getMinTileX () X 방향의 최소 타일 인덱스를 돌려줍니다.
int	getMinTileY () Y 방향의 최소 타일 인덱스를 돌려줍니다.
int	getMinX () RenderedImage 의 최소의 X 좌표를 돌려줍니다 (그 좌표를 포함한다).
int	getMinY () RenderedImage 의 최소의 Y 좌표를 돌려줍니다 (그 좌표를 포함한다).
int	getNumXTiles () X 방향의 타일의 수를 돌려줍니다.
int	getNumYTiles () Y 방향의 타일의 수를 돌려줍니다.
Object	getProperty (String name) 이 이미지의 프로퍼티 세트로부터 프로퍼티을 돌려줍니다.
String []	getPropertyNames () getProperty(String) 가 인식하는 모든 프로퍼티명이 포함되고 있는 String 배열.
SampleModel	getSampleModel () 이 이미지에 관련한 SampleModel 를 돌려줍니다.
Vector <RenderedImage >	getSources () 이 RenderedImage 의 이미지 데이터의 직접적인 소스가 되는 RenderedImage 의 벡터를 돌려줍니다.
Raster	getTile (int tileX, int tileY) 타일 (tileX, tileY)을 돌려줍니다.
int	getTileGridXOffset () 타일 구라두의 원점에 대한 X 오프셋(offset), 즉 타일 (0, 0)의 좌상의 픽셀의 X 좌표를 돌려줍니다.
int	getTileGridYOffset () 타일 구라두의 원점에 대한 Y 오프셋(offset), 즉 타일 (0, 0)의 좌상의 픽셀의 Y 좌표를 돌려줍니다.
int	getTileHeight () 타일의 높이를 픽셀 단위로 돌려줍니다.
int	getTileWidth () 타일의 폭을 픽셀 단위로 돌려줍니다.
int	getWidth () RenderedImage 의 폭을 돌려줍니다.

메소드의 상세

getSources

Vector <RenderedImage > getSources()

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

반환값:

RenderedImage 객체의 Vector

getProperty

Object  getProperty(String  name)

이 이미지의 프로퍼티 세트로부터 프로퍼티을 돌려줍니다. 프로퍼티세트 및 그 세트가 불변일지 어떨지는, 구현하는 클래스에 의해 정해집니다. 지정된 프로퍼티이 이 RenderedImage 로 정의되어 있지 않은 경우, 이 메소드는 java.awt.Image.UndefinedProperty 를 돌려줍니다.

파라미터:

name - 프로퍼티의 이름

반환값:

지정된 이름의 프로퍼티

관련 항목:

Image.UndefinedProperty

getPropertyNames

String [] getPropertyNames()

getProperty(String) 가 인식하는 모든 프로퍼티명이 포함되고 있는 String 배열.

반환값:

getProperty(String) 가 인식하는 모든 프로퍼티명을 포함하는 String 배열. 프로퍼티명이 인식되지 않는 경우는 null

getColorModel

ColorModel  getColorModel()

이 이미지에 관련한 ColorModel 를 돌려줍니다. 이 이미지로부터 반환된 모든 Raster 의 ColorModel 은, 이 ColorModel 가 됩니다. null 가 반환되는 일도 있습니다.

반환값:

이 이미지의 ColorModel

getSampleModel

SampleModel  getSampleModel()

이 이미지에 관련한 SampleModel 를 돌려줍니다. 이 이미지로부터 반환된 모든 Raster 의 SampleModel 은, 이 SampleModel 가 됩니다.

반환값:

이 이미지의 SampleModel

getWidth

int getWidth()

RenderedImage 의 폭을 돌려줍니다.

반환값:

이 RenderedImage 의 폭

getHeight

int getHeight()

RenderedImage 의 높이를 돌려줍니다.

반환값:

이 RenderedImage 의 높이

getMinX

int getMinX()

RenderedImage 의 최소의 X 좌표를 돌려줍니다 (그 좌표를 포함한다).

반환값:

이 RenderedImage 의 X 좌표

getMinY

int getMinY()

RenderedImage 의 최소의 Y 좌표를 돌려줍니다 (그 좌표를 포함한다).

반환값:

이 RenderedImage 의 Y 좌표

getNumXTiles

int getNumXTiles()

X 방향의 타일의 수를 돌려줍니다.

반환값:

X 방향의 타일수

getNumYTiles

int getNumYTiles()

Y 방향의 타일의 수를 돌려줍니다.

반환값:

Y 방향의 타일수

getMinTileX

int getMinTileX()

X 방향의 최소 타일 인덱스를 돌려줍니다.

반환값:

X 방향의 최소 타일 인덱스

getMinTileY

int getMinTileY()

Y 방향의 최소 타일 인덱스를 돌려줍니다.

반환값:

X 방향의 최소 타일 인덱스

getTileWidth

int getTileWidth()

타일의 폭을 픽셀 단위로 돌려줍니다. 모든 타일의 폭은 같은 필요가 있습니다.

반환값:

픽셀 단위의 타일폭

getTileHeight

int getTileHeight()

타일의 높이를 픽셀 단위로 돌려줍니다. 모든 타일의 높이는 같은 필요가 있습니다.

반환값:

픽셀 단위의 타일의 높이

getTileGridXOffset

int getTileGridXOffset()

타일 구라두의 원점에 대한 X 오프셋(offset), 즉 타일 (0, 0)의 좌상의 픽셀의 X 좌표를 돌려줍니다. 타일 (0, 0)은 실제로는 존재하지 않는 경우도 있습니다.

반환값:

타일 구라두의 원점에 대한 X 오프셋(offset)

getTileGridYOffset

int getTileGridYOffset()

타일 구라두의 원점에 대한 Y 오프셋(offset), 즉 타일 (0, 0)의 좌상의 픽셀의 Y 좌표를 돌려줍니다. 타일 (0, 0)은 실제로는 존재하지 않는 경우도 있습니다.

반환값:

타일 구라두의 원점에 대한 Y 오프셋(offset)

getTile

Raster  getTile(int tileX,
               int tileY)

타일 (tileX, tileY)을 돌려줍니다. tileX 및 tileY 는 타일 배열내에서의 인덱스이며, 픽셀 위치가 아닙니다. 반환된 Raster 는 라이브이며, 이미지가 변경되면(자) 갱신됩니다.

파라미터:

tileX - 타일 배열에 있는 요구된 타일의 X 인덱스

tileY - 타일 배열에 있는 요구된 타일의 Y 인덱스

반환값:

지정된 인덱스의 타일

getData

Raster  getData()

이미지를 1 개의 큰 타일로서 돌려줍니다. 타일이 베이스가 되어 있는 이미지의 경우는, 이미지 전체의 페치와 이미지 데이터 전체의 카피가 필요하게 됩니다. 반환되는 Raster 는 이미지 데이터의 카피이며, 이미지가 변경되어도 갱신되지 않습니다.

반환값:

1 개(살)의 큰 타일로서의 이미지

getData

Raster  getData(Rectangle  rect)

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

파라미터:

rect - 반환되는 RenderedImage 의 영역

반환값:

지정된 Rectangle 로 나타난다 RenderedImage 의 영역

copyData

WritableRaster  copyData(WritableRaster  raster)

RenderedImage 의 임의의 구형 영역을 계산해, 호출측이 제공한 WritableRaster 에 카피합니다. 계산되는 영역을 결정하는 것은, 제공된 WritableRaster 의 경계입니다. 제공되는 WritableRaster 는, 이 이미지에 준거하고 있는 SampleModel 를 가질 필요가 있습니다. raster 가 null 의 경우는, 적절한 WritableRaster 가 작성됩니다.

파라미터:

raster - 이미지가 반환된 부분을 보관 유지하는 WritableRaster, 또는 null

반환값:

공급 또는 생성된 WritableRaster 에의 참조