Platforms to show: All Mac Windows Linux Cross-Platform

Back to SCNCameraMBS class.

SCNCameraMBS.ApertureBladeCount as Integer

Type Topic Plugin Version macOS Windows Linux iOS Targets
property SceneKit MBS Mac64bit Plugin 18.5 ✅ Yes ❌ No ❌ No ✅ Yes Desktop & iOS
The number of physical camera aperture blades simulated by SceneKit for depth-of-field effects.

When the wantsDepthOfField setting is enabled, SceneKit renders scenes using the camera with a depth-of-field blur (also called bokeh) effect modeled after those created by a real-world physical camera. One feature of real-world camera bokeh effects is the tendency of distant bright points to blur into larger shapes based on the shape of the aperture between the camera's lens and its imaging plane (film or sensor). Physical cameras control aperture using a mechanism that moves several flat blades in or out to create a smaller or larger opening, so the natural bokeh effect in traditional photography produces polygon-shaped blur effects.
This property controls the number of blades in the simulated camera aperture, and thus the polygon shape seen in the resulting bokeh effect. For example, a blade count of 6 (the default) causes distant bright points to blur into hexagon shapes. Increasingly large blade counts result in the bokeh effect appearing more circular, as shown below.
(Read and Write property)

SCNCameraMBS.AutomaticallyAdjustsZRange as Boolean

Type Topic Plugin Version macOS Windows Linux iOS Targets
property SceneKit MBS Mac64bit Plugin 18.5 ✅ Yes ❌ No ❌ No ✅ Yes Desktop & iOS
A Boolean value that determines whether the camera automatically adjusts its zNear and zFar depth limits.

The default value of this property is false, specifying that the camera’s zNear and zFar properties control its depth limits. If you change this property’s value to true, SceneKit automatically adjusts the depth limits at render time to fit the bounding box of the scene. Changing the values of the zNear and zFar properties automatically resets this property’s value to false.
(Read and Write property)

SCNCameraMBS.averageGray as Double

Type Topic Plugin Version macOS Windows Linux iOS Targets
property SceneKit MBS Mac64bit Plugin 18.5 ✅ Yes ❌ No ❌ No ✅ Yes Desktop & iOS
The luminance level to use as the midpoint of a tone mapping curve.

When using a High Dynamic Range (HDR) camera, SceneKit applies a process called tone mapping to translate the wide range of luminance values in the visible scene to the narrower range of brightness values that can be shown on a display. SceneKit determines a tone mapping curve from the minimumExposure, maximumExposure, exposureOffset, and whitePoint properties, along with this property which serves as a constant estimate of scene luminance.
The default value is 0.18. By setting this property to a higher or lower value, you can compensate for scenes with darker or brighter content. Alternatively, by setting the wantsExposureAdaptation property, you can allow SceneKit to automatically adjust exposure as the visible contents of the scene change.
This property has no effect if the wantsHDR value is false. If the exposureAdaptationDarkeningSpeedFactor value is true, SceneKit ignores this property, and instead computes the average luminance currently visible to the camera during rendering.
(Read and Write property)

SCNCameraMBS.bloomBlurRadius as Double

Type Topic Plugin Version macOS Windows Linux iOS Targets
property SceneKit MBS Mac64bit Plugin 18.5 ✅ Yes ❌ No ❌ No ✅ Yes Desktop & iOS
The radius, in pixels, for the blurring portion of the bloom effect applied to highlights in the rendered scene. Animatable.

A bloom effect adds a soft glow to highlights (areas of bright color) in the rendered scene, simulating the way bright highlights appear to the human eye or a physical camera in a real-world scene. The bloom effect combines selective brightening and blurring effects; this property controls the blur portion of the effect. A value of zero effectively disables the bloom effect, and higher values result in a broader, softer glow. The default value is 4.0 pixels.
You can animate changes to this property’s value. See Animating SceneKit Content.
To enable this behavior, you must first enable the wantsHDR setting.
(Read and Write property)

SCNCameraMBS.bloomIntensity as Double

Type Topic Plugin Version macOS Windows Linux iOS Targets
property SceneKit MBS Mac64bit Plugin 18.5 ✅ Yes ❌ No ❌ No ✅ Yes Desktop & iOS
The magnitude of bloom effect to apply to highlights in the rendered scene. Animatable.

A bloom effect adds a soft glow to highlights (areas of bright color) in the rendered scene, simulating the way bright highlights appear to the human eye or a physical camera in a real-world scene. This property controls the strength of the bloom effect; lower values result in a subtle effect, and higher values create very bright glow. The default value is 0.0, resulting in no bloom effect.
You can animate changes to this property’s value. See Animating SceneKit Content.
To enable this behavior, you must first enable the wantsHDR setting.
(Read and Write property)

