Inheritance diagram for TSLRDTEDExporter:

Detailed Description

This class provides the capability to export user-provided height data in RDTED format.

Pseudo Code

Each scale has to be created separately to ensure that the correct data is put into each tile at the required scale.

TSLRDTEDExporter::unlockSupport( key );

TSLCoordinateSystem::loadCoordinateSystems();

setCallback(callback, userData)
exportDirectory(directory)

Set up data for first scale.
export(First scale)

Set up data for second scale.
export(Second scale)

Repeat set up and export for additional scales.

createToc()

The data written out for each frame is supplied by a user-implemented callback which is responsible for loading the data into the format expected by the exporter.

Output Directory Structure

The output directory structure is:

exportDirectory/RDTED/RPF/SCALE/Frames  RDTED Frame files.
exportDirectory/RDTED/RPF/A.TOC         RDTED Table of Contents file.

Where exportDirectory is the directory set by the user by calling exportDirectory() method.

Limitations:

All files are created big-endian.

The Frame filenames are defined as continuous frame numbers (ref 1 para 5.1.4 & 5.1.5, ref 2, para 30.6).

Polar regions are not supported.

Header fields are filled in with the minimum information.

All Classifications are set to 'U'.

Frames are generated even if part of their extent exceeds the legal latitude longitude limits.

Frame Filenames

The frame naming convention is defined in the spec (MIL-C-89038) para 30.6.

fffffvvp.ccz

Where:

fffff - is radix 34 value that encodes the unique cumulative frame number in the zone (base 34).
vv - version number - always 00
p - producer number - always 0
cc - Map or chart type e.g. AP
z - Zone number/letter

Map/Chart Types (Series Code)

The following table shows the Series Codes that Envitia know about.

