SRM Reference Manual
Functions
SRM DeriveCoordinate2DFrom3D
extern SRM_Status_Code
SRM_DeriveCoordinate2DFrom3D
(
constSRM_Coord *coord_3d_ptr, (notes)
SRM_Coord *coord_2d_ptr (notes)
);

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

SRM_STAT_CODE_SUCCESS and *coord_2d_ptr is set to the appropriate result, if valid parameters were passed in.
SRM_STAT_CODE_INVALID_TARGET_COORDINATE and *coord_2d_ptr is left unchanged, if coord_2d_ptr is NULL.
SRM_STAT_CODE_INVALID_SOURCE_COORDINATE 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.

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: SRM_CrossProduct. Next: SRM_DotProduct. Up:Index.

Last updated: August 23, 2005 Copyright © 2005 SEDRIS