GhostscriptSharp 技术文档

1. 安装指南

1.1 环境要求

• .NET Framework 4.0 或更高版本
• Ghostscript 库（确保已安装并配置好环境变量）

1.2 安装步骤

1. 下载 GhostscriptSharp 项目源码或通过 NuGet 包管理器安装。
2. 如果通过 NuGet 安装，使用以下命令：

   Install-Package GhostscriptSharp
   

3. 确保 Ghostscript 库已正确安装并配置好环境变量，以便 GhostscriptSharp 能够正常调用 Ghostscript 库。

2. 项目使用说明

GhostscriptSharp 是一个简单的 C# 封装库，用于调用 Ghostscript 库将 PDF 文件转换为 JPG 图像。它提供了三个静态方法，分别用于生成单页缩略图、多页缩略图以及基于设置生成输出。

2.1 生成单页缩略图

使用 GeneratePageThumb 方法可以为 PDF 文件的指定页面生成一张缩略图。

GhostscriptWrapper.GeneratePageThumb(string inputPath, string outputPath, int page, int width, int height);

参数说明

• inputPath: PDF 文件的路径。
• outputPath: 输出 JPG 文件的路径。
• page: 要生成图像的页面编号。
• width: 输出图像的宽度。
• height: 输出图像的高度。

2.2 生成多页缩略图

使用 GeneratePageThumbs 方法可以为 PDF 文件的多个页面生成一系列缩略图。

GhostscriptWrapper.GeneratePageThumbs(string inputPath, string outputPath, int firstPage, int lastPage, int width, int height);

参数说明

• inputPath: PDF 文件的路径。
• outputPath: 输出 JPG 文件的路径（可以在路径中使用 %d 来为每个页面生成编号）。
• firstPage: 开始生成缩略图的页面编号。
• lastPage: 结束生成缩略图的页面编号。
• width: 输出图像的宽度。
• height: 输出图像的高度。

2.3 基于设置生成输出

使用 GenerateOutput 方法可以根据指定的设置生成 Ghostscript 输出。

GhostscriptWrapper.GenerateOutput(string inputPath, string outputPath, GhostscriptSettings settings);

参数说明

• inputPath: PDF 文件的路径。
• outputPath: 输出 JPG 文件的路径。
• settings: 包含输出设置的 GhostscriptSettings 对象（详见源码中的设置列表）。

3. 项目API使用文档

3.1 GeneratePageThumb 方法

public static void GeneratePageThumb(string inputPath, string outputPath, int page, int width, int height);

• 功能: 生成 PDF 文件中指定页面的缩略图。
• 参数:
  • inputPath: PDF 文件路径。
  • outputPath: 输出 JPG 文件路径。
  • page: 页面编号。
  • width: 图像宽度。
  • height: 图像高度。

3.2 GeneratePageThumbs 方法

public static void GeneratePageThumbs(string inputPath, string outputPath, int firstPage, int lastPage, int width, int height);

• 功能: 生成 PDF 文件中多个页面的缩略图。
• 参数:
  • inputPath: PDF 文件路径。
  • outputPath: 输出 JPG 文件路径（支持 %d 编号）。
  • firstPage: 起始页面编号。
  • lastPage: 结束页面编号。
  • width: 图像宽度。
  • height: 图像高度。

3.3 GenerateOutput 方法

public static void GenerateOutput(string inputPath, string outputPath, GhostscriptSettings settings);

• 功能: 根据设置生成 Ghostscript 输出。
• 参数:
  • inputPath: PDF 文件路径。
  • outputPath: 输出 JPG 文件路径。
  • settings: 包含输出设置的 GhostscriptSettings 对象。

4. 项目安装方式

4.1 通过 NuGet 安装

使用以下命令通过 NuGet 安装 GhostscriptSharp：

Install-Package GhostscriptSharp

4.2 手动安装

1. 下载 GhostscriptSharp 项目源码。
2. 将项目添加到您的解决方案中。
3. 确保 Ghostscript 库已正确安装并配置好环境变量。

通过以上步骤，您可以成功安装并使用 GhostscriptSharp 项目。