j:UddlmZddhZddlZddlZddlmZddlmZm Z m Z m Z dZ e r$dd l mZmZdd lmZdd lmZmZdd lmZdd lmZmZejjZded< GddZd0d1dZd0d2dZ d3d4d%Zd5d,Z d6d/Z!dS)7) annotationsmathstructN)cast)Image ImageColor ImageFont ImageTextF)CallableSequence) ModuleType)AnyAnyStr ImageDraw2)Coords_Inkz!Callable[[], Image.core._Outline]OutlineceZdZUdZded<dYdZd Zd[d Zd\dZ dYd]dZ d^d_dZ dYd`d Z dadbd"Z dadcd#Z daddd&Z ded(Z dfdgd*Z dhdid-Z dadbd.ZdYdjd/Z dadcd0Z dkdld6Z dadcd7Z dkdd8dmd;Z dndodQZ dnddRdpdTZ dqddRdrdUZ dsddRdtdWZ dsddRdtdXZdS)u ImageDrawNImageFont.BaseImageFont | Nonefontim Image.Imagemode str | NonereturnNonec|d}||j}||jkr%|dkr|jdkrd}nd}t||dkr |j|_nd|_||_|j|_t j|j||_||_|dvr |j d|_ n|j d |_ |d vrd |_ nd |_ d |_ dS)a Create a drawing instance. :param im: The image to draw in. :param mode: Optional mode to use for color values. For RGB images, this argument can be RGB or RGBA (to blend the drawing into the image). For all other modes, this argument must be the same as the image mode. If omitted, the mode defaults to the mode of the image. rNRGBARGBrz mode mismatchP)IF)1r#r$r%r'LF) _ensure_mutabler ValueErrorpalette_imagerrcoredrawdraw_inkinkfontmodefill)selfrrblendmsgs YC:\Users\johnn\AppData\Local\Programs\Python\Python311\Lib\site-packages\PIL/ImageDraw.py__init__zImageDraw.__init__As   <7D 27??v~~"'U"2"2% oo% 3;;:DLLDL %JOODGU33  :  y))!,,DHHy))"--DH ' ' 'DMMDM ImageFont.BaseImageFontcN|jstj|_|jS)a= Get the current default font. To set the default font for this ImageDraw instance:: from PIL import ImageDraw, ImageFont draw.font = ImageFont.truetype("Tests/fonts/FreeMono.ttf") To set the default font for all future ImageDraw instances:: from PIL import ImageDraw, ImageFont ImageDraw.ImageDraw.font = ImageFont.truetype("Tests/fonts/FreeMono.ttf") If the current default font is ``None``, it is initialized with ``ImageFont.load_default()``. :returns: An image font.)rr load_default)r3s r6getfontzImageDraw.getfontis&(y 1!.00DIyr8 font_size float | NonecV|tj|S|SN)r r;r<)r3r=s r6_getfontzImageDraw._getfonts'  ))44 4<<>> !r8r0 _Ink | Noner2tuple[int | None, int | None]chd}d}|||jr |j}n|j}n|t|trt j||j}|jr5t|tr |j||j }|j |}|t|trt j||j}|jr5t|tr |j||j }|j |}||fSr@) r2r0 isinstancestrr getcolorrr+tupler,r.r/)r3r0r2 result_ink result_fills r6_getinkzImageDraw._getinks,  ;4<y &"h !X c3''>$-c49==C<BJsE$:$:B,//T[AAC!Y//44 dC((@%.tTY??D<DJtU$;$;D<00t{CCD"i0066 ;&&r8rxyrstartfloatendwidthintc||\}}|&|dkr"|j|||||dSdSdS)z Draw an arc.Nr)rKr.draw_arc)r3rLrMrOr2rPr0s r6arcz ImageDraw.arcsULL&& T ?uzz I  r5#sE : : : : : ?zzr8 Sequence[int]bitmapc|||\}}||}|#|j||j|dSdS)zDraw a bitmap.N)loadrKr. draw_bitmapr)r3rLrVr2r0s r6rVzImageDraw.bitmaps^  LL&& T ;C ? I ! !"fi 5 5 5 5 5 ?r8outlinec|||\}}||j||||d|-||kr)|dkr%|j||||d|dSdSdSdS)z Draw a chord.Nrr)rKr. draw_chord r3rLrMrOr2rZrPr0fill_inks r6chordzImageDraw.chords Wd33 X   I UC1 = = = ?sh5A:: I UCa ? ? ? ? ? ?::r8c|||\}}||j||d|+||kr'|dkr#|j||d|dSdSdSdS)zDraw an ellipse.Nrr)rKr. draw_ellipser3rLr2rZrPr0r^s r6ellipsezImageDraw.ellipses Wd33 X   I " "2x 3 3 3 ?sh5A:: I " "2sAu 5 5 5 5 5 ?::r8Sequence[float]radiusc|d|z |d|z |d|z|d|zf}|||||dS)z4Draw a circle given center coordinates and a radius.rrN)rc)r3rLrer2rZrP ellipse_xys r6circlezImageDraw.circlesPefnbefnbefnbefnU  Zw66666r8Sequence[Sequence[float]]ctdttfrtdSfdt dt dDS)z=Normalize 1 or 2 dimensional coord sequence into 2d sequence.rric `g|]*}tdt||dz+S)rd)rrH).0irLs r6 z/ImageDraw._normalize_coords..sH&bQUm(<(<==r8rl)rElistrHrrangelen)r3rLs `r6_normalize_coordszImageDraw._normalize_coordssk bedE] + + 3R88 8q#b''1-- r8jointc`||d}|dkr|j|||dkrdkr||}t dt |dz D]}||}d||dz |f|||dzffD} | d| dkrBdfd } | d| dko| ddz | dkp&| d| dko| ddz| dk} |ddz z dz|ddz z dzf|ddz zdz |ddz zdz fg} | r| ddz| ddz}} n| ddz | ddz }} || | dz |dz |dkrq| r,| || ddz|| || ddzg}n+| || ddz || || ddz g}|||ddSdSdSdSdS)z6Draw a line, or a connected sequence of line segments.rNcurverc g|]M\}}tjtj|d|dz |d|dz dzNS)rrh)rdegreesatan2)rmrMrOs r6roz"ImageDraw.line..sg'E3 TZAq0A58cRSfCT%U%UVVr8coordrdanglerNrtuple[float, ...]c |\}}|dz}dz dz }td||tjtj|zf||tjtj|zffDS)NZrlrc3~K|]8\}}||dkrtj|ntj|zV9dS)rN)rfloorceil)rmpp_ds r6 z9ImageDraw.line..coord_at_angle..s[%% &3C!GGC3P%%%%%%r8)rHrcosradianssin)r|r}xydistancerPs r6coord_at_anglez&ImageDraw.line..coord_at_angles %1 #(19q=$%%"#Htx U8K8K/L/L$L M!"Htx U8K8K/L/L$L M+%%%  r8rlr)rP)r|rdr}rNrr~)rKr. draw_linesrsrqrrpiesliceline)r3rLr2rPrtr0pointsrnpointanglesrflippedcoordsrMrO gap_coordss ` r6rzImageDraw.linesll4  # ?uzz I S% 0 0 0EAII//33q#f++/227=7=A"1IE$AE]E2"F1q5M2+FayF1I--       q F1I-M&)c/F1I2MQ )fQi/OF1IOfQi4OqEAI-158eai3G!3KLqEAI-158eai3G!3KLFF&,Qi"nfQi"ns&,Qi"nfQi"nsMM&%"*cBhEEEqyy"  .ufQi"n E E % .ufQi"n E E*JJ!/ufQi"n E E % .ufQi"n E E*J  *d! <<|z dz |zdzkr,j |zdz|z dz fdss|zg} dr| dxx|dzz cc<dr| dxx|dzzcc<j | d|z g} dr| dxx|dzz cc<dr| dxx|dzzcc<j | dkrdkr| dszdz g} dr| dxx|dzz cc<dr| dxx|dzzcc<j | dz dzg} dr| dxx|dzz cc<dr| dxx|dzzcc<j | dsĉzdz g} dr| dxx|dzz cc<dr| dxx|dzzcc<j | dz dzg} dr| dxx|dzz cc<dr| dxx|dzzcc<j | ddSdSdSdSdS)zDraw a rounded rectangle.z&x1 must be greater than or equal to x0z&y1 must be greater than or equal to y0N)TTTTrl)FFrrrboolrrc  r z zfddf z zfddff}nr z zfddf z zfddff}n`tfdt z zfddf z zfddf z z fddf z zfddffD}|D]-}|r jj|dfz jj| fz.dS)Nrryrrc32K|]\}}| |VdSr@)rmrnpartrs r6rzDImageDraw.rounded_rectangle..draw_corners..sG  4qz       r8r)rH enumerater.rrS)rpartsrrdr^full_xfull_yr0r3rPx0x1y0y1s r6 draw_cornersz1ImageDraw.rounded_rectangle..draw_cornerss "b1fb1f-sC8"q&"q&"-q#6 "b1fb1f-r371fb"b1f-sB7     #, "b1fb1f5sC@ 1fb"b1f5sC@ 1fb1fb"5q"= "q&"q&"5r3? $$      ? ??+DI+dh].BDDD&DI&e )<>>>  ? ?r8TrF)rrrr) rsr*minroundallrcanyrrQrKr.r)r3rLrer2rZrPrr5rrleftrighttopbottomrr^rrr0rrrrs` `` @@@@@@@@@r6rounded_rectanglezImageDraw.rounded_rectangles"33B77R(2r 77:CS// ! 77:CS// ! ?.G Rb&1* - - 2YY 2YY 2YY 2YY% w<< >"r'A+%F G"r'A+%F G >& >||Bgu=== 66W6>>"dGU;; ; QKK Wd33 X ? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ?D   L    X (("b1fqj"b1fqj)I8UVWWWWa!rAvz)) (("q&1*b"q&1*b)I8UVWWW =& =BQ+1:%GGGq1u$GGG1:%GGGq1u$GGG ((x;;;aR,1:&!HHHA%HHH1:&!HHHA%HHH ((!<<< ?sh5A:: L    92r2:>21:$FFFa!eOFFF1:$FFFa!eOFFF ((c1555b5j1nb"51:'1IIIQ&III1:'1IIIQ&III ((a888 8BU Q31:%GGGq1u$GGG1:%GGGq1u$GGG ((sA666eaR41:&!HHHA%HHH1:&!HHHA%HHH ((Q77777= ?::" 8 8r8rwrFtuple[float, float]textAnyStr | ImageText.Text[AnyStr]anchorspacingalignrF directionfeatureslist[str] | Nonelanguage stroke_width stroke_fillembedded_colorrargsrkwargsc ` t|tjr|nw|(d}tj||j|  r| r| | dfd }||}|dSd}jrj |j n|} |||D]Add  f d }|#||j||kr ||6||BdS)z Draw text.Nr=r2rBrrQcH|\}}||J|S|Sr@)rK)r2r0r^r3s r6getinkzImageDraw.text..getink3s3 LL..MC{+++Jr8rr0rrNrc  j}|dkr rd}tj}tj}t jjdt jjdf}t jtj rDjj j | |j ||g Rddi\}}||dz }||dz }nZ jj j | |j |g Rd|i}n/#t$r"j j }YnwxYw|dkr||d}}t!jd|d} |d| j>j|||||jdz||jdzf|dSdSj||f||dS) Nrr! stroke_filledTrrMrrn)r1rQrrrmodfrErr FreeTypeFontgetmask2rrgetmask TypeErrorgetbandrpackfillbandrpasterr.rY)r0rrrrrMroffsetcolor ink_alpharrrr image_textrrrr3s r6 draw_textz!ImageDraw.text..draw_textHs`}1$$$!DKKKK46**1-ty/@/@/CDjoy/EFF!B#;:?#; !  $  $ $ $ $'+ $! $ $LD&NANAAB6z6 I %$$( K "   #( %  %BBB)66tyAAB6>>#' Q4E & C 5 5a 8INN1i000w* !Aq!dil*:A ! >>*$$IcNNN #EB B r8r=rcH|||||||||| | | | | |SNr)r)r3rLrr2rrrrrrrrrrr=s r6multiline_textzImageDraw.multiline_textsI$yy                r8c|||}tj|||j|||}|r||S)z@Get the length of a given string, in pixels with 1/64 precision.N)rrr)rAr rrr get_length) r3rrrrrrr=rs r6 textlengthzImageDraw.textlengthsr <==++D^   I      %  " " $ $ $$$&&&r8!tuple[float, float, float, float]c  ||| }tj|||j|||| } | r| | r| | | |||S)z2Get the bounding box of a given string, in pixels.)rAr rrrrget_bbox)r3rLrrrrrrrrrrr=rs r6textbboxzImageDraw.textbboxs" <==++D^ $ 7Ix    %  " " $ $ $  ,   l + + +""2vu555r8c D|||||||||| | | |  Sr)r) r3rLrrrrrrrrrrr=s r6multiline_textbboxzImageDraw.multiline_textbboxsC }}              r8r@)rrrrrr)rr9)r=r>rr9)r0rBr2rBrrC)Nr) rLrrMrNrOrNr2rBrPrQrr)rLrUrVrr2rBrr)NNr)rLrrMrNrOrNr2rBrZrBrPrQrr) rLrr2rBrZrBrPrQrr) rLrdrerNr2rBrZrBrPrQrr)rLrrri)NrN) rLrr2rBrPrQrtrrr)NN)rrr2rBrZrBrr)rLrr2rBrr)rNNr)rrrrQrrNr2rBrZrBrPrQrr)rLrrerNr2rBrZrBrPrQrrrr) NNNrwrNNNrNF) rLrrrr2rBrrrrrrNrrFrrrrrrrrNrrBrrrrrrrr)rLrrrr2rBrrrrrrNrrFrrrrrrrrNrrBrrr=r>rr)NNNNF)rrrrrrrrrrrrr=r>rrN) NNrwrNNNrF)rLrrrrrrrrrNrrFrrrrrrrrNrrr=r>rr)__name__ __module__ __qualname__r__annotations__r7r<rArKrTrVr_rcrhrsrrrrrrrrrrrrrrr8r6rr>s+/D////&&&&&P2""""59'''''<! ; ; ; ; ;KO 6 6 6 6 6 !#@@@@@&!# 6 6 6 6 6$!# 7 7 7 7 7! D=D=D=D=D=R!# 2 2 2 2 2&!#CCCCC +++++!# KKKKK8 # / / / / / !# 8 8 8 8 8" # G89=G8G8G8G8G8G8Z!/3! $%)##'$uuuuuv!/3! $%)##'$! #'!! ! ! ! ! ! L04 $%)#$'#'''''''<04! $%)#$6#'666666@04! $%)#$ #'        r8rrrrrrcv t|d|S#t$rt||cYSwxYw)a A simple 2D drawing interface for PIL images. :param im: The image to draw in. :param mode: Optional mode to use for color values. For RGB images, this argument can be RGB or RGBA (to blend the drawing into the image). For all other modes, this argument must be the same as the image mode. If omitted, the mode defaults to the mode of the image. getdraw)getattrAttributeErrorr)rrs r6rrsR#%wr9%%d+++ ###T"""""#s 88Image.Image | None)tuple[ImageDraw2.Draw | None, ModuleType]c>ddlm}||j|nd}||fS)zm :param im: The image to draw in. :returns: A (drawing context, drawing resource factory) tuple. rrN)rr)rrr.s r6r r s; "$.?:?2   dD  r8imagerLtuple[int, int]valuefloat | tuple[int, ...]borderfloat | tuple[int, ...] | NonethreshrNrcz|}|J|\}} |||f}t|||krdS||||f<n#ttf$rYdSwxYw||fh} t } | rt } | D]\}}|dz|f|dz |f||dzf||dz ffD]\} } | | f| vs | dks| dkr || | f}| | | f|t|||k}n|||fv}|r||| | f<| | | fx#ttf$rYwxYw| } | } | dSdS)a .. warning:: This method is experimental. Fills a bounded region with a given color. :param image: Target image. :param xy: Seed position (a 2-item coordinate tuple). See :ref:`coordinate-system`. :param value: Fill color. :param border: Optional border value. If given, the region consists of pixels with a color different from the border color. If not given, the region consists of pixels having the same color as the seed pixel. :param thresh: Optional threshold value which specifies a maximum tolerable difference of a pixel value from the 'background' in order for it to be replaced. Useful for filling regions of non-homogeneous, but similar, colors. Nrr)rX _color_diffr* IndexErrorsetadd)rrLrrrpixelrr backgroundedge full_edgenew_edgestrr2s r6 floodfillr&s6 JJLLE     DAq1a4[ uj ) )V 3 3 Fad  # F8DI 55 - -DAqa%a!eQZ!QUaQZH - -1q6Y&&!a%%1q55 -ad AMM1a&)))~*1j99VC 7-&+ad  aV,,,#J/D  -" + s(AAAA< DD/.D/rrrrQrlist[tuple[float, float]]cp t|tsd}t||dkrd}t|t|tt fsd}t|t |dkrKtd|Dsd}t|tdt |^ nt |dkrt|d tt frtd |d Dr"t|d ttfsd}t|t |d dkrd }t|tdt |d td |d  nd}t| d krd}t|t|ttfsd}t|dfd d fd dd}|||}fd|DS) u Generate a list of vertices for a 2D regular polygon. :param bounding_circle: The bounding circle is a sequence defined by a point and radius. The polygon is inscribed in this circle. (e.g. ``bounding_circle=(x, y, r)`` or ``((x, y), r)``) :param n_sides: Number of sides (e.g. ``n_sides=3`` for a triangle, ``6`` for a hexagon) :param rotation: Apply an arbitrary rotation to the polygon (e.g. ``rotation=90``, applies a 90 degree rotation) :return: List of regular polygon vertices (e.g. ``[(25, 50), (50, 50), (50, 25), (25, 25)]``) How are the vertices computed? 1. Compute the following variables - theta: Angle between the apothem & the nearest polygon vertex - side_length: Length of each polygon edge - centroid: Center of bounding circle (1st, 2nd elements of bounding_circle) - polygon_radius: Polygon radius (last element of bounding_circle) - angles: Location of each polygon vertex in polar grid (e.g. A square with 0 degree rotation => [225.0, 315.0, 45.0, 135.0]) 2. For each angle in angles, get the polygon vertex at that angle The vertex is computed using the equation below. X= xcos(φ) + ysin(φ) Y= −xsin(φ) + ycos(φ) Note: φ = angle in degrees x = 0 y = polygon_radius The formula above assumes rotation around the origin. In our case, we are rotating around the centroid. To account for this, we use the formula below X = xcos(φ) + ysin(φ) + centroid_x Y = −xsin(φ) + ycos(φ) + centroid_y zn_sides should be an intrzn_sides should be an int > 2z$bounding_circle should be a sequencec3NK|] }t|ttfV!dSr@rErQrNrmrns r6rz4_compute_regular_polygon_vertices..s0HH1:a#u..HHHHHHr8z0bounding_circle should only contain numeric data list[float]rlrc3NK|] }t|ttfV!dSr@r*r+s r6rz4_compute_regular_polygon_vertices..sA  ,-Jq3, ' '      r8rzBbounding_circle centre should contain 2D coordinates (e.g. (x, y))rNz[bounding_circle should contain 2D coordinates and a radius (e.g. (x, y, r) or ((x, y), r) )z$bounding_circle radius should be > 0z"rotation should be an int or floatrrzrrc t|dtjtjd|z z|dtjtjd|z zz dzdt|dtjtjd|z z|dtjtjd|z zzdzdfS)Nrryrrl)rrrrr)rrzcentroids r6_apply_rotationz:_compute_regular_polygon_vertices.._apply_rotations a48DLw$?$?@@@(TXdl3=&A&ABBBC1+    a48DLw$?$?@@@(TXdl3=&A&ABBBC1+     r8r}c$dg}||SNrr)r} start_pointr0polygon_radiuss r6_compute_polygon_vertexzB_compute_regular_polygon_vertices.._compute_polygon_vertexs%q) {E222r8rrQrcg}d|z }dd|zz |z}t|D]'}||||z }|dkr|dz}(|S)Nryrg?)rqappend)rrrrz current_angle_s r6 _get_anglesz6_compute_regular_polygon_vertices.._get_anglesso-sW},8 w % %A MM- ( ( ( W $Ms""$  r8c&g|] }|Srr)rmr}r5s r6roz5_compute_regular_polygon_vertices..s% ? ? ?u # #E * * ? ? ?r8)rr,rzrNrr)r}rNrr)rrQrrNrr,) rErQrr*rprHrrrrrN) rrrr5r:rr0r5r/r4s @@@@r6rr`sV gs # #(nn{{,oo oe} 5 54nn ?q  HHHHHHH "DCS// !$(_8M8M$N$N!>> _   " "z/!2DtUm'T'T "  1@1C      "OA.e == "ECS// ! q! " "a ' 'VCS// ! tOA,>'?'?@@gq'9:: < oo4oo he - -2oo      3333333    [( + +F @ ? ? ? ? ? ??r8color1color2ct|tr|n|ft|tr|n|ftfdtt DS)zJ Uses 1-norm distance to calculate difference between two values. c3TK|]"}t||z V#dSr@)abs)rmrnfirstseconds r6rz_color_diff..s8EEQs58fQi'((EEEEEEr8)rErHsumrqrr)r<r=rArBs @@r6rrsn !// >FFfYE!&%00 ?VVviF EEEEE%F 2D2DEEE E EEr8r@)rrrrrr)rrrrr2) rrrLrrrrrrrNrr)rrrrQrrNrr')r<rr=rrrN)" __future__r__lazy_modules__rrtypingrrrr r r TYPE_CHECKINGcollections.abcr r typesrrrr_typingrrr-rZrr rrr r&rrrr8r6rKs@#""""""H% 555555555555 &22222222      """"""""%%%%%%%%.3Z-?????B  B  B  B  B  B  B  B  J#####".2 >>>>>B@@@@D F F F F F Fr8