Novolis.Rendering.Planar
2026.1.1.82
dotnet add package Novolis.Rendering.Planar --version 2026.1.1.82
NuGet\Install-Package Novolis.Rendering.Planar -Version 2026.1.1.82
<PackageReference Include="Novolis.Rendering.Planar" Version="2026.1.1.82" />
<PackageVersion Include="Novolis.Rendering.Planar" Version="2026.1.1.82" />
<PackageReference Include="Novolis.Rendering.Planar" />
paket add Novolis.Rendering.Planar --version 2026.1.1.82
#r "nuget: Novolis.Rendering.Planar, 2026.1.1.82"
#:package Novolis.Rendering.Planar@2026.1.1.82
#addin nuget:?package=Novolis.Rendering.Planar&version=2026.1.1.82
#tool nuget:?package=Novolis.Rendering.Planar&version=2026.1.1.82
Novolis.Rendering.Planar
Host-neutral 2D scene model for orthographic platformers (Mario-style): backgrounds, sprite animation, static polygons with colliders, HUD, and menus.
Install
dotnet add package Novolis.Rendering.Planar
Prerequisites: .NET 10 SDK (net10.0).
Quick start
var scene = new PlanarScene();
var texture = scene.Textures.Register(pixels, width, height, "hero.png");
var sheet = PlanarScenePrimitives.CreateSpriteSheet(scene, texture, 32, 32);
var run = PlanarAnimationClip.FromRow(sheet, row: 0, startColumn: 0, count: 4);
scene.AnimatedSprites.Add(new PlanarAnimatedSprite { Clip = run, Transform = { Position = Vector3PlanarExtensions.Xz(4, 2) } });
scene.AddPlatform(0, 0, 20, 1, Rgba32.Chartreuse);
scene.Hud.AddText("MARIO 000000", screenX: 16, screenY: 16);
scene.Menus.Push(new PlanarMenuScreen("SUPER NOVOLIS", [
new PlanarMenuItem("1 PLAYER", tag: "start"),
new PlanarMenuItem("OPTIONS", tag: "options"),
]));
Draw by tessellating into Math and submitting through a Silk host:
using Novolis.Rendering.Planar;
using Novolis.Silk;
var scene = new PlanarScene();
SilkGame.Run("Platformer", 800, 600, frame =>
{
scene.Update(frame.DeltaSeconds);
frame.Submit(scene.Tessellate(frame.Width, frame.Height));
});
Packages
| Package | Role |
|---|---|
Novolis.Rendering.Planar |
Scene, collision, HUD, menus, tessellate to PlanarDrawList |
Novolis.Silk |
GLFW / OpenGL host (Submit / Blit) — compose in apps and labs |
In-memory layered grids (tests / debug)
Rasterize a scene to per-layer DenseGrid<Rgba32> without a GPU:
var grids = scene.ToLayeredGrids(PlanarGridRasterOptions.WorldCells(
cellSize: 1f,
worldBounds: new PlanarWorldBounds(0f, 0f, 40f, 40f)));
var ascii = grids.ToAscii(PlanarDrawLayer.World);
var merged = grids.CompositedToAscii();
| Mode | Cell meaning |
|---|---|
WorldCells |
One cell per world XZ slab (CellSize world units) |
ScreenPixels |
One cell per framebuffer pixel |
Layers: Background, World, Foreground, Hud, Menu, plus Composited in draw order.
Conventions
- World space uses BCL
Vector3on the XZ plane (Y = 0). - Screen-space HUD/menu uses pixel coordinates (origin top-left).
- Textures are registered in
PlanarTextureRegistry; PNG loading is provided by the Silk backend.
| Product | Versions Compatible and additional computed target framework versions. |
|---|---|
| .NET | net10.0 is compatible. 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. |
-
net10.0
- Novolis.Math.Arrays (>= 2026.1.1.58)
- Novolis.Math.Geometry (>= 2026.1.1.58)
- Novolis.Math.Topology (>= 2026.1.1.58)
- StbImageSharp (>= 2.30.16)
NuGet packages (2)
Showing the top 2 NuGet packages that depend on Novolis.Rendering.Planar:
| Package | Downloads |
|---|---|
|
Novolis.Avalonia.Rendering
Avalonia hosts for Novolis.Rendering.Planar (OpenGL) and CPU RGBA frames. |
|
|
Novolis.Game.Scenes
Host-agnostic game scene helpers over Rendering. Games take this plus a host (Silk, Avalonia, MAUI, Web). |
GitHub repositories
This package is not used by any popular GitHub repositories.
| Version | Downloads | Last Updated |
|---|---|---|
| 2026.1.1.82 | 66 | 10/12/2026 |
| 2026.1.1.80 | 39 | 10/12/2026 |
| 2026.1.1.79 | 45 | 10/12/2026 |
| 2026.1.1.78 | 60 | 10/11/2026 |