Consola de Python

La consola de Python ofereix una manera ràpida de provar fragments de codi i explorar l’API de Blender. Executa qualsevol cosa que escriviu a l’indicador >>> i té un historial d’ordres i autocompletar.

../_images/editors_python-console_default.png

Consola de Python.

Interfície

Menús de capçalera

Menú de vista

Aproximar / allunyar

Augmenta o disminueix la mida de la font.

Moure al mot anterior Ctrl-Esqu

Mou el cursor al començament de la paraula anterior. Si el cursor es troba al mig d’una paraula, el cursor es mou al començament de la paraula on està.

Moure al mot següent Ctrl-Dret

Mou el cursor al final de la paraula següent. Si el cursor es troba al mig d’una paraula, el cursor es mou fins al final de la paraula on està.

Moure a començament de línia Inici

Mou el cursor al començament de la línia on està.

Maj-Inici: selecciona tot el text entre el cursor i l’inici de la línia on està.

Moure a final de línia Final

Mou el cursor al final de la línia on està.

Maj-Final: selecciona tot el text entre el cursor i el final de la línia on està.

Menú de la consola

Retirar tot

Refresca la consola, tot facilitant a la vista de començar de bell nou. Tingueu en compte que l’historial d’ordres no es perd.

Retirar línia Maj-Retorn.

Suprimeix tot el que hi ha a la línia d’ordres.

Elimina la paraula anterior Ctrl-Enrere

Ho elimina tot entre el cursor i el començament de la paraula anterior (separat per punts). Si el cursor està al mig d’una paraula, ho elimina tot fins al començament de la paraula on està.

Eliminar mot següent Ctrl-Eliminar

Elimina tot entre el cursor i el final de la paraula següent. Si el cursor està al mig d’una paraula, ho suprimeix tot fins al final de la paraula on està.

Copiar com a protocol Maj-Ctrl-C

Copia l’historial complet de la vàlvula al porta-retalls. Això es pot enganxar en un document de text per a utilitzar-lo com a protocol de Python.

Retallar Ctrl-X

Copia el text seleccionat al porta-retalls i l’elimina.

Copiar Ctrl-C

Copia el text seleccionat al porta-retalls.

Enganxar Ctrl-V

Enganxa a la línia d’ordres.

Sagnar Tab

Insereix un tabulador al cursor.

Dessagnar Maj-Tab

Dessagna la selecció.

Recular en l’historial Amunt

Canvia l’ordre que hi ha a la que hi havia abans a partir de l’historial d’ordres.

Avançar en l’historial Avall

Canvia l’ordre actual a la que ve després segons l’historial d’ordres.

Autocompletar Tab

Vegeu Autocompleció.

Vista principal

Tecles drecera

  • BER – mou el cursor al llarg de la línia d’ingressió.

  • Esqu / Dreta – Mou el cursor un sol caràcter.

  • Ctrl-Esqu / Ctrl-Dreta – mou el cursor una paraula sencera.

  • Maj-Esqu / Maj-Dreta – selecciona els caràcters a l’esquerra/dreta.

  • Maj-Ctrl-Esqu / Maj-Ctrl-Dreta – selecciona paraules a l’esquerra/dreta.

  • Ctrl-A selecciona tot el text i l’historial de text.

  • Retrocés / Supr – esborra caràcters.

  • Ctrl-Enrere / Ctrl-Eliminar – esborra les paraules.

  • Retorn – executa l’ordre.

  • Maj-Retorn – afegeix a l’historial d’ordres sense executar.

Operativa

Àlies

Algunes variables i mòduls estan disponibles per comoditat:

  • C: accés ràpid a bpy.context.

  • D: accés ràpid a bpy.data.

  • bpy: mòdul de l’API de Python de nivell superior del Blender.

Primer cop d’ull a l’Entorn de la consola

Per veure la llista de funcions i variables globals, escriviu dir() i premeu Retorn per executar-ho.

../_images/editors_python-console_dir.png

Autocompleció

La consola pot previsionar els membres disponibles d’un mòdul o variable. Com a exemple, escriviu bpy. i pitgeu Tab:

../_images/editors_python-console_completion.png

Els submòduls es mostren en verd. Els atributs i mètodes es llistaran igual i els mètodes s’indicaran amb un ( al final.

Exemples

bpy.context

Aquest mòdul us permet accedir a l’escena actual, als objectes presentment seleccionats, al mode d’objecte actual, etc.

Nota

Perquè les ordres de sota mostrin l’egressió adequada, assegureu-vos que teniu objectes seleccionats al mirador 3D.

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

Obtenir el mode del mirador 3D en curs (Objecte, Edició, Esculpir, etc.):

bpy.context.mode

Obtenir objecte actiu:

bpy.context.object
bpy.context.active_object

Canviar coordenada X de l’objecte actiu a 1:

bpy.context.object.location.x = 1

Moure l’objecte actiu de 0,5 seguint l’eix X:

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

Canviar les tres coordenades d’ubicació d’una tirada:

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

Canviar només les coordenades X i Y:

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

Obtenir objectes seleccionats:

bpy.context.selected_objects

Obtenir els objectes seleccionats excloent-ne l’actiu:

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

bpy.data

Ofereix accés a totes les dades del document blend, independentment de si està actiu o seleccionat.

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

bpy.ops

Els «operadors» són accions que normalment s’activen des d’un botó o element de menú, però també es poden invocar programàticament. Vegeu la documentació de l’API bpy.ops per veure una llista de tots els operadors.