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.

  • Blender Python API – Official API documentation. Use this for referencing while writing scripts.

  • API Introduction – A short introduction to get you started with the API. Contains examples.

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.

  • Add-ons project – Project to maintain a central repository of extensions to Blender.

Getting Started#

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.

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).

Estendendo o Blender#

Complementos#

Add-ons are scripts that enable Blender to gain extra functionality; they can be enabled from the Preferences.

Outside of the Blender executable, there are hundreds of add-ons written by many people:

  • Os complementos oficialmente suportados são embutidos nas versões de lançamento do Blender.

  • Other Testing add-ons are included in development builds of Blender but not official releases. Many of them work reliably and are very useful but are not yet ensured to be stable for release.

Veja também

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

Scripts#

Apart from add-ons, there are several other types of scripts that extend Blender’s functionality:

Modules:

Utility libraries for import into other scripts.

Predefinições:

Settings for Blender’s tools and key configurations.

Inicialização:

These files are imported when starting Blender. They define most of Blender’s UI, as well as some additional core operators.

Custom Scripts:

In contrast to add-ons, they are typically intended for one-time execution via the Text Editor.

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.