Function Name: Convert Coord To Given System Without Boundary Checking

Definition

This performs the same conversion as SE_ConvertCoordToGivenSystem() but skips boundary checks for use with trusted data in order to achieve increased speed. As a result, operations may be "successfully" performed on invalid coordinates, or result in invalid coordinates.

Returns

SE_COORD_SUCCESS - and *dest_coord_ptr is set to the appropriate operation result, if the coordinate operation succeeded.

SE_COORD_UNSUPPORTED - and *dest_coord_ptr is left unchanged, if the coordinate operation (conversion and/or transformation) is unsupported.

SE_COORD_INVALID_SRF_PAIR - and *dest_coord_ptr is left unchanged, if coord_op_params_ptr was NULL or invalid.

SE_COORD_INVALID_SOURCE_COORD - and *dest_coord_ptr is left unchanged, if source_coord_ptr is NULL.

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

SE_COORD_FAILURE - and *dest_coord_ptr is left unchanged, if the coordinate operation failed for reasons unspecified.

Prototype


extern SE_COORD_STATUS_CODE_ENUM
SE_ConvertCoordToGivenSystemWithoutBoundaryChecking
(
constSE_CONVERT_COORD_SYSTEM_PAIR coord_op_params_ptr, (notes)
constSE_COORD *source_coord_ptr, (notes)
SE_COORD *dest_coord_ptr (notes)
);

Parameters Notes

coord_op_params_ptr

 a pointer to the optimized coordinate operations parameters.

source_coord_ptr

 a pointer to the incoming coordinate, the coordinate to convert

dest_coord_ptr

 a pointer to where the converted coordinate will be stored.  This
 can be the same location that source_coord_ptr points to, but it
 does not have to be.

Prev: Convert Coord To Given System. Next: Convert Degrees To Radians. Up:Index.