OpenVisionLab 3D Studio

Build, teach, validate, and replay rule-based 3D inspection recipes on Windows

OpenVisionLab 3D Studio is a local desktop workbench for repeatable, rule-based 3D inspection. An operator can load height, mesh, or point-cloud data; check source quality; teach measurement regions; set explicit limits; preview the selected step; run a complete recipe; and review the resulting metrics, overlays, and records in one application.

Start here

Choose the path that matches what you have:

• Self-contained Windows package: extract the folder, run OpenVisionLab.ThreeD.Shell.exe, and follow the package README.md. The package includes its .NET runtime; no developer utilities are required.
• GitHub source clone: install the source-build prerequisites, clone this repository, build it, and launch the Shell using the commands below.

For a guided first inspection, see the user tutorial.

What the operator workflow looks like

flowchart LR
    Source["Open 3D data"] --> Quality["Review source quality"]
    Quality --> Tool["Add or select an inspection step"]
    Tool --> Teach["Teach ROI and parameters"]
    Teach --> Preview["Preview selected step"]
    Preview --> Publish["Publish accepted preview"]
    Publish --> Run["Run complete recipe"]
    Run --> Evidence["Review metrics, overlays, and records"]
    Evidence --> Save["Save and reopen the recipe"]

Loading

Preview, Publish, Run, and validation are explicit actions. Editing a parameter, changing Viewer visibility, or reopening saved setup does not run an inspection automatically.

Source Quality also provides one explicit acquisition/source contract editor. Record whether acquisition evidence is available, the evidence and known limitations, and—when supplied—the source-frame Sensor → scene XYZ direction. Then choose Apply source contract. The normalized direction can classify existing edge normals for display, but it does not change matching or infer a camera pose, calibration, or viewpoint from geometry.

Included Thickness Coupon tutorial data

The repository and the self-contained package include a ready-to-run Thickness Coupon with eight independently inspectable pads.

Item	Included value
Height grid	1280 × 840
Layout	Eight pads in a 4 × 2 arrangement
Recipe	Eight Thickness steps with 16 editable ROIs
ROI contract	Reference and Measurement ROI remain on the same visible pad
Declared unit	raw-height

Open this recipe from Recipe Center → Open existing recipe:

3D\Samples\ThicknessCouponV1\inspection-recipe.ov3d-recipe.json

The recipe keeps its C3D input beside the recipe file, so the complete example works after cloning or moving the whole package folder.

Supported inspection work

Area	Current workflow
Input review	C3D height data, glTF/GLB, STL, LAS, and LAZ loading with visible source-quality evidence plus explicit available/unavailable acquisition provenance, limitations, and optional source-frame sensor-to-scene direction
Height inspection	Thickness, Warpage, Plane Flatness, Height Deviation, Gap/Flush, Volume, and grid/region statistics
Geometry inspection	Point-pair and cross-section measurements, lines, planes, edges, landmarks, nominal/actual mesh comparison, and deterministic surface matching
Teaching	Linked 3D and full-resolution Height Image ROI editing with explicit Review, Apply, Cancel, and Delete actions
Validation	Good, Bad, and Held-out sample roles; run results; failure analysis; threshold review; and held-out replay
Evidence	Viewer overlays, metrics, reports, output comparison, retained match review, and headless Runner records
Recipe lifecycle	Save and restore ordered steps, inputs, parameters, ROI roles, outputs, and validation setup

Measurements use the unit declared by the source. A raw-height result is not automatically a calibrated physical measurement. Apply and verify the correct calibration and acceptance limits before using physical tolerances.

Build and run from a fresh clone

Prerequisites

• Windows 10 build 19041 or later, or Windows 11, on x64
• OpenGL-compatible GPU with a current vendor driver
• Git
• Windows PowerShell 5.1 or later
• .NET 10 SDK 10.0.300 or later in the .NET 10 line

Python 3.13 is required only for the repository's full independent verification suite, not for a normal source build or application launch.

Check the current machine without changing it:

powershell -NoProfile -ExecutionPolicy Bypass -File scripts\setup-development-environment.ps1 -CheckOnly -Scope Build

Install only missing build utilities by their fixed winget package IDs:

powershell -NoProfile -ExecutionPolicy Bypass -File scripts\setup-development-environment.ps1 -InstallMissing -Scope Build

Clone to a short local path to avoid Windows and NuGet path-length failures:

cd C:\src
git clone https://github.com/Noah8218/OpenVisionLab-3D-Studio.git
cd OpenVisionLab-3D-Studio
dotnet restore OpenVisionLab.ThreeDStudio.sln
dotnet build OpenVisionLab.ThreeDStudio.sln -c Release -p:Platform="Any CPU"
dotnet run --no-build --project src\OpenVisionLab.ThreeD.Shell\OpenVisionLab.ThreeD.Shell.csproj -c Release

The repository contains the vendored OpenVisionLab.Vision3D and WPF PropertyGrid packages required by the solution. A separate OpenVisionLab-Vision-SDK checkout is not required to build or run this project.

See system requirements and setup for full verification utilities, exact package IDs, short NuGet-cache guidance, and post-reinstall recovery.

Create the self-contained Windows package

From a source clone:

powershell -NoProfile -ExecutionPolicy Bypass -File scripts\publish-windows-app.ps1

The default output is artifacts\release\openvisionlab-3d-studio-win-x64. It is a folder-based, self-contained win-x64 package with the application, samples, recipes, operator documentation, license notices, and a SHA-256 manifest.

The package quick-start source is available at Windows package quick start.

Keyboard shortcuts

Shortcut	Action
Ctrl+N	New recipe
Ctrl+O	Open recipe
Ctrl+Shift+O	Open C3D height input
Ctrl+S	Save recipe
Ctrl+Shift+S	Save recipe as
F5	Preview the selected step
Ctrl+F5	Run the complete recipe
Enter	Apply the current ROI candidate
Esc	Cancel the current ROI candidate
Delete	Delete the selected supported ROI or recipe item

Documentation

• Documentation map
• User tutorial
• System requirements and setup
• Development and verification guide
• Changelog
• Release and version policy
• Acquisition/source provenance contract
• Acquisition direction and edge orientation
• Sample data and attribution
• Product direction and master backlog
• Code rules

License and attribution

OpenVisionLab 3D Studio is licensed under the Apache License 2.0. Commercial use, modification, and redistribution are permitted under its terms. Distributions must retain the LICENSE, NOTICE, copyright, and required attribution notices. Third-party components remain subject to their respective licenses.

This project includes software developed by Noah Choi.
Copyright (c) 2026 Noah Choi.