javax.imageio
클래스 ImageIO

java.lang.Object 
  javax.imageio.ImageIO

public final class ImageIO
extends Object 

ImageReader 및 ImageWriter 를 검색하는 정적인 편리한 메소드를 보관 유지해, 간단한 encode와 복호화를 실행하는 클래스입니다.

메소드의 개요

static ImageInputStream	createImageInputStream (Object input) 지정된 Object 로부터 입력을 취득하는 ImageInputStream 를 돌려줍니다.
static ImageOutputStream	createImageOutputStream (Object output) 지정된 Object 에 출력을 송신하는 ImageOutputStream 를 돌려줍니다.
static File	getCacheDirectory () setCacheDirectory 에 의해 설정된 현재의 값, 또는 명시적으로 설정을 하지 않은 경우는 null 를 돌려줍니다.
static ImageReader	getImageReader (ImageWriter writer) 지정된 ImageWriter 에 대응하는 ImageReader (존재하는 경우)를 돌려줍니다.
static Iterator <ImageReader >	getImageReaders (Object input) 지정된 Object, 일반적으로은 ImageInputStream 를 복호화 할 수 있는 것 같은, 현재 등록되어 모든 ImageReader 를 보관 유지하는 Iterator 를 돌려줍니다.
static Iterator <ImageReader >	getImageReadersByFormatName (String formatName) 이름 첨부의 형식을 복호화 할 수 있는 것 같은, 현재 등록되어 모든 ImageReader 를 보관 유지하는 Iterator 를 돌려줍니다.
static Iterator <ImageReader >	getImageReadersByMIMEType (String MIMEType) 지정된 MIME 타입을 가지는 파일을 복호화 할 수 있는 것 같은, 현재 등록되어 모든 ImageReader 를 보관 유지하는 Iterator 를 돌려줍니다.
static Iterator <ImageReader >	getImageReadersBySuffix (String fileSuffix) 지정된 접미사(suffix)을 가지는 파일을 복호화 할 수 있는 것 같은, 현재 등록되어 모든 ImageReader 를 보관 유지하는 Iterator 를 돌려줍니다.
static Iterator <ImageTranscoder >	getImageTranscoders (ImageReader reader, ImageWriter writer) 지정된 ImageReader 및 ImageWriter 의 메타데이타간을 변환할 수 있는 것 같은, 현재 등록되어 모든 ImageTranscoder 를 보관 유지하는 Iterator 를 돌려줍니다.
static ImageWriter	getImageWriter (ImageReader reader) 지정된 ImageReader 에 대응하는 ImageWriter (존재하는 경우)를 돌려줍니다.
static Iterator <ImageWriter >	getImageWriters (ImageTypeSpecifier type, String formatName) 지정된 형식에서, 지정된 레이아웃 (ImageTypeSpecifier 를 사용해 지정되었다)의 이미지를 encode 할 수 있는 것 같은, 현재 등록되어 모든 ImageWriter 를 보관 유지하는 Iterator 를 돌려줍니다.
static Iterator <ImageWriter >	getImageWritersByFormatName (String formatName) 이름 첨부의 형식을 encode 할 수 있는 것 같은, 현재 등록되어 모든 ImageWriter 를 보관 유지하는 Iterator 를 돌려줍니다.
static Iterator <ImageWriter >	getImageWritersByMIMEType (String MIMEType) 지정된 MIME 타입을 가지는 파일을 encode 할 수 있는 것 같은, 현재 등록되어 모든 ImageWriter 를 보관 유지하는 Iterator 를 돌려줍니다.
static Iterator <ImageWriter >	getImageWritersBySuffix (String fileSuffix) 지정된 접미사(suffix)을 가지는 파일을 encode 할 수 있는 것 같은, 현재 등록되어 모든 ImageWriter 를 보관 유지하는 Iterator 를 돌려줍니다.
static String []	getReaderFileSuffixes () 현재 등록되어 있는 일련의 리더에 의해 인식되는 형식에 관련지을 수 있던 모든 파일접미사(suffix)을 리스트 하는 String 의 배열을 돌려줍니다.
static String []	getReaderFormatNames () 현재 등록되어 있는 일련의 리더에 의해 인식되는, 모든 비공식인 형식의 이름을 리스트 하는 String 의 배열을 돌려줍니다.
static String []	getReaderMIMETypes () 현재 등록되어 있는 일련의 리더에 의해 인식되는, 모든 MIME 타입을 리스트 하는 String 의 배열을 돌려줍니다.
static boolean	getUseCache () setUseCache 에 의해 설정된 현재의 값, 또는 명시적으로 설정을 하지 않은 경우는 true 를 돌려줍니다.
static String []	getWriterFileSuffixes () 현재 등록되어 있는 일련의 라이터에 의해 인식되는 형식에 관련지을 수 있던 모든 파일접미사(suffix)을 리스트 하는 String 의 배열을 돌려줍니다.
static String []	getWriterFormatNames () 현재 등록되어 있는 일련의 라이터에 의해 인식되는, 모든 비공식인 형식의 이름을 리스트 하는 String 의 배열을 돌려줍니다.
static String []	getWriterMIMETypes () 현재 등록되어 있는 일련의 라이터에 의해 인식되는, 모든 MIME 타입을 리스트 하는 String 의 배열을 돌려줍니다.
static BufferedImage	read (File input) 현재 등록되어 있는 것의 중으로부터 자동적으로 선택된 ImageReader 를 사용해, 지정된 File 를 복호화 한 결과적으로,BufferedImage 를 돌려줍니다.
static BufferedImage	read (ImageInputStream stream) 현재 등록되어 있는 것의 중으로부터 자동적으로 선택된 ImageReader 를 사용해, 지정된 ImageInputStream 를 복호화 한 결과적으로,BufferedImage 를 돌려줍니다.
static BufferedImage	read (InputStream input) 현재 등록되어 있는 것의 중으로부터 자동적으로 선택된 ImageReader 를 사용해, 지정된 InputStream 를 복호화 한 결과적으로,BufferedImage 를 돌려줍니다.
static BufferedImage	read (URL input) 현재 등록되어 있는 것의 중으로부터 자동적으로 선택된 ImageReader 를 사용해, 지정된 URL 를 복호화 한 결과적으로,BufferedImage 를 돌려줍니다.
static void	scanForPlugins () 어플리케이션의 클래스 패스에 있는 플러그 인을 주사 해, 서비스 프로바이더 클래스를 로드해,IIORegistry 로 검출된 인스턴스 마다 서비스 프로바이더 인스턴스를 등록합니다.
static void	setCacheDirectory (File cacheDirectory) 캐쉬 파일이 작성되는 디렉토리를 설정합니다.
static void	setUseCache (boolean useCache) ImageInputStream 및 ImageOutputStream 의 작성시에, 디스크 베이스의 캐쉬 파일을 사용할 필요가 있을지 어떨지를 나타내는 플래그를 설정합니다.
static boolean	write (RenderedImage im, String formatName, File output) File 로 지정된 형식을 지원하는, 임의의 ImageWriter 를 사용해 이미지를 기입합니다.
static boolean	write (RenderedImage im, String formatName, ImageOutputStream output) ImageOutputStream 에, 지정된 형식을 지원하는 임의의 ImageWriter 를 사용해 이미지를 기입합니다.
static boolean	write (RenderedImage im, String formatName, OutputStream output) OutputStream 로 지정된 형식을 지원하는, 임의의 ImageWriter 를 사용해 이미지를 기입합니다.

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

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

