javax.imageio
클래스 IIOImage

java.lang.Object 
  javax.imageio.IIOImage

public class IIOImage
extends Object 

이미지, 썸네일 (프리뷰) 이미지 세트 및 이미지에 관련된 메타데이타를 나타내는 객체를 집합시키는 단순한 컨테이너 클래스입니다.

이미지 데이터는 RenderedImage 형식이나 Raster 형식의 어떤 것인지를 취합니다. IIOImage를 돌려주는 read용 메서드는 RenderedImage 참조를 사용해, 항상 BufferedImage를 리턴합니다. IIOImage를 받아들이는 출력용 메서드는 항상 RenderedImage를 받아들입니다만, 옵션에 의해 Raster를 받아들이는 경우도 있습니다.

getRenderedImage와 getRaster 가운데 1개가 확실히 null 이외의 값을 리턴합니다. 서브 클래스가 이 동작을 가능하게 합니다.

관련 항목:

ImageReader.readAll(int, ImageReadParam), ImageReader.readAll(java.util.Iterator), ImageWriter.write(javax.imageio.metadata.IIOMetadata, IIOImage, ImageWriteParam), ImageWriter.write(IIOImage), ImageWriter.writeToSequence(IIOImage, ImageWriteParam), ImageWriter.writeInsert(int, IIOImage, ImageWriteParam)

필드 개요

protected RenderedImage	image 참조된 RenderedImage 입니다.
protected IIOMetadata	metadata 이미지에 관련한 메타데이타를 보관 유지하는 IIOMetadata 입니다.
protected Raster	raster 참조된 Raster 입니다.
protected List <? extends BufferedImage >	thumbnails BufferedImage 썸네일의 List 또는 null 입니다.

생성자 개요

IIOImage (Raster raster, List <? extends BufferedImage > thumbnails, IIOMetadata metadata)
Raster를 보관 유지하는 IIOImage와 거기에 관련된 썸네일와 메타데이타를 구축합니다.

IIOImage (RenderedImage image, List <? extends BufferedImage > thumbnails, IIOMetadata metadata)
RenderedImage를 보관 유지하는 IIOImage와 거기에 관련된 썸네일와 메타데이타를 구축합니다.

메서드 개요

IIOMetadata	getMetadata () 현재의 IIOMetadata 객체에의 참조를 리턴합니다.
int	getNumThumbnails () 이 IIOImage에 포함되고 있는 썸네일의 수를 리턴합니다.
Raster	getRaster () 현재 설정되어 있는 Raster인가RenderedImage 만을 사용할 수 있는 경우는 null을 리턴합니다.
RenderedImage	getRenderedImage () 현재 설정되어 있는 RenderedImage인가Raster 만을 사용할 수 있는 경우는 null을 리턴합니다.
BufferedImage	getThumbnail (int index) 메인 이미지에 관련된 썸네일를 리턴합니다.
List <? extends BufferedImage >	getThumbnails () 썸네일 BufferedImage 현재의 List를 리턴합니다.
boolean	hasRaster () 이 IIOImage가 RenderedImage는 아니고, Raster를 포함하는 경우는 true를 리턴합니다.
void	setMetadata (IIOMetadata metadata) IIOMetadata를 새로운 객체인가null로 설정합니다.
void	setRaster (Raster raster) 현재의 Raster를 설정합니다.
void	setRenderedImage (RenderedImage image) 현재의 RenderedImage를 설정합니다.
void	setThumbnails (List <? extends BufferedImage > thumbnails) 썸네일의 리스트를, 새로운 BufferedImage List인가null로 설정합니다.

클래스 java.lang. Object 로부터 상속된 메서드

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

필드의 상세

image

protected RenderedImage  image

참조된 RenderedImage 입니다.

raster

protected Raster  raster

참조된 Raster 입니다.

thumbnails

protected List <?  extends BufferedImage > thumbnails

BufferedImage 썸네일의 List 또는 null 입니다. 반드시 BufferedImage 객체만을 List에 포함해 주세요.

metadata

protected IIOMetadata  metadata

이미지에 관련한 메타데이타를 보관 유지하는 IIOMetadata 입니다.

생성자 상세

IIOImage

public IIOImage(RenderedImage  image,
                List <?  extends BufferedImage > thumbnails,
                IIOMetadata  metadata)

RenderedImage를 보관 유지하는 IIOImage와 거기에 관련된 썸네일와 메타데이타를 구축합니다.

모든 파라미터가 참조에 의해 포함됩니다.

