hTK(ddlmZddlmZmZmZmZmZddlZddl Z ddl m Z m Z ddlmZddlmZddlmZdd lmZmZdd lmZer dd lmZdd lmZgd Zdej<dzej<ej<dzgZGddZ ddZ!ddZ"y)) annotations) TYPE_CHECKINGIterableSequenceIteratorOptionalN)Vec2UVec) BoundingBox2d)enclosing_angles)ConstructionCircle)ConstructionRayConstructionLine)UCS)Arc) BaseLayout)ConstructionArcarc_chord_lengtharc_segment_count?g?ceZdZdZ d ddZed dZed dZed!dZed"dZ ed#dZ d$dZ ed%d Z d&d Z d'd Zd&d Zd(d Zd)dZd*dZd+dZed%dZed%dZe d,dZe d- d.dZe d/ d0dZe d- d1dZ d2 d3dZ d4 d5dZ d4 d6dZ d4 d7dZ d4 d8dZ d9dZ!y):raPConstruction tool for 2D arcs. :class:`ConstructionArc` represents a 2D arc in the xy-plane, use an :class:`UCS` to place a DXF :class:`~ezdxf.entities.Arc` entity in 3D space, see method :meth:`add_to_layout`. Implements the 2D transformation tools: :meth:`translate`, :meth:`scale_uniform` and :meth:`rotate_z` Args: center: center point as :class:`Vec2` compatible object radius: radius start_angle: start angle in degrees end_angle: end angle in degrees is_counter_clockwise: swaps start- and end angle if ``False`` cpt||_||_|r||_||_y||_||_yN)r centerradius start_angle end_angle)selfrrrris_counter_clockwises .lib/python3.12/site-packages/ezdxf/math/arc.py__init__zConstructionArc.__init__+s76l  *D &DN(D (DNcp|jtj|j|jzS)z$start point of arc as :class:`Vec2`.)rr from_deg_anglerrrs r! start_pointzConstructionArc.start_point=s*{{T001A1A4;;OOOr#cp|jtj|j|jzS)z"end point of arc as :class:`Vec2`.)rr r%rrr&s r! end_pointzConstructionArc.end_pointBs({{T00MMMr#c4|j|jkDS)z= 2hT)numendpointN) ValueErrorrrnplinspace)rr7startstopangles r!angleszConstructionArc.anglesWsl 7Z( (''#-nns* 5= CKD[[#EE#+ FsAA!c`|j}||jkr|dz }||jz S)z3Returns angle span of arc from start- to end param.v@)rr)rends r! angle_spanzConstructionArc.angle_spangs5^^ !! ! 5LCT%%%%r#c#K|j}|j}|D]}|tj||zyw)zYields vertices on arc for angles in iterable `a` in WCS as location vectors. Args: a: angles in the range from 0 to 360 in degrees, arc goes counter clockwise around the z-axis, WCS x-axis = 0 deg. N)rrr r%)rarrr>s r!verticeszConstructionArc.verticesos<E4..uf== =s<>c#xKt|j}|dkDr|j}|j}t j ||ry|dz}|dz}||kr|dz }t j ||z }t|||}|jtj|||dzEd{yy7w)zApproximate the arc by vertices in WCS, argument `sagitta` is the max. distance from the center of an arc segment to the center of its chord. rNr6r ) absrrrmathiscloseradiansrrFr:r;)rsagittarr<r=rCcounts r! flatteningzConstructionArc.flattening~s DKK( A:++E..D||E4( SLE CKDu}  $ TE\ :J%fj'BE}}R[[eai%HI I I  JsB/B:1B82B:c#K|D]M}tj|}ttj| tj|fOyw)zYields tangents on arc for angles in iterable `a` in WCS as direction vectors. Args: a: angles in the range from 0 to 360 in degrees, arc goes counter-clockwise around the z-axis, WCS x-axis = 0 deg. N)rIrKr sincos)rrEr>rs r!tangentszConstructionArc.tangentssBE||E*A! dhhqk23 3sAAc# K|j}|j}tj|j}tj|j }t D]+}t|||s|tj||z-ywr) rrrIrKrrQUARTER_ANGLESr r from_angle)rrrr<rBr>s r!r1z ConstructionArc.main_axis_pointssj{{ ||D$4$45\\$..1#Euc2tuf===$s A-B0BcD|xjt||z c_|S)zMove arc about `dx` in x-axis and about `dy` in y-axis, returns `self` (floating interface). Args: dx: translation in x-axis dy: translation in y-axis )rr )rdxdys r! translatezConstructionArc.translates tB|#  r#cB|xjt|zc_|S)zkScale arc inplace uniform about `s` in x- and y-axis, returns `self` (floating interface). )rfloat)rss r! scale_uniformzConstructionArc.scale_uniforms uQx  r#cZ|xj|z c_|xj|z c_|S)zRotate arc inplace about z-axis, returns `self` (floating interface). Args: angle: rotation angle in degrees r+)rr>s r!rotate_zzConstructionArc.rotate_zs( E! % r#c@tj|jS)z#Returns the start angle in radians.)rIrKrr&s r!start_angle_radzConstructionArc.start_angle_rads||D,,--r#c@tj|jS)z!Returns the end angle in radians.)rIrKrr&s r! end_angle_radzConstructionArc.end_angle_rads||DNN++r#cVt|}t|}||k(r td||fS)Nz1Start- and end point have to be different points.)r r9)r'r)s r!validate_start_and_end_pointz,ConstructionArc.validate_start_and_end_points6;' O ) #PQ QI%%r#c|j||\}}tj|}|dk(r td|dur||}}|dz }|j |}|dz } | tj |z } | tj |z } |j|d} ||z } | jj| }| |z}t|| ||z j||z jdS) aCreate arc from two points and enclosing angle. Additional precondition: arc goes by default in counter-clockwise orientation from `start_point` to `end_point`, can be changed by `ccw` = ``False``. Args: start_point: start point as :class:`Vec2` compatible object end_point: end point as :class:`Vec2` compatible object angle: enclosing angle in degrees ccw: counter-clockwise direction if ``True`` rzAngle can not be 0.F@rfactorTrrrrr ) rfrIrKr9distancerPtanlerp orthogonal normalizer angle_deg)clsr'r)r>ccw _start_point _end_pointalpha2rl distance2rheight mid_pointdistance_vector height_vectorrs r! from_2p_anglezConstructionArc.from_2p_angles &$'#C#C $  j U# A:23 3 %<'1<*L $--l;#c> !DHHV$44!DHHV$44$//,s/C *\ 9-88:DDVL  =0%.99!F*55!%   r#c|j||\}}t|}|dkr td|dur||}}|j|d}|j |} | dz } t j |dz| dzz } |||z j|j| z} t| ||| z j|| z jd S) aXCreate arc from two points and arc radius. Additional precondition: arc goes by default in counter-clockwise orientation from `start_point` to `end_point` can be changed by `ccw` = ``False``. The parameter `center_is_left` defines if the center of the arc is left or right of the line from `start_point` to `end_point`. Parameter `ccw` = ``False`` swaps start- and end point, which also inverts the meaning of ``center_is_left``. Args: start_point: start point as :class:`Vec2` compatible object end_point: end point as :class:`Vec2` compatible object radius: arc radius ccw: counter-clockwise direction if ``True`` center_is_left: center point of arc is left of line from start- to end point if ``True`` rzRadius has to be > 0.Frrirhr5)rsTrk) rfr\r9rnrlrIsqrtrorprrq) rrr'r)rrscenter_is_leftrtruryrlrwrxrs r!from_2p_radiuszConstructionArc.from_2p_radius s8$'#C#C $  jv Q;45 5 %<'1<*L$//,s/C $--l;#c>  &!)il":; J$=#I#I$J$ )F %.99!F*55!%   r#c,|j||\}}t|}||k(s||k(r tdtj|||}t|j }t ||j||z j||z j|S)aCreate arc from three points. Additional precondition: arc goes in counter-clockwise orientation from `start_point` to `end_point`. Args: start_point: start point as :class:`Vec2` compatible object end_point: end point as :class:`Vec2` compatible object def_point: additional definition point as :class:`Vec2` compatible object ccw: counter-clockwise direction if ``True`` z5def_point has to be different to start- and end pointrk) rfr r9rfrom_3prrrrq)rrr'r) def_pointrsr.rs r!rzConstructionArc.from_3p>s("%!A!A "  YO  #yI'=TU U#++KINfmm$==$v-88 6)44!$   r#Nc|j|j|j|j|j|}||S|j |j S)a9Add arc as DXF :class:`~ezdxf.entities.Arc` entity to a layout. Supports 3D arcs by using an :ref:`UCS`. An :class:`ConstructionArc` is always defined in the xy-plane, but by using an arbitrary UCS, the arc can be placed in 3D space, automatically OCS transformation included. Args: layout: destination layout as :class:`~ezdxf.layouts.BaseLayout` object ucs: place arc in 3D space by :class:`~ezdxf.math.UCS` object dxfattribs: additional DXF attributes for the ARC entity )rrrr dxfattribs)add_arcrrrr transformmatrix)rlayoutucsrarcs r! add_to_layoutzConstructionArc.add_to_layoutcsV nn;;;;((nn!  ks@s}}SZZ'@@r#ct|tsJ|jj||Dcgc]}|j |r|c}Scc}w)aReturns intersection points of arc and `ray` as sequence of :class:`Vec2` objects. Args: ray: intersection ray abs_tol: absolute tolerance for tests (e.g. test for tangents) Returns: tuple of :class:`Vec2` objects =========== ================================== tuple size Description =========== ================================== 0 no intersection 1 line intersects or touches the arc at one point 2 line intersects the arc at two points =========== ================================== ) isinstancerr. intersect_ray_is_point_in_arc_range)rrayabs_tolpoints r!rzConstructionArc.intersect_ray|sZ,#///223@ @**51 @   Act|tsJ|jj||Dcgc]}|j |r|c}Scc}w)aReturns intersection points of arc and `line` as sequence of :class:`Vec2` objects. Args: line: intersection line abs_tol: absolute tolerance for tests (e.g. test for tangents) Returns: tuple of :class:`Vec2` objects =========== ================================== tuple size Description =========== ================================== 0 no intersection 1 line intersects or touches the arc at one point 2 line intersects the arc at two points =========== ================================== )rrr.intersect_liner)rlinerrs r!rzConstructionArc.intersect_lines[,$ 011133D'B B**51 B   rct|tsJ|jj||Dcgc]}|j |r|c}Scc}w)aReturns intersection points of arc and `circle` as sequence of :class:`Vec2` objects. Args: circle: intersection circle abs_tol: absolute tolerance for tests Returns: tuple of :class:`Vec2` objects =========== ================================== tuple size Description =========== ================================== 0 no intersection 1 circle intersects or touches the arc at one point 2 circle intersects the arc at two points =========== ================================== )rrr.intersect_circler)rr.rrs r!rz ConstructionArc.intersect_circles[,&"455555fgF F**51 F   rct|tsJ|jj|j|Dcgc]&}|j |r|j |r|(c}Scc}w)aReturns intersection points of two arcs as sequence of :class:`Vec2` objects. Args: other: other intersection arc abs_tol: absolute tolerance for tests Returns: tuple of :class:`Vec2` objects =========== ================================== tuple size Description =========== ================================== 0 no intersection 1 other arc intersects or touches the arc at one point 2 other arc intersects the arc at two points =========== ================================== )rrr.rr)rotherrrs r! intersect_arczConstructionArc.intersect_arcsl,%11155ellGL L**51,,U3 L   s+A)c|jdz}|jdz}||jz jdz}||kDr ||k\xs||kS||cxkxr|kScS)NrA)rrrrq)rrr<rBr>s r!rz&ConstructionArc._is_point_in_arc_rangesk''%/^^e+ +66> 3;E>1Uc\ 1$$$$$r#))rrg?rAT) rr rr\rr\rr\r zOptional[bool])returnr )rbool)rr)rr )r7intrIterable[float])rr\)rErrIterable[Vec2])rLr\rr)rzIterator[Vec2])rXr\rYr\rr)r]r\rr)r>r\rr)r'r r)r rztuple[Vec2, Vec2])T) r'r r)r r>r\rsrrr)TT) r'r r)r rr\rsrrrrr) r'r r)r rr rsrrr)NN)rrrz Optional[UCS]rr)g|=)rrrr\rSequence[Vec2])rrrr\rr)r.rrr\rr)rrrr\rr)rr rr)"__name__ __module__ __qualname____doc__r"propertyr'r)r,r.r3r?rCrFrNrSr1rZr^r`rbrd staticmethodrf classmethodr|rrrrrrrrr#r!rrs(  /3 ))) )  ) - )$PPNN11<<  && >J( 4>  ..,,&&&*& &&  + + +  +  +  + + Z # 2 2 2  2  2  2  2 2 h  " " "  "  "  " " JIMA A'4A A46; " -2  <8= $ /4  <rL chord_lengthalphas r!rr s[.vw? yy!3f!<=Cyy'' ) *sAAAA)rr\rLr\rr\)rr\r>r\rLr\rr)# __future__rtypingrrrrrrInumpyr: ezdxf.mathr r r2r construct2dr r.rrrrrrezdxf.entitiesr ezdxf.layoutsr__all__pirUrrrrr#r!rso#HH !)&3"( FTWWs]DGGTWWs];a%a%H r#