> 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-reference.md).
# Find Reference
## 📥 Entradas
`Object Image` La imagen en la que debe localizarse la referencia (imagen objetivo).
`Reference Image` La imagen de referencia más pequeña que se usa para buscar dentro de la `Object Image`.
`Reference Image ROI` Entrada de forma opcional para limitar la coincidencia a una región dentro de la `Reference Image` (útil para ignorar partes irrelevantes).
## 📤 Salidas
`Result Image` La `Object Image` anotada con el polígono delimitador de la referencia detectada.
`Detected Object Image` Un recorte corregido en perspectiva del objeto detectado, transformado para coincidir con la orientación/tamaño de la referencia.
`Keypoints Image` Una visualización de las detecciones de características/puntos clave en la `Object Image` para verificar las coincidencias.
`Bounding Box` El rectángulo que encierra la referencia detectada dentro de la `Object Image`.
`Corner Coordinates` Las coordenadas de las cuatro esquinas del polígono de la zona de referencia detectada.
`Center Position` El punto central (x, y) de la referencia detectada.
## 🕹️ Controles
Este bloque no ofrece controles adicionales en la interfaz más allá de sus entradas. Use la entrada `Reference Image ROI` para limitar el área de referencia cuando sea necesario.
## 🎨 Características
* Resultado visual con un polígono superpuesto para verificación rápida.
* Devuelve tanto un recorte corregido en perspectiva como salidas geométricas (esquinas, bounding box, centro) para procesado posterior.
* Acepta un ROI opcional en la `Reference Image` para centrar la búsqueda en una sub-región.
* Genera una visualización de puntos clave para ayudar a depurar la calidad de la coincidencia.
## 📝 Instrucciones de uso
1. Proporcione la imagen fuente en `Object Image` y la plantilla/referencia en `Reference Image`.
2. Opcionalmente conecte una forma a `Reference Image ROI` para focalizar en un área concreta dentro de la referencia.
3. Ejecute el escenario — el bloque intentará encontrar la referencia y generará salidas visuales anotadas y geometría.
4. Use las salidas para dibujar superposiciones, recortar, medir o alimentar la lógica de decisión.
## 📊 Cómo se ejecuta
Al ejecutarse, el bloque compara características visuales distintivas entre la referencia y la imagen objetivo, estima la posición y orientación de la mejor coincidencia y devuelve una anotación visual además de salidas transformadas y numéricas que representan el objeto encontrado.
## 💡 Consejos y trucos
* Para enfocar la detección en un área específica de la imagen de entrada, recorte antes con `Image ROI Select` o `Image ROI` y alimente la imagen recortada a `Object Image`.
* Si la escala u orientación difieren significativamente entre la referencia y el objeto, pruebe a redimensionar las entradas con `Image Resize` antes de la coincidencia.
* Mejore la robustez ante cambios de iluminación preprocesando con `Adjust Colors`, `Contrast Optimization` o `Blur` para reducir ruido.
* Use `Show Image` para previsualizar `Result Image` o `Detected Object Image` de forma interactiva mientras ajusta los parámetros.
* Combine la salida del bloque con `Draw Detections` o `Draw Result On Image` para superponer anotaciones textuales o rectangulares en imágenes en vivo.
* Si necesita una matriz de perspectiva para otras medidas, considere seguir con `Perspective Transform` usando las `Corner Coordinates` detectadas.
* Cuando la coincidencia devuelva muchos falsos positivos, intente limitar las características de la referencia usando `Reference Image ROI` o aplique `Image Threshold` en las entradas para simplificar texturas.
Sugerencia: Para flujos basados en regiones, use `Get ROI` después de la detección para extraer y reenviar el área detectada a otros bloques de procesamiento.
## 🛠️ Solución de problemas
* No se encontró detección: asegúrese de que la referencia aparece en la `Object Image` con textura visible suficiente; pruebe a aumentar el tamaño de la referencia en la imagen objetivo o use `Image Resize`.
* Coincidencias pobres o inestables: mejore iluminación y contraste con `Adjust Colors` o `Contrast Optimization`; reduzca ruido con `Blur`.
* Detectado pero el recorte corregido en perspectiva parece incorrecto: valide las `Corner Coordinates` usando `Show Image` en la `Keypoints Image` y considere restringir la `Reference Image ROI`.
* Procesamiento lento en imágenes grandes: reduzca escala con `Image Resize` antes de alimentar este bloque y, si es necesario, mapee los resultados de nuevo a las coordenadas originales.