# Modular-Tree-Modeler-25

**Repository Path**: kingfuyao/Modular-Tree-Modeler-25

## Basic Information

- **Project Name**: Modular-Tree-Modeler-25
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-12-23
- **Last Updated**: 2025-12-23

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# ModularTreeModeler
<p align="center">
<img src="https://github.com/RyuZhihao123/Modular-Tree-Modeler-25/blob/main/Figures/figure_gallery.png" width="70%">
</p>

Efficient generation of customized 3D plant models is an important problem in computer graphics. However, existing procedural methods always rely on algorithmically writing complex structural rules, thus very difficult and unintuitive for non-experts to learn.

This repository contains a more advanced 3D modeling system, which enables users to **intuitively** manipulate a so-called **``Modular Graph``** to easily design and obtain diverse 3D plant models. 

📺 **[[Preview Video (1min)]](https://drive.google.com/file/d/1FugtnOsYm2L_HkJawwiUUKoe6aQs5e93/view?usp=sharing): Short demo video for fast preview. (Recommend watching it before starting🔥🔥!)**

📺 [[Full instruction Video (5min)]](https://drive.google.com/file/d/1uOwghzsHS2jrZXc8RHVIOitZZubseMT-/view?usp=sharing): A long instruction video to teach the usage step by step.

🟠 [[Program Download]](https://github.com/RyuZhihao123/Modular-Tree-Modeler-25/tree/main/GraphTreeModeler): Please download the entire folder to execute the program.

BTW, I am continuing adding new features to this software. If you have any suggestions or requirements, please feel free to raise an issue! ^_^.





https://github.com/user-attachments/assets/f0d309b6-fb10-4030-9ec2-0a2231a6d7a9







## Quick Start

📺 Before starting, we also strongly recommend that all users carefully watch this [[5-min Instruction Video]](https://drive.google.com/file/d/1uOwghzsHS2jrZXc8RHVIOitZZubseMT-/view?usp=sharing) to understand the step-by-step process of designing a simple tree species.

This software is only runable on Windows PCs (we successfully tested on Win 10 and Win 11).

### 🌳 Create Trees using Existing Species Templates:

(0) Download the program from [this folder](https://github.com/RyuZhihao123/Modular-Tree-Modeler-25/tree/main/GraphTreeModeler).

(1) Open the first program ``GraphTreeModeler.exe``, which is the window for visualization of 3D results. 

(2) Then open the second program ``GraphTreeModeler_UI.exe``, which is the core user interface for interactively designing species graphs. Please note that:

- The second exe often takes around 6 seconds for initialization. Please be patient to wait.
- **You must make sure to sequentially open two exes in this order.** They have dependencies thus cannot be opened in an inverse order.

(3) For convenience, we've provided several pre-created species templates under this [folder path](https://github.com/RyuZhihao123/Modular-Tree-Modeler-25/tree/main/GraphTreeModeler/SavedGraphs), which you can use for quickly creating some 3D tree models. 

- To load them, go to the **``Menu Bar``** of the second program (i.e., ``GraphTreeModeler_UI``), and click **``File``** -> **``Load Graph``**. Then, after selecting a template file and pressing the ``Generate New`` button, our system will automatically generate a nice-looking 3D tree within half a second.
- You can also refer to the **[[Preview Video]](https://drive.google.com/file/d/1FugtnOsYm2L_HkJawwiUUKoe6aQs5e93/view?usp=sharing)** to see how to load the templates. **(Recommend!)**

### 🌳 Design Your Own Species From Scratch:

After executing the two programs following the steps (1) and (2) above, you can also freely design your own species graphics! Please watch the [[5-min Instruction Video]](https://drive.google.com/file/d/1uOwghzsHS2jrZXc8RHVIOitZZubseMT-/view?usp=sharing) to see how to practically use the system.

FYI, the main operations and hotkeys are listed below:

- ``Left MouseButtion``: Select/move an existing node.
- ``Ctrl`` + ``Left MouseButtion``: Add a new node.
- ``Alt`` + ``Left MouseButtion``: Connect edges between two nodes.
- ``Backspace``: Delete a selected node.

<img src="https://github.com/RyuZhihao123/Modular-Tree-Modeler-25/blob/main/Figures/interfaces.png" alt="Interfaces" style="width:700px;"/>


## More.

Our system can be used to automatically generate large 3D datasets in various data formats/representations.
![Teaser](https://github.com/RyuZhihao123/Modular-Tree-Modeler-25/blob/main/Figures/fig_representation.png)
![Teaser](https://github.com/RyuZhihao123/Modular-Tree-Modeler-25/blob/main/Figures/fig_multi.png)