TiffOptions-klass

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	Description
TiffOptions(expected_format)	Initierar en ny instans av klassen TiffOptions. Som standard används little endian‑konventionen.
TiffOptions(expected_format, byte_order)	Initierar en ny instans av klassen TiffOptions.
TiffOptions(options)	Initierar en ny instans av klassen TiffOptions.
TiffOptions(tags)	Initierar en ny instans av klassen TiffOptions.

Properties

Name	Type	Access	Description
alpha_storage	TiffAlphaStorage	r/w	Hämtar eller anger alfa lagringsalternativet. Alternativ förutom TiffAlphaStorage.UNSPECIFIED används när det finns mer än 3 TiffOptions.samples_per_pixel definierade.
artist	string	r/w	Hämtar eller anger artisten.
bits_per_pixel	int	r	Hämtar bitarna per pixel.
bits_per_sample	int[]	r/w	Hämtar eller anger antalet bitar per prov.
buffer_size_hint	int	r/w	Hämtar eller anger en ledtråd för buffertstorlek som definierar maximal tillåten storlek för alla interna buffertar.
byte_order	TiffByteOrder	r/w	Hämtar eller anger ett värde som indikerar tiff-byteordningen.
color_map	int[]	r/w	Hämtar eller anger färgkartan.
compressed_quality	int	r/w	Hämtar eller anger komprimerad bildkvalitet. Används med Jpeg‑komprimering.
compression	TiffCompressions	r/w	Hämtar eller anger komprimeringen.
upphovsrätt	string	r/w	Hämtar eller anger upphovsrätten.
date_time	string	r/w	Hämtar eller anger datum och tid.
default_memory_allocation_limit	int	r/w	Hämtar eller anger standardgränsen för minnesallokering.
disable_icc_export	bool	r/w	Hämtar eller anger ett värde som indikerar om ICC‑profilexport är inaktiverad (ICC‑profilen appliceras på källpixlarna i förväg).
disposed	bool	r	Hämtar ett värde som indikerar om den här instansen är frigjord.
document_name	string	r/w	Hämtar eller anger dokumentets namn.
exif_data	ExifData	r/w	Hämtar eller anger Exif-data.
exif_ifd	TiffExifIfd	r	Hämtar eller anger pekaren till EXIF IFD.
extra_samples	int[]	r	Hämtar värdena för extra samples.
fax_t4_options	Group3Options	r/w	Hämtar eller anger fax t4‑alternativen.
file_standard	TiffFileStandards	r/w	Hämtar eller anger TIFF‑filstandard.
fill_order	TiffFillOrders	r/w	Hämtar eller anger fyllningsordningen för byte‑bitar.
full_frame	bool	r/w	Hämtar eller anger ett värde som indikerar om [full frame].
half_tone_hints	int[]	r/w	Hämtar eller anger halvtone‑tipsen.
image_description	string	r/w	Hämtar eller anger bildbeskrivningen.
image_length	int	r/w	Hämtar eller anger bildlängden.
image_width	int	r/w	Hämtar eller anger bildbredden.
ink_names	string	r/w	Hämtar eller anger bläcknamnen.
is_extra_samples_present	bool	r	Hämtar ett värde som indikerar om de extra proverna finns.
is_tiled	bool	r	Hämtar ett värde som indikerar om bilden är tiled.
is_valid	bool	r	Hämtar ett värde som indikerar om TiffOptions har konfigurerats korrekt. Använd Validate method för att hitta felorsaken.
keep_metadata	bool	r/w	Hämtar ett värde som anger om originalmetadata för bilden ska behållas vid export.
max_sample_value	int[]	r/w	Hämtar eller anger det maximala provvärdet.
min_sample_value	int[]	r/w	Hämtar eller anger det minsta provvärdet.
multi_page_options	MultiPageOptions	r/w	Flersidiga alternativ
orientation	TiffOrientations	r/w	Hämtar eller anger orienteringen.
page_name	string	r/w	Hämtar eller anger sidnamnet.
page_number	int[]	r/w	Hämtar eller anger sidnummer‑taggen.
palette	IColorPalette	r/w	Hämtar eller anger färgpaletten.
photometric	TiffPhotometrics	r/w	Hämtar eller anger photometric.
planar_configuration	TiffPlanarConfigs	r/w	Hämtar eller anger den plana konfigurationen.
predictor	TiffPredictor	r/w	Hämtar eller anger förutsägaren för LZW-komprimering.
premultiply_components	bool	r/w	Hämtar eller anger ett värde som indikerar om komponenterna måste förmultipliceras.
resolution_settings	ResolutionSetting	r/w	Hämtar eller anger upplösningsinställningarna.
resolution_unit	TiffResolutionUnits	r/w	Hämtar eller anger upplösningsenheten.
rows_per_strip	int	r/w	Hämtar eller anger rader per strip.
sample_format	TiffSampleFormats[]	r/w	Hämtar eller anger provformatet.
samples_per_pixel	int	r	Hämtar prover per pixel. För att ändra detta egenskapsvärde, använd TiffOptions.bits_per_sample egenskaps‑setter.
scanner_manufacturer	string	r/w	Hämtar eller anger skannertillverkaren.
scanner_model	string	r/w	Hämtar eller anger skannermodellen.
smax_sample_value	int[]	r/w	Hämtar eller anger det maximala provvärdet. Värdet har en fälttyp som bäst matchar provdata (Byte, Short eller Long type).
smin_sample_value	int[]	r/w	Hämtar eller anger det minsta provvärdet. Värdet har en fälttyp som bäst matchar provdata (Byte, Short eller Long type).
software_type	string	r/w	Hämtar eller anger programvarutypen.
source	Source	r/w	Hämtar eller anger källan där bilden ska skapas.
strip_byte_counts	int[]	r/w	Hämtar eller anger strip-byte-antalet.
strip_offsets	int[]	r/w	Hämtar eller anger strip-offsetsen.
sub_file_type	TiffNewSubFileTypes	r/w	Hämtar eller anger en allmän indikation på vilken typ av data som finns i denna underfil.
tag_count	int	r	Hämtar taggantalet.
tags	TiffDataType[]	r/w	Hämtar eller anger taggarna.
target_printer	string	r/w	Hämtar eller anger målskrivaren.
threshholding	TiffThresholds	r/w	Hämtar eller anger tröskelvärdet.
tile_byte_counts	int[]	r/w	Hämtar eller anger tile-byte-antalet.
tile_length	int	r/w	Hämtar eller anger tile-längden.
tile_offsets	int[]	r/w	Hämtar eller anger tile-offsetsen.
tile_width	int	r/w	Hämtar eller anger tile-bredden.
total_pages	int	r	Hämtar det totala antalet sidor.
valid_tag_count	int	r	Hämtar det giltiga taggantalet. Detta är inte det totala antalet taggar utan antalet taggar som kan bevaras.
vector_rasterization_options	VectorRasterizationOptions	r/w	Hämtar eller anger vektorrasteriseringsalternativen.
xmp_data	XmpPacketWrapper	r/w	Hämtar eller anger XMP-metadatabehållaren.
xp_author	string	r/w	Hämtar eller anger bildens författare, som används av Windows Explorer.
xp_comment	string	r/w	Hämtar eller anger kommentar på bilden, som används av Windows Explorer.
xp_keywords	string	r/w	Hämtar eller anger bildens ämne, som används av Windows Explorer.
xp_subject	string	r/w	Hämtar eller anger information om bilden, som används av Windows Explorer.
xp_title	string	r/w	Hämtar eller anger information om bilden, som används av Windows Explorer.
xposition	TiffRational	r/w	Hämtar eller anger x‑positionen.
xresolution	TiffRational	r/w	Hämtar eller anger x-upplösningen.
y_cb_cr_coefficients	TiffRational[]	r/w	Hämtar eller anger YCbCr‑koefficienterna.
y_cb_cr_subsampling	int[]	r/w	Hämtar eller anger subsamplingsfaktorerna för YCbCr‑fotometriska data.
yposition	TiffRational	r/w	Hämtar eller anger y‑positionen.
yresolution	TiffRational	r/w	Hämtar eller anger y-upplösningen.

