RenderedImage — 렌더 이미지 인터페이스

RenderedImage — 렌더 이미지 인터페이스 (java.awt.image)

Raster 형태의 이미지 데이터를 포함하거나 생산할 수 있는 객체들의 공통 인터페이스예요.

출처: Java API Reference

본문

RenderedImage는 Raster 형태로 이미지 데이터를 포함하거나 생산할 수 있는 객체의 공통 인터페이스예요. 이미지 데이터는 단일 타일 또는 타일의 규칙적인 배열로 저장·생산될 수 있어요. 이 인터페이스의 하위 인터페이스는 WritableRenderedImage, 구현 클래스는 BufferedImage가 있어요.

메서드

  • getSources() — 이 RenderedImage의 직접 소스인 RenderedImage 벡터 반환. 직접 소스에 대한 정보가 없으면 null, 직접 소스가 없으면 빈 Vector 반환
  • getProperty(String name) — 이미지 속성 집합에서 속성 가져오기 (구현 클래스가 결정). 지정된 속성이 정의되지 않으면 java.awt.Image.UndefinedProperty 반환
  • getPropertyNames() — getProperty(String)가 인식하는 이름 배열 반환. 인식되는 이름이 없으면 null
  • getColorModel() — 이 이미지와 연관된 ColorModel 반환. 이 이미지에서 반환되는 모든 Raster가 이 ColorModel을 가짐. null일 수 있음
  • getSampleModel() — 이 이미지와 연관된 SampleModel 반환. 모든 Raster가 이 SampleModel을 가짐
  • getWidth() / getHeight() — RenderedImage의 너비 / 높이 반환
  • getMinX() / getMinY() — RenderedImage의 최소 X / Y 좌표(포함) 반환
  • getNumXTiles() / getNumYTiles() — X / Y 방향 타일 수 반환
  • getMinTileX() / getMinTileY() — X / Y 방향의 최소 타일 인덱스 반환
  • getTileWidth() / getTileHeight() — 타일 너비 / 높이(픽셀) 반환. 모든 타일은 같은 너비·높이를 가져야 해요
  • getTileGridXOffset() / getTileGridYOffset() — 원점 기준 타일 그리드의 X / Y 오프셋, 즉 타일 (0, 0)의 왼쪽 위 픽셀 좌표 반환 (타일 (0, 0)이 실제로 존재하지 않을 수 있음)
  • getTile(int tileX, int tileY) — 타일 (tileX, tileY) 반환. tileX·tileY는 픽셀 위치가 아니라 타일 배열 인덱스예요. 반환된 Raster는 라이브이므로 이미지가 변경되면 갱신됨
  • getData() — 이미지를 하나의 큰 타일로 반환 (타일 기반 이미지는 전체를 가져와 복사해야 해요). 반환된 Raster는 이미지 데이터의 사본으로, 이미지가 변경돼도 갱신되지 않음
  • getData(Rectangle rect) — RenderedImage의 임의 영역을 계산해 반환. 사본이므로 이미지 변경 시 갱신되지 않음
  • copyData(WritableRaster raster) — RenderedImage의 임의 사각 영역을 계산해 호출자가 제공한 WritableRaster로 복사. 계산할 영역은 제공된 WritableRaster의 범위로 결정. WritableRaster는 이 이미지와 호환되는 SampleModel을 가져야 해요. raster가 null이면 적절한 WritableRaster 생성

더 알아보기