Class TIFFImageReadParam

javax.imageio.plugins.tiff.TIFFImageReadParam

public final class TIFFImageReadParam extends ImageReadParam

Подкласс ImageReadParam, позволяющий управлять процессом чтения TIFF.

Поскольку TIFF является расширяемым форматом, модулю чтения требуется информация о любых тегах, используемых расширениями TIFF, для формирования осмысленных метаданных. Кроме того, расширения TIFF могут определять новые типы сжатия. Оба типа информации о расширениях могут быть предоставлены через этот интерфейс.

Дополнительные теги TIFF должны быть организованы в TIFFTagSet. TIFFTagSet может быть передан модулю чтения с помощью метода addAllowedTagSet. По умолчанию включены наборы тегов BaselineTIFFTagSet, FaxTIFFTagSet, ExifParentTIFFTagSet и GeoTIFFTagSet.

Принудительное чтение полей, соответствующих TIFFTag, не входящим ни в один из разрешенных TIFFTagSet, может быть выполнено с помощью setReadUnknownTags.

Since:: 9

Краткое описание полей

Fields declared in class ImageReadParam

canSetSourceRenderSize, destination, destinationBands, minProgressivePass, numProgressivePasses, sourceRenderSize

Fields declared in class IIOParam

controller, defaultController, destinationOffset, destinationType, sourceBands, sourceRegion, sourceXSubsampling, sourceYSubsampling, subsamplingXOffset, subsamplingYOffset

Краткое описание конструкторов

Constructor	Description
`TIFFImageReadParam()`	Конструирует `TIFFImageReadParam`.

Краткое описание методов

Modifier and Type	Method	Description
`void`	`addAllowedTagSet(TIFFTagSet tagSet)`	Добавляет объект `TIFFTagSet` в список разрешенных наборов тегов.
`List<TIFFTagSet>`	`getAllowedTagSets()`	Возвращает `List`, содержащий разрешенные объекты `TIFFTagSet`.
`boolean`	`getReadUnknownTags()`	Получает значение параметра, определяющего, следует ли читать поля, соответствующие неизвестным `TIFFTag`.
`void`	`removeAllowedTagSet(TIFFTagSet tagSet)`	Удаляет объект `TIFFTagSet` из списка разрешенных наборов тегов.
`void`	`setReadUnknownTags(boolean readUnknownTags)`	Задает, следует ли читать поля, соответствующие `TIFFTag`, не входящим в разрешенные `TIFFTagSet`.

Methods declared in class ImageReadParam

canSetSourceRenderSize, getDestination, getDestinationBands, getSourceMaxProgressivePass, getSourceMinProgressivePass, getSourceNumProgressivePasses, getSourceRenderSize, setDestination, setDestinationBands, setSourceProgressivePasses, setSourceRenderSize

Methods declared in class IIOParam

activateController, getController, getDefaultController, getDestinationOffset, getDestinationType, getSourceBands, getSourceRegion, getSourceXSubsampling, getSourceYSubsampling, getSubsamplingXOffset, getSubsamplingYOffset, hasController, setController, setDestinationOffset, setDestinationType, setSourceBands, setSourceRegion, setSourceSubsampling

Methods declared in class Object

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

Подробное описание конструкторов

TIFFImageReadParam

public TIFFImageReadParam()

Конструирует TIFFImageReadParam. Теги, определенные наборами TIFFTagSet BaselineTIFFTagSet, FaxTIFFTagSet, ExifParentTIFFTagSet и GeoTIFFTagSet, будут поддерживаться.

See Also:

Подробное описание методов

addAllowedTagSet

public void addAllowedTagSet(TIFFTagSet tagSet)

Добавляет объект TIFFTagSet в список разрешенных наборов тегов. Попытка добавить дублирующийся объект в список не имеет никакого эффекта.

Parameters:: tagSet - объект TIFFTagSet.
Throws:: IllegalArgumentException - если tagSet равен null.

removeAllowedTagSet

public void removeAllowedTagSet(TIFFTagSet tagSet)

Удаляет объект TIFFTagSet из списка разрешенных наборов тегов. Удаление основано на методе equals объекта TIFFTagSet, который обычно определяется как равенство по ссылке.

Parameters:: tagSet - объект TIFFTagSet.
Throws:: IllegalArgumentException - если tagSet равен null.

getAllowedTagSets

public List<TIFFTagSet> getAllowedTagSets()

Возвращает List, содержащий разрешенные объекты TIFFTagSet.

Returns:: коллекция List из объектов TIFFTagSet.

setReadUnknownTags

public void setReadUnknownTags(boolean readUnknownTags)

Задает, следует ли читать поля, соответствующие TIFFTag, не входящим в разрешенные TIFFTagSet. Значение по умолчанию — false. Если модуль чтения TIFF ImageReader настроен на игнорирование метаданных, значение true переопределяется, так как игнорируются все метаданные, за исключением тех, которые необходимы для чтения самого изображения.

Parameters:: readUnknownTags - следует ли читать поля нераспознанных тегов

getReadUnknownTags

public boolean getReadUnknownTags()

Получает значение параметра, определяющего, следует ли читать поля, соответствующие неизвестным TIFFTag.

Returns:: следует ли читать поля нераспознанных тегов

© 1993, 2025, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
https://docs.oracle.com/en/java/javase/25/docs/api/java.desktop/javax/imageio/plugins/tiff/TIFFImageReadParam.html