BigTiffImage 类

Summary: With the BigTiffImage class you can effortlessly manipulate
BigTiff image format files. Our API offering seamless handling and customization
options, ensuring optimal processing of large-scale image data with versatile features
tailored to your specific requirements.

Module: aspose.imaging.fileformats.bigtiff

Full Name: aspose.imaging.fileformats.bigtiff.BigTiffImage

Inheritance: IObjectWithBounds, IMetadataContainer, IHasExifData, IHasMetadata, IHasXmpData, IRasterImageArgb32PixelLoader, IRasterImageRawDataLoader, IMultipageImage, IMultipageImageExt, TiffImage

Constructors

Name	描述
BigTiffImage(frame)	通过初始化 使用 TiffFrame 参数来创建 BigTiffImage 类的新实例。非常适合希望以便捷方式使用 BigTiffImage 对象的开发者，确保灵活性并易于将其集成 到项目中。
BigTiffImage(frames)	通过 使用 TiffFrames 列表参数初始化新实例，开始无缝使用 BigTiffImage 类。 非常适合希望以直接方式处理包含多个帧的 BigTiffImage 对象的开发者，确保项目的高效性。

Properties

Name	Type	Access	描述
active_frame	TiffFrame	r/w	无缝管理活动帧，促进在指定上下文中的动态导航和 操作。让您的应用程序能够高效地与多媒体内容交互，提升用户参与度和生产力。
auto_adjust_palette	bool	r/w	获取或设置一个值，指示是否自动调整调色板。
background_color	Color	r/w	获取或设置背景颜色的值。
bits_per_pixel	int	r	获取图像每像素位数计数。
bounds	Rectangle	r	获取对象的边界。
buffer_size_hint	int	r/w	获取或设置缓冲区大小提示，该提示定义了所有内部缓冲区的最大允许大小。
byte_order	TiffByteOrder	r/w	无缝切换 TIFF 文件的字节序，确保对 数据解释的精确控制。为您的应用程序提供灵活性，以适应 多种文件规范，提升兼容性和数据处理的效率。
container	Image	r	获取 Image 容器。
data_stream_container	StreamContainer	r	获取对象的数据流。
disposed	bool	r	获取一个值，指示此实例是否已释放。
exif_data	ExifData	r/w	获取或设置 Exif 实例。
file_format	FileFormat	r	获取此 Image 实例的文件格式。
frames	TiffFrame[]	r	检索 TiffFrame 实例的数组，以实现对 TIFF 图像中各个帧的全面 访问和操作。利用该数组的强大功能来简化图像处理工作流，确保对视觉内容的精确 控制和优化。
has_alpha	bool	r	确定图像是否具有 alpha 通道，为渲染和合成操作提供关键信息 。将此功能集成到视觉处理工作流中，以优化 流程，确保对透明元素的准确 表现和操作。
has_background_color	bool	r/w	获取或设置指示图像是否具有背景颜色的值。
has_transparent_color	bool	r/w	获取指示图像是否具有透明颜色的值。
height	int	r	获取对象的高度。
horizontal_resolution	float	r/w	检索指定 Image 的水平分辨率（每英寸像素） ，以便实现精确的调整和渲染能力。 轻松访问必需的图像元数据，提升图像处理工作流的效率， 为增强用户体验提供支持。
image_opacity	float	r	获取此图像的不透明度。
interrupt_monitor	InterruptMonitor	r/w	获取或设置中断监视器。
is_cached	bool	r	获取指示图像数据当前是否已缓存的值。
is_raw_data_available	bool	r	获取指示是否支持原始数据加载的值。
metadata	ImageMetadata	r	获取或设置来自帧的 XMP 数据。
page_count	int	r	检索指定文档的总页数，以便 高效导航和管理多页内容。整合此 功能以提升用户体验，实现对 完整文档结构的无缝访问。
pages	Image[]	r	无缝访问文档的页面，支持在内容结构内的动态导航和 操作。为您的应用程序提供高效的单页访问， 简化文档处理流程， 并提升用户交互体验。
palette	IColorPalette	r/w	获取或设置颜色调色板。当像素直接表示时，不使用颜色调色板。
premultiply_components	bool	r/w	指示组件是否需要预乘，以确保对视觉元素的高效处理 。通过切换此属性来提升渲染过程， 简化图形工作流，实现性能优化。
raw_custom_color_converter	IColorConverter	r/w	获取或设置自定义颜色转换器
raw_data_format	PixelDataFormat	r	获取原始数据格式。
raw_data_settings	RawDataSettings	r	获取当前原始数据设置。注意，使用这些设置时，数据将在不进行转换的情况下加载。
raw_fallback_index	int	r/w	获取或设置当调色板索引超出范围时使用的回退索引
raw_indexed_color_converter	IIndexedColorConverter	r/w	获取或设置索引颜色转换器
raw_line_size	int	r	获取以字节为单位的原始行大小。
size	Size	r	获取对象大小。
transparent_color	Color	r/w	获取图像的透明颜色。
update_xmp_data	bool	r/w	获取或设置一个值，指示是否更新 XMP 元数据。
use_palette	bool	r	获取一个值，指示是否使用图像调色板。
use_raw_data	bool	r/w	获取或设置一个值，指示在可用原始数据加载时是否使用原始数据加载。
vertical_resolution	float	r/w	获取指定 Image 的垂直分辨率（每英寸像素） ，实现精确的调整和渲染优化。 轻松利用关键的图像数据，简化图像处理工作流， 确保应用程序的卓越质量和性能。
width	int	r	获取对象的宽度。
xmp_data	XmpPacketWrapper	r/w	获取或设置 Xmp 数据。

Methods