메소드의 상세

scanForPlugins

public static void scanForPlugins()

어플리케이션의 클래스 패스에 있는 플러그 인을 주사 해, 서비스 프로바이더 클래스를 로드해,IIORegistry 로 검출된 인스턴스 마다 서비스 프로바이더 인스턴스를 등록합니다.

이 메소드가 필요한 것은, 어플리케이션의 클래스 패스를 이론상 변경할 수가 있어 추가의 플러그 인이 사용 가능하게 되기 (위해)때문에입니다. 클래스 패스는, API 가 호출할 것에 재주사 하는 것이 아니라, 최초의 호출만으로 자동적으로 주사 됩니다. 클라이언트는, 이 메소드를 호출해 재주사를 요구할 수 있습니다. 따라서, 이 메소드는, 실행시에 새로운 플러그 인을 동적으로 사용 가능하게 하는 고도의 어플리케이션에 의해서만 호출할 필요가 있습니다.

ClassLoader 문맥의 getResources 메소드는,META-INF/services/javax.imageio.spi. classname 라는 이름의 파일을 보관 유지하는 JAR 파일의 검색에 사용합니다. 여기서,classname 는, 어플리케이션의 클래스 패스에 따른 ImageReaderSpi,ImageWriterSpi,ImageTranscoderSpi,ImageInputStreamSpi, 또는 ImageOutputStreamSpi 의 어느쪽이든 1 개(살)입니다.