Methods

Name	Description
add_tag(tag_to_add)	Lägger till en ny tagg.
add_tags(tags_to_add)	Lägger till taggarna.
clone()	Klonar den här instansen.
create_with_format(expected_format)	Initierar en ny instans av klassen TiffOptions. Som standard används little endian‑konventionen.
create_with_options(options)	Initierar en ny instans av klassen TiffOptions.
create_with_tags(tags)	Initierar en ny instans av klassen TiffOptions.
get_tag_by_type(tag_key)	Hämtar instansen av taggen efter typ.
get_valid_tags_count(tags)	Hämtar antalet giltiga taggar.
is_tag_present(tag)	Bestämmer om taggen finns i alternativen eller inte.
remove_tag(tag)	Tar bort taggen.
remove_tags(tags)	Tar bort taggarna.
try_set_metadata(metadata)	Försöker sätta en metadata-instans, om detta Image-instans stödjer och implementerar IImageMetadataFormat-instansen.
validate()	Validerar om alternativ har en giltig kombination av taggar

Constructor: TiffOptions(expected_format)

 TiffOptions(expected_format)

Initierar en ny instans av klassen TiffOptions. Som standard används little endian‑konventionen.

Parameters:

Parameter	Typ	Beskrivning
expected_format	TiffExpectedFormat	Det förväntade tiff‑filformatet.

