Descrição
A API 3DCoat Python destina-se a acionar comandos de interface do usuário, operar na cena e criar novas ferramentas. É muito semelhante ao C++ Core API, mas tem suas próprias vantagens e desvantagens.
- Não há necessidade de nenhuma configuração adicional para fazer seus scripts; O Python está embutido no distributivo 3DCoat .
- Python é como um canivete suíço, permitindo que você traga todo o poder das bibliotecas Python para o 3DCoat.
- Python é muito mais lento que C++, então pode ser usado apenas para gerenciamento geral, não para algoritmos profundos e complexos.
- Se você já está familiarizado com a Core API, a API Python é muito semelhante, quase 1:1, com a mesma lógica e nomes de função.
Uso
- Use Scripts->Criar Script Python para criar um novo script. Você pode escolher um modelo inicial para começar. O arquivo .py será aberto em seu editor atual associado aos arquivos .py.
- Usamos o Python 3.8.10 incorporado para operar. Esta é a última versão do Python que pode ser executada no Windows 7.
- Se necessário, você pode criar um arquivo chamado requirements.txt com uma lista de módulos usados; neste caso, os módulos serão instalados automaticamente antes da execução do script.
- Recomendamos o Visual Studio Code, pois ele reconhecerá automaticamente a sintaxe de comandos especializados em 3DCoat e oferecerá as dicas corretas.
- Atenção: o arquivo coat.pyi localizado na pasta do projeto é responsável pelas dicas do módulo coat no Visual Studio. Você pode abrir esse arquivo, pois ele contém a lista de todas as classes e comandos, o que pode ser útil para referência rápida.
- Use Scripts->Show Python Console para ver a saída do console do Python. Atualmente, esta é a única maneira de depurar o scripth. Posteriormente, planejamos adicionar depuração nativa usando o Visual Studio Code.
- Você pode instalar módulos adicionais para Python usando Scripts->Install Python Modules . Outra maneira é usar requirements.txt na mesma pasta onde está o arquivo .py.
classes principais
E/S geral: coat.io
Gerenciamento de diálogo: coat.dialog
Operações de malha: coat.Mesh
Raízes da cena: casaco. Cena
Elemento da cena: casaco.SceneElement
Gerenciamento de volume: coat.Volume
Gerenciamento da interface do usuário: coat.ui
Matemática de vetores 2D: coat.vec2
Matemática de vetores 3D: coat.vec3
Matemática de vetores 4D: coat.vec4
Matemática de matriz 3D: coat.mat3
Matemática de matriz 4D: coat.mat4
Gerenciamento de simetria: coat.symm