검색된 파일의 내용은, 상기의 서비스 프로바이더 인터페이스를 구현하는 실제의 구현 클래스의 이름을 나타냅니다. 디폴트의 클래스 로더가, 이러한 각 클래스를 로드해, 각 클래스의 인스턴스를 인스턴스화하기 위해서(때문에) 사용되어 나중에 취득할 수 있도록(듯이) 레지스트리에 배치됩니다.

검색되는 정확한 위치세트는 Java 실행시 환경의 구현에 의존합니다.

관련 항목:

ClassLoader.getResources(java.lang.String)

setUseCache

public static void setUseCache(boolean useCache)

ImageInputStream 및 ImageOutputStream 의 작성시에, 디스크 베이스의 캐쉬 파일을 사용할 필요가 있을지 어떨지를 나타내는 플래그를 설정합니다.

표준 InputStream 로부터 읽어내는 경우, 배후에 있는 스트림은 데이터를 재독 보고 포함 할 수 없기 때문에, 사전에 캐쉬에 읽어들여 정보를 보존할 필요가 있습니다. 같이 표준 OutputStream 에 기입을 실시하는 경우, 최종 송신지에 플래시 하기 전에, 사전에 기입해진 값을 변경하기 위해서 캐쉬를 사용합니다.

캐쉬는, 주기억 또는 디스크에 상주합니다. 이 플래그를 false 로 설정하면(자), 이것 이후의 스트림이 디스크를 사용하지 않게 할 수 있습니다. 이것에 의해, 파일의 작성과 폐기의 오버헤드가 제외해지기 (위해)때문에, 작은 이미지를 사용해 작업하는 경우에 도움이 됩니다.

기동시는, 값은 true 로 설정됩니다.

파라미터:

useCache - 옵션이 되고 있는 경우에, 캐쉬 파일을 사용할 수 있을지 어떨지를 나타내는 boolean

관련 항목:

getUseCache()

getUseCache

public static boolean getUseCache()

setUseCache 에 의해 설정된 현재의 값, 또는 명시적으로 설정을 하지 않은 경우는 true 를 돌려줍니다.

반환값:

ImageInputStream 및 ImageOutputStream 에 대해서, 디스크 베이스의 캐쉬를 사용할 수 있는 경우는 true

관련 항목:

setUseCache(boolean)

setCacheDirectory

public static void setCacheDirectory(File  cacheDirectory)

캐쉬 파일이 작성되는 디렉토리를 설정합니다. 값 null 는, 시스템에 의존하는 디폴트의 임시 파일 디렉토리가 사용되는 것을 나타냅니다. getUseCache 가 false 를 돌려주는 경우, 이 값은 무시됩니다.

파라미터:

cacheDirectory - 디렉토리를 지정하는 File

예외:

SecurityException - 시큐리티 매니저가 디렉토리에의 액세스를 거부하는 경우

IllegalArgumentException - cacheDir 가 null 이외이지만, 디렉토리가 아닌 경우

관련 항목:

File.createTempFile(String, String, File) , getCacheDirectory()

getCacheDirectory

public static File  getCacheDirectory()

setCacheDirectory 에 의해 설정된 현재의 값, 또는 명시적으로 설정을 하지 않은 경우는 null 를 돌려줍니다.