SCNCameraMBS.bloomThreshold as Double

Type Topic Plugin Version macOS Windows Linux iOS Targets
property SceneKit MBS Mac64bit Plugin 18.5 ✅ Yes ❌ No ❌ No ✅ Yes Desktop & iOS
The brightness threshold at which to apply a bloom effect to highlights in the rendered scene. Animatable.

A bloom effect adds a soft glow to highlights (areas of bright color) in the rendered scene, simulating the way bright highlights appear to the human eye or a physical camera in a real-world scene. This property controls the brightness level required to trigger the bloom effect; lower values apply the effect to more of the scene, and higher values apply the effect only to the brightest white areas. The default value is 1.0.
You can animate changes to this property’s value. See Animating SceneKit Content.
To enable this behavior, you must first enable the wantsHDR setting.
(Read and Write property)

SCNCameraMBS.colorFringeIntensity as Double

Type Topic Plugin Version macOS Windows Linux iOS Targets
property SceneKit MBS Mac64bit Plugin 18.5 ✅ Yes ❌ No ❌ No ✅ Yes Desktop & iOS
The blend factor for fading the color fringing effect applied to the rendered scene.

Color fringing applies an effect that separately blurs the color components of each rendered pixel, adding subtle rainbow edge effects to the rendered scene that simulate the effects of chromatic aberration in a physical camera. Higher values for this property result in brighter, more vivid color fringing, and lower values create a subtler effect. The default value of 1.0 leaves the color fringing effect at its most vivid.
This property controls a fade between the color fringing effect and the otherwise-normally-rendered image. The colorFringeStrength property controls the breadth of the color fringing effect.
To enable this behavior, you must first enable the wantsHDR setting.
(Read and Write property)

SCNCameraMBS.colorFringeStrength as Double

Type Topic Plugin Version macOS Windows Linux iOS Targets
property SceneKit MBS Mac64bit Plugin 18.5 ✅ Yes ❌ No ❌ No ✅ Yes Desktop & iOS
The magnitude of color fringing effect to apply to the rendered scene.

Color fringing applies an effect that separately blurs the color components of each rendered pixel, adding subtle rainbow edge effects to the rendered scene that simulate the effects of chromatic aberration in a physical camera. Higher values create a more pronounced color shift, creating wider rainbow fringes; lower values spread colors across shorter distances, creating a subtler effect. The default value of 0.0 disables the color fringing effect entirely.
This property controls the breadth of color fringing. The colorFringeIntensity property controls the blend factor between the color-fringed and the otherwise-normally-rendered image.
To enable this behavior, you must first enable the wantsHDR setting.
(Read and Write property)

SCNCameraMBS.colorGrading as SCNMaterialPropertyMBS

Type Topic Plugin Version macOS Windows Linux iOS Targets
property SceneKit MBS Mac64bit Plugin 19.1 ✅ Yes ❌ No ❌ No ✅ Yes Desktop & iOS
A texture for applying color grading effects to the entire rendered scene.

The contents value for this material property must be a 3D color lookup table, or a 2D texture image that represents such a table arranged in a horizontal strip.

see also
https://developer.apple.com/documentation/scenekit/scncamera/1644114-colorgrading
(Read only property)

SCNCameraMBS.contrast as Double

Type Topic Plugin Version macOS Windows Linux iOS Targets
property SceneKit MBS Mac64bit Plugin 18.5 ✅ Yes ❌ No ❌ No ✅ Yes Desktop & iOS
An adjustment factor to apply to the overall visual contrast of the rendered scene.

A value of 0.0 (the default) leaves the rendered scene unchanged. Positive values increase contrast between bright and dark areas, and negative values reduce contrast, shifting the rendered scene towards a uniform gray.
To enable this behavior, you must first enable the wantsHDR setting.
(Read and Write property)

SCNCameraMBS.exposureAdaptationBrighteningSpeedFactor as Double

Type Topic Plugin Version macOS Windows Linux iOS Targets
property SceneKit MBS Mac64bit Plugin 18.5 ✅ Yes ❌ No ❌ No ✅ Yes Desktop & iOS
The relative duration of automatically animated exposure transitions from dark to bright areas.

