3.2. Module: terrain_map_viewer

-Class Hierarchy

Terrain_map_viewer is not a subclass of any other class.

-Description

Terrain_map_viewer is a class which displays a subregion of interest that the user has chosen from the thumbnail map. Terrain_map_viewer provides the user with the ability to manipulate the displayed subregion: namely, he may choose to exaggerate the z-coordinates of the subregion's data points by a constant factor so as to emphasize the differences in elevations between various points in the subregion. To do this, the user first selects the desired factor by adjusting the on-screen counter; then, he presses the RECALCULATE button, and GISMO will redraw the terrain map with the new z factor.

The terrain_map_viewer contains four widgets:

1. an Fl_Gl_Window in which to draw the actual terrain map;
2. an Fl_Window (this allows the terrain map to be displayed in a FLTK window);
3. an Fl_Counter that allows the user to choose a scaling factor for the z-coordinates;
4. and an Fl_Button with the label "RECALCULATE", which when pushed will make GISMO redraw the terrain map using the scaling factor displayed in the counter.

terrain_map_viewer( vector<DataAbstraction*> *newtiles,
        int sx, int sy, int sz, int ex, int ey, int ez )

Description: This constructor creates a terrain_map_viewer from the data specified by newtiles

Inputs: *newtiles, a pointer to the set of data to be drawn by this map
             sx, sy, sz - integers specifying the minimum x, y and z values of the dataset that the user wishes to be drawn
             ex, ey, ez - integers specifying the minimum x, y and z values of the dataset that the user wishes to be drawn.  In short, these two sets of values tell this window where to set the boundaries of the drawable region.  Anything less or greater than the values specified by these regions will not be drawn.

Outputs: A new terrain_map_viewer will be created.

Assumptions: None

Exceptions: None.

Known Bugs: None Yet.

show()

Description: show is a method that simply causes the Fl_Window and the GlMapWindow to be displayed.

Inputs: None.

Outputs: The terrain_map_viewer is displayed on the screen.

Assumptions:

Exceptions:

Known Bugs: None Yet.
 

hide()

Description: Closes the terrain_map_viewer.

Inputs: None.

Outputs: The terrain_map_viewer is no longer displayed on the screen.

Assumptions:

Exceptions: None.

Known Bugs: None yet.