Mesh API

From FreeCAD Documentation
This page is a translated version of the page Mesh API and the translation is 40% complete.
Outdated translations are marked like this.
(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