ProjectionAngle

From Director Online Wiki
Jump to: navigation, search

3D camera property. For cameras whose projection property is set to #perspective, the .projectionAngle property allows you to get or set the vertical projection angle (or full viewing angle) of the camera's view. The default value for this property for a new camera is 30.0 (degrees). The default value for the default camera of a new Shockwave3D member is 34.5160?Ǭ?. (This corresponds to a corner-to-corner view angle of 1 radian). The maximum angle allowed is 180.0?Ǭ?.

 v3DMember = new(#shockwave3d)
 put v3DMember.camera(1).projectionAngle
 -- 34.5160
 vCamera = v3DMember.newCamera("Test")
 put vCamera.projectionAngle
 -- 30.0000

The projectionAngle indicates the angle formed by two rays: one drawn from the camera to the top of the projection plane, and the other drawn from the camera to the bottom of the projection plane.

The images of models in the 3D world are mapped onto the projection plane, which is positioned in front of the camera like a screen in front of a movie projector. The projection plane is what you see in the 3D sprite.

When you alter the projectionAngle of a perspective camera, the projection plane is rescaled to fit the rect of the sprite.

For cameras whose projection property is set to #orthographic, use the camera.orthoHeight property to define the top and bottom of the projection plane.

Synonym for camera.fieldOfView