Cubic Stylization
Cubic stylization is a 3D stylization tool. Unlike image stylization (2D to 2D) and non-photorealistic rendering (3D to 2D), cubic stylization is a 3D to 3D stylization algorithm which takes a manifold triangle mesh as the input and outputs a cubified triangle mesh.
This is a C++ implementation based on "Cubic Stylization" by Hsueh-Ti Derek Liu and Alec Jacobson.
Download
We can download the application by cloning the repository with the RECURSIVE option
git clone --recursive https://github.com/HTDerekLiu/CubicStylization_Cpp.git
1. ImGui version
Once we clone the cubic stylization code, we offer an ImGui version in folder cubicStylization_ImGui
for one to play with the stylization interactively in the GUI. To compile the application, please type these commands in the terminal
cd CubicStylization_Cpp/cubicStylization_ImGui
mkdir build
cd build
cmake ..
make
This will create the excutable of the cubic stylization. To start the application, please run
./cubicStylization_bin [meshName]
where the example meshes are provided in /CubicStylization_Cpp/meshes
. Instructions of how to control the cubic stylization is listed on the side of the GUI.
2. Command line version
We also offer a command line version in folder cubicStylization_cmd
for one to cubify shapes directly. To compile the application, please type these commands in the terminal
cd CubicStylization_Cpp/cubicStylization_cmd
mkdir build
cd build
cmake ..
make
This will create the excutable of the cubic stylization. To start the application, please run
./cubicStylization_bin [meshName] [lambda]
where the lambda parameter controls the cubeness. This command line demo will save the output OBJ file in the directory CubicStylization_Cpp/cubicStylization_cmd/
. Both demos are based on the Algorithm 1 in the paper.
Please visit CubicStylization_MATLAB for a prototype implementation in MATLAB. Our code is licensed under MPL2. If any questions, please contact Hsueh-Ti Derek Liu ([email protected]).
Bibtex
@article{Liu:CubicStyle:2019,
title = {Cubic Stylization},
author = {Hsueh-Ti Derek Liu and Alec Jacobson},
year = {2019},
journal = {ACM Transactions on Graphics},
}