Name	描述
add(image)	将指定图像的帧无缝添加到当前帧中， 整合其内容并提升组合灵活性。将此方法集成到您的应用程序中， 简化帧管理和操作， 促进对多帧图像的高效处理。
add_frame(frame)	将指定帧无缝合并到图像中，扩展其内容和多样性。 利用此方法提升图像组合和管理， 使您的应用程序能够高效处理多帧图像。
add_frames(frames)	将帧数组无缝集成到图像中，丰富其内容和多样性。 利用此方法提升图像组合和管理， 使您的应用程序能够高效处理多帧图像。
add_page(page)	通过此直观方法轻松为您的 BigTiff 图像添加新页面， 非常适合希望动态增强多页图像内容的开发者。
adjust_brightness(brightness)	实现对图像的 brightness 调整，允许 修改整体亮度水平。将此方法整合到您的图像处理工作流中， 以提升可见性并改善 应用程序中图像的视觉质量。
adjust_contrast(contrast)	提升 Image 实例的对比度， 放大其亮暗区域的差异。 将此功能集成，以改善图像的视觉清晰度和整体质量， 为您的应用程序提供更佳的图像表现。
adjust_gamma(gamma)	对图像应用伽马校正，调整像素强度以实现 所需的色彩平衡。将此方法纳入您的图像处理 工作流，以提升视觉质量并提高后续 分析或显示任务的准确性。
adjust_gamma(gamma_red, gamma_green, gamma_blue)	使用红、 绿和蓝通道的单独系数对图像进行伽马校正，以实现对色彩平衡 和对比度的精细调节。将此方法集成到您的图像处理管道中， 实现对颜色渲染的精确控制，并在您的应用程序中提升视觉保真度。
align_resolutions()	实现 AlignResolutions 辅助方法，以同步水平和 垂直分辨率，确保图像尺寸的一致性。此功能 通过统一分辨率参数，优化视觉质量和跨各种平台与 设备的一致性，从而简化图像处理工作流。
analyze_percentage_digital_signature(password)	计算提取数据与原始密码之间的相似度百分比。
auto_brightness_contrast()	对整个图像执行自动自适应亮度和对比度归一化。
auto_rotate()	自动根据从 Exif 元数据中提取的方向数据旋转图像。此方法确保图像以正确的方向显示， 提升用户体验并消除手动调整的需求。通过 分析 Exif 信息，图像相应旋转，提供跨不同平台和设备的无缝 浏览体验。此自动旋转过程简化了图像处理，并在处理大量方向各异的图像批次时， 提高整体可用性。
binarize_bradley(brightness_difference)	使用 Bradley 的自适应阈值算法和积分图阈值进行图像二值化
binarize_bradley(brightness_difference, window_size)	在图像上实现二值化，采用 Bradley 自适应阈值 算法结合积分图阈值。此方法根据图像邻域动态计算 局部阈值，提升对不同光照条件的适应性，并确保后续 处理任务的稳健分割。
binarize_fixed(threshold)	使用预定义阈值对图像进行二值化，将其转换为 前景和背景区域明确的二值图像。将此方法纳入您的图像处理工作流，以便于分割和特征 提取任务，提升图像分析的准确性和效率。
binarize_otsu()	利用 Otsu 阈值法对图像进行二值化，自动 根据图像直方图确定最佳阈值。将此方法集成到您的图像处理工作流，以实现有效的分割 和特征提取，提升图像分析任务的准确性和可靠性。
blend(origin, overlay, overlay_alpha)	将此图像实例与 overlay 图像混合。
blend(origin, overlay, overlay_area, overlay_alpha)	将此图像实例与 overlay 图像混合。
cache_data()	缓存私有数据。
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)	创建一个新图像，将指定的图像作为页面。
create_with_frame(frame)	初始化 BigTiffImage 类的新实例。
create_with_frames(frames)	初始化 BigTiffImage 类的新实例。
crop(left_shift, right_shift, top_shift, bottom_shift)	通过指定左、右、上、 下方向的位移对图像进行裁剪。此方法能够精确选择图像的所需部分， 高效去除不需要的区域并聚焦于关键内容。将此功能集成到您的图像处理 管道中，以在需要时提升图像的清晰度和构图。
crop(rectangle)	使用指定的矩形区域裁剪图像，精确选择所需内容。将此方法集成到您的图像处理工作流中， 高效去除不需要的区域并聚焦关键细节，提升图像的整体清晰度和构图。
dither(dithering_method, bits_count)	对当前图像执行抖动处理。
dither(dithering_method, bits_count, custom_palette)	对当前图像执行抖动处理，以提升视觉质量并减少 颜色带状伪影。将此方法纳入您的图像处理工作流， 确保颜色过渡更平滑，从而改善整体图像外观和清晰度。
embed_digital_signature(password)	根据提供的密码将数字签名嵌入图像的每一页。
filter(rectangle, options)	在指定矩形区域内过滤内容，应用指定的图像 处理滤镜以增强或修改所选区域。将此方法 集成到您的图像操作工作流中，以实现针对性的增强或 转换，在您的应用程序中。
get_argb_32_pixel(x, y)	获取图像的 32 位 ARGB 像素。
get_default_argb_32_pixels(rectangle)	获取默认的 32 位 ARGB 像素数组。
get_default_options(args)	获取默认选项。
get_default_pixels(rectangle, partial_pixel_loader)	使用部分像素加载器获取默认像素数组。
get_default_raw_data(rectangle, partial_raw_data_loader, raw_data_settings)	使用部分像素加载器获取默认原始数据数组。
get_default_raw_data(rectangle, raw_data_settings)	获取默认原始数据数组。
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_modify_date(use_default)	获取资源图像最后修改的日期和时间。
get_original_options()	检索源文件设置派生的选项，便于无缝 保留关键参数，如位深度和原始图像的其他重要属性。使用此方法在图像处理任务中保持保真度和一致性，确保获得最佳结果而不进行不必要的更改。 例如，如果我们加载一张每像素 1 位的黑白 PNG 图像，然后使用 DataStreamSupporter.save(file_path) 方法保存，它将生成每像素 8 位的 PNG 图像。 为避免这种情况并以每像素 1 位保存 PNG 图像，请使用此方法获取相应的保存选项并将其传递给 Image.save(file_path, options) 方法的第二个参数。
get_pixel(x, y)	获取图像像素。
get_proportional_height(width, height, new_width)	获取比例高度。
get_proportional_width(width, height, new_height)	获取比例宽度。
get_serialized_stream(image_options, clipping_rectangle, page_number)	转换为 aps。
get_skew_angle()	获取倾斜角度。 此方法适用于扫描的文本文件，用于在扫描时确定倾斜角度。
grayscale()	将图像转换为灰度表示，转化为 单通道图像，每个像素表示强度。将此方法集成到您的图像处理管道中，以简化分析并提升 与基于灰度的算法的兼容性，促进各种计算机 视觉和图像分析任务。
insert_frame(index, frame)	在帧序列中指定索引处插入新帧，确保 对帧排列的精确控制。使用此方法有效管理帧 序列，促进图像内容的动态操作和组织。
is_digital_signed(password, percentage_threshold)	使用提供的密码和阈值执行快速检查，以确定图像是否已数字签名。
load(file_path)	从指定的文件路径或 URL 加载新图像。 如果 filePath 是文件路径，方法仅打开该文件。 如果 filePath 是 URL，方法会下载文件，将其存为临时文件，然后打开它。
load(file_path, load_options)	从指定的文件路径或 URL 加载新图像。 如果 filePath 是文件路径，方法仅打开该文件。 如果 filePath 是 URL，方法会下载文件，将其存为临时文件，然后打开它。
load(stream)	从指定的流加载新图像。
load(stream, load_options)	从指定的流加载新图像。
load_argb_32_pixels(rectangle)	加载 32 位 ARGB 像素。
load_argb_64_pixels(rectangle)	加载 64 位 ARGB 像素。
load_cmyk_32_pixels(rectangle)	加载 CMYK 格式的像素。
load_cmyk_pixels(rectangle)	加载 CMYK 格式的像素。 此方法已弃用。请使用更有效的 RasterImage.load_cmyk_32_pixels(rectangle) 方法。
load_partial_argb_32_pixels(rectangle, partial_pixel_loader)	部分加载 32 位 ARGB 像素（按块）。
load_partial_argb_64_pixels(rectangle, partial_pixel_loader)	按包部分加载 64 位 ARGB 像素。
load_partial_pixels(desired_rectangle, pixel_loader)	按包部分加载像素。
load_pixels(rectangle)	加载像素。
load_raw_data(rectangle, dest_image_bounds, raw_data_settings, raw_data_loader)	加载原始数据。
load_raw_data(rectangle, raw_data_settings, raw_data_loader)	加载原始数据。
load_stream(stream)	从指定的流加载新图像。
load_stream_with_options(stream, load_options)	从指定的流加载新图像。
load_with_options(file_path, load_options)	从指定的文件路径或 URL 加载新图像。 如果 filePath 是文件路径，方法仅打开该文件。 如果 filePath 是 URL，方法会下载文件，将其存为临时文件，然后打开它。
normalize_angle()	归一化角度。 此方法适用于扫描的文本文档，以消除倾斜扫描。 此方法使用 RasterImage.get_skew_angle() 和 RasterImage.rotate(angle) 方法。
normalize_angle(resize_proportionally, background_color)	使用专为扫描文本文件设计的 NormalizeAngle 方法 矫正倾斜扫描，确保准确对齐。将此功能无缝 集成到您的文本处理工作流中，以提升 文档可读性和质量，改善文本识别 与分析任务的整体效率。 此方法使用 RasterImage.get_skew_angle() 和 TiffImage.rotate(angle, resize_proportionally, background_color) 方法。
normalize_histogram()	归一化图像直方图 — 调整像素值以使用全部可用范围。
read_argb_32_scan_line(scan_line_index)	按指定的扫描线索引读取整条扫描线。
read_scan_line(scan_line_index)	按指定的扫描线索引读取整条扫描线。
remove_frame(frame)	高效移除图像序列中指定的帧，促进 在您的应用程序中实现流畅的帧管理。将此功能 集成以提升帧操作的精确性和灵活性，确保图像内容的无缝 组织和呈现。
remove_frame(index)	通过索引移除帧。
remove_frame_by_index(index)	通过索引移除帧。
remove_metadata()	通过将此 IHasXmpData.xmp_data 和 IHasExifData.exif_data 的值设为 None 来移除该图像实例的元数据。
replace_argb(old_color_argb, old_color_diff, new_color_argb)	在允许的差异范围内将一种颜色替换为另一种颜色，并保留原始 alpha 值以保持平滑边缘。
replace_color(old_color, old_color_diff, new_color)	在允许的差异范围内将一种颜色替换为另一种颜色，并保留原始 alpha 值以保持平滑边缘。
replace_color(old_color_argb, old_color_diff, new_color_argb)	在允许的差异范围内将一种颜色替换为另一种颜色，并保留原始 alpha 值以保持平滑边缘。
replace_frame(index, new_frame)	在指定位置用另一帧替换该帧，操作无缝 ，促进图像序列中的动态帧管理。将此 方法集成以提升帧操作的灵活性和精确性，确保 在您的应用程序中实现图像内容的最佳组织和呈现。
replace_non_transparent_colors(new_color)	将所有非透明颜色替换为新颜色，并保留原始 alpha 值以保持平滑边缘。 注意：如果在没有透明度的图像上使用，它将把所有颜色替换为单一颜色。
replace_non_transparent_colors(new_color_argb)	将所有非透明颜色替换为新颜色，并保留原始 alpha 值以保持平滑边缘。 注意：如果在没有透明度的图像上使用，它将把所有颜色替换为单一颜色。
resize(new_width, new_height)	调整图像大小。使用默认的 ResizeType.NEAREST_NEIGHBOUR_RESAMPLE。
resize(new_width, new_height, resize_type)	对图像执行等比例缩放操作，保持宽高比 同时调整尺寸。使用此方法在您的应用程序中动态缩放图像， 确保内容完整性的视觉表现一致。 等比例缩放将根据 newWidth/width 和 newHeight/height 的比例对每帧进行调整。
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_proportional(new_width, new_height, resize_type)	对图像执行等比例缩放操作，保持宽高比 同时调整尺寸。使用此方法在您的应用程序中动态缩放图像， 确保内容完整性的视觉表现一致。 等比例缩放将根据 newWidth/width 和 newHeight/height 的比例对每帧进行调整。
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(angle, resize_proportionally, background_color)	围绕图像中心点按指定角度旋转图像，实现精确 方向调整。将此功能纳入您的图像处理 管道，以实现准确的变换，确保视觉内容的最佳对齐和 呈现。
rotate_flip(rotate_flip_type)	对活动帧执行旋转、翻转或两者的组合操作。此方法允许对图像序列中的单个帧进行精确操作，提升图像编辑和构图的灵活性。
rotate_flip_all(rotate_flip)	旋转并翻转全部。
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_argb_32_pixels(rectangle, pixels)	保存 32 位 ARGB 像素。
save_cmyk_32_pixels(rectangle, pixels)	保存像素。
save_cmyk_pixels(rectangle, pixels)	保存像素。 此方法已弃用。请使用更有效的 RasterImage.save_cmyk_32_pixels(rectangle, pixels) 方法。
save_pixels(rectangle, pixels)	保存像素的内部主要内容。
save_raw_data(data, data_offset, rectangle, raw_data_settings)	保存原始数据。
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_argb_32_pixel(x, y, argb_32_color)	为指定位置设置图像的 32 位 ARGB 像素。
set_palette(palette, update_colors)	设置图像调色板。
set_pixel(x, y, color)	为指定位置设置图像像素。
set_resolution(dpi_x, dpi_y)	为指定的 RasterImage 建立分辨率，能够 精确控制图像渲染和显示属性。集成此 功能以优化视觉输出并确保与各种 输出设备和平台的兼容性，提升整体用户体验。
try_set_metadata(metadata)	尝试设置一个 metadata 实例，前提是此 Image 实例支持并实现 IImageMetadataFormat 实例。
write_argb_32_scan_line(scan_line_index, argb_32_pixels)	将整条扫描线写入指定的扫描线索引。
write_scan_line(scan_line_index, pixels)	将整条扫描线写入指定的扫描线索引。