Constructor: TiffOptions(expected_format, byte_order)

 TiffOptions(expected_format, byte_order)

Initierar en ny instans av klassen TiffOptions.

Parameters:

Parameter	Typ	Beskrivning
expected_format	TiffExpectedFormat	Det förväntade tiff‑filformatet.
byte_order	TiffByteOrder	Byteordningen för tiff-filformatet att använda.

Constructor: TiffOptions(options)

 TiffOptions(options)

Initierar en ny instans av klassen TiffOptions.

Parameters:

Parameter	Typ	Beskrivning
options	TiffOptions	Alternativen att kopiera från.

Constructor: TiffOptions(tags)

 TiffOptions(tags)

Initierar en ny instans av klassen TiffOptions.

Parameters:

Parameter	Typ	Beskrivning
tags	TiffDataType[]	Taggarna att initiera alternativ med.

Property: compressed_quality

Hämtar eller anger komprimerad bildkvalitet.
Används med Jpeg‑komprimering.

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)

Lägger till en ny tagg.

Parameters:

Parameter	Typ	Beskrivning
tag_to_add	TiffDataType	Taggen att lägga till.

Method: add_tags(tags_to_add)

 add_tags(tags_to_add)

Lägger till taggarna.

Parameters:

Parameter	Typ	Beskrivning
tags_to_add	TiffDataType[]	Taggarna att lägga till.

Method: clone()

 clone()

Klonar den här instansen.

Returns

Typ	Beskrivning
ImageOptionsBase	Returnerar en djup klon.

Method: create_with_format(expected_format) [static]

 create_with_format(expected_format)

Initierar en ny instans av klassen TiffOptions. Som standard används little endian‑konventionen.

Parameters:

Parameter	Typ	Beskrivning
expected_format	TiffExpectedFormat	Det förväntade tiff‑filformatet.

Returns

Typ	Beskrivning
TiffOptions

Method: create_with_options(options) [static]

 create_with_options(options)

Initierar en ny instans av klassen TiffOptions.

Parameters:

Parameter	Typ	Beskrivning
options	TiffOptions	Alternativen att kopiera från.

Returns

Typ	Beskrivning
TiffOptions

Method: create_with_tags(tags) [static]

 create_with_tags(tags)

Initierar en ny instans av klassen TiffOptions.

Parameters:

Parameter	Typ	Beskrivning
tags	TiffDataType[]	Taggarna att initiera alternativ med.

Returns

Typ	Beskrivning
TiffOptions

Method: get_tag_by_type(tag_key)

 get_tag_by_type(tag_key)

Hämtar instansen av taggen efter typ.

Parameters:

