> 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/pt-br/secao-01-introducao/lighting-environment.md).

# Iluminação e ambiente

Diretrizes para otimizar as condições de iluminação e a configuração do ambiente da câmera para melhorar a detecção de marcadores e o desempenho geral do sistema.

O sistema identificará os marcadores em quase total escuridão. No entanto, você terá um desempenho melhor da câmera se tiver um pouco de cuidado com a configuração do ambiente.

## Indicadores de qualidade

Os Indicadores de Qualidade são uma pequena exibição na tela que permite identificar rapidamente qualquer problema com a área de ajuste.

Os Indicadores de Qualidade aparecem ao lado da pré-visualização da câmera Kinect, na Etapa 1: Configuração:

![Velogic Studio Etapa 1 Configuração mostrando painel de indicadores de qualidade ao lado da pré-visualização da câmera para monitoramento do desempenho do sistema](https://3174144422-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FjxwtZYYk0lvusnMTywNR%2Fuploads%2Fgit-blob-6473f03bcb1404f27a2acee72f17a0203f987e19%2Fquality-indicators-step1.png?alt=media)

Se você clicar no botão de mais, os indicadores de qualidade serão expandidos para mostrar o valor numérico de cada indicador e algumas opções adicionais:

![Painel expandido de indicadores de qualidade exibindo valores numéricos e opções adicionais para monitoramento detalhado do desempenho](https://3174144422-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FjxwtZYYk0lvusnMTywNR%2Fuploads%2Fgit-blob-a33acde197e9ecbda1df9034e6ffb9e38c641d13%2Fexpanded-quality-indicators.png?alt=media)

Os indicadores de qualidade também aparecem na Etapa 2: Captura, com um indicador adicional "Detecção":

![Visualização da Etapa 2: Captura mostrando indicadores de qualidade, incluindo taxa de quadros, exposição e status de detecção, com a métrica adicional Detecção](https://3174144422-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FjxwtZYYk0lvusnMTywNR%2Fuploads%2Fgit-blob-18b60fcf2aef9201296253bbc977452758f71863%2Fquality-indicators-step2.png?alt=media)

## Exposição

A exposição é a quantidade de milissegundos que a abertura da câmera permanece aberta para capturar cada quadro.

Geralmente, você quer que a abertura fique aberta pelo menor tempo possível, para minimizar o desfoque de movimento em vídeos e imagens estáticas. Mas se a abertura precisar ficar aberta por tempo suficiente para capturar luz suficiente para fazer uma boa imagem da cena em cada quadro.

Queremos obter 30 quadros por segundo da câmera, o que significa que a exposição deve ser menor que 33 ms. (33 ms por quadro x 30 quadros por segundo = 1 segundo)

A câmera Kinect possui um método de autoexposição integrado. Ele funciona aproximadamente da seguinte forma:

1. Se a iluminação for boa o suficiente para produzir uma imagem com bom balanço de branco a 30 fps, então faça isso
2. Se a iluminação não for boa o suficiente para isso, reduza para 15 fps
3. Se a iluminação estiver realmente ruim, reduza para menos de 15 fps

Às vezes, se tivermos condições de iluminação imperfeitas ou um fundo totalmente branco ou totalmente preto, a câmera Kinect não alcançará 30 fps, mesmo quando parece que deveria. Nesse caso, podemos substituir a função de autoexposição integrada da câmera Kinect e definir a exposição manualmente.

Basta clicar no menu suspenso "Modo de exposição" e selecionar "Exposição manual":

![Controles de exposição manual mostrando o menu suspenso Modo de exposição definido como Manual com controles deslizantes de Exposição e Ganho para ajuste fino das configurações da câmera](https://3174144422-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FjxwtZYYk0lvusnMTywNR%2Fuploads%2Fgit-blob-c6deb8768417db193115a357668f085bb5a6679d%2Fmanual-exposure-controls.png?alt=media)

Você verá então dois controles adicionais:

1. um controle deslizante de Exposição, permitindo definir a exposição manualmente de 1 ms a 30 ms.
2. um controle deslizante de Ganho, permitindo definir o ganho (brilho)

Observe que, ao usar os controles manuais de exposição, a imagem às vezes parecerá "cintilante" sob certas condições de iluminação, dependendo da frequência da sua fonte de energia. Você pode variar levemente a exposição para reduzir a cintilação.

## Dicas de iluminação

1. Idealmente, você quer que a luz seja distribuída de forma uniforme, ou seja, espalhada consistentemente pelo espaço. Ter pontos muito claros no ciclista ou no fundo não melhora a pontuação.
2. Um fundo claro ajuda, garantindo que a luz seja refletida pelo espaço, em vez de ser absorvida
3. A iluminação natural indireta (por exemplo, de uma janela) é ótima

## Produtos de iluminação

Se você precisar adicionar iluminação artificial à sua cena, aqui estão alguns produtos que outros ajustadores usaram com sucesso:

1. [Nanoleaf Strip](https://nanoleaf.me/en-NZ/products/essentials/lightstrips/?category=lightstrips\&standard=matter\&pack=smarter-kit\&size=2) produz cerca de 2200 lúmens, o que é brilhante para uma fita de LED. Uma ou mais delas iluminando seu estúdio de bike fit é uma forma barata e visualmente interessante de adicionar iluminação.
2. "Luzes de garagem" na Amazon, como [esta](https://www.amazon.com/POLARPRA-LED-Garage-Light-Adjustable/dp/B0BFNNQXWH) são muito brilhantes e, como se encaixam em um soquete de lâmpada padrão, podem ser usadas com um [suporte para lâmpada](https://www.amazon.com/Emart-Photography-Holder-Light-Umbrella/dp/B07X37NZSK) que pode ser fixado a um tripé.

## Taxa de quadros

A taxa de quadros indica quantos quadros o Velogic Studio consegue capturar da Kinect e processar por segundo. Se você estiver obtendo apenas 15/16 fps, é provável que o método de autoexposição da Kinect esteja reduzindo os FPS da câmera Kinect. Veja a seção Exposição acima.

## Detecção

A detecção mostra se o sistema está encontrando consistentemente exatamente 7 marcadores.

## Ainda está com problemas?

Confira o nosso [guia de solução de problemas](/pt-br/secao-02-usando-o-velogic-studio/troubleshooting.md) se você estiver tendo problemas para obter um bom resultado com os Indicadores de Qualidade.


---

# 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/pt-br/secao-01-introducao/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.
