Nœud Format String

Le nœud Format String insère les valeurs dans une chaîne en utilisant une syntaxe de format de chaîne compatible Python ou la syntaxe Spécificateur de format de Blender.

Ce nœud simplifie la construction de chaînes, permettant à la combinaison des valeurs de combiner et de formater sans convertir des nombres en chaînes ou en utilisant plusieurs nœuds de concaténation.

Voir aussi

Références de syntaxe Python : - Python Format String Syntax - {fmt} Format String Syntax

Inputs

Format

Une chaîne utilisant soit le style de format python, soit le spécificateur de format de Blender. Par exemple, Count: {} insère la première valeur en entrée à la place de {}.

Des valeurs d’entrée supplémentaires (Float, Integer ou String) peuvent être gérées dans la liste Format Items de la barre latérale.

Propriétés

Format Items

Une list view pour gérer la liste dynamique des entrants utilisés dans la chaîne de format. Chaque entrée correspond à une valeur quipeut être insérée dans le format à l’aide d’un espace réservé. Voir Input Naming Behavior pour comprendre comment les entrées doivent être nommées.

Socket Type

Le type de valeur pour cette entrée :

Float:

Un nombre à virgule flottante (par exemple 3.14).

Integer:

Un nombre entier (par exemple 42).

String:

Une chaîne de texte.

Outputs

String

La chaîne formatée.

Notes

• Prend en charge à la fois les espaces réservés sans nom ({}) et nommés ({nom}). Cependant, tous les espaces réservés sans nom doivent apparaître devant tous ceux nommés.

• Seules les entrées flottantes, entières et de chaîne sont prises en charge.

• Les conversions de style python telles que !r ne sont pas prises en charge.

• L’accès sous-attribuant (par exemple {vector.x}) n’est pas pris en charge.

• Le formatage basé sur le pourcentage (par exemple %d, %s) n’est pas pris en charge.

• Les spécificateurs de formulaires alternatifs utilisant # (par exemple {:#x}) ne sont pas pris en charge.

• Le formatage basé sur les paramètres régionaux utilisant L (comme dans la bibliothèque fmt) n’est pas pris en charge.

• Le regroupement des options comme des milliers de séparateurs (par exemple {:,} or {:_}) ne sont pas pris en charge.

Comportement de dénomination en entrée

Chaque entrée doit avoir un nom d’identifiant unique et valide utilisé dans les espaces réservés (par exemple {value}). Ce nœud utilise une logique spéciale pour attribuer automatiquement des noms aux nouvelles entrées :

• Si connectée, le premier caractère du nom de la prise lié est utilisé.

• Sinon, les noms par défaut des lettres a à z.

• Si nécessaire, le nom de socket d’origine est converti en un identifiant valide.

• Si tout le reste échoue, un suffixe unique est ajouté (par exemple _001, _002).

Important

Les noms des entrées doivent être des identifiants valides et doivent être uniques. Si un nom n’est pas valide, l’opération de format peut échouer ou produire une sortie incorrecte.

Exemples

Basic

• Format: Count: {}

• Inputs: Entier avec valeur 5

• Result: Count: 5

Plusieurs valeurs

• Format: X: {}, Y: {}

• Inputs: Float 1.5, Float 2.0

• Result: X: 1.5, Y: 2.0

Entrées nommées

• Format: Size: {width} x {height}

• Inputs: width=1920, height=1080

• Result: Size: 1920 x 1080

Padded Numbers (Nombres avec un certain nombre de chiffres)

• Format: Frame_{:04}

• Inputs: Integer 12

• Result: Frame_0012

Format de nombre (modèle de style)

• Format: ##.00

• Input: Float 3.1415

• Result: 03.14

Chemin avec Frame Number

• Format: /output/image_{:04}.png

• Input: Integer 42

• Result: /output/image_0042.png