Parameter	Typ	Beskrivning
tag_key	TiffTags	Taggnyckeln.

Returns

Typ	Beskrivning
TiffDataType	Instans av taggen om den finns, annars null.

Method: get_valid_tags_count(tags) [static]

 get_valid_tags_count(tags)

Hämtar antalet giltiga taggar.

Parameters:

Parameter	Typ	Beskrivning
tags	TiffDataType[]	Taggarna att validera.

Returns

Typ	Beskrivning
int	Antalet giltiga taggar.

Method: is_tag_present(tag)

 is_tag_present(tag)

Bestämmer om taggen finns i alternativen eller inte.

Parameters:

Parameter	Typ	Beskrivning
tag	TiffTags	Tagg‑id‑et att kontrollera.

Returns

Typ	Beskrivning
bool	true om taggen finns; annars false.

Method: remove_tag(tag)

 remove_tag(tag)

Tar bort taggen.

Parameters:

Parameter	Typ	Beskrivning
tag	TiffTags	Taggen att ta bort.

Returns

Typ	Beskrivning
bool	true om den har tagits bort framgångsrikt

Method: remove_tags(tags)

 remove_tags(tags)

Tar bort taggarna.

Parameters:

Parameter	Typ	Beskrivning
tags	TiffTags[]	Taggarna att ta bort.

Returns

Typ	Beskrivning
bool	True om storleken på tagg‑samlingen har ändrats.

Method: try_set_metadata(metadata)

 try_set_metadata(metadata)

Försöker sätta en metadata-instans, om detta Image-instans stödjer och implementerar IImageMetadataFormat-instansen.

Parameters:

Parameter	Typ	Beskrivning
metadata	IImageMetadataFormat	Metadata.

Returns

Typ	Beskrivning
bool	Sant, om IMetadataContainer‑instansen stöder och/eller implementerar IImageMetadataFormat‑instansen; annars falskt.

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


# Skapa en instans av en filström
with open(r"C:\temp\output.tiff", "w+b") as stream:
	# Skapa en instans av TiffOptions och ställ in dess olika egenskaper
	tiffOptions = TiffOptions(TiffExpectedFormat.DEFAULT)
	# Ange källan för instansen av ImageOptions
	tiffOptions.source = StreamSource(stream)
	# Skapa en instans av Image
	with Image.create(tiffOptions, 500, 500) as image:
		# Skapa och initiera en instans av Graphics-klassen
		graphics = Graphics(image)
		# Rensa Graphics-ytan
		graphics.clear(Color.wheat);
		# Skapa en instans av klassen GraphicsPath
		graphics_path = GraphicsPath()
		# Skapa en instans av klassen Figure
		figure = Figure()
		# Lägg till former till Figure-objektet
		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))
		# Lägg till Figure-objektet till GraphicsPath
		graphics_path.add_figure(figure)
		# Rita bana med Pen-objektet i färgen svart
		graphics.draw_path(Pen(Color.black, 2.0), graphics_path)
		# spara alla ändringar.
		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\\"
#Läs in en befintlig gif-bild som en instans av Image-klassen.
with Image.load(path_join(directory, "sample.gif")) as image:
	# Exportera till BMP-filformat med standardalternativen.
	image.save(path_join(directory, "output.bmp"), BmpOptions())
	# Exportera till JPEG-filformat med standardalternativen.
	image.save(path_join(directory, "output.jpg"), JpegOptions())
	# Exportera till PNG-filformat med standardalternativen.
	image.save(path_join(directory, "output.png"), PngOptions())
	# Exportera till TIFF-filformat med standardalternativen.
	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)
	# Ställ in RGB-färgmodellen.
	tiff_options.photometric = TiffPhotometrics.RGB
	# Ställ in JPEG-komprimeringen.
	tiff_options.compression = TiffCompressions.JPEG
	tiff_options.compressed_quality = 50
	# Ställ in 8 bitar för varje färgkomponent.
	tiff_options.bits_per_sample = [8, 8, 8]
	image.save("zeebra.tif-50.tiff", tiff_options)

TgaOptions-klass TimeInterval klass

TiffOptions-klass

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.