福昕开发者文档中心

福昕 PDF SDK C/C++ 库 ​

本节主要介绍如何使用福昕 PDF SDK C/C++ 库运行示例及创建一个基础的 C/C++ 工程。该工程演示如何将 PDF 文档的首页渲染成 bitmap，并将其另存为 JPG 图片。

先决条件 ​

开发环境 ​

  • 编译 Linux C/C++ 或 Mac C++ 示例工程之前，请确保您已正确配置 GCC 编译器，且已安装CMake 3.1或更高版本。
  • 福昕 PDF SDK C 或 C++ 库（请通过 福昕开发中心 申请试用或获取下载指引，下载并安装与您的操作系统和架构匹配的 C 或 C++ 库；亦可联系福昕技术支持团队与销售代表）。

系统支持 ​

我们提供 Windows、Linux 和 Mac 平台的详细系统支持信息，包括操作系统版本、编译器要求等。请选择您的操作系统平台，查看详细信息。

提示

  • 当前 C 语言库仅支持 Windows 平台。

使用命令行运行示例 ​

使用命令行运行示例 ​

请参阅 示例，其中包含了示例工程简介，特定示例的依赖信息，以及如何通过命令行运行示例。

使用 Visual Studio 运行示例 ​

使用 Visual Studio 运行示例 ​

Windows 下，SDK 库通过 Vistual Stuidio 编译后，会在 \examples\simple_demo\bin 文件夹下将生成 .exe 可执行文件。可执行文件的名称取决于工程编译的配置。

运行所有示例 ​

  1. 打开解决方案： 在 \examples\simple_demo 文件夹下，根据您的 Visual Studio 版本，选择相应的解决方案文件（.sln）打开。

  2. 生成解决方案： 在 Visual Studio 中，选择 生成 > 生成解决方案 菜单，编译所有示例。

  3. 运行示例： 编译成功后，可使用以下方法运行相应的示例。
    方法一：直接运行 .exe 文件

    • 导航到 bin 文件夹，双击生成的 .exe 可执行文件即可运行相应的示例。
      方法二：在 Visual Studio 中运行
    • 在 解决方案资源管理器 中，右键单击您想要运行的示例项目，并选择 设为启动项目。
    • 按 F5 键或点击 调试 -> 开始调试 运行示例。

  4. 查看输出：

    • 示例运行结果将在 Visual Studio 的 “输出” 窗口或控制台窗口中显示。

    NOTE

    若需查看详细的示例执行过程，请通过命令行运行。

    • 打开 cmd.exe，使用 cd 命令导航至 \examples\simple_demo\bin 目录，然后执行特定的 .exe 文件。

运行某个特定示例 ​

  1. 生成示例工程： 在 Visual Studio 的解决方案资源管理器中，右键单击目标示例工程，选择生成。或者，直接双击示例工程文件夹下的 .vcxproj 文件，打开并生成该工程。
  2. 运行示例： 编译成功后，双击生成的 .exe 可执行文件即可运行该示例。

NOTE

  • 若需查看详细的示例执行过程，请通过命令行运行。
  • 打开 cmd.exe，使用 cd 命令导航至 \examples\simple_demo\bin 目录，然后执行特定的 .exe 文件。

使用 CMake 和 Make 编译并运行 C++ 示例 ​

在 Linux / Mac 下， SDK C++ 库支持 使用 CMake 和 Make 编译和运行示例。具体步骤如下：

  1. 导航到示例目录：
    • 通过终端，定位到包含示例代码的 .../examples/simple_demo 目录。
  2. 使用 CMake 配置编译：
    • 运行 cmake -DPRJ_NAME=XXX 命令，其中 XXX 是要编译的示例名称 (例如 "annotation", "attachment", "pdf2text" 等)。
    • CMake 会根据 PRJ_NAME 参数生成 Makefile 文件，用于后续的编译。
  3. 使用 Make 构建示例：
    • 运行 make 命令，根据之前生成的 Makefile 文件编译示例代码，并生成可执行文件。
    • 生成的可执行文件命名格式为 XXX_xxx，其中 XXX 是示例名称，xxx 是架构名称（例如 annotation_linux64）。
  4. 运行示例：
    • 执行 ./XXX_xxx 命令，运行编译生成的可执行文件。例如，执行 ./annotation_linux64 来运行 annotation 示例。

使用 Visual Studio 构建工程 ​

Windows 下，可使用 Visual Studio 构建工程。具体步骤如下：

使用 Makefile 构建工程 ​

Linux / Mac 下， 可使用 Makefile 构建工程。 具体步骤如下：