TRANS2D_MAPGEN Class Reference

General map transformation implementing Exterior - InputMap - OutputMap - Exterior sequence. More...

#include <mi32/trans2dmapgen.h>

Public Types
enum	COORD { COORD_Exterior = 0, COORD_Map = 1 }
enum	DIRECTION { DIRECTION_Forward = 0, DIRECTION_Reverse = 1, DIRECTION_Inverse = DIRECTION_Reverse }
enum	SIDE { SIDE_Input = 0, SIDE_Output = 1 }
Public Member Functions
	TRANS2D_MAPGEN (const TRANS2D_MAPGEN &rhs)
	TRANS2D_MAPGEN ()
	~TRANS2D_MAPGEN ()
ERRVALUE	ApplyOffsetInputToMap (double OffsetX, double OffsetY)
ERRVALUE	ApplyOffsetMapToInput (double OffsetX, double OffsetY)
ERRVALUE	ApplyOffsetMapToOutput (double OffsetX, double OffsetY)
ERRVALUE	ApplyOffsetOutputToMap (double OffsetX, double OffsetY)
ERRVALUE	ApplyScaleInputToMap (double ScaleX, double ScaleY)
ERRVALUE	ApplyScaleMapToInput (double ScaleX, double ScaleY)
ERRVALUE	ApplyScaleMapToOutput (double ScaleX, double ScaleY)
ERRVALUE	ApplyScaleOutputToMap (double ScaleX, double ScaleY)
void	Clear ()
ERRVALUE	ConvertForward (const DRECT2D &irect, DRECT2D &orect, int sidepoints=0) const
ERRVALUE	ConvertForward (const void ipoints, void opoints, INT32 NumPoints, int NumDim) const
ERRVALUE	ConvertForward (const DPOINT3D ipoints, DPOINT3D opoints, INT32 NumPoints) const
ERRVALUE	ConvertForward (const DPOINT2D ipoints, DPOINT2D opoints, INT32 NumPoints) const
ERRVALUE	ConvertForward (const DPOINT3D &ipoint, DPOINT3D &opoint) const
ERRVALUE	ConvertForward (const DPOINT2D &ipoint, DPOINT2D &opoint) const
INT32	ConvertForwardDense (const double *ipoints, INT32 iNumPoints, int NumDim, MIDOUBLEARRAY &opoints) const
ERRVALUE	ConvertInputToMap (const DPOINT2D &ipoint, DPOINT2D &opoint) const
ERRVALUE	ConvertInverse (const DRECT2D &irect, DRECT2D &orect, int sidepoints=0) const
ERRVALUE	ConvertInverse (const void ipoints, void opoints, INT32 NumPoints, int NumDim) const
ERRVALUE	ConvertInverse (const DPOINT3D ipoints, DPOINT3D opoints, INT32 NumPoints) const
ERRVALUE	ConvertInverse (const DPOINT2D ipoints, DPOINT2D opoints, INT32 NumPoints) const
ERRVALUE	ConvertInverse (const DPOINT3D &ipoint, DPOINT3D &opoint) const
ERRVALUE	ConvertInverse (const DPOINT2D &ipoint, DPOINT2D &opoint) const
INT32	ConvertInverseDense (const double *ipoints, INT32 iNumPoints, int NumDim, MIDOUBLEARRAY &opoints) const
ERRVALUE	ConvertMapToInput (const DPOINT2D &ipoint, DPOINT2D &opoint) const
ERRVALUE	ConvertMapToMapForward (const DPOINT2D &ipoint, DPOINT2D &opoint) const
ERRVALUE	ConvertMapToMapInverse (const DPOINT2D &ipoint, DPOINT2D &opoint) const
ERRVALUE	ConvertOutputToMap (const DPOINT2D &ipoint, DPOINT2D &opoint) const
ERRVALUE	CopyInputToInput (const TRANS2D_MAPGEN &itrans)
ERRVALUE	CopyInputToOutput (const TRANS2D_MAPGEN &itrans)
ERRVALUE	CopyOutputToInput (const TRANS2D_MAPGEN &itrans)
ERRVALUE	CopyOutputToOutput (const TRANS2D_MAPGEN &itrans)
ERRVALUE	DisectForward (const DPOINT2D &point, double xscale, double yscale, double rotangle=0, double shearangle=0, double size=1.0) const
ERRVALUE	DisectInverse (const DPOINT2D &point, double xscale, double yscale, double rotangle=0, double shearangle=0, double size=1.0) const
ERRVALUE	GetAffine (TRANS2D_AFFINE &trans) const
DEPRECATED ERRVALUE	GetAffine (MAT3X3 fwd, MAT3X3 rev) const
const DOUBLE_ARRAY< CTRLPOINT3 > &	GetInputCtrlPoints () const
void	GetInputFormulasDisplay (const MISTRING &ExtSymX, const MISTRING &ExtSymY, MISTRING &retstr) const
const SPATREF::COORDREFSYS &	GetInputMapCoordRefSys () const
TRANS2DMODEL	GetInputModel () const
int	GetInputTrans (CTRLPOINT3 **ctrlpoint) const
DEPRECATED ERRVALUE	GetInputTrans (MAT3X3 fwd, MAT3X3 rev) const
ERRVALUE	GetInputTrans (TRANS2D_AFFINE &trans) const
DEPRECATED ERRVALUE	GetLocalAffine (const DPOINT2D &point, MAT3X3 fwd, MAT3X3 rev, double size=1.0, SIDE side=SIDE_Input) const
ERRVALUE	GetLocalAffine (const DPOINT2D &point, TRANS2D_AFFINE &trans, double size=1.0, SIDE side=SIDE_Input) const
bool	GetNode2D (INT32 nodenum, DPOINT2D &point, SIDE side, COORD coord) const
bool	GetNode3D (INT32 nodenum, DPOINT3D &point, SIDE side, COORD coord) const
const DOUBLE_ARRAY< CTRLPOINT3 > &	GetOutputCtrlPoints () const
void	GetOutputFormulasDisplay (const MISTRING &ExtSymX, const MISTRING &ExtSymY, MISTRING &retstr) const
const SPATREF::COORDREFSYS &	GetOutputMapCoordRefSys () const
TRANS2DMODEL	GetOutputModel () const
int	GetOutputTrans (CTRLPOINT3 **ctrlpoint) const
DEPRECATED ERRVALUE	GetOutputTrans (MAT3X3 fwd, MAT3X3 rev) const
ERRVALUE	GetOutputTrans (TRANS2D_AFFINE &trans) const
PTTRIANGULATOR &	GetTriangulator (SIDE side)
const PTTRIANGULATOR &	GetTriangulator (SIDE side) const
bool	HasForward () const
bool	HasInverse () const
bool	IsAffine () const
bool	IsEqual (const TRANS2D_MAPGEN &rhs) const
bool	IsGeneral () const
bool	IsIdentity () const
bool	IsInputTransIdentity () const
bool	IsOutputTransIdentity () const
bool	IsReversible () const
TRANS2D_MAPGEN &	operator= (const TRANS2D_MAPGEN &rhs)
void	ReverseDirection ()
void	SetActiveTriangle (INT32 triangle, SIDE side) const
void	SetAffineApproximation (const DRECT2D &SrcRect, double TgtTolerance, SIDE side)
void	SetAffineApproximation (const DRECT2D &SrcRect, double TgtTolerance, DIRECTION direction)
void	SetExcludeFlippedPieces (bool ExcludeFlippedPieces)
void	SetExtrapolation (bool extrapolate)
void	SetFullTransAffine (const TRANS2D_AFFINE &trans)
void	SetGeneral (TRANSFUNC TransFuncFwd, TRANSFUNC TransFuncRev, void *userdata)
ERRVALUE	SetInputBounds (const DRECT2D &boundrect)
ERRVALUE	SetInputMapCoordRefSys (const SPATREF::COORDREFSYS &MapCRS)
void	SetInputMaxError (double maxerror)
ERRVALUE	SetInputTrans (const CTRLPOINT3 *CtrlPoint, INT32 NumPoints, TRANS2DMODEL Model)
DEPRECATED void	SetInputTrans (const MAT3X3 fwd, const MAT3X3 rev)
void	SetInputTrans (const TRANS2D_AFFINE &trans)
void	SetInputTransIdentity ()
void	SetMaxVertices (INT32 MaxVertices)
ERRVALUE	SetOutputBounds (const DRECT2D &boundrect)
ERRVALUE	SetOutputMapCoordRefSys (const SPATREF::COORDREFSYS &MapCRS)
void	SetOutputMaxError (double maxerror)
ERRVALUE	SetOutputTrans (const CTRLPOINT3 *CtrlPoint, INT32 NumPoints, TRANS2DMODEL Model)
DEPRECATED void	SetOutputTrans (const MAT3X3 fwd, const MAT3X3 rev)
void	SetOutputTrans (const TRANS2D_AFFINE &trans)
void	SetOutputTransIdentity ()
void	SetPrimaryDirection (DIRECTION direction)
void	Update ()
ERRVALUE	UpdatePiecewise (SIDE side)

