AnimAero

Conversor de modelos SOLIDWORKS para projetos editáveis no Blender, com interface para Windows, execução por comando e processamento em lote. Inclui um perfil de animação manual para a montagem da nave-mãe e do planador da Céu Azul.

Começar

1. Abra Iniciar.cmd. Na primeira execução, ele compila AnimAero.exe automaticamente.
2. Escolha a montagem .SLDASM ou peça .SLDPRT e o arquivo .blend de destino.
3. Escolha a organização e clique em Converter para Blender.
4. Aguarde Concluído e clique em Abrir .blend.

Nas próximas execuções, também é possível abrir AnimAero.exe diretamente.

Mantenha o executável junto das pastas src, profiles, assets, do arquivo settings.json e da logo original aguia-+-nome-azul-sem-fundo.png. O executável é gerado localmente e não é versionado. Novos arquivos são sugeridos na pasta convertidos; um destino existente só é substituído quando essa opção é marcada.

Não é necessário instalar complementos no Blender. A aplicação utiliza o Python distribuído com o próprio Blender.

Requisitos

• Windows e Windows PowerShell 5.1 (powershell.exe).
• SOLIDWORKS instalado e funcionando, com API COM e interop .NET. A instalação deve conseguir abrir a versão dos arquivos de origem.
• Blender 4.5; a versão usada na validação foi a 4.5.4 LTS.
• Peças e texturas referenciadas disponíveis no computador. A busca considera a pasta da origem, suas subpastas e as pastas adicionais informadas.

O caminho do Blender pode ser escolhido na janela. Em settings.json, blender_path e interop_dll permitem indicar instalações específicas; default_source e default_profile definem os valores iniciais da interface.

Organização no Blender

Opção	Resultado
Genérico, por corpo	Um objeto de malha por corpo, com componentes e submontagens em hierarquia.
Genérico, por componente	Agrupa os corpos de cada peça e mantém corpos ocultos separados dos visíveis.
Nave-mãe + planador	Controles manuais e articulações para a montagem compatível com o perfil da aeronave.

O resultado é uma malha triangulada editável, com hierarquia e identificação da origem. Histórico paramétrico, sketches, mates, estudos de movimento e definições de shaders proprietários não são convertidos. Articulações automáticas estão disponíveis no perfil específico da aeronave.

Perfil da nave-mãe e do planador

O perfil cria 10 controles para voo conjunto, nave-mãe, planador, ailerons, profundores, lemes e hélice. Os ailerons são diferenciais; a cauda em V mistura profundor e leme. As articulações usam os pinos do CAD na nave-mãe e a borda de encaixe no planador, com limites de movimento. A linha do tempo fica livre para animações manuais.

No Blender, abra COMECE AQUI • Animação manual no Editor de Texto. A coleção 01 CONTROLES reúne os objetos destinados à animação. A coleção 99 ORIGINAL CAD, excluída por padrão, guarda as peças individuais para edição detalhada.

Esse perfil exige os nomes e a geometria definidos em profiles/nave_mae_planador.json. Se uma articulação não for reconhecida, a conversão informa a falha. Para outras montagens, use o modo genérico ou adapte o perfil à geometria correspondente.

Materiais e escala

A conversão lê cores e aparências de componentes, modelos, corpos, faces e features. Traduz o acabamento para o Principled BSDF, empacota as imagens encontradas e preserva a visibilidade dos corpos e componentes. Imagens ausentes são identificadas no relatório.

O carbono usa coordenadas em metros, independentes do tamanho da peça. O padrão de 25 mm corresponde ao tamanho da imagem completa repetida; a trama interna fica em escala milimétrica. Esse valor pode ser ajustado na janela ou no Shader Editor. Acabamentos proprietários do SOLIDWORKS são aproximados no Blender e podem precisar de ajustes.

Converter por comando

Na pasta do projeto, execute:

powershell.exe -NoProfile -ExecutionPolicy Bypass -STA -File .\Converter.ps1 `
  -Source "D:\Projetos CAD\Montagem.SLDASM" `
  -Output "D:\Modelos Blender\Montagem.blend"

Parâmetros mais usados:

Parâmetro	Uso
-Grouping components	Agrupa por peça; o padrão é bodies, por corpo.
-Profile nave_mae_planador	Aplica o perfil específico da aeronave; o padrão é generic.
-IncludeSuppressed	Inclui componentes originalmente suprimidos.
-Blender "D:\Aplicativos\Blender\blender.exe"	Indica outra instalação do Blender.
-CarbonTileMm 25	Define a dimensão da imagem repetida do carbono, em milímetros.
-SearchFolders "D:\Pecas", "D:\Biblioteca"	Acrescenta pastas para resolver referências ao chamar o script no PowerShell.
-NoCache	Força nova leitura da geometria CAD.
-Overwrite	Permite substituir o arquivo de destino.

