Hide menu
Settings file format

The settings file follows the INI format and has the following syntax:

[section1]
parameter11=value11
parameter12=value12
...
[section2]
parameter21=value21
...

The settings file provided via command line is not required to contain all parameters. If only a subset of parameters is specified the rest will be taken as follows:

  1. If the specific parameter was changed in CAD Exchanger GUI on a given machine, the set value will be taken;
  2. Otherwise, default value will be taken.

Common parameters

Section Name: common

ParameterTypeDefault valueDescription
concurrent

Boolean

true

Specifies whether the parallel computations should be used.

Format specific parameters

SolidWorks

This format does not have any parameters.

Creo

This format does not have any parameters.

Siemens NX

This format does not have any parameters.

IGES

Export Parameters

Section Name: %7B212ba5d0-1b69-4aaf-9509-44f406db9301%7D

ParameterTypeDefault valueDescription
units

Length Units

0

Specifies the length unit.

writemode

String

0

Specifies preferred type of topological entities. The following values are supported:
0 - use Bounded Surface (type 143) when writing solid or sheet bodies.
1 - use Manifold Solid B-Rep (type 186) when writing solid bodies and Bounded Surface (type 143) when writing sheet bodies.

STEP

Import Parameters

Section Name: %7Bac61d53b-18dc-467b-b3d0-1f91f0d955ff%7D

ParameterTypeDefault valueDescription
brep.type

Number

0

Specifies the preferred B-Rep shape representation type, which should be imported. The following values are supported:
0 - the most appropriate representation is chosen automatically.
1 - all representations are imported. This includes the main representation and all connected to it via relationships.
2 - prefer ADVANCED_BREP_SHAPE_REPRESENTATION, which stores solid bodies.
3 - prefer MANIFOLD_SURFACE_SHAPE_REPRESENTATION, which stores sheet bodies with shells.
4 - prefer NON_MANIFOLD_SURFACE_SHAPE_REPRESENTATION, which stores sheet bodies with faces.
5 - prefer EDGE_BASED_WIREFRAME_SHAPE_REPRESENTATION, which stores wireframe bodies.
In case the preferred representation cannot be found, the first appropriate is imported.

Export Parameters

Section Name: %7Bf22f6a46-2e3b-4493-b85c-adb76ac6b6c9%7D

ParameterTypeDefault valueDescription
units

Length Units

0 (mm)

Specifies the length unit.

writer.extRefMode

Split mode

0 (monolithic)

Specifies the split mode.

writePCurves

Boolean

false

Specifies whether p-curves (edge curves in 2D parametric space of face surfaces) should be written. Writing p-curves can be helpful for certain receiving CAD systems to import data from STEP files. However writing p-curves can increase an output file size considerably.

ACIS

Export Parameters

Section Name: %7B62c7c279-ae3a-47ac-9342-d471ec37c2b8%7D

ParameterTypeDefault valueDescription
format

Number

0

Specifies version of the ACIS file. The following values are supported:
0 - version 4
1 - version 7

Parasolid

This format does not have any parameters.

JT

Export Parameters

Section Name: %7B5129dc5b-43dc-4a18-a041-964a7440339e%7D

ParameterTypeDefault valueDescription
split

Split mode

1 (perPart)

Specifies the split mode.

savebrep

Boolean

true

Specifies whether part B-Rep representations should be saved.

savepoly

Boolean

true

Specifies whether polygonal representations should be saved.

overrideinstances

Boolean

true

Specifies whether parts and assembly will use a name of the first instance if original name is not specified. If false, original names of parts/assemblies/instances are stored in the JT file.

units

Length Units

0 (mm)

Specifies the length unit.

IFC

Export Parameters

Section Name: %7B5129dc5b-43dc-4a18-a041-964a7440339e%7D

ParameterTypeDefault valueDescription
units

Length Units

0 (mm)

Specifies the length unit.

Rhino

Import Parameters

Section Name: %7B1186B46F-B3FC-4AE6-92A1-62A4409E0870%7D

ParameterTypeDefault valueDescription
meshindex

number

0

The type of mesh to read. The following values are supported:
0 - "default"
1 - "render"
2 - "analysis"
3 - "preview"

hiddenobjects.mode

Boolean

false

Specifies whether the hidden objects should be read.

pcurve.mode

Boolean

true

