mirror of
https://github.com/daveallie/crosspoint-reader.git
synced 2026-02-04 22:57:50 +03:00
4ef35afb4d
- Add XTCH container format support (.xtch extension) - Add XTH page format with two bit-plane, column-major storage - Update XtcParser to handle both XTC/XTCH magic and XTG/XTH pages - Update XtcReaderActivity for XTH column-major rendering - Update cover BMP generation for 2-bit grayscale - Add README with format documentation XTH format details: - Two bit planes stored sequentially (Bit1, then Bit2) - Column-major order, scanned right to left - 8 vertical pixels per byte (MSB = topmost) - Grayscale: 0=White, 1=Dark Grey, 2=Light Grey, 3=Black
41 lines
1.2 KiB
Plaintext
41 lines
1.2 KiB
Plaintext
# XTC/XTCH Library
|
|
|
|
XTC ebook format support for CrossPoint Reader.
|
|
|
|
## Supported Formats
|
|
|
|
| Format | Extension | Description |
|
|
|--------|-----------|----------------------------------------------|
|
|
| XTC | `.xtc` | Container with XTG pages (1-bit monochrome) |
|
|
| XTCH | `.xtch` | Container with XTH pages (2-bit grayscale) |
|
|
|
|
## Format Overview
|
|
|
|
XTC/XTCH are container formats designed for ESP32 e-paper displays. They store pre-rendered bitmap pages optimized for the XTeink X4 e-reader (480x800 resolution).
|
|
|
|
### Container Structure (XTC/XTCH)
|
|
|
|
- 56-byte header with metadata offsets
|
|
- Optional metadata (title, author, etc.)
|
|
- Page index table (16 bytes per page)
|
|
- Page data (XTG or XTH format)
|
|
|
|
### Page Formats
|
|
|
|
#### XTG (1-bit monochrome)
|
|
|
|
- Row-major storage, 8 pixels per byte
|
|
- MSB first (bit 7 = leftmost pixel)
|
|
- 0 = Black, 1 = White
|
|
|
|
#### XTH (2-bit grayscale)
|
|
|
|
- Two bit planes stored sequentially
|
|
- Column-major order (right to left)
|
|
- 8 vertical pixels per byte
|
|
- Grayscale: 0=White, 1=Dark Grey, 2=Light Grey, 3=Black
|
|
|
|
## Reference
|
|
|
|
Original format info: <https://gist.github.com/CrazyCoder/b125f26d6987c0620058249f59f1327d>
|