TSLCompareHelper Class Reference

Detailed Description

Utility class providing some standard data layer comparison functions.

All methods of this class are static.

The methods in this class are known to not be thread safe.

Static Public Member Functions
static bool	anyDifferences (TSLStandardDataLayer *sourceLayer1, TSLStandardDataLayer *sourceLayer2, TSLTMC tolerance=0, bool explodePolygons=true)
static bool	anyDifferencesWithID (TSLStandardDataLayer *sourceLayer1, TSLStandardDataLayer *sourceLayer2, TSLTMC tolerance=0, bool explodePolygons=false)
static bool	copyDifferences (TSLStandardDataLayer *sourceLayer1, TSLStandardDataLayer *sourceLayer2, TSLStandardDataLayer *resultLayer1, TSLStandardDataLayer *resultLayer2, TSLTMC tolerance=0, int edgeThickness=2, TSLStyleID layer1Colour=1, TSLStyleID layer2Colour=4, bool explodePolygons=true)
static bool	copyDifferencesWithID (TSLStandardDataLayer *sourceLayer1, TSLStandardDataLayer *sourceLayer2, TSLStandardDataLayer *resultLayer1, TSLStandardDataLayer *resultLayer2, TSLTMC tolerance=0, int edgeThickness=2, TSLStyleID layer1Colour=1, TSLStyleID layer2Colour=4, bool explodePolygons=false)
static bool	showDifferences (TSLStandardDataLayer *sourceLayer1, TSLStandardDataLayer *sourceLayer2, TSLTMC tolerance=0, int edgeThickness=2, TSLStyleID layer1Colour=1, TSLStyleID layer2Colour=4, bool explodePolygons=true)
static bool	showDifferencesWithID (TSLStandardDataLayer *sourceLayer1, TSLStandardDataLayer *sourceLayer2, TSLTMC tolerance=0, int edgeThickness=2, TSLStyleID layer1Colour=1, TSLStyleID layer2Colour=4, bool explodePolygons=false)

Member Function Documentation

anyDifferences()

static bool TSLCompareHelper::anyDifferences ( TSLStandardDataLayer * sourceLayer1, TSLStandardDataLayer * sourceLayer2, TSLTMC tolerance = 0, bool explodePolygons = true )

static

Compares the data contained within the specified source data layers.

A tolerance may be applied to the coordinates within an entity.

Parameters

sourceLayer1	First source layer to compare
sourceLayer2	Second source layer to compare
tolerance	Tolerance in TMC units, for coordinate comparison
explodePolygons	If true converts the parts of a polygon into a polyline (default true). If the parts of a polygon (inners and outer edge) are converted to a polyline then the bordered polygon side orientation are ignored.

Returns

True if there are any differences, False otherwise.

anyDifferencesWithID()

static bool TSLCompareHelper::anyDifferencesWithID ( TSLStandardDataLayer * sourceLayer1, TSLStandardDataLayer * sourceLayer2, TSLTMC tolerance = 0, bool explodePolygons = false )

static

Compares the data contained within the specified source data layers, also taking into account changes to the Entity ID.

A tolerance may be applied to the coordinates within an entity.

Parameters

sourceLayer1	First source layer to compare
sourceLayer2	Second source layer to compare
tolerance	Tolerance in TMC units, for coordinate comparison
explodePolygons	If true converts the parts of a polygon into a polyline (default false). If the parts of a polygon (inners and outer edge) are converted to a polyline then the bordered polygon side orientation are ignored.

Returns

True if there are any differences, False otherwise.

copyDifferences()

static bool TSLCompareHelper::copyDifferences ( TSLStandardDataLayer * sourceLayer1, TSLStandardDataLayer * sourceLayer2, TSLStandardDataLayer * resultLayer1, TSLStandardDataLayer * resultLayer2, TSLTMC tolerance = 0, int edgeThickness = 2, TSLStyleID layer1Colour = 1, TSLStyleID layer2Colour = 4, bool explodePolygons = true )

static

Compares the data contained within the specified source data layers.

A tolerance may be applied to the coordinates within an entity.

The differences will be copied to the result data layers, with the differences highlighted using the specified attributes. The first drawing surface that contains sourceLayer1 is used to determine rendering of map features. Entities that are unique to the first source layer will be copied to the first result layer, while entities that are unique to the second source layer are copied to the second result layer. Note that the resultLayers can be the same layer. In this case the layer will contain all entities that are unique to each source layer.

Parameters

