IMPORTANT:  The code in this archive is offered under the license at:
http://wireless.java.sun.com/berkeley_license.html

----

**Java Media Demos** 
by Bill Day, Sun Microsystems

This REAMDE_demos.txt file is saved within a ZIP
archive which contains nine subdirectories.  Each
subdirectory in turn contains one example Java(TM) Media
APIs application.  These applications are used in order 
(Example01 to Example09) to illustrate Java 2D, JMF,
and Java 3D programming concepts and capabilities in 
the related "Java Media Programming" Code Camp, available
from:
  http://www.sun.com/developers/evangcentral


**The directories and the demos they contain are:

01_Graphics2D:  contains simple Java 2D application demonstrating
        the use of Graphics2D

02_ShapesTransforms:  contains a Java 2D application illustrating
        the use of Shapes and GeneralPaths, plus basic transforms

03_CurvesAntialiasing:  Java 2D app which shows the use of curved
        segments on GeneralPaths, 2D text, and antialiasing
        to removed jagged edges on 2D graphics

04_ImageDicer:  Java 2D app which demonstrates a number of 2D
        image operations, as well as the ability to save component
        contents as a JPEG image

05_JMFApplet:  JMF applet (runs in properly configured appletviewer
        or Web browser; see below) which can load and play various
        audio or video files, local or accessed over the network

06_3DBasics:  Java 3D application which goes through the minimal
        set of steps required to create a basic 3D world

07_ContentBranch:  Java 3D app which provides some content for
        rendering in basic 3D world

08_3DUtilities:  Java 3D app illustrating how you can save a
        lot of effort if you use provided Sun utilities

09_Behaviours:  Java 3D application demonstrating how behaviors
        are used to schedule interpolated movement of 3D objects



**To use any of the demos in this archive, you must:

(1) unzip the archive to your file system, preserving
    directory structure

(2) have a Java(TM) 2 Platform, Standard Edition 1.4 SDK
    implementation (referred to henceforth as "J2SDK1.4")
    installed on your system; for detailed instructions,
    please refer to:
    http://java.sun.com/j2se/1.4

(3) set the environment variable JAVA_HOME on your system
    such that it resolves to location of your J2SDK1.4
    installation, i.e., if you have installed J2SDK1.4 in
    the default C:\j2sdk1.4.0 directory on a Win32 system,
    then JAVA_HOME should be set to resolve to C:\j2sdk1.4.0

(4) if you wish to use the JMF demo applet (Example05), you
    must also successfully install a JMF implementation on
    your system; for detailed instructions, please refer to:
    http://java.sun.com/products/java-media/jmf

(5) if you wish to use the Java 3D demo applications
    (Example06 to Example09), you must also successfully
    install a Java 3D implementation (version 1.3 Beta 2 or newer)
    on your system; for detailed instructions, please refer to:
    http://java.sun.com/products/java-media/3D


Once you have completed system configuration steps #1-5
above, you can then compile and/or execute the demos.

To compile a demo on Win32, change into its directory, then execute
the Win32 script named 'compile.bat'.  If you are using a Solaris, 
Linux, or other Java enabled system, execute the Java compile
statement in the compile.bat file manually using your commandline 
'javac' or IDE compiler of choice.

To execute a demo on Win32, change into its directory, then execute
the Win32 script named 'run.bat'.  If you are using a Solaris, 
Linux, or other Java enabled system, execute the Java application
using the statement in the run.bat file manually via your commandline 
'java' executable or IDE of choice.  Note:  You can also execute the 
JMF demo (Example05) by changing into its directory and loading the 
HTML page 'example.html' in your JMF-enabled Internet Explorer or 
Netscape Communicator Web browser.


I hope you find these demos interesting and useful as you
explore the possibilities of Java Media programming.
Good luck and happy hacking,
Bill Day
Sun Microsystems, Inc.
30-May-2002