When using a High Dynamic Range (HDR) camera, SceneKit applies a process called tone mapping to translate the wide range of luminance values in the visible scene to the narrower range of brightness values that can be shown on a display. When the wantsExposureAdaptation property is enabled, SceneKit automatically adjusts the tone mapping curve based on the average luminance currently visible to the camera, and creates automatic transitions between exposure levels.
SceneKit automatically determines the overall duration of exposure-level animations based on the values of this property and the exposureAdaptationDarkeningSpeedFactor property. The default value is 0.4, resulting in brightening animations that are slightly faster than darkening animations.
This property has no effect if either of the wantsHDR or wantsExposureAdaptation values is false.
(Read and Write property)

SCNCameraMBS.exposureAdaptationDarkeningSpeedFactor as Double

Type Topic Plugin Version macOS Windows Linux iOS Targets
property SceneKit MBS Mac64bit Plugin 18.5 ✅ Yes ❌ No ❌ No ✅ Yes Desktop & iOS
The relative duration of automatically animated exposure transitions from bright to dark areas.

When using a High Dynamic Range (HDR) camera, SceneKit applies a process called tone mapping to translate the wide range of luminance values in the visible scene to the narrower range of brightness values that can be shown on a display. When the wantsExposureAdaptation property is enabled, SceneKit automatically adjusts the tone mapping curve based on the average luminance currently visible to the camera, and creates automatic transitions between exposure levels.
SceneKit automatically determines the overall duration of exposure-level animations based on the values of this property and the exposureAdaptationDarkeningSpeedFactor property. The default value is 0.6, resulting in darkening animations that are slightly faster than brighting animations.
This property has no effect if either of the wantsHDR or wantsExposureAdaptation values is false.
(Read and Write property)

SCNCameraMBS.exposureOffset as Double

Type Topic Plugin Version macOS Windows Linux iOS Targets
property SceneKit MBS Mac64bit Plugin 18.5 ✅ Yes ❌ No ❌ No ✅ Yes Desktop & iOS
A logarithmic bias that adjusts the results of SceneKit’s tone mapping operation, brightening or darkening the visible scene.

When using a High Dynamic Range (HDR) camera, SceneKit applies a process called tone mapping to translate the wide range of luminance values in the visible scene to the narrower range of brightness values that can be shown on a display. SceneKit determines a tone mapping curve from the minimumExposure, maximumExposure, exposureOffset, and whitePoint properties, along with a measure of scene luminance.
Use this property to bias the tone mapping curve. The default exposure offset is zero, specifying no bias. Positive values result in a brighter scene, and negative values result in a darker scene.
This property has no effect if the wantsHDR value is false.
(Read and Write property)

SCNCameraMBS.FieldOfView as Double

Type Topic Plugin Version macOS Windows Linux iOS Targets
property SceneKit MBS Mac64bit Plugin 18.5 ✅ Yes ❌ No ❌ No ✅ Yes Desktop & iOS
The vertical or horizontal viewing angle of the camera.

The projectionDirection property determines whether this fieldOfView property measures the camera's vertical or horizontal viewing angle, and SceneKit automatically calculates the viewing angle in the other direction to match the aspect ratio of the view displaying the scene. For example, a fieldOfView of 60 and the default SCNCameraProjectionDirectionVertical projection, presented fullscreen on a 16:9 display in portrait orientation, results in a vertical viewing angle of 60° and a horizontal viewing angle of 33.75°.
You can choose to specify viewing angle either directly, using this fieldOfView property, or in terms that model a physical camera, using the sensorHeight and focalLength properties. Setting the fieldOfView property causes SceneKit to automatically recalculate the focalLength value, and setting the sensorHeight or focalLength property recalculates fieldOfView.
(Read and Write property)

SCNCameraMBS.FocalBlurSampleCount as Integer

Type Topic Plugin Version macOS Windows Linux iOS Targets
property SceneKit MBS Mac64bit Plugin 18.5 ✅ Yes ❌ No ❌ No ✅ Yes Desktop & iOS
The number of pixel samples SceneKit uses to create depth-of-field blur effects.

When the wantsDepthOfField setting is enabled, SceneKit renders depth-of-field blur (also called bokeh) effects using a blur filter that samples multiple points in the image. Sampling a larger number of points produces a higher quality visual effect at a higher performance cost, and vice versa. The default sample count is 25.
(Read and Write property)

SCNCameraMBS.FocalLength as Double

Type Topic Plugin Version macOS Windows Linux iOS Targets
property SceneKit MBS Mac64bit Plugin 18.5 ✅ Yes ❌ No ❌ No ✅ Yes Desktop & iOS
The camera's focal length, in millimeters.

The sensorHeight and focalLength properties determine the camera's horizontal and vertical viewing angles using terms that model physical camera devices. (Alternatively, you can work with viewing angle directly though the fieldOfView property.) For example, with the default sensor height of 24 mm and default focal length of 50 mm, the vertical field of view is 60°.
Setting the fieldOfView property causes SceneKit to automatically recalculate the focalLength value, and setting the sensorHeight or focalLength property recalculates fieldOfView.
(Read and Write property)

