Argument på kommandoraden¶

Blender 4.5

Användning: blender [args …] [file] [args …]

Renderingsalternativ¶

-b, --background

Körs i bakgrunden (används ofta för rendering utan användargränssnitt).

Ljudenheten är inaktiverad i bakgrundsläget som standard och kan återaktiveras genom att skicka in -setaudio Default efteråt.

-a, --render-anim

Rendera bildrutor från början till slut (inklusive).

-S, --scene <namn>

Ställ in den aktiva scenen <name> för rendering.

-f, --render-frame <bildruta>

Rendera ramen <frame> och spara den.

+<frame> startram relativ, -<frame> slutram relativ.
En kommaseparerad lista med ramar kan också användas (inga mellanslag).
Ett antal ramar kan uttryckas med hjälp av .. mellan den första och den sista ramen (inklusive).

-s, --frame-start <bildruta>

Ställ in start till ram <frame>, stöder +/- för relativa ramar också.

-e, --frame-end <bildruta>

Ställ in slutet på ramen <frame>, stöder +/- för relativa ramar också.

-j, --frame-jump <bildrutor>

Ställ in antalet bildrutor som ska stegas framåt efter varje renderad bildruta.

-o, --render-output <sökväg>

Ange sökväg och filnamn för rendering. Använd // i början av sökvägen för att rendera relativt blend-filen.

Tecknen # ersätts av ramnumret och används för att definiera nollutfyllnad.

animation_##_test.png blir animation_01_test.png
test-######.png blir test-000001.png

Om filnamnet inte innehåller # läggs suffixet #### till filnamnet.

Ramnumret kommer att läggas till i slutet av filnamnet, t.ex:

blender -b animation.blend -o //render_ -F PNG -x 1 -a

//render_ blir //render_####, och skriver ramar som //render_0001.png

-E, --engine <motor>

Ange renderingsmotor. Använd -E help för att lista tillgängliga motorer.

-t, --threads <trådar>

Använd mängden <threads> för rendering och andra operationer [1-1024], 0 för att använda systemets processorantal.

Cycles Renderingsalternativ¶

Cycles tilläggsalternativ måste specificeras efter ett dubbelstreck.

--cycles-device <enhet>

Ställ in den enhet som används för rendering. Giltiga alternativ är: CPU CUDA OPTIX HIP ONEAPI METAL.

Lägg till +CPU till en GPU-enhet för att rendera på både CPU och GPU.

Exempel:

blender -b file.blend -f 20 -- --cycles-device OPTIX

--cycles-print-stats

Logga statistik om minnes- och tidsanvändning för rendering.

Alternativ för format¶

-F, --render-format <format>

Ställ in renderingsformatet. Giltiga alternativ är: TGA RAWTGA JPEG IRIS AVIRAW AVIJPEG PNG BMP HDR TIFF.

Format som kan kompileras till Blender, inte tillgängliga på alla system: OPEN_EXR OPEN_EXR_MULTILAYER FFMPEG CINEON DPX JP2 WEBP.

-x, --use-extension <bool>

Ange alternativ för att lägga till filändelsen i slutet av filen.

Alternativ för uppspelning av animationer¶

-a <options> <fil(er)>

Istället för att visa Blenders användargränssnitt körs Blender som en animationsspelare för att visa filmer och bildsekvenser som renderas i Blender (ignoreras om -b är inställt).

Argument för uppspelning:

-p <sx> <sy>: Öppna med nedre vänstra hörnet på <sx>, <sy>.
-m: Läs från disk (buffra inte).
-f <fps> <fps_base>: Ange FPS till att börja med.
-j <frame>: Ställ in ramsteg till <frame>.
-s <frame>: Spela från <frame>.
-e <frame>: Spela tills <frame>.
-c <cache_memory>: Minnesmängd i megabyte för att tillåta cachning av bilder under uppspelning. Zero inaktiverar (fastlåsning till ett fast antal bilder i stället).

Alternativ för fönster¶