Constructor: BigTiffImage(frame)

 BigTiffImage(frame) 

通过初始化
使用 TiffFrame 参数来创建 BigTiffImage 类的新实例。非常适合希望以便捷方式使用 BigTiffImage 对象的开发者，确保灵活性并易于将其集成
到项目中。

Parameters:

参数	Type	Description
frame	TiffFrame	用于初始化图像的 tiff 帧。

Constructor: BigTiffImage(frames)

 BigTiffImage(frames) 

通过
使用 TiffFrames 列表参数初始化新实例，开始无缝使用 BigTiffImage 类。
非常适合希望以直接方式处理包含多个帧的
BigTiffImage 对象的开发者，确保项目的高效性。

Parameters:

参数	Type	Description
frames	TiffFrame[]	帧。

Method: add(image)

 add(image) 

将指定图像的帧无缝添加到当前帧中，
整合其内容并提升组合灵活性。将此方法集成到您的应用程序中，
简化帧管理和操作，
促进对多帧图像的高效处理。

Parameters:

参数	Type	Description
image	TiffImage	源图像。

Method: add_frame(frame)

 add_frame(frame) 

将指定帧无缝合并到图像中，扩展其内容和多样性。
利用此方法提升图像组合和管理，
使您的应用程序能够高效处理多帧图像。

