Lorsque vous installez le plug-in Exportateur Datasmith 3ds Max, il ajoute une petite interface Datasmith_Export
à l'environnement MAXScript. Utilisez cette interface pour automatiser les exportations de scènes 3ds Max vers des fichiers .udatasmith
, au lieu d'exporter manuellement les scènes. Dans cette page, nous vous décrivons les méthodes exposées par l'interface Datasmith_Export
.
La syntaxe des scripts d'exportation Datasmith 3ds Max a changé dans la version 5.1. Les scripts écrits pour les versions précédentes ne fonctionnent pas dans la version 5.1. Vous pouvez réécrire des scripts existants en utilisant la nouvelle syntaxe décrite sur cette page.
Certaines de ces méthodes correspondent aux commandes de l'onglet Datasmith du ruban 3ds Max (consultez la rubrique Ruban 3ds Max). Lorsque vous appelez une méthode dans MAXScript, l'interface utilisateur de la commande correspondante dans le ruban peut ne pas se mettre à jour immédiatement. Pour actualiser l'interface utilisateur, accédez à un autre onglet du ruban 3dsMax, puis revenez à l'onglet Datasmith.
Obtenir et définir des options d'exportation
Datasmith_GetExportOption_AnimatedTransforms()
Renvoie true
si Datasmith est configuré pour exporter la chronologie complète de l'animation et false
s'il est configuré pour exporter uniquement l'image actuelle.
Datasmith_SetExportOption_AnimatedTransforms
Spécifie si Datasmith exporte la chronologie complète de l'animation ou l'image actuelle.
true
: Datasmith exporte la chronologie complète de l'animation.false
: Datasmith exporte uniquement l'image actuelle.
Datasmith_GetExportOption_TextureResolution()
Renvoie la valeur d'index de la limite de résolution actuelle pour les textures procédurales précalculées que Datasmith exporte. Chaque valeur correspond au nombre de pixels dans une résolution cible, quelles que soient les largeurs/hauteurs spécifiques des textures exportées.
Valeur | Résolution |
---|---|
0 | 4 096 pixels |
1 | 16 384 pixels |
2 | 65 536 pixels |
3 | 0,25 mégapixel |
4 | 1 mégapixel |
5 | 4 mégapixels |
6 | 16 mégapixels |
Pour en savoir plus sur la limitation de la résolution des textures procédurales précalculées, consultez la page Textures procédurales.
Datasmith_SetExportOption_TextureResolution
Spécifie la résolution maximale pour les textures procédurales précalculées que Datasmith exporte. Les valeurs prises en charge sont comprises entre 0 et 6. Chaque valeur correspond au nombre de pixels dans une résolution cible, quelles que soient les largeurs/hauteurs spécifiques des textures exportées.
Valeur | Résolution |
---|---|
0 | 4 096 pixels |
1 | 16 384 pixels |
2 | 65 536 pixels |
3 | 0,25 mégapixel |
4 | 1 mégapixel |
5 | 4 mégapixels |
6 | 16 mégapixels |
Pour en savoir plus sur la limitation de la résolution des textures procédurales précalculées, consultez la page Textures procédurales.
Exemple :
Datasmith_SetExportOption_TextureResolution 4
Définit la résolution maximale de texture précalculée/procédurale à un million de pixels, soit un mégapixel.
Enregistrement des messages dans la fenêtre Messages de Datasmith
Utilisez ces commandes pour enregistrer des messages personnalisés dans la fenêtre Messages de Datasmith. Chaque type de message s'affiche dans une couleur différente.
Type de message | Couleur |
---|---|
Infos | Gris |
Avertissement | Jaune |
Erreur | Rouge |
Achèvement | Vert |

