+
?im- R t ^ RIt^ RIHt ^ RIHtHtHtHtH t ^ RI
t
^ RI t ^RI
Ht ^RIHtHtHt ^RIHtHt ^RIHt ! R R ]4 tR# )
ag Read/Write images using OpenCV.
Backend Library: `OpenCV `_
This plugin wraps OpenCV (also known as ``cv2``), a popular image processing
library. Currently, it exposes OpenCVs image reading capability (no video or GIF
support yet); however, this may be added in future releases.
Methods
-------
.. note::
Check the respective function for a list of supported kwargs and their
documentation.
.. autosummary::
:toctree:
OpenCVPlugin.read
OpenCVPlugin.iter
OpenCVPlugin.write
OpenCVPlugin.properties
OpenCVPlugin.metadata
Pixel Formats (Colorspaces)
---------------------------
OpenCV is known to process images in BGR; however, most of the python ecosystem
(in particular matplotlib and other pydata libraries) use the RGB. As such,
images are converted to RGB, RGBA, or grayscale (where applicable) by default.
N)Path)AnyDictListOptionalUnionRequest) URI_BYTESInitializationErrorIOMode)ImagePropertiesPluginV3) ArrayLikec a a ] tR t^.t oV3R lV 3R lltRRRRR]P /V3R lR lltR]P 3V3R lR
lltRV3R lR llt RR]P 3V3R
lR llt
RV3R lR llt Rt Vt
V ;t# ) OpenCVPluginc $ < V ^8 d QhRS[ RR/# ) requestreturnNr )format
__classdict__s "T/var/www/html/photoedit/myenv/lib/python3.14/site-packages/imageio/plugins/opencv.py __annotate__OpenCVPlugin.__annotate__/ s
S
S
SD
S c * < \ SV ` V4 VP 4 V n VP \
J d R V n MVP V n VP P pV\ P 8X d@ \ P ! V P 4 ' g \ RV P R24 hV\ P 8X dB \ P ! V P 4 ' g \ RV P R24 hR# R# )zzOpenCV can't read ``.zOpenCV can't write to `N)super__init__get_local_filename file_handle _uri_typer
filenameraw_urimodeio_moder readcv2haveImageReaderr writehaveImageWriter)selfr r% __class__s && r r OpenCVPlugin.__init__/ s
!"557 ) %DM #OODM||## 6;; s':':4;K;K'L'L%(;DMM?"&MN N
V\\
!#*=*=d>N>N*O*O%(?
b&QR R +P
!r indexN
colorspaceflagsc \ < V ^8 d QhRS[ RS[S[ S[3, RS[ RS[P /# r r/ r0 r1 r )intr strnpndarray)r r s "r r r > sG K+ K+ K+ #s(O K+
K+
K+r c Vf- \ P ! V P V4 pV^8X d ^ MRpVRJ d( \ P ! V P VR7 w rVRpM(\ P ! V P V^VR7 w rVRpVRJ d \ RV RV P
R24 hV^ , P ^8X d R pT;' g R p M`_
and use it for conversion. If str, convert the image into the given
colorspace. Possible string values are: ``"RGB"``, ``"BGR"``,
``"RGBA"``, ``"BGRA"``, ``"GRAY"``, ``"HSV"``, or ``"LAB"``.
flags : int
The OpenCV flag(s) to pass to the reader. Refer to the `OpenCV docs
`_
for details.
Returns
-------
ndimage : np.ndarray
The decoded image as a numpy array.
N.)r1 TFzCould not read index `z` from `r GRAYBGRARGBABGRRGBCOLOR_2)r( imcountr! imreadmulti
ValueErrorr# ndimshape
isinstancer4 uppergetattrr6 stackcvtColor) r, r/ r0 r1 n_imagesretvalimgis_batch
in_colorspaceout_colorspace cvt_spacexs &$$$ r r' OpenCVPlugin.read> s L ={{4#3#3U;H!Q ACE C< //$*:*:%HKFH //$*:*:E1ERKF H U? 5eWHT]]OSU VW W q6;;! "M ' 1 16N
V\\"
" "M ' 1 16N !M ' 0 05N j# & &"I
2 2 4
4 I + 1 1 3N vm_An=M%NOI ((D1CLL 6DEC((3-C s*CF* Es 9 G c V < V ^8 d QhRS[ S[S[3, RS[RS[P /# )r r0 r1 r )r r4 r5 r6 r7 )r r s "r r r s: K K#s(O K K
Kr c # " \ \ P ! V P 4 4 F pV P W2VR7 x K R# 5i)a Yield images from the ImageResource.
Parameters
----------
colorspace : str, int
The colorspace to convert into after loading and before returning
the image. If None (default) keep grayscale images as is, convert
images with an alpha channel to ``RGBA`` and all other images to
``RGB``. If int, interpret ``colorspace`` as one of OpenCVs
`conversion flags
`_
and use it for conversion. If str, convert the image into the given
colorspace. Possible string values are: ``"RGB"``, ``"BGR"``,
``"RGBA"``, ``"BGRA"``, ``"GRAY"``, ``"HSV"``, or ``"LAB"``.
flags : int
The OpenCV flag(s) to pass to the reader. Refer to the `OpenCV docs
`_
for details.
Yields
------
ndimage : np.ndarray
The decoded image as a numpy array.
r/ r1 r0 N)ranger( rA r! r' )r, r0 r1 idxs &&& r iterOpenCVPlugin.iter s8 < T%5%567C))#z)J J 8s AA
c x < V ^8 d QhRS[ S[S[S[, 3, RS[RS[S[, RS[S[, /# )r ndimagerN paramsr )r r r boolr4 r bytes)r r s "r r r sI 87 87y$y/1287 87 S 87
% 87r c \ V\ 4 ' d \ P ! V^ R7 pMV' g
VR, pV^ , P ^8X d ^pMV^ , P
R, pV^8X d V Uu. uF qUNK ppMpV^8X d6 V Uu. uF( p\ P ! V\ P 4 NK* ppM4V Uu. uF( p\ P ! V\ P 4 NK* pp\ P ! V P Wc4 pVRJ d \ R4 hV P P \ 8X d$ \! V P 4 P# 4 # R# u upi u upi u upi )a Save an ndimage in the ImageResource.
Parameters
----------
ndimage : ArrayLike, List[ArrayLike]
The image data that will be written to the file. It is either a
single image, a batch of images, or a list of images.
is_batch : bool
If True, the provided ndimage is a batch of images. If False (default), the
provided ndimage is a single image. If the provided ndimage is a list of images,
this parameter has no effect.
params : List[int]
A list of parameters that will be passed to OpenCVs imwrite or
imwritemulti functions. Possible values are documented in the
`OpenCV documentation
`_.
Returns
-------
encoded_image : bytes, None
If the ImageResource is ``""`` the call to write returns the
encoded image as a bytes string. Otherwise it returns None.
)axisNFzOpenCV failed to write.)N.r@ )rF listr6 rI rD rE r( rJ COLOR_RGBA2BGRA
COLOR_RGB2BGR imwritemultir! IOErrorr r" r
r
read_bytes)r, r\ rN r]
n_channelsrR ndimage_cv2rL s &&&& r r* OpenCVPlugin.write s0 > gt $ $hhwQ/G i(G 1:??a J ))"-J ?&-.g1gK.K
1_IPQA3<<3+>+>?KQKGNOw!3<<3+<+<=wKO!!$"2"2KH U? 34 4 << ! !Y .(()446 6 / /QOs
E4.E9.E>c H < V ^8 d QhRS[ RS[S[ S[3, RS[ RS[/# r3 )r4 r r5 r
)r r s "r r r sA >Q >Q>Q #s(O>Q >Q
>Qr c Vf( \ P ! V P V4 pV^8 pM0V\ J d% \ P ! V P V4 pRpMRpV' d; V P ^ W2R7 p\ X.VP O5VP VRR7 # V P WVR7 p\ VP VP RR7 # )af Standardized image metadata.
Parameters
----------
index : int, Ellipsis
If int, get the properties of the index-th image in the
ImageResource. If ``...``, get the properties of the image stack
that contains all images. If None (default), use ``index=0`` if the
image contains exactly one image and ``index=...`` otherwise.
colorspace : str, int
The colorspace to convert into after loading and before returning
the image. If None (default) keep grayscale images as is, convert
images with an alpha channel to ``RGBA`` and all other images to
``RGB``. If int, interpret ``colorspace`` as one of OpenCVs
`conversion flags
`_
and use it for conversion. If str, convert the image into the given
colorspace. Possible string values are: ``"RGB"``, ``"BGR"``,
``"RGBA"``, ``"BGRA"``, ``"GRAY"``, ``"HSV"``, or ``"LAB"``.
flags : int
The OpenCV flag(s) to pass to the reader. Refer to the `OpenCV docs
`_
for details.
Returns
-------
props : ImageProperties
A dataclass filled with standardized image metadata.
Notes
-----
Reading properties with OpenCV involves decoding pixel data, because
OpenCV doesn't provide a direct way to access metadata.
TFrV )rE dtyperK rN )rE rm rN )r( rA r! Ellipsisr' r
rE rm )r, r/ r0 r1 rK rN rM s &&&& r
propertiesOpenCVPlugin.properties s T ={{4#3#3U;H !|H
h
{{4#3#3U;HH H ))!5)HC" ,#)),ii!
iieZiH SYYcii%PPr c B < V ^8 d QhRS[ RS[RS[S[S[3, /# )r r/ exclude_appliedr )r4 r^ r r5 r )r r s "r r r & s- 26
c3h r c L \ P ! R\ 4 \ 4 # )a Format-specific metadata.
.. warning::
OpenCV does not support reading metadata. When called, this function
will raise a ``NotImplementedError``.
Parameters
----------
index : int
This parameter has no effect.
exclude_applied : bool
This parameter has no effect.
z)OpenCV does not support reading metadata.)warningswarn UserWarningdict)r, r/ rr s &&&r metadataOpenCVPlugin.metadata& s $
A;Ov
r )r! r# )FN)NT)__name__
__module__ __qualname____firstlineno__r r( IMREAD_COLORr' rY r* ro rx __static_attributes____classdictcell__
__classcell__)r- r s @@r r r . s
S
S K+ K+ '+ K+
%% K+ K+^ '+%% K KB87 87x &*%% >Q >Q@ r r )__doc__rt pathlibr typingr r r r r r( numpyr6 corer core.requestr
r r core.v3_plugin_apir
r r r r r r s< @ 3 3
A A : K8 Kr