From a30d9e71738153ccdf0b1989b5af16d30d8889ac Mon Sep 17 00:00:00 2001 From: Tom Ruisseau Date: Mon, 15 Jul 2024 12:29:32 +0200 Subject: [PATCH] Intro complete --- src/SUMMARY.md | 2 ++ src/doc_menu.md | 1 + src/intro.md | 44 +++++++++++++++++++++++++++++++++++++++----- 3 files changed, 42 insertions(+), 5 deletions(-) create mode 100644 src/doc_menu.md diff --git a/src/SUMMARY.md b/src/SUMMARY.md index 014dc9c..c69063b 100644 --- a/src/SUMMARY.md +++ b/src/SUMMARY.md @@ -3,3 +3,5 @@ [Introduction](./intro.md) # Technical documentation + +[Documentation](./doc_menu.md) \ No newline at end of file diff --git a/src/doc_menu.md b/src/doc_menu.md new file mode 100644 index 0000000..7d8b3af --- /dev/null +++ b/src/doc_menu.md @@ -0,0 +1 @@ +# Documentation \ No newline at end of file diff --git a/src/intro.md b/src/intro.md index fef3431..d888ffc 100644 --- a/src/intro.md +++ b/src/intro.md @@ -4,9 +4,43 @@ ISGT is a Unity project aimed at generating realistic virtual rooms. They are th ## How to use -To use the software, you only need to download the latest realease, unzip it and start ISGT.exe .
-You canchange the settings and the output folder via the menu, and then start the process. It can be stopped at any point by pressing escape. -By default, screenshots and JSONs are saved at /ISGT_Data/Export/ +To use the software, you only need to download the [latest realease](https://github.com/numediart/ISGT/releases), unzip it and start ISGT.exe. + +You can change the settings and the output folder via the menu, and then start the process. It can be stopped at any point by pressing escape. + +By default, screenshots and JSONs are saved at /ISGT_Data/Export/. + +## Parameters + +The process is fully parametrable thanks to the following settings : +- **General settings** + - Number of room + - Screenshots per room + - Image resolution : the size of the screenshots, from 640 x 360 to 2560 x 1440 +
+- **Generation settings** + - Rooms max size + - Props density : the amount of furniture in the room + - Doors density : the max amount of doors per room + - Windows density : the max amount of windows in the room +
+- **Camera settings** + - Camera max rotation : the max angle of the camera around x,y and z + - FOV : the diagonal Field Of View of the camera + - ISO + - Aperture + - Focus Distance +
+- **Precision settings** + - Raycasts amount : the number of rays shot when calculating camera visibility + +#### Performances + +Most of these parameters (except from camera settings) have an impact on performances and will affect the duration of the process. The estimated remaining time is displayed on the bottom left corner of the screen. + +#### Presets + +When applying new settings, a preset file is created and can then be selected to retrieve the same configuration. They can be found in the Ressource folder of the app if the user need to share or delete one. ## Generated data @@ -82,6 +116,6 @@ Each screenshot is matched with a Json containing info about the room, the seeds ## Open source -ISGT is fully open-source, you can fork this repository and start helping us improve the tool. To work on this project, you will need Unity version 2022.3.26f1 or higher.
+ISGT is fully open-source, you can fork the GitHub repository and start helping us improve the tool. -A more detailed documentation is on the way. +You can find the complete technical documentation [here](doc_menu.md). \ No newline at end of file