Interface: SceneCameraSettings
Camera configuration settings for the 3D scene.
This interface defines how the viewpoint camera behaves in the 3D scene, controlling default positions, animation settings, and viewing limits. The camera is the user's "eyes" in the virtual environment, so its behavior significantly impacts the user experience.
Well-configured camera settings make products easy to examine from all angles while preventing disorienting viewpoints.
Properties
ghost?
optionalghost:Nullable<CameraPosition>
Camera position used for the "ghost" view.
This property defines an alternative camera position used in special visualization contexts, such as showing transparent or "ghost" views of products to reveal internal components.
Ghost views are particularly useful for complex products with internal features or for "x-ray" style views.
main?
optionalmain:Nullable<CameraPosition>
Default camera position for the main view.
This property defines the standard positioning of the camera when viewing products, including angles, distance, and target point. A good main position shows the product clearly and attractively.
The main camera should typically show products from a slight angle to convey depth while clearly displaying the primary features.
mode
mode:
"main"|"ghost"
The active camera mode.
This property determines which camera position is currently active, allowing the system to switch between different predefined views.
- "main": Uses the standard product view
- "ghost": Uses the alternative "ghost" view