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

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).

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.

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

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

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

Elimina una capa.

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.

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

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

Modifica una capa de texto existente.

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).

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

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

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.

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

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).

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

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

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

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

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

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

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.

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

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.

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

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

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.

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

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

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.

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

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

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.

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

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).

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

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

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.