TSLAutoTitleData Class Reference

Detailed Description

This structure holds configuration information for the auto title creation algorithm.

In the following descriptions :

• A building outline is considered the result of a simple 'bound' around the seed point
• A property outline is the final result of the auto title process, after unnecessary building edges have been removed and gaps filled.
• An orphan chain is a line that has one end that does not join another line.

Public Member Functions
	TSLAutoTitleData ()

Public Attributes
TSLTMC	m_propertyBoundWidth
double	m_continuationAngleTolerance
double	m_orphanAngleTolerance
TSLTMC	m_smallOrphanChainLength
double	m_extensionScaleFactor
TSLFeatureID *	m_buildingFeatureCodes
int	m_numBuildingFeatureCodes
const TSLCoordSet *	m_boundary
TSLTMC	m_minGap
TSLTMC	m_maxGap
TSLStyleID	m_edgeColour
TSLDeviceUnits	m_edgeThickness
TSLStyleID	m_edgeStyle
TSLStyleID	m_fillColour
TSLStyleID	m_fillStyle
TSLTMC	m_borderWidth
TSLStyleID	m_borderColour
TSLFeatureID *	m_extensionFeatureCodes
int	m_numExtensionFeatureCodes
bool	m_extend
TSLTMC	m_maxExtensionLength
double	m_minCornerAngleChange
bool	m_markPartyWallAsBoundary
bool	m_addClipEdges

Constructor & Destructor Documentation

TSLAutoTitleData()

TSLAutoTitleData::TSLAutoTitleData ( )

inline

This is the constructor the the auto title data.

Member Data Documentation

m_addClipEdges

bool TSLAutoTitleData::m_addClipEdges

This flag controls if the clipping edges are added to the list of entities while checking for feature's in a map.

This corrects for adjacent buildings which are not being auto-titled and thus not recognised as buildings, causing building edges to be converted to fences.

NOTE: This is experimental do not set to true unless requested to.

m_borderColour

TSLStyleID TSLAutoTitleData::m_borderColour

This parameter specifies the border colour index, as defined in the colour data file, for the polygons created by the auto title helper.

m_borderWidth

TSLTMC TSLAutoTitleData::m_borderWidth

This parameter specifies the width of the border, in TMC units, for the polygons created by the auto title helper.

m_boundary

const TSLCoordSet* TSLAutoTitleData::m_boundary

This parameter specifies the boundary that the auto title helper should use when extracting map data to use then creating properties.

m_buildingFeatureCodes

TSLFeatureID* TSLAutoTitleData::m_buildingFeatureCodes

The algorithm used by the auto title helper attempts to ignore unnecessary parts of the building outlines when constructing a property outline. Since map data is not necessarily consistent in tagging the edges of a building, the auto title helper uses any building seeds it finds within the boundary to apply correct feature codes to the building outline.

This parameter specifies an array of feature codes which indicate that a symbol is a building seed, or a polyline is part of a building outline. The size of the array is specified by the m_numBuildingFeatureCodes parameter. For NTF data, this is typically the 'Roofed building seed' code 321, 'glasshouse seed' code 323, 'building outline' code 1 and 'building pecks' code 4.

m_continuationAngleTolerance

double TSLAutoTitleData::m_continuationAngleTolerance

The algorithm used by the auto title helper, attempts to ignore unnecessary parts of the building outlines when constructing a property outline. An edge of the building may be necessary when it appears to form part of the fence line, by being a continuation of an existing fence line.

This parameter is used to provide a tolerance as to how much the building edge is allowed to diverge from the fence line and still be considered an extension of the fence line. It is specified in degrees where 0.0 means exactly straight ahead, and 90.0 means at right angles to the fence line. A typical value is 1.2 degrees.

m_edgeColour

TSLStyleID TSLAutoTitleData::m_edgeColour

This parameter specifies the edge colour index, as defined in the colour data file, for the polygons created by the auto title helper.

m_edgeStyle

TSLStyleID TSLAutoTitleData::m_edgeStyle

This parameter specifies the edge style index, as defined in the line style data file, for the polygons created by the auto title helper.

m_edgeThickness

TSLDeviceUnits TSLAutoTitleData::m_edgeThickness

This parameter specifies the edge thickness in pixels for the polygons created by the auto title helper.

m_extend

bool TSLAutoTitleData::m_extend

After creating a property outline the auto title helper may attempt to extend the corners of the property outline to particular features, for example, road centre lines.

This parameter specifies whether the extension should occur.

m_extensionFeatureCodes

TSLFeatureID* TSLAutoTitleData::m_extensionFeatureCodes

