> 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/analysis/non-zero-of-image.md).

# Non-zero of Image

Este bloque devuelve el número total de píxeles no nulos que se encuentran en una imagen. Es útil para mediciones rápidas como el conteo de píxeles de primer plano, comprobaciones de ocupación o verificar la cobertura de una máscara.

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

`Image Any` Proporcione la imagen que desea analizar. El bloque acepta imágenes en color o en escala de grises.

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

`Count` Número total de píxeles no nulos detectados en la imagen proporcionada.

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

Este bloque no tiene controles visibles para el usuario. Se ejecuta automáticamente cuando se proporciona una imagen.

## ✨ Funcionalidades <a href="#features" id="features"></a>

* Resultado rápido de un solo valor, útil para análisis simples y toma de decisiones.
* Acepta imágenes en color y en escala de grises (las imágenes a color se interpretan internamente para actividad de píxeles).
* Funciona bien como una métrica ligera para máscaras, resultados binarios o detección de primer plano.

## ⚙️ Mecanismo de ejecución <a href="#how-it-works" id="how-it-works"></a>

Cuando se evalúa el bloque, examina la imagen proporcionada y cuenta los píxeles que son distintos de cero (es decir, que contienen información útil/primer plano). El resultado se devuelve como un único valor numérico a través de la salida `Count`.

## 📝 Uso <a href="#usage" id="usage"></a>

1. Conecte un bloque que genere imágenes a la entrada `Image Any`.
2. Lea el resultado numérico desde la salida `Count` para impulsar lógica, registros o alarmas.
3. Combine con otros bloques para preprocesamiento, visualización o toma de decisiones.

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

* Prepare una máscara binaria clara antes de contar usando `Image Threshold` o `Image Adaptive Threshold` para reducir falsos positivos por ruido.
* Use `Image ROI` o `Image ROI Select` para limitar el área del conteo a una región de interés (mediciones localizadas).
* Reduzca el ruido con `Blur`, `Bilateral Filter` o `Denoising` antes de contar para evitar resultados inflados.
* Visualice lo que se está contando enviando la misma imagen a `Show Image` o superponiendo resultados con `Draw Result On Image` / `Write Text On Image`.
* Registre los resultados numéricos a lo largo del tiempo usando `CSV Export` o `Data to JSON` para análisis de tendencias o archivado.
* Combine con `Logic Input` o bloques de comparación para activar acciones cuando el conteo cruce un umbral.

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

* Conteos inesperadamente altos: verifique ruido en la imagen o píxeles dispersos. Aplique `Image Threshold` y bloques de suavizado para limpiar la entrada.
* Conteos cero o muy bajos: confirme que la imagen upstream es válida usando `Show Image` y asegúrese de que el área de interés contenga el primer plano esperado.
* Los conteos varían inesperadamente entre fotogramas: restrinja el área con `Image ROI` o estabilice la entrada usando filtros para reducir la variación entre fotogramas.