13.1.6. O visualizador do buffer de fotograma

O visualizador do buffer de fotograma mostra o que a câmara vê – mais precisamente, o que o script em execução deixou por último no buffer de fotograma da câmara. Cada snapshot() coloca uma nova captura de imagem aí, e tudo o que o script desenha na imagem depois também está lá, portanto a pré-visualização mostra o fotograma após o processamento do script, incluindo as anotações. O IDE interroga a câmara para obter o último fotograma via USB e apresenta cada um à medida que chega.

O buffer de fotograma com uma região selecionada: a linha de leitura e o histograma abaixo calculam apenas a partir dos pixels selecionados.

A pré-visualização tem um custo: comprimir e transmitir cada fotograma consome tempo da câmara, por isso um script geralmente corre mais depressa com o IDE desligado do que com a pré-visualização ativa. Os botões na barra de título do painel gerem essa troca:

• Zoom – dimensiona a imagem para caber no painel (ativo por predefinição). Desativado, a imagem é renderizada a um pixel do ecrã por pixel da imagem.

• Disable – para completamente a transmissão de fotogramas, para desempenho máximo do lado da câmara. O script continua a correr; a pré-visualização congela no último fotograma por detrás de um banner «Frame Buffer Disabled» até o reativar. Use-o ao fazer benchmarking, uma vez que os FPS que o script atinge com a pré-visualização desativada são os FPS que atingirá de forma autónoma.

• JPG Mode / RAW Mode – se os fotogramas são comprimidos em JPEG para a viagem até ao IDE ou enviados sem compressão. O modo começa no que a câmara ligada preferir – JPG para a maioria. O modo JPG é muito mais rápido; o modo RAW mostra os valores exatos de pixel ao custo da taxa de fotogramas. O botão aparece para câmaras com firmware recente.

13.1.6.1. Selecionar uma região

Clique e arraste sobre a imagem para selecionar uma região retangular. Enquanto existe uma seleção, o histograma abaixo calcula as suas estatísticas apenas a partir dos pixels selecionados, e a linha de leitura acima do histograma reporta a posição, tamanho e contagem de pixels da seleção – a forma mais rápida de ler um tuplo ROI para um script, ou de medir as estatísticas de cor de um objeto em vez de toda a cena. Clique sem arrastar para ler a posição de um único pixel; clique fora da imagem para limpar a seleção.

13.1.6.2. Guardar o que a câmara vê

Clique com o botão direito na imagem para guardar o fotograma apresentado num ficheiro de imagem no seu computador. O guardamento respeita a seleção: clique com o botão direito dentro de uma região selecionada e apenas essa região é guardada (a entrada do menu indica «Save Image selection to PC»); clique com o botão direito em qualquer outro lugar e todo o fotograma é guardado. O que fica em disco é o fotograma apresentado no momento em que clica com o botão direito – para capturar um fotograma exato de uma cena em movimento, pare primeiro o script para que a pré-visualização congele nesse fotograma.