imagecsseries.java

java3D game engine design of the source [three-dimensionalvirtualrealitynetworkprogram] - "virtual

// ImageCsSeries.java
// Andrew Davison, November 2003, [e-mail]

/* An ImagesCsSeries object is a 'screen', centered at (0,0,0),
   that can display an image from a series passed to it at creation
   time. 

   The size of the screen's sides is set by the screenSize variable.

   The screen is a subclass of OrientedShape3D, configured to rotate
   around the point (0,0, zCoord) relative to the user's viewpoint.

   The series of images are stored in an ImageComponent2D array.

   By default, the first image in the array is shown, and methods
   must be explicitly called to change the displayed picture. There
   is no default animation.

   A version of ImageCsSeries with default animation can be found in 
   FPShooter3D
*/

import javax.vecmath.*;
import javax.media.j3d.*;
import com.sun.j3d.utils.geometry.*;
import com.sun.j3d.utils.image.*;


public class ImageCsSeries extends OrientedShape3D
{
  private static final int NUM_VERTS = 4;

  private ImageComponent2D[] ims;  // the sequence of images
  private int imIndex, numImages;
  private Texture2D texture;


  public ImageCsSeries(float zCoord, float screenSize, ImageComponent2D[] ims) 
  { 
    this.ims = ims;
    imIndex = 0;
    numImages = ims.length;

    // set the orientation mode
    setAlignmentMode(OrientedShape3D.ROTATE_ABOUT_POINT);
    setRotationPoint(0.0f, 0.0f, zCoord);

    createGeometry(screenSize);
    createAppearance();
  } // end of ImageCsSeries()



  private void createGeometry(float sz)
  {
    QuadArray plane = new QuadArray(NUM_VERTS, 
							GeometryArray.COORDINATES |
							GeometryArray.TEXTURE_COORDINATE_2 );

    // the screen is centered at the center, size screenSize, facing +z axis
    Point3f p1 = new Point3f(-sz/2, -sz/2, 0.0f);
    Point3f p2 = new Point3f(sz/2, -sz/2, 0.0f);
    Point3f p3 = new Point3f(sz/2, sz/2, 0.0f);
    Point3f p4 = new Point3f(-sz/2, sz/2, 0.0f);

    // anti-clockwise from bottom left
    plane.setCoordinate(0, p1);
    plane.setCoordinate(1, p2);
    plane.setCoordinate(2, p3);
    plane.setCoordinate(3, p4);

    // set up texture coords for holding the image
    TexCoord2f q = new TexCoord2f();
    q.set(0.0f, 0.0f);    
    plane.setTextureCoordinate(0, 0, q);
    q.set(1.0f, 0.0f);   
    plane.setTextureCoordinate(0, 1, q);
    q.set(1.0f, 1.0f);    
    plane.setTextureCoordinate(0, 2, q);
    q.set(0.0f, 1.0f);   
    plane.setTextureCoordinate(0, 3, q);  

    setGeometry(plane);
  }  // end of createGeometry()


  private void createAppearance()
  {                       
    Appearance app = new Appearance();

    // blended transparency so texture can be irregular
    TransparencyAttributes tra = new TransparencyAttributes();
    tra.setTransparencyMode( TransparencyAttributes.BLENDED );
    app.setTransparencyAttributes( tra );

    // Create a two dimensional texture with magnification filtering
    // Set the texture from the first loaded image
    texture = new Texture2D(Texture2D.BASE_LEVEL, Texture.RGBA,
                       ims[0].getWidth(), ims[0].getHeight());
    texture.setMagFilter(Texture2D.BASE_LEVEL_LINEAR);   // NICEST
    texture.setImage(0, ims[0]);
    texture.setCapability(Texture.ALLOW_IMAGE_WRITE);   // texture can change
    app.setTexture(texture);
   
    setAppearance(app);
  }  // end of createAppearance()


  public void showImage(int i)
  // show the i th image in the sequence
  { 
    if (i < 0) {
      texture.setImage(0, ims[0]);
      imIndex = 0;
    }
    else if (i >= numImages) {
      texture.setImage(0, ims[numImages-1]);
      imIndex = numImages-1;
    }
    else {
      texture.setImage(0, ims[i]);
      imIndex = i;
    }
  }  // end of showImage()


  public void showNext()
  // show the next image in the sequence
  { if (imIndex < numImages-1) {
      imIndex++;
      texture.setImage(0, ims[imIndex]);
    }
  }

  public void showPrev()
  // show the previous image in the sequence
  { if (imIndex > 0) {
      imIndex--;
      texture.setImage(0, ims[imIndex]);
    }
  }

} // end of ImageCsSeries class