SRM Reference Manual
Functions
SRM DeriveCoordinate2DFrom3D
extern SRM_Status_Code
SRM_DeriveCoordinate2DFrom3D
(
const SRM_Coordinate  *coord_3d_ptr,1
SRM_Coordinate  *coord_2d_ptr2
);

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

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

2 pointer to the 2D coordinate that we are deriving.


Prev: SRM_CrossProduct. Next: SRM_DotProduct. Up:Index.