Derive Coord 3D From 2D For Given Elevation

Function Name: Derive Coord 3D From 2D For Given Elevation

Definition

Given a 2D coordinate, expressed in an SRF that has a corresponding 3D SRF, and given a z/elevation, constructs the corresponding 3D representation of the given coordinate.

Returns

SE_COORD_SUCCESS - if valid parameters were passed in and all operations succeeded.

SE_COORD_INVALID_DEST_COORD - and *coord_3d_ptr is left unaltered, if coord_3d_ptr is NULL.

SE_COORD_INVALID_SOURCE_COORD - and *coord_3d_ptr is left unaltered, if coord_2d_ptr is NULL or is expressed in a 2D SRF that has no corresponding 3D SRF.

Prototype

extern SE_COORD_STATUS_CODE_ENUM
SRM_DeriveCoord3DFrom2DForGivenElevation
(
const	SE_COORD_2D	*	coord_2d_ptr,	(notes)
	SE_FLOAT64		elevation,	(notes)
	SE_COORD_3D	*	coord_3d_ptr	(notes)
);

Parameters Notes

coord_2d_ptr

 pointer to the 2D coordinate for which we are obtaining a
 corresponding 3D coordinate.

elevation

 given z/elevation

coord_3d_ptr

 pointer to the 3D coordinate that we are deriving.

Prev: Derive Coord 2D From 3D. Next: Dot Product. Up:Index.