U
|
T ±dVT ã @ s d dl Z d dlZd dlZddlmZmZ dd Zdd Zdd Zd2d d Z d3ddZ
|
ej j fddZ ej j ddfddZd4ddZej j fddZej jfddZd5d d Zd6d d Zej j d dfd!d"Zd#d$ Zd%d& Zd'd( Zd)d* Zd+d, Zd7d.d/Zd0d1 Z dS )8é Né )ÚImageÚ ImagePalettec C s^ t | trBt| dkr(| \}}\}}qRt| dkrR| \}}}}n| } } }}||||fS )Né é )Ú
|
isinstanceÚtupleÚlen)ÚborderÚleftÚtopÚrightÚbottom© r úCd:\z\workplace\vscode\pyvenv\venv\Lib\site-packages\PIL/ImageOps.pyÚ_border s
|
r c C s& t | tr"ddlm} | | |¡} | S )Nr )Ú
|
ImageColor)r ÚstrÚ r Úgetcolor)ÚcolorÚmoder r r r Ú_color) s
|
r c C s^ | j dkrd}t|nB| j dkrN| j dkrDt|dkrD|| | }| |¡S d}t|d S )NÚPzmode P support coming soon)ÚLÚRGBr é z!not supported for this image mode)r ÚNotImplementedErrorr ÚpointÚOSError)ÚimageÚlutÚmsgr r r Ú_lut1 s
|
|
|
|
r# Fc C sV |r| d¡ |¡}n
|
| |¡}g }tdt|dD ]}|||d
}|dk rz d||< W n& tk
|
r |D ] } d|| < qrY nX |rt|ts||f}d}
|
tdD ]} |
|
|| }
|
qª|
|
|d d } tdD ]H} | || krú| || } d|| < n|| | 8 < d} | dkrÔ q qÔ|
|
|d d } tdddD ]N} | || krb| || } d|| < n|| | 8 < d} | dkr: qq:tdD ]} || r qªqtdddD ]} || r¶ qÎq¶| | krì| ttd¡ q4d | | }| | }tdD ]>} t | | | } | dk r.d} n| dkr<d} |
|
| ¡ q
|
q4t | |S )
|
aÙ
|
Maximize (normalize) image contrast. This function calculates a
|
histogram of the input image (or mask region), removes ``cutoff`` percent of the
|
lightest and darkest pixels from the histogram, and remaps the image
|
so that the darkest pixel becomes black (0), and the lightest
|
becomes white (255).
|
|
:param image: The image to process.
|
:param cutoff: The percent to cut off from the histogram on the low and
|
high ends. Either a tuple of (low, high), or a single
|
number for both.
|
:param ignore: The background pixel value (use None for no background).
|
:param mask: Histogram used in contrast operation is computed using pixels
|
within the mask. If no mask is given the entire image is used
|
for histogram computation.
|
:param preserve_tone: Preserve image tone in Photoshop-like style autocontrast.
|
|
.. versionadded:: 8.2.0
|
|
:return: An image.
|
r r r Néd r éÿ éÿÿÿÿg ào@) ÚconvertÚ histogramÚranger Ú TypeErrorr r ÚextendÚlistÚintÚappendr# )r ÚcutoffÚignoreÚmaskZ preserve_toner( r! ZlayerÚhÚixÚnZcutÚloÚhiÚscaleÚoffsetr r r Ú autocontrastC sl
|
|
|
|
|
|
|
|
|
|
|
|
|
|
r9 r% é c C s | j dkst|dkr<d| kr4| kr4dksjn tn.d| krd| krd| krddksjn tt|d}t|d}|dk rt|d}g }g }g } td|D ].}
|
| |d ¡ | |d ¡ | |d ¡ q¦|dkrztd|| } | D ]}
|
| |d |
|
|d |d t| ¡ | |d |
|
|d |d t| ¡ | |d |
|
|d |d t| ¡ qòn0td|| } td|| } | D ]}
|
| |d |
|
|d |d t| ¡ | |d |
|
|d |d t| ¡ | |d |
|
|d |d t| ¡ q| D ]}
|
| |d |
|
|d |d t| ¡ | |d |
|
|d |d t| ¡ | |d |
|
|d |d t| ¡ q$tdd| D ]0}
|
| |d ¡ | |d ¡ | |d ¡ q¸| d¡} t| || | S ) a
|
Colorize grayscale image.
|
This function calculates a color wedge which maps all black pixels in
|
the source image to the first color and all white pixels to the
|
second color. If ``mid`` is specified, it uses three-color mapping.
|
The ``black`` and ``white`` arguments should be RGB tuples or color names;
|
optionally you can use three-color mapping by also specifying ``mid``.
|
Mapping positions for any of the colors can be specified
|
(e.g. ``blackpoint``), where these parameters are the integer
|
value corresponding to where the corresponding color should be mapped.
|
These parameters must have logical order, such that
|
``blackpoint <= midpoint <= whitepoint`` (if ``mid`` is specified).
|
|
:param image: The image to colorize.
|
:param black: The color to use for black input pixels.
|
:param white: The color to use for white input pixels.
|
:param mid: The color to use for midtone input pixels.
|
:param blackpoint: an int value [0, 255] for the black mapping.
|
:param whitepoint: an int value [0, 255] for the white mapping.
|
:param midpoint: an int value [0, 255] for the midtone mapping.
|
:return: An image.
|
r Nr r% r r r r )r ÚAssertionErrorr r) r. r r' r# )r ZblackZwhiteZmidZ
|
blackpointZ
|
whitepointZmidpointÚredÚgreenÚblueÚiZ range_mapZ
|
range_map1Z
|
range_map2r r r Úcolorize sJ &.
|
|
|
|
**0**.**.
|
r@ c C s | j | j }|d |d }||kr||kr^t| j| j |d }||d kr|d |f}n0t| j | j |d }||d kr||d f}| j||dS )aö
|
Returns a resized version of the image, set to the maximum width and height
|
within the requested size, while maintaining the original aspect ratio.
|
|
:param image: The image to resize and crop.
|
:param size: The requested output size in pixels, given as a
|
(width, height) tuple.
|
:param method: Resampling method to use. Default is
|
:py:attr:`~PIL.Image.Resampling.BICUBIC`.
|
See :ref:`concept-filters`.
|
:return: An image.
|
r r )Úresample)ÚwidthÚheightÚroundÚresize)r ÚsizeÚmethodZim_ratioZ
|
dest_ratioZ
|
new_heightZ new_widthr r r Úcontainð s rH )ç à?rI c C sÀ t | ||}|j|kr |}n t | j||¡}|jr@| | ¡ ¡ |j|d krt |d |j t
|
dt |d d }| ||df¡ n6t |d |j t
|
dt |d d }| |d|f¡ |S )at
|
Returns a resized and padded version of the image, expanded to fill the
|
requested aspect ratio and size.
|
|
:param image: The image to resize and crop.
|
:param size: The requested output size in pixels, given as a
|
(width, height) tuple.
|
:param method: Resampling method to use. Default is
|
:py:attr:`~PIL.Image.Resampling.BICUBIC`.
|
See :ref:`concept-filters`.
|
:param color: The background color of the padded image.
|
:param centering: Control the position of the original image within the
|
padded version.
|
|
(0.5, 0.5) will keep the image centered
|
(0, 0) will keep the image aligned to the top left
|
(1, 1) will keep the image aligned to the bottom
|
right
|
:return: An image.
|
r r )rH rF r Únewr ÚpaletteÚ
|
putpaletteÚ
|
getpaletterB rD ÚmaxÚminÚpasterC ) r rF rG r Ú centeringZresizedÚoutÚxÚyr r r Úpad s
|
&&rU c C s6 t |\}}}}| ||| jd | | jd | f¡S )a/
|
Remove border from image. The same amount of pixels are removed
|
from all four sides. This function works on all image modes.
|
|
.. seealso:: :py:meth:`~PIL.Image.Image.crop`
|
|
:param image: The image to crop.
|
:param border: The number of pixels to remove.
|
:return: An image.
|
r r )r ÚcroprF )r r
|
r r r r r r r rV 3 s rV c C sR |dkr| ¡ S |dkr&d}t|n(t|| j t|| j f}| ||¡S dS )aá
|
Returns a rescaled image by a specific factor given in parameter.
|
A factor greater than 1 expands the image, between 0 and 1 contracts the
|
image.
|
|
:param image: The image to rescale.
|
:param factor: The expansion factor, as a float.
|
:param resample: Resampling method to use. Default is
|
:py:attr:`~PIL.Image.Resampling.BICUBIC`.
|
See :ref:`concept-filters`.
|
:returns: An :py:class:`~PIL.Image.Image` object.
|
r r z!the factor must be greater than 0N)ÚcopyÚ
|
ValueErrorrD rB rC rE )r ZfactorrA r" rF r r r r7 B s
|
r7 c C s | | jtjj| | ¡|¡S )aL
|
Deform the image.
|
|
:param image: The image to deform.
|
:param deformer: A deformer object. Any object that implements a
|
``getmesh`` method can be used.
|
:param resample: An optional resampling filter. Same values possible as
|
in the PIL.Image.transform function.
|
:return: An image.
|
)Z transformrF r Z TransformZMESHZgetmesh)r ZdeformerrA r r r ÚdeformY s ÿrY c C sâ | j dkr| d¡} | |¡}g }tdt|dD ]¤}dd |||d
D }t|dkrp| ttd¡ q2t t j
|
|¡|d d }|s¢| ttd¡ q2|d
|
}tdD ]"}| || ¡ |||| }q²q2t | |S ) a
|
Equalize the image histogram. This function applies a non-linear
|
mapping to the input image, in order to create a uniform
|
distribution of grayscale values in the output image.
|
|
:param image: The image to equalize.
|
:param mask: An optional mask. If given, only the pixels selected by
|
the mask are included in the analysis.
|
:return: An image.
|
r r r r c S s g | ] }|r|qS r r )Ú.0Z_fr r r Ú
|
<listcomp>y s z equalize.<locals>.<listcomp>r r& r% r ) r r' r( r) r r+ r, Ú functoolsÚreduceÚoperatorÚaddr. r# ) r r1 r2 r! ÚbZhistoÚstepr4 r? r r r Úequalizei s
|
|
|
rb c C s¨ t |\}}}}|| jd | }|| jd | }t|| j} | jrltj| ¡ d}
|
t| trp|
|
| ¡} nd}
|
t
|
| j||f| ¡} |
|
r| |
|
j¡ | | ||f¡ | S )zÖ
|
Add border to the image
|
|
:param image: The image to expand.
|
:param border: Border width, in pixels.
|
:param fill: Pixel fill value (a color value). Default is 0 (black).
|
:return: An image.
|
r r )rK N)r rF r r rK r rM r r r r rJ rL rP ) r r
|
Úfillr r r r rB rC r rK rR r r r Úexpand s
|
rd ç c C sx t |}d|d kr dks*n d|d< d|d krBdksLn d|d< d| kr`dk sfn d}|| jd || jd f}| jd |d d | jd |d d f}|d |d }|d |d }||krè|d } |d }
|
n4||kr||d } |d }
|
n|d } |d | }
|
|d |d | |d } |d |d |
|
|d } | | | | | |
|
f} | j||| dS )a
|
Returns a resized and cropped version of the image, cropped to the
|
requested aspect ratio and size.
|
|
This function was contributed by Kevin Cazabon.
|
|
:param image: The image to resize and crop.
|
:param size: The requested output size in pixels, given as a
|
(width, height) tuple.
|
:param method: Resampling method to use. Default is
|
:py:attr:`~PIL.Image.Resampling.BICUBIC`.
|
See :ref:`concept-filters`.
|
:param bleed: Remove a border around the outside of the image from all
|
four edges. The value is a decimal percentage (use 0.01 for
|
one percent). The default value is 0 (no border).
|
Cannot be greater than or equal to 0.5.
|
:param centering: Control the cropping position. Use (0.5, 0.5) for
|
center cropping (e.g. if cropping the width, take 50% off
|
of the left side, and therefore 50% off the right side).
|
(0.0, 0.0) will crop from the top left corner (i.e. if
|
cropping the width, take all of the crop off of the right
|
side, and if cropping the height, take all of it off the
|
bottom). (1.0, 0.0) will crop from the bottom left
|
corner, etc. (i.e. if cropping the width, take all of the
|
crop off the left side, and if cropping the height take
|
none from the top, and therefore all off the bottom).
|
:return: An image.
|
re r g ð?rI r r )Zbox)r, rF rE )r rF rG ZbleedrQ Z bleed_pixelsZ live_sizeZlive_size_ratioZ output_ratioZ
|
crop_widthZ crop_heightZ crop_leftZcrop_toprV r r r Úfit¢ s2 # þ
|
|
|
rf c C s | tjj¡S )zq
|
Flip the image vertically (top to bottom).
|
|
:param image: The image to flip.
|
:return: An image.
|
)Ú transposer Ú TransposeÚFLIP_TOP_BOTTOM©r r r r Úflipø s rk c C s
|
| d¡S )zi
|
Convert the image to grayscale.
|
|
:param image: The image to convert.
|
:return: An image.
|
r )r' rj r r r Ú grayscale s rl c C s> g }t dD ]}| d| ¡ q | jdkr4| |¡S t| |S )zc
|
Invert (negate) the image.
|
|
:param image: The image to invert.
|
:return: An image.
|
r r% Ú1)r) r. r r r# )r r! r? r r r Úinvert s rn c C s | tjj¡S )zq
|
Flip image horizontally (left to right).
|
|
:param image: The image to mirror.
|
:return: An image.
|
)rg r rh ÚFLIP_LEFT_RIGHTrj r r r Úmirror s rp c C s< g }dd| d }t dD ]}| ||@ ¡ q t| |S )zÁ
|
Reduce the number of bits for each color channel.
|
|
:param image: The image to posterize.
|
:param bits: The number of bits to keep for each channel (1-8).
|
:return: An image.
|
r é r r ©r) r. r# )r Úbitsr! r1 r? r r r Ú posterize# s
|
rt é c C s> g }t dD ]&}||k r$| |¡ q | d| ¡ q t| |S )z¿
|
Invert all pixel values above a threshold.
|
|
:param image: The image to solarize.
|
:param threshold: All pixels above this greyscale level are inverted.
|
:return: An image.
|
r r% rr )r Ú thresholdr! r? r r r Úsolarize2 s rw c C sâ | ¡ }| d¡}tjjtjjtjjtjjtjjtjj tjj
|
d |¡}|dk rÚ| |¡}| ¡ }d|krÖ|d= d|j kr| ¡ |j d< nLd|j kr¨| ¡ ¡ |j d< n.d|j krÖdD ] }t |d|j d ¡|j d< q¶|S | ¡ S ) a
|
If an image has an EXIF Orientation tag, other than 1, return a new image
|
that is transposed accordingly. The new image will have the orientation
|
data removed.
|
|
Otherwise, return a copy of the image.
|
|
:param image: The image to transpose.
|
:return: An image.
|
i )r é r é é é rq NÚexifzRaw profile type exifzXML:com.adobe.xmp)ztiff:Orientation="([0-9])"z,<tiff:Orientation>([0-9])</tiff:Orientation>r )ZgetexifÚgetr rh ro Z
|
ROTATE_180ri Z TRANSPOSEZ
|
ROTATE_270Z
|
TRANSVERSEZ ROTATE_90rg ÚinfoÚtobytesÚhexÚreÚsubrW )r r| Z orientationrG Ztransposed_imageZtransposed_exifÚpatternr r r Úexif_transposeC sB
|
ùø
|
|
|
|
þÿ
|
ÿ r )r NNF)Nr r% r: )r )N)r r )ru ) r\ r^ r r r r r r r# r9 r@ Z
|
ResamplingZBICUBICrH rU rV r7 ZBILINEARrY rb rd rf rk rl rn rp rt rw r r r r r Ú<module> s.
|
[
|
R &
|
|
|
V
|
|
|
|
|
