Introdução

O Python é uma linguagem de programação interpretada, interativa e orientada a objetos. Ele incorpora módulos, tipificação dinâmica, e é uma linguagem com diversos tipos de dados dinâmicos de alto nível, e classes. O Python combina um potencial gigantesco com uma sintaxe bastante clara.

Python scripts are a versatile way to extend Blender functionality. Most areas of Blender can be scripted, including animation, rendering, import and export, object creation and automating repetitive tasks.

Para interagir com o Blender, os scripts podem fazer uso da API («Application Programming Interface») altamente integrada.

Informações gerais

Ligações que são úteis na escrita de scripts (em Inglês):

• Python.org - Informações gerais sobre Python.
• :doc:`API Python para o Blender (em inglês) <https://www.blender.org/api/current>`__ - Documentação oficial da API. Utilize estas páginas como referência ao escrever scripts.
• :doc:`Introdução a API do Blender (em inglês) <https://www.blender.org/api/current/info_quickstart.html>`__ - Uma rápida introdução para começar com a API. Contém exemplos.

Ligações que explicam como lidar com a distribuição de seus scripts:

• Compartilhamento de scripts - Informações sobre como você pode compartilhar seus scripts e incluí-los dentro das versões de distribuição oficiais do Blender.
• Criação de complementos - Complementos são usados para encapsular e distribuir scripts.
• Projeto de complementos - Projeto para manter um repositório central de extensões para o Blender.

Inciando

Ligações para o manual

As seguintes ligações levam você desde os princípios básicos até os mais avançados conceitos na confecção de scripts Python para o Blender.

• Editor de textos
• Console interativo Python
• Info Editor

Ligações externas

aqui, apresentamos algumas ligações externas contendo muitas informações boas para começar a aprender como escrever scripts para o Blender (em inglês).

• Python API: Quickstart
• CG Cookie: Blender 2.8 Python Scripting Superpowers for Non-Programmers
• Olav3D Tutorials: 3D Programming for Beginners Using Python
• Blender Artists: Python Support Forum

Estendendo o Blender

Complementos

Add-ons are scripts you can enable to gain extra functionality within Blender, they can be enabled from the Preferences.

Fora do executável do Blender, existem literalmente centenas de complementos escritos por muitas pessoas:

• Os complementos oficialmente suportados são embutidos nas versões de lançamento do Blender.
• Other Testing add-ons are included in development builds but not official releases. Many of them work reliably and are very useful but are not ensured to be stable for release.

See Add-ons for documentation on add-ons included with Blender.

Scripts

Independente dos complementos, existem também scripts que você pode utilizar para estender a funcionalidade do Blender:

• Módulos: Bibliotecas de utilitários para a importação em outros formatos de script.
• Predefinições: Configurações importantes para as ferramentas do Blender e suas definições..
• Inicialização: Estes arquivos são importados durante a inicialização do Blender. Eles definem a maioria da interface de usuário, bem como alguns operadores adicionais do núcleo do software.
• Scripts personalizados: Em contraste aos complementos, eles são projetados tipicamente para uma única execução através do Editor de texto.

Salvando seus próprios scripts

Localização de arquivos

All scripts are loaded from the scripts folder of the local, system and user paths.

You can setup an additional search path for scripts in File Paths Preferences ‣ File Paths.

Instalação

Add-ons are conveniently installed through Blender in the Preferences. Click the Install… button and select the .py or .zip file.

To manually install scripts or add-ons, place them in the addons, modules, presets, or startup directory according to their type. See the description above.

Você também pode executar os scripts carregando-os através do Editor de texto.