9i59 S r SSKrSSKJrJr SSKJr SSKJ r J
r
J r J r " S S \5 r
" S
S \
5 r " S S
\
5 r " S S\
5 r " S S\
5 rg)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 ^ \ rS rSrSrSrSSS.U 4S jjjr\S 5 rS r S r
" S
S \ R 5 r " S S
\ R 5 r
SrU =r$ )FreeimageFormat% z$See :mod:`imageio.plugins.freeimage`iN)fifc . > [ TU ] XX4S9 XPl g )N)
extensionsmodes)super__init___fif)selfname descriptionr r r __class__s Y/var/www/html/land-doc-ocr/venv/lib/python3.13/site-packages/imageio/plugins/freeimage.pyr FreeimageFormat.__init__* s
zO c U R $ Nr r s r r FreeimageFormat.fif. s yyr c h [ R " 5 ( a [ US5 ( d2 [ R " UR SUR
5 Ul UR U R :X a gUR S:X a U R S:X a gg g g ! [ a
SUl NRf = f)Nr rT ) r has_libhasattrgetFIFfilename
firstbytesr Exceptionr r requests r _can_readFreeimageFormat._can_read2 s
::<<7F++&#%99W-=-=sGDVDV#WGL ||txx' "txx2~ (6" ! &#%GL&s 1B B10B1c Z [ R " 5 ( aS [ US5 ( d' [ R " UR S5 Ul UR
U R L a gg g ! [ a1 UR [ :X a U R Ul NMSUl NVf = f)Nr wr% T)
r r( r) r* r+ r
ValueErrorraw_urir r r. s r
_can_writeFreeimageFormat._can_writeA s
::<<7F++*#%99W-=-=s#CGL ||txx' ( " * ,6'+xx ') *s &A/ //B* B*)B*c 6 \ rS rSrS rS S jrS rS rS rSr g)
FreeimageFormat.ReaderQ c g)Nr r! s r _get_length"FreeimageFormat.Reader._get_lengthR s r c [ R " U R R U R R
U5 U l U R R U R R 5 5 g r ) r
create_bitmapr/ r+ formatr _bmload_from_filenameget_local_filenamer flagss r _open FreeimageFormat.Reader._openU sJ '' (=(=t{{PUVDH HH ' ' (G(G(I Jr c 8 U R R 5 g r )rB closer! s r _close FreeimageFormat.Reader._closeY s HHNN r c US:w a [ S5 eU R R 5 U R R 5 4$ )Nr z+This format only supports singleton images.)
IndexErrorrB get_image_data
get_meta_datar indexs r _get_data FreeimageFormat.Reader._get_data\ s: z !NOO88**,dhh.D.D.FF Fr c \ Ub US:X d
[ 5 eU R R 5 $ )Nr )rN rB rP rQ s r _get_meta_data%FreeimageFormat.Reader._get_meta_dataa s( MUaZ l"88))+ +r rB Nr )
__name__
__module__ __qualname____firstlineno__r= rG rK rS rV __static_attributes__r< r r Readerr9 Q s K G
,r r_ c 0 \ rS rSrSS jrS rS rS rSrg) FreeimageFormat.Writerh c : Xl S U l SU l 0 U l g )NF)_flagsrB _is_set_metarE s r rG FreeimageFormat.Writer._openi s KDH DLDJr c U R R U R 5 U R R U R R 5 5 U R R
5 g r )rB
set_meta_datarf save_to_filenamer/ rD rJ r! s r rK FreeimageFormat.Writer._closeo sE HH " "4:: . HH % %dll&E&E&G H HHNN r c U R ( d SU l O [ S5 eUR S:X a UR S S:X a US S 2S S 2S4 nU R cj [
R " U R R U R R U R 5 U l U R R U5 U R R U5 X l g )NTz1Singleton image; can only append image data once. r% r r )re RuntimeErrorndimshaperB r r@ r/ r+ rA r rd allocateset_image_datarf r immetas r _append_data#FreeimageFormat.Writer._append_datav s << # "J ww!| 11a[xx ++LL))4;;??DKK !!"% HH # #B ' Jr c Xl g r )rf )r ru s r _set_meta_data%FreeimageFormat.Writer._set_meta_data s Jr )rB rd re rf NrY ) rZ r[ r\ r] rG rK rv ry r^ r< r r Writerra h s . r r{ r )NN)rZ r[ r\ r] __doc___modesr propertyr r0 r6 r r_ r{ r^
__classcell__)r s @r r
r
% s_ .
Fd
, ,.& & & r r
c B \ rS rSrSr " S S\R 5 rSrg)FreeimageBmpFormat az 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 $ \ rS rSrSS jrS rSrg)FreeimageBmpFormat.Writer c [ U5 nU( a U[ R - nOU[ R - n[ R
R
X5 $ r )intr BMP_SAVE_RLE BMP_DEFAULTr
r{ rG )r rF compressions r rG FreeimageBmpFormat.Writer._open sE JE...---"))//< 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 \ rS rSrSS jrSrg)FreeimagePngFormat.Reader c [ U5 nU( a U[ R - n[ R R X5 $ r )r r PNG_IGNOREGAMMAr
r_ rG )r rF ignoregammas r rG FreeimagePngFormat.Reader._open s5 JE111"))//< ?Agglrxx|q'8 !?@@Q!c' !DEEXX&&q!, r rX N)r r r Fr r< r r r{ r s =$ r r{ r< N rZ r[ r\ r] r| r
r_ r{ r^ r< r r r r s+ <= '' =$ '' $ r r c l \ rS rSrSr " S S\R 5 r " S S\R 5 rSrg) FreeimageJpegFormati
a 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 * \ rS rSrSS jrS rS rSrg)FreeimageJpegFormat.Readeri3 c [ U5 nU( a US:w a U[ R - nU( d U[ R - n[ R
R
X5 $ )Nr )r r JPEG_EXIFROTATE
JPEG_ACCURATEr
r_ rG )r rF
exifrotate quickreads r rG FreeimageJpegFormat.Reader._open4 sN JEjAo111 ///"))//< s/ &--77DHB b'B8Or c U R R R SS5 S:X a US S nUS; a US; a [ R " US5 nUS; a [ R " US 5 nUS
; a [ R " U5 nUS ; a [ R
" U5 nU$ U$ ! [ a U$ f = f) a 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 )rm ) r rm )r& r )r r r r& )r/ r r nprot90fliplrr )r rt ru oris r r "FreeimageJpegFormat.Reader._rotateC s ||""&&|T:a?+ {+M:C
f} f} XXb!_f} XXb!_f} XXb\l* YYr]I2I I s B1 1
B?>B?r< N)r TF)rZ r[ r\ r] rG rS r r^ r< r r r_ r 3 s =
r r_ c & \ rS rSr SS jrS rSrg)FreeimageJpegFormat.Writeri_ c > [ U5 nUS: d US: a [ S5 e[ U5 nX- nU( a U[ R - nU( a U[ R - nU( a U[ R
- n[ R R X5 $ )Nr d z)JPEG quality should be between 1 and 100.) r r4 r JPEG_PROGRESSIVE
JPEG_OPTIMIZE
JPEG_BASELINEr
r{ rG )r rF quality progressiveoptimizebaselines r rG FreeimageJpegFormat.Writer._open` s 'lG{gm !LMMJE E222//////"))//< 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 \ rS rSrSS jrSrg)FreeimagePnmFormat.Writeri c [ U5 nU( a U[ R - n[ R R X5 $ r )r r PNM_SAVE_ASCIIr
r{ rG )r rF use_asciis r rG FreeimagePnmFormat.Writer._open s5 JE000"))//< r se 0 ( ' B B
i f i d"G "GJN N bjG/ jGZ= =r