-w, --window-border: Kraftöppning med gränser.
-W, --window-fullscreen: Tvinga fram en öppning i helskärmsläge.
-p, --window-geometry <sx> <sy> <w> <h>: Öppna med nedre vänstra hörnet på <sx>, <sy> och bredd och höjd som <w>, <h>.
-M, --window-maximized: Kraftöppning maximerad.
-con, --start-console: Starta med konsolfönstret öppet (ignoreras om -b är inställt), (endast Windows).
--no-native-pixels: Använd inte den ursprungliga pixelstorleken för högupplösta skärmar (MacBook Retina).
--no-window-focus: Öppna bakom andra fönster och utan att ta fokus.

Python-alternativ¶

-y, --enable-autoexec: Aktivera automatisk exekvering av Python-skript.
-Y, --disable-autoexec: Inaktivera automatisk körning av Python-skript (Python-drivare och startskript), (standard).
-P, --python <filsökväg>: Kör den angivna Python-skriptfilen.
--python-text <namn>: Kör det angivna textblocket för Python-skript.
--python-expr <uttryck>: Kör det angivna uttrycket som ett Python-skript.
--python-console: Kör Blender med en interaktiv konsol.
--python-exit-code <kod>: Ställ in exit-koden i [0..255] för att avsluta om ett Python-undantag uppstår (endast för skript som körs från kommandoraden), noll inaktiverar.
--python-use-system-env: Tillåt Python att använda systemmiljövariabler som PYTHONPATH och användarens webbplats-paketkatalog.
--addons <tillägg>: Kommaseparerad lista (inga mellanslag) över tillägg som ska aktiveras utöver standardtilläggen.

Nätverksinställningar¶

--online-mode: Tillåt internetåtkomst genom att åsidosätta inställningen.
--offline-mode: Avvisa internetåtkomst, vilket åsidosätter inställningen.

Alternativ för loggning¶

--log <match>: Aktiverar loggningskategorier, med ett enda kommaseparerat argument. Flera kategorier kan matchas med hjälp av suffixet .*, så –log ”wm.*” loggar alla typer av meddelanden från Window Manager. Delsträngar kan matchas med prefixet och suffixet *, så att –log ”*undo*” loggar alla typer av undorelaterade meddelanden. Använd prefixet ”^” för att ignorera, så –log ”*,^wm.operator.*” loggar allt utom wm.operators.* Använd ”*” för att logga allt.
--log-level <nivå>: Ställ in loggningsnivån (högre för mer information) Standardvärde är 1, använd -1 för att logga alla nivåer.
--log-show-basename: Visa endast filnamnet i utdata (inte den inledande sökvägen).
--log-show-backtrace: Visa en backspårning för varje loggmeddelande (endast debug-versioner).
--log-show-timestamp: Visa en tidsstämpel för varje loggmeddelande i sekunder sedan start.
--log-file <filsökväg>: Ange en fil att mata ut loggen till.

Felsökningsalternativ¶

-d, --debug

Slå på felsökning.

Aktiverar detektering av minnesfel
Inaktiverar musgrepp (för att interagera med en debugger i vissa fall)
Behåller Pythons sys.stdin istället för att sätta den till None

--debug-value <värde>

Ställ in debug-värdet för <value> vid start.

--debug-events

Aktivera felsökningsmeddelanden för händelsesystemet.

--debug-ffmpeg

Aktivera felsökningsmeddelanden från FFmpeg-biblioteket.

--debug-handlers

Aktivera felsökningsmeddelanden för händelsehantering.

--debug-libmv

Aktivera felsökningsmeddelanden från libmv-biblioteket.

--debug-cycles

Aktivera felsökningsmeddelanden från Cycles.

--debug-memory

Möjliggör helt bevakad minnesallokering och felsökning.

--debug-jobs

Aktivera tidsprofilering för bakgrundsjobb.

--debug-python

Aktivera felsökningsmeddelanden för Python.

--debug-depsgraph

Aktivera alla felsökningsmeddelanden från beroendediagrammet.

--debug-depsgraph-eval

Aktivera felsökningsmeddelanden från beroendediagram relaterade till utvärdering.

--debug-depsgraph-build

Aktivera felsökningsmeddelanden från beroendediagram relaterade till diagramkonstruktion.

--debug-depsgraph-tag

Aktivera felsökningsmeddelanden från beroendediagram relaterade till taggning.

