Documentation

Create a set of write connection hints from command line.

This function can be used to allow your programs to support a number of standard command line arguments for specifying preferences for opening a write connection.

The function will scan the provided command line looking for any supported arguments. It will build a TsmConnectionParams structure based upon the options that it finds and return this to you the client. This TsmConnectionParams structure can then be passed directly to tsmConnect when opening a connection.

You should free the memory used by the TsmConnectionParams structure when you are finished with it by calling tsmFreeParams().

For example, if this function finds an option called "-writejpeg" on the command line, it will insert an entry into the TsmConnectionParams structure to say that a JPEG dataset should be generated. So when you use tsmConnect with this set of hints, it will try to create a JPEG version of the dataset.

The currently supported options that this function recognises are:

• "-writelrbt" = write a raw lrbt-raster version of the dataset
• "-writejpeg" = write a jpeg-compressed version of the dataset
• "-writetiffs" = write local tile data in TIFF format
• "-writerawtiles" = write local tile data in old .tile format
• "-writeexact" = fail if an illegal dataset combination is specified (e.g. JPEG DEMs), otherwise a legal alternative will be selected (e.g. LRBT DEMs).