PDF 与 OFD 互转
本节介绍如何使用 OfdConvert 在 PDF 与 OFD 文件之间互转,以及将 OFD 指定页导出为图片。互转能力归属 Conversion 转换模块,使用前须先成功调用 Library::Initialize,且许可证需包含 Conversion 模块权限。
OFD 文档内容处理(打开包、渲染、签名、水印等)请参阅 OFD;统一加载 PDF/OFD 请参阅 FLD。从 v11.x 升级时的互转(OfdConvert)迁移说明请参阅 v12.0 预览版发版说明。
能力概览
| 能力 | 说明 |
|---|---|
| OFD 转 PDF | OfdConvert::ToPdf |
| PDF 转 OFD | OfdConvert::FromPdf |
| OFD 转图片 | OfdConvert::ToImage(page_index 从 0 起) |
| 转换参数 | OFDConvertParam(文档索引、字体嵌入、DPI、图片质量等) |
OFDConvertParam 主要字段:
| 字段 | 说明 |
|---|---|
document_index | 多文档 OFD 包内待转换文档索引,默认 0 |
is_embed_font | 是否在输出文件中嵌入字体 |
ofd2pdf_sign_pic_red2black | OFD 转 PDF 时是否将签章图片红色转为黑色 |
dpi | 输出分辨率,默认 96;转图片时常设为 150 或更高 |
dib_format | 转图片时的位图格式(如 Bitmap::e_DIBArgb) |
jpg_quality | JPEG 质量(1–100),默认 75 |
img_width / img_height | 转图片时的目标宽高(0 表示按 DPI 自动计算) |
page_split_x_count / page_split_y_count | 页面拆分栅格数 |
password | 源文件打开密码(未加密时为空字符串) |
v12.0 起 无需 调用 Library::InitializeOFDEngine / ReleaseOFDEngine;OFD 引擎随 SDK 内置,初始化 Library 后即可使用 OfdConvert。
示例
以下示例演示 OFD 与 PDF 互转及 OFD 转图片。完整可运行工程见 SDK 发布包 examples/simple_demo/ofd2pdf/。
c++
#include "common/fs_common.h"
#include "addon/conversion/fs_convert.h"
using namespace foxit;
using namespace foxit::common;
using namespace foxit::addon::conversion;
bool ConvertOfdAndPdf() {
// 须先 Library::Initialize(sn, key) 成功
OFDConvertParam param;
param.document_index = 0;
param.is_embed_font = true;
param.dpi = 150;
param.jpg_quality = 85;
param.password = "";
WString ofd_path = L"input/sample.ofd";
WString pdf_path = L"output/sample.pdf";
WString ofd_out_path = L"output/sample.ofd";
WString img_path = L"output/page0.jpg";
if (!OfdConvert::ToPdf(ofd_path, "", pdf_path, param)) {
return false;
}
if (!OfdConvert::FromPdf(pdf_path, "", ofd_out_path, param)) {
return false;
}
if (!OfdConvert::ToImage(ofd_path, "", img_path, param, 0)) {
return false;
}
return true;
}
c
#include "fs_basictypes_c.h"
#include "fs_convert_c.h"
int ConvertOfdAndPdf(const wchar_t* ofd_path,
const wchar_t* pdf_path,
const wchar_t* ofd_out_path,
const wchar_t* img_path) {
/* 须先 FSDK_Library_Initialize(sn, key) 成功 */
FSOFDConvertParam param;
FS_BOOL result = FALSE;
memset(¶m, 0, sizeof(param));
param.document_index = 0;
param.is_embed_font = TRUE;
param.dpi = 150;
param.dib_format = e_FSDIBArgb;
param.jpg_quality = 85;
param.img_width = 0.0f;
param.img_height = 0.0f;
param.page_split_x_count = 1;
param.page_split_y_count = 1;
param.password.str = NULL;
param.password.len = 0;
if (FSDK_OfdConvert_ToPdf(ofd_path, L"", pdf_path, param, &result) != e_FSErrSuccess
|| !result) {
return 0;
}
if (FSDK_OfdConvert_FromPdf(pdf_path, L"", ofd_out_path, param, &result) != e_FSErrSuccess
|| !result) {
return 0;
}
if (FSDK_OfdConvert_ToImage(ofd_path, L"", img_path, param, 0, &result) != e_FSErrSuccess
|| !result) {
return 0;
}
return 1;
}
java
import com.foxit.sdk.PDFException;
import com.foxit.sdk.addon.conversion.OFDConvertParam;
import com.foxit.sdk.addon.conversion.OfdConvert;
public class PdfOfdConversion {
public static boolean convertOfdAndPdf() throws PDFException {
// 须先 Library.initialize(sn, key) 成功
OFDConvertParam param = new OFDConvertParam();
param.setDocument_index(0);
param.setIs_embed_font(true);
param.setDpi(150);
param.setJpg_quality(85);
String ofdPath = "input/sample.ofd";
String pdfPath = "output/sample.pdf";
String ofdOutPath = "output/sample.ofd";
String imgPath = "output/page0.jpg";
if (!OfdConvert.toPdf(ofdPath, "", pdfPath, param)) {
return false;
}
if (!OfdConvert.fromPdf(pdfPath, "", ofdOutPath, param)) {
return false;
}
if (!OfdConvert.toImage(ofdPath, "", imgPath, param, 0)) {
return false;
}
return true;
}
}
csharp
using foxit.addon.conversion;
bool ConvertOfdAndPdf()
{
// 须先 Library.Initialize(sn, key) 成功
OFDConvertParam param = new OFDConvertParam();
param.document_index = 0;
param.is_embed_font = true;
param.dpi = 150;
param.jpg_quality = 85;
string ofdPath = "input/sample.ofd";
string pdfPath = "output/sample.pdf";
string ofdOutPath = "output/sample.ofd";
string imgPath = "output/page0.jpg";
if (!OfdConvert.ToPdf(ofdPath, "", pdfPath, param))
{
return false;
}
if (!OfdConvert.FromPdf(pdfPath, "", ofdOutPath, param))
{
return false;
}
if (!OfdConvert.ToImage(ofdPath, "", imgPath, param, 0))
{
return false;
}
return true;
}
python
from FoxitPDFSDKPython3 import *
def convert_ofd_and_pdf():
# 须先 Library.Initialize(sn, key) 成功
param = OFDConvertParam()
param.document_index = 0
param.is_embed_font = True
param.dpi = 150
param.jpg_quality = 85
ofd_path = "input/sample.ofd"
pdf_path = "output/sample.pdf"
ofd_out_path = "output/sample.ofd"
img_path = "output/page0.jpg"
if not OfdConvert_ToPdf(ofd_path, "", pdf_path, param):
return False
if not OfdConvert_FromPdf(pdf_path, "", ofd_out_path, param):
return False
if not OfdConvert_ToImage(ofd_path, "", img_path, param, 0):
return False
return True
go
package main
import "foxit.com/fsdk"
func ConvertOfdAndPdf() bool {
// 须先 fsdk.LibraryInitialize(sn, key) 成功
param := fsdk.NewOFDConvertParam()
defer fsdk.DeleteOFDConvertParam(param)
param.SetIs_embed_font(true)
param.SetDpi(150)
param.SetJpg_quality(85)
ofdPath := "input/sample.ofd"
pdfPath := "output/sample.pdf"
ofdOutPath := "output/sample.ofd"
imgPath := "output/page0.jpg"
if !fsdk.OfdConvertToPdf(ofdPath, "", pdfPath, param) {
return false
}
if !fsdk.OfdConvertFromPdf(pdfPath, "", ofdOutPath, param) {
return false
}
if !fsdk.OfdConvertToImage(ofdPath, "", imgPath, param, 0) {
return false
}
return true
}
js
const FSDK = require("@fuxinsoft/fuxin-pdf-ofd-sdk-node");
function convertOfdAndPdf() {
// 须先 FSDK.Library.Initialize(sn, key) 成功
const param = new FSDK.OFDConvertParam();
param.is_embed_font = true;
param.dpi = 150;
param.jpg_quality = 85;
const ofdPath = "input/sample.ofd";
const pdfPath = "output/sample.pdf";
const ofdOutPath = "output/sample.ofd";
const imgPath = "output/page0.jpg";
if (!FSDK.OfdConvert.ToPdf(ofdPath, "", pdfPath, param)) {
return false;
}
if (!FSDK.OfdConvert.FromPdf(pdfPath, "", ofdOutPath, param)) {
return false;
}
if (!FSDK.OfdConvert.ToImage(ofdPath, "", imgPath, param, 0)) {
return false;
}
return true;
}
注意事项
- v11.x 使用的
Convert::FromOFD/Convert::ToOFD与InitializeOFDEngine在 v12.0 已移除,请改用OfdConvert并删除 OFD 引擎独立初始化步骤。 - 提高
dpi或jpg_quality会增大输出文件体积与处理耗时。