ImageIO FreeImage

警告

此仓库使用的是FreeImage开源双许可证，而不是我们用于其他所有内容的典型BSD-2许可证。请检查此仓库中的LICENSE文档，并确保您理解其后果。

ImageIO FreeImage是ImageIO库的FreeImage库插件。换句话说，它允许使用FreeImage与ImageIO。

安装

pip install imageio-freeimage
python -c "imageio.plugins.freeimage.download()"

使用（示例）

要使用它，只需导入库。它将自动与ImageIO注册。

import imageio.v3 as iio
import imageio_freeimage

img = iio.imread("imageio:chelsea.png", plugin="PNG-FI")

为什么选择ImageIO FreeImage

基于在ImageIO主仓库中的讨论，我们决定分拆FreeImage插件。这是出于两个原因

1. FreeImage许可证的适用性尚不清楚，它与BSD（ImageIO的许可证）的确切交互以及这对不需要FreeImage的下游用户意味着什么尚不明确。为了避免这种交互的后果，我们决定分拆FreeImage插件。这样，除非用户明确需要FreeImage，否则无需担心，在这种情况下，他们可能会意识到FreeImage的许可证以及这对他们的项目意味着什么。

2. 我们提供的FreeImage绑定基于ctypes。在许多情况下，这不会成问题；然而，对于一些用户来说，这会引发一些问题，因为他们，例如，使用pypy或其他非CPython解释器，或者他们想要通过pyodide在浏览器中编译Python代码。当涉及到ctypes时，这些用例更容易出现问题，将它们放入专门的可选依赖项中可以简化这种情况。

3. 我们可以添加 plumbing 来在 CD 中编译 FreeImage 并预编译它，而无需任何安装后操作。