SDK support for eHVD output

Raster backend support for eHVD output. More...

Files
file	hvdmemfb.h
	Support for local memory framebuffers for eHVD elements.
file	hvdoutput.h
	This file declares functions that can be used to composite eHVD elements and output the composed raster through the raster backend API.
file	hvdrstore.h
	Support for using the Raster Store API for eHVD elements.
file	hvdshmfb.h
	Support for shared memory framebuffers for eHVD elements. This allows a Scalable RIP to share eHVD elements across the entire RIP farm, without needing coordination from a raster manager or central controller.
file	hvdmemfb.c
	Support for local memory framebuffers for eHVD elements.
file	hvdoutput.c
	Support for raster output of composited external Harlequin VariData elements.
file	hvdrstore.c
	Support for raster store API for eHVD elements.
file	hvdshmfb.c
	Support for shared memory framebuffers for eHVD elements. This allows a Scalable RIP to share eHVD elements across the entire RIP farm, without needing coordination from a raster manager or central controller.

Data Structures
struct	hvd_output_page_params
	Structure to carry parameters and callback functions for compositing and outputting an eHVD page. More...

Macros
#define	MEMFB_CACHEAPI_NAME   "MEMFB"
	Name used to register the local memory framebuffer HVD cache implementation in RDR.
#define	RSTORE_CACHEAPI_NAME   "RASTERSTORE"
	Name used to register the raster store HVD cache implementation in RDR.
#define	SHMFB_CACHEAPI_NAME   "SHMFB"
	Name used to register the shared memory framebuffer HVD cache implementation in RDR.

Typedefs
typedef struct hvd_output_page_params	hvd_output_page_params
	Structure to carry parameters and callback functions for compositing and outputting an eHVD page.

Enumerations
enum	{ HVD_LOG_TIMING = 1 }
	Bitmask of options for the hvd_output_page_params::progress field. More...

Functions
HqBool	memfb_cache_register (void)
	Register the local memory framebuffer HVD cache implementation in RDR.
void	memfb_cache_deregister (void)
	Deregister the local memory framebuffer HVD cache implementation from RDR.
const RasterDescription *	memfb_raster_description (void *elementRaster)
	Function to use as hvd_output_page_params::raster_description_fn when using local memory elements. More...
void *	memfb_element_raster_open (void *elementRaster, struct RASTER_PLANE *plane, HqnResult *perr)
	Function to use as hvd_output_page_params::element_raster_open when using local memory elements. More...
const uint8 *	memfb_element_raster_map (void *context, void *elementRaster, unsigned int *pstartline, unsigned int *pnlines, HqnResult *perr)
	Function to use as hvd_output_page_params::element_raster_map when using local memory elements. More...
void	memfb_element_raster_close (void *context, void *elementRaster)
	Function to use as hvd_output_page_params::element_raster_close when using local memory elements. More...
HVD_result	hvd_output_page (const struct HVD_page_output *page, hvd_output_page_params *params)
	Common support callback function for raster backends implementing libHVD to output an HVD page. More...
int	hvd_default_cache_policy (void)
	Get the default cache policy, allowing overriding of default values to avoid having to recompile debug RIPs.
HqBool	rstore_cache_register (void)
	Register the raster store HVD cache implementation in RDR.
void	rstore_cache_deregister (void)
	Deregister the raster store HVD cache implementation from RDR.
const RasterDescription *	rstore_raster_description (void *elementRaster)
	Function to use as hvd_output_page_params::raster_description_fn when using raster store elements. More...
void *	rstore_element_raster_open (void *elementRaster, struct RASTER_PLANE *plane, HqnResult *perr)
	Function to use as hvd_output_page_params::element_raster_open when using raster store elements. More...
const uint8 *	rstore_element_raster_map (void *context, void *elementRaster, unsigned int *pstartline, unsigned int *pnlines, HqnResult *perr)
	Function to use as hvd_output_page_params::element_raster_map when using raster store elements. More...
void	rstore_element_raster_close (void *context, void *elementRaster)
	Function to use as hvd_output_page_params::element_raster_close when using raster store elements. More...
HqBool	shmfb_cache_register (void)
	Register the shared memory framebuffer HVD cache implementation in RDR.
void	shmfb_cache_deregister (void)
	Deregister the shared memory framebuffer HVD cache implementation from RDR.
const RasterDescription *	shmfb_raster_description (void *elementRaster)
	Function to use as hvd_output_page_params::raster_description_fn when using shared memory elements. More...
