Disposició del directori del Blender

Aquesta pàgina documenta els diferents directoris utilitzats pel Blender.

Pot resultar útil per a la resolució de problemes, l’automatització i la personalització.

Directoris d’usuària

Preferències de directoris d’emmagatzament de la usuària, document d’inici, extensions instal·lades, valors predefinits i molt més. Per defecte, utilitzen les carpetes de configuració estàndard per a cada sistema operatiu.

Linux

$HOME/.config/blender/5.3/

Si està consignada la variable d’entorn $XDG_CONFIG_HOME:

$XDG_CONFIG_HOME/blender/5.3/

macOS

/Users/$USER/Library/Application Support/Blender/5.3/

Windows

%USERPROFILE%\AppData\Roaming\Blender Foundation\Blender\5.3\

Instal·lació portable

Quan executeu Blender des d’una unitat portàtil, és factible de mantenir els documents de configuració a la mateixa unitat per portar-los sempre al damunt.

Per habilitar-ho, creeu una carpeta anomenada portable a les ubicacions següents:

  • Windows: al costat de l’executable de Blender, a la carpeta descomprimida

  • Linux: al costat de l’executable de Blender, a la carpeta descomprimida

  • macOS: dins del paquet d’aplicacions de Blender.app/Contents/Resources

Aleshores, aquesta carpeta emmagatzemarà les preferències, el document d’inici, les extensions instal·lades i els valors predefinits.

Variables d’entorn

La variable d’entorn BLENDER_USER_RESOURCES es pot consignar a un directori personalitzat per substituir el directoris d’usuària per defecte.

Directoris de sistema

Els directoris del sistema emmagatzemen documents que s’inclouen amb Blender i són necessaris perquè funcioni. Això inclou protocols, predeterminats, recursos essencials i altres coses.

Linux

Document descarregat de blender.org:

./5.3/

Paquets de distribució de Linux:

/usr/share/blender/5.3/

macOS

./Blender.app/Contents/Resources/5.3/

Windows

Document zip descarregat de blender.org:

./5.3/

Instal·lador descarregat de blender.org:

%ProgramFiles%\Blender Foundation\Blender\5.3\

Instal·lació des de la Botiga de Microsoft:

%ProgramFiles%\WindowsApps\BlenderFoundation.Blender<HASH>\Blender\5.3\

Variables d’entorn

Les variables d’entorn BLENDER_SYSTEM_SCRIPTS i BLENDER_SYSTEM_EXTENSIONS es poden usar per agregar protocols i extensions addicionals que no formin part de la instal·lació normal de Blender.

Altres variables d’entorn BLENDER_SYSTEM poden sobreseure altres rutes del sistema, encara que a la pràctica no se solguin utilitzar.

Disposició de rutes

./autosave

Ubicació d’autodesat del document blend. (sols Windows, directori temporal utilitzat per a altres sistemes.)

Ubicat en directoris de la usuària.

./config

Configuració d’usuària i info de la sessió.

Ubicat en directoris de la usuària.

./config/startup.blend

Document blend per defecte que es carrega en iniciar.

./config/userpref.blend

Preferències d’usuària.

./config/bookmarks.txt

Adreces d’interès del navegador de documents.

./config/recent-files.txt

Llista de menú de documents recents.

./config/{APP_TEMPLATE_ID}/startup.blend

Document d’inici per a una plantilla d’aplicació.

./config/{APP_TEMPLATE_ID}/userpref.blend

Document de preferències d’usuària per a una plantilla d’aplicació.

./datafiles

Documents de dades carregats durant l’execució.

Situat tant als directoris d’usuàries com del sistema. Els document de dades d’usuària sobreseuen o suplementen els documents de dades del sistema.

./datafiles/colormanagement

Configuració predeterminada d’OpenColorIO.

./datafiles/fonts

Fonts de la interfície d’usuària.

./datafiles/studiolights

Imatges de llums d’estudi per al mirador 3D.

./extensions

Repositoris d’extensions.

Situat tant als directoris d’usuàries com del sistema. Els repositoris es carreguen des d’ambdós entorns.

./scripts

Complements, predefinits, plantilles, interfície d’usuària, protocols d’inici.

Situat tant als directoris d’usuàries com del sistema. Els protocols es carreguen des d’ambós entorns.

./scripts/addons/*.py

Els complements de Python que es poden habilitar a les Preferències inclouen el suport per al format d’importació/exportació, la integració del motor de revelat i molts utensilis pràctics.

./scripts/addons/modules/*.py

Mòduls per als complements a utilitzar (afegits al sys.path de Python).

./scripts/addons_core/*.py

El directori de complements que s’utilitza per als complements integrats.

./scripts/addons_core/modules/*.py

Mòduls per a addons_core disponibles (afegits al sys.path de Python, quan hi és).

./scripts/modules/*.py

Mòduls de Python que contenen la nostra API nuclear i funcions d’utensilis per a altres protocols per importar (afegit a sys.path de Python).

./scripts/startup/*.py

Protocols que s’importen automàticament a l’inici.

./scripts/startup/bl_app_templates_user/{APP_TEMPLATE_ID}

Plantilles d’aplicació instal·lades en els directoris d’usuària.

./scripts/startup/bl_app_templates_system/{APP_TEMPLATE_ID}

Plantilles d’aplicació instal·lades automàticament des dels directoris del sistema.

./scripts/presets/{preset}/*.py

Predefinits emprats per emmagatzemar la configuració definida per la usuària per a tela, formats de revelat, etc.

./scripts/templates_py/*.py

Exemple de protocols als quals es pot accedir des d'Editor de text ‣ Plantilles ‣ Python.

./scripts/templates_osl/*.osl

Exemple d’aspectors OSL als quals es pot accedir des d'Editor de text ‣ Plantilles ‣ Llenguatge d’aspecció obert (OSL).

./python

Distribució de Python integrada.

Ubicat en directoris del sistema.

Directori local de memòria cau

El directori de la memòria cau s’utilitza per emmagatzemar localment les memòries cau persistents. Actualment només s’utilitza per a la indexació de Biblioteques de recursos. No s’espera que el sistema operatiu ho retiri automàticament.

S’utilitzarà la ruta següent:

  • Linux:

    $XDG_CACHE_HOME/blender/ si $XDG_CACHE_HOME està definit, altrament $HOME/.cache/blender/

  • macOS:

    /Library/Caches/Blender/

  • Windows:

    %USERPROFILE%\AppData\Local\Blender Foundation\Blender\Cache\

Directori temporal

El directori temporal s’utilitza per emmagatzemar diversos documents en temps d’execució (incloent-hi capes de revelat, la memòria cau de física, la vàlvula de copiar-enganxar registres de fallides).

El directori temporal se selecciona en funció de la prioritat següent:

  • Preferència de la usuària (vegeu Rutes de documents).

  • Variables d’entorn (TEMP a Windows, TMP & TMP_DIR en d’altres plataformes).

  • El directori /tmp/.