subface

A collection of triangle mesh subdivision/tessellation/decimation implementations.

Compiling

git clone https://github.com/chaosink/subface.git --recursive
cd subface
mkdir build
cd build
cmake ..
cmake --build . --config Debug # Or Release

Usage

Command line

Usage: subface [-h] [--cmd] [--export_obj] [--save_png] [--smooth] [--fix_camera] [--cull] [--transparent] [--render VAR] [--method VAR] [--level VAR] OBJ_file_path

Process geometries with one of the following methods:
    1.LoopSubdivideSmooth
    2.LoopSubdivideSmoothNoLimit
    3.LoopSubdivideFlat
    4.Tessellate4
    5.Tessellate4_1
    6.Tessellate3
    7.Decimate_ShortestEdge_V0
    8.Decimate_ShortestEdge_Midpoint
    9.MeshoptDecimate
    10.MeshoptDecimateSloppy
    11.SimplygonDecimate


Positional arguments:
  OBJ_file_path         OBJ file path

Optional arguments:
  -h, --help            shows help message and exits
  -v, --version         prints version information and exits
  -c, --cmd             run in command line mode
  -e, --export_obj      export OBJ in command line mode
  -s, --save_png        save PNG in command line mode
  -n, --smooth          use smooth normal
  -f, --fix_camera      fix camera
  -u, --cull            enable face culling
  -t, --transparent     enable transparent window
  -r, --render          render mode ID [default: 0]
  -m, --method          processing method ID [default: 1]
  -l, --level           processing level [default: 0]

Rendering

key	function
`Tab`	switch rendering mode: FacesWireframe (default), FacesOnly, WireframeOnly
`N`	enable / disable (default) smooth rendering
`C`	enable / disable (default) face culling
`T`	enable / disable (default) transparent window
`F`	use camera's fixed parameters
`R`	refresh camera's fixed parameters
`P`	print camera's current parameters
`F2`	save the screenshot as a PNG file
`ESC`	exit

Camera controlling

key	function
(`Shift` +) `W`/`S`/`A`/`D`/`Q`/`E`	(slowly) move forward / backward / left / right / down / up
(`Shift` +) `J`/`L`/`I`/`K`	(slowly) turn left / right / up / down
`-`/`=`	slow down / speed up movement
`[`/`]`	slow down / speed up turning
`Space`	reset camera and model
`mouse left button`	rotate model
`mouse right button`	change camera direction
`mouse scroll wheel`	adjust field of view

Triangle mesh processing

key	function
`Ctrl` + `1`,...,`6`	choose from the subdivision and tessellation methods 1.LoopSubdivideSmooth 2.LoopSubdivideSmoothNoLimit 3.LoopSubdivideFlat 4.Tessellate4 5.Tessellate4_1 6.Tessellate3
`Alt` + `1`,...,`5`	choose from the decimation methods 1.Decimate_ShortestEdge_V0 2.Decimate_ShortestEdge_Midpoint 3.MeshoptDecimate 4.MeshoptDecimateSloppy 5.SimplygonDecimate
`0`-`9`	processing level, `0` for the original mesh (default)
`,`/`.`	decimate one less/more triangle for the decimation methods
`O`	export the processed mesh as an OBJ file

Results

Rendering modes

FacesWireframe	FacesOnly

WireframeOnly, Cull_false	WireframeOnly, Cull_true

LoopSubdivideSmooth, Normal_flat vs Normal_smooth

original mesh, Normal_flat	original mesh, Normal_smooth

level=1, Normal_flat	level=1, Normal_smooth

level=2, Normal_flat	level=2, Normal_smooth

level=3, Normal_flat	level=3, Normal_smooth

level=4, Normal_flat	level=4, Normal_smooth