Ember

Media Byte Reader

Usage

1. Add to build.zig.zon:

.{
    .dependencies = .{
        .ember = .{
            .url = "https://github.com/eyzi/ember/archive/2b83332d5bc5ab259d3064c25e6b90eded9f3dad.tar.gz",
            .hash = "12202221a4415efd2186a651add316c5247d2ecc6dbac55e43a30658c833075dabe1",
        },
    },
}

2. Add module to your exe in build.zig

const ember_dep = b.dependency("ember", .{
    .target = target,
    .optimize = optimize,
});
exe.addModule("ember", ember_dep.module("ember"));  

3. Import in code

const ember = @import("ember");

Image

const image: ember.types.EmberImage = try ember.load_image(.BMP, "assets/images/icon.bmp", allocator);
defer image.deallocate(allocator);

ember.types.EmberImage has the following structure:

{
    meta: {
        file: [:0]const u8, // filepath
        bytes: []u8, // raw file content
    },
    format: EmberImageFormat,
    width: u32,
    height: u32,
    pixels: []{
        red: u8,
        green: u8,
        blue: u8,
        alpha: u8,
    },
}

Sound

const sound: ember.types.EmberSound = try ember.load_sound(.WAV, "assets/sounds/completion.wav", allocator);
defer sound.deallocate(allocator);

ember.types.EmberSound has the following structure:

{
    meta: {
        file: [:0]const u8, // filepath
        bytes: []u8, // raw file content
    },
    format: EmberSoundFormat,
    n_channels: u16,
    sample_rate: u32,
    bit_depth: u16,
    data_size: usize,
    samples: []u8,
}

3d

const model: ember.types.Ember3d = try ember.load_3d(.OBJ, "assets/models/cube.obj", allocator);
defer model.deallocate(allocator);

ember.types.Ember3d has the following structure:

{
    meta: {
        file: [:0]const u8, // filepath
        bytes: []u8, // raw file content
    },
    format: Ember3dFormat,
    vertices: []@Vector(3, f32),
    uvs: []@Vector(2, f32),
    normals: []@Vector(3, f32),
    indices: []@Vector(3, u32),
}

Raw Bytes

const bytes: []u8 = try ember.load(filepath, allocator);
defer allocator.free(bytes);