반환값:

캐쉬 파일이 작성되는 디렉토리를 나타내는 File, 또는 시스템에 의존하는 디폴트의 임시 파일 디렉토리를 나타내는 null

관련 항목:

setCacheDirectory(java.io.File)

createImageInputStream

public static ImageInputStream  createImageInputStream(Object  input)
                                               throws IOException 

지정된 Object 로부터 입력을 취득하는 ImageInputStream 를 돌려줍니다. IIORegistry 클래스에서 등록된 ImageInputStreamSpi 세트가 조회되어 지정된 객체로부터 입력을 취득할 수 있는 최초의 스트림을 사용해, 반환되는 ImageInputStream 가 작성됩니다. 적절한 ImageInputStreamSpi 가 존재하지 않는 경우,null 가 돌려주어집니다.

getUseCache 및 getCacheDirectory 로부터의 현재의 캐쉬의 설정은, 캐쉬의 제어에 사용합니다.

파라미터:

input - File, 읽어들여 가능한 RandomAccessFile, InputStream 등을 입력 소스로서 사용하는 Object

반환값:

ImageInputStream 또는 null

예외:

IllegalArgumentException - input 가 null 의 경우

IOException - 캐쉬 파일이 필요하지만 작성할 수 없는 경우

관련 항목:

ImageInputStreamSpi

createImageOutputStream

public static ImageOutputStream  createImageOutputStream(Object  output)
                                                 throws IOException 

지정된 Object 에 출력을 송신하는 ImageOutputStream 를 돌려줍니다. IIORegistry 클래스에서 등록된 ImageOutputStreamSpi 세트가 조회되어 지정된 객체로부터 출력을 송신할 수 있는 최초의 스트림을 사용해, 반환되는 ImageOutputStream 가 작성됩니다. 적절한 ImageOutputStreamSpi 가 존재하지 않는 경우,null 가 돌려주어집니다.

getUseCache 및 getCacheDirectory 로부터의 현재의 캐쉬의 설정은, 캐쉬의 제어에 사용합니다.

파라미터:

output - File, 기입해 가능한 RandomAccessFile, OutputStream 등, 출력처로서 사용하는 Object

반환값:

ImageOutputStream 또는 null

예외:

IllegalArgumentException - output 가 null 의 경우

IOException - 캐쉬 파일이 필요하지만 작성할 수 없는 경우

관련 항목:

ImageOutputStreamSpi

getReaderFormatNames

public static String [] getReaderFormatNames()

현재 등록되어 있는 일련의 리더에 의해 인식되는, 모든 비공식인 형식의 이름을 리스트 하는 String 의 배열을 돌려줍니다.

반환값:

String 의 배열

getReaderMIMETypes

public static String [] getReaderMIMETypes()

현재 등록되어 있는 일련의 리더에 의해 인식되는, 모든 MIME 타입을 리스트 하는 String 의 배열을 돌려줍니다.

반환값:

String 의 배열

getReaderFileSuffixes

public static String [] getReaderFileSuffixes()

현재 등록되어 있는 일련의 리더에 의해 인식되는 형식에 관련지을 수 있던 모든 파일접미사(suffix)을 리스트 하는 String 의 배열을 돌려줍니다.

반환값:

String 의 배열

도입된 버젼:

1.6

getImageReaders

public static Iterator <ImageReader > getImageReaders(Object  input)

지정된 Object, 일반적으로은 ImageInputStream 를 복호화 할 수 있는 것 같은, 현재 등록되어 모든 ImageReader 를 보관 유지하는 Iterator 를 돌려줍니다.

스트림의 위치는, 메소드의 종료시에 그 전의 위치에 남습니다.

파라미터:

input - ImageInputStream 또는 encode 된 이미지 데이터를 보관 유지하는 것 외의 Object

반환값:

ImageReader 를 보관 유지하는 Iterator

예외:

IllegalArgumentException - input 가 null 의 경우

관련 항목:

ImageReaderSpi.canDecodeInput(java.lang.Object)

getImageReadersByFormatName

