Python Console

De Python-console biedt een snelle manier om codefragmenten te testen en Blender’s API te verkennen. Het voert uit wat men typt bij de >>>-prompt en beschikt over een opdrachtgeschiedenis en auto-complete (automatische aanvulling).

../_images/editors_python-console_default.png

Python Console.

Interface (Interactievlak)

Header Menus (Hoofdbalkmenu’s)

View Menu (Weergave Menu)

Zoom In / Zoom Out

Vergroot/verkleint de lettergrootte.

Ctrl-Left: Move to Previous Word (Ga naar het vorige woord)

Verplaatst de cursor naar het begin van het vorige woord. Als de cursor in het midden van een woord staat, wordt deze verplaatst naar het begin van het huidige woord.

Ctrl-Right: Move to Next Word (Ga naar het volgende woord)

Verplaatst de cursor naar het einde van het volgende woord. Als de cursor in het midden van een woord staat, wordt deze verplaatst naar het einde van het huidige woord.

Home: Move to Line Begin (Ga naar het begin van de regel)

Verplaatst de cursor naar het begin van de huidige regel.

Shift-Home: Selecteert alle tekst tussen de cursor en het begin van de huidige regel.

Home: Move to Line End (Ga naar het eind van de regel)

Verplaatst de cursor naar het eind van de huidige regel.

Shift-End: Selecteert alle tekst tussen de cursor en het einde van de huidige regel.

Console Menu

Clear All (Alles Wissen)

Vernieuwt de console, waardoor de weergave een frisse start krijgt. Let op: de opdrachtgeschiedenis wordt niet gewist.

Shift-Return Clear Line (Wis Regel).

Verwijdert alles van de opdrachtregel.

Ctrl-Backspace Delete Previous Word (verwijder het vorige woord)

Verwijdert alles tussen de cursor en het begin van het vorige woord (gescheiden door punten). Als de cursor in het midden van een woord staat, wordt alles tot aan het begin van het huidige woord verwijderd.

:kbd:`Ctrl-Delete`Delete Next Word (verwijder het volgende woord)

Verwijdert alles tussen de cursor en het eind van het vorige woord. Als de cursor in het midden van een woord staat, wordt alles tot aan het eind van het huidige woord verwijderd.

:kbd:`Shift-Ctrl-C`Copy as Script (Kopieer als script)

Kopieert de volledige geschiedenisbuffer naar het klembord. Deze kan in een tekstbestand worden geplakt om als een Python-script te worden gebruikt.

:kbd:`Ctrl-X`Cut (snijden)

Kopieert de geselecteerde tekst naar het klembord en verwijdert deze.

Copy Ctrl-C

Kopieert de geselecteerde tekst naar het klembord.

Ctrl-V Paste (plakken)

Plakt in de opdrachtregel.

:kbd:`Tab`Indent (Inspringen)

Voegt een tab karakter toe op de cursor.

:kbd:`Shift-Tab`Unindent (terug inspringen)

Verwijder Inspringing van de selectie.

:kbd:`Up`Backward in History (Terug in de geschiedenis)

Verandert de huidige opdracht naar de vorige uit de opdrachtgeschiedenis.

:kbd:`Down`Forward in History (voorwaarts in de geschiedenis)

Verandert de huidige opdracht naar de volgende uit de opdrachtgeschiedenis.

Autocomplete Tab

See Auto Completion.

Main View (Hoofdweergave)

Key Bindings (Toetstoekenning)

  • LMB – Verplaatst de cursor langs de invoerregel.

  • Left, Right – Verplaats de cursor één karakter.

  • Ctrl-Left, Ctrl-Right – Verplaatst de cursor per woord.

  • Shift-Left / Shift-Right – Selecteert de letters links/rechts.

  • Shift-Ctrl-Left / Shift-Ctrl-Right – Selecteert woorden links/rechts.

  • Ctrl-A – Selecteert alle tekst en tekstgeschiedenis.

  • Backspace / Delete – Erase characters (verwijder karakters).

  • Ctrl-Backspace / Ctrl-Delete – Erase words (verwijder woorden).

  • Return – Execute command (voer opdracht uit).

  • Shift-Return – Add to command history without executing (voeg toe aan de opdrachtgeschiedenis zonder uit te voeren).

Usage (Gebruik)

Aliases (Bijnamen)

Sommige variabelen en modules zijn beschikbaar voor gebruiksgemak:

  • C: Quick access to bpy.context.

  • D: Quick access to bpy.data.

  • bpy: Top level Blender Python API module.

Eerste blik op de console-omgeving

Om de lijst van globale functies en variabelen te zien, typ je dir() en druk op Return om het uit te voeren.

../_images/editors_python-console_dir.png

Auto Completion (Automatisch voltooien)

De Console kan de beschikbare leden (members) van een module of variabele weergeven. Typ bijvoorbeeld bpy. en druk op Tab:

../_images/editors_python-console_completion.png

De submodules worden in het groen weergegeven. Attributen en methoden worden op dezelfde manier weergegeven, waarbij methoden worden aangeduid met een afsluitende (.

Examples (Voorbeelden)

bpy.context

Deze module biedt toegang tot de huidige scène, de momenteel geselecteerde objecten, de huidige objectmodus, enzovoort.

Notitie

Zorg ervoor dat de object(en) geselecteerd zijn in de 3D-viewport voor de onderstaande commando’s om de juiste output te tonen.

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

Krijg de huidige 3D viewport modus (Object, Edit, Sculpt, enzovoort.):

bpy.context.mode

Krijg het actieve object:

bpy.context.object
bpy.context.active_object

Verander het actieve object X coordinaat naar 1:

bpy.context.object.location.x = 1

Verplaats het actieve object met 0,5 langs de X-as:

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

Verander alle drie de locatiecoördinaten in één keer:

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

Verander alleen de X- en Y-coördinaten:

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

Krijg het geselecteerde object:

bpy.context.selected_objects

Krijg de geselecteerde objecten, met uitzondering van het actieve object:

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

bpy.data

Geeft toegang tot alle gegevens in het blend-bestand, ongeacht of deze momenteel actief of geselecteerd zijn.

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

bpy.ops

“Operators” zijn acties die normaal gesproken worden geactiveerd via een knop of menu-item, maar die ook programmatsich kunnen worden aangeroepen. Zie de bpy.ops API-documentatie voor een lijst van alle operators.