Parameters:

参数	Type	Description
frame	TiffFrame	要添加的帧。

Method: add_frames(frames)

 add_frames(frames) 

将帧数组无缝集成到图像中，丰富其内容和多样性。
利用此方法提升图像组合和管理，
使您的应用程序能够高效处理多帧图像。

Parameters:

参数	Type	Description
frames	TiffFrame[]	要添加的帧数组

Method: add_page(page)

 add_page(page) 

通过此直观方法轻松为您的 BigTiff 图像添加新页面，
非常适合希望动态增强多页图像内容的开发者。

Parameters:

参数	Type	Description
page	RasterImage	要添加的页面。

Method: adjust_brightness(brightness)

 adjust_brightness(brightness) 

实现对图像的 brightness 调整，允许
修改整体亮度水平。将此方法整合到您的图像处理工作流中，
以提升可见性并改善
应用程序中图像的视觉质量。

Parameters:

参数	Type	Description
亮度	int	亮度值。

Method: adjust_contrast(contrast)

 adjust_contrast(contrast) 

提升 Image 实例的对比度，
放大其亮暗区域的差异。
将此功能集成，以改善图像的视觉清晰度和整体质量，
为您的应用程序提供更佳的图像表现。

Parameters:

参数	Type	Description
对比度	float	对比度值（范围为 [-100; 100]）

Method: adjust_gamma(gamma)

 adjust_gamma(gamma) 

对图像应用伽马校正，调整像素强度以实现
所需的色彩平衡。将此方法纳入您的图像处理
工作流，以提升视觉质量并提高后续
分析或显示任务的准确性。

Parameters:

参数	Type	Description
伽马	float	红、绿、蓝通道的伽马系数

Method: adjust_gamma(gamma_red, gamma_green, gamma_blue)

 adjust_gamma(gamma_red, gamma_green, gamma_blue) 

使用红、
绿和蓝通道的单独系数对图像进行伽马校正，以实现对色彩平衡
和对比度的精细调节。将此方法集成到您的图像处理管道中，
实现对颜色渲染的精确控制，并在您的应用程序中提升视觉保真度。

Parameters:

参数	Type	Description
gamma_red	float	红色通道的伽马系数
gamma_green	float	绿色通道的伽马系数
gamma_blue	float	蓝色通道系数的 Gamma

Method: analyze_percentage_digital_signature(password)

 analyze_percentage_digital_signature(password) 

计算提取数据与原始密码之间的相似度百分比。

Parameters:

参数	Type	Description
密码	string	用于提取嵌入数据的密码。

Returns

Type	Description
int	百分比相似度值。

Method: binarize_bradley(brightness_difference)

 binarize_bradley(brightness_difference) 

使用 Bradley 的自适应阈值算法和积分图阈值进行图像二值化

Parameters:

参数	Type	Description
brightness_difference	float	像素与以该像素为中心的 s x s 像素窗口的平均值之间的亮度差 。

Method: binarize_bradley(brightness_difference, window_size)

 binarize_bradley(brightness_difference, window_size) 

在图像上实现二值化，采用 Bradley 自适应阈值
算法结合积分图阈值。此方法根据图像邻域动态计算
局部阈值，提升对不同光照条件的适应性，并确保后续
处理任务的稳健分割。

Parameters:

参数	Type	Description
brightness_difference	float	像素与以该像素为中心的 s x s 像素窗口的平均值之间的亮度差 。
window_size	int	以该像素为中心的 s x s 像素窗口的大小

Method: binarize_fixed(threshold)

 binarize_fixed(threshold) 

使用预定义阈值对图像进行二值化，将其转换为
前景和背景区域明确的二值图像。将此方法纳入您的图像处理工作流，以便于分割和特征
提取任务，提升图像分析的准确性和效率。

Parameters:

参数	Type	Description
阈值	System.Byte	阈值。如果像素的对应灰度值大于阈值，则赋值为 255，否则为 0。

Method: blend(origin, overlay, overlay_alpha)

 blend(origin, overlay, overlay_alpha) 

将此图像实例与 overlay 图像混合。

Parameters:

参数	Type	Description
origin	Point	背景图像混合的原点。
overlay	RasterImage	覆盖图像。
overlay_alpha	System.Byte	覆盖的 alpha。

Method: blend(origin, overlay, overlay_area, overlay_alpha)

 blend(origin, overlay, overlay_area, overlay_alpha) 

将此图像实例与 overlay 图像混合。

Parameters:

参数	Type	Description
origin	Point	背景图像混合的原点。
overlay	RasterImage	覆盖图像。
overlay_area	Rectangle	覆盖区域。
overlay_alpha	System.Byte	覆盖的 alpha。

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: create_with_frame(frame) [static]

 create_with_frame(frame) 

初始化 BigTiffImage 类的新实例。

Parameters:

参数	Type	Description
frame	TiffFrame	用于初始化图像的 tiff 帧。

Returns

Type	Description
BigTiffImage	包含该帧的新 BigTiffImage 图像。

Method: create_with_frames(frames) [static]

 create_with_frames(frames) 

初始化 BigTiffImage 类的新实例。

Parameters:

参数	Type	Description
frames	TiffFrame[]	帧。

Returns

Type	Description
BigTiffImage

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: dither(dithering_method, bits_count)

 dither(dithering_method, bits_count) 

对当前图像执行抖动处理。

Parameters:

参数	Type	Description
dithering_method	DitheringMethod	抖动方法。
bits_count	int	用于抖动的最终位计数。

Method: dither(dithering_method, bits_count, custom_palette)

 dither(dithering_method, bits_count, custom_palette) 

对当前图像执行抖动处理，以提升视觉质量并减少
颜色带状伪影。将此方法纳入您的图像处理工作流，
确保颜色过渡更平滑，从而改善整体图像外观和清晰度。

Parameters:

参数	Type	Description
dithering_method	DitheringMethod	抖动方法。
bits_count	int	用于抖动的最终位计数。
custom_palette	IColorPalette	用于抖动的自定义调色板。

Method: embed_digital_signature(password)

 embed_digital_signature(password) 

根据提供的密码将数字签名嵌入图像的每一页。

Parameters:

参数	Type	Description
密码	string	用于生成数字签名数据的密码

Method: filter(rectangle, options)

 filter(rectangle, options) 

在指定矩形区域内过滤内容，应用指定的图像
处理滤镜以增强或修改所选区域。将此方法
集成到您的图像操作工作流中，以实现针对性的增强或
转换，在您的应用程序中。

Parameters:

参数	Type	Description
rectangle	Rectangle	矩形。
options	FilterOptionsBase	选项。

Method: get_argb_32_pixel(x, y)

 get_argb_32_pixel(x, y) 

获取图像的 32 位 ARGB 像素。

Parameters:

参数	Type	Description
x	int	像素的 x 位置。
y	int	像素的 y 位置。

Returns

Type	Description
int	指定位置的 32 位 ARGB 像素。

Method: get_default_argb_32_pixels(rectangle)

 get_default_argb_32_pixels(rectangle) 

获取默认的 32 位 ARGB 像素数组。

Parameters:

参数	Type	Description
rectangle	Rectangle	用于获取像素的矩形。

Returns

Type	Description
int[]	默认像素数组。

Method: get_default_options(args)

 get_default_options(args) 

获取默认选项。

Parameters:

参数	Type	Description
args	System.Object	参数。

Returns

