Detailed Description

This class is used to control the conversion of S57 data into a form suitable for fast display by MapLink. It is capable of both ingesting new datasets as well as managing and applying updates to existing ingested data.

During ingest callbacks will be issued to the OEM via the TSLS57DataClient interface. For a description of which callbacks are used and when see the documentation for TSLS57DataClient.

Public Member Functions
	TSLS57MediaIngestManager (TSLS57DataClient *dataClient, TSLMapLinkVersion maplinkVersion=TSL_CURRENT_MAPLINK_VERSION)

void	destroy ()

bool	loadCatalog (const char catalogFile, const char filterConfigurationFile=0)

bool	loadCell (const char s57CellLocation, const char filterConfigurationFile=0)

void	setProcessingFlags (TSLFilterProcess processingFlags)

void *	operator new (size_t size) TSL_NO_THROW

void *	operator new (size_t size, char *filename, int line)

Constructor & Destructor Documentation

◆ TSLS57MediaIngestManager()

TSLS57MediaIngestManager::TSLS57MediaIngestManager	(	TSLS57DataClient *	dataClient,
		TSLMapLinkVersion	maplinkVersion = TSL_CURRENT_MAPLINK_VERSION )

Member Function Documentation

◆ destroy()

void TSLS57MediaIngestManager::destroy ( )

Used to destroy instances of this class.

◆ loadCatalog()

bool TSLS57MediaIngestManager::loadCatalog	(	const char *	catalogFile,
		const char *	filterConfigurationFile = 0 )

Loads the S57 dataset as specified by the given CATALOG file.This method will ingest all cells contained within the CATALOG.

During ingest callbacks will be issued via the TSLS57DataClient. For information on when these callbacks will be invoked see the class documentation.

Parameters

catalogFile	The full path including filename to the CATALOG file for the S57 dataset.
filterConfigurationFile	The full path to the file which will be used to configure the S57 filter.

Returns: true on successful completion of an ingest, or false if a fatal error was encountered. Any errors encountered will be passed to the OEM via the notifyError() or notifyWarning() callbacks on the TSLS57DataClient.

◆ loadCell()

bool TSLS57MediaIngestManager::loadCell	(	const char *	s57CellLocation,
		const char *	filterConfigurationFile = 0 )

Loads the S57 cell as specified by the given s57CellLocation parameter.

During ingest callbacks will be issued via the TSLS57DataClient. For information on when these callbacks will be invoked see the class documentation.

Parameters

s57CellLocation	The full path including filename to the S57 cell which is to be loaded.
filterConfigurationFile	An optional full path to the file which will be used to configure the S57 filter. If no path is supplied, default filter settings will be used.

Returns: true on successful completion of an ingest, or false if a fatal error was encountered. Any errors encountered will be passed to the OEM via the notifyError() or notifyWarning() callbacks on the TSLS57DataClient.

◆ operator new() [1/2]

void * TSLS57MediaIngestManager::operator new ( size_t size )

Allocation override for API redirection.

◆ operator new() [2/2]

void * TSLS57MediaIngestManager::operator new	(	size_t	size,
		char *	filename,
		int	line )

When included in an MFC application in debug mode, the debug new expects this to be here. Override it and return the same as the normal one. The library must include it when compiled in release mode, since the user's application may be in debug mode.

◆ setProcessingFlags()

void TSLS57MediaIngestManager::setProcessingFlags ( TSLFilterProcess processingFlags )

Allows the processing options when reading S57 data to be set.

The following option increases the time to ingest data but improves performance of drawing:

TSLFilterProcessKeyHoling | TSLFilterProcessIgnorePolygonGeometryFailures