#pragma once //////////////////////////////////////////////////////////////////////////////// // The MIT License (MIT) // // Copyright (c) 2019 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/compressed_tracks.h" #include "acl/core/error_result.h" #include "acl/core/iallocator.h" #include "acl/core/impl/compiler_utils.h" #include "acl/compression/compression_settings.h" #include "acl/compression/output_stats.h" #include "acl/compression/track_array.h" #include ACL_IMPL_FILE_PRAGMA_PUSH namespace acl { ////////////////////////////////////////////////////////////////////////// // Compresses a track array with uniform sampling. // // This compression algorithm is the simplest by far and as such it offers // the fastest compression and decompression. Every sample is retained and // every track has the same number of samples playing back at the same // sample rate. This means that when we sample at a particular time within // the clip, we can trivially calculate the offsets required to read the // desired data. All the data is sorted in order to ensure all reads are // as contiguous as possible for optimal cache locality during decompression. // // allocator: The allocator instance to use to allocate and free memory. // track_list: The track list to compress. // settings: The compression settings to use. // out_compressed_tracks: The resulting compressed tracks. The caller owns the returned memory and must free it. // out_stats: Stat output structure. ////////////////////////////////////////////////////////////////////////// error_result compress_track_list(iallocator& allocator, const track_array& track_list, const compression_settings& settings, compressed_tracks*& out_compressed_tracks, output_stats& out_stats); ////////////////////////////////////////////////////////////////////////// // Compresses a transform track array and using its additive base and uniform sampling. // // This compression algorithm is the simplest by far and as such it offers // the fastest compression and decompression. Every sample is retained and // every track has the same number of samples playing back at the same // sample rate. This means that when we sample at a particular time within // the clip, we can trivially calculate the offsets required to read the // desired data. All the data is sorted in order to ensure all reads are // as contiguous as possible for optimal cache locality during decompression. // // allocator: The allocator instance to use to allocate and free memory. // track_list: The track list to compress. // settings: The compression settings to use. // out_compressed_tracks: The resulting compressed tracks. The caller owns the returned memory and must free it. // out_stats: Stat output structure. ////////////////////////////////////////////////////////////////////////// error_result compress_track_list(iallocator& allocator, const track_array_qvvf& track_list, const compression_settings& settings, const track_array_qvvf& additive_base_track_list, additive_clip_format8 additive_format, compressed_tracks*& out_compressed_tracks, output_stats& out_stats); } #include "acl/compression/impl/compress.impl.h" ACL_IMPL_FILE_PRAGMA_POP