Rutes de documents¶

Plantilles de rutes¶

Les Plantilles de rutes substitueixen les expressions de plantilla (escrites {abcd}, on «abcd» és un nom de variable) d’una ruta de documents quan es fa servir la ruta.

Per exemple, si el document blend obert ara mateix és dance.blend i la ruta d’egressió de revelat està posada així:

//my_render_dir/{blend_name}.png

Aleshores en revelar, Blender tractarà la ruta com:

//my_render_dir/dance.png

Amb {blend_name} substituït per el dance provinent de dance.blend.

Aquesta substitució té lloc de forma interna en el moment d’ús (p. ex. en revelar), per la qual cosa la sintaxi de plantilla es mantindrà tal com és al camp de la ruta.

Nota

Actualment, les plantilles de ruta només són compatibles amb la ruta d’egressió de revelat de les propietats d’Escena i amb les rutes d’egressió del node Egressió de document del compositador. En properes distribucions s’aniran afegint més plantilles de rutes compatibles.

Variables disponibles¶

Les següents variables estan ara mateix disponibles per a expressions de plantilla.

Disponibles en totes les rutes que admeten expressions de plantilla:

blend_name:: El nom del document blend presentment obert (sense .blend).
blend_dir:: Ruta fins a (però que no inclou) el document blend actualment obert.
blend_name_lib:: Igual que blend_name, excepte que, en relació amb les propietats de les rutes dels blocs de dades vinculats a la biblioteca, serà el nom del document blend de la biblioteca l’origen del bloc de dades.
blend_dir_lib:: Igual que blend_dir, excepte que, en relació amb les propietats de les rutes dels blocs de dades vinculats a la biblioteca, serà la ruta del document blend de la biblioteca d’origen del bloc de dades.

Disponible només en rutes d’egressió de revelats (incloent-hi en el node Egressió de document del compositador):

fps:: Els fotogrames per segon de l’escena en curs.
resolution_x / resolution_y:: La resolució en x i y de la imatge revelada. Això també aplica a l’escala de resolució, de manera que si la resolució d’escena és 1000x600 i l’escala és del 50%, llavors resolution_x i resolution_y seran 500 i 300, respectivament.
scene_name:: Nom de l’escena en curs.
camera_name:: Nom de la càmera de revelat en curs.

Disponible només a les propietats de rutes d’un node:

node_name:: El nom del node on hi figura la propietat de la ruta.

Sintaxi¶

Una expressió de plantilla bàsica simplement enclou un nom de variable entre claus:

dance_{fps}.png

Especificadors de format¶

Les expressions de plantilla també poden incloure un especificador de format. Els especificadors de format indiquen al Blender com formatar el valor substituït. S’escriuen després d’un signe de dos punts separador, així:

dance_{fps:FORMAT}.png

Els especificadors de format actualment només es poden utilitzar amb variables que representin valors numèrics, no pas valors de cadena. Els especificadors de format disponibles són:

dance_{fps:###}.png: formata com un enter amb almenys 3 dígits.
dance_{fps:.###}.png: formata com un nombre de coma flotant amb exactament 3 dígits després del punt decimal.
dance_{fps:###.##}.png: formata com a nombre de coma flotant amb almenys 3 dígits per a la part entera i exactament 2 dígits per a la part fraccionària.

En tots els casos, el nombre de símbols de quadradet (#) indica el nombre desitjat de dígits.

Per exemple, si els fps són 29.97, llavors:

dance_{fps:###}.png -> dance_030.png
dance_{fps:.###}.png -> dance_29.970.png
dance_{fps:###.##}.png -> -> dance_029.97.png

Tingueu en compte que els valors s’arrodoneixen al nombre de dígits que pertoca.

Si no s’aporta cap especificació de format, s’utilitza la formatació predeterminada per a la variable anomenada (p. ex. coma flotant per fps, enter per a resolució).

Seqüències d’escapada¶

Com que { i } s’utilitzen per a les expressions de plantilla en les rutes que les admeten, quan es desitja un { o } literal en una ruta així, cal expressar l’escapada escrivint-los per duplicat:

{{ equival a una única { a la ruta final.
}} equival a una única } a la ruta final.

Per exemple:

my_weird}}_{{path.png -> my_weird}_{path.png
//my_render_{{dir}}/{blend_name}.png -> //my_render_{dir}/dance.png
//my_render_dir/{{{blend_name}}}.png -> //my_render_dir/{dance}.png

Errades¶

Les rutes compatibles amb plantilles poden tenir errors de plantilla que bloquegin el processament de la ruta.

Per exemple, en la ruta següent:

//my_render_dir/{blend_name.png

L’expressió {blend_name no està ben tancada, cosa que pot provocar un error.

Quan les rutes pateixen d’errors de plantilla, el camp de la ruta es ressaltarà en vermell a la IU:

../_images/files_file_paths-invalid_path_template.png

Sobrerondant el camp de la ruta farà emergir un consell d’eina que contindrà una llista dels errors de plantilla que s’han trobat en la ruta en qüestió:

../_images/files_file_paths-invalid_path_template_tooltip.png

Nota

Depenent de la ruta, els errors de plantilla poden evitar certes accions. Per exemple, si hi ha errors en la ruta d’egressió de revelat, llavors el revelat d’una animació fallarà amb un missatge d’error que indiqui els errors de ruta.