SCNCameraMBS.focusDistance as Double

Type Topic Plugin Version macOS Windows Linux iOS Targets
property SceneKit MBS Mac64bit Plugin 18.5 ✅ Yes ❌ No ❌ No ✅ Yes Desktop & iOS
The distance from the camera at which objects appear in sharp focus. Animatable.

Objects at this distance from the camera appear perfectly focused. Objects nearer to or farther from the camera than this distance appear increasingly blurred, with the behavior of the blur effect depending on the fStop, apertureBladeCount and focalBlurSampleCount properties. The default focus distance is 2.5.
You can animate changes to this property’s value. See Animating SceneKit Content.
(Read and Write property)

SCNCameraMBS.fStop as Double

Type Topic Plugin Version macOS Windows Linux iOS Targets
property SceneKit MBS Mac64bit Plugin 18.5 ✅ Yes ❌ No ❌ No ✅ Yes Desktop & iOS
The physical camera aperture simulated by SceneKit for depth-of-field effects. Animatable.

F-stop numbers describe the light-gathering area of a physical camera's imaging system, and are typically expressed as the denominator of a ratio including the camera's focal length ƒ, such as ƒ/2 or ƒ/5.6. A larger denominator indicates a smaller aperture, allowing less light to pass from the camera's lens through to the imaging plane (sensor or film), and a smaller denominator indicates a larger aperture that lets more light through.
SceneKit uses aperture measurements to simulate depth-of-field blur effects (also called bokeh) approximating those produced by a physical camera. A larger fStop number (or aperture denominator) causes most of the scene to appear in focus, with extremely close or far depths showing slight blurring; a smaller number results in only a narrow range of depths appearing in focus, and a more pronounced blur effect for the rest of the scene. The default fStop value is 5.6.
You can animate changes to this property’s value. See Animating SceneKit Content.
(Read and Write property)

SCNCameraMBS.Handle as Integer

Type Topic Plugin Version macOS Windows Linux iOS Targets
property SceneKit MBS Mac64bit Plugin 18.5 ✅ Yes ❌ No ❌ No ✅ Yes Desktop & iOS
The internal object reference.

(Read and Write property)

SCNCameraMBS.maximumExposure as Double

Type Topic Plugin Version macOS Windows Linux iOS Targets
property SceneKit MBS Mac64bit Plugin 18.5 ✅ Yes ❌ No ❌ No ✅ Yes Desktop & iOS
The minimum exposure value to use in tone mapping.

When using a High Dynamic Range (HDR) camera, SceneKit applies a process called tone mapping to translate the wide range of luminance values in the visible scene to the narrower range of brightness values that can be shown on a display. SceneKit determines a tone mapping curve from the minimumExposure, maximumExposure, exposureOffset, and whitePoint properties, along with a measure of scene luminance.
Exposure values are exponential: a value of 1.0 doubles brightness, a value of 2.0 quadruples brightness, a value of -1.0 halves brightness, and so on. The default value is 15.0. Decreasing the value causes brighter portions of the scene to become over-exposed (uniformly white, losing definition). Increasing the value adds more dynamic range for brighter portions of the scene; however, a greater breadth of difference between the minimum and maximum exposures decreases contrast.
This property has no effect if the wantsHDR value is false.
(Read and Write property)

SCNCameraMBS.minimumExposure as Double

Type Topic Plugin Version macOS Windows Linux iOS Targets
property SceneKit MBS Mac64bit Plugin 18.5 ✅ Yes ❌ No ❌ No ✅ Yes Desktop & iOS
The minimum exposure value to use in tone mapping.

When using a High Dynamic Range (HDR) camera, SceneKit applies a process called tone mapping to translate the wide range of luminance values in the visible scene to the narrower range of brightness values that can be shown on a display. SceneKit determines a tone mapping curve from the minimumExposure, maximumExposure, exposureOffset, and whitePoint properties, along with a measure of scene luminance.
Exposure values are exponential: a value of 1.0 doubles brightness, a value of 2.0 quadruples brightness, a value of -1.0 halves brightness, and so on. The default value is -15.0. Increasing the value causes darker portions of the scene to become under-exposed (uniformly black, losing definition). Decreasing the value adds more dynamic range for darker portions of the scene; however, a greater breadth of difference between the minimum and maximum exposures decreases contrast.
This property has no effect if the wantsHDR value is false.
(Read and Write property)

SCNCameraMBS.motionBlurIntensity as Double

