https://github.com/felipeek/dt-sgim
Mesh smoothing technique based on 2d filtering
https://github.com/felipeek/dt-sgim
3d domain-transform-filter filter geometry-image geometry-images mesh-filtering mesh-processing
Last synced: 13 days ago
JSON representation
Mesh smoothing technique based on 2d filtering
- Host: GitHub
- URL: https://github.com/felipeek/dt-sgim
- Owner: felipeek
- License: mit
- Created: 2018-09-07T21:52:30.000Z (over 7 years ago)
- Default Branch: master
- Last Pushed: 2024-05-21T14:14:34.000Z (over 1 year ago)
- Last Synced: 2024-05-21T15:35:54.404Z (over 1 year ago)
- Topics: 3d, domain-transform-filter, filter, geometry-image, geometry-images, mesh-filtering, mesh-processing
- Language: C
- Homepage:
- Size: 16.6 MB
- Stars: 5
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# dt-sgim
## Overview
Implementation of the DT-SGIM filter, published in *Domain transform for spherical geometry images* [1].
The DT-SGIM filter acts on polygonal meshes represented by [Geometry Images](http://hhoppe.com/proj/gim/) obtained from [spherical parametrization](http://hhoppe.com/proj/sphereparam/). As a result, the filter provides a smoothed mesh, while keeping its important curvatures.
## Compile
### Linux
You need the dependencies: gcc, g++, make, GLFW, GLEW, libgl, libpng-dev and zlib-dev.
To compile simply run:
```bash
$ make
```
and the binary `bin/gimmesh` will be created.
### OS X
You need the dependencies: gcc, g++, make, GLFW, GLEW and the OpenGL framework.
To compile simply run:
```bash
$ make
```
and the binary `bin/gimmesh` will be created.
## Usage
To use this tool, you must provide a geometry image. They are represented as `.gim` files with the following format, in order:
- Image Width: 4-bytes integer
- Image Height: 4-bytes integer
- Image Data: each pixel is represented as a 3-channel 4-byte float (RGB), totalizing 12 bytes per pixel. Total data size is (width * height * 3 (channels) * 4) bytes.
A set of example geometry images are available in the res/ folder.
To open the application, simply run:
```bash
$ ./bin/gimmesh -g
```
An iterative GUI will be opened and you will be able to filter the geometry image.
## Wavefront Objects
It is also possible to transform wavefront objects to the `.gim` format using the application.
To do that, simply run:
```bash
./bin/gimmesh -o
```
You can also set the optional parameters:
```
-e : specify the path of the geometry image that will be generated (default: ./export.gim)
-it : number of iterations for spherical parametrization algorithm (default: 500)
-s : size of geometry image ( x ) [must be an odd number] (default: 255)
```
> Note: The parametrization used to transform meshes to geometry images still needs to be improved. Thus, the quality of the result will depend on the input mesh.
## References
- [1] https://www.sciencedirect.com/science/article/abs/pii/S0097849320301503.