public static Iterator <ImageReader > getImageReadersByFormatName(String  formatName)

이름 첨부의 형식을 복호화 할 수 있는 것 같은, 현재 등록되어 모든 ImageReader 를 보관 유지하는 Iterator 를 돌려줍니다.

파라미터:

formatName - 「jpeg」또는 「tiff」등의 비공식인 형식의 이름을 보관 유지하는 String

반환값:

ImageReader 를 보관 유지한다 Iterator

예외:

IllegalArgumentException - formatName 가 null 의 경우

관련 항목:

ImageReaderWriterSpi.getFormatNames()

getImageReadersBySuffix

public static Iterator <ImageReader > getImageReadersBySuffix(String  fileSuffix)

지정된 접미사(suffix)을 가지는 파일을 복호화 할 수 있는 것 같은, 현재 등록되어 모든 ImageReader 를 보관 유지하는 Iterator 를 돌려줍니다.

파라미터:

fileSuffix - 「jpg」또는 「tiff」등의 파일접미사(suffix)을 보관 유지하는 String

반환값:

ImageReader 를 보관 유지한다 Iterator

예외:

IllegalArgumentException - fileSuffix 가 null 의 경우

관련 항목:

ImageReaderWriterSpi.getFileSuffixes()

getImageReadersByMIMEType

public static Iterator <ImageReader > getImageReadersByMIMEType(String  MIMEType)

지정된 MIME 타입을 가지는 파일을 복호화 할 수 있는 것 같은, 현재 등록되어 모든 ImageReader 를 보관 유지하는 Iterator 를 돌려줍니다.

파라미터:

MIMEType - 「image/jpeg」또는 「image/x-bmp」등의 파일접미사(suffix)을 보관 유지하는 String

반환값:

ImageReader 를 보관 유지한다 Iterator

예외:

IllegalArgumentException - MIMEType 가 null 의 경우

관련 항목:

ImageReaderWriterSpi.getMIMETypes()

getWriterFormatNames

public static String [] getWriterFormatNames()

현재 등록되어 있는 일련의 라이터에 의해 인식되는, 모든 비공식인 형식의 이름을 리스트 하는 String 의 배열을 돌려줍니다.

반환값:

String 의 배열

getWriterMIMETypes

public static String [] getWriterMIMETypes()

현재 등록되어 있는 일련의 라이터에 의해 인식되는, 모든 MIME 타입을 리스트 하는 String 의 배열을 돌려줍니다.

반환값:

String 의 배열

getWriterFileSuffixes

public static String [] getWriterFileSuffixes()

현재 등록되어 있는 일련의 라이터에 의해 인식되는 형식에 관련지을 수 있던 모든 파일접미사(suffix)을 리스트 하는 String 의 배열을 돌려줍니다.

반환값:

String 의 배열

도입된 버젼:

1.6

getImageWritersByFormatName

public static Iterator <ImageWriter > getImageWritersByFormatName(String  formatName)

이름 첨부의 형식을 encode 할 수 있는 것 같은, 현재 등록되어 모든 ImageWriter 를 보관 유지하는 Iterator 를 돌려줍니다.

파라미터:

formatName - 「jpeg」또는 「tiff」등의 비공식인 형식의 이름을 보관 유지하는 String

반환값:

ImageWriter 를 보관 유지한다 Iterator

예외:

IllegalArgumentException - formatName 가 null 의 경우

관련 항목:

ImageReaderWriterSpi.getFormatNames()

getImageWritersBySuffix

public static Iterator <ImageWriter > getImageWritersBySuffix(String  fileSuffix)

지정된 접미사(suffix)을 가지는 파일을 encode 할 수 있는 것 같은, 현재 등록되어 모든 ImageWriter 를 보관 유지하는 Iterator 를 돌려줍니다.

파라미터:

fileSuffix - 「jpg」또는 「tiff」등의 파일접미사(suffix)을 보관 유지하는 String

반환값:

ImageWriter 를 보관 유지하는 Iterator

예외:

IllegalArgumentException - fileSuffix 가 null 의 경우

관련 항목:

ImageReaderWriterSpi.getFileSuffixes()

