h@SSKJr SSKJrJrJrJrJr SSKJ r J r J r J r J r Jr SSKJr \(aSSKJr /SQr\"SSS 54SS jjrS r"S S 5r"SS5r"SS\5rg)) annotations) TYPE_CHECKINGSequenceIterableOptionalIterator)Vec3UVecX_AXISY_AXISZ_AXISMatrix44)RGB) BaseLayout)OCSUCS PassTroughUCScP[X#5HupEURXSU0S9 M g)Ncolor) dxfattribs)zipadd_line)layoutstartpointscolorspointrs @/var/www/html/env/lib/python3.13/site-packages/ezdxf/math/ucs.py render_axisr"s* F+ '51AB,g?c\rSrSrSr\4SSjjr\SSj5r\SSj5r \SSj5r SSjr SSjr SS jr SS jrS \"S S S 54SSjjrSrg)rz_Establish an :ref:`OCS` for a given extrusion vector. Args: extrusion: extrusion vector. c[U5R5nUR[5(+UlUR(a[ UR 5[:a4[ UR5[:a[R"U5nO[R"U5nUR5nURU5R5n[R"X4U5Ul ggN)r normalizeiscloser transformabsx _1_OVER_64yr crossrucsmatrix)self extrusionAzAxAys r!__init__ OCS.__init__#s )_ & & (ZZ// >>BDD J&SY-C\\"%\\"%B"'')B",,rr2DK r#c\UR(aURR$[$zx-axis unit vector)r*r1uxr r2s r!r;OCS.ux/"&t{{~~;V;r#c\UR(aURR$[$zy-axis unit vector)r*r1uyr r<s r!rAOCS.uy4r>r#c\UR(aURR$[$zz-axis unit vector)r*r1uzr r<s r!rEOCS.uz9r>r#ct[U5nUR(aURRU5$U$)z#Returns OCS vector for WCS `point`.)r r*r1 ocs_from_wcs)r2r p3s r!from_wcs OCS.from_wcs>s, %[ >>;;++B/ /Ir#c## [R"U5nUR(a*URRnUH nU"U5v M gUShvN gN7f)z2Returns iterable of OCS vectors from WCS `points`.N)r generater*r1rH)r2r_pointsrJr s r!points_from_wcsOCS.points_from_wcsFsH--' >>{{//H uo%!  AA!AA!cpUR(aURRU5$[U5$)z#Returns WCS vector for OCS `point`.)r*r1 ocs_to_wcsr r2r s r!to_wcs OCS.to_wcsPs( >>;;))%0 0; r#c## [R"U5nUR(a*URRnUH nU"U5v M gUShvN gN7f)z1Returns iterable of WCS vectors for OCS `points`.N)r rMr*r1rS)r2rrNrUr s r! points_to_wcsOCS.points_to_wcsWsH--' >>[[++F Um#!  rQrrrc [USUR[U-5UR[U-5UR[U-54US9 g)(Render axis as 3D lines into a `layout`.rrrrrrN)r"rUr r r r2rlengthrs r!r"OCS.render_axisasL   FVO, FVO, FVO,  r#r1r*N)r3r returnr )r r rcr )rzIterable[UVec]rcIterator[Vec3])rrr_floatrrrcNone)__name__ __module__ __qualname____firstlineno____doc__r r7propertyr;rArErJrOrUrXrr"__static_attributes__r#r!rrs*0 3<<<<<<!Ql         r#rc\rSrSrSrS)S*Sjjr\S+Sj5r\S+Sj5r\S+Sj5r \S+Sj5r \ RS,S j5r S-S jr S.S jr S/S jrS0S jrS.SjrS/SjrS0SjrS.SjrS/SjrS1SjrS1SjrS2SjrS3SjrS4SjrS4SjrS4SjrS5SjrS6SjrS7Sjr\S8Sj5r\ S9Sj5r!\ S9Sj5r"\ S9S j5r#\ S9S!j5r$\ S9S"j5r%\ S9S#j5r&S$\'"S$S%S&54S:S'jjr(S(r)g);rtaEstablish a user coordinate system (:ref:`UCS`). The UCS is defined by the origin and two unit vectors for the x-, y- or z-axis, all axis in :ref:`WCS`. The missing axis is the cross product of the given axis. If x- and y-axis are ``None``: ux = ``(1, 0, 0)``, uy = ``(0, 1, 0)``, uz = ``(0, 0, 1)``. Unit vectors don't have to be normalized, normalization is done at initialization, this is also the reason why scaling gets lost by copying or rotating. Args: origin: defines the UCS origin in world coordinates ux: defines the UCS x-axis as vector in :ref:`WCS` uy: defines the UCS y-axis as vector in :ref:`WCS` uz: defines the UCS z-axis as vector in :ref:`WCS` NcPUcUc[n[n[nGOfUc\[U5R 5n[U5R 5n[U5R U5R 5nGOUc[[U5R 5n[U5R 5n[U5R U5R 5nOUc[[U5R 5n[U5R 5n[U5R U5R 5nOK[U5R 5n[U5R 5n[U5R 5n[ R"XVU[U55Ulgr') r r r r r(r/rr0r1)r2originr;rArE_ux_uy_uzs r!r7 UCS.__init__s6 :"*CCC Zr($$&Cr($$&Cr(..$..0C Zr($$&Cr($$&Cr(..$..0C Zr($$&Cr($$&Cr(..$..0Cr($$&Cr($$&Cr($$&C ( SsDL I r#c.URR$r:)r1r;r<s r!r;UCS.ux{{~~r#c.URR$r@)r1rAr<s r!rAUCS.uyryr#c.URR$rD)r1rEr<s r!rEUCS.uzryr#c.URR$)zReturns the originr1rrr<s r!rr UCS.origins{{!!!r#c$XRlg)z Set origin.Nr)r2vs r!rrrs r#cn[URURURUR5$)zReturns a copy of this UCS.)rrrr;rArEr<s r!copyUCS.copys#4;;$''::r#c8URRU5$)z"Returns WCS point for UCS `point`.rarTs r!rU UCS.to_wcss{{$$U++r#c8URRU5$)z1Returns iterable of WCS vectors for UCS `points`.)r1transform_verticesr2rs r!rXUCS.points_to_wcss{{--f55r#c8URRU5$)zAReturns WCS direction for UCS `vector` without origin adjustment.)r1transform_directionr2vectors r!direction_to_wcsUCS.direction_to_wcss{{..v66r#c8URRU5$)z"Returns UCS point for WCS `point`.)r1ucs_vertex_from_wcsrTs r!rJ UCS.from_wcss{{..u55r#c#J# URnUH nU"U5v M g7f)z2Returns iterable of UCS vectors from WCS `points`.N)rJ)r2rrJr s r!rOUCS.points_from_wcss"==E5/ !s!#c8URRU5$)z>Returns UCS vector for WCS `vector` without origin adjustment.)r1ucs_direction_from_wcsrs r!direction_from_wcsUCS.direction_from_wcss{{11&99r#clURU5n[UR5RU5$)zeReturns OCS vector for UCS `point`. The :class:`OCS` is defined by the z-axis of the :class:`UCS`. rUrrErJ)r2r wpoints r!to_ocs UCS.to_ocss+ U#477|$$V,,r#c## URn[UR5nUHnURU"U55v M g7f)zReturns iterable of OCS vectors for UCS `points`. The :class:`OCS` is defined by the z-axis of the :class:`UCS`. Args: points: iterable of UCS vertices Nr)r2rwcsocsr s r! points_to_ocsUCS.points_to_ocss:kk$''lE,,s5z* *sAAc`UR[R"U55R$)zTransforms `angle` from current UCS to the parent coordinate system (most likely the WCS) including the transformation to the OCS established by the extrusion vector :attr:`UCS.uz`. Args: angle: in UCS in degrees )ucs_direction_to_ocs_directionr from_deg_angle angle_degr2angles r!to_ocs_angle_degUCS.to_ocs_angle_degs*22    & ) r#c`UR[R"U55R$)zTransforms `angle` from current UCS to the parent coordinate system (most likely the WCS) including the transformation to the OCS established by the extrusion vector :attr:`UCS.uz`. Args: angle: in UCS in radians )rr from_anglerrs r!to_ocs_angle_radUCS.to_ocs_angle_rads$224??53IJPPPr#ch[UR5RURU55$)zTransforms UCS `direction` vector into OCS direction vector of the parent coordinate system (most likely the WCS), target OCS is defined by the UCS z-axis. )rrErJr)r2 directions r!r"UCS.ucs_direction_to_ocs_direction s( 477|$$T%:%:9%EFFr#c[R"[U5U5nURURUR UR /5upEn[URXEUS9$)a+Returns a new rotated UCS, with the same origin as the source UCS. The rotation vector is located in the origin and has :ref:`WCS` coordinates e.g. (0, 0, 1) is the WCS z-axis as rotation vector. Args: axis: arbitrary rotation axis as vector in :ref:`WCS` angle: rotation angle in radians rrr;rArE) r axis_rotater rr;rArErrr)r2axisrtr;rArEs r!rotate UCS.rotatesT  dU 3))477DGGTWW*EF $++";;r#c[R"URU5nURURUR /5up4[ URURX4S9$)zlReturns a new rotated UCS, rotation axis is the local x-axis. Args: angle: rotation angle in radians r)rrr;rrArErrr)r2rrrArEs r!rotate_local_xUCS.rotate_local_x!sP  % 0%%tww&89$++$''b@@r#c[R"URU5nURURUR /5up4[ URX0RUS9$)zlReturns a new rotated UCS, rotation axis is the local y-axis. Args: angle: rotation angle in radians r)rrrArr;rErrr)r2rrr;rEs r!rotate_local_yUCS.rotate_local_y,sP  % 0%%tww&89$++"R@@r#c[R"URU5nURURUR /5up4[ URX4URS9$)zlReturns a new rotated UCS, rotation axis is the local z-axis. Args: angle: rotation angle in radians r)rrrErr;rArrr)r2rrr;rAs r!rotate_local_zUCS.rotate_local_z7sP  % 0%%tww&89$++"@@r#cBU=R[U5- slU$)z\Shifts current UCS by `delta` vector and returns `self`. Args: delta: shifting vector )rrr )r2deltas r!shift UCS.shiftBs tE{"  r#c&[U5UlU$)zgPlace current UCS at new origin `location` and returns `self`. Args: location: new origin in WCS )r rr)r2locations r!moveto UCS.movetoLs8n  r#c0U=RU-slU$)zGeneral inplace transformation interface, returns `self` (floating interface). Args: m: 4x4 transformation matrix (:class:`ezdxf.math.Matrix44`) )r1)r2ms r!r* UCS.transformVs q  r#c.URR$)z0Returns ``True`` if cartesian coordinate system.)r1 is_cartesianr<s r!rUCS.is_cartesianas{{'''r#cf[U5nUR[U5U- 5n[XUS9$)aKReturns a new :class:`UCS` defined by the origin, the x-axis vector and an arbitrary point in the xy-plane. Args: origin: UCS origin as (x, y, z) tuple in :ref:`WCS` axis: x-axis vector as (x, y, z) tuple in :ref:`WCS` point: arbitrary point unlike the origin in the xy-plane as (x, y, z) tuple in :ref:`WCS` rrr;rEr r/r)rrrr x_axisz_axiss r!from_x_axis_and_point_in_xyUCS.from_x_axis_and_point_in_xyf1dd5kF23&77r#cj[U5n[U5U- nURU5n[XUS9$)aKReturns a new :class:`UCS` defined by the origin, the x-axis vector and an arbitrary point in the xz-plane. Args: origin: UCS origin as (x, y, z) tuple in :ref:`WCS` axis: x-axis vector as (x, y, z) tuple in :ref:`WCS` point: arbitrary point unlike the origin in the xz-plane as (x, y, z) tuple in :ref:`WCS` rrr;rAr)rrrr r xz_vectory_axiss r!from_x_axis_and_point_in_xzUCS.from_x_axis_and_point_in_xzx6dK&( (&77r#cj[U5n[U5U- nURU5n[XUS9$)aKReturns a new :class:`UCS` defined by the origin, the y-axis vector and an arbitrary point in the xy-plane. Args: origin: UCS origin as (x, y, z) tuple in :ref:`WCS` axis: y-axis vector as (x, y, z) tuple in :ref:`WCS` point: arbitrary point unlike the origin in the xy-plane as (x, y, z) tuple in :ref:`WCS` rrrArEr)rrrr r xy_vectorrs r!from_y_axis_and_point_in_xyUCS.from_y_axis_and_point_in_xyrr#cj[U5n[U5U- nURU5n[XUS9$)aKReturns a new :class:`UCS` defined by the origin, the y-axis vector and an arbitrary point in the yz-plane. Args: origin: UCS origin as (x, y, z) tuple in :ref:`WCS` axis: y-axis vector as (x, y, z) tuple in :ref:`WCS` point: arbitrary point unlike the origin in the yz-plane as (x, y, z) tuple in :ref:`WCS` rr)rrrr r yz_vectorrs r!from_y_axis_and_point_in_yzUCS.from_y_axis_and_point_in_yzrr#cf[U5nUR[U5U- 5n[XUS9$)aKReturns a new :class:`UCS` defined by the origin, the z-axis vector and an arbitrary point in the xz-plane. Args: origin: UCS origin as (x, y, z) tuple in :ref:`WCS` axis: z-axis vector as (x, y, z) tuple in :ref:`WCS` point: arbitrary point unlike the origin in the xz-plane as (x, y, z) tuple in :ref:`WCS` rr)rrrr rrs r!from_z_axis_and_point_in_xzUCS.from_z_axis_and_point_in_xzrr#cj[U5n[U5U- nURU5n[XUS9$)aKReturns a new :class:`UCS` defined by the origin, the z-axis vector and an arbitrary point in the yz-plane. Args: origin: UCS origin as (x, y, z) tuple in :ref:`WCS` axis: z-axis vector as (x, y, z) tuple in :ref:`WCS` point: arbitrary point unlike the origin in the yz-plane as (x, y, z) tuple in :ref:`WCS` rr)rrrr rrrs r!from_z_axis_and_point_in_yzUCS.from_z_axis_and_point_in_yzrr#rrrc [UURUR[U-5UR[U-5UR[ U-54US9 g)r[r]N)r"rrrUr r r r^s r!r"UCS.render_axissP  ++ FVO, FVO, FVO,  r#r)r\NNN)rrr r;Optional[UVec]rArrErrb)rr rcrf)rcrr r rcr rzIterable[Vec3]rcrd)rr rcr rrercre)rr rcr )rr rrercr)rrercr)rr rcr)rr rcr)rrrcr)rcbool)rrr rr r r rcr)rrr_rerr)*rgrhrirjrkr7rlr;rArErrsetterrrUrXrrJrOrrrrrrrrrrrrr*r staticmethodrrrrrrrr"rmrnr#r!rrts*!!!! JJ J  J  J<"" ]];,676" :- +  QG < A A A ((88 8)-8 88"88 8)-8 88$88 8)-8 88$88 8)-8 88$88 8)-8 88"88 8)-8 88*!Ql       r#rc|^\rSrSrSrU4SjrS SjrSSjrS SjrSSjr SSjr SS jr S S jr SS jr S rU=r$)riz5UCS is equal to the WCS and OCS (extrusion = 0, 0, 1)c">[TU]5 gr')superr7)r2 __class__s r!r7PassTroughUCS.__init__s r#cU$r'rnrTs r!rUPassTroughUCS.to_wcs r#c[U5$r'iterrs r!rXPassTroughUCS.points_to_wcs F|r#cU$r'rnrTs r!rPassTroughUCS.to_ocsrr#c[U5$r'rrs r!rPassTroughUCS.points_to_ocsrr#cU$r'rnrs r!rPassTroughUCS.to_ocs_angle_degrr#cU$r'rnrs r!rPassTroughUCS.to_ocs_angle_radrr#cU$r'rnrTs r!rJPassTroughUCS.from_wcsrr#c[U5$r'rrs r!rOPassTroughUCS.points_from_wcsrr#rnrrr)rgrhrirjrkr7rUrXrrrrrJrOrm __classcell__)rs@r!rrs8?r#rN) rrrr rzSequence[UVec]rrrcrf) __future__rtypingrrrrr ezdxf.mathr r r r r r ezdxf.colorsr ezdxf.layoutsr__all__r"r-rrrrnr#r!rs#HHCC( )aA, C C C C  C  C V V rr r j Cr#