Header Header

Transformations handling


Detailed Description

Functions for transformations handling.


Functions

static int gx_inittrafo (gxHANDLE handle, gxTRAFO *ptrafo)
 Initializes a transformation structure.
static int gx_alloctrafo (gxHANDLE handle, gxTRAFO **ptrafo)
 Allocates a transformation structure.
static int gx_alloctrafo_dbg (gxHANDLE handle, gxTRAFO **ptrafo, const char *file, int line)
 Allocates a transformation structure (Debug version).
static int gx_freetrafo (gxHANDLE handle, gxTRAFO *ptrafo)
 Frees the specified transformation structure.
static int gx_createtrafo (gxHANDLE handle, gxTRAFO *ptrafo, const gxPG2 *pairs, int npair, const gxRCT frame, int resolution)
 Creates a transformation structure based on the specified parameters.
static int gx_loadtrafo (gxHANDLE handle, gxTRAFO *ptrafo, const wchar_t *filename)
 Loads data from the specified transformation file to an initialized structure (Unicode version).
static int gx_loadtrafoa (gxHANDLE handle, gxTRAFO *ptrafo, const char *filename)
 Loads data from the specified transformation file to an initialized structure (ASCII version).
static int gx_savetrafo (gxHANDLE handle, gxTRAFO *ptrafo, const wchar_t *filename)
 Saves the specified transformation structure to a file (Unicode version).
static int gx_savetrafoa (gxHANDLE handle, gxTRAFO *ptrafo, const char *filename)
 Saves the specified transformation structure to a file (ASCII version).
static int gx_copytrafo (gxHANDLE handle, gxTRAFO *ptrafo, const gxTRAFO *ptrafo_source)
 Copies one transformation structure to another.
static int gx_trafo (gxHANDLE handle, gxTRAFO *ptrafo, const gxPNT *source, gxPNT *target, int npoints)
 Transforms points from the source sequence with the help of the specified structure then writes the result to the destination sequence list.
static int gx_trafo_pnt (gxHANDLE handle, gxTRAFO *ptrafo, const gxPNT *source, gxPNT *target)
 Transforms one point from the source with the help of the specified structure then writes the result to the destination point.
static int gx_itrafo (gxHANDLE handle, gxTRAFO *ptrafo, const gxPNT *source, gxPNT *target, int npoints)
 Inverse transformation.
static int gx_itrafo_pnt (gxHANDLE handle, gxTRAFO *ptrafo, const gxPNT *source, gxPNT *target)
 Inverse transformation.
static int gx_isvalidtrafo (gxHANDLE handle, const gxTRAFO *ptrafo)
 Checks the specified transformation structure.
static int gx_trafotovariant (gxHANDLE handle, gxTRAFO *source, int varid, gxVARIANT *target)
 Embedds a transformation structure into a variant.
static int gx_trafofromvariant (gxHANDLE handle, gxTRAFO **target, gxVARIANT source)
 Loads an embedded transformation structure from a variant.


Function Documentation

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

Initializes a transformation structure.

Parameters:
handle Handle of the module.
ptrafo Pointer to an uninitialized transformation 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_alloctrafo ( gxHANDLE  handle,
gxTRAFO **  ptrafo 
) [static]

Allocates a transformation structure.

Parameters:
handle Handle of the module.
ptrafo Pointer to a transformation structure pointer, where the function copies the recently allocated 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_alloctrafo_dbg ( gxHANDLE  handle,
gxTRAFO **  ptrafo,
const char *  file,
int  line 
) [static]

Allocates a transformation structure (Debug version).

Parameters:
handle Handle of the module.
ptrafo Pointer to a transformation structure pointer, where the function copies the recently allocated structure.
file File name.
line Line number.
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_freetrafo ( gxHANDLE  handle,
gxTRAFO ptrafo 
) [static]

Frees the specified transformation 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_createtrafo ( gxHANDLE  handle,
gxTRAFO ptrafo,
const gxPG2 pairs,
int  npair,
const gxRCT  frame,
int  resolution 
) [static]

Creates a transformation structure based on the specified parameters.

