lvll2utm(3)

LIBRARY ROUTINE
lvll2utm - Convert explicit location data from geographical coordinates to utm.

LIBRARY CALL
#include "vinclude.h"
int lvll2utm (img, s_flag)
struct xvimage *img;
int s_flag;

INPUT

    1. img -- a pointer to a struct xvimage. This pointer
               is used for both the input and the output
               images. The location data in the input
               image will be replaced by the converted
               coordinates in the ouput image, so be
               careful not to overwrite important data.

    2. s_flag -- a flag that is set to specify that the
               input coordinates are given in arc seconds
               instead of degrees of latitude and
               longitude.

OUTPUT

MODIFICATIONS

DESCRIPTION
lvll2utm converts explicit location data from geographical to universal transverse mercator coordinates.

        When digital elevation model data is imported using dem2viff, it is optional to write explicit location data along with the elevations. If the file input to dem2viff is a 1-degree DEM file, the explicit locations will be given in arc seconds of latitude and longitude. This program may be used to convert the coordinates in arc seconds to their equivalents in utm. This is desirable because the other geographical information programs in Khoros use locations in utm.

        The -s flag specifies whether the geographical coordinates are given in degrees or arc seconds. Dem2viff will always write geographical coordinates in arc seconds, but the degrees option has been included for possible future use.

SEE ALSO
vll2utm(1), intro(3), vipl(3), verror(3), vutils(3) ldem2viff(3)

RESTRICTIONS
lvll2utm requires that the input file contains only one image and that the image must contain explicit location data.

AUTHOR
Per Lysne

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