Derive Coord 2D From 3D

Function Name: Derive Coord 2D From 3D

Definition

Given a 3D coordinate, expressed in an SRF that has a corresponding 2D SRF, constructs the corresponding 2D representation (i.e., without the z/elevation portion of the 3D, in the proper 2D SRF).

Returns

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

SE_COORD_INVALID_DEST_COORD - and *coord_2d_ptr is left unchanged, if coord_2d_ptr is NULL.

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

Prototype

extern SE_COORD_STATUS_CODE_ENUM
SRM_DeriveCoord2DFrom3D
(
const	SE_COORD_3D	*	coord_3d_ptr,	(notes)
	SE_COORD_2D	*	coord_2d_ptr	(notes)
);

Parameters Notes

coord_3d_ptr

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

coord_2d_ptr

 pointer to the 2D coordinate that we are deriving.

Prev: Cross Product. Next: Derive Coord 3D From 2D For Given Elevation. Up:Index.