^j9d dZddlmZddlmZddlmZddlmZm Z m Z m Z m Z ddl mZddlmZmZmZmZddlmZmZmZmZmZmZmZmZmZmZmZm Z dd l!m"Z"m#Z#m$Z$m%Z% dd Z&d d d d d d d de jNf ddZ(d d de jNf ddZ)d e jTe jVde jNf ddZ, ddZ-d ej\dde jNf ddZ/d ej`d de jbf ddZ2d d d d de jNf ddZ3y )a Part Operations name: operations_part.py by: Gumyr date: March 17th 2023 desc: This python module contains operations (functions) that work on Parts. license: Copyright 2023 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)cast)Iterable)GeomTypeModeUntilKindSide) BuildPart)AxisPlaneVector VectorLike) CompoundCurveDraftAngleErrorEdgeFaceShellSolidWirePartSketch ShapeListVertex)logger WorkplaneListflatten_sequencevalidate_inputsc xtjd}t|}td|DsJdt |d|t j t jt jh}|Dcgc]}|j|vs|}}|r-tddjtd|Dtd|D}t|dk7r td tt|j!} t| dk7r td  | d j#|||} |"|j+| dt,j.t1t3| gj4Scc}w#t$$r(} t%d | j&| j( | d} ~ wwxYw)a Part Operation: draft Apply a draft angle to the given faces of the part Args: faces: Faces to which the draft should be applied. neutral_plane: Plane defining the neutral direction and position. angle: Draft angle in degrees. draftc3<K|]}t|tywN) isinstancer.0fs R/opt/ringagent/.cad-venv/lib/python3.12/site-packages/build123d/operations_part.py zdraft..Ls6qz!T"6zall faces must be of type Facez.Draft not supported on face(s) with geometry: z, c3HK|]}|jjywr#) geom_typenamer%s r(r)zdraft..TsC!Q[[--Cs "c3NK|]}|j|jywr#) topo_parentr%s r(r)zdraft..XsU1==;Tq}}Us%%z:All faces must share the same topological parent (a Solid)z)Topological parent must be a single SolidrzXDraft operation failed. Use `err.face` and `err.problematic_shape` for more information.)faceproblematic_shapeNFcleanmode)r _get_contextrallrrPLANECYLINDERCONEr, ValueErrorjoinsetlennextitersolidsr!rr1r2_add_to_contextrREPLACErrwrapped) faces neutral_planeanglecontext face_listvalid_geom_typesr' unsupported topo_parents parent_solids new_soliderrs r(r!r!;s!* 6 6w ?G!1%!8I 6I6 6X8XX 6GWi0 (9(98==I'O1;;>N+N1OKO<yyC{CCDE G  UiUUL <AUVVl+,335M =QDEE!!$**9mUK  T\\J )%-- ..;P$  O!33    s$:FF*F F9#F44F9NFgTc (tjd} t| d||@| 3| jr'| j} | j} g| _g| _nct dt |tttfrg|n|j} g} | D]"} t| } | | j| $g}|O| D cgc]D} t| j| jjj t#|F} } t%| t%| k7r t dt'j(dt%| t%| t+| | D]\} } |rddgndgD]}|t|dk(r7|jt-j.| | j0|z|z A|jt-j2| | j0|z|z| y| t d || t d | j4}n|}| t d |jt-j6| || j0|z||r@t%|dkDr2|j9j:|}t |tr|n|g}|r|Dcgc]}|j=}}| | j>|||dtAtC|jES#t $rd} Y_wxYwcc} wcc}w)aPart Operation: extrude Extrude a sketch or face by an amount or until another object. Args: to_extrude (Union[Face, Sketch], optional): object to extrude. Defaults to None. amount (float, optional): distance to extrude, sign controls direction. Defaults to None. dir (VectorLike, optional): direction. Defaults to None. until (Until, optional): extrude limit. Defaults to None. target (Shape, optional): extrude until target. Defaults to None. both (bool, optional): extrude in both directions. Defaults to False. taper (float, optional): taper angle. Defaults to 0.0. clean (bool, optional): Remove extraneous internal structure. Defaults to True. mode (Mode, optional): combination mode. Defaults to Mode.ADD. Raises: ValueError: No object to extrude ValueError: No target object Returns: Part: extruded object extrudeN!A face or sketch must be providedz4dir must be provided when extruding non-planar facesz)%d face(s) to extrude on %d face plane(s)r0r) direction)rTtaperz'Either amount or until must be providedz A target object must be providedzNo target object provided)targetrTuntilr3)#r r6r pending_facespending_face_planesr;r$tuplelistfilterrEr appendcentercenter_locationx_axisrTrr>rinfoziprrQz_dir extrude_taperpart extrude_untilpopfuser4rBrrrA) to_extrudeamountdirrWrVbothrUr4r5rHto_extrude_faces face_planesr1plane new_solidsrT target_object fused_solidssolids r(rQrQps.D!* 6 6y AGGY 3  7#8#8&44 !55K$&G !*,G '@A A *udF&;< jM!!#   $ *D d  ""5)  *!J )  $++-!5!5!()KLL$+LLM$*M ($%@AA!!'',"'++ "9# =% &P J!#,z~~',,j9 %/ d%C\,  1;<ekkm< <5tD  *%,,. //O   r=s K8A L (L8 LLc ,d}tjd}t|}t|d|t d|Dr4| |j s t d|j }g|_g|_n|}td|DrQt|dtst|dts t d td |d dDr t d g}g} |D]w} t| tr|j| %| jD]@} |j| j| j| jBy|| } tj ||} | r3t#t| j%tj | |} | j&sq | j|D cgc]} t| t(s| c} z}tt+|} |r| j-} | j&s t d  ||j3| ||n|r| j-} t5t7| gj8Scc} w#t.$r}t1d |d}~wwxYw)aBPart Operation: loft Loft the pending sketches/faces, across all workplanes, into a solid. Args: sections (Vertex, Face, Sketch): slices to loft into object. If not provided, pending_faces will be used. If vertices are to be used, a vertex can be the first, last, or first and last elements. ruled (bool, optional): discontiguous layer tangents. Defaults to False. clean (bool, optional): Remove extraneous internal structure. Defaults to True. mode (Mode, optional): combination mode. Defaults to Mode.ADD. c|Dchc] }t|}}|dhkrgS|dhk(r|Dcgc]}|d c}St|dkDr tdtdt|dcc}wcc}w)Nrr0z4The number of holes in the sections must be the samezJloft supports a maximum of 1 hole per section but one or more section has zF hole - loft the perimeter and holes separately and subtract the holes)r>r;max)lstsublengthss r(normalize_list_of_listsz%loft..normalize_list_of_listss'*+3s8++ qc>I qc>&)*sCF* * w.s +19 +sNzNo sections providedc3<K|]}t|tywr#r$rr~s r(r)zloft..&s 9Q:a 9r*rrSz.-sCz!V$Cr*r0zRecovery failedzFailed to create valid loftr3)r r6rrr7rXr;rYanyr$rr]rE outer_wire inner_wiresr make_loftrcutis_validrrr4 Exception RuntimeErrorrBrrrD)sectionsruledr4r5rzrH section_listinput_sections loft_sectionshole_candidatesrr1holesrNrecovery_faceses r(r{r{sy&  !* 6 6v >G#H-LGV\2 +l ++ ?'"7"734 4 .. "&(#% 9. 99.+V4Z 2 > N  CnQr.BC CN  MO ; a   #  ;$$T__%67&&t'7'7'9: ; ; $O 4E u5I  eooeU.K LM     E&__.(2Jq$,?2NeN34I%OO- %% !233&  TB OO% )%-- ..!2 E<=1 D Es1<I9I4%I4)AI94I99 J JJc tjd}t|d|Et|tr|j d}nGt|t tfs1td||j |j}n td|j|||d}|j} tt|} t} |j} t|t t"fr|gt%| z}n't|t&r t)|}n t+d | D]t}| j-t/|}|d dD]P}t1t/||z j2|z d ks+| j5t j6||tv| j9|} t%|t%| k7rtd t%| d t;| |Dcgc])\}}tj<|| j>|z+}}}|jAj9|}g}tCt%|d z D]6}|j5tEjF||||d zg||8t%|d kDr!tItJtKjL|}n|d}|$|jO|||t|_(n|r|jS}tKtU|gjVS#t$r} td| d} ~ wwxYwcc}}w)amake_brake_formed Create a part typically formed with a sheet metal brake from a single outline. The line parameter describes how the material is to be bent. Either a single width value or a width value at each vertex or station is provided to control the width of the end part. Note that if multiple values are provided there must be one for each vertex and that the resulting part is composed of linear segments. Args: thickness (float): sheet metal thickness station_widths (Union[float, Iterable[float]]): width of part at each vertex or a single value. Note that this width is perpendicular to the provided line/plane. line (Union[Edge, Wire, Curve], optional): outline of part. Defaults to None. side (Side, optional): offset direction. Defaults to Side.LEFT. kind (Kind, optional): offset intersection type. Defaults to Kind.ARC. clean (bool, optional): clean the resulting solid. Defaults to True. mode (Mode, optional): combination mode. Defaults to Mode.ADD. Raises: ValueError: invalid line type ValueError: not line provided ValueError: line not suitable ValueError: incorrect # of width values Returns: Part: sheet metal part make_brake_formedNrz)line must be either a Curve, Edge or WirezA line must be providedT)distancekindsideclosedz%line not suitable - probably straightzrr[ TypeErrorsort_by_distancerabslengthr] make_linesort_byrbrQrcedgesranger sweep_multirrrhrB pending_edgesr4rrD) thicknessstation_widthslinerrr4r5rH offset_lineoffset_verticesroexc station_edges line_verticesstation_widths_listvertexothersotherrw station_faces sweep_pathsrirNs r(rr[s!N!* 6 67J KGG01  dE "::<?DD4,/HI I  !>!>!J,,233..)$TRV.WK!**,OKd;'( &/[MMMOM.5#,/-.]1CC NH -">2VWW 11&.AABZ E66E>+22Y>?$F$$T^^FE%BC  "))$/M 3}#55336}3E2Fa I   ':; Aq ekkAo6M**,&&t,KH 3}%) *    q!=Q#78{1~    8}qtyy(34 QK  TB )  OO% )%-- ..e K@AsJK6s5L%8.M% L?. L::L?ctjd}|t|ts tdt|tr t |n t |}t |j }t |j }|||zz}t||}tjdd|}t||z|}|j|} | s td| dd|z } | |_ |S)a Part Operation: project_workplane Return a plane to be used as a BuildSketch or BuildLine workplane with a known origin and x direction. The plane's origin will be the projection of the provided origin (in 3D space). The plane's x direction will be the projection of the provided x_dir (in 3D space). Args: origin (Union[VectorLike, Vertex]): origin in 3D space x_dir (Union[VectorLike, Vertex]): x direction in 3D space projection_dir (VectorLike): projection direction distance (float): distance from origin to workplane Raises: RuntimeError: Not suitable for BuildLine or BuildSketch ValueError: x_dir perpendicular to projection_dir Returns: Plane: workplane aligned for projection project_workplanezIprojection_workplane can only be used from a BuildPart context or algebra)rcgeA)roz%x_dir perpendicular to projection_dirr)r r6r$rrr normalizedr r make_rectr find_intersection_pointsr;x_dir) originrprojection_dirrrHworkplane_origin workplanescreenx_dir_point_axis projectionworkplane_x_dirs r(rrs4!* 6 67J KG:gy#A W   *&&9VF^vf~F 5M $ $ &EN+668N 99&n=I^^CI 6FFUNN;001ABJ @AA!mA&)99O%IO v@cDtjd}t|}t|d||dk\rdnd}||dzz}|dk(r|dzn|}t |D cgc]} | duc} r6|||j s t d|j } g|_g|_n|j} | D cgc]} tj| ||} } t| } ||j| ||dn|r| j} t| jScc} wcc} w) aPart Operation: Revolve Revolve the profile or pending sketches/face about the given axis. Note that the most common use case is when the axis is in the same plane as the face to be revolved but this isn't required. Args: profiles (Face, optional): 2D profile(s) to revolve. axis (Axis, optional): axis of rotation. Defaults to Axis.Z. revolution_arc (float, optional): angular size of revolution. Defaults to 360.0. clean (bool, optional): Remove extraneous internal structure. Defaults to True. mode (Mode, optional): combination mode. Defaults to Mode.ADD. Raises: ValueError: Invalid axis of revolution revolverr0rSrNzNo profiles providedr3)r r6rrr7rXr;rYrErrrrBr4rrD)profilesaxisrevolution_arcr4r5rH profile_listsignrGr profile_facesprofilerprNs r(rrs&.!* 6 6y AG#H-LGY 5!#1D dUl +E!QJD5LEE | ,!AI ,- ?w27;P;P34 4-- "&(#$**, ERS'%--5SJS$I5tD OO%  !! ""# -Ts  D0Dc 6tjd}t|dd||}n&||j |j}n t d|j d}t dt|jt|j zD|jz}|t|tr|n|g} n,|tjj} n t d| D cgc]N} tjd|zd|zt!| j"| j$|zz| j$ P} } |&||j& |j}n t d g} | D]I} |j)| } t| t*r| j-| 6| 9| j/| K||j0| d||d n|r| Dcgc]}|j3} }t5t7| j8Scc} wcc}w) aPart Operation: section Slices current part at the given height by section_by or current workplane(s). Args: obj (Part, optional): object to section. Defaults to None. section_by (Plane, optional): plane(s) to section object. Defaults to None. height (float, optional): workplane offset. Defaults to 0.0. clean (bool, optional): Remove extraneous internal structure. Defaults to True. mode (Mode, optional): combination mode. Defaults to Mode.INTERSECT. sectionNzNo object to sectionF)optimalc32K|]}t|ywr#)r)r&vs r(r)zsection..VsCa3q6Csz&Plane(s) must be provide to section by)rrczobj must be provided)faces_to_pendingr4r5)r r6rrer; bounding_boxrvr[mindiagonalr$rr workplanesrrr rrc_obj intersectrextendr]rBr4rrrD)r section_byheightr4r5rH to_sectionbboxmax_sizesection_planesroplanes new_objects intersectionrs r(rr8s&!* 6 6y AGGY-   !9\\ /00  " "5 " 1DC4>DN#BCCdmmSH$Z:J    &335@@ABB$    L L  f(< normal_atr]rrrrBrrrhr4rrD) to_thickenrjrrlr4r5rHto_thicken_facesrpr1 face_normalrTrss r(rrs<!* 6 6y AGGY 3~566  7#8#8&44 $&G !*,G '@A A *udF&;< jM!!#  !J KK'-=)>? .:O@P %)!Rqc I    {8Ki8W   5tD z?Q tTYY %;<=J 5?@E%++-@J@ $,, --AsF)rEzFace | Iterable[Face]rFr rGrreturnr)riFace | Sketch | Nonerj float | NonerkVectorLike | NonerWz Until | NonerVzCompound | Solid | NonerlboolrUrr4rr5rrr) rz7Face | Sketch | Iterable[Vertex | Face | Sketch] | Nonerrr4rr5rrr)rrrzfloat | Iterable[float]rzEdge | Wire | Curve | Nonerr rr r4rr5rrr) rVectorLike | Vertexrrrrrrrr ) rzFace | Iterable[Face] | Nonerr rrr4rr5rrr) rz Part | NonerzPlane | Iterable[Plane]rrr4rr5rrr)rrrjrrrrlrr4rr5rrr)4__doc__ __future__rtypingrcollections.abcrbuild123d.build_enumsrrrr r build123d.build_partr build123d.geometryr r rrbuild123d.topologyrrrrrrrrrrrrbuild123d.build_commonrrrrr!ADDrQr{LEFTARCrrZrXZPRIVATErrr}rr(r s8#$CC*>>    2/ 2/2/ 2/ 2/l(,!&*B0$B0 B0 B0  B0 $ B0  B0 B0 B0 B0 B0LIM c/Ec/ c/ c/  c/  c/R(,l/l/+l/ %l/  l/  l/  l/ l/ l/^4 4 44 4  4p.2! 4#*4# 4#4#  4#  4#  4#p*/(( G1 G1'G1 G1  G1  G1  G1V(,)- M.$M. M.'M.  M.  M.  M. M.r