XImage

概述

XImage 是 Aspose.PDF FOSS 中用于 .NET 的一个类。继承自：ImageXObject。

Image XObject 包装器，公开 XImage 表面。

此类提供了 22 个用于在 .NET 程序中处理 XImage 对象的方法。可用的方法包括：AddStencilMask、Delete、DetectColorType、GetAlternativeText、GetColorType、GetDecodedData、GetJpegBytes、GetNameInCollection、GetRawData、GetRawImageData、IsTheSameObject、Rename，以及另外 5 个方法。安装 Aspose.PDF FOSS for .NET 包后，所有公共成员对任何 .NET 应用程序均可访问。属性包括：BitsPerComponent、ColorSpace、ComponentCount、ContainsTransparency、Filter、FilterType，以及另外 10 项。

属性

名称	类型	访问	描述
`Name`	`string`	读写	资源名称（例如 “Im0”）；可在派生类型上写入。
`Width`	`int`	读取	图像宽度（像素）。
`Height`	`int`	读取	图像高度（像素）。
`ContainsTransparency`	`bool`	读取	图像是否具有 /SMask 或 /Mask 条目，以指示逐像素透明度。
`ImageMask`	`bool`	读取	图像是否为 1 位模板掩码（匹配基础 IsImageMask）。
`FilterType`	`ImageFilterType`	读取	对图像数据应用的压缩过滤器。
`Grayscaled`	`System.Drawing.Image?`	读取	将图像渲染为灰度 System.Drawing.Image。
`Metadata`	`Metadata`	读取	附加到此图像的 XMP 元数据，在首次访问时从图像 XObject 的 /Metadata 流中解析（当图像不包含 /Metadata 时为空）。
`BitsPerComponent`	`int`	读取	每个组件的位数。
`ColorSpace`	`string?`	读取	颜色空间名称。
`Filter`	`string?`	读取	使用的过滤器（例如，JPEG 使用 “DCTDecode”，FlateDecode）。
`IsJpeg`	`bool`	读取	是否为 JPEG 图像（DCTDecode 过滤器）。
`IsJpeg2000`	`bool`	读取	是否为 JPEG2000 图像（JPXDecode 过滤器）。
`HasSoftMask`	`bool`	读取	此图像是否具有软遮罩（alpha channel）。
`IsImageMask`	`bool`	读取	这是否是图像遮罩（模板）。
`ComponentCount`	`int`	读取	基于颜色空间的颜色分量数量。

方法

签名	描述
`Delete()`	从获取该图像的资源中删除此图像。
`Replace(stream: Stream)`	用提供的图像流替换此图像的数据，保持其资源名称，以便现有的 content-stream 引用显示新的像素。
`AddStencilMask(maskStream: Stream)`	附加一个由给定图像流构建的模板遮罩。
`DetectColorType(bmp: System.Drawing.Bitmap)`	通过采样像素来检测位图是灰度、RGB 还是 CMYK。
`GetAlternativeText(page: Page)`	Alternative-text 访问器 — 返回在页面结构树中为此图像声明的 alt 字符串。
`GetColorType()`	检测图像的颜色族。
`GetNameInCollection()`	在页面的 XObject 字典中注册的资源名称。
`GetRawImageData()`	获取原始（已编码）图像数据的副本，作为可寻址的 MemoryStream。
`IsTheSameObject(image: XImage)`	对另一个 XImage 的引用相等性。
`Rename(name: string)`	重命名图像的资源条目。
`Save(stream: Stream)`	将图像字节写入流。
`Save(stream: Stream, format: System.Drawing.Imaging.ImageFormat)`	将图像字节写入流，并重新编码为指定格式。
`Save(stream: Stream, format: Aspose.Pdf.Drawing.ImageFormat)`	将图像重新编码为给定的 ImageFormat 并写入。
`Save(stream: Stream, format: System.Drawing.Imaging.ImageFormat, resolution: int)`	将图像字节写入流，按提供的分辨率重新编码为 format。
`Save(stream: Stream, resolution: int)`	在提供的分辨率下将图像字节写入流。
`ToStream()`	将图像字节作为可定位流返回。
`TrySetAlternativeText(alternativeText: string, page: Page)`	通过页面的结构树为此图像附加替代文本。
`GetRawData()`	获取原始（已编码的）图像数据。
`GetDecodedData()`	获取已解码的图像数据（已移除过滤器）。
`GetJpegBytes()`	对于 JPEG 图像，返回原始 JPEG 字节（可直接写入 .jpg 文件）。
`Save(path: string)`	将图像保存到文件。
`ToPng()`	将图像导出为 PNG 字节。

另请参阅

Aspose.PDF for .NET — Enterprise API Reference