Falcon Player (FPP) riproduce file di sequenza .fseq. Pixel LED Animator 3 può esportare FSEQ direttamente, così puoi progettare un’animazione nell’editor e consegnare il risultato a uno spettacolo FPP senza ricostruirlo in un sequencer.

La parte importante non è il pulsante di esportazione. È far coincidere conteggio dei canali, ordine dei pixel e disposizione del cablaggio tra Pixel LED Animator, il file FSEQ e qualunque cosa piloti FPP. Se questi tre elementi sono corretti, la sequenza parte al primo tentativo.

Cosa Contiene un File FSEQ

Un file FSEQ è un flusso piatto di valori di canale, un blocco per fotogramma. L’intestazione registra il numero di fotogrammi, il tempo per passo, il numero di canali e la compressione opzionale. Pixel LED Animator scrive FSEQ v2 con indicizzazione dei blocchi opzionale e compressione Zstd.

Non memorizza la forma fisica della matrice. Un pannello serpentina da 64 x 32 e un pannello progressivo da 64 x 32 possono produrre lo stesso file FSEQ se l’ordine dei canali è identico. Il cablaggio viene applicato dal ricevitore: l’output LED Panels di FPP oppure il controller che riceve gli universi.

Allinea Prima il Conteggio dei Canali

Conta i canali prima di esportare:

width x height x 3 = total RGB channels

MatricePixelCanali
16 x 16256768
32 x 321.0243.072
64 x 322.0486.144
64 x 644.09612.288
128 x 648.19224.576

Imposta l’output di FPP sullo stesso totale. Se FPP si aspetta più canali di quelli contenuti nel file, i canali in eccesso restano a zero. Se se ne aspetta meno, la fine della sequenza viene troncata.

Passo 1: Progetta alla Dimensione Finale della Matrice

Imposta il canvas di Pixel LED Animator sulla risoluzione della matrice, non su una risoluzione video. Una matrice 64 x 32 va progettata a 64 x 32.

Scegli un frame rate che FPP possa riprodurre in modo affidabile. 30 FPS è un valore predefinito sicuro; 40 o 50 FPS vanno bene per matrici più piccole, ma aumentano la dimensione del file e il carico di rete. Limita la durata a ciò che lo spettacolo richiede davvero.

Ricorda che un fotogramma FSEQ contiene tutti i pixel della matrice. Una sequenza lunga ad alto frame rate cresce in fretta:

channels x frames = bytes

A 64 x 32 e 30 FPS, dieci secondi sono circa 1,8 MB prima della compressione. Una matrice 128 x 64 con le stesse impostazioni arriva a circa 7,4 MB.

Passo 2: Esporta FSEQ

  1. Apri il pannello di esportazione e seleziona il profilo FSEQ.
  2. Scegli la compressione FSEQ:
    • None per la massima compatibilità con build e strumenti FPP più vecchi.
    • Zstd per file più piccoli quando la build FPP di destinazione supporta Zstd.
  3. Imposta nome e cartella di output.
  4. Esporta e verifica che il file .fseq esista e abbia una dimensione plausibile.

Se il file pesa solo pochi kilobyte per un’animazione lunga, l’esportazione non ha renderizzato i fotogrammi. Controlla durata, canvas e percorso di output.

Passo 3: Carica su Falcon Player

  1. Apri l’interfaccia web di FPP.
  2. Vai su Content Setup → File Manager.
  3. Apri la scheda FSEQ.
  4. Carica il file .fseq.
  5. Verifica che compaia con la dimensione attesa.

File Manager inserisce le sequenze nella directory media di FPP. Se copi i file manualmente, usa la cartella sequences dentro la directory media di FPP, non la radice della chiavetta USB.

Passo 4: Configura l’Output

FPP deve sapere come i canali vengono mappati sulle uscite fisiche.

  • Output diretto alla matrice: usa Input/Output Setup → Channel Outputs → LED Panels. Imposta dimensione del pannello, disposizione e cablaggio serpentina o progressivo in base alla struttura fisica.
  • Controller esterno: configura l’output E1.31 o Art-Net e imposta il canale iniziale e il numero di universi. Il controller applica ordine dei pixel e cablaggio.
  • Impianto misto: mantieni il primo pixel sul canale 1 e documenta il canale iniziale di ogni output.

L’ordine dei pixel conta. Pixel LED Animator scrive RGB. Se la striscia o il controller si aspetta GRB, impostalo sul controller o nella configurazione dell’output FPP. Modificarlo nel FSEQ dopo l’esportazione non è la soluzione corretta.

Passo 5: Prova, Poi Riproduci

Prima di riprodurre la sequenza, usa Display Testing in FPP per riempire la matrice e lanciare un chase. Così verifichi alimentazione, dati e cablaggio senza coinvolgere il file di sequenza.

Poi:

  1. Vai su Content Setup → Playlists.
  2. Crea una playlist e aggiungi la voce FSEQ.
  3. Salva la playlist.
  4. Avvia la playlist dalla pagina di stato di FPP o dall’editor delle playlist e osserva i primi dieci secondi.

Controlla il primo fotogramma, i colori e l’orientamento. Se l’immagine è ruotata o specchiata, correggi la disposizione del pannello o il pattern di cablaggio invece di riesportare.

Risoluzione dei Problemi

ProblemaSoluzione
FPP non elenca il fileVerifica che sia nell’area FSEQ, che abbia estensione .fseq e che il caricamento sia terminato
La sequenza parte ma non si accende nullaControlla la configurazione dell’output, il canale iniziale e il conteggio totale dei canali
I colori sono invertitiImposta l’ordine RGB/GRB sul controller o nell’output FPP
L’immagine è spostata di un pixelControlla il canale iniziale e l’indice del primo pixel
Metà matrice è neraIl conteggio dei canali è troppo basso o il numero di universi è errato
La riproduzione è troppo veloce o lentaAllinea gli FPS della sequenza al timing di FPP e al frame rate di esportazione
Il file Zstd non parteRiesporta con la compressione impostata su None
Il file è troppo grandeRiduci gli FPS, accorcia la sequenza o attiva Zstd

Domande Frequenti

FSEQ è lo stesso formato usato da xLights? Sì. FSEQ è il formato di sequenza che xLights esporta e Falcon Player riproduce. Pixel LED Animator scrive FSEQ v2 direttamente, quindi xLights è opzionale.

Serve xLights per usare FPP? No. Puoi esportare FSEQ da Pixel LED Animator, caricarlo e riprodurlo. xLights è utile se vuoi modificare ulteriormente la sequenza o gestire uno spettacolo più grande.

FSEQ include l’audio? No. Il file FSEQ contiene i dati dei canali. L’audio è gestito separatamente da FPP o dal controller dello spettacolo.

FPP può inviare la sequenza a WLED? Sì. Configura FPP per inviare E1.31 a WLED e imposta WLED come ricevitore E1.31. Il FSEQ contiene comunque l’intero flusso di canali.

Posso usare una matrice Raspberry Pi invece di un controller? Sì. L’output LED Panels di FPP pilota direttamente una matrice RGB Raspberry Pi. Imposta la disposizione del pannello e il cablaggio in base alla struttura fisica.

Scopri Pixel LED Animator 3 · Vedi tutte le integrazioni · Leggi la guida allo streaming WLED · Acquista la licenza a vita