> 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/detections-shapes/detectors/find-object-multiple-image.md).

# Find Object - Multiple Image

Este bloque de función detecta si una plantilla (objeto) aparece en varias regiones correspondientes de una imagen más grande. Está diseñado para casos en los que tanto la imagen principal como la plantilla se comparan dividiéndolas en una cuadrícula de mosaicos (tiles) y comprobando cada par de mosaicos correspondientes. El bloque ofrece retroalimentación visual marcando los mosaicos que no coinciden y proporciona tanto recuentos como un indicador global de aprobado/reprobado.

## 📥 Entradas

`Main Image`\
Proporcione la imagen en la que desea verificar la presencia del objeto.

`Object Image`\
Proporcione la imagen plantilla que debería estar presente a lo largo de los mosaicos de la imagen principal.

## 📤 Salidas

`Image Any`\
La imagen principal anotada para indicar los mosaicos donde no se encontró la plantilla (retroalimentación visual).

`Match Count`\
El número de mosaicos donde la plantilla se ha emparejado con éxito.

`Matched All`\
Booleano que es TRUE cuando la plantilla se encuentra en todos los mosaicos esperados (según la cuadrícula de slices elegida); de lo contrario FALSE.

## 🕹️ Controles

`Method`\
Elija el método de emparejamiento para controlar cómo se evalúa la similitud entre cada par de mosaicos. Los distintos métodos cambian la sensibilidad y el comportamiento de la coincidencia.

`Match Threshold %`\
Ajuste lo estricta que debe ser la coincidencia. Aumentar el umbral requiere mayor similitud para que un mosaico se considere emparejado.

`Horizontal Slice`\
Indique en cuántos mosaicos se debe dividir la imagen horizontalmente (columnas).

`Vertical Slice`\
Indique en cuántos mosaicos se debe dividir la imagen verticalmente (filas).

## 🎯 Características clave

* Comparación en cuadrícula: divide tanto la imagen principal como la plantilla en el mismo número de mosaicos y compara los mosaicos correspondientes.
* Indicadores visuales de fallo: la imagen de salida se anota para mostrar los mosaicos que no coincidieron (inspección visual sencilla).
* Resumen de coincidencias: devuelve el recuento numérico de mosaicos emparejados y un booleano `Matched All` para saber rápidamente si toda la cuadrícula pasó.
* Sensibilidad y método ajustables: afine el comportamiento de detección usando `Method` y `Match Threshold %`.
* Funciona con múltiples escalas mediante comparación por mosaicos, útil cuando el objeto debe aparecer repetidamente en un diseño estructurado.

## ⚙️ Cómo funciona

Al ejecutar el bloque:

1. Divide tanto `Main Image` como `Object Image` en una cuadrícula definida por `Horizontal Slice` y `Vertical Slice`.
2. Compara cada par de mosaicos correspondientes usando el `Method` seleccionado y el `Match Threshold %`.
3. Marca en la imagen de salida los mosaicos donde no se encontró la plantilla y incrementa un contador de coincidencias para los mosaicos exitosos.
4. Devuelve la imagen anotada, el recuento total de mosaicos emparejados y un booleano que indica si todos los mosaicos coincidieron.

Nota: Para resultados fiables, las imágenes principal y de plantilla deberían tener escalas y orientación similares para que los mosaicos correspondientes sean comparables.

## 📝 Consejos de uso

* Seleccione `Horizontal Slice` y `Vertical Slice` para que coincidan con el enlosado o la disposición esperada del objeto en la `Main Image` (por ejemplo, una cuadrícula 3x3 para nueve posiciones esperadas).
* Aumente `Match Threshold %` para reducir falsos positivos cuando haya ruido de fondo o patrones repetitivos.
* Pruebe diferentes opciones de `Method` si un método produce demasiadas faltas o coincidencias falsas.

## 💡 Tips and Tricks — Combinaciones útiles de bloque

* Si sus imágenes son demasiado grandes o lentas de procesar, use `Image Resizer` antes de este bloque para reducir el tamaño de entrada.
* Use `Image ROI Select` para recortar la `Main Image` al área de interés, de modo que el enlosado solo se aplique donde sea necesario.
* Aplique `Blur` o `Denoising` a la `Main Image` para reducir ruido de alta frecuencia que pueda provocar falsas no coincidencias.
* Ajuste colores o contraste con `Adjust Colors` o `Contrast Optimization` para que el objeto se distinga mejor del fondo.
* Previsualice los resultados enviando la salida anotada a `Show Image`.
* Guarde casos fallidos o la imagen anotada usando `Image Logger` o `Image Write` para revisión offline.
* Para comprobaciones con una sola plantilla (sin enlosado), considere `Find Object` cuando solo necesite verificar una ocurrencia en lugar de una cuadrícula de mosaicos.

(pista: combine los controles y bloques anteriores para construir un flujo de inspección robusto — recorte, preprocesado, comparación y luego registro o visualización de resultados)

## 🛠️ Solución de problemas

* Si el bloque reporta menos coincidencias de las esperadas: verifique que `Horizontal Slice` y `Vertical Slice` coincidan con la forma en que el objeto se repite en la `Main Image`; aumente `Match Threshold %` o pruebe otro `Method`.
* Si el bloque reporta demasiadas coincidencias falsas: aumente `Match Threshold %`, aplique preprocesado como `Image Threshold` o `Blur`, o use `Image Resizer` para alinear escalas.
* Si los conteos de slices no coinciden o la comparación parece inválida: asegúrese de que ambas entradas sean imágenes válidas y que los números de slices sean enteros positivos.
* Si la orientación o escala difiere entre la plantilla y la imagen principal: rote o cambie el tamaño de las entradas para que los mosaicos se alineen, o use `Auto Alignment` / `Image Resizer` antes de ejecutar la comparación.