Harlequin RIP SDK

#include "swraster.h"

Data Fields

intptr_t owner
 
int32 y
 
int32 h
 
HqBool final
 

Detailed Description

The SWEVT_BANDS_HANDLED event returns a band or bands to the RIP's control. This message is usually generated by the RIP skin (the PGB device or a client of it) to indicate that band(s) written to the PGB device have been handled, and the RIP can re-use any resources associated with them. If the memory for the band is owned by the PGB device or a client (e.g., when using BAND_ALLOC_FRAMEBUFFER or BAND_ALLOC_SKIN and the raster destination call or DeviceIOCtl_GetBufferForRaster ioctl to place bands), this call can be made by the RIP skin immediately, and the band(s) can be processed by the PGB device or output device at leisure. If the RIP supplied the band memory, then issuing a SWEVT_BANDS_HANDLED event is a contract that the client will not read, write, or modify the band memory again.

Field Documentation

◆ final

HqBool SWMSG_BANDS_HANDLED::final

This band range will not be requested again for this sheet. This is used to indicate that partial lines for RLE output may be retried.

◆ h

int32 SWMSG_BANDS_HANDLED::h

Height in lines of band range.

◆ owner

intptr_t SWMSG_BANDS_HANDLED::owner

The owner of the bands. This is expressed as an intptr_t for future-proofing. In the current PageBuffer implementations this is the PGB timeline reference.

◆ y

int32 SWMSG_BANDS_HANDLED::y

Top line (inclusive) of band range.


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