Crafter.Build/interfaces/Crafter.Build-Asset.cppm
Jorijn van der Graaf 8892154b28
Some checks failed
CI / build-test-release (push) Failing after 7m15s
linting
2026-07-23 01:24:42 +02:00

45 lines
1.9 KiB
C++
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

// SPDX-License-Identifier: LGPL-3.0-only
// SPDX-FileCopyrightText: Copyright (C) 2026 Catcrafts®
module;
#include "Crafter.Build-Api.h"
export module Crafter.Build:Asset;
import std;
namespace fs = std::filesystem;
namespace Crafter {
// Compress a build-time asset (.png/.obj) into its on-disk
// SaveCompressed counterpart (.ctex/.cmesh) using Crafter.Asset's
// library API in-process. Returns "" on success, an error message
// otherwise (matches Shader::Compile's contract).
//
// Real implementation lives in the impl unit and only compiles when
// CRAFTER_BUILD_HAS_ASSET is defined (i.e. when the build links
// Crafter.Asset). The bootstrap build.sh produces a stub variant
// that errors out at runtime if cfg.assets is non-empty — full
// support requires a self-host rebuild via crafter-build itself,
// which resolves the Crafter.Asset dep through project.cpp.
export CRAFTER_API std::string CompressAsset(const fs::path& input, const fs::path& output);
// Split a single .obj + .mtl file by material group into per-material
// .cmesh files, per-unique-albedo .ctex files, and a scene.txt manifest
// under outDir. All albedo textures are resized to albedoSize × albedoSize
// before compression (required for a texture_2d_array where all layers
// must have identical dimensions).
//
// scene.txt format (read by the Sponza example at runtime):
// <albedoCount>
// <meshCount>
// <albedoIdx_for_mesh_0> (-1 = no albedo)
// ...
//
// Idempotent: returns "" immediately if outDir/scene.txt already exists,
// so repeated builds skip the expensive split+resize step.
// Returns "" on success, an error string on failure.
export CRAFTER_API std::string BuildOBJBundle(
const fs::path& objPath,
const fs::path& mtlPath,
const fs::path& outDir,
std::uint16_t albedoSize = 1024
);
}