^j8.UdZddlZddlZddlmZddlmZmZddl m Z m Z ddl m Z mZddlmZddlmZmZmZmZmZdd lmZmZmZmZmZmZdd lmZdd l m!Z!dd l"m#Z#dd l$m%Z%m&Z&m'Z'm(Z(m)Z)m*Z*ddl+m,Z,ddl-m.Z.ddl/m0Z0ddl1m2Z2m3Z3m4Z4m5Z5m6Z6m7Z7m8Z8m9Z9m:Z:m;Z;mZ>m?Z?ejdjejejdZCe4e>ze5zeze5ze2ze3ze;ze7zZOe eEd$< de&jejfdeOeeOzdzd%e&dede3e;ze7ze2zfd&ZQe4e5zeze)ze=zZXe eEd/< dddejfdeXeeXzdzd0e&dzd1eze5zeze5zezee4zdzd>eHd?eHd@edAe*dzdBe4e>zdzdeHdede7e;zfdCZay)Ea$ Generic Operations name: operations_generic.py by: Gumyr date: March 21th 2023 desc: This python module contains operations (functions) that work on combinations of Curves, Sketches and Parts. 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. N)Iterable)radianstan) TypeAliascast)Standard_ConstructionErrorStandard_Failure)StdFail_NotDone)Builder LocationList WorkplaneListflatten_sequencevalidate_inputs)GeomTypeKeepKindModeSide Transition) BuildLine) BuildPart) BuildSketch)AxisPlaneRotation RotationLikeVector VectorLike)BaseLineObject)BasePartObject)BaseSketchObject)CompoundCurveEdgeFaceGroupByPartShape ShapeListShellSketchSolidVertexWire isclose_b build123dAddTypeTobjectsrotationcleanmodereturnc z tjd}| tdt|trt|t s t |}n|g}|Dcgc]j}t|tr |jLt|t r|jdn)t|tr|j |jn|l}}t|d|t|tr|tddd}n$t|tr t|}n td|Dcgc]}|j|}}|Dcgc]}t|ts|}}|Dcgc]}t|t s|} }|Dcgc]}t|t"s|} }|Dcgc]}t|t$s|} }t'd|D]} |j)| j+t| j)| j+t | j)| j+t"| j)| j+t$| D]!} |j)| j-#t/js td |Dcgc]6}t/jj0D]}|j|8}}}|j2||}t5jj6D]q}g}t/jj0D])}| D]"}|j9|j|$+|j2|d |i|j)|s| Dcgc]6}t/jj0D]}|j|8}}}|j:|||d |j)|t |St|t<rt|t>t@fr|nd }g}|D]j}|j)t/jjBDcgc]1}|jEtFjH|j|3c}l|j:|d |it |St|tJrt|t>t@fr|nd }g}|D]j}|j)t/jjBDcgc]1}|jEtFjH|j|3c}l|j:|d |it |Std|jLjNdcc}wcc}wcc}wcc}wcc}wcc}wcc}}wcc}}wcc}wcc}w)a<Generic Object: Add Object to Part or Sketch Add an object to a builder. BuildPart: Edges and Wires are added to pending_edges. Compounds of Face are added to pending_faces. Solids or Compounds of Solid are combined into the part. BuildSketch: Edges and Wires are added to pending_edges. Compounds of Face are added to sketch. BuildLine: Edges and Wires are added to line. Args: objects (Edge | Wire | Face | Solid | Compound or Iterable of): objects to add rotation (float | RotationLike, optional): rotation angle for sketch, rotation about each axis for part. Defaults to None. clean (bool, optional): Remove extraneous internal structure. Defaults to True. mode (Mode, optional): combine mode. Defaults to Mode.ADD. Nz'Add must have an active builder contextFfullyaddrzInvalid rotation valuec"t|tS)N) isinstancer")os U/opt/ringagent/.cad-venv/lib/python3.12/site-packages/build123d/operations_generic.pyzadd..s Ax)@z$There is no active Locations context face_planer4r5r5zBuilder z is unsupported)(r _get_context RuntimeErrorr<rr"list_objunwraprrrtuple ValueErrormovedr$r.r%r,filterextendget_typeedgesr locations_add_to_pendingr workplanesappend_add_to_contextrintfloatlocal_locationsrotaterZr __class____name__)r2r3r4r5context object_listobj object_iter new_edges new_wires new_faces new_solidscompoundnew_wireedgelocation located_edges new_objects workplanefaces_per_workplanefacesolidlocated_solidsrotation_angles r>r:r:NsZ2&2248GDEE'8$Z-J7m i   3(SXX-= #x( JJUJ #'W5#((:NTW XKGUK0'9%  1a(H % (*H56 66ABssyy*B B$/IS:c43HSI I$/IS:c43HSI I$/IS:c43HSI I%0KcJsE4JcK K@+N 8H   X..t4 5   X..t4 5   X..t4 5   h//6 7  8 " /H   X^^- . /((*EF F" (557AA  JJx    /# '335@@ 4I"$ (557AA E%ED'..tzz(/CDE E $G # #%8 OY O   2 3  4$ (557AA  KK ! !  u4H>*: K  7 G[ )%/3,%GS  C   %1$=$=$?$O$O JJtvv~6<rqrqsV&22>BG ?g1gll6J78 8||n &w/ G^[9 [ 1cCHHM 12  UC#v&##%DTXXZZ(TXXZZ(TXXZZ(TXXZZ(TXXZZ( H   T$"3"34Q1VAY4Q"RS T U   #G # #Y :T :hy)1122K   c6 " ! NN   txxzz488::txxzz:;    848 %-- ..C 25Rs "L%LChamferFilletTypelengthlength2angle referencec >tjd}|r |r td|r|tt |z}|r|s |s td||n|}|||||j tdt |}t|d|| |j n|dj tdjdk(rttrtjnt|Dcgc]}t|tc}s tdj!||t#||}|!|j%|t&j( tt+|gjSjd k(r tt,rt/jnt|Dcgc]}t|t0c}s td g} j3D][} | j5D cgc] } | |vs|  } } | r$| j7| j9||| |K| j7| ]t/t+| j} |!|j%| t&j( | Sjd k(rtt:r$s t=gn)t=jnj?dt|Dcgc]}t|t0c}s td j@stCtEfd|}j9||||}|!|j%|t&j( |Stdcc}wcc}wcc} wcc}w)aaGeneric Operation: chamfer Applies to 2 and 3 dimensional objects. Chamfer the given sequence of edges or vertices. Args: objects (Edge | Vertex or Iterable of): edges or vertices to chamfer length (float): chamfer size length2 (float, optional): asymmetric chamfer size. Defaults to None. angle (float, optional): chamfer angle in degrees. Defaults to None. reference (Edge | Face): identifies the side where length is measured. Edge(s) must be part of the face. Vertex/Vertices must be part of edge Raises: ValueError: no objects provided ValueError: objects must be Edges ValueError: objects must be Vertices ValueError: Only one of length2 or angle should be provided ValueError: reference can only be used in conjunction with length2 or angle chamferz/Only one of length2 or angle should be providedz?reference can only be used in conjunction with length2 or angleNo objects providedrzNothing to chamferz%3D chamfer operation takes only Edgesr5rsz(2D chamfer operation takes only Vertices'1D fillet operation takes only Verticesctt|jdz jdxs1tt|jdz jd SNrrCrr/r position_atrrtargets r>r?zchamfer..vY!6!9v/A/A!/D#D"L"LcRV$fQi&2D2DQ2G&G%O%OQTUr@Invalid object dimension)#r rDrJrrrGrr topo_parentrur<r r'r{rtr$rrFrTrREPLACEr"r!r+r-facesrrS chamfer_2drr.wires is_closedr)rL)r2rrrrr\r]r^new_partrbrlrvertices_in_face new_sketchrers @r>rr sN8&229=G5JKK 3wu~..'U M   fWGGOG/GLL4H.//"7+KGY 4Q++ ~-.. {{a)3FN)Kfnn%QW[AcJsD)ABDE E>>&'4 3DiP    # #H4<< # @HhZ(0011 {{a'19I&JF6>> "PV {CJsF+CDGH H LLN 'D+/==?Oaa;>NO O  OOFG5EyQ  & 'HY/778    # #JT\\ # B {{a fn -bfnn-\\^A&F{CJsF+CDFG G# K$$VWk9M    # #H4<< # @ / 00sBD P,Ds7N ?N NN:Nradiusc  tjd}|||||j tdt |}t |d|| |j n|dj td jdk(rt trt jn t|Dcgc]}t|tc}s td j|t|}|!|j!|t"j$tt'|gjS jdk(rt t(rt+ jn t|Dcgc]}t|t,c}s td g} j/D]b}|j1Dcgc]}|t|vs|} }| r"|j3|j5|| R|j3|dt+t'|j} |!|j!| t"j$| S jd k(rt t6r$ s t9g n)t9 j n j;d t|Dcgc]}t|t,c}s td  j<st?tA fd |} j5||} |!|j!| t"j$| Std cc}wcc}wcc}wcc}w)a%Generic Operation: fillet Applies to 2 and 3 dimensional objects. Fillet the given sequence of edges or vertices. Note that vertices on either end of an open line will be automatically skipped. Args: objects (Edge | Vertex or Iterable of): edges or vertices to fillet radius (float): fillet size - must be less than 1/2 local width Raises: ValueError: no objects provided ValueError: objects must be Edges ValueError: objects must be Vertices ValueError: nothing to fillet filletrrzNothing to filletrz$3D fillet operation takes only Edgesrrsz'2D fillet operation takes only Verticesrrctt|jdz jdxs1tt|jdz jd Srrrs r>r?zfillet..rr@r)!r rDrGrJrrrrur<r r'r{rtr$rrFrTrrr"r!r+r-rrrS fillet_2drr.rrr)rL) r2rr\r]r^rrbrlrrrrers @r>rrs*&228> "PV {CJsF+CDFG G LLN 'D+/==?Uaa4 CT>TU U  8H!IJ  &  ' HY/778    # #JT\\ # B {{a fn -bfnn-\\^A&F{CJsF+CDFG G# K##FK8    # #H4<< # @ / 00qBD V(Ds8M>MM!MM MirrorTypeaboutc>tjd}t|trt|ts t |}n|g}|)|||j td|j g}n t|}t|d||Dcgc]&}tj|j|(}}||j|d|it |}t|Dcgc]}|jdk(c}rt!|j"St|Dcgc]}|jdk(c}rt%|j"St|Dcgc]}|jdk(c}rt'|j"S|Scc}wcc}wcc}wcc}w)aGeneric Operation: mirror Applies to 1, 2, and 3 dimensional objects. Mirror a sequence of objects over the given plane. Args: objects (Edge | Face | Compound or Iterable of): objects to mirror about (Plane, optional): reference plane. Defaults to "XZ". mode (Mode, optional): combination mode. Defaults to Mode.ADD. Raises: ValueError: missing objects mirrorrrr5rrsr)r rDr<rr"rFrGrJrr copy_moduledeepcopyrrTrtrur'r{r+r#) r2rr5r\r]r=mirroredmirrored_compoundr^s r>rrsi&&228rr"sH&228>#3 3 ; ;e C yH ,78q478K8&(,, 4K+x0  t!<=K3  -  -   X &I$'J u:?uQx11X]]BuQx#~uQx#~FuQx#~uQx#~F )FD)H IU %%f4d6%RI  &JSTQ//@TIT (D!:J  19%PAQ%++-=Oa%P "%P%' " OO2FO F J J L  i'*4K848{+O [ 1cCHHM 12O++,, [ 1cCHHM 12o--.. [ 1cCHHM 12_,,-- C *     92U&Q 2 1 1s=&AT42U UUU U#U(U-4UU ProjectTyperjrc  tjd}t|tr t d|s | t d|sx|vt|t rf|j |jz}g|_g|_t|jdkDr|jd}g|_ n|jd}n t|}|Dcgc]}t|tr t|n|!}}t|jdj }|Dcgc]}t|ttfs|} }| D cgc] } t| } } |Dcgc]}t|t"s|} }|Dcgc]}t|t$t&fs|} }|| t dt|t(r1|j*d}|t,j.k7rP| s| rLt d t|t0r1|j*d}|t,j.k7r| s| r t d t3t4|}d }|At|t r1|t,j.k7r | r t d | |j6}d }nt#j8d|zd|z|}| t dt;|dg}| | zD]}|j=|j=z j?}|jA|jBdkr|jD |z}n|jD|z}|jG||}|st|t0r/|jI|Dcgc]}|jK|c}t|t(r|jI||jI|jMtO}| D]} |jP| z j?}|jA|jBdkrtS| |jD|z }ntS| |jD|z}|jU|}t|tRr tWd||jY|jK|||jZ|d|i|r|}|St|}t]|Dcgc]}|j^dk(c}rta|jb}|St]|Dcgc]}|j^d k(c}rte|jb}|Scc}wcc}wcc} wcc}wcc}wcc}wcc}wcc}w)aGeneric Operation: project Applies to 0, 1, and 2 dimensional objects. Project the given objects or points onto a BuildLine or BuildSketch workplane in the direction of the normal of that workplane. When projecting onto a sketch a Face(s) are generated while Edges are generated for BuildLine. Will only use the first if BuildSketch has multiple active workplanes. In algebra mode a workplane must be provided and the output is either a Face, Curve, Sketch, Compound, or ShapeList[Vector]. Note that only if mode is not Mode.PRIVATE only Faces can be projected into BuildSketch and Edge/Wires into BuildLine. Args: objects (Edge | Face | Wire | VectorLike | Vertex or Iterable of): objects or points to project workplane (Plane, optional): screen workplane mode (Mode, optional): combination mode. Defaults to Mode.ADD. Raises: ValueError: project doesn't accept group_by ValueError: Either a workplane must be provided or a builder must be active ValueError: Points and faces can only be projected in PRIVATE mode ValueError: Edges, wires and points can only be projected in PRIVATE mode RuntimeError: BuildPart doesn't have a project operation projectz2project doesn't accept group_by, did you miss [n]?zNo object to projectr)childrenF)optimalz?Either a workplane must be provided or a builder must be activez6Points and faces can only be projected in PRIVATE modez=Edges, wires and points can only be projected in PRIVATE moderz,Points can only be projected in PRIVATE moder)planez'A target object could not be determinedz.working_plane and projection_axis are parallelr5rs)3r rDr<r&rJr pending_edges pending_facesrpending_face_planesexit_workplanesrrr-r"rqdiagonalr%r$r.rrRrPRIVATErrrpart make_rectrcenter normalizedfrom_local_coordsrYz_dirproject_to_shaperMto_local_coordsrr)originr intersectrErSrTrtrur+r{r#)r2rjrr5r\r]r= shape_list object_size vct_vrt_listpnt point_list face_list line_list working_planeprojection_flipprojected_shapesr^ obj_to_screenprojection_direction projectionpprojected_points pnt_to_targetprojection_axis intersectionresults r>rrsB&229=G'7#MNN w/00 w*z'9/M++g.C.CC " " w** +a /33A6I*,G '//2I&w/ FQQz!V4&)!;QJQJ/<?I?'Gq:a$+FGIG ?Q  gy )**1-It||#j L -**1-It||#j S *MOz'9= 4<< JKL L >\\FK[ V ~BCCGY'9$<3::<7CCE  * *= 9 ; ;a ?$1$7$7#7/#I #0#6#6#H ))&2FG ';/ ''?IJ!]2215JGY/ '' 3 '' (8(8(:;<"+4+ Q&--3??A  * *= 9 ; ;a ?#C)<)<)NOOO"3 (;(;o(MNO$..? lD )OP P  #  # #M$A$A,$O P Q!1==! M *+ 5#A 5 6FNN+F M;7C#((a-7 86>>*F MqRO6?GdK667sB $T4T95T9?T>U-U7UU"U UUrbyctjd}|)|||j td|jg}n t |}t |d|g}|D]'}||j |j||)||j|d|it|}t|Dcgc]}|jdk(c}rt|j}nwt|Dcgc]}|jdk(c}rt|j}n;t|Dcgc]}|jdk(c}rt|j}|j!d Scc}wcc}wcc}w) aGeneric Operation: scale Applies to 1, 2, and 3 dimensional objects. Scale a sequence of objects. Note that when scaling non-uniformly across the three axes, the type of the underlying object may change to bspline from line, circle, etc. Args: objects (Edge | Face | Compound | Solid or Iterable of): objects to scale by (float | tuple[float, float, float]): scale factor about (VectorLike, optional): point to scale about. Defaults to each object's location position. mode (Mode, optional): combination mode. Defaults to Mode.REPLACE. Raises: ValueError: missing objects scalerr)rr5rrsrFr8)r rDrGrJrrrSrrTr"rtrur'r{r+r#rH) r2rrr5r\r]rir^scale_compounds r>rrMsW0&227;G ?g1gll6J78 8||n &w/ GWk2K7 ; 399Ru9567 848k*N [ 1cCHHM 12n445 { 3chh!m 3 4 6 67 { 3chh!m 3 4~556  u -- 2 3 3s/E++E0'E5 SplitType bisect_bykeepc~tjd}|)|||j td|jg}n t |}t |d|g}|D]~}d}|t jk(r|j||\} }n|j||} | |fD]8} t| tr|j| %| (|j| :||j|d|it|} t|Dcgc]}|j dk(c}rt#| j$St|Dcgc]}|j dk(c}rt'| j$St|Dcgc]}|j dk(c}rt)| j$S| Scc}wcc}wcc}w)a(Generic Operation: split Applies to 1, 2, and 3 dimensional objects. Bisect object with plane and keep either top, bottom or both. Args: objects (Edge | Wire | Face | Solid or Iterable of), objects to split bisect_by (Plane | Face, optional): plane to segment part. Defaults to Plane.XZ. keep (Keep, optional): selector for which segment to keep. Defaults to Keep.TOP. mode (Mode, optional): combination mode. Defaults to Mode.REPLACE. Raises: ValueError: missing objects splitNrrr5rrsr)r rDrGrJrrrBOTHrr<rrMrSrTr"rtrur'r{r+r#) r2rrr5r\r]rir^bottomtopsubpartsplit_compounds r>rrs,&227;G ?g1gll6J78 8||n &w/ GWk2#%K , 499 ))It4KC))It,CV} ,G'8,""7+$""7+  , ,848k*N [ 1cCHHM 12N**++ [ 1cCHHM 12n,,-- [ 1cCHHM 12^++,,  2 1 1sF0F5<F: SweepTypeFsectionspath multisection is_frenet transitionnormalbinormalc \tjd} |g} n&t|tr|D cgc]} | |  } } n|g} t | d| |L| "t| t t fr | js tdt| j} g| _nHt|tr t|} n+t|tst|jn|} | sD| 7t| t r'| jr| j} g| _ g| _ n tdg}g}| D]\} t| tttfr |j| j>|j| j!^g}|r|| t#|}nt|tr t|g}n|}|r8|Dcgc]}|j%}}t'j(|| d||g}n(|Dcgc]}t'j*|| d|||}}g}|r=| D]8} t-j*| | |}|j|j!:| | j.||z||dn<|r:|Dcgc]}|j1}}|Dcgc]}|j1}}|rt3t5|j6St9t5|j6Scc} w#t$r} td| d} ~ wwxYwcc}wcc}wcc}wcc}w) a{Generic Operation: sweep Sweep pending 1D or 2D objects along path. Args: sections (Compound | Edge | Wire | Face | Solid): cross sections to sweep into object path (Curve | Edge | Wire, optional): path to follow. Defaults to context pending_edges. multisection (bool, optional): sweep multiple on path. Defaults to False. is_frenet (bool, optional): use frenet algorithm. Defaults to False. transition (Transition, optional): discontinuity handling option. Defaults to Transition.TRANSFORMED. normal (VectorLike, optional): fixed normal. Defaults to None. binormal (Edge | Wire, optional): guide rotation along path. Defaults to None. clean (bool, optional): Remove extraneous internal structure. Defaults to True. mode (Mode, optional): combination. Defaults to Mode.ADD. sweepNzpath must be providedzUnable to build path from edgeszNo sections providedT)sectionr make_solidrr5rrB)r rDr<rrrrrrJr.rOrrr#r$rMrrrr, sweep_multir r*rTr4r'r"r{r+)rrrrrr r r4r5r\ section_listsec path_wireerr edge_listrrc binormal_moderlrbsweptrms r>r r s8&227;G Hh ''/C3?C C z GWl3 | Og ;'?@((45 5../ " dH % M J 3=T42HTZZ\*dI   7I.%%"00L$&G !*,G '34 4II* cE4. /   SYY[ )   SYY[ ) *J   2"6NM $ ' (,M$M 6?@d)@H@!!(ItY VJ&   "#'&)  J I ,CKKY ;E   U[[] + ,*y"8TR 1;<ekkm< <.78dTZZ\8 8HZ(0011 (9%-- ..oD& M !BCL MHA ,=8s:K8K8- K=L"LL$!L)= L LL)NNN)b__doc__copyrloggingcollections.abcrmathrrtypingrr OCP.Standardrr OCP.StdFailr build123d.build_commonr r r rrbuild123d.build_enumsrrrrrrbuild123d.build_linerbuild123d.build_partrbuild123d.build_sketchrbuild123d.geometryrrrrrrbuild123d.objects_curverbuild123d.objects_partr build123d.objects_sketchr!build123d.topologyr"r#r$r%r&r'r(r)r*r+r,r-r.r/ getLogger addHandler NullHandlerloggerr1__annotations__ADDrVboolr:rrqrrrrXZrrARCrrrFrrrrIrrTOPrr TRANSFORMEDr r@r>r5s:$"E'ON**.VV215"+))*='*=*=*?@   ; 'D[4'%/(:WDD5 -1 y! x( (y!l"T)y! y!  y!  y!z/3:/ Xe_ $t +:/ :/ d]:/z $f}9,8 !$( w1 *;!< <w1 w1T\w1 4< w1 d{T! w1  d] w1ta1 *;!< <a1 a1 d]Ua1Ht d*X5=FM IM+9=88. (:. . 5. . . V^dX% .bt e+h6 I6)9=)-$(S (:. . 5S ST$Z$&S  S  S  ST\S S V^dX%Slt+f4v= Y=,;?"-1 N 8K0 04 7Nt|N H t #d *N  N  V^h6!22 Nd/3-.# 3. Xe_ $t +3. eUE)**3.  3.  3.  V^dX% 3.ld{T)E1 91(7;&+hh 8 ), ,t 38t|e#8 8  8v $-4u< 9<(8<8<'33 $#'x/(9--4x/ $,  . 5x/x/ x/  x/   x/TkD x/ x/ x/ F]x/r@