EpsImage 类

Summary: The API for Encapsulated PostScript (EPS) image file format support offers
robust capabilities for manipulating compositions comprising text, graphics,
and images. With features such as bitmap preview image handling, orientation
flipping, bounding box retrieval for illustration bounds, resizing, rotating
images, and adding preview images, this API ensures seamless processing
and integration of EPS files into various applications with precision and
versatility.

Module: aspose.imaging.fileformats.eps

Full Name: aspose.imaging.fileformats.eps.EpsImage

Inheritance: IObjectWithBounds, IMetadataContainer, IHasExifData, IHasMetadata, IHasXmpData, IObjectWithSizeF, VectorImage

Properties

Name	Type	Access	描述
auto_adjust_palette	bool	r/w	获取或设置一个值，指示是否自动调整调色板。
background_color	Color	r/w	获取或设置背景颜色的值。
bits_per_pixel	int	r	使用此属性轻松访问图像的精确位深。检索 每像素位数，提供对图像颜色深度的关键洞察 并有助于优化处理任务。非常适用于需要 对图像操作和分析进行细粒度控制的应用程序。
bounding_box	RectangleF	r	以设备无关点访问原始边界框，此属性 提供关于 EpsImage 尺寸的关键几何信息。 通过检索这些数据，用户可以准确评估图像的大小和纵横比 从而在各种应用中实现精确的布局和定位。
bounding_box_px	Rectangle	r	此属性返回 EpsImage 实例的原始像素边界框，提供用于精确渲染和 操作的关键几何数据。凭借这些信息，用户可以确保在项目中对 EPS 图像进行精确的放置和尺寸 /// 调整，提升整体视觉呈现和质量。
bounds	Rectangle	r	获取对象的边界。
buffer_size_hint	int	r/w	获取或设置缓冲区大小提示，该提示定义了所有内部缓冲区的最大允许大小。
container	Image	r	获取 Image 容器。
creation_date	System.DateTime	r	从 EPS 文档结构约定 (DSC) 注释中检索创建日期，此属性提供指示 EPS 文件起始时间的关键元数据。通过访问这些信息，用户可以深入了解文件的来源和时间线，提升文件管理和组织能力。
creator	string	r	此属性提供对 EPS 文档 结构约定 (DSC) 注释中获取的创建者信息的访问。了解 创建者细节可提供有关用于生成 EPS 文件的软件或工具的洞察，帮助在各种平台和 应用之间进行兼容性评估。
data_stream_container	StreamContainer	r	获取对象的数据流。
disposed	bool	r	获取一个值，指示此实例是否已释放。
eps_type	EpsType	r	访问并解释 EPS 图像的子类型值，简化您的 工作流程并提升跨平台兼容性。非常适合在项目中以精确高效的方式优化 EPS 子类型的检索。
exif_data	ExifData	r/w	获取或设置 Exif 实例。
file_format	FileFormat	r	使用此属性访问图像的文件格式。检索有关图像文件格式的关键 信息，以促进兼容性和高效处理。非常适合识别图像文件的格式，以便在项目中实现无缝集成。
has_background_color	bool	r/w	获取或设置指示图像是否具有背景颜色的值。
has_raster_preview	bool	r	使用此属性轻松发现光栅预览的存在。访问 布尔值以指示 EpsImage 实例是否包含 光栅预览，从而为您的图像处理任务提供清晰高效的支持。 非常适合根据 EPS 图像中光栅预览的有无来简化工作流决策。
height	int	r	获取图像高度。
height_f	float	r	使用此属性访问图像的高度。轻松获取图像的高度， 以实现无缝的布局调整、宽高比计算以及在不同屏幕分辨率和显示环境下的精确渲染。
interrupt_monitor	InterruptMonitor	r/w	获取或设置中断监视器。
is_cached	bool	r	此属性提供了一种便捷方式来检查对象的数据是否当前 已被缓存，消除额外读取数据的需求。它提供了一种快速且高效的方法来判断所需信息是否已随时可用， 优化性能并在数据密集型操作中降低资源开销。
metadata	ImageMetadata	r	获取图像元数据。
palette	IColorPalette	r/w	获取或设置颜色调色板。当像素直接表示时，不使用颜色调色板。
post_script_version	string	r	此属性检索与 EpsImage 实例关联的 PostScript 版本。它提供了对 EPS 文件中使用的特定 PostScript 语言版本的洞察，有助于兼容性评估并促进与支持 PostScript 的环境的无缝集成。
preview_image_count	int	r	轻松访问可用预览图像的数量。此属性允许您 轻松检索与文件关联的预览图像计数， 实现对图像预览的高效管理和导航。非常适合 优化工作流并有效组织图像资产。
preview_images	Image[]	r	检索与文件关联的预览图像。此属性提供 对预览图像集合的无缝访问，使您能够高效 浏览并根据需要管理这些图像。非常适合快速预览并为项目选择合适的图像。
size	Size	r	获取对象大小。
size_f	SizeF	r	获取对象的尺寸（单位为英寸）。
标题	string	r	此属性检索从 EPS 文档结构约定（DSC）注释中提取的标题，这些注释嵌入在 EPS 文件中。它提供了关于 EPS 文件内容的有价值 元数据，有助于在兼容的软件应用中进行文档组织和识别。
use_palette	bool	r	获取一个值，指示是否使用图像调色板。
width	int	r	获取图像宽度。
width_f	float	r	使用此便捷属性检索图像的宽度。轻松获取图像的宽度， 便于在应用中进行精确的布局计算、缩放操作和尺寸相关任务。非常适合确保图像在各种平台和设备上的准确 渲染和显示。
xmp_data	XmpPacketWrapper	r/w	获取或设置 Xmp 数据。

