TiffOptions 类

Summary: The tiff file format options.
Note that width and height tags will get overwritten on image creation by width and height parameters so there is no need to specify them directly.
Note that many options return a default value but that does not mean that this option is set explicitly as a tag value. To verify the tag is present use Tags property or the corresponding IsTagPresent method.

Module: aspose.imaging.imageoptions

Full Name: aspose.imaging.imageoptions.TiffOptions

Inheritance: IMetadataContainer, IHasExifData, IHasMetadata, IHasXmpData, ImageOptionsBase

Constructors

Name	描述
TiffOptions(expected_format)	初始化一个新的 TiffOptions 类实例。默认使用小端字节序。
TiffOptions(expected_format, byte_order)	初始化一个新的 TiffOptions 类实例。
TiffOptions(options)	初始化一个新的 TiffOptions 类实例。
TiffOptions(tags)	初始化一个新的 TiffOptions 类实例。

Properties

Name	Type	Access	描述
alpha_storage	TiffAlphaStorage	r/w	获取或设置 alpha 存储选项。除 TiffAlphaStorage.UNSPECIFIED 之外的选项当定义的 TiffOptions.samples_per_pixel 超过 3 时使用。
artist	string	r/w	获取或设置艺术家。
bits_per_pixel	int	r	获取每像素的位数。
bits_per_sample	int[]	r/w	获取或设置每个样本的位数。
buffer_size_hint	int	r/w	获取或设置缓冲区大小提示，该提示定义了所有内部缓冲区的最大允许大小。
byte_order	TiffByteOrder	r/w	获取或设置一个值，指示 tiff 字节序。
color_map	int[]	r/w	获取或设置颜色映射。
compressed_quality	int	r/w	获取或设置压缩图像质量。与 Jpeg 压缩一起使用。
compression	TiffCompressions	r/w	获取或设置压缩。
版权	string	r/w	获取或设置版权。
date_time	string	r/w	获取或设置日期和时间。
default_memory_allocation_limit	int	r/w	获取或设置默认内存分配限制。
disable_icc_export	bool	r/w	获取或设置一个值，指示是否禁用 ICC 配置文件导出（ICC 配置文件会预先应用于源像素）。
disposed	bool	r	获取一个值，指示此实例是否已释放。
document_name	string	r/w	获取或设置文档的名称。
exif_data	ExifData	r/w	获取或设置 Exif 数据。
exif_ifd	TiffExifIfd	r	获取或设置指向 EXIF IFD 的指针。
extra_samples	int[]	r	获取额外样本的值。
fax_t4_options	Group3Options	r/w	获取或设置传真 t4 选项。
file_standard	TiffFileStandards	r/w	获取或设置 TIFF 文件标准。
fill_order	TiffFillOrders	r/w	获取或设置字节位填充顺序。
full_frame	bool	r/w	获取或设置一个值，指示是否为 [full frame]。
half_tone_hints	int[]	r/w	获取或设置半色调提示。
image_description	string	r/w	获取或设置图像描述。
image_length	int	r/w	获取或设置图像长度。
image_width	int	r/w	获取或设置图像宽度。
ink_names	string	r/w	获取或设置墨水名称。
is_extra_samples_present	bool	r	获取一个值，指示是否存在额外样本。
is_tiled	bool	r	获取一个值，指示图像是否已平铺。
is_valid	bool	r	获取一个值，指示 TiffOptions 是否已正确配置。使用 Validate 方法查找失败原因。
keep_metadata	bool	r/w	获取一个值，指示在导出时是否保留原始图像元数据。
max_sample_value	int[]	r/w	获取或设置最大样本值。
min_sample_value	int[]	r/w	获取或设置最小样本值。
multi_page_options	MultiPageOptions	r/w	多页选项
orientation	TiffOrientations	r/w	获取或设置方向。
page_name	string	r/w	获取或设置页面名称。
page_number	int[]	r/w	获取或设置页码标签。
palette	IColorPalette	r/w	获取或设置颜色调色板。
photometric	TiffPhotometrics	r/w	获取或设置光度学。
planar_configuration	TiffPlanarConfigs	r/w	获取或设置平面配置。
predictor	TiffPredictor	r/w	获取或设置 LZW 压缩的预测器。
premultiply_components	bool	r/w	获取或设置一个值，指示组件是否必须预乘。
resolution_settings	ResolutionSetting	r/w	获取或设置分辨率设置。
resolution_unit	TiffResolutionUnits	r/w	获取或设置分辨率单位。
rows_per_strip	int	r/w	获取或设置每条带的行数。
sample_format	TiffSampleFormats[]	r/w	获取或设置样本格式。
samples_per_pixel	int	r	获取每像素的样本数。要更改此属性值，请使用 TiffOptions.bits_per_sample 属性设置器。
scanner_manufacturer	string	r/w	获取或设置扫描仪制造商。
scanner_model	string	r/w	获取或设置扫描仪型号。
smax_sample_value	int[]	r/w	获取或设置最大样本值。该值具有最匹配样本数据的字段类型（Byte、Short 或 Long 类型）。
smin_sample_value	int[]	r/w	获取或设置最小样本值。该值具有最匹配样本数据的字段类型（Byte、Short 或 Long 类型）。
software_type	string	r/w	获取或设置软件类型。
source	Source	r/w	获取或设置用于创建图像的源。
strip_byte_counts	int[]	r/w	获取或设置条带字节计数。
strip_offsets	int[]	r/w	获取或设置条带偏移量。
sub_file_type	TiffNewSubFileTypes	r/w	获取或设置对该子文件中包含的数据类型的一般指示。
tag_count	int	r	获取标签计数。
tags	TiffDataType[]	r/w	获取或设置标签。
target_printer	string	r/w	获取或设置目标打印机。
threshholding	TiffThresholds	r/w	获取或设置阈值处理。
tile_byte_counts	int[]	r/w	获取或设置瓦片字节计数。
tile_length	int	r/w	获取或设置瓦片长度。
tile_offsets	int[]	r/w	获取或设置瓦片偏移量。
tile_width	int	r/w	获取或设置瓦片宽度。
total_pages	int	r	获取总页数。
valid_tag_count	int	r	获取有效标签计数。这不是标签的总计数，而是可能被保留的标签数量。
vector_rasterization_options	VectorRasterizationOptions	r/w	获取或设置矢量光栅化选项。
xmp_data	XmpPacketWrapper	r/w	获取或设置 XMP 元数据容器。
xp_author	string	r/w	获取或设置图像作者，该作者用于 Windows Explorer。
xp_comment	string	r/w	获取或设置图像注释，该注释用于 Windows Explorer。
xp_keywords	string	r/w	获取或设置图像主题，该主题用于 Windows Explorer。
xp_subject	string	r/w	获取或设置信息关于图像，该信息用于 Windows Explorer。
xp_title	string	r/w	获取或设置信息关于图像，该信息用于 Windows Explorer。
xposition	TiffRational	r/w	获取或设置 x 位置。
xresolution	TiffRational	r/w	获取或设置 x 分辨率。
y_cb_cr_coefficients	TiffRational[]	r/w	获取或设置 YCbCrCoefficients。
y_cb_cr_subsampling	int[]	r/w	获取或设置 YCbCr 光度的子采样因子。
yposition	TiffRational	r/w	获取或设置 y 位置。
yresolution	TiffRational	r/w	获取或设置 y 分辨率。

