KevInc.Texture.Ckd 0.1.1

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

TextureConverter is included as a command-line texture conversion tool and as integration coverage for the libraries.

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);

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 TextureConverter integration.

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.