Methods

Name	描述
cache_data()	此方法不执行任何操作，因为当前对 EpsImage 类的实现不涉及缓存数据。虽然它可能不 执行任何动作，但了解此行为对处理 EPS 图像的开发者至关重要，能够确保在其应用中实现高效的资源管理和最佳性能。
can_load(file_path)	确定是否可以从指定的文件路径加载图像。
can_load(file_path, load_options)	确定是否可以从指定的文件路径加载图像，并可选地使用指定的打开选项。
can_load(stream)	确定是否可以从指定的流加载图像。
can_load(stream, load_options)	确定是否可以从指定的流加载图像，并可选地使用指定的 loadOptions。
can_load_stream(stream)	确定是否可以从指定的流加载图像。
can_load_stream_with_options(stream, load_options)	确定是否可以从指定的流加载图像，并可选地使用指定的 loadOptions。
can_load_with_options(file_path, load_options)	确定是否可以从指定的文件路径加载图像，并可选地使用指定的打开选项。
can_save(options)	确定是否可以将图像保存为由传入的保存选项表示的指定文件格式。
create(files)	创建包含指定文件的多页图像。
create(files, throw_exception_on_load_error)	创建包含指定文件的多页图像。
create(image_options, width, height)	使用指定的创建选项创建新图像。
create(image_options, width, height, pixels)	创建一个来自提供的像素数组的 RasterImage 实例。 验证指定的宽度和高度是否与像素数据的维度匹配。 仅当库处于授权模式时才能使用此方法。
create(images)	使用指定的图像作为页面创建新图像。
create(images, dispose_images)	创建一个新图像，将指定的图像作为页面。
create(multipage_create_options)	创建指定的多页创建选项。
create_from_files(files)	创建包含指定文件的多页图像，将其作为延迟加载页面。
create_from_files(files, throw_exception_on_load_error)	创建包含指定文件的多页图像，将其作为延迟加载页面。
create_from_images(images)	使用指定的图像作为页面创建新图像。
create_from_images(images, dispose_images)	创建一个新图像，将指定的图像作为页面。
crop(left_shift, right_shift, top_shift, bottom_shift)	使用位移裁剪图像。
crop(rectangle)	裁剪指定的矩形。
get_default_options(args)	获取默认图像选项。
get_embedded_images()	获取嵌入的图像。
get_file_format(file_path)	获取文件格式。
get_file_format(stream)	获取文件格式。
get_file_format_of_stream(stream)	获取文件格式。
get_fitting_rectangle(rectangle, pixels, width, height)	获取适合当前图像的矩形。
get_fitting_rectangle(rectangle, width, height)	获取适合当前图像的矩形。
get_original_options()	根据原始文件设置获取选项。 这有助于保持原始图像的位深度和其他参数不变。 例如，如果我们加载一个每像素 1 位的黑白 PNG 图像，然后使用 DataStreamSupporter.save(file_path) 方法保存，它将生成每像素 8 位的输出 PNG 图像。 为避免这种情况并以每像素 1 位保存 PNG 图像，请使用此方法获取相应的保存选项，并将其 作为第二个参数传递给 Image.save(file_path, options) 方法。
get_preview_image(format)	检索指定 format 的现有预览图像，或 在未找到时返回 None。此方法在 访问针对特定格式定制的预览图像时提供灵活性，优化应用中的兼容性和 资源管理。
get_preview_images()	访问链接到 EpsImage 实例的预览图像，允许 在应用中无缝检索以进行检查或使用。此方法 提供便捷的预览图像访问，提升用户与图像数据的交互体验。
get_proportional_height(width, height, new_width)	获取比例高度。
get_proportional_width(width, height, new_height)	获取比例宽度。
get_serialized_stream(image_options, clipping_rectangle, page_number)	转换为 aps。
load(file_path)	从指定的文件路径或 URL 加载新图像。 如果 filePath 是文件路径，方法仅打开该文件。 如果 filePath 是 URL，方法会下载文件，将其存为临时文件，然后打开它。
load(file_path, load_options)	从指定的文件路径或 URL 加载新图像。 如果 filePath 是文件路径，方法仅打开该文件。 如果 filePath 是 URL，方法会下载文件，将其存为临时文件，然后打开它。
load(stream)	从指定的流加载新图像。
load(stream, load_options)	从指定的流加载新图像。
load_stream(stream)	从指定的流加载新图像。
load_stream_with_options(stream, load_options)	从指定的流加载新图像。
load_with_options(file_path, load_options)	从指定的文件路径或 URL 加载新图像。 如果 filePath 是文件路径，方法仅打开该文件。 如果 filePath 是 URL，方法会下载文件，将其存为临时文件，然后打开它。
remove_background()	移除背景。
remove_background(settings)	移除背景。
remove_metadata()	移除元数据。
resize(new_width, new_height)	调整图像大小。使用默认的 ResizeType.NEAREST_NEIGHBOUR_RESAMPLE。
resize(new_width, new_height, resize_type)	调整指定的新宽度。
resize(new_width, new_height, settings)	使用扩展选项调整图像大小。
resize_by_settings(new_width, new_height, settings)	调整图像大小。
resize_by_type(new_width, new_height, resize_type)	调整图像大小。
resize_height_proportionally(new_height)	按比例调整高度。默认使用 ResizeType.NEAREST_NEIGHBOUR_RESAMPLE。
resize_height_proportionally(new_height, resize_type)	按比例调整高度。
resize_height_proportionally(new_height, settings)	按比例调整高度。
resize_height_proportionally_settings(new_height, settings)	按比例调整高度。
resize_width_proportionally(new_width)	按比例调整宽度。默认使用 ResizeType.NEAREST_NEIGHBOUR_RESAMPLE。
resize_width_proportionally(new_width, resize_type)	按比例调整宽度。
resize_width_proportionally(new_width, settings)	按比例调整宽度。
resize_width_proportionally_settings(new_width, settings)	按比例调整宽度。
rotate(angle)	围绕中心旋转图像。
rotate_flip(rotate_flip_type)	旋转、翻转或同时旋转和翻转图像。
save()	将图像数据保存到底层流中。
save(file_path)	将图像保存到指定的文件位置。
save(file_path, options)	根据保存选项，将对象的数据保存到指定文件位置的指定文件格式中。
save(file_path, options, bounds_rectangle)	根据保存选项，将对象的数据保存到指定文件位置的指定文件格式中。
save(file_path, over_write)	将对象的数据保存到指定的文件位置。
save(stream)	保存数据。
save(stream, options_base)	根据保存选项，将图像的数据保存到指定流中的指定文件格式。
save(stream, options_base, bounds_rectangle)	根据保存选项，将图像的数据保存到指定流中的指定文件格式。
save_to_stream(stream)	将对象的数据保存到指定的流中。
save_to_stream_with_options(stream, options_base)	根据保存选项，将图像的数据保存到指定流中的指定文件格式。
save_to_stream_with_options_rect(stream, options_base, bounds_rectangle)	根据保存选项，将图像的数据保存到指定流中的指定文件格式。
save_with_options(file_path, options)	根据保存选项，将对象的数据保存到指定文件位置的指定文件格式中。
save_with_options_rect(file_path, options, bounds_rectangle)	根据保存选项，将对象的数据保存到指定文件位置的指定文件格式中。
set_palette(palette, update_colors)	自定义图像调色板以实现独特的配色方案并提升视觉吸引力。 为特定效果调整颜色，并轻松在不同平台和设备上优化图像质量。
try_set_metadata(metadata)	尝试设置一个 metadata 实例，前提是此 Image 实例支持并实现 IImageMetadataFormat 实例。

