vmapdlg(1)

PROGRAM
vmapdlg - Change the map of an image imported from DLG data to displayable colors.

SYNTAX

vmapdlg

-i  input image

-o  output image

[-V]
    Gives the version for vmapdlg

[-U]
    Gives the usage for vmapdlg

[-P]
    Prompts for command line options

[-A [file1]]
    Creates the answer file called vmapdlg.ans or file1

[-a [file1]]
    Uses vmapdlg.ans or file1 as the answer file

DESCRIPTION
vmapdlg is used to convert the maps of a viff image created using dlg2viff from actual geographical attributes to an rgb map of displayable colors. When dlg2viff is used to import digital line graph data, the image created is a multiband bit image. Each band in the image corresponds to a single attribute, or feature in the dlg data. For instance, one band might be for divided highways, another band for two-lane highways, and so on. The map for each band contains the dlg attributes for that band. See your dlg user's guide for a list of attributes. Vmapdlg changes the map from the dlg attributes to displayable colors. For instance, all hydrological attributes will be converted to varying shades of blue.

The image and location data will be preserved as well as all of the data in the image header. The only thing that will change between the input and output images is the maps that are installed. The maps containing the dlg attributes on the input image will be replaced by an rgb map on each band of the output image.

Here is a list of which categories will be mapped to which colors. The definitions of these colors may be found in the color table /usr/lib/X11/rgb.txt. Only the major attribute is used in assigning a color to a feature. For instance, all attribute pairs with a major attribute in the range 50-59 will be considered hydrography and colored blue accordingly.

    hypsography brown
    streams blue 2
    water bodies blue 3
    hydrography blue 1
    coastal features blue 4
    surface cover green
    non-vegatative surface features cyan
    boundaries grey
    roads and trails red
    railroads tan
    water navigation azure 1
    pipelines and transmission lines yellow
    other significant manmade structures magenta
    survey control markers orange
    US public land survey system pink
    all other categories white

REQUIRED ARGUMENTS

-i  type: infile
    desc: input image

-o  type: outfile
    desc: output image

OPTIONAL ARGUMENTS
none

EXAMPLES
vmapdlg -i new_mexico_dlg.xv -o new_mexico_color.xv

In this example, the file "new_mexico_dlg.xv" is a viff image that has been created using dlg2viff. The image can only be displayed in two colors, black and white, because its maps contain dlg attribute data that cannot be interpreted as colors. All of the dlg attributes will be displayed as white. After using vmapdlg, the output file "new_mexico_color.xv" is another viff image which contains an rgb colormap so that each attribute in the dlg data will be displayed in a corresponding color.

SEE ALSO
intro(1), verror(3), vgparms(3), vutils(3), lvmapdlg(3) dlg2viff(1), vlayer(1)

RESTRICTIONS
The only restrictions on vmapdlg are on the map type of the input image. There must be one map per band (VFF_MS_ONEPERBAND), the map storage type must be short (VFF_MAPTYP_2_BYTE), the number of rows in each map must be 1 (map_col_size=1), and the number of columns must be 2 (map_row_size=2). It is also required that there only be one image in the input viff file.

COPYRIGHT
Copyright 1991, University of New Mexico. All rights reserved.