Готовый перевод Blender 2.60.4 - API documentation / Blender 2.60.4 - Документация API: Blender/Python Quickstart: new to blender/scripting and want to get your feet wet?

- Введение -

Этот API по большей степени стабилен, но в некоторых местах все еще работают над дополнениями и усовершенствованиями.

Blender/Python API может следующее:
- Редактировать любые данные пользовательского интерфейса (Сцены, Меши, Частицы и т.д.)
- Модифицировать пользовательские настройки, горячие клавиши и темы
- Запускать утилиты с собственными настройками
- Создавать элементы пользовательского интерфейса, такие как меню, заголовки и панели
- Создавать новые утилиты
- Создавать взаимодействующие утилиты
- Создавать новые средства рендеринга, которые интегрируются с Blender
- Определить новые параметры в существующих Blender данных
- Рисовать 3D изображения, используя OpenGL через команды Python

Блендер/Python API не может (пока)...
- Создавать новое пространство типов.
- Назначать пользовательские свойства для каждого типа.
- Определять callback-функций или слушателей для получения уведомлений при изменении данных.

- Перед началом работы -

Этот документ не предназначен для полного описания каждой темы. Скорее, его цель-познакомить вас с новым Python API Blender'а 2.5.

Краткий список полезных вещей, чтобы знать, прежде чем начать:
- Blender использует Python 3.x; some 3rd party extensions are not available yet. доступны еще.
- Консоль в Blender 2.5 была усовершенствована; тестирование однострочными командами в консоли - это хороший способ научиться.
- Всплывающие подсказки на кнопках показывают атрибуты и имена операторов Python.
- Щелчек правой кнопкой мыши на кнопки и пункты меню выдает ссылку на документацию API.
- For more examples, the text menu has a templates section where some example operators can be found.
- Для дальнейшего изучения скрипты примеров распространяются с Blender, см. ~/.blender/scripts/startup/bl_ui для пользовательского интерфейса и в ~/.blender/scripts/startup/bl_op для операторов.

- Ключевые понятия -

-- Доступ к данным --

--- Доступ к datablock ---

Python дает доступ к данным Blender'а по одному и тому же принципу, как к анимации системой так и к пользовательскому интерфейсу; это означает, что любой параметр, который может быть изменен с помощью кнопок также может быть изменен с помощью Python.

Доступ к данным из загруженного blend файла выполняется с помощью модуля bpy.data. Это дает доступ к библиотеке данных. Например:

--- О Коллекциях ---

Можно заметить, что индекс и строка могут быть использованы для доступа к членам коллекции.

В Отличие от словарей Python'а, оба метода являются приемлемыми, однако, индекс члена может измениться при запуске Blender.

--- Доступ к атрибутам ---

Как только у вас есть блок данных, таких как материал, объект, группа и т.д., его атрибуты можно будет изменять, также как изменяются установки с помощью графического интерфейса. В самом деле, всплывающая подсказка для каждой кнопки также отображает Python атрибут, который покажет то, что нужно написать в скрипт.

Для тестирования того, что изменения данных происходят успешно, полезно использовать консоль, которая занимает отдельное пространство в Blender'е. Консоль поддерживает авто заполнение, помогая быстро разобраться в разнообразных данных ваших объектов.

Пример данных, которые могут быть быстро найдены с помощью консоли

--- Пользовательские Свойства ---

Python имеет доступ к свойствам любого блока данных, который имеет ID (данные, которые могут быть связаны и доступны из bpy.data). При присвоении свойства, вы можете задать свои собственные имена, которые будут созданы при необходимости или перезаписаны, если они уже существуют

Пример:

Отметим, что эти свойства могут быть связаны только с базовыми типами Python.
- int, float, string
- array of ints/floats
- dictionary

Переведено на Нотабеноиде
http://notabenoid.org/book/23587/77976

Переводчики: turlicht, nezo