Comprueba la conexión con GIMP (lo arranca si hace falta) y lista las imágenes abiertas.

Lista las imágenes abiertas en GIMP (id, nombre, archivo, tamaño).

Detalle de una imagen: tamaño, modo, resolución, selección y árbol de capas con ids.

Crea una imagen nueva. background: color, 'transparent', 'foreground' o 'background'.

Abre un archivo de imagen (png, jpg, xcf, psd, webp, tif, pdf...) y devuelve su info.

Guarda en formato XCF de GIMP (con capas). Sin path, guarda sobre su archivo .xcf actual.

Exporta la imagen al formato que indique la extensión (png, jpg, webp, gif, tif, bmp, pdf...).

quality (1-100) aplica a jpg/webp. flatten=True une las capas antes de exportar (sobre una copia, la imagen original no cambia).

Cierra una imagen. Por seguridad falla si tiene cambios sin guardar, salvo discard_changes=True.

Duplica una imagen completa (con capas) en una imagen nueva.

Devuelve una vista previa PNG de la imagen (o de una sola capa) para VER el resultado.

Úsala tras cada cambio importante para comprobar que ha quedado bien.

Escala la imagen entera. Indica width y/o height (mantiene proporción si falta uno) o percent.

Cambia el tamaño del lienzo sin escalar el contenido. fill: color para rellenar el espacio nuevo (si no, queda transparente).

Recorta la imagen: a un rectángulo (x,y,width,height), a la selección actual (to_selection) o quitando bordes uniformes (autocrop).

Gira la imagen entera 90/180/270 grados (sentido horario) y/o la voltea.

Convierte el modo de color de la imagen. Para indexed, colors = nº de colores de la paleta.

Crea una capa (o un grupo de capas si group=True). fill: 'transparent' o un color. position 0 = arriba del todo. parent_id: grupo donde meterla.

Inserta otra imagen (logo, foto...) como capa nueva. Sin x/y queda centrada. width/height opcionales para escalarla (si das uno, mantiene proporción).

Cambia propiedades de una capa: nombre, visibilidad, opacidad (0-100), modo de fusión (normal, multiply, screen, overlay, soft-light, hard-light, difference, addition, subtract, darken-only, lighten-only, hue, saturation, color, value...), posición x/y, bloqueo de alfa, o la marca como capa activa (select=True).

Mueve una capa en la pila: raise/lower (un paso), top/bottom, o position (0 = arriba).

Duplica una capa (queda justo encima de la original).

Elimina una capa.

Combina capas: merge_down (la capa con la de debajo), merge_visible (todas las visibles) o flatten (todo en una capa sin transparencia).

Transforma una capa: escalar (px o %), rotar (grados, sentido horario, sobre su centro), voltear, mover a x/y absolutos (esquina superior izquierda), centrar en la imagen (align), o ajustar el tamaño del borde de la capa al de la imagen.

Máscaras de capa: add (white=todo visible, black=todo oculto, selection=desde la selección, alpha, copy, grayscale), apply (aplica y elimina la máscara) o remove (la descarta).

Crea o modifica la selección. rectangle/ellipse/rounded_rectangle usan x,y,width,height (radius para las esquinas); polygon usa points=[x1,y1,x2,y2,...]; from_alpha selecciona lo opaco de layer_id. operation combina con la selección previa. feather difumina el borde (px).

Selecciona por color. Con color: todos los píxeles de ese color. Con x,y: la varita mágica (contiguous=True) o el color de ese punto en toda la imagen. threshold 0-255.

Modifica la selección actual: grow/shrink/border (px), feather (radio px), sharpen (quita difuminado).

Ajusta el contexto de pintura: color de frente/fondo, pincel (nombre), tamaño, opacidad y modo. Sin argumentos devuelve los valores actuales.

Rellena la selección (o la capa entera si no hay selección). fill: 'foreground', 'background', 'white', 'transparent', 'pattern' o un color concreto ('#ff0000').

