AppleSCNCamera - UBogun/Xojo-iosLib GitHub Wiki

Inherits from AppleSCNAnimatableObject
Memory leak check: not yet done.
Status: incomplete, cameraWithMDMLCamera constructor missing. SecureCoding & SCNTechniqueSupport not implemented.

An SCNCamera object manages camera attributes attached to a node. To display a scene, you must designate a node whose camera property contains a camera object as the point of view.

The SCNNode object containing a camera defines a point of view—that is, the position and orientation of the camera. A camera’s direction of view is always along the negative z-axis of the node’s local coordinate system. To point the camera at different parts of your scene, use the position, rotation, or transform property of the node containing it. (Alternatively, to ensure that a camera always points at a particular element of your scene even when that element moves, attach a SCNLookAtConstraint object to the node containing the camera.).

SCNCamera includes the AppleSCNAnimatableObject Interface, which means you can use AppleCAAnimations to animate these properties. Convenience methods have not been introduced to this class. Please check out the Animate… methods of the AppleView class to get an idea of how to create own property animations for this class.

Constructors

Constructor(): Creates a camera object.

Properties

Aperture As Double: A factor that determines the transition between in-focus and out-of-focus areas. Animatable. Default 0.125 = 1/8

AutomaticallyAdjustsZRange As Boolean: Whether the camera automatically adjusts its zNear and zFar depth limits. Default False.

CategoryBitMask As UInteger: A mask that defines which categories the camera belongs to.

FocalBluarRadius As Double: The maximum amount of blurring, in pixels, applied to areas outside the camera’s depth of field. Animatable. Default 0.0.

FocalDistance As Double: The distance from the camera at which objects appear in sharp focus. Animatable. Default 10.0.

FocalSize As Double: The width of the distance range at which objects appear in sharp focus. Animatable. Default 0.0.

Name As Text: A name associated with the camera object.

OrthographicScale As Double: Specifies the camera’s magnification factor when using an orthographic projection.

ProjectionTransform As SCNMatrix4: The camera’s projection transformation.

UsesOrthograhicProjection As Boolean: Whether the camera uses an orthographic projection. Default False.

xFieldOfView As Double: The camera's field of view, in degrees, on the horizontal axis. Animatable.

yFieldOfView As Double: The camera's field of view, in degrees, on the vertical axis. Animatable.

zFar As Double: The camera's far depth limit. Animatable.

zNear As Double: The camera's near depth limit. Animatable.

See the AppleSCNAnimatableObject for Animation properties and methods too.!