cymesh

KO | EN

gitlite — search

#python #ai #rag #javascript #llm #deep-learning #machine-learning #rust #react #vscode-extension #nextjs #typescript

★ 19 Open GitHub ↗

Half-edge 3D mesh in python/cython. Supports dynamic manipulation operators.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# CyMesh

A Half-Edge mesh implemented in cython. The mesh is intended for dynamic manipulation. Splitting edges, fliping edges and calculating normals and curvatures are all supported.

Currently only supports tri-meshes.

TODO:

* support n-gon meshes and have a tri-mesh subclass

## INSTALL
Requires cython and pygame/pyopengl for viewing.

```
git clone https://github.com/Sloth6/cymesh
cd cymesh
python setup.py build_ext --inplace
python demo.py
```

To install locally.

```
python setup.py install
```

## Demo
Here is all the code in demo.py for creating a mesh from an .obj file and viewing it. Mesh's can also be created from a list of polygons.

```python
from random import random
from cymesh.mesh import Mesh
from cymesh.view import Viewer

mesh = Mesh.from_obj('triangulated_sphere_2.obj')

# Add noise to mesh.
for vert in mesh.verts:
    vert.p[0] += random() * .1
    vert.p[1] += random() * .1
    vert.p[2] += random() * .1

# If not given a max length, all edges are split.
mesh.splitEdges()

# Flip edges which will become shorter.
mesh.shortenEdges()

# Normals and curvature updates must be called after making changes to mesh.
mesh.calculateNormals()
mesh.calculateCurvature()

# We can write our new object to a file.
mesh.writeObj('my_mesh.obj')

# We can also export the mesh to a dict of numpy arrays.
export = mesh.export()
print(export.keys())
# > dict_keys(['faces', 'vertice_normals', 'face_normals', 'vert_data', 'vertices', 'curvature', 'edges'])

# Each vert has a dictionary 'data' attribute to add additional information.
# Colors can be passed to the viewer by adding a color to data.
for vert in mesh.verts:
    vert.data['color'] = (random(), random(), random())

# View the mesh with pyopengl.
view = Viewer()
view.startDraw()
view.drawMesh(mesh, edges=True)
view.endDraw()
view.mainLoop()

```

## Interface

### Mesh

```
Attributes:
    readonly list verts
    readonly list faces
    readonly list edges
    readonly list halfs

Methods:
    void shortenEdges()
    int splitEdges(double max_edge_length=0.0)
    double volume()
    void calculateNormals()
    void calculateCurvature()
    list getNearby(Vert v, int n)
    Vert splitEdge(Edge e)
    tuple boundingBox(self)
```

### Vert

```
Attributes:
	readonly unsigned int id
	public double p[3]
	readonly double normal[3]
	readonly double curvature
	readonly HalfEdge he
	public dict data

Methods:
	list faces()
	list neighbors()
```

### Edge

```
Attributes:
    readonly unsigned int id

Methods:
    double length()
    tuple vertices()
    bint isBoundary()
    void flip()
```

### Face

```
Attributes:
    readonly unsigned int id
    readonly double normal[3]

Methods:
    list vertices()
    list edges()
```

cymesh

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README