<LINK rev=made href="mailto:calzada@me-studio.com">
<META content="franck calzada,calzada franck,calzada,java,java webstart,java 3d,java 3D,java3D,java3d,java3d game,java 3d game,java3d games,game,games,online,jeu 3D,jeux 3d,pool,billard,pool 3D,billard 3D,pool3D,billard3D,virtuel,virtuelle,virtual,includes,real,time,Virtuatrack,Virtua Track,bouncing,ball,physics,collision,features,PathInterpolator" name=keywords>
<META content="CazaPool3D a java pool game (8 ball pool) online created by Franck Calzada, using java3D technology like behavior, model loading, texture, appearence, light, PathInterpolator, etc..." name=description>
<META content="Franck Calzada, Calzada Franck" name=author>
<META content=ALL name=ROBOTS><!-- Metadata generated by http://vancouver-webpages.com/META/mk-metas.html -->
<CENTER><IMG src="cazapoolScr4.JPG" NOSAVE height=300 width=450>
<P><B><FONT face=Arial,Helvetica>CazaPool3D<SUP>TM</SUP> (Java3D 8 ball Pool Game) by <A href="mailto:calzada@me-studio.com">Franck Calzada</A>, <A href="http://www.me-studio.com/">Mobile Entertainment Studio</A>, <A href="http://www.geocities.com/calzada_us/" target=_top>Home Page</A></FONT></B></CENTER></TD><BR>&nbsp;

<!--#exec cmd="../../cgi-bin/count.cgi"-->

<A href="http://sourceforge.net/projects/cazapool3d/"> <IMG src="http://sourceforge.net/sflogo.php?group_id=109238&amp;type=5" width="210" height="62" border="0" alt="SourceForge.net Logo" /></A>

<H1>User Documentation</H1>&nbsp;
<H2>Index</H2><FONT size=-1>Last revised:&nbsp;Jan 22, 2005</FONT>
<BLOCKQUOTE>

<A href="#introduction">Introduction</A> <BR>
<A href="#installation">Installation</A> <BR>
<A href="#howtoplay">How to play</A> <BR>
<A href="#playit">Play it!</A> <BR>
<A href="#screenshots">Screen shots</A> <BR>
<A href="#latestchanges">Latest changes</A> <BR>
<A href="#rules">Rules</A> <BR>
<A href="#knownissues">Known issues</A> <BR>
<A href="#enhancements">Enhancements</A> <BR>
<A href="#relatedjars">Related jars</A> <BR>
<A href="#forum">Golden book</A> <BR>
<A href="#misc">Misc</A> <BR>
<A href="#links">Links</A>

<HR width="100%">

<H2><A name=introduction></A>Introduction</H2>
<UL>
<LI>
<P>Play pool online (single/multiplayer) in an applet or in a standalone application</P></LI>
<LI>
<P>Shows ball trajectories as you line up your shot.</P></LI>
<LI>
<P>Undo your last shot.</P></LI>
<LI>
<P>Move the white ball (picking)</P></LI>
<LI>
<P>Many java3D technologies are used like: Behaviors, 3D model loading, PathInterpolator, morphing, textures, lights, collisions, etc...</P></LI>
<LI>
<P>handles multiple views.</P></LI>
</UL>

<HR width="100%">

<H2><A name=installation></A>Installation </H2>
<P>Note that you need to have a <A href="http://java.sun.com/products/plugin/autodl/jinstall-1_4_2-windows-i586.cab#Version=1,3,0,0">Java 1.4.2.04 runtime</A> and <A href="http://java.sun.com/products/java-media/3D/download.html">Java3D 1.3.1</A> installed! </P>
<P><A href="http://java.sun.com/products/plugin/1.3/jinstall-13-win32.cab#Version=1,3,0,0">Java3D Version 1.3.1</A>This is a self-installing executable </P>
<P><A href="http://java.sun.com/products/plugin/autodl/jinstall-1_4_2-windows-i586.cab#Version=1,3,0,0" classid="clsid:8AD9C840-044E-11D1-B3E9-00805F499D93">jdk1.4.2_04</A>This is a self-installing executable </P>
<P>To run CazaPool3D stand alone, please download the zip file from <A href="http://sourceforge.net/projects/cazapool3d/">Sourceforges</A>, unzip this file to a directory. Then you have two ways to run the game. </P>
<UL>
<LI>
<P>Full game mode: go to &lt;InstalledDir&gt;/pool/bin, edit pool.cmd, set the LOCAL_JAVA_HOME accordingly. Then start pool.cmd.</P></LI></UL>
<P></P>
<P>Install Web Start</P>
<P>See the Sun Microsystems Java Web Start Technology page to download and install Web Start.</P>
<P>You only have to install the Web Start program once, unless you need to update to a later version.</P>
<P>Under Linux and Solaris, you will be prompted for the pathname of the installed JRE - the Java runtime environment.</P>
<P>Be sure you are running Web Start version 1.0.1_02 or later. If you are using Netscape, after installing Web Start, </P>
<P>you must exit and restart Netscape.</P>
<P></P>

