CUPS rastertoql filter  1.0.4
Filter for the Brother QL family of label printers
Data Fields
ql_trim Struct Reference

Data Fields

unsigned raster_width
 
unsigned raster_height
 
unsigned media_width
 
unsigned media_height
 
float media_width_mm
 
float media_height_mm
 
unsigned top_skip
 
unsigned top_keep
 
unsigned left_skip
 
unsigned left_offset
 
unsigned left_keep
 

Detailed Description

Trim the input raster to the available media

Note
For a continuous length tape for now

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

◆ left_keep

unsigned ql_trim::left_keep

Use raster dots (right of left_skip)

◆ left_offset

unsigned ql_trim::left_offset

Empty dots on the media before the left dot

◆ left_skip

unsigned ql_trim::left_skip

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

◆ media_height

unsigned ql_trim::media_height

Output media line count

◆ media_height_mm

float ql_trim::media_height_mm

Output media length [mm]

◆ media_width

unsigned ql_trim::media_width

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

◆ media_width_mm

float ql_trim::media_width_mm

Output media width [mm]

◆ raster_height

unsigned ql_trim::raster_height

Input raster line count

◆ raster_width

unsigned ql_trim::raster_width

Input raster dot count per line

◆ top_keep

unsigned ql_trim::top_keep

Use raster lines (below top_skip)

◆ top_skip

unsigned ql_trim::top_skip

Skip raster lines at top and bottom, for pre-cut labels