ARCamera Class Reference

#import <ARCamera.h>

Inherits ARNode.

Class Methods
(ARCamera *)	+ defaultCamera
Class Methods inherited from ARNode
(instancetype)	+ nodeWithName:

Properties
ARMatrix4 *	projectionMatrix
CGPoint	frustumPlaneDistance
CGPoint	principlePoint
CGPoint	fov
ARViewPort *	viewPort
Properties inherited from ARNode
NSString *	name
ARNode *	parent
NSArray< ARNode * > *	children
NSArray *	descendants
ARVector3 *	position
ARVector3 *	scale
ARQuaternion *	orientation
ARMatrix4 *	localTransform
ARMatrix4 *	worldTransform
ARMatrix4 *	fullTransform
ARQuaternion *	fullOrientation
ARQuaternion *	worldOrientation
ARVector3 *	worldScale
ARVector3 *	worldPosition
ARVector3 *	fullPosition
ARNode *	world
NSUInteger	childCount
BOOL	visible

Additional Inherited Members
Instance Methods inherited from ARNode
(void)	- addChild:
(void)	- addChildren:
(void)	- removeChild:
(void)	- removeAllChildren
(void)	- remove
(ARNode *)	- findChildWithName:
(void)	- markWorldTransformAsDirty
(void)	- translateByX:y:z:
(void)	- translateByX:y:z:transformSpace:
(void)	- translateByVector:
(void)	- translateByVector:transformSpace:
(void)	- scaleByUniform:
(void)	- scaleByX:y:z:
(void)	- scaleByVector:
(void)	- rotateByDegrees:axisX:y:z:
(void)	- rotateByRadians:axisX:y:z:
(void)	- rotateByQuaternion:
(ARVector3 *)	- positionToWorld:
(ARVector3 *)	- positionToEye:
(ARQuaternion *)	- orientationToWorld:
(ARQuaternion *)	- orientationToEye:
(CGPoint)	- viewPortFromNodePosition:
(void)	- render
(void)	- preRender
(void)	- postRender
(void)	- addTouchTarget:withAction:
(void)	- didReceiveTouch
(ARVector3 *)	- nodeFromViewPort:
Protected Types inherited from ARNode
enum	TransformSpace { ARNodeTransformSpaceLocal, ARNodeTransformSpaceParent, ARNodeTransformSpaceWorld }

Detailed Description

An ARCamera is a subclass of ARNode that represents the root node of the scenegraph, at the top of the hierarchy. It is attached to an ARViewPort and controls the projection.

Method Documentation

defaultCamera

+ (ARCamera *) defaultCamera

Reference to a default static camera. Will be created if it hasn't already.

Example of use:

ARCamera *camera = [ARCamera defaultCamera];

Property Documentation

fov

- (CGPoint) fov

readwritenonatomicassign

The cameras horizontal and verticle field of view. The x represents the horizontal fov and the y represents the vertical fov. The field of view is the extent of the observable scene that is seen by the camera at any given moment. A larger field of view alows more of the scene to be seen at a time.

frustumPlaneDistance

- (CGPoint) frustumPlaneDistance

readwritenonatomicassign

The distance to the far clipping plane of the camera frustum. Any objects further than this distance will not be rendered.

principlePoint

- (CGPoint) principlePoint

readwritenonatomicassign

The point where the forward axis intersects with the image plane. This point is also referred to as the image center.

projectionMatrix

- (ARMatrix4*) projectionMatrix

readwritenonatomicassign

The projection matrix representing the camera intrinsics. A computer monitor is a 2D surface. A 3D scene rendered must therefore be projected onto the computer screen as a 2D image. The projection matrix is used for this projection transformation. First, it transforms all vertex data from eye space to clip space. The resulting coordinates are then transformed from camera space to screen space.

viewPort

- (ARViewPort*) viewPort

readwritenonatomicweak

The viewport this camera is attached to, or nil if detached.

---

The documentation for this class was generated from the following files:

• ARCamera.h
• ARCamera.m