← Back to CoursesBlendercursus
Blendercursus
45. Text Editor
schoolium · Blendercursus
Blendercursus
45. Text Editor
DDeel D · De editors

Hoofdstuk 45Text Editor

Python-scripts en losse tekstnotities bewerken, intern in het .blend-bestand bewaard

De Text Editor is een eenvoudige, ingebouwde teksteditor met Python-syntaxiskleuring — voor scripts die je binnen Blender uitvoert, of gewoon voor notities die je wil bewaren bij het bestand. Elke tekst is een los datablock, net als een mesh of een materiaal.

4× uitleg1× ontleed2× naslag1× zelf doen1 oefenbestand5 beelden
beeld-tegel-d045-text-editorRECCONCEPT00:00:00:00schoolium
Uitleg · 45.1

Waarvoor de Text Editor dient

1/8

Elke tekst die je hier typt of laadt, wordt een Text-datablock dat mét het .blend-bestand bewaard blijft (tenzij je 'm expliciet als extern bestand koppelt). Dat maakt de Text Editor de plek voor: Python-scripts die je binnen dit project wil hergebruiken, driver-expressies die te lang zijn voor het kleine invoerveld, of gewoon een to-do-lijst die je bij de scene wil bewaren.

Wat hij niet doet: hij is geen volwaardige IDE — geen autocomplete voor je eigen modules, geen debugger, geen linter. Voor serieus scriptwerk gebruiken veel mensen een externe editor (VS Code met de Blender Development-extensie) en laten ze Blender alleen het resultaat uitvoeren; deze editor blijft wel de snelste weg voor een kort script dat bij het bestand moet blijven horen.

De Text Editor met een kort Python-script en regelnummers.RECBLENDER 5.1 · EDITOR-TEXT-EDITOR00:00:00:001920×1080
shot-editor-text-editorDe Text Editor met een kort Python-script en regelnummers.
Ontleed · 45.2

De header van de Text Editor

2/8
shot-text-editor-header
RECBLENDER 5.1 · TEXT-EDITOR-HEADER00:00:00:001614×79
Wijs een nummer aan: de camera zoomt in op dat onderdeel. Klik om vast te zetten.
  1. 1
    Text-datablock-selector

    Kies of maak een tekst; 'New' en 'Open' staan hier ook.

  2. 2
    View · Text · Edit · Select · Format-menu's

    Bestand-opties, opmaak, en tekstbewerking.

  3. 3
    Line Numbers / Word Wrap / Syntax Highlight-toggles

    Weergave-opties die niets aan de inhoud veranderen.

  4. 4
    Run Script-knop

    Voert de volledige tekst uit als Python; alleen zinvol bij geldige code.

  5. 5
    Register-toggle

    Voert het script automatisch uit bij het openen van het bestand — met de nodige voorzichtigheid te gebruiken (zie hieronder).

Naslag · 45.3

Het Text-menu

3/8
Text
Menu-itemWat het doet
New / Open / ReloadMaakt een leeg datablock, laadt een extern bestand in, of herlaadt de laatste versie van schijf.
Save / Save AsSchrijft de tekst terug naar het gekoppelde externe bestand, of vraagt om een nieuw pad.
Make InternalOntkoppelt een extern-gekoppelde tekst zodat hij volledig in het .blend-bestand leeft.
Run ScriptVoert de volledige inhoud uit als Python-code (ook via Alt+P).
RegisterMarkeert het script om automatisch te draaien bij het openen van het bestand.
Find & ReplaceZoeken en vervangen binnen de tekst.
Jump to LineSpringt direct naar een regelnummer.
Uitleg · 45.4

Extern tegenover intern: waarom 'Save' soms niets lijkt te doen

4/8

Een tekst die je met New aanmaakt, is standaard puur intern: er is geen extern bestand om naar te schrijven, dus 'Save' vraagt de eerste keer om een pad (Save As). Open je daarentegen een extern .py-bestand, dan blijft de Text Editor gekoppeld aan dat pad; wijzig je het bestand buiten Blender, dan toont de header een waarschuwingsdriehoekje en moet je Reload gebruiken om de externe wijziging in te laden — Blender leest een gekoppeld bestand niet automatisch opnieuw.

De statusbalk onderaan verraadt het meteen: 'Text: Internal' betekent geen gekoppeld extern bestand, dus de eerste Save vraagt om een pad.RECBLENDER 5.1 · D45-TEXTEDITOR-MASTER00:00:00:00288×65
shot-d45-texteditor-masterDe statusbalk onderaan verraadt het meteen: 'Text: Internal' betekent geen gekoppeld extern bestand, dus de eerste Save vraagt om een pad.
Uitleg · 45.5

Een script uitvoeren en fouten lezen

5/8

Run Script (Alt+P) voert de hele tekst uit in de Python-omgeving van deze Blender-sessie. Foutmeldingen verschijnen niet in de Text Editor zelf, maar in de systeemconsole (Window → Toggle System Console op Windows) of, korter, als een rode melding onderaan het Blender-venster die je met de muis kan overhoveren voor de volle tekst. Zonder de systeemconsole open te hebben, mis je bij een fout vaak de volledige traceback en dus de regel waar het precies misging.

Het driehoekje uiterst rechts is Run Script (Alt+P) — foutmeldingen verschijnen niet hier, maar in de systeemconsole.RECBLENDER 5.1 · D45-TEXTEDITOR-MASTER00:00:00:00288×65
shot-d45-texteditor-masterHet driehoekje uiterst rechts is Run Script (Alt+P) — foutmeldingen verschijnen niet hier, maar in de systeemconsole.
Naslag · 45.6

Sneltoetsen — Text Editor

6/8
Sneltoetsen — Text TEXT_EDITOR / WINDOW
ToetsActieOperator
Ctrl+WHEELUPMOUSEContext Int Cyclewm.context_cycle_int
Ctrl+WHEELDOWNMOUSEContext Int Cyclewm.context_cycle_int
Ctrl+NUMPAD_PLUSContext Int Cyclewm.context_cycle_int
Ctrl+NUMPAD_MINUSContext Int Cyclewm.context_cycle_int
Alt+NNew Texttext.new
Alt+OOpen Texttext.open
Alt+RReloadtext.reload
Alt+SSavetext.save
Ctrl+Alt+Shift+SSave Astext.save_as
Alt+PRun Scripttext.run_script
Ctrl+XCuttext.cut
Ctrl+CCopytext.copy
Ctrl+VPastetext.paste
Shift+DELCuttext.cut
Ctrl+INSERTCopytext.copy
Shift+INSERTPastetext.paste
Ctrl+DDuplicate Linetext.duplicate_line
Ctrl+ASelect Alltext.select_all
Ctrl+Shift+ASelect Linetext.select_line
LEFTMOUSESelect Wordtext.select_word
Ctrl+Shift+UP_ARROWMove Linestext.move_lines
Ctrl+Shift+DOWN_ARROWMove Linestext.move_lines
TABIndent or Autocompletetext.indent_or_autocomplete
Shift+TABUnindenttext.unindent
Ctrl+SLASHToggle Commentstext.comment_toggle
HOMEMove Cursortext.move
ENDMove Cursortext.move
Ctrl+EMove Cursortext.move
Ctrl+Shift+EMove Cursortext.move
LEFT_ARROWMove Cursortext.move
RIGHT_ARROWMove Cursortext.move
Ctrl+LEFT_ARROWMove Cursortext.move
Ctrl+RIGHT_ARROWMove Cursortext.move
UP_ARROWMove Cursortext.move
DOWN_ARROWMove Cursortext.move
PAGE_UPMove Cursortext.move
PAGE_DOWNMove Cursortext.move
Ctrl+HOMEMove Cursortext.move
Ctrl+ENDMove Cursortext.move
Shift+HOMEMove Selecttext.move_select
Shift+ENDMove Selecttext.move_select
Shift+LEFT_ARROWMove Selecttext.move_select
Shift+RIGHT_ARROWMove Selecttext.move_select
Ctrl+Shift+LEFT_ARROWMove Selecttext.move_select
Ctrl+Shift+RIGHT_ARROWMove Selecttext.move_select
Shift+UP_ARROWMove Selecttext.move_select
Shift+DOWN_ARROWMove Selecttext.move_select
Shift+PAGE_UPMove Selecttext.move_select
Shift+PAGE_DOWNMove Selecttext.move_select
Ctrl+Shift+HOMEMove Selecttext.move_select
Ctrl+Shift+ENDMove Selecttext.move_select
DELDeletetext.delete
BACK_SPACEDeletetext.delete
Shift+BACK_SPACEDeletetext.delete
Ctrl+DELDeletetext.delete
Ctrl+BACK_SPACEDeletetext.delete
INSERTToggle Overwritetext.overwrite_toggle
LEFTMOUSEScrollbartext.scroll_bar
MIDDLEMOUSEScrollbartext.scroll_bar
MIDDLEMOUSEScrolltext.scroll
TRACKPADPANScrolltext.scroll
LEFTMOUSESet Selectiontext.selection_set
LEFTMOUSESet Cursortext.cursor_set
Shift+LEFTMOUSESet Selectiontext.selection_set
WHEELUPMOUSEScrolltext.scroll
WHEELDOWNMOUSEScrolltext.scroll
RETLine Breaktext.line_break
NUMPAD_ENTERLine Breaktext.line_break
Ctrl+Alt+Shift+Cmd+TEXTINPUTLine Numbertext.line_number
RIGHTMOUSECall Menuwm.call_menu
Ctrl+Alt+Shift+Cmd+TEXTINPUTInserttext.insert
Sneltoetsen — Text Generic TEXT_EDITOR / WINDOW
ToetsActieOperator
Ctrl+TContext Togglewm.context_toggle
Ctrl+FFindtext.start_find
Ctrl+JJumptext.jump
Ctrl+GFind & Set Selectiontext.find_set_selected
Ctrl+HReplacetext.replace
Uitleg · 45.7

Veelvoorkomend: 'Register' en waarom je hem met opzet negeert

7/8

Een Register-script draait automatisch zodra iemand het .blend-bestand opent — handig voor een bestand dat bij het laden bv. een custom operator moet aanmelden, maar ook een reëel beveiligingsrisico: een gedeeld .blend-bestand kan zo willekeurige code laten draaien zonder dat je het doorhebt. Blender toont daarom bij het openen van een bestand met auto-run scripts een duidelijke waarschuwing, en de Preferences-optie 'Auto Run Python Scripts' staat bewust standaard aan noch onbeperkt vertrouwd — controleer bij een bestand van onbekende herkomst eerst de inhoud van elke geregistreerde tekst voor je hem vertrouwt.

Het blauwe schild-icoon naast de bestandsnaam is de Register-toggle — hier aan, dus dit script draait automatisch mee bij het openen van het bestand.RECBLENDER 5.1 · D45-TEXTEDITOR-MASTER00:00:00:00135×65
shot-d45-texteditor-masterHet blauwe schild-icoon naast de bestandsnaam is de Register-toggle — hier aan, dus dit script draait automatisch mee bij het openen van het bestand.
Zelf doen · 45.8

Zelf proberen: een script schrijven en uitvoeren

8/8

Open start_text_editor.blend met een leeg Text-datablock.

  1. 1Typ een klein script: import bpy, gevolgd door bpy.ops.mesh.primitive_cube_add().
  2. 2Voer het uit met Alt+P en controleer dat er een kubus verschijnt in de 3D-viewport.
  3. 3Open de systeemconsole (Window-menu) om te zien of er iets naar de console geschreven wordt.
  4. 4Sla de tekst extern op via Text → Save As als een .py-bestand.
Gelukt als…Een werkend, uitvoerbaar script binnen het .blend-bestand, ook als los .py-bestand bewaard.
Sleep om rond te draaien
001
start_text_editor.blend
VoorbeeldKubusObject13 materialen1.122 vertices