getImageWritersByMIMEType

public static Iterator <ImageWriter > getImageWritersByMIMEType(String  MIMEType)

지정된 MIME 타입을 가지는 파일을 encode 할 수 있는 것 같은, 현재 등록되어 모든 ImageWriter 를 보관 유지하는 Iterator 를 돌려줍니다.

파라미터:

MIMEType - 「image/jpeg」또는 「image/x-bmp」등의 파일접미사(suffix)을 보관 유지하는 String

반환값:

ImageWriter 를 보관 유지하는 Iterator

예외:

IllegalArgumentException - MIMEType 가 null 의 경우

관련 항목:

ImageReaderWriterSpi.getMIMETypes()

getImageWriter

public static ImageWriter  getImageWriter(ImageReader  reader)

지정된 ImageReader 에 대응하는 ImageWriter (존재하는 경우)를 돌려줍니다. 또는, 이 ImageReader 의 플러그 인이 대응하는 ImageWriter 를 지정하지 않는 경우, 혹은 지정된 ImageReader 가 등록되지 않은 경우는 null 를 돌려줍니다. 이 기구는,ImageReader 로 생성된 (IIOMetadata 객체에 의해 encode 된 것 같은) 픽셀 이외의 메타데이타의 내부 구조를 인식하는 ImageWriter 를 취득하기 위해서 사용됩니다. 이 데이터를 ImageReader 로부터 취득해, 이 메소드로 취득된 ImageWriter 에 건네주는 것으로, 클라이언트 프로그램은, 메타데이타의 구조나 이미지 형식을 인식하지 않아도, 모든 메타데이타를 보관 유지한 채로, 이미지를 읽어들여, 그것을 어떠한 방법으로 변경해, 써낼 수가 있습니다. 이 메소드는,javax.imageio.spi.ImageReaderSpi.getImageWriterSpiNames() 에 의해 반환된 리스트의 최초로 있는 「우선 설정」라이터를 돌려주는 것에 주의해 주세요.

파라미터:

reader - 등록된 ImageReader 의 인스턴스

반환값:

ImageWriter 또는 null

예외:

IllegalArgumentException - reader 가 null 의 경우

관련 항목:

getImageReader(ImageWriter) , ImageReaderSpi.getImageWriterSpiNames()

getImageReader

public static ImageReader  getImageReader(ImageWriter  writer)

지정된 ImageWriter 에 대응하는 ImageReader (존재하는 경우)를 돌려줍니다. 또는, 이 ImageWriter 의 플러그 인이 대응하는 ImageReader 를 지정하지 않는 경우, 혹은 지정된 ImageWriter 가 등록되지 않은 경우는 null 를 돌려줍니다. 이 메소드는, 주로 getImageWriter(ImageReader) 와 대칭이 되도록(듯이) 제공됩니다. 이 메소드는, javax.imageio.spi.ImageWriterSpi. getImageReaderSpiNames() 에 의해 반환된 리스트의 최초로 있는 「우선 설정」리더를 돌려주는 것에 주의해 주세요.

파라미터:

writer - 등록된 ImageWriter 의 인스턴스

반환값:

ImageReader 또는 null

예외:

IllegalArgumentException - writer 가 null 의 경우

관련 항목:

getImageWriter(ImageReader) , ImageWriterSpi.getImageReaderSpiNames()

getImageWriters

public static Iterator <ImageWriter > getImageWriters(ImageTypeSpecifier  type,
                                                    String  formatName)

지정된 형식에서, 지정된 레이아웃 (ImageTypeSpecifier 를 사용해 지정되었다)의 이미지를 encode 할 수 있는 것 같은, 현재 등록되어 모든 ImageWriter 를 보관 유지하는 Iterator 를 돌려줍니다.

파라미터:

type - 기입해진 이미지의 레이아웃을 나타낸다 ImageTypeSpecifier

formatName - format 의 비공식인 이름

반환값:

ImageWriter 를 보관 유지하는 Iterator

예외:

IllegalArgumentException - 임의의 파라미터가 null 의 경우

관련 항목:

