Skip to content

how-to-use-3D-UI.md

Latest commit

 

History

History
90 lines (64 loc) · 3.62 KB

how-to-use-3D-UI.md

File metadata and controls

90 lines (64 loc) · 3.62 KB

How to Use the Intel® SceneScape 3D UI for Camera Calibration

This guide provides step-by-step instructions to use the Intel® SceneScape 3D UI to manage and calibrate cameras in a 3D scene. By completing this guide, you will:

  • Navigate the 3D UI.
  • Add, modify, or delete cameras.
  • Calibrate cameras interactively within a 3D scene.

This task is important for developers or customers using Intel® SceneScape to visually manage and align camera data with 3D environments. If you're new to Intel® SceneScape, see the Intel® SceneScape README.

Prerequisites

Before you begin:

  • SceneScape Installed: Intel® SceneScape must be installed and accessible via your browser.
  • 3D Scene Loaded: A glTF/GLB file should be uploaded and attached to a scene.
  • Permissions: Ensure you have permissions to create or modify camera data.

Steps to Use the 3D UI

Step 1: Launch the 3D UI

  1. Log in to Intel® SceneScape.

  2. On the homepage, identify a scene and click its 3D button Homepage

  3. You will be directed to the 3D UI view. 3D UI

    Expected Results:

    • Scene loads with camera icons, tracked objects, and a glTF/GLB background.

Step 2: Add or Modify a Camera

  1. Click on Add Camera to place a new camera.
  2. Select a camera by clicking its icon in the scene.
  3. Use transform tools to rotate or move the camera. camera-controls Camera Control Panel Options:
    • name: Assign a custom name.
    • scene camera: Set view to camera's perspective.
    • toggle rotate/translate: Switch between rotation and translation tools.
    • project frame: Display camera frame projected into the 3D scene.
    • pause video: Pause live camera feed.
    • opacity: Adjust projection transparency.
    • extrinsics/intrinsics/distortion: Configure camera settings.
    • save camera: Persist the current camera configuration.
    • delete camera: Remove selected camera.

Step 3: Calibrate the Camera

  1. Ensure camera is facing the scene for proper projection.

  2. Enable project frame. project-frame

  3. Double-click on the projected image area to create a calibration point. Repeat until four points are added. calib-point-creation

  4. Drag the calibration spheres to align the projection with the 3D scene. camera-calibrated

  5. Click save to persist the calibration.

    Tips:

    • Choose distinct, identifiable image features.
    • Space calibration points apart for better accuracy.

Configuration Options

Parameter Purpose Expected Values
camera_name Custom label for the camera String
extrinsics Camera position and orientation Matrix or 3D transform values
intrinsics Lens configuration fx, fy, cx, cy, etc.
distortion Lens distortion coefficients k1, k2, p1, p2, etc.
opacity Transparency of projected image 0.0 (transparent) to 1.0 (solid)

Troubleshooting

  1. Issue: If you use 3D UI Camera Calibration, the 8-points in 2D UI Camera Calibration will no longer be consistent with the current pose.

Supporting Resources