Document S-01

Support

DepthWeaver for iPhone and Mac · iOS 17+ · macOS 14+

DepthWeaver is a small app maintained by one person. The fastest way to get help, request a feature, or report a bug is the GitHub issue tracker. Everything else lives below.

Report an issue Email the developer

Quick start

Capture depth. Pick a source — on iPhone, the Generation screen offers LiDAR (live), Photo (on-device AI), 3D Model (orbit a bundled or imported file), Capture 3D (scan a real object with Object Capture), or a bundled height-map preset. On Mac, the inspector pane offers the same sources minus LiDAR and Object Capture (no camera-based capture on macOS).
Pick a pattern. Choose a built-in texture, import an image as a tile, or tune one of the six procedural generators.
Adjust. Slide DPI, depth strength, separation, and oversampling. Open Depth Adjustment to remap input/output ranges or denoise an 8-bit import.
Share. Tap the result for a full-screen view, then export to Photos, Messages, AirDrop, or any app with a share sheet on iPhone. On Mac, use File → Save (⌘S) for a PNG, Edit → Copy (⌘⇧C) for the pasteboard, or the standard share menu.

How to actually see the stereogram

Autostereograms (Magic Eye images) need either of two viewing techniques:

Parallel / divergent — focus past the screen, as if looking at something behind it. The image floats forward.
Cross-eyed — cross your eyes slightly and the depth inverts (peaks become valleys).

If it does not click, try this: hold the device close enough (or sit close to your Mac display) that the screen blurs, then slowly move away while keeping your gaze relaxed. The hidden image will lock in. It gets easier with practice.

Frequently asked questions

Does DepthWeaver run on Mac?

Yes — there is a native macOS app (macOS 14+) built from the same SwiftUI codebase. The Mac UI is a document-style window with a collapsible inspector, standard menu commands (Open ⌘O, Save ⌘S, Copy ⌘⇧C, Toggle Inspector ⌘⌥I), and PNG export through the standard save panel. LiDAR live capture and Object Capture scans stay on iPhone where the hardware lives; everything else (AI depth, 3D model loading, presets, denoising, the Metal renderer) works identically on both.

Why is the LiDAR option missing on my iPhone (or Mac)?

LiDAR is only available on iPhone Pro models. On non-Pro iPhones the option is hidden because there is no sensor to read. The Mac app does not offer LiDAR live capture at all.

Why is the "Capture 3D" option missing?

Object Capture requires a LiDAR-equipped iPhone or iPad (iPhone 12 Pro and later Pro models, or recent LiDAR iPad Pro) and iOS 17+. On unsupported devices the button is hidden. The Mac app does not include Object Capture; load a pre-made .usdz or other 3D file instead. The Simulator cannot run Object Capture.

Tips for a clean 3D scan?

Use a small, opaque, matte object on a contrasting surface in even, diffuse light. Follow the orbit guides through three passes. Glossy, transparent, thin, or textureless objects (mirrors, glass, single-color plastic) are difficult for photogrammetry. Reconstruction runs after you finish capturing and may take a minute or two.

Where are my captured 3D models stored?

In a private "My captures" library inside the app sandbox. They show up alongside the bundled samples in the 3D Model picker. You can rename or delete them from a long-press menu. Nothing is uploaded.

My imported depth map looks banded or noisy. Can I fix it?

Open Depth Adjustment and enable denoising. The denoiser targets 8-bit quantization (the typical cause of visible bands) and only runs on imported depth maps — LiDAR and AI-generated depths skip it because they have real precision to preserve.

The output is blank or extremely thin.

The stereogram algorithm requires the maximum separation to be smaller than the image width. Lower the depth strength, raise the DPI, or pick a smaller pattern, then try again.

Is the GPU used for rendering?

Yes. The full stereogram pipeline (link-based hidden-surface removal, both centre-outwards pattern fills, OKLab gap fill, and OKLab oversampling downscale) runs as a Metal compute kernel — one thread per output row. If Metal is unavailable for any reason, the app transparently falls back to a parallel CPU path that produces the same output.

Where does the app save my generated images?

On iPhone, wherever you send them through the share sheet — DepthWeaver does not maintain its own gallery. On Mac, use File → Save (⌘S) to write a PNG to disk, Edit → Copy (⌘⇧C) to put it on the pasteboard, or the share menu. By default, nothing is stored outside the app's session unless you explicitly save or share.

Does the app work offline?

Yes — entirely. There is no network code in DepthWeaver. The Depth Anything V2 model is bundled inside the app.

Do you collect data?

No. See the privacy policy. There is no account, no analytics, no advertising.

What languages is it available in?

English and French. The language follows your iOS or macOS system setting.

Known limitations

LiDAR depth is captured at 256 × 192 in landscape from ARKit and rotated for portrait. Fine detail beyond that resolution will not appear.
The app uses sceneDepth; smoothedSceneDepth is not available, so live LiDAR frames may be slightly noisier than other ARKit apps.
Pathological combinations of depth strength and pattern size can produce an empty result. Lower the strength and retry.
3D model loading is limited to .usdz, .usd, .obj, and .scn — formats SceneKit can read natively.
In-app 3D scanning needs Apple's Object Capture, which requires a LiDAR-equipped iPhone or iPad (iPhone 12 Pro+) on iOS 17+. The button is hidden on unsupported devices.
The macOS app does not include LiDAR live capture or Object Capture (these flows are gated behind #if os(iOS)). On Mac, capture depth from photos, presets, or 3D models loaded from disk.
Rendering uses Metal by default; if the Metal kernel can't be loaded, the app falls back to a slower parallel CPU path. Both produce numerically aligned output.

Reporting a bug

Open an issue on GitHub with: your device model and OS version (iPhone + iOS, or Mac model + macOS), the DepthWeaver version (in the iOS Settings app, or DepthWeaver → About on Mac), and the steps to reproduce. A screenshot or short screen recording is always welcome.

Issues: github.com/glandais/DepthWeaver/issues
Email: gabriel.landais@gmail.com
Source: github.com/glandais/DepthWeaver