> 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/slice-image.md).

# Slice Image

Esta función divide una imagen de entrada en una cuadrícula de sub-imágenes más pequeñas. Úsala para partir imágenes grandes en mosaicos para análisis individual, procesamiento en paralelo o para generar galerías de imágenes.

## 📥 Entradas <a href="#inputs" id="inputs"></a>

`Image Any` - Imagen principal que se desea dividir.

`Horizontal Percentage` - Número de cortes horizontales (columnas). Si está vacío, por defecto es 1.

`Vertical Percentage` - Número de cortes verticales (filas). Si está vacío, por defecto es 1.

## 📤 Salidas <a href="#outputs" id="outputs"></a>

`Image Any` - La imagen principal con pistas visuales opcionales (igual que la entrada o una versión anotada).

`Sliced Images` - Lista de sub-imágenes generadas (cada mosaico de la cuadrícula).

`Sliced Coordinates` - Lista de coordenadas de rectángulos para cada corte (útil para mapear resultados a la imagen original).

## 🕹️ Controles <a href="#controls" id="controls"></a>

Este bloque usa las entradas mencionadas arriba como parámetros ajustables. Proporciona valores para `Horizontal Percentage` y `Vertical Percentage` para controlar la disposición de la cuadrícula.

## ⚙️ Mecanismo de funcionamiento <a href="#running-mechanism" id="running-mechanism"></a>

* Al ejecutarse, el bloque lee la `Image Any` proporcionada y los dos valores de número de cortes.
* Divide la imagen en una cuadrícula usando el número especificado de columnas y filas.
* El bloque devuelve la imagen completa, una lista de imágenes de cada slice (en orden de lectura) y las coordenadas de cada slice para que puedas relacionar detecciones con la imagen original.

## ✨ Características <a href="#features" id="features"></a>

* División por cuadrícula sencilla sin necesidad de recorte manual.
* Devuelve tanto las imágenes cortadas como sus coordenadas para procesamiento posterior.
* Funciona con cualquier tamaño de imagen; los cortes se calculan para cubrir el área de manera uniforme.

## 📝 Instrucciones de uso <a href="#usage" id="usage"></a>

1. Conecta un productor de imágenes (cámara, cargador de archivos, etc.) a `Image Any`.
2. Ajusta el número deseado de columnas mediante `Horizontal Percentage`.
3. Ajusta el número deseado de filas mediante `Vertical Percentage`.
4. Ejecuta el escenario: el bloque emitirá las imágenes en mosaico y sus coordenadas para procesamiento adicional.

## 💡 Consejos y trucos <a href="#tips-and-tricks" id="tips-and-tricks"></a>

* Combínalo con `Show Image` para previsualizar rápidamente los mosaicos individualmente conectando un elemento de `Sliced Images` a un flujo de visualización.
* Usa `Image Resize` o `Image Resizer` antes de dividir si necesitas tamaños de mosaico uniformes o quieres reducir el tiempo de procesamiento.
* Alimenta cada mosaico a bloques de detección como `Find Object`, `Object Detection` o `Mask Detection` para análisis por mosaico y luego usa `Sliced Coordinates` para mapear los resultados a la imagen original.
* Tras el procesamiento por mosaicos, utiliza `Collage Images` o `Image Concatenate` para crear un resumen visual único a partir de los mosaicos procesados.
* Para guardar resultados por mosaico, conecta `Sliced Images` a `Image Logger` o `Multi Image Write` para una exportación organizada.

(sugerencia) Si solo necesitas una región en vez de una cuadrícula, considera usar `Image ROI Select` o `Image ROI` antes de dividir para limitar el área.

## 🛠️ Solución de problemas <a href="#troubleshooting" id="troubleshooting"></a>

* Si los mosaicos aparecen distorsionados o inesperados, prueba a agregar `Image Resize` antes del bloque para forzar dimensiones de origen consistentes.
* Si recibes menos mosaicos de los esperados, verifica que `Horizontal Percentage` y `Vertical Percentage` estén configurados como enteros mayores que 0.
* Si los detectores posteriores pierden objetos en los bordes de los mosaicos, añade un pequeño solapamiento redimensionando o pre-recortando con `Image ROI` y luego divide; así los objetos que cruzan límites estarán capturados en al menos un mosaico.