ImageWriterSpi.canEncodeImage(ImageTypeSpecifier)

getImageTranscoders

public static Iterator <ImageTranscoder > getImageTranscoders(ImageReader  reader,
                                                            ImageWriter  writer)

지정된 ImageReader 및 ImageWriter 의 메타데이타간을 변환할 수 있는 것 같은, 현재 등록되어 모든 ImageTranscoder 를 보관 유지하는 Iterator 를 돌려줍니다.

파라미터:

reader - ImageReader

writer - ImageWriter

반환값:

ImageTranscoder 를 보관 유지한다 Iterator

예외:

IllegalArgumentException - reader 또는 writer 가 null 의 경우

read

public static BufferedImage  read(File  input)
                          throws IOException 

현재 등록되어 있는 것의 중으로부터 자동적으로 선택된 ImageReader 를 사용해, 지정된 File 를 복호화 한 결과적으로,BufferedImage 를 돌려줍니다. File 는 ImageInputStream 에 랩 됩니다. 결과의 스트림을 읽어들일 수 있는 것 같은 ImageReader 가 등록되지 않은 경우는,null 가 돌려주어집니다.

getUseCache 및 getCacheDirectory 로부터의 현재의 캐쉬의 설정은, 작성된 ImageInputStream 의 캐쉬의 제어에 사용합니다.

파일명으로서 String 를 취하는 read 메소드는 존재하지 않는 것에 주의해 주세요. 대신에, 파일명으로부터 File 를 작성한 뒤에 이 메소드를 사용합니다.

이 메소드는,File 로부터 직접 읽어낼 수 있는 ImageReader 를 검색하지 않습니다. 이 경우는,IIORegistry 와 ImageReaderSpi 를 사용합니다.

파라미터:

input - read원의 File

반환값:

복호화 된 입력 내용을 보관 유지하는 BufferedImage 또는 null

예외:

IllegalArgumentException - input 가 null 의 경우

IOException - read중에 에러가 발생했을 경우

read

public static BufferedImage  read(InputStream  input)
                          throws IOException 

현재 등록되어 있는 것의 중으로부터 자동적으로 선택된 ImageReader 를 사용해, 지정된 InputStream 를 복호화 한 결과적으로,BufferedImage 를 돌려줍니다. InputStream 는 ImageInputStream 에 랩 됩니다. 결과의 스트림을 읽어들일 수 있는 것 같은 ImageReader 가 등록되지 않은 경우는,null 가 돌려주어집니다.

getUseCache 및 getCacheDirectory 로부터의 현재의 캐쉬의 설정은, 작성된 ImageInputStream 의 캐쉬의 제어에 사용합니다.

이 메소드는,InputStream 로부터 직접 읽어낼 수 있는 ImageReader 를 검색하지 않습니다. 이 경우는,IIORegistry 와 ImageReaderSpi 를 사용합니다.

이 메소드는, read 오퍼레이션의 완료 후, 제공된 InputStream 를 닫지 않습니다. 스트림을 필요에 따라서 닫는 것은, 호출측의 역할입니다.

파라미터:

input - read원의 InputStream

반환값:

복호화 된 입력 내용을 보관 유지하는 BufferedImage 또는 null

예외:

IllegalArgumentException - input 가 null 의 경우

IOException - read중에 에러가 발생했을 경우

read

public static BufferedImage  read(URL  input)
                          throws IOException 

현재 등록되어 있는 것의 중으로부터 자동적으로 선택된 ImageReader 를 사용해, 지정된 URL 를 복호화 한 결과적으로,BufferedImage 를 돌려줍니다. InputStream 는 ImageInputStream 에 랩 된 URL 로부터 가져옵니다. 결과의 스트림을 읽어들일 수 있는 것 같은 ImageReader 가 등록되지 않은 경우는,null 가 돌려주어집니다.

getUseCache 및 getCacheDirectory 로부터의 현재의 캐쉬의 설정은, 작성된 ImageInputStream 의 캐쉬의 제어에 사용합니다.

