From 2179980ed660ef66a9c064d153c5de7994d431ab Mon Sep 17 00:00:00 2001 From: Kenneth Russel Date: Wed, 25 Jun 2003 09:05:29 +0000 Subject: Split up net.java.games.util; moved GLUT and BufferUtils into net.java.games.jogl.util, and moved demo-specific utility classes into jogl-demos project under demos.util. Added nearly all JavaOne demos into jogl-demos project; rewrote where necessary to use ClassLoader.getResourceAsStream() instead of flat files, put into packages and added to Makefile. Added gleem to jogl-demos project. Added jogl.jar build rule. git-svn-id: file:///usr/local/projects/SUN/JOGL/git-svn/../svn-server-sync/jogl-demos/trunk@3 3298f667-5e0e-4b4a-8ed4-a3559d26a5f4 --- doc/readme.html | 171 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 171 insertions(+) create mode 100644 doc/readme.html (limited to 'doc') diff --git a/doc/readme.html b/doc/readme.html new file mode 100644 index 0000000..3b5092e --- /dev/null +++ b/doc/readme.html @@ -0,0 +1,171 @@ + + + +Jogl Demos - Documentation + + + +

Jogl Demos - Documentation

+ +

+ +This workspace contains the source code to demos for the Jogl +package. To build the demos: + +

Check out and build the Jogl sources from http://jogl.dev.java.net/ + +
Add jogl.jar to your CLASSPATH and put jogl.dll, libjogl.so, or + jogl.dylib in your PATH, LD_LIBRARY_PATH or similar + +
cd into the "make" subdirectory of the jogl-demos workspace and + type "make" (NOTE: GNU make is required) + +

+ +To run the demos: + +

Add the built jars to your CLASSPATH (jogl-demos.jar, + jogl-demos-util.jar, jogl-demos-data.jar) + +
Run one of the demos from the command line: e.g. java + demos.gears.Gears (Note: the current working directory is not + important) + +

+ +

Hardware and Software Requirements

+ +

+ +The demos currently have the following hardware and software +requirements: + +

+ + + + + + + + + +
demos.gears.Gears + none + +
demos.hwShadowmapsSimple.HWShadowmapsSimple + NVidia GeForce 2 or better. Currently only runs on Windows + because pbuffer support is not yet implemented in Jogl on X11 or Mac + OS X. + +
demos.infiniteShadowVolumes.InfiniteShadowVolumes + none + +
demos.proceduralTexturePhysics.ProceduralTexturePhysics + NVidia GeForce 3 or better. Requires pbuffer support + (i.e. Windows only at the moment). + +
demos.vertexArrayRange.VertexArrayRange + NVidia GeForce family card. Runs on Windows and Linux (Jogl's + vertex_array_range support not yet ported to Mac OS X). + +
demos.vertexProgRefract.VertexProgRefract + NVidia GeForce 2 or better. Runs on Windows and Linux (uses + GL_NV_vertex_program, not supported on Mac OS X). + +
demos.vertexProgWarp.VertexProgWarp + NVidia GeForce 2 or better. Runs on Windows and Linux (uses + GL_NV_vertex_program, not supported on Mac OS X). + +
+ +

+ +

Per-demo controls

+ +

Hardware Shadow Mapping

+ +

Alt + left click and drag: rotate camera about focal point +
Alt + right click and drag: translate camera parallel to image plane +
Alt + left + right click and drag: zoom camera in/out +
Click and drag on the faces of the manipulators (look for the +yellow highlight of the faces upon mouse over) to translate the +manipulator parallel to that face. Use the handles outside the boxes +to rotate, and the handles at the corners of the boxes to scale. +
Escape key or 'q' quits. +
Space bar cycles through view options. Shadowed view; view from +light source; unshadowed view. +
'v' recenters camera on object +

+ +

Infinite Shadow Volumes

+ +

Alt + left click and drag: rotate camera about focal point +
Alt + right click and drag: translate camera parallel to image plane +
Alt + left + right click and drag: zoom camera in/out +
Click and drag on the faces of the manipulators (look for the +yellow highlight of the faces upon mouse over) to translate the +manipulator parallel to that face. Use the handles outside the boxes +to rotate, and the handles at the corners of the boxes to scale. +
'w' toggles wireframe view +
'c' recenters camera on object +
Space bar toggles animation of figure +
'v' toggles visualization of shadow volume +

+ +

Vertex Prog Warp

+ +

Left click + drag: rotate camera about focal point +
Right click + drag: translate camera parallel to image plane +
Left + right click and drag: zoom camera in/out +
'w' toggles wireframe mode +
Escape or 'q' quits +
'r' resets the demo (including recentering object) +
left/right arrow keys cycle through warp effects +
'h' produces a help screen +
'-'/'+' decreases/increases amplitude of deformation +
'['/']' decreases/increases frequency of deformation +
'1'..'5' changes model being viewed +
Space bar toggles animation +

+ +

Vertex Prog Refract

+ +

Left click + drag: rotate camera about focal point +
Right click + drag: translate camera parallel to image plane +
Left + right click and drag: zoom camera in/out +
'w' toggles wireframe mode +
Escape or 'q' quits +
'1' .. '4' changes model being viewed +
's' toggles multipass rendering for chromatic aberration effect +
'v' recenters the camera on the object +
Space bar toggles animation +

+ +

Procedural Texture Physics

+ +

Alt + left click and drag: rotate camera about focal point +
Alt + right click and drag: translate camera parallel to image plane +
Alt + left + right click and drag: zoom camera in/out +
Space bar toggles animation +
'r' resets the demo +
'c'/'v' decrease/increase blur increment +
'-'/'=' decrease/increase bump scale +
'l' (lowercase “L”) toggles effect of spinning and static textures on the water +
','/'.' decrease/increase frequency of droplets +

+ + + -- cgit v1.2.3

demos.gears.Gears +	none + +
demos.hwShadowmapsSimple.HWShadowmapsSimple +	NVidia GeForce 2 or better. Currently only runs on Windows + because pbuffer support is not yet implemented in Jogl on X11 or Mac + OS X. + +
demos.infiniteShadowVolumes.InfiniteShadowVolumes +	none + +
demos.proceduralTexturePhysics.ProceduralTexturePhysics +	NVidia GeForce 3 or better. Requires pbuffer support + (i.e. Windows only at the moment). + +
demos.vertexArrayRange.VertexArrayRange +	NVidia GeForce family card. Runs on Windows and Linux (Jogl's + vertex_array_range support not yet ported to Mac OS X). + +
demos.vertexProgRefract.VertexProgRefract +	NVidia GeForce 2 or better. Runs on Windows and Linux (uses + GL_NV_vertex_program, not supported on Mac OS X). + +
demos.vertexProgWarp.VertexProgWarp +	NVidia GeForce 2 or better. Runs on Windows and Linux (uses + GL_NV_vertex_program, not supported on Mac OS X). + +