IlvCADRGFrame Class Reference

This class defines a CADRG frame as described in the CADRG table of contents. More...

#include <ilviews/maps/format/cadrg/cadrgutil.h>

Public Member Functions
IlShort	getColumn () const
	Returns the column of the frame in its CADRG coverage. More...
const IlvCADRGCoverage *	getCoverage () const
	Returns the IlvCADRGCoverage that owns the frame. More...
const char *	getFileName () const
	Returns the file name of the frame as read from the CADRG table of contents. More...
IlBoolean	getLowerRightCorner (IlvCoordinate &lr) const
	Queries the lower-right corner of the frame region. More...
const char *	getPathName () const
	Returns the path name of the frame as read from the CADRG table of contents. The path name is relative to the directory that contains the CADRG table of contents. More...
IlShort	getRow () const
	Returns the row of the frame in its CADRG coverage. More...
IlBoolean	getUpperLeftCorner (IlvCoordinate &ul) const
	Queries the upper-left corner of the frame region. More...
IlvCADRGFrameReader *	makeReader () const
	Initializes a frame reader for the CADRG frame. More...

Detailed Description

This class defines a CADRG frame as described in the CADRG table of contents.

Library: ilvmaps

A frame corresponds physically to a file in a CADRG product. It can be loaded with an IlvCADRGFrameReader.

Most of the frames are georeferenced, except for those used to display the overview of a CADRG product or the map legends. Instances of IlvCADRGFrame are obtained with an IlvCADRGCoverage.

See also

makeReader().

Member Function Documentation

IlShort IlvCADRGFrame::getColumn

(

)

const

Returns the column of the frame in its CADRG coverage.

Returns

The column of the frame.

const IlvCADRGCoverage* IlvCADRGFrame::getCoverage

(

)

const

Returns the IlvCADRGCoverage that owns the frame.

Returns

An IlvCADRGCoverage that should not be modified nor deleted.

const char* IlvCADRGFrame::getFileName

(

)

const

Returns the file name of the frame as read from the CADRG table of contents.

Returns

The capitalized file name of the corresponding frame file.

See also

getPathName(), IlvCADRGTocReader.

IlBoolean IlvCADRGFrame::getLowerRightCorner

(

IlvCoordinate &

lr

)

const

Queries the lower-right corner of the frame region.

The frame projection is either an IlvGeographicProjection or, for polar regions, an IlvAzimuthalEquidistantProjection.

Parameters

lr	Set on return to the coordinates of the lower-right corner of the frame.

Returns

IlTrue if the frame is georeferenced. Otherwise, it returns IlFalse, and the value of lr should not be used. This occurs in the case of legend frames or of overview frames.

const char* IlvCADRGFrame::getPathName

(

)

const

Returns the path name of the frame as read from the CADRG table of contents. The path name is relative to the directory that contains the CADRG table of contents.

Returns

The capitalized path name relative to the directory containing the CADRG table of content file, which is named "A.TOC".

See also

getPathName(), IlvCADRGTocReader.

IlShort IlvCADRGFrame::getRow

(

)

const

Returns the row of the frame in its CADRG coverage.

Returns

The row of the frame.

IlBoolean IlvCADRGFrame::getUpperLeftCorner

(

IlvCoordinate &

ul

)

const

Queries the upper-left corner of the frame region.

The frame projection is either an IlvGeographicProjection or, for polar regions, an IlvAzimuthalEquidistantProjection.

Parameters

ul	Set on return to the coordinates of the upper-left corner of the frame.

Returns

IlTrue if the frame is georeferenced. Otherwise, it returns IlFalse, and the value of ul should not be used. This occurs in the case of legend frames or of overview frames.

IlvCADRGFrameReader* IlvCADRGFrame::makeReader

(

)

const

Initializes a frame reader for the CADRG frame.

Returns

0 if the reader initialization failed, or an IlvCADRGFrameReader instance that must be deleted.