Classes

---

Name
Camera

Description
Data Type for manipulating the Processing viewport. There are several ways to create a Camera, but all cameras are manipulated the same way. The default camera position sits on the positive z axis. The default target position is at the world origin. The default up direction is in the negative y. The default field-of-view is 60 degrees PI/3 radians. The default aspect ratio is the ratio of the applet width to the applet height. The default near clipping plane is placed a 1/10 x shot length. The default far clipping plane is placed at 10x the shot length. Each constructor provides a way to override these default values.

Methods
Camera Switching
feed()
send what this camera sees to the view port

Perspective changes
zoom(amount)
change the field of view by the specified amount

Straight-line movements
truck(distance)
move the camera and c.o.i. along the side vector by the specified distance

boom(distance)
move the camera and c.o.i. along the up vector by the specified distance

dolly(distance)
move the camera and c.o.i. along the view vector by the specified distance

Arc movements
arc(amount)
arcs the camera over (under) a center of interest at its present azimuth by the specified amount
(which would be preferred here... arc length or change in elevation?)

circle(amount)
arcs the camera around a center of interest at its present elevation by the specified amount
(which would be preferred here... arc length or change in azimuth?)

Instantaneous Changes
jump(locationX, locationY, locationZ)
instantly change the camera's position to the specified location

aim(targetX, targetY, targetZ)
instantly change the camera's center of interest to the specified target

Rotations
Note: the following three methods assume degrees, but I think I remember seeing an angleMode() somewhere that sets the preferred angular units. Is there any way to check this and use radians or degrees based on the preferred mode? (Everything's in radians now.)

tilt(amount)
rotate the camera about the side vector by the specified amount

pan(amount)
rotate the camera about the up vector by the specified amount

roll(amount)
rotate the camera about the view vector by the specified amount

Combinations
tumble(azAmount, elAmount)
tumbles the camera about its center of interest by the specified amounts
(which would be preferred here... arc lengths or change in azimuth and elevation?)

look(azAmount, elAmount)
moves the c.o.i. around the camera at its present position by the specified amounts
(which would be preferred here... arc lengths or change in azimuth and elevation?)

track(xDistance, yDistance)
move the camera and c.o.i. simulataneously in the local x-y plane

Constructors
Camera(parent)
Camera(parent, shotLength)
Camera(parent, cameraX, cameraY, cameraZ)
Camera(parent, cameraX, cameraY, cameraZ, targetX, targetY, targetZ)
Camera(parent, cameraX, cameraY, cameraZ, targetX, targetY, targetZ, upX, upY, upZ)
Camera(parent, fov, aspect, nearClip, farClip)
Camera(parent, cameraX, cameraY, cameraZ, fov, aspect, nearClip, farClip)
Camera(parent, cameraX, cameraY, cameraZ, targetX, targetY, targetZ, fov, aspect, nearClip, farClip)
Camera(parent, cameraX, cameraY, cameraZ, targetX, targetY, targetZ, upX, upY, upZ, fov, aspect, nearClip, farClip)

Parameters

parent	PApplet: typically use "this"
shotLength	float: distance from the camera to the center of interest
cameraX	float: x coordinate for the camera position
cameraY	float: y coordinate for the camera position
cameraZ	float: z coordinate for the camera position
targetX	float: x coordinate for the center of interest
targetY	float: y coordinate for the center of interest
targetZ	float: z coordinate for the center of interest
upX	float: x component of the "up" direction vector, usually -1.0, 0.0, or 1.0
upY	float: y component of the "up" direction vector, usually -1.0, 0.0, or 1.0
upZ	float: z component of the "up" direction vector, usually -1.0, 0.0, or 1.0
fov	float: field-of-view angle in vertical direction
aspect	float: ratio of width to height
nearClip	float: relative z-position of the near clipping plane
farClip	float: relative z-position of the far clipping plane

i second the recommendation on radians.. we found that angleMode() wound up messing with too much of the api, and decided it'd just create too many bugs for such a minor improvement. putting radians() on things doesn't seem like a big deal for ppl who want to use degrees.

whups, i'll change fov to radians for 86. it's just been degrees forever and that's api that we only recently exposed so it went untouched.

Hey Damkjer

I have a question on your library;

how can retrieve the current zoom value for a camera?
I'm asking this because the values that feed camera.zoom
are relative (they're the amount of change);
I want to reset the camera to a initial zoom amount, but since the zoom values are placed by the user at run time, and the camera.zoom does not accept an absolute value, I'm not being able to.

Any ideas?

I've added online documentation and refreshed the download information. I also threw the source into the archive and fixed a very minor bug that was allowing the up and view vectors to be parallel.

The new home for OCD is: http://www.cise.ufl.edu/~kdamkjer/processing/libraries/ocd/

Items I'm currently working on:

1) Additional prespective manipulation
2) Ortho mode
3) Absolute manipulations (possibly a camera mode)
4) Simultaneous camera display

Thoughts

hey Damkjer,

I think both modes are fine (relative is even easier to implement the user feedback, absolute is easier to script animations), I was just wondering ways to retrieve the values;
I have a situation where I find a good points of view of my geometry and want to save them for later, to a sketch presentation; it would be great to get camera1.zoom value, camera1.eyeX value, so on so forth...

anyway, I'm an adopter and a fan of OCD. Thanks!

Solution 1:

Code:

import damkjer.ocd.*;

Camera persp;
Camera orth;

void setup() {
  size(320, 240, P3D);
  persp = new Camera(this, 100,-150, 200);
  orth = new Camera(this);
  rectMode(CENTER);
}

void draw() {
  lights();
  background(204);
  persp.feed();

  rotateY(PI/3);
  box(50, 50, 50);

  orth.feed();  
  rect(0, (height / 2) - 20, width, 40);
}

void mouseMoved() {
  persp.tumble(radians(mouseX-pmouseX), radians(mouseY-pmouseY));
}