EstablishTransform

WRAPPER_API bool EstablishTransform(const TransformPreferences &prefs, ConcatenatedTransform &concatTransform);

Description

This method may be used to complete the setup of the passed in ConcatenatedTransform object, by populating it with valid transforms to convert between the specified source and targets, as limited by the settings in the TransformPreferences provided.

The ConcatenatedTransform may then be used to generate a PointTransformer for use in conversions.

Note that not all setups will result in a valid transformation. If a transform is required and none is available, an exception will be thrown.

Note also that the transform established will not necessarily be consistent, if there are changes to the TransformPreferences, the underlying DataSource objects, or the system settings regarding whether or not AreaOfUse is being ignored.

The main utility of this method will be to those wishing to bypass the TransformPicker dialog and simply pick a valid transform "invisibly".