thumbnails인수는 null인지, BufferedImage 객체만을 포함합니다.

파라미터:

image - RenderedImage

thumbnails - BufferedImage List 또는 null

metadata - IIOMetadata 객체, 또는 null

예외:

IllegalArgumentException - image가 null인 경우

IIOImage

public IIOImage(Raster  raster,
                List <?  extends BufferedImage > thumbnails,
                IIOMetadata  metadata)

Raster를 보관 유지하는 IIOImage와 거기에 관련된 썸네일와 메타데이타를 구축합니다.

모든 파라미터가 참조에 의해 포함됩니다.

파라미터:

raster - Raster

thumbnails - BufferedImage List 또는 null

metadata - IIOMetadata 객체, 또는 null

예외:

IllegalArgumentException - raster가 null인 경우

메서드의 상세

getRenderedImage

public RenderedImage  getRenderedImage()

현재 설정되어 있는 RenderedImage인가Raster 만을 사용할 수 있는 경우는 null을 리턴합니다.

반환값:

RenderedImage 또는 null

관련 항목:

setRenderedImage(java.awt.image.RenderedImage)

setRenderedImage

public void setRenderedImage(RenderedImage  image)

현재의 RenderedImage를 설정합니다. 값은 참조에 의해 포함됩니다. 기존의 Raster는 파기됩니다.

파라미터:

image - RenderedImage

예외:

IllegalArgumentException - image가 null인 경우

관련 항목:

getRenderedImage()

hasRaster

public boolean hasRaster()

이 IIOImage가 RenderedImage는 아니고, Raster를 포함하는 경우는 true를 리턴합니다.

반환값:

Raster를 사용할 수 있는 경우는 true

getRaster

public Raster  getRaster()

현재 설정되어 있는 Raster인가RenderedImage 만을 사용할 수 있는 경우는 null을 리턴합니다.

반환값:

Raster 또는 null

관련 항목:

setRaster(java.awt.image.Raster)

setRaster

public void setRaster(Raster  raster)

현재의 Raster를 설정합니다. 값은 참조에 의해 포함됩니다. 기존의 RenderedImage는 파기됩니다.

파라미터:

raster - Raster

예외:

IllegalArgumentException - raster가 null인 경우

관련 항목:

getRaster()

getNumThumbnails

public int getNumThumbnails()

이 IIOImage에 포함되고 있는 썸네일의 수를 리턴합니다.

반환값:

int로서의 썸네일의 수

getThumbnail

public BufferedImage  getThumbnail(int index)

메인 이미지에 관련된 썸네일를 리턴합니다.

파라미터:

index - 목적의 썸네일 이미지의 인덱스

반환값:

BufferedImage로서의 썸네일 이미지

예외:

IndexOutOfBoundsException - 지정된 인덱스가 부인가 유효한 최대의 인덱스보다 큰 경우

ClassCastException - BufferedImage 이외의 객체가 지정된 인덱스의 썸네일의 리스트로 검출되었을 경우

관련 항목:

getThumbnails(), setThumbnails(java.util.List)

getThumbnails

public List <?  extends BufferedImage > getThumbnails()

썸네일 BufferedImage 현재의 List를 리턴합니다. 아무것도 설정되어 있지 않은 경우는 null을 리턴합니다. 라이브 참조는 리턴됩니다 .

반환값:

BufferedImage 썸네일의 현재의 List 또는 null

관련 항목:

getThumbnail(int), setThumbnails(java.util.List)

setThumbnails

public void setThumbnails(List <?  extends BufferedImage > thumbnails)

썸네일의 리스트를, 새로운 BufferedImage List인가null로 설정합니다. 이전의 List에 의 참조는 파기됩니다.

thumbnails인수는 null인지, BufferedImage 객체만을 포함합니다.

파라미터:

thumbnails - BufferedImage 썸네일의 List 또는 null

관련 항목:

getThumbnail(int), getThumbnails()

getMetadata

public IIOMetadata  getMetadata()

현재의 IIOMetadata 객체에의 참조를 리턴합니다. 아무것도 설정되어 있지 않은 경우는 null을 리턴합니다.

반환값:

IIOMetadata 객체, 또는 null

관련 항목:

setMetadata(javax.imageio.metadata.IIOMetadata)

setMetadata

public void setMetadata(IIOMetadata  metadata)

IIOMetadata를 새로운 객체인가null로 설정합니다.

파라미터:

metadata - IIOMetadata 객체, 또는 null

관련 항목:

getMetadata()