Devuelve la version de Designer, el grafo y paquete activos y las herramientas detectadas. Requiere Designer abierto.

Lista los paquetes abiertos y sus grafos de composicion. Oculta las bibliotecas de Adobe.

Abre un grafo en el editor. file_path carga antes un .sbs de una carpeta permitida; package es un uid o ruta.

Crea un grafo de composicion y lo abre. Sin package crea un paquete nuevo sin guardar.

width y height son el tamano en Designer, en potencias de 2. No viajan al .sbsar: al renderizar, indicalos otra vez en render_outputs. format: 8_bits_per_channel, 16_bits_per_channel, hdr_low_precision o hdr_high_precision.

Lista nodos, frames y comentarios de un grafo (por defecto, el activo).

Devuelve id, definicion, entradas, salidas, parametros con sus valores y conexiones de un nodo.

Crea un nodo. Indica definition para nodos atomicos (p. ej. sbs::compositing::blend) o library para filtros de la biblioteca de Adobe (p. ej. noise_perlin_noise), con library_graph si el paquete contiene varios. Devuelve el id del nodo.

Borra un nodo y sus conexiones.

Conecta una salida con una entrada. Sin from_output usa la primera salida. get_node_info muestra los ids.

Cambia un parametro del nodo. Vectores y colores van como lista; los enums por su id.

$outputsize usa log2: [10, 10] significa 1024x1024.

Lee el valor y el tipo de un parametro de un nodo.

Crea un frame. Agrupa solo visualmente: la API no asocia nodos a frames, asi que colocalo alrededor de ellos.

Crea un comentario suelto o, con node_id, unido a un nodo (x e y son entonces relativas a el).

Ordena los nodos en columnas de izquierda a derecha. Es un layout propio: la API no ofrece uno.

No mueve frames ni comentarios, asi que usalo antes de crear los frames.

Crea un parametro del grafo y, con node_id y node_parameter, hace que controle ese parametro del nodo.

Sin default, un parametro enlazado toma el valor actual del nodo. type: float, float2, float3, float4, color, int, int2, int3, int4, bool o string.

Crea un nodo de salida con usage: baseColor, normal, roughness, metallic, height o ambientOcclusion.

Con source_node lo conecta a esa fuente.

Guarda un paquete. Un paquete nuevo necesita path (.sbs) dentro de una carpeta permitida.

Exporta un paquete abierto a .sbsar desde Designer. Sin Designer abierto, usa cook_sbs.

Cocina un .sbs a .sbsar con sbscooker. No necesita Designer abierto.

Renderiza los mapas de un .sbsar con sbsrender. No necesita Designer abierto.

parameters es {identificador: valor}; los vectores van como lista. Rechaza parametros que el archivo no exponga. bit_depth: 8, 16, 16f o 32f. Indica width y height (potencias de 2): sin ellos, sbsrender usa 256x256, no el tamano del grafo.

Renderiza varios .sbsar con varios juegos de parametros. No necesita Designer abierto.

parameter_sets es una lista de {"name": str, "parameters": {...}}. Los archivos quedan en output_dir//. Un fallo no detiene el resto; revisa "failed" y "jobs". Indica width y height: sin ellos, sbsrender usa 256x256.

Ejecuta codigo Python arbitrario dentro de Designer, en su hilo principal.

REQUIERE CONFIRMACION EXPLICITA: muestra el codigo al usuario y espera su aprobacion antes de llamar con confirmed=true. Puede leer, modificar o borrar cualquier cosa a la que Designer tenga acceso; la restriccion de carpetas permitidas NO aplica dentro de este codigo. Usala solo cuando ninguna otra herramienta sirva. Dispones de sd y app; asigna a result lo que quieras devolver.