void *	shmfb_element_raster_open (void *elementRaster, struct RASTER_PLANE *plane, HqnResult *perr)
	Function to use as hvd_output_page_params::element_raster_open when using shared memory elements. More...
const uint8 *	shmfb_element_raster_map (void *context, void *elementRaster, unsigned int *pstartline, unsigned int *pnlines, HqnResult *perr)
	Function to use as hvd_output_page_params::element_raster_map when using shared memory elements. More...
void	shmfb_element_raster_close (void *context, void *elementRaster)
	Function to use as hvd_output_page_params::element_raster_close when using shared memory elements. More...

Detailed Description

Raster backend support for eHVD output.

These support functions can be used to composite eHVD elements and output the composed raster through the raster backend API (Raster backend output API). This allows the same raster backend implementation to be used for eHVD output as non-eHVD output.

Enabling eHVD in Raster output backends

The Harlequin SDK provides functions to make it easy to enable eHVD output in raster backends using libHVD (see eHVD support library and SDK support for eHVD output). In the simplest case this involves:

• Decide how to store elements. The raster backend will store the element rasters itself, and add them to the HVD monitor using an opaque reference and textual ID, but the cache functions need HVD_cache_fns::raster_release() and HVD_cache_fns::raster_find() methods, and optionally HVD_cache_fns::recovery_filter() and HVD_cache_fns::raster_purge() methods. If using the hvd_output_page() function to composite and output, the output page params needs the hvd_output_page_params::raster_description_fn(), hvd_output_page_params::element_raster_open(), hvd_output_page_params::element_raster_map(), and hvd_output_page_params::element_raster_close() methods. libHVD provides two non-instantiable cache implementations that may be copied and specialized for the element storage. The Harlequin RIP SDK contains specializations of these for local memory framebuffers (declared in hvdmemfb.h, registered in RDR using MEMFB_CACHEAPI_NAME); shared memory framebuffers (declared in hvdshmfb.h, registered in RDR using SHMFB_CACHEAPI_NAME); and compressible, purgeable raster stores (declared in hvdrstore.h, registered in RDR using RSTORE_CACHEAPI_NAME). Each of these headers declares functions that will be used in some of the remaining steps below. If none of these element storage methods are appropriate, the libHVD cache implementations LIBHVD_BASE (for process-memory caches) or LIBHVD_SHM_BASE (for shared-memory caches) may be copied and specialized for an appropriate storage method, and registered in RDR under a new name. The Scalable RIP also provides one non-instantiable cache implementation to communicate with a remote cache hosted in the "libripfarm" library (registered in RDR as "RIPFARM_BASE", see RIP Farm: API and Library to split jobs across multiple RIPs), and an instantiable specialization of this cache for use with shared memory framebuffers (registered in RDR as "RIPFARM_SHM"). If required, the "RIPFARM_BASE" cache may be discovered, copied and specialized for an alternate storage method, and registered in RDR under a new name. All of the cache API names are registered as named RDRs of class RDR_NAMES_LIBHVD_CACHE_API.
• Add a page output function of the HVD_page_output_fn type to the raster backend. This will usually be a small trampoline function that constructs an hvd_output_page_params structure, and calls hvd_output_page().
• Add a connection verification function of the HVD_connect_verify_fn type to the raster backend. This will usually be a simple function that calls GetPageBufferType(), and compares the result to the expected raster backend's name. This function is used to ensure that a configuration that targets eHVD is connected to the correct event monitor, tracker and cache handler for the raster backend it is serving.
• Construct an HVD_monitor_params structure containing an eHVD cache ID chosen for the raster back end; the page output and verification functions; and the appropriate raster release, recovery, and purge functions for the element storage methods chosen. During SDK initialisation, call HVD_monitor_start() with this parameter structure, and save the HVD monitor reference returned.
• In the raster backend's raster start function (RASTER_START_EX), check if the raster being presented has an OptimizedPDFId, and call HVD_monitor_connected() to check whether the HVD monitor created in the previous step is connected. If so, this is an eHVD element targetted at this backend. Create the element storage using the create function for the storage type chosen, and save the element storage handle returned.
• In the raster backend's raster data function (RASTER_WRITE_DATA_EX), call the appropriate function to write data to the element storage. If using a framebuffer storage method, the raster backend's SwLeRASTERDESTINATION function will be set instead to enable the RIP to write data directly into the framebuffer memory.
• In the raster backend's raster finish function (RASTER_FINISH_EX), call HVD_monitor_add_raster() with the element handle to make libHVD aware that the element is now complete. Alternatively, if there was an error constructing the element, the element storage methods provide functions to indicate that an element handle is invalid, and should be destroyed.
• In the raster backend's blank page function (SwLeBLANKPAGECALLBACK), check if the raster being presented has an OptimizedPDFId, and call HVD_monitor_connected() to check whether the HVD monitor created in the previous step is connected. If so, this is an empty eHVD element targetted at this backend. Either set the blank page action to BLANK_PAGE_OUTPUT, or set the blank page action to BLANK_PAGE_COUNT and call HVD_monitor_add_raster() to add a single empty raster with and empty raster ID and zero size to the element.

