FindTransforms

 
WRAPPER_API void FindTransforms(
const TransformPreferences &prefs,
const ConcatenatedTransform &concatTransform,
std::list<const TransformInfo*> &datumDirectChoices, 
 
std::list<const TransformInfo*> &verticalDirectChoices,
std::list<const TransformInfo*> &parametricChoices,
std::list<const TransformInfo*> &exactMatchChoices,
std::list<const TransformInfo*> &datumConcatenatedChoices,
std::list<const TransformInfo*> &verticalConcatenatedChoices,
std::list<const TransformInfo*> &timeDependentChoices,
std::map<BmgString, std::list<const TransformInfo*> 
 > &datumGeneratedChoices,
std::map<BmgString, std::list<const TransformInfo*> 
 > &verticalGeneratedChoices,
DatumTransform** htdpChoice,
bool &horizontalNoop,
bool &verticalNoop) const;

Description

This method may be used to generate a full list of all CoordTransform objects (and sets of objects) that may be used to perform the transformation of coordinate point data in a specific scenario. The various returned choices are those which are valid for the Sources and Targets of the provided ConcatenatedTransform object, and as match the criteria identified in the passed in TransformPreferences.

In the case of the datumGeneratedChoices and verticalGeneratedChoices, the BmgString in the std::map will contain the GC code of the CoordSys used as an intermediate. Each list will contain a pair of transforms that can be used to perform a transform via that intermediate where no direct transform may be available.

Note that the transformations returned by this method are based on the provided source and target coordinate system, and the TransformPreferences object, and not all lists will contain results. If a transform is required and none is available, an exception will be thrown.

The main utility of this method will be to those wishing to bypass the TransformPicker dialog and create their own list of transformation choices for a user.

Note: The developer is responsible for disposing all objects returned by this method.