View source for Add a Camera

== Introduction ==

Cameras can be set up to be fixed in place, move in a set direction or pattern or follow an entity.  It is possible to add more than one camera and switch between them during a game.


== Add a Camera ==

To add a Camera to the scene click the Camera icon [[File:ToolsMenu06.png|link=]] on the [[ Tools Menu | Tools Menu ]] and the cursor will change to a camera icon.  Move the icon to the required position and click to place it. 


To move the Camera, use the [[ Gizmos | Move Gizmo]], or use the spin controls in the Properties window. 



== Properties Window ==

The Properties window will open when a Camera is added or selected:
  
{| class = "wikitable";
!rowspan="19" style="width:300px;vertical-align:top;" |[[File:Camera.png|link=]]
|style="width:160px;vertical-align:top;" | '''Name'''
|Camera name
|-
|style="vertical-align:top;" | '''View'''	
|The view seen by the camera
|-
|style="vertical-align:top;"|'''Position''' 	 	
|The position of the camera
|-
|style="vertical-align:top;"|'''Rotation''' 	 	
|The angle of the camera 
|-
|style="vertical-align:top;"|'''Tracking Entity''' 	 	
|The entity the camera is to track, or 'None' if no tracking required. Click the name/'None' to change.
|-
|style="vertical-align:top;"|'''Tracking Distance''' 	 	
|How far the camera should be from the entity. This combines with the ''Distance Threshold'' parameter to set how far the camera can be from the entity before it needs to move. 
|-
|style="vertical-align:top;"|'''Tracking Style''' 	 	
|How the camera should track the entity. ''Static'' (no movement), ''Follow'' (the entity will always be the centre of the view) or ''Fixed Direction'' (the camera will only move in the specified direction).
|-
|style="vertical-align:top;"|'''Target Offset''' 	 	
|The difference between the entity position and the position the camera is to point towards, eg the camera could point slightly ahead of a player so that the player is shown towards the side of the screen rather than in the centre. 
|-
|style="vertical-align:top;"|'''Movement Style''' 	 	
|How the camera will move. ''Static'' (no movement), ''Follow'' (move around the scene with the Entity), ''Rotate'' (rotate around the Entity), ''Spline'' (move along the specified spline) or ''Velocity'' (move at the specified velocity). 
|-
|style="vertical-align:top;"|'''Lock Camera''' 	 	
|Stops the camera from moving in the specified direction, eg locking Y in a side-scrolling game means the camera can track the player movement left and right but will not move up or down.
|-
<!-- |style="vertical-align:top;"|'''Camera Active Area''' 	 	
|Sets an [[Active Area|Active Area]] the camera can move within. If the object the camera is tracking moves outside of this area then the camera will stop moving at the boundary. 
|- -->
|style="vertical-align:top;"|'''Target Active Area''' 	 	
|Sets an [[Active Area|Active Area]] the camera can focus on. If the object the camera is tracking moves outside of this area then the camera will stop following it at the boundary. 
|-
|style="vertical-align:top;"|'''Rotation Threshold''' 	 	
|How far the entity being tracked can move before the camera rotates. A larger value means the camera will move less as it won't follow all small movements.
|-
<!-- |style="vertical-align:top;"|'''Distance Threshold''' 	 	
|How far the entity being tracked can go from the ''Tracking Distance'' before the camera moves. A larger value means the camera will move less as it won't follow all small movements.
|- -->
|style="vertical-align:top;"|'''Field of View''' 	 	
|The angle which describes how wide the camera’s view is. 
|-
|style="vertical-align:top;"|'''Transition Type''' 	 	
|Sets whether the transition to the camera should be ''Immediate'' or ''Smooth'' when the camera becomes active. 
|-
|style="vertical-align:top;"|'''Use Editor Camera View''' 	 	
|style="vertical-align:top;" |Sets the camera position so it's view matches the current view displayed in the [[Level Editor|Level Editor]].  
|-
|style="vertical-align:top;"|'''Starting CameraShot''' 	 	
|Whether this camera is to be used as the initial camera in the game. Only one camera should have this checkbox set. 
|-
|style="vertical-align:top;"|'''Parent''' 	 	
|The [[Parent Entity|Parent Entity]] the camera is attached to.
|-
|'''Hidden	'''
|If checked, the camera is active but invisible in game.
|-
|'''Enabled'''	
|Specifies whether the camera is switched on.
|}