
vmapdlg(1)                   Khoros                    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 inter-
     preted 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.

Khoros                    Release: 1.0                          1

