This Elm package allows you to create and manipulate indexed triangular meshes. A mesh contains an array of vertices which contain the bulk of the mesh data; vertices can be of any type, so you can create meshes from 2D or 3D points or have complex vertices of your own custom type that include additional data such as colors, normal vectors, texture coordinates, unique IDs, etc.
Mesh faces are defined by triples of integer indices specifying which three vertices make up the face. This package has functionality for creating meshes in various ways, extracting faces as index triples or vertex triples, extracting edges as index pairs or vertex pairs, and combining multiple meshes.
For example, you might create a 2D mesh representing a single rectangle as:
import TriangularMesh exposing (TriangularMesh) import Array mesh : TriangularMesh ( Float, Float ) mesh = let vertices = Array.fromList [ ( 0, 0 ) , ( 4, 0 ) , ( 4, 3 ) , ( 0, 3 ) ] faceIndices = [ ( 0, 1, 2 ) , ( 2, 3, 0 ) ] in TriangularMesh.indexed vertices faceIndices
You could then do things like get the faces or edges of that mesh as tuples of vertices:
TriangularMesh.faceVertices mesh --> [ ( ( 0, 0 ), ( 4, 0 ), ( 4, 3 ) ) --> , ( ( 4, 3 ), ( 0, 3 ), ( 0, 0 ) ) --> ] TriangularMesh.edgeVertices mesh --> [ ( ( 0, 0 ), ( 4, 0 ) ) --> , ( ( 0, 0 ), ( 4, 3 ) ) --> , ( ( 0, 0 ), ( 0, 3 ) ) --> , ( ( 4, 0 ), ( 4, 3 ) ) --> , ( ( 4, 3 ), ( 0, 3 ) ) --> ]
Full API documentation is available.
Please open a new issue if you run into a bug, if any documentation is missing/incorrect/confusing, or if there's a new feature that you would find useful. For general questions about using this package, try:
You can also find me on Twitter (@ianemackenzie), where I occasionally post geometry-related stuff like demos or new package releases. Have fun, and don't be afraid to ask for help!