PDF渲染器改进分支技术文档

1. 安装指南

本项目的安装过程主要依赖于Java环境。请确保你的系统中已安装Java运行时环境（JRE）或Java开发工具包（JDK）。

环境要求：

• Java 8 或更高版本

安装步骤：

1. 下载项目源代码。
2. 使用Java编译器编译源代码，或使用构建工具如Maven或Gradle构建项目。
3. 确保所有依赖项都已正确安装。
4. 编译完成后，将生成的jar文件添加到你的项目依赖中。

2. 项目使用说明

本项目是对原始PDF渲染器的改进分支，旨在解决原始版本中的多种问题并提供更多功能。以下是项目的一些关键功能和使用示例。

功能特点：

• 支持数字签名的注释小部件
• 支持函数类型4的渲染
• 支持链接注释以渲染链接
• 对戳记和自由文本注释的基本支持
• 处理替代色彩空间
• 修复透明度问题/透明遮罩图像
• 修正重叠形状的处理
• 对Type0字体使用嵌入式CID字体的更好支持
• 使用改进的"jpedal" API解码jbig2图像格式
• 修复JPEG和TIFF图像解码问题

使用示例：

以下是一个简单的Java类，用于显示PDF文件的内容：

public class PDFDisplay extends JComponent {

    private byte[] bytes = null;
    
    // 其他代码 ...

    @Override
    public void paintComponent(Graphics g) {
        int pageindex = 1;
        PDFFile pdfFile = new PDFFile(ByteBuffer.wrap(this.bytes));      
        PDFPage page = pdfFile.getPage(pageIndex);
        Paper paper = new Paper();
        int formatOrientation = page.getAspectRatio() > 1 ? PageFormat.LANDSCAPE
                            : PageFormat.PORTRAIT;
        if(formatOrientation == PageFormat.LANDSCAPE) {
            paper.setSize(page.getHeight(), page.getWidth());
        } else {
            paper.setSize(page.getWidth(), page.getHeight());
        }
        PageFormat pageFormat = new PageFormat();
        pageFormat.setPaper(paper);
        pageFormat.setOrientation(formatOrientation);

        Graphics2D g2d = (Graphics2D)g.create();
        Rectangle imgbounds = new Rectangle(0, 0, (int)pageFormat.getWidth(),
                        (int)pageFormat.getHeight());
        PDFRenderer renderer = new PDFRenderer(page, g2d, imgbounds, null, Color.WHITE);
        try {
            this.page.waitForFinish();
        }
        catch (InterruptedException e) {
            // 异常处理
        }
        renderer.run();
    }
}

3. 项目API使用文档

本项目提供了一系列API，以便开发者能够更好地使用PDF渲染器。以下是一些关键API的简要说明：

• PDFFile: 用于表示PDF文件的类。可以通过传入一个包含PDF内容的ByteBuffer来创建其实例。
• PDFPage: 代表PDF文件中的一个页面。可以通过PDFFile实例来获取单个页面的实例。
• PDFRenderer: 负责渲染PDF页面到Graphics2D对象。

更多API的详细信息，请参考项目源代码中的注释和Javadoc文档。

4. 项目安装方式

请遵循以下步骤以安装本项目：

1. 克隆或下载项目代码。
2. 在项目中配置Java编译环境。
3. 编译源代码或使用构建工具构建项目。
4. 将生成的jar文件添加到你的项目中。

确保你的项目依赖配置正确，以便能够使用本项目提供的功能。