WooHoo. This is great news. But the link to the new version links to the old version.

I also have a request. Would it be possible to make the variables of the library public. It's quite useful to know where the OCD camera is. Especially if you've got a few of them.

OK, I've updated the OCD library once again to provide accessors for camera position, target position, camera orientation (attitude), camera "up" direction, and field of view.

Let me know what you think.

All of the reference documentation has been updated on the site as well.

I had the file permissions set incorrectly. It should be available now.

I did some more digging and yeah it is the aspect ratio math. The two ints (width and height) divide to give an int and are then converted into a float. So unless the ratio of width/height is a whole number the aspect ratio will always be out of wack. If one of the ints is converted to a float before the divide then the answer will be correct.

Code:

  size(640, 480);

  // 1.1 method
  println( 1f * width / height );   // prints 1.3333334

  // 1.2 method
  println((float)(width / height) );// prints 1.0

  //adjusted 1.2 method
  println(float(width) / float(height));// prints 1.3333334

 

Awesome, thanks for that. It works like a charm.

I ran into the same problem, it's because there's no constructor that takes those arguments.  It's an error in the documentation.  I had to look at the source code to find a list of suitable constructors.  I went ahead and copied it here. it's pretty well documented,  Kristian, maybe you should include it in the online documentation.  I take it this doesn't work with the opengl camera, but it shouldn't be to hard to port.  Thanks for the great work!!

//--- Constructors --------

  // Create a camera that sits on the z axis
  public Camera(PApplet aParent)
  {
     this(aParent,
          aParent.height * 0.5f / tan(DEFAULT_FOV * 0.5f));
  }

  // Create a camera that sits on the z axis with a specified shot length
  public Camera(PApplet aParent,
                float   aShotLength)
  {
     this(aParent,
          0, 0, aShotLength);
  }

  // Create a camera at the specified location looking at the world origin
  public Camera(PApplet aParent,
                float   aCameraX, float aCameraY, float aCameraZ)
  {
     this(aParent,
          aCameraX, aCameraY, aCameraZ,
          0, 0, 0);
  }

  // Create a camera at the specified location with the specified target
  public Camera(PApplet aParent,
                float aCameraX, float aCameraY, float aCameraZ,
                float aTargetX, float aTargetY, float aTargetZ)
  {
     this(aParent,
          aCameraX, aCameraY, aCameraZ,
          aTargetX, aTargetY, aTargetZ,
                 0,        1,        0,
          DEFAULT_FOV, (float)(1f * aParent.width / aParent.height), 0, 0);

     theNearClip = theShotLength * 0.1f;
     theFarClip  = theShotLength * 10f;
  }

  // Specify all parameters for camera creation
  public Camera(PApplet aParent,
                float aCameraX, float aCameraY, float aCameraZ,
                float aTargetX, float aTargetY, float aTargetZ,
                float anUpX,    float anUpY,    float anUpZ,
                float anFoV, float anAspect, float aNearClip, float aFarClip)
  {
     theParent   = aParent;
     theCameraX  = aCameraX;
     theCameraY  = aCameraY;
     theCameraZ  = aCameraZ;
     theTargetX  = aTargetX;
     theTargetY  = aTargetY;
     theTargetZ  = aTargetZ;
     theUpX      = anUpX;
     theUpY      = anUpY;
     theUpZ      = anUpZ;
     theFoV      = anFoV;
     theAspect   = anAspect;
     theNearClip = aNearClip;
     theFarClip  = aFarClip;

     theDeltaX   = theCameraX - theTargetX;
     theDeltaY   = theCameraY - theTargetY;
     theDeltaZ   = theCameraZ - theTargetZ;

     theShotLength = magnitude(theDeltaX, theDeltaY, theDeltaZ);

     theAzimuth    = atan2(theDeltaX,
                           theDeltaZ);
     theElevation  = atan2(theDeltaY,
                           sqrt(theDeltaZ * theDeltaZ +
            theDeltaX * theDeltaX));

     if (theElevation > HALF_PI - TOL)
     {
        theUpY =  0;
        theUpZ = -1;
     }    

     if (theElevation < TOL - HALF_PI)
     {
        theUpY =  0;
        theUpZ =  1;
     }

     updateUp();
  }

Camera(this, float CameraX, float CameraY, float CameraZ,
      float TargetX, float TargetY, float TargetZ,
      float UpX,    float UpY,    float UpZ,
      float FoV, float Aspect, float NearClip, float FarClip)

Youll' have to initialize the camera with all these setting if you want to change the clipping distance for example:

camera1 = new Camera(this, 0, 0,  600, 0, 0, 0, 0, 1, 0, PI/3, 1.25, 1, 50000);

This will place the camera at coord. 0,0,600 targeting 0,0,0 with up direction being positive Y, Fov Pi/3, aspect ratio of 1.25, short clipping range of 1 and far clip at 50000;