'j9IddlmZddlmZmZmZmZmZddlZddl Z ddl m Z m Z ddlmZddlmZddlmZdd lmZmZdd lmZer dd lmZdd lmZgd ZdejdzejejdzgZGddZ ddZ!ddZ"dS)) annotations) TYPE_CHECKINGIterableSequenceIteratorOptionalN)Vec2UVec) BoundingBox2d)enclosing_angles)ConstructionCircle)ConstructionRayConstructionLine)UCS)Arc) BaseLayout)ConstructionArcarc_chord_lengtharc_segment_count?g?ceZdZdZ dPdQdZedRdZedRdZedSdZedTdZ edUdZ dVdZ edWdZ dXd!Z dYd#ZdXd$ZdZd&Zd[d)Zd\d+Zd]d-ZedWd.ZedWd/Zed^d3Ze d_d`d5Ze dadbd7Ze d_dcd9Z ddded@Z dfdgdFZ dfdhdIZ dfdidKZ dfdjdMZ dkdOZ!d:S)lraPConstruction 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`` rr?v@Tcenterr radiusfloat start_angle end_angleis_counter_clockwiseOptional[bool]c|t||_||_|r||_||_dS||_||_dSN)r rrr r!)selfrrr r!r"s H/DATA/AppData/hermes/venv/lib/python3.11/site-packages/ezdxf/math/arc.py__init__zConstructionArc.__init__+sF6ll   )*D &DNNN(D (DNNNreturnr cP|jtj|j|jzS)z$start point of arc as :class:`Vec2`.)rr from_deg_angler rr&s r' start_pointzConstructionArc.start_point=s#{T01A4;OOOOr)cP|jtj|j|jzS)z"end point of arc as :class:`Vec2`.)rr r,r!rr-s r' end_pointzConstructionArc.end_pointBs"{T0MMMMr)boolc"|j|jkS)zd.?@@ D))++,,, r)numintIterable[float]c#K|dkrtd|jdz}|jdz}||kr|dz }tj|||dD] }|dzV dS)zReturns `num` angles from start- to end angle in degrees in counter-clockwise order. All angles are normalized in the range from [0, 360). znum >= 2hT)r<endpointN) ValueErrorr r!nplinspace)r&r<startstopangles r'angleszConstructionArc.anglesWs 77Z(( ('#-ns* 5== CKD[#EEE  E#+      r)cD|j}||jkr|dz }||jz S)z3Returns angle span of arc from start- to end param.r)r!r )r&ends r' angle_spanzConstructionArc.angle_spangs0^ ! ! ! 5LCT%%%r)aIterable[Vec2]c#dK|j}|j}|D]}|tj||zVdS)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,)r&rMrrrHs r'verticeszConstructionArc.verticesosP > >E4.uf=== = = = = > >r)sagittac#jKt|j}|dkr|j}|j}t j||rdS|dz}|dz}||kr|dz }t j||z }t|||}|tj |||dzEd{VdSdS)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. rNrAr ) absrr r!mathiscloseradiansrrPrDrE)r&rQrrFrGrLcounts r' flatteningzConstructionArc.flattening~s DK(( A::+E.D|E4((  SLE CKDu}}  $ TE\ : :J%fj'BBE}}R[eai%H%HII I I I I I I I I I :r)c#K|D]N}tj|}ttj| tj|fVOdS)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)rTrVr sincos)r&rMrHrs r'tangentszConstructionArc.tangentss^ 4 4E|E**A! dhqkk233 3 3 3 3 4 4r)Iterator[Vec2]c#K|j}|j}tj|j}tj|j}t D]-}t|||r|tj ||zV.dSr%) rrrTrVr r!QUARTER_ANGLESr r from_angle)r&rrrFrKrHs r'r9z ConstructionArc.main_axis_pointss{ |D$455\$.11# > >Euc22 >tuf====== > >r)dxdycB|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 )r&rbrcs r' translatezConstructionArc.translates! tB||#  r)sc@|xjt|zc_|S)zkScale arc inplace uniform about `s` in x- and y-axis, returns `self` (floating interface). )rr)r&rfs r' scale_uniformzConstructionArc.scale_uniforms uQxx  r)rHcF|xj|z c_|xj|z c_|S)zRotate arc inplace about z-axis, returns `self` (floating interface). Args: angle: rotation angle in degrees r3)r&rHs r'rotate_zzConstructionArc.rotate_zs- E! % r)c4tj|jS)z#Returns the start angle in radians.)rTrVr r-s r'start_angle_radzConstructionArc.start_angle_rads|D,---r)c4tj|jS)z!Returns the end angle in radians.)rTrVr!r-s r' end_angle_radzConstructionArc.end_angle_rads|DN+++r)r.r0tuple[Vec2, Vec2]cpt|}t|}||krtd||fS)Nz1Start- and end point have to be different points.)r rC)r.r0s r'validate_start_and_end_pointz,ConstructionArc.validate_start_and_end_pointsA;'' OO ) # #PQQ QI%%r)ccwc|||\}}tj|}|dkrtd|dur||}}|dz }||}|dz } | tj|z } | tj|z } ||d} ||z } |  | }| |z}t|| ||z j ||z j dS) 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@rfactorTrrr r!r") rqrTrVrCdistancerZtanlerp orthogonal normalizer angle_deg)clsr.r0rHrr _start_point _end_pointalpha2rx distance2rheight mid_pointdistance_vector height_vectorrs r' from_2p_anglezConstructionArc.from_2p_angles)&$'#C#C $ $  j U## A::233 3 %<<'1<*L $--l;;#c> !DHV$4$44!DHV$4$44$//,s/CC *\ 9-88::DDVLL  =0%.9!F*5!%     r)center_is_leftc|||\}}t|}|dkrtd|dur||}}||d}||} | dz } t j|dz| dzz } |||z || z} t| ||| z j || z j d 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.Frrurtr@)rrTrw) rqrrCrzrxrTsqrtr{r|rr}) r~r.r0rrrrrrrrxrrrs r'from_2p_radiuszConstructionArc.from_2p_radius s8$'#C#C $ $  jv Q;;455 5 %<<'1<*L$//,s/CC $--l;;#c>  &!)il":;; J$=#I#I$J$ $ )F  %.9!F*5!%     r) def_pointc.|||\}}t|}||ks||krtdtj|||}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 pointrw) rqr rCrfrom_3prrrr})r~r.r0rrrr6rs r'rzConstructionArc.from_3p>s("%!A!A " "  YOO  # #yI'='=TUU U#+KINNfm$$=$v-8 6)4!$     r)Nlayoutrucs Optional[UCS]rc||j|j|j|j|}||n||jS)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 )rrr r! dxfattribs)add_arcrrr r! transformmatrix)r&rrrarcs r' add_to_layoutzConstructionArc.add_to_layoutcsR nn;;(n!   ksss}}SZ'@'@@r)绽|=rayrabs_tolSequence[Vec2]ct|tsJfdj||DS)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 =========== ================================== c>g|]}||S_is_point_in_arc_range.0pointr&s r' z1ConstructionArc.intersect_ray..=   **511    r)) isinstancerr6 intersect_ray)r&rrs` r'rzConstructionArc.intersect_ray|sX,#/////    223@@    r)linerct|tsJfdj||DS)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 =========== ================================== c>g|]}||Srrrs r'rz2ConstructionArc.intersect_line..rr))rrr6intersect_line)r&rrs` r'rzConstructionArc.intersect_linesY,$ 011111    33D'BB    r)r6ct|tsJfdj||DS)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 =========== ================================== c>g|]}||Srrrs r'rz4ConstructionArc.intersect_circle..rr))rrr6intersect_circle)r&r6rs` r'rz ConstructionArc.intersect_circlesY,&"455555    55fgFF    r)othercttsJfdjj|DS)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 =========== ================================== chg|].}||,|/Srr)rrrr&s r'rz1ConstructionArc.intersect_arc..sU   **511 ,,U33     r))rrr6r)r&rrs`` r' intersect_arczConstructionArc.intersect_arcs`,%11111     55elGLL    r)rc|jdz}|jdz}||jz jdz}||kr ||kp||kS||cxko|kncS)Nr)r r!rr})r&rrFrKrHs r'rz&ConstructionArc._is_point_in_arc_rangeso'%/^e+ +6> 3;;E>1Uc\ 1$$$$$$$$$r))rrrrT) rr rrr rr!rr"r#)r*r )r*r1)r*r)r*r )r<r=r*r>)r*r)rMr>r*rN)rQrr*rN)r*r^)rbrrcrr*r)rfrr*r)rHrr*r)r.r r0r r*ro)T) r.r r0r rHrrrr1r*r)TT) r.r r0r rrrrr1rr1r*r) r.r r0r rr rrr1r*r)NN)rrrrr*r)r)rrrrr*r)rrrrr*r)r6rrrr*r)rrrrr*r)rr r*r1)"__name__ __module__ __qualname____doc__r(propertyr.r0r4r6r;rIrLrPrXr]r9rerhrjrlrn staticmethodrq classmethodrrrrrrrrrrr)r'rrsJ(  /3 )))))$PPPXPNNNXN111X1<<<X<X  &&&X& > > > >JJJJ( 4 4 4 4>>>>        ...X.,,,X,&&&\&  + + + + [+ Z # 2 2 2 2 [2 h  " " " " [" JIMAAAAA46;     <8=     <rs#"""""HHHHHHHHHHHHHH !!!!!!!!))))))&&&&&&33333333)""""""(((((( F F FTWs]DGTWs];a%a%a%a%a%a%a%a%H    r)