Automating the Datasmith Export with MAXScript

When you install the Datasmith 3ds Max Exporter plugin, it adds a small Datasmith_Export interface to the MAXScript environment. Use the interface to automate exports of 3ds Max scenes to .udatasmith files, instead of manually exporting scenes. This page describes the methods that the Datasmith_Export interface exposes.

Getting and Setting Export Options

Datasmith_GetExportOption_AnimatedTransforms()

Returns true if Datasmith is set to export the full animation timeline, and false if it's set to export the current frame only.

Datasmith_SetExportOption_AnimatedTransforms <boolean>

Specifies whether Datasmith exports the full animation timeline or the current frame.

• true: Datasmith exports the full animation timeline.

• false: Datasmith exports the current frame only.

Datasmith_GetExportOption_TextureResolution()

Returns the index value of the current resolution limit for baked procedural textures that Datasmith exports. Each value corresponds to the number of pixels in a target resolution, regardless of the specific widths / heights of exported textures.

For more information about limiting baked procedural texture resolution, see Procedural Textures.

Datasmith_SetExportOption_TextureResolution <index>

Specifies the maximum resolution for baked procedural textures that Datasmith exports. Accepts values between 0 and 6. Each value corresponds to the number of pixels in a target resolution, regardless of the specific widths / heights of exported textures.

For more information about limiting baked procedural texture resolution, see Procedural Textures.

Example:

Datasmith_SetExportOption_TextureResolution 4

Sets the maximum baked / procedural texture resolution to one million pixels, or one megapixel.

Logging Messages to the Datasmith Messages Window

Use these commands to log custom messages to the Datasmith Messages window. Each type of message displays in a different color.

Datasmith_LogInfo <msg>

Logs an Info-type message to the Datasmith Messages window. Info messages appear in gray.

Example: Datasmith_LogInfo "this is an Info message"

Datasmith_LogWarning <msg>

Logs a Warning-type message to the Datasmith Messages window. Warning messages appear in yellow.

Example: Datasmith_LogInfo "this is a Warning message"

Datasmith_LogError <msg>

Logs an Error-type message to the Datasmith Messages window. Error messages appear in red.

Example: Datasmith_LogInfo "this is an Error message"

Datasmith_LogCompletion <msg>

Logs a Completion-type message to the Datasmith Messages window. Completion messages appear in green.

Example: Datasmith_LogInfo "this is a Completion message"

Datasmith_LogFlush()

Writes log messages that are queued in memory to the log file. The log file is stored in the %LOCALAPPDATA%\UnrealDatasmithExporter\Saved\Logs directory.

Exporting .udatasmith Files

Datasmith_ExportDialog()

Opens the Datasmith file export dialog, where you can specify the name and path for the exported .udatasmith file.

Datasmith_Export <name> <path> selected:[boolean] quiet:[boolean]

Exports the 3ds Max model or selection as a .udatasmith file, without opening the Datasmith file export dialog.

This method takes the following arguments:

Example:

Datasmith_Export "DatasmithExportName" "D:\DatasmithExports\3dsMax" selected:true quiet:true

The example above automatically exports selected objects as a .udatasmith file with the name DatasmithExportName at the path D:\DatasmithExports\3dsMax, without displaying a progress bar or other export UI.

Direct Link and Direct Link Auto Sync

Datasmith_OpenDirectlinkUi()

Opens the Datasmith Direct Link Connection Status window.

Datasmith_GetDirectlinkCacheDirectory()

Returns the path to the Direct Link Cache Directory. You can also get the path from the Datasmith Direct Link Connection Status window.

Datasmith_GetUnrealEnginePath()
Datasmith_GetUnrealEnginePathFromRegistry()

These methods return the path to the installed Unreal Engine connected via DirectLink. Datasmith_GetUnrealEnginePath() calls Datasmith_GetUnrealEnginePathFromRegistry() and returns the path stored in the registry. If the registry does not contain a path, it returns the default hardcoded path: C:/ProgramData/Epic/Exporter/3dsMaxEngine/.

Datasmith_ToggleAutoSync()

Toggles Direct Link Auto Sync on and off. Use Datasmith_IsAutoSyncEnabled() to check whether Auto Sync is currently enabled .

Datasmith_IsAutoSyncEnabled()

Returns true if Direct Link Auto Sync is currently enabled, false otherwise.

Datasmith_GetExportOption_StatSync()

Returns true if Datasmith is set to output statistics to the Datasmith Messages window when you synchronize the scene using Direct Link or Direct Link Auto Sync, false otherwise.

Datasmith_SetExportOption_StatSync <boolean>

Specifies whether Datasmith outputs statistics to the Datasmith Messages window when you synchronize the scene using Direct Link or Direct Link Auto Sync

• true: Datasmith outputs statistics to the Datasmith Messages window.

• false: Datasmith does not output statistics.

Datasmith_SetAutoSyncDelay <seconds>

Specifies the interval of the timer that checks conditions for Direct Link Auto Sync.

This method takes the following arguments:

Datasmith_SetAutoSyncIdleDelay <seconds>

When Direct Link Auto Sync is enabled, this method specifies the minimum amount of time for which the user has to be idle before Datasmith attempts a Direct Link Auto Sync.

This method takes the following arguments:

Datasmith_UpdateScene quiet:[boolean]

Updates the Datasmith 3ds Max Exporter plugin's scene representation to match current 3ds Max scene.

Returns true if the scene changed since the last update, false otherwise.

This method takes the following arguments:

Datasmith_DirectLinkUpdateScene()

Synchronizes the Datasmith 3ds Max Exporter plugin's scene representation with Unreal Engine via Datasmith Direct Link. Sets up tracking for scene changes.

For more information, see File Export Panel in The Datasmith 3ds Max UI, and Synchronizing 3ds Max and Unreal with Direct Link.

Datasmith_Reset()

Stops tracking scene changes, and resets the Datasmith 3ds Max Exporter plugin's scene representation.