类 OtgImage

OtgImage class

使用我们的 API 处理 OpenDocument Template(OTG)绘图图像文件,利用带有图形内容的 OpenDocument XML 格式实现无缝操作。轻松解析文档、定制背景颜色并调整页面尺寸,确保对 OTG 矢量图形项目拥有最佳的控制和灵活性。

public class OtgImage : OdImage

构造函数

名称描述
OtgImage(StreamContainer)通过提供流容器创建 OtgImage 类的新对象。此构造函数使开发者能够直接从流容器创建 OTG 图像,简化 OTG 图像数据的使用流程。
OtgImage(StreamContainer, LoadOptions)通过提供流容器和加载选项初始化新的 OtgImage 对象。此构造函数使开发者能够在指定自定义加载配置的同时,高效地从流中加载 OTG 图像。

属性

名称描述
AutoAdjustPalette { get; set; }获取或设置指示是否自动调整调色板的值。
virtual BackgroundColor { get; set; }获取或设置背景颜色的值。
override BitsPerPixel { get; }检索图像的每像素位数。此属性提供图像细节级别和颜色深度的信息,有助于各种图像处理任务和优化。
Bounds { get; }获取图像的边界。
BufferSizeHint { get; set; }获取或设置缓冲区大小提示,该提示定义了所有内部缓冲区的最大允许大小。
Container { get; }获取 Image 容器。
DataStreamContainer { get; }获取对象的数据流。
Disposed { get; }获取一个值,指示此实例是否已释放。
ExifData { get; set; }获取或设置 Exif 数据。
override FileFormat { get; }此属性提供对 OTG 文件格式的访问,提供有关图像文件中封装数据类型的关键洞察。它是软件开发者的重要参考点,使其能够在应用程序中有效处理 OTG 文件。通过使用此属性,您可以确定图像文件的具体格式,从而在软件系统中实现 OTG 文件的无缝集成和操作。
virtual HasBackgroundColor { get; set; }获取或设置指示图像是否具有背景颜色的值。
override Height { get; }获取图像高度。
virtual HeightF { get; }获取对象的高度(英寸)。
InterruptMonitor { get; set; }获取或设置中断监视器。
override IsCached { get; }获取一个布尔值,指示对象的数据是否已被缓存,从而消除读取数据的需求。此属性作为优化指示器,通过最小化冗余数据访问操作来提升性能。
Metadata { get; }检索特定于 OpenDocument 文件的元数据。此属性允许访问嵌入在 OD 文件中的关键信息,便于执行诸如提取、修改或分析元数据等各种操作。
override Metadata { get; }获取图像元数据。
override PageCount { get; }检索图像中页面的总数。此属性对于管理多页图像的应用程序至关重要,使它们能够准确确定可用于处理或显示的页面数量。
virtual PageExportingAction { get; set; }获取或设置页面导出操作。请注意,设置此方法后将在执行后自动释放页面资源。它将在每个页面保存之前执行。
override Pages { get; }检索与图像关联的页面集合,使软件开发人员能够高效访问和操作每个单独的页面。此属性促进对页面的无缝迭代,以执行各种操作,提升图像处理应用程序的功能性和多样性。
Palette { get; set; }获取或设置颜色调色板。当像素直接表示时,调色板不被使用。
Records { get; }检索存储在图像中的 OpenDocument 记录。此属性提供对嵌入在 OpenDocument 文件中的特定结构化数据元素的访问,便于检索或操作相关信息以进行进一步处理或分析。
Size { get; }获取图像尺寸。
SizeF { get; }获取对象的尺寸(英寸)。
virtual UsePalette { get; }获取一个值,指示是否使用图像调色板。
override Width { get; }获取图像宽度。
virtual WidthF { get; }获取对象的宽度(英寸)。
XmpData { get; set; }获取或设置 Xmp 数据。

方法