Method: can_load(file_path) [static]

 can_load(file_path) 

确定是否可以从指定的文件路径加载图像。

Parameters:

参数	Type	Description
file_path	string	文件路径。

Returns

Type	Description
bool	true 如果可以从指定文件加载图像；否则为 false。

Method: can_load(file_path, load_options) [static]

 can_load(file_path, load_options) 

确定是否可以从指定的文件路径加载图像，并可选地使用指定的打开选项。

Parameters:

参数	Type	Description
file_path	string	文件路径。
load_options	LoadOptions	加载选项。

Returns

Type	Description
bool	true 如果可以从指定文件加载图像；否则为 false。

Method: can_load(stream) [static]

 can_load(stream) 

确定是否可以从指定的流加载图像。

Parameters:

参数	Type	Description
流	_io.BufferedRandom	要加载的流。

Returns

Type	Description
bool	true 如果可以从指定流加载图像；否则为 false。

Method: can_load(stream, load_options) [static]

 can_load(stream, load_options) 

确定是否可以从指定的流加载图像，并可选地使用指定的 loadOptions。

Parameters:

参数	Type	Description
流	_io.BufferedRandom	要加载的流。
load_options	LoadOptions	加载选项。

Returns

Type	Description
bool	true 如果可以从指定流加载图像；否则为 false。

