# huzhiqian/mvision architecture

> Architecture diagram of the GitHub repository huzhiqian/mvision, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-01). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/huzhiqian/mvision
- Repository: https://github.com/huzhiqian/mvision

## Overview

MVision is a .NET wrapper around HALCON intended to simplify camera control and image handling. In the stable version, an application opens the acquisition settings UI, which configures a camera tool; the tool manages camera acquisition and exposes images and camera settings. The repository also contains image conversion, serialization, GigE access, and reusable controls. The graph emphasizes the stable version because its acquisition workflow is documented and sampled; many parameter and UI details are unsampled, so uncertain links are omitted.

Main entry points: [`稳定版/HalconMVision/Halcon.MVision.Core/HalAcqFifoTool.cs`](https://github.com/huzhiqian/mvision/blob/master/%E7%A8%B3%E5%AE%9A%E7%89%88/HalconMVision/Halcon.MVision.Core/HalAcqFifoTool.cs) (Acquisition Tool), [`稳定版/HalconCameraDLLTest/HalconCameraDLLTest/Form1.cs`](https://github.com/huzhiqian/mvision/blob/master/%E7%A8%B3%E5%AE%9A%E7%89%88/HalconCameraDLLTest/HalconCameraDLLTest/Form1.cs) (Demo Form), [`稳定版/HalconMVision/Halcon.MVision.Controls/HalAcqFifoEdit.cs`](https://github.com/huzhiqian/mvision/blob/master/%E7%A8%B3%E5%AE%9A%E7%89%88/HalconMVision/Halcon.MVision.Controls/HalAcqFifoEdit.cs) (Acquisition Editor), [`稳定版/HalconCameraDLLTest/HalconCameraDLLTest/AcqForm.cs`](https://github.com/huzhiqian/mvision/blob/master/%E7%A8%B3%E5%AE%9A%E7%89%88/HalconCameraDLLTest/HalconCameraDLLTest/AcqForm.cs) (Acquisition Form)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["Application"]
  node_operator(("Camera Operator"))
  node_mainform["Demo Form<br/>[Form1.cs]"]
  node_acqform["Acquisition Form<br/>[AcqForm.cs]"]
end

subgraph group_ui["Camera UI"]
  node_editor["Acquisition Editor<br/>[HalAcqFifoEdit.cs]"]
  node_widgets["Editor Widgets"]
end

subgraph group_acq["Acquisition"]
  node_fifo["Acquisition Tool<br/>[HalAcqFifoTool.cs]"]
  node_openinfo["Camera Open Info<br/>[HalAcqOpenInfo.cs]"]
  node_params["Camera Parameters"]
  node_gige["GigE Access<br/>[CHalGigEAccess.cs]"]
  node_halcon["HALCON SDK"]
end

subgraph group_imaging["Image Handling"]
  node_image["Image Wrapper<br/>[HalImage8Grey.cs]"]
  node_imageapi["Image Interface<br/>[IHalImage.cs]"]
  node_completion["Acquisition Event"]
end

subgraph group_shared["Shared Core"]
  node_serializer["Object Serializer<br/>[HalSerializer.cs]"]
  node_toolbase["Tool Base<br/>[HalToolBase.cs]"]
end

node_operator -->|"opens settings"| node_mainform
node_mainform -->|"shows dialog"| node_acqform
node_acqform -->|"assigns subject"| node_editor
node_editor -->|"configures and runs"| node_fifo
node_editor -.->|"uses controls"| node_widgets
node_fifo -->|"opens and grabs"| node_halcon
node_fifo -->|"creates open info"| node_openinfo
node_fifo -.->|"manages parameters"| node_params
node_fifo -->|"creates access"| node_gige
node_fifo -->|"wraps frames"| node_image
node_fifo -->|"raises completion"| node_completion
node_image -->|"implements"| node_imageapi
node_fifo -->|"inherits"| node_toolbase
node_mainform -->|"loads saved tool"| node_serializer

click node_mainform "https://github.com/huzhiqian/mvision/blob/master/%E7%A8%B3%E5%AE%9A%E7%89%88/HalconCameraDLLTest/HalconCameraDLLTest/Form1.cs"
click node_acqform "https://github.com/huzhiqian/mvision/blob/master/%E7%A8%B3%E5%AE%9A%E7%89%88/HalconCameraDLLTest/HalconCameraDLLTest/AcqForm.cs"
click node_editor "https://github.com/huzhiqian/mvision/blob/master/%E7%A8%B3%E5%AE%9A%E7%89%88/HalconMVision/Halcon.MVision.Controls/HalAcqFifoEdit.cs"
click node_widgets "https://github.com/huzhiqian/mvision/tree/master/%E7%A8%B3%E5%AE%9A%E7%89%88/HalconMVision/Halcon.MVision.Controls"
click node_fifo "https://github.com/huzhiqian/mvision/blob/master/%E7%A8%B3%E5%AE%9A%E7%89%88/HalconMVision/Halcon.MVision.Core/HalAcqFifoTool.cs"
click node_openinfo "https://github.com/huzhiqian/mvision/blob/master/%E7%A8%B3%E5%AE%9A%E7%89%88/HalconMVision/Halcon.MVision.Core/HalAcqOpenInfo.cs"
click node_params "https://github.com/huzhiqian/mvision/tree/master/%E7%A8%B3%E5%AE%9A%E7%89%88/HalconMVision/Halcon.MVision.Core/Implementation.Internal"
click node_gige "https://github.com/huzhiqian/mvision/blob/master/%E7%A8%B3%E5%AE%9A%E7%89%88/HalconMVision/Halcon.MVision.Core/Implementation.Internal/CHalGigEAccess.cs"
click node_image "https://github.com/huzhiqian/mvision/blob/master/%E7%A8%B3%E5%AE%9A%E7%89%88/HalconMVision/Halcon.MVision.Core/HalImage8Grey.cs"
click node_imageapi "https://github.com/huzhiqian/mvision/blob/master/%E7%A8%B3%E5%AE%9A%E7%89%88/HalconMVision/Halcon.MVision.Core/IHalImage.cs"
click node_completion "https://github.com/huzhiqian/mvision/blob/master/%E7%A8%B3%E5%AE%9A%E7%89%88/HalconMVision/Halcon.MVision.Core/HalCompleteEventArgs.cs"
click node_serializer "https://github.com/huzhiqian/mvision/blob/master/%E7%A8%B3%E5%AE%9A%E7%89%88/HalconMVision/Halcon.MVision.Core/HalSerializer.cs"
click node_toolbase "https://github.com/huzhiqian/mvision/blob/master/%E7%A8%B3%E5%AE%9A%E7%89%88/HalconMVision/Halcon.MVision.Core/HalToolBase.cs"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_operator,node_mainform,node_acqform toneBlue
class node_editor,node_widgets toneAmber
class node_fifo,node_openinfo,node_params,node_gige,node_halcon toneMint
class node_image,node_imageapi,node_completion toneRose
class node_serializer,node_toolbase toneIndigo
```

## Components

### Application

- **Camera Operator**
- [Demo Form](https://github.com/huzhiqian/mvision/blob/master/%E7%A8%B3%E5%AE%9A%E7%89%88/HalconCameraDLLTest/HalconCameraDLLTest/Form1.cs): `稳定版/HalconCameraDLLTest/HalconCameraDLLTest/Form1.cs`
- [Acquisition Form](https://github.com/huzhiqian/mvision/blob/master/%E7%A8%B3%E5%AE%9A%E7%89%88/HalconCameraDLLTest/HalconCameraDLLTest/AcqForm.cs): `稳定版/HalconCameraDLLTest/HalconCameraDLLTest/AcqForm.cs`

### Camera UI

- [Acquisition Editor](https://github.com/huzhiqian/mvision/blob/master/%E7%A8%B3%E5%AE%9A%E7%89%88/HalconMVision/Halcon.MVision.Controls/HalAcqFifoEdit.cs): `稳定版/HalconMVision/Halcon.MVision.Controls/HalAcqFifoEdit.cs`
- [Editor Widgets](https://github.com/huzhiqian/mvision/tree/master/%E7%A8%B3%E5%AE%9A%E7%89%88/HalconMVision/Halcon.MVision.Controls): `稳定版/HalconMVision/Halcon.MVision.Controls`

### Acquisition

- [Acquisition Tool](https://github.com/huzhiqian/mvision/blob/master/%E7%A8%B3%E5%AE%9A%E7%89%88/HalconMVision/Halcon.MVision.Core/HalAcqFifoTool.cs): `稳定版/HalconMVision/Halcon.MVision.Core/HalAcqFifoTool.cs`
- [Camera Open Info](https://github.com/huzhiqian/mvision/blob/master/%E7%A8%B3%E5%AE%9A%E7%89%88/HalconMVision/Halcon.MVision.Core/HalAcqOpenInfo.cs): `稳定版/HalconMVision/Halcon.MVision.Core/HalAcqOpenInfo.cs`
- [Camera Parameters](https://github.com/huzhiqian/mvision/tree/master/%E7%A8%B3%E5%AE%9A%E7%89%88/HalconMVision/Halcon.MVision.Core/Implementation.Internal): `稳定版/HalconMVision/Halcon.MVision.Core/Implementation.Internal`
- [GigE Access](https://github.com/huzhiqian/mvision/blob/master/%E7%A8%B3%E5%AE%9A%E7%89%88/HalconMVision/Halcon.MVision.Core/Implementation.Internal/CHalGigEAccess.cs): `稳定版/HalconMVision/Halcon.MVision.Core/Implementation.Internal/CHalGigEAccess.cs`
- **HALCON SDK**

### Image Handling

- [Image Wrapper](https://github.com/huzhiqian/mvision/blob/master/%E7%A8%B3%E5%AE%9A%E7%89%88/HalconMVision/Halcon.MVision.Core/HalImage8Grey.cs): `稳定版/HalconMVision/Halcon.MVision.Core/HalImage8Grey.cs`
- [Image Interface](https://github.com/huzhiqian/mvision/blob/master/%E7%A8%B3%E5%AE%9A%E7%89%88/HalconMVision/Halcon.MVision.Core/IHalImage.cs): `稳定版/HalconMVision/Halcon.MVision.Core/IHalImage.cs`
- [Acquisition Event](https://github.com/huzhiqian/mvision/blob/master/%E7%A8%B3%E5%AE%9A%E7%89%88/HalconMVision/Halcon.MVision.Core/HalCompleteEventArgs.cs): `稳定版/HalconMVision/Halcon.MVision.Core/HalCompleteEventArgs.cs`

### Shared Core

- [Object Serializer](https://github.com/huzhiqian/mvision/blob/master/%E7%A8%B3%E5%AE%9A%E7%89%88/HalconMVision/Halcon.MVision.Core/HalSerializer.cs): `稳定版/HalconMVision/Halcon.MVision.Core/HalSerializer.cs`
- [Tool Base](https://github.com/huzhiqian/mvision/blob/master/%E7%A8%B3%E5%AE%9A%E7%89%88/HalconMVision/Halcon.MVision.Core/HalToolBase.cs): `稳定版/HalconMVision/Halcon.MVision.Core/HalToolBase.cs`

## Connections

- Camera Operator → Demo Form: opens settings (evidence: `稳定版/HalconCameraDLLTest/HalconCameraDLLTest/Form1.cs`)
- Demo Form → Acquisition Form: shows dialog (evidence: `稳定版/HalconCameraDLLTest/HalconCameraDLLTest/Form1.cs`)
- Acquisition Form → Acquisition Editor: assigns subject (evidence: `稳定版/HalconCameraDLLTest/HalconCameraDLLTest/AcqForm.cs`)
- Acquisition Editor → Acquisition Tool: configures and runs (evidence: `稳定版/HalconMVision/Halcon.MVision.Controls/HalAcqFifoEdit.cs`)
- Acquisition Editor → Editor Widgets: uses controls
- Acquisition Tool → HALCON SDK: opens and grabs (evidence: `稳定版/HalconMVision/Halcon.MVision.Core/HalAcqFifoTool.cs`)
- Acquisition Tool → Camera Open Info: creates open info (evidence: `稳定版/HalconMVision/Halcon.MVision.Core/HalAcqFifoTool.cs`)
- Acquisition Tool → Camera Parameters: manages parameters
- Acquisition Tool → GigE Access: creates access (evidence: `稳定版/HalconMVision/Halcon.MVision.Core/HalAcqFifoTool.cs`)
- Acquisition Tool → Image Wrapper: wraps frames (evidence: `稳定版/HalconMVision/Halcon.MVision.Core/HalAcqFifoTool.cs`)
- Acquisition Tool → Acquisition Event: raises completion (evidence: `稳定版/HalconMVision/Halcon.MVision.Core/HalAcqFifoTool.cs`)
- Image Wrapper → Image Interface: implements (evidence: `稳定版/HalconMVision/Halcon.MVision.Core/HalImage8Grey.cs`)
- Acquisition Tool → Tool Base: inherits (evidence: `稳定版/HalconMVision/Halcon.MVision.Core/HalAcqFifoTool.cs`)
- Demo Form → Object Serializer: loads saved tool (evidence: `稳定版/HalconCameraDLLTest/HalconCameraDLLTest/Form1.cs`)
