So verwenden Sie die Raster-Funktion in 3D2HOLO Desktop

Was die Raster-Funktion eigentlich macht

In 3d2holo-desktop aktiviert die Auswahl `FORMAT = ras` den Raster-Ausgabepfad. Die App speichert dann nicht nur ein normales PNG oder TIFF, sondern erzeugt einen Datenstrom, der besser fuer die Weitergabe an eine CUPS-Warteschlange geeignet ist.

Der aktuelle Desktop-Code stellt dafuer spezielle Druckfelder bereit, darunter Aufloesung, Rasterrichtung, Drucker, Papiergroesse und X/Y-Versatz. Beim eigentlichen Druck uebergibt das native Add-on die Datei an CUPS und setzt dabei explizit Optionen wie `Resolution`, `PageSize`, `media` und `StpPrintingDirection=Unidirectional`.

Der Raster-Modus unterstuetzt derzeit direkt nur Epson L1800, Epson L1300 und Epson P608. Wenn ein anderer Epson-Drucker von Gutenprint unterstuetzt wird, koennen Sie in 3d2holo-desktop zunaechst Epson L1800 als vorlaeufige Testoption auswaehlen.

• Verwenden Sie den Raster-Modus, wenn der letzte Schritt Ihres Workflows ein echter, von CUPS verwalteter Druckprozess ist und nicht nur ein Datei-Export.
• Verwenden Sie ihn, wenn Seitengroesse und physische Platzierung bereits vor dem Absenden mit den Druckereinstellungen uebereinstimmen sollen.
• Verwenden Sie ihn besonders dann, wenn Ihr Epson-Workflow auf von Gutenprint bereitgestellten Treiberoptionen basiert.

1. Zuerst Gutenprint und CUPS installieren

Unter Debian- oder Ubuntu-basierten Systemen ist der einfachste Weg die Installation von CUPS selbst und anschliessend des Gutenprint-CUPS-Treiberpakets. Die folgenden Paketnamen entsprechen den aktuellen Suchergebnissen auf einem Debian/Ubuntu-System.

1. Installieren Sie `cups`, `cups-client` und `cups-daemon`, damit Druckdienst und Warteschlangenwerkzeuge verfuegbar sind.
2. Installieren Sie `printer-driver-gutenprint`, damit Epson-Drucker in CUPS mit Gutenprint-Treibern angelegt werden koennen.
3. Starten oder aktivieren Sie den CUPS-Dienst und oeffnen Sie danach `http://localhost:631`.

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

Pruefen Sie nach der Installation zuerst, ob CUPS die Warteschlange sieht, und danach, ob die relevanten Gutenprint-Optionen verfuegbar sind. Der zweite Befehl ist besonders nuetzlich, weil er die echten Optionsnamen Ihrer Warteschlange auflistet.

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

2. Druckerparameter in CUPS konfigurieren

CUPS legt die Druckwarteschlange, das Standardpapierverhalten und die treiberbezogenen Optionen fest. Ein sicherer Ablauf ist: zuerst den Drucker in CUPS anlegen, dann eine normale Testseite drucken und erst danach in 3d2holo-desktop die Raster-Ausgabe verwenden.

1. Oeffnen Sie `http://localhost:631`, gehen Sie zu `Administration` und waehlen Sie `Add Printer`.
2. Waehlen Sie Ihren Epson-Drucker, authentifizieren Sie sich bei Bedarf und waehlen Sie den passenden Gutenprint-Treibereintrag fuer Ihr Modell.
3. Nachdem die Warteschlange erstellt wurde, oeffnen Sie die Druckerseite und waehlen `Set Default Options`.

Stellen Sie die konkreten Parameter direkt anhand der folgenden Screenshots ein.

3. Raster-Funktion in 3d2holo-desktop verwenden

Sobald die Druckwarteschlange bereit ist, ist der Ablauf in der App recht direkt. Die Raster-Steuerungen erscheinen nur bei `FORMAT = ras`, und die Schaltflaeche `Print` wird nur angezeigt, wenn die exportierte Datei auf `.ras` endet.

