/****************************************************************************
 * RAGE 128 PROGRAMMER'S GUIDE SAMPLE CODE VERSION 1.0                      *
 *                                                                          *
 * Author: Special Projects/Developer Relations  1999 08 05                 *
 *                                                                          *
 * Copyright (c) 1999 ATI Technologies Inc. All rights reserved             *
 ****************************************************************************/

READ THIS FILE COMPLETELY BEFORE ATTEMPTING TO USE THIS PRODUCT !

ATI Technologies Inc.
33 Commerce Valley Drive East
Thornhill, Ontario
Canada L3T 7N6

Developer Relations Hotline ............ (905) 882-2600 ext. 6000
Developer Relations FAX ................ (905) 944-2655
Developer Relations E-mail ............. devrel@ati.com

Please direct all inquiries about this SDK to Developer Relations at
one of the above two numbers or via the E-mail address.

Head Office, Sales and Marketing ....... (905) 882-2600
Corporate FAX .......................... (905) 882-2620

World Wide Web ......................... http://www.ati.com

*****************************************************************************

Contents

1.0     Installing the Sample Code
2.0     Compiling
3.0     Executing
4.0     Sample Code Listings
5.0     Reporting Problems

*****************************************************************************
1.0     Installing the Sample Code

You will need to use PKUNZIP, version 2.0 or higher, to unzip the DDK
archive.  You should use the "-d" option (create subdirectories) as in:

    PKUNZIP -d R128DDK1.ZIP

The subdirectory SAMPLE will be created containing the sample code.  Each
Chapter has its own subdirectory.  Within each Chapter directory, each code
example also has its own subdirectory, as well as an object directory.

*****************************************************************************

2.0     Compiling

The code contained on this diskette was created using Watcom C 11.0 in
Dos Protected Mode using the DOS/4GW extender.  The DOS4GW.EXE program
is needed to run all executables on this diskette.  This program must be
located on your path or within the directory of the executable that you
want to run.

To compile any of the code examples, change to the example's directory
and type WMAKE or a similar makefile utility.  Please note that for
all chapters, you must make the utility library located in directory
\..\CHAPx\UTIL.

All programs and modules were written in Watcom C.

*****************************************************************************

3.0     Executing

To execute any of the code examples, change to the example's directory and
type the executable filename.  Arguments of X and Y resolutions and pixel
depth should be passed to the individual executables.  The order that
arguments are passed is not important.  For example:

     SETMODE 1024 768 16
or
     SETMODE 16 768 1024

will both run SETMODE.EXE with a spatial resolution of 1024 by 768 and a colour
depth of 16bpp.  Valid arguments for pixel depth include 8, 15, 16, and 32.

Valid X and Y spatial resolutions are:

X resolution    Y resolution
    320      x      200
    320      x      240
    400      x      300
    512      x      384
    640      x      400
    640      x      480
   *720      x      480
    800      x      600
   *848      x      480
   1024      x      768
  *1152      x      864
   1280      x     1024
   1600      x     1200
   1920      x     1440

The default is always 640x480 and 8bpp.  Some executables are not available
in various resolutions or colour depths.  Modes with a preceding * CANNOT be
set using a BIOS call.  They must be manually programmed.

Note that most of the sample code examples require keyboard input (i.e.
press a key) to step through the programs and to exit.

*****************************************************************************

4.0     Code listings

Detailed descriptions of each program can be found in the CHAP*.TXT
files of their respective chapter subdirectories.  In addition, a short
explanation of each program is given upon execution.

*****************************************************************************
*                                                                           *
*                           W A R N I N G ! !                               *
*                                                                           *
* The examples may not operate properly if run under a Windows 95/98 DOS    *
* box or command prompt.  We have experienced issues with the DOS4GW        *
* extender and DPMI services that may lock your system.  It is highly       *
* recommended that you boot your system with DOS to ensure proper operation.*
*                                                                           *
*****************************************************************************

*****************************************************************************

5.0     Reporting Problems

If you experience any difficulties, please contact Developer Relations at
(905) 882-2600 extension 6000, send a Fax to (905) 944-2652, or send E-mail
to devrel@ati.com.

*****************************************************************************
