Luce
Controlla i dispositivi di illuminazione collegati all'interno di una pipeline.
Il modulo Luce controlla i dispositivi di illuminazione collegati (I/O digitale) durante l’esecuzione della pipeline. Viene tipicamente posizionato in un blocco prima del blocco telecamera per garantire che le condizioni di illuminazione corrette siano impostate prima della cattura dell’immagine.
Configurazione
| Field | Type | Description |
|---|---|---|
| configuration | object |
Un dizionario che mappa le etichette delle luci al loro stato desiderato (true = accesa, false = spenta) |
Ogni chiave nell’oggetto configuration corrisponde a un’etichetta luce come definita nella pagina Dispositivi → Luci.
Comportamento
- Il modulo confronta gli stati delle luci richiesti con gli stati hardware correnti.
- Se tutte le luci sono già nello stato corretto, non c’è attesa (zero overhead).
- Se almeno una luce deve cambiare stato, il modulo attende brevemente per permettere alla luce di accendersi o spegnersi prima che il blocco continui.
- Quando le luci vengono aggiunte per la prima volta a un modulo, ogni luce viene impostata su OFF per impostazione predefinita. Dovrai accendere le luci che vuoi utilizzare prima di eseguire la pipeline.
- Nell’anteprima del modulo, ogni luce viene mostrata come un pallino colorato: verde lime quando la luce è accesa, e grigio quando è spenta. Passa il mouse sul pallino per vedere il nome della luce in un tooltip.
Il modulo recupera automaticamente le etichette delle luci correnti dal server al primo rendering.
Input e Output
| Direction | Key | Type | Description |
|---|---|---|---|
| Input | — | — | Nessun input richiesto |
| Output | — | — | Nessun output di dati mostrato |
Regole di Validazione
| Rule | Description |
|---|---|
| Esclusione luce-telecamera | Un modulo Luce e un modulo Telecamera non possono essere nello stesso blocco. Posiziona la Luce nel blocco prima della Telecamera. |
| Massimo una luce per blocco | È ammesso un solo modulo Luce per blocco. |
I moduli Luce vengono sempre eseguiti in entrambe le modalità di esecuzione.
Posizionamento Tipico nella Pipeline
Un modulo Luce dovrebbe essere posizionato nel primo blocco di una pipeline, seguito da un modulo Telecamera nel secondo blocco:
Blocco 0: [ Luce ] ← Imposta condizioni di illuminazione
Blocco 1: [ Telecamera ] ← Cattura immagine con illuminazione corretta
Blocco 2: [ Inferenza ] ← Analizza immagine catturata