Previous PageNext Page

3.3. File Menu

File Open Image

File Retrieve Image

Purpose

Parameters

Remarks

Use File Open Image to display an image in a new window and File Retrieve Image to display an image in the currently active graphic window.

The difference image file is optional. 0's for all image coordinates can be used to default to the entire image. The image will be scaled to fit the window. There is no longer a zoom factor; infinite, floating-point zoom is used. See the IDA Users Manual for a description of IDA file formats. See color tables for a description of color tables and how to create them.

An image should be retrieved before any maps. Also, retrieving more than one image into a window should be avoided.

File Open Map

File Retrieve Map

Purpose

Display a .bna map in a new window,retrieve a map into the currently active window, or
overlay a map on top of an image, bitmap or map in the currently active window

Parameters

Remarks

The map file format is based on the Strategic Mapping ASCII .bna file format. See the IDA Users Manual, or a Strategic Mapping manual for a description of the file format.

The data file and data field parameters are optional. If they are included, the data file must be an ASCII, comma-delimited file with field descriptors in the first row and map labels in the first column. All data values must be numeric. The legend is only used if data is displayed. If a color table is specified, it will be used to assign colors to ranges of data values. This will over-ride the map fill color. If no color table is specified, the data be displayed in 5 equal ranges in colors from red to green.

Once a map has been displayed, the map label for points and polygons will be displayed in the status bar by clicking on the feature. If data has been displayed, the data value for that feature will also be displayed.

File Open Bitmap

File Retrieve Bitmap

Purpose

Parameters

Remarks

Use X1, Y1, X2 and Y2 to display just a portion of a bitmap.

If the UL and LR map coordinates for the entire bitmap are specified, maps can be overlayed on top of the bitmap and the cursor will return map coordinates. Note that the bitmap must be in the same projection as the maps to be overlayed (ie lat/long projection).

The View Zoom functions can be used to zoom in and out on bitmaps.

WARNING: 256 color bitmaps will take over the display palette and destroy the palettes of any images displayed!

File Open Text

File Retrieve Text

Purpose

Parameters

Remarks

This is useful for editing and viewing projects, data files and color tables.

File Open Table

Purpose

Parameters

Remarks

This function is useful for viewing image statistics files created with Process Stats or any other data file that is quote/comma-delimited in ASCII format. If the row names correspond to map features, then the values can be graphed with View Graph MapData and individual values can be overlayed on a map or image with Draw Labels.

The following is a sample data file:

File Open Film

Purpose

Parameters

Remarks

Film loops are a powerful way to view change over time. To create a film loop, first display the images that you want to view and create a series of bitmaps (which can be done using File Save Bitmap). Next create a list of the bitmap file-names and then display the loop with this function.
A variety of commands are available to control the display of the film loops. All film commands will be listed on the status bar when filming begins.

Filming has two modes of operation...

Automatic Mode
Filming starts in "automatic" mode. Each picture is shown for half a second by default. You can manipulate the animation with the following commands.
"F"--increases the speed of the animation by 1/10th of a second.
"S"--slows down the animation speed by 1/10th of a second.
"Q"--stops all filming, leaving the current image in the window
"M"--switches from Automatic to Manual mode.

Manual Mode
Manual mode allows you to switch between frames manually, allowing for closer inspection of individual pictures. Each frame is shown until you manually advance to the next frame, or until you return to Automatic mode.
"N"--advances to the next frame
"P"--advances to the previous frame
"A"--returns to Automatic mode.
"Q"--stops all filming. leaving the current image in the window.

File Open Project

Purpose

Open a WinDisp project in a new window

Parameters

File Open Idrisi Image

File Retrieve Idrisi Image

Purpose

Parameters

Remarks

This works with binary byte, integer and single IDRISI images. Image coordinates can be specified to display just a portion of the image. All of the View Zoom and View Pan functions can also be used to display a portion of the image. If the associated DOC file contains projection information, maps can be overlayed on top of the image and cursor coordinates will be displayed.

At this time, only the default 16-color IDRISI palette is used when displaying Idrisi images.

File Open Idrisi Vector

File Retrieve Idrisi Vector

Purpose

Display an Idrisi vector map in a new window, retrieve an Idrisi vector map into the currently active window, or overlay an Idrisi vector map on top of an image, bitmap or map in the currently active window

Parameters

Idrisi vector file
Line color
Line style
Fill color
Fill style

Remarks

The Idrisi vectors are stored in a simple ASCII file format. Each feature within the file begins with a line containing a feature ID followed by the number of vertices in the feature. If the last vertex is the same as the first vertex, the feature is assumed to be a polygon. The file should end with two zeros.

Sample point file:

Sample line file:

Sample polygon file:

File Open Erdas Image

File Retrieve Erdas Image

Purpose

Parameters

erdas 7.4 lan or gis file red band (for images)
Green band (for LAN images)
Blue band (for LAN images)
Image X1 (default=0)
Image Y1 (default=0)
Image X2 (default=0)
Image Y2 (default=0)

Remarks

The display must be capable of displaying at least 256 colors for these images to display properly.

Only 4- and 8-bit ERDAS images are currently supported.

If the image is in a geographic projection, maps can be overlayed on top of the image and the cursor can be used to display geographic coordinates.

When displaying GIS images, the colors are created from the Erdas trailer (TRL) file that is typically associated with the GIS file. If no trailer file is present, the color scheme defaults to 256 gray shades.
When displaying single-band LAN images, or a single band of a multi-band LAN image, that band is displayed using 256 gray shades. The image values are stretched from the mean +/- 2 standard deviations to the range of 0 to 255. The mean and standard deviation are extracted from the STA file that is typically associated with LAN images. If this file does not exist, then the scaling is 1:1.