Method: can_load_stream(stream) [static]

 can_load_stream(stream) 

确定是否可以从指定的流加载图像。

Parameters:

参数	Type	Description
流	_io.BufferedRandom	要加载的流。

Returns

Type	Description
bool	true 如果可以从指定流加载图像；否则为 false。

Method: can_load_stream_with_options(stream, load_options) [static]

 can_load_stream_with_options(stream, load_options) 

确定是否可以从指定的流加载图像，并可选地使用指定的 loadOptions。

Parameters:

参数	Type	Description
流	_io.BufferedRandom	要加载的流。
load_options	LoadOptions	加载选项。

Returns

Type	Description
bool	true 如果可以从指定流加载图像；否则为 false。

Method: can_load_with_options(file_path, load_options) [static]

 can_load_with_options(file_path, load_options) 

确定是否可以从指定的文件路径加载图像，并可选地使用指定的打开选项。

Parameters:

参数	Type	Description
file_path	string	文件路径。
load_options	LoadOptions	加载选项。

Returns

Type	Description
bool	true 如果可以从指定文件加载图像；否则为 false。

Method: can_save(options)

 can_save(options) 

确定是否可以将图像保存为由传入的保存选项表示的指定文件格式。

Parameters:

参数	Type	Description
options	ImageOptionsBase	要使用的保存选项。

Returns

Type	Description
bool	true 如果图像可以保存为由传入的保存选项表示的指定文件格式；否则为 false。

Method: create(files) [static]

 create(files) 

创建包含指定文件的多页图像。

Parameters:

参数	Type	Description
文件	string[]	文件。

Returns

Type	Description
Image	多页图像

Method: create(files, throw_exception_on_load_error) [static]

 create(files, throw_exception_on_load_error) 

创建包含指定文件的多页图像。

Parameters:

参数	Type	Description
文件	string[]	文件。
throw_exception_on_load_error	bool	如果设置为 true [throw exception on load error]。

Returns

Type	Description
Image	多页图像

Method: create(image_options, width, height) [static]

 create(image_options, width, height) 

使用指定的创建选项创建新图像。

Parameters:

参数	Type	Description
image_options	ImageOptionsBase	图像选项。
width	int	宽度。
height	int	高度。

Returns

Type	Description
Image	新创建的图像。

Method: create(image_options, width, height, pixels) [static]

 create(image_options, width, height, pixels) 

创建一个来自提供的像素数组的 RasterImage 实例。

验证指定的宽度和高度是否与像素数据的维度匹配。
仅当库处于授权模式时才能使用此方法。

Parameters:

参数	Type	Description
image_options	ImageOptionsBase	用于创建 RasterImage 的选项。
width	int	RasterImage 的宽度。
height	int	RasterImage 的高度。
像素	int[]	用于填充图像的像素值数组。

Returns

Type	Description
Image	使用提供的像素数据填充的 RasterImage。

Method: create(images) [static]

 create(images) 

使用指定的图像作为页面创建新图像。

Parameters:

参数	Type	Description
images	Image[]	图像。

Returns

Type	Description
Image	Image 作为 IMultipageImage

Method: create(images, dispose_images) [static]

 create(images, dispose_images) 

创建一个新图像，将指定的图像作为页面。

Parameters:

参数	Type	Description
images	Image[]	图像。
dispose_images	bool	如果设置为 true [dispose images]。

Returns

Type	Description
Image	Image 作为 IMultipageImage

Method: create(multipage_create_options) [static]

 create(multipage_create_options) 

创建指定的多页创建选项。

Parameters:

参数	Type	Description
multipage_create_options	MultipageCreateOptions	多页创建选项。

Returns

Type	Description
Image	多页图像

Method: create_from_files(files) [static]

 create_from_files(files) 

创建包含指定文件的多页图像，将其作为延迟加载页面。

Parameters:

参数	Type	Description
文件	string[]	文件。

Returns

Type	Description
Image	多页图像

Method: create_from_files(files, throw_exception_on_load_error) [static]

 create_from_files(files, throw_exception_on_load_error) 

创建包含指定文件的多页图像，将其作为延迟加载页面。

Parameters:

参数	Type	Description
文件	string[]	文件。
throw_exception_on_load_error	bool	如果设置为 true 抛出加载错误异常。

Returns

Type	Description
Image	多页图像

