Documentation

Creates an entire dataset of tiles.

This function will take an input image for the highest level of a dataset. It will then proceed to segment this image into tiles (padding the edge data to tile boundaries where necessary), then downsample this image to create data for the next level of the pyramid. This process is repeated until the image fits inside a single tile.

This function calls the tsmCreateLevelTiles to create the tiles for an entire level, and tsmDownSample to produce a half-resolution image.

All of the details about the image and how to create the tileset should be provided in the params data structure - refer to the documentation on TsmTileParams for a list of all the fields that you can set (N.B. you should always initialise a TsmTileParams structure with tsmInitTileParams).

This function will create an OI dataset tspec if you set the params->dataset_type field to TSM_IMAGE_DATASET, and it will create a DEM dataset tspec if you set this field to TSM_DEM_DATASET. If you don't set this field at all, then the value will be taken from the connection handle (if it has been defined).

You can specify the file format of the input file by setting the format field of the params structure. Currently we only support the LAS format for both DEMs and OIs. tsmInitTileParams will set this field to TSM_LAS by default.

If you set the TSM_PROGRESS_METER setting for the connection to TRUE (i.e. using tsmSet), then progress reports will be displayed to the terminal during the process. Setting this value to FALSE will make this operation silent (unless an error occurs).