Type Topic Plugin Version macOS Windows Linux iOS Targets
property SceneKit MBS Mac64bit Plugin 18.5 ✅ Yes ❌ No ❌ No ✅ Yes Desktop & iOS
A factor that determines the intensity of motion blur effects. Animatable.

The default intensity of zero results in no motion blur effect. Higher values (toward a maximum of 1.0) create more pronounced motion blur effects.
Motion blur is not supported when wide-gamut color rendering is enabled. Wide-gamut rendering is enabled by default on supported devices; to opt out, set the SCNDisableWideGamut key in your app's Info.plist file.
You can animate changes to this property’s value. See Animating SceneKit Content.
(Read and Write property)

SCNCameraMBS.Name as String

Type Topic Plugin Version macOS Windows Linux iOS Targets
property SceneKit MBS Mac64bit Plugin 18.5 ✅ Yes ❌ No ❌ No ✅ Yes Desktop & iOS
A name associated with the camera object.

You can provide a descriptive name for a camera object to make managing your scene graph easier. Cameras loaded from a scene file may have names assigned by an artist using a 3D authoring tool. Use the SCNSceneSourceMBS class to examine cameras in a scene file without loading its scene graph.
(Read and Write property)

SCNCameraMBS.orthographicScale as Double

Type Topic Plugin Version macOS Windows Linux iOS Targets
property SceneKit MBS Mac64bit Plugin 18.5 ✅ Yes ❌ No ❌ No ✅ Yes Desktop & iOS
Specifies the camera’s magnification factor when using an orthographic projection.

In an orthographic projection, equally sized objects appear equally sized regardless of their distance from the camera. To switch between orthographic and perspective projections, see the usesOrthographicProjection property.
(Read and Write property)

SCNCameraMBS.ProjectionDirection as Integer

Type Topic Plugin Version macOS Windows Linux iOS Targets
property SceneKit MBS Mac64bit Plugin 18.5 ✅ Yes ❌ No ❌ No ✅ Yes Desktop & iOS
The axis used to determine field of view or orthographic scale.

The fieldOfView property measures view angle in a single primary direction, determined by this projectionDirection property. For the other direction, SceneKit automatically adjusts field of view depending on the aspect ratio of the view presenting the scene.
For example, with the default projection direction of SCNCameraProjectionDirectionVertical, setting fieldOfView to 60 results in a vertical view angle of 60°. If the scene appears on a display with a 4:3 aspect ratio, the horizontal view angle is 80°. However, if the scene appears on a 16:9 display, the horizontal view angle is 106°.
This property has a similar effect on scaling for orthographic projections. The orthographicScale property measures the scale factor in the direction of the projectionDirection property, and SceneKit automatically calculates scale factor in the other direction according to aspect ratio.
(Read and Write property)

SCNCameraMBS.projectionTransform as SCNMatrix4MBS

Type Topic Plugin Version macOS Windows Linux iOS Targets
property SceneKit MBS Mac64bit Plugin 19.1 ✅ Yes ❌ No ❌ No ✅ Yes Desktop & iOS
The camera’s projection transformation.

This transformation expresses the combination of all the camera’s geometric properties: projection type (perspective or orthographic), field of view, depth limits, and orthographic scale (if applicable). SceneKit uses this transformation to convert points in the camera node’s coordinate space to the renderer’s 2D space when rendering and processing events.
You can use this transformation directly if your app needs to convert between view and renderer coordinates for other purposes. Alternatively, if you compute your own projection transform matrix, you can set this property to override the transformation synthesized from the camera’s geometric properties.
(Read and Write property)

SCNCameraMBS.saturation as Double

Type Topic Plugin Version macOS Windows Linux iOS Targets
property SceneKit MBS Mac64bit Plugin 18.5 ✅ Yes ❌ No ❌ No ✅ Yes Desktop & iOS
An adjustment factor to apply to the overall color saturation of the rendered scene.

A value of 1.0 (the default) leaves scene colors unchanged. Greater values result in oversaturated colors, and a value of 0.0 makes the rendered scene entirely grayscale.
To enable this behavior, you must first enable the wantsHDR setting.
(Read and Write property)

SCNCameraMBS.screenSpaceAmbientOcclusionBias as Double

Type Topic Plugin Version macOS Windows Linux iOS Targets
property SceneKit MBS Mac64bit Plugin 18.5 ✅ Yes ❌ No ❌ No ✅ Yes Desktop & iOS
An offset for modulating ambient occlusion effects.

