top of page
orthopractis.com

VisionMeshCapture

06A9D494-E995-4FB6-A8BF-B8CEA072CCF7_1_102_o_edited.jpg
VisionMeshCapture_Logo_1024.png
Download_on_the_App_Store_Badge_US-UK_135x40.png

VisionMeshCapture is a visionOS app for Apple Vision Pro that helps users capture selected reconstructed environment mesh inside an immersive yellow selection box, preview captured geometry, tune capture quality, load and align USDZ models, and export structured PLY, USDZ, CSV, and JSON packages.
The app is designed for spatial documentation, construction documentation support, research, education, visualization, design review, and technical prototyping. It is not a medical device, not a certified survey tool, and not a safety-critical inspection system.

VisionMeshCapture is a spatial mesh capture and analysis tool for Apple Vision Pro. It allows users to define a 3D capture box in immersive space, preview reconstructed environment geometry, tune capture quality in real time, inspect mesh color information where available, align imported 3D models, and export structured mesh packages including PLY, USDZ, CSV, and JSON files.

The app is designed for professional, educational, research, visualization, spatial documentation, ergonomic study, design review, and technical prototyping workflows. It helps users capture and organize local 3D spatial information from the surrounding environment and imported assets.

Key Features

Immersive selection-box capture
Place a visible yellow 3D capture box in immersive space. The box includes a yellow perimeter, always-visible center sphere, and draggable transparent surface handles for resizing and refinement.

Real-time capture preview
Preview the reconstructed faces inside the selection box before committing the final capture. The HUD displays live diagnostics such as source faces, box hits, filtered faces, retained faces, rejected faces, triangle area range, and nearest reconstructed surface distance.

Automatic capture tuning
The app can automatically choose practical capture settings to reduce empty-box results and improve successful mesh extraction. Users can also manually adjust resolution, face budget, minimum triangle area, preview opacity, and color-blending settings.

Enterprise camera-aware color path
When approved enterprise main-camera access is available, the app can use camera-frame information to improve color sampling and vertex-color export. If enterprise access is unavailable, the app remains fully functional using the scene-reconstruction mesh and classification/fallback color path. Apple describes Vision Pro main-camera access as part of enterprise APIs, so this capability should be enabled only with the approved entitlement and license.  

Scene reconstruction and world sensing
The app uses visionOS world-sensing / scene-reconstruction capabilities to understand surrounding geometry inside the selected capture area. Apple requires a world-sensing privacy usage description for features such as scene reconstruction, plane detection, image tracking, and related ARKit data access.  

Multiple USDZ loading
Load multiple USDZ models into immersive space. Each loaded model keeps its own stored transform and can be placed at the center of the capture box.

Point-cloud alignment
Use captured points inside the selection box as an input point cloud and align the last loaded USDZ model to the captured mesh using point-cloud matching techniques.

Mesh and color analytics
For imported vertex-colored meshes, the app can read vertex positions and color values, allowing export of structured (x, y, z, r, g, b, a) information for analysis, clustering, thresholding, review, or post-processing.

Export package
Export structured capture packages containing:

* captured environment PLY
* captured environment USDZ
* imported USDZ models
* captured vertices CSV
* captured faces CSV
* color/mesh analysis CSV
* manifest JSON
* package metadata

 

Professional workflow
The app includes a scrollable control window, collapsible menus, immersive HUD, progress bars, export status, help menu, privacy text, terms of use, and a first-launch consent page.

Example Uses

VisionMeshCapture may be useful for:

* spatial documentation of local environments
* design and architecture review
* object-to-environment alignment testing
* mesh reconstruction experiments
* ergonomic and posture-related spatial research
* technical prototyping for spatial computing
* education and demonstration of 3D capture concepts
* comparison of imported USDZ models against captured geometry
* point-cloud registration experiments
* exporting local mesh data for external review

Important Limitations

VisionMeshCapture is not a medical device and does not provide diagnosis, treatment recommendations, surgical planning, or automated clinical decisions. Any measurements, reconstructions, color samples, alignments, or exported files are intended for visualization, research, education, technical review, and documentation support only.

The app does not replace professional judgment. Accuracy depends on device conditions, lighting, reconstruction quality, surface texture, camera availability, user-selected thresholds, and environmental factors.

IMG_0728.PNG
IMG_0729.PNG
Download_on_the_App_Store_Badge_US-UK_135x40.png

Quick start

