A3DRWParamsGeneralData

struct A3DRWParamsGeneralData

Reading options to filter the types of information that are read when CAD files are loaded.

All the m_bRead* fields are boolean options defaulted to A3D_FALSE, which means the related entity is skipped upon reading.

Even if these options are very common among CAD formats, some of them may be irrelevant to a specific format.

Loading a model

PRC basics

Reading views and PMIs

Traversing feature trees

3.0

Variables

A3DBool A3DRWParamsGeneralData.m_bReadSolids
A3DBool

Allows reading of solid parts.

A3DBool A3DRWParamsGeneralData.m_bReadSurfaces
A3DBool

Allows reading of surfaces entities.

A3DBool A3DRWParamsGeneralData.m_bReadWireframes
A3DBool

Allows reading of wireframe entities.

A3DBool A3DRWParamsGeneralData.m_bReadPmis
A3DBool

Allows reading of PMIs.

A3DBool A3DRWParamsGeneralData.m_bReadAttributes
A3DBool

Allows reading of non-geometric information linked to entities and files.

Attributes linked to solids and entities, such as material and density, are always read, even if m_bReadAttributes is A3D_FALSE.
A3DBool A3DRWParamsGeneralData.m_bReadHiddenObjects
A3DBool

Allows reading of representation items which are marked as hidden in the CAD file.

This option only impacts representation items. Reading of assembly-level entities (parts and product occurrences) is not affected, may the CAD file identify them as hidden or not.

Setting m_bReadHiddenObjects to false when reading PMIs, Views or complex assemblies may lead to unexpected behavior due to the potential for removal of bodies referenced by residual PMI or Views.

Default is A3D_TRUE. When set to A3D_FALSE, representation items considered hidden in the CAD file won’t be kept in the resulting PRC. This can be useful when the objective is to observe the visible appearance of the resulting PRC.

A3DBool A3DRWParamsGeneralData.m_bReadConstructionAndReferences
A3DBool

Allows reading of construction entities, such as planes and axes.

A3DBool A3DRWParamsGeneralData.m_bReadActiveFilter
A3DBool

Allows reading of only data stored in the active filter or on layers corresponding to the active filter.

A3DEReadingMode2D3D A3DRWParamsGeneralData.m_eReadingMode2D3D
A3DEReadingMode2D3D

If applicable, choose whether reading 2D drawing, 3D model or both.

For IGES format, kA3DRead_Both is not available and will default to kA3DRead_3D.

A3DEReadGeomTessMode A3DRWParamsGeneralData.m_eReadGeomTessMode
A3DEReadGeomTessMode

Select between reading geometry, tessellation or both.

A3DEUnits A3DRWParamsGeneralData.m_eDefaultUnit
A3DEUnits

DefaultUnit option restricted to those formats where unit never exists or is unreliable (U3D, CGR, STL, VRML)

  • If it is different than kA3DUnitUnknown, the default unit used is the one defined with this enum
  • If it is set to kA3DUnitUnknown, the default unit is considered unknown and the value is 1.0.
A3DBool A3DRWParamsGeneralData.m_bReadFeature
A3DBool

Allows reading of model feature tree.

10.2
A3DBool A3DRWParamsGeneralData.m_bReadConstraints
A3DBool

Allows reading of assembly constraints.

14.0
A3DInt32 A3DRWParamsGeneralData.deprecated_m_iNbMultiProcess

deprecated

A3DInt32

Deprecated. Not used anymore. This will be removed in version 2026.1.0.

A3DUns32 A3DRWParamsGeneralData.m_uiSearchTextureDirectoriesSize
A3DUns32

The size of m_ppcSearchTextureDirectories array.

8.0
A3DUTF8Char **A3DRWParamsGeneralData.m_ppcSearchTextureDirectories
A3DUTF8Char**

Additional search directories for texture files.

8.0
A3DUns32 A3DRWParamsGeneralData.m_uiSearchMaterialLibraryFilesSize
A3DUns32

The size of m_ppcSearchMaterialLibraryFiles array.

24.2
A3DUTF8Char **A3DRWParamsGeneralData.m_ppcSearchMaterialLibraryFiles
A3DUTF8Char**

Additional material library files.

24.2
A3DBool A3DRWParamsGeneralData.m_bTreatLongWireframeAsConstructionAndReferences
A3DBool

Remove long wireframe when m_bReadConstructionAndReferences is set to false.

This option will only apply when m_bReadWireframes is set to true. When m_bReadWireframes is set to false, all wireframes will be removed, no matter the value of m_dLongWireframeThreshold.

24.4

Threshold value to determine long wireframe is set via m_dLongWireframeThreshold.

A3DDouble A3DRWParamsGeneralData.m_dLongWireframeThreshold
A3DDouble

Define the threshold for long wireframe.

Default value is 24690.0

24.4

Any wireframe with a bounding box longer than this value will be removed if m_bTreatLongWireframeAsConstructionAndReferences is true, and m_bReadConstructionAndReferences is false