Nodo Formatear cadena

The Format String node inserts values into a string using either a Python compatible string format syntax or Blender’s format specifier syntax.

This node simplifies string construction, allowing values to be combined and formatted without converting numbers to strings or using multiple concatenate nodes.

Ver también

Python Syntax references: - Python Format String Syntax - {fmt} Format String Syntax

Entradas

Formato

A string using either python format style or Blender’s format specifier. For example, Count: {} inserts the first input value in place of the {}.

Additional input values (Float, Integer, or String) can be managed in the Format Items list in the sidebar.

Propiedades

Elementos de formato

A list view. to manage the dynamic list of inputs used in the format string. Each entry corresponds to a value that can be inserted into the format using a placeholder. See Input Naming Behavior to understand how inputs must be named.

Tipo de conector

El tipo de valor para esta entrada:

Decimal:

Un número decimal (p.ej: 3.14).

Entero:

Un número entero (p.ej: 42).

Cadena de texto:

Una cadena de texto.

Salidas

Cadena de texto

La cadena formateada.

Notas

• Soportará marcadores de posición tanto sin nombre ({}) como con nombre ({nombre}). Sin embargo, todos los marcadores sin nombre deberán aparecer antes que los que tengan nombre.

• Sólo se soportan entradas de tipo decimal, entero y cadena.

• Las conversiones de estilo Python, tales como !r no están soportadas.

• El acceso a sub atributos (p.ej: {vector.x}) no está soportado.

• El formateo basado en porcentajes (p.ej: %d, %s) no está soportado.

• Los especificadores de formas alternativas que utilicen # (p.ej: {:#x}) no están soportados.

• El formateo basado en localización utilizando L (tal como en la biblioteca fmt) no está soportado.

• Las opciones de agrupamiento tales como los separadores de miles (p.ej: {:,} o {:_}) no están soportadas.

Comportamiento de nomenclatura de entrada

Each input must have a unique, valid identifier name used in placeholders (e.g. {value}). This node uses special logic to automatically assign names to new inputs:

• If connected, the first character of the linked socket’s name is used.

• Otherwise, names default to letters a through z.

• If needed, the original socket name is converted to a valid identifier.

• If all else fails, a unique suffix is appended (e.g. _001, _002).

Importante

Input names must be valid identifiers and must be unique. If a name is invalid, the format operation may fail or produce incorrect output.

Ejemplos

Básicos

• Formato: Cantidad: {}

• Entradas: Entero con un valor de 5

• Resultado: Cantidad: 5

Valores múltiples

• Formato: X: {}, Y: {}

• Entradas: Decimal 1.5, Decimal 2.0

• Resultado: X: 1.5, Y: 2.0

Entradas con nombre

• Formato: Tamaño: {ancho} x {altura}

• Entradas: ancho=1920, altura=1080

• Resultado: Tamaño: 1920 x 1080

Relleno numérico

• Formato: Fotograma_{:04}

• Entradas: Entero 12

• Resultado: Fotograma_0012

Formato numérico (de tipo plantilla)

• Formato: ##.00

• Entrada: Decimal 3.1415

• Resultado: 03.14

Ruta con número de fotograma

• Formato: /salida/imagen_{:04}.png

• Entrada: Entero 42

• Resultado: /salida/imagen_0042.png