Mi,X SrSSKJr SSKJr SSKrSSKJr SSKJ r SS K J r J r SS K JrJr \"\5r"S S \ 5r"S S\5r"SS\5r"SS\5r"SS\5r"SS\5r"SS\5rg)z entities.py -------------- Basic geometric primitives which only store references to vertex indices rather than vertices themselves. )deepcopy) getLoggerN)util)ABC) arc_centerdiscretize_arc)discretize_bezierdiscretize_bsplinec\rSrSrSSjr\S5r\S5r\RS5rS\ 4Sjr \S 5r \S 5r \S 5r \S 5rSS jrSrSrSrSrSrSrSrSrg)EntityNc [R"U[RS9UlUbX lUbX0lUbUR RU5 0UlXPl X`l gNdtype) np asanyarrayint64pointsclosedlayermetadataupdate_cachecolorkwargs)selfrrrrrrs o/var/www/eduai.edurigo.com/storigo/production/storigo_env/lib/python3.13/site-packages/trimesh/path/entities.py__init__Entity.__init__s[mmF"((;   K  J   MM  *   cJ[US5(d0UlUR$)z\ Get any metadata about the entity. Returns --------- metadata : dict Bag of properties. _metadata)hasattrr%rs r rEntity.metadata,s"t[))DN~~r#c8URRS5$)z Set the layer the entity resides on as a shortcut to putting it in the entity metadata. Returns ---------- layer : any Hashable layer identifier. r)rgetr's r r Entity.layer;s}}  ))r#c XRS'g)za Set the current layer of the entity. Returns ---------- layer : any Hashable layer indicator rN)rrvalues r rr+Hs"' gr#returnczURRURR5URS.$)z Returns a dictionary with all of the information about the entity. Returns ----------- as_dict : dict Has keys 'type', 'points', 'closed' )typerr) __class____name__rtolistrr's r to_dictEntity.to_dictTs2NN++kk((*kk  r#c~[UR5S:=(a URSURS:H$)z If the first point is the same as the end point the entity is closed Returns ----------- closed : bool Is the entity closed or not? rrlenrr's r r Entity.closedds24;;!#I A$++b/(IIr#c[R"URUR45RS5SSRS5$)a Returns an (n,2) list of nodes, or vertices on the path. Note that this generic class function assumes that all of the reference points are on the path which is true for lines and three point arcs. If you were to define another class where that wasn't the case (for example, the control points of a bezier curve), you would need to implement an entity- specific version of this function. The purpose of having a list of nodes is so that they can then be added as edges to a graph so we can use functions to check connectivity, extract paths, etc. The slicing on this function is essentially just tiling points so the first and last vertices aren't repeated. Example: self.points = [0,1,2] returns: [[0,1], [1,2]] r8rr8r)r column_stackrreshaper's r nodes Entity.nodesqs@0 OOT[[$++6 7 ? ? CAb I Q QRY Z r#c$URSS/$)a0 Returns the first and last points. Also note that if you define a new entity class where the first and last vertices in self.points aren't the endpoints of the curve you need to implement this function for your class. Returns ------------- ends : (2,) int Indices of the two end points of the entity rr8rr's r end_pointsEntity.end_pointss{{Ar7##r#cg)d Is the current entity valid. Returns ----------- valid : bool Is the current entity well formed Tr's r is_validEntity.is_validsr#c.US:aSUlgSUlg)z Reverse the current entity in place. Parameters ---------------- direction : int If positive will not touch direction If negative will reverse self.points rr8rN) _direction)r directions r reverseEntity.reverses q= DODOr#cX[US5(aURS:aUSSS2$U$)z Reverse a curve if a flag is set. Parameters -------------- curve : (n, dimension) float Curve made up of line segments in space Returns ------------ orient : (n, dimension) float Original curve, but possibly reversed rLrNr8)r&rL)rcurves r _orientEntity._orients/ 4 & &4??Q+>2;  r#c[R"XRRSS9XRR SS9/5nU$)z Return the AABB of the current entity. Parameters ----------- vertices : (n, dimension) float Vertices in space Returns ----------- bounds : (2, dimension) float Coordinates of AABB, in (min, max) form raxis)rarrayrminmax)rverticesboundss r r[ Entity.boundssK kk " & &A & .0E0I0Iq0I0Q R  r#c[R"URU5SS9S-n[R"US/URS-5S-R 5nU$)z Return the total length of the entity. Parameters -------------- vertices : (n, dimension) float Vertices in space Returns --------- length : float Total length of entity rrUrrg?)rdiffdiscretedotshapesum)rrZr^lengths r rc Entity.lengthsUwwt}}X.Q71<&&sX^^A%6673>CCE r#c$UR5/$)z Split the entity into multiple entities. Returns ------------ explode : list of Entity Current entity split into multiple entities. )copyr's r explodeEntity.explodes }r#c*[U5n[US5(aH[UR5Ul[UR5[UR5:wde[UR5[UR5:wdeU$)ze Return a copy of the current entity. Returns ------------ copied : Entity Copy of current entity r%)rr&r%idr)rcopieds r rf Entity.copysq$ 4 % %'7F f&&'2dnn+== ==&-- Bt{{O333 r#c4[UR55$)z Return a hash that represents the current entity. Returns ---------- hashed : int Hash of current class name, points, and closed )hash_bytesr's r __hash__Entity.__hash__ sDKKM""r#cNURSURS:a@URRRS5URR 5-$URRRS5URSSS2R 5-$)z Get hashable bytes that define the current entity. Returns ------------ data : bytes Hashable data defining the current entity rr8utf-8N)rr2r3encodetobytesr's r ro Entity._bytess ;;q>DKKO +>>**11':T[[=P=P=RR R>>**11':T[[2=N=V=V=XX Xr#)rrLr%rrrrr)NNNN)r8)r3 __module__ __qualname____firstlineno__r!propertyrrsetterdictr5rr@rDrIrNrRr[rcrgrfrpro__static_attributes__rHr#r rrsDH*   * * \\ ' '   J J  4 $ $    $&$ $ # Yr#rc.\rSrSrSrSSjr\S5r\RS5r\S5r \ RS5r \S 5r \ RS 5r SS jr S r S r Sr\S5r\S5r\S5r\S5rSrSrg)Texti%z# Text to annotate a 2D or 3D path. Nc XlX@lXPlX0lUbXplU bUR R U 5 XlUcSS/nO3[U[5(aXf/nO[U5S:wa [S5eX`l [US5(aURS5Ulg[U5Ulg)a An entity for text labels. Parameters -------------- origin : int Index of a single vertex for text origin text : str The text to label height : float or None The height of text vector : int or None An vertex index for which direction text is written along unitized: vector - origin normal : int or None A vertex index for the plane normal: vector is along unitized: normal - origin align : (2,) str or None Where to draw from for [horizontal, vertical]: 'center', 'left', 'right' Ncenterrzalign must be (2,) strdecoders)originvectornormalheightrrrr isinstancestrr: ValueErroralignr&rtext) rrrrrrrrrrs r r! Text.__init__*sD     J   MM  *  =x(E s # #NE Z1_56 6  4 " " G,DID DIr#c URS$)zU The origin point of the text. Returns ----------- origin : int Index of vertices rrCr's r r Text.originqs{{1~r#c[U5n[US5(a$[R"UR5S:Xa,[R "S[R S9U-UlgXRS'g)Nrrr)intr&rptpronesrr-s r rr}sRE tX&&"&&*=*B''!2884u>!  !23 3' 4::h/0  kk "iizz!}zz!}    HHJ r#cURSS:wa [S5eXRXR- n[R "USSS26nU$)z If Text is 2D, get the rotation angle in radians. Parameters ----------- vertices : (n, 2) float Vertices in space referenced by self.points Returns --------- angle : float Rotation angle in radians rrzangle only valid for 2D points!Nr8)rarrrrarctan2)rrZrMrs r r Text.anglesV >>!  !>? ?[[)H[[,AA  IddO, r#cg)NgrH)rrZs r rc Text.lengthsr#c.[R"/5$NrrW)rargsrs r r_ Text.discretesxx|r#cg)NFrHr's r r Text.closedsr#cg)NTrHr's r rI Text.is_validsr#c.[R"/5$rrr's r r@ Text.nodesxx|r#c.[R"/5$rrr's r rDText.end_pointsrr#cSRSURR5URR S5/5nU$)Nr#sTextrs)joinrrurrt)rdatas r ro Text._bytess8xx$++"5"5"79I9I'9RST r#) rrrrrrrrr)NNNNNNN)F)r3rwrxry__doc__r!rzrr{rrrrrcr_rrIr@rDror}rHr#r rr%sE"N   ]]##   ]]$$    ]]$$ @2r#rc\rSrSrSrSSjr\S5r\RS\ 4Sj5r\S5r Sr S r S \ 4S jrS rg )Lineiz A line or poly-line entity c<URXR5$)a Discretize into a world- space path. Parameters ------------ vertices: (n, dimension) float Points in space scale : float Size of overall scene for numerical comparisons Returns ------------- discrete: (m, dimension) float Path in space composed of line segments )rRrrrZscales r r_ Line.discretes ||H[[122r#c~[UR5S:=(a URSURS:H$Nrrr8r9r's r r Line.closeds04;;!#I A$++b/(IIr#r.cURSURS:HnU(a=U(d6[R"URURS/45UlgU(dU(a[R S5 ggg)Nrr8zignoring `Line.closed = False`)rr concatenatelogdebug)rr.currents r rrs`++a.DKKO3 ..$++ A7G)HIDK7 II6 7#r#cl[R"URURS- S:g5nU$)rGr)ranyr)rvalids r rI Line.is_valid%s- dkk!n4:; r#cURn[R"URUR45R 5SSR S5nUVs/sH n[ X1S9PM nnU$s snf)z If the current Line entity consists of multiple line break it up into n Line entities. Returns ---------- exploded: (n,) Line entities rr8r=)r)rrr>rravelr?r)rrriexplodeds r rg Line.explode2sk  OOT[[$++6 7 = = ?" E M Mg V 399&QD(&9:sA4cURSURS:aSURR5-$SURSSS2R5-$)Nrr8sLine)rrur's r ro Line._bytesCsS ;;q>DKKO +T[[0022 2T[[2.6688 8r#r/cdURRURR5S.$)a~ Returns a dictionary with all of the information about the Line. `closed` is not additional information for a Line like it is for Arc where the value determines if it is a partial or complete circle. Rather it is a check which indicates the first and last points are identical, and thus should not be included in the export Returns ----------- as_dict Has keys 'type', 'points' )r1r)r2r3rr4r's r r5 Line.to_dictJs+NN++kk((*  r#rCN?)r3rwrxryrr_rzrr{boolrIrgror|r5r}rHr#r rrsk3$JJ ]]8D88  "9  r#rcz\rSrSr\S5r\R S5r\S5rSrSr S Sjr Sr S r S r g ) Arci^c[USS5$)z A boolean flag for whether the arc is closed (a circle) or not. Returns ---------- closed : bool If set True, Arc will be a closed circle _closedF)getattrr's r r Arc.closed_stY..r#c$[U5Ulg)z Set the Arc to be closed or not, without changing the control points Parameters ------------ value : bool Should this Arc be a closed circle or not N)rrr-s r rrksE{ r#cZ[[R"UR55S:H$)zy Is the current Arc entity valid. Returns ----------- valid : bool Does the current Arc have exactly 3 control points r)r:runiquerr's r rI Arc.is_validxs!299T[[)*a//r#c[URSURS:5S-S- nS[UR5-URSSU2R 5-$)Nrr8rrsArc)rrbytesrru)rorders r ro Arc._bytessZDKKNT[[_459A=dkk**T[[5-A-I-I-KKKr#cUR(a1URUSSS9n[RUR-S-$URUSSS9nUR UR-S-$)z Return the arc length of the 3-point arc. Parameter ---------- vertices : (n, d) float Vertices for overall drawing. Returns ----------- length : float Length of arc. F return_normal return_angleTr)rrrpiradiusspan)rrZfits r rc Arc.lengthse ;;++he%+PC553::%) )kk(%dkKxx#**$q((r#cbUR[XRURUS95$)a Discretize the arc entity into line sections. Parameters ------------ vertices : (n, dimension) float Points in space scale : float Size of overall scene for numerical comparisons Returns ------------- discrete : (m, dimension) float Path in space made up of line segments )closer)rRr rrrs r r_ Arc.discretes,"|| 8KK0 5 Q  r#c 2[XR40UD6$)z Return the center information about the arc entity. Parameters ------------- vertices : (n, dimension) float Vertices in space Returns ------------- info : dict With keys: 'radius', 'center' )r r)rrZrs r r Arc.centers(;;/:6::r#c[R"US5(awUR(afURUSSS9n[R "URUR - URUR -/[RS9nU$URU5n[R "URSS9URSS9/[RS9nU$)z Return the AABB of the arc entity. Parameters ----------- vertices: (n, dimension) float Vertices in space Returns ----------- bounds : (2, dimension) float Coordinates of AABB in (min, max) form r=FrrrrU) ris_shaperrrrWrfloat64r_rXrY)rrZinfor[r_s r r[ Arc.boundss ==7 + + ;;xu5;QDXXt{{*DKK$++,EFbjjF }}X.HXX1%x|||';>r#rHN)r3rwrxryrrzr@r}rHr#r rrs??r#rc"\rSrSrSrSSjrSrg)Bezieriz An open or closed Bezier curve NcLUR[XRX2S95$)a# Discretize the Bezier curve. Parameters ------------- vertices : (n, 2) or (n, 3) float Points in space scale : float Scale of overall drawings (for precision) count : int Number of segments to return Returns ------------- discrete : (m, 2) or (m, 3) float Curve as line segments )countr)rRr r)rrZrr s r r_Bezier.discretes&$|| h{{35 N  r#rH)rN)r3rwrxryrr_r}rHr#r r r s  r#r c@\rSrSrSrS SjrS SjrSrS\4Sjr S r g) BSplineiz An open or closed B- Spline. Nc [R"U[RS9Ul[R"U[RS9UlUbX0lUbURRU5 0Ul X`l XPl gr) rrrrrknotsrrrrrr)rrrrrrrs r r!BSpline.__init__sbmmF"((; ]]5 ;  J   MM  *   r#cf[XRURX#S9nURU5$)a% Discretize the B-Spline curve. Parameters ------------- vertices : (n, 2) or (n, 3) float Points in space scale : float Scale of overall drawings (for precision) count : int Number of segments to return Returns ------------- discrete : (m, 2) or (m, 3) float Curve as line segments )controlrr r)r rrrR)rrZr rr_s r r_BSpline.discretes1$&[[)5 ||H%%r#c:URSURS:a8SURR5-URR5-$SURSSS2R5-URSSS2R5-$)Nrr8sBSpline)rrrur's r roBSpline._bytes5s ;;q>DKKO + 2 2 44t{{7J7J7LL L 4R4 0 8 8 ::T[[2=N=V=V=XX Xr#r/cURRURR5URR5UR S.$)zD Returns a dictionary with all of the information about the entity. )r1rrr)r2r3rr4rrr's r r5BSpline.to_dict<sB NN++kk((*ZZ&&(kk   r#)rrrrrr)NNN)Nr) r3rwrxryrr!r_ror|r5r}rHr#r rrs# &.Y    r#r)rrfrloggingrnumpyrrrarcr r rQr r r3rrrrrrr rrHr#r rs+8LYSLY^W6Wt\ 6\ ~E&EP ?F ? U 88 e8 r#