Detailed Description

General map transformation implementing Exterior - InputMap - OutputMap - Exterior sequence.

Member Enumeration Documentation

enum TRANS2D_MAPGEN::COORD

Enumerator:

COORD_Exterior
COORD_Map

enum TRANS2D_MAPGEN::DIRECTION

Transformation direction.

Enumerator:

DIRECTION_Forward	Forward direction.
DIRECTION_Reverse	Reverse direction.
DIRECTION_Inverse

enum TRANS2D_MAPGEN::SIDE

Enumerator:

SIDE_Input
SIDE_Output

Constructor & Destructor Documentation

TRANS2D_MAPGEN::TRANS2D_MAPGEN ( )

Default constructor, creates identity transformation.

TRANS2D_MAPGEN::TRANS2D_MAPGEN ( const TRANS2D_MAPGEN & rhs )

Copy constructor.

TRANS2D_MAPGEN::~TRANS2D_MAPGEN ( )

Destructor.

Member Function Documentation

ERRVALUE TRANS2D_MAPGEN::ApplyOffsetInputToMap	(	double	OffsetX,
		double	OffsetY
	)

Apply offset from input to map.

Parameters:

	OffsetX	X offset in map coordinates
	OffsetY	Y offset in map coordinates

ERRVALUE TRANS2D_MAPGEN::ApplyOffsetMapToInput	(	double	OffsetX,
		double	OffsetY
	)

