SFML.Game.Framework.ContentBuilder
1.0.0
dotnet add package SFML.Game.Framework.ContentBuilder --version 1.0.0
NuGet\Install-Package SFML.Game.Framework.ContentBuilder -Version 1.0.0
<PackageReference Include="SFML.Game.Framework.ContentBuilder" Version="1.0.0" />
<PackageVersion Include="SFML.Game.Framework.ContentBuilder" Version="1.0.0" />
<PackageReference Include="SFML.Game.Framework.ContentBuilder" />
paket add SFML.Game.Framework.ContentBuilder --version 1.0.0
#r "nuget: SFML.Game.Framework.ContentBuilder, 1.0.0"
#:package SFML.Game.Framework.ContentBuilder@1.0.0
#addin nuget:?package=SFML.Game.Framework.ContentBuilder&version=1.0.0
#tool nuget:?package=SFML.Game.Framework.ContentBuilder&version=1.0.0
π¦ SFML.Game.Framework.ContentBuilder
SFML.Game.Framework.ContentBuilder is a lightweight asset packaging and loading system
designed to work seamlessly with SFML.Game.Framework.
It allows developers to bundle, compress, and efficiently load game assets using a single .as (ASSETBIN) file format β making your gameβs content pipeline faster, cleaner, and easier to manage.
π Overview
This tool is part of the SFML.Game.Framework ecosystem and provides two core components:
- Asset Builder (ContentBuilder) β Combines multiple assets (textures, sounds, fonts, etc.) into a single
.asbinary file. - Runtime Reader (ContentPipelineReader) β Efficiently reads and retrieves individual assets from the packaged file at runtime.
π The ASSETBIN Format (.as)
The .as (ASSETBIN) file is a custom binary format that stores multiple game assets in a compact structure.
π§± File Structure
Each .as file contains:
| Section | Description |
|----------|--------------|
| Header | "ASSETBIN" identifier and version byte |
| File Table | Asset names, lengths, and data offsets |
| Asset Data | The raw binary data for each asset |
This ensures fast lookup times and minimal I/O overhead when loading content at runtime.
βοΈ Features
π¦ ContentBuilder
- Combines multiple files (textures, sounds, shaders, etc.) into a single
.asfile. - Generates a compact binary table of contents for instant asset lookup.
- Reduces file I/O operations and loading time.
- Ideal for shipping games β prevents direct access to loose asset files.
- Cross-platform compatible (Windows / Linux / macOS).
π§ ContentPipelineReader
- Provides an API for reading assets from the
.asarchive. - Can load individual assets directly into memory as byte arrays.
- Includes validation and version checking.
- Integrates seamlessly with
SFML.Game.Framework.ContentManager.
// Load a .as content package
var content = new ContentPipelineReader("Assets/game_content.as");
// Retrieve a texture by name
byte[] textureBytes = content.GetByName("player");
// Convert to SFML texture
var texture = new Texture(textureBytes);
| Product | Versions Compatible and additional computed target framework versions. |
|---|---|
| .NET | net10.0-windows7.0 is compatible. |
-
net10.0-windows7.0
- SFML.Game.Framework (>= 1.0.0)
NuGet packages
This package is not used by any NuGet packages.
GitHub repositories
This package is not used by any popular GitHub repositories.
| Version | Downloads | Last Updated |
|---|---|---|
| 1.0.0 | 146 | 10/25/2025 |