AddImageFromVariant

图像处理

描述

将变体字节数组中的图像添加到所选文档

图像添加到文档后,可在任意页面上多次绘制,而不会进一步增加 PDF 文件大小

支持的图像文件类型包括:BMP、TIFF、JPEG、PNG、GIF、WMF 和 EMF

对于 BMP 和 TIFF 图像,可在调用此函数前调用 CompressImages 函数以压缩图像数据。其他图像类型会自动压缩

语法

ActiveX

Function PDFlib::AddImageFromVariant(SourceData As Variant, Options As Long) As Long

参数

SourceData

包含图像数据的变体

Options

对于多页 TIFF 图像,此参数指定要加载的页码

对于 PNG 图像:

0 = 按常规方式加载图像

1 = 将 Alpha 通道作为灰度图像加载

2 = 加载图像和 Alpha 通道(将 Alpha 限制为 8 位)

3 = 加载图像(图像限制为每通道 8 位)

4 = 加载 Alpha 通道(限制为每通道 8 位)

5 = 使用 Alpha 通道加载图像(两者均限制为每通道 8 位)

6 = 加载图像和 Alpha 通道

7 = 加载图像和 ICC 颜色配置文件

对于其他图像类型,此参数应设置为 0

将 Options 设为 -1 会强制使用 GDI+ 图形库加载 TIFF、EMF 和 WMF 图像。将 Options 参数设为 -PageNumber(例如 -3 表示第 3 页)也可以用 GDI+ 加载多页 TIFF 图像

返回值

0无法添加图像
Non-zero图像已成功添加,这是新图像的 ID