Cyclops.PdfKit

项目概述

Cyclops.PdfKit是企服版框架中的PDF处理工具包，提供了高效、灵活的PDF文档操作功能。该工具包专注于PDF文本提取、内容分析和基本操作，为企业应用中的PDF处理需求提供了简洁而强大的解决方案。

核心功能模块

1. PDF工具类（PdfUtil）

提供PDF文档的基本操作接口
支持PDF文本提取和内容分析
提供PDF页面管理功能
支持PDF内容搜索和定位
提供PDF文档信息获取

2. 文本块处理（TextChunk）

定义PDF文本块数据结构
提供文本块位置、大小、内容等属性
支持文本块的比较和分析
用于PDF文本提取和结构化处理

3. PDF内容分析

提供PDF文档结构分析
支持文本、图像等元素的识别和提取
提供基本的PDF格式分析

4. PDF文档操作

提供PDF页面的基本操作
支持简单的PDF编辑功能
提供PDF内容的读取和访问

技术栈

.NET 8.0：基础开发框架
PDF处理库：用于底层PDF文档解析
Cyclops.Common：公共库依赖

环境依赖

.NET 8.0或更高版本
相关的PDF处理库依赖

安装配置

安装

通过NuGet包管理器安装：

Install-Package TJC.Cyclops.PdfKit

或通过.NET CLI安装：

dotnet add package TJC.Cyclops.PdfKit

配置

无需额外配置，直接引用即可使用。

使用示例

1. PDF文本提取

// 提取PDF文档中的所有文本
string pdfPath = "example.pdf";
string text = PdfUtil.ExtractText(pdfPath);
Console.WriteLine(text);

// 提取指定页面的文本
string pageText = PdfUtil.ExtractTextFromPage(pdfPath, 1); // 提取第1页文本

2. PDF文本块分析

// 获取PDF文档中的文本块
List<TextChunk> chunks = PdfUtil.GetTextChunks("example.pdf");

// 遍历文本块
foreach (var chunk in chunks)
{
    Console.WriteLine($"文本: {chunk.Text}");
    Console.WriteLine($"位置: X={chunk.X}, Y={chunk.Y}");
    Console.WriteLine($"大小: Width={chunk.Width}, Height={chunk.Height}");
}

3. PDF文档信息获取

// 获取PDF文档信息
var info = PdfUtil.GetDocumentInfo("example.pdf");
Console.WriteLine($"标题: {info.Title}");
Console.WriteLine($"作者: {info.Author}");
Console.WriteLine($"页数: {info.PageCount}");
Console.WriteLine($"创建日期: {info.CreationDate}");

4. PDF内容搜索

// 在PDF中搜索文本
List<SearchResult> results = PdfUtil.SearchText("example.pdf", "关键词");

// 输出搜索结果
foreach (var result in results)
{
    Console.WriteLine($"页码: {result.PageNumber}");
    Console.WriteLine($"位置: X={result.X}, Y={result.Y}");
    Console.WriteLine($"上下文: {result.Context}");
}

5. 文本块操作

// 创建文本块
var chunk = new TextChunk
{
    Text = "示例文本",
    X = 100,
    Y = 200,
    Width = 150,
    Height = 20
};

// 文本块比较
var anotherChunk = new TextChunk { Text = "示例文本" };
bool isEqual = chunk.Equals(anotherChunk);

// 获取文本块的边界信息
var rectangle = chunk.GetBounds();

yswenli/TJC.Cyclops.PdfKitv2026.2.26.1

Get Started

Readme