114 lines
4.5 KiB
C++
114 lines
4.5 KiB
C++
#pragma once
|
|
|
|
////////////////////////////////////////////////////////////////////////////////
|
|
// The MIT License (MIT)
|
|
//
|
|
// Copyright (c) 2020 Nicholas Frechette & Animation Compression Library 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.
|
|
////////////////////////////////////////////////////////////////////////////////
|
|
|
|
#include "acl/core/impl/compiler_utils.h"
|
|
|
|
#include <cstdint>
|
|
|
|
ACL_IMPL_FILE_PRAGMA_PUSH
|
|
|
|
namespace acl
|
|
{
|
|
// BE CAREFUL WHEN CHANGING VALUES IN THIS ENUM
|
|
// The rotation format is serialized in the compressed data, if you change a value
|
|
// the compressed clips will be invalid. If you do, bump the appropriate algorithm versions.
|
|
enum class rotation_format8 : uint8_t
|
|
{
|
|
quatf_full = 0, // Full precision quaternion, [x,y,z,w] stored with float32
|
|
//quatf_variable = 1, // TODO Quantized quaternion, [x,y,z,w] stored with [N,N,N,N] bits (same number of bits per component)
|
|
quatf_drop_w_full = 2, // Full precision quaternion, [x,y,z] stored with float32 (w is dropped)
|
|
quatf_drop_w_variable = 3, // Quantized quaternion, [x,y,z] stored with [N,N,N] bits (w is dropped, same number of bits per component)
|
|
|
|
//quatf_optimal = 15, // Mix of quatf_variable and quatf_drop_w_variable
|
|
|
|
// TODO: Implement these?
|
|
//quatf_drop_largest_full // Full precision quaternion, [a,b,c] stored with float32 (largest component dropped)
|
|
//quatf_drop_largest_variable // Quantized quaternion, [a,b,c] stored with [N,N,N] bits (largest component dropped, same number of bits per component)
|
|
//quatf_log_full, // Full precision quaternion logarithm, [x,y,z] stored with float32
|
|
//quatf_log_variable, // Quantized quaternion logarithm, [x,y,z] stored with [N,N,N] bits (same number of bits per component)
|
|
};
|
|
|
|
// BE CAREFUL WHEN CHANGING VALUES IN THIS ENUM
|
|
// The vector format is serialized in the compressed data, if you change a value
|
|
// the compressed clips will be invalid. If you do, bump the appropriate algorithm versions.
|
|
enum class vector_format8 : uint8_t
|
|
{
|
|
vector3f_full = 0, // Full precision vector3f, [x,y,z] stored with float32
|
|
vector3f_variable = 1, // Quantized vector3f, [x,y,z] stored with [N,N,N] bits (same number of bits per component)
|
|
};
|
|
|
|
union track_format8
|
|
{
|
|
rotation_format8 rotation;
|
|
vector_format8 vector;
|
|
|
|
track_format8() {}
|
|
explicit track_format8(rotation_format8 format) : rotation(format) {}
|
|
explicit track_format8(vector_format8 format) : vector(format) {}
|
|
};
|
|
|
|
enum class animation_track_type8 : uint8_t
|
|
{
|
|
rotation,
|
|
translation,
|
|
scale,
|
|
};
|
|
|
|
enum class rotation_variant8 : uint8_t
|
|
{
|
|
quat,
|
|
quat_drop_w,
|
|
//quat_drop_largest,
|
|
//quat_log,
|
|
};
|
|
|
|
//////////////////////////////////////////////////////////////////////////
|
|
|
|
const char* get_rotation_format_name(rotation_format8 format);
|
|
|
|
bool get_rotation_format(const char* format, rotation_format8& out_format);
|
|
|
|
constexpr const char* get_vector_format_name(vector_format8 format);
|
|
|
|
bool get_vector_format(const char* format, vector_format8& out_format);
|
|
|
|
constexpr rotation_variant8 get_rotation_variant(rotation_format8 rotation_format);
|
|
|
|
constexpr rotation_format8 get_highest_variant_precision(rotation_variant8 variant);
|
|
|
|
constexpr bool is_rotation_format_variable(rotation_format8 format);
|
|
|
|
constexpr bool is_rotation_format_full_precision(rotation_format8 format);
|
|
|
|
constexpr bool is_vector_format_variable(vector_format8 format);
|
|
|
|
constexpr bool is_vector_format_full_precision(vector_format8 format);
|
|
}
|
|
|
|
#include "acl/core/impl/track_formats.impl.h"
|
|
|
|
ACL_IMPL_FILE_PRAGMA_POP
|