Консоль Python (Python console)

Консоль Python предлагает быстрый способ тестирования фрагментов кода и изучения API Blender’а. Она выполняет всё, что вы вводите в строке запроса >>>, а также имеет историю команд и функцию автодополнения.

../_images/editors_python-console_default.png

Консоль Python.

Интерфейс (interface)

Меню заголовка

Меню «Вид»

Приблизить / Отдалить (zoom in / zoom out)

Увеличивает/уменьшает размер шрифта.

Перейти к предыдущему слову (move to previous word) Ctrl-Влево

Перемещает курсор в начало предыдущего слова. Если курсор находится в середине слова, он перемещается к его началу.

Перейти к следующему слову (move to next word) Ctrl-Вправо

Перемещает курсор в конец следующего слова. Если курсор находится в середине слова, он перемещается к его концу.

Перейти в начало строки (move to line begin) Home

Перемещает курсор в начало текущей строки.

Shift-Home: Выделяет весь текст между курсором и началом текущей строки.

Перейти в конец строки (move to line end) End

Перемещает курсор в конец текущей строки.

Shift-End: Выделяет весь текст между курсором и концом текущей строки.

Меню «Консоль»

Очистить всё (clear all)

Обновляет консоль, открывая новый вид, как в самом начале. Обратите внимание, что история команд не очищается.

Очистить строку (clear line) Shift-Ввод.

Удаляет всё из строки запроса.

Удалить предыдущее слово (delete previous word) Ctrl-Backspace

Удаляет всё между курсором и началом предыдущего слова (разделённое точками). Если курсор находится в середине слова, удаляет всё до начала текущего слова.

Удалить следующее слово (delete next word) Ctrl-Delete

Удаляет всё между курсором и концом следующего слова. Если курсор находится в середине слова, удаляет всё до конца текущего слова.

Копировать как скрипт (copy as script) Shift-Ctrl-C

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

Разрезать* (cut) Ctrl-X

Копирует выделенный текст в буфер обмена и удаляет его.

Копировать (copy) Ctrl-C

Копирует выделенный текст в буфер обмена.

Вставить (paste) Ctrl-V

Вставляется в командную строку.

Добавить отступ (indent) Tab

Вставляет символ табуляции в положение курсора.

Убрать отступ (unindent) Shift-Tab

Убирает отступ в строке.

Назад по истории (backward in history) Вверх

Изменяет текущую команду на предыдущую из истории команд.

Вперёд по истории (forward in history) Вниз

Изменяет текущую команду на следующую из истории команд.

Автодополнение (autocomplete) Tab

См. раздел «Автоматическое дополнение».

Основной вид

Назначение клавиш

  • ЛКМ – Перемещает курсор вдоль строки ввода.

  • Влево / Вправо – Перемещает курсор на один символ.

  • Ctrl-Влево / Ctrl-Вправо – Перемещает курсор на одно слово.

  • Shift-Влево / Shift-Вправо – Выделяет символы слева/справа.

  • Shift-Ctrl-Влево / Shift-Ctrl-Вправо – Выделяет слова слева/справа.

  • Ctrl-A – Выделяет весь текст и его историю.

  • Backspace / Delete – Удалить символы.

  • Ctrl-Backspace / Ctrl-Delete – Удалить слова.

  • Ввод – Выполнить команду.

  • Shift-Ввод – Добавить в историю команд без выполнения.

Использование

Псевдонимы

Для удобства доступны некоторые переменные и модули:

  • C: Быстрый доступ к bpy.context.

  • D: Быстрый доступ к bpy.data.

  • bpy: Модуль верхнего уровня Python API Blender’а.

Первый взгляд на среду консоли

Чтобы просмотреть список глобальных функций и переменных, введите dir() и нажмите Ввод для выполнения.

../_images/editors_python-console_dir.png

Автоматическое дополнение

Консоль позволяет просматривать доступные элементы модуля или переменной. Например, введите bpy. и нажмите Tab:

../_images/editors_python-console_completion.png

Подмодули выделяются зелёным цветом. Атрибуты и методы будут перечисляться аналогичным образом, причём методы будут обозначены символом ( в конце.

Примеры

bpy.context

Этот модуль предоставляет вам доступ к текущей сцене, текущим выделенным объектам, текущему режиму объекта и т. п..

Примечание

Чтобы команды, приведённые ниже, отображали правильный результат, – убедитесь, что вы выделили объект(ы) в 3D-вьюпорте.

../_images/editors_python-console_bpy-context.png

Получить текущий режим 3D-вьюпорта (объектный, редактирования, скульптинга и т. д.):

bpy.context.mode

Получить активный объект:

bpy.context.object
bpy.context.active_object

Изменить координату X активного объекта на 1:

bpy.context.object.location.x = 1

Переместить активный объект на „0.5“ по оси X:

bpy.context.object.location.x += 0.5

Изменить одновременно все три координаты положения:

bpy.context.object.location = (1, 2, 3)

Изменить только координаты X и Y:

bpy.context.object.location.xy = (1, 2)

Получить выделенные объекты:

bpy.context.selected_objects

Получить выделенные объекты, исключая активный:

[obj for obj in bpy.context.selected_objects if obj != bpy.context.object]

bpy.data

Предоставляет доступ ко всем данным в blend-файле, независимо от того, являются ли они активными в данный момент или выделенными.

../_images/editors_python-console_bpy-data.png

bpy.ops

«Операторы» – это действия, которые обычно вызываются кнопкой или элементом меню, но также они могут быть вызваны и программно. Список всех операторов см. в документации API «Operators (bpy.ops)».