This is an old revision of the document!
Table of Contents
Installation of IG.Model.Processor v1.4.0.100
To install IG.Model.Processor you can follow the following steps.
Windows x64
Tested on clean system: Windows Server 2019/2022 and Windows 11
- Download or obtain the zip package containing all the necessary DLL files named
IG.Model.Processor-RT_1.3.zip. - Download or obtain
IG.Model.Processor_1.4.0.100.zip.
This is the program .exe itself. - Extract both zip packages into a single folder.
- Run the executable (
IG.Model.Processor.exe). - Even without commands or a batch file, you should get the {Cube.obj} geometry. This means the installation was completed successfully.
Linux Ubuntu 24.04
Tested on: Linux Ubuntu 24.04
- Obtain zip package named
Model.Processor_linux_1.4.0.100.zip. - Extract the package.
- Go inside the extracted folder named
Model.Processor_linux_programversionfull. You will see a script namedrun_install.sh. - Make the script executable by running:
chmod +x run_install.sh
- Run the script to install all required runtimes and prepare system.
./run_install.sh
- The successful installation should print the
–helpcommand of IG.Model.Processor in the terminal.
- After installation, you can run IG.Model.Processor with your JSON files. For example:
./IG_Model_Processor --model flat --file flatPanel-104-triangle.json --output OBJ
How to run IG.Model.Processor
The program is run via the command line. The main syntax is:
./IG_Model_Processor --model <MODEL> --file <PATH> [options]
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:
./IG_Model_Processor --model flat --file flatPanel-104-triangle.json --output OBJ
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.
Model Flag: <pre> –extrusion </pre>
- extrusion-101-min1.4.json Example commands:
- Linux:
./IG_Model_Processor --model extrusion --file extrusion-101-min1.4.json --output OBJ
* **Windows:**
IG.Model.Processor.exe --model extrusion --file extrusion-101-min1.4.json --output OBJ
List of Sample Files: <pre> extrusion-101-min1.4.json </pre>
Flat / FlatPanel Sample command and file list.
Model Flag: <pre> –flat or –flatpanel </pre>
- flatPanel-101-horizontal-min1.4.json Example commands:
- Linux:
./IG_Model_Processor --model flatpanel --file flatPanel-101-horizontal-min1.4.json --output OBJ
* **Windows:**
IG.Model.Processor.exe --model flatpanel --file flatPanel-101-horizontal-min1.4.json --output OBJ
List of Sample Files: <pre> flatPanel-101-horizontal-min1.4.json flatPanel-102-vertical-min1.4.json flatPanel-103-solid-min1.4.json flatPanel-104-triangle-min1.4.json flatPanel-111-horizontal-raised-min1.4.json flatPanel-112-vertical-raised-min1.4.json flatPanel-113-solid-raised-min1.4.json flatPanel-114-triangle-raised-min1.4.json flatPanel-115-vertical-arched-panel-min1.4.json </pre>
Solid Sample command and file list.
Model Flag: <pre> –solid </pre>
- solid-101-min1.4.json Example commands:
- Linux:
./IG_Model_Processor --model solid --file solid-101-min1.4.json --output OBJ
* **Windows:**
IG.Model.Processor.exe --model solid --file solid-101-min1.4.json --output OBJ
List of Sample Files: <pre> solid-101-min1.4.json solid-102-min1.4.json solid-103-min1.4.json solid-104-min1.4.json solid-111-min1.4.json solid-112-min1.4.json solid-113-min1.4.json solid-114-default-min1.4.json solid-114-min1.4.json solid-131-square-path-min1.4.json solid-132-beveled-path-min1.4.json solid-134-arched-panel-min1.4.json solid-135-square-with-profile-min1.4.json </pre>
Revolution Sample command and file list.
Model Flag: <pre> –revolution </pre>
- revolution-101.json Example commands:
- Linux:
./IG_Model_Processor --model revolution --file revolution-101.json --output OBJ
* **Windows:**
IG.Model.Processor.exe --model revolution --file revolution-101.json --output OBJ