Methods

Name	描述
add_tag(tag_to_add)	添加新标签。
add_tags(tags_to_add)	添加标签。
clone()	克隆此实例。
create_with_format(expected_format)	初始化一个新的 TiffOptions 类实例。默认使用小端字节序。
create_with_options(options)	初始化一个新的 TiffOptions 类实例。
create_with_tags(tags)	初始化一个新的 TiffOptions 类实例。
get_tag_by_type(tag_key)	按类型获取标签实例。
get_valid_tags_count(tags)	获取有效标签计数。
is_tag_present(tag)	确定标签是否存在于选项中。
remove_tag(tag)	移除标签。
remove_tags(tags)	移除标签。
try_set_metadata(metadata)	尝试设置一个 metadata 实例，前提是此 Image 实例支持并实现 IImageMetadataFormat 实例。
validate()	验证选项是否具有有效的标签组合

Constructor: TiffOptions(expected_format)

 TiffOptions(expected_format)

初始化一个新的 TiffOptions 类实例。默认使用小端字节序。

Parameters:

参数	Type	Description
expected_format	TiffExpectedFormat	预期的 tiff 文件格式。

Constructor: TiffOptions(expected_format, byte_order)

 TiffOptions(expected_format, byte_order)

初始化一个新的 TiffOptions 类实例。

Parameters:

参数	Type	Description
expected_format	TiffExpectedFormat	预期的 tiff 文件格式。
byte_order	TiffByteOrder	要使用的 tiff 文件格式字节顺序。

