# duy12i1i7/canon-lbp2900-for-macos architecture

> Architecture diagram of the GitHub repository duy12i1i7/canon-lbp2900-for-macos, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-06). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/duy12i1i7/canon-lbp2900-for-macos
- Repository: https://github.com/duy12i1i7/canon-lbp2900-for-macos

## Overview

This repository provides a macOS CUPS driver for the Canon LBP2900: a print job is rasterized, converted to CAPT/Hi-SCoA data, and sent through CUPS’ USB backend to the printer. The driver also reports page progress and media-empty status for the native queue, with separate progress-monitoring tools. The graph follows documented flow and sampled source references; detailed wiring inside unsampled installer and status-monitoring code is not inferred.

Main entry points: [`captdriver/src/rastertocapt.c`](https://github.com/duy12i1i7/canon-lbp2900-for-macos/blob/main/captdriver/src/rastertocapt.c) (CAPT filter), [`captdriver/src/prn_lbp2900.c`](https://github.com/duy12i1i7/canon-lbp2900-for-macos/blob/main/captdriver/src/prn_lbp2900.c) (Printer operations), [`captdriver/src/generic-ops.c`](https://github.com/duy12i1i7/canon-lbp2900-for-macos/blob/main/captdriver/src/generic-ops.c) (Band operations), [`captdriver/src/hiscoa-compress.c`](https://github.com/duy12i1i7/canon-lbp2900-for-macos/blob/main/captdriver/src/hiscoa-compress.c) (Hi-SCoA compression)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_print_entry["CUPS print entry"]
  node_cups["CUPS print system"]
  node_rasterize["PDF rasterization"]
end

subgraph group_driver["CAPT driver"]
  node_filter["CAPT filter<br/>[rastertocapt.c]"]
  node_dimensions["Page dimensions<br/>[paper.c]"]
  node_printer_ops["Printer operations<br/>[prn_lbp2900.c]"]
  node_printer_api["Printer interface<br/>[printer.h]"]
  node_generic_ops["Band operations<br/>[generic-ops.c]"]
  node_compress["Hi-SCoA compression<br/>[hiscoa-compress.c]"]
  node_hiscoa_params["Hi-SCoA parameters<br/>[hiscoa-common.c]"]
  node_capt_commands["CAPT commands<br/>[capt-command.c]"]
  node_capt_status["CAPT status<br/>[capt-status.c]"]
end

subgraph group_monitor["Progress and status"]
  node_queue["Native print queue"]
  node_menubar["Menu-bar progress app"]
  node_progress_script["Progress CLI<br/>[progress.sh]"]
end

subgraph group_printer["Printer and configuration"]
  node_usb["CUPS USB backend"]
  node_device["LBP2900 printer"]
  node_ppd["Printer description"]
end

node_user(("Print user"))

node_user -->|"submits job"| node_cups
node_cups -->|"rasterizes PDF"| node_rasterize
node_rasterize -->|"passes raster"| node_filter
node_filter -->|"sets page dimensions"| node_dimensions
node_filter -.->|"dispatches printer work"| node_printer_ops
node_printer_ops -->|"uses band operations"| node_generic_ops
node_generic_ops -->|"compresses bands"| node_compress
node_compress -->|"uses format parameters"| node_hiscoa_params
node_printer_ops -->|"sends CAPT commands"| node_capt_commands
node_printer_ops -->|"polls printer status"| node_capt_status
node_generic_ops -->|"sends print data"| node_capt_commands
node_filter -->|"streams CAPT data"| node_usb
node_usb -->|"communicates over USB"| node_device
node_ppd -->|"describes printer queue"| node_cups
node_filter -->|"reports page and media status"| node_queue
node_queue -->|"provides job progress"| node_menubar
node_queue -->|"provides job counters"| node_progress_script

click node_filter "https://github.com/duy12i1i7/canon-lbp2900-for-macos/blob/main/captdriver/src/rastertocapt.c"
click node_dimensions "https://github.com/duy12i1i7/canon-lbp2900-for-macos/blob/main/captdriver/src/paper.c"
click node_printer_ops "https://github.com/duy12i1i7/canon-lbp2900-for-macos/blob/main/captdriver/src/prn_lbp2900.c"
click node_printer_api "https://github.com/duy12i1i7/canon-lbp2900-for-macos/blob/main/captdriver/src/printer.h"
click node_generic_ops "https://github.com/duy12i1i7/canon-lbp2900-for-macos/blob/main/captdriver/src/generic-ops.c"
click node_compress "https://github.com/duy12i1i7/canon-lbp2900-for-macos/blob/main/captdriver/src/hiscoa-compress.c"
click node_hiscoa_params "https://github.com/duy12i1i7/canon-lbp2900-for-macos/blob/main/captdriver/src/hiscoa-common.c"
click node_capt_commands "https://github.com/duy12i1i7/canon-lbp2900-for-macos/blob/main/captdriver/src/capt-command.c"
click node_capt_status "https://github.com/duy12i1i7/canon-lbp2900-for-macos/blob/main/captdriver/src/capt-status.c"
click node_ppd "https://github.com/duy12i1i7/canon-lbp2900-for-macos/blob/main/ppd/CanonLBP-2900-3000.ppd"
click node_menubar "https://github.com/duy12i1i7/canon-lbp2900-for-macos/blob/main/menubar/LBP2900Progress.swift"
click node_progress_script "https://github.com/duy12i1i7/canon-lbp2900-for-macos/blob/main/progress.sh"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_cups,node_rasterize,node_user toneBlue
class node_filter,node_dimensions,node_printer_ops,node_printer_api,node_generic_ops,node_compress,node_hiscoa_params,node_capt_commands,node_capt_status toneAmber
class node_queue,node_menubar,node_progress_script toneMint
class node_usb,node_device,node_ppd toneRose
```

## Components

### CUPS print entry

- **CUPS print system**
- **PDF rasterization**

### CAPT driver

- [CAPT filter](https://github.com/duy12i1i7/canon-lbp2900-for-macos/blob/main/captdriver/src/rastertocapt.c): `captdriver/src/rastertocapt.c`
- [Page dimensions](https://github.com/duy12i1i7/canon-lbp2900-for-macos/blob/main/captdriver/src/paper.c): `captdriver/src/paper.c`
- [Printer operations](https://github.com/duy12i1i7/canon-lbp2900-for-macos/blob/main/captdriver/src/prn_lbp2900.c): `captdriver/src/prn_lbp2900.c`
- [Printer interface](https://github.com/duy12i1i7/canon-lbp2900-for-macos/blob/main/captdriver/src/printer.h): `captdriver/src/printer.h`
- [Band operations](https://github.com/duy12i1i7/canon-lbp2900-for-macos/blob/main/captdriver/src/generic-ops.c): `captdriver/src/generic-ops.c`
- [Hi-SCoA compression](https://github.com/duy12i1i7/canon-lbp2900-for-macos/blob/main/captdriver/src/hiscoa-compress.c): `captdriver/src/hiscoa-compress.c`
- [Hi-SCoA parameters](https://github.com/duy12i1i7/canon-lbp2900-for-macos/blob/main/captdriver/src/hiscoa-common.c): `captdriver/src/hiscoa-common.c`
- [CAPT commands](https://github.com/duy12i1i7/canon-lbp2900-for-macos/blob/main/captdriver/src/capt-command.c): `captdriver/src/capt-command.c`
- [CAPT status](https://github.com/duy12i1i7/canon-lbp2900-for-macos/blob/main/captdriver/src/capt-status.c): `captdriver/src/capt-status.c`

### Progress and status

- **Native print queue**
- [Menu-bar progress app](https://github.com/duy12i1i7/canon-lbp2900-for-macos/blob/main/menubar/LBP2900Progress.swift): `menubar/LBP2900Progress.swift`
- [Progress CLI](https://github.com/duy12i1i7/canon-lbp2900-for-macos/blob/main/progress.sh): `progress.sh`

### Printer and configuration

- **CUPS USB backend**
- **LBP2900 printer**
- [Printer description](https://github.com/duy12i1i7/canon-lbp2900-for-macos/blob/main/ppd/CanonLBP-2900-3000.ppd): `ppd/CanonLBP-2900-3000.ppd`

### Other components

- **Print user**

## Connections

- Print user → CUPS print system: submits job (evidence: `README.md`)
- CUPS print system → PDF rasterization: rasterizes PDF (evidence: `README.md`)
- PDF rasterization → CAPT filter: passes raster (evidence: `README.md`)
- CAPT filter → Page dimensions: sets page dimensions (evidence: `captdriver/src/rastertocapt.c`)
- CAPT filter → Printer operations: dispatches printer work
- Printer operations → Band operations: uses band operations (evidence: `captdriver/src/prn_lbp2900.c`)
- Band operations → Hi-SCoA compression: compresses bands (evidence: `captdriver/src/generic-ops.c`)
- Hi-SCoA compression → Hi-SCoA parameters: uses format parameters (evidence: `captdriver/src/hiscoa-compress.c`)
- Printer operations → CAPT commands: sends CAPT commands (evidence: `captdriver/src/prn_lbp2900.c`)
- Printer operations → CAPT status: polls printer status (evidence: `captdriver/src/prn_lbp2900.c`)
- Band operations → CAPT commands: sends print data (evidence: `captdriver/src/generic-ops.c`)
- CAPT filter → CUPS USB backend: streams CAPT data (evidence: `README.md`)
- CUPS USB backend → LBP2900 printer: communicates over USB (evidence: `README.md`)
- Printer description → CUPS print system: describes printer queue (evidence: `README.md`)
- CAPT filter → Native print queue: reports page and media status (evidence: `README.md`)
- Native print queue → Menu-bar progress app: provides job progress (evidence: `README.md`)
- Native print queue → Progress CLI: provides job counters (evidence: `README.md`)
