###############################################################################
#                                                                             #
#  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_RASTERFILE(3T)     AVIATOR TERRAIN LIBRARY FUNCTIONS     ATL_RASTERFILE(3T)



NAME
        atl_rasterfile - create Sun rasterfile from Aviator terrain data files

SYNOPSIS
        #include <atl.h>

        int atl_rasterfile(long_00, lat_00, long_0c, lat_0c,
                           long_r0, lat_r0, long_rc, lat_rc,
                           filename, flags)
        double long_00, lat_00, long_0c, lat_0c;
        double long_r0, lat_r0, long_rc, lat_rc;
        char   *filename;
        int    flags;

DESCRIPTION
        atl_rasterfile() creates a Sun rasterfile pointed to by filename from
        Aviator terrain data files.  The rasterfiles can be used as an aid
        during the development of the terrain data.  atl_rasterfile() creates
        the rasterfile directly from the color data in the files ???_???,
        without modifying the colors in any way.

        long_00 and lat_00, long_0c and lat_0c, long_r0 and lat_r0, and
        long_rc and lat_rc represent the longitudes and latitudes of the
        locations on the globe of the the four corners of the rasterfile.  All
        longitudes are measured in degrees from the Meridian of Greenwich and
        all latitudes are measured in degrees from the Equator.

        atl_rasterfile() can generate a rasterfile from the different depth
        colors in the terrain data files.  flags specifies the depth that will
        be used to generate the rasterfile (only one of the flags below must
        be used):

        ATL_DEPTH_4     Create rasterfile using 4 bit color data.

        ATL_DEPTH_8     Create rasterfile using 8 bit color data.

        atl_rasterfile() can only be called after the data files have been
        generated and postprocessed using atl_color_post() and
        atl_elevation_post().

RETURN VALUES
        atl_rasterfile() 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_color_post(3T), atl_elevation_post(3T), passwords(5A),
        rasterfile(5),
        screenload(1)



ATL Release 1.8         Last change: 25 December 1991