Apply offset from map to input.

Parameters:

	OffsetX	X offset in input coordinates
	OffsetY	Y offset in input coordinates

ERRVALUE TRANS2D_MAPGEN::ApplyOffsetMapToOutput	(	double	OffsetX,
		double	OffsetY
	)

Apply offset from map to output.

Parameters:

	OffsetX	X offset in output coordinates
	OffsetY	Y offset in output coordinates

ERRVALUE TRANS2D_MAPGEN::ApplyOffsetOutputToMap	(	double	OffsetX,
		double	OffsetY
	)

Apply offset from output to map.

Parameters:

	OffsetX	X offset in map coordinates
	OffsetY	Y offset in map coordinates

ERRVALUE TRANS2D_MAPGEN::ApplyScaleInputToMap	(	double	ScaleX,
		double	ScaleY
	)

Apply scale from input to map.

Parameters:

	ScaleX	X scaling
	ScaleY	Y scaling

ERRVALUE TRANS2D_MAPGEN::ApplyScaleMapToInput	(	double	ScaleX,
		double	ScaleY
	)

Apply scale from map to input.

Parameters:

	ScaleX	X scaling
	ScaleY	Y scaling

ERRVALUE TRANS2D_MAPGEN::ApplyScaleMapToOutput	(	double	ScaleX,
		double	ScaleY
	)

Apply scale from map to output.

Parameters:

	ScaleX	X scaling
	ScaleY	Y scaling

ERRVALUE TRANS2D_MAPGEN::ApplyScaleOutputToMap	(	double	ScaleX,
		double	ScaleY
	)

Apply scale from output to map.

Parameters:

	ScaleX	X scaling
	ScaleY	Y scaling

