vox_import.hpp

Go to the documentation of this file.

 
#pragma once
#include <cstdint>
#include <glm/glm.hpp>
#include <optional>
#include <span>
#include <string>
#include <toast/export.hpp>
#include <toast/voxel/brick_pool.hpp>
#include <toast/voxel/palette.hpp>
#include <toast/voxel/stamp.hpp>
#include <toast/voxel/voxel_volume.hpp>
#include <vector>
 
namespace assets {
 
inline constexpr uint32_t k_vox_max_dim = 256;
 
struct VoxVoxel {
  uint8_t x = 0;
  uint8_t y = 0;
  uint8_t z = 0;

  uint8_t palette_index = 0;
};
 
struct VoxModel {
  glm::uvec3 dims {0};
  std::vector<VoxVoxel> voxels;
};

struct VoxTransform {
  voxel::LatticeOrientation orientation;
  glm::ivec3 translation {0};
 
  [[nodiscard]]
  auto operator==(const VoxTransform&) const noexcept -> bool = default;
};
 
struct VoxNode {
  std::string name;
 
  VoxTransform local;
 
  bool hidden = false;
 
  std::vector<uint32_t> children;
 
  std::optional<uint32_t> model;
};
 
struct VoxScene {
  std::vector<VoxModel> models;

  std::vector<VoxNode> nodes;
 
  voxel::Palette palette;
 
  std::vector<std::string> warnings;
};

[[nodiscard]]
TOAST_API auto voxOrientationFromByte(uint8_t rotation) -> std::optional<voxel::LatticeOrientation>;
 
[[nodiscard]]
TOAST_API auto voxOrientationToByte(const voxel::LatticeOrientation& orientation) -> uint8_t;
 
[[nodiscard]]
TOAST_API auto composeVoxTransforms(const VoxTransform& parent, const VoxTransform& local) -> VoxTransform;

[[nodiscard]]
TOAST_API auto voxPlacementOf(const VoxTransform& world, glm::uvec3 model_dims) -> voxel::LatticePlacement;
 
struct VoxPlacement {
  uint32_t model = 0;
  std::string name;
  bool hidden = false;
  voxel::LatticePlacement placement;
};
 
[[nodiscard]]
TOAST_API auto flattenVoxScene(const VoxScene& scene) -> std::vector<VoxPlacement>;
 
[[nodiscard]]
TOAST_API auto buildVoxVolume(const VoxModel& model, voxel::BrickPool& pool) -> std::optional<voxel::Volume>;

[[nodiscard]]
TOAST_API auto importVox(std::span<const uint8_t> data) -> VoxScene;
 
}