Devinno.Vision.UI 0.1.1

dotnet add package Devinno.Vision.UI --version 0.1.1
                    
NuGet\Install-Package Devinno.Vision.UI -Version 0.1.1
                    
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="Devinno.Vision.UI" Version="0.1.1" />
                    
For projects that support PackageReference, copy this XML node into the project file to reference the package.
<PackageVersion Include="Devinno.Vision.UI" Version="0.1.1" />
                    
Directory.Packages.props
<PackageReference Include="Devinno.Vision.UI" />
                    
Project file
For projects that support Central Package Management (CPM), copy this XML node into the solution Directory.Packages.props file to version the package.
paket add Devinno.Vision.UI --version 0.1.1
                    
#r "nuget: Devinno.Vision.UI, 0.1.1"
                    
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.
#:package Devinno.Vision.UI@0.1.1
                    
#:package directive can be used in C# file-based apps starting in .NET 10 preview 4. Copy this into a .cs file before any lines of code to reference the package.
#addin nuget:?package=Devinno.Vision.UI&version=0.1.1
                    
Install as a Cake Addin
#tool nuget:?package=Devinno.Vision.UI&version=0.1.1
                    
Install as a Cake Tool

Devinno.Vision

English | 한국어

A .NET 9 vision inspection library on OpenCvSharp4, with a teaching tool (Devinno.Vision.Studio).

One image goes into one job (a list of steps) and comes out as one result: OK / NG / Error, NG codes, measured values and overlays. An inspection is either made in Studio and loaded as a recipe, or written in C# as steps.

  • Images are released automatically inside a run, and coordinates are tracked back to the original image.
  • ROIs follow the part (alignment pose).
  • A run does not throw for inspection problems: they come out as NG or Error in the result.
  • Steps have timeouts; a part that was not inspected does not come out OK.
  • A small toolkit: blobs, brightness, caliper, round-part alignment, difference against good parts.
  • ONNX models on CPU (ONNX Runtime): anomaly detection from good parts, defect classifier.

This is the first version. The API may change.

Packages

Package What it is
Devinno.Vision The library: images, jobs, results, recipes, toolkit, camera interface, image-folder and RTSP cameras
Devinno.Vision.UI DvVisionView: shows a result (image, overlays, judgment) on a Devinno.UI screen and lets the operator drag a ROI
Devinno.Vision.FlashCap FlashCapCamera: USB (UVC) cameras, based on FlashCap

Devinno.Vision.Studio is an app, not a package. It is in this repository (see Studio).

Install

Devinno.Vision brings OpenCvSharp4 and Microsoft.ML.OnnxRuntime. Add the OpenCV native runtime package yourself, with the same version as the OpenCvSharp4 package that Devinno.Vision references. On Windows:

<ItemGroup>
  <PackageReference Include="Devinno.Vision" Version="0.1.1" />
  <PackageReference Include="OpenCvSharp4.runtime.win" Version="4.13.0.20261107" />
</ItemGroup>

Without it the first image call fails with an exception that names OpenCvSharpExtern. Other platforms have their own OpenCvSharp4.runtime.* packages; they are not verified with this library.

Run a recipe

A recipe is what Studio saves: a folder with studio.json, or one .dvpkg package file.

using Devinno.Vision;

using var recipe = VisionRecipe.Load(@"C:\recipes\plate");   // a folder with studio.json, or a .dvpkg file
var job = recipe.CreateJob();                                    // make it once, run it many times

using var img = VisionImage.Load(@"C:\images\part01.bmp");
using var r = await job.RunAsync(img);

switch (r.State)
{
    case VisionState.Ok:    /* accept */ break;
    case VisionState.Ng:    Console.WriteLine(string.Join(", ", r.Codes)); break;   // "HOLE, LENGTH"
    case VisionState.Error: Console.WriteLine(r.Error); break;                       // could not inspect
}
foreach (var v in r.Values)
    Console.WriteLine($"{v.Name} = {v.Value:0.##} {v.Unit} ({(v.Ok ? "OK" : v.Code)})");

Write an inspection in C#

The same kind of inspection without Studio: a job is a list of steps, and each step looks at its ROI, draws what it found and records a value with limits.

using Devinno.Vision;

var job = new VisionJob("plate")
    .Add("align", pose: "body", ctx =>
    {
        var part = Blob.Find(ctx.Image, minArea: 20000).FirstOrDefault();
        if (part is null) { ctx.Fail("part not found"); return; }
        ctx.SetPose(VisionPose.FromBlob(part), reference: new VisionPose(319.1, 240.7, -2.3));   // reference = the pose on the base image
    })
    .Add("left hole", roi: () => VisionRoi.Rect(138, 130, 60, 60), ctx =>
    {
        var holes = Blob.Find(ctx.Image, ThresholdMode.Fixed, threshold: 80, invert: true, minArea: 300);
        ctx.Draw(holes);
        ctx.Value("left holes", holes.Length, min: 1, max: 1, code: "HOLE");
    })
    .Add("length", roi: () => VisionRoi.Rect(100, 180, 440, 12), ctx =>
    {
        var e = Edge.Caliper(ctx.Image, EdgePolarity.BrightObject, minContrast: 8);
        ctx.Draw(e);
        ctx.Value("length", e.Distance, nominal: 400, plus: 5, minus: 5, code: "LENGTH", unit: "px");
    });