Datasmith_LogInfo
Enregistre un message de type Infos dans la fenêtre Messages de Datasmith. Les messages d'information apparaissent en gris.
Paramètre | Type | Description |
---|---|---|
<msg> |
chaîne | Message à afficher dans la fenêtre Messages de Datasmith. |
Exemple : Datasmith_LogInfo "this is an Info message"
Datasmith_LogWarning
Enregistre un message de type Avertissement dans la fenêtre Messages de Datasmith. Les messages d'avertissement apparaissent en jaune.
Paramètre | Type | Description |
---|---|---|
<msg> |
chaîne | Message à afficher dans la fenêtre Messages de Datasmith. |
Exemple : Datasmith_LogInfo "this is a Warning message"
Datasmith_LogError
Enregistre un message de type Erreur dans la fenêtre Messages de Datasmith. Les messages d'erreur apparaissent en rouge.
Paramètre | Type | Description |
---|---|---|
<msg> |
chaîne | Message à afficher dans la fenêtre Messages de Datasmith. |
Exemple : Datasmith_LogInfo "this is an Error message"
Datasmith_LogCompletion
Enregistre un message de type Achèvement dans la fenêtre Messages de Datasmith. Les messages d'achèvement apparaissent en vert.
Paramètre | Type | Description |
---|---|---|
<msg> |
chaîne | Message à afficher dans la fenêtre Messages de Datasmith. |
Exemple : Datasmith_LogInfo "this is a Completion message"
Datasmith_LogFlush()
Écrit les messages mis en file d'attente en mémoire dans le fichier journal. Le fichier journal est stocké dans le répertoire %LOCALAPPDATA%\UnrealDatasmithExporter\Saved\Logs
.
Exporter des fichiers .udatasmith
Datasmith_ExportDialog()
Ouvre la boîte de dialogue d'exportation de fichiers Datasmith, dans laquelle vous pouvez spécifier le nom et le chemin du fichier .udatasmith
exporté.
Datasmith_Export selected:[boolean] quiet:[boolean]
Exporte le modèle ou la sélection 3ds Max sous forme de fichier .udatasmith
, sans ouvrir la boîte de dialogue d'exportation de fichiers Datasmith.
Cette méthode prend les arguments suivants :
Paramètre | Type | Description | Facultatif ? |
---|---|---|---|
name |
chaîne | Nom du fichier à exporter, sans l'extension de fichier. | n |
path |
chaîne | Chemin d'accès complet vers le répertoire vers lequel exporter le fichier. | n |
selected: |
booléen | Spécifie si Datasmith exporte la scène complète ou uniquement les objets actuellement sélectionnés.
|
o |
quiet: |
booléen |
|
o |
Exemple :
Datasmith_Export "DatasmithExportName" "D:\DatasmithExports\3dsMax" selected:true quiet:true
L'exemple ci-dessus exporte automatiquement les objets sélectionnés sous forme de fichier .udatasmith
avec le nom DatasmithExportName à l'emplacement D:\DatasmithExports\3dsMax
, sans afficher de barre de progression ou d'autre interface utilisateur d'exportation.
Direct Link et synchronisation automatique Direct Link
Datasmith_OpenDirectlinkUi()
Ouvre la fenêtre État de la connexion Datasmith Direct Link.
Datasmith_GetDirectlinkCacheDirectory()
Renvoie le chemin d'accès au répertoire du cache Direct Link. Vous pouvez également obtenir le chemin à partir de la fenêtre État de la connexion Datasmith Direct Link.
Datasmith_GetUnrealEnginePath()
Datasmith_GetUnrealEnginePathFromRegistry()
Ces méthodes renvoient le chemin d'accès vers l'Unreal Engine installé et connecté via DirectLink. Datasmith_GetUnrealEnginePath()
appelle Datasmith_GetUnrealEnginePathFromRegistry()
et renvoie le chemin d'accès stocké dans le registre. Si le registre ne contient pas de chemin, il renvoie le chemin d'accès codé en dur par défaut : C:/ProgramData/Epic/Exporter/3dsMaxEngine/
.
Datasmith_ToggleAutoSync()
Active et désactive la synchronisation automatique Direct Link. Utilisez Datasmith_IsAutoSyncEnabled()
pour vérifier si la synchronisation automatique est actuellement activée.
Datasmith_IsAutoSyncEnabled()
Renvoie true
si la synchronisation automatique Direct Link est actuellement activée, false
dans le cas contraire.
Datasmith_GetExportOption_StatSync()
Renvoie true
si Datasmith est configuré pour générer des statistiques dans la fenêtre Messages de Datasmith lorsque vous synchronisez la scène à l'aide de Direct Link ou la synchronisation automatique Direct Link, false
dans le cas contraire.
Datasmith_SetExportOption_StatSync
Spécifie si Datasmith génère des statistiques dans la fenêtre Messages de Datasmith lorsque vous synchronisez la scène à l'aide de Direct Link ou de la synchronisation automatique Direct Link.
true
: Datasmith génère des statistiques dans la fenêtre Messages de Datasmith.false
: Datasmith ne génère pas de statistiques.
Datasmith_SetAutoSyncDelay
Spécifie l'intervalle du chronomètre qui vérifie les conditions de synchronisation automatique Direct Link.
Cette méthode prend les arguments suivants :
Paramètre | Type | Description |
---|---|---|
<seconds> |
float | Durée de l'intervalle entre les vérifications de condition de synchronisation automatique, en secondes. |
Datasmith_SetAutoSyncIdleDelay
Lorsque la synchronisation automatique Direct Link est activée, cette méthode spécifie la durée minimale pendant laquelle l'utilisateur doit être inactif avant que Datasmith ne tente une synchronisation automatique Direct Link.
Cette méthode prend les arguments suivants :
Paramètre | Type | Description |
---|---|---|
<seconds> |
float | Nombre de secondes pendant lesquelles l'utilisateur doit être inactif avant que Datasmith ne tente une synchronisation automatique Direct Link. |
Datasmith_UpdateScene quiet:[boolean]
Met à jour la représentation de la scène du plug-in Exportateur Datasmith 3ds Max pour qu'elle corresponde à la scène 3ds Max actuelle.
Renvoie true
si la scène a changé depuis la dernière mise à jour, false
dans le cas contraire.
Lorsque vous utilisez la commande Synchroniser de l'onglet Datasmith du ruban 3ds Max, Datasmith appelle d'abord cette commande, puis, s'il détecte des modifications, appelle Datasmith_DirectLinkUpdateScene()
.
Cette méthode prend les arguments suivants :
Paramètre | Type | Description | Facultatif ? |
---|---|---|---|
quiet: |
booléen |
|
o |
Datasmith_DirectLinkUpdateScene()
Synchronise la représentation de scène du plug-in Exportateur Datasmith 3ds Max avec l'Unreal Engine via Datasmith Direct Link. Configure le suivi des modifications de scène.
Lorsque vous utilisez la commande Synchroniser de l'onglet Datasmith du ruban 3ds Max, Datasmith appelle d'abord Datasmith_UpdateScene(). S'il détecte des modifications, il appelle alors cette méthode.
Pour en savoir plus, consultez le panneau Exporter un fichier dans l'interface utilisateur de Datasmith 3ds Max et la page Synchroniser 3ds Max et l'Unreal avec Direct Link.
Datasmith_Reset()
Arrête le suivi des modifications de scène et réinitialise la représentation de scène du plug-in Exportateur Datasmith 3ds Max.