Hoofdstuk 46Python Console

Typ een regel Python en druk Enter: het resultaat verschijnt meteen eronder, net als in elke interactieve Python-shell. Omdat de console in dezelfde sessie draait als de rest van Blender, zie je effecten direct terug in de 3D-viewport — bpy.context.object.location.x = 2 verplaatst het actieve object meteen.

Wat hij niet doet: hij bewaart niets automatisch tussen sessies (in tegenstelling tot een Text-datablock) en hij is niet bedoeld voor lange scripts — meerdere regels tikken kan, maar wordt al snel onhandig zonder de gewone editorfuncties (zoeken, uitcommentariëren, regelnummers) van de Text Editor.

De Tab-toets vult aan op basis van wat er al getypt is — begin je bpy.context.o en druk Tab, dan toont de console de mogelijke vervolgnamen (object, objects, ...). Dit is de snelste manier om de enorme bpy-API te verkennen zonder de documentatie te moeten opzoeken: tik een paar letters, Tab, en lees wat er beschikbaar is op dat punt in de datastructuur.

Pijl-omhoog/omlaag doorloopt de geschiedenis van eerder getypte regels binnen deze sessie, net als in een terminal.

Elke operator die je met de muis uitvoert (een object verplaatsen, een modifier toevoegen) verschijnt als Python-regel in de Info-editor (hoofdstuk 47). Rechtsklik op zo'n regel en kies Copy (Ctrl+C) om de exacte bpy.ops-aanroep naar het klembord te zetten, en plak hem in de Python Console om meteen uit te voeren — de brug tussen 'ik weet hoe het met de muis moet' en 'ik wil dit in een script automatiseren'.

Variabelen die je in de console aanmaakt, blijven alleen bestaan zolang Blender open blijft — sluit je het bestand of herstart je Blender, dan is de hele consolesessie weg, ook al blijft de scene zelf natuurlijk bewaard als je opgeslagen hebt. Voor iets dat je wil hergebruiken, kopieer je de werkende regels naar een Text-datablock (hoofdstuk 45) zodra ze doen wat je wil.

De meest gebruikte startpunten zijn bpy.context (wat er nú actief/geselecteerd is) en bpy.data (alle datablocks in het bestand, ongeacht selectie) — het eerste voor 'doe iets met wat ik nu heb geselecteerd', het tweede voor 'doorzoek alles in het bestand'.