B |b,@sdZddlZddlZddlZddlmZddlmZmZm Z ddl m Z ddl m Z mZmZmZmZmZddlmZdd lmZmZdd lmZdd lmZd Zd ZdZdZdZ dZ!dZ"dZ#e$de#Z%dZ&dZ'dZ(dZ)dZ*GdddeZ+ddZ,dS)z:mod:`wand.drawing` --- Drawings ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ The module provides some vector drawing functions. .. versionadded:: 0.3.0 N) assertions) AffineMatrix PointInfolibrary)Color)abcbinary string_typetext text_typexrange)WandLibraryVersionError) BaseImageCOMPOSITE_OPERATORS) SingleImage)Resource)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)Zundefined_path_unitsZ user_spaceZuser_space_on_useZobject_bounding_box) undefinedleftcenterright)r!no underlineoverlineZ line_through)r! right_to_leftZ left_to_right) ZforgetZ north_westZnorthZ north_eastZwestr#ZeastZ south_westZsouthZ south_eastZstatic)r!ZevenoddZnonzero) Zcharacter_widthZcharacter_heightZascenderZ descender text_widthZ text_heightZmaximum_horizontal_advancex1y1x2y2xyr ) r!normalZultra_condensedZextra_condensedZ condensedZsemi_condensedZ semi_expandedexpandedZextra_expandedZultra_expandedany)r!r0italicZobliquer2)r!ZbuttroundZsquare)r!Zmiterr4Zbevel)r!pointreplaceZ floodfillZ filltoborderresetc @sZeZdZdZejZejZej Z ej Z dddZ eddZejddZedd Zejd d Zed d Zejd d ZeddZejddZeddZejddZeddZejddZeddZejddZeddZejddZeddZejddZed d!Zejd"d!Zed#d$Zejd%d$Zed&d'Zejd(d'Zed)d*Zejd+d*Zed,d-Zejd.d-Zed/d0Zejd1d0Zed2d3Zejd4d3Zed5d6Z e jd7d6Z ed8d9Z!e!jd:d9Z!ed;d<Z"e"jd=d<Z"ed>d?Z#e#jd@d?Z#edAdBZ$e$jdCdBZ$edDdEZ%e%jdFdEZ%edGdHZ&e&jdIdHZ&edJdKZ'e'jdLdKZ'edMdNZ(e(jdOdNZ(edPdQZ)e)jdRdQZ)edSdTZ*e*jdUdTZ*edVdWZ+e+jdXdWZ+edYdZZ,e,jd[dZZ,ed\d]Z-e-jd^d]Z-ed_d`Z.e.jdad`Z.edbdcZ/e/jdddcZ/ededfZ0e0jdgdfZ0edhdiZ1e1jdjdiZ1edkdlZ2e2jdmdlZ2dndoZ3ddqdrZ4dsdtZ5ddudvZ6dwdxZ7dydzZ8d{d|Z9dd~dZ:dddZ;ddZdddZ?ddZ@dddZAddZBdddZCdddZDdddZEddZFdddZGdddZHdddZIddZJdddZKdddZLdddZMddZNddZOddZPddZQddZRddZSddZTddZUddZVdddZWdddZXdddZYddZZddÄZ[dddńZ\ddDŽZ]dddɄZ^dd˄Z_dd̈́Z`dS)raDrawing 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 Nc CsX|F|st}n,t|t|s8tdt|n t|j}||_WdQRXdS)Nz5drawing must be a wand.drawing.Drawing instance, not ) allocaterZNewDrawingWand isinstancetype TypeErrorreprZCloneDrawingWandresource)selfdrawingwandrAO/home/ankuromar296_gmail_com/.local/lib/python3.7/site-packages/wand/drawing.py__init__s   zDrawing.__init__cCs.t}t|j|t|}t|}|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 NewPixelWandZDrawGetBorderColorr=rfrom_pixelwandDestroyPixelWand)r>Z pixelwandcolorrArArB border_colors   zDrawing.border_colorc CsBt|trt|}tj|d|t|j|jWdQRXdS)N)rH)r9r rr assert_colorrZDrawSetBorderColorr=)r>rGrArArBrHs   cCs0d}t|j}|r,tt|}t|}|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)rZDrawGetClipPathr=r ctypes string_atMagickRelinquishMemory)r>Z clip_path_strZ clip_path_prArArB clip_paths   zDrawing.clip_pathcCs"tj|dt|jt|dS)N)rM)r assert_stringrZDrawSetClipPathr=r )r>pathrArArBrMs cCst|j}t|S)z(:class:`basestring`) The current clip rule. It also can be set. It's a string value from :const:`FILL_RULE_TYPES` list. .. versionadded:: 0.4.0 )rZDrawGetClipRuler=r)r> clip_rulerArArBrPs zDrawing.clip_rulecCs(tjtd|dt|jt|dS)Nzwand.drawing.FILL_RULE_TYPES)rP)rstring_in_listrrZDrawSetClipRuler=index)r>rPrArArBrPs cCst|j}t|S)z(:class:`basestring`) The current clip units. It also can be set. It's a string value from :const:`CLIP_PATH_UNITS` list. .. versionadded:: 0.4.0 )rZDrawGetClipUnitsr=r)r> clip_unitrArArB clip_unitss zDrawing.clip_unitscCs(tjtd|dt|jt|dS)Nzwand.drawing.CLIP_PATH_UNITS)rS)rrQrrZDrawSetClipUnitsr=rR)r>rSrArArBrTs cCs.t}t|j|t|}t|}|S)z](:class:`~wand.color.Color`) The current color to fill. It also can be set. )rrDZDrawGetFillColorr=rrErF)r>pixelrGrArArB fill_color s   zDrawing.fill_colorc CsBt|trt|}tj|d|t|j|jWdQRXdS)N)rV)r9r rrrIrZDrawSetFillColorr=)r>rGrArArBrVs   cCs t|jS)zx(:class:`~numbers.Real`) The current fill opacity. It also can be set. .. versionadded:: 0.4.0 )rZDrawGetFillOpacityr=)r>rArArB fill_opacity szDrawing.fill_opacitycCstj|dt|j|dS)N)rW)r assert_realrZDrawSetFillOpacityr=)r>opacityrArArBrW)s cCs(t|j}|tkr|tt|S)z(:class:`basestring`) The current fill rule. It can also be set. It's a string value from :const:`FILL_RULE_TYPES` list. .. versionadded:: 0.4.0 )rZDrawGetFillRuler=rraise_exceptionr )r>Zfill_rule_indexrArArB fill_rule.s zDrawing.fill_rulecCs(tjtd|dt|jt|dS)Nzwand.drawing.FILL_RULE_TYPES)r[)rrQrrZDrawSetFillRuler=rR)r>r[rArArBr[:s cCs0d}t|j}|r,tt|}t|}|S)z(:class:`basestring`) The current font name. It also can be set. .. versionchanged: 0.4.1 Safely release allocated memory with :c:func:`MagickRelinquishMemory` instead of :c:func:`libc.free`. N)rZ DrawGetFontr=r rJrKrL)r>Zfont_strZfont_prArArBfontBs   z Drawing.fontcCs"tj|dt|jt|dS)N)r\)rrNrZ DrawSetFontr=r )r>r\rArArBr\Rs cCs0d}t|j}|r,tt|}t|}|S)a (:class:`basestring`) The current font family. 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)rZDrawGetFontFamilyr=r rJrKrL)r>Zfont_family_strZ font_family_prArArB font_familyWs   zDrawing.font_familycCs"tj|dt|jt|dS)N)r])rrNrZDrawSetFontFamilyr=r )r>familyrArArBr]is cCs>tdtd}}t|jt|t||j|jfS)z(:class:`~collections.abc.Sequence`) The current font resolution. It also can be set. .. versionadded:: 0.4.0 g)rJc_doublerZDrawGetFontResolutionr=byrefvalue)r>r.r/rArArBfont_resolutionns  zDrawing.font_resolutioncCs"tj|dtj|jf|dS)N)rb)rassert_coordinaterZDrawSetFontResolutionr=)r> resolutionrArArBrb{s cCs t|jS)z;(:class:`numbers.Real`) The font size. It also can be set.)rZDrawGetFontSizer=)r>rArArB font_sizeszDrawing.font_sizecCs6tj|d|dkr$tdt|t|j|dS)N)regz!cannot be less than 0.0, but got )rrX ValueErrorr<rZDrawSetFontSizer=)r>sizerArArBres cCst|j}tt|S)z(:class:`basestring`) The current font stretch variation. It also can be set, but will only apply if the font-family or encoder supports the stretch type. .. versionadded:: 0.4.0 )rZDrawGetFontStretchr=r r)r>Z stretch_indexrArArB font_stretchs zDrawing.font_stretchcCs(tjtd|dt|jt|dS)Nzwand.drawing.STRETCH_TYPES)rh)rrQrrZDrawSetFontStretchr=rR)r>ZstretchrArArBrhs cCst|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 )rZDrawGetFontStyler=r r)r>Z style_indexrArArB font_styles zDrawing.font_stylecCs(tjtd|dt|jt|dS)Nzwand.drawing.STYLE_TYPES)ri)rrQrrZDrawSetFontStyler=rR)r>stylerArArBris cCs t|jS)z{(:class:`~numbers.Integral`) The current font weight. It also can be set. .. versionadded:: 0.4.0 )rZDrawGetFontWeightr=)r>rArArB font_weightszDrawing.font_weightcCstj|dt|j|dS)N)rk)rassert_integerrZDrawSetFontWeightr=)r>weightrArArBrks cCs$t|j}|s|tt|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. )rZDrawGetGravityr=rZr r)r>Z gravity_indexrArArBgravitys zDrawing.gravitycCs(tjtd|dt|jt|dS)Nzwand.drawing.GRAVITY_TYPES)rn)rrQrrZDrawSetGravityr=rR)r>rarArArBrnscCs t|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 )rZDrawGetOpacityr=)r>rArArBrYs zDrawing.opacitycCstj|dt|j|dS)N)rY)rrXrZDrawSetOpacityr=)r>opaquerArArBrYs cCst|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 )rZDrawGetStrokeAntialiasr=bool)r>stroke_antialiasrArArBrqs zDrawing.stroke_antialiascCstj|dt|j|dS)N)rq)r assert_boolrZDrawSetStrokeAntialiasr=)r>rqrArArBrqs cCs.t}t|j|t|}t|}|S)z(:class:`~wand.color.Color`) The current color of stroke. It also can be set. .. versionadded:: 0.3.3 )rrDZDrawGetStrokeColorr=rrErF)r>rUrGrArArB stroke_colors   zDrawing.stroke_colorc CsBt|trt|}tj|d|t|j|jWdQRXdS)N)rs)r9r rrrIrZDrawSetStrokeColorr=)r>rGrArArBrss   csLtd}t|jt|g}rHfddt|jD}t|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`. rcsg|]}t|qSrA)float).0i) dash_array_prArB !sz-Drawing.stroke_dash_array..) rJc_size_trZDrawGetStrokeDashArrayr=r`r rarL)r>Znumber_elements dash_arrayrA)rwrBstroke_dash_arrays   zDrawing.stroke_dash_arraycCs*t|}tj||}t|j||dS)N)lenrJr_rZDrawSetStrokeDashArrayr=)r>rzZ dash_array_lrwrArArBr{&s cCs t|jS)zm(:class:`numbers.Real`) The stroke dash offset. It also can be set. .. versionadded:: 0.4.0 )rZDrawGetStrokeDashOffsetr=)r>rArArBstroke_dash_offset.szDrawing.stroke_dash_offsetcCstj|dt|j|dS)N)r})rrXrZDrawSetStrokeDashOffsetr=)r>offsetrArArBr}6s cCs(t|j}|tkr|tt|S)zh(:class:`basestring`) The stroke line cap. It also can be set. .. versionadded:: 0.4.0 )rZDrawGetStrokeLineCapr=rrZr )r>Zline_cap_indexrArArBstroke_line_cap;s zDrawing.stroke_line_capcCs(tjtd|dt|jt|dS)Nzwand.drawing.LINE_CAP_TYPES)r)rrQrrZDrawSetStrokeLineCapr=rR)r>Zline_caprArArBrFs cCs(t|j}|tkr|tt|S)zi(:class:`basestring`) The stroke line join. It also can be set. .. versionadded:: 0.4.0 )rZDrawGetStrokeLineJoinr=rrZr )r>Zline_join_indexrArArBstroke_line_joinNs zDrawing.stroke_line_joincCs(tjtd|dt|jt|dS)Nzwand.drawing.LINE_JOIN_TYPES)r)rrQrrZDrawSetStrokeLineJoinr=rR)r>Z line_joinrArArBrYs cCs t|jS)z{(:class:`~numbers.Integral`) The current miter limit. It also can be set. .. versionadded:: 0.4.0 )rZDrawGetStrokeMiterLimitr=)r>rArArBstroke_miter_limitaszDrawing.stroke_miter_limitcCstj|dt|j|dS)N)r)rrlrZDrawSetStrokeMiterLimitr=)r>Z miter_limitrArArBrjs cCs t|jS)zz(:class:`~numbers.Real`) The current stroke opacity. It also can be set. .. versionadded:: 0.4.0 )rZDrawGetStrokeOpacityr=)r>rArArBstroke_opacityoszDrawing.stroke_opacitycCstj|dt|j|dS)N)r)rrXrZDrawSetStrokeOpacityr=)r>rYrArArBrxs cCs t|jS)zi(:class:`numbers.Real`) The stroke width. It also can be set. .. versionadded:: 0.3.3 )rZDrawGetStrokeWidthr=)r>rArArB stroke_width}szDrawing.stroke_widthcCs6tj|d|dkr$tdt|t|j|dS)N)rgz!cannot be less than 0.0, but got )rrXrfr<rZDrawSetStrokeWidthr=)r>widthrArArBrs cCs$t|j}|s|tt|S)z(:class:`basestring`) The current text alignment setting. It's a string value from :const:`TEXT_ALIGN_TYPES` list. It also can be set. )rZDrawGetTextAlignmentr=rZr r)r>Ztext_alignment_indexrArArBtext_alignments zDrawing.text_alignmentcCs(tjtd|dt|jt|dS)Nzwand.drawing.TEXT_ALIGN_TYPES)r)rrQrrZDrawSetTextAlignmentr=rR)r>alignrArArBrs cCst|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. )rZDrawGetTextAntialiasr=rp)r>resultrArArBtext_antialiass zDrawing.text_antialiascCstj|dt|j|dS)N)r)rrrrZDrawSetTextAntialiasr=)r>rarArArBrs cCs$t|j}|s|tt|S)z(:class:`basestring`) The text decoration setting, a string from :const:`TEXT_DECORATION_TYPES` list. It also can be set. )rZDrawGetTextDecorationr=rZr r)r>Ztext_decoration_indexrArArBtext_decorations zDrawing.text_decorationcCs(tjtd|dt|jt|dS)Nz"wand.drawing.TEXT_DECORATION_TYPES)r)rrQrrZDrawSetTextDecorationr=rR)r>Z decorationrArArBrs cCs6tjdkrtdt|j}|s*|tt|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)rDrawGetTextDirectionrr=rZr r)r>Ztext_direction_indexrArArBtext_directions  zDrawing.text_directioncCs:tjdkrtdtjtd|dt|jt|dS)NzBThe installed version of ImageMagick does not support this featurez!wand.drawing.TEXT_DIRECTION_TYPES)r) rrrrrQrZDrawSetTextDirectionr=rR)r> directionrArArBrs cCs0d}t|j}|r,tt|}t|}|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)rZDrawGetTextEncodingr=r rJrKrL)r>Ztext_encoding_strZtext_encoding_prArArB text_encodings   zDrawing.text_encodingcCs4|dkrd}ntj|dt|}t|j|dS)N)r)rrNr rZDrawSetTextEncodingr=)r>encodingrArArBrs  cCstjdkrtdt|jS)zc(:class:`numbers.Real`) The setting of the text line spacing. It also can be set. NzBThe installed version of ImageMagick does not support this feature)rZDrawGetTextInterlineSpacingrr=)r>rArArBtext_interline_spacings zDrawing.text_interline_spacingcCs0tjdkrtdtj|dt|j|dS)NzBThe installed version of ImageMagick does not support this feature)r)rZDrawSetTextInterlineSpacingrrrXr=)r>spacingrArArBrs  cCs t|jS)z^(:class:`numbers.Real`) The setting of the word spacing. It also can be set. )rZDrawGetTextInterwordSpacingr=)r>rArArBtext_interword_spacingszDrawing.text_interword_spacingcCstj|dt|j|dS)N)r)rrXrZDrawSetTextInterwordSpacingr=)r>rrArArBrs cCs t|jS)z^(:class:`numbers.Real`) The setting of the text kerning. It also can be set. )rZDrawGetTextKerningr=)r>rArArB text_kerningszDrawing.text_kerningcCstj|dt|j|dS)N)r)rrXrZDrawSetTextKerningr=)r>ZkerningrArArBr$s cCs.t}t|j|t|}t|}|S)z(:class:`~wand.color.Color`) The color of a background rectangle to place under text annotations. It also can be set. )rrDZDrawGetTextUnderColorr=rrErF)r>rUrGrArArBtext_under_color)s   zDrawing.text_under_colorc CsBt|trt|}tj|d|t|j|jWdQRXdS)N)r)r9r rrrIrZDrawSetTextUnderColorr=)r>rGrArArBr5s   cCs:t|j}|r&t|}t|}nd}dt|dS)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`. rzz)rZDrawGetVectorGraphicsr=rJrKrLr )r>Zvg_pZvg_strrArArBvector_graphics=s    zDrawing.vector_graphicscCsd|dk r$t|ts$tdt|n<|dkr:t|jn&t|}t|j|}|dkr`t ddS)Nzexpected a string, not rzVector graphic not understood.) r9r r;r<rZDrawResetVectorGraphicsr=r ZDrawSetVectorGraphicsrf)r>rokayrArArBrUs cCst|tjrt|dkr tdx0t|D]$\}}t|tjs*tdt |q*Wt |d|d|d|d|d|d d }t |j t|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)sxrxryZsyZtxtyN)r9rSequencer|rf enumeratenumbersRealr;r<rrZ DrawAffiner=rJr`)r>ZmatrixidxvalZamxrArArBaffineds  zDrawing.affiner!cCsPtjdkrtdtj||dtjtd|dt|}t|j|||dS)aJPaints 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 replaces :meth:`matte()` in ImageMagick version 7. An :class:`AttributeError` will be raised if attempting to call on a library without ``DrawAlpha`` support. .. versionadded:: 0.5.0 Nz[Method added with ImageMagick version 7. Please use `wand.drawing.Drawing.matte()' instead.)r.r/zwand.drawing.PAINT_METHOD_TYPES) paint_method) rZ DrawAlphaAttributeErrorrrXrQrrRr=)r>r.r/roprArArBalphas  z Drawing.alphac Cs\tj|||d|\}}|\}}|\}} t|jt|t|t|t|t|t| dS)aDraws a arc using the current :attr:`stroke_color`, :attr:`stroke_width`, and :attr:`fill_color`. :param start: (:class:`~numbers.Real`, :class:`numbers.Real`) pair which represents starting x and y of the arc :type start: :class:`~collections.abc.Sequence` :param end: (:class:`~numbers.Real`, :class:`numbers.Real`) pair which represents ending x and y of the arc :type end: :class:`~collections.abc.Sequence` :param degree: (:class:`~numbers.Real`, :class:`numbers.Real`) pair which represents starting degree, and ending degree :type degree: :class:`~collections.abc.Sequence` .. versionadded:: 0.4.0 )startenddegreeN)rrcrZDrawArcr=rt) r>rrrstart_xstart_yend_xend_yZ degree_startZ degree_endrArArBarcs  z Drawing.arcc Cs.t|\}}t|j|t|ttdS)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_inforZ DrawBezierr=rJcastPOINTERr)r>pointspoints_lpoints_prArArBbeziers  zDrawing.beziercCs6tj||d|\}}|\}}t|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)rrcrZ DrawCircler=)r>rrorigin_xorigin_yZ perimeter_xZ perimeter_yrArArBcircles  zDrawing.circlecCst|jdS)N)rZClearDrawingWandr=)r>rArArBclearsz Drawing.clearcCst||dS)zdCopies a drawing object. :returns: a duplication :rtype: :class:`Drawing` )r?)r:)r>rArArBclonesz Drawing.clonecCs>tj||dtjtd|dt|}t|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 )r.r/zwand.drawing.PAINT_METHOD_TYPES)rN)rrXrQrrRrZ DrawColorr=)r>r.r/rrrArArBrGs  z Drawing.colorcCs4|dkrd}ntj|dt|}t|j|dS)zAdds a comment to the vector stream. :param message: the comment to set. :type message: :class:`basestring` .. versionadded:: 0.4.0 Nr)message)rrNr rZ DrawCommentr=)r>rrArArBcomments  zDrawing.commentc Cs^tj|dtj||||dtjtd|dt|}t|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 )operator)r"toprheightz wand.drawing.COMPOSITE_OPERATORSN) rrNrXrQrrRrZ DrawCompositer=r@rZ)r>rr"rrrimagerrArArB composite!s   zDrawing.compositecCst|tstdt|t|trht|jj}t |jj|j t |jj|j }t |jj|nt |j|j }|s| dS)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` z3image must be a wand.image.BaseImage instance, not N)r9rr;r<rrZMagickGetIteratorIndex containerr@ZMagickSetIteratorIndexrRZMagickDrawImager=rZ)r>rpreviousresrArArBdraw@s   z Drawing.drawc CsP|dkr d}tj|||d|\}}|\}}|\}} t|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)rrcrZ DrawEllipser=) r>rrrrrZradius_xZradius_yZrotation_startZ rotation_endrArArBellipse]szDrawing.ellipseFcst|tstdt|tj|d|r2tj}ntj}t|t r^|j rV| |j }nt |}||j |j|s||tdfddtdD}tt|S)aQQueries font metrics from the given ``text``. :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` z3image must be a wand.image.BaseImage instance, not )r z(Unable to render text with current font.csg|] }|qSrArA)rurv)rrArBrxsz,Drawing.get_font_metrics.. )r9rr;r<rrNrZMagickQueryMultilineFontMetricsZMagickQueryFontMetricsr rencoder r@r=rZrfr rLr )r>rr multilineZfont_metrics_fargsrA)rrBget_font_metrics{s&     zDrawing.get_font_metricscCs8|\}}|\}}t|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)rZDrawLiner=int)r>rrrrrrrArArBlines  z Drawing.linecCsPtjdkrtdtj||dtjtd|dt|}t|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.)r.r/zwand.drawing.PAINT_METHOD_TYPES)r) rZ DrawMatterrrXrQrrRr=)r>r.r/rrrArArBmattes  z Drawing.mattecCst|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 )rZ DrawPathCloser=)r>rArArB path_closes zDrawing.path_closec Cs|dkrtd|dkr td|\}}|r6|\}}n|\\} } \}}|rz|rdt|j||||qt|j||||n6|rt|j| | ||||nt|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 Nz to is missingzcontrols is missing)r;rZDrawPathCurveToSmoothRelativer=ZDrawPathCurveToSmoothAbsoluteZDrawPathCurveToRelativeZDrawPathCurveToAbsolute) r>tocontrolssmoothrelativer.r/r,r-r*r+rArArB path_curves( zDrawing.path_curvec Cs|dkrtd|\}}|rT|r:t|jt|t|qt|jt|t|nf|dkrdtd|\}}|rt|jt|t|t|t|n$t|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 Nz to is missingzcontrol is missing)r;rZ,DrawPathCurveToQuadraticBezierSmoothRelativer=rtZ,DrawPathCurveToQuadraticBezierSmoothAbsoluteZ&DrawPathCurveToQuadraticBezierRelativeZ&DrawPathCurveToQuadraticBezierAbsolute) r>rcontrolrrr.r/r*r+rArArBpath_curve_to_quadratic_beziers0  z&Drawing.path_curve_to_quadratic_bezierc Cs|dkrtd|dkr td|\}}|\} } |rlt|jt| t| t|t|t|t|t|n6t|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 Nz to is missingzradius is missing)r;rZDrawPathEllipticArcRelativer=rtrpZDrawPathEllipticArcAbsolute) r>rrrZ large_arcZ clockwiserr.r/rrrArArBpath_elliptic_arcFs("  zDrawing.path_elliptic_arccCst|j|S)zGTerminates the current path. .. versionadded:: 0.4.0 )rZDrawPathFinishr=)r>rArArB path_finish~s zDrawing.path_finishcCs2tj|d|r t|j|nt|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 )r.)rrXrZ DrawPathLineToHorizontalRelativer=Z DrawPathLineToHorizontalAbsolute)r>r.rrArArBpath_horizontal_lines  zDrawing.path_horizontal_linecCs>tj|d|\}}|r*t|j||nt|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)rrcrZDrawPathLineToRelativer=ZDrawPathLineToAbsolute)r>rrr.r/rArArB path_lines  zDrawing.path_linecCs>tj|d|\}}|r*t|j||nt|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)rrcrZDrawPathMoveToRelativer=ZDrawPathMoveToAbsolute)r>rrr.r/rArArB path_moves  zDrawing.path_movecCst|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 )rZ DrawPathStartr=)r>rArArB path_starts zDrawing.path_startcCs2tj|d|r t|j|nt|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 )r/)rrXrZDrawPathLineToVerticalRelativer=ZDrawPathLineToVerticalAbsolute)r>r/rrArArBpath_vertical_lines  zDrawing.path_vertical_linec Cs.t|\}}t|j|t|ttdS)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)rrZ DrawPolygonr=rJrrr)r>rrrrArArBpolygons  zDrawing.polygonc Cs.t|\}}t|j|t|ttdS)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)rrZ DrawPolyliner=rJrrr)r>rrrrArArBpolylines  zDrawing.polylinecCs"tj||dt|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 )r.r/N)rrXrZ DrawPointr=)r>r.r/rArArBr5s z Drawing.pointcCs tt|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 )rprZPopDrawingWandr=rZ)r>okrArArBpop)sz Drawing.popcCst|jdS)zMTerminates a clip path definition. .. versionadded:: 0.4.0 N)rZDrawPopClipPathr=)r>rArArB pop_clip_path>szDrawing.pop_clip_pathcCst|jdS)zHTerminates a definition list. .. versionadded:: 0.4.0 N)rZ DrawPopDefsr=)r>rArArBpop_defsFszDrawing.pop_defscCst|jdS)zKTerminates a pattern definition. .. versionadded:: 0.4.0 N)rZDrawPopPatternr=)r>rArArB pop_patternNszDrawing.pop_patterncCs tt|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 diffrent 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 )rprZPushDrawingWandr=rZ)r>rrArArBpushVs4z Drawing.pushcCst|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)rZDrawPushClipPathr=r )r>Z clip_mask_idrArArBpush_clip_paths zDrawing.push_clip_pathcCst|jdS)aIndicates 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)rZ DrawPushDefsr=)r>rArArB push_defsszDrawing.push_defscCsLtj|dtj||||dt|jt|||||}|sD|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_id)r"rrr) rrNrXrZDrawPushPatternr=r rZrp)r>rr"rrrrrArArB push_patterns zDrawing.push_patternc Cs|dkrtdn^|dkr(tdnJ|dkrD|dkrDtdn.|dkr`|dkr`tdn|dksz|dksztdn|dks|dkstdnt|tjstdt|nt|tjstd t|n|dkst|tjstd t|n||dks t|tjs td t|nR|dksJt|tjsJtd t|n(|dksrt|tjsrtd t||dkr|dkrtdt|||}n||krtd|||dkr|dkrtdt|||}n||krtd|||dk r|}} |dk s(| dk rl|dkr6d}| dkrDd} tj|| dt |j |||||| nt |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})g)xradiusyradius)r;r9rrr<rfformatrrXrZDrawRoundRectangler=Z DrawRectanglerZ) r>r"rr$bottomrrrrrrArArB rectanglesf:                       zDrawing.rectanglecCstj|dt|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)rrXrZ DrawRotater=)r>rrArArBrotate8s zDrawing.rotate?cCs"tj||dt|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 )r.r/N)rrXrZ DrawScaler=)r>r.r/rArArBscaleDs z Drawing.scalecCs>tj|d|ddkr tdt|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#z1value not a relative URL, expecting "#identifier"N)rrNrfrZDrawSetFillPatternURLr=r rZ)r>rrArArBset_fill_pattern_urlTs  zDrawing.set_fill_pattern_urlcCs>tj|d|ddkr tdt|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 )rrrz1value not a relative URL, expecting "#identifier"N)rrNrfrZDrawSetStrokePatternURLr=r rZ)r>rrArArBset_stroke_pattern_urlgs  zDrawing.set_stroke_pattern_urlcCsH|dk r"tj|dt|j||dk rDtj|dt|j|dS)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 N)r.)r/)rrXrZ DrawSkewXr=Z DrawSkewY)r>r.r/rArArBskewzs   z Drawing.skewc Csxtj||dtj|d|s&tdt|trH|jsr.r/rZbody_prArArBr s     z Drawing.textcCs"tj||dt|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 )r.r/N)rrXrZ DrawTranslater=)r>r.r/rArArB translates zDrawing.translatecCs*tj||||dt|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$rN)rrlrZDrawSetViewboxr=)r>r"rr$rrArArBviewboxs zDrawing.viewboxcCs ||S)N)r)r>rrArArB__call__szDrawing.__call__)N)NNr!)N)rrr!)N)N)F)rrr!)NNFF)NNFF)NNrFFF)NF)NF)NF)NF)N)N) NNNNNNNNN)r)rr)NN)rr)a__name__ __module__ __qualname____doc__rZ IsDrawingWandZ c_is_resourceZDestroyDrawingWandZc_destroy_resourceZDrawGetExceptionZc_get_exceptionZDrawClearExceptionZc_clear_exceptionrCpropertyrHsetterrMrPrTrVrWr[r\r]rbrerhrirkrnrYrqrsr{r}rrrrrrrrrrrrrrrrrrrrrrrGrrrrrrrrrrrrrrrrrrrr5rrrrrrrrrrrrrrr rrrrArArArBrs                                    "     $ " 1 7 7      9  ! o   rcCszt|tstdt|t|}d}||}tj|}x6t|D]*}||}||}t|||||<qDW||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)r9listr;r<r|rJr_r )rZ point_length tuple_sizeZpoint_info_sizeZ point_infoZ double_indexZ tuple_indexZ tuple_offsetrArArBrs  r)-r  collectionsrJrrapirrrrGrcompatrr r r r r exceptionsrrrrsequencerr=r__all__rrrrrrr namedtupler rrrrrrrrArArArBsR             I