using var img = VisionImage.Load(path);
using var r = await job.RunAsync(img);

Studio

Devinno.Vision.Studio is the teaching tool: a Windows app (built with Devinno.UI) for making an inspection without writing code, checking it against labelled images and packing it for the line.

Studio, test page: 40 labelled images, all judged correctly

Studio, edit page: checks, ROIs on the base image and measured values

The part in the screenshots is a synthetic sample (a generated stamped plate), not a real product.

  • Edit: set the base image, add checks (blob alignment, blob count, pixel count, brightness, width/length, ONNX), drag each ROI on the image and run to see the overlays and values.
  • Good-part model: point at a folder of good images and train an anomaly model. No Python needed.
  • Defect model: train a classifier from folders of defect images (in a Python environment with PyTorch that Studio sets up), or import an existing .onnx.
  • Test: run the logic on folders of labelled images, see the correct rate per label and step through the wrong ones.
  • Virtual camera: stream a test folder over RTSP with a Modbus TCP trigger, to try the line program without a camera.
  • Package: write the logic as one .dvpkg file. The line program opens it with VisionRecipe.Load.
  • MCP: every command is also an MCP tool, at http://127.0.0.1:5199/mcp (this PC only) while Studio runs. An AI tool can build and test an inspection and look at the result images.
  • The screen is in Korean or English.

Download the zip from the releases (tags studio-v…; Windows x64), unzip it and run Devinno.Vision.Studio.exe. It needs the .NET 9 SDK, or the .NET 9 Desktop Runtime and the ASP.NET Core Runtime 9. The zip has an llms.txt for AI tools (how to connect over MCP). Or run it from the repository:

dotnet run --project src/Devinno.Vision.Studio

Studio and the NuGet packages are versioned and released separately. Optional files that are in neither the repository nor the zip: the feature model for the good-part model (tools/models/features.onnx, made with tools/export_features.py) and MediaMTX for the virtual camera (tools/mediamtx/).

Documentation

These documents ship in the package's docs/ folder.

  • llms.txt: the entry point (question → page)
  • llm-rules.md: rules, project setup, minimal examples, symptom → cause → fix. Read this first.
  • vision-recipe.md: recipes, results, packages, good-part model
  • vision-jobs.md: jobs, steps, ROI and pose, judging, images
  • vision-toolkit.md: toolkit, ONNX, cameras
  • C# API: the IntelliSense XML in the package (English, and Korean under ko/)

Documentation for AI tools

When a project that references Devinno.Vision is built, the package documents and the English IntelliSense XML are copied to .devinno/Devinno.Vision/ in the project folder, where AI coding tools can find them.

  • Add this line to your AI instruction file (CLAUDE.md, AGENTS.md, etc.): Devinno library docs: read .devinno/*/llms.txt first.
  • To turn the copy off: <DevinnoCopyDocs>false</DevinnoCopyDocs> in the project file.
  • Adding .devinno/ to .gitignore is recommended (it is recreated on every build).

Repository (repository only)

Path Description
src/Devinno.Vision Core library
src/Devinno.Vision.UI Result view for Devinno.UI (DvVisionView)
src/Devinno.Vision.FlashCap USB camera driver (FlashCapCamera)
src/Devinno.Vision.Studio Teaching tool (WinForms host, Devinno.UI screens, MCP server)
tests/ xUnit tests for the library and for Studio
tools/ Scripts for the feature model and defect training; the Korean IntelliSense check
i18n/ko Korean IntelliSense XML

Disclaimer

Devinno.Vision is provided "as is", without warranty of any kind (see LICENSE).

An inspection result depends on the images, lighting, limits and models you set up. The library does not guarantee that a defective part is judged NG or that a good part is judged OK, and it is not designed or certified for safety functions. You are responsible for testing and validating any inspection you build with it, with enough good and defective samples from your own line.

License

MIT

Product Compatible and additional computed target framework versions.
.NET net9.0 is compatible.  net9.0-android was computed.  net9.0-browser was computed.  net9.0-ios was computed.  net9.0-maccatalyst was computed.  net9.0-macos was computed.  net9.0-tvos was computed.  net9.0-windows was computed.  net10.0 was computed.  net10.0-android was computed.  net10.0-browser was computed.  net10.0-ios was computed.  net10.0-maccatalyst was computed.  net10.0-macos was computed.  net10.0-tvos was computed.  net10.0-windows was computed. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

NuGet packages

This package is not used by any NuGet packages.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last Updated
0.1.1 0 11/17/2026
0.1.0 0 11/17/2026