void TRANS2D_MAPGEN::Clear ( )

Clear transformation, resetting to identity.

ERRVALUE TRANS2D_MAPGEN::ConvertForward	(	const DRECT2D &	irect,
		DRECT2D &	orect,
		int	sidepoints = `0`
	)			const

Perform forward transformation on rectangle.

Parameters:

	irect	Input rectangle
	orect	Output rectangle
	sidepoints	Number of extra points along sides for interpolation

ERRVALUE TRANS2D_MAPGEN::ConvertForward	(	const void *	ipoints,
		void *	opoints,
		INT32	NumPoints,
		int	NumDim
	)			const

Perform forward transformation on generic point array.

Parameters:

	ipoints	Input point array
	opoints	Output point array
	NumPoints	Number of points to convert
	NumDim	Number of dimensions

ERRVALUE TRANS2D_MAPGEN::ConvertForward	(	const DPOINT3D *	ipoints,
		DPOINT3D *	opoints,
		INT32	NumPoints
	)			const

Perform forward transformation on DPOINT3D array.

Parameters:

	ipoints	Input point array
	opoints	Output point array
	NumPoints	Number of points to convert

ERRVALUE TRANS2D_MAPGEN::ConvertForward	(	const DPOINT2D *	ipoints,
		DPOINT2D *	opoints,
		INT32	NumPoints
	)			const

Perform forward transformation on DPOINT2D array.

Parameters:

	ipoints	Input point array
	opoints	Output point array
	NumPoints	Number of points to convert

ERRVALUE TRANS2D_MAPGEN::ConvertForward	(	const DPOINT3D &	ipoint,
		DPOINT3D &	opoint
	)			const

Perform forward transformation on DPOINT3D.

Parameters:

	ipoint	Input point
	opoint	Output point

ERRVALUE TRANS2D_MAPGEN::ConvertForward	(	const DPOINT2D &	ipoint,
		DPOINT2D &	opoint
	)			const

Perform forward transformation on DPOINT2D.

Parameters:

	ipoint	Input point
	opoint	Output point

INT32 TRANS2D_MAPGEN::ConvertForwardDense	(	const double *	ipoints,
		INT32	iNumPoints,
		int	NumDim,
		MIDOUBLEARRAY &	opoints
	)			const

Perform forward transformation with densification.

Returns:: Number of output points or error < 0.

Parameters:

	ipoints	Input point array
	iNumPoints	Number of input points
	NumDim	Numer of dimensions
	opoints	Array of output points returned

ERRVALUE TRANS2D_MAPGEN::ConvertInputToMap	(	const DPOINT2D &	ipoint,
		DPOINT2D &	opoint
	)			const

Convert from "input" to "map" coordinates.

Parameters:

	ipoint	Point to convert
	opoint	Point returned

ERRVALUE TRANS2D_MAPGEN::ConvertInverse	(	const DRECT2D &	irect,
		DRECT2D &	orect,
		int	sidepoints = `0`
	)			const

Perform reverse transformation on rectangle.

Parameters:

	irect	Input rectangle
	orect	Output rectangle
	sidepoints	Number of extra points along sides for interpolation

ERRVALUE TRANS2D_MAPGEN::ConvertInverse	(	const void *	ipoints,
		void *	opoints,
		INT32	NumPoints,
		int	NumDim
	)			const

Perform reverse transformation on generic point array.

Parameters:

	ipoints	Input point array
	opoints	Output point array
	NumPoints	Number of points to convert
	NumDim	Number of dimensions

ERRVALUE TRANS2D_MAPGEN::ConvertInverse	(	const DPOINT3D *	ipoints,
		DPOINT3D *	opoints,
		INT32	NumPoints
	)			const

Perform reverse transformation on DPOINT3D array.

Parameters:

	ipoints	Input point array
	opoints	Output point array
	NumPoints	Number of points to convert

ERRVALUE TRANS2D_MAPGEN::ConvertInverse	(	const DPOINT2D *	ipoints,
		DPOINT2D *	opoints,
		INT32	NumPoints
	)			const

Perform reverse transformation on DPOINT2D array.