Constructor: TiffOptions(options)

 TiffOptions(options)

初始化一个新的 TiffOptions 类实例。

Parameters:

参数	Type	Description
options	TiffOptions	要复制的选项。

Constructor: TiffOptions(tags)

 TiffOptions(tags)

初始化一个新的 TiffOptions 类实例。

Parameters:

参数	Type	Description
tags	TiffDataType[]	用于初始化选项的标签。

Property: compressed_quality

获取或设置压缩图像质量。
与 Jpeg 压缩一起使用。

See also:

Example # 1: This example shows how to create a TIFF image with the Jpeg compression and t…

Method: add_tag(tag_to_add)

 add_tag(tag_to_add)

添加新标签。

Parameters:

参数	Type	Description
tag_to_add	TiffDataType	要添加的标签。

Method: add_tags(tags_to_add)

 add_tags(tags_to_add)

添加标签。

Parameters:

参数	Type	Description
tags_to_add	TiffDataType[]	要添加的标签。

Method: clone()

 clone()

克隆此实例。

Returns

Type	Description
ImageOptionsBase	返回深度克隆。

Method: create_with_format(expected_format) [static]

 create_with_format(expected_format)

初始化一个新的 TiffOptions 类实例。默认使用小端字节序。

Parameters:

参数	Type	Description
expected_format	TiffExpectedFormat	预期的 tiff 文件格式。

Returns

Type	Description
TiffOptions

Method: create_with_options(options) [static]

 create_with_options(options)

初始化一个新的 TiffOptions 类实例。

Parameters:

参数	Type	Description
options	TiffOptions	要复制的选项。

Returns

Type	Description
TiffOptions

Method: create_with_tags(tags) [static]

 create_with_tags(tags)

初始化一个新的 TiffOptions 类实例。

Parameters:

参数	Type	Description
tags	TiffDataType[]	用于初始化选项的标签。

Returns

Type	Description
TiffOptions

Method: get_tag_by_type(tag_key)

 get_tag_by_type(tag_key)

按类型获取标签实例。

Parameters:

参数	Type	Description
tag_key	TiffTags	标签键。

Returns

Type	Description
TiffDataType	如果存在则为标签实例，否则为 null。

Method: get_valid_tags_count(tags) [static]

 get_valid_tags_count(tags)

获取有效标签计数。

Parameters:

参数	Type	Description
tags	TiffDataType[]	要验证的标签。

Returns

Type	Description
int	有效标签的计数。

Method: is_tag_present(tag)

 is_tag_present(tag)

确定标签是否存在于选项中。

Parameters:

参数	Type	Description
tag	TiffTags	要检查的标签 ID。

Returns

Type	Description
bool	true 表示标签存在；否则为 false。

Method: remove_tag(tag)

 remove_tag(tag)

移除标签。

Parameters:

参数	Type	Description
tag	TiffTags	要移除的标签。

Returns

Type	Description
bool	成功移除时返回 true

Method: remove_tags(tags)

 remove_tags(tags)

移除标签。

Parameters:

参数	Type	Description
tags	TiffTags[]	要移除的标签。

Returns

Type	Description
bool	True 表示标签集合大小已更改。

Method: try_set_metadata(metadata)

 try_set_metadata(metadata)

尝试设置一个 metadata 实例，前提是此 Image 实例支持并实现 IImageMetadataFormat 实例。

Parameters:

参数	Type	Description
metadata	IImageMetadataFormat	元数据。

Returns

Type	Description
bool	如果 IMetadataContainer 实例支持和/或实现 IImageMetadataFormat 实例，则为 true；否则为 false。

Examples

This examples make use of GraphicsPath and Graphics classes to create and manipulate figures on an Image surface. Example creates a new Image (of type Tiff), clears the surface and draws paths with the help of GraphicsPath class. At the end `draw_path` method exposed by Graphics class is called to render the paths on surface.


from aspose.imaging import Image, Graphics, Color, GraphicsPath, Figure, RectangleF, PointF, SizeF
from aspose.imaging import Pen
from aspose.imaging.sources import StreamSource
from aspose.imaging.imageoptions import TiffOptions
from aspose.imaging.fileformats.tiff.enums import TiffExpectedFormat
from aspose.imaging.shapes import RectangleShape, EllipseShape, PieShape


