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().