raster_adapt_preparation Struct Reference

Required adaptions from the document's content to the raster content. More...

Data Fields
struct caps_rect	source_sz
struct caps_area	source_area
int	source_area_used
struct caps_rect	source_print_sz
double	scale_x
double	scale_y
int	print_rotation
double	raster_resolution_x
double	raster_resolution_y
enum caps_colour_format	raster_cf
struct caps_rect	target_sz
struct caps_area	target_area
struct caps_rect	target_area_sz
double	raster_offset_x
double	raster_offset_y

Detailed Description

Note

Internally used only

The information herein is used to calculate the required adaptions from the document's content to the raster content.
At the end all this information is used to setup the caps_rstr_raster in order to reconstruct the line data the printer driver needs.

How the rasterizer should extract the content from its source document into the target raster.

Document matches the print medium in size and orientation

Printing an A4 portrait document on an A4 portrait medium is straight forward

• source_sz has the full size of the document's page
• source_area has the size of the document's page, reduced by the printer's margins
• source_area_used marks source_area as should be used
• target_sz has the full size of the document's page and available medium
• target_area has the size of the medium, reduced by the printer's margins and thus, equals to source_area
• print_rotation is '0'

Document matches the print medium in size, but not its orientation

Printing an A4 landscape document on an A4 portrait medium with (auto) rotation

• source_sz has the full size of the document's page
• source_area has the size and orientation of the document's page, reduced by the printer's margins. If the four margins differ, it is already considered in the source_area
• source_area_used marks source_area as should be used
• target_sz has the full size of the document's page and available medium and its different orientation
• target_area has the size and orientation of the medium, reduced by the printer's margins and thus, equals to source_area in size, but not its orientation
• print_rotation is '-90' (in this example)

Document matches the print medium orientation, but is smaller than the print medium

Printing an A5 portrait document on an A4 portrait medium

• source_sz and source_area have the full size of the document's page
• source_area_used marks source_area as not required
• target_sz has the full size of the medium
• target_area has the size and orientation of the document's page and thus, equals to source_sz and source_area, but is located in the center of target_sz
• print_rotation is '0'

Document has a different orientation and is smaller than the print medium

Printing an A5 landscape document on an A4 portrait medium

• source_sz and source_area have the full size of the document's page
• source_area_used marks source_area as not required
• target_sz has the full size of the medium and its orientation
• target_area has the size of the document's page, but the medium's orientation and thus, equals to source_sz and source_area in their size and to target_sz in its orientation and is located in the center of target_sz
• print_rotation is '-90' (in this example)

Document matches the print medium orientation, but is larger than the print medium

Printing an A3 portrait document on an A4 portrait medium

• source_sz has the full size of the document's page
• source_area has the size of the medium reduced by the margins and thus, is equal to target_area
• source_area_used marks source_area as should be used
• target_sz has the full size of the medium
• target_area has the size of the medium, reduced by the margins and thus, equals to source_area
• print_rotation is '0'

Document has a different orientation and is larger than the print medium

Printing an A3 landscape document on an A4 portrait medium

• source_sz has the full size of the document's page
• source_area has the size of the medium reduced by the margins, but the orientation of source_sz. If the four margins differ, it is already considered in the source_area
• source_area_used marks source_area as should be used
• target_sz has the full size of the medium and its orientation
• target_area has the size of the medium reduced by the margins and its orientation and thus, equals to source_area in size and to target_sz in orientation

• print_rotation is '-90' (in this example)

  Todo:

  This structure should replace the caps_rstr_page parameter for the rasterizer's mupdf_page_rasterize() call

Field Documentation

source_sz

struct caps_rect source_sz

Document's intendet page size, in [pts]

source_area

struct caps_area source_area

Document's content crop area. This area is taken from inside source_sz and should be used to create the final raster for printing, in [pts]
This member is always filled. If it defines a different area than source_sz, additionally source_area_used is not '0'

source_area_used

int source_area_used

'0' if you can ignore source_area. Not '0', source_area should be used

source_print_sz

struct caps_rect source_print_sz

Document's crop area as a size, for convinience, same as in source_area, in [pts] TODO irgendwie überflüssig

scale_x

double scale_x

Scale the source_sz caps_rect::width by this factor

scale_y

double scale_y

Scale the source_sz caps_rect::length by this factor TODO only one factor is required!

print_rotation

int print_rotation

Rotation from source_sz (view) to target_sz orientation, 0 °, +90 °, -90° or 180°

raster_resolution_x

double raster_resolution_x

Horizontal resolution, in relation to target_sz and its orientation, in [DPI]

raster_resolution_y

double raster_resolution_y

Vertical resolution, in relation to target_sz and its orientation, in [DPI]

raster_cf

enum caps_colour_format raster_cf

Colour format the raster should have

target_sz

struct caps_rect target_sz

Target print medium's size [pts]

target_area

struct caps_area target_area

Print device's imageable area on the target print medium in [pts], defines an area inside target_sz

target_area_sz

struct caps_rect target_area_sz

Print device's imageable area as a size, for convinience, same as in target_area, in [pts] TODO irgendwie überflüssig

raster_offset_x

double raster_offset_x

Horizontal offset of the raster image on the medium (medium's left edge to the raster's left dot), in [pts]

raster_offset_y

double raster_offset_y

Vertical offset of the raster image on the medium (medium's bottom up to the raster's bottom line), in [pts]

---

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

• libcapsraster/src/libcapsraster-local.h