Autodesk 3DS Reader

3DS
File Extension 3DS
Supported Versions Any
Platforms wy ly my an iy
Tessellation t_green Supported
B-rep c_grey N/A
PMI c_grey N/A

3DS is a binary 3D file format provided by Autodesk. Usually 3DS files come with the .3ds extension.

How to Import From 3DS

To load a 3DS file, use A3DAsmModelFileLoadFromFile(). The A3DParamsLoadData structure is used to customize the loading behavior:

A3DAsmModelFile* pModelFile = 0;

A3DRWParamsLoadData sReadParam;
A3D_INITIALIZE_DATA(A3DRWParamsLoadData, sReadParam);
sReadParam.m_sGeneral.m_bReadSolids = true;

// ... set other A3DRWParamsLoadData fields as necessary

A3DAsmModelFileLoadFromFile("path/to/file.3ds", &sReadParam, &pModelFile);

See Simple Load and Export for more about loading model files.

B-rep

3DS files only contain tessellated data. Thus, B-rep geometries are not available with this format.

Assembly

3DS being a simple 3D format, complex structures made of assemblies are not part of its specification.

Textures

Textures are fully supported when parsing 3DS.

Inside 3DS file, texture file names are stored:

  • Truncated to 12 characters
  • Without the containing folder
  • Usually capitalized

This means the name of the texture may not match the actual texture file to load.

To load the textures upon loading, HOOPS Exchange will open the first matching file by truncating and capitalizing each file found in the search folders, considering the first match as satisfying.

The search folders are in that order:

  • The parent folder of the 3DS file
  • The folders specified in A3DRWParamsGeneralData.m_ppcSearchTextureDirectories

3DS and Default Unit

By default, 3DS file format stores the measurements in inches. Because PRC default unit is in millimeters a conversion is done upon reading.