Type	Description
ImageOptionsBase	默认选项

Method: get_default_pixels(rectangle, partial_pixel_loader)

 get_default_pixels(rectangle, partial_pixel_loader) 

使用部分像素加载器获取默认像素数组。

Parameters:

参数	Type	Description
rectangle	Rectangle	用于获取像素的矩形。
partial_pixel_loader	IPartialArgb32PixelLoader	部分像素加载器。

Method: get_default_raw_data(rectangle, partial_raw_data_loader, raw_data_settings)

 get_default_raw_data(rectangle, partial_raw_data_loader, raw_data_settings) 

使用部分像素加载器获取默认原始数据数组。

Parameters:

参数	Type	Description
rectangle	Rectangle	用于获取像素的矩形。
partial_raw_data_loader	IPartialRawDataLoader	部分原始数据加载器。
raw_data_settings	RawDataSettings	原始数据设置。

Method: get_default_raw_data(rectangle, raw_data_settings)

 get_default_raw_data(rectangle, raw_data_settings) 

获取默认原始数据数组。

Parameters:

参数	Type	Description
rectangle	Rectangle	用于获取原始数据的矩形。
raw_data_settings	RawDataSettings	原始数据设置。

Returns

Type	Description
System.Byte	默认原始数据数组。

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_modify_date(use_default)

 get_modify_date(use_default) 

获取资源图像最后修改的日期和时间。

Parameters:

参数	Type	Description
use_default	bool	如果设置为 true，则使用 FileInfo 中的信息作为默认值。

Returns

Type	Description
System.DateTime	资源图像上次修改的日期和时间。

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_pixel(x, y)

 get_pixel(x, y) 

获取图像像素。

Parameters:

参数	Type	Description
x	int	像素的 x 位置。
y	int	像素的 y 位置。

Returns

Type	Description
Color	指定位置的像素颜色。

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: get_skew_angle()

 get_skew_angle() 

获取倾斜角度。
此方法适用于扫描的文本文件，用于在扫描时确定倾斜角度。

Returns

Type	Description
float	倾斜角度（单位：度）。

Method: insert_frame(index, frame)

 insert_frame(index, frame) 

在帧序列中指定索引处插入新帧，确保
对帧排列的精确控制。使用此方法有效管理帧
序列，促进图像内容的动态操作和组织。

Parameters:

参数	Type	Description
index	int	frame 的索引。
frame	TiffFrame	用于插入的帧。

Method: is_digital_signed(password, percentage_threshold)

 is_digital_signed(password, percentage_threshold) 

使用提供的密码和阈值执行快速检查，以确定图像是否已数字签名。

Parameters:

参数	Type	Description
密码	string	用于检查签名的密码。
percentage_threshold	int	阈值（百分比）[0-100] 用于确定图像是否被视为已签名。 如果未指定，将使用默认阈值（75）。

Returns

Type	Description
bool	如果图像已签名则为 true，否则为 false。

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_argb_32_pixels(rectangle)

 load_argb_32_pixels(rectangle) 

加载 32 位 ARGB 像素。

Parameters:

参数	Type	Description
rectangle	Rectangle	加载像素的矩形。

Returns

Type	Description
int[]	已加载的 32 位 ARGB 像素数组。

Method: load_argb_64_pixels(rectangle)

 load_argb_64_pixels(rectangle) 

加载 64 位 ARGB 像素。

Parameters:

参数	Type	Description
rectangle	Rectangle	加载像素的矩形。

Returns

Type	Description
int[]	已加载的 64 位 ARGB 像素数组。

Method: load_cmyk_32_pixels(rectangle)

 load_cmyk_32_pixels(rectangle) 

加载 CMYK 格式的像素。

Parameters:

参数	Type	Description
rectangle	Rectangle	加载像素的矩形。

Returns

Type	Description
int[]	已加载的 CMYK 像素以 32 位整数值呈现。

Method: load_cmyk_pixels(rectangle)

 load_cmyk_pixels(rectangle) 

加载 CMYK 格式的像素。
此方法已弃用。请使用更有效的 RasterImage.load_cmyk_32_pixels(rectangle) 方法。

Parameters:

参数	Type	Description
rectangle	Rectangle	加载像素的矩形。

Returns

Type	Description
CmykColor[]	已加载的 CMYK 像素数组。

Method: load_partial_argb_32_pixels(rectangle, partial_pixel_loader)

 load_partial_argb_32_pixels(rectangle, partial_pixel_loader) 

部分加载 32 位 ARGB 像素（按块）。

Parameters:

参数	Type	Description
rectangle	Rectangle	加载像素的矩形。
partial_pixel_loader	IPartialArgb32PixelLoader	部分像素加载器。

Method: load_partial_argb_64_pixels(rectangle, partial_pixel_loader)

 load_partial_argb_64_pixels(rectangle, partial_pixel_loader) 

按包部分加载 64 位 ARGB 像素。

Parameters:

参数	Type	Description
rectangle	Rectangle	所需的矩形。
partial_pixel_loader	IPartialArgb64PixelLoader	64 位 ARGB 像素加载器。

Method: load_partial_pixels(desired_rectangle, pixel_loader)

 load_partial_pixels(desired_rectangle, pixel_loader) 

按包部分加载像素。

Parameters:

参数	Type	Description
desired_rectangle	Rectangle	所需的矩形。
pixel_loader	IPartialPixelLoader	像素加载器。

Method: load_pixels(rectangle)

 load_pixels(rectangle) 

加载像素。

Parameters:

参数	Type	Description
rectangle	Rectangle	加载像素的矩形。

Returns

Type	Description
Color[]	已加载的像素数组。

Method: load_raw_data(rectangle, dest_image_bounds, raw_data_settings, raw_data_loader)

 load_raw_data(rectangle, dest_image_bounds, raw_data_settings, raw_data_loader) 