Specifies whether original parametric curves should be read from the file.

Export Parameters

Section Name: %7B2D3D3A68-5A9D-443D-824A-054F80186E2E%7D

ParameterTypeDefault valueDescription
version

Number

4

Specifies version of the Rhino file. The following values are supported:
0 - version 2
1 - version 3
2 - version 4
3 - version 5
4 - version 6

savebrep.mode

Boolean

true

Specifies whether part B-Rep representations should be saved.

savepoly.mode

Boolean

true

Specifies whether polygonal representations should be saved.

units

Length Units

0 (mm)

Specifies the length unit.

3DS

This format does not have any parameters.

3MF

This format does not have any parameters.

Collada

This format does not have any parameters.

FBX

Export Parameters

Section Name: %7B8711BA5C-E40C-469E-9C64-147421C4B723%7D

ParameterTypeDefault valueDescription
fbxVersion

Number

0

Specifies version of the FBX file. The following values are supported:
0: version 2012
1: version 2014
2: version 2016
3: version 2019

isText

Boolean

false

Specifies whether generated file should be written in text form (true) or binary form (false).

units

Length Units

1 (cm)

Specifies the length unit.

glTF

This format does not have any parameters.

Wavefront OBJ

Import Parameters

Section Name: %7B3BAFD3B1-B3ED-4B97-B396-6218CEBF4D6D%7D

ParameterTypeDefault valueDescription
enforceGrouping

Boolean

false

Specifies whether forced grouping should be enabled to reduce amount of created parts.

units

Length Units

0 (mm)

Specifies the length unit.

Export Parameters

Section Name: %7B8D6BE5E6-C724-4D69-822E-C11DF1FAAC7F%7D

ParameterTypeDefault valueDescription
overrideduplicatenames.mode

Boolean

true

Specifies whether original names should be supplemented by suffix(es) to provide unique name to every instance of the part. This allows some receiving software to avoid merging of geometries of parts with same name when reading an exported .obj file.

normals.mode

Boolean

true

Specifies whether vertex normal should be saved or not. When vertex normals are stored in the .obj file the model can be displayed in smooth shading by third-party viewers. Otherwise the model will be displayed in flat shading only.

mtlgeneration.mode

Boolean

true

Specifies whether material library should be generated or not. The material library contains materials used in the model. If the material library is not created then no colors or materials will be exported.

replaceSpacesInNames

Boolean

false

Specifies whether space characters in part names should be replaced by '_' character or not. It can improve compatibility with receiving systems.

units

Length Units

mm

Specifies the length unit.

X3D

Export Parameters

Section Name: %7Bb2bbfe9f-5537-4d30-ac54-a85ed7a7290a%7D

ParameterTypeDefault value

Description

writeNormals

Boolean

false

When vertex normals are stored in the file the model can be displayed in smooth shading by third-party viewers. Otherwise the model will be displayed in flat shading only.

units

Length Units

0 (mm)

Specifies the length unit.

VRML

Import Parameters

Section Name: %7Bd8cac077-fb49-4572-a6f4-6470c1c6a8da%7D

ParameterTypeDefault valueDescription
units

Length Units

2 (m)

Specifies the length unit.

Export Parameters

Section Name: %7Bd13caad8-9ef2-4403-88d7-cc365cd77461%7D

ParameterTypeDefault valueDescription
units

Length Units

2 (m)

Specifies the length unit.

STL

Import Parameters

Section Name: %7B823eabbe-9ee7-4ad1-a195-12252fb3623e%7D

ParameterTypeDefault valueDescription
units

Length Units

1 (mm)

Specifies the length unit.

Export Parameters

Section Name: %7Bef0714ca-fd0e-4d98-9fd5-94648099af56%7D

ParameterTypeDefault valueDescription
ascii.mode

Boolean

false

Specifies whether generated file should be written in text form (true) or binary form (false).

ismultiPart.mode

Boolean

true

Specifies whether each body is saved in a separate [solid/endsolid] section in STL file.

units

Length Units

0 (mm)

Specifies the length unit.

DXF

This format does not have any parameters.

BRep

Import Parameters

Section Name: %7B633d57ab-5714-4900-8264-71f48d840cfc%7D

ParameterTypeDefault valueDescription
breaksharing

Boolean

true

