Platforms to show: All Mac Windows Linux Cross-Platform

SCNLevelOfDetailMBS class

Type Topic Plugin Version macOS Windows Linux iOS Targets
class SceneKit MBS Mac64bit Plugin 19.3 ✅ Yes ❌ No ❌ No ✅ Yes Desktop & iOS
An alternate resolution for a geometry that SceneKit automatically substitutes to improve rendering performance.

You use level-of-detail objects when you have a detailed geometry that appears at several apparent sizes in a scene. For example, the teapot model on the the left in the figure below has 256 polygons, the model at center has 1024 polygons, and the model on the right has 14,400 polygons. If all three models appear close to the camera, filling most of the rendered view, the difference in detail between them is clearly visible—but if they appear far away, taking up a small area of the view, the difference is much less obvious. Rendering higher-resolution geometries incurs a higher performance cost.

When you associate one or more level-of-detail objects with a SCNGeometryMBS object using its levelsOfDetail property, SceneKit automatically substitutes alternate geometries when appropriate. For example, the two lower-resolution teapot models seen above can be added as levels of detail for the high-resolution model.
For each level of detail, you specify either a world-space distance or a screen-space radius. The measure you specify determines the threshold where SceneKit automatically renders that level of detail’s alternate geometry instead of the original geometry. If you specify a distance, the alternate geometry appears when the node containing the geometry is moved that distance away from the camera. If you specify a radius, the alternate geometry appears when the pixel area covered by the rendered by the geometry is smaller than a circle of that radius.
The geometries associated with lower levels of detail need not share all attributes of the original geometry. For example, you can use different materials for levels of detail that only appear when far away from the camera, disabling expensive features such as per-pixel lighting, reflection mapping, or custom shader programs.
This is an abstract class. You can't create an instance, but you can get one from various plugin functions.

This class has no sub classes.

Some methods using this class:

Blog Entries

Release notes


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


SCNIKConstraintMBS   -   SCNLightMBS


The biggest plugin in space...