Method: create_from_images(images) [static]

 create_from_images(images) 

使用指定的图像作为页面创建新图像。

Parameters:

参数	Type	Description
images	Image[]	图像。

Returns

Type	Description
Image	Image 作为 IMultipageImage

Method: create_from_images(images, dispose_images) [static]

 create_from_images(images, dispose_images) 

创建一个新图像，将指定的图像作为页面。

Parameters:

参数	Type	Description
images	Image[]	图像。
dispose_images	bool	如果设置为 true [dispose images]。

Returns

Type	Description
Image	Image 作为 IMultipageImage

Method: crop(left_shift, right_shift, top_shift, bottom_shift)

 crop(left_shift, right_shift, top_shift, bottom_shift) 

使用位移裁剪图像。

Parameters:

参数	Type	Description
left_shift	int	左移。
right_shift	int	右移。
top_shift	int	上移。
bottom_shift	int	下移。

Method: crop(rectangle)

 crop(rectangle) 

裁剪指定的矩形。

Parameters:

参数	Type	Description
rectangle	Rectangle	矩形。

Method: get_default_options(args)

 get_default_options(args) 

获取默认图像选项。

Parameters:

参数	Type	Description
args	System.Object	参数。

Returns

Type	Description
ImageOptionsBase	默认图像选项。

Method: get_embedded_images()

 get_embedded_images() 

获取嵌入的图像。

Returns

Type	Description
EmbeddedImage[]	图像数组

Method: get_file_format(file_path) [static]

 get_file_format(file_path) 

获取文件格式。

Parameters:

参数	Type	Description
file_path	string	文件路径。

Returns

Type	Description
FileFormat	确定的文件格式。

Method: get_file_format(stream) [static]

 get_file_format(stream) 

获取文件格式。

Parameters:

参数	Type	Description
流	_io.BufferedRandom	该流。

Returns

Type	Description
FileFormat	确定的文件格式。

Method: get_file_format_of_stream(stream) [static]

 get_file_format_of_stream(stream) 

获取文件格式。

Parameters:

参数	Type	Description
流	_io.BufferedRandom	该流。

Returns

Type	Description
FileFormat	确定的文件格式。

Method: get_fitting_rectangle(rectangle, pixels, width, height) [static]

 get_fitting_rectangle(rectangle, pixels, width, height) 

获取适合当前图像的矩形。

Parameters:

参数	Type	Description
rectangle	Rectangle	用于获取合适矩形的矩形。
像素	int[]	32 位 ARGB 像素。
width	int	对象宽度。
height	int	对象高度。

Returns

Type	Description
Rectangle	适配矩形，若未找到适配矩形则抛出异常。

Method: get_fitting_rectangle(rectangle, width, height) [static]

 get_fitting_rectangle(rectangle, width, height) 

获取适合当前图像的矩形。

Parameters:

参数	Type	Description
rectangle	Rectangle	用于获取合适矩形的矩形。
width	int	对象宽度。
height	int	对象高度。

Returns

Type	Description
Rectangle	适配矩形，若未找到适配矩形则抛出异常。

Method: get_original_options()

 get_original_options() 

根据原始文件设置获取选项。
这有助于保持原始图像的位深度和其他参数不变。
例如，如果我们加载一个每像素 1 位的黑白 PNG 图像，然后使用
DataStreamSupporter.save(file_path) 方法保存，它将生成每像素 8 位的输出 PNG 图像。
为避免这种情况并以每像素 1 位保存 PNG 图像，请使用此方法获取相应的保存选项，并将其
作为第二个参数传递给 Image.save(file_path, options) 方法。

Returns

Type	Description
ImageOptionsBase	基于原始文件设置的选项。

Method: get_preview_image(format)

 get_preview_image(format) 

检索指定 format 的现有预览图像，或
在未找到时返回 None。此方法在
访问针对特定格式定制的预览图像时提供灵活性，优化应用中的兼容性和
资源管理。

Parameters:

参数	Type	Description
format	EpsPreviewFormat	EPS 预览图像格式。

Returns

Type	Description
Image	现有的预览图像或 None。

Method: get_preview_images()

 get_preview_images() 

访问链接到 EpsImage 实例的预览图像，允许
在应用中无缝检索以进行检查或使用。此方法
提供便捷的预览图像访问，提升用户与图像数据的交互体验。

Returns

