h0GddlmZddlmZmZmZmZmZddlm Z ddl m Z m Z m Z mZmZmZmZmZmZddlmZmZmZmZmZmZdgZdZd Zd Zd ZGd dZ ejBdejDdejFd ejHdiZ%ddZ&y)) annotations)OptionalIteratorIterableAnyCallable)Self) Vec3NULLVECOCSBezier3PBezier4PMatrix44has_clockwise_orientationUVec BoundingBox)CommandLineToMoveToCurve3ToCurve4To PathElementPathg{Gz?g-C6?) _vertices _start_index _commands_has_sub_paths _user_dataceZdZeZefd*dZe d+ d,dZd-dZ d.dZ d/dZ d0dZ d1dZ d2d Zd3d Zd4d ZeZed5d Zej(d6d Zed7dZej(d8dZed7dZd9dZd:dZed;dZed;dZed;dZed;dZd;dZddZ"d?dZ#d?dZ$d@dZ%d3d Z&d3d!Z'd3d"Z(dAdBd#Z)dCdDd$Z*dEd%Z+dFd&Z,dGd'Z-dHd(Z.dHd)Z/y)Irc^t|g|_g|_g|_d|_d|_y)NF)r rrrrr )selfstarts /lib/python3.12/site-packages/ezdxf/path/path.py__init__z Path.__init__,s-&*5k]')(*##Nc|}t|dk(r|S||_||_t||_t d|D|_||_|S)zECreate path instances from a list of vertices and a list of commands.rc3BK|]}|tjk(ywNrMOVE_TO.0cmds r% z2Path.from_vertices_and_commands..Cs%V cW__&< )lenrrmake_vertex_indexranyrr )clsvertices command_codes user_datanew_paths r%from_vertices_and_commandszPath.from_vertices_and_commands5sY5 x=A O%* 1- @"%%V %V"V'r'cx|j}t|j|j|_|S)zReturns a new transformed path. Args: m: transformation matrix of type :class:`~ezdxf.math.Matrix44` )clonelisttransform_verticesr)r#mr9s r% transformzPath.transformGs0::<!!"6"6t~~"FGr'c4t|jS)zoReturns the bounding box of all control vertices as :class:`~ezdxf.math.BoundingBox` instance. )rcontrol_verticesr#s r%bboxz Path.bboxRs400233r'c,t|jS)zReturns count of path elements.)r2rrCs r%__len__z Path.__len__Xs4>>""r'ct|tr td|j|}|j|}|j }|t jk(rt||S|t jk(rt||S|t jk(rt||dz||S|t jk(rt||dz||||dzStd|)zBReturns the path element at given index, slicing is not supported.zslicing not supportedrInvalid command: ) isinstanceslice TypeErrorrrrrr,rLINE_TOr CURVE3_TOr CURVE4_TOr ValueError)r#itemr/indexr6s r% __getitem__zPath.__getitem__\s dE "34 4nnT"!!$'>> '// !(5/* * '// !(5/* * '## #HUQY/%A A '## ###  ,SE233r'cRfdttjDS)Nc3(K|] }| ywr*)r.ir#s r%r0z Path.__iter__..rs>':!;<>"c%//&::::..--/!..335#22??r'c|jS)zAttach arbitrary user data to a :class:`Path` object. The user data is copied by reference, no deep copy is applied therefore a mutable state is shared between copies. r rCs r%r8zPath.user_datas r'c||_yr*rc)r#datas r%r8zPath.user_datas r'c |jdS)zc:class:`Path` start point, resetting the start point of an empty path is possible. rrrCs r%r$z Path.starts ~~a  r'cb|jr tdt||jd<y)NzRequires an empty path.r)rrPr rr#locations r%r$z Path.starts' >>67 7 $XDNN1 r'c |jdS)z:class:`Path` end point.rgrCs r%endzPath.ends~~b!!r'cH|jrt|jSgS)z6Yields all path control vertices in consecutive order.)rr=rrCs r%rBzPath.control_verticess >>' ' r'c,t|jS)z Internal API.)r=rrCs r%r7zPath.command_codessDNN##r'cf|j}t|dkDr|dj|dSy)z>Returns ``True`` if the start point is close to the end point.rrrlF)rr2isclose)r#r6s r% is_closedzPath.is_closeds5>> x=1 A;&&x|4 4r'c:tj|jvS)z3Returns ``True`` if the path has any line segments.)rrMrrCs r% has_lineszPath.has_liness$..00r'cvtj|jvxstj|jvS)z4Returns ``True`` if the path has any curve segments.)rrOrrNrCs r% has_curveszPath.has_curvess/    / V73D3D3V r'c|jS)zoReturns ``True`` if the path is a :term:`Multi-Path` object that contains multiple sub-paths. )rrCs r% has_sub_pathszPath.has_sub_pathss """r'cZ|jr tdt|jS)zReturns ``True`` if 2D path has clockwise orientation, ignores z-axis of all control vertices. Raises: TypeError: can't detect orientation of a :term:`Multi-Path` object z/can't detect orientation of a multi-path object)rxrLrrrCs r%rzPath.has_clockwise_orientations(   MN N(88r'c|j}|tjk(r|j|jy|tj k(r|j |jy|tjk(r'|j|j|jy|tjk(r2|j|j|j|jytd|)zAppend a single path element.rIN)typerrMline_tormr,move_torN curve3_toctrlrO curve4_toctrl1ctrl2rP)r#r/ts r%append_path_elementzPath.append_path_elements HH   LL ! '// ! LL ! '## # NN377CHH - '## # NN377CIIsyy 9045 5r'c|jjtj|jjt |j |j jt|y)z4Add a line from actual path end point to `location`.N)rappendrrMrr2rr ris r%r|z Path.line_tosK goo.   T^^!45 d8n-r'c|j}|st||jd<yd|_|dtj k(rD|j |jj |jj |jtj |jjt|j|jjt|y)aSStart a new sub-path at `location`. This creates a gap between the current end-point and the start-point of the new sub-path. This converts the instance into a :term:`Multi-Path` object. If the :meth:`move_to` command is the first command, the start point of the path will be reset to `location`. rNTrl) rr rrrr,poprrr2)r#rjr[s r%r}z Path.move_tos>> $XDNN1  " B<7?? * LLN NN      ! ! #(   T^^!45 d8n-r'c|jjtj|jjt |j |j jt|t|fy)uAdd a quadratic Bèzier-curve from actual path end point to `location`, `ctrl` is the control point for the quadratic Bèzier-curve. N) rrrrNrr2rextendr )r#rjrs r%r~zPath.curve3_tosX g//0   T^^!45 tDz4>:;r'c$|jjtj|jjt |j |j jt|t|t|fy)uAdd a cubic Bèzier-curve from actual path end point to `location`, `ctrl1` and `ctrl2` are the control points for the cubic Bèzier-curve. N) rrrrOrr2rrr )r#rjrrs r%rzPath.curve4_tos^ g//0   T^^!45 tE{DKhHIr'cT|js|j|jyy)z[Close path by adding a line segment from the end point to the start point. N)rrr|r$rCs r%closez Path.closes ~~ LL $r'c|jrG|j}|Jd|jj|s|j |yy|j y)zClose last sub-path by adding a line segment from the end point to the start point of the last sub-path. Behaves like :meth:`close` for :term:`Single-Path` instances. Nz2internal error: required MOVE_TO command not found)rx_start_of_last_sub_pathrmrqr|r)r# start_points r%close_sub_pathzPath.close_sub_pathsa   668K' DC D'88##K0 [)1 JJLr'ctj}|j}t|dz }|dkDr/|||k(r|j|j |S|dz}|dkDr/y)Nrr)rr,rr2rr)r#r}r[rRs r%rzPath._start_of_last_sub_path,sf//>>H !ai')~~d&7&7&>?? QJEair'c|j}|js|S|jdtjk(ro|jj |j j |j j td|jD|_|jj|j jt|j|_|S)zZReturns a new :class:`Path` with reversed commands and control vertices. rlc3BK|]}|tjk(ywr*r+r-s r%r0z Path.reversed..Gs&2@3w&.r1) r<rrr,rrrr4rreverser3)r#paths r%reversedz Path.reversed7s zz|~~K >>"  0 NN   NN      ! ! #"%&26..&#D     -dnn= r'cb|jr|jS|jS)zReturns new :class:`Path` in clockwise orientation. Raises: TypeError: can't detect orientation of a :term:`Multi-Path` object )rr<rrCs r% clockwisezPath.clockwiseOs(  ) ) +::< ==? "r'cb|jr|jS|jS)zReturns new :class:`Path` in counter-clockwise orientation. Raises: TypeError: can't detect orientation of a :term:`Multi-Path` object )rrr<rCs r%counter_clockwisezPath.counter_clockwise[s(  ) ) +==? "::< r'c@dfd }dfd }|j||S)uYApproximate path by vertices, `segments` is the count of approximation segments for each Bézier curve. Does not yield any vertices for empty paths, where only a start point is present! Approximation of :term:`Multi-Path` objects is possible, but gaps are indistinguishable from line segments. cPtt|||fjSr*)iterr approximate)p0p1p2segmentss r%curve3z Path.approximate..curve3ts$"b".::8DE Er'cRtt||||fjSr*)rrr)rrrp3rs r%curve4z Path.approximate..curve4ws'"b"b!12>>xHI Ir'rr rr rr returnIterator[Vec3] rr rr rr rr rr _approximate)r#rrrs ` r%rzPath.approximatehs$ F J  00r'cFdfd }dfd }|j||S)ugApproximate path by vertices and use adaptive recursive flattening to approximate Bèzier curves. The argument `segments` is the minimum count of approximation segments for each curve, if the distance from the center of the approximation segment to the curve is bigger than `distance` the segment will be subdivided. Does not yield any vertices for empty paths, where only a start point is present! Flattening of :term:`Multi-Path` objects is possible, but gaps are indistinguishable from line segments. Args: distance: maximum distance from the center of the curve to the center of the line segment between two approximation points to determine if a segment should be subdivided. segments: minimum segment count per Bézier curve crdk(r tdtt|||fjSNgzinvalid max distance: 0.0)rPrr flattening)rrrdistancers r%rzPath.flattening..curve3s93 #<>>"b".99(HMN Nr'ctdk(r tdtt||||fjSr)rPrrr)rrrrrrs r%rzPath.flattening..curve4s<3 #<>>"b"b!12==hQR Rr'rrr)r#rrrrs `` r%rzPath.flattening|s$* O  S   00r'c#8K|jsy|jd}||j}t|j|jD]\}}|tj k(s|tj k(r ||}|n|tjk(r+|||dz\}}||||} t| | Ed{nN|tjk(r-|||dz\} } }||| | |} t| | Ed{ntd||}y7X7w)NrrHrI) rrziprrrMr,rNnextrOrP) r#rrr$r6sir/ end_locationrptsrrs r%rzPath._approximates~~ q! >>4,,dnn=GBgoo%)?'| "")))%-b26%:"lUD,7S )))-5b26-B*ulUE5,?S  #4SE!:;; E!> s$B;D=D>?D=D>DDcPtfd|jD|_y)z;Transform path from given `ocs` to WCS coordinates inplace.c3rK|].}j|jt0yw))zN)to_wcsreplacefloat)r.v elevationocss r%r0zPath.to_wcs..s. ?M!CJJqyy5#3y4 5~s47N)r=r)r#rrs ``r%rz Path.to_wcss  ?C~~  r'c#\K|j|j}|j|_tj}|j D]T}|j |k(r2||j|j}|j|_D|j|V|yw)zYield all sub-paths as :term:`Single-Path` objects. It's safe to call :meth:`sub_paths` on any path-type: :term:`Single-Path`, :term:`Multi-Path` and :term:`Empty-Path`. )r$N) r]r$r rr,r[r{rmr)r#rr}r/s r% sub_pathszPath.sub_pathss~~DJJ~/////==?Cxx7" ~~CGG~4"&//((- # sB*B,ct|rB|j|j|jD]}|j |yy)zExtend the path by another path. The source path is automatically a :term:`Multi-Path` object, even if the previous end point matches the start point of the appended path. Ignores paths without any commands (empty paths). N)r2r}r$r[rr#rr/s r%extend_multi_pathzPath.extend_multi_paths> t9 LL $}}((-' r'c*t|dk(ry|jrA|jj|js-|j |jn|j|_|j D]}|j|y)zAppend another path to this path. Adds a :code:`self.line_to(path.start)` if the end of this path != the start of appended path. rN)r2rrmrqr$r|r[rrs r% append_pathzPath.append_pathsh t9>  >>88##DJJ/ TZZ(DJ==?C  $ $S )#r')r$rr*)r6 list[Vec3]r7z list[Command]r8rrr )r?rrr )rr)rint)rr)rzIterator[PathElement])rzlist[PathElement])rr )r<rrNone)rr)rer)rr )rjrrr)rr)r list[int])rbool)r/rrr)rjrrrrr)rjrrrrrrr)rr)rzOptional[Vec3]))rrrr)r)rrrrrr)rrrrrr)rr rrrr)rzIterator[Self])rrrr)0__name__ __module__ __qualname___slots __slots__r r& classmethodr:r@rDrFrSrYr[r`r_r<propertyr8setterr$rmrBr7rrrtrvrxrrr|r}r~rrrrrrrrrrrrrrrVr'r%rr)sI%,$RV!2?LO " 4 #4*=%+ E !!  \\// "" $11  ## 9 6. ..<J%  0 #  1(1B!4 & . *r'rHrcZt}d}g}|D]}|j||||z }|S)Nr)CMD_SIZEr)r7cmd_sizer$ start_indexcodes r%r3r3s?HEK5! $ r'N)r7zIterable[Command]rr)' __future__rtypingrrrrrtyping_extensionsr ezdxf.mathr r r r rrrrrr[rrrrrr__all__ MAX_DISTANCE MIN_SEGMENTSG1_TOLrrr,rMrNrOrr3rVr'r%rs##    (   S@*@*H OOQ OOQ q q  r'