###############################################################################
#                                                                             #
#  Copyright © 1989-1991 by Artificial Horizons®, Inc.  All rights reserved.  #
#                                                                             #
#      This material  constitutes  the trade  secrets  and confidential,      #
#      proprietary information of Bruce Factor and Curtis Priem,  and is      #
#      under license  to Artificial Horizons, Inc.   The material is not      #
#      to be disclosed,  reproduced,  copied,  or used in any manner not      #
#      permitted under license from Artificial Horizons, Inc.   For more      #
#      information email "ahi-interest@ahi.com".                              #
#                                                                             #
###############################################################################

ATL_ELEVATION_POST(3T) AVIATOR TERRAIN LIBRARY FUNCTIONS ATL_ELEVATION_POST(3T)



NAME
        atl_elevation_post - final elevation processing of Aviator terrain
        data files

SYNOPSIS
        #include <atl.h>

        int atl_postproc(long_00, lat_00, long_0c, lat_0c,
                         long_r0, lat_r0, long_rc, lat_rc)
        double long_00, lat_00, long_0c, lat_0c;
        double long_r0, lat_r0, long_rc, lat_rc;

DESCRIPTION
        atl_elevation_post() does the elevation postprocessing needed by the
        data files used by Aviator.  Minimum and maximum elevations are
        calculated.  The data files have filenames of ???_??? where ? is a
        number.

        long_00 and lat_00, long_0c and lat_0c, long_r0 and lat_r0, and
        long_0r and lat_0r represent the longitudes and latitudes of the
        locations on the globe of the area bounding box where the elevation
        postprocessing is to be done.  All longitudes are measured in degrees
        from the Meridian of Greenwich and all latitudes are measured in
        degrees from the Equator.

        atl_elevation_post() must be called once after the data files have
        been generated by one or more calls to atl_elevation() and
        atl_elevation_delete().

RETURN VALUES
        atl_elevation_post() returns:
        0       on success.
        -1      on failure.

FILES
        /usr/games/aviator/atl/h/atl.h
        /usr/games/aviator/atl/lib/libatl.a
        /usr/games/aviator/passwords
        /usr/games/aviator/terrain/???_???

ENVIRONMENT
        The environment variable AVIATOR_HOME points to the home directory for
        aviator, if it is other than /usr/games/aviator.  AVIATOR_PASSWORDS
        points to the file that contains the password file passwords, if it is
        other than /usr/games/aviator/passwords or ${AVIATOR_HOME}/passwords.
        passwords contains the password needed to use atl_color().  The
        following are examples of how to set AVIATOR_HOME and
        AVIATOR_PASSWORDS:

                setenv AVIATOR_HOME      /home/bigdisk/aviator
                setenv AVIATOR_PASSWORDS /home/bigdisk/aviator/passwords

SEE ALSO
        atl_elevation(3T), atl_elevation_delete(), passwords(5A)



ATL Release 1.8         Last change: 25 December 1991