Scan Workflow

The scanning process enables the Lightform device to scan your scene and wirelessly send a Smart Scan to Lightform Creator.

The Smart Scan captures an understanding of your scene from the perspective of the projector so you can quickly select objects and apply dynamic instant effects that map precisely to every pixel of your scene.


  1. Be sure to reference Getting a Good Scan before continuing.
  2. Make sure your projector is on, the Lightform device is on, and the Lightform device is connected to your projector over HDMI.

Scan Workflow

Step 1 Start the Scan Workflow

When you first open Lightform Creator, you will see the Welcome Screen. From here, click the New Project button to start a New Project. Pair or select your Lightform device to enter the scan dialog. You will see the Lightform device's camera stream of your physical scene.


Step 2 Align the Lightform Device's Camera

When you enter scan dialog, the Lightform device will automatically display a test pattern and you will see a live preview of the Lightform device's camera feed. Ensure that the entire test pattern is visible within in the camera frame. If it's not, you may need to physically adjust the device position, projector zoom, or lens shift in order to capture the entire projected image.


Step 3 Capture all of Desired Scene with Test Pattern

Use the camera stream and the projected test pattern to make sure you can see the entire scene you'd like to work with and that your projector is in focus. Make any necessary adjustments to the projector's placement or focus.

Step 4 Advanced Settings

Check to see if any of the advanced settings might be appropriate for your scan.

Step 5 Scan!

Make sure nothing will be moving in between the Lightform device and your scene during your scan. Click the Scan button.


While structured light patterns are flashing, it is important that there is no motion in the scene, and that there is nothing to obstruct the Lightform device's camera or projector's field of view.

During the scan process, structured light patterns are displayed for approximately 30 seconds. Once the patterns have finished flashing, the Lightform device will process the images and assign color values to all projector pixels. The processing phase will take approximately 60 seconds. This image forms the resulting "scan" – essentially a snapshot from the projector's exact point of view.


  1. If you have trouble downloading the scan image try improving your WiFi setup or switch to an ethernet connection.
  2. You can take multiple scans after the initial scan. Check out Getting a Good Scan and Common Scan Issues and Resolutions for scanning tips.

Advanced Settings

Toggle the Advanced Settings in the scan page to see these options:

High Dynamic Range (HDR)

You can enable/disable HDR and select taking 2 or 3 exposures for HDR.

Selecting more exposures increases the time to complete a scan but can improve the quality of a scan. HDR with 2 exposures is the recommended setting.

Apply Mask

This setting will attempt to figure out which parts of the scene are directly projected on, as opposed to being illuminated by other light or bounced/reflected light from the projector. The scanning algorithm estimates this "mask", and then uses it to cancel out other light in the scene.

When this setting is on, the scan should look more "clean." However, sometimes the mask estimation fails and removes parts of the scan that are actually valid scan regions.

A good rule of thumb is: if the projected light looks a bit dim in your scene, and/or there is not a lot of bounced light from the projector, you will probably get a better result with Apply Mask off. Otherwise, Apply Mask can help filter out incorrect estimates when the projector is bright or your scene contains bounced light from the projector (usually occurring from glossy/reflective surfaces).

Safe Mode

If scan is not looking very good for any reason, try enabling Safe Mode. This option increases scanning time, but tests many different algorithm parameters to try and get the best scan possible. Safe Mode is usually not needed though, unless the scene is very dark, or the projector's frame delay is significantly higher than normal.

Was this article helpful?
5 out of 5 found this helpful

Sign in to make a suggestion to improve this article