QUICK START
-----------
1. Open SurfaceScan and review the full-window data-handling notice.
2. Select the two full-row acknowledgements for data handling and subject permission.
3. Allow Camera or World Sensing access.
4. Tap or recenter to place the bright blue box over the intended surface.
5. Adjust position, rotation, width, height, and depth.
6. Select LIVE for editable blue-box capture or Lock for a fixed green protected scan.
7. Move slowly through overlapping views until points and triangles accumulate.
8. Adjust Capture Points, Capture Rate, Confidence, Mesh Resolution, Mesh Refresh, Fusion Stability, Surface Continuity, and Preview Smoothing.
9. Open Preview, select a format, then choose Save or Share.
10. For Apple Vision Pro paired mode, accept the every-launch disclosure on both Build 36 devices and grant Local Network access. Automatic discovery establishes an encrypted link, verifies the SurfaceScan roles/build/protocol, selects the iOS RGB-D source, applies settings once, and starts streaming. Apple transport membership is checked before every send; a stale peer’s queued work is cancelled before bounded recovery and fresh verification. Request Final before export; Stop, Disconnect, manual retry, and native fallback remain available.

GESTURE GUIDE
-------------
Platform | Gesture | Action
-------- | ------- | ------
iPhone/iPad | Tap | Place the box on measured depth, raycast, or feature fallback.
iPhone/iPad | One-finger drag | Move left, right, up, or down.
iPhone/iPad | Two-finger vertical drag | Move nearer or farther.
iPhone/iPad | Two-finger horizontal drag | Change box depth.
iPhone/iPad | Pinch / rotate | Resize / rotate the box.
visionOS native | Spatial drag / pinch / rotate | Move, resize, and rotate the world box.
visionOS paired | Remote controls | Recenter, capture, pause, lock, reset, request preview, and request final mesh on the iPhone/iPad camera.
Android | Tap / drag / pinch / two fingers | Place, move, resize, change distance/depth, and rotate.

CAPTURE MODES
-------------
- LIVE: captures continuously inside the editable blue box. Capture pauses during a gesture or size change, clears observations registered to the old volume, and restarts after the box settles.
- LOCKED: freezes the box transform and six clipping planes, turns the box green, and produces the protected mesh used for export.

QUALITY CONTROLS
----------------
- Capture Points controls how many RGB-D, spatial, binocular, or temporal multi-view observations can be accepted from each processed frame.
- Capture Rate controls how frequently eligible frames or scene updates enter fusion.
- Confidence controls depth, spatial, binocular, and temporal multi-view acceptance; higher values reject more uncertain observations.
- Mesh Resolution controls protected output spacing and bounded voxel, cell, and triangle limits without controlling camera cadence.
- Mesh Refresh controls how frequently the protected and presentation meshes are rebuilt from accumulated fusion voxels.
- Fusion Stability controls residual and repeated-observation thresholds plus isolated-surface cleanup.
- Surface Continuity independently controls the maximum accepted local depth jump between neighbouring surface cells.
- Preview Smoothing affects only the displayed presentation mesh and is capped at 2.5 mm. It does not alter exported protected coordinates.

FILE FORMATS AND TRANSFER
-------------------------
- Save opens the system file destination picker.
- Share opens AirDrop or the Apple share interface, or Android Sharesheet / Quick Share when available.
- Receiving apps decide whether they support a particular mesh format.

Format | Colour | Typical compatibility
------ | ------ | ---------------------
PLY | Per-vertex RGB | Mesh and scientific tools.
OBJ | Vertex RGB extension | General 3D tools that support coloured vertices.
STL | No | Geometry-only CAD/manufacturing workflows.
USDZ | RGB displayColor | Apple Quick Look, RealityKit, and USD workflows.

TROUBLESHOOTING
---------------
Box is visible but no points appear: Improve lighting, include textured surroundings, make the box intersect the surface, reduce depth, wait for tracking, and move slowly.
Points appear but no connected mesh: Collect more overlapping views, increase Mesh Resolution or Mesh Refresh moderately, and lower Fusion Stability only if observations remain coherent.
Tracking limited: Hold the device steady, avoid featureless close-up views, include surrounding texture, and allow relocalization.
Save or Share unavailable: Lock the box and wait until the protected mesh contains vertices and triangles. Close any other file presentation.
Receiving app cannot open STL/PLY/OBJ: Save to Files and open the file in a mesh application that declares support for that format. USDZ is usually the simplest Apple preview format.
Enterprise RGB unavailable: Verify the approved entitlement, App ID, profile, license, physical device, and authorization. Standard geometry fallback should remain visible.
Paired iPhone/iPad not found or reconnecting: Accept the every-launch disclosure on every device, grant Local Network permission, confirm the same Build 36 is installed, keep devices awake and nearby, enable Wi-Fi and Bluetooth, and avoid networks that isolate peer devices. SurfaceScan checks Apple transport membership before every send, cancels stale queued traffic, retries a still-known interrupted camera with bounded backoff, and requires fresh verification before resuming payloads.
Paired preview visible but export disabled: Pause capture and request Final. A live preview is intentionally not exportable; wait for final and complete-topology status.

PRIVACY AND RESPONSIBLE USE
---------------------------
- Capture and file creation are local to the device.
- A surface mesh can contain identifiable colour, contour, scar, or tattoo detail.
- Scan only with permission and avoid intimate regions or unnecessary facial capture.
- Protect exported files and share them only with intended recipients.
- Android uses Google Play Services for AR, which is provided by Google and governed by Google's Privacy Policy.

LINKS AND CONTACT
-----------------
Website: https://www.orthopractis.com
Support: https://www.orthopractis.com/surfacescan
Privacy Policy: https://www.orthopractis.com/privacy
Terms of Use: https://www.orthopractis.com/terms-of-use
Email: info@orthopractis.com
Google Privacy Policy: https://policies.google.com/privacy