名称描述
override CacheData()缓存数据并确保不会从底层 DataStreamContainer 加载额外数据。
CanSave(ImageOptionsBase)确定图像是否可以保存为传入保存选项所表示的指定文件格式。
override Crop(Rectangle)裁剪指定的矩形。
virtual Crop(int, int, int, int)使用位移裁剪图像。
Dispose()释放当前实例。
override GetDefaultOptions(object[])获取默认的图像选项。
override GetEmbeddedImages()获取嵌入的图像。
virtual GetOriginalOptions()根据原始文件设置获取选项。这有助于保持原始图像的位深度和其他参数不变。例如,如果我们加载一幅每像素 1 位的黑白 PNG 图像,然后使用 Save 方法保存,输出的 PNG 图像将是每像素 8 位。为避免这种情况并以每像素 1 位保存 PNG 图像,请使用此方法获取相应的保存选项,并将其作为第二个参数传递给 Save 方法。
override GetSerializedStream(ImageOptionsBase, Rectangle, out int)转换为 aps。
override RemoveBackground()移除背景。
override RemoveBackground(RemoveBackgroundSettings)移除背景。
virtual RemoveMetadata()移除元数据。
Resize(int, int)调整图像大小。默认使用 NearestNeighbourResample。
override Resize(int, int, ImageResizeSettings)调整图像大小。
override Resize(int, int, ResizeType)调整图像大小。
ResizeHeightProportionally(int)按比例调整高度。默认使用 NearestNeighbourResample。
virtual ResizeHeightProportionally(int, ImageResizeSettings)按比例调整高度。
virtual ResizeHeightProportionally(int, ResizeType)按比例调整高度。
ResizeWidthProportionally(int)按比例调整宽度。使用默认的 NearestNeighbourResample。
virtual ResizeWidthProportionally(int, ImageResizeSettings)按比例调整宽度。
virtual ResizeWidthProportionally(int, ResizeType)按比例调整宽度。
override Rotate(float)围绕中心旋转图像。
override RotateFlip(RotateFlipType)旋转、翻转或同时旋转和翻转图像。
Save()将图像数据保存到底层流。
Save(Stream)将对象的数据保存到指定的流。
override Save(string)将图像保存到指定的文件位置。
Save(Stream, ImageOptionsBase)根据保存选项,将图像数据以指定的文件格式保存到指定的流中。
virtual Save(string, bool)将对象的数据保存到指定的文件位置。
virtual Save(string, ImageOptionsBase)根据保存选项,将对象的数据以指定的文件格式保存到指定的文件位置。
virtual Save(Stream, ImageOptionsBase, Rectangle)根据保存选项,将图像数据以指定的文件格式保存到指定的流中。
virtual Save(string, ImageOptionsBase, Rectangle)根据保存选项,将对象的数据以指定的文件格式保存到指定的文件位置。
override SetPalette(IColorPalette, bool)设置图像调色板。
virtual TrySetMetadata(IImageMetadataFormat)尝试设置 metadata 实例,前提是此 Image 实例支持并实现了 IImageMetadataFormat 类型。

示例

以下代码片段演示如何将 OTG 图像转换为 PDF 及其他图像格式。

[C#]

string dir = "c:\\aspose.imaging\\issues\\net\\3567\\";
string inputFilePath = dir + "VariousObjectsMultiPage.otg";
Aspose.Imaging.ImageOptionsBase[] options = { new Aspose.Imaging.ImageOptions.PngOptions(), new Aspose.Imaging.ImageOptions.PdfOptions() };
foreach (Aspose.Imaging.ImageOptionsBase saveOptions in options)
{
    string extension = saveOptions is Aspose.Imaging.ImageOptions.PngOptions ? ".png" : ".pdf";
    using (Aspose.Imaging.Image image = Aspose.Imaging.Image.Load(inputFilePath))
    {
        Aspose.Imaging.ImageOptions.OtgRasterizationOptions otgRasterizationOptions = new Aspose.Imaging.ImageOptions.OtgRasterizationOptions();
        otgRasterizationOptions.PageSize = image.Size;
        saveOptions.VectorRasterizationOptions = otgRasterizationOptions;

        image.Save(inputFilePath + extension, saveOptions);
    }
}

另请参见