2?j59 d Z ddlZddlmZmZ ddlmZ ddlm Z m
Z
m Z m Z G d d e Z
G d
d e
Z G d d
e
Z G d de
Z G d 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 e Zd ZdZdZd
dd fd Zed Zd Zd Z G d d
e
j Z G d d e
j Z xZ
S )FreeimageFormatz$See :mod:`imageio.plugins.freeimage`iN)fifc ` t |||| || _ d S )N)
extensionsmodes)super__init___fif)selfname descriptionr r r __class__s JC:\Projects\Historical\venv\Lib\site-packages\imageio/plugins/freeimage.pyr zFreeimageFormat.__init__* s/
{zOOO c | j S N)r r s r r zFreeimageFormat.fif. s
yr c $ t j rxt |d s> t j |j d|j |_ n# t $ r
d|_ Y nw xY w|j | j k rdS |j dk r| j dk rdS d S d S d S )Nr rT ) r has_libhasattrgetFIFfilename
firstbytesr Exceptionr r requests r _can_readzFreeimageFormat._can_read2 s
:<< 7F++
&&#%9W-=sGDV#W#WGLL & & &#%GLLL&|tx''t ""tx2~~ t #"~~s %A A A c t j rut |d sU t j |j d |_ n4# t $ r' |j t k r
| j |_ nd|_ Y nw xY w|j | j u rdS d S d S )Nr wr! T)
r r$ r% r& r' r
ValueErrorraw_urir r r* s r
_can_writezFreeimageFormat._can_writeA s
:<<
7F++
**#%9W-=s#C#CGLL! * * * ,66'+x ') *
|tx''t
('s A .A65A6c . e Zd Zd ZddZd Zd Zd ZdS ) FreeimageFormat.Readerc dS )Nr r s r _get_lengthz"FreeimageFormat.Reader._get_lengthR s 1r r c t j | j j | j j | | _ | j | j d S r ) r
create_bitmapr+ r' formatr _bmload_from_filenameget_local_filenamer flagss r _openz FreeimageFormat.Reader._openU sL ' (=t{PUVVDH H ' ' (G(G(I(I J J J J Jr c 8 | j d S r )r: closer s r _closez FreeimageFormat.Reader._closeY s HNN r c |dk rt d | j | j fS )Nr z+This format only supports singleton images.)
IndexErrorr: get_image_data
get_meta_datar indexs r _get_dataz FreeimageFormat.Reader._get_data\ sA zz !NOOO8**,,dh.D.D.F.FF Fr c ` ||dk st | j S )Nr )rD r: rF rG s r _get_meta_dataz%FreeimageFormat.Reader._get_meta_dataa s- MUaZZ ll"8))++ +r Nr )__name__
__module__ __qualname__r6 r? rB rI rK r5 r r Readerr3 Q sk K K K K G G G
, , , , ,r rP c ( e Zd ZddZd Zd Zd ZdS )FreeimageFormat.Writerr c > || _ d | _ d| _ i | _ d S )NF)_flagsr: _is_set_metar= s r r? z FreeimageFormat.Writer._openi s" DKDH DLDJJJr c | j | j | j | j | j d S r )r:
set_meta_datarV save_to_filenamer+ r< rA r s r rB z FreeimageFormat.Writer._closeo sV H " "4: . . . H % %dl&E&E&G&G H H H HNN r c | j sd| _ nt d |j dk r |j d dk r|d d d d df }| j Nt j | j j | j j
| j | _ | j | | j
| || _ d S )NTz1Singleton image; can only append image data once. r! r r )rU RuntimeErrorndimshaper: r r8 r+ r' r9 r rT allocateset_image_datarV r immetas r _append_dataz#FreeimageFormat.Writer._append_datav s <
# "J w!|| 1 1111a[x +L)4;?DK !!"%%% H # #B ' ' ' DJJJr c || _ d S r )rV )r rc s r _set_meta_dataz%FreeimageFormat.Writer._set_meta_data s
DJJJr NrL )rM rN rO r? rB rd rf r5 r r WriterrR h sU . r rg )NN)rM rN rO __doc___modesr propertyr r, r1 r rP rg
__classcell__)r s @r r
r
% s ..
Fd X
, , , , , , , ,.& & & & & & & & & & & & r r
c 8 e Zd ZdZ G d dej ZdS )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 e Zd ZddZd ZdS )FreeimageBmpFormat.Writerr Fc t | }|r|t j z }n|t j z }t j | | S r )intr BMP_SAVE_RLE BMP_DEFAULTr
rg r? )r r> compressions r r? z FreeimageBmpFormat.Writer._open sJ JJE
...--")//e<< 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 ZddZdS )FreeimagePngFormat.Readerr Tc t | }|r|t j z }t j | | S r )rq r PNG_IGNOREGAMMAr
rP r? )r r> ignoregammas r r? z FreeimagePngFormat.Reader._open s; JJE
211")//e<< rt quantize
interlacedcompression_maps r r? z FreeimagePngFormat.Writer._open s 0,52 O JJE
100
K 55
K
K
K !IJJJ
K #)//e<< >??A
gllrx|q'8'8 !?@@@Q!c'' !DEEEX&&q!,, r N)r r r Fry r5 r r rg r s7 = = = =$ r rg NrM rN rO rh r
rP rg r5 r r r| r| sx <= = = = = ' = = =$ $ $ $ $ ' $ $ $ $ $ r r| c ^ e Zd ZdZ G d dej Z G d dej ZdS )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 " e Zd ZddZd Zd ZdS ) FreeimageJpegFormat.Readerr TFc t | }|r|dk r|t j z }|s|t j z }t j | | S )Nr )rq r JPEG_EXIFROTATE
JPEG_ACCURATEr
rP r? )r r>
exifrotate quickreads r r? z FreeimageJpegFormat.Reader._open4 sX JJE
2jAoo11
0//")//e<< s: &-77eDDHB b$''Bt8Or c \ | j j dd dk r |d d }|dv r |dv rt j |d }|dv rt j |d }|d
v rt j | }|d v rt j | }n# t $ r Y nw xY w|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.
r Nr EXIF_MAIN Orientation)r r )r[ ) r r[ )r" rv )r r r r" )r+ r r nprot90fliplrr )r rb rc oris r r z"FreeimageJpegFormat.Reader._rotateC s |"&&|T::a??+ {+M:C
f}} f}} Xb!__f}} Xb!__f}} Xb\\l** Yr]] D Is B
B)(B)N)r TF)rM rN rO r? rI r r5 r r rP r 3 sF = = = =
r rP c e Zd Z ddZd ZdS )FreeimageJpegFormat.Writerr K Fc $ t | }|dk s|dk rt d t | }||z }|r|t j z }|r|t j z }|r|t j z }t j | | S )Nr d z)JPEG quality should be between 1 and 100.) rq r/ r JPEG_PROGRESSIVE
JPEG_OPTIMIZE
JPEG_BASELINEr
rg r? )r r> quality progressiveoptimizebaselines r r? z FreeimageJpegFormat.Writer._open` s 'llG{{gmm !LMMMJJE W E
322
0//
0//")//e<< 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 e Zd ZddZdS )FreeimagePnmFormat.Writerr Tc t | }|r|t j z }t j | | S r )rq r PNM_SAVE_ASCIIr
rg r? )r r> use_asciis r r? z FreeimagePnmFormat.Writer._open s; JJE
100")//e<< r ss 0 ( ( ( ( ( ( ( ( ' ' ' ' ' ' B B B B B B B B B B B B
i i i i i f i i i d"G "G "G "G "G "G "G "GJN N N N N N N N bjG jG jG jG jG/ jG jG jGZ= = = = = = = = = =r