Mesh API/es: Difference between revisions

From FreeCAD Documentation
(Created page with "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 descr...")
No edit summary
 
(9 intermediate revisions by 3 users not shown)
Line 1: Line 1:
<languages/>
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 Module/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:

{{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>
<syntaxhighlight lang="python">
m = Mesh.Mesh()
m = Mesh.Mesh()
... # Manipulate the mesh
... # Manipulate the mesh
Line 11: Line 17:




<div class="mw-translate-fuzzy">
{{APIFunction|addFacet|Facet|Adds a facet to the mesh| }}
{{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/es|foraminate| |Obtiene una lista de índices de facetas y puntos de intersección| }}
{{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|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|getSegment|integer|Get a list of facet indices that describes a segment| }}
{{APIFunction/es|getSegment|integer|Obtiene una lista de índices de facetas que describen un segmento| }}
{{APIFunction|getSeparateComponents| |Returns a list containing the different components (separated areas) of the mesh as separate meshes|a list}}
{{APIFunction/es|getSeparateComponents| |Devuelve una lista conteniendo los diferentes componentes (áreas separadas) de la malla como mallas separadas|Una lista}}
{{APIFunction|harmonizeNormals| |Adjust wrong oriented facets| }}
{{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/es|meshFromSegment| |Crea una malla a partir de segmentos| }}
{{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|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|offset|float|Move the point along their normals| }}
{{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/es|removeComponents|integer|Elimina componentes con menos o igual número de facetas dadas| }}
{{APIFunction|removeDuplicatedFacets| |Remove duplicated facets| }}
{{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.| }}
{{APIFunction/es|writeInventor| |Escribe la malla en formato de OpenInventor en una cadena de texto.|Una cadena de texto}}
{{APIProperty|Area|the area of the mesh object.}}
{{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/es|CountPoints|El número de vértices 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|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/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|Topology|the points and face indices as tuple.}}
{{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>




{{Userdocnavi{{#translation:}}}}
[[Category:API]]
[[Category:API{{#translation:}}]]

[[Category:Poweruser Documentation{{#translation:}}]]
{{clear}}
{{clear}}
<languages/>

Latest revision as of 13:54, 23 August 2021

(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()


addFacet ( Facet )

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

Devuelve:


addFacets ( list )

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

Devuelve:


addMesh ( Mesh )

Descripción: Combina esta malla con otra malla.

Devuelve:


clear ( )

Descripción: Alisa la malla

Devuelve:


coarsen ( )

Descripción: Desalisado de malla

Devuelve:


collapseEdge ( Edge )

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

Devuelve:


collapseFacet ( Facet )

Descripción: Elimina una faceta

Devuelve:


collapseFacets ( list )

Descripción: Elimina una lista de facetas

Devuelve:


copy ( )

Descripción: Crea una copia de esta malla

Devuelve: Un objeto malla


countComponents ( )

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

Devuelve: Un entero


countNonUniformOrientedFacets ( )

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

Devuelve: Un entero


countSegments ( )

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

Devuelve: Un entero


crossSections ( )

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

Devuelve:


difference ( Mesh )

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

Devuelve:


fillupHoles ( )

Descripción: Rellena agujeros

Devuelve:


fixDeformations ( )

Descripción: Repara facetas deformadas

Devuelve:


fixDegenerations ( )

Descripción: Elimina facetas degeneradas

Devuelve:


fixIndices ( )

Descripción: Repara cualquier índice inválido

Devuelve:


fixSelfIntersections ( )

Descripción: Repara auto-intersecciones

Devuelve:


flipNormals ( )

Descripción: Invierte las normales de la malla

Devuelve:


foraminate ( )

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

Devuelve:


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:


getSegment ( integer )

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

Devuelve:


getSeparateComponents ( )

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

Devuelve: Una lista


harmonizeNormals ( )

Descripción: Ajusta las facetas mal orientadas

Devuelve:


hasNonManifolds ( )

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

Devuelve: Un booleano


hasNonUniformOrientedFacets ( )

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

Devuelve:


hasSelfIntersections ( )

Descripción: Comprueba si la malla intersecta consigo misma

Devuelve:


inner ( )

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

Devuelve:


insertVertex ( Vertex )

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

Devuelve:


intersect ( Mesh )

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

Devuelve:


isSolid ( )

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

Devuelve:


meshFromSegment ( )

Descripción: Crea una malla a partir de segmentos

Devuelve:


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


offset ( float )

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

Devuelve:


offsetSpecial ( float )

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

Devuelve:


optimizeEdges ( )

Descripción: Optimiza las aristas para conseguir mejores facetas

Devuelve:


optimizeTopology ( )

Descripción: Optimiza las aristas para conseguir mejores facetas

Devuelve:


outer ( )

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

Devuelve:


printInfo ( )

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

Devuelve:


read ( )

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

Devuelve:


refine ( )

Descripción: Refina la malla

Devuelve:


removeComponents ( integer )

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

Devuelve:


removeDuplicatedFacets ( )

Descripción: Elimina facetas duplicadas

Devuelve:


removeDuplicatedPoints ( )

Descripción: Elimina puntos duplicados

Devuelve:


removeFacets ( list )

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

Devuelve:


removeFoldsOnSurface ( )

Descripción: Elimina pliegues en superficies

Devuelve:


removeNonManifolds ( )

Descripción: Elimina non-manifolds

Devuelve:


rotate ( )

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

Devuelve:


setPoint ( int, Vector )

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

Devuelve:


smooth ( )

Descripción: Suaviza la malla

Devuelve:


snapVertex ( )

Descripción: Inserta una faceta nueva en el borde

Devuelve:


splitEdge ( )

Descripción: Dividir arista

Devuelve:


splitEdges ( )

Descripción: Dividir todas las aristas

Devuelve:


splitFacet ( )

Descripción: Dividir faceta

Devuelve:


swapEdge ( )

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

Devuelve:


transform ( )

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

Devuelve:


transformToEigen ( )

Descripción: Transforma la malla en su eigenbase

Devuelve:


translate ( Vector )

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

Devuelve:


unite ( Mesh )

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

Devuelve:


write ( string )

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

Devuelve:


writeInventor ( )

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

Devuelve: Una cadena de texto


Area

Devuelve: El área del objeto malla.


CountFacets

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


CountPoints

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


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


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


Topology

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


Volume

Devuelve: El volumen del objeto malla.


BoundBox

Devuelve: La caja de abarque del objeto


Matrix

Devuelve: La transformación actualdel objeto como matriz


Placement

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