加载原始数据。

Parameters:

参数	Type	Description
rectangle	Rectangle	用于加载原始数据的矩形。
dest_image_bounds	Rectangle	目标图像边界。
raw_data_settings	RawDataSettings	用于已加载数据的原始数据设置。注意，如果数据不是指定的格式，则会执行数据转换。
raw_data_loader	IPartialRawDataLoader	原始数据加载器。

Method: load_raw_data(rectangle, raw_data_settings, raw_data_loader)

 load_raw_data(rectangle, raw_data_settings, raw_data_loader) 

加载原始数据。

Parameters:

参数	Type	Description
rectangle	Rectangle	用于加载原始数据的矩形。
raw_data_settings	RawDataSettings	用于已加载数据的原始数据设置。注意，如果数据不是指定的格式，则会执行数据转换。
raw_data_loader	IPartialRawDataLoader	原始数据加载器。

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: normalize_angle(resize_proportionally, background_color)

 normalize_angle(resize_proportionally, background_color) 

使用专为扫描文本文件设计的 NormalizeAngle 方法
矫正倾斜扫描，确保准确对齐。将此功能无缝
集成到您的文本处理工作流中，以提升
文档可读性和质量，改善文本识别
与分析任务的整体效率。
此方法使用 RasterImage.get_skew_angle() 和 TiffImage.rotate(angle, resize_proportionally, background_color) 方法。

Parameters:

参数	Type	Description
resize_proportionally	bool	如果设置为 true，图像尺寸将根据旋转矩形（角点）投影进行更改；否则保持尺寸不变，仅旋转内部图像内容。
background_color	Color	背景颜色。

Method: read_argb_32_scan_line(scan_line_index)

 read_argb_32_scan_line(scan_line_index) 

按指定的扫描线索引读取整条扫描线。

Parameters:

参数	Type	Description
scan_line_index	int	扫描线的零基索引。

Returns

Type	Description
int[]	扫描线 32 位 ARGB 颜色值数组。

Method: read_scan_line(scan_line_index)

 read_scan_line(scan_line_index) 

按指定的扫描线索引读取整条扫描线。

Parameters:

参数	Type	Description
scan_line_index	int	扫描线的零基索引。

Returns

Type	Description
Color[]	扫描线像素颜色值数组。

Method: remove_frame(frame)

 remove_frame(frame) 

高效移除图像序列中指定的帧，促进
在您的应用程序中实现流畅的帧管理。将此功能
集成以提升帧操作的精确性和灵活性，确保图像内容的无缝
组织和呈现。

Parameters:

参数	Type	Description
frame	TiffFrame	要移除的帧。

Method: remove_frame(index)

 remove_frame(index) 

通过索引移除帧。

Parameters:

参数	Type	Description
index	int	要移除的帧的索引。

Returns

Type	Description
TiffFrame	已移除的帧。

Method: remove_frame_by_index(index)

 remove_frame_by_index(index) 

通过索引移除帧。

Parameters:

参数	Type	Description
index	int	要移除的帧的索引。

Returns

Type	Description
TiffFrame	已移除的帧。

Method: replace_argb(old_color_argb, old_color_diff, new_color_argb)

 replace_argb(old_color_argb, old_color_diff, new_color_argb) 

在允许的差异范围内将一种颜色替换为另一种颜色，并保留原始 alpha 值以保持平滑边缘。

Parameters:

参数	Type	Description
old_color_argb	int	要替换的旧颜色 ARGB 值。
old_color_diff	System.Byte	允许的旧颜色差异，以便能够扩大替换颜色的色调。
new_color_argb	int	用于替换旧颜色的新颜色 ARGB 值。

Method: replace_color(old_color, old_color_diff, new_color)

 replace_color(old_color, old_color_diff, new_color) 

在允许的差异范围内将一种颜色替换为另一种颜色，并保留原始 alpha 值以保持平滑边缘。

Parameters:

参数	Type	Description
old_color	Color
old_color_diff	System.Byte	允许的旧颜色差异，以便能够扩大替换颜色的色调。
new_color	Color

Method: replace_color(old_color_argb, old_color_diff, new_color_argb)

 replace_color(old_color_argb, old_color_diff, new_color_argb) 

在允许的差异范围内将一种颜色替换为另一种颜色，并保留原始 alpha 值以保持平滑边缘。

Parameters:

参数	Type	Description
old_color_argb	int	要替换的旧颜色 ARGB 值。
old_color_diff	System.Byte	允许的旧颜色差异，以便能够扩大替换颜色的色调。
new_color_argb	int	用于替换旧颜色的新颜色 ARGB 值。

Method: replace_frame(index, new_frame)

 replace_frame(index, new_frame) 

在指定位置用另一帧替换该帧，操作无缝
，促进图像序列中的动态帧管理。将此
方法集成以提升帧操作的灵活性和精确性，确保
在您的应用程序中实现图像内容的最佳组织和呈现。

Parameters:

参数	Type	Description
index	int	基于零的帧位置。
new_frame	TiffFrame	用于替换指定 index 处帧的帧。

Returns

Type	Description
TiffFrame	已移除的帧。

Method: replace_non_transparent_colors(new_color)

 replace_non_transparent_colors(new_color) 

将所有非透明颜色替换为新颜色，并保留原始 alpha 值以保持平滑边缘。
注意：如果在没有透明度的图像上使用，它将把所有颜色替换为单一颜色。

Parameters:

参数	Type	Description
new_color	Color

Method: replace_non_transparent_colors(new_color_argb)

 replace_non_transparent_colors(new_color_argb) 

将所有非透明颜色替换为新颜色，并保留原始 alpha 值以保持平滑边缘。
注意：如果在没有透明度的图像上使用，它将把所有颜色替换为单一颜色。

