Foxit PDF SDK
FSDK::VectorGraphics类 参考

用于将矢量图形(SVG、WMF/EMF)插入 PDF 文件的类。 更多...

静态 Public 成员函数

static Initialize (library_path)
 通过加载 fxvectorgraphics 共享库来初始化矢量图形模块。 更多...
 
static InsertSVGToPage (pdf_path, svg_path, out_pdf_path, page_index, x, y, width, height, dpi)
 将 SVG 文件插入已有 PDF 页面的指定矩形区域。 更多...
 
static InsertSVGToPDF (pdf_path, svg_path, out_pdf_path, page_index, page_width_pt, page_height_pt, dpi)
 将 SVG 文件作为新页面插入 PDF 文档。 更多...
 
static InsertWMFToPage (pdf_path, wmf_path, out_pdf_path, page_index, x, y, width, height, dpi)
 将 WMF/EMF 文件插入已有 PDF 页面的指定矩形区域。 更多...
 
static InsertWMFToPDF (pdf_path, wmf_path, out_pdf_path, page_index, page_width_pt, page_height_pt, dpi)
 将 WMF/EMF 文件作为新页面插入 PDF 文档。 更多...
 
static Release ()
 释放矢量图形模块分配的所有资源。 更多...
 

详细描述

用于将矢量图形(SVG、WMF/EMF)插入 PDF 文件的类。

该类提供将 SVG 矢量图形和 WMF/EMF 图元文件插入 PDF 文档的方法。 目标 PDF 的打开、修改和保存均在 fxvectorgraphics 共享库内部完成, 调用方无需通过 Foxit PDF SDK 自行打开文档。 输出文件会自动保留输入 PDF 的结构特性(线性化、交叉引用流等)。

在调用该类的任何其他方法之前,请先调用 FSDK.VectorGraphics.Initialize 以加载 fxvectorgraphics 共享库。 当不再需要该模块时,调用 FSDK.VectorGraphics.Release。

当前,这个功能不在Linux x86/ARM 和 MAC ARM上支持。

成员函数说明

◆ Initialize()

static FSDK::VectorGraphics::Initialize (   library_path)
inlinestatic

通过加载 fxvectorgraphics 共享库来初始化矢量图形模块。

在"矢量图形"模块的生命周期中,此函数应在其他任何函数之前调用一次。 库将保持加载状态,直到调用 FSDK.VectorGraphics.Release。

参数
[in]library_pathfxvectorgraphics 共享库文件的完整路径,不能为空字符串。
返回
无。
注解
若 FSDK.Library.Initialize 中使用的许可证信息未包含"Conversion"模块, 则用户无权使用矢量图形相关功能,此函数将抛出异常 FSDK.e_ErrNoConversionModuleRight。

◆ InsertSVGToPage()

static FSDK::VectorGraphics::InsertSVGToPage (   pdf_path,
  svg_path,
  out_pdf_path,
  page_index,
  x,
  y,
  width,
  height,
  dpi 
)
inlinestatic

将 SVG 文件插入已有 PDF 页面的指定矩形区域。

SVG 图形将渲染到源 PDF 指定页面的指定矩形内,结果写入 out_pdf_path。 源 PDF 的结构特性(线性化、XRef 流等)将自动保留。

参数
[in]pdf_path源 PDF 文件路径,不能为空字符串。
[in]svg_pathSVG 文件路径,不能为空字符串。
[in]out_pdf_path输出 PDF 文件路径,不能为空字符串。
[in]page_index要插入 SVG 的页面的从零开始的索引,有效范围:0 到(page_count-1)。
[in]x目标矩形左边缘的 X 坐标(单位:点)。
[in]y目标矩形下边缘的 Y 坐标(单位:点)。
[in]width目标矩形的宽度(单位:点),必须大于 0。
[in]height目标矩形的高度(单位:点),必须大于 0。
[in]dpi渲染分辨率(每英寸点数),必须大于 0。
返回
无。

◆ InsertSVGToPDF()

static FSDK::VectorGraphics::InsertSVGToPDF (   pdf_path,
  svg_path,
  out_pdf_path,
  page_index,
  page_width_pt,
  page_height_pt,
  dpi 
)
inlinestatic

将 SVG 文件作为新页面插入 PDF 文档。

在 page_index 处插入指定大小的新页面,并将 SVG 图形渲染到该页面上, 结果写入 out_pdf_path。

参数
[in]pdf_path源 PDF 文件路径。若为空字符串或文件不存在,将新建 PDF 文档。
[in]svg_pathSVG 文件路径,不能为空字符串。
[in]out_pdf_path输出 PDF 文件路径,不能为空字符串。
[in]page_index要插入的页面索引(从零开始)。小于 0 时插入开头,大于等于 page_count 时追加到末尾。
[in]page_width_pt新页面的宽度(单位:点),必须大于 0。
[in]page_height_pt新页面的高度(单位:点),必须大于 0。
[in]dpi渲染分辨率(每英寸点数),必须大于 0。
返回
无。

◆ InsertWMFToPage()

static FSDK::VectorGraphics::InsertWMFToPage (   pdf_path,
  wmf_path,
  out_pdf_path,
  page_index,
  x,
  y,
  width,
  height,
  dpi 
)
inlinestatic

将 WMF/EMF 文件插入已有 PDF 页面的指定矩形区域。

WMF/EMF 图形将渲染到源 PDF 指定页面的指定矩形内,结果写入 out_pdf_path。 源 PDF 的结构特性将自动保留。

参数
[in]pdf_path源 PDF 文件路径,不能为空字符串。
[in]wmf_pathWMF/EMF 文件路径,不能为空字符串。
[in]out_pdf_path输出 PDF 文件路径,不能为空字符串。
[in]page_index要插入 WMF/EMF 的页面的从零开始的索引,有效范围:0 到(page_count-1)。
[in]x目标矩形左边缘的 X 坐标(单位:点)。
[in]y目标矩形下边缘的 Y 坐标(单位:点)。
[in]width目标矩形的宽度(单位:点),必须大于 0。
[in]height目标矩形的高度(单位:点),必须大于 0。
[in]dpi渲染分辨率(每英寸点数),必须大于 0。
返回
无。

◆ InsertWMFToPDF()

static FSDK::VectorGraphics::InsertWMFToPDF (   pdf_path,
  wmf_path,
  out_pdf_path,
  page_index,
  page_width_pt,
  page_height_pt,
  dpi 
)
inlinestatic

将 WMF/EMF 文件作为新页面插入 PDF 文档。

在 page_index 处插入指定大小的新页面,并将 WMF/EMF 图形渲染到该页面上, 结果写入 out_pdf_path。

参数
[in]pdf_path源 PDF 文件路径。若为空字符串或文件不存在,将新建 PDF 文档。
[in]wmf_pathWMF/EMF 文件路径,不能为空字符串。
[in]out_pdf_path输出 PDF 文件路径,不能为空字符串。
[in]page_index要插入的页面索引(从零开始)。小于 0 时插入开头,大于等于 page_count 时追加到末尾。
[in]page_width_pt新页面的宽度(单位:点),必须大于 0。
[in]page_height_pt新页面的高度(单位:点),必须大于 0。
[in]dpi渲染分辨率(每英寸点数),必须大于 0。
返回
无。

◆ Release()

static FSDK::VectorGraphics::Release ( )
inlinestatic

释放矢量图形模块分配的所有资源。

当用户不再需要"矢量图形"模块时,应调用此函数以卸载共享库并释放所有相关资源。

返回
无。