ql_trim Struct Reference

Trim the input raster to the available media. More...

Data Fields
unsigned	raster_width
unsigned	raster_height
unsigned	medium_width
unsigned	medium_height
double	medium_width_mm
double	medium_height_mm
unsigned	top_skip
unsigned	top_offset
unsigned	top_keep
unsigned	left_skip
unsigned	left_offset
unsigned	left_keep

Detailed Description

If the input raster is wider or smaller than the physical print width of the QL printer, we need to trim it before sending it to the printer.

Horizontal:

Wider raster image:

        |<--------------------------- printable area width ----------------------------->|
        |<------------------------------ media width ----------------------------------->|
  |<---------------------------------  wider input raster  ---------------------------------->|
  |<--->|< "left_skip"
        |<------------------------------------------------------------------------------>| < "left_keep"

Smaller raster image:

        |<--------------------------- printable area width ----------------------------->|
        |<------------------------------ media width ----------------------------------->|
                |<-------------- smaller input raster ---------------->|
        |<----->|< "left_offset"
                |<---------------------------------------------------->| < "left_keep"

left_offset is based on required hardware margins.

Vertical:

On a continous length tape there is no vertical limit to consider.

Attention

All values are resolution dependend.

Field Documentation

raster_width

unsigned raster_width

Input raster dot count per line

raster_height

unsigned raster_height

Input raster line count

medium_width

unsigned medium_width

Output medium dot count per line, always equal to or smaller than the printable area

medium_height

unsigned medium_height

Output medium line count

medium_width_mm

double medium_width_mm

Output medium width [mm]

medium_height_mm

double medium_height_mm

Output medium length [mm]

top_skip

unsigned top_skip

Skip raster lines if the raster is higher than the medium

top_offset

unsigned top_offset

Empty lines on the medium before the top raster line

top_keep

unsigned top_keep

Use raster lines (below top_skip)

left_skip

unsigned left_skip

Skip raster dots from the left border if the raster is wider than the medium

left_offset

unsigned left_offset

Empty dots on the medium before the left dot

left_keep

unsigned left_keep

Use raster dots (right of left_skip)

---

The documentation for this struct was generated from the following file:

• caps-driver-collection/src/brother/ql/ql-series.h