+
]i\$ c s R t ^ RIt^ RIHt ^ RIHtHt ^ RIt^ RIH t ^ RI
H t ^ RI H
t
Ht ^ RIHt ^ RIt ! R R ] P$ ] P& 4 t ! R
R ]
4 tR tR
tR tR tR tR tR t R t R# )a
Add a ``figure-mpl`` directive that is a responsive version of ``figure``.
This implementation is very similar to ``.. figure::``, except it also allows a
``srcset=`` argument to be passed to the image tag, hence allowing responsive
resolution images.
There is no particular reason this could not be used standalone, but is meant
to be used with :doc:`/api/sphinxext_plot_directive_api`.
Note that the directory organization is a bit different than ``.. figure::``.
See the *FigureMpl* documentation below.
N)relpath)PurePathPath)nodes)
directives)FigureImage)ExtensionErrorc s ] tR t^ tRtR# )
figmplnode N)__name__
__module__ __qualname____firstlineno____static_attributes__r L/usr/lib64/python3.14/site-packages/matplotlib/sphinxext/figmpl_directive.pyr r s r r c s a ] tR t^ t o RtRt^t^tRtR] P R] P R] P R] P R]P R] P R ] P R
] P /tR tR tV tR
# ) FigureMpla&
Implements a directive to allow an optional hidpi image.
Meant to be used with the *plot_srcset* configuration option in conf.py,
and gets set in the TEMPLATE of plot_directive.py
e.g.::
.. figure-mpl:: plot_directive/some_plots-1.png
:alt: bar
:srcset: plot_directive/some_plots-1.png,
plot_directive/some_plots-1.2x.png 2.00x
:class: plot-directive
The resulting html (at ``some_plots.html``) is::
Note that the handling of subdirectories is different than that used by the sphinx
figure directive::
.. figure-mpl:: plot_directive/nestedpage/index-1.png
:alt: bar
:srcset: plot_directive/nestedpage/index-1.png
plot_directive/nestedpage/index-1.2x.png 2.00x
:class: plot_directive
The resulting html (at ``nestedpage/index.html``)::
where the subdirectory is included in the image name for uniqueness.
Faltheightwidthscalealignclasscaptionsrcsetc s: \ 4 pV P ^ , pV P P RR4 VR& V P P RR4 VR& V P P RR4 VR& V P P RR4 VR& V P P RR4 VR& V P P RR4 VR& V P P R R4 VR & W!R
& V P P R R4 VR & V.# ) i r r Nr r r r r urir )r Z argumentsZoptionsZget)selfZ
image_nodeZimagenms & r runZ
FigureMpl.runZ s \
..# LL , ,UB 7
5 "ll . .w =
7 "ll . .w =
7 "ll . .w =
7 #|| / /$ ?
8 "ll . .w =
7 $ 0 0D A
9 $5 #|| / /$ ?
8 |r r N)r
r r r
__doc__Z has_contentZrequired_argumentsZoptional_argumentsZfinal_argument_whitespacer Z unchangedZlength_or_unitlessZ length_or_percentage_or_unitlessZnonnegative_intr r Z class_optionZ option_specr r Z__classdictcell__)Z
__classdict__s @r r r s (T K %
z##*//<<++((:''*&& K r r c s8 V P R4 p/ pV F pVP 4 P R4 p\ V4 ^8X d V^ , V^ & K@ \ V4 ^8X d$ V^, RR pV^ , V\ V4 & Ks \ RV R24 h V# )z
parse srcset...
Z, Nzsrcset argument "z
" is invalid.)ZsplitZstriplenZfloatr )ZstZentriesr ZentryZsplmults & r _parse_srcsetNodesr# q s hhsmG
Fkkm!!#& s8q=AF1I
X]q6#2;D"%a&F5; #4UG=!IJ J Mr c sF VR , ' d \ VR , 4 pMRp\ V P R, 4 P pV P P
p\
W44 P RR4 P \ P R4 p\ V4 ' d
VR,
p\ V P P V P P 4 p\ V4 P RRR7 V' dS VP 4 F= p\ W74 pWXP , p \" P$ ! WV , 4 K? MA\ W1R, 4 pWXP , p \" P$ ! WV , 4 WbV3# ) r NsourceZ.r Z-T)ZparentsZexist_okr )r# r documentparentbuildersrcdirr ZreplaceosZsepr! outdirimagedirr ZmkdirZvaluesnameshutilZcopyfile)
r noder docsourcesrctoprelr+ srcZabspathr, s
&& r _copy_images_figmplr3 s3 H~~#DN3 x0188I \\
F
)
$
,
,S"
5
=
=bffc
JC
3xx s
++T\\-B-BCH N5 ==?C y.G %D OOG_ 5 # 95k2\\!D 1 S r c s \ W4 w r#p\ V P R , 4 p\ V P P R4 p\ WV4 p\ V P P R4 pW, p \ \ W)P 4 4 P 4 p
V P P R8X d RV
2p
\ VR, R, 4 P p V
RV V 2p RV RVR, /p
T pV' d R$pRpVP 4 F` w pp\ VR, 4 P p V
RV V 2pVV,
pV^ 8X d VR ,
pMVR
VR
R 2,
pVV8 g K\ TpTpKb VR
R% V
R& VR, e R
P VR, 4 V
R& R& FQ pVV, ' g K RV
9 d V RVV, R2V
R& K/ V
R;;, V RVV, R2,
uu& KS V P P T P TRVR, ' d
RVR, 2MRR7 4 V P P V P VRRVR7 V P ! VR3/ V
B , R , 4 VR , ' d V P P V P VR 4 4 V P P V P VR 4 4 V P P V P VR R!R7 4 V P P VR , 4 V P P R"4 V P P R#4 R
# )'r$ r Zdirhtmlz..r :i NNZ/r2 r z, r z1.2fzx, Nr r stylez: Z;Zfigurer zalign-z align-center)CLASSZaz"reference internal image-reference)r5 ZhrefZimgz
r Z
figcaptionZpZspanz caption-textz
z
r i)r r r )r3 r r% r' r( r r* r& Zas_posixr, ZitemsZjoinZbodyZappendZstarttagZemptytag)r r. r+ r r1 r/ r0 Z relsourceZdesttopZdestZimagerelZnmr Z img_attrsZmaxsrcmaxmultZsrcsetstr" r2 Zpathr4 s && r visit_figmpl_htmlr7 s2 / ;Hc x01I dll))2
.F *It||**B/G D ++67@@BH ||I%z?
$u+b/ " ' 'B
JauRD
!CUDK0I F
ID##b'"''B ZqbT*D HqyD aT{# ..g~ ( 'sm ( G} XXd7m 4 '- ;;i'(-wbe
Q%? '"'"r$u+ a&@@" ." II
(.27mmF4=/* QR II
dC'K! #
dE/Y/ 0
I t\:; tS12 tV> JK i ) 56II]#r c s VR , e; \ W4 w r#Rp\ VRR7 p\ W4, 4 P VR& V P V4 R# )r N)Zdefaultr r )r3 Zmaxr r, Z visit_figure)r r. r+ r r6 s && r visit_figmpl_latexr8 sN H~!.t:fb) v/44U dr c s R # Nr r r. &&r depart_figmpl_htmlr< s r c s( V P V4 R # r9 )Z
depart_figurer: r; r depart_figmpl_latexr= s t r c s^ V P \ \ \ 3\ \
3R 7 R# ))ZhtmlZlatexN)Zadd_noder r7 r< r8 r= )apps &r figurempl_addnoder? s( LL(*<=*,?@ Br c st V P R \ 4 \ V 4 RRRRR\ P /pV# )z
figure-mplZparallel_read_safeTZparallel_write_safeZversion)Z
add_directiver r?
matplotlibZ __version__)r> Zmetadatas & r setuprA s; lI.c$d,A4:113H Or ) r r) Zos.pathr Zpathlibr r r- Zdocutilsr Zdocutils.parsers.rstr Z&docutils.parsers.rst.directives.imagesr r Z
sphinx.errorsr r@ ZGeneralZElementr r r# r3 r7 r8 r< r= r? rA r r r rB sx
"
+ @ (
N N b$$!NR$j B r