이 메소드는,URL 로부터 직접 읽어낼 수 있는 ImageReader 를 검색하지 않습니다. 이 경우는,IIORegistry 와 ImageReaderSpi 를 사용합니다.

파라미터:

input - read원의 URL

반환값:

복호화 된 입력 내용을 보관 유지하는 BufferedImage 또는 null

예외:

IllegalArgumentException - input 가 null 의 경우

IOException - read중에 에러가 발생했을 경우

read

public static BufferedImage  read(ImageInputStream  stream)
                          throws IOException 

현재 등록되어 있는 것의 중으로부터 자동적으로 선택된 ImageReader 를 사용해, 지정된 ImageInputStream 를 복호화 한 결과적으로,BufferedImage 를 돌려줍니다. 스트림을 읽어들일 수 있는 것 같은 ImageReader 가 등록되지 않은 경우는,null 가 돌려주어집니다.

이 클래스외의 대부분의 메소드와는 달라, 이 메소드는,null 가 돌려주어지지 않은 한, read 오퍼레이션의 완료 후에 제공된 ImageInputStream 를 닫습니다. null 가 돌려주어졌을 경우, 이 메소드는 스트림을 닫지 않습니다.

파라미터:

stream - read원의 ImageInputStream

반환값:

복호화 된 입력 내용을 보관 유지하는 BufferedImage 또는 null

예외:

IllegalArgumentException - stream 가 null 의 경우

IOException - read중에 에러가 발생했을 경우

write

public static boolean write(RenderedImage  im,
                            String  formatName,
                            ImageOutputStream  output)
                     throws IOException 

ImageOutputStream 에, 지정된 형식을 지원하는 임의의 ImageWriter 를 사용해 이미지를 기입합니다. 이미지는, 현재의 스트림 포인터로 시작되는 ImageOutputStream 에 기입해져 그 포인트로부터 전에 있는 기존의 스트림 데이터 (존재하는 경우)를 덧쓰기합니다.

이 메소드는, 기입 오퍼레이션의 완료 후, 제공된 ImageOutputStream 를 닫지 않습니다. 스트림을 필요에 따라서 닫는 것은, 호출측의 역할입니다.

파라미터:

im - 기입해지는 RenderedImage

formatName - 비공식인 형식의 이름을 보관 유지하는 String

output - 기입해지는 ImageOutputStream

반환값:

적절한 라이터가 발견되지 않는 경우는 false

예외:

IllegalArgumentException - 임의의 파라미터가 null 의 경우

IOException - 기입중에 에러가 발생했을 경우

write

public static boolean write(RenderedImage  im,
                            String  formatName,
                            File  output)
                     throws IOException 

File 로 지정된 형식을 지원하는, 임의의 ImageWriter 를 사용해 이미지를 기입합니다. 벌써 File 가 존재하는 경우, 그 내용은 파기됩니다.

파라미터:

im - 기입해지는 RenderedImage

formatName - 비공식인 형식의 이름을 보관 유지하는 String

output - 기입해지는 File

반환값:

적절한 라이터가 발견되지 않는 경우는 false

예외:

IllegalArgumentException - 임의의 파라미터가 null 의 경우

IOException - 기입중에 에러가 발생했을 경우

write

public static boolean write(RenderedImage  im,
                            String  formatName,
                            OutputStream  output)
                     throws IOException 

OutputStream 로 지정된 형식을 지원하는, 임의의 ImageWriter 를 사용해 이미지를 기입합니다.

이 메소드는, 기입 오퍼레이션의 완료 후, 제공된 OutputStream 를 닫지 않습니다. 스트림을 필요에 따라서 닫는 것은, 호출측의 역할입니다.

getUseCache 및 getCacheDirectory 로부터의 현재의 캐쉬의 설정은, 캐쉬의 제어에 사용합니다.

파라미터:

im - 기입해지는 RenderedImage

formatName - 비공식인 형식의 이름을 보관 유지하는 String

output - 기입해지는 OutputStream

반환값:

적절한 라이터가 발견되지 않는 경우는 false

예외:

IllegalArgumentException - 임의의 파라미터가 null 의 경우

IOException - 기입중에 에러가 발생했을 경우