square(x)
calculate the square of x.
В программах, которые мы разработаем, мы будем использовать этот метод документирования, где это уместно.
Функция dir() выводит список все членов объекта. Этот объект может быть экземпляром, но также классом или модулем. Например, мы можем применить её к модулю Blender.Lamp:
dir(Blender.Lamp)
На выходе будет список всех членов модуля Blender.Lamp. Вы можете заметить функцию Get(), с которой мы столкнулись с ранее:
['ENERGY', 'Falloffs', 'Get', 'Modes', 'New', 'OFFSET',
'RGB', 'SIZE', 'SPOTSIZE', 'Types', '__doc__',
'__name__', '__package__', 'get']
Как только Вы выясните, что входит в состав класса или модуля, Вы можете затем выяснить наличие любой дополнительной информации помощи, применяя функцию help().
Конечно обе функции, как dir() так и help() - наиболее полезны, когда у вас уже есть какие-то мысли, где искать информацию. Но если это так, то они на самом деле могут быть очень удобными инструментами.
Знакомство со встроенным редактором
Вполне возможно использовать любой редактор (который вам нравится), чтобы писать скрипты на Питоне, а затем импортировать скрипты как текстовые файлы, но встроенного текстового редактора Блендера, вероятно, будет достаточно для всех потребностей программирования. Он представляет такие удобства, как, например, подсветка синтаксиса, нумерация строк и автоматический отступ, и дает Вам возможность запускать скрипты непосредственно из редактора. Способность запускать скрипт непосредственно из редактора даёт определенные блага при отладке из-за обратной связи, которую вы получите при возникновении ошибок. Вы не только получите информационное сообщение, но также ошибочная строка будет выделена в редакторе.
Более того, редактор поставляется с большим количеством плагинов, например, автоматическое дополнение или просмотр документации, которые очень удобны для программистов. И, конечно, можно написать дополнительные плагины самостоятельно.
Вы можете выбрать встроенный редактор, выбрав Text Editor из меню окон:
Когда Вы его запустите, вам будет предоставлена почти пустая область, за исключением полосы кнопок внизу:
Мы можем выбрать по умолчанию пустой текстовый буфер TX:Text или создать новый пустой текст, выбрав ADD NEW из выпадающего меню, появляющегося при щелчке на кнопку Меню.
Имя по-умолчанию для этого нового текста будет TX:Text.001, но Вы можете изменить его на что-то более значимое, щелкнув по имени, и исправив его. Заметьте, что если Вы хотели бы сохранить этот текст во внешний файл (с помощью Text | Save As...) имя текста станет отличаться от имени файла (хотя обычно было бы хорошей идеей держать имена одинаковыми, чтобы избегнуть неразберихи). Не обязательно сохранять тексты как внешние файлы; тексты являются объектами Блендера, которые сохраняются вместе со всей остальной информацией, когда Вы сохраняете ваш .blend файл.
Внешние файлы можно открыть как тексты, выбрав OPEN NEW из выпадающего Меню вместо ADD NEW. Если по некоторой причине внешний файл и связанный текст рассинхронизируются, когда запущен Блендер, отобразится кнопка рассинхронизации. Если по ней щелкнуть, отобразится множество опций для решения проблемы.
Как только новый или существующий текст будет выбран, зона меню внизу экрана немного изменится за счет дополнительных опций:
Меню текстового файла Text дает доступ к опциям, позволяющим открывать или сохранять файл, или запускать скрипт в редакторе. Оно также представляет множество шаблонных скриптов, которые можно использовать как основу для ваших собственных скриптов. Если Вы выберите один из этих шаблонов, будет создан новый текстовый буфер с копией выбранного шаблона.
Меню Редактирования Edit содержит функциональность вырезать-и-вставить, а также опции поиска и замены текста или быстрого перепрыгивания (jump) на выбранный номер строки.
Меню Форматирования Format имеет опции вставки и удаления отступов выбранного текста, а также опции для преобразования интервала. Последняя опция может быть очень полезной, когда интерпретатор Питона жалуется на неожиданные уровни отступа, хотя вам кажется, что в вашем файле нет никаких ошибок. Если это случилось, Вы, возможно, в какой-то момент смешали табуляцию и пробелы, что спутало Питон (поскольку они отличаются, как считает интерпретатор) и возможным выходом будет преобразовать выбранный текст сначала в пробелы, а затем обратно в табуляцию. (Во всех книжках и руководствах по Питону настоятельно рекомендуют использовать для отступов НЕ табуляцию, а 4 пробела — дополнение пер.) Этот способ можно использовать снова, если когда-нибудь опять произойдёт смешение пробелов и табуляции.