When displaying multi-band LAN images, one band is assigned to each of the red, green and blue colors. The image values for each band are stretched from the mean +/- 2 standard deviations to the range of 0 to 5 for the color assigned to that band. The result values are added together to create a final result between 0 and 215 according to the formula red + green*6 + blue*36. These values are displayed in color with 6 intensities per color for a total of 6*6*6=26 possible colors. This technique is based on a similar algorithm implemented by the Idrisi system.

The image X1, Y1, X2 and Y2 can be used to display a window within the image. The zoom and pan functions will work with these images. The cursor will return screen and image coordinates. If projection information is present in the image header then the cursor will return geographic coordinates and maps can be overlayed on top of the image.

See Process Import Erdas Image and Process Export Erdas Image for more information on importing and exporting ERDAS images.

File Open ArcInfo Gen

File Retrieve ArcInfo Gen

Purpose

Parameters

ArcInfo Gen file
Line color
Line style

Remarks

ESRI has developed a simple ASCII file format for arcs and points that can be "generated" to create ArcInfo coverages. These files can be created with ArcInfo by "ungenerating" coverages. WinDisp3.5 can display these maps in a new window, or can overlay the maps on top of images or other maps with . To overlay Shapes on WinDisp3.5 images, the coordinates should be in the long/lat projection. Note that the GEN format does not support polygons. Furthermore, WinDisp3.5 does not support the display of GEN grids or annotation.

The format for arcs is:

where 101 and 102 are IDS. The comma-separated values are x and y coordinates. Each arc must end with END and the entire file must end with an additional END.

The format for points is:

where the first value on each line is an id, and the second and third are x and y values respectively. The file must end with END.

File Open ArcView Shape

File Retrieve ArcView Shape

Purpose

Display an ArcView SHP map in a new window, retrieve an ArcView SHP map into the currently active window, or overlay an ArcView SHP map on top of an image, bitmap or map

Parameters

ArcView Shape file
Line color
Line style
Fill color
Fill style

Remarks

Use File Open ArcView Shape to display a shape map in a new window. Use File Retrieve ArcView Shape to either retrieve a shape map into the currently active window if it is empty, or to overlay a shape map on top of an image, bitmap or map in the currently active window if the shape map is in a lat/long projection.

ESRI has published a open format description for map features called Shapes that are often used with ArcView. ArcInfo coverages can be converted to Shape files with ArcView. Utilities are available to convert shape files to/from MapInfo MIF files.

WinDisp3.5 can display Shape points, multi-points, lines, and polygons.

File New Project

Purpose

Open up a new, empty project window

Parameters

[None]

Remarks

This is the first step in creating a project. See Projects for more information on creating projects.

File New Bitmap

Purpose

Open up a new, empty graphic window

Parameters

[None]

Remarks

A new graphic window can be used for displaying bitmaps, images, maps, and any of the Draw features.

File New Text

Purpose

Open up a new, empty text window

Parameters

[None]

Remarks

This is most often used for creating new text files, such as color tables.

File Close

File Close All

Purpose

Close the current window or all open windows

Parameters

[None]

Remarks

This can be used to close the active window. The window can also be closed with the Close function in the windows control box in the upper-left corner of the window.

File Save Project

Purpose

Save the current project window to a project file

Parameters

Filename to save to

Remarks

This is used to save all of the feature layers in a new or edited project. See Projects for a description of how to create and edit projects.

File Save Bitmap

Purpose

Save the current graphic window to a .bmp file

Parameters

Filename to save to JPEG Compression (2-255)

Remarks

This is used to save a project, image, map or bitmap window to a file in a variety of formats, including .BMP, .EPS, .JPG, .PCX, .RAS, .TGA, .TIF, .WMF, .WPG. Currently, .GIF format bitmaps are not supported because we do not have a license from Unisys.

If the window is saved in .JPG format, a compression factor from 2 to 255 should be specified, with 2 meaning no compression and 255 meaning maximum compression.

File Save Text

Purpose

Save the current text window to an ASCII text file

Parameters

Filename to save to

Remarks

Be sure to save a text file after you have edited it.

File Print Current Window

Purpose

Print the current text or graphic window

Parameters

Print width (inches)

Remarks

Prints the contents of the active window to the default printer. The image is automatically centered on the page, with left-right and top-bottom margins being equal. The height of the image is automatically derived from the width parameter by keeping the aspect ratio 1:1.

To change the default printer, use File Print Setup.

To print all open windows at once, use File Print All Windows.

File Print All Windows

Purpose

Print all WinDisp windows

Parameters

Width of printed image, in inches.

Remarks

This function prints the contents of every window in WinDisp to a single page. The individual images are placed on the printer page as they are arranged in the main WinDisp window. There is no space between the windows, and the windows are seperated by a black line. As with File Print Current Window, the image is automatically centered on the page. Note that the height of the printed image is computed from the width given, since the aspect ratio of the image is kept at 1:1.

To change the default printer, use File Print Setup.

To print only the currently active window, use File Print Current Window

File Print Setup

Purpose

Select a printer

Parameters

[None]

Remarks

Brings up the windows printer dialog box. This function does not print anything--it only allows you to select the printer to print to. The printer you select becomes the default printer for the system.

File Run

Purpose

Run an external application

Parameters

Application name (and parameters)

Remarks

This is included to allow the user to open another application from within WinDisp. This may be included as a layer in a Project in order to view an external file associated with the project. Command-line parameters (such as file names) can be included.

File Exit

Purpose

Exit WinDisp

Parameters

[None]

Remarks

There is no warning, so make sure you mean it.


Previous PageTop Of PageNext Page
This manual was prepared by the Global Information and Early Warning System of the United Nations Food and Agriculture Organization
© FAO/GIEWS - 1999
E-mail: Giews1@fao.org