Broiler.Native.Windows 0.1.0-preview.7

Broiler.Native

Shared native API bindings for Broiler.Graphics, Broiler.Input, and Broiler.Media. The component owns native entry points, ABI structures, constants, COM contracts, function delegates, and library probing. It has no dependency on those consumers.

Packages

All projects target net10.0 and are annotated with <IsAotCompatible>true</IsAotCompatible>. A reference to a platform package does not eagerly load its native libraries; call platform APIs only on a compatible host with the required libraries installed.

Quickstart for Consumers

Install packages via NuGet:

dotnet add package Broiler.Native.Windows
# or for multi-platform projects:
dotnet add package Broiler.Native.All

Probing Library Availability

using Broiler.Native;

if (OperatingSystem.IsWindows() && NativeLibraryProbe.IsAvailable("d2d1.dll"))
{
    // Direct2D is available
}

High-Precision Timing

using Broiler.Native.Windows;

PerformanceCounterNative.QueryPerformanceFrequency(out long frequency);
PerformanceCounterNative.QueryPerformanceCounter(out long start);
// ... work ...
PerformanceCounterNative.QueryPerformanceCounter(out long end);
double elapsedSeconds = (double)(end - start) / frequency;

For complete consumer documentation, platform requirements, and detailed subsystem examples, see the End-User and Consumer Guide.

Developer Quickstart

Requires the .NET 10 SDK, Node.js 24, and PowerShell 7 (or Windows PowerShell).

# Build solution
dotnet build Broiler.Native.slnx -c Release

# Run test suite
dotnet run --project src/tests/Broiler.Native.Tests -c Release --no-build
# or: bash ./eng/run-tests.sh Release

# Test version resolution engine
node --test eng/resolve-preview-version.test.mjs

# Pack and verify shipping packages locally
pwsh -File eng/pack.ps1 -Configuration Release

# Verify consumer restoration against NuGet.org
pwsh -File eng/verify-feed.ps1 -Packages artifacts

For guidelines on authoring bindings, COM interfaces under NativeAOT, struct layout verification, and release workflows, see the Developer and Contributor Guide.

Documentation Index

• End-User and Consumer Guide: Package selection, host prerequisites, probing patterns, subsystem guides, and code examples.
• Developer and Contributor Guide: Architecture scope, development setup, building, testing, binding conventions, and packaging.
• CI, Packages, and Releases: Preview version calculation, feed rules, packaging validation, and NuGet.org release workflow.
• Architecture Decision Record: 0001 Native API Ownership: Decision context and rationale for native API extraction.
• Native API Extraction Inventory: Mapping of extracted types from legacy sibling components.
• Roadmap: Current implementation status and milestones.

License

Licensed under Apache-2.0.