13.1.6. Il visualizzatore del frame buffer

Il visualizzatore del frame buffer mostra ciò che la camera vede – più precisamente, qualunque cosa lo script in esecuzione abbia lasciato per ultimo nel frame buffer della camera. Ogni snapshot() vi inserisce una nuova acquisizione, e anche tutto ciò che lo script disegna sull’immagine successivamente è presente, quindi l’anteprima mostra il frame dopo l’elaborazione dello script, annotazioni incluse. L’IDE interroga la camera per ottenere l’ultimo frame tramite USB e visualizza ciascuno man mano che arriva.

Il frame buffer con una regione selezionata: la riga di lettura e l’istogramma sottostante calcolano a partire dai soli pixel selezionati.

L’anteprima ha un costo: comprimere e trasmettere ogni frame richiede tempo alla camera, quindi uno script viene generalmente eseguito più velocemente con l’IDE disconnesso che con l’anteprima attiva. I pulsanti della barra del titolo del pannello gestiscono questo compromesso:

• Zoom – ridimensiona l’immagine per adattarla al pannello (attivo per impostazione predefinita). Disattivato, l’immagine viene visualizzata con un pixel dello schermo per ogni pixel dell’immagine.

• Disabilita – interrompe completamente lo streaming dei frame, per ottenere le massime prestazioni lato camera. Lo script continua a essere eseguito; l’anteprima si blocca sull’ultimo frame dietro un banner «Frame Buffer Disabled» finché non la riabiliti. Usalo durante il benchmarking, poiché gli FPS che lo script raggiunge con l’anteprima disabilitata sono gli FPS che raggiungerà in modalità autonoma.

• Modalità JPG / Modalità RAW – indica se i frame vengono compressi in JPEG per il trasferimento all’IDE o inviati non compressi. La modalità parte da quella preferita dalla camera connessa – JPG per la maggior parte. La modalità JPG è molto più veloce; la modalità RAW mostra i valori esatti dei pixel a scapito del frame rate. Il pulsante compare per le camere che eseguono un firmware recente.

13.1.6.1. Selezionare una regione

Fai clic e trascina sull’immagine per selezionare una regione rettangolare. Finché esiste una selezione, l’istogramma sottostante calcola le sue statistiche a partire dai soli pixel selezionati, e la riga di lettura sopra l’istogramma riporta la posizione, la dimensione e il numero di pixel della selezione – il modo più rapido per leggere una tupla ROI per uno script, o per misurare le statistiche di colore di un singolo oggetto invece dell’intera scena. Fai clic senza trascinare per leggere la posizione di un singolo pixel; fai clic fuori dall’immagine per annullare la selezione.

13.1.6.2. Salvare ciò che la camera vede

Fai clic con il tasto destro sull’immagine per salvare il frame visualizzato in un file immagine sul tuo computer. Il salvataggio rispetta la selezione: fai clic con il tasto destro all’interno di una regione selezionata e viene salvata solo quella regione (la voce di menu indica «Save Image selection to PC»); fai clic con il tasto destro altrove e viene salvato l’intero frame. Ciò che finisce sul disco è il frame mostrato nel momento in cui fai clic con il tasto destro – per catturare un frame esatto da una scena in movimento, ferma prima lo script in modo che l’anteprima si blocchi su di esso.