Type	Description
System.Collections.Generic.IEnumerable`1[[Aspose.Imaging.Image]]	预览图像。

Method: get_proportional_height(width, height, new_width) [static]

 get_proportional_height(width, height, new_width) 

获取比例高度。

Parameters:

参数	Type	Description
width	int	宽度。
height	int	高度。
new_width	int	新的宽度。

Returns

Type	Description
int	比例高度。

Method: get_proportional_width(width, height, new_height) [static]

 get_proportional_width(width, height, new_height) 

获取比例宽度。

Parameters:

参数	Type	Description
width	int	宽度。
height	int	高度。
new_height	int	新的高度。

Returns

Type	Description
int	比例宽度。

Method: get_serialized_stream(image_options, clipping_rectangle, page_number)

 get_serialized_stream(image_options, clipping_rectangle, page_number) 

转换为 aps。

Parameters:

参数	Type	Description
image_options	ImageOptionsBase	图像选项。
clipping_rectangle	Rectangle	裁剪矩形。
page_number	int[]	页码。

Returns

Type	Description
_io.BufferedRandom	序列化流

Method: load(file_path) [static]

 load(file_path) 

从指定的文件路径或 URL 加载新图像。
如果 filePath 是文件路径，方法仅打开该文件。
如果 filePath 是 URL，方法会下载文件，将其存为临时文件，然后打开它。

Parameters:

参数	Type	Description
file_path	string	加载图像的文件路径或 URL。

Returns

Type	Description
Image	已加载的图像。

Method: load(file_path, load_options) [static]

 load(file_path, load_options) 

从指定的文件路径或 URL 加载新图像。
如果 filePath 是文件路径，方法仅打开该文件。
如果 filePath 是 URL，方法会下载文件，将其存为临时文件，然后打开它。

Parameters:

参数	Type	Description
file_path	string	加载图像的文件路径或 URL。
load_options	LoadOptions	加载选项。

Returns

Type	Description
Image	已加载的图像。

Method: load(stream) [static]

 load(stream) 

从指定的流加载新图像。

Parameters:

参数	Type	Description
流	_io.BufferedRandom	加载图像的流。

Returns

Type	Description
Image	已加载的图像。

Method: load(stream, load_options) [static]

 load(stream, load_options) 

从指定的流加载新图像。

Parameters:

参数	Type	Description
流	_io.BufferedRandom	加载图像的流。
load_options	LoadOptions	加载选项。

Returns

Type	Description
Image	已加载的图像。

Method: load_stream(stream) [static]

 load_stream(stream) 

从指定的流加载新图像。

Parameters:

参数	Type	Description
流	_io.BufferedRandom	加载图像的流。

Returns

Type	Description
Image	已加载的图像。

Method: load_stream_with_options(stream, load_options) [static]

 load_stream_with_options(stream, load_options) 

从指定的流加载新图像。

Parameters:

参数	Type	Description
流	_io.BufferedRandom	加载图像的流。
load_options	LoadOptions	加载选项。

Returns

Type	Description
Image	已加载的图像。

Method: load_with_options(file_path, load_options) [static]

 load_with_options(file_path, load_options) 

从指定的文件路径或 URL 加载新图像。
如果 filePath 是文件路径，方法仅打开该文件。
如果 filePath 是 URL，方法会下载文件，将其存为临时文件，然后打开它。

Parameters:

参数	Type	Description
file_path	string	加载图像的文件路径或 URL。
load_options	LoadOptions	加载选项。

Returns

Type	Description
Image	已加载的图像。

Method: remove_background(settings)

 remove_background(settings) 

移除背景。

Parameters:

参数	Type	Description
settings	RemoveBackgroundSettings	设置。

Method: resize(new_width, new_height)

 resize(new_width, new_height) 

调整图像大小。使用默认的 ResizeType.NEAREST_NEIGHBOUR_RESAMPLE。

Parameters:

参数	Type	Description
new_width	int	新的宽度。
new_height	int	新的高度。

Method: resize(new_width, new_height, resize_type)

 resize(new_width, new_height, resize_type) 

调整指定的新宽度。

Parameters:

参数	Type	Description
new_width	int	新的宽度。
new_height	int	新的高度。
resize_type	ResizeType	调整大小的类型。

See also:

Example # 1: Resize EPS image and export it to PNG format.

Method: resize(new_width, new_height, settings)

 resize(new_width, new_height, settings) 

使用扩展选项调整图像大小。

Parameters:

参数	Type	Description
new_width	int	新的宽度。
new_height	int	新的高度。
settings	ImageResizeSettings	调整大小设置。

See also:

Example # 1: Resize EPS image using advanced settings.

Method: resize_by_settings(new_width, new_height, settings)

 resize_by_settings(new_width, new_height, settings) 

调整图像大小。

Parameters:

参数	Type	Description
new_width	int	新的宽度。
new_height	int	新的高度。
settings	ImageResizeSettings	调整大小设置。

Method: resize_by_type(new_width, new_height, resize_type)

 resize_by_type(new_width, new_height, resize_type) 

调整图像大小。

Parameters:

参数	Type	Description
new_width	int	新的宽度。
new_height	int	新的高度。
resize_type	ResizeType	调整大小类型。

Method: resize_height_proportionally(new_height)

 resize_height_proportionally(new_height) 

按比例调整高度。默认使用 ResizeType.NEAREST_NEIGHBOUR_RESAMPLE。

Parameters:

参数	Type	Description
new_height	int	新的高度。

Method: resize_height_proportionally(new_height, resize_type)

 resize_height_proportionally(new_height, resize_type) 

按比例调整高度。

Parameters:

参数	Type	Description
new_height	int	新的高度。
resize_type	ResizeType	调整大小的类型。

Method: resize_height_proportionally(new_height, settings)

 resize_height_proportionally(new_height, settings) 

按比例调整高度。

Parameters:

参数	Type	Description
new_height	int	新的高度。
settings	ImageResizeSettings	图像调整大小设置。

Method: resize_height_proportionally_settings(new_height, settings)

 resize_height_proportionally_settings(new_height, settings) 

按比例调整高度。

Parameters:

参数	Type	Description
new_height	int	新的高度。
settings	ImageResizeSettings	图像调整大小设置。

Method: resize_width_proportionally(new_width)

 resize_width_proportionally(new_width) 

按比例调整宽度。默认使用 ResizeType.NEAREST_NEIGHBOUR_RESAMPLE。

Parameters:

参数	Type	Description
new_width	int	新的宽度。

Method: resize_width_proportionally(new_width, resize_type)

 resize_width_proportionally(new_width, resize_type) 

按比例调整宽度。

Parameters:

参数	Type	Description
new_width	int	新的宽度。
resize_type	ResizeType	调整大小的类型。

Method: resize_width_proportionally(new_width, settings)

 resize_width_proportionally(new_width, settings) 

按比例调整宽度。

Parameters:

参数	Type	Description
new_width	int	新的宽度。
settings	ImageResizeSettings	图像调整大小设置。

Method: resize_width_proportionally_settings(new_width, settings)

 resize_width_proportionally_settings(new_width, settings) 

按比例调整宽度。

Parameters:

参数	Type	Description
new_width	int	新的宽度。
settings	ImageResizeSettings	图像调整大小设置。

Method: rotate(angle)

 rotate(angle) 

围绕中心旋转图像。

Parameters:

参数	Type	Description
角度	float	旋转角度（以度为单位）。正值将顺时针旋转。

Method: rotate_flip(rotate_flip_type)

 rotate_flip(rotate_flip_type) 

旋转、翻转或同时旋转和翻转图像。

Parameters:

参数	Type	Description
rotate_flip_type	RotateFlipType	旋转翻转的类型。

Method: save(file_path)

 save(file_path) 

将图像保存到指定的文件位置。

Parameters:

参数	Type	Description
file_path	string	保存图像的文件路径。

Method: save(file_path, options)

 save(file_path, options) 

根据保存选项，将对象的数据保存到指定文件位置的指定文件格式中。

Parameters:

参数	Type	Description
file_path	string	文件路径。
options	ImageOptionsBase	选项。

Method: save(file_path, options, bounds_rectangle)

 save(file_path, options, bounds_rectangle) 

根据保存选项，将对象的数据保存到指定文件位置的指定文件格式中。

Parameters:

参数	Type	Description
file_path	string	文件路径。
options	ImageOptionsBase	选项。
bounds_rectangle	Rectangle	目标图像边界矩形。将空矩形设置为使用源边界。

Method: save(file_path, over_write)

 save(file_path, over_write) 

将对象的数据保存到指定的文件位置。

Parameters:

参数	Type	Description
file_path	string	保存对象数据的文件路径。
over_write	bool	如果设置为 true，覆盖文件内容，否则将追加。

Method: save(stream)

 save(stream) 

保存数据。

Parameters:

参数	Type	Description
流	_io.BufferedRandom	保存数据的流。

Method: save(stream, options_base)

 save(stream, options_base) 

根据保存选项，将图像的数据保存到指定流中的指定文件格式。

Parameters:

参数	Type	Description
流	_io.BufferedRandom	保存图像数据的流。
options_base	ImageOptionsBase	保存选项。

Method: save(stream, options_base, bounds_rectangle)

 save(stream, options_base, bounds_rectangle) 

根据保存选项，将图像的数据保存到指定流中的指定文件格式。

Parameters:

参数	Type	Description
流	_io.BufferedRandom	保存图像数据的流。
options_base	ImageOptionsBase	保存选项。
bounds_rectangle	Rectangle	目标图像边界矩形。将空矩形设置为使用源边界。

Method: save_to_stream(stream)

 save_to_stream(stream) 

将对象的数据保存到指定的流中。

Parameters:

参数	Type	Description
流	_io.BufferedRandom	用于保存对象数据的流。

Method: save_to_stream_with_options(stream, options_base)

 save_to_stream_with_options(stream, options_base) 

根据保存选项，将图像的数据保存到指定流中的指定文件格式。

Parameters:

参数	Type	Description
流	_io.BufferedRandom	保存图像数据的流。
options_base	ImageOptionsBase	保存选项。

Method: save_to_stream_with_options_rect(stream, options_base, bounds_rectangle)

 save_to_stream_with_options_rect(stream, options_base, bounds_rectangle) 

根据保存选项，将图像的数据保存到指定流中的指定文件格式。

Parameters:

参数	Type	Description
流	_io.BufferedRandom	保存图像数据的流。
options_base	ImageOptionsBase	保存选项。
bounds_rectangle	Rectangle	目标图像边界矩形。将空矩形设置为使用源边界。

Method: save_with_options(file_path, options)

 save_with_options(file_path, options) 

根据保存选项，将对象的数据保存到指定文件位置的指定文件格式中。

Parameters:

参数	Type	Description
file_path	string	文件路径。
options	ImageOptionsBase	选项。

Method: save_with_options_rect(file_path, options, bounds_rectangle)

 save_with_options_rect(file_path, options, bounds_rectangle) 

根据保存选项，将对象的数据保存到指定文件位置的指定文件格式中。

Parameters:

参数	Type	Description
file_path	string	文件路径。
options	ImageOptionsBase	选项。
bounds_rectangle	Rectangle	目标图像边界矩形。将空矩形设置为使用源边界。

Method: set_palette(palette, update_colors)

 set_palette(palette, update_colors) 

自定义图像调色板以实现独特的配色方案并提升视觉吸引力。
为特定效果调整颜色，并轻松在不同平台和设备上优化图像质量。

Parameters:

参数	Type	Description
palette	IColorPalette	要设置的调色板。
update_colors	bool	如果设置为 true，颜色将根据新调色板进行更新；否则颜色索引保持不变。请注意，未更改的索引如果在加载时没有对应的调色板条目，可能会导致图像崩溃。

Method: try_set_metadata(metadata)

 try_set_metadata(metadata) 

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

Parameters:

参数	Type	Description
metadata	IImageMetadataFormat	元数据。

Returns

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

Examples

Convert EPS image to PNG using PostScript rendering.

import aspose.pycore as aspycore
from aspose.imaging import Image
from aspose.imaging.fileformats.eps import EpsImage, EpsPreviewFormat
from aspose.imaging.imageoptions import PngOptions

with aspycore.as_of(Image.load("Sample.eps"), EpsImage) as image:
	obj_init = EpsRasterizationOptions()
	obj_init.page_width = 500
	obj_init.page_height = 500
	obj_init.preview_to_export = EpsPreviewFormat.POST_SCRIPT_RENDERING
	options = PngOptions()
	obj_init2.vector_rasterization_options = obj_init
	# 使用 PostScript 渲染光栅图像
	image.save("Sample.png", options)
	

Convert EPS image to PDF using PostScript rendering.

from aspose.imaging import Image, PdfComplianceVersion
from aspose.imaging.imageoptions import PdfOptions
from aspose.imaging.fileformats.pdf import PdfCoreOptions

with Image.load("Sample.eps") as image:
	options = PdfOptions()
	options.pdf_core_options = PdfCoreOptions()
	options.pdf_core_options.pdf_compliance = PdfComplianceVersion.PDF_A1B # Set required PDF compliance
	image.save("Sample.pdf", options)

Resize EPS image and export it to PNG format.

from aspose.imaging import Image, ResizeType
from aspose.imaging.imageoptions import PngOptions

# 加载 EPS 图像
with Image.load("AstrixObelix.eps") as image:
	# 使用 Mitchell 三次插值方法调整图像大小
	image.resize(400, 400, ResizeType.MITCHELL)

	# 导出图像为 PNG 格式
	image.save("ExportResult.png", PngOptions())

Resize EPS image using advanced settings.

import aspose.pycore as aspycore
from aspose.imaging import Image, ImageResizeSettings, ResizeType, ImageFilterType, ColorCompareMethod, ColorQuantizationMethod
from aspose.imaging.imageoptions import PngOptions

#加载 EPS 图像
with Image.load("AstrixObelix.eps") as image:
	# 使用高级调整设置调整图像大小
	obj_init = ImageResizeSettings()
	obj_init.mode = ResizeType.LANCZOS_RESAMPLE
	obj_init.filter_type = ImageFilterType.SMALL_RECTANGULAR
	obj_init.color_compare_method = ColorCompareMethod.EUCLIDIAN
	obj_init.color_quantization_method = ColorQuantizationMethod.POPULARITY
	image.resize(400, 400, obj_init)
	# 导出图像为 PNG 格式
	image.save("ExportResult.png", PngOptions())