Como automatizar a exportação do Datasmith com MAXScript

Quando você instala o plugin Datasmith 3ds Max Exporter , ele adiciona uma pequena interface "Datasmith_Export" ao ambiente MAXScript. Use a interface para automatizar as exportações de cenas do 3ds Max para arquivos ".udatasmith", em vez de exportá-las manualmente. Esta página descreve os métodos expostos pela interface "Datasmith_Export".

A sintaxe dos códigos de exportação do Datasmith 3ds Max foi alterada na versão 5.1. Scripts escritos para versões anteriores não funcionarão na versão 5.1. Você pode reescrever scripts existentes usando a nova sintaxe descrita nesta página.

Alguns desses métodos correspondem a comandos na aba Datasmith, na faixa de opções do 3ds Max (consulte a [Faixa de opções do 3ds Max])(working-with-content/datasmith/software-interop-guides/3ds-max/3ds-max-ui#The3dsMaxRibbon)). Quando você chama um método no MAXScript, a interface de usuário do comando correspondente na faixa de opções pode não ser atualizada imediatamente. Para atualizar a interface do usuário, vá para outra aba na faixa de opções do 3dsMax e volte para a aba Datasmith.

Como obter e definir opções de exportação

Datasmith_GetExportOption_AnimatedTransforms()

Retorna "verdadeiro" se o Datasmith estiver configurado para exportar a linha do tempo completa da animação, retorna "falso" se estiver configurado para exportar apenas o quadro atual.

Datasmith_SetExportOption_AnimatedTransforms

Especifica se o Datasmith exporta a linha do tempo completa da animação ou o quadro atual.

• "true": o Datasmith exporta a linha do tempo completa da animação.
• "false": o Datasmith exporta apenas o quadro atual.

Datasmith_GetExportOption_TextureResolution()

Retorna o valor do índice do limite de resolução atual para texturas procedurais incorporadas que o Datasmith exporta. Cada valor corresponde ao número de pixels em uma resolução de destino, independentemente das larguras/alturas específicas das texturas exportadas.

Para obter mais informações sobre como limitar a resolução de texturas procedurais incorporadas, consulte Texturas procedurais.

Datasmith_SetExportOption_TextureResolution

Especifica a resolução máxima para texturas procedurais incorporadas que o Datasmith exporta. Aceita valores entre 0 e 6. Cada valor corresponde ao número de pixels em uma resolução de destino, independentemente das larguras/alturas específicas das texturas exportadas.

Para obter mais informações sobre como limitar a resolução de texturas procedurais incorporadas, consulte Texturas procedurais.

Exemplo:

"Datasmith_SetExportOption_TextureResolution 4"

Define a resolução máxima da textura procedural/integrada para um milhão de pixels, ou um megapixel.

Como registrar mensagens na janela Datasmith Messages

Use estes comandos para registrar mensagens personalizadas na janela Datasmith Messages. Cada tipo de mensagem é exibido em uma cor diferente.

Datasmith_LogInfo

Registra uma mensagem informativa na janela Datasmith Messages. As mensagens informativas aparecem em cinza.

Exemplo: "Datasmith_LogInfo 'esta é uma mensagem informativa'"

Datasmith_LogWarning

Registra uma mensagem de aviso na janela Datasmith Messages. As mensagens de aviso são exibidas em amarelo.

Exemplo: "Datasmith_LogInfo 'esta é uma mensagem de aviso'"

Datasmith_LogError

Registra uma mensagem de erro na janela Datasmith Messages. As mensagens de erro aparecem em vermelho.

Exemplo: "Datasmith_LogInfo 'esta é uma mensagem de erro'"

Datasmith_LogCompletion

Registra uma mensagem de conclusão na janela Datasmith Messages. As mensagens de conclusão aparecem em verde.

Exemplo: "Datasmith_LogInfo 'esta é uma mensagem de conclusão'"

Datasmith_LogFlush()

Grava as mensagens de log enfileiradas na memória no arquivo de logs. O arquivo de log é armazenado no diretório "%LOCALAPPDATA%\UnrealDatasmithExporter\Saved\Logs".

Como exportar .udatasmith Arquivos

Datasmith_ExportDialog()

Abre a caixa de diálogo de exportação de arquivo do Datasmith, na qual você pode especificar o nome e o caminho do arquivo ".udatasmith" exportado.

Datasmith_Export selected:[boolean] quiet:[boolean]

Exporta o modelo ou a seleção do 3ds Max como um arquivo ".udatasmith" sem abrir a caixa de diálogo de exportação de arquivo do Datasmith.

Esse método usa os seguintes argumentos:

Exemplo:

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

O exemplo acima exporta automaticamente os objetos selecionados como um arquivo ".udatasmith" com o nome DatasmithExportName no caminho "D:\DatasmithExports\3dsMax", sem exibir uma barra de progresso ou outra interface de exportação.

Direct Link e Direct Link Auto Sync

Datasmith_OpenDirectlinkUi()

Abre a janela Datasmith Direct Link Connection Status.

Datasmith_GetDirectlinkCacheDirectory()

Retorna o caminho para o diretório do cache do Direct Link. Você também pode obter o caminho na janela Datasmith Direct Link Connection Status.

Datasmith_GetUnrealEnginePath()
Datasmith_GetUnrealEnginePathFromRegistry()

Esses métodos retornam o caminho para a Unreal Engine instalada e conectada via Direct Link. "Datasmith_GetUnrealEnginePath()" chama "Datasmith_GetUnrealEnginePathFromRegistry()" e retorna o caminho armazenado no registro. Se o registro não tiver um caminho, ele retornará o caminho padrão codificado: "C:/ProgramData/Epic/Exporter/3dsMaxEngine/".

Datasmith_ToggleAutoSync()

Ativa e desativa o Direct Link Auto Sync. Use "Datasmith_IsAutoSyncEnabled()" para verificar se a sincronização automática está habilitada.

Datasmith_IsAutoSyncEnabled()

Retorna verdadeiro se o Direct Link Auto Sync estiver habilitado. Caso contrário, retorna falso.

Datasmith_GetExportOption_StatSync()

Retorna "verdadeiro" se o Datasmith estiver configurado para gerar estatísticas na janela Datasmith Messages quando a cena for sincronizada usando o Direct Link ou o Direct Link Auto Sync. Caso contrário, retorna "falso".

Datasmith_SetExportOption_StatSync

Especifica se o Datasmith gera estatísticas na janela Datasmith Messages quando a cena for sincronizada usando o Direct Link ou o Direct Link Auto Sync.

• "true": o Datasmith gera estatísticas na janela Datasmith Messages.
• "false": o Datasmith não gera estatísticas.

Datasmith_SetAutoSyncDelay

Especifica o intervalo do temporizador que verifica as condições do Direct Link Auto Sync.

Esse método usa os seguintes argumentos:

Datasmith_SetAutoSyncIdleDelay

Quando o Direct Link Auto Sync está habilitado, este método especifica o tempo mínimo de ociosidade do usuário antes que o Datasmith tente usar o Direct Link Auto Sync.

Esse método usa os seguintes argumentos:

Datasmith_UpdateScene quiet:[boolean]

Atualiza a representação de cena do plugin Datasmith 3ds Max Exporter para corresponder à cena 3ds Max atual.

Retorna "verdadeiro" se a cena mudou desde a última atualização. Caso contrário, retornará "falso".

Quando você usa o comando Synchronize na aba Datasmith, na faixa de opções do 3ds Max, primeiro o Datasmith chama esse comando e, se detectar alguma alteração, chama "Datasmith_DirectLinkUpdateScene()".

Esse método usa os seguintes argumentos:

Datasmith_DirectLinkUpdateScene()

Sincroniza a representação de cena do plugin Datasmith 3ds Max Exporter com a Unreal Engine por meio do Datasmith Direct Link. Define o rastreamento para mudanças de cena.

Quando você usa o comando Synchronize na aba Datasmith, na faixa de opções do 3ds Max, primeiro o Datasmith chama Datasmith_UpdateScene(). Se detectar alterações, ele chama este método.

Para obter mais informações, consulte o painel de exportação de arquivo em interface de usuário do Datasmith 3ds Max e Como sincronizar o 3ds Max e a Unreal com Direct Link.

Datasmith_Reset()

Interrompe o rastreamento de alterações de cena e restaura a representação de cena do plugin Datasmith 3ds Max Exporter.