Ji/dZddlmZddlZddlZddlmZmZmZddl m Z m Z ddl m Z ddlmZddlmZddlmZdd lmZdd lmZdd lmZmZdd lmZmZdd lm Z m!Z!ddl"m#Z#m$Z$m%Z%m&Z&m'Z'm(Z(m)Z)ddl*m+Z+ddl,m-Z-m.Z.ddl/m0Z0ddl1m2Z2ddl3m4Z4ddl5m6Z6ddl7m8Z8ddl9m:Z:m;Z;ddlZ>m?Z?m@Z@mAZAddlBmCZCmDZDddlEmFZFmGZGmHZHmIZIddlJmKZKmLZLmMZMmNZNmOZOmPZPmQZQmRZRmSZSddlTmUZUddlVmWZWmXZXmYZYddlZm[Z[m\Z\m]Z]m^Z^m_Z_ddl`maZambZbmcZcmdZddd lemfZfmgZgmhZhmiZidd!ljmkZke r dd"llmmZmmnZnmoZompZpGd#d$e[ZqGd%d&eqe[e@Zry)'a build123d topology name: three_d.py by: Gumyr date: January 07, 2025 desc: This module defines the `Solid` class and associated methods for creating, manipulating, and querying three-dimensional solid geometries in the build123d CAD system. It provides powerful tools for constructing complex 3D models, including operations such as extrusion, sweeping, filleting, chamfering, and Boolean operations. The module integrates with OpenCascade to leverage its robust geometric kernel for precise 3D modeling. Key Features: - **Solid Class**: - Represents closed, bounded 3D shapes with methods for volume calculation, bounding box computation, and validity checks. - Includes constructors for primitive solids (e.g., box, cylinder, cone, torus) and advanced operations like lofting, revolving, and sweeping profiles along paths. - **Mixin3D**: - Adds shared methods for operations like filleting, chamfering, splitting, and hollowing solids. - Supports advanced workflows such as finding maximum fillet radii and extruding with rotation or taper. - **Boolean Operations**: - Provides utilities for union, subtraction, and intersection of solids. - **Thickening and Offsetting**: - Allows transformation of faces or shells into solids through thickening. This module is essential for generating and manipulating complex 3D geometries in the build123d library, offering a comprehensive API for CAD modeling. license: Copyright 2025 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. ) annotationsN)radianscostan)Union TYPE_CHECKING)Iterable)BRepAlgoAPI_Cut)BRepBuilderAPI_MakeSolid)BRepClass3d_SolidClassifier)BRepFeat_MakeDPrism)BRepFilletAPI_MakeChamferBRepFilletAPI_MakeFillet)BRepOffset_MakeOffsetBRepOffset_Skin)BRepOffsetAPI_MakePipeShellBRepOffsetAPI_MakeThickSolid)BRepPrimAPI_MakeBoxBRepPrimAPI_MakeConeBRepPrimAPI_MakeCylinderBRepPrimAPI_MakeRevolBRepPrimAPI_MakeSphereBRepPrimAPI_MakeTorusBRepPrimAPI_MakeWedge) GProp_GProps)GeomAbs_IntersectionGeomAbs_JoinType) LocOpe_DPrism)ShapeFix_Solid)Standard_Failure)StdFail_NotDone)TopExp))TopTools_IndexedDataMapOfShapeListOfShapeTopTools_ListOfShape)TopoDS TopoDS_Face TopoDS_Shape TopoDS_Solid TopoDS_Wire)gp_Ax2gp_Pnt)CenterOfKind TransitionUntil) DEG2RADAxisBoundBoxColorLocationOrientedBoundBoxPlaneVector VectorLike)Self)EdgeWireMixin1D)Shape ShapeListJointdowncast shapetype)sort_wires_by_build_orderMixin2DFaceShell)_extrude_topods_shapefind_max_dimension _make_loft!_make_topods_compound_from_shapes)Vertex)CompoundCurveSketchPartceZdZdZej Zej ZejZejZ ejZ ejZ ejZ ejZ ejZejZej Zej"Zej$ZeddZeddZe ddZej2fddZ d ddZ d ddZdd Zd ej>f dd Z ddd Z! d dd Z"d ej>f ddZ#d dZ$d!dZ%y)"Mixin3Dz-Additional methods to add to 3D Shape classescy)zDimension of Solidsselfs k/workspace/moltex-experiments/.pixi/envs/default/lib/python3.12/site-packages/build123d/topology/three_d.py_dimz Mixin3D._dimsc 4tjttjttj t tjttjttjti}t|}||t|S)z6Returns the right type of wrapper, given a OCCT object)ta TopAbs_VERTEXrK TopAbs_EDGEr; TopAbs_WIREr< TopAbs_FACErE TopAbs_SHELLrF TopAbs_SOLIDSolidrBrA)clsobjconstructor_lut shape_types rWcastz Mixin3D.castsd   f NND NND NND OOU OOU  s^ *z*8C=99rYctS)z9Unused - only here because Mixin1D is a subclass of Shape)NotImplementedrcrd directions rWextrudezMixin3D.extrudes rYc|tjk(r td|tjk(r^t }t j t|j}||j|t|j}|S|tjk(r|jj}S)aReturn center of object Find center of object Args: center_of (CenterOf, optional): center option. Defaults to CenterOf.MASS. Raises: ValueError: Center of GEOMETRY is not supported for this object NotImplementedError: Unable to calculate center of mass of this object Returns: Vector: center z3Center of GEOMETRY is not supported for this object)r,GEOMETRY ValueErrorMASSrr>shape_properties_LUTrBwrappedr7 CentreOfMass BOUNDING_BOX bounding_boxcenter)rV center_of properties calc_functionmiddles rWrvzMixin3D.centers )) )RS S  %%J!66y7NOM $,, 3J3356F (// /&&(//1F rYNc t|}rtfd|Dr td|Dcgc]}|j}}t }t j |jtjtj|t|j}|r|} |} n|} |} |D]W} r j} n|j| j} |j| | | tj| Y |j!|j#} | j%st& | Scc}w#t(t&f$r}td|d}~wwxYw)a]Chamfer Chamfers the specified edges of this solid. Args: length (float): length > 0, the length (length) of the chamfer length2 (Optional[float]): length2 > 0, optional parameter for asymmetrical chamfer. Should be `None` if not required. edge_list (Iterable[Edge]): a list of Edge objects, which must belong to this solid face (Face, optional): identifies the side where length is measured. The edge(s) must be part of the face Returns: Self: Chamfered solid c3HK|]}|jvs|ywN)edges).0edgefaces rW z"Mixin3D.chamfer..sJIDTZZ\1I4Is""z#Some edges are not part of the facez8Failed creating a chamfer, try a smaller length value(s)N)listanyrorrr#r"MapShapesAndAncestors_sr[r]r_r FindFromKeyFirstAddr%Face_s __class__r>is_validr r!)rVlengthlength2 edge_listre native_edges edge_face_mapchamfer_builder distance1 distance2 native_edge topo_face new_shapeerrs ` rWchamferzMixin3D.chamfersT.O JIJJ !FGG+459a 9 5BC && LL".."..- 4DLLA IIII'K LL )55kBHHJ   9k6==3K  ( '<'<'>?I%%'&&(K6@ !12 J  sE 5E E) E$$E)c t|dtr+t|}|D cgc]} t| d| dd} } n|} |j} | D]} t | | j|r |jn t |tz|d} || j|jn&|s|| jn| j|| j} |j| Scc} w)a~dprism Make a prismatic feature (additive or subtractive) Args: basis (Optional[Face]): face to perform the operation on bounds (list[Union[Face,Wire]]): list of profiles depth (float, optional): depth of the cut or extrusion. Defaults to None. taper (float, optional): in degrees. Defaults to 0. up_to_face (Face, optional): a face to extrude until. Defaults to None. thru_all (bool, optional): cut thru_all. Defaults to True. additive (bool, optional): Defaults to True. Returns: Solid: prismatic feature rr:NF) isinstancer<rCrErrr r&r0PerformPerformThruAllr>r)rVbasisboundsdepthtaper up_to_facethru_alladditivesorted_profilespfacesshaperfeats rWdprismzMixin3D.dprism s4 fQi &7?O0?@1T!A$!"&E@E-1\\D& !& KM D% Z//0U]##% U#JJLE#&~~e$$1AsC0cZ|Dcgc]}|j}}t|j}|D]}|j|| |j|j }|j st  |Scc}w#tt f$r}td|d|d}~wwxYw)a$Fillet Fillets the specified edges of this solid. Args: radius (float): float > 0, the radius of the fillet edge_list (Iterable[Edge]): a list of Edge objects, which must belong to this solid Returns: Any: Filleted solid z(Failed creating a fillet with radius of zQ, try a smaller value or use max_fillet() to find the largest valid fillet radiusN) rrrrrr>rr r!ro) rVradiusrrrfillet_builderrrrs rWfilletzMixin3D.filletAs,559a 9 51$,,?'K   v{ 3( ~';';'=>I%%'&&(#6 !12 :6(COP  sB 5BB*B%%B*g-C6?c v|r t|ng}|tjk(r tdtjt j tjt ji}t}|D]}|j|jt}|j|j|||d|||j|r+|jj!|j#} | S|jj!|j#j%dj} |j%dj} |dkDr t'| | } n t'| | } |jj!| j#j)} | S)anHollow Return the outer shelled solid of self. Args: faces (Optional[Iterable[Face]]): faces to be removed, which must be part of the solid. Can be an empty list. thickness (float): shell thickness - positive shells outwards, negative shells inwards. tolerance (float, optional): modelling tolerance of the method. Defaults to 0.0001. kind (Kind, optional): intersection type. Defaults to Kind.ARC. Raises: ValueError: Kind.TANGENT not supported Returns: Solid: A hollow solid. Kind.TANGENT not supportedT) IntersectionJoinr)rr-TANGENTroARCr GeomAbs_Arc INTERSECTIONrr$AppendrrrMakeThickSolidByJoinBuildrrgr>shellsr fix) rVr thickness tolerancekind kind_dictocc_faces_listr shell_builder return_valueshell1shell2sols rWhollowzMixin3D.hollow`s|2 %U " 4<< 9: : HH&22   /DD ./D  ! !$,, /56 ** LL   4 +   >>..}/B/B/DEL^^(()<)<)>?FFHKSSF[[]1%--F1}.vv>.vv> >>..syy{;??ALrYct|j}|jtt |j ||j tjk(xs|jS)aReturns whether or not the point is inside a solid or compound object within the specified tolerance. Args: point: tuple or Vector representing 3D point to be tested tolerance: tolerance for inside determination, default=1.0e-6 point: VectorLike: tolerance: float: (Default value = 1.0e-6) Returns: bool indicating whether or not point is within solid ) r rrrr+r7to_tupleStater[ TopAbs_IN IsOnAFace)rVpointrsolid_classifiers rW is_insidezMixin3D.is_insides\7t||D  )?)?)A!BIN%%'2<<7W;K;U;U;WWrYc.dfd js td|Dcgc]}|jc}tjdk(rt nt ddjjzd}|Scc}w)a5Find Maximum Fillet Size Find the largest fillet radius for the given Shape and edges with a recursive binary search. Example: max_fillet_radius = my_shape.max_fillet(shape_edges) max_fillet_radius = my_shape.max_fillet(shape_edges, tolerance=0.5, max_iterations=8) Args: edge_list (Iterable[Edge]): a sequence of Edge objects, which must belong to this solid tolerance (float, optional): maximum error from actual value. Defaults to 0.1. max_iterations (int, optional): maximum number of recursive iterations. Defaults to 10. Raises: RuntimeError: failed to find the max value ValueError: the provided Shape is invalid Returns: float: maximum fillet radius ch||zdz }| k(rtd d t j} D]}|j|| j |j }|j s  ||z kr|}|S|||dz}|S# $r|||dzcYSwxYw)Nz$Failed to find the max value within z in r:) RuntimeErrorrrrrrr>r) window_min window_maxcurrent_iteration window_midrrrr_Mixin3D__max_filletfillet_exceptionmax_iterationsrrVrs rW __max_filletz(Mixin3D.max_fillet..__max_fillets$z1Q6J N2":9+T.IYZ6dllCN+ "":{; , S NN>+?+?+AB  ))+**, J&)3)   , ,=,A   $ S#J +G+G'GK 6sBc |r t|ng}|tjk(r tdtjt j tjt jtjt ji}t}|D]}|j|jt}|j|j|||dd|||j |j!} |j(j+| } | jJ| j,dkr| jj/| S#t"t$f$r} t'd| d} ~ wwxYw)aQShell Make an offset solid of self. Args: openings (Optional[Iterable[Face]]): faces to be removed, which must be part of the solid. Can be an empty list. thickness (float): offset amount - positive offset outwards, negative inwards tolerance (float, optional): modelling tolerance of the method. Defaults to 0.0001. kind (Kind, optional): intersection type. Defaults to Kind.ARC. Raises: ValueError: Kind.TANGENT not supported Returns: Solid: A shelled solid. rT)rRemoveIntEdgesrz8offset Error, an alternative kind may resolve this errorNr)rr-rrorrrrrGeomAbs_Tangentr$rrrrrrr>r!r rrrgvolumeReverse) rVopeningsrrrrrroffset_builderoffset_occt_solidr offset_solids rW offset_3dzMixin3D.offset_3dsb0&.4>2 4<< 9: : HH&22   /DD LL*:: ./D  ! !$,, /67++ LL   4 ,    . 4 4 6  ~~**+<= ##///    "  ( ( * !12 J  s6EE:) E55E:c.tj|dS)zReturn the Solidrb)r>get_single_shaperUs rWsolidz Mixin3D.solidDs%%dG44rYc.tj|dS)z%solids - all the solids in this Shaperb)r>get_shape_listrUs rWsolidszMixin3D.solidsHs##D'22rY)returnz int | None)rdr'rr9)rdr>rkr8rz&Edge | Face | Shell | Solid | Compound)rwr,rr7r}) rrr float | NonerIterable[Edge]r Face | Nonerr9)NrNTT)rrrzlist[Face | Wire]rrrrrrrboolrrrrb)rrrrrr9) rIterable[Face] | Nonerrrrrr-rrb)gư>)rr8rrrr)g? )rrrrrr) rrrrrrrr-rrb)rz Solid | None)rzShapeList[Solid])&__name__ __module__ __qualname____doc__r=project_to_viewportsplitrDfind_intersection_pointsverticesvertexr~rwireswirerrrshellpropertyrX classmethodrgrlr,rprvrrrr-rrrrrrrrTrYrWrQrQys^7!55 MME&??H ^^F MME <! AAA" A  A  AN#"&4%4%"4% 4%  4%  4%4%4% 4%lF"XX A$AA A  A  AFX, J!J J  J`"XX @'@@ @  @  @D53rYrQceZdZdZdZ d dfd Zed dZed!dZ e d"dZ ed#dZ e d$ d%d Z e d& d'd Z eejf d(d Zed)d Zeej&f d*dZeej&df d+dZeej&df d,dZed-d.dZeej&dddf d/dZeej&dddf d0dZeej&f d1dZe d$ d2dZedd ddej:f d3dZe d4 d5dZe d$ d6dZ xZ!S)7rbaA Solid in build123d represents a three-dimensional solid geometry in a topological structure. A solid is a closed and bounded volume, enclosing a region in 3D space. It comprises faces, edges, and vertices connected in a well-defined manner. Solid modeling operations, such as Boolean operations (union, intersection, and difference), are often performed on Solid objects to create or modify complex geometries.g@Nct|trtj|}t||||||dn||_|i|_y||_y)aBuild a solid from an OCCT TopoDS_Shape/TopoDS_Solid Args: obj (TopoDS_Shape | Shell, optional): OCCT Solid or Shell. label (str, optional): Defaults to ''. color (Color, optional): Defaults to None. material (str, optional): tag for external tools. Defaults to ''. joints (dict[str, Joint], optional): names joints. Defaults to None. parent (Compound, optional): assembly parent. Defaults to None. )rdlabelcolorparentN)rrFrb _make_solidsuper__init__materialjoints)rVrdr r rrr rs rWrzSolid.__init__Xs^( c5 !##C(C   '.H "Nb  rYc,tj|S)z!volume - the volume of this Solid)r> compute_massrUs rWrz Solid.volume{s!!$''rYcHtj|jS)z,Create a Solid object from the surface shell)rSolidFromShellrr)rcrs rWrzSolid._make_solids..u}}==rYcd}t|trkt}|j|j j |j |j|j|d}|St|ttfr*|j|jjd|S)NFT) rr7r* SetLocation start_pointto_pnt SetDirectionto_dirSetModer<r;to_wirerr)rcbuilderpathbinormalrotatecoordinate_systems rW_set_sweep_modezSolid._set_sweep_modes h ' &   ) )$*:*:*<*C*C*E F  * *8??+< = OO- .F 4, / OOH,,.66 = rYcfttjt|j|S)a/extrude Extrude a Face into a Solid. Args: direction (VectorLike): direction and magnitude of extrusion Raises: ValueError: Unsupported class RuntimeError: Generated invalid result Returns: Edge: extruded shape )rbr%Solid_srGrrrjs rWrlz Solid.extrudes$ V^^$9#++y$QRSSrYc |r|ng}t|}t|} dd}t|tr!|j}|j }n|}t j ||j|}tj|gdj} d|z |jz} tt j| |jd||gj} ||j| | } |D cgc]} || j| | }} t|}tt| |j!Scc} w)anExtrude with Rotation Creates a 'twisted prism' by extruding, while simultaneously rotating around the extrusion vector. Args: section (Union[Face,Wire]): cross section vec_center (VectorLike): the center point about which to rotate vec_normal (VectorLike): a vector along which to extrude the wires angle (float): the angle to rotate through while extruding inner_wires (list[Wire], optional): holes - only used if section is of type Wire. Defaults to None. Returns: Solid: extruded object ct|}|j|d|j||j|j |j S)zHelper functionF)rrrr MakeSolidr>)rspine aux_spineextrude_builders rWextrude_aux_spinez=Solid.extrude_linear_with_rotation..extrude_aux_spinesS:%@O  # #Iu 5    %  ! ! #  % % '"((* *rYrgv@r:)rvnormal)rr)r+r)r,r)rr')r7rrE outer_wire inner_wiresr; make_lineaddr<combinerrr make_helixrJrbr r>)rcsectionrvr/angler1r.r0straight_spine_estraight_spine_wpitch aux_spine_w outer_solidw inner_solids inner_comps rWextrude_linear_with_rotationz"Solid.extrude_linear_with_rotationseF&1kb  + +&1 +>I +  + gt $ ++-J!--/K J >>&&**V2DE<<)9(:;A>FF  - __UFMM1VF S T '  (    0+ !   aii)9; G   7|D _[*=CCEFF sETc :t|}|j|jk(rt|jj dkDro|dkDrj|j sZt|j|jtt|z t|}t|j}|S|j tt|z}|j}t|j!|} | j#|t$j&} t|j)| } | j+t-||jg|j z} g} t/| D]\}}|dkDr|rdnd}t|j!|}|j#||zt$j&}t|j)|}|j+t-|| j1|t3| | Dcgc]\}}tj5||g}}}t7|dkDr+|dj8|dd}t;|tsJ|}|S|d}|Scc}}w)aExtrude a cross section with a taper Extrude a cross section into a prismatic solid in the provided direction. Note that two difference algorithms are used. If direction aligns with the profile normal (which must be positive), the taper is positive and the profile contains no holes the OCP LocOpe_DPrism algorithm is used as it generates the most accurate results. Otherwise, a loft is created between the profile and the profile with a 2D offset set at the appropriate direction. Args: section (Face]): cross section normal (VectorLike): a vector along which to extrude the wires. The length of the vector controls the length of the extrusion. taper (float): taper angle in degrees. flip_inner (bool, optional): outer and inner geometry have opposite tapers to allow for part extraction when injection molding. Returns: Solid: extruded cross section r)rr:N)r7 normalized normal_atr6z_dirZr1rrrrrrrbr>rr0to_local_coords offset_2dr-rfrom_local_coordsmover4 enumerateappendzip make_loftlencutr)rcprofilerkr flip_inner prism_builder new_solid offset_amtouter local_outerlocal_taper_outer taper_outer profile_wires taper_wiresirfliplocal local_taper taper_wirertr complex_solids rW extrude_taperzSolid.extrude_tapersh49%   "g&7&7&9 9g$$&&* ''))  3wu~#66M m1134ID?$***S-@@J&&(E %g > >u EK + 5 5!2!2!6!  .::;LMK   Xi0 1$//12W5H5H5JJMK$]34Uzrq#Gn<#C#CK#P  34"":. 458 {4S4SDAqA'4S 6{Q -q vabz : !-777) #1I s3!JcXt|}|tjtjfvr8|dz}|tjk(rtjntj }t ||g}|tjk(r||zn| |z}t|j|}tj|||z}g} |j||D]7} t| tr| j| %| | jz } 9| D cgc]2} | j r"| j#j%|dk(s| 4} } | s t'd| D cgc]&} tj| |j)(} } | Dcgc]}|j*dkDs|} }|tjk(rR|j-|}t|t.r|j1|d}n|}| D]} |j-|}n|j9|}t|t.r|}n| t/}n t/|g}| D]G} |j9|}|1|j|j;j1|dItj<|}j;j1|d}|Scc} wcc} wcc}w#t2$rt5j6ddY wxYw#t2$rt5j6ddYwxYw) aextrude_until Extrude section in provided direction until it encounters either the NEXT or LAST surface of target_object. Note that the bounding surface must be larger than the extruded face where they contact. Args: section (Face): Face to extrude target_object (Union[Compound, Solid]): object to limit extrusion direction (VectorLike): extrusion direction until (Until, optional): surface to limit extrusion. Defaults to Until.NEXT. Raises: ValueError: provided face does not intersect target_object Returns: Union[Compound, Solid]: extruded Face rBrz.provided face does not intersect target_objectg& .>rz+clipping error - extrusion may be incorrectr) stacklevel)r7r/PREVIOUSFIRSTNEXTLASTrHr1rvrbrlproject_to_shaperrErLr is_planarrDdotrorrrPr?sort_by Exceptionwarningswarn intersectrfuse)rcr6 target_objectrkuntil max_dimensionclipping_directiondirection_axis extrusionrrf clip_facesclipping_objectsotrimmed_extrusionclosest_extrusionclipping_objectextrusion_shapes base_partextrusion_partsclipped_extrusionresults rW extrude_untilzSolid.extrude_untilLs49% U^^U[[1 1 OI"'5>>"9EJJuzzE*G]+CD  "  %m+  gnn.0BCMM'9}+DE ,,]IFD$% T"% G KKAKKM$5$5i$@C$G   MN NAK @J1EMM!/ 0 4 4 6   (8K'7!188d?A'7K EJJ  ) m < +Y7$5$=$=n$Ma$P!$5!#3'8'<'<_'M$ $4"++M:I)Y/"+""++"+YK"8#3 (1(;(;O(L%(4'..-446>>~NqQ $4 %zz?; !((*22>B1E o  L!MME#$(!MME#$s=7K +KK&K=KAL LL L)(L)ct|tr>tj|jj t |jStt |j dz j|j}tj|jj|jj|jj|S)z)A box of the same dimensions and locationr)plane)rr2rbmake_boxsizelocater4minr6rJlocationXYrF)rcbbox moved_planes rWfrom_bounding_boxzSolid.from_bounding_boxs dH %>>499-44Xdhh5GH H!&x Q'?!@!E!Edmm!TK>> TYY[[$))++[" rYcb|t|j|||jS)a<make box Make a box at the origin of plane extending in positive direction of each axis. Args: length (float): width (float): height (float): plane (Plane, optional): base plane. Defaults to Plane.XY. Returns: Solid: Box )r to_gp_ax2r>)rcrwidthheightrs rWrzSolid.make_boxs5" !   eg   rYihc r|t|j||||tzjS)afmake cone Make a cone with given radii and height Args: base_radius (float): top_radius (float): height (float): plane (Plane): base plane. Defaults to Plane.XY. angle (float, optional): arc size. Defaults to 360. Returns: Solid: Full or partial cone )rrr0r>)rc base_radius top_radiusrrr7s rW make_conezSolid.make_cones<. !   eg  rYc p|t|j|||tzjS)avmake cylinder Make a cylinder with a given radius and height with the base center on plane origin. Args: radius (float): height (float): plane (Plane): base plane. Defaults to Plane.XY. angle (float, optional): arc size. Defaults to 360. Returns: Solid: Full or partial cylinder )rrr0r>)rcrrrr7s rW make_cylinderzSolid.make_cylinders9* $!   eg   rYFc(|t|d|S)amake loft Makes a loft from a list of wires and vertices. Vertices can appear only at the beginning or end of the list, but cannot appear consecutively within the list nor between wires. Args: objs (list[Vertex, Wire]): wire perimeters or vertices ruled (bool, optional): stepped or smooth. Defaults to False (smooth). Raises: ValueError: Too few wires Returns: Solid: Lofted object T)rI)rcobjsruleds rWrNzSolid.make_lofts$:dD%011rYiZc |t|j||tz|tz|tzjS)aSphere Make a full or partial sphere - with a given radius center on the origin or plane. Args: radius (float): plane (Plane): base plane. Defaults to Plane.XY. angle1 (float, optional): Defaults to -90. angle2 (float, optional): Defaults to 90. angle3 (float, optional): Defaults to 360. Returns: Solid: sphere )rrr0r>)rcrrangle1angle2angle3s rW make_spherezSolid.make_sphere0sG. "!     eg  rYrc |t|j|||tz|tz|tzjS)amake torus Make a torus with a given radii and angles Args: major_radius (float): minor_radius (float): plane (Plane): base plane. Defaults to Plane.XY. start_angle (float, optional): start major arc. Defaults to 0. end_angle (float, optional): end major arc. Defaults to 360. Returns: Solid: Full or partial torus )rrr0r>)rc major_radius minor_radiusr start_angle end_angle major_angles rW make_toruszSolid.make_torusQsJ0 !!g%G#g%  eg  rYc j|t|j|||||||jS)aOMake a wedge Args: delta_x (float): delta_y (float): delta_z (float): min_x (float): min_z (float): max_x (float): max_z (float): plane (Plane): base plane. Defaults to Plane.XY. Returns: Solid: wedge )rrrb) rcdelta_xdelta_ydelta_zmin_xmin_zmax_xmax_zrs rW make_wedgezSolid.make_wedgetsA6 !! eg  rYc|r|ng}t|tr t||}n|}t|j|j|t zd}||j S)aRevolve Revolve a cross section about the given Axis by the given angle. Args: section (Union[Face,Wire]): cross section angle (float): the angle to revolve through axis (Axis): rotation Axis inner_wires (list[Wire], optional): holes - only used if section is of type Wire. Defaults to []. Returns: Solid: the revolved cross section T)rr<rErrrr0r>)rcr6r7axisr1 section_face revol_builders rWrevolvez Solid.revolvesb,&1kb gt $5L"L-  LL GO   =&&())rYct|tr!|j}|j}n|}|r|ng}g} |g|zD]} t |j j } d} |rtj| ||} n| j|| jtj|| j| j d| | j|r| j| j!t"j%| j| d| dd}} |r#| j&|}t|tsJ|S| S)a)Sweep Sweep the given cross section into a prismatic solid along the provided path Args: section (Union[Face, Wire]): cross section to sweep path (Union[Wire, Edge]): sweep path inner_wires (list[Wire]): holes - only used if section is a wire make_solid (bool, optional): return Solid or Shell. Defaults to True. is_frenet (bool, optional): Frenet mode. Defaults to False. mode (Union[Vector, Wire, Edge, None], optional): additional sweep mode parameters. Defaults to None. transition (Transition, optional): handling of profile orientation at C1 path discontinuities. Defaults to Transition.TRANSFORMED. Returns: Solid: the swept cross section Frr:N)rrEr0r1rrrrrbr%rSetTransitionModer>_transModeDictrrr*rLrQrgrP)rcr6r!r1 make_solid is_frenetmode transitionr0shapesrr r# outer_shape inner_shapeshollow_outer_shapes rWsweepz Solid.sweeps4: gt $ ++-J!--/K J)4+"KL;.D1$,,.2H2HIGF..wdC *  % %e&:&::&F G KK eV 4 MMO!!# MM',,w}}7 8'/*%+1Ivabz\ !0,!? 0%8 88% %rYc|jj}t|}d}d} |r|j|||} n|j ||D]K} t | t r | jn| jj}|j||| M|j|r|j||jS)aaMulti section sweep Sweep through a sequence of profiles following a path. Args: profiles (Iterable[Union[Wire, Face]]): list of profiles path (Union[Wire, Edge]): The wire to sweep the face resulting from the wires over make_solid (bool, optional): Solid or Shell. Defaults to True. is_frenet (bool, optional): Select frenet mode. Defaults to False. binormal (Union[Vector, Wire, Edge, None], optional): additional sweep mode parameters. Defaults to None. Returns: Solid: swept object F) rrrrr%rrr<r0rrr*r>) rcprofilesr!rrr" path_as_wirer  translater#rQs rW sweep_multizSolid.sweep_multis0||~-- -l;  (($AF OOI &Ggt,'')11  KK i 8         7==?##rYc |}t|tr_|]|j}|j|j }|j t |j dkr| }t}|j|j|dtddtdd |j t|j}|S#t$r} t!d| d} ~ wwxYw)aThicken Face or Shell Create a solid from a potentially non planar face or shell by thickening along the normals. .. image:: thickenFace.png Non-planar faces are thickened both towards and away from the center of the sphere. Args: depth (float): Amount to thicken face(s), can be positive or negative. normal_override (Vector, optional): Face only. The normal_override vector can be used to indicate which way is 'up', potentially flipping the face normal direction such that many faces with different normals all go in the same direction (direction need only be +/- 90 degrees from the face normal). Defaults to None. Raises: RuntimeError: Opencascade internal failures Returns: Solid: The resulting Solid object Nrgh㈵>TF)OffsetTolModer SelfInterr Thickeningrz'Error applying thicken to given surface)rrErvrDrCrlr7r InitializerrrrMakeOffsetShaperbr>r!r) rcsurfacernormal_overrideadjusted_depthsurface_centersurface_normalrrrs rWthickenz Solid.thicken7s> gt $)D$^^-N$..~>IIKN!!&"9"D"D"FG!K"'.0!! OO! % "  &&( S>//12F  SHIs R Ss9C C. C))C.)NrNrNN) rdzTopoDS_Solid | Shell | Noner strr z Color | Nonerrrzdict[str, Joint] | Noner zCompound | None)rr)rrFrr()r rr! Wire | Edger"zVector | Wire | Edgerr)rdrErkr8rrbr}) r6 Face | Wirervr8r/r8r7rr1list[Wire] | Nonerrb)T) rQrErkr8rrrRrrrb) r6rErsCompound | Solidrkr8rtr/rr)rzBoundBox | OrientedBoundBoxrrb) rrrrrrrr6rrb) rrrrrrrr6r7rrrb) rrrrrr6r7rrrb)F)rzIterable[Vertex | Wire]rrrrb) rrrr6rrrrrrrrb)rrrrrr6rrrrrrrrb)rrrrrrrrrrrrrrrr6rrb) r6rr7rrr1r1rrrb)r6rr!rr1rrrrrrVector | Wire | Edge | Nonerr.rrb)TFN) rzIterable[Wire | Face]r!rrrrrr"rrrb)rz Face | ShellrrrzVectorLike | Nonerrb)"rrrrorderrrrrrr%rlr@rcr/rhrrr6XYrrrrNrrrrr. TRANSFORMEDrrr __classcell__)rs@rWrbrbMs= E ,0"*."&7 (77 7  7 ( 7 7F((>>,'   &TT"*. PGPGPG PG  PG ' PG PGPGdTXHH'1H:?HMQH HHT zz ii(i i  i  iiVHM  #( 27 @E   2 xx             @ xx           :22&xx             @ xx                    Dxx% % %  %  %  % % % %  % % N *. "*"*"* "* ' "*  "*"*H *.,0!+!7!7@@@' @  @  @*@@ @@D  04 0$'0$0$ 0$  0$ . 0$ 0$0$d .2 999+ 9  99rYrb)sr __future__rrromathrrrtypingrrcollections.abcr OCP.TopAbsTopAbsr[OCP.BRepAlgoAPIr OCP.BRepBuilderAPIr OCP.BRepClass3dr OCP.BRepFeatr OCP.BRepFilletAPIrrOCP.BRepOffsetrrOCP.BRepOffsetAPIrrOCP.BRepPrimAPIrrrrrrr OCP.GPropr OCP.GeomAbsrr OCP.LocOper OCP.ShapeFixr OCP.Standardr OCP.StdFailr! OCP.TopExpr" OCP.TopToolsr#r$ OCP.TopoDSr%r&r'r(r)OCP.gpr*r+build123d.build_enumsr,r-r.r/build123d.geometryr0r1r2r3r4r5r6r7r8typing_extensionsr9one_dr;r<r= shape_corer>r?r@rArBtwo_drCrDrErFutilsrGrHrIrJzero_drK compositerLrMrNrOrQrbrTrYrWrs4l#""'$+77,QAW#>$')'XSS!CC   #&&DDBB 88Q3eQ3hd GU<(d rY