Consola 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.
Interfaz#
Vista principal#
Atajos de teclado
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.
Retroceso / Suprimir – Borra caracteres.
Ctrl-Retroceso / Ctrl-Suprimir – Borra palabras.
Intro – Ejecuta el comando.
Mayús-Intro – Agrega al historial de comandos sin ejecutar.
Uso#
Alias#
Algunas variables y módulos están disponibles para su comodidad:
C
: Acceso rápido abpy.context
.D
: Acceso rápido abpy.data
.bpy
: Módulo API Python de Blender de nivel superior.
Primer vistazo al entorno de la consola#
To see the list of global functions and variables,
type dir()
and press Return to execute it.
Finalización Automática#
The Console can preview the available members of a module or variable.
As an example, type bpy.
and press Tab:
The submodules are listed in green. Attributes and methods will be listed
in the same way, with methods being indicated by a trailing (
.
Ejemplos#
bpy.context#
This module gives you access to the current scene, the currently selected objects, the current object mode, and so on.
Nota
Para que los siguientes comandos muestren el resultado adecuado, asegúrese de haber seleccionado los objetos en la Vista 3D.
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.
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.