There are worked examples of this process present in several of the raster backends provided with the distributed application layers.

Using local memory framebuffers for eHVD

To use local memory framebuffers for storage and output of eHVD elements, the libHVD event monitor needs to be configured to use the local memory framebuffer raster release and recovery functions, and the HVD output function should be called with the local memory framebuffer access functions.

Before calling hvd_output_page(), the hvd_output_page_params::raster_description_fn field should be set to the memfb_raster_description function pointer, hvd_output_page_params::element_raster_open should be set to the memfb_element_raster_open function pointer, hvd_output_page_params::element_raster_map should be set to the memfb_element_raster_map function pointer, and hvd_output_page_params::element_raster_close should be set to the memfb_element_raster_close function pointer.

Using raster stores for eHVD

To use raster stores for storage and output of eHVD elements, the libHVD event monitor needs to be configured to use the raster store release and recovery functions, and the HVD output function should be called with the raster store framebuffer access functions.

Before calling hvd_output_page(), the hvd_output_page_params::raster_description_fn field should be set to the rstore_raster_description function pointer, hvd_output_page_params::element_raster_open should be set to the rstore_element_raster_open function pointer, hvd_output_page_params::element_raster_map should be set to the rstore_element_raster_map function pointer, and hvd_output_page_params::element_raster_close should be set to the rstore_element_raster_close function pointer.

Using shared memory framebuffers for eHVD

To use shared memory framebuffers for storage and output of eHVD elements, the libHVD event monitor needs to be configured to use the shared memory framebuffer raster release and recovery functions, and the HVD output function should be called with the shared memory framebuffer access functions.

Before calling the libHVD HVD_monitor_start() function, the HVD_monitor_params::cache_fns field should be set to the return value of HVD_shmfb_cache().

Before calling hvd_output_page(), the hvd_output_page_params::raster_description_fn field should be set to the shmfb_raster_description function pointer, hvd_output_page_params::element_raster_open should be set to the shmfb_element_raster_open function pointer, hvd_output_page_params::element_raster_map should be set to the shmfb_element_raster_map function pointer, and hvd_output_page_params::element_raster_close should be set to the shmfb_element_raster_close function pointer.

Enumeration Type Documentation

anonymous enum

anonymous enum

Bitmask of options for the hvd_output_page_params::progress field.

Enumerator
HVD_LOG_TIMING	Log separation and page combined compositing and output timing information on MON_CHANNEL_PROGRESS.

Function Documentation

hvd_output_page()

HVD_result hvd_output_page	(	const struct HVD_page_output *	page,
		hvd_output_page_params *	params
	)

Common support callback function for raster backends implementing libHVD to output an HVD page.

Parameters

[in]	page	The output page description from libHVD.
[in,out]	params	Callback functions and parameter data.

Return values

HVD_SUCCESS

The page was output successfully

Returns

One of the HVD_ERROR_* error codes, or any other return value greater than MON_CLASS_ERROR is an error UID. HVD_ERROR_* codes should be translated to monitor UID errors using HVD_result_translate(). The error subclass, PS error type, and UID for the error can be deconstructed using the macros in monevent.h.

memfb_element_raster_close()

void memfb_element_raster_close	(	void *	context,
		void *	elementRaster
	)

Function to use as hvd_output_page_params::element_raster_close when using local memory elements.

The context parameter will previously have been created by shmfb_element_raster_open().

The elementRaster parameter will previously have been created by shmfb_raster_create().

Parameters

[in]	context	A raster mapping context previously returned by hvd_output_page_params::element_raster_open().
[in]	elementRaster	A raster handle previously attached to an HVD element using one of libHVD's HVD_tracker_element_add_raster(), HVD_element_add_raster() or HVD_monitor_add_raster() functions.

