specs-spatial-image

Convert 2D images into 3D spatialized meshes for Spectacles using the Spatial Image package.

16|2|Updated Apr 13, 2026
One-click install
npx skills add https://github.com/lens-studio-devs/ls-extensions --skill specs-spatial-image-lens-studio-devs
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: specs-spatial-image
Source: https://github.com/lens-studio-devs/ls-extensions/tree/main/plugins/ls-clad/skills/specs-spatial-image
Command: npx skills add https://github.com/lens-studio-devs/ls-extensions --skill specs-spatial-image-lens-studio-devs

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Building 3D photo experiences on Spectacles requires coordinating multiple components—frames, depth animators, angle validators, and gallery navigation—plus Remote Service Gateway authentication. This Skill provides the scene setup, API patterns, and code snippets needed to spatialize flat images into depth-enabled 3D meshes without reading the full upstream documentation. ## Core Features & Use Cases - Image Spatialization: Set a Texture on SpatialImageFrame and automatically swap to the 3D mesh when the spatialization service returns. - Gallery Navigation: Browse multiple images with next/previous controls using the SpatialGallery pattern with clamped indexing. - Viewing Angle Validation: Flatten the image back to 2D when the user views from extreme angles using SpatialImageAngleValidator callbacks. - Depth Animation & Focal Adjustment: Animate depth scale with easing and correct frame offset when users grab and move the image. - Use Case: Build a 3D photo gallery Lens where users pinch through spatialized vacation photos that automatically flatten when viewed from the side. ## Quick Start Set up the four template scene objects, add your Remote Service Gateway credential, then call frame.setImage with your texture and swapWhenSpatialized set to true.

Frequently Asked Questions about specs-spatial-image

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I convert a 2D image to 3D in Lens Studio?

Install the Spatial Image package from the Asset Library, then call SpatialImageFrame.setImage with your Texture and swapWhenSpatialized set to true. The frame automatically swaps the flat image for the spatialized 3D mesh once the service returns.

How do I build a 3D photo gallery on Spectacles?

Use the SpatialGallery pattern: store images as a Texture array, keep a clamped index, and call frame.setImage in a setIndex function. Expose nextImage and prevImage methods to navigate through the gallery.

What are the requirements for the Spatial Image package?

You need Lens Studio 5.3.0 or above, Spectacles OS v5.58.6621 or later, and a Remote Service Gateway credential entered in the RemoteServiceGatewayCredentials scene object. The Spectacles Interaction Kit is optional.

Why does the spatial image not appear in the Lens Studio preview?

Make sure the preview device is set to Spectacles and check your internet connection, since spatialization runs through a remote service. Also verify your Remote Service Gateway credential is configured.

Why is the spatial image background cut off?

The background gets clipped when the camera's far clipping plane is too small. Increase the far clipping plane of the camera to render the full spatialized mesh.

Can I spatialize multiple images at the same time?

No, only one image can be spatialized at a time. The component prioritizes active in-scene images, and simultaneous requests cause delays, so gallery navigation should spatialize images sequentially.