> For the complete documentation index, see [llms.txt](https://docs.augelab.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.augelab.com/spanish/function-blocks/blocks-reference/image-transformations/operations/image-padding.md).

# Image Padding

Esta función añade un borde de color constante (padding) alrededor de una imagen. Úsala para crear márgenes, unificar tamaños de imagen o preparar imágenes para concatenación y maquetación sin alterar el contenido original.

## 📥 Entradas

`Input Image` La imagen a la que se aplicará el padding.

`Padding Size` Número que indica cuántos píxeles añadir (se aplica según el lado seleccionado).

`Color` Valor de color de píxel (B, G, R) usado para rellenar el padding. Si no se proporciona, se usa negro.

## 📤 Salidas

`Padded Image` La imagen resultante con el padding añadido.

## 🕹️ Controles

`Padding Side`\
Selecciona en qué lado(s) se aplicará el padding. Opciones disponibles:

* `ALL`
* `VERTICAL`
* `HORIZONTAL`
* `LEFT`
* `RIGHT`
* `TOP`
* `BOTTOM`

Este control determina dónde se añaden los píxeles de padding respecto a la imagen de entrada.

## 🎨 Características

* Borde de color fijo aplicado alrededor de la imagen.
* Selección flexible de lados para añadir padding solo donde se necesite.
* Acepta un color de píxel de entrada para que el padding coincida con fondos o resalte márgenes.

## 📝 Instrucciones de uso

1. Proporciona una imagen en `Input Image`.
2. Introduce el número de píxeles en `Padding Size` para definir el ancho del borde.
3. Opcional: suministra un color en `Color` (formato: (Blue, Green, Red)). Si queda vacío, el padding será negro.
4. Selecciona el lado deseado con `Padding Side` y ejecuta el escenario para obtener `Padded Image`.

## 📊 Evaluación

Al ejecutarse, este bloque devuelve la imagen con el padding aplicado según el lado, tamaño y color seleccionados. Usa la salida directamente en bloques posteriores para visualización o procesamiento.

## 💡 Consejos y trucos

* Para que varias imágenes compartan el mismo lienzo visual, primero usa `Image Resize` para igualar alturas o anchuras, luego este bloque para añadir padding simétrico y que todas se alineen.
* Si quieres centrarte en una región recortada y luego añadir un fondo, combina `Image ROI Select` (para recortar) → este bloque (para añadir borde) → `Show Image` para previsualizar el resultado.
* Para crear márgenes antes de combinar imágenes lado a lado, añade padding y luego usa `Image Concatenate` o `Collage Images` para ensamblar un diseño limpio.
* Usa `Make Image` para crear un fondo coloreado y emplea este bloque cuando necesites márgenes que coincidan con un color específico.
* Guarda resultados con padding automáticamente conectando `Padded Image` a `Image Logger` o `Image Write`.

(hint) Al proporcionar el color, recuerda que el sistema espera valores de píxel en orden BGR.

## 🛠️ Solución de problemas

* Si el padding aparece en un color inesperado, confirma que el valor en `Color` está dado como (Blue, Green, Red) y que los valores están entre 0–255.
* Si no se aprecia ningún cambio, asegúrate de que `Padding Size` es mayor que cero y que la opción correcta de `Padding Side` está seleccionada.
* Al combinar muchas imágenes tras aplicar padding, verifica la alineación final con `Show Image` para comprobar espaciados y consistencia de bordes.