1. Launch the app and accept the consent page.

2. Open Immersive Space.

3. Press Start / Restart Providers.

4. Press Recenter Box.

5. Place the yellow box around the area you want to capture.

6. Press Auto Tune or Preview current thresholds.

7. Press Prepare Capture and inspect the highlighted mesh in the HUD.

8. Press Commit Capture when the preview is correct.

9. Optionally load USDZ models and align the latest model to the captured point cloud.

10. Press Prepare Export Package.

11. Save or share the ZIP package from the window UI.

What each major button does

Open Immersive Space

Opens the immersive Vision Pro scene where the yellow selection box, HUD, reconstructed mesh preview, imported models, and alignment result are visible.

Start / Restart Providers

Starts or restarts world tracking, scene reconstruction, and the available camera/color pipeline.

Recenter Box

Places the yellow capture box in front of the user. The HUD remains above the upper surface of the box and faces the user.

Refresh License

Checks whether approved enterprise main-camera access is available. If not available, the app remains usable in fallback mode.

IMG_0731.PNG
IMG_0762.PNG

Auto Tune
Automatically adjusts capture settings to reduce empty-box previews and keep useful reconstructed geometry.
Preview current thresholds
Shows candidate mesh faces using the current box size, position, rotation, and filters.
Prepare Capture
Stage 1: highlights the candidate captured mesh and shows diagnostics without finalizing export data.
Commit Capture
Stage 2: finalizes the captured mesh and creates export-ready PLY, USDZ, CSV, JSON, and manifest data.
Load Meshes
Imports supported 3D files. New models appear at the yellow center sphere.
Align Last Loaded
Aligns the latest loaded model to the captured point cloud using registration/refinement logic.
Prepare Export Package
Builds an export ZIP with captured and imported 3D files plus analytics tables and manifests.
Save ZIP to Files / Share ZIP / AirDrop
Exports the prepared ZIP from the window UI. The immersive HUD does not open system share dialogs.
Gesture map
Yellow center sphere: drag to move the box.
Transparent face handles: drag to resize one surface of the box.
Pinch: scale the active target.
Rx / Ry / Rz controls: rotate the active model or box with precision.
HUD sliders: tune capture filters in real time.
Recenter: place the box in front of the user again.
Construction and job-site examples
VisionMeshCapture may help with selected-area documentation and review:
capture local as-built context around a wall, floor, corner, ceiling, or opening;
document MEP routes such as pipes, ducts, trays, and conduits;
compare a loaded USDZ model with captured geometry for approximate fit and clearance;
capture before/after renovation snapshots;
prepare PLY/USDZ/CSV/JSON handoff packages for technical review.
Important: VisionMeshCapture is not a certified surveying instrument, not a construction sign-off system, not a safety inspection system, and not a regulatory measurement tool. Always validate geometry, scale, and alignment with approved professional tools.
Troubleshooting
Empty selection box
Press Start / Restart Providers.
Move the box onto a visible reconstructed surface.
Increase Capture Resolution and Face Budget.
Lower Minimum Triangle Area.
Enlarge the box.
Press Auto Tune.
Enterprise camera color not active
Press Refresh License.
Confirm the provisioning profile includes the approved entitlement.
Confirm Enterprise.license is bundled.
Confirm camera usage strings are present in Info.plist.
If still unavailable, fallback mesh/classification capture remains usable.
Export or share issues
Wait until the export progress says Export ready.
Use Save ZIP to Files first.
Prepare a new export package if needed.
Do not try to share from immersive HUD.

IMG_0737 3.PNG

Construction and job-site value


VisionMeshCapture may support construction and architecture workflows by helping users document selected site areas, compare imported USDZ models with captured surfaces, visualize approximate fit and clearance, and export structured mesh packages for review. Example use cases include:
as-built context capture of selected walls, floors, corners, openings, and fixtures;
local MEP route documentation around ducts, pipes, conduits, trays, or mechanical units;
renovation progress snapshots before demolition, after installation, or during punch-list review;
prefab and component placement visualization by loading a USDZ model at the capture-box center;
approximate fit or clearance review by aligning a loaded model to captured point-cloud data;
QA handoff packages containing PLY, USDZ, CSV, JSON, and manifest files for external inspection.
VisionMeshCapture is not a certified survey instrument, construction sign-off system, safety-critical inspection system, or regulatory measurement device. Geometry, scale, color, alignment, and exported data must be validated with approved professional tools before decisions.
Other potential uses

  • architecture and interior design review;


  • industrial maintenance and equipment documentation;


  • education and training for 3D scanning, mesh formats, and spatial computing;


  • research and prototyping for point-cloud registration and color/geometry analytics;


  • museum, exhibit, and retail layout testing;


  • robotics or spatial-AI dataset prototyping with appropriate privacy controls;


  • ergonomic or clinical-adjacent visualization under qualified professional review, without diagnostic use.


  • Important limitations