Series Code	Scale enum	Description
AP	TSLCADRGScale_1_IN_9M	Series code is not defined anywhere - Area Planning
GN	TSLCADRGScale_1_IN_5M
JN	TSLCADRGScale_1_IN_2M
OH	TSLCADRGScale_1_IN_1M
ON	TSLCADRGScale_1_IN_1M
OW	TSLCADRGScale_1_IN_1M
TP	TSLCADRGScale_1_IN_500K	Tactical Pilotage Chart CADRG
LF	TSLCADRGScale_1_IN_500K	LFC-FR (Day) 1:500,000 Low Flying Chart (Day)- Host Nation CADRG
L1	TSLCADRGScale_1_IN_500K	LFC-1 1:500,000 Low Flying Chart (TBD #1) CADRG
L2	TSLCADRGScale_1_IN_500K	LFC-2 1:500,000 Low Flying Chart (TBD #2) CADRG
L3	TSLCADRGScale_1_IN_500K	LFC-3 1:500,000 Low Flying Chart (TBD #3) CADRG
L4	TSLCADRGScale_1_IN_500K	LFC-4 1:500,000 Low Flying Chart (TBD #4) CADRG
L5	TSLCADRGScale_1_IN_500K	LFC-5 1:500,000 Low Flying Chart (TBD #5) CADRG
LN	TSLCADRGScale_1_IN_500K	LFC (Night) 1:500,000 Low Flying Chart (Night) - Host Nation CADRG
JG	TSLCADRGScale_1_IN_250K	JOG 1:250,000 Joint Operations Graphic CADRG
JA	TSLCADRGScale_1_IN_250K	JOG-A 1:250,000 Joint Operations Graphic - Air CADRG
JR	TSLCADRGScale_1_IN_250K	JOG-R 1:250,000 Joint Operations Graphic - Radar CADRG
JO	TSLCADRGScale_1_IN_250K	OPG 1:250,000 Operational Planning Graphic CADRG
VT	TSLCADRGScale_1_IN_250K	VTAC 1:250,000 VFR Terminal Area Chart CADRG
F1	TSLCADRGScale_1_IN_250K	TFC-1 1:250,000 Transit Flying Chart (TBD #1) CADRG
F2	TSLCADRGScale_1_IN_250K	TFC-2 1:250,000 Transit Flying Chart (TBD #2) CADRG
F3	TSLCADRGScale_1_IN_250K	TFC-3 1:250,000 Transit Flying Chart (TBD #3) CADRG
F4	TSLCADRGScale_1_IN_250K	TFC-4 1:250,000 Transit Flying Chart (TBD #4) CADRG
F5	TSLCADRGScale_1_IN_250K	TFC-5 1:250,000 Transit Flying Chart (TBD #5) CADRG
AT	TSLCADRGScale_1_IN_200K	ATC 1:200,000 Series 200 Air Target Chart CADRG
VH	TSLCADRGScale_1_IN_125K	HRC 1:125,000 Helicopter Route Chart CADRG
TN	TSLCADRGScale_1_IN_125K	TFC (Night) 1:250,000 Transit Flying Chart(Night)- Host nation CADRG
TR	TSLCADRGScale_1_IN_200K	TLM200 1:200,000 Topographic Line Map 1:200,000 scale CADRG
TC	TSLCADRGScale_1_IN_100K	TLM 100 1:100,000 Topographic Line Map 1:100,0000 scale CADRG
RV	TSLCADRGScale_1_IN_50K	Riverine 1:50,000 Riverine Map 1:50,000 scale CADRG
TL	TSLCADRGScale_1_IN_50K	TLM 50 1:50,000 Topographic Line Map CADRG
UL	TSLCADRGScale_1_IN_50K	TLM50-Other 1:50,000 Topographic Line Map (other 1:50,000 scale) CADRG
TT	TSLCADRGScale_1_IN_25K	TLM25 1:25,000 Topographic Line Map 1:25,000 scale CADRG
TQ	TSLCADRGScale_1_IN_24K	TLM24 1:24,000 Topographic Line Map 1:24,000 scale CADRG
HA	TSLCADRGScale_UNKNOWN	HA Various Harbor and Approach Charts CADRG
CO	TSLCADRGScale_UNKNOWN	CO Various Coastal Charts CADRG
OA	TSLCADRGScale_UNKNOWN	OPAREA Various Naval Range Operating Area Chart CADRG
CG	TSLCADRGScale_UNKNOWN	CG Various City Graphics CADRG
C1	TSLCADRGScale_1_IN_10K	CG 1:10,000 City Graphics CADRG
C2	TSLCADRGScale_1_IN_10560	CG 1:10,560 City Graphics CADRG
C3	TSLCADRGScale_1_IN_11000	CG 1:11,000 City Graphics CADRG
C4	TSLCADRGScale_1_IN_11800	CG 1:11,800 City Graphics CADRG
C5	TSLCADRGScale_1_IN_12000	CG 1:12,000 City Graphics CADRG
C6	TSLCADRGScale_1_IN_12pt5K	CG 1:12,500 City Graphics CADRG
C7	TSLCADRGScale_1_IN_12800	CG 1:12,800 City Graphics CADRG
C8	TSLCADRGScale_1_IN_14000	CG 1:14,000 City Graphics CADRG
C9	TSLCADRGScale_1_IN_14700	CG 1:14,700 City Graphics CADRG
CA	TSLCADRGScale_1_IN_15000	CG 1:15,000 City Graphics CADRG
CB	TSLCADRGScale_1_IN_15500	CG 1:15,500 City Graphics CADRG
CC	TSLCADRGScale_1_IN_16000	CG 1:16,000 City Graphics CADRG
CD	TSLCADRGScale_1_IN_16666	CG 1:16,666 City Graphics CADRG
CE	TSLCADRGScale_1_IN_17000	CG 1:17,000 City Graphics CADRG
CF	TSLCADRGScale_1_IN_17500	CG 1:17,500 City Graphics CADRG
CH	TSLCADRGScale_1_IN_18000	CG 1:18,000 City Graphics CADRG
CJ	TSLCADRGScale_1_IN_20000	CG 1:20,000 City Graphics CADRG
CK	TSLCADRGScale_1_IN_21000	CG 1:21,000 City Graphics CADRG
CL	TSLCADRGScale_1_IN_21120	CG 1:21,120 City Graphics CADRG
CN	TSLCADRGScale_1_IN_22000	CG 1:22,000 City Graphics CADRG
CP	TSLCADRGScale_1_IN_23000	CG 1:23,000 City Graphics CADRG
CQ	TSLCADRGScale_1_IN_25000	CG 1:25,000 City Graphics CADRG
CR	TSLCADRGScale_1_IN_26000	CG 1:26,000 City Graphics CADRG
CS	TSLCADRGScale_1_IN_35000	CG 1:35,000 City Graphics CADRG
CT	TSLCADRGScale_1_IN_36000	CG 1:36,000 City Graphics CADRG
CM	TSLCADRGScale_UNKNOWN	CM Various Combat Charts CADRG
A1	TSLCADRGScale_1_IN_10K	CM 1:10,000 Combat Charts, 1:10,000 scale CADRG
A2	TSLCADRGScale_1_IN_25K	CM 1:25,000 Combat Charts, 1:25,000 scale CADRG
A3	TSLCADRGScale_1_IN_50K	CM 1:50,000 Combat Charts, 1:50,000 scale CADRG
A4	TSLCADRGScale_1_IN_100K	CM 1:100,000 Combat Charts, 1:100,000 scale CADRG
MI	TSLCADRGScale_1_IN_50K	MIM 1:50,000 Military Installation Maps CADRG
M1	TSLCADRGScale_UNKNOWN	MIM Various Military Installation Map (TBD #1) CADRG
M2	TSLCADRGScale_UNKNOWN	MIM Various Military Installation Map (TBD #2) CADRG
VN	TSLCADRGScale_1_IN_500K	VNC 1:500,000 Visual Navigation Charts CADRG
MM	TSLCADRGScale_UNKNOWN	Various (Miscellaneous Maps & Charts) CADRG
I1	TSLCADRGScale_10M	10m Imagery, 10 meter resolution CIB
I2	TSLCADRGScale_5M	5m Imagery, 5 meter resolution CIB
I3	TSLCADRGScale_2M	2m Imagery, 2 meter resolution CIB
I4	TSLCADRGScale_1M	1m Imagery, 1 meter resolution CIB
I5	TSLCADRGScale_0pt5M	0.5m Imagery, .5 (half) meter resolution CIB
IV	TSLCADRGScale_UNKNOWN	Various>10m Imagery, greater than 10 meter resolution CIB
R1	TSLCADRGScale_750M	RDTED 750M - 1:5,000,000
R3	TSLCADRGScale_150M	RDTED 150M - 1:1,000,000
R5	TSLCADRGScale_37pt5M	RDTED 37.5M - 1:250,000

References:

MIL-STD-2411-1
CADRG (MIL-C-89038)
CIB (MIL-C-89041)
RDTED (ref 1, 5, 6 & MIL-PRF-xxxx)
RPF (MIL-STD-2411)
NITF (MIL-STD-2411-2, MIL-STD-2500).
Software: NIMAMUSE 2.1, Raster Importer 2.1.1.

Public Member Functions
	TSLRDTEDExporter ()

virtual	~TSLRDTEDExporter ()

bool	createTOC (bool keepAnalysisFiles)

bool	exportRdted (const TSLCADRGScaleEnum scale, const TSLGeodeticExtent &extent, TSLRDTEDDataCallback frameCallback, void callbackData, const char mapChartType=0)

Public Member Functions inherited from TSLRPFExporter
bool	exportDirectory (const char *directory)

void	setCallback (TSLRPFProgressCallback callback, void *callbackData=0)

void	cancel ()

Static Public Member Functions
static bool	unlockSupport (const char *key)

Additional Inherited Members
Protected Member Functions inherited from TSLRPFExporter
	TSLRPFExporter ()

virtual	~TSLRPFExporter ()

bool	createTableOfContents (bool keepAnalysisFiles, const char *product)

Protected Attributes inherited from TSLRPFExporter
void *	m_classId

Constructor & Destructor Documentation

◆ TSLRDTEDExporter()

TSLRDTEDExporter::TSLRDTEDExporter ( )

◆ ~TSLRDTEDExporter()

virtual TSLRDTEDExporter::~TSLRDTEDExporter ( )

virtual

Member Function Documentation

◆ createTOC()

bool TSLRDTEDExporter::createTOC ( bool keepAnalysisFiles )

Create the 'A.TOC' file in the export directory.

To be able to create the Table of Contents file the Analysis files generated when creating the product at the required scales must be present in the export directory. The names of the sub-directories and analysis files are significant and should not be altered.

All sub-directories are searched for valid Analysis files. A TOC file must not contain multiple products (this can happen if the user moves files around).

Call createTOC once all the scales have been generated.

Parameters

keepAnalysisFiles If set to false deletes the Analysis files if the TOC file was created. Default false.

Returns: true if successful, false otherwise.

◆ exportRdted()

bool TSLRDTEDExporter::exportRdted	(	const TSLCADRGScaleEnum	scale,
		const TSLGeodeticExtent &	extent,
		TSLRDTEDDataCallback	frameCallback,
		void *	callbackData,
		const char *	mapChartType = 0 )

Exports user-supplied data in RDTED format. Please refer to the class document for a more detailed description of the setup process..

Parameters

scale	Scale to output.
extent	Extent of area to output.
frameCallback	pointer to user function which provides terrain data.
callbackData	pointer to user data, passed back to user in call to frame Callback.
mapChartType	Map or chart type. Also known as Series Code. (See class documentation - Frame Filenames & Map/Chart Types) If this variable is NULL then we use the default defined in TSLCADRGScale Enum. The passed string must be two characters.

Returns: true if the export succeeded, false otherwise.

◆ unlockSupport()

static bool TSLRDTEDExporter::unlockSupport ( const char * key )

static

Unlocks support for RDTED export.

If this method is not called then exporting of RDTED will fail.

Parameters

key	The unlock key for the RDTED filter, provided by Envitia.

Detailed Description

Pseudo Code

Output Directory Structure

Limitations:

Frame Filenames

Map/Chart Types (Series Code)

References:

Public Member Functions

Static Public Member Functions

Additional Inherited Members

Constructor & Destructor Documentation

◆ TSLRDTEDExporter()

◆ ~TSLRDTEDExporter()

Member Function Documentation

◆ createTOC()

◆ exportRdted()

◆ unlockSupport()