Difference between revisions of "Mesh API/es"

From FreeCAD Documentation
Jump to navigation Jump to search
(Updating to match new version of source page)
 
(10 intermediate revisions by 3 users not shown)
Line 1: Line 1:
The Mesh objects can be manipulated by adding new facets, deleting facets, importing from an STL file, transforming the mesh and much more. For a complete overview of what can be done see also the [[Mesh Module]] documentation. A mesh object cannot be added to an existing document directly. Therefore the document must create an object with a property class that supports meshes. Example:
+
<languages/>
  
<syntaxhighlight>
+
{{VeryImportantMessage|(November 2018) This information may be incomplete and outdated. For the latest API, see the [https://www.freecadweb.org/api autogenerated API documentation].}}
 +
 
 +
<div class="mw-translate-fuzzy">
 +
Los objetos malla pueden ser manipulados añadiendo facetas, eliminando facetas, importando desde un archivo STL, transformando la malla y muchas opciones más. Para una descripción completa de lo que se puede hacer mira también la documentación del [[Mesh_Workbench/es|Módulo de malla]]. Un objeto malla no se puede añadir a un documento existente directamente. Por lo tanto el documento debe crear un objeto con clase apropiada que soporte las mallas. Por ejemplo:
 +
</div>
 +
 
 +
<syntaxhighlight lang="python">
 
  m = Mesh.Mesh()
 
  m = Mesh.Mesh()
 
  ... # Manipulate the mesh
 
  ... # Manipulate the mesh
Line 11: Line 17:
  
  
{{APIFunction|addFacet|Facet|Adds a facet to the mesh| }}
+
<div class="mw-translate-fuzzy">
{{APIFunction|addFacets|list|Adds a list of facets to the mesh| }}
+
{{APIFunction/es|addFacet|Facet|Añade una faceta a la malla| }}
{{APIFunction|addMesh|Mesh|Combines this mesh with another mesh.| }}
+
{{APIFunction/es|addFacets|list|Añade una lista de facetas a la malla| }}
{{APIFunction|clear| |Clears the mesh| }}
+
{{APIFunction/es|addMesh|Mesh|Combina esta malla con otra malla.| }}
{{APIFunction|coarsen| |Coarsens the mesh| }}
+
{{APIFunction/es|clear| |Alisa la malla| }}
{{APIFunction|collapseEdge|Edge|Removes an edge and both facets that share this edge| }}
+
{{APIFunction/es|coarsen| |Desalisado de malla| }}
{{APIFunction|collapseFacet|Facet|Removes a facet| }}
+
{{APIFunction/es|collapseEdge|Edge|Elimina una arista y ambas facetas que compartían esa arista| }}
{{APIFunction|collapseFacets|list|Removes a list of facets| }}
+
{{APIFunction/es|collapseFacet|Facet|Elimina una faceta| }}
{{APIFunction|copy| |Creates a copy of this mesh|a Mesh object}}
+
{{APIFunction/es|collapseFacets|list|Elimina una lista de facetas| }}
{{APIFunction|countComponents| |Get the number of topological independent areas|an integer}}
+
{{APIFunction/es|copy| |Crea una copia de esta malla|Un objeto malla}}
{{APIFunction|countNonUniformOrientedFacets| |Get the number of wrong oriented facets|an integer}}
+
{{APIFunction/es|countComponents| |Obtiene el número de áreas topológicamente independientes|Un entero}}
{{APIFunction|countSegments| |Get the number of segments which may also be 0|an integer}}
+
{{APIFunction/es|countNonUniformOrientedFacets| |Obtiene el número de facetas mal orientadas|Un entero}}
{{APIFunction|crossSections| |Get cross-sections of the mesh through several planes| }}
+
{{APIFunction/es|countSegments| |Obtiene el número de segmentos que también podría ser 0|Un entero}}
{{APIFunction|difference|Mesh|Difference of this and the given mesh object.| }}
+
{{APIFunction/es|crossSections| |Obtiene secciones de cruce de la malla a través de diversos planos| }}
{{APIFunction|fillupHoles| |Fillup holes| }}
+
{{APIFunction/es|difference|Mesh|Diferencia de esta y el objeto malla dado.| }}
{{APIFunction|fixDeformations| |Repair deformed facets| }}
+
{{APIFunction/es|fillupHoles| |Rellena agujeros| }}
{{APIFunction|fixDegenerations| |Remove degenerated facets| }}
+
{{APIFunction/es|fixDeformations| |Repara facetas deformadas| }}
{{APIFunction|fixIndices| |Repair any invalid indices| }}
+
{{APIFunction/es|fixDegenerations| |Elimina facetas degeneradas| }}
{{APIFunction|fixSelfIntersections| |Repair self-intersections| }}
+
{{APIFunction/es|fixIndices| |Repara cualquier índice inválido| }}
{{APIFunction|flipNormals| |Flip the mesh normals| }}
+
{{APIFunction/es|fixSelfIntersections| |Repara auto-intersecciones| }}
{{APIFunction|foraminate| |Get a list of facet indices and intersection points| }}
+
{{APIFunction/es|flipNormals| |Invierte las normales de la malla| }}
{{APIFunction|getPlanes| |Get all planes of the mesh as segment. In the worst case each triangle can be regarded as single plane if none of its neighbors is coplanar.| }}
+
{{APIFunction/es|foraminate| |Obtiene una lista de índices de facetas y puntos de intersección| }}
{{APIFunction|getSegment|integer|Get a list of facet indices that describes a segment| }}
+
{{APIFunction/es|getPlanes| |Obtiene todos los planos de la malla como segmentos. En el peor de los casos cada triángulo se puede considerar un único plano si ninguno de sus vecinos es coplanar.| }}
{{APIFunction|getSeparateComponents| |Returns a list containing the different components (separated areas) of the mesh as separate meshes|a list}}
+
{{APIFunction/es|getSegment|integer|Obtiene una lista de índices de facetas que describen un segmento| }}
{{APIFunction|harmonizeNormals| |Adjust wrong oriented facets| }}
+
{{APIFunction/es|getSeparateComponents| |Devuelve una lista conteniendo los diferentes componentes (áreas separadas) de la malla como mallas separadas|Una lista}}
{{APIFunction|hasNonManifolds| |Check if the mesh has non-manifolds|a boolean}}
+
{{APIFunction/es|harmonizeNormals| |Ajusta las facetas mal orientadas| }}
{{APIFunction|hasNonUniformOrientedFacets| |Checks if the mesh has facets with inconsistent orientation| }}
+
{{APIFunction/es|hasNonManifolds| |Comprueba si la malla tiene non-manifolds|Un booleano}}
{{APIFunction|hasSelfIntersections| |Check if the mesh intersects itself| }}
+
{{APIFunction/es|hasNonUniformOrientedFacets| |Comprueba si la malla tiene facetas con orientación inconsistente| }}
{{APIFunction|inner| |Get the part inside of the intersection| }}
+
{{APIFunction/es|hasSelfIntersections| |Comprueba si la malla intersecta consigo misma| }}
{{APIFunction|insertVertex|Vertex|Inserts a vertex into a facet| }}
+
{{APIFunction/es|inner| |Obtiene la pieza dentro de la intersección| }}
{{APIFunction|intersect|Mesh|Intersection of this and the given mesh object.| }}
+
{{APIFunction/es|insertVertex|Vertex|Inserta un vértice en una faceta| }}
{{APIFunction|isSolid| |Check if the mesh is a solid| }}
+
{{APIFunction/es|intersect|Mesh|Intersección de esta y el objeto malla dado.| }}
{{APIFunction|meshFromSegment| |Create a mesh from segment| }}
+
{{APIFunction/es|isSolid| |Comprueba si la malla es un sólido| }}
{{APIFunction|nearestFacetOnRay|tuple, tuple|Get the index and intersection point of the nearest facet to a ray. The first parameter is a tuple of three floats the base point of the ray, the second parameter is ut uple of three floats for the direction. The result is a dictionary with an index and the intersection point or an empty dictionary if there is no intersection.|a dictionary}}
+
{{APIFunction/es|meshFromSegment| |Crea una malla a partir de segmentos| }}
{{APIFunction|offset|float|Move the point along their normals| }}
+
{{APIFunction/es|nearestFacetOnRay|tuple, tuple|Obtiene el índice y punto de intersección de las facetas más cercanas a un rayo. El primer parámetro es una tupla de tres números de coma flotante de un punto base del rayo, el segundo parámetro es una tupla de tres números de coma flotante para la orientación. El resultado es un diccionario con un índice y el punto de intersección o un diccionario vacio si no hay intersección.|Un diccionario}}
{{APIFunction|offsetSpecial|float|Move the point along their normals| }}
+
{{APIFunction/es|offset|float|Mueve el punto a lo largo de sus normales| }}
{{APIFunction|optimizeEdges| |Optimize the edges to get nicer facets| }}
+
{{APIFunction/es|offsetSpecial|float|Mueve el punto a lo largo de su normal| }}
{{APIFunction|optimizeTopology| |Optimize the edges to get nicer facets| }}
+
{{APIFunction/es|optimizeEdges| |Optimiza las aristas para conseguir mejores facetas| }}
{{APIFunction|outer| |Get the part outside the intersection| }}
+
{{APIFunction/es|optimizeTopology| |Optimiza las aristas para conseguir mejores facetas| }}
{{APIFunction|printInfo| |Get detailed information about the mesh| }}
+
{{APIFunction/es|outer| |Obtiene la pieza fuera de la intersección| }}
{{APIFunction|read| |Read in a mesh object from file.| }}
+
{{APIFunction/es|printInfo| |Obtiene información detallada de la malla| }}
{{APIFunction|refine| |Refine the mesh| }}
+
{{APIFunction/es|read| |Lee un objeto malla desde un archivo.| }}
{{APIFunction|removeComponents|integer|Remove components with less or equal to number of given facets| }}
+
{{APIFunction/es|refine| |Refina la malla| }}
{{APIFunction|removeDuplicatedFacets| |Remove duplicated facets| }}
+
{{APIFunction/es|removeComponents|integer|Elimina componentes con menos o igual número de facetas dadas| }}
{{APIFunction|removeDuplicatedPoints| |Remove duplicated points| }}
+
{{APIFunction/es|removeDuplicatedFacets| |Elimina facetas duplicadas| }}
{{APIFunction|removeFacets|list|Remove a list of facet indices from the mesh| }}
+
{{APIFunction/es|removeDuplicatedPoints| |Elimina puntos duplicados| }}
{{APIFunction|removeFoldsOnSurface| |Remove folds on surfaces| }}
+
{{APIFunction/es|removeFacets|list|Elimina una lista de índices de facetas desde la malla| }}
{{APIFunction|removeNonManifolds| |Remove non-manifolds| }}
+
{{APIFunction/es|removeFoldsOnSurface| |Elimina pliegues en superficies| }}
{{APIFunction|rotate| |Apply a rotation to the mesh| }}
+
{{APIFunction/es|removeNonManifolds| |Elimina non-manifolds| }}
{{APIFunction|setPoint|int, Vector|Sets the point at index.| }}
+
{{APIFunction/es|rotate| |Aplica una rotación a la malla| }}
{{APIFunction|smooth| |Smooth the mesh| }}
+
{{APIFunction/es|setPoint|int, Vector|Establece el punto en el índice.| }}
{{APIFunction|snapVertex| |Insert a new facet at the border| }}
+
{{APIFunction/es|smooth| |Suaviza la malla| }}
{{APIFunction|splitEdge| |Split edge| }}
+
{{APIFunction/es|snapVertex| |Inserta una faceta nueva en el borde| }}
{{APIFunction|splitEdges| |Split all edges| }}
+
{{APIFunction/es|splitEdge| |Dividir arista| }}
{{APIFunction|splitFacet| |Split facet| }}
+
{{APIFunction/es|splitEdges| |Dividir todas las aristas| }}
{{APIFunction|swapEdge| |Swap the common edge with the neighbor| }}
+
{{APIFunction/es|splitFacet| |Dividir faceta| }}
{{APIFunction|transform| |Apply a transformation to the mesh| }}
+
{{APIFunction/es|swapEdge| |Cambia la arista común con el vecino| }}
{{APIFunction|transformToEigen| |Transform the mesh to its eigenbase| }}
+
{{APIFunction/es|transform| |Aplica una trasformación a la malla| }}
{{APIFunction|translate|Vector|Apply a translation to the mesh| }}
+
{{APIFunction/es|transformToEigen| |Transforma la malla en su eigenbase| }}
{{APIFunction|unite|Mesh|Union of this and the given mesh object.| }}
+
{{APIFunction/es|translate|Vector|Aplica una translación a la malla| }}
{{APIFunction|write|string|Write the mesh object into file.| }}
+
{{APIFunction/es|unite|Mesh|Unión de esta y del objeto malla dado.| }}
{{APIFunction|writeInventor| |Write the mesh in OpenInventor format to a string.|a string}}
+
{{APIFunction/es|write|string|Escribe el objeto malla en un archivo.| }}
{{APIProperty|Area|the area of the mesh object.}}
+
{{APIFunction/es|writeInventor| |Escribe la malla en formato de OpenInventor en una cadena de texto.|Una cadena de texto}}
{{APIProperty|CountFacets|the number of facets of the mesh object.}}
+
{{APIProperty/es|Area|El área del objeto malla.}}
{{APIProperty|CountPoints|the number of vertices of the mesh object.}}
+
{{APIProperty/es|CountFacets|El número de facetas del objeto malla.}}
{{APIProperty|Facets|A collection of facets; With this attribute it is possible to get access to the facets of the mesh: for p in mesh.Facets: print p}}
+
{{APIProperty/es|CountPoints|El número de vértices del objeto malla.}}
{{APIProperty|Points|A collection of the mesh points; With this attribute it is possible to get access to the points of the mesh: for p in mesh.Points: print p.x, p.y, p.z}}
+
{{APIProperty/es|Facets|Una colección de facetas; Con este atributo es posible tener acceso a las facetas de la malla: for p in mesh.Facets: print p}}
{{APIProperty|Topology|the points and face indices as tuple.}}
+
{{APIProperty/es|Points|Una colección de puntos de malla; Con este atributo es posible tener acceso a los puntos de la malla: for p in mesh.Points: print p.x, p.y, p.z}}
{{APIProperty|Volume|the volume of the mesh object.}}
+
{{APIProperty/es|Topology|Los índices de los puntos y caras como tuplas.}}
{{APIProperty|BoundBox|the BoundBox of the object}}
+
{{APIProperty/es|Volume|El volumen del objeto malla.}}
{{APIProperty|Matrix|the current transformation of the object as matrix}}
+
{{APIProperty/es|BoundBox|La caja de abarque del objeto}}
{{APIProperty|Placement|the current transformation of the object as placement}}
+
{{APIProperty/es|Matrix|La transformación actualdel objeto como matriz}}
 +
{{APIProperty/es|Placement|La transformación actual del objeto como colocación}}
 +
</div>
  
  
[[Category:API]]
+
{{Userdocnavi{{#translation:}}}}
 
+
[[Category:API{{#translation:}}]]
 +
[[Category:Poweruser Documentation{{#translation:}}]]
 
{{clear}}
 
{{clear}}
<languages/>
 

Latest revision as of 13:54, 23 August 2021

Other languages:
Deutsch • ‎English • ‎español • ‎français • ‎italiano • ‎magyar • ‎polski • ‎română • ‎日本語
(November 2018) This information may be incomplete and outdated. For the latest API, see the autogenerated API documentation.

Los objetos malla pueden ser manipulados añadiendo facetas, eliminando facetas, importando desde un archivo STL, transformando la malla y muchas opciones más. Para una descripción completa de lo que se puede hacer mira también la documentación del Módulo de malla. Un objeto malla no se puede añadir a un documento existente directamente. Por lo tanto el documento debe crear un objeto con clase apropiada que soporte las mallas. Por ejemplo:

 m = Mesh.Mesh()
 ... # Manipulate the mesh
 d = FreeCAD.activeDocument() # Get a reference to the actie document
 f = d.addObject("Mesh::Feature", "Mesh") # Create a mesh feature
 f.Mesh = m # Assign the mesh object to the internal property
 d.recompute()


Method.png addFacet ( Facet )

Descripción: Añade una faceta a la malla

Devuelve:


Method.png addFacets ( list )

Descripción: Añade una lista de facetas a la malla

Devuelve:


Method.png addMesh ( Mesh )

Descripción: Combina esta malla con otra malla.

Devuelve:


Method.png clear ( )

Descripción: Alisa la malla

Devuelve:


Method.png coarsen ( )

Descripción: Desalisado de malla

Devuelve:


Method.png collapseEdge ( Edge )

Descripción: Elimina una arista y ambas facetas que compartían esa arista

Devuelve:


Method.png collapseFacet ( Facet )

Descripción: Elimina una faceta

Devuelve:


Method.png collapseFacets ( list )

Descripción: Elimina una lista de facetas

Devuelve:


Method.png copy ( )

Descripción: Crea una copia de esta malla

Devuelve: Un objeto malla


Method.png countComponents ( )

Descripción: Obtiene el número de áreas topológicamente independientes

Devuelve: Un entero


Method.png countNonUniformOrientedFacets ( )

Descripción: Obtiene el número de facetas mal orientadas

Devuelve: Un entero


Method.png countSegments ( )

Descripción: Obtiene el número de segmentos que también podría ser 0

Devuelve: Un entero


Method.png crossSections ( )

Descripción: Obtiene secciones de cruce de la malla a través de diversos planos

Devuelve:


Method.png difference ( Mesh )

Descripción: Diferencia de esta y el objeto malla dado.

Devuelve:


Method.png fillupHoles ( )

Descripción: Rellena agujeros

Devuelve:


Method.png fixDeformations ( )

Descripción: Repara facetas deformadas

Devuelve:


Method.png fixDegenerations ( )

Descripción: Elimina facetas degeneradas

Devuelve:


Method.png fixIndices ( )

Descripción: Repara cualquier índice inválido

Devuelve:


Method.png fixSelfIntersections ( )

Descripción: Repara auto-intersecciones

Devuelve:


Method.png flipNormals ( )

Descripción: Invierte las normales de la malla

Devuelve:


Method.png foraminate ( )

Descripción: Obtiene una lista de índices de facetas y puntos de intersección

Devuelve:


Method.png getPlanes ( )

Descripción: Obtiene todos los planos de la malla como segmentos. En el peor de los casos cada triángulo se puede considerar un único plano si ninguno de sus vecinos es coplanar.

Devuelve:


Method.png getSegment ( integer )

Descripción: Obtiene una lista de índices de facetas que describen un segmento

Devuelve:


Method.png getSeparateComponents ( )

Descripción: Devuelve una lista conteniendo los diferentes componentes (áreas separadas) de la malla como mallas separadas

Devuelve: Una lista


Method.png harmonizeNormals ( )

Descripción: Ajusta las facetas mal orientadas

Devuelve:


Method.png hasNonManifolds ( )

Descripción: Comprueba si la malla tiene non-manifolds

Devuelve: Un booleano


Method.png hasNonUniformOrientedFacets ( )

Descripción: Comprueba si la malla tiene facetas con orientación inconsistente

Devuelve:


Method.png hasSelfIntersections ( )

Descripción: Comprueba si la malla intersecta consigo misma

Devuelve:


Method.png inner ( )

Descripción: Obtiene la pieza dentro de la intersección

Devuelve:


Method.png insertVertex ( Vertex )

Descripción: Inserta un vértice en una faceta

Devuelve:


Method.png intersect ( Mesh )

Descripción: Intersección de esta y el objeto malla dado.

Devuelve:


Method.png isSolid ( )

Descripción: Comprueba si la malla es un sólido

Devuelve:


Method.png meshFromSegment ( )

Descripción: Crea una malla a partir de segmentos

Devuelve:


Method.png nearestFacetOnRay ( tuple, tuple )

Descripción: Obtiene el índice y punto de intersección de las facetas más cercanas a un rayo. El primer parámetro es una tupla de tres números de coma flotante de un punto base del rayo, el segundo parámetro es una tupla de tres números de coma flotante para la orientación. El resultado es un diccionario con un índice y el punto de intersección o un diccionario vacio si no hay intersección.

Devuelve: Un diccionario


Method.png offset ( float )

Descripción: Mueve el punto a lo largo de sus normales

Devuelve:


Method.png offsetSpecial ( float )

Descripción: Mueve el punto a lo largo de su normal

Devuelve:


Method.png optimizeEdges ( )

Descripción: Optimiza las aristas para conseguir mejores facetas

Devuelve:


Method.png optimizeTopology ( )

Descripción: Optimiza las aristas para conseguir mejores facetas

Devuelve:


Method.png outer ( )

Descripción: Obtiene la pieza fuera de la intersección

Devuelve:


Method.png printInfo ( )

Descripción: Obtiene información detallada de la malla

Devuelve:


Method.png read ( )

Descripción: Lee un objeto malla desde un archivo.

Devuelve:


Method.png refine ( )

Descripción: Refina la malla

Devuelve:


Method.png removeComponents ( integer )

Descripción: Elimina componentes con menos o igual número de facetas dadas

Devuelve:


Method.png removeDuplicatedFacets ( )

Descripción: Elimina facetas duplicadas

Devuelve:


Method.png removeDuplicatedPoints ( )

Descripción: Elimina puntos duplicados

Devuelve:


Method.png removeFacets ( list )

Descripción: Elimina una lista de índices de facetas desde la malla

Devuelve:


Method.png removeFoldsOnSurface ( )

Descripción: Elimina pliegues en superficies

Devuelve:


Method.png removeNonManifolds ( )

Descripción: Elimina non-manifolds

Devuelve:


Method.png rotate ( )

Descripción: Aplica una rotación a la malla

Devuelve:


Method.png setPoint ( int, Vector )

Descripción: Establece el punto en el índice.

Devuelve:


Method.png smooth ( )

Descripción: Suaviza la malla

Devuelve:


Method.png snapVertex ( )

Descripción: Inserta una faceta nueva en el borde

Devuelve:


Method.png splitEdge ( )

Descripción: Dividir arista

Devuelve:


Method.png splitEdges ( )

Descripción: Dividir todas las aristas

Devuelve:


Method.png splitFacet ( )

Descripción: Dividir faceta

Devuelve:


Method.png swapEdge ( )

Descripción: Cambia la arista común con el vecino

Devuelve:


Method.png transform ( )

Descripción: Aplica una trasformación a la malla

Devuelve:


Method.png transformToEigen ( )

Descripción: Transforma la malla en su eigenbase

Devuelve:


Method.png translate ( Vector )

Descripción: Aplica una translación a la malla

Devuelve:


Method.png unite ( Mesh )

Descripción: Unión de esta y del objeto malla dado.

Devuelve:


Method.png write ( string )

Descripción: Escribe el objeto malla en un archivo.

Devuelve:


Method.png writeInventor ( )

Descripción: Escribe la malla en formato de OpenInventor en una cadena de texto.

Devuelve: Una cadena de texto


Property.png Area

Devuelve: El área del objeto malla.


Property.png CountFacets

Devuelve: El número de facetas del objeto malla.


Property.png CountPoints

Devuelve: El número de vértices del objeto malla.


Property.png Facets

Devuelve: Una colección de facetas; Con este atributo es posible tener acceso a las facetas de la malla: for p in mesh.Facets: print p


Property.png Points

Devuelve: Una colección de puntos de malla; Con este atributo es posible tener acceso a los puntos de la malla: for p in mesh.Points: print p.x, p.y, p.z


Property.png Topology

Devuelve: Los índices de los puntos y caras como tuplas.


Property.png Volume

Devuelve: El volumen del objeto malla.


Property.png BoundBox

Devuelve: La caja de abarque del objeto


Property.png Matrix

Devuelve: La transformación actualdel objeto como matriz


Property.png Placement

Devuelve: La transformación actual del objeto como colocación