sourceLayer1	First source layer to compare
sourceLayer2	Second source layer to compare
resultLayer1	Entities that are only in sourceLayer1 are copied to this layer
resultLayer2	Entities that are only in sourceLayer2 are copied to this layer.
tolerance	Tolerance in TMC units, for coordinate comparison
edgeThickness	Copied entities have their edge thickness modified to this value.
layer1Colour	Entities copied from sourceLayer1 have their edge colour modified to this value
layer2Colour	Entities copied from sourceLayer2 have their edge colour modified to this value
explodePolygons	If true converts the parts of a polygon into a polyline (default true). If the parts of a polygon (inners and outer edge) are converted to a polyline then the bordered polygon side orientation are ignored.

Returns

True if there are any differences, False otherwise.

copyDifferencesWithID()

static bool TSLCompareHelper::copyDifferencesWithID ( TSLStandardDataLayer * sourceLayer1, TSLStandardDataLayer * sourceLayer2, TSLStandardDataLayer * resultLayer1, TSLStandardDataLayer * resultLayer2, TSLTMC tolerance = 0, int edgeThickness = 2, TSLStyleID layer1Colour = 1, TSLStyleID layer2Colour = 4, bool explodePolygons = false )

static

Compares the data contained within the specified source data layers, also taking into account changes to the Entity ID.

A tolerance may be applied to the coordinates within an entity.

The differences will be copied to the result data layers, with the differences highlighted using the specified attributes. The first drawing surface that contains sourceLayer1 is used to determine rendering of map features. Entities that are unique to the first source layer will be copied to the first result layer, while entities that are unique to the second source layer are copied to the second result layer. Note that the resultLayers can be the same layer. In this case the layer will contain all entities that are unique to each source layer.

Parameters

sourceLayer1	First source layer to compare
sourceLayer2	Second source layer to compare
resultLayer1	Entities that are only in sourceLayer1 are copied to this layer
resultLayer2	Entities that are only in sourceLayer2 are copied to this layer.
tolerance	Tolerance in TMC units, for coordinate comparison
edgeThickness	Copied entities have their edge thickness modified to this value.
layer1Colour	Entities copied from sourceLayer1 have their edge colour modified to this value
layer2Colour	Entities copied from sourceLayer2 have their edge colour modified to this value
explodePolygons	If true converts the parts of a polygon into a polyline (default false). If the parts of a polygon (inners and outer edge) are converted to a polyline then the bordered polygon side orientation are ignored.

Returns

True if there are any differences, False otherwise.

showDifferences()

static bool TSLCompareHelper::showDifferences ( TSLStandardDataLayer * sourceLayer1, TSLStandardDataLayer * sourceLayer2, TSLTMC tolerance = 0, int edgeThickness = 2, TSLStyleID layer1Colour = 1, TSLStyleID layer2Colour = 4, bool explodePolygons = true )

static

Compares the data contained within the specified source data layers.

A tolerance may be applied to the coordinates within an entity.

The differences will be highlighted using the specified attributes. The first drawing surface that contains sourceLayer1 is used to determine rendering of map features.

Parameters

sourceLayer1	First source layer to compare
sourceLayer2	Second source layer to compare
tolerance	Tolerance in TMC units, for coordinate comparison
edgeThickness	Entities have their edge thickness modified to this value.
layer1Colour	Entities that are only in sourceLayer1 have their edge colour modified to this value
layer2Colour	Entities that are only in sourceLayer2 have their edge colour modified to this value
explodePolygons	If true converts the parts of a polygon into a polyline (default true). If the parts of a polygon (inners and outer edge) are converted to a polyline then the bordered polygon side orientation are ignored.

Returns

True if there are any differences, False otherwise.

showDifferencesWithID()

static bool TSLCompareHelper::showDifferencesWithID ( TSLStandardDataLayer * sourceLayer1, TSLStandardDataLayer * sourceLayer2, TSLTMC tolerance = 0, int edgeThickness = 2, TSLStyleID layer1Colour = 1, TSLStyleID layer2Colour = 4, bool explodePolygons = false )

static

Compares the data contained within the specified source data layers, also taking into account changes to the Entity ID.

A tolerance may be applied to the coordinates within an entity.

The differences will be highlighted using the specified attributes. The first drawing surface that contains sourceLayer1 is used to determine rendering of map features.

Parameters

sourceLayer1	First source layer to compare
sourceLayer2	Second source layer to compare
tolerance	Tolerance in TMC units, for coordinate comparison
edgeThickness	Entities have their edge thickness modified to this value.
layer1Colour	Entities that are only in sourceLayer1 have their edge colour modified to this value
layer2Colour	Entities that are only in sourceLayer2 have their edge colour modified to this value
explodePolygons	If true converts the parts of a polygon into a polyline (default false). If the parts of a polygon (inners and outer edge) are converted to a polyline then the bordered polygon side orientation are ignored.

Returns

True if there are any differences, False otherwise.