Parameters:
handle Handle of the module.
ptrafo Pointer to an initialized structure.
pairs Pointer to the list point pairs.
npair Number of points in the list of point pairs.
frame The transformation works with in this frame. The coordinates are defined on the source coordinate system.
resolution Distances between two transformation elements.
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_loadtrafo ( gxHANDLE  handle,
gxTRAFO ptrafo,
const wchar_t *  filename 
) [static]

Loads data from the specified transformation file to an initialized structure (Unicode version).

Parameters:
handle Handle of the module.
ptrafo Pointer to an initialized structure.
filename Name of the file containing the data.
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_loadtrafoa ( gxHANDLE  handle,
gxTRAFO ptrafo,
const char *  filename 
) [static]

Loads data from the specified transformation file to an initialized structure (ASCII version).

Parameters:
handle Handle of the module.
ptrafo Pointer to an initialized structure.
filename Name of the file containing the data.
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_savetrafo ( gxHANDLE  handle,
gxTRAFO ptrafo,
const wchar_t *  filename 
) [static]

Saves the specified transformation structure to a file (Unicode version).

Parameters:
handle Handle of the module.
ptrafo Pointer to an initialized structure.
filename Name of the file.
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_savetrafoa ( gxHANDLE  handle,
gxTRAFO ptrafo,
const char *  filename 
) [static]

Saves the specified transformation structure to a file (ASCII version).

Parameters:
handle Handle of the module.
ptrafo Pointer to an initialized structure.
filename Name of the file.
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_copytrafo ( gxHANDLE  handle,
gxTRAFO ptrafo,
const gxTRAFO ptrafo_source 
) [static]

Copies one transformation structure to another.

The destination structure must be initialized. Its data will be overwritten. The source structure remains unchanged.

Parameters:
handle Handle of the module.
ptrafo Pointer to an initialized destination structure.
ptrafo_source Pointer to the source.
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_trafo ( gxHANDLE  handle,
gxTRAFO ptrafo,
const gxPNT source,
gxPNT target,
int  npoints 
) [static]

Transforms points from the source sequence with the help of the specified structure then writes the result to the destination sequence list.

Parameters:
handle Handle of the module.
ptrafo Pointer to an initialized transformation structure.
source List of source points.
target Place of transformed points.
npoints Number of points in the list.
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_trafo_pnt ( gxHANDLE  handle,
gxTRAFO ptrafo,
const gxPNT source,
gxPNT target 
) [static]

Transforms one point from the source with the help of the specified structure then writes the result to the destination point.

Parameters:
handle Handle of the module.
ptrafo Pointer to an initialized transformation structure.
source Pointer to the source point.
target Place of transformed point.
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_itrafo ( gxHANDLE  handle,
gxTRAFO ptrafo,
const gxPNT source,
gxPNT target,
int  npoints 
) [static]

Inverse transformation.

Parameters:
handle Handle of the module.
ptrafo Pointer to an initialized transformation structure.
source List of source points.
target Place of transformed points.
npoints Number of points in the list.
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_itrafo_pnt ( gxHANDLE  handle,
gxTRAFO ptrafo,
const gxPNT source,
gxPNT target 
) [static]

Inverse transformation.

Parameters:
handle Handle of the module.
ptrafo Pointer to an initialized transformation structure.
source Pointer to the source point.
target Place of transformed point.
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_isvalidtrafo ( gxHANDLE  handle,
const gxTRAFO ptrafo 
) [static]

Checks the specified transformation structure.

Parameters:
handle Handle of the module.
ptrafo Pointer to an initialized transformation 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_trafotovariant ( gxHANDLE  handle,
gxTRAFO source,
int  varid,
gxVARIANT target 
) [static]

Embedds a transformation structure into a variant.

Parameters:
handle Handle of the module.
source Pointer to the source transformation structure.
varid The id for the created variant.
target Pointer to the initialized destination variant.
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_trafofromvariant ( gxHANDLE  handle,
gxTRAFO **  target,
gxVARIANT  source 
) [static]

Loads an embedded transformation structure from a variant.

Parameters:
handle Handle of the module.
target Pointer to the destination transformation structure.
source Variant with an embedded transformation 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