MxPlot.UI.Avalonia 0.4.0

MxPlot.UI.Avalonia

Cross-platform UI layer for the MxPlot Ecosystem — built on Avalonia UI.

💡 Recommendation Most users should install the MxPlot metapackage, which bundles this UI layer together with the core engine and I/O extensions.

📦 About this Package

MxPlot.UI.Avalonia provides a fully featured, cross-platform visualization layer on top of MxPlot.Core. It runs on Windows, macOS, and Linux via Avalonia UI and requires no WinForms or WPF dependency.

Key Components

🚀 Quick Start

1. Install

dotnet add package MxPlot

Or reference MxPlot.UI.Avalonia directly if you only need the UI layer.

2. Show a matrix in one line

using MxPlot.Core;
using MxPlot.UI.Avalonia.Views;

// Create a 512×512 float matrix and fill with your data
var data = new MatrixData<float>(512, 512);
// ... populate data.GetInternalArray(0) here ...

// Open a standalone viewer window
MatrixPlotter.Create(data, title: "My Data").Show();

3. Open from a file (with a format extension)

using MxPlot.Core;
using MxPlot.Extensions.Tiff;        // MxPlot.Extensions.Tiff NuGet
using MxPlot.UI.Avalonia.Views;

var format = new OmeTiffFormat();
var data = MatrixData.Load("image.ome.tif", format);
MatrixPlotter.Create(data, title: "image.ome.tif").Show();

4. Link two plotters (shared data, synchronized refresh)

var parent = MatrixPlotter.Create(originalData, title: "Original");
var child  = parent.CreateLinked(filteredData, title: "Filtered");
parent.Show();
child.Show();
// Calling parent.Refresh() or child.Refresh() updates both windows.

🎨 Overlay System

Built-in (right-click context menu)

MatrixPlotter provides built-in overlay tools accessible from the right-click context menu on the image surface — no code required:

• Line — draws a line; right-click → Plot Profile opens a live ProfilePlotter window
• Rectangle / Oval / Targeting — region shapes; right-click → Show Statistics displays Min/Max/Mean
• Text — free text annotation
• All shapes support drag-move, handle-resize, snap modes, and a pen/color editor via double-click

Programmatic creation

using MxPlot.UI.Avalonia.Overlays.Shapes;

// Add a line overlay
var line = new LineObject(new Point(10, 10), new Point(200, 150));
plotter.MainView.OverlayManager.Add(line);

// Add a rectangular ROI
var roi = new RectObject(new Point(50, 50), 100, 80);
plotter.MainView.OverlayManager.Add(roi);

🔗 Using MxPlot.UI.Avalonia from WinForms or WPF

Embedding Avalonia UI controls inside a WinForms or WPF host requires additional setup. Please refer to the integration guide in the repository:

👉 Non-Avalonia Integration Guide (documentation in progress)

🖥️ Requirements

📚 Documentation & Source

👉 GitHub Repository: u1bx0/MxPlot

📊 Version History

For the complete changelog, please visit the Releases Page on GitHub.