Basic

Import one panorama

Your image must be complete and 2:1. Use a JPEG, PNG, or HEIC that is at least 4,096 × 2,048 pixels. A recommended size is 12,288 × 6,144.
  1. Open Library, then Import Your Own.
  2. Choose Import a View. Pick Photos, Files, or URL.
  3. Select the panorama. For URL, paste a direct public HTTPS image link rather than a webpage.
  4. Wait while Locus prepares it. Locus creates the images it needs for preview and Room lighting on your device.
  5. Open it in Places. Pair the new View with any Room, then choose Enter.

If the panorama is already online, the faster route is Apply a panorama from Locus Browser. You can try it without using an import first.

Better results

Prepare the image before importing

A flat two-to-one equirectangular panorama of an autumn hillside
A View image looks unusually wide because it stores the full 360° sphere in one flat 2:1 image.

In Locus

Fine-tune the View

In Places, open the menu for your View and choose Edit View. Adjust Turn the View first, then View Brightness, Contrast, Color, Room Lighting, and optional Sunlight. These settings are saved for this View.

Separate what you see from how the Room is lit. View Brightness changes the panorama. Room Lighting changes how strongly that View lights the 3D Room.

Advanced

Package a reusable View

A View ZIP lets you ship the panorama with a thumbnail, provenance, starting direction, appearance, Room-lighting image, and optional sunlight. Keep every file at the ZIP root:

my-view.zip
├── view.json
├── provenance.json
├── panorama.jpg
├── thumbnail.jpg
└── lighting.jpg       # optional
  1. Create the panorama and thumbnail. Keep the panorama complete and exactly 2:1.
  2. Describe the View in view.json. Set its display name, dimensions, panorama.initialYawDegrees, appearance, and optional sun.
  3. Record provenance. State who made it, what rights apply, what changed, and whether AI was used.
  4. Pack and validate the flat ZIP. Use the public tools before sharing or importing it.