Parameters:

	ipoints	Input point array
	opoints	Output point array
	NumPoints	Number of points to convert

ERRVALUE TRANS2D_MAPGEN::ConvertInverse	(	const DPOINT3D &	ipoint,
		DPOINT3D &	opoint
	)			const

Perform reverse transformation on DPOINT3D.

Parameters:

	ipoint	Input point
	opoint	Output point

ERRVALUE TRANS2D_MAPGEN::ConvertInverse	(	const DPOINT2D &	ipoint,
		DPOINT2D &	opoint
	)			const

Perform reverse transformation on DPOINT2D.

Parameters:

	ipoint	Input point
	opoint	Output point

INT32 TRANS2D_MAPGEN::ConvertInverseDense	(	const double *	ipoints,
		INT32	iNumPoints,
		int	NumDim,
		MIDOUBLEARRAY &	opoints
	)			const

Perform reverse transformation with densification.

Returns:: Number of output points or error < 0.

Parameters:

	ipoints	Input point array
	iNumPoints	Number of input points
	NumDim	Numer of dimensions
	opoints	Array of output points returned

ERRVALUE TRANS2D_MAPGEN::ConvertMapToInput	(	const DPOINT2D &	ipoint,
		DPOINT2D &	opoint
	)			const

Convert from "map" to "input" coordinates.

Parameters:

	ipoint	Point to convert
	opoint	Point returned

ERRVALUE TRANS2D_MAPGEN::ConvertMapToMapForward	(	const DPOINT2D &	ipoint,
		DPOINT2D &	opoint
	)			const

Convert from input map coordinates to output map coordinates.

Parameters:

	ipoint	Point to convert
	opoint	Output point

ERRVALUE TRANS2D_MAPGEN::ConvertMapToMapInverse	(	const DPOINT2D &	ipoint,
		DPOINT2D &	opoint
	)			const

Convert from output map coordinates to input map coordinates.

Parameters:

	ipoint	Point to convert
	opoint	Output point

ERRVALUE TRANS2D_MAPGEN::ConvertOutputToMap	(	const DPOINT2D &	ipoint,
		DPOINT2D &	opoint
	)			const

Convert from "output" to "map" coordinates.

Parameters:

	ipoint	Point to convert
	opoint	Output point

ERRVALUE TRANS2D_MAPGEN::CopyInputToInput ( const TRANS2D_MAPGEN & itrans )

Copy MAPGEN "input" parameters to "input" parameters.

ERRVALUE TRANS2D_MAPGEN::CopyInputToOutput ( const TRANS2D_MAPGEN & itrans )

Copy MAPGEN "input" parameters to "output" parameters.

ERRVALUE TRANS2D_MAPGEN::CopyOutputToInput ( const TRANS2D_MAPGEN & itrans )

Copy MAPGEN "output" parameters to "input" parameters.

ERRVALUE TRANS2D_MAPGEN::CopyOutputToOutput ( const TRANS2D_MAPGEN & itrans )

Copy MAPGEN "output" parameters to "output" parameters.

ERRVALUE TRANS2D_MAPGEN::DisectForward	(	const DPOINT2D &	point,
		double *	xscale,
		double *	yscale,
		double *	rotangle = `0`,
		double *	shearangle = `0`,
		double	size = `1.0`
	)			const

Determine scale/rotation/shear at specified point for forward transformation.