After creating a property outline the auto title helper may attempt to extend the corners of the property outline to particular features, for example, road centre lines. This happens when the m_extent parameter is true.

This parameter specifies an array of feature codes that the corners may be extended to. The size of the array is specified by the m_numExtensionFeature Codes parameter.

m_extensionScaleFactor

double TSLAutoTitleData::m_extensionScaleFactor

The algorithm used by the auto title helper, attempts to dispose of small orphan chains (dangling nodes) and extend longer orphan chains to intersections with other features. The calculate length of an orphan chain ends when it meets another line, or when the line turns by a sufficient amount.

This parameter is used to decide how much a TSLTMC orphan chain may be extended to meet other map features. It is a multiplier, typically 1.8

m_fillColour

TSLStyleID TSLAutoTitleData::m_fillColour

This parameter specifies the fill colour index, as defined in the colour data file, for the polygons created by the auto title helper.

m_fillStyle

TSLStyleID TSLAutoTitleData::m_fillStyle

This parameter specifies the fill style index, as defined in the fill style data file, for the polygons created by the auto title helper.

m_markPartyWallAsBoundary

bool TSLAutoTitleData::m_markPartyWallAsBoundary

This flag controls if a party wall is marked as a Boundary. By default the flag is set to false and hence does not mark party walls as boundary walls.

m_maxExtensionLength

TSLTMC TSLAutoTitleData::m_maxExtensionLength

After creating a property outline the auto title helper may attempt to extend the corners of the property outline to particular features, for example, road centre lines. This happens when the m_extent parameter is true.

This parameter specifies the maximum distance, in TMC units, that the corners of the property outline may be extended by the meet the extension features.

m_maxGap

TSLTMC TSLAutoTitleData::m_maxGap

This parameter specifies the tolerance, in TMC units, below which 2 points are considered to be close enough to be identified as gap. A small fillet edge is added between the two points by the auto title helper.

m_minCornerAngleChange

double TSLAutoTitleData::m_minCornerAngleChange

After creating a property outline the auto title helper may attempt to extend the corners of the property outline to particular features, for example, road centre lines. This happens when the m_extent parameter is true.

This parameter specifies the minimum angle change that must occur to indicate a corner of the property outline. It is in degrees, where 0.0 indicates a straight line and 90.0 indicates a right angle. A typical value is 45 degrees.

m_minGap

TSLTMC TSLAutoTitleData::m_minGap

This parameter specifies the tolerance, in TMC units, below which 2 points are considered identical and therefore not identified as a gap.

m_numBuildingFeatureCodes

int TSLAutoTitleData::m_numBuildingFeatureCodes

The algorithm used by the auto title helper, attempts to ignore unnecessary parts of the building outlines when constructing a property outline. Since map data is not necessarily consistent in tagging the edges of a building, the auto title helper uses any building seeds it finds within the boundary to apply correct feature codes to the building outline.

This parameter specifies the size of the m_buildingFeatureCodes array .

m_numExtensionFeatureCodes

int TSLAutoTitleData::m_numExtensionFeatureCodes

After creating a property outline the auto title helper may attempt to extend the corners of the property outline to particular features, for example, road centre lines. This happens when the m_extent parameter is true.

This parameter specifies athe size of the array specified by the m_extension FeatureCodes parameter.

m_orphanAngleTolerance

double TSLAutoTitleData::m_orphanAngleTolerance

The algorithm used by the auto title helper, attempts to dispose of small orphan chains (dangling nodes) and extend longer orphan chains to intersections with other features. The calculate length of an orphan chain ends when it meets another line, or when the line turns by a sufficient amount.

This parameter is used to provide a tolerance as to how much the line is allowed to diverge still be considered a straight line. It is specified in degrees where 0.0 means exactly straight ahead, and 90.0 means at right angles to the line. A typical value is 12 degrees.

m_propertyBoundWidth

TSLTMC TSLAutoTitleData::m_propertyBoundWidth

This parameter specifies the distance (in TMC units) from the property seed point, that the auto title algorithm will use when creating the property outline. Like the distance passed to the 'bound' operation, this distance is used to create a square around the property seed point.

m_smallOrphanChainLength

TSLTMC TSLAutoTitleData::m_smallOrphanChainLength

The algorithm used by the auto title helper, attempts to dispose of small orphan chains (dangling nodes) and extend longer orphan chains to intersections with other features. The calculate length of an orphan chain ends when it meets another line, or when the line turns by a sufficient amount.

This parameter is used to specify, in TMC units, the maximum length of a small orphan chain. These orphan chains are discarded when forming the property boundary, before the remaining longer orphan chains are extended to the nearest map feature.