o
e59 @ s d Z ddlZddlmZmZ ddlmZ ddlm Z m
Z
m Z m Z G dd d eZ
G d
d d e
ZG d d
d
e
ZG dd de
ZG dd de
ZdS )ag Read/Write images using FreeImage.
Backend Library: `FreeImage `_
.. note::
To use this plugin you have to install its backend::
imageio_download_bin freeimage
or you can download the backend using the function::
imageio.plugins.freeimage.download()
Each Freeimage format has the ``flags`` keyword argument. See the `Freeimage
documentation `_ for more information.
Parameters
----------
flags : int
A freeimage-specific option. In most cases we provide explicit
parameters for influencing image reading.
N )Format
image_as_uint) RETURN_BYTES )FNAME_PER_PLATFORMIO_FLAGSdownloadfic sl e Zd ZdZdZddd fdd Zedd Zd d
Zd d Z G d
d de
j Z G dd de
j Z Z
S )FreeimageFormatz$See :mod:`imageio.plugins.freeimage`iN)fifc s t j||||d || _d S )N)
extensionsmodes)super__init___fif)selfname descriptionr r r
__class__ ID:\Projects\ConvertPro\env\Lib\site-packages\imageio/plugins/freeimage.pyr * s
zFreeimageFormat.__init__c C s | j S N)r r r r r r
. s zFreeimageFormat.fifc C sx t r6t|ds"z t |jd|j|_W n ty! d|_Y nw |j| jkr*dS |jdkr8| jdkr:dS d S d S d S )Nr rT ) r
has_libhasattrgetFIFfilenameZ
firstbytesr Exceptionr
r requestr r r _can_read2 s
zFreeimageFormat._can_readc C sl t r2t|ds*z
t |jd|_W n ty) |jtkr$| j |_nd|_Y nw |j| j u r4dS d S d S )Nr wr T)
r
r r! r" r# r
ValueErrorZraw_urir r
r% r r r
_can_writeA s
zFreeimageFormat._can_writec @ s6 e Zd Zdd Zd
ddZdd Zdd Zd
d Zd S )zFreeimageFormat.Readerc C s dS )Nr r r r r r _get_lengthR s z"FreeimageFormat.Reader._get_lengthr c C s. t | jj| jj|| _| j| j d S r ) r
create_bitmapr& r# formatr
_bmZload_from_filenameget_local_filenamer flagsr r r _openU s z FreeimageFormat.Reader._openc C s | j d S r )r. closer r r r _closeY s z FreeimageFormat.Reader._closec C s$ |dkrt d| j | j fS )Nr z+This format only supports singleton images.)
IndexErrorr. Zget_image_data
get_meta_datar indexr r r _get_data\ s z FreeimageFormat.Reader._get_datac C s |d u s |dks t | j S )Nr )r5 r. r6 r7 r r r _get_meta_dataa s
z%FreeimageFormat.Reader._get_meta_dataNr )__name__
__module__ __qualname__r+ r2 r4 r9 r: r r r r ReaderQ s
r? c @ s. e Zd Zd ddZdd Zdd Zdd Zd
S ) zFreeimageFormat.Writerr c C s || _ d | _d| _i | _d S )NF)_flagsr. _is_set_metar0 r r r r2 i s
z FreeimageFormat.Writer._openc C s. | j | j | j | j | j d S r )r. Z
set_meta_datarB Zsave_to_filenamer& r/ r3 r r r r r4 o s z FreeimageFormat.Writer._closec C s | j sd| _ ntd|jdkr"|jd dkr"|d d d d df }| jd u r:t| jj| j j
| j | _| j | | j
| || _d S )NTz1Singleton image; can only append image data once. r r r )rA RuntimeErrorndimshaper. r
r, r& r# r- r
r@ allocateZset_image_datarB r immetar r r _append_datav s
z#FreeimageFormat.Writer._append_datac C s
|| _ d S r )rB )r rJ r r r _set_meta_data s
z%FreeimageFormat.Writer._set_meta_dataNr; )r< r= r> r2 r4 rK rL r r r r Writerh s
rM )NN)r< r= r> __doc__Z_modesr propertyr
r' r* r r? rM
__classcell__r r r r r % s
r c @ " e Zd ZdZG dd dejZdS )FreeimageBmpFormata A BMP format based on the Freeimage library.
This format supports grayscale, RGB and RGBA images.
The freeimage plugin requires a `freeimage` binary. If this binary
not available on the system, it can be downloaded manually from
by either
- the command line script ``imageio_download_bin freeimage``
- the Python method ``imageio.plugins.freeimage.download()``
Parameters for saving
---------------------
compression : bool
Whether to compress the bitmap using RLE when saving. Default False.
It seems this does not always work, but who cares, you should use
PNG anyway.
c @ s e Zd ZdddZdd ZdS ) zFreeimageBmpFormat.Writerr Fc C s0 t |}|r |tjO }n|tjO }tj| |S r )intr Z BMP_SAVE_RLEZ BMP_DEFAULTr rM r2 )r r1 compressionr r r r2 s
z FreeimageBmpFormat.Writer._openc C s t |dd}tj| ||S )N Zbitdepth)r r rM rK rH r r r rK s z&FreeimageBmpFormat.Writer._append_dataN)r Fr< r= r> r2 rK r r r r rM s
rM Nr< r= r> rN r rM r r r r rR s rR c @ 4 e Zd ZdZG dd dejZG dd dejZdS )FreeimagePngFormataY A PNG format based on the Freeimage library.
This format supports grayscale, RGB and RGBA images.
The freeimage plugin requires a `freeimage` binary. If this binary
not available on the system, it can be downloaded manually from
by either
- the command line script ``imageio_download_bin freeimage``
- the Python method ``imageio.plugins.freeimage.download()``
Parameters for reading
----------------------
ignoregamma : bool
Avoid gamma correction. Default True.
Parameters for saving
---------------------
compression : {0, 1, 6, 9}
The compression factor. Higher factors result in more
compression at the cost of speed. Note that PNG compression is
always lossless. Default 9.
quantize : int
If specified, turn the given RGB or RGBA image in a paletted image
for more efficient storage. The value should be between 2 and 256.
If the value of 0 the image is not quantized.
interlaced : bool
Save using Adam7 interlacing. Default False.
c @ e Zd ZdddZdS )zFreeimagePngFormat.Readerr Tc C $ t |}|r |tjO }tj| |S r )rS r ZPNG_IGNOREGAMMAr r? r2 )r r1 Z ignoregammar r r r2
z FreeimagePngFormat.Reader._openNr Tr< r= r> r2 r r r r r? r? c @ s e Zd Zd ddZdd ZdS )
zFreeimagePngFormat.Writerr Fc C sb t jt jt jt jd}t|}|r|t jO }z||| O }W n ty) tdw t j
| |S )N)r r ra z&Png compression must be 0, 1, 6, or 9.) r ZPNG_Z_NO_COMPRESSIONZPNG_Z_BEST_SPEEDZPNG_Z_DEFAULT_COMPRESSIONZPNG_Z_BEST_COMPRESSIONrS ZPNG_INTERLACEDKeyErrorr) r rM r2 )r r1 rT quantizeZ
interlacedZcompression_mapr r r r2 s
z FreeimagePngFormat.Writer._openc C s t |jdkrt|dd}nt|dd}tj| || t| jj dd}|s*d S |j
dkr6|j d dks:t d |d
k sB|d krFt d | j
d
|}| j
|| _
d S )NZuint16 rV rU rd FrC r z Can only quantize RGB imagesr z!PNG quantize param must be 2..256r )strZdtyper r rM rK rS r& kwargsgetrE rF r) r. rd r3 )r rI rJ qZbmr r r rK s
z&FreeimagePngFormat.Writer._append_dataN)r ra r FrW r r r r rM s
rM Nr< r= r> rN r r? rM r r r r rZ s rZ c @ rY )FreeimageJpegFormataA A JPEG format based on the Freeimage library.
This format supports grayscale and RGB images.
The freeimage plugin requires a `freeimage` binary. If this binary
not available on the system, it can be downloaded manually from
by either
- the command line script ``imageio_download_bin freeimage``
- the Python method ``imageio.plugins.freeimage.download()``
Parameters for reading
----------------------
exifrotate : bool
Automatically rotate the image according to the exif flag.
Default True. If 2 is given, do the rotation in Python instead
of freeimage.
quickread : bool
Read the image more quickly, at the expense of quality.
Default False.
Parameters for saving
---------------------
quality : scalar
The compression factor of the saved image (1..100), higher
numbers result in higher quality but larger file size. Default 75.
progressive : bool
Save as a progressive JPEG file (e.g. for images on the web).
Default False.
optimize : bool
On saving, compute optimal Huffman coding tables (can reduce a
few percent of file size). Default False.
baseline : bool
Save basic JPEG, without metadata or any markers. Default False.
c @ s& e Zd Zd ddZdd Zdd Zd
S ) zFreeimageJpegFormat.Readerr TFc C s: t |}|r|dkr|tjO }|s|tjO }tj| |S )Nr )rS r ZJPEG_EXIFROTATEZ
JPEG_ACCURATEr r? r2 )r r1
exifrotateZ quickreadr r r r2 4 s
z FreeimageJpegFormat.Reader._openc C s& t j| |\}}| ||}||fS r )r r? r9 _rotate)r r8 rI rJ r r r r9 > s z$FreeimageJpegFormat.Reader._get_datac C s | j jdddkrHz|d d }W n
ty Y |S w |dv r" |dv r,t|d}|dv r6t|d }|d
v r?t|}|d v rHt|}|S ) aN Use Orientation information from EXIF meta data to
orient the image correctly. Freeimage is also supposed to
support that, and I am pretty sure it once did, but now it
does not, so let's just do it in Python.
Edit: and now it works again, just leave in place as a fallback.
rm Nr Z EXIF_MAINZ Orientation)r r )rC ) rb rC )r rU )r ro rp r )r& rh ri rc npZrot90Zfliplr)r rI rJ Zorir r r rn C s$
z"FreeimageJpegFormat.Reader._rotateN)r TF)r< r= r> r2 r9 rn r r r r r? 3 s
r? c @ s e Zd Z d ddZdd ZdS )
zFreeimageJpegFormat.Writerr K Fc C sh t |}|dk s |dkrtdt |}||O }|r |tjO }|r&|tjO }|r-|tjO }tj| |S )Nr d z)JPEG quality should be between 1 and 100.) rS r) r ZJPEG_PROGRESSIVEZ
JPEG_OPTIMIZEZ
JPEG_BASELINEr rM r2 )r r1 ZqualityZ progressiveoptimizeZbaseliner r r r2 ` s
z FreeimageJpegFormat.Writer._openc C s< |j dkr|jd dkrtdt|dd}tj| ||S )NrC r ro z$JPEG does not support alpha channel.rU rV )rE rF IOErrorr r rM rK rH r r r rK s s z'FreeimageJpegFormat.Writer._append_dataN)r rr FFFrW r r r r rM _ s
rM Nrk r r r r rl
s %,rl c @ rQ )FreeimagePnmFormatal A PNM format based on the Freeimage library.
This format supports single bit (PBM), grayscale (PGM) and RGB (PPM)
images, even with ASCII or binary coding.
The freeimage plugin requires a `freeimage` binary. If this binary
not available on the system, it can be downloaded manually from
by either
- the command line script ``imageio_download_bin freeimage``
- the Python method ``imageio.plugins.freeimage.download()``
Parameters for saving
---------------------
use_ascii : bool
Save with ASCII coding. Default True.
c @ r[ )zFreeimagePnmFormat.Writerr Tc C r\ r )rS r ZPNM_SAVE_ASCIIr rM r2 )r r1 Z use_asciir r r r2 r] z FreeimagePnmFormat.Writer._openNr^ r_ r r r r rM r` rM NrX r r r r rv z s rv )rN numpyrq corer r Z core.requestr Z
_freeimager r r r
r rR rZ rl rv r r r r s r%Qm