^jpdZddlmZddlmZddlmZmZmZm Z m Z m Z ddl m Z ddlmZddlZddlmZmZmZdd lmZmZmZmZdd lmZdd lmZmZmZm Z m!Z!m"Z"m#Z#dd l$m%Z%m&Z&m'Z'm(Z(m)Z)m*Z*m+Z+m,Z,m-Z-Gd de)Z.Gdde.Z/Gdde.Z0Gdde.Z1Gdde.Z2Gdde.Z3Gdde.Z4Gdde.Z5Gdde.Z6Gdd e.Z7Gd!d"e.Z8Gd#d$e.Z9Gd%d&e.Z:Gd'd(e.Z;y))a Sketch Objects name: objects_sketch.py by: Gumyr date: March 22nd 2023 desc: This python module contains objects (classes) that create 2D Sketches. license: Copyright 2022 Gumyr Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at http://www.apache.org/licenses/LICENSE-2.0 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License. ) annotations)Iterable)cosdegreespiradianssintan)PathLike)castN) LocationListflatten_sequencevalidate_inputs)Align FontStyleMode TextAlign) BuildSketch) TOLERANCEAxisLocationRotationVector VectorLiketo_align_offset) CompoundEdgeFace ShapeListSketchVertexWiretopo_explore_common_vertextuplifycheZdZdZej gZddejf dfd Z xZ S)BaseSketchObjectayBaseSketchObject Base class for all BuildSketch objects Args: face (Face): face to create rotation (float, optional): angle to rotate object. Defaults to 0 align (Align | tuple[Align, Align], optional): align MIN, CENTER, or MAX of object. Defaults to None mode (Mode, optional): combination mode. Defaults to Mode.ADD rNcl|Ct|d}|jt|jj |t j |d}|@|dk7r*|jtdd|jn|j}ns||_ ||_ |dk7r|jtdd|n|}td|jD}t|t r|j|d|it|At#|j$y)NF)logrc3K|]G}tjjD]$}|tk7r|j |n|&IywN)r _get_contextlocal_locationsrmoved).0facelocations Q/opt/ringagent/.cad-venv/lib/python3.12/site-packages/build123d/objects_sketch.py z,BaseSketchObject.__init__..gsS" , 9 9 ; K K")1HJ(> 8$DH"H"sA Amode)r$mover bounding_boxrrr,r.rfacesrotationr4r isinstance_add_to_contextsuper__init__rwrapped)selfobjr8alignr4context new_faces __class__s r2r<zBaseSketchObject.__init__Ns  E1%E HHXc..0@@GH I&1&>&>t&O ?q= (1a2399;YY[ %DMDI9AQ#))HQ845CC!"IIK"I ';/'''>> ),445)r?zCompound | Facer8floatr@"Align | tuple[Align, Align] | Noner4r __name__ __module__ __qualname____doc__r_tag _applies_torADDr< __classcell__rCs@r2r&r&?sW ##$K 48XX !6 !6!62 !6  !6!6rDr&ceZdZdZej gZdejejfe jf dfd Z xZ S)CircleaSketch Object: Circle Create a circle defined by radius. Args: radius (float): circle radius arc_size (float, optional): angular size of sector. Defaults to 360. align (Align | tuple[Align, Align], optional): align MIN, CENTER, or MAX of object. Defaults to (Align.CENTER, Align.CENTER) mode (Mode, optional): combination mode. Defaults to Mode.ADD v@cztj|}t||||_||_t |d|_|dk(rttj|n:tjtj|dfd|tj}t|A|d|j |y)Nr(rSrrr)rr,rradiusarc_sizer$r@rr" make_circlerevolver make_linerZr;r<)r>rVrWr@r4rAr0rCs r2r<zCircle.__init__s'2&>&>t&D&   UA& 5  !!&) *dnnfa[&A8TVVT q$**d3rD)rVrErWrEr@rFr4r rHrIrJrKrrLrMrCENTERrrNr<rOrPs@r2rRrRrsd ##$K  5:\\5<<4PXX 4442 4  44rDrRceZdZdZej gZdejejfe jf dfd Z xZ S)EllipseaSketch Object: Ellipse Create an ellipse defined by x- and y- radii. Args: x_radius (float): x radius of the ellipse (along the x-axis of plane) y_radius (float): y radius of the ellipse (along the y-axis of plane) rotation (float, optional): angle to rotate object. Defaults to 0 align (Align | tuple[Align, Align], optional): align MIN, CENTER, or MAX of object. Defaults to (Align.CENTER, Align.CENTER) mode (Mode, optional): combination mode. Defaults to Mode.ADD rctj|}t||||_||_t |d|_ttj||}t|-|||j |yNr() rr,rx_radiusy_radiusr$r@rr" make_ellipser;r<) r>rbrcr8r@r4rAr0rCs r2r<zEllipse.__init__si'2&>&>t&D&    UA& D%%h9: xT:rD) rbrErcrEr8rEr@rFr4rr\rPs@r2r_r_sn ##$K 5:\\5<<4PXX ;;; ; 2 ;  ;;rDr_ceZdZdZej gZdejejfe jd dfdZ xZ S)PolygonaSketch Object: Polygon Create a polygon defined by given sequence of points. Note: the order of the points defines the resulting normal of the Face in Algebra mode, where counter-clockwise order creates an upward normal while clockwise order a downward normal. In Builder mode, the Face is added with an upward normal. Args: pts (VectorLike | Iterable[VectorLike]): sequence of points defining the vertices of the polygon rotation (float, optional): angle to rotate object. Defaults to 0 align (Align | tuple[Align, Align], optional): align MIN, CENTER, or MAX of object. Defaults to (Align.NONE, Align.NONE) mode (Mode, optional): combination mode. Defaults to Mode.ADD rr8r@r4cJtj|}t||t|}||_t |d|_|jDcgc] }t|}}ttj|} t |1| ||j |ycc}wra) rr,rrptsr$r@rrr" make_polygonr;r<) r>r8r@r4rirA flattened_ptsppoly_ptsr0rCs r2r<zPolygon.__init__s'2&>&>t&D&(#.  UA& '+xx0!F1I00D%%h/0 xT:1sB )riz!VectorLike | Iterable[VectorLike]r8rEr@rFr4r) rHrIrJrKrrLrMrNONErrNr<rOrPs@r2rfrfsd"##$K 5:ZZ4LXX ;/;;2 ;  ;;rDrfceZdZdZej gZdejejfe jf dfd Z xZ S) RectangleaSketch Object: Rectangle Create a rectangle defined by width and height. Args: width (float): rectangle width height (float): rectangle height rotation (float, optional): angle to rotate object. Defaults to 0 align (Align | tuple[Align, Align], optional): align MIN, CENTER, or MAX of object. Defaults to (Align.CENTER, Align.CENTER) mode (Mode, optional): combination mode. Defaults to Mode.ADD rctj|}t||||_||_t |d|_tj||}t|)|||j |yra) rr,rwidthrectangle_heightr$r@r make_rectr;r< r>rrheightr8r@r4rAr0rCs r2r<zRectangle.__init__sc'2&>&>t&D& &UA& ~~eV, xT:rD rrrErvrEr8rEr@rFr4rr\rPs@r2rprpsn ##$K 5:\\5<<4PXX ;;; ; 2 ;  ;;rDrpceZdZdZej gZdejejfe jf dfd Z xZ S)RectangleRoundedaSketch Object: Rectangle Rounded Create a rectangle defined by width and height with filleted corners. Args: width (float): rectangle width height (float): rectangle height radius (float): fillet radius rotation (float, optional): angle to rotate object. Defaults to 0 align (Align | tuple[Align, Align], optional): align MIN, CENTER, or MAX of object. Defaults to (Align.CENTER, Align.CENTER) mode (Mode, optional): combination mode. Defaults to Mode.ADD rcZtj|}t|||d|zks|d|zkr td||_||_||_t|d|_tj||}|j||j}t |9||||y)Nr(z#width and height must be > 2*radius)rr,r ValueErrorrrrsrVr$r@rrt fillet_2dverticesr;r<) r>rrrvrVr8r@r4rAr0rCs r2r<zRectangleRounded.__init__s'2&>&>t&D& AJ &AJ"6BC C & UA& ~~eV,~~fdmmo6 x5rD) rrrErvrErVrEr8rEr@rFr4rr\rPs@r2ryrysx ##$K5:\\5<<4PXX666 6  6 2 666rDryceZdZdZej gZddejejfe jf dfd Z xZ S)RegularPolygonaSketch Object: Regular Polygon Create a regular polygon defined by radius and side count. Use major_radius to define whether the polygon circumscribes (along the vertices) or inscribes (along the sides) the radius circle. Args: radius (float): construction radius side_count (int): number of sides major_radius (bool): If True the radius is the major radius (circumscribed circle), else the radius is the minor radius (inscribed circle). Defaults to True rotation (float, optional): angle to rotate object. Defaults to 0 align (Align | tuple[Align, Align], optional): align MIN, CENTER, or MAX of object. Defaults to (Align.CENTER, Align.CENTER) mode (Mode, optional): combination mode. Defaults to Mode.ADD Trctj|}t|||dkrtd||r|}n|t t |z z }||_|t t |z z|_||_||_ tt|dzD cgc]X} t|t | dzt z|z t|zz|t| dzt z|z t|zzZc} } | jt j"| jt j$g} | ddj"| ddj$g} | ddj"| ddj$g} t'| | |d}| Dcgc]}||z }}t)t+j,|}t.|a|dd| ycc} wcc}w) Nz3RegularPolygon must have at least three sides, not r(rrU)centerrg)rr,rr{rrrVapothem side_countr@rrangerrr sort_byrXYrrr"rjr;r<)r>rVr major_radiusr8r@r4rAradiri pts_sortedminsmaxs align_offsetpointpts_aor0rCs r2r<zRegularPolygon.__init__@s'2&>&>t&D& >Ej\R  C3rJ//C  !C O%   %  zA~.    #a!ebj:58IIJJ#a!ebj:58IIJJ  kk$&&)3;;tvv+>? 1 a ""JqM!$4$6$671 b!##Z]2%6%8%89&tT5H 4785%,&88D%%f-. DA% 9s AG G) rVrErintrboolr8rEr@ztuple[Align, Align]r4rr\rPs@r2rr-s ##$K "&+llELL%AXX2B2B2B 2B  2B # 2B2B2BrDrcfeZdZdZej gZdejf dfd Z xZ S)SlotArcanSketch Object: Slot Arc Create a slot defined by a line and height. May be an arc, stright line, spline, etc. Args: arc (Edge | Wire): center line of slot height (float): diameter of end arcs rotation (float, optional): angle to rotate object. Defaults to 0 mode (Mode, optional): combination mode. Defaults to Mode.ADD rctj|}t||||_||_t |t r|n t |g}t|j|dz }t|)||d|yra) rr,rarc slot_heightr9r"r offset_2dr;r<)r>rrvr8r4rAr0rCs r2r<zSlotArc.__init__sn'2&>&>t&D&!T*ccU CMM&1*-. xt4rD)rz Edge | WirervrEr8rEr4rrGrPs@r2rrusT ##$K XX 5 55 5  55rDrcjeZdZdZej gZdejf dfd Z xZ S)SlotCenterPointaSketch Object: Slot Center Point Create a slot defined by the center of the slot and the center of one end arc. The slot will be symmetric about the center point. Args: center (VectorLike): center point point (VectorLike): center of arc point height (float): diameter of end arcs rotation (float, optional): angle to rotate object. Defaults to 0 mode (Mode, optional): combination mode. Defaults to Mode.ADD rctj|}t||t|}t|}||_||_||_||z } | jdkrtd| jdtjtj||tj||| z g} t| dj|dz } t |A| |d|y)NrzIDistance between center and point must be greater than 0 Got: distance = z (computed)r()rr,rr slot_centerrrlengthr{r"combinerrZrrr;r<) r>rrrvr8r4rAcenter_vpoint_v half_line slot_wiresr0rCs r2r<zSlotCenterPoint.__init__s'2&>&>t&D&&>-# !h&   q ##,#3#3"4KA  \\w1xI)=>  JqM++FQJ78 xt4rD) rrrrrvrEr8rEr4rrGrPs@r2rrs^ ##$KXX 5 5 5 5  5  5 5rDrcfeZdZdZej gZdejf dfd Z xZ S)SlotCenterToCenteraSketch Object: Slot Center To Center Create a slot defined by the distance between the centers of the two end arcs. Args: center_separation (float): distance between arc centers height (float): diameter of end arcs rotation (float, optional): angle to rotate object. Defaults to 0 mode (Mode, optional): combination mode. Defaults to Mode.ADD rc |dkrtd|tj|}t||||_||_|dkDrt ttjt| dz ddttjtt|dz ddgj|dz }n,tt t|dz |j}t|A||d|y)Nrz7Requires center_separation > 0. Got: center_separation=r(r4)r{rr,rcenter_separationrrr"rrZrrr rRr0r;r<)r>rrvr8r4rAr0rCs r2r<zSlotCenterToCenter.__init__s q J8I7KL '2&>&>t&D&!2! q v/@.@1.Da'KVXVvx9J8JQ8NPQST1UV )FQJ' DfVaZd;@@BCD xt4rD)rrErvrEr8rEr4rrGrPs@r2rrsT ##$K XX 5 55 5  55rDrceZdZdZej gZdejejfe jf dfd Z xZ S) SlotOverallaSketch Object: Slot Overall Create a slot defined by the overall width and height. Args: width (float): overall width of slot height (float): diameter of end arcs rotation (float, optional): angle to rotate object. Defaults to 0 align (Align | tuple[Align, Align], optional): align MIN, CENTER, or MAX of object. Defaults to (Align.CENTER, Align.CENTER) mode (Mode, optional): combination mode. Defaults to Mode.ADD rc ,||krtd|d|tj|}t||||_||_||kDrt ttjt| dz |dz zddttjtt|dz |dz z ddgj|dz }n,tt t|dz |j}t|A||||y)Nz.Slot requires that width > height. Got: width=z , height=r(rr)r{rr,rrrrrr"rrZrrr rRr0r;r<rus r2r<zSlotOverall.__init__s  6>A5(*VIN '2&>&>t&D& ! 6>vufqj6A:.Eq!'LfhWvx VaZ8OQRTU1VW )FQJ' DfUQYT:??ABD x5rDrwr\rPs@r2rrsn ##$K 5:\\5<<4PXX 666 6 2 6  66rDrc eZdZdZej gZddeje je jfddddde jf dfd Z xZS)TextawSketch Object: Text Create text defined by text string and font size. Fonts installed to the system can be specified by name and FontStyle. Fonts with subfamilies not in FontStyle should be specified with the subfamily name, e.g. "Arial Black". Alternatively, a specific font file can be specified with font_path. Use `available_fonts()` to list available font names for `font` and FontStyles. Note: on Windows, fonts must be installed with "Install for all users" to be found by name. Not all fonts have every FontStyle available, however ITALIC and BOLDITALIC will still italicize the font if the respective font file is not available. text_align specifies alignment of text inside the bounding box, while align the aligns the bounding box itself. Optionally, the Text can be positioned on a non-linear edge or wire with a path and position_on_path. Args: txt (str): text to render font_size (float): size of the font in model units font (str, optional): font name. Defaults to "Arial" font_path (PathLike | str, optional): system path to font file. Defaults to None font_style (Font_Style, optional): font style, REGULAR, BOLD, BOLDITALIC, or ITALIC. Defaults to Font_Style.REGULAR text_align (tuple[TextAlign, TextAlign], optional): horizontal text align LEFT, CENTER, or RIGHT. Vertical text align BOTTOM, CENTER, TOP, or TOPFIRSTLINE. Defaults to (TextAlign.CENTER, TextAlign.CENTER) align (Align | tuple[Align, Align], optional): align MIN, CENTER, or MAX of object. Defaults to None path (Edge | Wire, optional): path for text to follow. Defaults to None position_on_path (float, optional): the relative location on path to position the text, values must be between 0.0 and 1.0. Defaults to 0.0 single_line_width (float, optional): width of outlined single line font. Defaults to 4% of font_size rotation (float, optional): angle to rotate object. Defaults to 0 mode (Mode, optional): combination mode. Defaults to Mode.ADD ArialNc tj|} t| || d|z} n| dkrtd| d||_||_||_||_||_||_ ||_ ||_ | |_ | |_ | |_| |_t!j"|||||||| ||  }t$|M|| d| y)Ng{Gz?rzsingle_line_width (z) must be greater than 0) txt font_sizefont font_path font_style text_alignr@position_on_path text_pathsingle_line_width)rr,rr{rrrrrrr@rrrr8r4r make_textr;r<)r>rrrrrrr@pathrrr8r4rA text_stringrCs r2r<z Text.__init__[s'2&>&>t&D&  $!%y 0  # %%&7%88PQ " "$$  0!2   ((!!-/   hd;rD)rstrrrErrrzPathLike[str] | str | Nonerrrztuple[TextAlign, TextAlign]r@rFrzEdge | Wire | NonerrEr float | Noner8rEr4r)rHrIrJrKrrLrMrREGULARrr]rrNr<rOrPs@r2rr)s(V##$K04 ) 1 13<3C3CYEUEU2V48#'"%*.XX4< 4<4< 4< . 4<  4<04<24<!4< 4<(4<4<4<4rrrvrrr8r@r4rAreduction_leftreduction_righttop_width_lefttop_width_rightbot_width_leftbot_width_rightrir0rCs r2r<zTrapezoid.__init__s'2&>&>t&D&2B?HX &. 0UA& !B&AFS9Q5R,R "R'AVc'BR:S6T-T !)!) A  n ,N n ,N Q   .O  .O _ , 1GH H _ , 1DE E 6>/F7Q;78 6/F7Q;78 6/6A:67 6>/6A:67 3q6D%%c*+ xT:rD)rrrErvrErrErrr8rEr@rFr4rr\rPs@r2rrs&##$K*.5:\\5<<4PXX8;8;8; 8; ' 8;  8;28;8;8;rDrc eZdZdZej gZddddddddejd dfdZ xZ S)Trianglea9Sketch Object: Triangle Create a triangle defined by one side length and any of two other side lengths or interior angles. The interior angles are opposite the side with the same designation (i.e. side 'a' is opposite angle 'A'). Side 'a' is the bottom side, followed by 'b' on the right, going counter-clockwise. Args: a (float, optional): side 'a' length. Defaults to None b (float, optional): side 'b' length. Defaults to None c (float, optional): side 'c' length. Defaults to None A (float, optional): interior angle 'A'. Defaults to None B (float, optional): interior angle 'B'. Defaults to None C (float, optional): interior angle 'C'. Defaults to None rotation (float, optional): angle to rotate object. Defaults to 0 align (Align | tuple[Align, Align], optional): align MIN, CENTER, or MAX of object. Defaults to None mode (Mode, optional): combination mode. Defaults to Mode.ADD Raises: ValueError: One length and two other values were not provided Nr) abcABCr@r8r4c tj} t| |||fD cgc]} | duc} jddk(s*||||||fD cgc]} | duc} jddk7r t dd|||fD\}}}t j ||||||\} } }}__| _ t| _ t|_ t|_ ttj t#ddt#dt#| dj%t&j(jg}t+d|j-Dt#ddddz }|j/t1| |dn t3|d}t4m|||| j9j;fd d_j9j;fd d_j9j;fd d_ tCj>j@_"tGjDtHsJjD_%tCj<j@_&tGjLtHsJjL_%tCj<j>_'tGjNtHsJjN_%ycc} wcc} w) NTrz0One length and two other values must be providedc3:K|]}| t|ndywr+)r)r/angles r2r3z$Triangle.__init__..sXUU%675>D@Xsrc32K|]}t|ywr+)r)r/vs r2r3z$Triangle.__init__..#s8q8sr()r?r8r@r4cBt|jz tkSr+)absrr)ears r2z#Triangle.__init__..(ss188b=7II7UrDcdt|jz tkxr|jfvSr+)rrredge_a)rbrr>s r2rz#Triangle.__init__..,s)c!((R-(94O4;;-9OrDc8|jjfvSr+)redge_b)rr>s r2rz#Triangle.__init__..1sa T[[99rD)(rr,rcountr{trianglesolversolverrrrrrrrr"rjrrotaterr[sumr}r5rr$r;r<edges filter_byrredge_cr#vertex_Ar9r! topo_parentvertex_Bvertex_C)r>rrrrrrr@r8r4rArcrArBrCrtrianglecenter_of_geometry alignmentrrrCs` @@r2r<zTriangle.__init__s'2&>&>t&D& !1ay )!AI ) / / 5 : !1aAq1? AI? %+?OP PXqRSUViX1a!/!5!5aAq!Q!GBBB   1vb!}fRm.B.B466466.RS   8H$5$5$78&Aq/ JQ N   h 2234!MDwua/@  X PTUjjl,,-UV   jjl,, O    jjl,, 9    3 KK  $--000$( !2 KK  $--000$( !2 KK  $--000$( !g *? s M M)rrrrrrrrrrrrr@rFr8rEr4rrGrPs@r2rrs.##$K48XXC) C)  C)  C)  C) C) C)2C)C)C)C)rDr)rs8#$44RRCC.   06v06f"4 "4J ; ;F$;$;N ; ;F&6'&6REB%EBP55@05&05f,5),5^/6"/6df< f