All Projects → merrell42 → model-synthesis

merrell42 / model-synthesis

Licence: other
Model synthesis is a technique for generating 2D and 3D shapes from examples.

Programming Languages

C++
36643 projects - #6 most used programming language
MAXScript
40 projects
python
139335 projects - #7 most used programming language
c
50402 projects - #5 most used programming language

Model Synthesis

Generated Model

Generated Textures

Model synthesis is a technique for generating 2D and 3D shapes from examples. It is inspired by texture synthesis. Model synthesis was created by Paul Merrell. Merrell published several papers about it from 2007 - 2011 at i3D, SIGGRAPH Asia, TVCG, and in his PhD disseration. More information can be found on his website. It contains additional results and videos explaining the algorithm. This code implements Merrell's 2007 algorithm.

Related Work

Model synthesis was inspired by work on texture synthesis, especially Efros and Leung, 1999. A comparison to other texture synthesis algorithms can be found in Section 2.2.2 here.

Model synthesis is formulated as a constraint satisfication problem. To solve this, model synthesis originally used the AC-3 algorithm by Mackworth [1977]. But the AC-4 method by Mohr and Henderson [1986] is faster. Both methods are included in this project. (Flip the Boolean "useAc4" to switch between them.) Model synthesis was the first to use this type of approach for texture synthesis and procedural modeling. Model synthesis initially focused on procedural modeling with only a few texture synthesis examples.

Wave Function Collapse (WFC) by Gumin [2016] also generates textures and models by solving a constraint satisfication problem. WFC follows the algorithm below, but chooses the cells in a different order in Step 2. Gumin focused more on texture synthesis. He created more example textures (which are used in this project). And he developed the idea of applying this to overlapping image tiles. This is often more convenient since the tiles can be computed directly from an image. Here is a more detailed comparison of the two methods.

How to Use

Build and run the main file "Model Synthesis.cpp". The list of inputs and the input parameters are in "samples.xml". The example images and models are in the samples directory. Results are saved into outputs. There are three types of inputs: simpletiled, overlapping, and tiledmodel. The first two generate image files. The tiledmodel generates a text file which can be used to create a 3D model in 3DS Max or Blender. To load it in 3DS Max, first open the model file in "models/3DS Max Scenes". Then run the MaxScript file "editor.ms", click "Open Model" and select the generated text file. This file contains more information on how to use editor.ms. To load in Blender, open the model file in "models/Blender Scenes" then run "load-synth.py".

Algorithm Overview

The goal is to generate new images or models that look like an example. The example is divided into 2D or 3D tiles. Two tiles can be next to one another in the output if they were next to each other in the example. This is called the adjacency constraint. Our goal is to fill in a grid with tiles. Each grid cell contains a label. Each label represents one of the tiles. The assigned labels must satisfy the adjacency constraint. This is a constraint satisfaction problem. To solve it, we keep track of a list of possible labels that can be assigned to each cell.

  1. Assign every possible label to each cell.
  2. For each cell, pick one of the possible labels. Assign it to the output.
    1. Remove the other labels from the cell.
    2. Each time a label is removed propagate this removal to the other cells. Eliminate any labels that do not satisfy the adjacency constraint. This part uses the AC-4 algorithm.

Algorithm

Modifying in Blocks

This algorithm can fail. During the propagation step, it is possible for every label to be removed from every cell. This is, in fact, an NP-hard problem. What this means is that the difficulty of the problem grows exponentially with the size of the output. The algorithm is likely to succeed as long as the output size is kept small. Furthermore, large textures and models can be generated incrementally. We can start with a trivial solution and modify it in small parts. This allows us to reliably generate large textures and models.

This is just a brief overview. More details can be found in the videos here or in Section 3 here.

Modifying in Blocks

Credits

Most of the code in this project was written by Paul Merrell with a few exceptions:

  1. The XML parser by Frank Vanden Berghen,
  2. The PNG reading and writing by Lode Vandevenne
  3. The importer for Blender (load-synth.py) by Jason Sewall.

The 3D models were created by Paul Merrell.

The images and tile sets are the same as Gumin's Wave Function Collapse. The tile sets are in a format he constructed. He writes " Some samples are taken from the games Ultima IV and Dungeon Crawl Stone Soup. Circles tileset is taken from Mario Klingemann. FloorPlan tileset is taken from Lingdong Huang. Idea of generating integrated circuits was suggested to me by Moonasaur and their style was taken from Zachtronics' Ruckingenur II. Cat overlapping sample is taken from the Nyan Cat video, Qud sample was made by Brian Bucklew, MagicOffice + Spirals samples - by rid5x, ColoredCity + Link + Link 2 + Mazelike + RedDot + SmileCity samples - by Arvi Teikari, Wall sample - by Arcaniax, NotKnot + Sand + Wrinkles samples - by Krystian Samp. Summer tileset was made by Hermann Hillmann. Voxel models were rendered in MagicaVoxel."

References

A. Efros and T. Leung. Texture synthesis by non-parametric sampling. ICCV, 1999.

M. Gumin. 2016. WaveFunctionCollapse. GitHub repository, 2016.

A. Mackworth. Consistency in networks of relations. Artificial Intelligence, 1977.

P. Merrell. Model Synthesis. Ph.D. Dissertation, University of North Carolina at Chapel Hill, 2009.

P. Merrell and D. Manocha. Model Synthesis: A General Procedural Modeling Algorithm. IEEE Transactions on Visualization and Computer Graphics, 2010.

P. Merrell and D. Manocha. Continuous Model Synthesis. ACM Transactions on Graphics, 2008.

P. Merrell. Example-Based Model Synthesis. Symposium on Interactive 3D Graphics (i3D), 2007.

R. Mohr and T. Henderson. Arc and path consistency revisited. Artificial Intelligence, 1986.

Note that the project description data, including the texts, logos, images, and/or trademarks, for each open source project belongs to its rightful owner. If you wish to add or remove any projects, please contact us at [email protected].