1. Oeffnen Sie den 2D-, 3D-, Sketchfab- oder Pitch-Test-Arbeitsbereich, in dem Sie das zu druckende Ergebnis erzeugen.
2. Stellen Sie im Bereich Output `FORMAT` auf `ras` um.
3. Waehlen Sie bei `RESOLUTION` die Voreinstellung `5760*2880`.
4. Setzen Sie `DIRECTION`. Wenn Sie ein typisches horizontales Lentikularlayout testen, beginnen Sie mit `horizontal` und bestaetigen Sie die Richtung mit einem kleinen Testdruck.
5. Waehlen Sie `PRINTER` und `SIZE`, damit der Auftrag an die richtige CUPS-Warteschlange und das passende Papierformat geht.
6. Passen Sie `X OFFSET (IN)` und `Y OFFSET (IN)` an, um die physische Position auf dem Blatt zu steuern. Die Layout-Vorschau im Desktop hilft dabei, das Raster-Rechteck vor dem Export zu zentrieren oder feinzujustieren.
7. Fuehren Sie den Export aus. Wenn das Ergebnis als `.ras` gespeichert wird, erscheint die Schaltflaeche `Print`, ueber die der Auftrag direkt ueber CUPS gesendet werden kann.
8. Beobachten Sie anschliessend sowohl die aktive CUPS-Warteschlange als auch den Druckstatus in der App, um zu bestaetigen, dass der Auftrag wirklich angekommen ist.

Wenn Sie nicht ueber die UI senden moechten, koennen Sie dieselbe `.ras`-Datei auch per Kommandozeile an CUPS schicken. Im aktuellen Desktop-Code werden dabei `Resolution`, `PageSize`, `media`, `MediaType`, `StpMediaType` und `StpPrintingDirection=Unidirectional` explizit gesetzt. `DIRECTION` sowie `X/Y OFFSET` sind bereits im erzeugten `.ras` enthalten und muessen im `lp`-Befehl nicht noch einmal separat angegeben werden.

lp -d YOUR_CUPS_QUEUE \
  -o Resolution=5760x2880dpi \
  -o PageSize=A4 \
  -o media=A4 \
  -o MediaType=UltraGlossyPhoto \
  -o StpMediaType=UltraGlossyPhoto \
  -o StpPrintingDirection=Unidirectional \
  /path/to/result.ras

lp -d YOUR_CUPS_QUEUE \
  -o Resolution=5760x2880dpi \
  -o PageSize=A4 \
  -o media=A4 \
  -o MediaType=UltraGlossyPhoto \
  -o StpMediaType=UltraGlossyPhoto \
  -o StpPrintingDirection=Unidirectional \
  /path/to/result.ras

lp -d YOUR_CUPS_QUEUE \
  -o Resolution=2880x2880dpi \
  -o PageSize=A3 \
  -o media=A3 \
  -o MediaType=GlossyPhoto \
  -o StpMediaType=GlossyPhoto \
  -o StpPrintingDirection=Unidirectional \
  /path/to/result.ras

lp -d YOUR_CUPS_QUEUE \
  -o Resolution=5760x1440dpi \
  -o PageSize=A4 \
  -o media=A4 \
  -o MediaType=GlossyPhoto \
  -o StpMediaType=GlossyPhoto \
  -o StpPrintingDirection=Unidirectional \
  /path/to/result.ras

Die haeufigsten Pruefpunkte

• Wenn die App meldet, dass kein Drucker verfuegbar ist, stellen Sie sicher, dass in CUPS ein Standarddrucker gesetzt ist oder im Feld `PRINTER` der korrekte Warteschlangenname gewaehlt wurde.
• Wenn die Druckposition nicht stimmt, vergleichen Sie `PageSize` in CUPS mit `SIZE` in der App und pruefen Sie, ob wirklich dieselbe Papierdefinition gemeint ist.
• Wenn die Ausgabe falsch skaliert ist, kontrollieren Sie, ob die Raster-Aufloesung in der App zur tatsaechlich von Gutenprint genutzten Druckeraufloesung passt.
• Wenn das Medium unerwartet reagiert, gehen Sie zurueck zu den Standardoptionen der CUPS-Warteschlange und pruefen Sie `media` und verwandte Papieroptionen.