Ambient occlusion is an effect that improves material shading by calculating the amounts of ambient light that reach various parts of a surface, creating shadows on parts of a geometry where incoming light is obscured by other parts of the geometry. (You can provide pre-rendered ambient occlusion effects for a material using its ambientOcclusion property.) Screen-space ambient occlusion (SSAO) provides a real-time approximation of this effect for the entire scene viewed through the camera.
This screenSpaceAmbientOcclusionBias value is used in an intermediate stage of calculating the SSAO effect, and measures a distance in scene units. Increasing or decreasing this value from its default of 0.03 can help to offset unrealistic effects produced by changing other SSAO settings.
(Read and Write property)

SCNCameraMBS.screenSpaceAmbientOcclusionDepthThreshold as Double

Type Topic Plugin Version macOS Windows Linux iOS Targets
property SceneKit MBS Mac64bit Plugin 18.5 ✅ Yes ❌ No ❌ No ✅ Yes Desktop & iOS
The maximum depth difference, in units of scene space, at which to apply ambient occlusion effects.

Ambient occlusion is an effect that improves material shading by calculating the amounts of ambient light that reach various parts of a surface, creating shadows on parts of a geometry where incoming light is obscured by other parts of the geometry. (You can provide pre-rendered ambient occlusion effects for a material using its ambientOcclusion property.) Screen-space ambient occlusion (SSAO) provides a real-time approximation of this effect for the entire scene viewed through the camera.
This screenSpaceAmbientOcclusionDepthThreshold property controls the effect of relative distance from the camera on SSAO effects. Higher values create more shadowing effects between foreground and background elements of the scene, but this can result in unrealistic dark halos around foreground elements that are far from the background. Lower values avoid dark halo effects, but create less visual separation between scene elements at different distances from the camera. The default value is 0.2 units.
(Read and Write property)

SCNCameraMBS.screenSpaceAmbientOcclusionIntensity as Double

Type Topic Plugin Version macOS Windows Linux iOS Targets
property SceneKit MBS Mac64bit Plugin 18.5 ✅ Yes ❌ No ❌ No ✅ Yes Desktop & iOS
The intensity of the screen-space ambient occlusion effect applied in camera rendering.

Ambient occlusion is an effect that improves material shading by calculating the amounts of ambient light that reach various parts of a surface, creating shadows on parts of a geometry where incoming light is obscured by other parts of the geometry. (You can provide pre-rendered ambient occlusion effects for a material using its ambientOcclusion property.) Screen-space ambient occlusion (SSAO) provides a real-time approximation of this effect for the entire scene viewed through the camera.
The default value of this property is zero, disabling SSAO effects. Increasing the intensity value creates deeper, bolder shadows.
(Read and Write property)

SCNCameraMBS.screenSpaceAmbientOcclusionNormalThreshold as Double

Type Topic Plugin Version macOS Windows Linux iOS Targets
property SceneKit MBS Mac64bit Plugin 18.5 ✅ Yes ❌ No ❌ No ✅ Yes Desktop & iOS
The magnitude of the blur effect applied to create ambient occlusion shadows.

Ambient occlusion is an effect that improves material shading by calculating the amounts of ambient light that reach various parts of a surface, creating shadows on parts of a geometry where incoming light is obscured by other parts of the geometry. (You can provide pre-rendered ambient occlusion effects for a material using its ambientOcclusion property.) Screen-space ambient occlusion (SSAO) provides a real-time approximation of this effect for the entire scene viewed through the camera.
SSAO shadowing includes a blur effect to realistically soften differences in shadow between adjacent pixels, which depends on both the smoothness of scene geometry and this factor. Larger blur factors create a softer, more spread-out blur; smaller factors create coarser shadowing effects.
(Read and Write property)

SCNCameraMBS.screenSpaceAmbientOcclusionRadius as Double

Type Topic Plugin Version macOS Windows Linux iOS Targets
property SceneKit MBS Mac64bit Plugin 18.5 ✅ Yes ❌ No ❌ No ✅ Yes Desktop & iOS
The distance, in units of scene space, at which ambient occlusion takes effect.

Ambient occlusion is an effect that improves material shading by calculating the amounts of ambient light that reach various parts of a surface, creating shadows on parts of a geometry where incoming light is obscured by other parts of the geometry. (You can provide pre-rendered ambient occlusion effects for a material using its ambientOcclusion property.) Screen-space ambient occlusion (SSAO) provides a real-time approximation of this effect for the entire scene viewed through the camera.
SSAO effects work by storing relevant scene geometry information for each pixel, and using that information to produce per-pixel shading effects. This screenSpaceAmbientOcclusionRadius property determines the area in scene space to consider around each pixel for determining the amount of incoming ambient light blocked by surrounding geometry (and thus the amount of shadow effect to apply). The default value is 5; smaller values cause SSAO effects to apply only to finer geometry details, while larger values affect coarser details.
(Read and Write property)

