Argument på kommandoraden¶

Blender 5.1

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.

Du kan använda funktioner för sökvägsmallar som {blend_name} i sökvägen. Se Blenders dokumentation om sökvägsmallar för mer information.

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>

Set the render format. Valid options are: TGA RAWTGA JPEG IRIS 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: Force opening with borders, in a normal (non maximized) state.
-M, --window-maximized: Kraftöppning maximerad.
-W, --window-fullscreen: Force opening full-screen.
-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>.
-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-frame: Disable all window decorations (Linux only).
--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.

The expression may be a complete multi-line script; you are limited only by the platform’s maximum argument length.

--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>

Enable logging categories, taking a single comma separated argument.

--log "*": everything --log "event": every category starting with event. --log "render,cycles": both render and cycles messages. --log "*mesh*": every category containing mesh sub-string. --log "*,^operator": everything except operators, with ^prefix to exclude.

--log-level <nivå>

Set the logging verbosity level.

fatal: Fatal errors only error: Errors only warning: Warnings info: Information about devices, files, configuration, operations debug: Verbose messages for developers trace: Very verbose code execution tracing

--log-show-memory

Show memory usage for each log message.

--log-show-source

Show source file and function name in output.

--log-show-backtrace

Visa en backspårning för varje loggmeddelande (endast debug-versioner).

--log-file <filsökväg>

Ange en fil att mata ut loggen till.

--log-list-categories

List all available logging categories for --log, and exit.

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-handlers

Aktivera felsökningsmeddelanden för händelsehantering.

--debug-libmv

Aktivera felsökningsmeddelanden från libmv-biblioteket.

--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-shader-debug-info

Enable shader debug info generation (Vulkan only).

--debug-gpu-scope-capture

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

--debug-gpu-shader-source

Save the compiled GPU shader source code for the given shader name. The given name can contain leading or trailing wildcard ”*” to match multiple shaders. Files are saved in the current working directory inside a directory named ”Shaders”.

--debug-gpu-shader-no-preprocessor

Skip preprocessor pass and rely on driver or shader compiler preprocessor instead. Also disable dead code elimination.

--debug-gpu-shader-no-dce

Skip dead code elimination pass.

--debug-gpu-no-texture-pool

Disable memory aliasing optimizations in the GPU texture pool.

--debug-gpu-renderdoc

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

--debug-gpu-vulkan-local-read

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

--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.

--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, metal, opengl.

--gpu-vsync

Set the VSync. Valid options are: on, off & auto for adaptive sync.

The default settings depend on the GPU driver.
Disabling VSync can be useful for testing performance.
auto is only supported by the OpenGL backend.

--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).

--qos <level>

Set the Quality of Service (QoS) mode for hybrid CPU architectures (Windows only).

default: Uses the default behavior of the OS. high: Always makes use of performance cores. eco: Schedules Blender threads exclusively to efficiency cores.

-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 beroendediagram systematiskt när en blend-fil 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 blandningsfil.

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-ffmpeg

Enable debug messages from FFmpeg video input and output.

--debug-cycles

Aktivera felsökningsmeddelanden från Cycles.

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.
BLENDER_OCIO:: Path to override the OpenColorIO configuration file. If not set, the OCIO environment variable is used.
SPNAV_SOCKET:: The socket path to connect to the 3D-mouse daemon (Unix only).
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.