You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
{{ message }}
This repository was archived by the owner on May 6, 2026. It is now read-only.
Copy file name to clipboardExpand all lines: README.md
+22-13Lines changed: 22 additions & 13 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,5 +1,9 @@
1
1
# Environment LOD Tools
2
2
3
+
<palign="center">
4
+
<imgwidth="960"height="410"src="https://raw.githubusercontent.com/gojushin/EnvironmentLodTools/main/docs/resources/enviro_lod_tools_example.jpg"alt="LOD Example logo">
5
+
</p>
6
+
3
7
This is a collection of plugins for [Blender](https://www.blender.org/) (v. 4.0.0 and above).
4
8
The plugins are designed to help with the creation of environment levels of detail (LODs) for terrestrial photogrammetry models.
5
9
(Models of Landscapes, Cities, and other "flat" structures).
@@ -8,26 +12,20 @@ The plugin is split into several single plugins, that can be used independently
8
12
There is also a combined plugin that can load a model from the file system and generate LODs for it, without actively rendering it to the viewport.
9
13
**This is essential for source files that are too massive to display in the viewport.**
10
14
11
-
A version that runs entirely headless is also planned.
12
-
13
15
### Features
14
16
15
17
-**Cleanup**: Cleans/Preprocesses the mesh for use in the LOD pipeline.
16
-
-**Mesh Slicer**: Cuts a mesh into a user-defined amount of square slices.
17
-
-**LOD Pipeline**: Generates the levels of detail (LODs) for all the selections using the provided settings.
18
+
-**Mesh Slicer**: Cuts a mesh into a user-defined amount of square slices. (This reimplements Blenders Bisect logic in a way that does not require to duplicate the mesh in order to keep both halfs)
19
+
-**LOD Pipeline**: Generates the levels of detail (LODs) for all the selections using the provided settings. The LOD generation retains the borders of the highest LOD for flawless LOD transitions of individual modules.
18
20
-**XAtlas Unwrapper**: Unwraps the model using the [xatlas-python](https://github.com/mworchel/xatlas-python) bindings.
19
21
-**Baker**: Transfers the base color of a defined mesh onto one or multiple selected meshes.
20
22
21
23
22
-
### Installation
23
-
24
-
## Plugin
25
-
To install the plugins, follow these steps:
24
+
# Installation
26
25
27
-
1. Download the [latest release](https://github.com/gojushin/EnvironmentLodTool/releases/latest) from GitHub.
28
-
2. In Blender, go to `Edit` -> `Preferences` -> `Add-ons` and click on the `Install` button.
29
-
3. Select the .zip file from the download folder.
30
-
4. Enable the plugins by checking the plugins checkbox. *Note: This invokes pip to install xatlas to blenders environment and can therefore cause Blender to hang for a second.*
EnvironmentLodTools can also be used with a "standalone" PySide6 based GUI.
@@ -39,9 +37,20 @@ To use the GUI do the following:
39
37
3. Run `pip install -r requirnments.txt` in the directory of the plugin.
40
38
4. Start the GUI by executing `enviro_tools_gui.py`
41
39
40
+
## Plugin
41
+
To install the plugins, follow these steps:
42
+
43
+
1. Download the [latest release](https://github.com/gojushin/EnvironmentLodTool/releases/latest) from GitHub.
44
+
2. In Blender, go to `Edit` -> `Preferences` -> `Add-ons` and click on the `Install` button.
45
+
3. Select the .zip file from the download folder.
46
+
4. Enable the plugins by checking the plugins checkbox. *Note: This invokes pip to install xatlas to blenders environment and can therefore cause Blender to hang for a second.*
47
+
42
48
### Usage
43
49
44
-
Once installed, the plugins can be accessed through the `Tool` panel.
50
+
Once installed, the plugins can be accessed through the `Tool` and `Tools` panel.
51
+
52
+
To use the GUI, download the source code and execute the `enviro_tools_gui.py` file.
53
+
_Note: Since Blender is non-thread safe by nature, the GUI will currently freeze. You can track the progress in the CLI._
0 commit comments