KevInc.CrnLib 0.1.3

KevInc.Texture

KevInc.Texture provides .NET libraries for reading, writing, swizzling, and adapting game texture data. The package family is dependency-conscious: low-level wrapper and platform packages stay free of ImageSharp, while ImageSharp integration lives in opt-in packages.

Packages

Install

dotnet add package KevInc.Texture
dotnet add package KevInc.Texture.Ckd
dotnet add package KevInc.Texture.Nintendo
dotnet add package KevInc.Texture.Xbox

Use ImageSharp packages only when you want to work directly with Image<TPixel>:

dotnet add package KevInc.Texture.ImageSharp
dotnet add package KevInc.Texture.Nintendo.ImageSharp
dotnet add package KevInc.Texture.Xbox.ImageSharp

Examples

Decode a raw BGRA texture into ImageSharp:

using KevInc.Texture;
using KevInc.Texture.ImageSharp;

RawTexture texture = new(width, height, TextureFormat.BGRA32, data);
using Image<Rgba32> image = TextureImageSharpCodec.Decode(texture);

Decode an Xbox 360 texture stream:

using KevInc.Texture.Xbox.ImageSharp;

await using FileStream input = File.OpenRead("texture.x360");
using Image<Rgba32> image = Xbox360ImageSharpTextureCodec.Decode(input);

Decode a Nintendo Switch swizzled payload:

using KevInc.Texture;
using KevInc.Texture.Nintendo.ImageSharp;

using Image<Rgba32> image = NintendoSwitchImageSharpTextureCodec.DecodeSwizzled(
    swizzledData,
    width,
    height,
    TextureFormat.RGBA32,
    blockHeightLog2);

Register the ImageSharp decoders for DDS, Wii SSD, Wii U GTX, Switch XTX, and Xbox 360 texture streams:

using KevInc.Texture.ImageSharp;
using KevInc.Texture.Nintendo.ImageSharp;
using KevInc.Texture.Xbox.ImageSharp;

TextureImageSharpConfiguration.RegisterDdsFormat();
NintendoImageSharpConfiguration.RegisterTextureFormats();
Xbox360ImageSharpConfiguration.RegisterTextureFormat();

Build And Test

./run.ps1

Create local NuGet packages:

./run.ps1 -Configuration Release -Pack

Packages are written to artifacts/packages.

Publishing

See PUBLISHING.md for the GitHub, NuGet API key, release tag, and post-publish smoke-test checklist.

Test Coverage

The test suite covers wrapper handling, Nintendo swizzling, Xbox texture headers, ImageSharp adapters, dependency boundaries, CRN support, and game texture container round-trips.

Versioning

The repository uses Nerdbank.GitVersioning. Package versions come from version.json and Git metadata.

License

This repository is licensed under GPL-3.0-only unless a package explicitly states otherwise.