memfb_element_raster_map()

const uint8* memfb_element_raster_map	(	void *	context,
		void *	elementRaster,
		unsigned int *	pstartline,
		unsigned int *	pnlines,
		HqnResult *	perr
	)

Function to use as hvd_output_page_params::element_raster_map when using local memory elements.

The context parameter will previously have been created by memfb_element_raster_open().

The elementRaster parameter will previously have been created by memfb_raster_create().

Parameters

[in]	context	A raster mapping context previously returned by element_raster_open().
[in]	elementRaster	A raster handle previously attached to an HVD element using one of libHVD's HVD_tracker_element_add_raster(), HVD_element_add_raster() or HVD_monitor_add_raster() functions.
[in,out]	pstartline	A pointer to the first line of data requested from the element raster. On a successful exit, this is updated to the first line of data represented in the buffer. This may be larger than the first line requested, if the element raster did not store data for the requested start line.
[in,out]	pnlines	A pointer to the number of lines of data requested from the element raster. On a successful exit, this is updated to the number of lines of data represented in the buffer. This may be smaller than the number of lines requested, if the element raster did not have data stored for all of the requested lines.
[out]	perr	A location in which an error code is stored, if the raster context could not be acquired or created.

Returns

A pointer to data representing the lines in the updated pstartline and *pnlines range, or NULL if there was an error getting the data. This data is owned by the element, and must not be modified by the client. This pointer remains valid until the next call to hvd_output_page_params::element_raster_map() using the same raster mapping context, or until hvd_output_page_params::element_raster_close() is called.

If the pointer returned is non-NULL, then *perr is not modified. If the pointer returned is NULL, then *perr is either HQN_RESULT_SUCCESS, indicating there was no data in the range requested; or it is a code greater than MON_CLASS_ERROR indicating the error that occurred. The subclass, PS error type, and UID for the error can be deconstructed using the macros in monevent.h.

If there was no data in the range requested, then NULL is returned, *perr is set to HQN_RESULT_SUCCESS, *pnlines is updated to zero and *pstartline is updated to the end of the requested range.

In all cases the element raster mapping context is still open, and requires closing using hvd_output_page_params::element_raster_close().

memfb_element_raster_open()

void* memfb_element_raster_open	(	void *	elementRaster,
		struct RASTER_PLANE *	plane,
		HqnResult *	perr
	)

Function to use as hvd_output_page_params::element_raster_open when using local memory elements.

The elementRaster parameter will previously have been created by memfb_raster_create().

Parameters

[in]	elementRaster	A raster handle previously attached to an HVD element using one of libHVD's HVD_tracker_element_add_raster(), HVD_element_add_raster() or HVD_monitor_add_raster() functions.
[in]	plane	A raster plane to map buffers from.
[out]	perr	A location in which an error code is stored, if the raster context could not be acquired or created.

Returns

A raster context that will be passed to hvd_output_page_params::element_raster_map(), or NULL on error. If this is non-NULL, a corresponding call to hvd_output_page_params::element_raster_close() will be made after mapping buffers for plane.

If the pointer returned is non-NULL, then *perr is not modified. If the pointer returned is NULL, then *perr is set to a code greater than MON_CLASS_ERROR indicating the error that occurred. The subclass, PS error type, and UID for the error can be deconstructed using the macros in monevent.h.

memfb_raster_description()

const RasterDescription* memfb_raster_description

(

void *

elementRaster

)

Function to use as hvd_output_page_params::raster_description_fn when using local memory elements.

The elementRaster parameter will previously have been created by memfb_raster_create().

Parameters

[in]

elementRaster

A raster handle previously attached to an HVD element using one of libHVD's HVD_tracker_element_add_raster(), HVD_element_add_raster() or HVD_monitor_add_raster() functions.

Returns

A packed raster description associated with the raster handle. The internal pointers (including the raster layout) of a packed raster description are invalid. It may be unpacked using RasterDescriptionUnpack() if the pointers need to be accessed.

rstore_element_raster_close()

void rstore_element_raster_close	(	void *	context,
		void *	elementRaster
	)

Function to use as hvd_output_page_params::element_raster_close when using raster store elements.

The context parameter will previously have been created by rstore_element_raster_open().

The elementRaster parameter will previously have been created by rstore_raster_create().

Parameters

