^jPdZddlmZddlmZddlmZmZddlm Z ddl m Z m Z ddl mZmZddlmZdd lmZmZmZmZmZmZdd lmZmZmZmZmZmZm Z m!Z!Gd d eZ"Gd de"Z#Gdde"Z$Gdde"Z%Gdde"Z&Gdde"Z'Gdde"Z(Gdde"Z)Gdde"Z*Gdde"Z+Gdd e"Z,y!)"a Part Objects name: objects_part.py by: Gumyr date: March 22nd 2023 desc: This python module contains objects (classes) that create 3D 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)Iterable)radianstan) ConvexHull) LocationListvalidate_inputs)AlignMode) BuildPart)LocationPlaneRotation RotationLikeVector VectorLike)CompoundFacePart ShapeListShellSolidWiretuplifycheZdZdZej gZddejf dfd Z xZ S)BasePartObjectaBasePartObject Base class for all BuildPart objects & operations Args: solid (Solid): object to create rotation (RotationLike, optional): angles to rotate about axes. Defaults to (0, 0, 0) align (Align | tuple[Align, Align, Align] | None, optional): align MIN, CENTER, or MAX of object. Defaults to None mode (Mode, optional): combination mode. Defaults to Mode.ADD rrrNc|Gt|d}|j}|j|}|jt |t j |d}t|trt|n|}||_ |#|tk7r|j|gn|g} n||_ tj s tdtj jD cgc]2} |tk7s | t k7r|j| |zn|4} } t|t r|j | d|it#| dkDrt%| j&} n8t| dt$r| dj&} nt%| j&} t( |U| |j,|j.|j0|j2|j4ycc} w) NF)logzNo valid context foundmoder)objlabelmaterialjointsparentchildren)r bounding_boxto_align_offsetmover r _get_context isinstancetuplerrotationmovedr!r RuntimeError locations_add_to_contextlenrwrappedsuper__init__r$r%r&r'r() selfpartr/alignr!bboxoffsetcontextrotate new_solidslocationnew_part __class__s O/opt/ringagent/.cad-venv/lib/python3.12/site-packages/build123d/objects_part.pyr7zBasePartObject.__init__Is  E1%E$$&D))%0F IIhv& '$-$:$:4U$K(28U(C8$ ?178:1E$**V,-D6JDI,,."#;<<!- 9 9 ; E E  +x8:/EJJx&01J'9-'''?$? z?Q  +33H  1 x 0!!},,H +33H **]];;;;]]  %s.7G-)r9z Part | Solidr/rr:)Align | tuple[Align, Align, Align] | Noner!r ) __name__ __module__ __qualname____doc__r _tag _applies_tor ADDr7 __classcell__rBs@rCrr:sU >>"K "+;?XX 1 1 1 9 1  1 1 rceZdZdZej gZdejejejfe jf dfd Z xZ S)Boxa Part Object: Box Create a box defined by length, width, and height. Args: length (float): box length width (float): box width height (float): box height rotation (RotationLike, optional): angles to rotate about axes. Defaults to (0, 0, 0) align (Align | tuple[Align, Align, Align] | None, optional): align MIN, CENTER, or MAX of object. Defaults to (Align.CENTER, Align.CENTER, Align.CENTER) mode (Mode, optional): combine mode. Defaults to Mode.ADD rctj|}t||||_||_||_t j|||}t |%||t|d|yNrr9r/r:r!) r r,r lengthwidth box_heightrmake_boxr6r7r) r8rTrUheightr/r:r!r=solidrBs rCr7z Box.__init__sh%.$:$:4$@&   vuf5 1B  rN) rTfloatrUrZrXrZr/rr:"Align | tuple[Align, Align, Align]r!r rErFrGrHr rIrJr CENTERr rKr7rLrMs@rCrPrP}s >>"K"+ LL LL LL5 XX       2    rNrPceZdZdZej gZddejejejfe jf dfd Z xZ S)ConeaPart Object: Cone Create a cone defined by bottom radius, top radius, and height. Args: bottom_radius (float): bottom radius top_radius (float): top radius, may be zero height (float): cone height arc_size (float, optional): angular size of cone. Defaults to 360 rotation (RotationLike, optional): angles to rotate about axes. Defaults to (0, 0, 0) align (Align | tuple[Align, Align, Align] | None, optional): align MIN, CENTER, or MAX of object. Defaults to (Align.CENTER, Align.CENTER, Align.CENTER) mode (Mode, optional): combine mode. Defaults to Mode.ADD hrctj|}t||||_||_||_||_||_tj||||} t |-| |t|d|yN)anglerrS) r r,r bottom_radius top_radius cone_heightarc_sizer:r make_coner6r7r) r8rdrerXrgr/r:r!r=rYrBs rCr7z Cone.__init__s%.$:$:4$@&*$!         1B  rN)rdrZrerZrXrZrgrZr/rr:r[r!r r\rMs@rCr_r_s >>"K!* LL LL LL5 XX            2     rNr_c|eZdZdZej gZdeje jf dfd Z xZ S)ConvexPolyhedronaPart Object: ConvexPolyhedron Create a convex solid from the convex hull of the provided points. Args: points (Iterable[VectorLike]): vertices of the polyhedron rotation (RotationLike, optional): angles to rotate about axes. Defaults to (0, 0, 0) align (Align | tuple[Align, Align, Align] | None, optional): align MIN, CENTER, or MAX of object. Defaults to Align.NONE mode (Mode, optional): combine mode. Defaults to Mode.ADD rctj|}t|||Dcgc]}tt |}}t |j j}g} |D]A} | D cgc]} ||  } } | jttj| Ctt| j} t|A| |t#|d|ycc}wcc} wrR)r r,r r.rr simplicestolistappendrr make_polygonrrcleanr6r7r)r8pointsr/r:r!r=ppnts convex_hullpolyhedron_facesface_vertex_indicesicorner_vertices polyhedronrBs rCr7zConvexPolyhedron.__init__s%.$:$:4$@&7=>!U6!9->>!&00779 #. N 0CD1tAwDOD  # #D):):?)K$L M N 5!12399;  hgeQ6Gd  ?Es C/2 C4)rqzIterable[VectorLike]r/rr:rDr!r ) rErFrGrHr rIrJr NONEr rKr7rLrMs@rCrjrjsY >>"K "+;@::XX  $  9     rNrjcjeZdZdZej gZdejf dfd Z xZ S)CounterBoreHoleaPart Operation: Counter Bore Hole Create a counter bore hole defined by radius, counter bore radius, counter bore and depth. Args: radius (float): hole radius counter_bore_radius (float): counter bore radius counter_bore_depth (float): counter bore depth depth (float, optional): hole depth, through part if None. Defaults to None mode (Mode, optional): combination mode. Defaults to Mode.SUBTRACT Nc  tj|}t||||_||_||_|||_n!|||j|_n td||_ tj||j tddjtj|||j ztdd| f}t|tr t!|}n|}t" |I|d|y)NNo depth providedrrroriginz_dirrr9r/r!)r r,r radiuscounter_bore_radiuscounter_bore_depth hole_depth max_dimension ValueErrorr!r make_cylinderrfuser-rrr6r7) r8rrrdepthr!r=fusedrYrBs rCr7zCounterBoreHole.__init__s%.$:$:4$@& #6 "4  #DO ]w2%33DO01 1 ## DOOU):%N $   #"T__4q!0012    eY 'KEE eidCrN) rrZrrZrrZr float | Noner!r rErFrGrHr rIrJr SUBTRACTr7rLrMs@rCr|r| sc >>"K#]] #D#D##D" #D  #D  #D#DrNr|cleZdZdZej gZddejf dfd Z xZ S)CounterSinkHoleaPart Operation: Counter Sink Hole Create a countersink hole defined by radius, countersink radius, countersink angle, and depth. Args: radius (float): hole radius counter_sink_radius (float): countersink radius depth (float, optional): hole depth, through part if None. Defaults to None counter_sink_angle (float, optional): cone angle. Defaults to 82 mode (Mode, optional): combination mode. Defaults to Mode.SUBTRACT NRc `tj|}t||||_||_|||_n!|||j |_n td||_||_ |tt|dz z }tj||j tddjtj |d|tddtj||j }t#|t$r t'|} n|} t( |U| d|y)Nr~g@rrrgr)r r,r rcounter_sink_radiusrrrcounter_sink_angler!rrrrrrrhr-rrr6r7) r8rrrrr!r=rfrrYrBs rCr7zCounterSinkHole.__init__Os%.$:$:4$@& #6  #DO ]w2%33DO01 1"4 )C8JS8P0Q,RR ## DOOU):%N $ OO#Yj9      3T__ E   eY 'KEE eidCrN) rrZrrZrrrrZr!r rrMs@rCrr?sf >>"K #$&]] 'D'D#'D 'D " 'D  'D'DrNrceZdZdZej gZddejejejfe jf dfd Z xZ S)CylinderaBPart Object: Cylinder Create a cylinder defined by radius and height. Args: radius (float): cylinder radius height (float): cylinder height arc_size (float, optional): angular size of cone. Defaults to 360. rotation (RotationLike, optional): angles to rotate about axes. Defaults to (0, 0, 0) align (Align | tuple[Align, Align, Align] | None, optional): align MIN, CENTER, or MAX of object. Defaults to (Align.CENTER, Align.CENTER, Align.CENTER) mode (Mode, optional): combine mode. Defaults to Mode.ADD r`rctj|}t||||_||_||_||_tj|||}t |)||t|d|yrb) r r,r rcylinder_heightrgr:rrr6r7r) r8rrXrgr/r:r!r=rYrBs rCr7zCylinder.__init__sy%.$:$:4$@& %   ##    1B  rN) rrZrXrZrgrZr/rr:r[r!r r\rMs@rCrrys >>"K !* LL LL LL5 XX       2    rNrcbeZdZdZej gZdejf dfd Z xZ S)HoleaPart Operation: Hole Create a hole defined by radius and depth. Args: radius (float): hole radius depth (float, optional): hole depth, through part if None. Defaults to None mode (Mode, optional): combination mode. Defaults to Mode.SUBTRACT Nctj|}t||||_| d|z|_n$||d|j z|_n t d||_|dd|jdz fnd}tj||jt|d}t|1|tjtjtjfd|y)Nr~rrrr)r9r:r/r!)r r,r rrrrr!rrrr6r7r r])r8rrr!r= hole_startrYrBs rCr7z Hole.__init__s %.$:$:4$@&  %iDO ]w2'"7"77DO01 1 5:MaDOOa/0y ## DOOU*J%O  <<u||<  rN)rrZrrr!r rrMs@rCrrsH>>"K #]]       rNrceZdZdZej gZddddejejejfe jf dfd Z xZ S)SphereaPart Object: Sphere Create a sphere defined by a radius. Args: radius (float): sphere radius arc_size1 (float, optional): angular size of bottom hemisphere. Defaults to -90. arc_size2 (float, optional): angular size of top hemisphere. Defaults to 90. arc_size3 (float, optional): angular revolution about pole. Defaults to 360. rotation (RotationLike, optional): angles to rotate about axes. Defaults to (0, 0, 0) align (Align | tuple[Align, Align, Align] | None, optional): align MIN, CENTER, or MAX of object. Defaults to (Align.CENTER, Align.CENTER, Align.CENTER) mode (Mode, optional): combine mode. Defaults to Mode.ADD iZr`rctj|}t||||_||_||_||_||_tj||||} t |-| |t|d|y)N)angle1angle2angle3rrS) r r,r r arc_size1 arc_size2 arc_size3r:r make_spherer6r7r) r8rrrrr/r:r!r=rYrBs rCr7zSphere.__init__s%.$:$:4$@& """ !!    1B  rN)rrZrrZrrZrrZr/rr:r[r!r r\rMs@rCrrs >>"K !* LL LL LL5 XX         2   rNrceZdZdZej gZddddejejejfe jf dfd Z xZ S)TorusaPart Object: Torus Create a torus defined by major and minor radii. Args: major_radius (float): major torus radius minor_radius (float): minor torus radius minor_start_angle (float, optional): angle to start minor arc. Defaults to 0 minor_end_angle (float, optional): angle to end minor arc. Defaults to 360 major_angle (float, optional): angle to revolve minor arc. Defaults to 360 rotation (RotationLike, optional): angles to rotate about axes. Defaults to (0, 0, 0) align (Align | tuple[Align, Align, Align] | None, optional): align MIN, CENTER, or MAX of object. Defaults to (Align.CENTER, Align.CENTER, Align.CENTER) mode (Mode, optional): combine mode. Defaults to Mode.ADD rr`rc  tj|} t| |||_||_||_||_||_||_tj|||||} t |1| |t|d|y)N) start_angle end_angle major_anglerrS)r r,r major_radius minor_radiusminor_start_angleminor_end_anglerr:r make_torusr6r7r) r8rrrrrr/r:r!r=rYrBs rCr7zTorus.__init__s%.$:$:4$@&((!2.&    )%#   1B  rN)rrZrrZrrZrrZrrZr/rr:r[r!r r\rMs@rCrr s >>"K $%!$ !* LL LL LL5 XX" " " ! "  "  " " 2" " " rNrceZdZdZej gZdejejejfe jf dfd Z xZ S)WedgeaPart Object: Wedge Create a wedge with a near face defined by xsize and z size, a far face defined by xmin to xmax and zmin to zmax, and a depth of ysize. Args: xsize (float): length of near face along x-axis ysize (float): length of part along y-axis zsize (float): length of near face z-axis xmin (float): minimum position far face along x-axis zmin (float): minimum position far face along z-axis xmax (float): maximum position far face along x-axis zmax (float): maximum position far face along z-axis rotation (RotationLike, optional): angles to rotate about axes. Defaults to (0, 0, 0) align (Align | tuple[Align, Align, Align] | None, optional): align MIN, CENTER, or MAX of object. Defaults to (Align.CENTER, Align.CENTER, Align.CENTER) mode (Mode, optional): combine mode. Defaults to Mode.ADD rc tj|} t| |t|||fD cgc]} | dk c} r t d||_||_||_||_||_ ||_ ||_ | |_ tj|||||||} t|A| |t#| d| ycc} w)Nrz2xsize, ysize & zsize must all be greater than zerorrS)r r,r anyrxsizeysizezsizexminzminxmaxzmaxr:r make_wedger6r7r)r8rrrrrrrr/r:r!r=valuerYrBs rCr7zWedge.__init__\s"%.$:$:4$@& u(=>u > ?QR R          udD$M 1B  ?s B>)rrZrrZrrZrrZrrZrrZrrZr/rr:r[r!r r\rMs@rCrrDs&>>"K"+ LL LL LL5 XX# # #  #  #  # # # # 2# # # rNrN)-rH __future__rcollections.abcrmathrr scipy.spatialrbuild123d.build_commonrr build123d.build_enumsr r build123d.build_partr build123d.geometryr rrrrrbuild123d.topologyrrrrrrrrrrPr_rjr|rrrrrrrNrCrs8#$$@-*   @ T@ F) .) X2 >2 j) ~) X2Dn2Dj7Dn7Dt- ~- `, >, ^1 ^1 h5 N5 p; N; rN