lh8:dZddlZddlZddlZddlmZddlmZddlm Z m Z ddl m Z ddl mZmZmZmZmZmZdd lmZdd lmZmZdd lmZdd lmZd ZdZdZdZ dZ!dZ"dZ#dZ$dZ%dZ&dZ'dZ(dZ)GddeZ*Gddej+de$Z,dZ-dS)z:mod:`wand.drawing` --- Drawings ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ The module provides some vector drawing functions. .. versionadded:: 0.3.0 N) assertions)library) AffineMatrix PointInfo)Color)abcbinary string_typetext text_typexrange)WandLibraryVersionError)COMPOSITE_OPERATORS BaseImage)Resource) SingleImage)CLIP_PATH_UNITSFILL_RULE_TYPESFONT_METRICS_ATTRIBUTES GRAVITY_TYPESLINE_CAP_TYPESLINE_JOIN_TYPESPAINT_METHOD_TYPES STRETCH_TYPES STYLE_TYPESTEXT_ALIGN_TYPESTEXT_DECORATION_TYPESTEXT_DIRECTION_TYPESDrawing FontMetrics)undefined_path_units user_spaceuser_space_on_useobject_bounding_box) undefinedleftcenterright)r&no underlineoverline line_through)r& right_to_left left_to_right) forget north_westnorth north_eastwestr(east south_westsouth south_eaststatic)r&evenoddnonzero) character_widthcharacter_heightascender descender text_width text_heightmaximum_horizontal_advancex1y1x2y2xy) r&normalultra_condensedextra_condensed condensedsemi_condensed semi_expandedexpandedextra_expandedultra_expandedany)r&rIitalicobliquerR)r&buttroundsquare)r&miterrVbevel)r&pointreplace floodfill filltoborderresetc eZdZdZejZejZej Z ej Z d|dZ edZejdZedZejdZedZejd Zed Zejd Zed Zejd ZedZejdZedZejdZedZejdZedZejdZedZejdZedZejdZedZejdZedZejdZedZejdZed Zejd!Zed"Zejd#Zed$Z e jd%Z ed&Z!e!jd'Z!ed(Z"e"jd)Z"ed*Z#e#jd+Z#ed,Z$e$jd-Z$ed.Z%e%jd/Z%ed0Z&e&jd1Z&ed2Z'e'jd3Z'ed4Z(e(jd5Z(ed6Z)e)jd7Z)ed8Z*e*jd9Z*ed:Z+e+jd;Z+ed<Z,e,jd=Z,ed>Z-e-jd?Z-ed@Z.e.jdAZ.edBZ/e/jdCZ/edDZ0e0jdEZ0edFZ1e1jdGZ1edHZ2e2jdIZ2dJZ3d}dLZ4dMZ5d|dNZ6dOZ7dPZ8dQZ9d~dSZ:d|dTZ;dUZddYZ?dZZ@d~d[ZAd\ZBdd]ZC dd^ZD dd_ZEd`ZFddaZGddbZHddcZIddZJddeZKd|dfZLd|dgZMdhZNdiZOdjZPdkZQdlZRdmZSdnZTdoZUdpZV ddqZWddrZXddtZYduZZdvZ[ddwZ\dxZ]ddyZ^dzZ_d{Z`dS)r aDrawing object. It maintains several vector drawing instructions and can get drawn into zero or more :class:`~wand.image.Image` objects by calling it. For example, the following code draws a diagonal line to the ``image``:: with Drawing() as draw: draw.line((0, 0), image.size) draw(image) :param drawing: an optional drawing object to clone. use :meth:`clone()` method rather than this parameter :type drawing: :class:`Drawing` .. versionadded:: 0.3.0 NcD|5|stj}nUt|t |st dt |ztj|j}||_ddddS#1swxYwYdS)Nz5drawing must be a wand.drawing.Drawing instance, not ) allocaterNewDrawingWand isinstancetype TypeErrorreprCloneDrawingWandresource)selfdrawingwands O/var/www/html/research.buxo.ca/env/lib/python3.11/site-packages/wand/drawing.py__init__zDrawing.__init__s ]]__ ! ! B-//d44 B!137==!ABBB/0@AA DM ! ! ! ! ! ! ! ! ! ! ! ! ! ! ! ! ! !sA3BBBctj}tj|j|t j|}tj|}|S)z(:class:`~wand.color.Color`) the current border color. It also can be set. This attribute controls the behavior of :meth:`~wand.drawing.Drawing.color()` during ``'filltoborder'`` operation. .. versionadded:: 0.4.0 )r NewPixelWandDrawGetBorderColorrhrfrom_pixelwandDestroyPixelWand)ri pixelwandcolors rl border_colorzDrawing.border_colorsL(** "4=)<<<$Y//,Y77  ct|trt|}tj||5t j|j|jddddS#1swxYwYdS)N)ru)rcr rr assert_colorrDrawSetBorderColorrhrirts rlruzDrawing.border_color e[ ) ) !%LLEU3333  F F  &t}en E E E F F F F F F F F F F F F F F F F F F A))A-0A-cd}tj|j}|r5tt j|}tj|}|S)a (:class:`basestring`) The current clip path. It also can be set. .. versionadded:: 0.4.0 .. versionchanged: 0.4.1 Safely release allocated memory with :c:func:`MagickRelinquishMemory` instead of :c:func:`libc.free`. N)rDrawGetClipPathrhr ctypes string_atMagickRelinquishMemory)ri clip_path_str clip_path_ps rl clip_pathzDrawing.clip_pathsR -dm<<  F !1+!>!>??M!8EEKrvc~tj|tj|jt |dS)N)r)r assert_stringrDrawSetClipPathrhr )ripaths rlrzDrawing.clip_paths7 40000 vd||<<<</6 8 8 8 8 "4=#0#6#6w#?#? A A A A Arvchtj|j}tt|S)z(:class:`basestring`) The current font style. It also can be set, but will only apply if the font-family supports the style. .. versionadded:: 0.4.0 )rDrawGetFontStylerhr r)ri style_indexs rl font_stylezDrawing.font_styles).t}== K ,---rvctjtd|tj|jt|dS)Nzwand.drawing.STYLE_TYPES)r)rrrrDrawSetFontStylerhr)ristyles rlrzDrawing.font_stylesZ!+"<-2 4 4 4 4  !,!2!25!9!9 ; ; ; ; ;rvc4tj|jS)z{(:class:`~numbers.Integral`) The current font weight. It also can be set. .. versionadded:: 0.4.0 )rDrawGetFontWeightrhrs rl font_weightzDrawing.font_weights(777rvcdtj|tj|j|dS)N)r)rassert_integerrDrawSetFontWeightrh)riweights rlrzDrawing.font_weights1!f5555!$-88888rvctj|j}|s|t t |S)z(:class:`basestring`) The text placement gravity used when annotating with text. It's a string from :const:`GRAVITY_TYPES` list. It also can be set. )rDrawGetGravityrhrr r)ri gravity_indexs rlgravityzDrawing.gravitysC .t}==  #  " " "M-0111rvctjtd|tj|jt|dS)Nzwand.drawing.GRAVITY_TYPES)r)rrrrDrawSetGravityrhrrirs rlrzDrawing.gravitysO!-">*/ 1 1 1 1 t}m.A.A%.H.HIIIIIrvc4tj|jS)ai(:class:`~numbers.Real`) returns the opacity used when drawing with the fill or stroke color or texture. Fully opaque is 1.0. This method only affects vector graphics, and is experimental. To set the opacity of a drawing, use :attr:`Drawing.fill_opacity` & :attr:`Drawing.stroke_opacity` .. versionadded:: 0.4.0 )rDrawGetOpacityrhrs rlrzDrawing.opacitys%dm444rvcdtj|tj|j|dS)N)r)rrrDrawSetOpacityrh)riopaques rlrzDrawing.opacitys1v....t}f55555rvcRtj|j}t|S)aX(:class:`bool`) Controls whether stroked outlines are antialiased. Stroked outlines are antialiased by default. When antialiasing is disabled stroked pixels are thresholded to determine if the stroke color or underlying canvas color should be used. It also can be set. .. versionadded:: 0.4.0 )rDrawGetStrokeAntialiasrhboolristroke_antialiass rlrzDrawing.stroke_antialiass&#9$-HH$%%%rvcdtj|tj|j|dS)N)r)r assert_boolrDrawSetStrokeAntialiasrhrs rlrzDrawing.stroke_antialiass30@AAAA&t}6FGGGGGrvctj}tj|j|t j|}tj|}|S)z(:class:`~wand.color.Color`) The current color of stroke. It also can be set. .. versionadded:: 0.3.3 )rroDrawGetStrokeColorrhrrqrrrs rl stroke_colorzDrawing.stroke_colorsL$&&"4=%888$U++(// rvct|trt|}tj||5t j|j|jddddS#1swxYwYdS)N)r)rcr rrrxrDrawSetStrokeColorrhrzs rlrzDrawing.stroke_colorr{r|ctjd}tj|jtj|g}r4fdt |jD}tj|S)at(:class:`~collections.abc.Sequence`) - (:class:`numbers.Real`) An array representing the pattern of dashes & gaps used to stroke paths. It also can be set. .. versionadded:: 0.4.0 .. versionchanged: 0.4.1 Safely release allocated memory with :c:func:`MagickRelinquishMemory` instead of :c:func:`libc.free`. rc:g|]}t|S)float).0i dash_array_ps rl z-Drawing.stroke_dash_array..s;BBB Q00BBBrv) rc_size_trDrawGetStrokeDashArrayrhrrrr)rinumber_elements dash_arrayr s @rlstroke_dash_arrayzDrawing.stroke_dash_array s!/!,,5 M6<88    HBBBB#)/*?#@#@BBBJ"9,GGLrvc|t|}tj|z|}tj|j||dSN)lenrrrDrawSetStrokeDashArrayrh)rir dash_array_lr s rlrzDrawing.stroke_dash_array$sG: ,6D &t}'3'3 5 5 5 5 5rvc4tj|jS)zm(:class:`numbers.Real`) The stroke dash offset. It also can be set. .. versionadded:: 0.4.0 )rDrawGetStrokeDashOffsetrhrs rlstroke_dash_offsetzDrawing.stroke_dash_offset,s .t}===rvcdtj|tj|j|dS)N)r)rrrDrawSetStrokeDashOffsetrh)rioffsets rlrzDrawing.stroke_dash_offset4s1&9999' v>>>>>rvctj|j}|tvr|t t|S)zh(:class:`basestring`) The stroke line cap. It also can be set. .. versionadded:: 0.4.0 )rDrawGetStrokeLineCaprhrrr )riline_cap_indexs rlstroke_line_capzDrawing.stroke_line_cap9sF !5dmDD  / /  " " "N>2333rvctjtd|tj|jt|dS)Nzwand.drawing.LINE_CAP_TYPES)r)rrrrDrawSetStrokeLineCaprhr)riline_caps rlrzDrawing.stroke_line_capDs_!."?2: < < < < $T]%3%9%9(%C%C E E E E Ervctj|j}|tvr|t t|S)zi(:class:`basestring`) The stroke line join. It also can be set. .. versionadded:: 0.4.0 )rDrawGetStrokeLineJoinrhrrr )riline_join_indexs rlstroke_line_joinzDrawing.stroke_line_joinLsF "7 FF / 1 1  " " "OO4555rvctjtd|tj|jt|dS)Nzwand.drawing.LINE_JOIN_TYPES)r&)rrrrDrawSetStrokeLineJoinrhr)ri line_joins rlr&zDrawing.stroke_line_joinWs_!/"@3< > > > > %dm&5&;&;I&F&F H H H H Hrvc4tj|jS)z{(:class:`~numbers.Integral`) The current miter limit. It also can be set. .. versionadded:: 0.4.0 )rDrawGetStrokeMiterLimitrhrs rlstroke_miter_limitzDrawing.stroke_miter_limit_s.t}===rvcdtj|tj|j|dS)N)r,)rrrDrawSetStrokeMiterLimitrh)ri miter_limits rlr,zDrawing.stroke_miter_limiths1![AAAA' {CCCCCrvc4tj|jS)zz(:class:`~numbers.Real`) The current stroke opacity. It also can be set. .. versionadded:: 0.4.0 )rDrawGetStrokeOpacityrhrs rlstroke_opacityzDrawing.stroke_opacityms+DM:::rvcdtj|tj|j|dS)N)r2)rrrDrawSetStrokeOpacityrhrs rlr2zDrawing.stroke_opacityvs1g6666$T]G<<<<)rrrrDrawSetTextAlignmentrhr)rialigns rlr>zDrawing.text_alignments`!"2"A16 8 8 8 8 $T]%5%;%;E%B%B D D D D DrvcRtj|j}t|S)z(:class:`bool`) The boolean value which represents whether antialiasing is used for text rendering. It also can be set to ``True`` or ``False`` to switch the setting. )rDrawGetTextAntialiasrhr)riresults rltext_antialiaszDrawing.text_antialiass"-dm<<F||rvcdtj|tj|j|dS)N)rE)rrrDrawSetTextAntialiasrhrs rlrEzDrawing.text_antialiass1e4444$T]E:::::rvctj|j}|s|t t |S)z(:class:`basestring`) The text decoration setting, a string from :const:`TEXT_DECORATION_TYPES` list. It also can be set. )rDrawGetTextDecorationrhrr r)ritext_decoration_indexs rltext_decorationzDrawing.text_decorationsF !( =dm L L$ #  " " ")*?@AAArvctjtd|tj|jt|dS)Nz"wand.drawing.TEXT_DECORATION_TYPES)rK)rrrrDrawSetTextDecorationrhr)ri decorations rlrKzDrawing.text_decorations`!"7"F2< > > > > %dm&;&A&A*&M&M O O O O Orvctjtdtj|j}|s|t t |S)z(:class:`basestring`) The text direction setting. a string from :const:`TEXT_DIRECTION_TYPES` list. It also can be set.NzBthe installed version of ImageMagick does not support this feature)rDrawGetTextDirectionrrhrr r)ritext_direction_indexs rltext_directionzDrawing.text_directionsh  ' /)  ';DMJJ# #  " " "()=>???rvctjtdtjt d|tj|jt |dS)NBThe installed version of ImageMagick does not support this featurez!wand.drawing.TEXT_DIRECTION_TYPES)rR) rrPrrrrDrawSetTextDirectionrhr)ri directions rlrRzDrawing.text_directions  ' /)  !"6"E1: < < < < $T]%9%?%? %J%J L L L L Lrvcd}tj|j}|r5tt j|}tj|}|S)a&(:class:`basestring`) The internally used text encoding setting. Although it also can be set, but it's not encouraged. .. versionchanged: 0.4.1 Safely release allocated memory with :c:func:`MagickRelinquishMemory` instead of :c:func:`libc.free`. N)rDrawGetTextEncodingrhr rrr)ritext_encoding_strtext_encoding_ps rl text_encodingzDrawing.text_encodingsT!!5dmDD  N $V%5o%F%F G G %<_MMO  rvc|d}n$tj|t|}tj|j|dS)Nrv)r[)rrr rDrawSetTextEncodingrh)riencodings rlr[zDrawing.text_encodingsM  HH  $8 < < < <h''H#DM8<<<<>>>+DM7CCCCCrvc4tj|jS)z^(:class:`numbers.Real`) The setting of the word spacing. It also can be set. )rDrawGetTextInterwordSpacingrhrs rltext_interword_spacingzDrawing.text_interword_spacing s 24=AAArvcdtj|tj|j|dS)N)rh)rrrDrawSetTextInterwordSpacingrhrds rlrhzDrawing.text_interword_spacings1g>>>>+DM7CCCCCrvc4tj|jS)z^(:class:`numbers.Real`) The setting of the text kerning. It also can be set. )rDrawGetTextKerningrhrs rl text_kerningzDrawing.text_kernings )$-888rvcdtj|tj|j|dS)N)rm)rrrDrawSetTextKerningrh)rikernings rlrmzDrawing.text_kerning"rrvctj}tj|j|t j|}tj|}|S)z(:class:`~wand.color.Color`) The color of a background rectangle to place under text annotations. It also can be set. )rroDrawGetTextUnderColorrhrrqrrrs rltext_under_colorzDrawing.text_under_color'sL $&&%dmU;;;$U++(// rvct|trt|}tj||5t j|j|jddddS#1swxYwYdS)N)rs)rcr rrrxrDrawSetTextUnderColorrhrzs rlrszDrawing.text_under_color3s e[ ) ) !%LLE7777  I I  )$- H H H I I I I I I I I I I I I I I I I I Ir|ctj|j}|r)tj|}tj|}nd}dt |zdzS)a(:class:`basestring`) The XML text of the Vector Graphics. It also can be set. The drawing-wand XML is experimental, and subject to change. Setting this property to None will reset all vector graphic properties to the default state. .. versionadded:: 0.4.0 .. versionchanged: 0.4.1 Safely release allocated memory with :c:func:`MagickRelinquishMemory` instead of :c:func:`libc.free`. rvzz)rDrawGetVectorGraphicsrhrrrr )rivg_pvg_strs rlvector_graphicszDrawing.vector_graphics;s[ ,T];;  %d++F1$77DDF$v,,&22rvc(|4t|tstdt|z|t j|jdSt|}t j|j|}|dkrtddS)Nzexpected a string, not rzVector graphic not understood.) rcr rerfrDrawResetVectorGraphicsrhr DrawSetVectorGraphicsr)rirzokays rlrzzDrawing.vector_graphicsSs  &z/:E0G0G &5_8M8MMNN N  $  +DM : : : : :$_55O01@BBDqyy !ABBByrvc t|tjrt|dkrt dt |D]>\}}t|t jstdt|z?t|d|d|d|d|d|d  }tj |j tj|d S) auAdjusts the current affine transformation matrix with the specified affine transformation matrix. Note that the current affine transform is adjusted rather than replaced. .. sourcecode:: text | sx rx 0 | | x', y', 1 | = | x, y, 1 | * | ry sy 0 | | tx ty 1 | :param matrix: a list of :class:`~numbers.Real` to define affine matrix ``[sx, rx, ry, sy, tx, ty]`` :type matrix: :class:`collections.abc.Sequence` .. versionadded:: 0.4.0 z*matrix must be a list of size Real numbersz$expecting numbers.Real in position #rr)sxrxrysytxtyN)rcr Sequencerr enumeratenumbersRealrerfrr DrawAffinerhrr)rimatrixidxvalamxs rlaffinezDrawing.affinebs$&#,// K3v;;!3C3CIJJ J!&)) + +HCc7<00 + F $S !*+++ +fQiF1I$QiF1I$QiF1I777 4=&,s*;*;<<<<-> @ @ @ @ @rvc t|\}}tj|j|t j|t jtdS)aoDraws a bezier curve through a set of points on the image, using the specified array of coordinates. At least four points should be given to complete a bezier path. The first & forth point being the start & end point, and the second & third point controlling the direction & curve. Example bezier on ``image`` :: with Drawing() as draw: points = [(40,10), # Start point (20,50), # First control (90,10), # Second control (70,40)] # End point draw.stroke_color = Color('#000') draw.fill_color = Color('#fff') draw.bezier(points) draw.draw(image) :param points: list of x,y tuples :type points: :class:`list` .. versionadded:: 0.4.0 N)_list_to_point_infor DrawBezierrhrcastPOINTERrripointspoints_lpoints_ps rlbezierzDrawing.beziersY6 36::84=(!;x 1J1JKK M M M M Mrvctj|||\}}|\}}tj|j||||dS)aDraws a circle from ``origin`` to ``perimeter`` :param origin: (:class:`~numbers.Real`, :class:`numbers.Real`) pair which represents origin x and y of circle :type origin: :class:`collections.abc.Sequence` :param perimeter: (:class:`~numbers.Real`, :class:`numbers.Real`) pair which represents perimeter x and y of circle :type perimeter: :class:`collections.abc.Sequence` .. versionadded:: 0.4.0 )origin perimeterN)rrr DrawCirclerh)rirrorigin_xorigin_y perimeter_x perimeter_ys rlcirclezDrawing.circlesZ $FiHHHH#(#, [4=(H&  5 5 5 5 5rvc8tj|jdSr)rClearDrawingWandrhrs rlclearz Drawing.clears /////rvc4t||S)zdCopies a drawing object. :returns: a duplication :rtype: :class:`Drawing` )rj)rdrs rlclonez Drawing.clonestDzz$''''rvrctj||tjtd|t|}t j|j|||dS)anDraws a color on the image using current fill color, starting at specified position & method. Available methods in :class:`wand.drawing.PAINT_METHOD_TYPES`: - ``'undefined'`` - ``'point'`` - ``'replace'`` - ``'floodfill'`` - ``'filltoborder'`` - ``'reset'`` .. versionadded:: 0.4.0 rrrN)rrrrrr DrawColorrhrs rlrtz Drawing.colorsq a((((!"4"C/; = = = = % %l 3 3$-Ar22222rvc|d}n$tj|t|}tj|j|dS)zAdds a comment to the vector stream. :param message: the comment to set. :type message: :class:`basestring` .. versionadded:: 0.4.0 Nrv)message)rrr r DrawCommentrh)rirs rlcommentzDrawing.commentsJ ?GG  $W 5 5 5 5WooGDM733333rvc 0tj|tj||||tjtd|t j|}t j|j||||||j | dS)aComposites an image onto the current image, using the specified composition operator, specified position, and at the specified size. :param operator: the operator that affects how the composite is applied to the image. available values can be found in the :const:`COMPOSITE_OPERATORS` list :param type: :const:`COMPOSITE_OPERATORS` :param left: the column offset of the composited drawing source :type left: :class:`numbers.Real` :param top: the row offset of the composited drawing source :type top: :class:`numbers.Real` :param width: the total columns to include in the composited source :type width: :class:`numbers.Real` :param height: the total rows to include in the composited source :type height: :class:`numbers.Real` .. versionadded:: 0.4.0 )operatorr'topr:heightz wand.drawing.COMPOSITE_OPERATORSN) rrrrrrr DrawCompositerhrkr)rirr'rr:rimagers rl compositezDrawing.composites*  (3333DcvNNNN!"5"D+3 5 5 5 5! &x 0 0dmRsE$ej 2 2 2 rvct|tstdt|zt|trt j|jj}t j |jj|j t j |jj|j }t j |jj|nt j |j|j }|s| dSdS)aRenders the current drawing into the ``image``. You can simply call :class:`Drawing` instance rather than calling this method. That means the following code which calls :class:`Drawing` object itself:: drawing(image) is equivalent to the following code which calls :meth:`draw()` method:: drawing.draw(image) :param image: the image to be drawn :type image: :class:`~wand.image.BaseImage` 3image must be a wand.image.BaseImage instance, not N)rcrrerfrrMagickGetIteratorIndex containerrkMagickSetIteratorIndexrMagickDrawImagerhr)rirpreviousress rldrawz Drawing.draw>s %++ 3$&*5kk233 3 e[ ) ) E5eo6JKKH  *5?+? M M M)%/*> NNC  *5?+? J J J J)%*dmDDC #  " " " " " # #rvc |d}tj||||\}}|\}}|\}} tj|j|||||| dS)a6Draws a ellipse at ``origin`` with independent x & y ``radius``. Ellipse can be partial by setting start & end ``rotation``. :param origin: (:class:`~numbers.Real`, :class:`numbers.Real`) pair which represents origin x and y of circle :type origin: :class:`collections.abc.Sequence` :param radius: (:class:`~numbers.Real`, :class:`numbers.Real`) pair which represents radius x and radius y of circle :type radius: :class:`collections.abc.Sequence` :param rotation: (:class:`~numbers.Real`, :class:`numbers.Real`) pair which represents start and end of ellipse. Default (0,360) :type rotation: :class:`collections.abc.Sequence` .. versionadded:: 0.4.0 N)rih)rradiusrotation)rrr DrawEllipserh) rirrrrrradius_xradius_yrotation_start rotation_ends rlellipsezDrawing.ellipse[s$  H$F6.6 8 8 8 8#(#('/$ DM$h$h*L : : : : :rvFc^t|tstdt|zt j||r t j}n t j}t|tr,|j r|j |j }nt|}||j |j|s7||t!dfdt#dD}t jt'|S)a^Queries font metrics by cloning the ``image``, and rendering the ``text`` with the font properties defined on :class:`Drawing`. This is useful for determining the size of the rendered text. Set ``multiline`` to ``True`` if the given ``text`` contains line-breaks. The return value is an instance of :class:`FontMetrics` which has the attributes of the text's rendered size, max horizontal advance, and distance of ascent & descent from the baseline. :param image: the image to be drawn :type image: :class:`~wand.image.BaseImage` :param text: the text string for get font metrics. :type text: :class:`basestring` :param multiline: text is multiline or not :type multiline: `boolean` :returns: :class:`FontMetrics` .. versionadded:: 0.3.0 r)r z(Unable to render text with current font.c g|] }| Srr)rr rDs rlr z,Drawing.get_font_metrics..s...aq ...rv )rcrrerfrrrMagickQueryMultilineFontMetricsMagickQueryFontMetricsr r[encoder rkrhrrrrr!)rirr multilinefont_metrics_fargsrDs @rlget_font_metricszDrawing.get_font_metricsys5*%++ 3$&*5kk233 3 d++++  <$DNN$;N dI & & $! $"t{4#566d|| DM4@@ I  " " "  ! ! # # #GHH H....6"::.../77D!!rvc |\}}|\}}tj|jt|t|t|t|dS)aDraws a line ``start`` to ``end``. :param start: (:class:`~numbers.Integral`, :class:`numbers.Integral`) pair which represents starting x and y of the line :type start: :class:`collections.abc.Sequence` :param end: (:class:`~numbers.Integral`, :class:`numbers.Integral`) pair which represents ending x and y of the line :type end: :class:`collections.abc.Sequence` N)rDrawLinerhint)rirrrrrrs rllinez Drawing.lines\! uWs7||USZZ 1 1 1 1 1rvc tjtdtj||tjt d|t |}tj|j|||dS)aUPaints on the image's opacity channel in order to set effected pixels to transparent. To influence the opacity of pixels. The available methods are: - ``'undefined'`` - ``'point'`` - ``'replace'`` - ``'floodfill'`` - ``'filltoborder'`` - ``'reset'`` .. note:: This method has been replace by :meth:`alpha()` in ImageMagick version 7. An :class:`AttributeError` will be raised if attempting to call on a library without ``DrawMatte`` support. .. versionadded:: 0.4.0 Nz[Method removed from ImageMagick version. Please use `wand.drawing.Drawing.alpha()' instead.rrr) r DrawMatterrrrrrrhrs rlmattez Drawing.matterrvc8tj|j|S)zAdds a path element to the current path which closes the current subpath by drawing a straight line from the current point to the current subpath's most recent starting point. .. versionadded:: 0.4.0 )r DrawPathCloserhrs rl path_closezDrawing.path_closes dm,,, rvc ||td|td|\}}|r|\}}n |\\} } \}}|r>|rtj|j||||n_tj|j||||nA|r tj|j| | ||||ntj|j| | |||||S)a4Draws a cubic Bezier curve from the current point to given ``to`` (x,y) coordinate using ``controls`` points at the beginning and the end of the curve. If ``smooth`` is set to True, only one ``controls`` is expected and the previous control is used, else two pair of coordinates are expected to define the control points. The ``to`` coordinate then becomes the new current point. :param to: (:class:`~numbers.Real`, :class:`numbers.Real`) pair which represents coordinates to draw to :type to: :class:`collections.abc.Sequence` :param controls: (:class:`~numbers.Real`, :class:`numbers.Real`) coordinate to used to influence curve :type controls: :class:`collections.abc.Sequence` :param smooth: :class:`bool` assume last defined control coordinate :type smooth: :class:`bool` :param relative: treat given coordinates as relative to current point :type relative: :class:`bool` .. versionadded:: 0.4.0 N to is missingzcontrols is missing)rerDrawPathCurveToSmoothRelativerhDrawPathCurveToSmoothAbsoluteDrawPathCurveToRelativeDrawPathCurveToAbsolute) ritocontrolssmoothrelativerGrHrErFrCrDs rl path_curvezDrawing.path_curves.. :O,, ,  122 21  *FB!) HRhr2  F D5dm68"aDDDD5dm68"aDDDD F/ 02BB1FFFF/ 02BB1FFF rvc |td|\}}|rn|r6tj|jt |t |ntj|jt |t |n|td|\}}|rRtj|jt |t |t |t |nQtj|jt |t |t |t ||S)aDraws a quadratic Bezier curve from the current point to given ``to`` coordinate. The control point is assumed to be the reflection of the control point on the previous command if ``smooth`` is True, else a pair of ``control`` coordinates must be given. Each coordinates can be relative, or absolute, to the current point by setting the ``relative`` flag. The ``to`` coordinate then becomes the new current point, and the ``control`` coordinate will be assumed when called again when ``smooth`` is set to true. :param to: (:class:`~numbers.Real`, :class:`numbers.Real`) pair which represents coordinates to draw to :type to: :class:`collections.abc.Sequence` :param control: (:class:`~numbers.Real`, :class:`numbers.Real`) coordinate to used to influence curve :type control: :class:`collections.abc.Sequence` :param smooth: assume last defined control coordinate :type smooth: :class:`bool` :param relative: treat given coordinates as relative to current point :type relative: :class:`bool` .. versionadded:: 0.4.0 Nrzcontrol is missing)rer,DrawPathCurveToQuadraticBezierSmoothRelativerhr,DrawPathCurveToQuadraticBezierSmoothAbsolute&DrawPathCurveToQuadraticBezierRelative&DrawPathCurveToQuadraticBezierAbsolute) rircontrolrrrGrHrCrDs rlpath_curve_to_quadratic_bezierz&Drawing.path_curve_to_quadratic_beziersH2 :O,, ,1  I DM588U1XXDM588U1XX 4555FB I>t}?DRyy?DRyy?DQxx?DQxx IIII >t}?DRyy?DRyy?DQxx?DQxx III  rvc P|td|td|\}}|\} } |r|tj|jt | t | t |t |t |t |t |n{tj|jt | t | t |t |t |t |t ||S)aDraws an elliptical arc from the current point to given ``to`` coordinates. The ``to`` coordinates can be relative, or absolute, to the current point by setting the ``relative`` flag. The size and orientation of the ellipse are defined by two radii (rx, ry) in ``radius`` and an ``rotation`` parameters, which indicates how the ellipse as a whole is rotated relative to the current coordinate system. The center of the ellipse is calculated automagically to satisfy the constraints imposed by the other parameters. ``large_arc`` and ``clockwise`` contribute to the automatic calculations and help determine how the arc is drawn. If ``large_arc`` is True then draw the larger of the available arcs. If ``clockwise`` is true, then draw the arc matching a clock-wise rotation. :param to: (:class:`~numbers.Real`, :class:`numbers.Real`) pair which represents coordinates to draw to :type to: :class:`collections.abc.Sequence` :param radius: (:class:`~numbers.Real`, :class:`numbers.Real`) pair which represents the radii of the ellipse to draw :type radius: :class:`collections.abc.Sequence` :param rotate: degree to rotate ellipse on x-axis :type rotate: :class:`~numbers.Real` :param large_arc: draw largest available arc :type large_arc: :class:`bool` :param clockwise: draw arc path clockwise from start to target :type clockwise: :class:`bool` :param relative: treat given coordinates as relative to current point :type relative: :class:`bool` .. versionadded:: 0.4.0 Nrzradius is missing)rerDrawPathEllipticArcRelativerhrrDrawPathEllipticArcAbsolute) rirrr large_arc clockwiserrGrHrrs rlpath_elliptic_arczDrawing.path_elliptic_arcNsD :O,, , >/00 01B  D  / 05b 59905h04Y04Y05a%((  D D D D  / 05b 59905h04Y04Y05a%((  D D D  rvc8tj|j|S)zGTerminates the current path. .. versionadded:: 0.4.0 )rDrawPathFinishrhrs rl path_finishzDrawing.path_finishs t}--- rvctj||rtj|j|ntj|j||S)a<Draws a horizontal line path from the current point to the target point. Given ``x`` parameter can be relative, or absolute, to the current point by setting the ``relative`` flag. The target point then becomes the new current point. :param x: :class:`~numbers.Real` x-axis point to draw to. :type x: :class:`~numbers.Real` :param relative: :class:`bool` treat given point as relative to current point :type relative: :class:`bool` .. versionadded:: 0.4.0 rG)rrr DrawPathLineToHorizontalRelativerh DrawPathLineToHorizontalAbsolute)rirGrs rlpath_horizontal_linezDrawing.path_horizontal_linesS ####  G  4T]A F F F F  4T]A F F F rvctj||\}}|rtj|j||ntj|j|||S)a|Draws a line path from the current point to the given ``to`` coordinate. The ``to`` coordinates can be relative, or absolute, to the current point by setting the ``relative`` flag. The coordinate then becomes the new current point. :param to: (:class:`~numbers.Real`, :class:`numbers.Real`) pair which represents coordinates to draw to. :type to: :class:`collections.abc.Sequence` :param relative: :class:`bool` treat given coordinates as relative to current point :type relative: :class:`bool` .. versionadded:: 0.4.0 r)rrrDrawPathLineToRelativerhDrawPathLineToAbsoluterirrrGrHs rl path_linezDrawing.path_lines` $++++1  @  *4=!Q ? ? ? ?  *4=!Q ? ? ? rvctj||\}}|rtj|j||ntj|j|||S)aStarts a new sub-path at the given coordinates. Given ``to`` parameter can be relative, or absolute, by setting the ``relative`` flag. :param to: (:class:`~numbers.Real`, :class:`numbers.Real`) pair which represents coordinates to draw to. :type to: :class:`collections.abc.Sequence` :param relative: :class:`bool` treat given coordinates as relative to current point :type relative: :class:`bool` .. versionadded:: 0.4.0 r)rrrDrawPathMoveToRelativerhDrawPathMoveToAbsoluters rl path_movezDrawing.path_moves` $++++1  @  *4=!Q ? ? ? ?  *4=!Q ? ? ? rvc8tj|j|S)aDeclares the start of a path drawing list which is terminated by a matching :meth:`path_finish()` command. All other `path_*` commands must be enclosed between a :meth:`path_start()` and a :meth:`path_finish()` command. This is because path drawing commands are subordinate commands and they do not function by themselves. .. versionadded:: 0.4.0 )r DrawPathStartrhrs rl path_startzDrawing.path_starts dm,,, rvctj||rtj|j|ntj|j||S)a:Draws a vertical line path from the current point to the target point. Given ``y`` parameter can be relative, or absolute, to the current point by setting the ``relative`` flag. The target point then becomes the new current point. :param y: :class:`~numbers.Real` y-axis point to draw to. :type y: :class:`~numbers.Real` :param relative: :class:`bool` treat given point as relative to current point :type relative: :class:`bool` .. versionadded:: 0.4.0 rH)rrrDrawPathLineToVerticalRelativerhDrawPathLineToVerticalAbsolute)rirHrs rlpath_vertical_linezDrawing.path_vertical_linesS ####  E  24=! D D D D  24=! D D D rvc t|\}}tj|j|t j|t jtdS)aDraws a polygon using the current :attr:`stroke_color`, :attr:`stroke_width`, and :attr:`fill_color`, using the specified array of coordinates. Example polygon on ``image`` :: with Drawing() as draw: points = [(40,10), (20,50), (90,10), (70,40)] draw.polygon(points) draw.draw(image) :param points: list of x,y tuples :type points: :class:`list` .. versionadded:: 0.4.0 N)rr DrawPolygonrhrrrrrs rlpolygonzDrawing.polygonsY& 36::8DM8"K&.2K2KLL N N N N Nrvc t|\}}tj|j|t j|t jtdS)aDraws a polyline using the current :attr:`stroke_color`, :attr:`stroke_width`, and :attr:`fill_color`, using the specified array of coordinates. Identical to :class:`~wand.drawing.Drawing.polygon`, but without closed stroke line. :param points: list of x,y tuples :type points: :class:`list` .. versionadded:: 0.4.0 N)rr DrawPolylinerhrrrrrs rlpolylinezDrawing.polylinesY 36::8T]H#[6>)3L3LMM O O O O Orvchtj||tj|j||dS)a Draws a point at given ``x`` and ``y`` :param x: :class:`~numbers.Real` x of point :type x: :class:`~numbers.Real` :param y: :class:`~numbers.Real` y of point :type y: :class:`~numbers.Real` .. versionadded:: 0.4.0 rN)rrr DrawPointrhrs rlrZz Drawing.point#s7 a(((($-A.....rvc~ttj|j}|s||S)aPop destroys the current tip of the drawing context stack, and restores the parent style context. See :meth:`push()` method for an example. .. note:: Popping the graphical context stack will not erase, or alter, any previously executed drawing commands. :returns: success of pop operation. :rtype: :class:`bool` .. versionadded:: 0.4.0 )rrPopDrawingWandrhrrioks rlpopz Drawing.pop1s= '(77 8 8 #  " " " rvc8tj|jdS)zMTerminates a clip path definition. .. versionadded:: 0.4.0 N)rDrawPopClipPathrhrs rl pop_clip_pathzDrawing.pop_clip_pathFs  .....rvc8tj|jdS)zHTerminates a definition list. .. versionadded:: 0.4.0 N)r DrawPopDefsrhrs rlpop_defszDrawing.pop_defsNs DM*****rvc8tj|jdS)zKTerminates a pattern definition. .. versionadded:: 0.4.0 N)rDrawPopPatternrhrs rl pop_patternzDrawing.pop_patternVs t}-----rvc~ttj|j}|s||S)a$Grows the current drawing context stack by one, and inherits the previous style attributes. Use :class:`Drawing.pop` to return to restore previous style attributes. This is useful for drawing shapes with different styles without repeatedly setting the similar :meth:`fill_color ` & :meth:`stroke_color ` properties. For example:: with Drawing() as ctx: ctx.fill_color = Color('GREEN') ctx.stroke_color = Color('ORANGE') ctx.push() ctx.fill_color = Color('RED') ctx.text(x1, y1, 'this is RED with ORANGE outline') ctx.push() ctx.stroke_color = Color('BLACK') ctx.text(x2, y2, 'this is RED with BLACK outline') ctx.pop() ctx.pop() ctx.text(x3, y3, 'this is GREEN with ORANGE outline') Which translate to the following MVG:: push graphic-context fill "GREEN" stroke "ORANGE" push graphic-context fill "RED" text x1,y1 "this is RED with ORANGE outline" push graphic-context stroke "BLACK" text x2,y2 "this is RED with BLACK outline" pop graphic-context pop graphic-context text x3,y3 "this is GREEN with ORANGE outline" pop graphic-context .. note:: Pushing graphical context does not reset any previously drawn artifacts. :returns: success of push operation. :rtype: :class:`bool` .. versionadded:: 0.4.0 )rrPushDrawingWandrhrr4s rlpushz Drawing.push^s>h')$-88 9 9 #  " " " rvcTtj|jt|dS)aJStarts a clip path definition which is comprised of any number of drawing commands and terminated by a :class:`Drawing.pop_clip_path` command. :param clip_mask_id: string identifier to associate with the clip path. :type clip_mask_id: :class:`basestring` .. versionadded:: 0.4.0 N)rDrawPushClipPathrhr )ri clip_mask_ids rlpush_clip_pathzDrawing.push_clip_paths'  |0D0DEEEEErvc8tj|jdS)a Indicates that commands up to a terminating :class:`Drawing.pop_defs` command create named elements (e.g. clip-paths, textures, etc.) which may safely be processed earlier for the sake of efficiency. .. versionadded:: 0.4.0 N)r DrawPushDefsrhrs rl push_defszDrawing.push_defss T]+++++rvctj|tj||||tj|jt |||||}|s|t|S)aIndicates that subsequent commands up to a :class:`Drawing.pop_pattern` command comprise the definition of a named pattern. The pattern space is assigned top left corner coordinates, a width and height, and becomes its own drawing space. Anything which can be drawn may be used in a pattern definition. Named patterns may be used as stroke or brush definitions. :param pattern_id: a unique identifier for the pattern. :type pattern_id: :class:`basestring` :param left: x ordinate of top left corner. :type left: :class:`numbers.Real` :param top: y ordinate of top left corner. :type top: :class:`numbers.Real` :param width: width of pattern space. :type width: :class:`numbers.Real` :param height: height of pattern space. :type height: :class:`numbers.Real` :returns: success of push operation :rtype: :class:`bool` .. versionadded:: 0.4.0 ) pattern_idr) rrrrDrawPushPatternrhr rr)rirKr'rr:rr~s rl push_patternzDrawing.push_patterns0  J7777DcvNNNN&t}fZ6H6H'+S',f66 #  " " "Dzzrvc |td|td||td||td||td||tdt|tjstdt |zt|tjstd t |z|9t|tjstd t |z|9t|tjstd t |z|9t|tjstd t |z|9t|tjstd t |z|+|dkrt dt |z||z}n)||kr#t d|||+|dkrt dt |z||z}n)||kr#t d||||x}} || >|d}| d} tj|| tj |j |||||| ntj |j ||||| dS)a Draws a rectangle using the current :attr:`stroke_color`, :attr:`stroke_width`, and :attr:`fill_color`. .. sourcecode:: text +--------------------------------------------------+ | ^ ^ | | | | | | top | | | | | | | v | | | <-- left --> +-------------------+ bottom | | | ^ | | | | | <-- width --|---> | | | | | height | | | | | | | | | | | v | | | | +-------------------+ v | | <--------------- right ----------> | +--------------------------------------------------+ :param left: x-offset of the rectangle to draw :type left: :class:`numbers.Real` :param top: y-offset of the rectangle to draw :type top: :class:`numbers.Real` :param right: second x-offset of the rectangle to draw. this parameter and ``width`` parameter are exclusive each other :type right: :class:`numbers.Real` :param bottom: second y-offset of the rectangle to draw. this parameter and ``height`` parameter are exclusive each other :type bottom: :class:`numbers.Real` :param width: the :attr:`width` of the rectangle to draw. this parameter and ``right`` parameter are exclusive each other :type width: :class:`numbers.Real` :param height: the :attr:`height` of the rectangle to draw. this parameter and ``bottom`` parameter are exclusive each other :type height: :class:`numbers.Real` :param radius: the corner rounding. this is a short-cut for setting both :attr:`xradius`, and :attr:`yradius` :type radius: :class:`numbers.Real` :param xradius: the :attr:`xradius` corner in horizontal direction. :type xradius: :class:`numbers.Real` :param yradius: the :attr:`yradius` corner in vertical direction. :type yradius: :class:`numbers.Real` .. versionadded:: 0.3.6 .. versionchanged:: 0.4.0 Radius keywords added to create rounded rectangle. Nzleft is missingztop is missingzright/width is missingzbottom/height is missingzFparameters right and width are exclusive each other; use one at a timezHparameters bottom and height are exclusive each other; use one at a timezleft must be numbers.Real, not ztop must be numbers.Real, not z right must be numbers.Real, not z!bottom must be numbers.Real, not z width must be numbers.Real, not z!height must be numbers.Real, not rzwidth must be positive, not z0right must be more than left ({0!r}), not {1!r})zheight must be positive, not z0bottom must be more than top ({0!r}), not {1!r})r)xradiusyradius)rercrrrfrformatrrrDrawRoundRectanglerh DrawRectangler) rir'rr)bottomr:rrrOrPs rl rectanglezDrawing.rectangles)t <-.. . [,-- - ]u}455 5 ^677 7-5=788 8.FN788 8D',// P=T JKK KC.. PeLMM M.Jvw|$D$D.?$v,,NOO O-:eW\#B#B->eLMM M.Jvw|$D$D.?$v,,NOO O =qyy !?$u++!MNNN5LEE T\\**0&u*=*=?? ? >zz !@!%f".///6\FF c\\**0&f*=*=?? ?   & &Gg  '"5  "7G D D D D  &t}dC'. 9 9 9 9  !$-sE6 J J J rvcdtj|tj|j|dS)zApplies the specified rotation to the current coordinate space. :param degree: degree to rotate :type degree: :class:`~numbers.Real` .. versionadded:: 0.4.0 )rN)rrr DrawRotaterh)rirs rlrotatezDrawing.rotateAs3 f----4=&11111rv?chtj||tj|j||dS)ak Adjusts the scaling factor to apply in the horizontal and vertical directions to the current coordinate space. :param x: Horizontal scale factor. Default `1.0` :type x: :class:`~numbers.Real` :param y: Vertical scale factor. Default `1.0` :type y: :class:`~numbers.Real` .. versionadded:: 0.4.0 rN)rrr DrawScalerhrs rlscalez Drawing.scaleMs7 a(((($-A.....rvctj||ddkrtdtj|jt ||dS)aSets the URL to use as a fill pattern for filling objects. Only local URLs ("#identifier") are supported at this time. These local URLs are normally created by defining a named fill pattern with Drawing.push_pattern & Drawing.pop_pattern. :param url: URL to use to obtain fill pattern. :type url: :class:`basestring` .. versionadded:: 0.4.0 urlr#1value not a relative URL, expecting "#identifier"N)rrrrDrawSetFillPatternURLrhr rrir_s rlset_fill_pattern_urlzDrawing.set_fill_pattern_url]so  S)))) q6S==788 8%dmVC[[AAA rvctj||ddkrtdtj|jt ||dS)aSets the pattern used for stroking object outlines. Only local URLs ("#identifier") are supported at this time. These local URLs are normally created by defining a named stroke pattern with Drawing.push_pattern & Drawing.pop_pattern. :param url: URL to use to obtain stroke pattern. :type url: :class:`basestring` .. versionadded:: 0.4.0 r^rr`raN)rrrrDrawSetStrokePatternURLrhr rrcs rlset_stroke_pattern_urlzDrawing.set_stroke_pattern_urlpso  S)))) q6S==788 8' vc{{CCC rvc|/tj|tj|j||1tj|tj|j|dSdS)aVSkews the current coordinate system in the horizontal direction if ``x`` is given, and vertical direction if ``y`` is given. :param x: Skew horizontal direction :type x: :class:`~numbers.Real` :param y: Skew vertical direction :type y: :class:`~numbers.Real` .. versionadded:: 0.4.0 Nrr&)rrr DrawSkewXrh DrawSkewYrs rlskewz Drawing.skewsm =  "Q ' ' ' '  dmQ / / / =  "Q ' ' ' '  dmQ / / / / / =rvc tj||tj||stdt |t r(|jsd|_||j}tj |}tj |j ||tj |tjtjdS)a]Writes a text ``body`` into (``x``, ``y``). :param x: the left offset where to start writing a text :type x: :class:`numbers.Integral` :param y: the baseline where to start writing text :type y: :class:`numbers.Integral` :param body: the body string to write :type body: :class:`basestring` r)bodyzbody string cannot be emptyzUTF-8N)rassert_unsigned_integerrrrcr r[rrcreate_string_bufferrDrawAnnotationrhrrc_ubyte)rirGrHrmbody_ps rlr z Drawing.texts *Q!4444 d++++ <:;; ; dI & & 3% -%,";;t122D,T22 M1a Kv~ > > ? ?     rvchtj||tj|j||dS)aUApplies a translation to the current coordinate system which moves the coordinate system origin to the specified coordinate. :param x: Skew horizontal direction :type x: :class:`~numbers.Real` :param y: Skew vertical direction :type y: :class:`~numbers.Real` .. versionadded:: 0.4.0 rN)rrr DrawTranslaterhrs rl translatezDrawing.translates7 a((((dmQ22222rvcptj||||tj|j||||dS)a)Viewbox sets the overall canvas size to be recorded with the drawing vector data. Usually this will be specified using the same size as the canvas image. When the vector data is saved to SVG or MVG formats, the viewbox is use to specify the size of the canvas image that a viewer will render the vector data on. :param left: the left most point of the viewbox. :type left: :class:`~numbers.Integral` :param top: the top most point of the viewbox. :type top: :class:`~numbers.Integral` :param right: the right most point of the viewbox. :type right: :class:`~numbers.Integral` :param bottom: the bottom most point of the viewbox. :type bottom: :class:`~numbers.Integral` .. versionadded:: 0.4.0 )r'rr)rTN)rrrDrawSetViewboxrh)rir'rr)rTs rlviewboxzDrawing.viewboxsH& !t(-f > > > >t}dCGGGGGrvc,||Sr)r)rirs rl__call__zDrawing.__call__syyrvr)NNr&)rrr&)F)NNFF)NNrFFF)NF) NNNNNNNNN)r)rYrY)NN)rr)a__name__ __module__ __qualname____doc__r IsDrawingWand c_is_resourceDestroyDrawingWandc_destroy_resourceDrawGetExceptionc_get_exceptionDrawClearExceptionc_clear_exceptionrmpropertyrusetterrrrrrrrrrrrrrrrrrrrrr&r,r2r7r>rErKrRr[rarhrmrsrzrrrrrrrrtrrrrrrrrrr rrrrr!r$r)r,r/rZr6r9r<r?rBrFrIrMrUrXr\rdrgrkr rurxrzrrvrlr r s $)M 3.O2 ! ! ! !  X FFFX"===**X*BBB**X*CCC  X DDD99X9;;; 6 6X 6BBB  X  [99[9X"AAA   X  BBB66X6555 22X2AAA..X.;;;88X8999 2 2X 2 ^JJ^J  5 5X 5 ^66^6 & &X &HHH  X FFFX.555>>X>???44X4EEE66X6HHH>>X>DDD;;X;===99X9999  < <X <DDDX;;;BBXBOOO @ @X @ L L L!!X! === B BX B"DD#"DBBXB"DD#"D99X9;;;  X III33X3. C C C===: 3 3 3 3D@@@4MMMM>555&000(((3333. 4 4 4 4>###:::::<,",",","\111" 3 3 3 3D   ////b?C>C6666p@CEJ6666p.0.   .NNNN.OOOO& / / /*///+++...777r F F F , , ,BAE@Doooob 2 2 2 2//// &&0000&   8 3 3 3 3HHH.     rvr ceZdZdZdZdS)r!a The tuple subtype which consists of font metrics data. Pixel values can be converted to points by the following: .. math:: points = \frac{pixels \ast 72}{resolution} .. py:attribute:: character_width (:class:`numbers.Real`) The horizontal value of the ``x`` in pixels. .. py:attribute:: character_height (:class:`numbers.Real`) The vertical value of the ``x`` in pixels. .. py:attribute:: ascender (:class:`numbers.Real`) The largest distance from the text baseline to the highest point above the x-height. This value should always be positive. .. py:attribute:: descender (:class:`numbers.Real`) The farthest distance from the text baseline to the lowest point below the x-height. This value should always be negative. .. py:attribute:: text_width (:class:`numbers.Real`) The full width of the text. .. py:attribute:: text_height (:class:`numbers.Real`) The full height of the text. .. py:attribute:: maximum_horizontal_advance (:class:`numbers.Real`) The largest distance from the start of one character to the start of the following character. .. py:attribute:: x1 (:class:`numbers.Real`) The horizontal value of the bounding box's starting corner. .. py:attribute:: y1 (:class:`numbers.Real`) The vertical value of the bounding box's starting corner. .. py:attribute:: x2 (:class:`numbers.Real`) The horizontal value of the bounding box's ending corner. .. py:attribute:: y2 (:class:`numbers.Real`) The vertical value of the bounding box's ending corner. .. py:attribute:: x (:class:`numbers.Real`) The horizontal value of the origin. .. py:attribute:: y (:class:`numbers.Real`) The vertical value of the origin. .. note:: When using :meth:`~wand.drawing.Drawing.get_font_metrics`, the returned attributes ``x1``, ``y1``, ``x2``, ``y2``, ``x`` and ``y`` can be ignored as they are used for internal FreeType rendering, and have no meaningful context. .. versionadded:: 0.3.0 .. versionchanged:: 0.6.8 Created sub-class of the namedtuple to improve auto-documentation. c|j|jfS)zShort-cut method for the width & height of the rendered text. :returns: (width, height) .. versionadded:: 0.6.8 )r@rArs rlrzFontMetrics.size/s 000rvN)r{r|r}r~rrrvrlr!r!s0QQd11111rvr!cHt|tstdt|zt |}d}||z}t j|z}t|D]/}||z}||z}t j|||||<0||fS)a  Helper method to convert a list of tuples to ``const * PointInfo`` :param points: a list of tuples :type points: `list` :returns: tuple of point length and c_double array :rtype: `tuple` :raises: `TypeError` .. versionadded:: 0.4.0 zpoints must be a list, not r)rclistrerfrrrr)r point_length tuple_sizepoint_info_size point_info double_index tuple_index tuple_offsets rlrr9s fd # #F5V DEEEv;;LJ"Z/O/O366J//  "j0 #j0 #)? ;  -$ $ <   * %%rv).r~ collectionsrrrapircdefs.structuresrrrtrcompatr r r r r r exceptionsrrrrrhrsequencer__all__rrrrrrrrrrrrr namedtupler!rrrvrlrs 55555555EEEEEEEEEEEEEEEE//////11111111!!!!!! =*:)G 6+$< B :;<C C C C C hC C C L:[1[1[1[1[1(+()@BB[1[1[1|&&&&&rv