Parameters:

参数	Type	Description
new_color_argb	int	用于替换非透明颜色的新颜色 ARGB 值。

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) 

对图像执行等比例缩放操作，保持宽高比
同时调整尺寸。使用此方法在您的应用程序中动态缩放图像，
确保内容完整性的视觉表现一致。
等比例缩放将根据 newWidth/width 和 newHeight/height 的比例对每帧进行调整。

Parameters:

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

Method: resize(new_width, new_height, settings)

 resize(new_width, new_height, settings) 

根据指定设置调整图像大小，允许对尺寸、宽高比和缩放行为进行精确
控制。将此方法集成到您的图像处理工作流中，以实现针对应用程序特定需求的自定义缩放操作。

Parameters:

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

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_proportional(new_width, new_height, resize_type)

 resize_proportional(new_width, new_height, resize_type) 

对图像执行等比例缩放操作，保持宽高比
同时调整尺寸。使用此方法在您的应用程序中动态缩放图像，
确保内容完整性的视觉表现一致。
等比例缩放将根据 newWidth/width 和 newHeight/height 的比例对每帧进行调整。

Parameters:

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

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(angle, resize_proportionally, background_color)

 rotate(angle, resize_proportionally, background_color) 

围绕图像中心点按指定角度旋转图像，实现精确
方向调整。将此功能纳入您的图像处理
管道，以实现准确的变换，确保视觉内容的最佳对齐和
呈现。

Parameters:

参数	Type	Description
角度	float	旋转角度（以度为单位）。正值将顺时针旋转。
resize_proportionally	bool	如果设置为 true，图像尺寸将根据旋转矩形（角点）投影进行更改；否则保持尺寸不变，仅旋转内部图像内容。
background_color	Color	背景颜色。

Method: rotate_flip(rotate_flip_type)

 rotate_flip(rotate_flip_type) 

对活动帧执行旋转、翻转或两者的组合操作。此方法允许对图像序列中的单个帧进行精确操作，提升图像编辑和构图的灵活性。

Parameters:

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

Method: rotate_flip_all(rotate_flip)

 rotate_flip_all(rotate_flip) 

旋转并翻转全部。

Parameters:

参数	Type	Description
rotate_flip	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_argb_32_pixels(rectangle, pixels)

 save_argb_32_pixels(rectangle, pixels) 

保存 32 位 ARGB 像素。

Parameters:

参数	Type	Description
rectangle	Rectangle	保存像素的矩形。
像素	int[]	32 位 ARGB 像素数组。

Method: save_cmyk_32_pixels(rectangle, pixels)

 save_cmyk_32_pixels(rectangle, pixels) 

保存像素。

Parameters:

参数	Type	Description
rectangle	Rectangle	保存像素的矩形。
像素	int[]	以 32 位整数值表示的 CMYK 像素。

Method: save_cmyk_pixels(rectangle, pixels)

 save_cmyk_pixels(rectangle, pixels) 

保存像素。
此方法已弃用。请使用更有效的 RasterImage.save_cmyk_32_pixels(rectangle, pixels) 方法。

Parameters:

参数	Type	Description
rectangle	Rectangle	保存像素的矩形。
pixels	CmykColor[]	CMYK 像素数组。

Method: save_pixels(rectangle, pixels)

 save_pixels(rectangle, pixels) 

保存像素的内部主要内容。

Parameters:

参数	Type	Description
rectangle	Rectangle	矩形。
pixels	Color[]	像素。

Method: save_raw_data(data, data_offset, rectangle, raw_data_settings)

 save_raw_data(data, data_offset, rectangle, raw_data_settings) 

保存原始数据。

Parameters:

参数	Type	Description
数据	System.Byte	原始数据。
data_offset	int	起始原始数据偏移。
rectangle	Rectangle	原始数据矩形。
raw_data_settings	RawDataSettings	原始数据所在的设置。

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_argb_32_pixel(x, y, argb_32_color)

 set_argb_32_pixel(x, y, argb_32_color) 

为指定位置设置图像的 32 位 ARGB 像素。

Parameters:

参数	Type	Description
x	int	像素的 x 位置。
y	int	像素的 y 位置。
argb_32_color	int	指定位置的 32 位 ARGB 像素。

Method: set_palette(palette, update_colors)

 set_palette(palette, update_colors) 

设置图像调色板。

Parameters:

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

Method: set_pixel(x, y, color)

 set_pixel(x, y, color) 

为指定位置设置图像像素。

Parameters:

参数	Type	Description
x	int	像素的 x 位置。
y	int	像素的 y 位置。
color	Color	指定位置的像素颜色。

Method: set_resolution(dpi_x, dpi_y)

 set_resolution(dpi_x, dpi_y) 

为指定的 RasterImage 建立分辨率，能够
精确控制图像渲染和显示属性。集成此
功能以优化视觉输出并确保与各种
输出设备和平台的兼容性，提升整体用户体验。

Parameters:

参数	Type	Description
dpi_x	float	以每英寸点数表示的 RasterImage 的水平分辨率。
dpi_y	float	以每英寸点数表示的 RasterImage 的垂直分辨率。

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。

Method: write_argb_32_scan_line(scan_line_index, argb_32_pixels)

 write_argb_32_scan_line(scan_line_index, argb_32_pixels) 

将整条扫描线写入指定的扫描线索引。

Parameters:

参数	Type	Description
scan_line_index	int	扫描线的零基索引。
argb_32_pixels	int[]	要写入的 32 位 ARGB 颜色数组。

Method: write_scan_line(scan_line_index, pixels)

 write_scan_line(scan_line_index, pixels) 

将整条扫描线写入指定的扫描线索引。

Parameters:

参数	Type	Description
scan_line_index	int	扫描线的零基索引。
pixels	Color[]	要写入的像素颜色数组。