apple developer

home tech_notes app_store github stackoverflow devto

Getting Started with a Camera

Learn the semantics of using a camera in your scene.


SKCameraNode defines which portion of a scene is visible on the screen. You must do the following to use a camera:

  1. Instantiate a new SKCameraNode and set it as the scene’s camera.
  2. Add the camera node as a child to the scene.

Note: If you don’t use a camera in your scene, the scene’s anchorPoint is used to position the scene within the view.

Because the camera is a node, you define its position within the scene just like any other node. Actions, physics, and GameplayKit behaviors can also be applied to the camera node. When a scene is rendered using a camera node, the following occur:

In this way, a camera’s position, scale, and rotation always have the opposite effect on how the scene is rendered. For example, if the camera is moved 10 pixels to the right, the scene is rendered as if everything else moved 10 pixels to the left. And similarly, if a camera node has an xScale and yScale of 2.0, the scene is rendered as if every distance was half its normal size, effectively increasing the visible area of the camera’s viewport.

Important: A camera’s descendants are always rendered relative to the camera node’s origin and without applying the camera’s scaling or rotation to them. For example, if your app displays scores or other data floating above the gameplay, the nodes that render these elements should be added as child nodes to the camera.

download this page as .md

download this page as .pdf

back to SpriteKit documentation