PyTurboJPEG 技术文档

PyTurboJPEG 技术文档

PyTurboJPEG PyTurboJPEG is a highly optimized Python wrapper of libjpeg-turbo (TurboJPEG API) which supports x86 and ARM architecture. 项目地址: https://gitcode.com/gh_mirrors/py/PyTurboJPEG

PyTurboJPEG 是一个高效的 Python 封装库，专为解码和编码 JPEG 图像设计，它利用了 libjpeg-turbo 的加速特性，支持 x86 和 ARM 架构。此文档旨在提供全面的指南，帮助您快速上手并充分利用 PyTurboJPEG。

安装指南

前提条件

确保您的系统已安装以下组件：

• libjpeg-turbo: 可从其官方发布页面下载。
• numpy: 可通过 pip install numpy 安装。

在不同操作系统上的安装步骤

macOS

1. 使用 Homebrew 安装 libjpeg-turbo: brew install jpeg-turbo.
2. 通过 Git 安装最新版 PyTurboJPEG: pip install -U git+https://github.com/lilohuang/PyTurboJPEG.git.

Windows

1. 下载并安装 libjpeg-turbo 官方安装包。
2. 运行命令安装 PyTurboJPEG: pip install -U git+https://github.com/lilohuang/PyTurboJPEG.git。

Linux

• 对于 RHEL/CentOS/Fedora, 添加仓库并安装:
  1. 下载 libjpeg-turbo.repo 并放置在 /etc/yum.repos.d/。
  2. sudo yum install libjpeg-turbo-official。
  3. 然后安装 PyTurboJPEG。
• 在 Ubuntu 上:
  1. 更新包列表 sudo apt-get update。
  2. 安装 libturbojpeg sudo apt-get install libturbojpeg。
  3. 接着执行 pip install -U git+https://github.com/lilohuang/PyTurboJPEG.git。

项目的使用说明

PyTurboJPEG 提供了简洁的接口来处理 JPEG 图像，下面是几个基本操作的例子：

解码图像

使用默认设置解码图像:

import cv2
from turbojpeg import TurboJPEG

jpeg = TurboJPEG()
with open('input.jpg', 'rb') as in_file:
    bgr_array = jpeg.decode(in_file.read())
cv2.imshow('Decoded Image', bgr_array)
cv2.waitKey(0)

编码图像

将图像编码为 JPEG 格式:

# 继续上面的例子
out_file = open('output.jpg', 'wb')
out_file.write(jpeg.encode(bgr_array))
out_file.close()

高级功能

支持自定义选项，如颜色空间转换、质量调整等:

# 质量调整并编码
quality_encoded = jpeg.encode(bgr_array, quality=90, flags=TJFLAG_PROGRESSIVE)
with open('progressive_output.jpg', 'wb') as f:
    f.write(quality_encoded)

API 使用文档

PyTurboJPEG 提供的方法包括但不限于：

• decode(file_data): 解码 JPEG 数据到 BGR 数组。
• decode_header(file_data): 获取未解码图像的宽、高和色彩信息。
• scale_with_quality(...), crop(...): 实现高质量缩放和无损裁剪等高级操作。
• encode(image_array[, quality][, ...]): 以指定的质量和其他可选参数编码图像。

完整的 API 文档应在库的官方文档或源代码注释中查找更详细信息。

总结

PyTurboJPEG 通过简化 JPEG 图像处理过程，大大提高了开发者的工作效率。无论是简单的读写操作还是复杂的图像处理任务，PyTurboJPEG 都能提供强大的支持，并在性能上展现出明显优势。遵循上述指南，您可以迅速集成该库到您的项目中，享受高效便捷的图像处理体验。

PyTurboJPEG PyTurboJPEG is a highly optimized Python wrapper of libjpeg-turbo (TurboJPEG API) which supports x86 and ARM architecture. 项目地址: https://gitcode.com/gh_mirrors/py/PyTurboJPEG