Wenn Sie das Datasmith 3ds Max Exporter-Plugin installieren, fügt es ein kleines Datasmith_Export
-Interface zur MAXScript-Umgebung hinzu. Verwenden Sie das Interface, um Exporte von 3ds-Max-Szenen in .udatasmith
-Dateien zu automatisieren, anstatt Szenen manuell zu exportieren. Diese Seite beschreibt die Methoden, die das Datasmith_Export
-Interface bereitstellt.
Die Syntax für Datasmith-3ds-Max-Export-Skripte hat sich in Version 5.1 geändert. Skripte, die für frühere Versionen geschrieben wurden, funktionieren in Version 5.1 nicht. Sie können vorhandene Skripte mit der neuen Syntax neu schreiben, die auf dieser Seite beschrieben wird.
Einige dieser Methoden entsprechen Befehlen auf dem Datasmith-Tag des 3ds-Max-Menübandes (siehe Das 3ds-Max-Menüband). Wenn Sie eine Methode in MAXScript aufrufen, wird die Benutzeroberfläche für den entsprechenden Befehl im Menüband möglicherweise nicht sofort aktualisiert. Um die Benutzeroberfläche zu aktualisieren, wechseln Sie zu einem anderen Tab im 3dsMax-Menüband und kehren Sie dann zum Datasmith-Tab zurück.
Exportoptionen abrufen und festlegen
Datasmith_GetExportOption_AnimatedTransforms()
Gibt true
zurück, wenn Datasmith so eingestellt ist, dass die gesamte Animationszeitleiste exportiert wird, und false
, wenn nur der aktuelle Frame exportiert wird.
Datasmith_SetExportOption_AnimatedTransforms
Legt fest, ob Datasmith die gesamte Animationszeitleiste oder den aktuellen Frame exportiert.
true
: Datasmith exportiert die gesamte Animationszeitleiste.false
: Datasmith exportiert nur den aktuellen Frame.
Datasmith_GetExportOption_TextureResolution()
Gibt den Indexwert des aktuellen Auflösungslimits für gebakte prozedurale Texturen zurück, die Datasmith exportiert. Jeder Wert entspricht der Anzahl der Pixel in einer Zielauflösung, unabhängig von den spezifischen Breiten/Höhen der exportierten Texturen.
Wert | Auflösung |
---|---|
0 | 4096 Pixel |
1 | 16.384 Pixel |
2 | 65.536 Pixel |
3 | 0,25 Megapixel |
4 | 1 Megapixel |
5 | 4 Megapixel |
6 | 16 Megapixel |
Weitere Informationen zur Begrenzung der Auflösung gebakter prozeduraler Texturen finden Sie unter Prozedurale Texturen.
Datasmith_SetExportOption_TextureResolution
Legt die maximale Auflösung für gebakte prozedurale Texturen fest, die Datasmith exportiert. Akzeptiert Werte zwischen 0 und 6. Jeder Wert entspricht der Anzahl der Pixel in einer Zielauflösung, unabhängig von den spezifischen Breiten/Höhen der exportierten Texturen.
Wert | Auflösung |
---|---|
0 | 4096 Pixel |
1 | 16.384 Pixel |
2 | 65.536 Pixel |
3 | 0,25 Megapixel |
4 | 1 Megapixel |
5 | 4 Megapixel |
6 | 16 Megapixel |
Weitere Informationen zur Begrenzung der Auflösung gebakter prozeduraler Texturen finden Sie unter Prozedurale Texturen.
Beispiel:
Datasmith_SetExportOption_TextureResolution 4
Setzt die maximale Auflösung gebakter/prozeduraler Texturen auf eine Million Pixel oder ein Megapixel.
Protokollierung von Nachrichten im Fenster Datasmith Messages
Verwenden Sie diese Befehle, um benutzerdefinierte Nachrichten im Fenster Datasmith Messages zu protokollieren. Jeder Nachrichtentyp wird in einer anderen Farbe angezeigt.
Nachrichtentyp | Farbe |
---|---|
Info | Grau |
Warnung | Gelb |
Fehler | Rot |
Beendigung | Grün |

