关于 syncfusion-dotnet-pdf-to-image
用于生成 Syncfusion .NET PDF Library 的 C# 代码,将 PDF 页面或页面范围转换为图像流。它指导开发者识别项目类型,并仅依据参考资料中的 API 和包信息编写代码。
主要功能
- 01转换单页或页面范围
- 02自定义图像尺寸和 DPI
- 03设置透明度与注释选项
- 04按项目类型提供 NuGet 指引
- 05仅根据参考资料生成代码
适用场景
- 01生成 PDF 页面转换的 C# 示例
- 02按应用类型调整转换代码
安装
复制下面的命令,在终端中运行。
npx skills add https:/ / github.com/ syncfusion/ document-sdk-skills --skill syncfusion-dotnet-pdf-to-image安装后在 Claude Code 中输入/syncfusion-dotnet-pdf-to-image确认已加载。
包含的文件
除 SKILL.md 外,安装时一起下载的参考资料和脚本。
README.mdreferences/customizing-conversion.mdload.mdmultithreading-pdf-to-image.mdnuget-packages.md详细介绍
使用 Syncfusion .NET PDF 库将 PDF 转换为图像
概述
此 PDF 转图像库无需在 PDF Viewer 控件中打开文档,即可将 PDF 文档转换为图像。它允许你使用 Convert 方法有选择地将页面导出为流,从而将 PDF 文件转换为图像。
快速入门示例
示例 1:生成代码
用户:“给我展示将 PDF 转换为图像的 C# 代码。” **结果:**显示 C# 代码片段(不创建文件)
一种模式
模式 1:为用户的项目生成 C# 代码 (默认)
当用户想要查看、编写、审查、重构或修改与 PDF 转图像处理相关的 C# 代码时,使用此模式。许可、身份验证和机密配置不在范围内。
触发关键词:“给我展示如何”“如何”“怎么做”“我该怎么做”“提供代码”“提供示例”“举个例子”“演示”“代码片段”“示例代码”“示例”“样例”“给我”“展示给我”“Program.cs”“示例代码”“为……生成代码”“codesnippet”。
工作流:
步骤 1 — 检测应用程序类型并建议所需的 NuGet 包
-
检查工作区项目文件(
.csproj、web.config、App.config、Startup.cs、Program.cs等),并使用references/nuget-packages.md中的检测信号表来确定应用程序类型。 -
根据检测到的应用程序类型,从 references/nuget-packages.md 中确定正确的 NuGet 包,并在生成任何代码之前指示用户安装这些包。
步骤 2 — 仅根据参考文件生成代码
切勿编造、猜测或建议参考文件中未明确列出的任何 API、方法、属性、类或命名空间。
- 阅读与所请求功能相关的
references/*.md文件 - 严格依据这些文件中的 API 和代码片段构建 C# 代码。
- 排除任何许可、身份验证或机密处理逻辑。
- 不要创建或运行任何
.csx脚本
API 摘要
| API / 属性 | 用途 |
|---|---|
new PdfToImageConverter(stream) | 通过构造函数从流加载 PDF 文档 |
new PdfToImageConverter(stream, password) | 通过构造函数从流加载加密的 PDF 文档 |
imageConverter.Load(stream) | 使用 Load 方法从流加载 PDF 文档 |
imageConverter.Load(stream, password) | 使用 Load 方法从流加载加密的 PDF 文档 |
imageConverter.Convert(pageIndex, keepTransparency, isSkipAnnotations) | 将单个 PDF 页面转换为图像流 |
imageConverter.Convert(startPage, endPage, keepTransparency, isSkipAnnotations) | 将一系列 PDF 页面转换为图像流数组 |
imageConverter.Convert(pageIndex, SizeF, keepAspectRatio, keepTransparency, isSkipAnnotations) | 将 PDF 页面转换为具有自定义宽度和高度的图像 |
imageConverter.Convert(startPage, endPage, dpiX, dpiY, keepTransparency, isSkipAnnotations) | 以自定义 DPI 分辨率将一系列 PDF 页面转换为图像(MVC / WinForms / WPF) |
imageConverter.Convert(pageIndex, zoomFactor, tileXCount, tileYCount, tileX, tileY) | 使用缩放因子和平铺矩阵坐标将 PDF 页面转换为图像(ASP.NET Core / Blazor) |
imageConverter.Convert(startPageIndex, endPageIndex, SizeF, dpiX, dpiY, keepAspectRatio, keepTransparency, isSkipAnnotations) | 以自定义尺寸和 DPI 分辨率将一系列 PDF 页面转换为图像流(MVC / WinForms / WPF) |
imageConverter.Convert(startPageIndex, endPageIndex, SizeF, keepAspectRatio, keepTransparency, isSkipAnnotations) | 将一系列 PDF 页面转换为具有自定义宽度和高度的图像流。 |
imageConverter.Convert(pageIndex, SizeF, dpiX, dpiY,keepAspectRatio, keepTransparency, isSkipAnnotations) | 将单个 PDF 页面转换为具有自定义尺寸和 DPI 的图像。 |
imageConverter.Dispose() | 释放 PdfToImageConverter 使用的所有资源。 |
imageConverter.PageCount | 获取已加载 PDF 文档的总页数 |
imageConverter.ScaleFactor | 设置缩放因子以提升输出图像质量(默认值:1.5f) |
imageConverter.ReferencePath | 在访问受限的环境中,为 PDFium 二进制文件提取设置自定义文件夹路径 |
代码参考
所有模板和代码片段均位于 references/ 文件夹中:
| 文件 | 内容 |
|---|---|
nuget-packages.md | 列出各目标平台的 PDFToImageConverter 所需 NuGet 包,以及用于检测应用类型的信号 |
load.md | 使用构造函数或 Load 方法,将普通或加密的 PDF 文档作为流加载到 PdfToImageConverter 中。转换完成后,使用 Dispose 方法释放 PdfToImageConverter |
customizing-conversion.md | 将 PDF 页面转换为图像——支持单页、页面范围、自定义尺寸、自定义 DPI 以及缩放 / 平铺分辨率 |
multithreading-pdf-to-image.md | 使用多线程将 PDF 页面转换为图像——通过基于 Task 的异步模式和 Parallel.For 模式实现 |
规则
- 输出文件放在
./output/目录中 - 不要使用参考资料中未列出的 API
前提条件
- 生成代码前,请通过 NuGet 安装所需的运行时和库包。
- .NET SDK 8+