BetterHexViewer.WinUI3 1.1.5

BetterHexViewer.WinUI3

BetterHexViewer.WinUI3 is a feature-rich, fully customisable hex-viewer control for Windows App SDK / WinUI 3 applications. All rendering is GPU-accelerated via Win2D (CanvasControl) — a single DrawingSession replaces thousands of XAML elements, delivering smooth scrolling even on 4K displays with files of any size.

Features

Requirements

Quick start

1 — Install the NuGet package

dotnet add package BetterHexViewer.WinUI3

2 — Add the XAML namespace

xmlns:hex="using:BetterHexViewer.WinUI3"

3 — Place the control

<hex:BetterHexViewer
    x:Name="HexViewer"
    OffsetFormat="Hexadecimal"
    ColumnGroupSize="One"
    BytesSpacing="10"
    ExtraLineGap="4"
    FullWidth="False"
    ShowAsciiPanel="True"
    SelectionChanged="HexViewer_SelectionChanged"/>

4 — Load content

// From a file (any size — uses MemoryMappedFile)
await HexViewer.OpenFileAsync(filePath);

// From a byte array
HexViewer.LoadBytes(myByteArray);

5 — Search

// Text search (forward)
var result = await HexViewer.SearchAsync("MZ");

// Byte-sequence search
var result = await HexViewer.SearchAsync(new byte[] { 0x4D, 0x5A });

// Navigate results
await HexViewer.SearchNextAsync();
await HexViewer.SearchPreviousAsync();

// Find all occurrences
IReadOnlyList<long> offsets = await HexViewer.FindAllAsync("MZ");

6 — Programmatic selection

// Select 16 bytes starting at offset 0x100
HexViewer.SelectRange(0x100, 16);

// Select from offset 0x200 to 0x2FF (inclusive)
HexViewer.SelectFromTo(0x200, 0x2FF);

7 — Change ASCII encoding

// Enable extended code pages (call once at app startup)
Encoding.RegisterProvider(CodePagesEncodingProvider.Instance);

HexViewer.AsciiEncoding = Encoding.GetEncoding(437); // IBM CP437
HexViewer.AsciiEncoding = Encoding.UTF8;

Properties

Layout and display

Font

Colours

Methods

Events

// Fired when the selection changes
HexViewer.SelectionChanged += (sender, e) =>
{
    long   offset = e.StartOffset; // -1 when no selection
    long   length = e.Length;
    byte[] data   = e.Data;        // full copy, no size cap
};

// Fired after each SearchAsync / SearchNextAsync / SearchPreviousAsync
HexViewer.SearchResultFound += (sender, result) =>
{
    bool found   = result.Found;
    long offset  = result.Offset;  // -1 when not found
    long length  = result.Length;
    bool wrapped = result.Wrapped;
};

Enumerations

public enum OffsetFormat    { Hexadecimal, Decimal, Octal }
public enum ColumnGroupSize { One = 1, Two = 2, Four = 4, Eight = 8, Sixteen = 16 }

Building from source

git clone https://github.com/zipgenius/BetterHexViewer_WinUI3.git
cd BetterHexViewer.WinUI3
dotnet restore
dotnet build -c Release -p:Platform=x64

Run the demo:

dotnet run --project BetterHexViewer.Demo -c Debug -p:Platform=x64

Create a NuGet package:

dotnet pack BetterHexViewer.WinUI3/BetterHexViewer.WinUI3.csproj -c Release -p:Platform=x64 -o nupkg

Changelog

See CHANGELOG.md.

License

MIT © zipgenius.it — see LICENSE.