Ej59 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
Zy)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 | |||| || _ y )N)
extensionsmodes)super__init___fif)selfname descriptionr r r __class__s W/root/workspace/ytshorts/venv/lib/python3.12/site-packages/imageio/plugins/freeimage.pyr zFreeimageFormat.__init__* s
{zO c | j S N)r r s r r zFreeimageFormat.fif. s yyr c H t j rxt |d s1 t j |j d|j
|_ |j | j k( ry|j dk( r| j dk( ryy y y # t $ r
d|_ Y Nw xY w)Nr rT ) r has_libhasattrgetFIFfilename
firstbytesr Exceptionr r requests r _can_readzFreeimageFormat._can_read2 s
::<7F+&#%99W-=-=sGDVDV#WGL ||txx' "txx2~ (6" ! &#%GL&s 0B B! B!c : t j rLt |d s& t j |j d |_ |j
| j u ryy y # t $ r/ |j t k( r| j |_ nd|_ Y Rw xY w)Nr wr! T)
r r$ r% r& r' r
ValueErrorraw_urir r r* s r
_can_writezFreeimageFormat._can_writeA s
::<7F+*#%99W-=-=s#CGL ||txx' ( " * ,6'+xx ') *s %A" "5BBc , e Zd Zd ZddZd Zd Zd Zy)FreeimageFormat.Readerc y)Nr r s r _get_lengthz"FreeimageFormat.Reader._get_lengthR s r c t j | j j | j j
| | _ | j j | j j y r ) r
create_bitmapr+ r' formatr _bmload_from_filenameget_local_filenamer flagss r _openz FreeimageFormat.Reader._openU sJ '' (=(=t{{PUVDH HH ' ' (G(G(I Jr c 8 | j j y r )r: closer s r _closez FreeimageFormat.Reader._closeY s HHNN r c |dk7 r t d | j j | 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\ s: z !NOO88**,dhh.D.D.FF Fr c X ||dk( s
t | j j S )Nr )rD r: rF rG s r _get_meta_dataz%FreeimageFormat.Reader._get_meta_dataa s( MUaZ l"88))+ +r Nr )__name__
__module__ __qualname__r6 r? rB rI rK r5 r r Readerr3 Q s K G
,r rP c & e Zd ZddZd Zd Zd Zy)FreeimageFormat.Writerc < || _ d | _ d| _ i | _ y )NF)_flagsr: _is_set_metar= s r r? z FreeimageFormat.Writer._openi s DKDH DLDJr c | j j | j | j j | j j | j j
y r )r:
set_meta_datarV save_to_filenamer+ r< rA r s r rB z FreeimageFormat.Writer._closeo sE HH " "4:: . HH % %dll&E&E&G H HHNN r c | j sd| _ n t d |j dk( r |j d dk( r |d d d d df }| j it j | j j | j j | j | _ | j j | | j j | || _ y )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 ww!| 11a[xx ++LL))4;;??DKK !!"% HH # #B ' DJr c || _ y r )rV )r rc s r _set_meta_dataz%FreeimageFormat.Writer._set_meta_data s DJr NrL )rM rN rO r? rB rd rf r5 r r WriterrR h s . r rg )NN)rM rN rO __doc___modesr propertyr r, r1 r rP rg
__classcell__)r s @r r
r
% sZ .
Fd
, ,.& & & r r
c : e Zd ZdZ G d dej
Zy)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 Zy)FreeimageBmpFormat.Writerc t | }|r|t j z }n|t j z }t j
j
| | S r )intr BMP_SAVE_RLE BMP_DEFAULTr
rg r? )r r> compressions r r? z FreeimageBmpFormat.Writer._open sG JE...---"))//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 ZddZy)FreeimagePngFormat.Readerc t | }|r|t j z }t j j | | S r )rq r PNG_IGNOREGAMMAr
rP r? )r r> ignoregammas r r? z FreeimagePngFormat.Reader._open s7 JE111"))//e< rt quantize
interlacedcompression_maps r r? z FreeimagePngFormat.Writer._open s 00,,5522 O JE000
K 55 #))//e< <
K !IJJ
Ks !B B c t |j dk( rt |d }n
t |d }t j j | || t
| j j j dd }|sy |j dk( r|j d dk( s t d |d
k s|d kD r t d | j j d
| }| j j || _
y )Nuint16 rw rv r Fr[ r! z Can only quantize RGB imagesr z!PNG quantize param must be 2..256r )strdtyper r
rg rd rq r+ kwargsgetr] r^ r/ r: r rA )r rb rc qbms r rd z&FreeimagePngFormat.Writer._append_data s 288}("23"22 " " / /b$ ?DLL''++J>?Agglrxx|q'8 !?@@Q!c' !DEEXX&&q!, r N)r r r Fry r5 r r rg r s =$ r rg NrM rN rO rh r
rP rg r5 r r r| r| s+ <= '' =$ '' $ r r| c d e Zd ZdZ G d dej
Z G d dej Zy)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 Zy)FreeimageJpegFormat.Readerc t | }|r|dk7 r|t j z }|s|t j z }t j
j
| | S )Nr )rq r JPEG_EXIFROTATE
JPEG_ACCURATEr
rP r? )r r>
exifrotate quickreads r r? z FreeimageJpegFormat.Reader._open4 sP JEjAo111 ///"))//e< s7 &--77eDHB b$'Bt8Or c d | j j j dd dk( rv |d d }|dv r |dv rt j |d }|dv rt j |d }|d
v rt j | }|d v rt j
| }|S |S # t $ r Y |S w xY w) 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} XXb!_f} XXb!_f} XXb\l* YYr]I2I I s B" " B/.B/N)r TF)rM rN rO r? rI r r5 r r rP r 3 s =
r rP c e Zd Z ddZd Zy)FreeimageJpegFormat.Writerc t | }|dk s|dkD r t d t | }||z }|r|t j z }|r|t j z }|r|t j
z }t j 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 'lG{gm !LMMJE W E222//////"))//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 ZddZy)FreeimagePnmFormat.Writerc t | }|r|t j z }t j j | | S r )rq r PNM_SAVE_ASCIIr
rg r? )r r> use_asciis r r? z FreeimagePnmFormat.Writer._open s7 JE000"))//e< r se 0 ( ' B B
i f i d"G "GJN N bjG/ jGZ= =r