Instance Property

movabilityHint

A value that indicates how SceneKit should handle the node when rendering movement-related effects.

Declaration

@property(nonatomic) SCNMovabilityHint movabilityHint;

Discussion

This property controls how the node contributes to various motion-related effects during rendering. The default value is SCNMovabilityHintFixed. If the movability hint is SCNMovabilityHintMovable:

  • The node’s content is not affected by motion blur effects. (See the motionBlurIntensity camera property, which applies motion blur effects for camera movement but not subject movement.)

  • The node does not contribute to environmental lighting of other objects. Environmental lighting is an aspect of physically based rendering (see SCNLightingModelPhysicallyBased), in which surfaces tend to pick up the color of other scene content around them. SceneKit performs environmental lighting by rendering light probes—small, omnidirectional snapshots of the scene’s contents, as visible from at various points around the scene. Light probes are static, so nodes that are expected to move should not contribute to the lighting environment for other surfaces.

This value is merely a hint that communicates to SceneKit’s rendering system about how you want to move content in your scene; it does not affect your ability to change the node’s position or add animations or physics to the node.

See Also

Modifying the Node Visibility

hidden

A Boolean value that determines the visibility of the node’s contents. Animatable.

opacity

The opacity value of the node. Animatable.

renderingOrder

The order the node’s content is drawn in relative to that of other nodes.

castsShadow

A Boolean value that determines whether SceneKit renders the node’s contents into shadow maps.

SCNMovabilityHint

Values that inform SceneKit’s rendering for movement-related effects, used by the movabilityHint property.