2026-05-12 01:16:40 +02:00
|
|
|
|
/*
|
|
|
|
|
|
Crafter® Build
|
|
|
|
|
|
Copyright (C) 2026 Catcrafts®
|
|
|
|
|
|
Catcrafts.net
|
|
|
|
|
|
|
|
|
|
|
|
This library is free software; you can redistribute it and/or
|
|
|
|
|
|
modify it under the terms of the GNU Lesser General Public
|
|
|
|
|
|
License version 3.0 as published by the Free Software Foundation;
|
|
|
|
|
|
|
|
|
|
|
|
This library is distributed in the hope that it will be useful,
|
|
|
|
|
|
but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
|
|
|
|
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
|
|
|
|
|
|
Lesser General Public License for more details.
|
|
|
|
|
|
|
|
|
|
|
|
You should have received a copy of the GNU Lesser General Public
|
|
|
|
|
|
License along with this library; if not, write to the Free Software
|
|
|
|
|
|
Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
|
|
|
|
|
|
*/
|
|
|
|
|
|
|
|
|
|
|
|
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);
|
2026-05-19 00:50:06 +02:00
|
|
|
|
|
|
|
|
|
|
// 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
|
|
|
|
|
|
);
|
2026-05-12 01:16:40 +02:00
|
|
|
|
}
|
