669 lines
15 KiB
C
669 lines
15 KiB
C
/*
|
|
* Canon SELPHY CPneo series CUPS backend
|
|
*
|
|
* (c) 2016-2024 Solomon Peachy <pizza@shaftnet.org>
|
|
*
|
|
* The latest version of this program can be found at:
|
|
*
|
|
* https://git.shaftnet.org/gitea/slp/selphy_print.git
|
|
*
|
|
* This program is free software; you can redistribute it and/or modify it
|
|
* under the terms of the GNU General Public License as published by the Free
|
|
* Software Foundation; either version 3 of the License, or (at your option)
|
|
* any later version.
|
|
*
|
|
* This program is distributed in the hope that it will be useful, but
|
|
* WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
|
|
* or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
|
|
* for more details.
|
|
*
|
|
* You should have received a copy of the GNU General Public License
|
|
* along with this program; if not, see <https://www.gnu.org/licenses/>.
|
|
*
|
|
* SPDX-License-Identifier: GPL-3.0+
|
|
*
|
|
*/
|
|
|
|
#define BACKEND canonselphyneo_backend
|
|
|
|
#include "backend_common.h"
|
|
|
|
/* Header data structure */
|
|
struct selphyneo_hdr {
|
|
uint8_t data[24];
|
|
uint32_t cols; /* LE */
|
|
uint32_t rows; /* LE */
|
|
} __attribute((packed));
|
|
|
|
/* Readback data structure */
|
|
struct selphyneo_readback {
|
|
uint8_t data[12];
|
|
} __attribute((packed));
|
|
|
|
/* Private data structure */
|
|
struct selphyneo_printjob {
|
|
struct dyesub_job_common common;
|
|
|
|
uint8_t *databuf;
|
|
uint32_t datalen;
|
|
};
|
|
|
|
struct selphyneo_ctx {
|
|
struct dyesub_connection *conn;
|
|
|
|
struct marker marker;
|
|
};
|
|
|
|
static const char *selphyneo_statuses(uint8_t sts)
|
|
{
|
|
switch(sts) {
|
|
case 0x01:
|
|
return "Idle";
|
|
case 0x02:
|
|
return "Feeding Paper";
|
|
case 0x04:
|
|
return "Printing YELLOW";
|
|
case 0x08:
|
|
return "Printing MAGENTA";
|
|
case 0x10:
|
|
return "Printing CYAN";
|
|
case 0x20:
|
|
return "Printing LAMINATE";
|
|
default:
|
|
return "Unknown state!";
|
|
}
|
|
}
|
|
|
|
static const char *selphyneo_errors(uint8_t err)
|
|
{
|
|
switch(err) {
|
|
case 0x00:
|
|
return "None";
|
|
case 0x01:
|
|
return "Low battery";
|
|
case 0x02:
|
|
return "Paper Feed (No Paper?)";
|
|
case 0x03:
|
|
return "No Paper Tray";
|
|
case 0x04:
|
|
return "Incorrect Paper Tray";
|
|
case 0x05:
|
|
return "Incorrect Paper loaded";
|
|
case 0x06:
|
|
return "Ink Cassette Empty";
|
|
case 0x07:
|
|
return "No Ink";
|
|
case 0x08:
|
|
return "Incorrect Ink loaded";
|
|
case 0x09:
|
|
return "No Paper and Ink";
|
|
case 0x0A:
|
|
return "Incorrect paper tray and ink for job";
|
|
case 0x0B:
|
|
return "Paper jam";
|
|
case 0x0C:
|
|
return "Ink jam";
|
|
case 0x0D:
|
|
return "Ink illegal";
|
|
case 0x0E:
|
|
return "Unknown Ink";
|
|
case 0x0F:
|
|
return "Unknown Paper";
|
|
case 0x10:
|
|
return "Unknown Command";
|
|
default:
|
|
return "Unknown Error";
|
|
}
|
|
}
|
|
|
|
static const char *selphynew_pgcodes(uint8_t type) {
|
|
|
|
switch (type & 0xf) {
|
|
case 0x01:
|
|
return "P";
|
|
case 0x02:
|
|
return "L";
|
|
case 0x03:
|
|
return "C";
|
|
case 0x00:
|
|
return "None";
|
|
default:
|
|
return "Unknown";
|
|
}
|
|
}
|
|
|
|
static const char *selphyneo_powers(uint8_t sts) {
|
|
|
|
switch (sts & 0x3) {
|
|
case 0x00:
|
|
return "Line Power";
|
|
case 0x01:
|
|
return "Battery OK";
|
|
case 0x03:
|
|
return "Battery Low";
|
|
default:
|
|
return "Unknown";
|
|
}
|
|
}
|
|
|
|
static int selphyneo_send_reset(struct selphyneo_ctx *ctx)
|
|
{
|
|
uint8_t rstcmd[12] = { 0x40, 0x10, 0x00, 0x00,
|
|
0x00, 0x00, 0x00, 0x00,
|
|
0x00, 0x00, 0x00, 0x00 };
|
|
int ret;
|
|
|
|
if ((ret = send_data(ctx->conn,
|
|
rstcmd, sizeof(rstcmd))))
|
|
return CUPS_BACKEND_FAILED;
|
|
|
|
return CUPS_BACKEND_OK;
|
|
}
|
|
|
|
static int selphyneo_get_status(struct selphyneo_ctx *ctx)
|
|
{
|
|
struct selphyneo_readback rdback;
|
|
int ret, num;
|
|
|
|
/* Read in the printer status to clear last state */
|
|
ret = read_data(ctx->conn,
|
|
(uint8_t*) &rdback, sizeof(rdback), &num);
|
|
|
|
if (ret < 0)
|
|
return CUPS_BACKEND_FAILED;
|
|
|
|
/* And again, for the markers */
|
|
ret = read_data(ctx->conn,
|
|
(uint8_t*) &rdback, sizeof(rdback), &num);
|
|
|
|
if (ret < 0)
|
|
return CUPS_BACKEND_FAILED;
|
|
|
|
INFO("Printer state: %s\n", selphyneo_statuses(rdback.data[0]));
|
|
INFO("Printer power state: %s\n", selphyneo_powers(rdback.data[7]));
|
|
INFO("Media type: %s\n", selphynew_pgcodes(rdback.data[6]));
|
|
if (rdback.data[2]) {
|
|
INFO("Printer error: %s\n", selphyneo_errors(rdback.data[2]));
|
|
}
|
|
|
|
return CUPS_BACKEND_OK;
|
|
}
|
|
|
|
static void *selphyneo_init(void)
|
|
{
|
|
struct selphyneo_ctx *ctx = malloc(sizeof(struct selphyneo_ctx));
|
|
if (!ctx) {
|
|
ERROR("Memory Allocation Failure!\n");
|
|
return NULL;
|
|
}
|
|
memset(ctx, 0, sizeof(struct selphyneo_ctx));
|
|
|
|
return ctx;
|
|
}
|
|
|
|
static int selphyneo_attach(void *vctx, struct dyesub_connection *conn, uint8_t jobid)
|
|
{
|
|
struct selphyneo_ctx *ctx = vctx;
|
|
struct selphyneo_readback rdback;
|
|
int ret, num;
|
|
|
|
UNUSED(jobid);
|
|
|
|
ctx->conn = conn;
|
|
|
|
if (test_mode < TEST_MODE_NOATTACH) {
|
|
/* Read in the printer status to clear last state */
|
|
ret = read_data(ctx->conn,
|
|
(uint8_t*) &rdback, sizeof(rdback), &num);
|
|
|
|
if (ret < 0)
|
|
return CUPS_BACKEND_FAILED;
|
|
|
|
/* And again, for the markers */
|
|
ret = read_data(ctx->conn,
|
|
(uint8_t*) &rdback, sizeof(rdback), &num);
|
|
|
|
if (ret < 0)
|
|
return CUPS_BACKEND_FAILED;
|
|
} else {
|
|
rdback.data[2] = 0;
|
|
rdback.data[6] = 0x01;
|
|
if (getenv("MEDIA_CODE"))
|
|
rdback.data[6] = strtol(getenv("MEDIA_CODE"), NULL, 16);
|
|
}
|
|
|
|
ctx->marker.color = "#00FFFF#FF00FF#FFFF00";
|
|
ctx->marker.name = selphynew_pgcodes(rdback.data[6]);
|
|
ctx->marker.numtype = rdback.data[6];
|
|
ctx->marker.levelmax = CUPS_MARKER_UNAVAILABLE;
|
|
if (rdback.data[2]) {
|
|
ctx->marker.levelnow = 0;
|
|
} else {
|
|
ctx->marker.levelnow = CUPS_MARKER_UNKNOWN_OK;
|
|
}
|
|
|
|
return CUPS_BACKEND_OK;
|
|
}
|
|
|
|
static void selphyneo_cleanup_job(const void *vjob) {
|
|
const struct selphyneo_printjob *job = vjob;
|
|
|
|
if (job->databuf)
|
|
free(job->databuf);
|
|
|
|
free((void*)job);
|
|
}
|
|
|
|
static int selphyneo_read_parse(void *vctx, const void **vjob, int data_fd, int copies)
|
|
{
|
|
struct selphyneo_ctx *ctx = vctx;
|
|
struct selphyneo_hdr hdr;
|
|
int i, remain;
|
|
|
|
struct selphyneo_printjob *job = NULL;
|
|
|
|
if (!ctx)
|
|
return CUPS_BACKEND_FAILED;
|
|
|
|
job = malloc(sizeof(*job));
|
|
if (!job) {
|
|
ERROR("Memory allocation failure!\n");
|
|
return CUPS_BACKEND_RETRY_CURRENT;
|
|
}
|
|
memset(job, 0, sizeof(*job));
|
|
job->common.jobsize = sizeof(*job);
|
|
job->common.copies = copies;
|
|
|
|
/* Read the header.. */
|
|
i = read(data_fd, &hdr, sizeof(hdr));
|
|
if (i != sizeof(hdr)) {
|
|
if (i == 0) {
|
|
selphyneo_cleanup_job(job);
|
|
return CUPS_BACKEND_CANCEL;
|
|
}
|
|
ERROR("Read failed (%d/%d)\n",
|
|
i, (int)sizeof(hdr));
|
|
perror("ERROR: Read failed");
|
|
selphyneo_cleanup_job(job);
|
|
return CUPS_BACKEND_FAILED;
|
|
}
|
|
|
|
/* Determine job length */
|
|
switch(hdr.data[18]) {
|
|
case 0x50: /* P */
|
|
case 0x4c: /* L */
|
|
case 0x43: /* C */
|
|
remain = le32_to_cpu(hdr.cols) * le32_to_cpu(hdr.rows) * 3;
|
|
break;
|
|
default:
|
|
ERROR("Unknown print size! (%02x, %ux%u)\n",
|
|
hdr.data[10], le32_to_cpu(hdr.cols), le32_to_cpu(hdr.rows));
|
|
selphyneo_cleanup_job(job);
|
|
return CUPS_BACKEND_CANCEL;
|
|
}
|
|
|
|
// XXX Sanity check job against loaded media?
|
|
|
|
/* Allocate a buffer */
|
|
job->datalen = 0;
|
|
job->databuf = malloc(remain + sizeof(hdr));
|
|
if (!job->databuf) {
|
|
ERROR("Memory allocation failure!\n");
|
|
selphyneo_cleanup_job(job);
|
|
return CUPS_BACKEND_RETRY_CURRENT;
|
|
}
|
|
|
|
/* Store the read-in header */
|
|
memcpy(job->databuf, &hdr, sizeof(hdr));
|
|
job->datalen += sizeof(hdr);
|
|
|
|
/* Read in data */
|
|
while (remain > 0) {
|
|
i = read(data_fd, job->databuf + job->datalen, remain);
|
|
if (i < 0) {
|
|
selphyneo_cleanup_job(job);
|
|
return CUPS_BACKEND_CANCEL;
|
|
}
|
|
remain -= i;
|
|
job->datalen += i;
|
|
}
|
|
|
|
*vjob = job;
|
|
|
|
return CUPS_BACKEND_OK;
|
|
}
|
|
|
|
static int selphyneo_main_loop(void *vctx, const void *vjob, int wait_for_return) {
|
|
struct selphyneo_ctx *ctx = vctx;
|
|
struct selphyneo_readback rdback;
|
|
|
|
int ret, num;
|
|
int copies;
|
|
|
|
const struct selphyneo_printjob *job = vjob;
|
|
|
|
if (!ctx)
|
|
return CUPS_BACKEND_FAILED;
|
|
if (!job)
|
|
return CUPS_BACKEND_FAILED;
|
|
|
|
copies = job->common.copies;
|
|
|
|
/* Read in the printer status to clear last state */
|
|
ret = read_data(ctx->conn,
|
|
(uint8_t*) &rdback, sizeof(rdback), &num);
|
|
|
|
if (ret < 0)
|
|
return CUPS_BACKEND_FAILED;
|
|
|
|
top:
|
|
INFO("Waiting for printer idle\n");
|
|
|
|
do {
|
|
ret = read_data(ctx->conn,
|
|
(uint8_t*) &rdback, sizeof(rdback), &num);
|
|
|
|
if (ret < 0)
|
|
return CUPS_BACKEND_FAILED;
|
|
|
|
if (rdback.data[0] == 0x01)
|
|
break;
|
|
|
|
INFO("Printer state: %s\n", selphyneo_statuses(rdback.data[0]));
|
|
|
|
switch (rdback.data[2]) {
|
|
case 0x00:
|
|
break;
|
|
case 0x0A:
|
|
ERROR("Printer error: %s (%02x)\n", selphyneo_errors(rdback.data[2]), rdback.data[2]);
|
|
ctx->marker.levelnow = 0;
|
|
dump_markers(&ctx->marker, 1, 0);
|
|
return CUPS_BACKEND_CANCEL;
|
|
default:
|
|
ERROR("Printer error: %s (%02x)\n", selphyneo_errors(rdback.data[2]), rdback.data[2]);
|
|
ctx->marker.levelnow = 0;
|
|
dump_markers(&ctx->marker, 1, 0);
|
|
return CUPS_BACKEND_STOP;
|
|
}
|
|
|
|
sleep(1);
|
|
} while(1);
|
|
|
|
dump_markers(&ctx->marker, 1, 0);
|
|
|
|
INFO("Sending spool data\n");
|
|
/* Send the data over in 256K chunks */
|
|
{
|
|
int chunk = 256*1024;
|
|
int sent = 0;
|
|
while (chunk > 0) {
|
|
if ((ret = send_data(ctx->conn,
|
|
job->databuf + sent, chunk)))
|
|
return CUPS_BACKEND_FAILED;
|
|
sent += chunk;
|
|
chunk = job->datalen - sent;
|
|
if (chunk > 256*1024)
|
|
chunk = 256*1024;
|
|
}
|
|
}
|
|
|
|
/* Read in the printer status to clear last state */
|
|
ret = read_data(ctx->conn,
|
|
(uint8_t*) &rdback, sizeof(rdback), &num);
|
|
|
|
if (ret < 0)
|
|
return CUPS_BACKEND_FAILED;
|
|
|
|
INFO("Waiting for printer acknowledgement\n");
|
|
do {
|
|
ret = read_data(ctx->conn,
|
|
(uint8_t*) &rdback, sizeof(rdback), &num);
|
|
|
|
if (ret < 0)
|
|
return CUPS_BACKEND_FAILED;
|
|
|
|
if (rdback.data[0] == 0x01)
|
|
break;
|
|
|
|
INFO("Printer state: %s\n", selphyneo_statuses(rdback.data[0]));
|
|
|
|
switch (rdback.data[2]) {
|
|
case 0x00:
|
|
break;
|
|
case 0x0A:
|
|
ERROR("Printer error: %s (%02x)\n", selphyneo_errors(rdback.data[2]), rdback.data[2]);
|
|
ctx->marker.levelnow = 0;
|
|
dump_markers(&ctx->marker, 1, 0);
|
|
return CUPS_BACKEND_CANCEL;
|
|
default:
|
|
ERROR("Printer error: %s (%02x)\n", selphyneo_errors(rdback.data[2]), rdback.data[2]);
|
|
ctx->marker.levelnow = 0;
|
|
dump_markers(&ctx->marker, 1, 0);
|
|
return CUPS_BACKEND_STOP;
|
|
}
|
|
|
|
if (rdback.data[0] > 0x02 && !wait_for_return && copies <= 1) {
|
|
INFO("Fast return mode enabled.\n");
|
|
break;
|
|
}
|
|
|
|
sleep(1);
|
|
} while(1);
|
|
|
|
/* Clean up */
|
|
if (terminate)
|
|
copies = 1;
|
|
|
|
INFO("Print complete (%d copies remaining)\n", copies - 1);
|
|
|
|
if (copies && --copies) {
|
|
goto top;
|
|
}
|
|
|
|
return CUPS_BACKEND_OK;
|
|
}
|
|
|
|
static int selphyneo_cmdline_arg(void *vctx, int argc, char **argv)
|
|
{
|
|
struct selphyneo_ctx *ctx = vctx;
|
|
int i, j = 0;
|
|
|
|
if (!ctx)
|
|
return -1;
|
|
|
|
while ((i = getopt(argc, argv, GETOPT_LIST_GLOBAL "Rs")) >= 0) {
|
|
switch(i) {
|
|
GETOPT_PROCESS_GLOBAL
|
|
case 'R':
|
|
selphyneo_send_reset(ctx);
|
|
break;
|
|
case 's':
|
|
selphyneo_get_status(ctx);
|
|
break;
|
|
}
|
|
|
|
if (j) return j;
|
|
}
|
|
|
|
return CUPS_BACKEND_OK;
|
|
}
|
|
|
|
static void selphyneo_cmdline(void)
|
|
{
|
|
DEBUG("\t\t[ -R ] # Reset printer\n");
|
|
DEBUG("\t\t[ -s ] # Query printer status\n");
|
|
}
|
|
|
|
static int selphyneo_query_markers(void *vctx, struct marker **markers, int *count)
|
|
{
|
|
struct selphyneo_ctx *ctx = vctx;
|
|
struct selphyneo_readback rdback;
|
|
int ret, num;
|
|
|
|
/* Read in the printer status to clear last state */
|
|
ret = read_data(ctx->conn,
|
|
(uint8_t*) &rdback, sizeof(rdback), &num);
|
|
|
|
if (ret < 0)
|
|
return CUPS_BACKEND_FAILED;
|
|
|
|
/* And again, for the markers */
|
|
ret = read_data(ctx->conn,
|
|
(uint8_t*) &rdback, sizeof(rdback), &num);
|
|
|
|
if (ret < 0)
|
|
return CUPS_BACKEND_FAILED;
|
|
|
|
if (rdback.data[2])
|
|
ctx->marker.levelnow = 0;
|
|
else
|
|
ctx->marker.levelnow = CUPS_MARKER_UNKNOWN_OK;
|
|
|
|
*markers = &ctx->marker;
|
|
*count = 1;
|
|
|
|
return CUPS_BACKEND_OK;
|
|
}
|
|
|
|
static const char *canonselphyneo_prefixes[] = {
|
|
"canonselphyneo", // Family name
|
|
// backwards compatibility
|
|
"selphycp820", "selphycp910", "selphycp1000", "selphycp1200", "selphycp1300",
|
|
NULL
|
|
};
|
|
|
|
static const struct device_id selphyneo_devices[] = {
|
|
{ 0x04a9, 0x327b, P_CP910, NULL, "canon-cp820"},
|
|
{ 0x04a9, 0x327a, P_CP910, NULL, "canon-cp910"},
|
|
{ 0x04a9, 0x32ae, P_CP910, NULL, "canon-cp1000"},
|
|
{ 0x04a9, 0x32b1, P_CP910, NULL, "canon-cp1200"},
|
|
{ 0x04a9, 0x32db, P_CP910, NULL, "canon-cp1300"},
|
|
{ 0x04a9, 0x3302, P_CP910, NULL, "canon-cp1500"},
|
|
{ 0, 0, 0, NULL, NULL}
|
|
};
|
|
|
|
const struct dyesub_backend canonselphyneo_backend = {
|
|
.name = "Canon SELPHY CP (new)",
|
|
.version = "0.24",
|
|
.uri_prefixes = canonselphyneo_prefixes,
|
|
.cmdline_usage = selphyneo_cmdline,
|
|
.cmdline_arg = selphyneo_cmdline_arg,
|
|
.init = selphyneo_init,
|
|
.attach = selphyneo_attach,
|
|
.cleanup_job = selphyneo_cleanup_job,
|
|
.read_parse = selphyneo_read_parse,
|
|
.main_loop = selphyneo_main_loop,
|
|
.query_markers = selphyneo_query_markers,
|
|
.devices = selphyneo_devices,
|
|
};
|
|
/*
|
|
|
|
***************************************************************************
|
|
|
|
Stream formats and readback codes for supported printers
|
|
|
|
***************************************************************************
|
|
Selphy CP820/CP910/CP1000/CP1200/CP1300/CP1500:
|
|
|
|
Radically different spool file format from older Selphy models.
|
|
300dpi, same nominal print sizes but slightly different dimensions.
|
|
|
|
There is also a "mini" 50mm sticker media, but I think the printer
|
|
treats them as 'C' size.
|
|
|
|
32-byte header:
|
|
|
|
0f 00 00 40 00 00 00 00 00 00 00 00 00 00 01 00
|
|
01 00 TT 00 00 00 00 ZZ XX XX XX XX YY YY YY YY
|
|
|
|
size cols (le32) rows (le32)
|
|
50 e0 04 50 07 1248 * 1872 (P)
|
|
4c 80 04 c0 05 1152 * 1472 (L)
|
|
43 40 04 9c 02 1088 * 668 (C)
|
|
|
|
ZZ == 00 YUV444 data follows
|
|
== 01 CMY data follows
|
|
|
|
Followed by three planes of image data:
|
|
|
|
P == 7008800 (2336256 * 3)
|
|
L == 5087264 (1695744 * 3)
|
|
C == 2180384 (726784 * 3)
|
|
|
|
RGB -> YUV444 is as follows:
|
|
|
|
Y = ( 77 * R + 150 * G + 29 * B + 128 ) >> 8
|
|
U = ( ( -43 * R + 85 * G + 128 * B + 128 ) >> 8 ) + 128
|
|
V = ( ( 128 * R - 107 * G - 21 * B + 128 ) >> 8 ) + 128
|
|
|
|
Other questions:
|
|
|
|
* Printer supports different lamination types, how to control?
|
|
- Glossy
|
|
- Pattern 1 (Matte)
|
|
- Pattern 2 (Fine Matte)
|
|
- Pattern 3 (Grid - not all models?)
|
|
|
|
Data Readback:
|
|
|
|
XX 00 YY 00 00 00 ZZ PP 00 00 00 00
|
|
|
|
XX == Status
|
|
|
|
01 Idle
|
|
02 Feeding Paper
|
|
04 Printing Y
|
|
08 Printing M
|
|
10 Printing C
|
|
20 Printing L
|
|
|
|
YY == Error
|
|
|
|
00 None
|
|
02 No Paper (?)
|
|
03 No Paper
|
|
05 Wrong Paper
|
|
07 No Ink
|
|
09 No Paper and Ink
|
|
0A Media/Job mismatch
|
|
0B Paper Jam
|
|
|
|
ZZ == Media
|
|
|
|
01
|
|
10
|
|
11
|
|
^-- Ribbon
|
|
^-- Paper
|
|
|
|
1 == P
|
|
2 == L
|
|
3 == C
|
|
|
|
PP == Power state
|
|
|
|
00 = A/C power
|
|
01 = Battery OK
|
|
03 = Battery Low
|
|
|
|
Also, the first time a readback happens after plugging in the printer:
|
|
|
|
34 44 35 31 01 00 01 00 01 00 45 00 "4D51" ...??
|
|
34 44 35 31 01 00 01 00 01 00 54 00 [also seen..]
|
|
|
|
|
|
** ** ** ** This is what windows sends if you print over the network:
|
|
|
|
00 00 00 00 40 00 00 00 02 00 00 00 00 00 04 00 Header [unknown]
|
|
00 00 02 00 00 00 00 00 00 00 00 00 00 00 00 00
|
|
00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00
|
|
00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00
|
|
|
|
00 00 01 00 HH HH HH HH 02 00 00 00 PP PP PP PP Header2 [unknown] PP == payload len, HH == payload + header2 len [ie + 3 ]
|
|
CC CC CC CC RR RR RR RR 00 00 00 00 LL LL LL LL CC == cols, RR == rows, LL == plane len (ie RR * CC)
|
|
L2 L2 L2 L2 L2 == LL * 2, apparently.
|
|
|
|
[ ..followed by three planes of LL bytes, totalling PP bytes.. ]
|
|
|
|
*/
|