File: TDSLoader.md | Updated: 11/15/2025
A loader for the 3DS format, based on lib3ds.
Loads geometry with uv and materials basic properties with texture support.
const loader = new TDSLoader();
loader.setResourcePath( 'models/3ds/portalgun/textures/' );
const object = await loader.loadAsync( 'models/3ds/portalgun/portalgun.3ds' );
scene.add( object );
TDSLoader is an addon, and must be imported explicitly, see Installation#Addons.
import { TDSLoader } from 'three/addons/loaders/TDSLoader.js';
Constructs a new 3DS loader.
manager | The loading manager.
---|---
Whether debug mode should be enabled or not.
Default is false.
Starts loading from the given URL and passes the loaded 3DS asset to the onLoad() callback.
url | The path/URL of the file to be loaded. This can also be a data URI.
---|---
onLoad | Executed when the loading process has been finished.
onProgress | Executed while the loading is in progress.
onError | Executed when errors occur.
Overrides: Loader#load
Parses the given 3DS data and returns the resulting data.
arraybuffer | The raw 3DS data as an array buffer.
---|---
path | The asset path.
Overrides: Loader#parse
Returns: The parsed asset represented as a group.