OilyPNG 技术文档

1. 安装指南

1.1 安装环境要求

• Ruby 环境
• 不需要依赖 LibPNG、ImageMagick 或其他图像处理库

1.2 安装步骤

1. 打开终端或命令行工具。
2. 使用 gem 命令安装 OilyPNG：

   gem install oily_png
   

3. 安装完成后，确保 OilyPNG 已成功安装并可以在项目中使用。

2. 项目的使用说明

2.1 基本使用

1. 在项目中引入 OilyPNG：

   require "oily_png"
   

2. 使用 OilyPNG 代替 ChunkyPNG 进行 PNG 图像的解码和编码操作。
3. 通过 OilyPNG 提供的加速功能，可以显著提高 PNG 图像处理的性能，尤其是在处理带有过滤器的 PNG 图像时。

2.2 性能对比

OilyPNG 提供了更快的 PNG 解码和编码速度，具体性能对比可以参考相关的性能测试结果。

3. 项目 API 使用文档

3.1 解码 PNG 图像

OilyPNG 提供了高效的 PNG 解码功能，使用方法与 ChunkyPNG 类似，但性能更优。

3.2 编码 PNG 图像

OilyPNG 支持多种 PNG 编码方式，包括自动检测颜色模式、无压缩、快速 RGBA、快速 RGB 等。

3.3 图像像素访问

OilyPNG 允许直接访问和修改图像的像素数据，支持内存高效的像素操作。

4. 项目安装方式

4.1 通过 RubyGems 安装

使用以下命令通过 RubyGems 安装 OilyPNG：

gem install oily_png

4.2 手动安装

1. 下载 OilyPNG 的源代码。
2. 解压源代码并进入项目目录。
3. 运行以下命令进行安装：

   ruby setup.rb
   

5. 注意事项

• OilyPNG 是一个 Ruby C 扩展模块，首次编写 C 代码，可能存在内存泄漏等问题，使用时需谨慎。
• 使用 OilyPNG 时，请确保已正确安装并引入，以避免运行时错误。

通过以上文档，您可以快速了解并使用 OilyPNG 项目，享受其带来的性能提升。