3D2HOLO Desktop에서 Raster 기능을 사용하는 방법

Raster 기능이 실제로 하는 일

3d2holo-desktop에서 `FORMAT = ras`를 선택하면 앱은 raster 출력 경로로 전환됩니다. 단순히 PNG나 TIFF를 저장하는 것이 아니라, CUPS 큐에 넘기기 더 적합한 데이터 스트림을 준비합니다.

현재 데스크톱 코드에서는 해상도, raster 방향, 프린터, 페이지 크기, X/Y 오프셋 같은 전용 인쇄 필드를 제공합니다. 실제 인쇄 시 네이티브 addon은 파일을 CUPS로 넘기며 `Resolution`, `PageSize`, `media`, `StpPrintingDirection=Unidirectional` 같은 옵션을 명시적으로 설정합니다.

현재 raster 모드는 Epson L1800, Epson L1300, Epson P608 세 기종만 직접 지원합니다. 다른 Epson 프린터라도 Gutenprint 드라이버 지원이 있다면, 3d2holo-desktop에서 먼저 Epson L1800을 임시 선택지로 골라 테스트할 수 있습니다.

• 최종 단계가 단순 파일 저장이 아니라 CUPS가 관리하는 실제 인쇄 프로세스라면 raster 모드를 사용하세요.
• 작업 전송 전에 페이지 크기와 실제 배치를 프린터 설정과 맞추고 싶을 때도 적합합니다.
• 특히 Epson 워크플로가 Gutenprint 드라이버 옵션에 의존한다면 raster 모드의 가치가 큽니다.

1. 먼저 Gutenprint와 CUPS를 설치하기

Debian/Ubuntu 계열 시스템에서는 먼저 CUPS를 설치하고, 그 다음 CUPS용 Gutenprint 드라이버 패키지를 설치하는 것이 가장 간단합니다. 아래 패키지 이름은 현재 Debian/Ubuntu 스타일 시스템에서 확인되는 이름에 맞춘 것입니다.

1. `cups`, `cups-client`, `cups-daemon`을 설치해 인쇄 서비스와 큐 관리 도구를 사용할 수 있게 합니다.
2. `printer-driver-gutenprint`를 설치해 Epson 프린터를 CUPS에서 Gutenprint와 함께 사용할 수 있게 합니다.
3. CUPS 서비스를 시작하거나 활성화한 다음 `http://localhost:631`을 엽니다.

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

설치 후에는 먼저 CUPS가 큐를 인식하는지 확인하고, 그 다음 Gutenprint 관련 옵션이 실제로 노출되는지 확인하세요. 두 번째 명령은 큐가 지원하는 실제 옵션 이름을 보여주므로 특히 중요합니다.

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

2. CUPS에서 프린터 파라미터 설정하기

CUPS는 인쇄 큐, 기본 용지 동작, 드라이버 옵션을 결정합니다. 안전한 순서는 먼저 CUPS에 프린터를 추가하고, 일반 테스트 페이지를 출력한 뒤, 다시 3d2holo-desktop으로 돌아와 raster 출력을 사용하는 것입니다.

1. `http://localhost:631`을 열고 `Administration`으로 이동한 뒤 `Add Printer`를 선택합니다.
2. Epson 프린터를 선택하고 필요하면 인증한 뒤, 해당 모델에 맞는 Gutenprint 항목을 선택합니다.
3. 큐가 생성되면 프린터 페이지를 열고 `Set Default Options`를 사용합니다.

구체적인 파라미터는 아래 스크린샷을 그대로 참고해서 설정하세요.

3. 3d2holo-desktop에서 Raster 기능 사용하기

인쇄 큐가 준비되면 앱 안에서의 흐름은 비교적 단순합니다. raster 관련 컨트롤은 `FORMAT`을 `ras`로 바꿨을 때만 나타나고, 내보낸 파일 경로가 `.ras`일 때만 `Print` 버튼이 표시됩니다.

1. 출력할 이미지를 생성하는 2D, 3D, Sketchfab 또는 pitch-test 작업 공간을 엽니다.
2. Output 섹션에서 `FORMAT`을 `ras`로 변경합니다.
3. `RESOLUTION`은 `5760*2880` 프리셋을 선택합니다.
4. `DIRECTION`을 설정합니다. 일반적인 가로형 렌티큘러 레이아웃을 테스트한다면 먼저 `horizontal`부터 시작하고, 작은 테스트 인쇄로 방향을 확인하세요.
5. `PRINTER`와 `SIZE`를 선택해 작업이 올바른 CUPS 큐와 적절한 용지 형식으로 전송되도록 합니다.
6. `X OFFSET (IN)`과 `Y OFFSET (IN)`을 조정해 용지 위 실제 위치를 제어합니다. 데스크톱 레이아웃 미리보기는 raster 사각형을 내보내기 전에 중앙 정렬하거나 미세 조정하는 데 쓰입니다.
7. 내보내기를 실행합니다. 결과가 `.ras`로 저장되면 `Print` 버튼이 나타나 CUPS를 통해 직접 전송할 수 있습니다.
8. 전송 후에는 CUPS의 활성 큐와 앱의 인쇄 상태를 모두 확인해 작업이 실제로 큐에 들어갔는지 확인하세요.

UI에서 바로 보내고 싶지 않다면 같은 `.ras` 파일을 명령줄에서 CUPS로 보낼 수도 있습니다. 현재 desktop 코드에서는 `Resolution`, `PageSize`, `media`, `MediaType`, `StpMediaType`, `StpPrintingDirection=Unidirectional`가 명시적으로 전달됩니다. `DIRECTION`과 `X/Y OFFSET`은 이미 생성된 `.ras` 내용에 반영되어 있으므로 `lp` 명령에서 별도 옵션으로 다시 넣을 필요가 없습니다.

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

가장 자주 확인해야 하는 항목

• 앱이 프린터를 찾지 못한다고 표시하면 CUPS에 기본 프린터가 설정되어 있는지, 또는 `PRINTER` 필드에서 올바른 큐 이름을 선택했는지 확인하세요.
• 인쇄 위치가 어긋나면 CUPS의 `PageSize`와 앱의 `SIZE`가 정말 같은 용지 정의를 가리키는지 비교하세요.
• 출력 배율이 이상하면 앱의 raster 프리셋이 Gutenprint 큐의 실제 해상도와 일치하는지 확인하세요.
• 미디어 동작이 예상과 다르면 앱이 모든 Gutenprint 옵션을 덮어쓴다고 생각하지 말고, CUPS 큐 기본 옵션으로 돌아가 `media`와 관련 용지 설정을 확인하세요.