[in]	context	A raster mapping context previously returned by hvd_output_page_params::element_raster_open().
[in]	elementRaster	A raster handle previously attached to an HVD element using one of libHVD's HVD_tracker_element_add_raster(), HVD_element_add_raster() or HVD_monitor_add_raster() functions.

rstore_element_raster_map()

const uint8* rstore_element_raster_map	(	void *	context,
		void *	elementRaster,
		unsigned int *	pstartline,
		unsigned int *	pnlines,
		HqnResult *	perr
	)

Function to use as hvd_output_page_params::element_raster_map when using raster store elements.

The context parameter will previously have been created by rstore_element_raster_open().

The elementRaster parameter will previously have been created by rstore_raster_create().

Parameters

[in]	context	A raster mapping context previously returned by element_raster_open().
[in]	elementRaster	A raster handle previously attached to an HVD element using one of libHVD's HVD_tracker_element_add_raster(), HVD_element_add_raster() or HVD_monitor_add_raster() functions.
[in,out]	pstartline	A pointer to the first line of data requested from the element raster. On a successful exit, this is updated to the first line of data represented in the buffer. This may be larger than the first line requested, if the element raster did not store data for the requested start line.
[in,out]	pnlines	A pointer to the number of lines of data requested from the element raster. On a successful exit, this is updated to the number of lines of data represented in the buffer. This may be smaller than the number of lines requested, if the element raster did not have data stored for all of the requested lines.
[out]	perr	A location in which an error code is stored, if the raster context could not be acquired or created.

Returns

A pointer to data representing the lines in the updated pstartline and *pnlines range, or NULL if there was an error getting the data. This data is owned by the element, and must not be modified by the client. This pointer remains valid until the next call to hvd_output_page_params::element_raster_map() using the same raster mapping context, or until hvd_output_page_params::element_raster_close() is called.

If the pointer returned is non-NULL, then *perr is not modified. If the pointer returned is NULL, then *perr is either HQN_RESULT_SUCCESS, indicating there was no data in the range requested; or it is a code greater than MON_CLASS_ERROR indicating the error that occurred. The subclass, PS error type, and UID for the error can be deconstructed using the macros in monevent.h.

If there was no data in the range requested, then NULL is returned, *perr is set to HQN_RESULT_SUCCESS, *pnlines is updated to zero and *pstartline is updated to the end of the requested range.

In all cases the element raster mapping context is still open, and requires closing using hvd_output_page_params::element_raster_close().

rstore_element_raster_open()

void* rstore_element_raster_open	(	void *	elementRaster,
		struct RASTER_PLANE *	plane,
		HqnResult *	perr
	)

Function to use as hvd_output_page_params::element_raster_open when using raster store elements.

The elementRaster parameter will previously have been created by rstore_raster_create().

Parameters

[in]	elementRaster	A raster handle previously attached to an HVD element using one of libHVD's HVD_tracker_element_add_raster(), HVD_element_add_raster() or HVD_monitor_add_raster() functions.
[in]	plane	A raster plane to map buffers from.
[out]	perr	A location in which an error code is stored, if the raster context could not be acquired or created.

Returns

A raster context that will be passed to hvd_output_page_params::element_raster_map(), or NULL on error. If this is non-NULL, a corresponding call to hvd_output_page_params::element_raster_close() will be made after mapping buffers for plane.

If the pointer returned is non-NULL, then *perr is not modified. If the pointer returned is NULL, then *perr is set to a code greater than MON_CLASS_ERROR indicating the error that occurred. The subclass, PS error type, and UID for the error can be deconstructed using the macros in monevent.h.

rstore_raster_description()

const RasterDescription* rstore_raster_description

(

void *

elementRaster

)

Function to use as hvd_output_page_params::raster_description_fn when using raster store elements.

The elementRaster parameter will previously have been created by rstore_raster_create().

Parameters

[in]

elementRaster

A raster handle previously attached to an HVD element using one of libHVD's HVD_tracker_element_add_raster(), HVD_element_add_raster() or HVD_monitor_add_raster() functions.

Returns

A packed raster description associated with the raster handle. The internal pointers (including the raster layout) of a packed raster description are invalid. It may be unpacked using RasterDescriptionUnpack() if the pointers need to be accessed.

shmfb_element_raster_close()

void shmfb_element_raster_close	(	void *	context,
		void *	elementRaster
	)

Function to use as hvd_output_page_params::element_raster_close when using shared memory elements.

