simIGL.adaptiveUpsample
|
Description
|
Divide triangles with an edge longer than given threshold. |
| Lua synopsis |
mesh m = simIGL.adaptiveUpsample(mesh m, float threshold)
|
| Lua parameters |
m (mesh): mesh
threshold (float): maximum triangle edge length
|
| Lua return values |
m (mesh): list of tetrahedron volumes |
| Python synopsis |
mesh m = simIGL.adaptiveUpsample(mesh m, float threshold)
|
simIGL.barycenter
|
Description
|
Computes the barycenter of every simplex. |
| Lua synopsis |
grid bc = simIGL.barycenter(grid v, grid f)
|
| Lua parameters |
v (grid): vertex position list
f (grid): indices of simplex corners into V
|
| Lua return values |
bc (grid): matrix of vertices |
| Python synopsis |
grid bc = simIGL.barycenter(grid v, grid f)
|
simIGL.centroid
|
Description
|
Computes the centroid of a closed mesh using a surface integral. |
| Lua synopsis |
float[3] c, float vol = simIGL.centroid(mesh m)
|
| Lua parameters |
m (mesh): mesh |
| Lua return values |
c (table of float, size 3): vector of centroid coordinates
vol (float): total volume of solid
|
| Python synopsis |
list c, float vol = simIGL.centroid(mesh m)
|
simIGL.closestFacet
|
Description
|
Determine the closest facet for each of the input points. |
| Lua synopsis |
int[] r, int[] s = simIGL.closestFacet(mesh m, grid points, grid emap, grid uec, grid uee, int[] indices={})
|
| Lua parameters |
m (mesh): mesh
points (grid): query points
emap (grid): list of indices into uE, mapping each directed edge to unique undirected edge so that uE(EMAP(f+#F*c)) is the unique edge corresponding to E.row(f+#F*c)
uec (grid): list of cumulative counts of directed edges sharing each unique edge so the uEC(i+1)-uEC(i) is the number of directed edges sharing the ith unique edge
uee (grid): list of indices into E, so that the consecutive segment of indices uEE.segment(uEC(i),uEC(i+1)-uEC(i)) lists all directed edges sharing the ith unique edge
indices (table of int, default: {}): indices of faces to consider, or empty for all
|
| Lua return values |
r (table of int): list of closest face indices, same size as p
s (table of int): list of bools indicating on which side of the facet each query point lies, same size as p
|
| Python synopsis |
list r, list s = simIGL.closestFacet(mesh m, grid points, grid emap, grid uec, grid uee, list indices={})
|
simIGL.convexHull
|
Description
|
Given a set of points, compute the convex hull as a triangle mesh. |
| Lua synopsis |
mesh m = simIGL.convexHull(float[] points)
|
| Lua parameters |
points (table of float): mesh |
| Lua return values |
m (mesh): mesh |
| Python synopsis |
mesh m = simIGL.convexHull(list points)
|
simIGL.convexHullShape
|
Description
|
convenience wrapper for simIGL.convexHull to operate on shapes directly |
| Lua synopsis |
int handleResult = simIGL.convexHullShape(int[] handles)
|
| Lua parameters |
handles (table of int): the handle of the input shapes |
| Lua return values |
handleResult (int): the handle of the resulting shape |
| Python synopsis |
int handleResult = simIGL.convexHullShape(list handles)
|
simIGL.drawMesh
|
Description
|
draw a mesh using drawing objects |
| Lua synopsis |
table dwo = simIGL.drawMesh(table mesh, table opts)
|
| Lua parameters |
mesh (table): the mesh data, as returned by simIGL.getMesh
opts (table): various options (color: table3, lineWidth: int, offset: table3, dwo: int or nil, it will be created)
|
| Lua return values |
dwo (table): the drawing object that has been used to draw |
| Python synopsis |
list dwo = simIGL.drawMesh(list mesh, list opts)
|
simIGL.exactGeodesic
|
Description
|
The discrete geodesic distance between two points is the length of the shortest path between then restricted to the surface. For triangle meshes, such a path is made of a set of segments which can be either edges of the mesh or crossing a triangle. |
| Lua synopsis |
float[] distances = simIGL.exactGeodesic(mesh m, int[] vs, int[] fs, int[] vt, int[] ft)
|
| Lua parameters |
m (mesh): mesh
vs (table of int): indices of source vertices
fs (table of int): indices of source faces
vt (table of int): indices of target vertices
ft (table of int): indices of target faces
|
| Lua return values |
distances (table of float): output vector which lists first the distances for the target vertices, and then for the target faces |
| Python synopsis |
list distances = simIGL.exactGeodesic(mesh m, list vs, list fs, list vt, list ft)
|
simIGL.faceCentroids
|
Description
|
Computes the centroid of mesh faces. |
| Lua synopsis |
grid c = simIGL.faceCentroids(mesh m)
|
| Lua parameters |
m (mesh): mesh |
| Lua return values |
c (grid): centroid coordinates |
| Python synopsis |
grid c = simIGL.faceCentroids(mesh m)
|
simIGL.getMesh
|
Description
|
get mesh data of a given shape in the format used by simIGL functions |
| Lua synopsis |
table mesh = simIGL.getMesh(int h, table options={})
|
| Lua parameters |
h (int): the handle of the shape
options (table, default: {}): options
|
| Lua return values |
mesh (table): mesh object |
| Python synopsis |
list mesh = simIGL.getMesh(int h, list options={})
|
simIGL.intersectWithHalfSpace
|
Description
|
Intersect a PWN mesh with a half-space. Point on plane, normal pointing outward. |
| Lua synopsis |
mesh m, int[] j = simIGL.intersectWithHalfSpace(mesh m, float[3] pt, float[3] n)
|
| Lua parameters |
m (mesh): mesh
pt (table of float, size 3): point on plane
n (table of float, size 3): normal of plane pointing away from inside
|
| Lua return values |
m (mesh): result mesh
j (table of int): list of indices into [F;F.rows()+[1;2]] revealing "birth" facet
|
| Python synopsis |
mesh m, list j = simIGL.intersectWithHalfSpace(mesh m, list pt, list n)
|
simIGL.meshBoolean
|
Description
|
Compute several boolean operations on the meshes specified by vertices and (triangle) indices |
| Lua synopsis |
mesh result = simIGL.meshBoolean(mesh a, mesh b, int op)
|
| Lua parameters |
a (mesh): first mesh
b (mesh): second mesh
|
| Lua return values |
result (mesh): resulting mesh |
| Python synopsis |
mesh result = simIGL.meshBoolean(mesh a, mesh b, int op)
|
|
See also
|
|
simIGL.meshBooleanShape
|
Description
|
convenience wrapper for simIGL.meshBoolean to operate on shapes directly |
| Lua synopsis |
int handleResult = simIGL.meshBooleanShape(int[] handles, int op)
|
| Lua parameters |
handles (table of int): the handle of the input shapes
op (int): the operation (see simIGL.boolean_op)
|
| Lua return values |
handleResult (int): the handle of the resulting shape |
| Python synopsis |
int handleResult = simIGL.meshBooleanShape(list handles, int op)
|
simIGL.meshOctreeIntersection
|
Description
|
Computes the part of mesh intersecting the given octree. |
| Lua synopsis |
mesh m = simIGL.meshOctreeIntersection(mesh m, int oc)
|
| Lua parameters |
m (mesh): mesh
oc (int): handle of octree
|
| Lua return values |
m (mesh): intersecting mesh subset |
| Python synopsis |
mesh m = simIGL.meshOctreeIntersection(mesh m, int oc)
|
simIGL.pointNormalToMatrix
|
Description
|
return the transform matrix (table of 12 values) from point and normal |
| Lua synopsis |
table matrix = simIGL.pointNormalToMatrix(table point, table normal)
|
| Lua parameters |
point (table): (3D vector)
normal (table): (3D vector)
|
| Lua return values |
matrix (table): the resulting transform matrix (table of 12 values) |
| Python synopsis |
list matrix = simIGL.pointNormalToMatrix(list point, list normal)
|
simIGL.randomPointsOnMesh
|
Description
|
Randomly sample a mesh n times |
| Lua synopsis |
grid b, grid fi = simIGL.randomPointsOnMesh(int n, mesh m, bool convertToWorldCoords=false)
|
| Lua parameters |
n (int): num samples
m (mesh): mesh
convertToWorldCoords (bool, default: false): if true, output will be in world coords and not in barycentric coords
|
| Lua return values |
b (grid): list of barycentric/world coordinates, ith row are coordinates of ith sampled point in face FI[i]
fi (grid): list of indices into F
|
| Python synopsis |
grid b, grid fi = simIGL.randomPointsOnMesh(int n, mesh m, bool convertToWorldCoords=false)
|
simIGL.rayTest
|
Description
|
perform a ray test, from given origin towards every of the points, and return a new array of points. |
| Lua synopsis |
table resultPoints = simIGL.rayTest(table origin, table points, int proximitySensorHandle=NIL)
|
| Lua parameters |
origin (table): (3D vector)
points (table): one or more points to test
proximitySensorHandle (int, default: NIL): handle of a ray type proximity sensor, or nil in which case it will be created
|
| Lua return values |
resultPoints (table): the resulting points of the ray test |
| Python synopsis |
list resultPoints = simIGL.rayTest(list origin, list points, int proximitySensorHandle=NIL)
|
simIGL.sweptVolume
|
Description
|
Generate a volume-sweep mesh |
| Lua synopsis |
mesh m = simIGL.sweptVolume(mesh m, string transformFunc, int timeSteps, int gridSize, float isoLevel=0)
|
| Lua parameters |
m (mesh): mesh
transformFunc (string): rigid transform as a function of time (0..1); must return a 4x4 transform matrix as 12/16 values
timeSteps (int): number of time steps
gridSize (int): size of voxel grid internally used for mesh generation
isoLevel (float, default: 0): can be set to zero to approximate the exact swept volume, greater than zero to approximate a positive offset of the swept volume or less than zero to approximate a negative offset
|
| Lua return values |
m (mesh): volume-sweep mesh |
| Python synopsis |
mesh m = simIGL.sweptVolume(mesh m, string transformFunc, int timeSteps, int gridSize, float isoLevel=0)
|
simIGL.tetrahedralize
|
Description
|
Mesh the interior of a surface mesh using tetgen. |
| Lua synopsis |
int result, grid tv, grid tt, grid tf = simIGL.tetrahedralize(mesh m, string switches="")
|
| Lua parameters |
m (mesh): mesh
switches (string, default: ""): string of tetgen options (See tetgen documentation) e.g. "pq1.414a0.01" tries to mesh the interior of a given surface with quality and area constraints; "" will mesh the convex hull constrained to pass through V (ignores F)
|
| Lua return values |
result (int): Returns status: 0 success; 1 tetgen threw exception; 2 tetgen did not crash but could not create any tets (probably there are holes, duplicate faces etc.); -1 other error
tv (grid): vertex position list
tt (grid): list of tet face indices
tf (grid): list of triangle face indices
|
| Python synopsis |
int result, grid tv, grid tt, grid tf = simIGL.tetrahedralize(mesh m, string switches="")
|
simIGL.uniqueEdgeMap
|
Description
|
Construct relationships between facet "half"-(or rather "viewed")-edges E to unique edges of the mesh seen as a graph. |
| Lua synopsis |
grid e, grid ue, grid emap, grid uec, grid uee = simIGL.uniqueEdgeMap(grid f)
|
| Lua parameters |
f (grid): list of simplices |
| Lua return values |
e (grid): list of all directed edges, such that E.row(f+#F*c) is the edge opposite F(f,c)
ue (grid): list of unique undirected edges
emap (grid): list of indices into uE, mapping each directed edge to unique undirected edge so that uE(EMAP(f+#F*c)) is the unique edge corresponding to E.row(f+#F*c)
uec (grid): list of cumulative counts of directed edges sharing each unique edge so the uEC(i+1)-uEC(i) is the number of directed edges sharing the ith unique edge
uee (grid): list of indices into E, so that the consecutive segment of indices uEE.segment(uEC(i),uEC(i+1)-uEC(i)) lists all directed edges sharing the ith unique edge
|
| Python synopsis |
grid e, grid ue, grid emap, grid uec, grid uee = simIGL.uniqueEdgeMap(grid f)
|
simIGL.upsample
|
Description
|
Subdivide a mesh without moving vertices: loop subdivision but odd vertices stay put and even vertices are just edge midpoints. |
| Lua synopsis |
mesh m = simIGL.upsample(mesh m, int n=1)
|
| Lua parameters |
m (mesh): mesh
n (int, default: 1): number of subdivisions
|
| Lua return values |
m (mesh): subdivided mesh |
| Python synopsis |
mesh m = simIGL.upsample(mesh m, int n=1)
|
simIGL.volume
|
Description
|
Compute volume for all tets of a given tet mesh. |
| Lua synopsis |
float[] vol = simIGL.volume(tetmesh m)
|
| Lua parameters |
m (tetmesh): tet mesh |
| Lua return values |
vol (table of float): list of tetrahedron volumes |
| Python synopsis |
list vol = simIGL.volume(tetmesh m)
|
|