SCNCameraMBS.SensorHeight as Double

Type Topic Plugin Version macOS Windows Linux iOS Targets
property SceneKit MBS Mac64bit Plugin 18.5 ✅ Yes ❌ No ❌ No ✅ Yes Desktop & iOS
The vertical size of the camera's imaging plane, in millimeters.

The sensorHeight and focalLength properties determine the camera's horizontal and vertical viewing angles using terms that model physical camera devices. (Alternatively, you can work with viewing angle directly though the fieldOfView property.) For example, with the default sensor height of 24 mm and default focal length of 50 mm, the vertical field of view is 60°.
Setting the fieldOfView property causes SceneKit to automatically recalculate the focalLength value, and setting the sensorHeight or focalLength property recalculates fieldOfView.
(Read and Write property)

SCNCameraMBS.UsesOrthographicProjection as Boolean

Type Topic Plugin Version macOS Windows Linux iOS Targets
property SceneKit MBS Mac64bit Plugin 18.5 ✅ Yes ❌ No ❌ No ✅ Yes Desktop & iOS
A Boolean value that determines whether the camera uses an orthographic projection.

The default value of this property is false, specifying a perspective projection. In a perspective projection, equally sized objects nearer to the camera appear larger than those farther away.
Set the value of this property to true to specify an orthographic projection. In an orthographic projection, equally sized objects appear equally sized regardless of distance from the camera.
To control the magnification factor of an orthographic camera, use its orthographicScale property.
(Read and Write property)

SCNCameraMBS.vignettingIntensity as Double

Type Topic Plugin Version macOS Windows Linux iOS Targets
property SceneKit MBS Mac64bit Plugin 18.5 ✅ Yes ❌ No ❌ No ✅ Yes Desktop & iOS
The magnitude of vignette (darkening around edges) effect to apply to the rendered scene.

A vignette effect darkens the edges and corners of the rendered scene, simulating the effect of lens and barrel shape on the image produced by a physical camera. Higher values result in more darkening, and lower values result in a subtler effect. The default value of 0.0 results in no vignetting effect.
This property controls the level of darkening applied; the vignettingPower property controls the area of the rendered image to be darkened.
To enable this behavior, you must first enable the wantsHDR setting.
(Read and Write property)

SCNCameraMBS.vignettingPower as Double

Type Topic Plugin Version macOS Windows Linux iOS Targets
property SceneKit MBS Mac64bit Plugin 18.5 ✅ Yes ❌ No ❌ No ✅ Yes Desktop & iOS
The amount of the rendered scene to darken with a vignette effect.

A vignette effect darkens the edges and corners of the rendered scene, simulating the effect of lens and barrel shape on the image produced by a physical camera. Higher values result apply the darkening effect to a broader area around the edges of the rendered image, and lower values apply the effect to a smaller area, leaving more of the rendered image at full brightness. The default value of 0.0 results in no vignetting effect.
This property controls the area of the rendered image to be darkened; the vignettingIntensity property controls the level of darkening applied to those areas.
To enable this behavior, you must first enable the wantsHDR setting.
(Read and Write property)

SCNCameraMBS.WantsDepthOfField as Boolean

Type Topic Plugin Version macOS Windows Linux iOS Targets
property SceneKit MBS Mac64bit Plugin 18.5 ✅ Yes ❌ No ❌ No ✅ Yes Desktop & iOS
A Boolean value that determines whether SceneKit renders depth-of-field blur effects for the camera.

This value is false by default, disabling depth-of-field effects.
Enabling this property causes SceneKit to render blur effects that model those created by a physical camera device (also known as bokeh). That is, objects in the scene appear more or less blurry depending on their distance from the camera and the camera's focusDistance, and the intensity and style of the blur effect depend on the fStop and apertureBladeCount properties.

Note
For best results, also enable the wantsHDR property when using depth-of-field effects. High Dynamic Range rendering provides high contrast for distant bright points in the scene, creating more pronounced bokeh effects.
(Read and Write property)

SCNCameraMBS.WantsExposureAdaptation as Boolean

Type Topic Plugin Version macOS Windows Linux iOS Targets
property SceneKit MBS Mac64bit Plugin 18.5 ✅ Yes ❌ No ❌ No ✅ Yes Desktop & iOS
A Boolean value that determines whether SceneKit automatically adjusts the exposure level.

