Skip to content

PDF 与 OFD 互转 ​

本节介绍如何使用 OfdConvert 在 PDF 与 OFD 文件之间互转,以及将 OFD 指定页导出为图片。互转能力归属 Conversion 转换模块,使用前须先成功调用 Library::Initialize,且许可证需包含 Conversion 模块权限。

OFD 文档内容处理(打开包、渲染、签名、水印等)请参阅 OFD;统一加载 PDF/OFD 请参阅 FLD。从 v11.x 升级时的互转(OfdConvert)迁移说明请参阅 v12.0 预览版发版说明。

能力概览 ​

能力说明
OFD 转 PDFOfdConvert::ToPdf
PDF 转 OFDOfdConvert::FromPdf
OFD 转图片OfdConvert::ToImage(page_index 从 0 起)
转换参数OFDConvertParam(文档索引、字体嵌入、DPI、图片质量等)

OFDConvertParam 主要字段:

字段说明
document_index多文档 OFD 包内待转换文档索引,默认 0
is_embed_font是否在输出文件中嵌入字体
ofd2pdf_sign_pic_red2blackOFD 转 PDF 时是否将签章图片红色转为黑色
dpi输出分辨率,默认 96;转图片时常设为 150 或更高
dib_format转图片时的位图格式(如 Bitmap::e_DIBArgb)
jpg_qualityJPEG 质量(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(&param, 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 会增大输出文件体积与处理耗时。