//-----------------------------------------------------------------------------
// Name: DolphinVS Direct3D Sample
//
// Copyright (c) 1998-2001 Microsoft Corporation. All rights reserved.
//-----------------------------------------------------------------------------
Description
===========
The DolphinVS sample shows an underwater scene of a dolphin swimming, with
caustic effects on the dolphin and seafloor. The dolphin is animated using
a technique called "tweening". The underwater effect simply uses fog, and
the water caustics use an animated set of textures. These effects are
achieved using vertex shaders
Path
====
Source: DXSDK\Samples\Multimedia\D3D\DolphinVS
Executable: DXSDK\Samples\Multimedia\D3D\Bin
User's Guide
============
The following keys are implemented. The dropdown menus can be used for the
same controls.
<Enter> Starts and stops the scene
<Space> Advances the scene by a small increment
<F1> Shows help or available commands.
<F2> Prompts user to select a new rendering device or display mode
<Alt+Enter> Toggles between fullscreen and windowed modes
<Esc> Exits the app.
Programming Notes
=================
Several things are happening in this sample. First of all is the use of
vertex shaders. Two vertex shaders are used: one for the dolphin, and one
for the seafloor. The vertex shaders are assembly instructions which are
assembled from two files, DolphinTween.vsh and SeaFloor.vsh.
The dolphin is tweened (a form of morphing) by passing three versions of
the dolphin down in multiple vertex streams. The vertex shader takes the
weighted positions of each mesh and produces and output position. The vertex
is then lit, gets tex coords computed and gets fog added.
The seafloor is handled similiarly, just with no need for tweening. The
caustic effects are added in a separate alpha-blended pass, using an
animated set of 32 textures. The texture coordinates for the caustics are
generated in the vertex shaders, stored as TEXCOORDINDEX stage 1.
This sample makes use of common DirectX code (consisting of helper functions,
etc.) that is shared with other samples on the DirectX SDK. All common
headers and source code can be found in the following directory:
DXSDK\Samples\Multimedia\Common
LGram16
e067522598