Header Header

Reference handling


Detailed Description

Functions for reference handling.


Functions

static gxi32 gx_refimage (gxHANDLE handle, gxIMAGE *pimage)
 Increases the image reference counter.
static gxi32 gx_unrefimage (gxHANDLE handle, gxIMAGE *pimage)
 Decreases the image reference counter.
static int gx_refhandle (gxHANDLE handle)
 Increases the reference counter of a GX handle.
static int gx_unrefhandle (gxHANDLE *handle)
 Decreases the reference counter of a GX handle.
static int gx_reftrafo (gxHANDLE handle, gxTRAFO *ptrafo)
 Increases the reference number of the specified transformation structure.
static int gx_unreftrafo (gxHANDLE handle, gxTRAFO *ptrafo)
 Decreases the reference number of the specified transformation structure.


Function Documentation

static gxi32 gx_refimage ( gxHANDLE  handle,
gxIMAGE pimage 
) [static]

Increases the image reference counter.

The counter indicates the number of processes using the image. The counter can rise to positive or negative direction as well depending on whether the image is static or dynamic.

Parameters:
handle Handle of the module.
pimage Pointer to the image structure.
Returns:
On error false is returned and the error code/string in the GX system is set appropriately ( see gx_geterror() ).

References gx_call().

static gxi32 gx_unrefimage ( gxHANDLE  handle,
gxIMAGE pimage 
) [static]

Decreases the image reference counter.

The counter indicates the number of processes using the image. If the counter value becomes zero after the function call the structure will be freed depending on whether the image was allocated statically or dynamically.

Parameters:
handle Handle of the module.
pimage Pointer to the image structure.
Returns:
On error false is returned and the error code/string in the GX system is set appropriately ( see gx_geterror() ).

References gx_call().

static int gx_refhandle ( gxHANDLE  handle  )  [static]

Increases the reference counter of a GX handle.

Parameters:
handle Handle of the module.
Returns:
On error false is returned and the error code/string in the GX system is set appropriately ( see gx_geterror() ).

References gx_call().

static int gx_unrefhandle ( gxHANDLE handle  )  [static]

Decreases the reference counter of a GX handle.

Parameters:
handle Handle of the module.
Returns:
On error false is returned and the error code/string in the GX system is set appropriately ( see gx_geterror() ).

References gx_call().

static int gx_reftrafo ( gxHANDLE  handle,
gxTRAFO ptrafo 
) [static]

Increases the reference number of the specified transformation structure.

The reference number indicates how many processes are currently using the specified structure.

Parameters:
handle Handle of the module.
ptrafo Pointer to an initialized structure.
Returns:
On error false is returned and the error code/string in the GX system is set appropriately ( see gx_geterror() ).

References gx_call().

static int gx_unreftrafo ( gxHANDLE  handle,
gxTRAFO ptrafo 
) [static]

Decreases the reference number of the specified transformation structure.

As it reaches value zero the structure will be freed.

Parameters:
handle Handle of the module.
ptrafo Pointer to an initialized structure.
Returns:
On error false is returned and the error code/string in the GX system is set appropriately ( see gx_geterror() ).

References gx_call().


Generated  for GX
(c) Adaptive Recognition