Core RIP Dynamic Link Library Interface

Low-level functions for booting the RIP when it is encapsulated in its own dynamic library. More...

Files
file	dlliface.h
	Header file defining the Core RIP Dynamic Link Library Interface.

Data Structures
struct	DllFuncs

Typedefs
typedef struct DllFuncs	DllFuncs

Functions
HqBool	SwDllInit (SWSTART *start, DllFuncs *pDllFuncs)
	Initialise core RIP library. More...
void	SwDllStart (SWSTART *start, DllFuncs *pDllFuncs)
	Start running the core dynamic RIP library integration. More...
void	SwDllShutdown (void)
	Perform library shutdown after RIP termination. More...
void	SwDllWarn (uint8 *buffer)
	Issue a warning using the core RIP library integration callback function. More...

Detailed Description

Low-level functions for booting the RIP when it is encapsulated in its own dynamic library.

This is a wrapper layer to turn the core RIP into a DLL. When encapsulated in a DLL, some support functions are built into the library to provide required core RIP functions, and plug DEVICE-based file handling and memory into the unicode and other support libraries.

Note

If you are integrating the Harlequin RIP into your own application, you should not use these functions. Call the integration functions in the Harlequin RIP SDK to start the RIP, submit jobs to it, and stop it.

Copyright (C) 2023 Global Graphics Software Ltd. All rights reserved. This source code contains the confidential and trade secret information of Global Graphics Software Ltd. It may not be used, copied or distributed for any reason except as set forth in the applicable Global Graphics license agreement.

Typedef Documentation

DllFuncs

typedef struct DllFuncs DllFuncs

Callback functions for DLL library wrapping core RIP entry points.

Function Documentation

SwDllInit()

HqBool SwDllInit	(	SWSTART *	start,
		DllFuncs *	pDllFuncs
	)

Initialise core RIP library.

Parameters

[in]	start	An array of start structures, finished with an element containing a SWEndTag. The start structures should include memory settings, thread settings, pthreads, RDR API tags, and any other tags desirable.
[in]	pDllFuncs	A structure containing callback functions.

Return values

TRUE	If the RIP initialisation is successful.
FALSE	If the RIP initialisation failed.

Note that this function initialises the RIP global variables and allocates structures, but does not actually start running the RIP.

SwDllShutdown()

void SwDllShutdown

(

void

)

Perform library shutdown after RIP termination.

This function should be called after the RIP has been shut down, to terminate the core RIP library integration.

SwDllStart()

void SwDllStart	(	SWSTART *	start,
		DllFuncs *	pDllFuncs
	)

Start running the core dynamic RIP library integration.

Parameters

[in]	start	An array of start structures, finished with an element containing a SWEndTag. This may be the same array as passed to SwDllInit(), or may contain different start structures.
[in]	pDllFuncs	A structure containing callback functions.

This function does not return until the RIP exits.

SwDllWarn()

void SwDllWarn

(

uint8 *

buffer

)

Issue a warning using the core RIP library integration callback function.

Parameters

[in]

buffer

The message to issue through the warning function.