Написание скриптов для Blender 2.49

Чтобы увидеть, где Блендер действительно ищет модули, Вы можете посмотреть на переменную Питона sys.path. Чтобы сделать это, Вы должны запустить интерактивную консоль Питона в Блендере. Заметьте, что при этом используется другая и, возможно, здесь вы запутаетесь с понятиями консоли, - DOSBox или окно терминала, которое стартует одновременно с основным окном Блендера, и где появляются различные информационные сообщения также называется консолью! Интерактивная консоль Питона, которую мы хотим использовать, запускается в окне скриптов:

Как только интерактивная консоль Питона стартует, наберите следующие команды:

import sys

print sys.path

Заметьте, что в интерактивной консоли Питона не видно никаких подсказок (если только при этом не ожидается отступ, например в цикле for), но всё, что Вы набираете, будет отличаться цветом (белый на черном по умолчанию) от того, что возвращается (это будет синий или черный). Две предыдущие команды дадут нам доступ к модулю Питона sys, который содержит различные переменные с системной информацией. Переменная sys.path, которую мы печатаем, содержит все каталоги, в которых будет вестись поиск, когда мы попытаемся импортировать модуль. (Заметьте, что импортирование sys всегда будет работать, поскольку sys - встроенный модуль.) Результат будет чем-то, аналогичным этому:

['C:\\Program Files\\Blender Foundation\\Blender',

'C:\\Program Files\\Blender

Foundation\\Blender\\python26.zip', 'C:\\Python26\\Lib',

'C:\\Python26\\DLLs', 

'C:\\Python26\\Lib\\lib-tk', 'C:\\Program Files\\Blender

Foundation\\Blender', 

'C:\\Python26', 'C:\\Python26\\lib\\site-packages', 

'C:\\Python26\\lib\\site-packages\\PIL', 

'C:\\PROGRA~1\\BLENDE~1\\Blender', 

'C:\\Documents and Settings\\Michel\\Application

Data\\Blender  Foundation\\Blender\\.blender\\scripts',

'C:\\Documents and  Settings\\Michel\\Application

Data\\Blender

Foundation\\Blender\\.blender\\scripts\\bpymodules']

Если ваш каталог установки Питона не присутствует в этом списке, тогда Вы должны настроить переменную PYTHONPATH перед запуском Блендера.

Изучение встроенных модулей, функция help()

Интерактивная консоль Питона является также хорошей платформой для изучения встроенных модулей. Поскольку Питон поставляется оснащенным двумя очень полезными функциями, help() и dir(), у вас есть мгновенный доступ к большому количеству информации, содержащейся в модулях Блендера (и Питона), как к большой документации, предусмотренной в виде части кода.

Для людей, не знакомых с этими функциями, вот два коротких примера, оба работают из интерактивной консоли Питона. Для того, чтобы получить информацию о специфическом объекте или функции, наберите:

help(Blender.Lamp.Get)

Информация будет выведена в этой же консоли:

Help on built-in function Get in module Blender.Lamp:

Lamp.Get (name = None):

        Return the Lamp Data with the given name,

        None if not found, or Return a list with all

         Lamp Data objects in the current scene,

         if no argument was given.

Перевод:

Помощь по встроенной функции Get в модуле Blender.Lamp:

Lamp.Get (name = None):

Возвращает Данные лампы Lamp с именем name, None

если не она обнаружена, или возвращает список со

всеми объектами данных ламп в текущей сцене, если

вызвана без аргумента.

Функция help() показывает связанную строку документирования функций, классов, или модулей. В предыдущем примере показана информация, предоставленная вместе с методом или функцией Get() класса Lamp. Строка документирования является первой строкой  в определении функции, класса, или модуля. Когда вы определяете ваши собственные функции, было бы хорошо, если бы вы делали также. Это может выглядеть примерно так:

def square(x):

   """

   calculate the square of x.

   (вычисление квадрата x.)

   """

   return x*x