> For the complete documentation index, see [llms.txt](https://docs.velogicfit.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.velogicfit.com/es/seccion-01-primeros-pasos/lighting-environment.md).

# Iluminación y entorno

Directrices para optimizar las condiciones de iluminación y la configuración del entorno de la cámara para mejorar la detección de marcadores y el rendimiento general del sistema.

El sistema identificará los marcadores en casi total oscuridad. Sin embargo, obtendrás un mejor rendimiento de la cámara si prestas un poco de atención a la configuración del entorno.

## Indicadores de calidad

Los Indicadores de calidad son una pequeña visualización en pantalla que te permite identificar rápidamente cualquier problema con el área de ajuste.

Los Indicadores de calidad aparecen junto a la vista previa de la cámara Kinect, en el Paso 1: Configuración:

![Configuración del Paso 1 de Velogic Studio mostrando el panel de indicadores de calidad junto a la vista previa de la cámara para supervisar el rendimiento del sistema](https://1156257956-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FjxwtZYYk0lvusnMTywNR%2Fuploads%2Fgit-blob-6473f03bcb1404f27a2acee72f17a0203f987e19%2Fquality-indicators-step1.png?alt=media)

Si haces clic en el botón de más, los indicadores de calidad se desplegarán para mostrar el valor numérico de cada indicador y algunas opciones adicionales:

![Panel de indicadores de calidad expandido que muestra valores numéricos y opciones adicionales para una supervisión detallada del rendimiento](https://1156257956-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FjxwtZYYk0lvusnMTywNR%2Fuploads%2Fgit-blob-a33acde197e9ecbda1df9034e6ffb9e38c641d13%2Fexpanded-quality-indicators.png?alt=media)

Los indicadores de calidad también aparecen en el Paso 2: Captura, con un indicador adicional «Detección»:

![Vista de Captura del Paso 2 que muestra indicadores de calidad, incluyendo la tasa de fotogramas, la exposición y el estado de detección, con la métrica adicional Detección](https://1156257956-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FjxwtZYYk0lvusnMTywNR%2Fuploads%2Fgit-blob-18b60fcf2aef9201296253bbc977452758f71863%2Fquality-indicators-step2.png?alt=media)

## Exposición

La exposición es cuántos milisegundos permanece abierta la apertura de la cámara para capturar cada fotograma.

Por lo general, quieres que la apertura permanezca abierta el menor tiempo posible, para minimizar el desenfoque por movimiento en vídeos e imágenes fijas. Pero si la apertura necesita permanecer abierta el tiempo suficiente para captar la luz suficiente para obtener una buena imagen de la escena en cada fotograma.

Queremos obtener 30 fotogramas por segundo de la cámara, lo que significa que la exposición debe ser inferior a 33 ms. (33 ms por fotograma x 30 fotogramas por segundo = 1 segundo)

La cámara Kinect tiene un método de autoexposición integrado. Funciona aproximadamente así:

1. Si la iluminación es lo suficientemente buena como para producir una imagen con un buen balance de blancos a 30 fps, entonces haz eso
2. Si la iluminación no es lo suficientemente buena para eso, baja a 15 fps
3. Si la iluminación es realmente mala, baja por debajo de 15 fps

A veces, si tenemos condiciones de iluminación imperfectas o un fondo completamente blanco o completamente negro, la cámara Kinect no alcanzará 30 fps aunque parezca que debería. En ese caso, podemos anular la función de autoexposición integrada de la cámara Kinect y configurar la exposición manualmente.

Solo haz clic en el menú desplegable «Modo de exposición» y selecciona «Exposición manual»:

![Controles de exposición manual que muestran el menú desplegable Modo de exposición configurado en Manual, con deslizadores de Exposición y Ganancia para ajustar con precisión la configuración de la cámara](https://1156257956-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FjxwtZYYk0lvusnMTywNR%2Fuploads%2Fgit-blob-c6deb8768417db193115a357668f085bb5a6679d%2Fmanual-exposure-controls.png?alt=media)

Entonces verás dos controles adicionales:

1. un control deslizante de Exposición, que te permite configurar manualmente la exposición de 1 ms a 30 ms.
2. un control deslizante de Ganancia, que te permite configurar la ganancia (brillo)

Ten en cuenta que, al usar los controles de exposición manual, la imagen a veces se verá «parpadeante» bajo ciertas condiciones de iluminación, según la frecuencia de tu fuente de alimentación. Puedes variar ligeramente la exposición para reducir el parpadeo.

## Consejos de iluminación

1. Lo ideal es que la luz esté uniformemente difuminada, es decir, distribuida de manera constante en el espacio. Tener puntos brillantes sobre el ciclista o el fondo no mejora la puntuación.
2. Un fondo claro ayuda a que la luz se refleje por el espacio en lugar de ser absorbida
3. La iluminación natural indirecta (p. ej., desde una ventana) es ideal

## Productos de iluminación

Si necesitas añadir iluminación artificial a tu escena, aquí hay algunos productos que otros ajustadores han utilizado con éxito:

1. [Tira Nanoleaf](https://nanoleaf.me/en-NZ/products/essentials/lightstrips/?category=lightstrips\&standard=matter\&pack=smarter-kit\&size=2) produce alrededor de 2200 lúmenes, lo cual es mucho para una tira LED. Una o varias de estas para iluminar tu estudio de ajuste son una forma económica y atractiva de añadir iluminación.
2. Luces de garaje en Amazon como [esta](https://www.amazon.com/POLARPRA-LED-Garage-Light-Adjustable/dp/B0BFNNQXWH) son muy brillantes y, como encajan en un casquillo estándar, pueden usarse con un [soporte para bombilla](https://www.amazon.com/Emart-Photography-Holder-Light-Umbrella/dp/B07X37NZSK) que puede fijarse a un trípode.

## Tasa de fotogramas

La tasa de fotogramas indica cuántos fotogramas es capaz de capturar Velogic Studio desde la Kinect y procesar por segundo. Si solo estás obteniendo 15/16 fps, es probable que el método de autoexposición de la Kinect esté reduciendo los FPS de la cámara Kinect. Consulta la sección de Exposición anterior.

## Detección

La detección muestra si el sistema encuentra de forma consistente exactamente 7 marcadores.

## ¿Sigues teniendo problemas?

Consulta nuestra [guía de solución de problemas](/es/seccion-02-uso-de-velogic-studio/troubleshooting.md) si tienes problemas para obtener un buen resultado con los Indicadores de calidad.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.velogicfit.com/es/seccion-01-primeros-pasos/lighting-environment.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
