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.

../_images/editors_python-console_default.png

Consola de Python.

Interfaz

Menús del encabezado

Menú Vista

Ampliar / Reducir

Incrementa o disminuye el tamaño de la tipografía.

Mover a palabra anterior Ctrl-Izquierda

Mueve el cursor al principio de la palabra anterior. Si el cursor está en medio de una palabra, el cursor se mueve al principio de la palabra actual.

Mover a palabra siguiente Ctrl-Derecha

Mueve el cursor al final de la siguiente palabra. Si el cursor está en medio de una palabra, el cursor se mueve al final de la palabra actual.

Mover a inicio de línea Inicio

Mueve el cursor al inicio de la línea actual.

Mayús-Inicio: Seleccionará el texto entre el cursor y el inicio de la línea actual.

Mover a fin de línea Fin

Mueve el cursor al final de la línea actual.

Mayús-Fin: Seleccionará el texto entre el cursor y el final de la línea actual.

Menú Consola

Eliminar todo

Actualizará la consola, dando a la vista un nuevo comienzo. Nótese que el historial de comandos no será borrado.

Eliminar línea Mayús-Intro.

Eliminará todo en la línea del símbolo del sistema.

Borrar palabra anterior Ctrl-Retroceso

Elimina todo entre el cursor y el comienzo de la palabra anterior (separado por puntos). Si el cursor está en medio de una palabra, borra todo hasta el principio de la palabra actual.

Borrar palabra siguiente Ctrl-Suprimir

Elimina todo entre el cursor y el final de la siguiente palabra. Si el cursor está en medio de una palabra, borra todo hasta el final de la palabra actual.

Copiar como script Mayús-Ctrl-C

Copiará el buffer del historial completo al portapapeles. Éste podrá ser pegado dentro de un archivo de texto para ser usado como un script de Python.

Cortar Ctrl-X

Copiará el texto seleccionado al portapapeles y lo borrará.

Copiar Ctrl-C

Copiará el texto seleccionado al portapapeles.

Pegar Ctrl-V

Pegará en la línea de comando.

Insertar sangría Tab

Inserta un carácter de tabulación en el cursor.

Quitar sangría Mayús-Tab

Elimina la sangría de la selección.

Retroceder en historial Arriba

Cambiará el comando actual al comando anterior en el historial de comandos.

Avanzar en historial Abajo

Cambiará el comando actual al siguiente en el historial de comandos.

Autocompletar Tab

Ver Completado automático.

Vista principal

Atajos de teclado

  • LMB – Moverá el cursor a lo largo de la línea de entrada.

  • Izquierda / Derecha – Moverá el cursor un caracter.

  • Ctrl-Izquierda / Ctrl-Derecha – Moverá el cursor una palabra.

  • Mayús-Izquierda / Mayús-Derecha – Seleccionará caracteres hacia la izquierda o derecha.

  • Mayús-Ctrl-Izquierda / Mayús-Ctrl-Derecha – Seleccionará palabras hacia la izquierda o derecha.

  • Ctrl-A – Seleccionará todo el texto o todo el historial de texto.

  • Retroceso / Supr – Borrará caracteres.

  • Ctrl-Retroceso / Ctrl-Supr – Borrará palabras.

  • Intro – Ejecutará un comando.

  • Mayús-Intro – Agregará al historial de comandos sin ejecutarlo.

Uso

Alias

Algunas variables y módulos están disponibles para una mayor practicidad:

  • C: Acceso rápido a bpy.context.

  • D: Acceso rápido a bpy.data.

  • bpy: Módulo de nivel superior de la API de Python de Blender.

Vistazo inicial al entorno de la consola

Para ver la lista de funciones y variables globales, escribir dir() y pulsar Intro para ejecutar.

../_images/editors_python-console_dir.png

Completado automático

La Consola será capaz de previsualizar los miembros disponibles de un módulo o variable. A modo de ejemplo, escribir bpy. y pulsar Tab:

../_images/editors_python-console_completion.png

Los sub módulos serán listados en verde. Los atributos y métodos serán listados de la misma forma, distinguiendo a los métodos mediante un caracter ( final.

Ejemplos

bpy.context

Este módulo dará acceso a la escena actual, los objetos actualmente seleccionados, el modo actual de interacción, etc.

Nota

Para que los siguientes comandos muestren el resultado adecuado, habrá que asegurarse de haber seleccionado objetos en la Vista 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

Cambiará las tres coordenadas de posición a la vez:

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

Cambiará sólo las coordenadas X e Y:

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

Los «operadores» son acciones normalmente disparadas desde un botón o elemento de un menú, aunque también podrán ser invocadas de forma programática. Ver la documentación de la API para bpy.ops para obtener una lista de todos los operadores.