	README file for Media Vision OpenGL Demos for Windows NT

		      Release 1.0 Beta-1 
		  	  30-Sep-93

		    Pellucid/Media Vision, Inc.
		    3180 De La Cruz Blvd. #201
		    Santa Clara, CA 95054-2402
		    Voice: (408) 987-0321
		      FAX: (408) 986-8378



Introduction
------------
This diskette contains several demonstration programs constructed using 
the beta version of the Media Vision OpenGL Software Developer's Kit for 
Windows NT (MOGL SDK).  The intent of the MOGL SDK is to enable developers to 
write and test 3D applications using OpenGL* under Windows NT* in advance 
of its eventual inclusion in Win32* by Microsoft.   

The library has been created from OpenGL Version 1.0.10 from Silicon Graphics,
which is the release level that SGI recommends for product shipment.
The MOGL SDK is consistent with the OpenGL specification as published by 
Addison-Wesley in the OpenGL Reference Manual, and the MOGL SDK passes all 
of the OpenGL Compliance Tests as required by Silicon Graphics.

To ensure compatibility with the Microsoft release, the MOGL SDK implements 
its OpenGL - to - Windows interface identically to Microsoft's current
internal specification for the interface (WGL).  Hence, applications developed
with the MOGL SDK should only require re-linking for production deployment in
order to access the Microsoft DLLs.

The MOGL SDK will be available from Pellucid/Media Vision at the beginning 
of November 1993.  It will support application development on Intel, MIPS, 
and Digital AXP processors.  The Intel version will also run under the Win32s* 
extension to Windows* 3.1, giving the OpenGL developer access to its huge 
installed base.  Priced at $995 (exclusive of shipping and handling), the
SDK includes one year of technical support along with the following items:

	1) One CD-ROM containing files for Intel x86 and Pentium, 
	   MIPS R4xxx, and Digital AXP processors:
	   - OpenGL DLL and header files 
	   - Demos and sample programs
	   - On-line, comprehensive help via WinHelp

	2) Addison-Wesley OpenGL Documentation:
	   - OpenGL Reference Manual
	   - OpenGL Programming Guide

	3) Media Vision OpenGL SDK User's Guide and Release Notes

For more information, or to participate in the Beta Program, contact 
Kevin Schuh (pronounced "shoe"), 3D Product Manager at Pellucid/Media 
Vision.  Kevin may be reached via Internet at kevins@mv3.mediavis.com
or via telephone at (408) 987-0330.

	
Installation
------------
To install the demos, run [floppy]:\SETUP.


Running the Demos 
-----------------
The installation creates a Program Manager group called, by default, 
"Media Vision OpenGL Demos".  Double-clicking on an icon within the group 
launches the demo.  Alternately, the demos may be run from a command prompt 
window.  The demos are:

	Demo		Description
	----		-----------
	CUBE.EXE	A throbbing Rubik's Cube that solves itself.
	LIGHT.EXE	Demonstrates simple OpenGL lighting.
	INSECT.EXE	A robot insect that ambles towards the cursor.
	FLIP-VW.BAT	A moving model of a VW bathed in red light.
	FLIP-MV.BAT	A moving model of the logo of Pellucid's new parent, 
			Media Vision.
	TEX-FACE.BAT	Demostrates OpenGL texture mapping.
	TEX-DANC.BAT	Same as TEX-FACE.BAT, except an image of Balinese 
			dancers is used instead a face.
	DOLYMPIC.EXE	Olympic rings fly into place.
	WAVE.BAT	A green and red checked flag waving in the breeze.

The purpose of the these demos is to show the type of 3D rendering and 
animation possible under Windows NT using the OpenGL.  Note that the 
MOGL SDK implements OpenGL on top of the Win32 GDI; hence, there is no graphics 
hardware acceleration specific to OpenGL with these demos.  The faster the 
processor, the faster the demos will run.  If an i486 is too slow, try it 
on a Pentium, a MIPS R4400, or a Digital AXP.  Once OpenGL is part of Win32, 
graphics hardware acceleration of OpenGL will be possible, so one may expect 
order-of-magnitude levels of improvement in animation and rendering speeds.
 
All of the demos can be closed by hitting ESC.  Several of the demos accept 
additional keyboard and mouse input:


	Demo	Key/Button	Action
	----	----------	------
	LIGHT   c		Toggle auto cube spin.
		s		Toggle auto scene spin.
		l		Toggle mouse buttons between moving scene or 
				lights.
		m		Toggle MTV mode (left mouse spins projected 
				scene).
		left mouse	Spin the scene (auto scene spin must be off) or
				move light #1.
		right mouse	Spin the cube (auto cube spin must be off) or
				move light #2.

	INSECT  f		Toggle follow mode.
		left mouse	Move scene left/right/up/down.
		right mouse	Rotate viewing angle left/right/up/down.
	
	FLIP 	left mouse	Drag object.
		right mouse	Spin the object.

	TEX-* 	d		Enter demo mode (constant rotation) -- the 
				default.
		D		Exit demo mode.
		arrow keys	Rotate.
		T		Translate.
		t		Translate.
		s		Toggle sphere map mode.
		0		Use nearest magification filter.
		1		Use linear magification filter.
		2		Use nearest minification filter.
		3		Use linear minification filter.
		4		Use nearest-mipmap-nearest minification filter.
		5		Use nearest-mipmap-linear minification filter.
		6		Use linear-mipmap-nearest minification filter.
		7		Use linear-mipmap-linear minification filter.

	WAVE	s		Toggle smooth/flat shading.
		l		Toggle lighting.
		d		Toggle depth buffering.
		a		Toggle scene spin.
		space		Toggle animination.
		n		Next frame (when animination is off).


Notes
-----

1.  These demos require an 8-bit palette managed or true-color display 
adapter.  They will NOT work with 16-color VGA or Super VGA.


2.  To get an indication as to how fast the demos are running, you can have
the frame rate displayed by setting the environment variable 
_MOGL_SHOW_FRAMERATE to the number of frames between measurements.  Such 
information is useful in comparing animation speed between Windows NT 
platforms (e.g. Pentium vs. MIPS R4400 vs. Digital AXP, etc.) or Win32s 
platforms (e.g. i486DX2-66 vs. Pentium-66).

For example, issuing:

	SET _MOGL_SHOW_FRAMERATE=10

from a command prompt window or a batch file will cause a text console to 
pop up displaying animation speed (frames per second) measurements every 10
frames.  Resetting the environment variable:

	SET _MOGL_SHOW_FRAMERATE=
	
will eliminate the text console from future demos.


3.  This diskette may be freely distributed.


4.  These demos can also be run under Windows 3.1 by first installing
Version 1.1 of the Win32s extension.  To do this, boot Windows 3.1, insert 
the Win32s diskette, and use Program Manager to run A:\SETUPI .  Windows 
does not inherit program groups created under Windows NT, so you will need 
to re-install the demos if you've already installed them under Windows NT.


OpenGL* is a trademark of Silicon Graphics, Inc.  Windows*, Windows NT*, 
Win32*, and Win32s* are trademarks of Microsoft Corporation.


Copyright (c) 1993 by Pellucid, Inc., a Media Vision Company
