File Paths (Chemins de fichiers)

Modèles de chemin d’accès

Les modèles de chemin d’accès remplacent les template expressions (written {abcd}, où “abcd” est un nom de variable) dans un chemin de fichier lorsque le chemin est utilisé.

Par exemple, si le fichier blend actuellement ouvert est dance.blend et que le chemin de sortie du rendu est défini sur :

//my_render_dir/{blend_name}.png

Alors, lors du rendu, Blender traitera le chemin comme :

//my_render_dir/dance.png

Avec {blend_name} remplacé par dance de dance.blend.

Cette substitution se produit en interne au moment de l’utilisation (par exemple pendant le rendu), de sorte que la syntaxe du modèle restera telle quelle dans le champ du chemin.

Note

Actuellement, les modèles de chemin ne sont pris en charge que pour le chemin de sortie de rendu dans les propriétés de scène et les chemins de sortie dans le nœud File Output du compositeur. D’autres chemins d’accès aux fichiers prendront en charge les modèles dans les versions futures.

Variables disponibles

Les variables suivantes sont actuellement disponibles dans les expressions modèles.

Disponibles dans tous les chemins d’accès qui prennent en charge les expressions modèles :

blend_name:

Le nom du fichier blend actuellement ouvert (sans le fichier .blend).

blend_dir:

Chemin d’accès jusqu’au fichier blend actuellement ouvert (mais sans l’inclure).

blend_name_lib:

Comme blend_name, sauf que pour les propriétés de chemin sur les blocs de données liés à une bibliothèque, ce sera le nom du fichier blend de bibliothèque d’où provient le bloc de données.

blend_dir_lib:

Comme blend_dir, sauf que pour les propriétés de chemin sur les blocs de données liés à une bibliothèque, ce sera le chemin d’accès au fichier blend de bibliothèque d’où provient le bloc de données.

Disponible uniquement dans les chemins de sortie de rendu (y compris dans le nœud File Output du compositeur) :

fps:

Les cadres par seconde de la scène actuelle.

resolution_x / resolution_y:

La résolution X et Y de l’image rendue. Ces facteurs également dans l’échelle de résolution, donc si la résolution de la scène est de 1000x600 et que l’échelle est de 50%, alors resolution_x et resolution_y seront respectivement de 500 et 300.

scene_name:

Nom de la scène actuelle.

camera_name:

Nom de la caméra de rendu actuelle.

Disponible uniquement dans les propriétés du chemin d’un nœud :

node_name:

Le nom du nœud sur lequel se trouve la propriété du chemin.

Syntaxe

Une expression modèle de base enveloppe simplement un nom de variable avec des accolades { } :

dance_{fps}.png

Spécificateurs de format

Les expressions modèle peuvent également inclure un spécificateur de format. Les spécificateurs de format instruisent Blender comment formater la valeur substituée. Elles sont écrites après deux-points de séparation, comme ceci :

dance_{fps:FORMAT}.png

À l’heure actuelle, les spécificateurs de format ne peuvent être utilisés qu’avec des variables qui représentent des valeurs numériques, et non des valeurs de chaîne. Les spécificateurs de format disponibles sont les suivants :

• dance_{fps:###}.png: format entier avec au moins 3 chiffres.

• dance_{fps:.###}.png: format nombre à virgule flottante avec exactement 3 chiffres après la virgule.

• dance_{fps:###.##}.png: format nombre à virgule flottante avec au moins 3 chiffres pour la partie entière et exactement 2 chiffres pour la partie fractionnaire.

Dans tous les cas, le nombre de symboles dièses (#) indique le nombre de chiffres souhaité.

Par exemple, si fps est de 29,97, alors :

• dance_{fps:###}.png -> dance_030.png

• dance_{fps:.###}.png -> dance_29.970.png

• dance_{fps:###.##}.png -> -> dance_029.97.png

Notez que les valeurs sont correctement arrondies pour le nombre de chiffres donné.

Si aucune spécification de format n’est donnée, le formatage par défaut de la variable nommée est utilisé (par exemple, virgule flottante pour fps, entier pour la résolution).

Séquences d’échappement

Étant donné que { et } sont utilisés pour les expressions de modèle dans les chemins qui les prennent en charge, lorsqu’un { or } littéral est souhaité dans un tel chemin, ils doivent être échappés en les écrivant en double :

• {{ translates to a single { dans le chemin final.

• }} translates to a single } dans le chemin final.

Par 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

Erreurs

Les chemins d’accès qui prennent en charge les modèles peuvent comporter des erreurs de modèle, ce qui empêche le traitement du chemin d’accès.

Par exemple, dans le chemin suivant :

//my_render_dir/{blend_name.png

L’expression {blend_name n’est pas correctement fermée, ce qui entraînera une erreur.

Lorsqu’il y a des erreurs de modèle dans un chemin, le champ du chemin d’accès est mis en surbrillance en rouge dans l’interface utilisateur :

En survolant le champ du chemin, une info-bulle contenant la liste des erreurs de modèle rencontrées dans ce chemin d’accès s’affiche :

Note

Selon le chemin d’accès, des erreurs de modèle peuvent empêcher certaines actions. Par exemple, s’il y a des erreurs dans le chemin de sortie de rendu, le rendu d’une animation échouera avec un message d’erreur indiquant les erreurs de chemin.