Datasmith_LogInfo
Protokolliert eine Info-Nachricht im Fenster Datasmith Messages. Info-Nachrichten erscheinen in Grau.
Parameter | Typ | Beschreibung |
---|---|---|
<msg> |
string | Die Nachricht, die im Fenster Datasmith Messages ausgegeben werden soll |
Beispiel: Datasmith_LogInfo "Dies ist eine Info-Nachricht"
Datasmith_LogWarning
Protokolliert eine Warnmeldung im Fenster Datasmith Messages. Warnmeldungen erscheinen in Gelb.
Parameter | Typ | Beschreibung |
---|---|---|
<msg> |
string | Die Nachricht, die im Fenster Datasmith Messages ausgegeben werden soll |
Beispiel: Datasmith_LogInfo "Dies ist eine Warnmeldung"
Datasmith_LogError
Protokolliert eine Fehlermeldung im Fenster Datasmith Messages. Fehlermeldungen erscheinen in Rot.
Parameter | Typ | Beschreibung |
---|---|---|
<msg> |
string | Die Nachricht, die im Fenster Datasmith Messages ausgegeben werden soll |
Beispiel: Datasmith_LogInfo "Dies ist eine Fehlermeldung"
Datasmith_LogCompletion
Protokolliert eine Beendigungsmeldung im Fenster Datasmith Messages. Beendigungmeldungen erscheinen in Grün.
Parameter | Typ | Beschreibung |
---|---|---|
<msg> |
string | Die Nachricht, die im Fenster Datasmith Messages ausgegeben werden soll |
Beispiel: Datasmith_LogInfo "Dies ist eine Beendigungsmeldung"
Datasmith_LogFlush()
Schreibt Protokollnachrichten, die im Speicher zwischengespeichert sind, in die Protokolldatei. Die Protokolldatei wird im Verzeichnis %LOCALAPPDATA%\UnrealDatasmithExporter\Saved\Logs
gespeichert.
Exportieren von .udatasmith- Dateien
Datasmith_ExportDialog()
Öffnet den Datasmith-Dateiexportdialog, in dem Sie den Namen und Pfad für die exportierte .udatasmith
-Datei angeben können.
Datasmith_Export selected:[boolean] quiet:[boolean]
Exportiert das 3ds-Max-Modell oder die Auswahl als .udatasmith
-Datei, ohne den Datasmith-Dateiexportdialog zu öffnen.
Diese Methode übernimmt die folgenden Argumente:
Parameter | Typ | Beschreibung | Optional? | ||
---|---|---|---|---|---|
name |
string | Der Name der zu exportierenden Datei, ohne Dateierweiterung. | n | n | |
path |
string | Der vollständige Pfad zu dem Verzeichnis, in das die Datei exportiert werden soll. | n | ||
selected: |
boolean | Legt fest, ob Datasmith die gesamte Szene oder nur die aktuell ausgewählten Objekte exportiert.
|
y | ||
quiet: |
boolean |
|
y |
Beispiel:
Datasmith_Export "DatasmithExportName" "D:\DatasmithExports\3dsMax" selected:true quiet:true
Das obige Beispiel exportiert ausgewählte Objekte automatisch als Datei .udatasmith
mit dem Namen DatasmithExportName im Pfad D:\DatasmithExports\3dsMax
, ohne dass ein Fortschrittsbalken oder ein anderes Export-UI angezeigt wird.
Direct Link und Direct Link Auto Sync
Datasmith_OpenDirectlinkUi()
Öffnet das Fenster Datasmith Direct Link Connection Status.
Datasmith_GetDirectlinkCacheDirectory()
Gibt den Pfad zum Direct-Link-Cache-Verzeichnis zurück. Sie können den Pfad auch aus dem Fenster Datasmith Direct Link Connection Status abrufen.
Datasmith_GetUnrealEnginePath()
Datasmith_GetUnrealEnginePathFromRegistry()
Diese Methoden geben den Pfad zur installierten Unreal Engine zurück, die über DirectLink verbunden ist. Datasmith_GetUnrealEnginePath()
ruft Datasmith_GetUnrealEnginePathFromRegistry()
auf und gibt den im Register gespeicherten Pfad zurück. Wenn die Registry keinen Pfad enthält, wird der standardmäßig fest codierte Pfad zurückgegeben: C:/ProgramData/Epic/Exporter/3dsMaxEngine/
.
Datasmith_ToggleAutoSync()
Schaltet Direct Link Auto Sync ein und aus. Verwenden Sie Datasmith_IsAutoSyncEnabled()
, um zu überprüfen, ob Auto Sync derzeit aktiviert ist.
Datasmith_IsAutoSyncEnabled()
Gibt true
zurück, wenn Direct Link Auto Sync derzeit aktiviert ist, andernfalls false
.
Datasmith_GetExportOption_StatSync()
Gibt true
zurück, wenn Datasmith so eingestellt ist, dass Statistiken im Fenster Datasmith Messages ausgegeben werden, wenn Sie die Szene mit Direct Link oder Direct Link Auto Sync synchronisieren, andernfalls false
.
Datasmith_SetExportOption_StatSync
Legt fest, ob Datasmith Statistiken im Fenster Datasmith Messages ausgibt, wenn Sie die Szene mit Direct Link oder Direct Link Auto Sync synchronisieren.
true
: Datasmith gibt Statistiken im Fenster Datasmith Messages aus.false
: Datasmith gibt keine Statistiken aus.
Datasmith_SetAutoSyncDelay
Legt das Intervall des Timers fest, der die Bedingungen für Direct Link Auto Sync überprüft.
Diese Methode übernimmt die folgenden Argumente:
Parameter | Typ | Beschreibung |
---|---|---|
<seconds> |
float | Die Dauer des Intervalls zwischen den Überprüfungen der Auto-Sync-Bedingung, in Sekunden. |
Datasmith_SetAutoSyncIdleDelay
Wenn Direct Link Auto Sync aktiviert ist, gibt diese Methode die minimale Zeitspanne an, die der Nutzer inaktiv sein muss, bevor Datasmith versucht, Direct Link Auto Sync durchzuführen.
Diese Methode übernimmt die folgenden Argumente:
Parameter | Typ | Beschreibung |
---|---|---|
<seconds> |
float | Die Anzahl der Sekunden, die der Nutzer inaktiv sein muss, bevor Datasmith versucht, Direct Link Auto Sync durchzuführen. |
Datasmith_UpdateScene quiet:[boolean]
Aktualisiert die Szenenrepräsentation des Datasmith-3ds-Max-Exporter-Plugins, um die aktuelle 3ds-Max-Szene widerzuspiegeln.
Gibt true
zurück, wenn sich die Szene seit dem letzten Update geändert hat, andernfalls false
.
Wenn Sie den Synchronisierungsbefehl aus dem Datasmith-Tab des 3ds-Max-Menübands verwenden, ruft Datasmith zuerst diesen Befehl auf und dann, wenn Änderungen erkannt werden, Datasmith_DirectLinkUpdateScene()
.
Diese Methode übernimmt die folgenden Argumente:
Parameter | Typ | Beschreibung | Optional? |
---|---|---|---|
quiet: |
boolean |
|
y |
Datasmith_DirectLinkUpdateScene()
Synchronisiert die Szenenrepräsentation des Datasmith-3ds-Max-Exporter-Plugins mit der Unreal Engine über Datasmith Direct Link. Richtet die Verfolgung von Szenenänderungen ein.
Wenn Sie den Synchronisierungsbefehl aus der Datasmith-Tab des 3ds-Max-Menübands verwenden, ruft Datasmith zuerst Datasmith_UpdateScene() auf. Wenn Änderungen erkannt werden, wird anschließend diese Methode aufgerufen.
Weitere Informationen finden Sie unter Dateiexport-Panel in Die Datasmith-3ds-Max-UI und Synchronisierung von 3ds Max und Unreal mit Direct Link.
Datasmith_Reset()
Beendet die Verfolgung von Szenenänderungen und setzt die Szenenrepräsentation des Datasmith-3ds-Max-Exporter-Plugins zurück.