Python Console(Pythonコンソール)

The Python Console offers a quick way to test code snippets and explore Blender's API. It executes whatever you type on its >>> prompt and has command history and auto-complete.

../_images/editors_python-console_default.png

Pythonコンソール。

Interface(インターフェイス)

ヘッダーメニュー

View(ビュー) メニュー

Zoom In(ズームイン) / Zoom Out(ズームアウト)

Increases/decreases the font size.

Move to Previous Word(前の単語に移動) Ctrl-Left

前の単語の先頭にカーソルを移動します。カーソルが単語の途中にある場合、カーソルは現在の単語の先頭に移動します。

Move to Next Word(次の単語に移動) Ctrl-Right

次の単語の末尾にカーソルを移動します。カーソルが単語の途中にある場合、カーソルは現在の単語の末尾に移動します。

Move to Line Begin(行頭に移動) Home

現在の行の先頭にカーソルを移動します。

Shift-Home: Selects all text between the cursor and the start of the current line.

Move to Line End(行末に移動) End

現在の行の末尾にカーソルを移動します。

Shift-End: Selects all text between the cursor and the end of the current line.

Console(コンソール) メニュー

Clear All(すべてクリア)

Refreshes the console, giving the view a fresh start. Note that command history is not cleared.

Clear Line(行をクリア) Shift-Return

プロンプト行からすべてを削除します。

Delete Previous Word(前の単語を削除) Ctrl-Backspace

カーソルから前の(ピリオドで区切られた)単語の先頭までのすべてを削除します。カーソルが単語の途中にある場合は、現在の単語の先頭までのすべてを削除します。

Delete Next Word(次の単語を削除) Ctrl-Delete

カーソルから次の単語の終わりまでのすべてを削除します。カーソルが単語の途中にある場合は、現在の単語の最後までのすべてを削除します。

Copy as Script(スクリプトとしてコピー) Shift-Ctrl-C

Copies the full history buffer to the clipboard. This can be pasted into a text file to be used as a Python script.

Cut(カット) Ctrl-X

Copies the selected text into the clipboard and deletes it.

Copy(コピー) Ctrl-C

Copies the selected text into the clipboard.

Paste(貼り付け) Ctrl-V

Pastes into the command line.

Indent(インデント) Tab

カーソルの位置にタブ文字を挿入します。

Unindent(インデントを解除) Shift-Tab

選択範囲のインデントを解除します。

Backward in History(履歴の後方) Up

Changes the current command to the previous one from the command history.

Forward in History(履歴の前方) Down

Changes the current command to the next one from the command history.

Autocomplete(オートコンプリート) Tab

See Auto Completion.

メインビュー

キーバインディング

  • LMB -- Moves the cursor along the input line.

  • Left / Right -- Moves the cursor by one character.

  • Ctrl-Left / Ctrl-Right -- Moves the cursor by one word.

  • Shift-Left / Shift-Right -- Selects characters to the left/right.

  • Shift-Ctrl-Left / Shift-Ctrl-Right -- Selects words to the left/right.

  • Ctrl-A Selects all text and text history.

  • Backspace / Delete -- 文字を消去。

  • Ctrl-Backspace / Ctrl-Delete -- 単語を消去。

  • Return -- コマンドを実行。

  • Shift-Return -- 実行せずにコマンド履歴に追加。

使用方法

エイリアス

便宜上、いくつかの変数とモジュールを使用できます:

  • C: bpy.context へのクイックアクセス。

  • D: bpy.data へのクイックアクセス。

  • bpy: Blender Python APIモジュールのトップレベル。

コンソール環境の初見

To see the list of global functions and variables, type dir() and press Return to execute it.

../_images/editors_python-console_dir.png

オートコンプリート

The Console can preview the available members of a module or variable. As an example, type bpy. and press Tab:

../_images/editors_python-console_completion.png

The submodules are listed in green. Attributes and methods will be listed in the same way, with methods being indicated by a trailing (.

bpy.context

This module gives you access to the current scene, the currently selected objects, the current object mode, and so on.

注釈

以下のコマンドで適切な出力を表示するには、3Dビューポートでオブジェクトを選択していることを確認してください。

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

Get the current 3D Viewport mode (Object, Edit, Sculpt, etc.):

bpy.context.mode

Get the active object:

bpy.context.object
bpy.context.active_object

Change the active object's X coordinate to 1:

bpy.context.object.location.x = 1

Move the active object by 0.5 along the X axis:

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

Change all three location coordinates in one go:

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

Change only the X and Y coordinates:

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

Get the selected objects:

bpy.context.selected_objects

Get the selected objects excluding the active one:

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

bpy.data

Gives you access to all the data in the blend-file, regardless of whether it's currently active or selected.

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

bpy.ops

"Operators" are actions that are normally triggered from a button or menu item but can also be called programmatically. See the bpy.ops API documentation for a list of all operators.