readme.txt

java 3D

Chapter 16. Loading and Manipulating External Models

From:
  Killer Game Programming in Java
  Andrew Davison
  O'Reilly, May 2005
  ISBN: 0-596-00730-2
  http://www.oreilly.com/catalog/killergame/
  Web Site for the book: http://fivedots.coe.psu.ac.th/~ad/jg

Contact Address:
  Dr. Andrew Davison
  Dept. of Computer Engineering
  Prince of Songkla University
  Hat yai, Songkhla 90112, Thailand
  E-mail: [e-mail]


If you use this code, please mention my name, and include a link
to the book's Web site.

Thanks,
  Andrew


=================================================
LoaderInfo3D.java

This application requires the NCSA Portfolio JAR file
(portfolio.jar), which can be downloaded from 
http://fivedots.coe.psu.ac.th/~ad/jg/portfolio.jar


-----
Compilation: 

Use the compileLI.bat batch file.
It assumes that the NCSA Portfolio JAR is in the subdirectory
ncsa/

$ compileLI
    // you must have Java 3D installed for the compilation to succeed;
    // if you get "Warning" messages, please see the note below

Java 3D is available from http://java.sun.com/products/java-media/3D/

-----
Execution: 

Use the LoaderInfo3D.bat batch file
It assumes that the NCSA Portfolio JAR is in the subdirectory
ncsa/

It takes two arguments: <model file name> <adaption number>

e.g. 
$ LoaderInfo3D dolphins.3ds 0

The model file name should be in the subdirectory /models

The adaption number meanings:
  0: Make the shape blue;
  1: Draw the shape in outline;
  2: Render the shape almost transparent;
  3: Lay a texture over the shape;
  4: Make the shape blue and add a texture;
  Anything else: Make no changes at all.

-----------
Note on "unchecked or unsafe operation" Warnings

As explained in chapter 3, I have not used J2SE 5.0's type-safe 
collections, so that this code will compile in early versions of
J2SE (e.g. version 1.4).

The warning messages are always related to my use of collections
(e.g. ArrayList) without specifying a type for the objects they will
contain at run time.

No. of Warnings generated in J2SE 5.0 for the examples:
/LoaderInfo3D: 9 warnings

-----
Last updated: 16th April 2005