U
|
T ±d
ã @ s d dl Z d dlZd dlZddlmZmZ ddlmZ G dd dZdddZ z ej
|
j Z W n e k
|
rp dZ Y nX dd d
|
Zdd d Zd d Zdd ZdS )é Né )ÚImageÚ
|
ImageColor)Ú deprecatec @ s e Zd ZdZd:ddZdd Zd;ddZd<d d
|
Zd=d d Zd>d dZ d?ddZ
|
d@ddZ dAddZ dBddZ dCddZdDddZdEd d ZdFd d ZdGdd d!d"Zd#d$ Zd%d& Zd'd( ZdHd,d-ZdId.d/ZdJd0d1ZdKd2d3ZdLd4d5ZdMd6d7ZdNd8d9Z dS )OÚ ImageDrawNc C sÚ | ¡ |jr| ¡ d}|dkr(|j}||jkrV|dkrJ|jdkrJd}n d}t||dkrh|j| _nd| _|| _|j| _tj
|
| j|¡| _
|
|| _|dkr¬| j
|
d¡| _ n| j
|
d ¡| _ |d
|
krÊd | _ 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.
|
r NÚRGBAÚRGBr z mode mismatchÚP)ÚIÚFéÿÿÿÿ)Ú1r r
|
r r ÚLF)ÚloadÚreadonlyZ_copyÚmodeÚ
|
ValueErrorÚpaletteÚ_imageÚimr ÚcoreÚdrawÚdraw_inkÚinkÚfontmodeÚfill)Úselfr r ZblendÚmsg© r úDd:\z\workplace\vscode\pyvenv\venv\Lib\site-packages\PIL/ImageDraw.pyÚ__init__3 s2
|
|
zImageDraw.__init__c C s" | j s ddlm} | ¡ | _ | j S )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.r )Ú ImageFont)ÚfontÚ r! Z load_default)r r! r r r Úgetfont] s
|
zImageDraw.getfontc C sÊ |d kr&|d kr&| j r | j}qÂ| j}n|d k rtt|trFt || j¡}| jrht|tj sh| j || j
|
¡}| j |¡}|d k rÂt|trt || j¡}| jr¶t|tj s¶| j || j
|
¡}| j |¡}||fS ©N) r r Ú
|
isinstanceÚstrr Zgetcolorr r ÚnumbersÚNumberr r r )r r r r r r Ú_getinkv s"
|
|
zImageDraw._getinkr c C s. | |¡\}}|dk r*| j |||||¡ dS )z Draw an arc.N)r* r Údraw_arc)r ÚxyÚstartÚendr Úwidthr r r r Úarc s z ImageDraw.arcc C s@ | ¡ | |¡\}}|dkr"|}|dk r<| j ||j|¡ dS )zDraw a bitmap.N)r r* r Ú draw_bitmapr )r r, Úbitmapr r r r r r2 s zImageDraw.bitmapc C s^ | ||¡\}}|dk r,| j ||||d¡ |dk rZ||krZ|dkrZ| j ||||d|¡ dS )z Draw a chord.Nr r )r* r Z
|
draw_chord©r r, r- r. r Úoutliner/ r r r r Úchord s
|
zImageDraw.chordc C sV | ||¡\}}|dk r(| j ||d¡ |dk rR||krR|dkrR| j ||d|¡ dS )zDraw an ellipse.Nr r )r* r Z draw_ellipse©r r, r r4 r/ r r r r Úellipse¢ s
|
zImageDraw.ellipser c s6 | |¡d }|dk r2| j | ¡ |dkr2 dkr2td ttfslfddtdtdD tdtd D ]°}| }d d |d |f||d ffD }|d |d krÈq~ fd
|
d } |d |d krú|d d |d kp |d |d k o |d d |d k}
|
|d d d |d d d f|d d d |d d d fg} |
|
r|d d |d d } } n|d d |d d } } | | | d | d |¡ dkr~|
|
rú| ||d d || ||d d g}n&| ||d d || ||d d g}| j ||dd q~dS )z6Draw a line, or a connected sequence of line segments.r NZcurveé c s g | ]}t ||d
qS )é )Útuple©Ú.0Úi)r, r r Ú
|
<listcomp>± s z"ImageDraw.line.<locals>.<listcomp>r9 r c
|
S s> g | ]6\}}t t |d |d |d |d ¡¡d qS )r r éh )ÚmathÚdegreesÚatan2)r< r- r. r r r r> ´ s þ(ÿc
|
sZ | \}}|d8 } d d }t dd ||t t |¡¡ f||t t |¡¡ ffD S )NéZ r9 r c s s2 | ]*\}}||d kr t |¡nt |¡ V qdS )r N)r@ ÚfloorÚceil)r< ÚpZp_dr r r Ú <genexpr>Á s ÿz9ImageDraw.line.<locals>.coord_at_angle.<locals>.<genexpr>)r: r@ ÚcosÚradiansÚsin)ÚcoordÚangleÚxÚyZdistance©r/ r r Úcoord_at_angle½ s þþz&ImageDraw.line.<locals>.coord_at_angleé´ rC é é rO )
|
r* r Z
|
draw_linesr& Úlistr: ÚrangeÚlenÚpiesliceÚline)r r, r r/ Zjointr r= ÚpointÚanglesrP ZflippedZcoordsr- r. Z
|
gap_coordsr )r/ r, r rX ª sH
|
ý "ÿ$þ&&þ ýýzImageDraw.linec C sT | ¡ | ||¡\}}|dk r0| j ||d¡ |dk rP||krP| j ||d¡ dS )z (Experimental) Draw a shape.Nr r )Úcloser* r Z draw_outline)r Úshaper r4 r r r r r\ æ s zImageDraw.shapec C s^ | ||¡\}}|dk r,| j ||||d¡ |dk rZ||krZ|dkrZ| j ||||d|¡ dS )zDraw a pieslice.Nr r )r* r Ú draw_pieslicer3 r r r rW ï s
|
zImageDraw.pieslicec C s( | |¡\}}|dk r$| j ||¡ dS )z#Draw one or more individual pixels.N)r* r Z draw_points)r r, r r r r r rY ÷ s zImageDraw.pointc C s& | ||¡\}}|dk r(| j ||d¡ |dk r"||kr"|dkr"|dkrb| j ||d|¡ nÀt d| jj¡}| d¡d }| ¡ }t|} | j ||d¡ | ¡ }
|
t|
|
} |d d }| j ||d|¡ |j |
|
|d t | j
|
| jj¡} t| } | j ||d|¡ | j | jd| j |j¡ dS )zDraw a polygon.Nr r r r9 )Úmask)r r ) r* r Z draw_polygonr Únewr ÚsizeÚcopyÚDrawÚpaster ) r r, r r4 r/ r r^ Zmask_inkZfill_imr Zink_imr r r r Úpolygoný s( zImageDraw.polygonc C s t |||}| |||¡ dS )zDraw a regular polygon.N)Ú!_compute_regular_polygon_verticesrd )r Úbounding_circleÚn_sidesÚrotationr r4 r, r r r Úregular_polygon s zImageDraw.regular_polygonc C sV | ||¡\}}|dk r(| j ||d¡ |dk rR||krR|dkrR| j ||d|¡ dS )zDraw a rectangle.Nr r )r* r Údraw_rectangler6 r r r Ú rectangle" s
|
zImageDraw.rectangle)Úcornersc s t |d ttfr$|\\
|
\ n |\
|
k rDd}t|
|
k rXd}t| dkrdd |d d\t rÄ kr
|
kr¬
|
rÄrÄ ||¡S dksÔt sä ||¡S d } |¡\
|
f dd } dk rL| d
|
r`j
|
|
| d | d fd ¡ n(j
|
| d
|
| d fd ¡ sLsL
|
| g}
|
d rÂ|
|
d |d 7 < d rà|
|
d |d 8 < j
|
|
|
d ¡ |
|
g} d r | d |d 7 < d r<| d |d 8 < j
|
| d ¡ dk rþkrþdkrþ| d s8
|
|
d g} d rª| d |d 7 < d rÈ| d |d 8 < j
|
| d ¡ d g} d r
|
| d |d 7 < d r(| d |d 8 < j
|
| d ¡ sþ
|
d g}
|
d rp|
|
d |d 7 < d r|
|
d |d 8 < j
|
|
|
d ¡ d
|
g} d rÐ| d |d 7 < d rî| d |d 8 < j
|
| d ¡ dS )zDraw a rounded rectangle.r z&x1 must be greater than or equal to x0z&y1 must be greater than or equal to y0N)TTTTr9 )FFc s< r:
|
|
fddf fddff}nÂrt
|
|
fddf
|
|
fddff}ng }t
|
|
fddf
|
|
fddf fddf fddffD ]\}} | rà| |¡ qà|D ]6}| r jj|df njj|f q d S )NrQ r? r rC é r )Ú enumerateÚappendr r] r+ )rW Úpartsr= Úpart© rl Údr Zfull_xZfull_yr r r/ Zx0Úx1Zy0Úy1r r Ú draw_cornersT s, þþüÿ z1ImageDraw.rounded_rectangle.<locals>.draw_cornersTr rS F) r& rT r: r Úallr7 Úanyrk r* r rj )r r, Zradiusr r4 r/ rl r Úrrv ÚleftÚrightÚtopÚbottomr rr r Úrounded_rectangle* s "
|
*(
|
|
|
|
|
|
|
|
|
|
|
|
zImageDraw.rounded_rectanglec C s t |trdnd}||kS ©NÚ
|
ó
|
)r& r' ©r ÚtextZsplit_characterr r r Ú_multiline_check© s zImageDraw._multiline_checkc C s t |trdnd}| |¡S r )r& r' Úsplitr r r r Ú_multiline_split® s zImageDraw._multiline_splitc
|
C sF t ¡ 4 t jdtd | jd||dd | W 5 Q R £ S Q R X d S )NÚignore©ÚcategoryÚA)r" Ú stroke_widthr )ÚwarningsÚcatch_warningsÚfilterwarningsÚDeprecationWarningÚtextsize)r r" Úspacingr r r r Ú_multiline_spacing³ s
|
ýüûÿz ImageDraw._multiline_spacingr8 rz Fc sÚ ¡r,
|
| ||| | ¡ S rFjdkrFd}t|dkrV ¡ fdd}d
|
f dd }||}|dk rÖd}| r°| dk r¬|| n|}|dk rÎ||| ||d n|| dS )
|
z
|
Draw text.©r r ú3Embedded color supported only in RGB and RGBA modesNc s | ¡\}} |d kr| S |S r% )r* )r r )r r r Úgetinkë s z ImageDraw.text.<locals>.getinkr c sª j }|dkrrd}g }g }tdD ].}| t
|
| ¡ | t
|
| ¡d ¡ q&zPj |f| | |d\}}|d |d |d |d f}W nd tk
|
r
|
z,j || | fd|i}W n t k
|
r ¡}Y nX Y nX |r2|d |d |d |d f}|dkr||
|
d¡ } }| d| d? d @ ¡ |\}
|
} j | |
|
| |
|
|jd | |jd f|¡ nj ||| ¡ d S )
|
Nr r r9 )Ú directionÚfeaturesÚlanguager Úanchorr r- r r- rS é éÿ )r rU ro Úintr@ ÚmodfZgetmask2ÚAttributeErrorZgetmaskÚ TypeErrorZgetbandZfillbandr rc r` r r1 ) r r Z stroke_offsetr rK r- r= r^ ÚoffsetÚcolorrM rN © r Úargsr Úembedded_colorr r" Úkwargsr r r r, r r Ú draw_textñ sl þ
|
ö÷ õ
|
$ø
|
ö ÷ õ
|
|
.z!ImageDraw.text.<locals>.draw_text)r N)r Úmultiline_textr r r$ )r r, r r r" r r Úalignr r r r Ú stroke_fillr¤ r£ r¥ r r r¦ r Z
|
stroke_inkr r¢ r r À s@
|
ó "5
|
zImageDraw.textc C sÀ |dkrd}t ||d kr"d}n2t|dkr<d}t |n|d dkrTd}t |g }d }| |¡}| ||| ¡}|D ],}| j|||| |
|
d
|
}| |¡ t||}qx|d }|d d krÔ|t|d | d 8 }n |d d krô|t|d | 8 }t|D ]¾\}}|d }||| }|d d kr4||d 8 }n|d dkrJ||8 }|dkrVn8|dkrn||d 7 }n |dkr||7 }n d}t || j||f|||||| |
|
| | | d ||7 }qüd S )NÚttbú/ttb direction is unsupported for multiline textÚlar9 ú#anchor must be a 2 character stringr Útbú'anchor not supported for multiline textr ©r r r Úmç @rs ry rz Úcenterr{ ú)align must be "left", "center" or "right")r r r r r© r¤ ) r rV r r Ú
|
textlengthro Úmaxrn r )r r, r r r" r r r¨ r r r r r© r¤ r ÚwidthsÚ max_widthÚlinesÚ line_spacingrX Ú
|
line_widthr| Úidxrz Úwidth_differencer r r r§ 6 sv
|
|
ÿ
|
|
|
|
|
õ zImageDraw.multiline_textc
|
C s¦ t ddd | |¡rVt ¡ 2 tjdtd | |||||||¡W 5 Q R £ S Q R X |dkrf| ¡ }t ¡ . tjdtd | |||||¡W 5 Q R £ S Q R X dS )z*Get the size of a given string, in pixels.r é
|
ztextbbox or textlengthr r N) r r r r r r Úmultiline_textsizer$ Úgetsize)r r r" r r r r r r r r r s0
|
|
ù
|
|
ûzImageDraw.textsizec C s t ddd d}| |¡} | |||¡}
|
t ¡ B tjdtd | D ](} | | ||||||¡\} } t|| }qDW 5 Q R X |t | |
|
| fS )Nr¿ r¾ Úmultiline_textbboxr r r )
|
r r r r r r r r r¶ rV )r r r" r r r r r r¸ r¹ rº rX r» Z line_heightr r r r¿ s$
|
|
|
ù z ImageDraw.multiline_textsizec
|
C sØ | |¡rd}t||r0| jdkr0d}t||dkr@| ¡ }|rHdn| j}z| |||||¡W S tk
|
rÒ tdd t ¡ ( tj
|
dt d | j |||||d
|
} W 5 Q R X |d krÆ| d Y S | d Y S X dS )z@Get the length of a given string, in pixels with 1/64 precision.z&can't measure length of multiline textr r Nr z.textlength support for fonts without getlengthr¾ r r r° rª r r ) r r r r$ r Z getlengthr r r r r r r )
|
r r r" r r r r¤ r r r` r r r rµ Ê s2
|
|
|
|
û zImageDraw.textlengthc C s² | r| j dkrd} t| | |¡rB| ||||||||| |
|
| ¡ S |dkrR| ¡ }| rZdn| j} | || ||| |
|
|¡}|d |d |d |d |d |d |d |d fS ) z2Get the bounding box of a given string, in pixels.r r Nr r r r9 rS )r r r rÁ r$ r Zgetbbox)r r, r r" r r r¨ r r r r r¤ r r Úbboxr r r Útextbboxï s<
|
õ ÿzImageDraw.textbboxc C s@ |dkrd} t | |d kr"d}n2t|dkr<d} t | n|d dkrTd} t | g } d }| |¡}| |||
|
¡}|D ].}| j||||| | d
|
}| |¡ t||}qx|d }|d d krÖ|t|d | d 8 }n |d d krö|t|d | 8 }d }t|D ]\}}|d }|| | }|d d kr<||d 8 }n|d dkrR||8 }|dkr^n8|dkrv||d 7 }n |dkr||7 }n d} t | | j||f|||||| |
|
| d }|d krÆ|}nDt |d |d t |d |d t|d |d t|d |d f}||7 }q|d kr<|d |d |d |d fS |S )Nrª r« r¬ r9 r r r® r¯ r )r r r r¤ r± r² rs ry rz r³ r{ r´ )r r r r r¤ rS )
|
r rV r r rµ ro r¶ rn rà Úmin)r r, r r" r r r¨ r r r r r¤ r r· r¸ r¹ rº rX r» r| r r¼ rz r½ Z bbox_liner r r rÁ s
|
|
ú
|
|
|
|
|
÷
|
ü
|
z ImageDraw.multiline_textbbox)N)N)Nr )N)NNr )NNr )Nr N)NN)NNr )N)NNr )r NN)NNr )r NNr ) NNNr8 rz NNNr NF) NNNr8 rz NNNr NF)Nr8 NNNr )Nr8 NNNr )NNNNF) NNr8 rz NNNr F) NNr8 rz NNNr F) Ú__name__Ú
|
__module__Ú __qualname__r" r r$ r* r0 r2 r5 r7 rX r\ rW rY rd ri rk r~ r r r r r§ r r¿ rµ rà rÁ r r r r r 0 s¸
|
*
|
|
|
|
|
|
<
|
|
|
|
ÿ
|
|
ÿÿ ò
|
z ò
|
U ø
|
( ø
|
ù
|
) ô
|
. ôr c C s0 z | |¡W S tk
|
r* t| | Y S X dS )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.
|
N)Úgetdrawr r )r r r r r rb } s rb c C s` d}|rd|kr6zddl m} W n tk
|
r4 Y nX |dkrJddl m} | rX| | ¡} | |fS )a
|
(Experimental) A more advanced 2D drawing interface for PIL images,
|
based on the WCK interface.
|
|
:param im: The image to draw in.
|
:param hints: An optional list of hints.
|
:returns: A (drawing context, drawing resource factory) tuple.
|
NZnicestr )Ú _imagingagg)Ú
|
ImageDraw2)r# rÉ Ú ImportErrorrÊ rb )r ÚhintsÚhandlerr r r rÈ s
|
rÈ c C sl | ¡ }|\}}z0|||f }t|||kr2W dS ||||f< W n ttfk
|
rZ Y dS X ||fh} t }
|
| rht } | D ]à\}}|d |f|d |f||d f||d ffD ]ª\} } | | f|
|
ks°| dk s°| dk rÖq°z|| | f }W n ttfk
|
r Y q°X |
|
| | f¡ |dkr*t|||k}n||ko:||k}|r°||| | f< | | | f¡ q°q|| }
|
| } qldS )aÏ
|
(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.
|
Nr r )r Ú _color_diffr Ú
|
IndexErrorÚsetÚadd)Úimager, ÚvalueZborderZthreshZpixelrM rN Z
|
backgroundZedgeZ full_edgeZnew_edgeÚsÚtrF r r r r Ú floodfill s<
|
4
|
rÖ c s$ t |tsd}t||dk r*d}t|t | ttfsDd}t|t| dkr\| ^ n"t| dkrr| \n d}t|tdd fD s¢d }t|tdksºd
|
}t|d krÎd }t|t |ttfsèd }t|dd fdddd }|||}fdd|D S )u
|
Generate a list of vertices for a 2D regular polygon.
|
|
:param bounding_circle: The bounding circle is a tuple 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 intrS z n_sides should be an int > 2z!bounding_circle should be a tupler9 z[bounding_circle should contain 2D coordinates and a radius (e.g. (x, y, r) or ((x, y), r) )c s s | ]}t |ttfV qd S r% )r& r Úfloatr; r r r rG % s z4_compute_regular_polygon_vertices.<locals>.<genexpr>z0bounding_circle should only contain numeric datazBbounding_circle centre should contain 2D coordinates (e.g. (x, y))r z$bounding_circle radius should be > 0z"rotation should be an int or floatc
|
S s t | d t t d| ¡¡ | d t t d| ¡¡ |d dt | d t t d| ¡¡ | d t t d| ¡¡ |d dfS )Nr r? r r9 )Úroundr@ rH rI rJ )rY rA Úcentroidr r r Ú_apply_rotation7 s" ÿþüÿþüùz:_compute_regular_polygon_vertices.<locals>._apply_rotationc s |dg} ||| S )Nr r )rÙ Úpolygon_radiusrL Z start_point)rÚ r r Ú_compute_polygon_vertexG s zB_compute_regular_polygon_vertices.<locals>._compute_polygon_vertexc S sR g }d| }dd| | }t d| D ]&}| |¡ ||7 }|dkr&|d8 }q&|S )Nr? rm g à?r )rU ro )rg rh rZ rA Z current_angleÚ_r r r Ú _get_anglesK s
|
|
z6_compute_regular_polygon_vertices.<locals>._get_anglesc s g | ]} |qS r r )r< rL )rÜ rÙ rÛ r r r> [ s z5_compute_regular_polygon_vertices.<locals>.<listcomp>) r& r r r rT r: rV rw r× )rf rg rh r rÞ rZ r )rÚ rÜ rÙ rÛ r re å sF )
|
|
ÿ
|
ÿre c s< t tr,t fddtdtD S t S dS )zJ
|
Uses 1-norm distance to calculate difference between two values.
|
c 3 s" | ]}t | | V qd S r% )Úabsr; ©Zcolor1Zcolor2r r rG e s z _color_diff.<locals>.<genexpr>r N)r& r: ÚsumrU rV rß rà r rà r rÎ ` s
|
"rÎ )N)NN)Nr )r@ r( r r# r r Z
|
_deprecater r rb r r4 ZOutliner rÈ rÖ re rÎ r r r r Ú<module>! s(
|
S
|
|
|
|
8{
|
