AssetImporter.h

浏览该文件的文档.

#pragma once
#include "common/Export.h"
 
 
#include "asset/EvaArchive.h"
 
#include <map>
 
namespace eve::asset_import {
 
struct AssetImportLimits {
    std::uint64_t maximumSourceBytes = 2ULL * 1024 * 1024 * 1024;
    std::uint64_t maximumDecodedBytes = 4ULL * 1024 * 1024 * 1024;
    std::uint32_t maximumAssets = 100000;
    std::uint32_t maximumVerticesPerPrimitive = 100000000;
    std::uint32_t maximumIndicesPerPrimitive = 300000000;
    std::uint32_t maximumStringBytes = 4096;
};
 
enum class ImageColorSpace : std::uint8_t {
    Srgb,
    Linear,
};
 
struct ImportPackageIdentity {
    PersistentId  packageId;
    std::string   packageName;
    std::string   packageVersion;
    Value::Object provenance;
};
 
struct ImageImportRequest {
    ImportPackageIdentity        package;
    std::string                  sourceName;
    std::vector<std::uint8_t>    encodedBytes;
    ImageColorSpace              colorSpace = ImageColorSpace::Srgb;
    std::string                  usage = "color";
    AssetImportLimits            limits;
};
 
enum class GltfImportMode : std::uint8_t { Permissive, Strict };
 
struct GltfImportRequest {
    ImportPackageIdentity                         package;
    std::string                                   sourceName;
    std::vector<std::uint8_t>                     documentBytes;
    std::map<std::string, std::vector<std::uint8_t>> externalResources;
    AssetImportLimits                             limits;
    GltfImportMode                                   mode = GltfImportMode::Permissive;
};
 
enum class ImportDisposition : std::uint8_t {
    Translated,
    Baked,
    PreservedSource,
    Unsupported,
};
 
enum class ImportSeverity : std::uint8_t { Info, Warning };
 
struct ImportFinding {
    std::string       sourcePath;
    std::string       feature;
    ImportDisposition disposition = ImportDisposition::Translated;
    std::string       message;
    ImportSeverity    severity = ImportSeverity::Info;
};
 
struct ImportSourceMapping {
    std::string sourceObject;
    AssetRef    asset;
};
 
struct PreparedAssetImport {
    asset::EvaManifest                  manifest;
    std::vector<asset::EvaArchiveEntry> entries;
    std::vector<ImportFinding>           findings;
    std::vector<ImportSourceMapping>      sourceMappings;
};
 
[[nodiscard]] EVENGINE_API_PLATFORM Result<PreparedAssetImport> prepareImageImport(const ImageImportRequest& request);
 
[[nodiscard]] EVENGINE_API_PLATFORM Result<PreparedAssetImport> prepareGltfImport(const GltfImportRequest& request);
 
}  // namespace eve::asset_import