Platforms to show: All Mac Windows Linux Cross-Platform

Back to SCNCameraMBS class.

Previous items

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)

Previous items

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


💬 Ask a question or report a problem
The biggest plugin in space...