CoreandServices.book - Ocean - Schlumberger

Coordinate Systems
These methods provide an alternative to checking thrown exceptions or having API
methods return cryptic error codes that must be parsed. For a more detailed description of
any error or warning encountered, you should get the values of the Message and Code
properties. The following code sample shows an example of using the ReturnStatus
object.
// Assume csConverter and origPoint have been successfully created
// The status object will be instantiated by converter engine
ReturnStatus status = null;
// Status object is most often passed as an output parameter
Point3 newPoint = csConverter.Convert(origPoint, out status);
// Ceck status object with simple boolean method
if (status.IsOk())
{
Console.WriteLine("Conversion went okay!");
}
else if (status.IsError())
{
Console.WriteLine("Error during coordinate conversion process.");
Console.WriteLine("Error Code {0}, Message {1}", status.Code,
status.Message);
}
else if (status.IsWarning())
{
// write to error log file
}
As mentioned in the above example, the status object is often referenced as an output
parameter.
Local Transforms
Local Transforms are used to convert coordinates between a projected coordinate system
and an applications system. This allows you to convert, for example, from X, Y, Z to line,
crossline, and depth. You can also perform shifting of points within one coordinate system.
The conversion is accomplished by introducing a Matrix4 object. The LocalTransform
Schlumberger Private
Ocean Services 4-221