Add files from monorepo

@ commit 695b5833314ce0f73c7ff77877fb4b1c4fafbabc

Author: hazeycode

.gitattributes

@@ -0,0 +1,5 @@
+*.cpp text
+*.h text
+*.zig text
+*.txt text
+* text eol=lf

.gitignore

@@ -0,0 +1,6 @@
+# Ignore some special directories
+*zig-cache
+*zig-out
+
+# Ignore some special OS files
+*.DS_Store

LICENSE

@@ -0,0 +1,22 @@
+MIT License
+
+Copyright (c) 2021 Michal Ziulek
+Copyright (c) 2024 zig-gamedev contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

README.md

@@ -0,0 +1,93 @@
+# zstbi v0.10.0 - stb image bindings
+
+## Features
+
+* Supports Zig memory allocators
+* Supports decoding most popular formats
+* Supports HDR images
+* Supports 8-bits and 16-bits per channel
+* Supports image resizing
+* Supports image writing (.png, .jpg)
+
+## Getting started
+
+Copy `zstbi` to a subdirectory of your project and add the following to your `build.zig.zon` .dependencies:
+```zig
+    .zstbi = .{ .path = "libs/zstbi" },
+```
+
+Then in your `build.zig` add:
+```zig
+pub fn build(b: *std.Build) void {
+    const exe = b.addExecutable(.{ ... });
+
+    const zstbi = b.dependency("zstbi", .{});
+    exe.root_module.addImport("zstbi", zstbi.module("root"));
+    exe.linkLibrary(zstbi.artifact("zstbi"));
+}
+```
+Now in your code you may import and use `zstbi`.
+
+Init the lib. `zstbi.init()` is cheap and you may call it whenever you need to change memory allocator. Must be called from the main thread.
+```zig
+const zstbi = @import("zstbi");
+
+zstbi.init(allocator);
+defer zstbi.deinit();
+```
+```zig
+pub const Image = struct {
+    data: []u8,
+    width: u32,
+    height: u32,
+    num_components: u32,
+    bytes_per_component: u32,
+    bytes_per_row: u32,
+    is_hdr: bool,
+    ...
+```
+```zig
+pub fn loadFromFile(pathname: [:0]const u8, forced_num_components: u32) !Image
+
+pub fn loadFromMemory(data: []const u8, forced_num_components: u32) !Image
+
+pub fn createEmpty(width: u32, height: u32, num_components: u32, args: struct {
+    bytes_per_component: u32 = 0,
+    bytes_per_row: u32 = 0,
+}) !Image
+
+pub fn info(pathname: [:0]const u8) struct {
+    is_supported: bool,
+    width: u32,
+    height: u32,
+    num_components: u32,
+}
+
+pub fn resize(image: *const Image, new_width: u32, new_height: u32) Image
+
+pub fn writeToFile(
+    image: *const Image,
+    filename: [:0]const u8,
+    image_format: ImageWriteFormat,
+) ImageWriteError!void
+
+pub fn writeToFn(
+    image: *const Image,
+    write_fn: *const fn (ctx: ?*anyopaque, data: ?*anyopaque, size: c_int) callconv(.C) void,
+    context: ?*anyopaque,
+    image_format: ImageWriteFormat,
+) ImageWriteError!void
+```
+```zig
+var image = try zstbi.Image.loadFromFile("data/image.png", forced_num_components);
+defer image.deinit();
+
+const new_resized_image = image.resize(1024, 1024);
+```
+Misc functions:
+```zig
+pub fn isHdr(filename: [:0]const u8) bool
+pub fn is16bit(filename: [:0]const u8) bool
+
+pub fn setFlipVerticallyOnLoad(should_flip: bool) void
+```

build.zig

@@ -0,0 +1,52 @@
+const std = @import("std");
+
+pub fn build(b: *std.Build) void {
+    const optimize = b.standardOptimizeOption(.{});
+    const target = b.standardTargetOptions(.{});
+
+    _ = b.addModule("root", .{
+        .root_source_file = b.path("src/zstbi.zig"),
+    });
+
+    const zstbi_lib = b.addStaticLibrary(.{
+        .name = "zstbi",
+        .target = target,
+        .optimize = optimize,
+    });
+    zstbi_lib.addIncludePath(b.path("libs/stbi"));
+    if (optimize == .Debug) {
+        // TODO: Workaround for Zig bug.
+        zstbi_lib.addCSourceFile(.{
+            .file = b.path("src/zstbi.c"),
+            .flags = &.{
+                "-std=c99",
+                "-fno-sanitize=undefined",
+                "-g",
+                "-O0",
+            },
+        });
+    } else {
+        zstbi_lib.addCSourceFile(.{
+            .file = b.path("src/zstbi.c"),
+            .flags = &.{
+                "-std=c99",
+                "-fno-sanitize=undefined",
+            },
+        });
+    }
+    zstbi_lib.linkLibC();
+    b.installArtifact(zstbi_lib);
+
+    const test_step = b.step("test", "Run zstbi tests");
+
+    const tests = b.addTest(.{
+        .name = "zstbi-tests",
+        .root_source_file = b.path("src/zstbi.zig"),
+        .target = target,
+        .optimize = optimize,
+    });
+    tests.linkLibrary(zstbi_lib);
+    b.installArtifact(tests);
+
+    test_step.dependOn(&b.addRunArtifact(tests).step);
+}

build.zig.zon

@@ -0,0 +1,11 @@
+.{
+    .name = "zstbi",
+    .version = "0.10.0",
+    .paths = .{
+        "build.zig",
+        "build.zig.zon",
+        "libs",
+        "src",
+        "README.md",
+    },
+}