^j/(dZddlmZddlZddlmZmZddlmZddl m Z m Z ddl m ZddlmZddlmZdd lmZdd lmZmZmZmZdd lmZdd lmZmZmZm Z m!Z!m"Z"dd l#m$Z$ddl%m&Z&m'Z'm(Z(m)Z)m*Z*erddl+m,Z,m-Z-Gdde&eZ. ddZ/y)a build123d topology name: zero_d.py by: Gumyr date: January 07, 2025 desc: This module provides the foundational implementation for zero-dimensional geometry in the build123d CAD system, focusing on the `Vertex` class and its related operations. A `Vertex` represents a single point in 3D space, serving as the cornerstone for more complex geometric structures such as edges, wires, and faces. It is directly integrated with the OpenCascade kernel, enabling precise modeling and manipulation of 3D objects. Key Features: - **Vertex Class**: - Supports multiple constructors, including Cartesian coordinates, iterable inputs, and OpenCascade `TopoDS_Vertex` objects. - Offers robust arithmetic operations such as addition and subtraction with other vertices, vectors, or tuples. - Provides utility methods for transforming vertices, converting to tuples, and iterating over coordinate components. - **Intersection Utilities**: - Includes `topo_explore_common_vertex`, a utility to identify shared vertices between edges, facilitating advanced topological queries. - **Integration with Shape Hierarchy**: - Extends the `Shape` base class, inheriting essential features such as transformation matrices and bounding box computations. This module plays a critical role in defining precise geometric points and their interactions, serving as the building block for complex 3D models in the build123d library. 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)overload TYPE_CHECKING)Iterable)Self deprecated) BRep_Tool)BRepBuilderAPI_MakeVertex)TopExp_Explorer)TopoDS TopoDS_Shape TopoDS_Vertex TopoDS_Edge)gp_Pnt)MatrixVector VectorLikeLocationAxisPlane)Keep)Shape ShapeList TrimmingTooldowncast shapetype)EdgeWirecZeZdZdZdZedZeddZeddZeddZfdZeddZedd Z e dd Z e dd Z d d!d Z d"d ZdZdZd#dZd$dZd%dZej*fd&dZedd'dZd(dZd)dZd*dZxZS)+VertexaA Vertex in build123d represents a zero-dimensional point in the topological data structure. It marks the endpoints of edges within a 3D model, defining precise locations in space. Vertices play a crucial role in defining the geometry of objects and the connectivity between edges, facilitating accurate representation and manipulation of 3D shapes. They hold coordinate information and are essential for constructing complex structures like wires, faces, and solids.cy)zDefault Vertext at the originNselfs R/opt/ringagent/.cad-venv/lib/python3.12/site-packages/build123d/topology/zero_d.py__init__zVertex.__init__Xcy)z%Vertex from OCCT TopoDS_Vertex objectNr$)r&ocp_vxs r'r(zVertex.__init__\r)r*cy)zVertex from three float valuesNr$)r&XYZs r'r(zVertex.__init__`r)r*cy)z%Vertex from Vector or other iteratorsNr$)r&vs r'r(zVertex.__init__dr)r*c T|jdd}|jdd}|jdd}|jdd}|jdd}|r+tddj|j|rMt |dt r|d}n4t |dt r|d}n|dd d d t|z zz\}}}|0tjtj|gd d \}}}|-ttt|||jn|}t |A|t#j$|j&}|j)|j+|j-c|_|_|_y) Nr,r2r.rr/r0zUnexpected argument(s): , )r)rrr)pop ValueErrorjoinkeys isinstancerrlen itertoolsislicechainrr rr!superr(r Pnt_swrappedr.r/r0) r&argskwargsr,r2xyzpnt __class__s r'r(zVertex.__init__hspHd+ JJsD ! JJsA  JJsA  JJsA  7 &++-8P7QRS S $q'=1aDGX.Gr(TQT]%;;1a =&&yq)'DaHGAq!~ .vaA?FFH I   oodll+!$#%%'3557r*cy)Nrr$r%s r'_dimz Vertex._dimsr*cy)z8volume - the volume of this Vertex, which is always zeror"r$r%s r'volumez Vertex.volumesr*ctjti}t|}||t j|S)z6Returns the right type of wrapper, given a OCCT object)ta TopAbs_VERTEXr!rr )clsobjconstructor_lut shape_types r'castz Vertex.casts<   f s^ *z*6==+=>>r*ctd)z&extrude - invalid operation for Vertexz&Vertices can't be created by extrusionNotImplementedError)rPrQ directions r'extrudezVertex.extrudes""JKKr*ct|tr t|}nt|trt|j}n{t|t r-|j |jr t|gSdSt|tr.|j|j|r t|gSdSt|tr"|j||kr t|gSdS|j|||S)aSingle-object intersection for Vertex. For a vertex (0D), intersection means the vertex lies on/in the other shape. Args: other: Shape or geometry object to intersect with tolerance: tolerance for intersection detection include_touched: if True, include boundary contacts (only relevant when Solids are involved) N) r:rr!rpositionr intersectcenterrrcontains distance_to _intersect)r&other toleranceinclude_toucheds r'r`zVertex._intersects" eV $5ME x (5>>*E t $(- (F9dV$ PD P u %&+^^DKKM9%M 4&! SW  eV $(,(8(8(?9(L9dV$ VRV ViAAr*ct|trTt|j|jz|j|jz|j|jz}|St|t t fr_t |}t|j|jz|j|jz|j|jz}|Std)aAdd Add to a Vertex with a Vertex, Vector or Tuple Args: other: Value to add Raises: TypeError: other not in [Tuple,Vector,Vertex] Returns: Result Example: part.faces(">z").vertices("z").vertices(">r*zUse 'tuple(Vertex)' instead.ctj|j}|j|j |j fS)z&Return vertex as three tuple of floats)r r@rAr.r/r0)r& geom_points r'to_tuplezVertex.to_tuple)s5__T\\2    ??r*cBt|jt|S)aApply affine transform without changing type Transforms a copy of this Vertex by the provided 3D affine transformation matrix. Note that not all transformation are supported - primarily designed for translation and rotation. See :transform_geometry: for more comprehensive transformations. Args: t_matrix (Matrix): affine transformation matrix Returns: Vertex: copy of transformed shape with all objects keeping their type )r!multiplyr)r&t_matrixs r'transform_shapezVertex.transform_shape/sx((677r*c|S)zReturn the Vertexr$r%s r'vertexz Vertex.vertex>s r*ct|fS)z)vertices - all the vertices in this Shape)rr%s r'verticeszVertex.verticesBs$!!r*)r,r)r.floatr/rr0r)r2zIterable[float])returnint)rr)rQr rr)rQrrXrrr!)gư>F)raz(Shape | Vector | Location | Axis | PlanerbrrcboolrzShapeList | None)raz,Vertex | Vector | tuple[float, float, float]rr!)rstr)razVertex | Vector | tuplerr!)rr)rxrryr)rztuple[float, float, float])rrrr!)rr!)rzShapeList[Vertex])__name__ __module__ __qualname____doc__orderrr(propertyrJrL classmethodrTrYr`rkrmrprsrur]rTOPrzrr}rrr __classcell__)rHs@r'r!r!MsZJ E,,44--44;D  ? ?LL % #B7#B#B #B  #BN!A! !FC.7<6:XX?./@0@ 8"r*r!cdt|tr|n |j}t|tr|n |j}|| tdt |t j }|jr|j}t |t j }|jr`|j}|j|rttj|S|j|jr`|j|jry)z'Given two edges, find the common vertexNz edge is empty) r:rrAr7r rNrOMoreCurrentIsSamer!r Next)edge1edge2 topods_edge1 topods_edge2vert_expvertex1 explorer2vertex2s r'topo_explore_common_vertexrGs'uk:5 L&uk:5 L|3))|R-=-=>H --/""$$L"2B2BC nn'')G~~g&fmmG455 NN nn   --/ r*)rEdge | TopoDS_Edgerrrz Vertex | None)0r __future__rr<typingrrcollections.abcrtyping_extensionsrr OCP.TopAbsTopAbsrNOCP.BRepr OCP.BRepBuilderAPIr OCP.TopExpr OCP.TopoDSr r rrOCP.gprbuild123d.geometryrrrrrrbuild123d.build_enumsr shape_corerrrrrone_drrr!rr$r*r'rsw3j#*$.8&GGPP&KK!w"U= !w"t &8r*