--debug-depsgraph-no-threads

Byt beroendediagram till en utvärdering med en enda tråd.

--debug-depsgraph-time

Aktivera felsökningsmeddelanden från beroendediagram relaterade till timing.

--debug-depsgraph-pretty

Aktivera färger för felsökningsmeddelanden för beroendediagram.

--debug-depsgraph-uid

Verifiera giltigheten av sessionsövergripande identifierare som tilldelats ID-datablock.

--debug-ghost

Aktivera felsökningsmeddelanden för Ghost (endast Linux).

--debug-wintab

Aktivera debug-meddelanden för Wintab.

--debug-gpu

Aktivera GPU-felsökningskontext och -information för OpenGL 4.3+.

--debug-gpu-force-workarounds

Aktivera lösningar för typiska GPU-problem och inaktivera alla GPU-tillägg.

--debug-gpu-compile-shaders

Kompilera alla statiskt definierade shaders för att testa plattformskompatibilitet.

--debug-gpu-scope-capture

Fånga de GPU-kommandon som utfärdats inom det angivna scope-namnet.

--debug-gpu-renderdoc

Aktivera RenderDoc-integrering för GPU-ramgrabbing och felsökning.

--debug-wm

Aktivera felsökningsmeddelanden för fönsterhanteraren, visa alla operatorer i sökningen, visa fel i tangentbordet.

--debug-xr

Aktiverar felsökningsmeddelanden för virtuella verklighetssammanhang. Aktiverar valideringslagret för OpenXR API, felsökningsmeddelanden (OpenXR) och utskrifter av allmän information.

--debug-xr-time

Aktivera felsökningsmeddelanden för renderingstider för virtual reality-bilder.

--debug-all

Aktivera alla debug-meddelanden.

--debug-io

Aktivera felsökningsmeddelanden för I/O (Collada, …).

--debug-fpe

Aktivera undantag för flyttal.

--debug-exit-on-error

Avsluta omedelbart när interna fel upptäcks.

--debug-freestyle

Aktivera felsökningsmeddelanden för Freestyle.

--disable-crash-handler

Inaktivera kraschhanteraren.

--disable-abort-handler

Inaktivera avbrottshanteraren.

--verbose <verbose>

Ställ in loggningsnivån för felsökningsmeddelanden som stöder detta.

-q, --quiet

Undertryck statusutskrift (varningar och fel skrivs fortfarande ut).

GPU-alternativ¶

--gpu-backend: Tvinga till användning av en specifik GPU-backend. Giltiga alternativ: vulkan (experimentell), metal, opengl.
--gpu-compilation-subprocesses: Åsidosätt inställningen Max Compilation Subprocesses (endast OpenGL).
--profile-gpu: Aktivera prestandaprofilering för CPU och GPU för GPU-felsökningsgrupper (ger ut en profile.json-fil i spårningshändelseformatet till den aktuella katalogen)

Diverse alternativ¶

--open-last

Öppna den senast öppnade blendfilen, istället för standardstartfilen.

--app-template <mall>

Ställ in applikationsmallen (som matchar katalognamnet), använd default för ingen.

--factory-startup

Hoppa över att läsa startup.blend i användarens hemkatalog.

--enable-event-simulate

Aktivera testfunktionen för händelsesimulering bpy.types.Window.event_simulate.

--env-system-datafiles

Ange miljövariabeln BLENDER_SYSTEM_DATAFILES.

--env-system-scripts

Ställ in miljövariabeln BLENDER_SYSTEM_SCRIPTS.

--env-system-extensions

Ställ in miljövariabeln BLENDER_SYSTEM_EXTENSIONS.

--env-system-python

Ställ in miljövariabeln BLENDER_SYSTEM_PYTHON.

-noaudio

Forcera ljudsystemet till None.

-setaudio

Tvinga ljudsystemet till en specifik enhet. None Default SDL OpenAL CoreAudio JACK PulseAudio WASAPI.

-c, --command <kommando>

Kör ett kommando som förbrukar alla återstående argument. Använd -c help för att lista alla andra kommandon. Passera –help efter kommandot för att se dess hjälptext.

Detta innebär –background-läge.

