feat: init sarc + (clim + darc dumping)

* horizon/fmt: init sarc and clim
* tools/Archive: init Sarc and Darc dumping
* tools/Layout: init Image

Author: GasInfinity

README.md

@@ -112,7 +112,7 @@ You can (and are encouraged) to look at the `tools` directory as it is a good ex
 - 🟢 Smdh (tools/Smdh): Make / Dump
 - 🟢 3dsx (tools/3dsx): Make / Dump
 - 🟢 Pica (tools/Pica): Assemble / Disassemble
-    - 🟢 Assemble: Only **Z**itrus**P**ica**Sh**aders are implemented as an output format.
+    - 🟢 Assemble: Only **Z**itrus**P**ica**Sh**ader's are implemented as an output format.
     - 🟢 Disassemble: Outputs **Z**itrus**P**ica**A**sse**m**bly. Either RAW instructions, ZPSH's or DVL's (.shbin) can be disassembled.
 - 🟢 Firm (tools/Firm): Make / Info / Dump
     - 🟢 Make: Confirmed to build (and boot!) Luma3DS from source, however needs more testing as the firm is not 1:1.
@@ -124,9 +124,13 @@ You can (and are encouraged) to look at the `tools` directory as it is a good ex
     - 🟡 Yaz0 (Compress/Yaz): Decompression
     - 🟡 LZ10 (Compress/Lz10): Decompression
     - 🟡 LZ11 (Compress/Lz11): Decompression
-- 🟡 Archives:
-    - 🟡 Darc (Archive/Darc): List
-    - 🔴 Sarc
+- 🟡 Archives (tools/Archive):
+    - 🟡 Darc (Archive/Darc): List / Dump
+    - 🟡 Sarc (Archive/Sarc): List
+- 🟡 Layouts (tools/Layout):
+    - 🟡 Image (Layout/Image): Dump
+    - 🔴 Layout
+    - 🔴 Animation 
 - 🔴 Cro0 / Crr0
 - 🔴 Cia
 

src/compress.zig

@@ -1,3 +1,5 @@
+pub const etc = @import("compress/etc.zig");
+
 pub const lz = @import("compress/lz.zig");
 pub const yaz = @import("compress/yaz.zig");
 pub const lz10 = @import("compress/lz10.zig");

src/compress/etc.zig

@@ -0,0 +1,33 @@
+//! Ericsson Texture Compression Decoder
+//!
+//!
+//! TODO: Move this into its own library
+
+pub const pixels_per_block = 4;
+
+/// All fields should be read as big endian.
+pub const Pkm = extern struct {
+    pub const Format = enum(u16) {
+        etc1_rgb,
+        etc2_rgb,
+        etc2_rgba_old,
+        etc2_rgba,
+        etc2_rgba1,
+        etc2_r,
+        etc2_rg,
+        etc2_r_signed,
+        etc2_rg_signed,
+        _,
+    };
+
+    pub const magic_value = "PKM ";
+
+    magic: [magic_value.len]u8 = magic_value.*,
+    /// "10" for ETC1, "20" for ETC2
+    version: [2]u8 = "10".*,
+    format: Format,
+    width: u16,
+    height: u16,
+    real_width: u16,
+    real_height: u16,
+};

src/compress/lz10.zig

@@ -1,4 +1,4 @@
-//! LZ11 decompressor and (TODO) compressor.
+//! LZ10 decompressor and (TODO) compressor.
 //!
 //! LZ-like compression format where the maximum match offset is `4096` and length `18`.
 //!

src/hardware/pica.zig

@@ -102,6 +102,42 @@ pub const morton = struct {
 
         return values;
     }
