Spec-Zone .ru
спецификации, руководства, описания, API
|
public final class ImageIO extends Object
ImageReader
s и ImageWriter
s, и выполнение простого кодирования и декодирование.Модификатор и Тип | Метод и Описание |
---|---|
static ImageInputStream |
createImageInputStream(Object input)
Возвраты
ImageInputStream это возьмет его ввод от данного Object . |
static ImageOutputStream |
createImageOutputStream(Object output)
Возвраты
ImageOutputStream это отправит его вывод данному Object . |
static File |
getCacheDirectory()
Возвращает текущую стоимость, установленную
setCacheDirectory , или null если никакая явная установка не была сделана. |
static ImageReader |
getImageReader(ImageWriter writer)
Возвраты
ImageReader соответствие данному ImageWriter , если есть один, или null если плагин для этого ImageWriter не определяет соответствие ImageReader , или если данный ImageWriter не регистрируется. |
static Iterator<ImageReader> |
getImageReaders(Object input)
Возвраты
Iterator содержа все в настоящий момент зарегистрировался ImageReader s, что требование быть в состоянии декодировать предоставленный Object , обычно ImageInputStream . |
static Iterator<ImageReader> |
getImageReadersByFormatName(String formatName)
Возвраты
Iterator содержа все в настоящий момент зарегистрировался ImageReader s, что требование быть в состоянии декодировать именованный формат. |
static Iterator<ImageReader> |
getImageReadersByMIMEType(String MIMEType)
Возвраты
Iterator содержа все в настоящий момент зарегистрировался ImageReader s, что требование быть в состоянии декодировать файлы с данным типом MIME. |
static Iterator<ImageReader> |
getImageReadersBySuffix(String fileSuffix)
Возвраты
Iterator содержа все в настоящий момент зарегистрировался ImageReader s, что требование быть в состоянии декодировать файлы с данным суффиксом. |
static Iterator<ImageTranscoder> |
getImageTranscoders(ImageReader reader, ImageWriter writer)
Возвраты
Iterator содержа все в настоящий момент зарегистрировался ImageTranscoder s, что требование быть в состоянии транскодировать между метаданными данного ImageReader и ImageWriter . |
static ImageWriter |
getImageWriter(ImageReader reader)
Возвраты
ImageWriter соответствие данному ImageReader , если есть один, или null если плагин для этого ImageReader не определяет соответствие ImageWriter , или если данный ImageReader не регистрируется. |
static Iterator<ImageWriter> |
getImageWriters(ImageTypeSpecifier type, String formatName)
Возвраты
Iterator содержа все в настоящий момент зарегистрировался ImageWriter s, что требование быть в состоянии закодировать изображения данного расположения (определенное использование ImageTypeSpecifier ) в данном формате. |
static Iterator<ImageWriter> |
getImageWritersByFormatName(String formatName)
Возвраты
Iterator содержа все в настоящий момент зарегистрировался ImageWriter s, что требование быть в состоянии закодировать именованный формат. |
static Iterator<ImageWriter> |
getImageWritersByMIMEType(String MIMEType)
Возвраты
Iterator содержа все в настоящий момент зарегистрировался ImageWriter s, что требование быть в состоянии закодировать файлы с данным типом MIME. |
static Iterator<ImageWriter> |
getImageWritersBySuffix(String fileSuffix)
Возвраты
Iterator содержа все в настоящий момент зарегистрировался ImageWriter s, что требование быть в состоянии закодировать файлы с данным суффиксом. |
static String[] |
getReaderFileSuffixes()
Возвращает массив
String s перечисляющий все суффиксы файла, связанные с форматами, понял текущей группой зарегистрированных читателей. |
static String[] |
getReaderFormatNames()
Возвращает массив
String s перечисляющий все неофициальные имена формата понял текущей группой зарегистрированных читателей. |
static String[] |
getReaderMIMETypes()
Возвращает массив
String s перечисляющий все типы MIME понял текущей группой зарегистрированных читателей. |
static boolean |
getUseCache()
Возвращает текущую стоимость, установленную
setUseCache , или true если никакая явная установка не была сделана. |
static String[] |
getWriterFileSuffixes()
Возвращает массив
String s перечисляющий все суффиксы файла, связанные с форматами, понял текущей группой зарегистрированных писателей. |
static String[] |
getWriterFormatNames()
Возвращает массив
String s перечисляющий все неофициальные имена формата понял текущей группой зарегистрированных писателей. |
static String[] |
getWriterMIMETypes()
Возвращает массив
String s перечисляющий все типы MIME понял текущей группой зарегистрированных писателей. |
static BufferedImage |
read(File input)
Возвраты a
BufferedImage как результат декодирования предоставленного File с ImageReader выбранный автоматически из числа в настоящий момент зарегистрированных. |
static BufferedImage |
read(ImageInputStream stream)
Возвраты a
BufferedImage как результат декодирования предоставленного ImageInputStream с ImageReader выбранный автоматически из числа в настоящий момент зарегистрированных. |
static BufferedImage |
read(InputStream input)
Возвраты a
BufferedImage как результат декодирования предоставленного InputStream с ImageReader выбранный автоматически из числа в настоящий момент зарегистрированных. |
static BufferedImage |
read(URL input)
Возвраты a
BufferedImage как результат декодирования предоставленного URL с ImageReader выбранный автоматически из числа в настоящий момент зарегистрированных. |
static void |
scanForPlugins()
Сканирования для плагинов на пути класса приложений, загружает их классы поставщика услуг, и регистрирует экземпляр поставщика услуг для каждого найденного с
IIORegistry . |
static void |
setCacheDirectory(File cacheDirectory)
Устанавливает каталог, где файлы кэша должны быть созданы.
|
static void |
setUseCache(boolean useCache)
Устанавливает флаг, указывающий, должен ли находящийся на диске файл кэша использоваться, создавая
ImageInputStream s и ImageOutputStream s. |
static boolean |
write(RenderedImage im, String formatName, File output)
Пишет изображение, используя произвольное
ImageWriter это поддерживает данный формат к a File . |
static boolean |
write(RenderedImage im, String formatName, ImageOutputStream output)
Пишет изображение, используя произвольное
ImageWriter это поддерживает данный формат к ImageOutputStream . |
static boolean |
write(RenderedImage im, String formatName, OutputStream output)
Пишет изображение, используя произвольное
ImageWriter это поддерживает данный формат к OutputStream . |
public static void scanForPlugins()
IIORegistry
. Этот метод необходим, потому что путь класса приложений может теоретически измениться, или дополнительные плагины могут стать доступными. Вместо того, чтобы повторно сканировать путь к классу на каждом вызове API, путь к классу сканируется автоматически только на первом вызове. Клиенты могут вызвать этот метод, чтобы запросить пересканирование. Таким образом этот метод должен только быть вызванным сложными приложениями, которые динамически делают новые плагины доступными во время выполнения.
getResources
метод контекста ClassLoader
используется определяют местоположение файлов JAR, содержащих названные файлы META-INF/services/javax.imageio.spi.
имя класса, где имя класса является одним из ImageReaderSpi
, ImageWriterSpi
, ImageTranscoderSpi
, ImageInputStreamSpi
, или ImageOutputStreamSpi
, вдоль пути класса приложений.
Содержание расположенных файлов указывает на имена фактических классов реализации, которые реализуют вышеупомянутые интерфейсы поставщика услуг; загрузчик класса по умолчанию тогда используется, чтобы загрузить каждый из этих классов и инстанцировать экземпляра каждого класса, который тогда помещается в реестр для более позднего извлечения.
Точный набор искавших расположений зависит от реализации Среды выполнения Java enviroment.
public static void setUseCache(boolean useCache)
ImageInputStream
s и ImageOutputStream
s. Читая из стандарта InputStream
>, может быть необходимо сохранить ранее информацию о чтении в кэше, так как базовый поток не позволяет данным быть перечитанными. Точно так же при записи в стандарт OutputStream
, кэш может использоваться, чтобы позволить ранее записанному значению быть измененным прежде, чем сбросить это конечному месту назначения.
Кэш может находиться в основной памяти или на диске. Установка этого флага к false
отвергает использование диска для будущих потоков, которые могут быть выгодными, работая с маленькими изображениями, поскольку издержки создания и уничтожения файлов удаляются.
На запуске значение устанавливается в true
.
useCache
- a boolean
указание, должен ли файл кэша использоваться в случаях, где это является дополнительным.getUseCache()
public static boolean getUseCache()
setUseCache
, или true
если никакая явная установка не была сделана.ImageInputStream
s и ImageOutputStream
s.setUseCache(boolean)
public static void setCacheDirectory(File cacheDirectory)
null
указывает, что системно-зависимый каталог временного файла по умолчанию должен использоваться. Если getUseCache
возвращает false, это значение игнорируется.cacheDirectory
- a File
определение каталога.SecurityException
- если менеджер безопасности лишает доступа к каталогу.IllegalArgumentException
- если cacheDir
не -null
но не каталог.File.createTempFile(String, String, File)
, getCacheDirectory()
public static File getCacheDirectory()
setCacheDirectory
, или null
если никакая явная установка не была сделана.File
указание на каталог, где файлы кэша будут создаваться, или null
указать на системно-зависимый каталог временного файла по умолчанию.setCacheDirectory(java.io.File)
public static ImageInputStream createImageInputStream(Object input) throws IOException
ImageInputStream
это возьмет его ввод от данного Object
. Набор ImageInputStreamSpi
s зарегистрированный в IIORegistry
класс запрашивается и первый, который в состоянии взять ввод от предоставленного объекта, используется, чтобы создать возвращенный ImageInputStream
. Если не подходящий ImageInputStreamSpi
существует, null
возвращается. Текущие параметры кэширования от getUseCache
и getCacheDirectory
будет использоваться, чтобы управлять кэшированием.
input
- Object
использоваться в качестве входного источника, такого как a File
, читаемый RandomAccessFile
, или InputStream
.ImageInputStream
, или null
.IllegalArgumentException
- если input
null
.IOException
- если файл кэша необходим, но не может быть создан.ImageInputStreamSpi
public static ImageOutputStream createImageOutputStream(Object output) throws IOException
ImageOutputStream
это отправит его вывод данному Object
. Набор ImageOutputStreamSpi
s зарегистрированный в IIORegistry
класс запрашивается и первый, который в состоянии передаться, вывод от предоставленного объекта используется, чтобы создать возвращенный ImageOutputStream
. Если не подходящий ImageOutputStreamSpi
существует, null
возвращается. Текущие параметры кэширования от getUseCache
и getCacheDirectory
будет использоваться, чтобы управлять кэшированием.
output
- Object
использоваться в качестве выходного места назначения, такого как a File
, перезаписываемый RandomAccessFile
, или OutputStream
.ImageOutputStream
, или null
.IllegalArgumentException
- если output
null
.IOException
- если файл кэша необходим, но не может быть создан.ImageOutputStreamSpi
public static String[] getReaderFormatNames()
String
s перечисляющий все неофициальные имена формата понял текущей группой зарегистрированных читателей.String
s.public static String[] getReaderMIMETypes()
String
s перечисляющий все типы MIME понял текущей группой зарегистрированных читателей.String
s.public static String[] getReaderFileSuffixes()
String
s перечисляющий все суффиксы файла, связанные с форматами, понял текущей группой зарегистрированных читателей.String
s.public static Iterator<ImageReader> getImageReaders(Object input)
Iterator
содержа все в настоящий момент зарегистрировался ImageReader
s, что требование быть в состоянии декодировать предоставленный Object
, обычно ImageInputStream
. Потоковую позицию оставляют в ее предшествующей позиции на выход от этого метода.
input
- ImageInputStream
или другой Object
содержа закодированные данные изображения.Iterator
содержа ImageReader
s.IllegalArgumentException
- если input
null
.ImageReaderSpi.canDecodeInput(java.lang.Object)
public static Iterator<ImageReader> getImageReadersByFormatName(String formatName)
Iterator
содержа все в настоящий момент зарегистрировался ImageReader
s, что требование быть в состоянии декодировать именованный формат.formatName
- a String
содержа неофициальное имя формата (например, "jpeg" или "размолвка".Iterator
содержа ImageReader
s.IllegalArgumentException
- если formatName
null
.ImageReaderWriterSpi.getFormatNames()
public static Iterator<ImageReader> getImageReadersBySuffix(String fileSuffix)
Iterator
содержа все в настоящий момент зарегистрировался ImageReader
s, что требование быть в состоянии декодировать файлы с данным суффиксом.fileSuffix
- a String
содержа суффикс файла (например, "jpg" или "размолвка").Iterator
содержа ImageReader
s.IllegalArgumentException
- если fileSuffix
null
.ImageReaderWriterSpi.getFileSuffixes()
public static Iterator<ImageReader> getImageReadersByMIMEType(String MIMEType)
Iterator
содержа все в настоящий момент зарегистрировался ImageReader
s, что требование быть в состоянии декодировать файлы с данным типом MIME.MIMEType
- a String
содержа суффикс файла (например, "image/jpeg" или "image/x-bmp").Iterator
содержа ImageReader
s.IllegalArgumentException
- если MIMEType
null
.ImageReaderWriterSpi.getMIMETypes()
public static String[] getWriterFormatNames()
String
s перечисляющий все неофициальные имена формата понял текущей группой зарегистрированных писателей.String
s.public static String[] getWriterMIMETypes()
String
s перечисляющий все типы MIME понял текущей группой зарегистрированных писателей.String
s.public static String[] getWriterFileSuffixes()
String
s перечисляющий все суффиксы файла, связанные с форматами, понял текущей группой зарегистрированных писателей.String
s.public static Iterator<ImageWriter> getImageWritersByFormatName(String formatName)
Iterator
содержа все в настоящий момент зарегистрировался ImageWriter
s, что требование быть в состоянии закодировать именованный формат.formatName
- a String
содержа неофициальное имя формата (например, "jpeg" или "размолвка".Iterator
содержа ImageWriter
s.IllegalArgumentException
- если formatName
null
.ImageReaderWriterSpi.getFormatNames()
public static Iterator<ImageWriter> getImageWritersBySuffix(String fileSuffix)
Iterator
содержа все в настоящий момент зарегистрировался ImageWriter
s, что требование быть в состоянии закодировать файлы с данным суффиксом.fileSuffix
- a String
содержа суффикс файла (например, "jpg" или "размолвка").Iterator
содержа ImageWriter
s.IllegalArgumentException
- если fileSuffix
null
.ImageReaderWriterSpi.getFileSuffixes()
public static Iterator<ImageWriter> getImageWritersByMIMEType(String MIMEType)
Iterator
содержа все в настоящий момент зарегистрировался ImageWriter
s, что требование быть в состоянии закодировать файлы с данным типом MIME.MIMEType
- a String
содержа суффикс файла (например, "image/jpeg" или "image/x-bmp").Iterator
содержа ImageWriter
s.IllegalArgumentException
- если MIMEType
null
.ImageReaderWriterSpi.getMIMETypes()
public static ImageWriter getImageWriter(ImageReader reader)
ImageWriter
соответствие данному ImageReader
, если есть один, или null
если плагин для этого ImageReader
не определяет соответствие ImageWriter
, или если данный ImageReader
не регистрируется. Этот механизм может использоваться, чтобы получить ImageWriter
это поймет внутреннюю структуру непиксельных метаданных (как кодирующийся IIOMetadata
объекты) сгенерированный ImageReader
. Получая эти данные из ImageReader
и передача этого к ImageWriter
полученный с этим методом, клиентская программа может считать изображение, изменить его в некотором роде, и записать его обратно сохраняющий все метаданные, не имея необходимость понимать что-либо о структуре метаданных, или даже о формате изображения. Отметьте, что этот метод возвращает "привилегированного" писателя, который является первым в списке, возвращенном javax.imageio.spi.ImageReaderSpi.getImageWriterSpiNames()
.reader
- экземпляр зарегистрированного ImageReader
.ImageWriter
, или нуль.IllegalArgumentException
- если reader
null
.getImageReader(ImageWriter)
, ImageReaderSpi.getImageWriterSpiNames()
public static ImageReader getImageReader(ImageWriter writer)
ImageReader
соответствие данному ImageWriter
, если есть один, или null
если плагин для этого ImageWriter
не определяет соответствие ImageReader
, или если данный ImageWriter
не регистрируется. Этот метод обеспечивается преимущественно для симметрии с getImageWriter(ImageReader)
. Отметьте, что этот метод возвращает "привилегированного" читателя, который является первым в списке, возвращенном javax.imageio.spi. ImageWriterSpi.getImageReaderSpiNames()
.writer
- экземпляр зарегистрированного ImageWriter
.ImageReader
, или нуль.IllegalArgumentException
- если writer
null
.getImageWriter(ImageReader)
, ImageWriterSpi.getImageReaderSpiNames()
public static Iterator<ImageWriter> getImageWriters(ImageTypeSpecifier type, String formatName)
Iterator
содержа все в настоящий момент зарегистрировался ImageWriter
s, что требование быть в состоянии закодировать изображения данного расположения (определенное использование ImageTypeSpecifier
) в данном формате.type
- ImageTypeSpecifier
указание на расположение изображения, которое будет записано.formatName
- неофициальное имя format
.Iterator
содержа ImageWriter
s.IllegalArgumentException
- если какой-либо параметр null
.ImageWriterSpi.canEncodeImage(ImageTypeSpecifier)
public static Iterator<ImageTranscoder> getImageTranscoders(ImageReader reader, ImageWriter writer)
Iterator
содержа все в настоящий момент зарегистрировался ImageTranscoder
s, что требование быть в состоянии транскодировать между метаданными данного ImageReader
и ImageWriter
.reader
- ImageReader
.writer
- ImageWriter
.Iterator
содержа ImageTranscoder
s.IllegalArgumentException
- если reader
или writer
null
.public static BufferedImage read(File input) throws IOException
BufferedImage
как результат декодирования предоставленного File
с ImageReader
выбранный автоматически из числа в настоящий момент зарегистрированных. File
обертывается в ImageInputStream
. Если не регистрирующийся ImageReader
требования быть в состоянии считать получающийся поток, null
возвращается. Текущие параметры кэширования от getUseCache
и getCacheDirectory
будет использоваться, чтобы управлять кэшированием в ImageInputStream
это создается.
Отметьте, что есть нет read
метод, который берет имя файла в качестве a String
; используйте этот метод вместо этого после создания a File
от имени файла.
Этот метод не пытается расположиться ImageReader
s, который может читать непосредственно из a File
; это может быть выполнено, используя IIORegistry
и ImageReaderSpi
.
input
- a File
читать из.BufferedImage
содержа декодируемое содержание ввода, или null
.IllegalArgumentException
- если input
null
.IOException
- если ошибка происходит во время чтения.public static BufferedImage read(InputStream input) throws IOException
BufferedImage
как результат декодирования предоставленного InputStream
с ImageReader
выбранный автоматически из числа в настоящий момент зарегистрированных. InputStream
обертывается в ImageInputStream
. Если не регистрирующийся ImageReader
требования быть в состоянии считать получающийся поток, null
возвращается. Текущие параметры кэширования от getUseCache
и getCacheDirectory
будет использоваться, чтобы управлять кэшированием в ImageInputStream
это создается.
Этот метод не пытается расположиться ImageReader
s, который может читать непосредственно из InputStream
; это может быть выполнено, используя IIORegistry
и ImageReaderSpi
.
Этот метод не закрывает обеспеченный InputStream
после того, как операция чтения завершилась; это - обязанность вызывающей стороны закрыть поток при желании.
input
- InputStream
читать из.BufferedImage
содержа декодируемое содержание ввода, или null
.IllegalArgumentException
- если input
null
.IOException
- если ошибка происходит во время чтения.public static BufferedImage read(URL input) throws IOException
BufferedImage
как результат декодирования предоставленного URL
с ImageReader
выбранный автоматически из числа в настоящий момент зарегистрированных. InputStream
получается из URL
, который обертывается в ImageInputStream
. Если не регистрирующийся ImageReader
требования быть в состоянии считать получающийся поток, null
возвращается. Текущие параметры кэширования от getUseCache
и getCacheDirectory
будет использоваться, чтобы управлять кэшированием в ImageInputStream
это создается.
Этот метод не пытается расположиться ImageReader
s, который может читать непосредственно из a URL
; это может быть выполнено, используя IIORegistry
и ImageReaderSpi
.
input
- a URL
читать из.BufferedImage
содержа декодируемое содержание ввода, или null
.IllegalArgumentException
- если input
null
.IOException
- если ошибка происходит во время чтения.public static BufferedImage read(ImageInputStream stream) throws IOException
BufferedImage
как результат декодирования предоставленного ImageInputStream
с ImageReader
выбранный автоматически из числа в настоящий момент зарегистрированных. Если не регистрирующийся ImageReader
требования быть в состоянии считать поток, null
возвращается. В отличие от большинства других методов в этом классе, этот метод действительно закрывает обеспеченный ImageInputStream
после того, как операция чтения не завершилась, если null
возвращается, когда этот метод не закрывает поток.
stream
- ImageInputStream
читать из.BufferedImage
содержа декодируемое содержание ввода, или null
.IllegalArgumentException
- если stream
null
.IOException
- если ошибка происходит во время чтения.public static boolean write(RenderedImage im, String formatName, ImageOutputStream output) throws IOException
ImageWriter
это поддерживает данный формат к ImageOutputStream
. Изображение пишется ImageOutputStream
запуск в текущем потоковом указателе, перезапись существующих потоковых данных от той точки вперед, если существующий. Этот метод не закрывает обеспеченный ImageOutputStream
после того, как операция записи завершилась; это - обязанность вызывающей стороны закрыть поток при желании.
im
- a RenderedImage
быть записанным.formatName
- a String
containg неофициальное имя формата.output
- ImageOutputStream
быть записанным.false
если никакой соответствующий писатель не находится.IllegalArgumentException
- если какой-либо параметр null
.IOException
- если ошибка происходит во время записи.public static boolean write(RenderedImage im, String formatName, File output) throws IOException
ImageWriter
это поддерживает данный формат к a File
. Если уже есть a File
подарок, его содержание отбрасывается.im
- a RenderedImage
быть записанным.formatName
- a String
containg неофициальное имя формата.output
- a File
быть записанным.false
если никакой соответствующий писатель не находится.IllegalArgumentException
- если какой-либо параметр null
.IOException
- если ошибка происходит во время записи.public static boolean write(RenderedImage im, String formatName, OutputStream output) throws IOException
ImageWriter
это поддерживает данный формат к OutputStream
. Этот метод не закрывает обеспеченный OutputStream
после того, как операция записи завершилась; это - обязанность вызывающей стороны закрыть поток при желании.
Текущие параметры кэширования от getUseCache
и getCacheDirectory
будет использоваться, чтобы управлять кэшированием.
im
- a RenderedImage
быть записанным.formatName
- a String
containg неофициальное имя формата.output
- OutputStream
быть записанным.false
если никакой соответствующий писатель не находится.IllegalArgumentException
- если какой-либо параметр null
.IOException
- если ошибка происходит во время записи.
Для дальнейшей ссылки API и документации разработчика, см.
Авторское право © 1993, 2011, Oracle и/или его филиалы. Все права защищены.