README.TXT                                                  2000/08/15

                       TLWater    version 1.04

        Copyright (C) 2000 Tomohide Kano. All rights reserved.

______________________________________________________________________

Contents
  - Abstract
  - System Requirements
  - Usage
  - Technical Notes
  - History
  - Acknowledgment
  - Contact

______________________________________________________________________


Abstract
========
  TLWater is a simple demo that shows water in a pool.  The surface
  of the water dynamically changes.  The underwater and the reflected
  environments are distorted quite realistically.

  The aim of this demo is to investigate potentiality of hardware-
  accelerated transform and lighting.


System Requirements
===================
  - Intel or 80x86 compatible CPU
    (Pentium III or AMD Athlon is highly recommended.)
  - Windows 95/98
  - DirectX 7.0 or later
  - Video card that supports 3D acceleration via DirectX 7.
    T&L (transform and lighting) device is recommended.
    (e.g. NVIDIA GeForce 256 or GeForce2 GTS)


Usage
=====
  By clicking or dragging on the water, you can touch it :-).
  You can also use the following keybord controls:

  <Arrow Keys><Home><End>  Move camera
  <Ctrl+W>                 Toggle underwater
  <Ctrl+R>                 Toggle reflection
  <Ctrl+L>                 Toggle lighting effect (underwater)
  <Enter>                  Sparkle!
  <Pause>                  Pause/restart simulation
  <Space>                  Proceed with the simulation by single step
  <Esc>                    Exit

  Press shift key on start-up to run in fullscreen mode.


Technical Notes
===============
  - This app was built using the D3DX utility library.
  - The surface of the water is generated solving a two dimensional
    linear wave equation discretely.
  - Vertex blending technique is used for modeling the pole of a
    streetlight.


History
=======
  Ver. 1.0   2000/01/16  The first public release.
  Ver. 1.01  2000/01/19  Added support for non-TnL devices.
  Ver. 1.02  2000/01/19  Modified the calculation of texture coordinate.
  Ver. 1.03  2000/08/09  Fixed the following issue:
                           When running with NVIDIA's reference driver
                           version 5.3x, the program exits with the
                           error message "D3DXERR_CAPSNOTSUPPORTED".
  Ver. 1.04  2000/08/15  Added support for 16-bit display mode.
                         Fixed some bugs.


Acknowledgment
==============
  I wish to thank the following people:
    - Wataru Kishimoto for pressing me to open this app to the public.
    - Kiminori Matsuzaki for supporting my development.


Contact
=======
  For up-to-date information on TLWater, please consult the web
  page at <http://cgi3.tky.3web.ne.jp/~tkano/tlwater.shtml>.

  If you have any questions, requests, comments or bug reports,
  please feel free to email me!
  Tomohide Kano <tkano@tky3.3web.ne.jp>.

______________________________________________________________________
enjoy it!
