ZGL to MWX Soup import options
- Last UpdatedSep 03, 2025
- 3 minute read
ZGL to MWX Soup import configuration
The ZGL import configuration customizes the import settings for ZGL files with specific needs.
As the ZGL importer converts into MWX Soup, it supports all the available import actions. See Import actions for MWX Soup.
Parameters
These are the settings for a ZGL import configuration file.
|
Parameter |
Type |
Default |
Description |
|---|---|---|---|
|
cmdl |
bool |
false |
Launches in command line mode (different text output). |
|
cmpvertdelta |
sfloat |
0.0001 |
Used when compacting the vertices if gpreprocess is {2}; below this difference the vertices are merged (when value is {0} a different algorithm is used). |
|
configpath |
sstring |
Not set |
Config file path including extension. It's used when useConfigFile is set to true. |
|
detail |
sint |
0 |
The detail level. The default is 0, and will use the tessellator default values. From 1 onwards, it will start with low detail and will add subdivision sides as the number goes up. |
|
destinationpath |
sstring |
Not set |
The source destination path. Include filename with extension to overload file name. |
|
goctree |
sbool |
false |
Enable Octrees at Geometry level ([-tsoup] only). |
|
gpreprocess |
sint |
2 |
Amount of work to apply in processing the source geometry. {0} untouched, {1} recalculate normals, {2} recalculate normals and compact vertices. |
|
maxf |
|
200000 |
Maximum number of faces per Block (limit is ~1.3mld) ([-tsoup only]). |
|
maxp |
sint |
100000 |
Maximum number of primitives per Block (limit is ~4mld) ([-tsoup only], but not [-toctree]). |
|
maxv |
sint |
10000000 |
Maximum number of vertices per Block (limit is ~4mld) ([-tsoup only], but not [-toctree]). |
|
mergenodes |
bool |
true |
Merge some neighboring octree nodes to decrease object count ([-toctree] only). |
|
ngenmaxangle |
sfloat |
20 |
When normals are recalculated, this is the maximum angle (degrees) between faces in order to share the same normal. |
|
nohier |
bool |
false |
Disables the naming of objects using the full hierarchy. For example, SceneName|ParentA|ParentB|Child will be SceneName|Child |
|
nowarn |
bool |
false |
After exporting the .mwx file, will also export an .obj file ([-tsoup] only). |
|
obj |
bool |
false |
After exporting the .mwx file, will also export an .obj file ([-tsoup] only). |
|
onlyprims |
bool |
false |
Will not export nodes that are not primitives, such as hierarchy nodes (only if not [-tsoup]). |
|
recentermesh |
bool |
true |
If a Mesh was retrieved in world space it will be exported in local space (applies to Meshes that are not in a soup). |
|
rendups |
sbool |
true |
When nodes have the same name, they will be renamed. (not compatible with [-skipdups]) |
|
scale |
sfloat |
0.001 |
Scaling factor. The recommended value is 0.001. |
|
scene |
sstring |
Not set |
The name of the scene. This will be used as prefix for the objects naming; for example: SceneName|Object01. If not specified, the .mwx file name will be used. |
|
shader |
sstring |
Not set |
Specifies the Shader name. If not specified, it will be EngineLib|shRVM|default |
|
shaderparams |
sstring |
mReflectionMap=CubeRVM.dds |
Specifies additional Shader Parameters separated by a vertical pipe ( | ). For example: mTexture=Txt.tga|mColor=1.0 0.5 0.5 |
|
skipcolors |
bool |
false |
Assigns the same color to every primitive. |
|
skipdups |
bool |
true |
When nodes have the same name, only the first one will be exported (also the whole hierarchy will be skipped). |
|
toctree |
bool |
false |
Enables Octrees at Triangle level ([-tsoup] only) (does not use [-maxv] [-maxp]). |
|
tsoup |
sbool |
true |
Primitives will not be exported individually, but grouped into chunks of triangles. |
|
useConfigFile |
bool |
false |
Set to true to pass a config file path. Set to false to set all import settings directly. |