+
+    pub const Strategy = enum { tile, untile };
+
+    pub fn convert(comptime T: type, comptime strategy: Strategy, comptime tile_size: usize, width: usize, dst_pixels: []T, src_pixels: []const T) void {
+        std.debug.assert(dst_pixels.len == src_pixels.len);
+        const max_tile_subindex = (tile_size * tile_size);
+        const SubindexInt = std.math.IntFittingRange(0, max_tile_subindex - 1);
+
+        const height = @divExact(src_pixels.len, width);
+        const width_tiles = @divExact(width, tile_size);
+        const height_tiles = @divExact(height, tile_size);
+
+        var i: u16 = 0;
+        for (0..height_tiles) |y_tile| {
+            const y_start = y_tile * tile_size;
+
+            for (0..width_tiles) |x_tile| {
+                const x_start = x_tile * tile_size;
+
+                for (0..max_tile_subindex) |tile| {
+                    const x, const y = toDimensions(SubindexInt, 2, @intCast(tile));
+
+                    const linear_index = i;
+                    const morton_index = (y_start + y) * width + x_start + x;
+
+                    const src_pixel, const dst_pixel = switch (strategy) {
+                        .tile => .{ &src_pixels[morton_index], &dst_pixels[linear_index] },
+                        .untile => .{ &src_pixels[linear_index], &dst_pixels[morton_index] },
+                    };
+
+                    dst_pixel.* = src_pixel.*;
+                    i += 1;
+                }
+            }
+        }
+    }
 };
 
 pub const Screen = enum(u1) {
@@ -547,6 +583,16 @@ pub const TextureUnitFormat = enum(u4) {
     a4,
     etc1,
     etc1a4,
+
+    pub fn scale(format: TextureUnitFormat, size: usize) usize {
+        return switch (format) {
+            .abgr8888 => size << 2,
+            .bgr888 => size * 3,
+            .rgba5551, .rgb565, .rgba4444, .ia88, .hilo88 => size << 1,
+            .i8, .a8, .ia44, .etc1a4 => size,
+            .i4, .a4, .etc1 => size >> 1,
+        };
+    }
 };
 
 pub const TextureUnitTexture2Coordinates = enum(u1) {

src/horizon/fmt.zig

@@ -26,6 +26,7 @@ pub const ncch = @import("fmt/ncch.zig");
 pub const dvl = @import("fmt/dvl.zig");
 
 pub const archive = @import("fmt/archive.zig");
+pub const layout = @import("fmt/layout.zig");
 pub const audio = @import("fmt/audio.zig");
 pub const cro0 = @import("fmt/cro0.zig");
 
@@ -38,6 +39,7 @@ comptime {
     _ = dvl;
 
     _ = archive;
+    _ = layout;
     _ = audio;
     _ = cro0;
 }

src/horizon/fmt/archive.zig

@@ -1 +1,7 @@
 pub const darc = @import("archive/darc.zig");
+pub const sarc = @import("archive/sarc.zig");
+
+comptime {
+    _ = darc;
+    _ = sarc;
+}

src/horizon/fmt/archive/darc.zig

@@ -67,14 +67,45 @@ pub const TableEntry = extern struct {
     attributes: Attributes,
     info: Info,
 
-    pub fn name(entry: TableEntry, table: []const u16) []const u16 {
+    pub fn name(entry: TableEntry, table: []const u16) [:0]const u16 {
         return std.mem.span(@as([*:0]const u16, @ptrCast(table))[@divExact(entry.attributes.name_offset, 2)..]);
     }
 };
 
 pub const View = struct {
-    pub const File = enum(u32) { _ };
-    pub const Directory = enum(u32) { root = 0, _ };
+    pub const Directory = enum(u32) {
+        root = 0,
+        _,
+
+        pub fn name(directory: Directory, view: View) [:0]const u16 {
+            return view.entries[@intFromEnum(directory)].name(view.name_table);
+        }
+    };
+
+    pub const File = enum(u32) {
+        pub const Stat = struct {
+            /// Offset of file data starting from `data_offset`.
+            offset: u32,
+            /// Size of the file in bytes.
+            size: u32,
+        };
+
+        _,
+
+        pub fn name(file: File, view: View) [:0]const u16 {
+            return view.entries[@intFromEnum(file)].name(view.name_table);
+        }
+
+        pub fn stat(file: File, view: View) Stat {
+            const file_meta = view.entries[@intFromEnum(file)];
+
+            return .{
+                .offset = file_meta.info.file.offset,
+                .size = file_meta.info.file.size,
+            };
+        }
+    };
+
     pub const Entry = struct {
         pub const Handle = enum(u32) { _ };