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