# 创建文件流的实例
with open(r"C:\temp\output.tiff", "w+b") as stream:
	# 创建 TiffOptions 的实例并设置其各种属性
	tiffOptions = TiffOptions(TiffExpectedFormat.DEFAULT)
	# 为 ImageOptions 实例设置源
	tiffOptions.source = StreamSource(stream)
	# 创建 Image 的实例
	with Image.create(tiffOptions, 500, 500) as image:
		# 创建并初始化 Graphics 类的实例
		graphics = Graphics(image)
		# 清除 Graphics 表面
		graphics.clear(Color.wheat);
		# 创建 GraphicsPath 类的实例
		graphics_path = GraphicsPath()
		# 创建 Figure 类的实例
		figure = Figure()
		# 向 Figure 对象添加形状
		figure.add_shape(RectangleShape(RectangleF(10.0, 10.0, 300.0, 300.0)))
		figure.add_shape(EllipseShape(RectangleF(50.0, 50.0, 300.0, 300.0)))
		figure.add_shape(PieShape(RectangleF(PointF(250.0, 250.0), SizeF(200.0, 200.0)), 0.0, 45.0))
		# 将 Figure 对象添加到 GraphicsPath
		graphics_path.add_figure(figure)
		# 使用颜色为 Black 的 Pen 对象绘制路径
		graphics.draw_path(Pen(Color.black, 2.0), graphics_path)
		# 保存所有更改。
		image.save()

This example demonstrates the use of different classes from `imageoptions` package for export purposes. A gif image is loaded as an instance of Image and then exported out to several formats.


from aspose.imaging import Image
from aspose.imaging.imageoptions import BmpOptions, JpegOptions, PngOptions, TiffOptions
from aspose.imaging.fileformats.tiff.enums import TiffExpectedFormat
from os.path import join as path_join

directory = "c:\\temp\\"
#将现有的 gif 图像加载为 Image 类的实例
with Image.load(path_join(directory, "sample.gif")) as image:
	# 使用默认选项导出为 BMP 文件格式
	image.save(path_join(directory, "output.bmp"), BmpOptions())
	# 使用默认选项导出为 JPEG 文件格式
	image.save(path_join(directory, "output.jpg"), JpegOptions())
	# 使用默认选项导出为 PNG 文件格式
	image.save(path_join(directory, "output.png"), PngOptions())
	# 使用默认选项导出为 TIFF 文件格式
	image.save(path_join(directory, "output.tif"), TiffOptions(TiffExpectedFormat.DEFAULT))

This example shows how to create a TIFF image with the Jpeg compression and the specified compressed image quality.


import aspose.pycore as aspycore
from aspose.imaging import Image
from aspose.imaging.imageoptions import TiffOptions   
from aspose.imaging.fileformats.tiff import TiffImage
from aspose.imaging.fileformats.tiff.enums import TiffExpectedFormat, TiffPhotometrics, TiffCompressions

with aspycore.as_of(Image.load("zeebra.tif"), TiffImage) as image:
	tiff_options = TiffOptions(TiffExpectedFormat.DEFAULT)
	# 设置 RGB 颜色模型。
	tiff_options.photometric = TiffPhotometrics.RGB
	# 设置 JPEG 压缩。
	tiff_options.compression = TiffCompressions.JPEG
	tiff_options.compressed_quality = 50
	# 为每个颜色分量设置 8 位。
	tiff_options.bits_per_sample = [8, 8, 8]
	image.save("zeebra.tif-50.tiff", tiff_options)

TgaOptions 类 TimeInterval 类

TiffOptions 类

Constructors

Properties

Methods

Constructor: TiffOptions(expected_format)

Constructor: TiffOptions(expected_format, byte_order)

Constructor: TiffOptions(options)

Constructor: TiffOptions(tags)

Property: compressed_quality

Method: add_tag(tag_to_add)

Method: add_tags(tags_to_add)

Method: clone()

Method: create_with_format(expected_format) [static]

Method: create_with_options(options) [static]

Method: create_with_tags(tags) [static]

Method: get_tag_by_type(tag_key)

Method: get_valid_tags_count(tags) [static]

Method: is_tag_present(tag)

Method: remove_tag(tag)

Method: remove_tags(tags)

Method: try_set_metadata(metadata)

Examples

This example demonstrates the use of different classes from imageoptions package for export purposes. A gif image is loaded as an instance of Image and then exported out to several formats.

This example shows how to create a TIFF image with the Jpeg compression and the specified compressed image quality.

This example demonstrates the use of different classes from `imageoptions` package for export purposes. A gif image is loaded as an instance of Image and then exported out to several formats.