Parameters:

	point	Reference point at which values will be computed
	xscale	X scale returned (0 if don't need)
	yscale	Y scale returned (0 if don't need)
	rotangle	Rotation angle in radians returned (0 if don't need)
	shearangle	Shear angle in radians returned (0 if don't need)
	size	Size of area over which to compute values

ERRVALUE TRANS2D_MAPGEN::DisectInverse	(	const DPOINT2D &	point,
		double *	xscale,
		double *	yscale,
		double *	rotangle = `0`,
		double *	shearangle = `0`,
		double	size = `1.0`
	)			const

Determine scale/rotation/shear at specified point for reverse transformation.

Parameters:

	point	Reference point at which values will be computed
	xscale	X scale returned (0 if don't need)
	yscale	Y scale returned (0 if don't need)
	rotangle	Rotation angle in radians returned (0 if don't need)
	shearangle	Shear angle in radians returned (0 if don't need)
	size	Size of area over which to compute values

ERRVALUE TRANS2D_MAPGEN::GetAffine ( TRANS2D_AFFINE & trans ) const

Get affine transformation if available.

Will return error if transformation is not affine.

Parameters:

trans

Affine transformation

DEPRECATED ERRVALUE TRANS2D_MAPGEN::GetAffine	(	MAT3X3	fwd,
		MAT3X3	rev
	)			const

Get affine transformation if available.

Will return error if transformation is not affine.

Parameters:

	fwd	Forward transformation
	rev	Reverse transformation

const DOUBLE_ARRAY<CTRLPOINT3>& TRANS2D_MAPGEN::GetInputCtrlPoints ( ) const

Get "input" control points.

void TRANS2D_MAPGEN::GetInputFormulasDisplay	(	const MISTRING &	ExtSymX,
		const MISTRING &	ExtSymY,
		MISTRING &	retstr
	)			const

Get "input" formula display.

Parameters:

retstr

Formulas returned, separated by newline, empty if not available

const SPATREF::COORDREFSYS& TRANS2D_MAPGEN::GetInputMapCoordRefSys ( ) const

Get 'input' map coordinate reference system.

TRANS2DMODEL TRANS2D_MAPGEN::GetInputModel ( ) const

Get input model.

int TRANS2D_MAPGEN::GetInputTrans ( CTRLPOINT3 ** ctrlpoint ) const

Get input transformation as control points.

Will return number of points if any or error

DEPRECATED ERRVALUE TRANS2D_MAPGEN::GetInputTrans	(	MAT3X3	fwd,
		MAT3X3	rev
	)			const

Get input transformation as affine.

ERRVALUE TRANS2D_MAPGEN::GetInputTrans ( TRANS2D_AFFINE & trans ) const

Get input transformation as affine.

Parameters:

trans

Affine transformation

DEPRECATED ERRVALUE TRANS2D_MAPGEN::GetLocalAffine	(	const DPOINT2D &	point,
		MAT3X3	fwd,
		MAT3X3	rev,
		double	size = `1.0`,
		SIDE	side = `SIDE_Input`
	)			const

Get local affine transformation.

Parameters:

	fwd	Forward transformation
	rev	Reverse transformation

ERRVALUE TRANS2D_MAPGEN::GetLocalAffine	(	const DPOINT2D &	point,
		TRANS2D_AFFINE &	trans,
		double	size = `1.0`,
		SIDE	side = `SIDE_Input`
	)			const

Get local affine transformation.

Parameters:

	point	Point at which to compute transformation
	trans	Affine transformation returned
	size	Size for approximation
	side	Side of transformation corresponding to specified point

bool TRANS2D_MAPGEN::GetNode2D	(	INT32	nodenum,
		DPOINT2D &	point,
		SIDE	side,
		COORD	coord
	)			const

Get 2D node coordinates for piecewise transformation.

bool TRANS2D_MAPGEN::GetNode3D	(	INT32	nodenum,
		DPOINT3D &	point,
		SIDE	side,
		COORD	coord
	)			const

Get 3D node coordinates for piecewise transformation.

const DOUBLE_ARRAY<CTRLPOINT3>& TRANS2D_MAPGEN::GetOutputCtrlPoints ( ) const

Get "output" control points.

void TRANS2D_MAPGEN::GetOutputFormulasDisplay	(	const MISTRING &	ExtSymX,
		const MISTRING &	ExtSymY,
		MISTRING &	retstr
	)			const

Get "output" formula display.

Parameters:

retstr

Formulas returned, separated by newline, empty if not available

const SPATREF::COORDREFSYS& TRANS2D_MAPGEN::GetOutputMapCoordRefSys ( ) const

Get 'output' map coordinate reference system.

TRANS2DMODEL TRANS2D_MAPGEN::GetOutputModel ( ) const

Get output model.

int TRANS2D_MAPGEN::GetOutputTrans ( CTRLPOINT3 ** ctrlpoint ) const

Get output transformation as control points.

Will return number of points if any or error

DEPRECATED ERRVALUE TRANS2D_MAPGEN::GetOutputTrans	(	MAT3X3	fwd,
		MAT3X3	rev
	)			const

Get output transformation as affine.

ERRVALUE TRANS2D_MAPGEN::GetOutputTrans ( TRANS2D_AFFINE & trans ) const

Get output transformation as affine.

Parameters:

trans

Affine transformation

PTTRIANGULATOR& TRANS2D_MAPGEN::GetTriangulator ( SIDE side )

Get non-const TRIANGULATOR for input or output side.

Caller is responsible for updating piecewise transformation via UpdatePiecewise if changed.

const PTTRIANGULATOR& TRANS2D_MAPGEN::GetTriangulator ( SIDE side ) const

Get const TRIANGULATOR for input or output side.

bool TRANS2D_MAPGEN::HasForward ( ) const

Determine if has forward transformation.

bool TRANS2D_MAPGEN::HasInverse ( ) const

Determine if has reverse transformation.

bool TRANS2D_MAPGEN::IsAffine ( ) const

Determine if transformation is "affine".

bool TRANS2D_MAPGEN::IsEqual ( const TRANS2D_MAPGEN & rhs ) const

Determine if two transformations are "equal".

bool TRANS2D_MAPGEN::IsGeneral ( ) const

Determine if using general transformation functions.

bool TRANS2D_MAPGEN::IsIdentity ( ) const

Determine if transformation is "identity".

bool TRANS2D_MAPGEN::IsInputTransIdentity ( ) const

Determine if 'input' transformation is 'identity'.

bool TRANS2D_MAPGEN::IsOutputTransIdentity ( ) const

Determine if 'output' transformation is 'identity'.

bool TRANS2D_MAPGEN::IsReversible ( ) const

Determine if transformation is "reversible".

TRANS2D_MAPGEN& TRANS2D_MAPGEN::operator= ( const TRANS2D_MAPGEN & rhs )

Assignment from TRANS2D_MAPGEN.

void TRANS2D_MAPGEN::ReverseDirection ( )

Reverse direction of transformation.

void TRANS2D_MAPGEN::SetActiveTriangle	(	INT32	triangle,
		SIDE	side
	)			const

Set active triangle for next point test.

void TRANS2D_MAPGEN::SetAffineApproximation	(	const DRECT2D &	SrcRect,
		double	TgtTolerance,
		SIDE	side
	)			`[inline]`

Set full transformation to approximated affine if within specified tolerance.

The approximate affine transformation will be retained until the next "Set" method is used at which time the transformation will revert to its "exact" mode (which may also be affine).

Parameters:

	SrcRect	Rectangle in source coordinates
	TgtTolerance	Tolerance relative target coordinates

void TRANS2D_MAPGEN::SetAffineApproximation	(	const DRECT2D &	SrcRect,
		double	TgtTolerance,
		DIRECTION	direction
	)

Set full transformation to approximated affine if within specified tolerance.

The approximate affine transformation will be retained until the next "Set" method is used at which time the transformation will revert to its "exact" mode (which may also be affine).

Parameters:

	SrcRect	Rectangle in source coordinates
	TgtTolerance	Tolerance relative target coordinates
	direction	Direction from "source" to "target"

void TRANS2D_MAPGEN::SetExcludeFlippedPieces ( bool ExcludeFlippedPieces )

Set whether to exclude flipped pieces for piecewise transformation.

If flipped pieces are excluded an error will be returned if an attempt is made to convert a point within a flipped piece.

void TRANS2D_MAPGEN::SetExtrapolation ( bool extrapolate )

Set whether to perform extrapolation outside specified bounds.

If extrapolation is not enabled then an exception -may- occur if and attempt is made to convert points outside the previously-specified input/output bounds. This is the default condition and will generally be much faster than extrapolating.

Parameters:

extrapolate

Perform extrapolation if true, don't extrapolate if false

void TRANS2D_MAPGEN::SetFullTransAffine ( const TRANS2D_AFFINE & trans )

Set entire transformation as affine.

Parameters:

trans

Affine transformation

void TRANS2D_MAPGEN::SetGeneral	(	TRANSFUNC	TransFuncFwd,
		TRANSFUNC	TransFuncRev,
		void *	userdata
	)

ERRVALUE TRANS2D_MAPGEN::SetInputBounds ( const DRECT2D & boundrect )

Set boundaries for valid transformation in input coordinates.

Parameters:

boundrect

Bounding rectangle in input coordinates

ERRVALUE TRANS2D_MAPGEN::SetInputMapCoordRefSys ( const SPATREF::COORDREFSYS & MapCRS )

Set input map coordinate reference system.

Parameters:

MapCRS

Map coordinate reference system

void TRANS2D_MAPGEN::SetInputMaxError ( double maxerror )

Set maximum error for point densification in input coordinates.

Parameters:

maxerror

Maximum error value to set

ERRVALUE TRANS2D_MAPGEN::SetInputTrans	(	const CTRLPOINT3 *	CtrlPoint,
		INT32	NumPoints,
		TRANS2DMODEL	Model
	)

Set input transformation from control point array.

Parameters:

	CtrlPoint	Control point array
	NumPoints	Number of control points
	Model	Transformation model

DEPRECATED void TRANS2D_MAPGEN::SetInputTrans	(	const MAT3X3	fwd,
		const MAT3X3	rev
	)

Set input transformation as affine.

Parameters:

	fwd	Forward transformation
	rev	Reverse transformation

void TRANS2D_MAPGEN::SetInputTrans ( const TRANS2D_AFFINE & trans )

Set input transformation as affine.

Parameters:

trans

Affine transformation

void TRANS2D_MAPGEN::SetInputTransIdentity ( )

Set input transformation to identity.

void TRANS2D_MAPGEN::SetMaxVertices ( INT32 MaxVertices )

Set maximum number of vertices to insert if densifying points.

ERRVALUE TRANS2D_MAPGEN::SetOutputBounds ( const DRECT2D & boundrect )

Set boundaries for valid transformation in output coordinates.

Parameters:

boundrect

Bounding rectangle in output coordinates

ERRVALUE TRANS2D_MAPGEN::SetOutputMapCoordRefSys ( const SPATREF::COORDREFSYS & MapCRS )

Set output map coordinate reference system.

Parameters:

MapCRS

Map coordinate reference system

void TRANS2D_MAPGEN::SetOutputMaxError ( double maxerror )

Set maximum error for point densification in output coordinates.

Parameters:

maxerror

Maximum error value to set

ERRVALUE TRANS2D_MAPGEN::SetOutputTrans	(	const CTRLPOINT3 *	CtrlPoint,
		INT32	NumPoints,
		TRANS2DMODEL	Model
	)

Set output transformation from control point array.

Parameters:

	CtrlPoint	Control point array
	NumPoints	Number of control points
	Model	Transformation model

DEPRECATED void TRANS2D_MAPGEN::SetOutputTrans	(	const MAT3X3	fwd,
		const MAT3X3	rev
	)

Set output transformation as affine.

void TRANS2D_MAPGEN::SetOutputTrans ( const TRANS2D_AFFINE & trans )

Set output transformation as affine.

Parameters:

trans

Affine transformation

void TRANS2D_MAPGEN::SetOutputTransIdentity ( )

Set output transformation to identity.

void TRANS2D_MAPGEN::SetPrimaryDirection ( DIRECTION direction )

Set primary transformation direction.

The default transformation direction if not set explicitly is "forward". This method is used in cases where the time to do a reverse transformation is much higher than in the primary direction. This is commonly used for raster warping.

Parameters:

direction

DIRECTION_Forward or DIRECTION_Reverse

void TRANS2D_MAPGEN::Update ( )

ERRVALUE TRANS2D_MAPGEN::UpdatePiecewise ( SIDE side )

The documentation for this class was generated from the following file:

mi32/trans2dmapgen.h

TRANS2D_MAPGEN Class Reference

Public Types

Public Member Functions

Detailed Description

Member Enumeration Documentation

Constructor & Destructor Documentation

Member Function Documentation