Dibuja el contorno de la selección actual con el grosor (px) y color indicados.

Pinta un trazo que pasa por points=[x1,y1,x2,y2,...] (coordenadas de imagen) con la herramienta indicada. closed=True cierra el trazo volviendo al primer punto.

Rellena con degradado de (x1,y1) a (x2,y2). Por defecto va de start_color a end_color (o frente→fondo); gradient permite usar un degradado de GIMP por nombre.

Añade una capa de texto editable. (x,y) es la ESQUINA SUPERIOR IZQUIERDA de la capa de texto, no su centro: para centrar usa align='center' (ambos ejes) o 'center_x' (centrado horizontal a la altura y). size en px. box_width fija el ancho de caja para que el texto haga saltos de línea. Usa gimp_list_resources('fonts') para ver fuentes. Comprueba en la respuesta que x+width y y+height no superan el tamaño de la imagen (si no, el texto sale cortado).

Modifica una capa de texto existente.

Lista recursos de GIMP (fuentes, pinceles, degradados, patrones, paletas) filtrando por texto.

Ajustes de color sobre la capa (respetando la selección):

• brightness_contrast: brightness, contrast (-1..1)

• hue_saturation: hue (-180..180), saturation y lightness (-100..100)

• levels: low, high (0..1), gamma (0.1..10) · auto_levels / white_balance: automáticos

• desaturate, invert · threshold: low, high (0..1) · posterize: levels (2..256)

• colorize: color (tono) · color_balance: cyan_red, magenta_green, yellow_blue (-100..100)

• curves: curve_points=[x1,y1,x2,y2,...] en 0..1 (valor) · exposure: exposure (EV)

• color_temperature: temperature (K, <6500 enfría, >6500 calienta)

• shadows_highlights: shadows, highlights (-100..100)

Aplica cualquier filtro GEGL a una capa (respeta la selección). Ejemplos: gegl:gaussian-blur {std-dev-x, std-dev-y} · gegl:unsharp-mask {std-dev, scale} · gegl:dropshadow {x, y, radius, color, opacity} · gegl:pixelize {size-x, size-y} · gegl:noise-reduction {iterations} · gegl:vignette {radius, softness, color} · gegl:cartoon · gegl:emboss · gegl:edge-sobel · gegl:mosaic · gegl:waves · gegl:ripple · gegl:lens-distortion · gegl:bloom · gegl:high-pass · gegl:oilify · gegl:motion-blur-linear {length, angle} · gegl:sepia {scale} · gegl:mono-mixer · gimp:threshold-alpha... Usa gimp_filter_info para ver las propiedades de una operación. non_destructive=True lo deja como filtro editable en vez de fusionarlo con la capa.

Sin operation: lista las operaciones GEGL disponibles que contengan query. Con operation: muestra sus propiedades (nombre, tipo, valor por defecto, rango, descripción).

Busca procedimientos de la PDB de GIMP (incluye plugins y Script-Fu) por nombre.

Muestra los argumentos y valores de retorno de un procedimiento PDB.

Llama a cualquier procedimiento PDB por nombre con argumentos por nombre. Valores especiales: 'image' se rellena con image_id, 'drawable' con layer_id y 'drawables' con [layer_id]; 'run-mode' es NONINTERACTIVE por defecto; 'file' acepta una ruta; colores como texto. Consulta antes gimp_pdb_info.

Ejecuta código Python dentro de GIMP 3 (API GObject: Gimp, Gegl, Gio, GLib ya importados). Asigna la respuesta a la variable result (o usa print). Helpers disponibles: _img(id) imagen, _item(id) capa, _drawable(img, id) capa activa, _color('#hex'), _gegl(drawable, 'gegl:op', {props}), _pdb_run('proc', **args), _image_info(img), _undo(img). Las variables persisten entre llamadas.