-h, --help

Skriv ut denna hjälptext och avsluta.

/?

Skriv ut denna hjälptext och avsluta (endast Windows).

-r, --register

Registrera tillägget blend-file för aktuell användare och avsluta sedan (endast Windows & Linux).

--register-allusers

Registrera blend-filtillägget för alla användare och avsluta sedan (endast Windows & Linux).

--unregister

Avregistrera tillägget blend-file för aktuell användare och avsluta sedan (endast Windows & Linux).

--unregister-allusers

Avregistrera blend-file extension för alla användare och avsluta sedan (endast Windows & Linux).

-v, --version

Skriv ut Blender-versionen och avsluta.

--

Avslutar bearbetningen av alternativ, följande argument skickas oförändrade. Åtkomst via Pythons sys.argv.

Andra alternativ¶

--disable-depsgraph-on-file-load

Bakgrundsläge: Bygg och utvärdera inte ViewLayers beroendegrafer systematiskt när en blendfil laddas i bakgrundsläge (alternativen -b eller -c).

Skript som kräver utvärderade data måste då uttryckligen se till att en utvärderad depsgraph finns tillgänglig (t.ex. genom att anropa depsgraph = context.evaluated_depsgraph_get()).

OBS: detta är ett tillfälligt alternativ, i framtiden kommer depsgraph aldrig att genereras automatiskt vid filinläsning i bakgrundsläge.

--disable-liboverride-auto-resync

Utför inte automatisk resynkronisering som åsidosätter biblioteket när du laddar en ny blandfil.

OBS: detta är ett alternativt sätt att få samma effekt som när du ställer in alternativet No Override Auto Resync User Preferences Debug.

--debug-gpu-vulkan-local-read

Tvinga Vulkan dynamisk rendering till lokal läsning när enheten stöder detta.

Parsing av argument¶

Argument måste separeras med vitt utrymme, t.ex:

blender -ba test.blend

…kommer att avsluta eftersom -ba är ett okänt argument.

Argumentordning¶

Argumenten körs i den ordning de anges. t.ex:

blender --background test.blend --render-frame 1 --render-output "/tmp"

…kommer inte att rendera till /tmp eftersom –render-frame 1 renderar innan utgångssökvägen är inställd.

blender --background --render-output /tmp test.blend --render-frame 1

…kommer inte att renderas till /tmp eftersom laddning av blend-filen skriver över den renderingsutgång som ställdes in.

blender --background test.blend --render-output /tmp --render-frame 1

…fungerar som förväntat.

Miljövariabler¶

BLENDER_USER_RESOURCES:: Ersätt standardkatalogen för alla användarfiler. Andra BLENDER_USER_*-variabler åsidosätts när de är inställda.
BLENDER_USER_CONFIG:: Katalog för användarkonfigurationsfiler.
BLENDER_USER_SCRIPTS:: Katalog för användarskript.
BLENDER_USER_EXTENSIONS:: Katalog för användartillägg.
BLENDER_USER_DATAFILER:: Katalog för användardatafiler (ikoner, översättningar, …).
BLENDER_SYSTEM_RESURSER:: Ersätt standardkatalogen för alla medföljande resursfiler.
BLENDER_SYSTEM_SKRIPT:: Kataloger för att lägga till extra skript.
BLENDER_SYSTEM_UTVIDGNINGAR:: Katalog för lagring av systemtillägg.
BLENDER_SYSTEM_DATAFILER:: Katalog för att ersätta medföljande datafiler.
BLENDER_SYSTEM_PYTHON:: Katalog för att ersätta medföljande Python-bibliotek.
BLENDER_CUSTOM_SPLASH:: Fullständig sökväg till en bild som ersätter startskärmen.
BLENDER_CUSTOM_SPLASH_BANNER:: Fullständig sökväg till en bild som ska läggas över på startskärmen.
OCIO:: Sökväg för att åsidosätta konfigurationsfilen för OpenColorIO.
Temporärmapp för snabbfilm:: Spara tillfälliga filer här (MS-Windows).
TMPDIR:: Lagra temporära filer här (UNIX-system). Sökvägen måste referera till en befintlig katalog, annars ignoreras den.