Skip to main content

A plugin for ImageIO that wraps the FreeImage library

Project description

ImageIO FreeImage

CI

Warning

This repo is licensed under the FreeImage Open Source Dual-License and not the typical BSD-2 license we use for everything else. Check out the LICENSE document in this repo and make sure you understand the consequences.

ImageIO FreeImage is a ImageIO plugin for the FreeImage library. In other words, it allows using FreeImage with ImageIO.

Installation

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

Usage (and Examples)

To use it simply import the library. It will auto-register with ImageIO.

import imageio.v3 as iio
import imageio_freeimage

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

Why ImageIO FreeImage

Based on discussions over at ImageIO's main repository, we have decided to spin out the FreeImage plugin. This was done for two reasons

  1. It is/was unclear how permissible the FreeImage license is, how exactly it interacts with BSD (ImageIO's license), and what that means for downstream users who don't need FreeImage. Instead of having to deal with the fallout of this interaction, we decided to spin out the FreeImage plugin. This way, users don't have to worry, unless they explicitly need FreeImage, in which case they will likely be aware of how FreeImage is licensed, and what it means for their project.

  2. The FreeImage bindings we provide are based on ctypes. In many cases this is not a problem; however, for some users it causes complications, because they, for example, use pypy or other non-cpython interpreters or they want to complile their python code in a browser via pyodide. Those use-cases are more prone to problems when ctypes are involved and having them in a dedicated optional dependency make this situation easier.

  3. We can add plumbing to compile FreeImage in CD and ship it precompiled without the need for any post-install actions.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

imageio_freeimage-0.1.1.tar.gz (29.9 kB view details)

Uploaded Source

Built Distribution

imageio_freeimage-0.1.1-cp310-cp310-win_amd64.whl (30.3 kB view details)

Uploaded CPython 3.10 Windows x86-64

File details

Details for the file imageio_freeimage-0.1.1.tar.gz.

File metadata

  • Download URL: imageio_freeimage-0.1.1.tar.gz
  • Upload date:
  • Size: 29.9 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: poetry/1.2.1 CPython/3.10.0 Windows/10

File hashes

Hashes for imageio_freeimage-0.1.1.tar.gz
Algorithm Hash digest
SHA256 e2b40ac6de4a4e391a2865a0753476d4de96be6a19c2166d13a59e60c68e40d1
MD5 802eba860650ef65ecaa73ecdacdbae6
BLAKE2b-256 56f8d5ff8a1a39427545b36560a321c215300471024460b07e810e6dab24b15d

See more details on using hashes here.

File details

Details for the file imageio_freeimage-0.1.1-cp310-cp310-win_amd64.whl.

File metadata

File hashes

Hashes for imageio_freeimage-0.1.1-cp310-cp310-win_amd64.whl
Algorithm Hash digest
SHA256 4dc915356ad92ab51f7003b0767c578ec79736c514781cb3e08fcd10a1473925
MD5 51ef527d3a883f8fa46641f02bb7c451
BLAKE2b-256 1827297f368a388b77addc22f43808c57f84802a5723d94510fb2fda6d4a85e4

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page