Differences

This shows you the differences between two versions of the page.

--- ig:gfx:how-to-run-ig.model.processor [2025/10/29 09:10] – ig_ii
+++ ig:gfx:how-to-run-ig.model.processor [2025/10/29 09:11] (current) – ig_ii
@@ Line 1: / Line 1: @@
+====== How to run IG.Model.Processor ======
+The program is run via the command line. The main syntax is:
+<code bash>
+./IG_Model_Processor --model <MODEL> --file <PATH> [options]
+</code>
+===== Main Options =====
+  * **--model {SOLID, FLAT, EXTRUSION, REVOLUTION}**
+    Select the model to be processed. Model names are case-insensitive (e.g., SOLID, solid, Solid).\\
+    Default: ''SOLID''\\
+    Example: ''--model SOLID''
+  * **--file <path>**
+    Specify the absolute path of the file to be processed. The file format depends on the selected model (e.g., JSON for SOLID).\\
+    Default: empty\\
+    Example: ''--file C:/path/to/your/file/test.json''
+  * **--output {obj, stl, step, all, ctm, obj+ctm}**
+    Specify the output format(s). Case-insensitive.\\
+    Default: ''obj''\\
+    Example: ''--output obj''
+  * **--out <path>**
+    Optional. Specify the output folder for generated models.\\
+    Default: ''c:/tmp''\\
+    Example: ''--out C:/path/to/your/folder/''
+  * **--no-uvs**
+    Disable UV generation for the ''.obj'' output.\\
+    If specified, no UV coordinates will be included.\\
+    Additionally, no post-processing of mesh shading will be performed; the mesh will be outputted with flat shading.
+  * **--quality**
+    Overwrite JSON quality parameters.
+  * **--help**
+    Display the help message and exit.
+===== Example Command =====
+To process a flat panel JSON file and generate an OBJ output:
+<code bash>
+./IG_Model_Processor --model flat --file flatPanel-104-triangle.json --output OBJ
+</code>
+====== Recommendations for First-Time Users ======
+Use one of the sample JSON files as an example. There are also ''.bat'' files (Windows) with corresponding names for each sample. You can run them if the BAT file and JSON are in the same directory as the IG.Model.Processor executable.
+Change a parameter and observe how the geometry behaves. Each parameter’s meaning can be found in the spec sheets for each model, also referenced in this documentation. Example commands will work if your JSON file is placed in the same directory as the IG.Model.Processor executable and your terminal is pointing to root of Model.Processor, for both Linux and Windows.
 ===== Extrusion Sample command and file list. =====