> 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.md).
# Find Object
Este bloque de función te ayuda a localizar una imagen plantilla más pequeña dentro de una imagen mayor usando métodos de coincidencia seleccionables y un control deslizante de sensibilidad ajustable. Proporciona retroalimentación visual y salidas detalladas de ubicación para ayudar en inspección, conteo y procesamiento posterior.
## 📥 Entradas
Este bloque acepta las siguientes entradas:
* `Main Image` Acepta la imagen donde se realizará la búsqueda del objeto.
* `Object Image` Acepta la imagen plantilla (única o lista) del objeto a encontrar.
## 📤 Salidas
Este bloque proporciona las siguientes salidas:
* `Image Any` Resultado visual donde se pueden resaltar las coincidencias detectadas.
* `Object Positions` Coordenadas de los centros de los objetos detectados (múltiples).
* `Object Count` Número de objetos detectados.
* `Rectangle Coordinates` Rectángulos delimitadores para cada objeto detectado (múltiples).
## 🕹️ Controles
* `Method` Elige el algoritmo de template matching a utilizar de una lista de métodos disponibles.
* `Match Threshold %` Ajusta el deslizador para controlar qué tan estricta debe ser la coincidencia. Valores más altos reducen falsos positivos pero pueden omitir coincidencias débiles.
* `Result` Muestra la cuenta de objetos detectados para una retroalimentación rápida.
## 🎯 Características clave
* Superposición visual de las detecciones sobre la imagen de entrada para verificación rápida.
* Múltiples conexiones de salida que ofrecen resultados tanto visuales como numéricos para procesamiento posterior.
* Funciona con una única plantilla o con una lista de plantillas para encontrar la mejor coincidencia disponible.
## 📝 Cómo usar
1. Proporciona una imagen fuente en la entrada `Main Image`.
2. Proporciona una plantilla o lista de plantillas en la entrada `Object Image`.
3. Selecciona un `Method` que se adapte a las características de tu escena y plantilla.
4. Ajusta el deslizador `Match Threshold %` hasta que la precisión de detección sea aceptable.
5. Inspecciona los resultados usando la salida visual y los sockets numéricos.
## ⚙️ Qué sucede al ejecutarlo
Al ejecutarse, el bloque busca en la `Main Image` regiones que coincidan con la `Object Image` según el método y el umbral seleccionados. Devuelve una visualización, las posiciones centrales de las detecciones, su conteo y los rectángulos delimitadores.
## 💡 Consejos y trucos
* Para reducir falsas coincidencias en imágenes ruidosas, pasa la imagen por `Blur` o `Denoising` antes de este bloque.
* Si las plantillas y la imagen principal difieren en tamaño, usa `Image Resize` para estandarizar tamaños y obtener coincidencias más fiables.
* Para enfocar la búsqueda solo en un área específica, recorta la imagen primero con `Image ROI Select` y alimenta la imagen recortada a este bloque.
* Después de la detección, usa `Rectangles in Rectangle` para filtrar detecciones fuera de una región de interés.
* Visualiza e inspecciona las detecciones con el bloque `Show Image` para confirmar resultados de forma interactiva.
* Guarda fotogramas interesantes o fallos usando `Image Logger` o `Image Write` para auditoría y ajuste.
* Para escenas complejas o muchas clases de objetos, considera combinar con los bloques `Object Detection` o `Object Detection - Custom` cuando el template matching se vuelva poco fiable.
## 🛠️ Solución de problemas
* Si no se encuentran objetos, intenta bajar el `Match Threshold %` o mejorar el contraste de la plantilla con preprocesos como `Contrast Optimization` o `Adjust Colors`.
* Si aparecen muchos falsos positivos, aumenta el `Match Threshold %` y considera filtrar la imagen con `HSV Filter` o `Image Threshold` para resaltar el objeto.
* Si los resultados varían entre imágenes, asegúrate de que las plantillas sean consistentes con la apariencia esperada (escala, rotación, iluminación) o usa múltiples plantillas mediante la lista de entrada `Object Image`.