,h* d Z ddlmZmZmZmZ ddlmZ ddlm Z G d de Z
G d de Z G d d
e Z
G d d e Z G d
de Zy)z3Objects related to construction of freeform shapes. )absolute_importdivisionprint_functionunicode_literals)Sequence) lazypropertyc e Zd ZdZ fdZd Zd Zd Zed Z ddZ
ddZ d Z e
d
Ze
d Zd Zd
Zd Zed Ze
d Ze
d Ze
d Ze
d Zd Zd Ze
d Ze
d Z xZ S )FreeformBuilderaT Allows a freeform shape to be specified and created.
The initial pen position is provided on construction. From there, drawing
proceeds using successive calls to draw line segments. The freeform shape
may be closed by calling the :meth:`close` method.
A shape may have more than one contour, in which case overlapping areas
are "subtracted". A contour is a sequence of line segments beginning with
a "move-to" operation. A move-to operation is automatically inserted in
each new freeform; additional move-to ops can be inserted with the
`.move_to()` method.
c p t t | || _ || _ || _ || _ || _ y N)superr
__init___shapes_start_x_start_y_x_scale_y_scale)selfshapesstart_xstart_yx_scaley_scale __class__s V/var/www/html/Resume-Scraper/venv/lib/python3.12/site-packages/pptx/shapes/freeform.pyr zFreeformBuilder.__init__ s3
ot-/
c 8 | j j | S r )_drawing_operations __getitem__)r idxs r r zFreeformBuilder.__getitem__! s ''33C88r c 6 | j j S r )r __iter__r s r r" zFreeformBuilder.__iter__$ s ''0022r c 6 | j j S r )r __len__r# s r r% zFreeformBuilder.__len__' s ''//11r c b | |t t | t t | || S )zReturn a new |FreeformBuilder| object.
The initial pen location is specified (in local coordinates) by
(*start_x*, *start_y*).
intround)clsr r r r r s r newzFreeformBuilder.new* s) 63uW~.E'N0CWgVVr c b |D ] \ }}| j || |r| j | S )a Add a straight line segment to each point in *vertices*.
*vertices* must be an iterable of (x, y) pairs (2-tuples). Each x and
y value is rounded to the nearest integer before use. The optional
*close* parameter determines whether the resulting contour is
*closed* or left *open*.
Returns this |FreeformBuilder| object so it can be used in chained
calls.
)_add_line_segment
_add_close)r verticesclosexys r add_line_segmentsz!FreeformBuilder.add_line_segments3 s9 )DAq " "1a ( ) OO r c | j || }| j | }| D ] }|j | | j j | S )a Return new freeform shape positioned relative to specified offset.
*origin_x* and *origin_y* locate the origin of the local coordinate
system in slide coordinates (EMU), perhaps most conveniently by use
of a |Length| object.
Note that this method may be called more than once to add multiple
shapes of the same geometry in different locations on the slide.
)_add_freeform_sp _start_pathapply_operation_tor _shape_factory)r origin_xorigin_ysppathdrawing_operations r convert_to_shapez FreeformBuilder.convert_to_shapeD sY
"
"8X
6 #!% 7 0 0 6 7||**2..r c f | j j t j | || | S )zMove pen to (x, y) (local coordinates) without drawing line.
Returns this |FreeformBuilder| object so it can be used in chained
calls.
)r append_MoveTor+ r r1 r2 s r move_tozFreeformBuilder.move_toT s*
'' D!Q(?@ r c r | j }| D ]% }t |d st ||j }' |S )a Return x distance of shape origin from local coordinate origin.
The returned integer represents the leftmost extent of the freeform
shape, in local coordinates. Note that the bounding box of the shape
need not start at the local origin.
r1 )r hasattrminr1 )r min_xr= s r shape_offset_xz FreeformBuilder.shape_offset_x] B
!% 8 (#.E#4#6#67 8 r c r | j }| D ]% }t |d st ||j }' |S )a
Return y distance of shape origin from local coordinate origin.
The returned integer represents the topmost extent of the freeform
shape, in local coordinates. Note that the bounding box of the shape
need not start at the local origin.
r2 )r rE rF r2 )r min_yr= s r shape_offset_yz FreeformBuilder.shape_offset_yk rI r c ^ | j j t j y)z7Add a close |_Close| operation to the drawing sequence.N)r r@ _Closer+ r# s r r. zFreeformBuilder._add_closey s ''
5r c | j j }|j || j z || j z | j
| j S )zAdd a freeform `p:sp` element having no drawing elements.
*origin_x* and *origin_y* are specified in slide coordinates, and
represent the location of the local coordinates origin on the slide.
)r _spTreeadd_freeform_sp_left_top_width_height)r r9 r: spTrees r r5 z FreeformBuilder._add_freeform_sp} sI %%%% tzz !8dii#7dll
r c d | j j t j | || y)z7Add a |_LineSegment| operation to the drawing sequence.N)r r@ _LineSegmentr+ rB s r r- z!FreeformBuilder._add_line_segment s% '' (8(8q!(DEr c g S )z>Return the sequence of drawing operation objects for freeform. r# s r r z#FreeformBuilder._drawing_operations s r c | j x}}| D ]; }t |d st ||j }t ||j }= ||z
S )z9Return integer width of this shape's path in local units.r1 )r rE rF r1 max)r rG max_xr= s r _dxzFreeformBuilder._dx _
%!% 8 (#.E#4#6#67E#4#6#67 8 u} r c | j x}}| D ]; }t |d st ||j }t ||j }= ||z
S )z:Return integer height of this shape's path in local units.r2 )r rE rF r2 r\ )r rK max_yr= s r _dyzFreeformBuilder._dy r_ r c X t t | j | j z S )zReturn vertical size of this shape's path in slide coordinates.
This value is based on the actual extents of the shape and does not
include any positioning offset.
)r( r) rb r r# s r rU zFreeformBuilder._height ! 5DMM1233r c X t t | j | j z S )zReturn leftmost extent of this shape's path in slide coordinates.
Note that this value does not include any positioning offset; it
assumes the drawing (local) coordinate origin is at (0, 0) on the
slide.
)r( r) rH r r# s r rR zFreeformBuilder._left # 5,,t}}<=>>r c > || j z
|| j z
fS )a Translate local coordinates point to shape coordinates.
Shape coordinates have the same unit as local coordinates, but are
offset such that the origin of the shape coordinate system (0, 0) is
located at the top-left corner of the shape bounding box.
)rH rL )r local_xlocal_ys r _local_to_shapez FreeformBuilder._local_to_shape s% $---w9L9L/LMMr c |j | j | j } |j | j | j
| j |S )zReturn a newly created `a:path` element added to *sp*.
The returned `a:path` element has an `a:moveTo` element representing
the shape starting point as its only child.
)wh)add_pathr^ rb
add_moveTorj r r )r r; r< s r r6 zFreeformBuilder._start_path sF {{TXX{2--dmmT]]KL r c X t t | j | j z S )a Return topmost extent of this shape's path in slide coordinates.
Note that this value does not include any positioning offset; it
assumes the drawing (local) coordinate origin is located at slide
coordinates (0, 0) (top-left corner of slide).
)r( r) rL r r# s r rS zFreeformBuilder._top rf r c X t t | j | j z S )zReturn width of this shape's path in slide coordinates.
This value is based on the actual extents of the shape path and does
not include any positioning offset.
)r( r) r^ r r# s r rT zFreeformBuilder._width rd r )T)r r ) __name__
__module__ __qualname____doc__r r r" r% classmethodr+ r3 r> rC propertyrH rL r. r5 r- r r r^ rb rU rR rj r6 rS rT
__classcell__r s @r r
r
s 932 W W"/ 6
F 4 4 ? ?N ? ? 4 4r r
c H e Zd ZdZ fdZd Zed Zed Z xZ S )_BaseDrawingOperationzBase class for freeform drawing operations.
A drawing operation has at least one location (x, y) in local
coordinates.
c T t t | || _ || _ || _ y r )r
r{ r _freeform_builder_x_y)r freeform_builderr1 r2 r s r r z _BaseDrawingOperation.__init__ s'
#T35!1 r c t d )zuAdd the XML element(s) implementing this operation to *path*.
Must be implemented by each subclass.
z$must be implemented by each subclass)NotImplementedErrorr r< s r r7 z(_BaseDrawingOperation.apply_operation_to s
""HIIr c | j S )zReturn the horizontal (x) target location of this operation.
The returned value is an integer in local coordinates.
)r~ r# s r r1 z_BaseDrawingOperation.x
wwr c | j S )zReturn the vertical (y) target location of this operation.
The returned value is an integer in local coordinates.
)r r# s r r2 z_BaseDrawingOperation.y r r )
rr rs rt ru r r7 rw r1 r2 rx ry s @r r{ r{ s; J r r{ c & e Zd ZdZed Zd Zy)rN z?Specifies adding a `` element to the current contour.c | S )zReturn a new _Close object.rZ )r* s r r+ z
_Close.new s u r c " |j S )z Add `a:close` element to *path*.) add_closer s r r7 z_Close.apply_operation_to s ~~ r Nrr rs rt ru rv r+ r7 rZ r r rN rN s I r rN c & e Zd ZdZed Zd Zy)rX z@Specifies a straight line segment ending at the specified point.c ^ | |t t | t t | S )zReturn a new _LineSegment object ending at point *(x, y)*.
Both *x* and *y* are rounded to the nearest integer before use.
r' r* r r1 r2 s r r+ z_LineSegment.new $ #Sq]CaMBBr c |j | j | j j z
| j | j j
z
S )z}Add `a:lnTo` element to *path* for this line segment.
Returns the `a:lnTo` element newly added to the path.
)add_lnTor~ r} rH r rL r s r r7 z _LineSegment.apply_operation_to sE
}} GGd,,;; ; GGd,,;; ;
r Nr rZ r r rX rX s JC C
r rX c & e Zd ZdZed Zd Zy)rA z Specifies a new pen position.c ^ | |t t | t t | S )zReturn a new _MoveTo object for move to point *(x, y)*.
Both *x* and *y* are rounded to the nearest integer before use.
r' r s r r+ z _MoveTo.new* r r c |j | j | j j z
| j | j j
z
S )z7Add `a:moveTo` element to *path* for this line segment.)ro r~ r} rH r rL r s r r7 z_MoveTo.apply_operation_to2 sC GGd,,;; ; GGd,,;; ;
r Nr rZ r r rA rA ' s 'C C
r rA N)ru
__future__r r r r pptx.compatr pptx.utilr r
objectr{ rN rX rA rZ r r r sX : R R "Q4h Q4h"F "J
V
(
,
#
r