Класс JpegOptions

Summary: Create high-quality JPEG images effortlessly with our API, offering adjustable
levels of compression to optimize storage size without compromising image quality.
Benefit from support for various compression types, near lossless coding,
RGB and CMYK color profiles, as well as EXIF, JFIF image data, and XMP
containers, ensuring versatile and customizable options for your image creation needs.

Module: aspose.imaging.imageoptions

Full Name: aspose.imaging.imageoptions.JpegOptions

Inheritance: IMetadataContainer, IHasExifData, IHasMetadata, IHasXmpData, IHasJpegExifData, ImageOptionsBase

Constructors

Name	Description
JpegOptions()	Инициализирует новый экземпляр класса JpegOptions.
JpegOptions(jpeg_options)	Инициализирует новый экземпляр класса JpegOptions.

Properties

Name	Type	Access	Description
bits_per_channel	System.Byte	r/w	Получает или задает количество бит на канал для без потерь jpeg‑изображения. Сейчас поддерживается от 2 до 8 бит на канал.
buffer_size_hint	int	r/w	Получает или задает подсказку о размере буфера, определяющую максимальный допустимый размер для всех внутренних буферов.
cmyk_color_profile	StreamSource	r/w	Целевой профиль цвета CMYK для jpeg‑изображений CMYK. Используется при сохранении изображений. Должен использоваться вместе с RGBColorProfile для корректного преобразования цветов.
color_type	JpegCompressionColorMode	r/w	Получает или задает тип цвета для jpeg‑изображения.
comment	string	r/w	Получает или задает комментарий файла jpeg.
compression_type	JpegCompressionMode	r/w	Получает или задает тип сжатия.
default_memory_allocation_limit	int	r/w	Получает или задает предельный объём памяти по умолчанию.
disposed	bool	r	Получает значение, указывающее, удалён ли этот экземпляр.
exif_data	JpegExifData	r/w	Получить или задать контейнер данных Exif.
full_frame	bool	r/w	Получает или задает значение, указывающее, включен ли [full frame].
horizontal_sampling	System.Byte	r/w	Получает или задает горизонтальные субдискретизации для каждого компонента.
jfif	JFIFData	r/w	Получает или задает jfif.
jpeg_ls_allowed_lossy_error	int	r/w	Получает или задает границу различий JPEG-LS для почти без потерь кодирования (параметр NEAR из спецификации JPEG-LS).
jpeg_ls_interleave_mode	JpegLsInterleaveMode	r/w	Получает или задает режим чередования JPEG-LS.
jpeg_ls_preset	JpegLsPresetCodingParameters	r/w	Получает или задает предустановленные параметры JPEG-LS.
keep_metadata	bool	r/w	Получает значение, указывающее, сохранять ли оригинальные метаданные изображения при экспорте.
multi_page_options	MultiPageOptions	r/w	Параметры multipage
palette	IColorPalette	r/w	Получает или задает цветовую палитру.
preblend_alpha_if_present	bool	r/w	Получает или задает значение, указывающее, следует ли смешивать красные, зеленые и синие компоненты с цветом фона, если присутствует альфа‑канал.
quality	int	r/w	Получает или задает качество изображения.
rd_opt_settings	RdOptimizerSettings	r/w	Получает или задает настройки оптимизатора RD.
resolution_settings	ResolutionSetting	r/w	Получает или задает параметры разрешения.
resolution_unit	ResolutionUnit	r/w	Получает или задает единицу разрешения.
rgb_color_profile	StreamSource	r/w	Целевой профиль цвета RGB для jpeg‑изображений CMYK. Используется при сохранении изображений. Должен использоваться вместе с CMYKColorProfile для корректного преобразования цветов.
sample_rounding_mode	SampleRoundingMode	r/w	Получает или задает режим округления образца для приведения 8‑битного значения к n‑битному. JpegOptions.BitsPerChannel
scaled_quality	int	r	Масштабированное качество.
source	Source	r/w	Получает или задает источник, в котором создаётся изображение.
vector_rasterization_options	VectorRasterizationOptions	r/w	Получает или задает параметры растеризации вектора.
vertical_sampling	System.Byte	r/w	Получает или задает вертикальные субвыборки для каждого компонента.
xmp_data	XmpPacketWrapper	r/w	Получает или задает контейнер метаданных XMP.

Methods

Name	Description
clone()	Создаёт поверхностную копию этого экземпляра.
try_set_metadata(metadata)	Пытается установить экземпляр metadata, если этот экземпляр Image поддерживает и реализует экземпляр IImageMetadataFormat.

Constructor: JpegOptions()

 JpegOptions() 

Инициализирует новый экземпляр класса JpegOptions.

Constructor: JpegOptions(jpeg_options)

 JpegOptions(jpeg_options) 

Инициализирует новый экземпляр класса JpegOptions.

Parameters:

Параметр	Тип	Описание
jpeg_options	JpegOptions	Параметры JPEG.

Method: clone()

 clone() 

Создаёт поверхностную копию этого экземпляра.

Returns

Тип	Описание
ImageOptionsBase	Поверхностная копия этого экземпляра.

Method: try_set_metadata(metadata)

 try_set_metadata(metadata) 

Пытается установить экземпляр metadata, если этот экземпляр Image поддерживает и реализует экземпляр IImageMetadataFormat.

Parameters:

Параметр	Тип	Описание
metadata	IImageMetadataFormat	Метаданные.

Returns

Тип	Описание
bool	True, если экземпляр IMetadataContainer поддерживает и/или реализует экземпляр IImageMetadataFormat; иначе — false.

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.

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))