When using a High Dynamic Range (HDR) camera, SceneKit applies a process called tone mapping to translate the wide range of luminance values in the visible scene to the narrower range of brightness values that can be shown on a display. One measure of tone mapping is the exposure value, whose effect on the output is similar to that of the shutter speed (or exposure time) of a real-world camera—lower exposure values result in a darker image, and higher exposures result in a brighter image. You cannot adjust exposure value directly—instead, SceneKit determines a tone mapping curve (including the exposure level) from the minimumExposure, maximumExposure, exposureOffset, and whitePoint properties along with a measure of scene luminance.

If this property’s value is true (the default), SceneKit automatically measures the current luminance visible to the camera during rendering, and adjusts the exposure level accordingly. Additionally, when the scene luminance changes, SceneKit automatically animates a transition to the new exposure level (see the exposureAdaptationBrighteningSpeedFactor and exposureAdaptationDarkeningSpeedFactor properties).

Note
The visual effect of automatic exposure is similar to how human visual perception adjusts to changes in environmental lighting. For example, consider a game scene where the player moves from a darkened area into full daylight. At first, the exposure value is low, allowing for visible detail in the darkened area, but no detail in the white daylight outside. As the player moves into the daylight, the entire view becomes blindingly bright, but over a brief time the player’s vision adapts: detail becomes visible in the bright area, and the darkened area loses detail.

If this property’s value is false, SceneKit’s tone mapping effect is constant. Instead of responding to scene luminance, SceneKit uses the averageGray property to determine the tone mapping curve.
This property has no effect if the wantsHDR value is false.
(Read and Write property)

SCNCameraMBS.WantsHDR as Boolean

Type Topic Plugin Version macOS Windows Linux iOS Targets
property SceneKit MBS Mac64bit Plugin 18.5 ✅ Yes ❌ No ❌ No ✅ Yes Desktop & iOS
A Boolean value that determines whether SceneKit applies High Dynamic Range (HDR) postprocessing effects to a scene.

When this property’s value is false (the default), SceneKit performs lighting calculations in a color space whose brightness range is similar to that of the output display. This approach limits the ability to perform realistic rendering of scenes with fine details in brightness levels.
When you enable HDR rendering for a camera, SceneKit calculates lighting in a much deeper color space, preserving fine details in contrast regardless of brightness, then applies a post-processing effect called tone mapping to translate luminance values from that space to the narrower range of brightness values that can be shown on a display. SceneKit determines a tone mapping curve (including the exposure level) from the minimumExposure, maximumExposure, exposureOffset, and whitePoint properties along with a measure of scene luminance. The wantsExposureAdaptation property determines whether tone mapping effects are static or dynamically respond when the luminance visible to the camera changes.
The default value is false.
(Read and Write property)

SCNCameraMBS.whitePoint as Double

Type Topic Plugin Version macOS Windows Linux iOS Targets
property SceneKit MBS Mac64bit Plugin 18.5 ✅ Yes ❌ No ❌ No ✅ Yes Desktop & iOS
The luminance level to use as the upper end of a tone mapping curve.

When using a High Dynamic Range (HDR) camera, SceneKit applies a process called tone mapping to translate the wide range of luminance values in the visible scene to the narrower range of brightness values that can be shown on a display. SceneKit determines a tone mapping curve from the minimumExposure, maximumExposure, exposureOffset, and whitePoint properties, along with a measure of scene luminance.
The default value is 1.0. By setting this property to a higher or lower value, you can produce more gradual or more abrupt transitions between shadows and highlights.
This property has no effect if the wantsHDR value is false.
(Read and Write property)

SCNCameraMBS.zFar as Double

Type Topic Plugin Version macOS Windows Linux iOS Targets
property SceneKit MBS Mac64bit Plugin 18.5 ✅ Yes ❌ No ❌ No ✅ Yes Desktop & iOS
The camera’s far depth limit. Animatable.

The far value determines the maximal distance between the camera and a visible surface. If a surface is farther from the camera than this distance, the surface is clipped and does not appear. The default far value is 100.0.
You can animate changes to this property’s value. See Animating SceneKit Content.
(Read and Write property)

SCNCameraMBS.zNear as Double

Type Topic Plugin Version macOS Windows Linux iOS Targets
property SceneKit MBS Mac64bit Plugin 18.5 ✅ Yes ❌ No ❌ No ✅ Yes Desktop & iOS
The camera's near depth limit. Animatable.

The near value determines the minimal distance between the camera and a visible surface. If a surface is closer to the camera than this distance, the surface is clipped and does not appear. The near value must not be zero. The default near value is 1.0.
You can animate changes to this property’s value. See Animating SceneKit Content.
(Read and Write property)

The items on this page are in the following plugins: MBS Mac64bit Plugin.


The biggest plugin in space...