Para a montagem compatível com o perfil da aeronave:

powershell.exe -NoProfile -ExecutionPolicy Bypass -STA -File .\Converter.ps1 `
  -Source "D:\Projetos CAD\Modelo 1.SLDASM" `
  -Output "D:\Modelos Blender\Modelo 1 - controles.blend" `
  -Profile nave_mae_planador -IncludeSuppressed

A conversão usa a configuração ativa do documento. Código de saída 0 indica sucesso, 1 indica falha e 130 indica cancelamento de uma conversão individual.

Conversão em lote

Para converter todas as montagens de uma pasta, preservando a estrutura das subpastas:

powershell.exe -NoProfile -ExecutionPolicy Bypass -File .\Converter-Lote.ps1 `
  -PastaOrigem "D:\Projetos CAD" -PastaDestino "D:\Modelos Blender" -Recursivo

O lote usa o modo genérico, com agrupamento por componente, e processa os arquivos sequencialmente. Acrescente -IncluirPecas para incluir .SLDPRT, -IncluirSuprimidos ou -Substituir quando necessário. Use -Agrupamento bodies para organizar por corpo. Os nomes de saída terminam em .SLDASM.blend ou .SLDPRT.blend para evitar colisões entre peças e montagens com o mesmo nome.

-ExecutionPolicy Bypass vale somente para os processos desses comandos, sem alterar a política permanente do computador.

Arquivos, cache e cancelamento

Cada .blend recebe um arquivo .relatorio.json ao lado, com contagens, referências, avisos, materiais e resultados de validação. Ver registros abre a pasta da execução com os registros completos do exportador e do Blender. Antes de publicar o destino final, o programa reabre o arquivo temporário salvo para verificar sua geometria.

A opção Reutilizar exportação quando possível guarda a geometria intermediária. O cache só é reutilizado quando origem e referências mantêm tamanho e data de modificação, e o SOLIDWORKS está fechado. Se ele estiver aberto, o programa relê a montagem e não armazena em cache possíveis edições em memória. Alterar agrupamento ou escala do carbono pode reaproveitar a geometria CAD, mas sempre reconstrói o .blend.

Os dados locais ficam em %LOCALAPPDATA%\AnimAero. A pasta cache pode ser removida com o conversor fechado; jobs guarda os registros das execuções. Modelos convertidos, registros e executáveis gerados ficam fora do versionamento.

Cancelar solicita encerramento seguro. Aguarde a chamada atual do SOLIDWORKS ou Blender terminar. A janela pode ser fechada quando a conversão termina.

Comportamento com o SOLIDWORKS

• Documentos novos são abertos em modo silencioso e somente leitura. O exportador não salva arquivos originais.
• Estados de supressão e pastas de pesquisa são restaurados ao terminar, inclusive após erro ou cancelamento.
• Se a origem já estiver aberta, a conversão usa a configuração e as edições em memória. Resolver componentes pode marcar o documento como modificado; o programa não o salva nem descarta as edições.
• Exportações CAD são serializadas entre instâncias do conversor para preservar o estado global do SOLIDWORKS.
• Uma instância iniciada pelo conversor é encerrada ao terminar quando não resta nenhum documento aberto. Instâncias já em uso são preservadas.

Desenvolvimento

Arquivo ou pasta	Responsabilidade
Build.ps1	Compila AnimAero.exe.
src/DesktopLauncher.cs, src/Gui.ps1 e src/Branding.cs	Inicialização, interface Windows e apresentação da logo.
Converter.ps1	Validação dos parâmetros, cache e execução das etapas.
Converter-Lote.ps1	Conversão sequencial de pastas.
src/ExportSolidWorks.cs e src/ExportSolidWorks.ps1	Exportação por meio da API do SOLIDWORKS.
src/import_blender.py	Geometria, hierarquia, materiais e gravação do projeto Blender.
src/rig_profile.py e profiles	Articulações e perfil da aeronave.
assets	Identidade visual da Céu Azul.
tests	Testes de importação, articulações e orquestração.

Para compilar manualmente, ou após modificar src/DesktopLauncher.cs, feche o aplicativo e execute:

powershell.exe -NoProfile -ExecutionPolicy Bypass -File .\Build.ps1

Os scripts de interface, conversão e perfil são carregados diretamente.

Consulte VALIDACAO.md para os resultados registrados e os comandos de teste. Se faltarem componentes, informe as pastas de referências ou resolva os vínculos no SOLIDWORKS. Se o perfil da aeronave recusar nomes ou encaixes alterados, ajuste seu JSON ou use o modo genérico.