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) 지정된 접미말을 가지는 파일을 복호화 할 수 있는 것 같은 현재 등록되어 모든 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) 지정된 접미말을 가지는 파일을 encode 할 수 있는 것 같은 현재 등록되어 모든 ImageWriter를 보관 유지하는 Iterator를 리턴합니다.
static String []	getReaderFormatNames () 현재 등록되어 있는 일련의 리더에 의해 이해되는 모든 비공식인 형식의 이름을 리스트 하는 String 배열을 리턴합니다.
static String []	getReaderMIMETypes () 현재 등록되어 있는 일련의 리더에 의해 이해되는 모든 MIME 타입을 리스트 하는 String 배열을 리턴합니다.
static boolean	getUseCache () setUseCache에 의해 설정된 현재의 값, 또는 명시적으로 설정을 하지 않은 경우는 true를 리턴합니다.
static String []	getWriterFormatNames () 현재 등록되어 있는 일련의 Writer에 의해 이해되는 모든 비공식인 형식의 이름을 리스트 하는 String 배열을 리턴합니다.
static String []	getWriterMIMETypes () 현재 등록되어 있는 일련의 Writer에 의해 이해되는 모든 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에 write를 실시하는 경우, 최종 송신지에 플래시 하기 전에 사전에 출력해진 값을 변경하기 위해서 캐쉬를 사용합니다.

캐쉬는 주기억 또는 디스크에 상주합니다. 이 플래그를 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 배열

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)

지정된 접미말을 가지는 파일을 복호화 할 수 있는 것 같은 현재 등록되어 모든 ImageReader를 보관 유지하는 Iterator를 리턴합니다.

파라미터:

fileSuffix - 「jpg」또는 「tiff」등의 파일접미말을 보관 유지하는 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」등의 파일접미말을 보관 유지하는 String

반환값:

ImageReader를 보관 유지하는 Iterator

예외:

IllegalArgumentException - MIMEType가 null인 경우

관련 항목:

ImageReaderWriterSpi.getMIMETypes()

getWriterFormatNames

public static String [] getWriterFormatNames()

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

반환값:

String 배열

getWriterMIMETypes

public static String [] getWriterMIMETypes()

현재 등록되어 있는 일련의 Writer에 의해 이해되는 모든 MIME 타입을 리스트 하는 String 배열을 리턴합니다.

반환값:

String 배열

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)

지정된 접미말을 가지는 파일을 encode 할 수 있는 것 같은 현재 등록되어 모든 ImageWriter를 보관 유지하는 Iterator를 리턴합니다.

파라미터:

fileSuffix - 「jpg」또는 「tiff」등의 파일접미말을 보관 유지하는 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」등의 파일접미말을 보관 유지하는 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가 결과의 스트림을 read 할 수 없는 것 같은 경우, null이 리턴됩니다 .

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

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

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

파라미터:

input - 읽을 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를 사용합니다.

파라미터:

input - 읽을 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 - 읽을 URL

반환값:

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

예외:

IllegalArgumentException - input이 null인 경우

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

read

public static BufferedImage  read(ImageInputStream  stream)
                          throws IOException 

현재 등록되어 있는 것의 중으로부터 자동적으로 선택된 ImageReader를 사용해, 지정된 ImageInputStream를 복호화 한 결과적으로BufferedImage를 리턴합니다. 등록된 ImageReader가 스트림을 읽어낼 수 없는 것 같은 경우, null이 리턴됩니다 .

파라미터:

stream - 읽을 ImageInputStream

반환값:

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

예외:

IllegalArgumentException - stream가 null인 경우

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

write

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

ImageOutputStream에 지정된 형식을 지원하는 임의의 ImageWriter를 사용해 이미지를 출력합니다. 이미지는 현재의 스트림 포인터로 시작되는 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를 사용해 이미지를 출력합니다.

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

파라미터:

im - 출력해지는 RenderedImage

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

output - 출력해지는 OutputStream

반환값:

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

예외:

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

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