<HR width="100%">

<H2><A name=howtoplay></A>How to play </H2>
<P>

<UL>
<LI>
<P>Choose your target (on the principal view), by a left click and move the mouse left/right/down/up.</P></LI></UL>
<UL>
<LI>
<P>Zoom (move the camera closer to the white ball) by a middle click and move up/down your mouse.</P></LI></UL>
<UL>
<LI>
<P>Re-initialize the pool table (from the top image menu).</P></LI></UL>
<UL>
<LI>
<P>Your shot is trigger when pressing 's'(for shot). To release the shot, release the 's' key</P></LI></UL>
<UL>
<LI>
<P>Undo your last shot (from the top image menu)</P></LI></UL>
<UL>
<LI>
<P>You can move around using the arrow keys (with SHIFT / CTRL combination)</P></LI></UL>
<UL>
<LI>
<P>Press F12 to stabilize/re-initialize the view (camera)</P></LI></UL>
<UL>
<LI>
<P>Enable/disable sounds effects (from the top image menu).</P></LI></UL>
<UL>
<LI>
<P>Active help (display trajectories) (from the top image menu).</P></LI></UL>
<UL>
<LI>
<P>Drag and drop the white ball (by a right click &amp; drag).</P></LI></UL>
<UL>
<LI>
<P>View from the opposite by clicking on a ball. (click again when not shining to go back to the initial view point)</P></LI></UL>
<UL>
<LI>
<P>3 different views are available (white ball view , top view, animated view)</P></LI></UL>
<UL>
<LI>
<P>Zoom in the smaller view (top view) by a left click and move up/down your mouse.</P></LI></UL>
<UL>
<LI>
<P>Translate the view in the small view (top view).</P></LI></UL>
<UL>
<LI>
<P>Switch off/on the ceil fan (left click on the ceil fan)</P></LI></UL>
<UL>
<LI>
<P>You can chat (more fun in a multi-user environment (download the full version from sourceforge)</P></LI></UL>
<UL>
<LI>
<P>You can change chat overlay background by pressing F1 </P></LI></UL>
<UL>
<LI>
<P>You can change the view (opposite view) by clicking on a ball (this ball then starts to blink) Then click again on this ball to move back the camera to the opposite again.</P></LI></UL>
<UL>
<LI>
<P>Load more 3ds object in the room by pressing the 'seat' icon.</P></LI></UL>

<P>
</P>
<HR width="100%">

<H2><A name=playit></A>PLAY IT!! </H2>

<UL>
<LI>
<P>I JUST REMOVED (from 01/07/2005) the JWS link. If you want to play CazaPool3D, thanks to download the game from <A href='http://sourceforge.net/projects/cazapool3d/'>CazaPool3D on sourceforge</A>.</P>
<P>If you prefere JWS, thanks to let me know (with <A href='http://sourceforge.net/forum/?group_id=109238"'>sourceforge forum</A>)</P>


<A href="http://cazapool3d.sourceforge.net/cazapooljws/CazaPool3D.jnlp">CazaPool3D</A> (JWS version)


</LI>
</UL>

<HR width="100%">

<H2><A name=screenshots></A>Screen shots </H2>
<TABLE cellSpacing=10 cols=2 width=910 border=0>
<TBODY>
<TR>

<TD>
<CENTER><IMG src="cazapoolScr5.JPG" NOSAVE height=300 width=400></CENTER></TD>
<TD>
<CENTER><IMG src="cazapoolScr6.JPG" NOSAVE height=300 width=400></CENTER></TD>

</TR>

<TR>

<TD>
<CENTER><IMG src="cazapoolScr7.JPG" NOSAVE height=300 width=400></CENTER></TD>
<TD>
<CENTER><IMG src="cazapoolScr8.JPG" NOSAVE height=300 width=400></CENTER></TD>

</TR>

<TD>
<CENTER><IMG src="cazapoolScr9.JPG" NOSAVE height=300 width=400></CENTER></TD>
<TD>
<CENTER><IMG src="cazapoolScr2.JPG" NOSAVE height=300 width=400></CENTER></TD>

</TR>

</TBODY>
</TABLE>

<HR width="100%">

<H2><A name=rules></A>Rules</H2>
<P>
Game has 8 ball (eight ball) pool game built in among with other games.
Official eight ball rules:
8 ball pool rules (eight ball)
These pool games are played with a full rack of fifteen balls. If only one type of ball is pocketed during a break, (stripes or solids) the breaker is assigned that ball type. If both types are made, the breaker shoots again and assignment occurs when one type of ball is pocketed. If no balls are made it’s the next player’s turn to shoot. If the 8ball is pocketed on the break it is spotted on the foot spot.
8 ball (eight ball)Rules:  Object in 8ball games :
Pocket all seven stripes or solid balls, then pocket the 8ball. Stripes and solids are assigned to a player by pocketing stripes or solid balls. After assignment, you must pocket All your balls before shooting the 8ball. A player that pockets the 8ball before pocketing his assigned balls loses pool game.
8 ball (eight ball)Rules:  Winning the game 8ball :
You must pocket all your balls and then the 8ball in the pocket that you called. 8ball sunk on the break wins game, except if the cue ball is scratches which causes a loss of pool game.
8 ball (eight ball)Rules:  Call Pocket :
You are required to call the intended pocket before pocketing the 8ball. The CPU is not required to call pocket.
8ball (eight ball)Rules:  Combinations in 8ball games :
Before assignment is made, you can hit any ball first; otherwise you hit your ball type first. Your opponent’s balls or the 8-ball may be used in a combination shot as long as you hit your ball type first.
8 ball (eight ball)Rules:  Fouls in 8ball games :
The only foul is a scratch. If the 8ball is pocket on the break it is spotted on the foot spot.
8 ball (eight ball)Rules:  Penalty For Scratching :
Opposing player gets cue ball in hand. Player can place the cue ball anywhere on the table (does not have to be behind the headstring except on opening break). If you scratch while pocketing more than one balls of your group, then those balls are spotted at the break end of table one behind the other.
8 ball (eight ball)Rules:  Balls Jumped off the Table :
Balls jumped off the table are considered scratched and are spotted.
8 ball (eight ball)Rules:  Losing the game :
You lose 8 ball pool game if: you make the 8ball while any of your balls are left on the table; you scratch when shooting at the 8ball even if you make the 8ball, you make the 8ball on the break shot and also scratch.
</P>



<HR width="100%">

<H2><A name=latestchanges></A>Latest changes</H2>

<H3>01/04/2005</H3>
<UL>
<LI>
<P>Fixed splash screen loading</P></LI>
<LI>
<P>Fixed PointSound issues</P></LI>
</UL>

<H3>10/14/2004</H3>
<UL>
<LI>
<P>Added the ability to load more 3ds object by pressing the 'seat' icon</P></LI>
<LI>
<P>Fixed navigation handler</P></LI>
</UL>

<H3>09/21/2004</H3>
<UL>
<LI>
<P>Removed swing menu, replaced by icon overlay on the top right corner</P></LI>
<LI>
<P>Replaced the shot slider by a key pressed ('s') behavior</P></LI>
</UL>

<H3>09/13/2004</H3>
<UL>
<LI>
<P>Added the ability to start CazaPool3D with the Java 3D Web Start Release (version 1.3.1 (_01) ) </P></LI>
</UL>

<H3>07/27/2004</H3>
<UL>
<LI>
<P>Released new version under sourceforge.</P></LI>
<LI>
<P>added the ability to view from the other side of a selected ball.</P></LI>
<LI>
<P>Added blinking ball when selected.</P></LI>
<LI>
<P>Added player overlay image (enabled or disable according to the current player).</P></LI>
<LI>
<P>Replaced pool table by a nicer snooker table.</P></LI>
<LI>
<P>Added walk navigation (available only on the standalone version.</P></LI>
</UL>

<H3>07/19/2004</H3>
<UL>
<LI>
<P>replaced pool table by a snooker table</P></LI>
<LI>
<P>Fixed ball collision issue.</P></LI>
</UL>

<H3>07/09/2004</H3>
<UL>
<LI>
<P>Added overlay screen to display scores.</P></LI>
<LI>
<P>Added FPS overlay screen.</P></LI>
<LI>
<P>Removed redwood tree.</P></LI>
</UL>

<H3>06/22/2004</H3>
<UL>
<LI>
<P>Added the ability to switch ceil fan speed (right click on the ceil fan)</P></LI>
</UL>

<H3>06/18/2004</H3>
<UL>
<LI>
<P>Added dart board and door entrance object</P></LI>
</UL>

<H3>06/08/2004</H3>
<UL>
<LI>
<P>Added project under Sourceforge: <A href="http://sourceforge.net/projects/cazapool3d/">CazaPool3D</A></P></LI>
</UL>

<H3>06/06/2004</H3>
<UL>
<LI>
<P>Added ceilfan animation</P></LI>
<LI>
<P>Added carpet</P></LI>
<LI>
<P>Added picture on TV</P></LI>
</UL>

<H3>06/02/2004</H3>
<UL>
<LI>
<P>Added cue stick animation</P></LI>
<LI>
<P>added more 3DS objects (sofa, fireplace, ceil fan, etc...</P></LI>
<LI>
<P>3DS objects are loaded in different threads (using multiple thread pool). So no need to wait for each object...</P></LI>
<LI>
<P>Modified the camera animation</P></LI>
</UL>

<H3>03/20/2004</H3>
<UL>
<LI>
<P>Added the ability to connect to a server, and play against other player.</P>
<P>Go to <A href="http://81.66.100.46:2002/PoolServer/Pool.html">CazaPool3D Server Rooms</A> (Server might be down)</P></LI>
</UL>

<H3>01/11/2004</H3>
<UL>
<LI>
<P>Fixed camera position bug.</P></LI>
<LI>
<P>Added the ability to run CazaPool3D standalone</P></LI>
</UL>

<H3>12/31/2003</H3>
<UL>
<LI>
<P>Added cue stick rotation</P></LI>
<LI>
<P>Added camera animation</P></LI>
<LI>
<P>Added man morphing</P></LI>
<LI>
<P>Added server state display on the black board</P></LI>
</UL>

<H3>12/22/2003</H3>
<UL>
<LI>
<P>Added the ability to undo the last shot</P></LI>
<LI>
<P>Added morphing hand that point the white ball</P></LI>
<LI>
<P>Added 3 more 3DS objects, black-board, TV stand, stairway</P></LI>
<LI>
<P>Moved text (score, etc..) to the black board</P></LI>
<LI>
<P>Added Key behavior (arrows) to move around</P></LI>
</UL>

<H3>12/19/2003</H3>
<UL>
<LI>
<P>Added wall textures</P></LI>
<LI>
<P>Added a slider to change help level</P></LI>
<LI>
<P>fixed bug about ball collision detection</P></LI>
</UL>

<H3>12/18/2003</H3>
<UL>
<LI>
<P>Re-organized button display</P></LI>
<LI>
<P>Fixed game play bugs</P></LI>
<LI>
<P>Added clap sound at the end of a shot (if scored)</P></LI>
</UL>

<H3>12/05/2003</H3>
<UL>
<LI>
<P>Added trajectory display as you line up your shot</P></LI>
</UL>

<H3>12/03/2003</H3>
<UL>
<LI>
<P>Added 2nd view (top view)</P></LI>
<LI>
<P>Added slider to control speed</P></LI>
<LI>
<P>Added Behavior to move balls once in the pocket</P></LI>
<LI>
<P>Added The ability to pick the white ball</P></LI>
<LI>
<P>Fixed bug about lights</P></LI>
<LI>
<P>Fixed bug about rebounds</P></LI>
</UL>


<HR width="100%">

<H2><A name=knownissues></A>Known issues </H2>
<P>Please refer to  <A href='http://sourceforge.net/tracker/?group_id=109238&atid=652888"'>sourceforge bug list</A>
(this list here is not updated anymore)
</P>


<UL>
<LI>
<P>Balls are going out of the table (sometimes)</P>
<LI>
<P>No collision detection (with the key behavior)</P>
<LI>
<P>If you get the following exception in the sun java consol, close your browser and come back again.
<P>This will solve your issue.
<P>javax.media.j3d.RestrictedAccessException: Cannot modify capability bits on a live or compiled object at javax.media.j3d.SceneGraphObject.setCapability(SceneGraphObject.java:101) at com.caza.billard3D.Ball.<INIT>(Ball.java:87) at com.caza.billard3D.Ball.<INIT>(Ball.java:195) at com.caza.billard3D.PoolSceneGraph.loadAllBalls(PoolSceneGraph.java:157) at com.caza.billard3D.PoolSceneGraph.loadAll3DS(PoolSceneGraph.java:332) at com.caza.billard3D.PoolSceneGraph.<INIT>(PoolSceneGraph.java:72) at com.caza.billard3D.Pool.createSceneBranchGroup(Pool.java:778) at com.caza.core.Java3dApplet.initJava3d(Java3dApplet.java:138) at com.caza.billard3D.Pool.init(Pool.java:890)</P></LI></UL>
<HR width="100%">

<H2><A name=enhancements></A>Enhancements </H2>
<P>Please refer to  <A href='http://sourceforge.net/tracker/?group_id=109238&atid=652891"'>sourceforge enhancement list</A>
(this list here is not updated anymore)
</P>

<UL>
<LI>
<P>Add the ability to play against the computer (done 0%)</P>
<LI>
<P>Add the ability to play billiard (3 balls, i.e French pool) (done 20%)</P>
<LI>
<P>Add sound background (done 60%)</P>
<LI>
<P>Add the ability to play in a multiplayer client/server environment (done 95%)</P>
<LI>
<P>Add the ability to connect VirtuaTrack <A href="http://www.vrealities.com/virtuatrack.html">VirtuaTrack</A> (Magnetic VIO Head Tracker). You can navigate accurately in Virtual Reality CazaPool3D game by looking up, down and side to side with your head like you are really there. And connect to any Head Mounted Display, I'm using <A href="http://www.vrealities.com/igsvga.html">i-glasses SVGA</A> (done 10%)</P>
</UL>

<HR width="100%">

<H2><A name=relatedjars></A>Related jars </H2>
<P><A href='http://www.mnstarfire.com/download/inspector3ds.html"'>The 3DS object/model loader</A> </P>

<HR width="100%">

<H2><A name=forum></A>Forum</H2>
<P>Please refer to  <A href='http://sourceforge.net/forum/?group_id=109238"'>sourceforge forum</A>
</P>

<HR width="100%">

<H2><A name=misc></A>Misc </H2>
<UL>
<LI>
<P>IDE: Eclipse 3.01</P></LI></UL>
<UL>
<LI>
<P>java source code size: about 200k</P></LI></UL>
<UL>
<LI>
<P>System required: Graphic card is welcome...</P></LI></UL>
<UL>
<LI>
<P>Thanks to Philippe Renon for his contribution in the collision detection algorithm (a long time ago...)</P>
<LI>
<P>Thanks to the JAVA3D-INTEREST mailing list for their advises</P>
<LI>
<P>Thanks to my brother, <A href="http://www.3darchi.fr/html/3darchi.html">Laurent Calzada</a> for some 3DS objects (very very cool site with 3d movies and animations)</P>
</LI></UL>


<HR width="100%">

<H2><A name=links></A>Links</H2>
<UL>
<LI>
<P><A href='http://www.java3d.org/'>java3d.org web site</A></P></LI></UL>
<UL>
<LI>
<P><A href='https://java3d.dev.java.net/'>java3d project home</A></P></LI></UL>
<UL>
<LI>
<P><A href='http://www.j3d.org/'>j3d.org web site</A></P></LI></UL>
<UL>
<LI>
<P><A href='http://www.web3d-fr.com/'>web3d-fr web site</A></P></LI></UL>
<UL>
<LI>
<P><A href='http://www.3d-test.com/'>3D test web site</A></P></LI></UL>
<UL>
<LI>
<P><A href='http://fivedots.coe.psu.ac.th/~ad/jg/'>Java Graphics and Gaming</A></P></LI></UL>
<UL>
<LI>
<P><A href='http://www.javagaming.org/cgi-bin/JGNetForums/YaBB.cgi?board=3D'>javagaming 3D forum</A></P></LI></UL>
<UL>
<LI>
<P><A href='http://www.benhui.net/'>Benhui, Mobile developers portal</A></P></LI></UL>

<HR width="100%">

<P><A href="http://sourceforge.net/projects/cazapool3d/">Home Page</A> </P>
<CENTER>
<HR width=750 SIZE=1>
<P>Copyright © 2005 Franck Calzada. All rights reserved.</P>
<BR>
<A href="http://sourceforge.net/projects/cazapool3d/">Home Page</A> - <A href="http://www.me-studio.com/">Mobile Entertainment Studio</A> - <A href="http://sourceforge.net/projects/cazapool3d/">CazaPool3D</A> </FONT></CENTER><A href="#top">Back to Top</A>
<H5></H5><BR><FONT size=-1>Copyright(c)2005 <A href="mailto:calzada@me-studio.com">Franck Calzada</A></FONT> </BLOCKQUOTE>
</CENTER>