Part bodies must not share topological subshapes to ensure correct functioning of various algorithms especially when using parallel computations. Set this option to false only if imported models already guarantee absence of sharing.

Native CAD Exchanger format

Export Parameters

Section Name: %7B8c4d235e-957b-428a-be5f-f3d3fa4cf9ec%7D

ParameterTypeDefault valueDescription
savebrep Booleantrue

Indicates whether to save BRep representation or not

savepoly Booleantrue

Indicates whether to save Poly representation or not

preferredlod String medium

Indicates granularity level used as filter for Poly representations export. The following values are supported:
fine - only fine representation will be saved
medium - only medium representation will be saved
coarse - only course representation will be saved
any - all polygonal representations will be saved

savetextures Booleanfalse

Indicates whether to save textures or not

savepropertiesBooleantrue

Indicates whether to save properties or not

savepmi Booleanfalse

Indicates whether to save PMI data or not

savelayers Booleantrue

Indicates whether to save layers or not

Graphical formats

Export Parameters

Section Name: %7B7299022c-2011-4b30-962c-caaa39cbcb05%7D

ParameterTypeDefault valueDescription
width

Number

200

Specifies image width in pixels. Should be greater than 64.

height

Number

200

Specifies image height in pixels. Should be greater than 64.

bgcolor

String

transparent

Specifies background color. The following values are supported:
#RGB - the three-digit hexadecimal RGB notation.
#RRGGBB - the six-digit hexadecimal RGB notation.
namedColor - name from the list of colors defined in the list of SVG color keyword names provided by the World Wide Web Consortium. For example, "azure" or "black".
transparent - representing the absence of a color.

cameraposition

String

xposynegzpos

Specifies camera position (positive/negative XYZ). The following values are supported:

xpos
ypos
zpos
xneg
yneg
zneg
xposypos
xposzpos
yposzpos
xnegyneg
xnegypos
xnegzneg
xnegzpos
ynegzneg
ynegzpos
xposyneg
xposzneg
yposzneg
xposyposzpos
xposynegzpos
xposyposzneg
xnegyposzpos
xposynegzneg
xnegyposzneg
xnegynegzpos
xnegynegzneg

Aliases:

front
back
top
bottom
left
right

cameraprojection

String

isometric

Specifies camera projection mode. The following values are supported: isometric and perspective

representation

String

auto

Specifies representation to display. The following values are supported: auto, brep, poly, finepoly, mediumpoly, coarsepoly. auto mode means to display BRep representation if exists, otherwise to display any Poly representation.

displaymode

String

auto

Specifies display mode used for rendering. The following values are supported: auto, wireframe, shaded, shadedwithboundaries. auto mode means to use shadedwithboundaries for BRep representation, and to use shaded otherwise.

Split mode

The mode of writing file with external references.

ValueDescription
0

Monolithic file (monolithic).

1

Central file with scene graph and each part in own file (perPart).

2

Central assembly, sub-assemblies and each part in own file (perAssembly).

Length units

The length unit is used to convert all geometric entities and also geometric validation properties.

Warning
Custom properties are always converted "as-is", i.e. are not affected by length unit.
ValueLength unit
0

millimeters (mm)

1

centimeters (cm)

2

meters (m)

3

inches (in)

4

feet (ft)

5

yards (yd)

6

micrometers (μm)

7

decimeters (dm)

8

kilometers (km)

9

mils (mil)

10

miles (mi)

Example

[common]
concurrent=true
[%7B1186b46f-b3fc-4ae6-92a1-62a4409e0870%7D]
meshindex=0
hiddenobjects.mode=false
[%7B62c7c279-ae3a-47ac-9342-d471ec37c2b8%7D]
format=1
[%7Bef0714ca-fd0e-4d98-9fd5-94648099af56%7D]
ascii.mode=false
[%7B5129dc5b-43dc-4a18-a041-964a7440339e%7D]
split=0
savebrep=true
savepoly=true
[%7B8d6be5e6-c724-4d69-822e-c11df1faac7f%7D]
mtlgeneration.mode=true
[%7B2d3d3a68-5a9d-443d-824a-054f80186e2e%7D]
units=0
savebrep.mode=true
savepoly.mode=true
[%7B7299022c-2011-4b30-962c-caaa39cbcb05%7D]
width=512
height=512
cameraprojection=perspective
displaymode=shaded