Come usare la funzione Raster in 3D2HOLO Desktop

Che cosa fa davvero la funzione Raster

In 3d2holo-desktop, quando selezioni `FORMAT = ras`, l applicazione entra nel percorso di output raster. Non salva solo un normale PNG o TIFF, ma prepara un flusso piu adatto a una coda CUPS.

Il codice desktop attuale espone campi di stampa dedicati, come risoluzione, direzione raster, stampante, dimensione pagina e offset X/Y. Durante la stampa, l addon nativo invia il file a CUPS e passa esplicitamente opzioni come `Resolution`, `PageSize`, `media` e `StpPrintingDirection=Unidirectional`.

Al momento il modo raster supporta direttamente solo Epson L1800, Epson L1300 ed Epson P608. Se un altra stampante Epson e supportata da Gutenprint, puoi comunque iniziare selezionando Epson L1800 in 3d2holo-desktop come soluzione temporanea per i test.

• Usa la modalita raster quando l ultimo passaggio del tuo flusso e un processo di stampa reale gestito da CUPS e non soltanto un esportazione di file.
• Usala quando vuoi allineare formato pagina e posizionamento fisico ai parametri della stampante prima di inviare il lavoro.
• Usala soprattutto se il tuo flusso Epson dipende dalle opzioni esposte da Gutenprint.

1. Installa prima Gutenprint e CUPS

Sui sistemi basati su Debian o Ubuntu, il modo piu semplice e installare CUPS e poi il pacchetto driver Gutenprint per CUPS. I nomi dei pacchetti qui sotto corrispondono ai risultati attuali su un sistema in stile Debian/Ubuntu.

1. Installa `cups`, `cups-client` e `cups-daemon` per rendere disponibili il servizio di stampa e gli strumenti di gestione della coda.
2. Installa `printer-driver-gutenprint` per permettere alle stampanti Epson di usare Gutenprint in CUPS.
3. Avvia o abilita il servizio CUPS e poi apri `http://localhost:631`.

sudo apt update
sudo apt install cups cups-client cups-daemon printer-driver-gutenprint
sudo systemctl enable --now cups

Dopo l installazione, verifica prima che CUPS veda la coda e poi che le opzioni di Gutenprint siano effettivamente visibili. Il secondo comando e particolarmente utile perche elenca i nomi reali delle opzioni esposte dalla tua coda.

lpstat -p -d
lpoptions -p YOUR_PRINTER_NAME -l | rg 'Resolution|PageSize|media|Stp'

2. Configura i parametri della stampante in CUPS

CUPS definisce la coda di stampa, il comportamento predefinito del supporto e le opzioni del driver. Una sequenza sicura consiste nell aggiungere prima la stampante in CUPS, stampare una normale pagina di prova e poi tornare in 3d2holo-desktop per usare l output raster.

1. Apri `http://localhost:631`, vai su `Administration` e scegli `Add Printer`.
2. Seleziona la tua stampante Epson, autenticati se necessario e scegli la voce Gutenprint corrispondente al modello.
3. Dopo la creazione della coda, apri la pagina della stampante e usa `Set Default Options`.

Per i parametri concreti, impostali direttamente seguendo gli screenshot qui sotto.

3. Usa la funzione Raster dentro 3d2holo-desktop

Quando la coda di stampa e pronta, il flusso nell app e abbastanza diretto. I controlli raster appaiono solo quando `FORMAT` e impostato su `ras`, e il pulsante `Print` appare solo quando il file esportato termina con `.ras`.

1. Apri l area di lavoro 2D, 3D, Sketchfab o pitch-test che genera l immagine che vuoi stampare.
2. Nella sezione Output imposta `FORMAT` su `ras`.
3. Seleziona il preset `5760*2880` per `RESOLUTION`.
4. Imposta `DIRECTION`. Se stai testando un layout lenticolare orizzontale standard, inizia con `horizontal` e conferma la direzione con una piccola stampa di prova.
5. Seleziona `PRINTER` e `SIZE` per inviare il lavoro alla coda CUPS corretta e con il giusto formato carta.
6. Regola `X OFFSET (IN)` e `Y OFFSET (IN)` per controllare la posizione fisica sul foglio. L anteprima di layout nel desktop serve proprio a centrare o spostare il rettangolo raster prima dell esportazione.
7. Esegui l esportazione. Se il risultato viene salvato come `.ras`, comparira il pulsante `Print` per l invio diretto tramite CUPS.
8. Dopo l invio, osserva sia la coda attiva di CUPS sia lo stato di stampa nell app per confermare che il lavoro sia entrato davvero nella coda.

Controlli piu comuni

• Se l app indica che non ci sono stampanti disponibili, verifica che in CUPS esista una stampante predefinita oppure che nel campo `PRINTER` sia selezionato il nome corretto della coda.
• Se la posizione di stampa e sbagliata, confronta `PageSize` in CUPS con `SIZE` nell app per assicurarti che si riferiscano allo stesso foglio.
• Se la scala dell output non e corretta, verifica che il preset raster dell app corrisponda alla risoluzione reale esposta da Gutenprint.
• Se il comportamento del supporto e incoerente, torna alle opzioni predefinite della coda CUPS e controlla `media` e le impostazioni correlate.