VisionMeshCapture is not a medical device and does not provide diagnosis, treatment recommendations, surgical planning, automated clinical decisions, safety certification, or regulatory construction approval. Any measurements, reconstructions, color samples, alignments, or exported files are intended for visualization, research, education, technical review, documentation support, and prototyping only.
Capture quality depends on device tracking, lighting, surface texture, reconstruction quality, camera availability, environmental conditions, and user-selected thresholds.

Download_on_the_App_Store_Badge_US-UK_135x40.png

What each major button does
Open Immersive Space
Opens the immersive Vision Pro scene where the yellow selection box, HUD, reconstructed mesh preview, imported models, and alignment result are visible.
Start / Restart Providers
Starts or restarts world tracking, scene reconstruction, and the available camera/color pipeline.
Recenter Box
Places the yellow capture box in front of the user. The HUD remains above the upper surface of the box and faces the user.
Refresh License
Checks whether approved enterprise main-camera access is available. If not available, the app remains usable in fallback mode.
Auto Tune
Automatically adjusts capture settings to reduce empty-box previews and keep useful reconstructed geometry.
Preview current thresholds
Shows candidate mesh faces using the current box size, position, rotation, and filters.
Prepare Capture
Stage 1: highlights the candidate captured mesh and shows diagnostics without finalizing export data.
Commit Capture
Stage 2: finalizes the captured mesh and creates export-ready PLY, USDZ, CSV, JSON, and manifest data.
Load Meshes
Imports supported 3D files. New models appear at the yellow center sphere.
Align Last Loaded
Aligns the latest loaded model to the captured point cloud using registration/refinement logic.
Prepare Export Package
Builds an export ZIP with captured and imported 3D files plus analytics tables and manifests.
Save ZIP to Files / Share ZIP / AirDrop
Exports the prepared ZIP from the window UI. The immersive HUD does not open system share dialogs.
Gesture map
Yellow center sphere: drag to move the box.
Transparent face handles: drag to resize one surface of the box.
Pinch: scale the active target.
Rx / Ry / Rz controls: rotate the active model or box with precision.
HUD sliders: tune capture filters in real time.
Recenter: place the box in front of the user again.
Construction and job-site examples
VisionMeshCapture may help with selected-area documentation and review:
capture local as-built context around a wall, floor, corner, ceiling, or opening;
document MEP routes such as pipes, ducts, trays, and conduits;
compare a loaded USDZ model with captured geometry for approximate fit and clearance;
capture before/after renovation snapshots;
prepare PLY/USDZ/CSV/JSON handoff packages for technical review.
Important: VisionMeshCapture is not a certified surveying instrument, not a construction sign-off system, not a safety inspection system, and not a regulatory measurement tool. Always validate geometry, scale, and alignment with approved professional tools.
Troubleshooting
Empty selection box
Press Start / Restart Providers.
Move the box onto a visible reconstructed surface.
Increase Capture Resolution and Face Budget.
Lower Minimum Triangle Area.
Enlarge the box.
Press Auto Tune.
Enterprise camera color not active
Press Refresh License.
Confirm the provisioning profile includes the approved entitlement.
Confirm Enterprise.license is bundled.
Confirm camera usage strings are present in Info.plist.
If still unavailable, fallback mesh/classification capture remains usable.
Export or share issues
Wait until the export progress says Export ready.
Use Save ZIP to Files first.
Prepare a new export package if needed.
Do not try to share from immersive HUD.
What to include in a support request
App version and build.
visionOS version.
Apple Vision Pro hardware model.
Screenshot of the HUD diagnostics.
Camera lamp status: green, orange, yellow, gray, or red.
Whether fallback mode was active.
Export log lines.
First Xcode console error block.
If safe, attach manifest.json from the export ZIP.


Privacy Policy: https://www.orthopractis.com/privacy

Terms of Use

Download_on_the_App_Store_Badge_US-UK_135x40.png
bottom of page