Harlequin RIP SDK
The "minrip" application layer

A minimal RIP integration example. More...

Files

file  skinmin.c
 Minimal RIP example code.
 

Macros

#define CONFIG_RIP
 Minimal RIP integration fixed RIP configuration. More...
 
#define CONFIG_JOB
 Minimal RIP integration job configuration. More...
 

Functions

static RASTER_result raster_start (void *pJobContext, RasterDescription *pRasterDescription, RASTER_handle *pHandle)
 Minimal RIP integration raster start handler. More...
 
static RASTER_result raster_writeband (void *pJobContext, RASTER_handle handle, RasterDescription *pRasterDescription, void *data, int32 topline, int32 nlines, int32 bytesperline, int32 plane)
 Minimal RIP integration raster band data handler. More...
 
static RASTER_result raster_finish (void *pJobContext, RASTER_handle *pHandle, RasterDescription *pRasterDescription, RASTER_result result)
 Minimal RIP integration raster end handler. More...
 
static RASTER_result blank_page (void *pJobContext, RASTER_handle *pHandle, RASTER_BLANK *pBlank, RasterDescription *pRasterDescription)
 Minimal RIP integration blank page handler. More...
 
static RASTER_result job_end (void *pJobContext, RASTER_handle *pHandle)
 Minimal RIP integration job end handler. More...
 
static void minripMonitorCallback (uint32 bufLen, const uint8 *u8buf)
 Minimal RIP integration log and monitor output handler.
 
int main (int argc, char *argv[])
 The "minrip" application entry point.
 

Variables

static sw_raster_api_20230105 minrip_raster_api
 Raster output functions for the "minrip" application layer.
 

Detailed Description

A minimal RIP integration example.

The "minrip" application layer is intended to be a bare-bones minimal Harlequin RIP integration example. It accepts test jobs from the command-line and processes them through the Harlequin RIP. All input files supplied must have absolute file paths, there is a fixed RIP configuration compiled into the source code, and the raster output functions discard the raster buffers produced by the RIP.

The main() function shows how to:

The function minripMonitorCallback() is connected to capture log output.

The raster data is captured and discarded by the registered minrip_raster_api raster backend, using the blank_page(), raster_start(), raster_writeband(), raster_finish(), and job_end() functions.

The "minrip" application does not handle Unicode file names, it does not support different configurations or different output backends, it does not support Scalable RIP, and it does not support hot folder or any other persistent input source of jobs. It is intended as a minimal example of how to link, start, run, and stop the RIP. See the "clrip" application for a fully-featured RIP integration.

Macro Definition Documentation

◆ CONFIG_JOB

#define CONFIG_JOB
Value:
"" \
"<< " \
" /NumDisplayLists 2 " /* Only works if valid password supplied */ \
" /MaxThreads 3 " /* Only works if valid password supplied */ \
">> setsystemparams "

Minimal RIP integration job configuration.

This is run as the configuration for each job submitted on the command line.

◆ CONFIG_RIP

#define CONFIG_RIP

Minimal RIP integration fixed RIP configuration.

This is run as a configuration job once at the start of processing, to set the base state for each command-line job.

Function Documentation

◆ blank_page()

static RASTER_result blank_page ( void *  pJobContext,
RASTER_handle pHandle,
RASTER_BLANK pBlank,
RasterDescription pRasterDescription 
)
static

Minimal RIP integration blank page handler.

This discards the data passed to it.

◆ job_end()

static RASTER_result job_end ( void *  pJobContext,
RASTER_handle pHandle 
)
static

Minimal RIP integration job end handler.

This discards the data passed to it.

◆ raster_finish()

static RASTER_result raster_finish ( void *  pJobContext,
RASTER_handle pHandle,
RasterDescription pRasterDescription,
RASTER_result  result 
)
static

Minimal RIP integration raster end handler.

This discards the data passed to it.

◆ raster_start()

static RASTER_result raster_start ( void *  pJobContext,
RasterDescription pRasterDescription,
RASTER_handle pHandle 
)
static

Minimal RIP integration raster start handler.

This discards the data passed to it.

◆ raster_writeband()

static RASTER_result raster_writeband ( void *  pJobContext,
RASTER_handle  handle,
RasterDescription pRasterDescription,
void *  data,
int32  topline,
int32  nlines,
int32  bytesperline,
int32  plane 
)
static

Minimal RIP integration raster band data handler.

This discards the data passed to it.