The context parameter will previously have been created by shmfb_element_raster_open().

The elementRaster parameter will previously have been created by shmfb_raster_create().

Parameters

[in]	context	A raster mapping context previously returned by hvd_output_page_params::element_raster_open().
[in]	elementRaster	A raster handle previously attached to an HVD element using one of libHVD's HVD_tracker_element_add_raster(), HVD_element_add_raster() or HVD_monitor_add_raster() functions.

shmfb_element_raster_map()

const uint8* shmfb_element_raster_map	(	void *	context,
		void *	elementRaster,
		unsigned int *	pstartline,
		unsigned int *	pnlines,
		HqnResult *	perr
	)

Function to use as hvd_output_page_params::element_raster_map when using shared memory elements.

The context parameter will previously have been created by shmfb_element_raster_open().

The elementRaster parameter will previously have been created by shmfb_raster_create().

Parameters

[in]	context	A raster mapping context previously returned by element_raster_open().
[in]	elementRaster	A raster handle previously attached to an HVD element using one of libHVD's HVD_tracker_element_add_raster(), HVD_element_add_raster() or HVD_monitor_add_raster() functions.
[in,out]	pstartline	A pointer to the first line of data requested from the element raster. On a successful exit, this is updated to the first line of data represented in the buffer. This may be larger than the first line requested, if the element raster did not store data for the requested start line.
[in,out]	pnlines	A pointer to the number of lines of data requested from the element raster. On a successful exit, this is updated to the number of lines of data represented in the buffer. This may be smaller than the number of lines requested, if the element raster did not have data stored for all of the requested lines.
[out]	perr	A location in which an error code is stored, if the raster context could not be acquired or created.

Returns

A pointer to data representing the lines in the updated pstartline and *pnlines range, or NULL if there was an error getting the data. This data is owned by the element, and must not be modified by the client. This pointer remains valid until the next call to hvd_output_page_params::element_raster_map() using the same raster mapping context, or until hvd_output_page_params::element_raster_close() is called.

If the pointer returned is non-NULL, then *perr is not modified. If the pointer returned is NULL, then *perr is either HQN_RESULT_SUCCESS, indicating there was no data in the range requested; or it is a code greater than MON_CLASS_ERROR indicating the error that occurred. The subclass, PS error type, and UID for the error can be deconstructed using the macros in monevent.h.

If there was no data in the range requested, then NULL is returned, *perr is set to HQN_RESULT_SUCCESS, *pnlines is updated to zero and *pstartline is updated to the end of the requested range.

In all cases the element raster mapping context is still open, and requires closing using hvd_output_page_params::element_raster_close().

shmfb_element_raster_open()

void* shmfb_element_raster_open	(	void *	elementRaster,
		struct RASTER_PLANE *	plane,
		HqnResult *	perr
	)

Function to use as hvd_output_page_params::element_raster_open when using shared memory elements.

The elementRaster parameter will previously have been created by shmfb_raster_create().

Parameters

[in]	elementRaster	A raster handle previously attached to an HVD element using one of libHVD's HVD_tracker_element_add_raster(), HVD_element_add_raster() or HVD_monitor_add_raster() functions.
[in]	plane	A raster plane to map buffers from.
[out]	perr	A location in which an error code is stored, if the raster context could not be acquired or created.

Returns

A raster context that will be passed to hvd_output_page_params::element_raster_map(), or NULL on error. If this is non-NULL, a corresponding call to hvd_output_page_params::element_raster_close() will be made after mapping buffers for plane.

If the pointer returned is non-NULL, then *perr is not modified. If the pointer returned is NULL, then *perr is set to a code greater than MON_CLASS_ERROR indicating the error that occurred. The subclass, PS error type, and UID for the error can be deconstructed using the macros in monevent.h.

shmfb_raster_description()

const RasterDescription* shmfb_raster_description

(

void *

elementRaster

)

Function to use as hvd_output_page_params::raster_description_fn when using shared memory elements.

The elementRaster parameter will previously have been created by shmfb_raster_create().

Parameters

[in]

elementRaster

A raster handle previously attached to an HVD element using one of libHVD's HVD_tracker_element_add_raster(), HVD_element_add_raster() or HVD_monitor_add_raster() functions.

Returns

A packed raster description associated with the raster handle. The internal pointers (including the raster layout) of a packed raster description are invalid. It may be unpacked using RasterDescriptionUnpack() if the pointers need to be accessed.