From 437958ef91920bde96ebd8481540406a33aaa947 Mon Sep 17 00:00:00 2001 From: Jackie9527 <80555200+Jackie9527@users.noreply.github.com> Date: Sat, 25 Feb 2023 10:10:35 +0800 Subject: [PATCH 01/61] bugfix fails to check if point in triangle. Signed-off-by: Jackie9527 <80555200+Jackie9527@users.noreply.github.com> --- code/Common/PolyTools.h | 22 ++-------------------- 1 file changed, 2 insertions(+), 20 deletions(-) diff --git a/code/Common/PolyTools.h b/code/Common/PolyTools.h index 9837a2991..a5bd1090b 100644 --- a/code/Common/PolyTools.h +++ b/code/Common/PolyTools.h @@ -74,26 +74,8 @@ inline bool OnLeftSideOfLine2D(const T& p0, const T& p1,const T& p2) { * both aiVector3D and aiVector2D, but generally ignores the third coordinate.*/ template inline bool PointInTriangle2D(const T& p0, const T& p1,const T& p2, const T& pp) { - // Point in triangle test using baryzentric coordinates - const aiVector2D v0 = p1 - p0; - const aiVector2D v1 = p2 - p0; - const aiVector2D v2 = pp - p0; - - double dot00 = v0 * v0; - double dot11 = v1 * v1; - const double dot01 = v0 * v1; - const double dot02 = v0 * v2; - const double dot12 = v1 * v2; - const double denom = dot00 * dot11 - dot01 * dot01; - if (denom == 0.0) { - return false; - } - - const double invDenom = 1.0 / denom; - dot11 = (dot11 * dot02 - dot01 * dot12) * invDenom; - dot00 = (dot00 * dot12 - dot01 * dot02) * invDenom; - - return (dot11 > 0) && (dot00 > 0) && (dot11 + dot00 < 1); + // pp should be left side of the three triangle side, by ccw arrow + return OnLeftSideOfLine2D(p0, p1, pp) && OnLeftSideOfLine2D(p1, p2, pp) && OnLeftSideOfLine2D(p2, p0, pp); } From 94d977354804608d29281a7e3e940b71aa148865 Mon Sep 17 00:00:00 2001 From: FeeshWyvern Date: Mon, 27 Feb 2023 20:02:34 -0800 Subject: [PATCH 02/61] Bug fix: Correctly set the name of the attributes. PR #3940 did not seem to update in Master? --- port/PyAssimp/pyassimp/core.py | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/port/PyAssimp/pyassimp/core.py b/port/PyAssimp/pyassimp/core.py index 35ad882b3..37beac886 100644 --- a/port/PyAssimp/pyassimp/core.py +++ b/port/PyAssimp/pyassimp/core.py @@ -211,7 +211,7 @@ def _init(self, target = None, parent = None): else: # starts with 'm' but not iterable - setattr(target, m, obj) + setattr(target, name, obj) logger.debug("Added " + name + " as self." + name + " (type: " + str(type(obj)) + ")") if _is_init_type(obj): From f9fcf33aaa639fbfd386631cb796ac66d01fef94 Mon Sep 17 00:00:00 2001 From: FeeshWyvern Date: Mon, 27 Feb 2023 20:06:05 -0800 Subject: [PATCH 03/61] Bug fix: We should not be accessing `mPrivate` according to structs.Scene and fixes a crash when `mPrivate` points to invalid data. --- port/PyAssimp/pyassimp/core.py | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/port/PyAssimp/pyassimp/core.py b/port/PyAssimp/pyassimp/core.py index 37beac886..edde8b29a 100644 --- a/port/PyAssimp/pyassimp/core.py +++ b/port/PyAssimp/pyassimp/core.py @@ -115,6 +115,10 @@ def _init(self, target = None, parent = None): if m.startswith("_"): continue + # We should not be accessing `mPrivate` according to structs.Scene. + if m == 'mPrivate': + continue + if m.startswith('mNum'): if 'm' + m[4:] in dirself: continue # will be processed later on From a1aace74e58460d0d5c6462cea81682b5647e4b7 Mon Sep 17 00:00:00 2001 From: Kim Kulling Date: Tue, 28 Feb 2023 21:53:18 +0100 Subject: [PATCH 04/61] Fix: Use C++17 compliant utf8 encoding. --- samples/SharedCode/UTFConverter.cpp | 2 +- samples/SharedCode/UTFConverter.h | 43 ++++++++++++++++++----------- 2 files changed, 28 insertions(+), 17 deletions(-) diff --git a/samples/SharedCode/UTFConverter.cpp b/samples/SharedCode/UTFConverter.cpp index a1bff7e4b..e6c07e946 100644 --- a/samples/SharedCode/UTFConverter.cpp +++ b/samples/SharedCode/UTFConverter.cpp @@ -46,7 +46,7 @@ OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. namespace AssimpSamples { namespace SharedCode { -typename UTFConverter::UTFConverterImpl UTFConverter::impl_; +//typename UTFConverter::UTFConverterImpl UTFConverter::impl_; } } diff --git a/samples/SharedCode/UTFConverter.h b/samples/SharedCode/UTFConverter.h index 17e89ee4d..34b2293de 100644 --- a/samples/SharedCode/UTFConverter.h +++ b/samples/SharedCode/UTFConverter.h @@ -45,43 +45,54 @@ OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. #define ASSIMP_SAMPLES_SHARED_CODE_UTFCONVERTER_H #include -#include -#include +#include + +#ifdef ASSIMP_USE_HUNTER +#include +#else +#include "../contrib/utf8cpp/source/utf8.h" +#endif namespace AssimpSamples { namespace SharedCode { // Used to convert between multibyte and unicode strings. class UTFConverter { - using UTFConverterImpl = std::wstring_convert, wchar_t>; public: - UTFConverter(const char* s) : - s_(s), - ws_(impl_.from_bytes(s)) { + //utf8::utf16to8(start, end, back_inserter(str)); + + UTFConverter(const char* s) : s_(s), ws_() { + std::vector str; + utf8::utf8to16(s, s + std::strlen(s) + 1, back_inserter(str)); } - UTFConverter(const wchar_t* s) : - s_(impl_.to_bytes(s)), - ws_(s) { + + UTFConverter(const wchar_t* s) : s_(),ws_(s) { + std::vector str; + utf8::utf16to8(s, s + ws_.size() + 1, back_inserter(str)); } - UTFConverter(const std::string& s) : - s_(s), - ws_(impl_.from_bytes(s)) { + + UTFConverter(const std::string& s) : s_(s), ws_() { + std::vector str; + utf8::utf8to16(s.c_str(), s.c_str() + s.size() + 1, back_inserter(str)); } - UTFConverter(const std::wstring& s) : - s_(impl_.to_bytes(s)), - ws_(s) { + + UTFConverter(const std::wstring& s) : s_(), ws_(s) { + std::vector str; + utf8::utf16to8(s.c_str(), s.c_str() + ws_.size() + 1, back_inserter(str)); } + inline const char* c_str() const { return s_.c_str(); } + inline const std::string& str() const { return s_; } + inline const wchar_t* c_wstr() const { return ws_.c_str(); } private: - static UTFConverterImpl impl_; std::string s_; std::wstring ws_; }; From 60da5e7e963d5753a5a532cea1ff78600cf8185f Mon Sep 17 00:00:00 2001 From: Kim Kulling Date: Tue, 28 Feb 2023 23:27:46 +0100 Subject: [PATCH 05/61] Update UTFConverter.cpp --- samples/SharedCode/UTFConverter.cpp | 4 ---- 1 file changed, 4 deletions(-) diff --git a/samples/SharedCode/UTFConverter.cpp b/samples/SharedCode/UTFConverter.cpp index e6c07e946..383ae43f1 100644 --- a/samples/SharedCode/UTFConverter.cpp +++ b/samples/SharedCode/UTFConverter.cpp @@ -5,8 +5,6 @@ Open Asset Import Library (assimp) Copyright (c) 2006-2020, assimp team - - All rights reserved. Redistribution and use of this software in source and binary forms, @@ -46,7 +44,5 @@ OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. namespace AssimpSamples { namespace SharedCode { -//typename UTFConverter::UTFConverterImpl UTFConverter::impl_; - } } From 534ee288c5d5864f871a924a44ef5462c2acf435 Mon Sep 17 00:00:00 2001 From: Kim Kulling Date: Tue, 28 Feb 2023 23:28:24 +0100 Subject: [PATCH 06/61] Update UTFConverter.h --- samples/SharedCode/UTFConverter.h | 8 ++------ 1 file changed, 2 insertions(+), 6 deletions(-) diff --git a/samples/SharedCode/UTFConverter.h b/samples/SharedCode/UTFConverter.h index 34b2293de..8173d474c 100644 --- a/samples/SharedCode/UTFConverter.h +++ b/samples/SharedCode/UTFConverter.h @@ -3,9 +3,7 @@ Open Asset Import Library (assimp) --------------------------------------------------------------------------- -Copyright (c) 2006-2020, assimp team - - +Copyright (c) 2006-2023, assimp team All rights reserved. @@ -56,11 +54,9 @@ OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. namespace AssimpSamples { namespace SharedCode { -// Used to convert between multibyte and unicode strings. +/// @brief Used to convert between multibyte and unicode strings. class UTFConverter { public: - //utf8::utf16to8(start, end, back_inserter(str)); - UTFConverter(const char* s) : s_(s), ws_() { std::vector str; utf8::utf8to16(s, s + std::strlen(s) + 1, back_inserter(str)); From 39efe4c832c02e8e6560b9922b0504716fd3c99c Mon Sep 17 00:00:00 2001 From: Jackie9527 <80555200+Jackie9527@users.noreply.github.com> Date: Sat, 25 Feb 2023 10:11:35 +0800 Subject: [PATCH 07/61] upgrade draco to 1.5.6 Signed-off-by: Jackie9527 <80555200+Jackie9527@users.noreply.github.com> --- contrib/draco/.cmake-format.py | 217 +- contrib/draco/.gitattributes | 1 + contrib/draco/.gitmodules | 12 + contrib/draco/BUILDING.md | 86 +- contrib/draco/CMakeLists.txt | 1193 +++--- contrib/draco/README.md | 150 +- contrib/draco/cmake/DracoConfig.cmake | 3 - contrib/draco/cmake/FindDraco.cmake | 56 - contrib/draco/cmake/compiler_flags.cmake | 220 - contrib/draco/cmake/compiler_tests.cmake | 103 - .../draco/cmake/draco-config.cmake.template | 5 +- contrib/draco/cmake/draco.pc.template | 9 +- .../draco/cmake/draco_build_definitions.cmake | 79 +- contrib/draco/cmake/draco_cpu_detection.cmake | 14 + contrib/draco/cmake/draco_dependencies.cmake | 136 + contrib/draco/cmake/draco_emscripten.cmake | 177 +- contrib/draco/cmake/draco_flags.cmake | 51 +- contrib/draco/cmake/draco_helpers.cmake | 14 + contrib/draco/cmake/draco_install.cmake | 126 +- contrib/draco/cmake/draco_intrinsics.cmake | 34 +- contrib/draco/cmake/draco_options.cmake | 185 +- contrib/draco/cmake/draco_sanitizer.cmake | 22 +- contrib/draco/cmake/draco_targets.cmake | 147 +- contrib/draco/cmake/draco_test_config.h.cmake | 15 + contrib/draco/cmake/draco_tests.cmake | 154 +- contrib/draco/cmake/draco_variables.cmake | 29 +- contrib/draco/cmake/sanitizers.cmake | 19 - .../cmake/toolchains/aarch64-linux-gnu.cmake | 14 + .../cmake/toolchains/android-ndk-common.cmake | 14 + contrib/draco/cmake/toolchains/android.cmake | 20 +- .../cmake/toolchains/arm-ios-common.cmake | 16 +- .../toolchains/arm-linux-gnueabihf.cmake | 14 + .../toolchains/arm64-android-ndk-libcpp.cmake | 14 + .../draco/cmake/toolchains/arm64-ios.cmake | 15 +- .../cmake/toolchains/arm64-linux-gcc.cmake | 14 + .../toolchains/armv7-android-ndk-libcpp.cmake | 14 + .../draco/cmake/toolchains/armv7-ios.cmake | 15 +- .../cmake/toolchains/armv7-linux-gcc.cmake | 14 + .../draco/cmake/toolchains/armv7s-ios.cmake | 15 +- contrib/draco/cmake/toolchains/i386-ios.cmake | 15 +- .../toolchains/x86-android-ndk-libcpp.cmake | 14 + .../x86_64-android-ndk-libcpp.cmake | 14 + .../draco/cmake/toolchains/x86_64-ios.cmake | 15 +- contrib/draco/cmake/util.cmake | 79 - .../draco/src/draco/animation/animation.cc | 47 + contrib/draco/src/draco/animation/animation.h | 149 + .../src/draco/animation/animation_test.cc | 71 + .../keyframe_animation_encoding_test.cc | 17 +- .../animation/keyframe_animation_test.cc | 6 +- .../src/draco/animation/node_animation_data.h | 150 + contrib/draco/src/draco/animation/skin.cc | 29 + contrib/draco/src/draco/animation/skin.h | 64 + .../draco/attributes/attribute_transform.cc | 7 +- .../draco/attributes/geometry_attribute.cc | 2 +- .../src/draco/attributes/geometry_attribute.h | 225 +- .../src/draco/attributes/point_attribute.cc | 43 + .../src/draco/attributes/point_attribute.h | 6 + .../attributes/attributes_encoder.cc | 16 +- .../attributes/kd_tree_attributes_decoder.cc | 73 +- .../attributes/kd_tree_attributes_decoder.h | 4 + .../attributes/normal_compression_utils.h | 38 +- .../compression/attributes/point_d_vector.h | 12 +- ..._constrained_multi_parallelogram_decoder.h | 7 +- ..._constrained_multi_parallelogram_encoder.h | 2 +- ...ction_scheme_multi_parallelogram_decoder.h | 4 +- ...esh_prediction_scheme_tex_coords_decoder.h | 58 +- ...ction_scheme_tex_coords_portable_encoder.h | 5 +- ...ion_scheme_tex_coords_portable_predictor.h | 64 +- .../prediction_scheme_encoder_factory.cc | 53 +- .../prediction_scheme_encoder_factory.h | 7 +- ...ahedron_canonicalized_decoding_transform.h | 6 +- ...octahedron_canonicalized_transform_test.cc | 10 +- ...eme_normal_octahedron_decoding_transform.h | 18 +- ...scheme_normal_octahedron_transform_test.cc | 8 +- .../prediction_scheme_wrap_transform_base.h | 4 +- .../sequential_integer_attribute_decoder.cc | 10 +- .../sequential_integer_attribute_encoder.cc | 8 +- .../sequential_normal_attribute_encoder.cc | 3 +- .../bit_coders/direct_bit_decoder.h | 9 +- .../compression/config/encoder_options.h | 4 + .../src/draco/compression/decode_test.cc | 76 + .../compression/draco_compression_options.cc | 59 + .../compression/draco_compression_options.h | 141 + .../draco_compression_options_test.cc | 45 + contrib/draco/src/draco/compression/encode.h | 1 - .../draco/src/draco/compression/encode_base.h | 2 +- .../src/draco/compression/encode_test.cc | 187 +- .../draco/src/draco/compression/entropy/ans.h | 1 - .../compression/entropy/rans_symbol_decoder.h | 7 + .../compression/entropy/rans_symbol_encoder.h | 4 +- .../compression/entropy/symbol_decoding.cc | 2 +- .../src/draco/compression/expert_encode.cc | 118 + .../src/draco/compression/expert_encode.h | 6 + .../mesh/mesh_edgebreaker_decoder_impl.cc | 54 +- .../mesh/mesh_edgebreaker_encoder.cc | 1 - .../mesh/mesh_edgebreaker_encoder_impl.cc | 2 +- .../mesh/mesh_edgebreaker_encoder_impl.h | 1 - .../mesh/mesh_edgebreaker_encoding_test.cc | 27 +- .../mesh/mesh_edgebreaker_shared.h | 2 - ...sh_edgebreaker_traversal_valence_decoder.h | 6 +- .../compression/mesh/mesh_encoder_test.cc | 8 +- .../mesh/mesh_sequential_decoder.cc | 6 +- .../mesh/mesh_sequential_encoder.cc | 4 - .../mesh/mesh_sequential_encoder.h | 1 - ...mesh_attribute_indices_encoding_observer.h | 2 +- .../mesh/traverser/mesh_traversal_sequencer.h | 2 +- .../dynamic_integer_points_kd_tree_decoder.h | 53 +- .../dynamic_integer_points_kd_tree_encoder.h | 5 +- .../algorithms/float_points_tree_encoder.h | 4 +- .../integer_points_kd_tree_decoder.h | 3 +- .../integer_points_kd_tree_encoder.h | 3 +- .../algorithms/quantize_points_3.h | 6 +- .../point_cloud_kd_tree_encoding_test.cc | 4 +- contrib/draco/src/draco/core/bounding_box.cc | 15 +- contrib/draco/src/draco/core/bounding_box.h | 5 + contrib/draco/src/draco/core/constants.h | 6 + contrib/draco/src/draco/core/data_buffer.cc | 2 +- contrib/draco/src/draco/core/data_buffer.h | 2 +- contrib/draco/src/draco/core/decoder_buffer.h | 14 +- .../src/draco/core/draco_index_type_vector.h | 15 +- .../draco/src/draco/core/draco_test_utils.cc | 26 +- .../draco/src/draco/core/draco_test_utils.h | 53 + contrib/draco/src/draco/core/draco_version.h | 4 +- contrib/draco/src/draco/core/macros.h | 21 +- contrib/draco/src/draco/core/math_utils.h | 24 + .../draco/src/draco/core/math_utils_test.cc | 4 +- contrib/draco/src/draco/core/options.cc | 3 +- contrib/draco/src/draco/core/options.h | 7 +- contrib/draco/src/draco/core/status.cc | 44 + contrib/draco/src/draco/core/status.h | 6 + contrib/draco/src/draco/core/status_test.cc | 7 + contrib/draco/src/draco/core/vector_d.h | 6 +- contrib/draco/src/draco/core/vector_d_test.cc | 60 - .../draco/src/draco/io/file_reader_factory.cc | 2 +- contrib/draco/src/draco/io/file_utils.cc | 37 +- contrib/draco/src/draco/io/file_utils.h | 15 +- contrib/draco/src/draco/io/file_utils_test.cc | 2 + .../draco/src/draco/io/file_writer_factory.cc | 1 + .../draco/src/draco/io/file_writer_utils.cc | 21 +- .../src/draco/io/file_writer_utils_test.cc | 49 + contrib/draco/src/draco/io/gltf_decoder.cc | 2893 +++++++++++++ contrib/draco/src/draco/io/gltf_decoder.h | 524 +++ .../draco/src/draco/io/gltf_decoder_test.cc | 1402 +++++++ contrib/draco/src/draco/io/gltf_encoder.cc | 3662 +++++++++++++++++ contrib/draco/src/draco/io/gltf_encoder.h | 134 + .../draco/src/draco/io/gltf_encoder_test.cc | 1717 ++++++++ .../draco/src/draco/io/gltf_test_helper.cc | 823 ++++ contrib/draco/src/draco/io/gltf_test_helper.h | 61 + contrib/draco/src/draco/io/gltf_utils.cc | 154 + contrib/draco/src/draco/io/gltf_utils.h | 186 + contrib/draco/src/draco/io/gltf_utils_test.cc | 366 ++ .../src/draco/io/image_compression_options.h | 31 + contrib/draco/src/draco/io/mesh_io.cc | 33 +- contrib/draco/src/draco/io/obj_decoder.cc | 132 +- contrib/draco/src/draco/io/obj_decoder.h | 22 +- .../draco/src/draco/io/obj_decoder_test.cc | 128 +- contrib/draco/src/draco/io/obj_encoder.cc | 169 +- contrib/draco/src/draco/io/obj_encoder.h | 15 + .../draco/src/draco/io/obj_encoder_test.cc | 34 + contrib/draco/src/draco/io/parser_utils.cc | 43 +- .../draco/src/draco/io/ply_decoder_test.cc | 1 + contrib/draco/src/draco/io/ply_encoder.cc | 13 +- contrib/draco/src/draco/io/ply_reader_test.cc | 10 +- contrib/draco/src/draco/io/scene_io.cc | 127 + contrib/draco/src/draco/io/scene_io.h | 55 + contrib/draco/src/draco/io/scene_io_test.cc | 86 + .../src/draco/io/stdio_file_reader_test.cc | 2 +- contrib/draco/src/draco/io/stl_decoder.cc | 77 + contrib/draco/src/draco/io/stl_decoder.h | 38 + .../draco/src/draco/io/stl_decoder_test.cc | 49 + contrib/draco/src/draco/io/stl_encoder.cc | 111 + contrib/draco/src/draco/io/stl_encoder.h | 52 + .../draco/src/draco/io/stl_encoder_test.cc | 78 + contrib/draco/src/draco/io/texture_io.cc | 94 + contrib/draco/src/draco/io/texture_io.h | 56 + contrib/draco/src/draco/io/texture_io_test.cc | 55 + contrib/draco/src/draco/io/tiny_gltf_utils.cc | 230 ++ contrib/draco/src/draco/io/tiny_gltf_utils.h | 140 + .../animation_decoder_webidl_wrapper.cc | 101 - .../animation_decoder_webidl_wrapper.h | 73 - .../animation_encoder_webidl_wrapper.cc | 89 - .../animation_encoder_webidl_wrapper.h | 66 - .../emscripten/decoder_webidl_wrapper.cc | 12 +- .../draco_animation_decoder_glue_wrapper.cc | 28 - .../draco_animation_web_decoder.idl | 52 - .../draco_animation_web_encoder.idl | 34 - .../draco/javascript/emscripten/version.js | 2 +- contrib/draco/src/draco/material/material.cc | 258 ++ contrib/draco/src/draco/material/material.h | 276 ++ .../src/draco/material/material_library.cc | 125 + .../src/draco/material/material_library.h | 104 + .../draco/material/material_library_test.cc | 155 + .../draco/src/draco/material/material_test.cc | 320 ++ .../src/draco/material/material_utils.cc | 14 + .../draco/src/draco/material/material_utils.h | 14 + .../src/draco/material/material_utils_test.cc | 24 + contrib/draco/src/draco/mesh/corner_table.cc | 1 + contrib/draco/src/draco/mesh/corner_table.h | 1 + .../src/draco/mesh/corner_table_iterators.h | 32 +- .../draco/src/draco/mesh/corner_table_test.cc | 126 + contrib/draco/src/draco/mesh/mesh.cc | 433 ++ contrib/draco/src/draco/mesh/mesh.h | 180 + .../src/draco/mesh/mesh_are_equivalent.cc | 52 + .../draco/mesh/mesh_are_equivalent_test.cc | 37 + .../draco/mesh/mesh_attribute_corner_table.cc | 14 +- .../draco/mesh/mesh_attribute_corner_table.h | 10 +- contrib/draco/src/draco/mesh/mesh_cleanup.cc | 12 +- contrib/draco/src/draco/mesh/mesh_cleanup.h | 16 +- .../draco/src/draco/mesh/mesh_cleanup_test.cc | 16 +- .../draco/mesh/mesh_connected_components.h | 161 + contrib/draco/src/draco/mesh/mesh_features.cc | 98 + contrib/draco/src/draco/mesh/mesh_features.h | 93 + .../src/draco/mesh/mesh_features_test.cc | 98 + contrib/draco/src/draco/mesh/mesh_indices.h | 37 + .../src/draco/mesh/mesh_misc_functions.h | 1 - contrib/draco/src/draco/mesh/mesh_splitter.cc | 451 ++ contrib/draco/src/draco/mesh/mesh_splitter.h | 109 + .../mesh_splitter_test.cc} | 23 +- .../draco/src/draco/mesh/mesh_stripifier.h | 2 - contrib/draco/src/draco/mesh/mesh_test.cc | 644 +++ contrib/draco/src/draco/mesh/mesh_utils.cc | 492 +++ contrib/draco/src/draco/mesh/mesh_utils.h | 102 + .../draco/src/draco/mesh/mesh_utils_test.cc | 391 ++ .../draco/mesh/triangle_soup_mesh_builder.cc | 16 +- .../draco/mesh/triangle_soup_mesh_builder.h | 63 + .../mesh/triangle_soup_mesh_builder_test.cc | 72 +- .../src/draco/metadata/geometry_metadata.cc | 15 +- .../src/draco/metadata/geometry_metadata.h | 2 + contrib/draco/src/draco/metadata/metadata.cc | 8 + contrib/draco/src/draco/metadata/metadata.h | 1 + .../src/draco/metadata/metadata_decoder.cc | 21 +- .../draco/src/draco/metadata/metadata_test.cc | 6 +- .../src/draco/metadata/property_table.cc | 183 + .../draco/src/draco/metadata/property_table.h | 243 ++ .../src/draco/metadata/property_table_test.cc | 624 +++ .../src/draco/metadata/structural_metadata.cc | 74 + .../src/draco/metadata/structural_metadata.h | 64 + .../metadata/structural_metadata_test.cc | 170 + .../src/draco/point_cloud/point_cloud.cc | 39 +- .../draco/src/draco/point_cloud/point_cloud.h | 10 + .../draco/point_cloud/point_cloud_builder.cc | 2 + .../draco/point_cloud/point_cloud_builder.h | 11 + .../src/draco/point_cloud/point_cloud_test.cc | 54 + .../draco/src/draco/scene/instance_array.cc | 45 + .../draco/src/draco/scene/instance_array.h | 61 + .../src/draco/scene/instance_array_test.cc | 179 + contrib/draco/src/draco/scene/light.cc | 45 + contrib/draco/src/draco/scene/light.h | 81 + contrib/draco/src/draco/scene/light_test.cc | 64 + contrib/draco/src/draco/scene/mesh_group.h | 138 + .../draco/src/draco/scene/mesh_group_test.cc | 196 + contrib/draco/src/draco/scene/scene.cc | 174 + contrib/draco/src/draco/scene/scene.h | 258 ++ .../src/draco/scene/scene_are_equivalent.cc | 109 + .../src/draco/scene/scene_are_equivalent.h | 42 + .../draco/scene/scene_are_equivalent_test.cc | 86 + contrib/draco/src/draco/scene/scene_indices.h | 72 + contrib/draco/src/draco/scene/scene_node.h | 105 + contrib/draco/src/draco/scene/scene_test.cc | 295 ++ contrib/draco/src/draco/scene/scene_utils.cc | 962 +++++ contrib/draco/src/draco/scene/scene_utils.h | 150 + .../draco/src/draco/scene/scene_utils_test.cc | 763 ++++ contrib/draco/src/draco/scene/trs_matrix.cc | 102 + contrib/draco/src/draco/scene/trs_matrix.h | 124 + .../draco/src/draco/scene/trs_matrix_test.cc | 79 + .../draco/src/draco/texture/source_image.cc | 29 + .../draco/src/draco/texture/source_image.h | 72 + contrib/draco/src/draco/texture/texture.h | 46 + .../src/draco/texture/texture_library.cc | 61 + .../draco/src/draco/texture/texture_library.h | 67 + .../src/draco/texture/texture_library_test.cc | 22 + .../draco/src/draco/texture/texture_map.cc | 86 + contrib/draco/src/draco/texture/texture_map.h | 175 + .../src/draco/texture/texture_map_test.cc | 0 .../src/draco/texture/texture_transform.cc | 79 + .../src/draco/texture/texture_transform.h | 75 + .../draco/texture/texture_transform_test.cc | 0 .../draco/src/draco/texture/texture_utils.cc | 144 + .../draco/src/draco/texture/texture_utils.h | 78 + .../src/draco/texture/texture_utils_test.cc | 163 + .../draco/src/draco/tools/draco_decoder.cc | 20 +- .../draco/src/draco/tools/draco_encoder.cc | 59 +- .../draco/src/draco/tools/draco_transcoder.cc | 130 + .../src/draco/tools/draco_transcoder_lib.cc | 86 + .../src/draco/tools/draco_transcoder_lib.h | 103 + .../draco/tools/draco_transcoder_lib_test.cc | 172 + contrib/draco/src/draco/tools/fuzz/build.sh | 2 +- .../draco/tools/install_test/CMakeLists.txt | 25 + .../src/draco/tools/install_test/main.cc | 44 + .../src/draco/tools/install_test/test.py | 456 ++ 290 files changed, 30940 insertions(+), 2350 deletions(-) create mode 100644 contrib/draco/.gitattributes create mode 100644 contrib/draco/.gitmodules delete mode 100644 contrib/draco/cmake/DracoConfig.cmake delete mode 100644 contrib/draco/cmake/FindDraco.cmake delete mode 100644 contrib/draco/cmake/compiler_flags.cmake delete mode 100644 contrib/draco/cmake/compiler_tests.cmake create mode 100644 contrib/draco/cmake/draco_dependencies.cmake delete mode 100644 contrib/draco/cmake/sanitizers.cmake delete mode 100644 contrib/draco/cmake/util.cmake create mode 100644 contrib/draco/src/draco/animation/animation.cc create mode 100644 contrib/draco/src/draco/animation/animation.h create mode 100644 contrib/draco/src/draco/animation/animation_test.cc create mode 100644 contrib/draco/src/draco/animation/node_animation_data.h create mode 100644 contrib/draco/src/draco/animation/skin.cc create mode 100644 contrib/draco/src/draco/animation/skin.h create mode 100644 contrib/draco/src/draco/compression/draco_compression_options.cc create mode 100644 contrib/draco/src/draco/compression/draco_compression_options.h create mode 100644 contrib/draco/src/draco/compression/draco_compression_options_test.cc create mode 100644 contrib/draco/src/draco/core/constants.h create mode 100644 contrib/draco/src/draco/core/status.cc create mode 100644 contrib/draco/src/draco/io/file_writer_utils_test.cc create mode 100644 contrib/draco/src/draco/io/gltf_decoder.cc create mode 100644 contrib/draco/src/draco/io/gltf_decoder.h create mode 100644 contrib/draco/src/draco/io/gltf_decoder_test.cc create mode 100644 contrib/draco/src/draco/io/gltf_encoder.cc create mode 100644 contrib/draco/src/draco/io/gltf_encoder.h create mode 100644 contrib/draco/src/draco/io/gltf_encoder_test.cc create mode 100644 contrib/draco/src/draco/io/gltf_test_helper.cc create mode 100644 contrib/draco/src/draco/io/gltf_test_helper.h create mode 100644 contrib/draco/src/draco/io/gltf_utils.cc create mode 100644 contrib/draco/src/draco/io/gltf_utils.h create mode 100644 contrib/draco/src/draco/io/gltf_utils_test.cc create mode 100644 contrib/draco/src/draco/io/image_compression_options.h create mode 100644 contrib/draco/src/draco/io/scene_io.cc create mode 100644 contrib/draco/src/draco/io/scene_io.h create mode 100644 contrib/draco/src/draco/io/scene_io_test.cc create mode 100644 contrib/draco/src/draco/io/stl_decoder.cc create mode 100644 contrib/draco/src/draco/io/stl_decoder.h create mode 100644 contrib/draco/src/draco/io/stl_decoder_test.cc create mode 100644 contrib/draco/src/draco/io/stl_encoder.cc create mode 100644 contrib/draco/src/draco/io/stl_encoder.h create mode 100644 contrib/draco/src/draco/io/stl_encoder_test.cc create mode 100644 contrib/draco/src/draco/io/texture_io.cc create mode 100644 contrib/draco/src/draco/io/texture_io.h create mode 100644 contrib/draco/src/draco/io/texture_io_test.cc create mode 100644 contrib/draco/src/draco/io/tiny_gltf_utils.cc create mode 100644 contrib/draco/src/draco/io/tiny_gltf_utils.h delete mode 100644 contrib/draco/src/draco/javascript/emscripten/animation_decoder_webidl_wrapper.cc delete mode 100644 contrib/draco/src/draco/javascript/emscripten/animation_decoder_webidl_wrapper.h delete mode 100644 contrib/draco/src/draco/javascript/emscripten/animation_encoder_webidl_wrapper.cc delete mode 100644 contrib/draco/src/draco/javascript/emscripten/animation_encoder_webidl_wrapper.h delete mode 100644 contrib/draco/src/draco/javascript/emscripten/draco_animation_decoder_glue_wrapper.cc delete mode 100644 contrib/draco/src/draco/javascript/emscripten/draco_animation_web_decoder.idl delete mode 100644 contrib/draco/src/draco/javascript/emscripten/draco_animation_web_encoder.idl create mode 100644 contrib/draco/src/draco/material/material.cc create mode 100644 contrib/draco/src/draco/material/material.h create mode 100644 contrib/draco/src/draco/material/material_library.cc create mode 100644 contrib/draco/src/draco/material/material_library.h create mode 100644 contrib/draco/src/draco/material/material_library_test.cc create mode 100644 contrib/draco/src/draco/material/material_test.cc create mode 100644 contrib/draco/src/draco/material/material_utils.cc create mode 100644 contrib/draco/src/draco/material/material_utils.h create mode 100644 contrib/draco/src/draco/material/material_utils_test.cc create mode 100644 contrib/draco/src/draco/mesh/corner_table_test.cc create mode 100644 contrib/draco/src/draco/mesh/mesh_connected_components.h create mode 100644 contrib/draco/src/draco/mesh/mesh_features.cc create mode 100644 contrib/draco/src/draco/mesh/mesh_features.h create mode 100644 contrib/draco/src/draco/mesh/mesh_features_test.cc create mode 100644 contrib/draco/src/draco/mesh/mesh_indices.h create mode 100644 contrib/draco/src/draco/mesh/mesh_splitter.cc create mode 100644 contrib/draco/src/draco/mesh/mesh_splitter.h rename contrib/draco/src/draco/{javascript/emscripten/draco_animation_encoder_glue_wrapper.cc => mesh/mesh_splitter_test.cc} (51%) create mode 100644 contrib/draco/src/draco/mesh/mesh_test.cc create mode 100644 contrib/draco/src/draco/mesh/mesh_utils.cc create mode 100644 contrib/draco/src/draco/mesh/mesh_utils.h create mode 100644 contrib/draco/src/draco/mesh/mesh_utils_test.cc create mode 100644 contrib/draco/src/draco/metadata/property_table.cc create mode 100644 contrib/draco/src/draco/metadata/property_table.h create mode 100644 contrib/draco/src/draco/metadata/property_table_test.cc create mode 100644 contrib/draco/src/draco/metadata/structural_metadata.cc create mode 100644 contrib/draco/src/draco/metadata/structural_metadata.h create mode 100644 contrib/draco/src/draco/metadata/structural_metadata_test.cc create mode 100644 contrib/draco/src/draco/scene/instance_array.cc create mode 100644 contrib/draco/src/draco/scene/instance_array.h create mode 100644 contrib/draco/src/draco/scene/instance_array_test.cc create mode 100644 contrib/draco/src/draco/scene/light.cc create mode 100644 contrib/draco/src/draco/scene/light.h create mode 100644 contrib/draco/src/draco/scene/light_test.cc create mode 100644 contrib/draco/src/draco/scene/mesh_group.h create mode 100644 contrib/draco/src/draco/scene/mesh_group_test.cc create mode 100644 contrib/draco/src/draco/scene/scene.cc create mode 100644 contrib/draco/src/draco/scene/scene.h create mode 100644 contrib/draco/src/draco/scene/scene_are_equivalent.cc create mode 100644 contrib/draco/src/draco/scene/scene_are_equivalent.h create mode 100644 contrib/draco/src/draco/scene/scene_are_equivalent_test.cc create mode 100644 contrib/draco/src/draco/scene/scene_indices.h create mode 100644 contrib/draco/src/draco/scene/scene_node.h create mode 100644 contrib/draco/src/draco/scene/scene_test.cc create mode 100644 contrib/draco/src/draco/scene/scene_utils.cc create mode 100644 contrib/draco/src/draco/scene/scene_utils.h create mode 100644 contrib/draco/src/draco/scene/scene_utils_test.cc create mode 100644 contrib/draco/src/draco/scene/trs_matrix.cc create mode 100644 contrib/draco/src/draco/scene/trs_matrix.h create mode 100644 contrib/draco/src/draco/scene/trs_matrix_test.cc create mode 100644 contrib/draco/src/draco/texture/source_image.cc create mode 100644 contrib/draco/src/draco/texture/source_image.h create mode 100644 contrib/draco/src/draco/texture/texture.h create mode 100644 contrib/draco/src/draco/texture/texture_library.cc create mode 100644 contrib/draco/src/draco/texture/texture_library.h create mode 100644 contrib/draco/src/draco/texture/texture_library_test.cc create mode 100644 contrib/draco/src/draco/texture/texture_map.cc create mode 100644 contrib/draco/src/draco/texture/texture_map.h create mode 100644 contrib/draco/src/draco/texture/texture_map_test.cc create mode 100644 contrib/draco/src/draco/texture/texture_transform.cc create mode 100644 contrib/draco/src/draco/texture/texture_transform.h create mode 100644 contrib/draco/src/draco/texture/texture_transform_test.cc create mode 100644 contrib/draco/src/draco/texture/texture_utils.cc create mode 100644 contrib/draco/src/draco/texture/texture_utils.h create mode 100644 contrib/draco/src/draco/texture/texture_utils_test.cc create mode 100644 contrib/draco/src/draco/tools/draco_transcoder.cc create mode 100644 contrib/draco/src/draco/tools/draco_transcoder_lib.cc create mode 100644 contrib/draco/src/draco/tools/draco_transcoder_lib.h create mode 100644 contrib/draco/src/draco/tools/draco_transcoder_lib_test.cc create mode 100644 contrib/draco/src/draco/tools/install_test/CMakeLists.txt create mode 100644 contrib/draco/src/draco/tools/install_test/main.cc create mode 100644 contrib/draco/src/draco/tools/install_test/test.py diff --git a/contrib/draco/.cmake-format.py b/contrib/draco/.cmake-format.py index 64f2495b4..5b36f67aa 100644 --- a/contrib/draco/.cmake-format.py +++ b/contrib/draco/.cmake-format.py @@ -1,102 +1,137 @@ -# Generated with cmake-format 0.5.1 -# How wide to allow formatted cmake files -line_width = 80 - -# How many spaces to tab for indent -tab_size = 2 - -# If arglists are longer than this, break them always -max_subargs_per_line = 10 - -# If true, separate flow control names from their parentheses with a space -separate_ctrl_name_with_space = False - -# If true, separate function names from parentheses with a space -separate_fn_name_with_space = False - -# If a statement is wrapped to more than one line, than dangle the closing -# parenthesis on its own line -dangle_parens = False - -# What character to use for bulleted lists -bullet_char = '*' - -# What character to use as punctuation after numerals in an enumerated list -enum_char = '.' - -# What style line endings to use in the output. -line_ending = u'unix' - -# Format command names consistently as 'lower' or 'upper' case -command_case = u'lower' - -# Format keywords consistently as 'lower' or 'upper' case -keyword_case = u'unchanged' - -# Specify structure for custom cmake functions -additional_commands = { - "foo": { - "flags": [ - "BAR", - "BAZ" - ], - "kwargs": { - "HEADERS": "*", - "DEPENDS": "*", - "SOURCES": "*" - } +with section('parse'): + # Specify structure for custom cmake functions + additional_commands = { + 'draco_add_emscripten_executable': { + 'kwargs': { + 'NAME': '*', + 'SOURCES': '*', + 'OUTPUT_NAME': '*', + 'DEFINES': '*', + 'INCLUDES': '*', + 'COMPILE_FLAGS': '*', + 'LINK_FLAGS': '*', + 'OBJLIB_DEPS': '*', + 'LIB_DEPS': '*', + 'GLUE_PATH': '*', + 'PRE_LINK_JS_SOURCES': '*', + 'POST_LINK_JS_SOURCES': '*', + 'FEATURES': '*', + }, + 'pargs': 0, + }, + 'draco_add_executable': { + 'kwargs': { + 'NAME': '*', + 'SOURCES': '*', + 'OUTPUT_NAME': '*', + 'TEST': 0, + 'DEFINES': '*', + 'INCLUDES': '*', + 'COMPILE_FLAGS': '*', + 'LINK_FLAGS': '*', + 'OBJLIB_DEPS': '*', + 'LIB_DEPS': '*', + }, + 'pargs': 0, + }, + 'draco_add_library': { + 'kwargs': { + 'NAME': '*', + 'TYPE': '*', + 'SOURCES': '*', + 'TEST': 0, + 'OUTPUT_NAME': '*', + 'DEFINES': '*', + 'INCLUDES': '*', + 'COMPILE_FLAGS': '*', + 'LINK_FLAGS': '*', + 'OBJLIB_DEPS': '*', + 'LIB_DEPS': '*', + 'PUBLIC_INCLUDES': '*', + }, + 'pargs': 0, + }, + 'draco_generate_emscripten_glue': { + 'kwargs': { + 'INPUT_IDL': '*', + 'OUTPUT_PATH': '*', + }, + 'pargs': 0, + }, + 'draco_get_required_emscripten_flags': { + 'kwargs': { + 'FLAG_LIST_VAR_COMPILER': '*', + 'FLAG_LIST_VAR_LINKER': '*', + }, + 'pargs': 0, + }, + 'draco_option': { + 'kwargs': { + 'NAME': '*', + 'HELPSTRING': '*', + 'VALUE': '*', + }, + 'pargs': 0, + }, + # Rules for built in CMake commands and those from dependencies. + 'list': { + 'kwargs': { + 'APPEND': '*', + 'FILTER': '*', + 'FIND': '*', + 'GET': '*', + 'INSERT': '*', + 'JOIN': '*', + 'LENGTH': '*', + 'POP_BACK': '*', + 'POP_FRONT': '*', + 'PREPEND': '*', + 'REMOVE_DUPLICATES': '*', + 'REMOVE_ITEM': '*', + 'REVERSE': '*', + 'SORT': '*', + 'SUBLIST': '*', + 'TRANSFORM': '*', + }, + }, + 'protobuf_generate': { + 'kwargs': { + 'IMPORT_DIRS': '*', + 'LANGUAGE': '*', + 'OUT_VAR': '*', + 'PROTOC_OUT_DIR': '*', + 'PROTOS': '*', + }, + }, } -} -# A list of command names which should always be wrapped -always_wrap = [] +with section('format'): + # Formatting options. -# Specify the order of wrapping algorithms during successive reflow attempts -algorithm_order = [0, 1, 2, 3, 4] + # How wide to allow formatted cmake files + line_width = 80 -# If true, the argument lists which are known to be sortable will be sorted -# lexicographicall -autosort = False + # How many spaces to tab for indent + tab_size = 2 -# enable comment markup parsing and reflow -enable_markup = True + # If true, separate flow control names from their parentheses with a space + separate_ctrl_name_with_space = False -# If comment markup is enabled, don't reflow the first comment block in -# eachlistfile. Use this to preserve formatting of your -# copyright/licensestatements. -first_comment_is_literal = False + # If true, separate function names from parentheses with a space + separate_fn_name_with_space = False -# If comment markup is enabled, don't reflow any comment block which matchesthis -# (regex) pattern. Default is `None` (disabled). -literal_comment_pattern = None + # If a statement is wrapped to more than one line, than dangle the closing + # parenthesis on its own line. + dangle_parens = False -# Regular expression to match preformat fences in comments -# default=r'^\s*([`~]{3}[`~]*)(.*)$' -fence_pattern = u'^\\s*([`~]{3}[`~]*)(.*)$' + # Do not sort argument lists. + enable_sort = False -# Regular expression to match rulers in comments -# default=r'^\s*[^\w\s]{3}.*[^\w\s]{3}$' -ruler_pattern = u'^\\s*[^\\w\\s]{3}.*[^\\w\\s]{3}$' + # What style line endings to use in the output. + line_ending = 'unix' -# If true, emit the unicode byte-order mark (BOM) at the start of the file -emit_byteorder_mark = False + # Format command names consistently as 'lower' or 'upper' case + command_case = 'canonical' -# If a comment line starts with at least this many consecutive hash characters, -# then don't lstrip() them off. This allows for lazy hash rulers where the first -# hash char is not separated by space -hashruler_min_length = 10 - -# If true, then insert a space between the first hash char and remaining hash -# chars in a hash ruler, and normalize its length to fill the column -canonicalize_hashrulers = True - -# Specify the encoding of the input file. Defaults to utf-8. -input_encoding = u'utf-8' - -# Specify the encoding of the output file. Defaults to utf-8. Note that cmake -# only claims to support utf-8 so be careful when using anything else -output_encoding = u'utf-8' - -# A dictionary containing any per-command configuration overrides. Currently -# only `command_case` is supported. -per_command = {} + # Format keywords consistently as 'lower' or 'upper' case + keyword_case = 'upper' diff --git a/contrib/draco/.gitattributes b/contrib/draco/.gitattributes new file mode 100644 index 000000000..96acfc612 --- /dev/null +++ b/contrib/draco/.gitattributes @@ -0,0 +1 @@ +*.obj eol=lf \ No newline at end of file diff --git a/contrib/draco/.gitmodules b/contrib/draco/.gitmodules new file mode 100644 index 000000000..25f0a1c03 --- /dev/null +++ b/contrib/draco/.gitmodules @@ -0,0 +1,12 @@ +[submodule "third_party/googletest"] + path = third_party/googletest + url = https://github.com/google/googletest.git +[submodule "third_party/eigen"] + path = third_party/eigen + url = https://gitlab.com/libeigen/eigen.git +[submodule "third_party/tinygltf"] + path = third_party/tinygltf + url = https://github.com/syoyo/tinygltf.git +[submodule "third_party/filesystem"] + path = third_party/filesystem + url = https://github.com/gulrak/filesystem diff --git a/contrib/draco/BUILDING.md b/contrib/draco/BUILDING.md index d33917b88..340b2b83b 100644 --- a/contrib/draco/BUILDING.md +++ b/contrib/draco/BUILDING.md @@ -4,8 +4,10 @@ _**Contents**_ * [Mac OS X](#mac-os-x) * [Windows](#windows) * [CMake Build Configuration](#cmake-build-configuration) + * [Transcoder](#transcoder) * [Debugging and Optimization](#debugging-and-optimization) * [Googletest Integration](#googletest-integration) + * [Third Party Libraries](#third-party-libraries) * [Javascript Encoder/Decoder](#javascript-encoderdecoder) * [WebAssembly Decoder](#webassembly-decoder) * [WebAssembly Mesh Only Decoder](#webassembly-mesh-only-decoder) @@ -72,6 +74,43 @@ C:\Users\nobody> cmake ../ -G "Visual Studio 16 2019" -A x64 CMake Build Configuration ------------------------- +Transcoder +---------- + +Before attempting to build Draco with transcoding support you must run an +additional Git command to obtain the submodules: + +~~~~~ bash +# Run this command from within your Draco clone. +$ git submodule update --init +# See below if you prefer to use existing versions of Draco dependencies. +~~~~~ + +In order to build the `draco_transcoder` target, the transcoding support needs +to be explicitly enabled when you run `cmake`, for example: + +~~~~~ bash +$ cmake ../ -DDRACO_TRANSCODER_SUPPORTED=ON +~~~~~ + +The above option is currently not compatible with our Javascript or WebAssembly +builds but all other use cases are supported. Note that binaries and libraries +built with the transcoder support may result in increased binary sizes of the +produced libraries and executables compared to the default CMake settings. + +The following CMake variables can be used to configure Draco to use local +copies of third party dependencies instead of git submodules. + +- `DRACO_EIGEN_PATH`: this path must contain an Eigen directory that includes + the Eigen sources. +- `DRACO_FILESYSTEM_PATH`: this path must contain the ghc directory where the + filesystem includes are located. +- `DRACO_TINYGLTF_PATH`: this path must contain tiny_gltf.h and its + dependencies. + +When not specified the Draco build requires the presence of the submodules that +are stored within `draco/third_party`. + Debugging and Optimization -------------------------- @@ -114,17 +153,52 @@ $ cmake ../ -DDRACO_SANITIZE=address Googletest Integration ---------------------- -Draco includes testing support built using Googletest. To enable Googletest unit -test support the DRACO_TESTS cmake variable must be turned on at cmake -generation time: +Draco includes testing support built using Googletest. The Googletest repository +is included as a submodule of the Draco git repository. Run the following +command to clone the Googletest repository: + +~~~~~ bash +$ git submodule update --init +~~~~~ + +To enable Googletest unit test support the DRACO_TESTS cmake variable must be +turned on at cmake generation time: ~~~~~ bash $ cmake ../ -DDRACO_TESTS=ON ~~~~~ -When cmake is used as shown in the above example the googletest directory must -be a sibling of the Draco repository root directory. To run the tests execute -`draco_tests` from your build output directory. +To run the tests execute `draco_tests` from your build output directory: + +~~~~~ bash +$ ./draco_tests +~~~~~ + +Draco can be configured to use a local Googletest installation. The +`DRACO_GOOGLETEST_PATH` variable overrides the behavior described above and +configures Draco to use the Googletest at the specified path. + +Third Party Libraries +--------------------- + +When Draco is built with transcoding and/or testing support enabled the project +has dependencies on third party libraries: + +- [Eigen](https://eigen.tuxfamily.org/) + - Provides various math utilites. +- [Googletest](https://github.com/google/googletest) + - Provides testing support. +- [Gulrak/filesystem](https://github.com/gulrak/filesystem) + - Provides C++17 std::filesystem emulation for pre-C++17 environments. +- [TinyGLTF](https://github.com/syoyo/tinygltf) + - Provides GLTF I/O support. + +These dependencies are managed as Git submodules. To obtain the dependencies +run the following command in your Draco repository: + +~~~~~ bash +$ git submodule update --init +~~~~~ WebAssembly Decoder ------------------- diff --git a/contrib/draco/CMakeLists.txt b/contrib/draco/CMakeLists.txt index 6ea9b21fd..a93267d25 100644 --- a/contrib/draco/CMakeLists.txt +++ b/contrib/draco/CMakeLists.txt @@ -1,7 +1,18 @@ -cmake_minimum_required(VERSION 3.12 FATAL_ERROR) +# Copyright 2021 The Draco Authors +# +# Licensed under the Apache License, Version 2.0 (the "License"); you may not +# use this file except in compliance with the License. You may obtain a copy of +# the License at +# +# http://www.apache.org/licenses/LICENSE-2.0 +# +# Unless required by applicable law or agreed to in writing, software +# distributed under the License is distributed on an "AS IS" BASIS, WITHOUT +# WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the +# License for the specific language governing permissions and limitations under +# the License. -# Draco requires C++11. -set(CMAKE_CXX_STANDARD 11) +cmake_minimum_required(VERSION 3.12 FATAL_ERROR) project(draco C CXX) if(NOT CMAKE_BUILD_TYPE) @@ -10,21 +21,23 @@ endif() set(draco_root "${CMAKE_CURRENT_SOURCE_DIR}") set(draco_src_root "${draco_root}/src/draco") -set(draco_build "${Assimp_BINARY_DIR}") +set(draco_build "${CMAKE_BINARY_DIR}") if("${draco_root}" STREQUAL "${draco_build}") message( - FATAL_ERROR "Building from within the Draco source tree is not supported.\n" - "Hint: Run these commands\n" - "$ rm -rf CMakeCache.txt CMakeFiles\n" - "$ mkdir -p ../draco_build\n" "$ cd ../draco_build\n" - "And re-run CMake from the draco_build directory.") + FATAL_ERROR + "Building from within the Draco source tree is not supported.\n" + "Hint: Run these commands\n" + "$ rm -rf CMakeCache.txt CMakeFiles\n" + "$ mkdir -p ../draco_build\n" + "$ cd ../draco_build\n" + "And re-run CMake from the draco_build directory.") endif() -include(CMakePackageConfigHelpers) include(FindPythonInterp) include("${draco_root}/cmake/draco_build_definitions.cmake") include("${draco_root}/cmake/draco_cpu_detection.cmake") +include("${draco_root}/cmake/draco_dependencies.cmake") include("${draco_root}/cmake/draco_emscripten.cmake") include("${draco_root}/cmake/draco_flags.cmake") include("${draco_root}/cmake/draco_helpers.cmake") @@ -49,6 +62,7 @@ draco_track_configuration_variable(DRACO_GENERATED_SOURCES_DIRECTORY) # Controls use of std::mutex and absl::Mutex in ThreadPool. draco_track_configuration_variable(DRACO_THREADPOOL_USE_STD_MUTEX) + if(DRACO_VERBOSE) draco_dump_cmake_flag_variables() draco_dump_tracked_configuration_variables() @@ -68,29 +82,32 @@ draco_reset_target_lists() draco_setup_options() draco_set_build_definitions() draco_set_cxx_flags() +draco_set_exe_linker_flags() draco_generate_features_h() # Draco source file listing variables. -list(APPEND draco_attributes_sources - "${draco_src_root}/attributes/attribute_octahedron_transform.cc" - "${draco_src_root}/attributes/attribute_octahedron_transform.h" - "${draco_src_root}/attributes/attribute_quantization_transform.cc" - "${draco_src_root}/attributes/attribute_quantization_transform.h" - "${draco_src_root}/attributes/attribute_transform.cc" - "${draco_src_root}/attributes/attribute_transform.h" - "${draco_src_root}/attributes/attribute_transform_data.h" - "${draco_src_root}/attributes/attribute_transform_type.h" - "${draco_src_root}/attributes/geometry_attribute.cc" - "${draco_src_root}/attributes/geometry_attribute.h" - "${draco_src_root}/attributes/geometry_indices.h" - "${draco_src_root}/attributes/point_attribute.cc" - "${draco_src_root}/attributes/point_attribute.h") +list( + APPEND draco_attributes_sources + "${draco_src_root}/attributes/attribute_octahedron_transform.cc" + "${draco_src_root}/attributes/attribute_octahedron_transform.h" + "${draco_src_root}/attributes/attribute_quantization_transform.cc" + "${draco_src_root}/attributes/attribute_quantization_transform.h" + "${draco_src_root}/attributes/attribute_transform.cc" + "${draco_src_root}/attributes/attribute_transform.h" + "${draco_src_root}/attributes/attribute_transform_data.h" + "${draco_src_root}/attributes/attribute_transform_type.h" + "${draco_src_root}/attributes/geometry_attribute.cc" + "${draco_src_root}/attributes/geometry_attribute.h" + "${draco_src_root}/attributes/geometry_indices.h" + "${draco_src_root}/attributes/point_attribute.cc" + "${draco_src_root}/attributes/point_attribute.h") list( APPEND draco_compression_attributes_dec_sources "${draco_src_root}/compression/attributes/attributes_decoder.cc" "${draco_src_root}/compression/attributes/attributes_decoder.h" + "${draco_src_root}/compression/attributes/attributes_decoder_interface.h" "${draco_src_root}/compression/attributes/kd_tree_attributes_decoder.cc" "${draco_src_root}/compression/attributes/kd_tree_attributes_decoder.h" "${draco_src_root}/compression/attributes/kd_tree_attributes_shared.h" @@ -107,7 +124,7 @@ list( "${draco_src_root}/compression/attributes/sequential_normal_attribute_decoder.h" "${draco_src_root}/compression/attributes/sequential_quantization_attribute_decoder.cc" "${draco_src_root}/compression/attributes/sequential_quantization_attribute_decoder.h" - ) +) list( APPEND @@ -128,7 +145,7 @@ list( "${draco_src_root}/compression/attributes/sequential_normal_attribute_encoder.h" "${draco_src_root}/compression/attributes/sequential_quantization_attribute_encoder.cc" "${draco_src_root}/compression/attributes/sequential_quantization_attribute_encoder.h" - ) +) list( @@ -160,7 +177,7 @@ list( "${draco_src_root}/compression/attributes/prediction_schemes/prediction_scheme_normal_octahedron_transform_base.h" "${draco_src_root}/compression/attributes/prediction_schemes/prediction_scheme_wrap_decoding_transform.h" "${draco_src_root}/compression/attributes/prediction_schemes/prediction_scheme_wrap_transform_base.h" - ) +) list( APPEND @@ -192,7 +209,7 @@ list( "${draco_src_root}/compression/attributes/prediction_schemes/prediction_scheme_normal_octahedron_transform_base.h" "${draco_src_root}/compression/attributes/prediction_schemes/prediction_scheme_wrap_encoding_transform.h" "${draco_src_root}/compression/attributes/prediction_schemes/prediction_scheme_wrap_transform_base.h" - ) +) list( APPEND @@ -217,27 +234,34 @@ list( "${draco_src_root}/compression/bit_coders/symbol_bit_encoder.cc" "${draco_src_root}/compression/bit_coders/symbol_bit_encoder.h") -list(APPEND draco_enc_config_sources - "${draco_src_root}/compression/config/compression_shared.h" - "${draco_src_root}/compression/config/draco_options.h" - "${draco_src_root}/compression/config/encoder_options.h" - "${draco_src_root}/compression/config/encoding_features.h") +list( + APPEND draco_enc_config_sources + "${draco_src_root}/compression/config/compression_shared.h" + "${draco_src_root}/compression/config/draco_options.h" + "${draco_src_root}/compression/config/encoder_options.h" + "${draco_src_root}/compression/config/encoding_features.h") -list(APPEND draco_dec_config_sources - "${draco_src_root}/compression/config/compression_shared.h" - "${draco_src_root}/compression/config/decoder_options.h" - "${draco_src_root}/compression/config/draco_options.h") +list( + APPEND draco_dec_config_sources + "${draco_src_root}/compression/config/compression_shared.h" + "${draco_src_root}/compression/config/decoder_options.h" + "${draco_src_root}/compression/config/draco_options.h") + +list(APPEND draco_compression_options_sources + "${draco_src_root}/compression/draco_compression_options.cc" + "${draco_src_root}/compression/draco_compression_options.h") list(APPEND draco_compression_decode_sources "${draco_src_root}/compression/decode.cc" "${draco_src_root}/compression/decode.h") -list(APPEND draco_compression_encode_sources - "${draco_src_root}/compression/encode.cc" - "${draco_src_root}/compression/encode.h" - "${draco_src_root}/compression/encode_base.h" - "${draco_src_root}/compression/expert_encode.cc" - "${draco_src_root}/compression/expert_encode.h") +list( + APPEND draco_compression_encode_sources + "${draco_src_root}/compression/encode.cc" + "${draco_src_root}/compression/encode.h" + "${draco_src_root}/compression/encode_base.h" + "${draco_src_root}/compression/expert_encode.cc" + "${draco_src_root}/compression/expert_encode.h") list( APPEND @@ -291,7 +315,7 @@ list( "${draco_src_root}/compression/point_cloud/point_cloud_kd_tree_decoder.h" "${draco_src_root}/compression/point_cloud/point_cloud_sequential_decoder.cc" "${draco_src_root}/compression/point_cloud/point_cloud_sequential_decoder.h" - ) +) list( APPEND @@ -302,112 +326,126 @@ list( "${draco_src_root}/compression/point_cloud/point_cloud_kd_tree_encoder.h" "${draco_src_root}/compression/point_cloud/point_cloud_sequential_encoder.cc" "${draco_src_root}/compression/point_cloud/point_cloud_sequential_encoder.h" - ) +) -list(APPEND draco_compression_entropy_sources - "${draco_src_root}/compression/entropy/ans.h" - "${draco_src_root}/compression/entropy/rans_symbol_coding.h" - "${draco_src_root}/compression/entropy/rans_symbol_decoder.h" - "${draco_src_root}/compression/entropy/rans_symbol_encoder.h" - "${draco_src_root}/compression/entropy/shannon_entropy.cc" - "${draco_src_root}/compression/entropy/shannon_entropy.h" - "${draco_src_root}/compression/entropy/symbol_decoding.cc" - "${draco_src_root}/compression/entropy/symbol_decoding.h" - "${draco_src_root}/compression/entropy/symbol_encoding.cc" - "${draco_src_root}/compression/entropy/symbol_encoding.h") +list( + APPEND draco_compression_entropy_sources + "${draco_src_root}/compression/entropy/ans.h" + "${draco_src_root}/compression/entropy/rans_symbol_coding.h" + "${draco_src_root}/compression/entropy/rans_symbol_decoder.h" + "${draco_src_root}/compression/entropy/rans_symbol_encoder.h" + "${draco_src_root}/compression/entropy/shannon_entropy.cc" + "${draco_src_root}/compression/entropy/shannon_entropy.h" + "${draco_src_root}/compression/entropy/symbol_decoding.cc" + "${draco_src_root}/compression/entropy/symbol_decoding.h" + "${draco_src_root}/compression/entropy/symbol_encoding.cc" + "${draco_src_root}/compression/entropy/symbol_encoding.h") -list(APPEND draco_core_sources - "${draco_src_root}/core/bit_utils.cc" - "${draco_src_root}/core/bit_utils.h" - "${draco_src_root}/core/bounding_box.cc" - "${draco_src_root}/core/bounding_box.h" - "${draco_src_root}/core/cycle_timer.cc" - "${draco_src_root}/core/cycle_timer.h" - "${draco_src_root}/core/data_buffer.cc" - "${draco_src_root}/core/data_buffer.h" - "${draco_src_root}/core/decoder_buffer.cc" - "${draco_src_root}/core/decoder_buffer.h" - "${draco_src_root}/core/divide.cc" - "${draco_src_root}/core/divide.h" - "${draco_src_root}/core/draco_index_type.h" - "${draco_src_root}/core/draco_index_type_vector.h" - "${draco_src_root}/core/draco_types.cc" - "${draco_src_root}/core/draco_types.h" - "${draco_src_root}/core/encoder_buffer.cc" - "${draco_src_root}/core/encoder_buffer.h" - "${draco_src_root}/core/hash_utils.cc" - "${draco_src_root}/core/hash_utils.h" - "${draco_src_root}/core/macros.h" - "${draco_src_root}/core/math_utils.h" - "${draco_src_root}/core/options.cc" - "${draco_src_root}/core/options.h" - "${draco_src_root}/core/quantization_utils.cc" - "${draco_src_root}/core/quantization_utils.h" - "${draco_src_root}/core/status.h" - "${draco_src_root}/core/status_or.h" - "${draco_src_root}/core/varint_decoding.h" - "${draco_src_root}/core/varint_encoding.h" - "${draco_src_root}/core/vector_d.h") +list( + APPEND draco_core_sources + "${draco_src_root}/core/bit_utils.cc" + "${draco_src_root}/core/bit_utils.h" + "${draco_src_root}/core/bounding_box.cc" + "${draco_src_root}/core/bounding_box.h" + "${draco_src_root}/core/constants.h" + "${draco_src_root}/core/cycle_timer.cc" + "${draco_src_root}/core/cycle_timer.h" + "${draco_src_root}/core/data_buffer.cc" + "${draco_src_root}/core/data_buffer.h" + "${draco_src_root}/core/decoder_buffer.cc" + "${draco_src_root}/core/decoder_buffer.h" + "${draco_src_root}/core/divide.cc" + "${draco_src_root}/core/divide.h" + "${draco_src_root}/core/draco_index_type.h" + "${draco_src_root}/core/draco_index_type_vector.h" + "${draco_src_root}/core/draco_types.cc" + "${draco_src_root}/core/draco_types.h" + "${draco_src_root}/core/draco_version.h" + "${draco_src_root}/core/encoder_buffer.cc" + "${draco_src_root}/core/encoder_buffer.h" + "${draco_src_root}/core/hash_utils.cc" + "${draco_src_root}/core/hash_utils.h" + "${draco_src_root}/core/macros.h" + "${draco_src_root}/core/math_utils.h" + "${draco_src_root}/core/options.cc" + "${draco_src_root}/core/options.h" + "${draco_src_root}/core/quantization_utils.cc" + "${draco_src_root}/core/quantization_utils.h" + "${draco_src_root}/core/status.h" + "${draco_src_root}/core/status_or.h" + "${draco_src_root}/core/varint_decoding.h" + "${draco_src_root}/core/varint_encoding.h" + "${draco_src_root}/core/vector_d.h") -list(APPEND draco_io_sources - "${draco_src_root}/io/file_reader_factory.cc" - "${draco_src_root}/io/file_reader_factory.h" - "${draco_src_root}/io/file_reader_interface.h" - "${draco_src_root}/io/file_utils.cc" - "${draco_src_root}/io/file_utils.h" - "${draco_src_root}/io/file_writer_factory.cc" - "${draco_src_root}/io/file_writer_factory.h" - "${draco_src_root}/io/file_writer_interface.h" - "${draco_src_root}/io/file_writer_utils.h" - "${draco_src_root}/io/file_writer_utils.cc" - "${draco_src_root}/io/mesh_io.cc" - "${draco_src_root}/io/mesh_io.h" - "${draco_src_root}/io/obj_decoder.cc" - "${draco_src_root}/io/obj_decoder.h" - "${draco_src_root}/io/obj_encoder.cc" - "${draco_src_root}/io/obj_encoder.h" - "${draco_src_root}/io/parser_utils.cc" - "${draco_src_root}/io/parser_utils.h" - "${draco_src_root}/io/ply_decoder.cc" - "${draco_src_root}/io/ply_decoder.h" - "${draco_src_root}/io/ply_encoder.cc" - "${draco_src_root}/io/ply_encoder.h" - "${draco_src_root}/io/ply_property_reader.h" - "${draco_src_root}/io/ply_property_writer.h" - "${draco_src_root}/io/ply_reader.cc" - "${draco_src_root}/io/ply_reader.h" - "${draco_src_root}/io/point_cloud_io.cc" - "${draco_src_root}/io/point_cloud_io.h" - "${draco_src_root}/io/stdio_file_reader.cc" - "${draco_src_root}/io/stdio_file_reader.h" - "${draco_src_root}/io/stdio_file_writer.cc" - "${draco_src_root}/io/stdio_file_writer.h") +list( + APPEND draco_io_sources + "${draco_src_root}/io/file_reader_factory.cc" + "${draco_src_root}/io/file_reader_factory.h" + "${draco_src_root}/io/file_reader_interface.h" + "${draco_src_root}/io/file_utils.cc" + "${draco_src_root}/io/file_utils.h" + "${draco_src_root}/io/file_writer_factory.cc" + "${draco_src_root}/io/file_writer_factory.h" + "${draco_src_root}/io/file_writer_interface.h" + "${draco_src_root}/io/file_writer_utils.h" + "${draco_src_root}/io/file_writer_utils.cc" + "${draco_src_root}/io/mesh_io.cc" + "${draco_src_root}/io/mesh_io.h" + "${draco_src_root}/io/obj_decoder.cc" + "${draco_src_root}/io/obj_decoder.h" + "${draco_src_root}/io/obj_encoder.cc" + "${draco_src_root}/io/obj_encoder.h" + "${draco_src_root}/io/parser_utils.cc" + "${draco_src_root}/io/parser_utils.h" + "${draco_src_root}/io/ply_decoder.cc" + "${draco_src_root}/io/ply_decoder.h" + "${draco_src_root}/io/ply_encoder.cc" + "${draco_src_root}/io/ply_encoder.h" + "${draco_src_root}/io/ply_property_reader.h" + "${draco_src_root}/io/ply_property_writer.h" + "${draco_src_root}/io/ply_reader.cc" + "${draco_src_root}/io/ply_reader.h" + "${draco_src_root}/io/stl_decoder.cc" + "${draco_src_root}/io/stl_decoder.h" + "${draco_src_root}/io/stl_encoder.cc" + "${draco_src_root}/io/stl_encoder.h" + "${draco_src_root}/io/point_cloud_io.cc" + "${draco_src_root}/io/point_cloud_io.h" + "${draco_src_root}/io/stdio_file_reader.cc" + "${draco_src_root}/io/stdio_file_reader.h" + "${draco_src_root}/io/stdio_file_writer.cc" + "${draco_src_root}/io/stdio_file_writer.h") -list(APPEND draco_mesh_sources - "${draco_src_root}/mesh/corner_table.cc" - "${draco_src_root}/mesh/corner_table.h" - "${draco_src_root}/mesh/corner_table_iterators.h" - "${draco_src_root}/mesh/mesh.cc" - "${draco_src_root}/mesh/mesh.h" - "${draco_src_root}/mesh/mesh_are_equivalent.cc" - "${draco_src_root}/mesh/mesh_are_equivalent.h" - "${draco_src_root}/mesh/mesh_attribute_corner_table.cc" - "${draco_src_root}/mesh/mesh_attribute_corner_table.h" - "${draco_src_root}/mesh/mesh_cleanup.cc" - "${draco_src_root}/mesh/mesh_cleanup.h" - "${draco_src_root}/mesh/mesh_misc_functions.cc" - "${draco_src_root}/mesh/mesh_misc_functions.h" - "${draco_src_root}/mesh/mesh_stripifier.cc" - "${draco_src_root}/mesh/mesh_stripifier.h" - "${draco_src_root}/mesh/triangle_soup_mesh_builder.cc" - "${draco_src_root}/mesh/triangle_soup_mesh_builder.h" - "${draco_src_root}/mesh/valence_cache.h") +list( + APPEND draco_mesh_sources + "${draco_src_root}/mesh/corner_table.cc" + "${draco_src_root}/mesh/corner_table.h" + "${draco_src_root}/mesh/corner_table_iterators.h" + "${draco_src_root}/mesh/mesh.cc" + "${draco_src_root}/mesh/mesh.h" + "${draco_src_root}/mesh/mesh_are_equivalent.cc" + "${draco_src_root}/mesh/mesh_are_equivalent.h" + "${draco_src_root}/mesh/mesh_attribute_corner_table.cc" + "${draco_src_root}/mesh/mesh_attribute_corner_table.h" + "${draco_src_root}/mesh/mesh_cleanup.cc" + "${draco_src_root}/mesh/mesh_cleanup.h" + "${draco_src_root}/mesh/mesh_features.cc" + "${draco_src_root}/mesh/mesh_features.h" + "${draco_src_root}/mesh/mesh_indices.h" + "${draco_src_root}/mesh/mesh_misc_functions.cc" + "${draco_src_root}/mesh/mesh_misc_functions.h" + "${draco_src_root}/mesh/mesh_stripifier.cc" + "${draco_src_root}/mesh/mesh_stripifier.h" + "${draco_src_root}/mesh/triangle_soup_mesh_builder.cc" + "${draco_src_root}/mesh/triangle_soup_mesh_builder.h" + "${draco_src_root}/mesh/valence_cache.h") -list(APPEND draco_point_cloud_sources - "${draco_src_root}/point_cloud/point_cloud.cc" - "${draco_src_root}/point_cloud/point_cloud.h" - "${draco_src_root}/point_cloud/point_cloud_builder.cc" - "${draco_src_root}/point_cloud/point_cloud_builder.h") +list( + APPEND draco_point_cloud_sources + "${draco_src_root}/point_cloud/point_cloud.cc" + "${draco_src_root}/point_cloud/point_cloud.h" + "${draco_src_root}/point_cloud/point_cloud_builder.cc" + "${draco_src_root}/point_cloud/point_cloud_builder.h") list( APPEND @@ -424,7 +462,7 @@ list( "${draco_src_root}/compression/point_cloud/algorithms/dynamic_integer_points_kd_tree_decoder.h" "${draco_src_root}/compression/point_cloud/algorithms/float_points_tree_decoder.cc" "${draco_src_root}/compression/point_cloud/algorithms/float_points_tree_decoder.h" - ) +) list( APPEND @@ -433,13 +471,18 @@ list( "${draco_src_root}/compression/point_cloud/algorithms/dynamic_integer_points_kd_tree_encoder.h" "${draco_src_root}/compression/point_cloud/algorithms/float_points_tree_encoder.cc" "${draco_src_root}/compression/point_cloud/algorithms/float_points_tree_encoder.h" - ) +) -list(APPEND draco_metadata_sources - "${draco_src_root}/metadata/geometry_metadata.cc" - "${draco_src_root}/metadata/geometry_metadata.h" - "${draco_src_root}/metadata/metadata.cc" - "${draco_src_root}/metadata/metadata.h") +list( + APPEND draco_metadata_sources + "${draco_src_root}/metadata/geometry_metadata.cc" + "${draco_src_root}/metadata/geometry_metadata.h" + "${draco_src_root}/metadata/metadata.cc" + "${draco_src_root}/metadata/metadata.h" + "${draco_src_root}/metadata/property_table.cc" + "${draco_src_root}/metadata/property_table.h" + "${draco_src_root}/metadata/structural_metadata.cc" + "${draco_src_root}/metadata/structural_metadata.h") list(APPEND draco_metadata_enc_sources "${draco_src_root}/metadata/metadata_encoder.cc" @@ -465,7 +508,7 @@ list( APPEND draco_js_dec_sources "${draco_src_root}/javascript/emscripten/decoder_webidl_wrapper.cc" "${draco_src_root}/javascript/emscripten/draco_decoder_glue_wrapper.cc" - ) +) list( APPEND draco_js_enc_sources @@ -477,14 +520,14 @@ list( draco_animation_js_dec_sources "${draco_src_root}/javascript/emscripten/animation_decoder_webidl_wrapper.cc" "${draco_src_root}/javascript/emscripten/draco_animation_decoder_glue_wrapper.cc" - ) +) list( APPEND draco_animation_js_enc_sources "${draco_src_root}/javascript/emscripten/animation_encoder_webidl_wrapper.cc" "${draco_src_root}/javascript/emscripten/draco_animation_encoder_glue_wrapper.cc" - ) +) list(APPEND draco_unity_plug_sources "${draco_src_root}/unity/draco_unity_plugin.cc" @@ -494,49 +537,133 @@ list(APPEND draco_maya_plug_sources "${draco_src_root}/maya/draco_maya_plugin.cc" "${draco_src_root}/maya/draco_maya_plugin.h") +if(DRACO_TRANSCODER_SUPPORTED) + list( + APPEND draco_animation_sources + "${draco_src_root}/animation/animation.cc" + "${draco_src_root}/animation/animation.h" + "${draco_src_root}/animation/node_animation_data.h" + "${draco_src_root}/animation/skin.cc" + "${draco_src_root}/animation/skin.h") + + list( + APPEND draco_io_sources + "${draco_src_root}/io/gltf_decoder.cc" + "${draco_src_root}/io/gltf_decoder.h" + "${draco_src_root}/io/gltf_encoder.cc" + "${draco_src_root}/io/gltf_encoder.h" + "${draco_src_root}/io/gltf_utils.cc" + "${draco_src_root}/io/gltf_utils.h" + "${draco_src_root}/io/image_compression_options.h" + "${draco_src_root}/io/scene_io.cc" + "${draco_src_root}/io/scene_io.h" + "${draco_src_root}/io/texture_io.cc" + "${draco_src_root}/io/texture_io.h" + "${draco_src_root}/io/tiny_gltf_utils.cc" + "${draco_src_root}/io/tiny_gltf_utils.h") + + list( + APPEND draco_material_sources + "${draco_src_root}/material/material.cc" + "${draco_src_root}/material/material.h" + "${draco_src_root}/material/material_library.cc" + "${draco_src_root}/material/material_library.h") + + list( + APPEND draco_mesh_sources + "${draco_src_root}/mesh/mesh_connected_components.h" + "${draco_src_root}/mesh/mesh_splitter.cc" + "${draco_src_root}/mesh/mesh_splitter.h" + "${draco_src_root}/mesh/mesh_utils.cc" + "${draco_src_root}/mesh/mesh_utils.h") + + list( + APPEND draco_scene_sources + "${draco_src_root}/scene/instance_array.cc" + "${draco_src_root}/scene/instance_array.h" + "${draco_src_root}/scene/light.cc" + "${draco_src_root}/scene/light.h" + "${draco_src_root}/scene/mesh_group.h" + "${draco_src_root}/scene/scene.cc" + "${draco_src_root}/scene/scene.h" + "${draco_src_root}/scene/scene_are_equivalent.cc" + "${draco_src_root}/scene/scene_are_equivalent.h" + "${draco_src_root}/scene/scene_indices.h" + "${draco_src_root}/scene/scene_node.h" + "${draco_src_root}/scene/scene_utils.cc" + "${draco_src_root}/scene/scene_utils.h" + "${draco_src_root}/scene/trs_matrix.cc" + "${draco_src_root}/scene/trs_matrix.h") + + list( + APPEND draco_texture_sources + "${draco_src_root}/texture/source_image.cc" + "${draco_src_root}/texture/source_image.h" + "${draco_src_root}/texture/texture.h" + "${draco_src_root}/texture/texture_library.cc" + "${draco_src_root}/texture/texture_library.h" + "${draco_src_root}/texture/texture_map.cc" + "${draco_src_root}/texture/texture_map.h" + "${draco_src_root}/texture/texture_transform.cc" + "${draco_src_root}/texture/texture_transform.h" + "${draco_src_root}/texture/texture_utils.cc" + "${draco_src_root}/texture/texture_utils.h") + + +endif() + # # Draco targets. # if(EMSCRIPTEN AND DRACO_JS_GLUE) # Draco decoder and encoder "executable" targets in various flavors for - # Emsscripten. - list(APPEND draco_decoder_src - ${draco_attributes_sources} - ${draco_compression_attributes_dec_sources} - ${draco_compression_attributes_pred_schemes_dec_sources} - ${draco_compression_bit_coders_sources} - ${draco_compression_decode_sources} - ${draco_compression_entropy_sources} - ${draco_compression_mesh_traverser_sources} - ${draco_compression_mesh_dec_sources} - ${draco_compression_point_cloud_dec_sources} - ${draco_core_sources} - ${draco_dec_config_sources} - ${draco_js_dec_sources} - ${draco_mesh_sources} - ${draco_metadata_dec_sources} - ${draco_metadata_sources} - ${draco_point_cloud_sources} - ${draco_points_dec_sources}) + # Emscripten. - list(APPEND draco_encoder_src - ${draco_attributes_sources} - ${draco_compression_attributes_enc_sources} - ${draco_compression_attributes_pred_schemes_enc_sources} - ${draco_compression_bit_coders_sources} - ${draco_compression_encode_sources} - ${draco_compression_entropy_sources} - ${draco_compression_mesh_traverser_sources} - ${draco_compression_mesh_enc_sources} - ${draco_compression_point_cloud_enc_sources} - ${draco_core_sources} - ${draco_enc_config_sources} - ${draco_js_enc_sources} - ${draco_mesh_sources} - ${draco_metadata_enc_sources} - ${draco_metadata_sources} - ${draco_point_cloud_sources} - ${draco_points_enc_sources}) + if(DRACO_TRANSCODER_SUPPORTED) + message(FATAL_ERROR "The transcoder is not supported in Emscripten.") + endif() + + list( + APPEND draco_decoder_src + ${draco_attributes_sources} + ${draco_compression_attributes_dec_sources} + ${draco_compression_attributes_pred_schemes_dec_sources} + ${draco_compression_bit_coders_sources} + ${draco_compression_decode_sources} + ${draco_compression_entropy_sources} + ${draco_compression_mesh_traverser_sources} + ${draco_compression_mesh_dec_sources} + ${draco_compression_options_sources} + ${draco_compression_point_cloud_dec_sources} + ${draco_core_sources} + ${draco_dec_config_sources} + ${draco_js_dec_sources} + ${draco_mesh_sources} + ${draco_metadata_dec_sources} + ${draco_metadata_sources} + ${draco_point_cloud_sources} + ${draco_points_dec_sources}) + + list( + APPEND draco_encoder_src + ${draco_attributes_sources} + ${draco_compression_attributes_enc_sources} + ${draco_compression_attributes_pred_schemes_enc_sources} + ${draco_compression_bit_coders_sources} + ${draco_compression_encode_sources} + ${draco_compression_entropy_sources} + ${draco_compression_mesh_traverser_sources} + ${draco_compression_mesh_enc_sources} + ${draco_compression_options_sources} + ${draco_compression_point_cloud_enc_sources} + ${draco_core_sources} + ${draco_enc_config_sources} + ${draco_js_enc_sources} + ${draco_mesh_sources} + ${draco_metadata_enc_sources} + ${draco_metadata_sources} + ${draco_point_cloud_sources} + ${draco_points_enc_sources}) list(APPEND draco_js_dec_idl "${draco_src_root}/javascript/emscripten/draco_web_decoder.idl") @@ -561,10 +688,10 @@ if(EMSCRIPTEN AND DRACO_JS_GLUE) set(draco_decoder_glue_path "${draco_build}/glue_decoder") set(draco_encoder_glue_path "${draco_build}/glue_encoder") - draco_generate_emscripten_glue(INPUT_IDL ${draco_js_dec_idl} OUTPUT_PATH - ${draco_decoder_glue_path}) - draco_generate_emscripten_glue(INPUT_IDL ${draco_js_enc_idl} OUTPUT_PATH - ${draco_encoder_glue_path}) + draco_generate_emscripten_glue(INPUT_IDL ${draco_js_dec_idl} + OUTPUT_PATH ${draco_decoder_glue_path}) + draco_generate_emscripten_glue(INPUT_IDL ${draco_js_enc_idl} + OUTPUT_PATH ${draco_encoder_glue_path}) if(DRACO_DECODER_ATTRIBUTE_DEDUPLICATION) list(APPEND draco_decoder_features @@ -572,45 +699,28 @@ if(EMSCRIPTEN AND DRACO_JS_GLUE) "DRACO_ATTRIBUTE_VALUES_DEDUPLICATION_SUPPORTED") endif() - draco_add_emscripten_executable(NAME - draco_decoder - SOURCES - ${draco_decoder_src} - DEFINES - ${draco_defines} - FEATURES - ${draco_decoder_features} - INCLUDES - ${draco_include_paths} - LINK_FLAGS - "-sEXPORT_NAME=\"DracoDecoderModule\"" - GLUE_PATH - ${draco_decoder_glue_path} - PRE_LINK_JS_SOURCES - ${draco_pre_link_js_sources} - POST_LINK_JS_SOURCES - ${draco_post_link_js_decoder_sources}) + draco_add_emscripten_executable( + NAME draco_decoder + SOURCES ${draco_decoder_src} + DEFINES ${draco_defines} + FEATURES ${draco_decoder_features} + INCLUDES ${draco_include_paths} + LINK_FLAGS "-sEXPORT_NAME=\"DracoDecoderModule\"" + GLUE_PATH ${draco_decoder_glue_path} + PRE_LINK_JS_SOURCES ${draco_pre_link_js_sources} + POST_LINK_JS_SOURCES ${draco_post_link_js_decoder_sources}) draco_add_emscripten_executable( - NAME - draco_encoder - SOURCES - ${draco_encoder_src} - DEFINES - ${draco_defines} - FEATURES - DRACO_ATTRIBUTE_INDICES_DEDUPLICATION_SUPPORTED - DRACO_ATTRIBUTE_VALUES_DEDUPLICATION_SUPPORTED - INCLUDES - ${draco_include_paths} - LINK_FLAGS - "-sEXPORT_NAME=\"DracoEncoderModule\"" - GLUE_PATH - ${draco_encoder_glue_path} - PRE_LINK_JS_SOURCES - ${draco_pre_link_js_sources} - POST_LINK_JS_SOURCES - ${draco_post_link_js_sources}) + NAME draco_encoder + SOURCES ${draco_encoder_src} + DEFINES ${draco_defines} + FEATURES DRACO_ATTRIBUTE_INDICES_DEDUPLICATION_SUPPORTED + DRACO_ATTRIBUTE_VALUES_DEDUPLICATION_SUPPORTED + INCLUDES ${draco_include_paths} + LINK_FLAGS "-sEXPORT_NAME=\"DracoEncoderModule\"" + GLUE_PATH ${draco_encoder_glue_path} + PRE_LINK_JS_SOURCES ${draco_pre_link_js_sources} + POST_LINK_JS_SOURCES ${draco_post_link_js_sources}) if(DRACO_ANIMATION_ENCODING) set(draco_anim_decoder_glue_path "${draco_build}/glue_animation_decoder") @@ -622,186 +732,270 @@ if(EMSCRIPTEN AND DRACO_JS_GLUE) OUTPUT_PATH ${draco_anim_encoder_glue_path}) draco_add_emscripten_executable( - NAME - draco_animation_decoder - SOURCES - ${draco_animation_dec_sources} - ${draco_animation_js_dec_sources} - ${draco_animation_sources} - ${draco_decoder_src} - DEFINES - ${draco_defines} - INCLUDES - ${draco_include_paths} - LINK_FLAGS - "-sEXPORT_NAME=\"DracoAnimationDecoderModule\"" - GLUE_PATH - ${draco_anim_decoder_glue_path} - PRE_LINK_JS_SOURCES - ${draco_pre_link_js_sources} - POST_LINK_JS_SOURCES - ${draco_post_link_js_decoder_sources}) + NAME draco_animation_decoder + SOURCES ${draco_animation_dec_sources} ${draco_animation_js_dec_sources} + ${draco_animation_sources} ${draco_decoder_src} + DEFINES ${draco_defines} + INCLUDES ${draco_include_paths} + LINK_FLAGS "-sEXPORT_NAME=\"DracoAnimationDecoderModule\"" + GLUE_PATH ${draco_anim_decoder_glue_path} + PRE_LINK_JS_SOURCES ${draco_pre_link_js_sources} + POST_LINK_JS_SOURCES ${draco_post_link_js_decoder_sources}) draco_add_emscripten_executable( - NAME - draco_animation_encoder - SOURCES - ${draco_animation_enc_sources} - ${draco_animation_js_enc_sources} - ${draco_animation_sources} - ${draco_encoder_src} - DEFINES - ${draco_defines} - INCLUDES - ${draco_include_paths} - LINK_FLAGS - "-sEXPORT_NAME=\"DracoAnimationEncoderModule\"" - GLUE_PATH - ${draco_anim_encoder_glue_path} - PRE_LINK_JS_SOURCES - ${draco_pre_link_js_sources} - POST_LINK_JS_SOURCES - ${draco_post_link_js_sources}) + NAME draco_animation_encoder + SOURCES ${draco_animation_enc_sources} ${draco_animation_js_enc_sources} + ${draco_animation_sources} ${draco_encoder_src} + DEFINES ${draco_defines} + INCLUDES ${draco_include_paths} + LINK_FLAGS "-sEXPORT_NAME=\"DracoAnimationEncoderModule\"" + GLUE_PATH ${draco_anim_encoder_glue_path} + PRE_LINK_JS_SOURCES ${draco_pre_link_js_sources} + POST_LINK_JS_SOURCES ${draco_post_link_js_sources}) endif() else() # Standard Draco libs, encoder and decoder. Object collections that mirror the # Draco directory structure. - draco_add_library(NAME draco_attributes TYPE OBJECT SOURCES - ${draco_attributes_sources} DEFINES ${draco_defines} - INCLUDES ${draco_include_paths}) - draco_add_library(NAME - draco_compression_attributes_dec - OBJECT - ${draco_compression_attributes_dec_sources} - TYPE - OBJECT - SOURCES - ${draco_compression_attributes_dec_sources} - DEFINES - ${draco_defines} - INCLUDES - ${draco_include_paths}) - draco_add_library(NAME draco_compression_attributes_enc TYPE OBJECT SOURCES - ${draco_compression_attributes_enc_sources} DEFINES - ${draco_defines} INCLUDES ${draco_include_paths}) - draco_add_library(NAME draco_compression_attributes_pred_schemes_dec TYPE - OBJECT SOURCES - ${draco_compression_attributes_pred_schemes_dec_sources}) - draco_add_library(NAME draco_compression_attributes_pred_schemes_enc TYPE - OBJECT SOURCES - ${draco_compression_attributes_pred_schemes_enc_sources} - DEFINES ${draco_defines} INCLUDES ${draco_include_paths}) - draco_add_library(NAME draco_compression_bit_coders TYPE OBJECT SOURCES - ${draco_compression_bit_coders_sources} DEFINES - ${draco_defines} INCLUDES ${draco_include_paths}) - draco_add_library(NAME draco_enc_config TYPE OBJECT SOURCES - ${draco_enc_config_sources} DEFINES ${draco_defines} - INCLUDES ${draco_include_paths}) - draco_add_library(NAME draco_dec_config TYPE OBJECT SOURCES - ${draco_dec_config_sources} DEFINES ${draco_defines} - INCLUDES ${draco_include_paths}) - draco_add_library(NAME draco_compression_decode TYPE OBJECT SOURCES - ${draco_compression_decode_sources} DEFINES ${draco_defines} - INCLUDES ${draco_include_paths}) - draco_add_library(NAME draco_compression_encode TYPE OBJECT SOURCES - ${draco_compression_encode_sources} DEFINES ${draco_defines} - INCLUDES ${draco_include_paths}) - draco_add_library(NAME draco_compression_entropy TYPE OBJECT SOURCES - ${draco_compression_entropy_sources} DEFINES - ${draco_defines} INCLUDES ${draco_include_paths}) - draco_add_library(NAME draco_compression_mesh_traverser TYPE OBJECT SOURCES - ${draco_compression_mesh_traverser_sources} DEFINES - ${draco_defines} INCLUDES ${draco_include_paths}) - draco_add_library(NAME draco_compression_mesh_dec TYPE OBJECT SOURCES - ${draco_compression_mesh_dec_sources} DEFINES - ${draco_defines} INCLUDES ${draco_include_paths}) - draco_add_library(NAME draco_compression_mesh_enc TYPE OBJECT SOURCES - ${draco_compression_mesh_enc_sources} DEFINES - ${draco_defines} INCLUDES ${draco_include_paths}) - draco_add_library(NAME draco_compression_point_cloud_dec TYPE OBJECT SOURCES - ${draco_compression_point_cloud_dec_sources} DEFINES - ${draco_defines} INCLUDES ${draco_include_paths}) - draco_add_library(NAME draco_compression_point_cloud_enc TYPE OBJECT SOURCES - ${draco_compression_point_cloud_enc_sources} DEFINES - ${draco_defines} INCLUDES ${draco_include_paths}) - draco_add_library(NAME draco_core TYPE OBJECT SOURCES ${draco_core_sources} - DEFINES ${draco_defines} INCLUDES ${draco_include_paths}) - draco_add_library(NAME draco_io TYPE OBJECT SOURCES ${draco_io_sources} - DEFINES ${draco_defines} INCLUDES ${draco_include_paths}) - draco_add_library(NAME draco_mesh TYPE OBJECT SOURCES ${draco_mesh_sources} - DEFINES ${draco_defines} INCLUDES ${draco_include_paths}) - draco_add_library(NAME draco_metadata_dec TYPE OBJECT SOURCES - ${draco_metadata_dec_sources} DEFINES ${draco_defines} - INCLUDES ${draco_include_paths}) - draco_add_library(NAME draco_metadata_enc TYPE OBJECT SOURCES - ${draco_metadata_enc_sources} DEFINES ${draco_defines} - INCLUDES ${draco_include_paths}) - draco_add_library(NAME draco_metadata TYPE OBJECT SOURCES - ${draco_metadata_sources} DEFINES ${draco_defines} INCLUDES - ${draco_include_paths}) - draco_add_library(NAME draco_animation_dec TYPE OBJECT SOURCES - ${draco_animation_dec_sources} DEFINES ${draco_defines} - INCLUDES ${draco_include_paths}) - draco_add_library(NAME draco_animation_enc TYPE OBJECT SOURCES - ${draco_animation_enc_sources} DEFINES ${draco_defines} - INCLUDES ${draco_include_paths}) - draco_add_library(NAME draco_animation TYPE OBJECT SOURCES - ${draco_animation_sources} DEFINES ${draco_defines} INCLUDES - ${draco_include_paths}) - draco_add_library(NAME draco_point_cloud TYPE OBJECT SOURCES - ${draco_point_cloud_sources} DEFINES ${draco_defines} - INCLUDES ${draco_include_paths}) - draco_add_library(NAME - draco_points_dec - TYPE - OBJECT - SOURCES - ${draco_points_common_sources} - ${draco_points_dec_sources} - DEFINES - ${draco_defines} - INCLUDES - ${draco_include_paths}) - draco_add_library(NAME - draco_points_enc - TYPE - OBJECT - SOURCES - ${draco_points_common_sources} - ${draco_points_enc_sources} - DEFINES - ${draco_defines} - INCLUDES - ${draco_include_paths}) + draco_add_library( + NAME draco_attributes + TYPE OBJECT + SOURCES ${draco_attributes_sources} + DEFINES ${draco_defines} + INCLUDES ${draco_include_paths}) + draco_add_library( + NAME draco_compression_attributes_dec OBJECT + ${draco_compression_attributes_dec_sources} + TYPE OBJECT + SOURCES ${draco_compression_attributes_dec_sources} + DEFINES ${draco_defines} + INCLUDES ${draco_include_paths}) + draco_add_library( + NAME draco_compression_attributes_enc + TYPE OBJECT + SOURCES ${draco_compression_attributes_enc_sources} + DEFINES ${draco_defines} + INCLUDES ${draco_include_paths}) + draco_add_library( + NAME draco_compression_attributes_pred_schemes_dec + TYPE OBJECT + SOURCES ${draco_compression_attributes_pred_schemes_dec_sources}) + draco_add_library( + NAME draco_compression_attributes_pred_schemes_enc + TYPE OBJECT + SOURCES ${draco_compression_attributes_pred_schemes_enc_sources} + DEFINES ${draco_defines} + INCLUDES ${draco_include_paths}) + draco_add_library( + NAME draco_compression_bit_coders + TYPE OBJECT + SOURCES ${draco_compression_bit_coders_sources} + DEFINES ${draco_defines} + INCLUDES ${draco_include_paths}) + draco_add_library( + NAME draco_enc_config + TYPE OBJECT + SOURCES ${draco_enc_config_sources} + DEFINES ${draco_defines} + INCLUDES ${draco_include_paths}) + draco_add_library( + NAME draco_dec_config + TYPE OBJECT + SOURCES ${draco_dec_config_sources} + DEFINES ${draco_defines} + INCLUDES ${draco_include_paths}) + draco_add_library( + NAME draco_compression_decode + TYPE OBJECT + SOURCES ${draco_compression_decode_sources} + DEFINES ${draco_defines} + INCLUDES ${draco_include_paths}) + draco_add_library( + NAME draco_compression_encode + TYPE OBJECT + SOURCES ${draco_compression_encode_sources} + DEFINES ${draco_defines} + INCLUDES ${draco_include_paths}) + draco_add_library( + NAME draco_compression_entropy + TYPE OBJECT + SOURCES ${draco_compression_entropy_sources} + DEFINES ${draco_defines} + INCLUDES ${draco_include_paths}) + draco_add_library( + NAME draco_compression_mesh_traverser + TYPE OBJECT + SOURCES ${draco_compression_mesh_traverser_sources} + DEFINES ${draco_defines} + INCLUDES ${draco_include_paths}) + draco_add_library( + NAME draco_compression_mesh_dec + TYPE OBJECT + SOURCES ${draco_compression_mesh_dec_sources} + DEFINES ${draco_defines} + INCLUDES ${draco_include_paths}) + draco_add_library( + NAME draco_compression_mesh_enc + TYPE OBJECT + SOURCES ${draco_compression_mesh_enc_sources} + DEFINES ${draco_defines} + INCLUDES ${draco_include_paths}) + draco_add_library( + NAME draco_compression_options + TYPE OBJECT + SOURCES ${draco_compression_options_sources} + DEFINES ${draco_defines} + INCLUDES ${draco_include_paths}) + draco_add_library( + NAME draco_compression_point_cloud_dec + TYPE OBJECT + SOURCES ${draco_compression_point_cloud_dec_sources} + DEFINES ${draco_defines} + INCLUDES ${draco_include_paths}) + draco_add_library( + NAME draco_compression_point_cloud_enc + TYPE OBJECT + SOURCES ${draco_compression_point_cloud_enc_sources} + DEFINES ${draco_defines} + INCLUDES ${draco_include_paths}) + draco_add_library( + NAME draco_core + TYPE OBJECT + SOURCES ${draco_core_sources} + DEFINES ${draco_defines} + INCLUDES ${draco_include_paths}) + draco_add_library( + NAME draco_io + TYPE OBJECT + SOURCES ${draco_io_sources} + DEFINES ${draco_defines} + INCLUDES ${draco_include_paths}) + draco_add_library( + NAME draco_mesh + TYPE OBJECT + SOURCES ${draco_mesh_sources} + DEFINES ${draco_defines} + INCLUDES ${draco_include_paths}) + draco_add_library( + NAME draco_metadata_dec + TYPE OBJECT + SOURCES ${draco_metadata_dec_sources} + DEFINES ${draco_defines} + INCLUDES ${draco_include_paths}) + draco_add_library( + NAME draco_metadata_enc + TYPE OBJECT + SOURCES ${draco_metadata_enc_sources} + DEFINES ${draco_defines} + INCLUDES ${draco_include_paths}) + draco_add_library( + NAME draco_metadata + TYPE OBJECT + SOURCES ${draco_metadata_sources} + DEFINES ${draco_defines} + INCLUDES ${draco_include_paths}) + draco_add_library( + NAME draco_animation_dec + TYPE OBJECT + SOURCES ${draco_animation_dec_sources} + DEFINES ${draco_defines} + INCLUDES ${draco_include_paths}) + draco_add_library( + NAME draco_animation_enc + TYPE OBJECT + SOURCES ${draco_animation_enc_sources} + DEFINES ${draco_defines} + INCLUDES ${draco_include_paths}) + draco_add_library( + NAME draco_animation + TYPE OBJECT + SOURCES ${draco_animation_sources} + DEFINES ${draco_defines} + INCLUDES ${draco_include_paths}) + draco_add_library( + NAME draco_point_cloud + TYPE OBJECT + SOURCES ${draco_point_cloud_sources} + DEFINES ${draco_defines} + INCLUDES ${draco_include_paths}) + draco_add_library( + NAME draco_points_dec + TYPE OBJECT + SOURCES ${draco_points_common_sources} ${draco_points_dec_sources} + DEFINES ${draco_defines} + INCLUDES ${draco_include_paths}) + draco_add_library( + NAME draco_points_enc + TYPE OBJECT + SOURCES ${draco_points_common_sources} ${draco_points_enc_sources} + DEFINES ${draco_defines} + INCLUDES ${draco_include_paths}) - set(draco_object_library_deps - draco_attributes - draco_compression_attributes_dec - draco_compression_attributes_enc - draco_compression_attributes_pred_schemes_dec - draco_compression_attributes_pred_schemes_enc - draco_compression_bit_coders - draco_compression_decode - draco_compression_encode - draco_compression_entropy - draco_compression_mesh_dec - draco_compression_mesh_enc - draco_compression_point_cloud_dec - draco_compression_point_cloud_enc - draco_core - draco_dec_config - draco_enc_config - draco_io - draco_mesh - draco_metadata - draco_metadata_dec - draco_metadata_enc - draco_animation - draco_animation_dec - draco_animation_enc - draco_point_cloud - draco_points_dec - draco_points_enc) + if(DRACO_TRANSCODER_SUPPORTED) + if(MSVC) + # TODO(https://github.com/google/draco/issues/826) + set_source_files_properties("${draco_src_root}/io/gltf_decoder.cc" + PROPERTIES COMPILE_OPTIONS "/Od") + endif() + + draco_add_library( + NAME draco_material + TYPE OBJECT + SOURCES ${draco_material_sources} + DEFINES ${draco_defines} + INCLUDES ${draco_include_paths}) + + draco_add_library( + NAME draco_scene + TYPE OBJECT + SOURCES ${draco_scene_sources} + DEFINES ${draco_defines} + INCLUDES ${draco_include_paths}) + + draco_add_library( + NAME draco_texture + TYPE OBJECT + SOURCES ${draco_texture_sources} + DEFINES ${draco_defines} + INCLUDES ${draco_include_paths}) + + endif() + + list( + APPEND draco_object_library_deps + draco_attributes + draco_compression_attributes_dec + draco_compression_attributes_enc + draco_compression_attributes_pred_schemes_dec + draco_compression_attributes_pred_schemes_enc + draco_compression_bit_coders + draco_compression_decode + draco_compression_encode + draco_compression_entropy + draco_compression_mesh_dec + draco_compression_mesh_enc + draco_compression_options + draco_compression_point_cloud_dec + draco_compression_point_cloud_enc + draco_core + draco_dec_config + draco_enc_config + draco_io + draco_mesh + draco_metadata + draco_metadata_dec + draco_metadata_enc + draco_animation + draco_animation_dec + draco_animation_enc + draco_point_cloud + draco_points_dec + draco_points_enc) + + if(DRACO_TRANSCODER_SUPPORTED) + list(APPEND draco_object_library_deps draco_material draco_scene + draco_texture) + + endif() # Library targets that consume the object collections. if(MSVC) @@ -809,56 +1003,48 @@ else() # that the exported symbols are part of the DLL target. The unfortunate side # effect of this is that a single configuration cannot output both the # static library and the DLL: This results in an either/or situation. - # Windows users of the draco build can have a DLL and an import library, - # or they can have a static library; they cannot have both from a single + # Windows users of the draco build can have a DLL and an import library, or + # they can have a static library; they cannot have both from a single # configuration of the build. if(BUILD_SHARED_LIBS) set(draco_lib_type SHARED) else() set(draco_lib_type STATIC) endif() - draco_add_library(NAME - draco - OUTPUT_NAME - draco - TYPE - ${draco_lib_type} - DEFINES - ${draco_defines} - INCLUDES - ${draco_include_paths} - OBJLIB_DEPS - ${draco_object_library_deps}) + draco_add_library( + NAME draco + OUTPUT_NAME draco + TYPE ${draco_lib_type} + DEFINES ${draco_defines} + INCLUDES ${draco_include_paths} + OBJLIB_DEPS ${draco_object_library_deps} + LIB_DEPS ${draco_lib_deps}) + add_library(draco::draco ALIAS draco) else() - draco_add_library(NAME - draco_static - OUTPUT_NAME - draco - TYPE - STATIC - DEFINES - ${draco_defines} - INCLUDES - ${draco_include_paths} - OBJLIB_DEPS - ${draco_object_library_deps}) + draco_add_library( + NAME draco_static + OUTPUT_NAME draco + TYPE STATIC + DEFINES ${draco_defines} + INCLUDES ${draco_include_paths} + OBJLIB_DEPS ${draco_object_library_deps} + LIB_DEPS ${draco_lib_deps}) if(BUILD_SHARED_LIBS) - draco_add_library(NAME - draco_shared - SOURCES - "${draco_src_root}/core/draco_version.h" - OUTPUT_NAME - draco - TYPE - SHARED - DEFINES - ${draco_defines} - INCLUDES - ${draco_include_paths} - LIB_DEPS - draco_static) + draco_add_library( + NAME draco_shared + SOURCES "${draco_src_root}/core/draco_version.h" + OUTPUT_NAME draco + TYPE SHARED + DEFINES ${draco_defines} + INCLUDES ${draco_include_paths} + LIB_DEPS draco_static) + add_library(draco::draco ALIAS draco_shared) + set_target_properties(draco_shared PROPERTIES EXPORT_NAME draco) + else() + add_library(draco::draco ALIAS draco_static) + set_target_properties(draco_static PROPERTIES EXPORT_NAME draco) endif() endif() @@ -869,22 +1055,20 @@ else() set(unity_decoder_lib_type MODULE) endif() - draco_add_library(NAME draco_unity_plugin TYPE OBJECT SOURCES - ${draco_unity_plug_sources} DEFINES ${draco_defines} - INCLUDES ${draco_include_paths}) + draco_add_library( + NAME draco_unity_plugin + TYPE OBJECT + SOURCES ${draco_unity_plug_sources} + DEFINES ${draco_defines} + INCLUDES ${draco_include_paths}) - draco_add_library(NAME - dracodec_unity - TYPE - ${unity_decoder_lib_type} - DEFINES - ${draco_defines} - INCLUDES - ${draco_include_paths} - OBJLIB_DEPS - draco_unity_plugin - LIB_DEPS - ${draco_plugin_dependency}) + draco_add_library( + NAME dracodec_unity + TYPE ${unity_decoder_lib_type} + DEFINES ${draco_defines} + INCLUDES ${draco_include_paths} + OBJLIB_DEPS draco_unity_plugin + LIB_DEPS ${draco_plugin_dependency}) # For Mac, we need to build a .bundle for the unity plugin. if(APPLE) @@ -893,22 +1077,20 @@ else() endif() if(DRACO_MAYA_PLUGIN) - draco_add_library(NAME draco_maya_plugin TYPE OBJECT SOURCES - ${draco_maya_plug_sources} DEFINES ${draco_defines} - INCLUDES ${draco_include_paths}) + draco_add_library( + NAME draco_maya_plugin + TYPE OBJECT + SOURCES ${draco_maya_plug_sources} + DEFINES ${draco_defines} + INCLUDES ${draco_include_paths}) - draco_add_library(NAME - draco_maya_wrapper - TYPE - MODULE - DEFINES - ${draco_defines} - INCLUDES - ${draco_include_paths} - OBJLIB_DEPS - draco_maya_plugin - LIB_DEPS - ${draco_plugin_dependency}) + draco_add_library( + NAME draco_maya_wrapper + TYPE MODULE + DEFINES ${draco_defines} + INCLUDES ${draco_include_paths} + OBJLIB_DEPS draco_maya_plugin + LIB_DEPS ${draco_plugin_dependency}) # For Mac, we need to build a .bundle for the plugin. if(APPLE) @@ -917,29 +1099,44 @@ else() endif() # Draco app targets. - draco_add_executable(NAME - draco_decoder - SOURCES - "${draco_src_root}/tools/draco_decoder.cc" - ${draco_io_sources} - DEFINES - ${draco_defines} - INCLUDES - ${draco_include_paths} - LIB_DEPS - ${draco_dependency}) + draco_add_executable( + NAME draco_decoder + SOURCES "${draco_src_root}/tools/draco_decoder.cc" ${draco_io_sources} + DEFINES ${draco_defines} + INCLUDES ${draco_include_paths} + LIB_DEPS ${draco_dependency}) - draco_add_executable(NAME - draco_encoder - SOURCES - "${draco_src_root}/tools/draco_encoder.cc" - ${draco_io_sources} - DEFINES - ${draco_defines} - INCLUDES - ${draco_include_paths} - LIB_DEPS - ${draco_dependency}) + draco_add_executable( + NAME draco_encoder + SOURCES "${draco_src_root}/tools/draco_encoder.cc" ${draco_io_sources} + DEFINES ${draco_defines} + INCLUDES ${draco_include_paths} + LIB_DEPS ${draco_dependency}) + + if(DRACO_TRANSCODER_SUPPORTED) + draco_add_executable( + NAME draco_transcoder + SOURCES "${draco_src_root}/tools/draco_transcoder.cc" + "${draco_src_root}/tools/draco_transcoder_lib.cc" + "${draco_src_root}/tools/draco_transcoder_lib.h" + ${draco_io_sources} + DEFINES ${draco_defines} + INCLUDES ${draco_include_paths} + LIB_DEPS ${draco_dependency}) + + if(DRACO_SIMPLIFIER_SUPPORTED) + draco_add_executable( + NAME draco_simplifier + SOURCES ${draco_pipeline_proto_header} + "${draco_src_root}/tools/draco_simplifier.cc" + "${draco_src_root}/tools/draco_simplifier_lib.cc" + "${draco_src_root}/tools/draco_simplifier_lib.h" + ${draco_io_sources} + DEFINES ${draco_defines} + INCLUDES ${draco_include_paths} + LIB_DEPS ${draco_dependency}) + endif() + endif() draco_setup_install_target() draco_setup_test_targets() diff --git a/contrib/draco/README.md b/contrib/draco/README.md index 0d980b387..4cc717c8d 100644 --- a/contrib/draco/README.md +++ b/contrib/draco/README.md @@ -2,10 +2,93 @@

-[![Build Status](https://github.com/google/draco/workflows/Build/badge.svg)](https://github.com/google/draco/actions?query=workflow%3ABuild) +[![draco-ci](https://github.com/google/draco/workflows/draco-ci/badge.svg?branch=master)](https://github.com/google/draco/actions/workflows/ci.yml) News ======= + +Attention GStatic users: the Draco team strongly recommends using the versioned +URLs for accessing Draco GStatic content. If you are using the URLs that include +the `v1/decoders` substring within the URL, edge caching and GStatic propagation +delays can result in transient errors that can be difficult to diagnose when +new Draco releases are launched. To avoid the issue pin your sites to a +versioned release. + +### Version 1.5.6 release: +* Using the versioned www.gstatic.com WASM and Javascript decoders continues + to be recommended. To use v1.5.6, use this URL: + * https://www.gstatic.com/draco/versioned/decoders/1.5.6/* +* The CMake flag DRACO_DEBUG_MSVC_WARNINGS has been replaced with + DRACO_DEBUG_COMPILER_WARNINGS, and the behavior has changed. It is now a + boolean flag defined in draco_options.cmake. +* Bug fixes. +* Security fixes. + +### Version 1.5.5 release: +* Using the versioned www.gstatic.com WASM and Javascript decoders continues + to be recommended. To use v1.5.5, use this URL: + * https://www.gstatic.com/draco/versioned/decoders/1.5.5/* +* Bug fix: https://github.com/google/draco/issues/935 + +### Version 1.5.4 release: +* Using the versioned www.gstatic.com WASM and Javascript decoders continues + to be recommended. To use v1.5.4, use this URL: + * https://www.gstatic.com/draco/versioned/decoders/1.5.4/* +* Added partial support for glTF extensions EXT_mesh_features and + EXT_structural_metadata. +* Bug fixes. +* Security fixes. + +### Version 1.5.3 release: +* Using the versioned www.gstatic.com WASM and Javascript decoders continues + to be recommended. To use v1.5.3, use this URL: + * https://www.gstatic.com/draco/versioned/decoders/1.5.3/* +* Bug fixes. + +### Version 1.5.2 release +* This is the same as v1.5.1 with the following two bug fixes: + * Fixes DRACO_TRANSCODER_SUPPORTED enabled builds. + * ABI version updated. + +### Version 1.5.1 release +* Adds assertion enabled Emscripten builds to the release, and a subset of the + assertion enabled builds to GStatic. See the file listing below. +* Custom paths to third party dependencies are now supported. See BUILDING.md + for more information. +* The CMake configuration file draco-config.cmake is now tested and known to + work for using Draco in Linux, MacOS, and Windows CMake projects. See the + `install_test` subdirectory of `src/draco/tools` for more information. +* Bug fixes. + +### Version 1.5.0 release +* Adds the draco_transcoder tool. See the section below on the glTF transcoding + tool, and BUILDING.md for build and dependency information. +* Some changes to configuration variables have been made for this release: + - The DRACO_GLTF flag has been renamed to DRACO_GLTF_BITSTREAM to help + increase understanding of its purpose, which is to limit Draco features to + those included in the Draco glTF specification. + - Variables exported in CMake via draco-config.cmake and find-draco.cmake + (formerly FindDraco.cmake) have been renamed. It's unlikely that this + impacts any existing projects as the aforementioned files were not formed + correctly. See [PR775](https://github.com/google/draco/pull/775) for full + details of the changes. +* A CMake version file has been added. +* The CMake install target now uses absolute paths direct from CMake instead + of building them using CMAKE_INSTALL_PREFIX. This was done to make Draco + easier to use for downstream packagers and should have little to no impact on + users picking up Draco from source. +* Certain MSVC warnings have had their levels changed via compiler flag to + reduce the amount of noise output by the MSVC compilers. Set MSVC warning + level to 4, or define DRACO_DEBUG_MSVC_WARNINGS at CMake configuration time + to restore previous behavior. +* Bug fixes. + +### Version 1.4.3 release +* Using the versioned www.gstatic.com WASM and Javascript decoders continues + to be recommended. To use v1.4.3, use this URL: + * https://www.gstatic.com/draco/versioned/decoders/1.4.3/* +* Bug fixes + ### Version 1.4.1 release * Using the versioned www.gstatic.com WASM and Javascript decoders is now recommended. To use v1.4.1, use this URL: @@ -129,6 +212,7 @@ _**Contents**_ * [Encoding Tool](#encoding-tool) * [Encoding Point Clouds](#encoding-point-clouds) * [Decoding Tool](#decoding-tool) + * [glTF Transcoding Tool](#gltf-transcoding-tool) * [C++ Decoder API](#c-decoder-api) * [Javascript Encoder API](#javascript-encoder-api) * [Javascript Decoder API](#javascript-decoder-api) @@ -136,6 +220,7 @@ _**Contents**_ * [Metadata API](#metadata-api) * [NPM Package](#npm-package) * [three.js Renderer Example](#threejs-renderer-example) + * [GStatic Javascript Builds](#gstatic-javascript-builds) * [Support](#support) * [License](#license) * [References](#references) @@ -170,16 +255,18 @@ Command Line Applications ------------------------ The default target created from the build files will be the `draco_encoder` -and `draco_decoder` command line applications. For both applications, if you -run them without any arguments or `-h`, the applications will output usage and -options. +and `draco_decoder` command line applications. Additionally, `draco_transcoder` +is generated when CMake is run with the DRACO_TRANSCODER_SUPPORTED variable set +to ON (see [BUILDING](BUILDING.md#transcoder) for more details). For all +applications, if you run them without any arguments or `-h`, the applications +will output usage and options. Encoding Tool ------------- -`draco_encoder` will read OBJ or PLY files as input, and output Draco-encoded -files. We have included Stanford's [Bunny] mesh for testing. The basic command -line looks like this: +`draco_encoder` will read OBJ, STL or PLY files as input, and output +Draco-encoded files. We have included Stanford's [Bunny] mesh for testing. The +basic command line looks like this: ~~~~~ bash ./draco_encoder -i testdata/bun_zipper.ply -o out.drc @@ -232,15 +319,34 @@ and denser point clouds. Decoding Tool ------------- -`draco_decoder` will read Draco files as input, and output OBJ or PLY files. -The basic command line looks like this: +`draco_decoder` will read Draco files as input, and output OBJ, STL or PLY +files. The basic command line looks like this: ~~~~~ bash ./draco_decoder -i in.drc -o out.obj ~~~~~ +glTF Transcoding Tool +--------------------- + +`draco_transcoder` can be used to add Draco compression to glTF assets. The +basic command line looks like this: + +~~~~~ bash +./draco_transcoder -i in.glb -o out.glb +~~~~~ + +This command line will add geometry compression to all meshes in the `in.glb` +file. Quantization values for different glTF attributes can be specified +similarly to the `draco_encoder` tool. For example `-qp` can be used to define +quantization of the position attribute: + +~~~~~ bash +./draco_transcoder -i in.glb -o out.glb -qp 12 +~~~~~ + C++ Decoder API -------------- +--------------- If you'd like to add decoding to your applications you will need to include the `draco_dec` library. In order to use the Draco decoder you need to @@ -442,6 +548,30 @@ Javascript decoder using the `three.js` renderer. Please see the [javascript/example/README.md](javascript/example/README.md) file for more information. +GStatic Javascript Builds +========================= + +Prebuilt versions of the Emscripten-built Draco javascript decoders are hosted +on www.gstatic.com in version labeled directories: + +https://www.gstatic.com/draco/versioned/decoders/VERSION/* + +As of the v1.4.3 release the files available are: + +- [draco_decoder.js](https://www.gstatic.com/draco/versioned/decoders/1.4.3/draco_decoder.js) +- [draco_decoder.wasm](https://www.gstatic.com/draco/versioned/decoders/1.4.3/draco_decoder.wasm) +- [draco_decoder_gltf.js](https://www.gstatic.com/draco/versioned/decoders/1.4.3/draco_decoder_gltf.js) +- [draco_decoder_gltf.wasm](https://www.gstatic.com/draco/versioned/decoders/1.4.3/draco_decoder_gltf.wasm) +- [draco_wasm_wrapper.js](https://www.gstatic.com/draco/versioned/decoders/1.4.3/draco_wasm_wrapper.js) +- [draco_wasm_wrapper_gltf.js](https://www.gstatic.com/draco/versioned/decoders/1.4.3/draco_wasm_wrapper_gltf.js) + +Beginning with the v1.5.1 release assertion enabled builds of the following +files are available: + +- [draco_decoder.js](https://www.gstatic.com/draco/versioned/decoders/1.5.1/with_asserts/draco_decoder.js) +- [draco_decoder.wasm](https://www.gstatic.com/draco/versioned/decoders/1.5.1/with_asserts/draco_decoder.wasm) +- [draco_wasm_wrapper.js](https://www.gstatic.com/draco/versioned/decoders/1.5.1/with_asserts/draco_wasm_wrapper.js) + Support ======= diff --git a/contrib/draco/cmake/DracoConfig.cmake b/contrib/draco/cmake/DracoConfig.cmake deleted file mode 100644 index be5e1faef..000000000 --- a/contrib/draco/cmake/DracoConfig.cmake +++ /dev/null @@ -1,3 +0,0 @@ -@PACKAGE_INIT@ -set_and_check(draco_INCLUDE_DIR "@PACKAGE_draco_include_install_dir@") -set_and_check(draco_LIBRARY_DIR "@PACKAGE_draco_lib_install_dir@") diff --git a/contrib/draco/cmake/FindDraco.cmake b/contrib/draco/cmake/FindDraco.cmake deleted file mode 100644 index 0a9193065..000000000 --- a/contrib/draco/cmake/FindDraco.cmake +++ /dev/null @@ -1,56 +0,0 @@ -# Finddraco -# -# Locates draco and sets the following variables: -# -# draco_FOUND draco_INCLUDE_DIRS draco_LIBARY_DIRS draco_LIBRARIES -# draco_VERSION_STRING -# -# draco_FOUND is set to YES only when all other variables are successfully -# configured. - -unset(draco_FOUND) -unset(draco_INCLUDE_DIRS) -unset(draco_LIBRARY_DIRS) -unset(draco_LIBRARIES) -unset(draco_VERSION_STRING) - -mark_as_advanced(draco_FOUND) -mark_as_advanced(draco_INCLUDE_DIRS) -mark_as_advanced(draco_LIBRARY_DIRS) -mark_as_advanced(draco_LIBRARIES) -mark_as_advanced(draco_VERSION_STRING) - -set(draco_version_file_no_prefix "draco/src/draco/core/draco_version.h") - -# Set draco_INCLUDE_DIRS -find_path(draco_INCLUDE_DIRS NAMES "${draco_version_file_no_prefix}") - -# Extract the version string from draco_version.h. -if(draco_INCLUDE_DIRS) - set(draco_version_file - "${draco_INCLUDE_DIRS}/draco/src/draco/core/draco_version.h") - file(STRINGS "${draco_version_file}" draco_version REGEX "kdracoVersion") - list(GET draco_version 0 draco_version) - string(REPLACE "static const char kdracoVersion[] = " "" draco_version - "${draco_version}") - string(REPLACE ";" "" draco_version "${draco_version}") - string(REPLACE "\"" "" draco_version "${draco_version}") - set(draco_VERSION_STRING ${draco_version}) -endif() - -# Find the library. -if(BUILD_SHARED_LIBS) - find_library(draco_LIBRARIES NAMES draco.dll libdraco.dylib libdraco.so) -else() - find_library(draco_LIBRARIES NAMES draco.lib libdraco.a) -endif() - -# Store path to library. -get_filename_component(draco_LIBRARY_DIRS ${draco_LIBRARIES} DIRECTORY) - -if(draco_INCLUDE_DIRS - AND draco_LIBRARY_DIRS - AND draco_LIBRARIES - AND draco_VERSION_STRING) - set(draco_FOUND YES) -endif() diff --git a/contrib/draco/cmake/compiler_flags.cmake b/contrib/draco/cmake/compiler_flags.cmake deleted file mode 100644 index 8750e6f7d..000000000 --- a/contrib/draco/cmake/compiler_flags.cmake +++ /dev/null @@ -1,220 +0,0 @@ -if(DRACO_CMAKE_COMPILER_FLAGS_CMAKE_) - return() -endif() -set(DRACO_CMAKE_COMPILER_FLAGS_CMAKE_ 1) - -include(CheckCCompilerFlag) -include(CheckCXXCompilerFlag) -include("${draco_root}/cmake/compiler_tests.cmake") - -# Strings used to cache failed C/CXX flags. -set(DRACO_FAILED_C_FLAGS) -set(DRACO_FAILED_CXX_FLAGS) - -# Checks C compiler for support of $c_flag. Adds $c_flag to $CMAKE_C_FLAGS when -# the compile test passes. Caches $c_flag in $DRACO_FAILED_C_FLAGS when the test -# fails. -macro(add_c_flag_if_supported c_flag) - unset(C_FLAG_FOUND CACHE) - string(FIND "${CMAKE_C_FLAGS}" "${c_flag}" C_FLAG_FOUND) - unset(C_FLAG_FAILED CACHE) - string(FIND "${DRACO_FAILED_C_FLAGS}" "${c_flag}" C_FLAG_FAILED) - - if(${C_FLAG_FOUND} EQUAL -1 AND ${C_FLAG_FAILED} EQUAL -1) - unset(C_FLAG_SUPPORTED CACHE) - message("Checking C compiler flag support for: " ${c_flag}) - check_c_compiler_flag("${c_flag}" C_FLAG_SUPPORTED) - if(${C_FLAG_SUPPORTED}) - set(CMAKE_C_FLAGS "${CMAKE_C_FLAGS} ${c_flag}" CACHE STRING "") - else() - set(DRACO_FAILED_C_FLAGS - "${DRACO_FAILED_C_FLAGS} ${c_flag}" - CACHE STRING "" FORCE) - endif() - endif() -endmacro() - -# Checks C++ compiler for support of $cxx_flag. Adds $cxx_flag to -# $CMAKE_CXX_FLAGS when the compile test passes. Caches $c_flag in -# $DRACO_FAILED_CXX_FLAGS when the test fails. -macro(add_cxx_flag_if_supported cxx_flag) - unset(CXX_FLAG_FOUND CACHE) - string(FIND "${CMAKE_CXX_FLAGS}" "${cxx_flag}" CXX_FLAG_FOUND) - unset(CXX_FLAG_FAILED CACHE) - string(FIND "${DRACO_FAILED_CXX_FLAGS}" "${cxx_flag}" CXX_FLAG_FAILED) - - if(${CXX_FLAG_FOUND} EQUAL -1 AND ${CXX_FLAG_FAILED} EQUAL -1) - unset(CXX_FLAG_SUPPORTED CACHE) - message("Checking CXX compiler flag support for: " ${cxx_flag}) - check_cxx_compiler_flag("${cxx_flag}" CXX_FLAG_SUPPORTED) - if(${CXX_FLAG_SUPPORTED}) - set(CMAKE_CXX_FLAGS "${CMAKE_CXX_FLAGS} ${cxx_flag}" CACHE STRING "") - else() - set(DRACO_FAILED_CXX_FLAGS - "${DRACO_FAILED_CXX_FLAGS} ${cxx_flag}" - CACHE STRING "" FORCE) - endif() - endif() -endmacro() - -# Convenience method for adding a flag to both the C and C++ compiler command -# lines. -macro(add_compiler_flag_if_supported flag) - add_c_flag_if_supported(${flag}) - add_cxx_flag_if_supported(${flag}) -endmacro() - -# Checks C compiler for support of $c_flag and terminates generation when -# support is not present. -macro(require_c_flag c_flag update_c_flags) - unset(C_FLAG_FOUND CACHE) - string(FIND "${CMAKE_C_FLAGS}" "${c_flag}" C_FLAG_FOUND) - - if(${C_FLAG_FOUND} EQUAL -1) - unset(HAVE_C_FLAG CACHE) - message("Checking C compiler flag support for: " ${c_flag}) - check_c_compiler_flag("${c_flag}" HAVE_C_FLAG) - if(NOT ${HAVE_C_FLAG}) - message( - FATAL_ERROR "${PROJECT_NAME} requires support for C flag: ${c_flag}.") - endif() - if(${update_c_flags}) - set(CMAKE_C_FLAGS "${c_flag} ${CMAKE_C_FLAGS}" CACHE STRING "" FORCE) - endif() - endif() -endmacro() - -# Checks CXX compiler for support of $cxx_flag and terminates generation when -# support is not present. -macro(require_cxx_flag cxx_flag update_cxx_flags) - unset(CXX_FLAG_FOUND CACHE) - string(FIND "${CMAKE_CXX_FLAGS}" "${cxx_flag}" CXX_FLAG_FOUND) - - if(${CXX_FLAG_FOUND} EQUAL -1) - unset(HAVE_CXX_FLAG CACHE) - message("Checking CXX compiler flag support for: " ${cxx_flag}) - check_cxx_compiler_flag("${cxx_flag}" HAVE_CXX_FLAG) - if(NOT ${HAVE_CXX_FLAG}) - message( - FATAL_ERROR - "${PROJECT_NAME} requires support for CXX flag: ${cxx_flag}.") - endif() - if(${update_cxx_flags}) - set(CMAKE_CXX_FLAGS - "${cxx_flag} ${CMAKE_CXX_FLAGS}" - CACHE STRING "" FORCE) - endif() - endif() -endmacro() - -# Checks for support of $flag by both the C and CXX compilers. Terminates -# generation when support is not present in both compilers. -macro(require_compiler_flag flag update_cmake_flags) - require_c_flag(${flag} ${update_cmake_flags}) - require_cxx_flag(${flag} ${update_cmake_flags}) -endmacro() - -# Checks only non-MSVC targets for support of $c_flag and terminates generation -# when support is not present. -macro(require_c_flag_nomsvc c_flag update_c_flags) - if(NOT MSVC) - require_c_flag(${c_flag} ${update_c_flags}) - endif() -endmacro() - -# Checks only non-MSVC targets for support of $cxx_flag and terminates -# generation when support is not present. -macro(require_cxx_flag_nomsvc cxx_flag update_cxx_flags) - if(NOT MSVC) - require_cxx_flag(${cxx_flag} ${update_cxx_flags}) - endif() -endmacro() - -# Checks only non-MSVC targets for support of $flag by both the C and CXX -# compilers. Terminates generation when support is not present in both -# compilers. -macro(require_compiler_flag_nomsvc flag update_cmake_flags) - require_c_flag_nomsvc(${flag} ${update_cmake_flags}) - require_cxx_flag_nomsvc(${flag} ${update_cmake_flags}) -endmacro() - -# Adds $flag to assembler command line. -macro(append_as_flag flag) - unset(AS_FLAG_FOUND CACHE) - string(FIND "${DRACO_AS_FLAGS}" "${flag}" AS_FLAG_FOUND) - - if(${AS_FLAG_FOUND} EQUAL -1) - set(DRACO_AS_FLAGS "${DRACO_AS_FLAGS} ${flag}") - endif() -endmacro() - -# Adds $flag to the C compiler command line. -macro(append_c_flag flag) - unset(C_FLAG_FOUND CACHE) - string(FIND "${CMAKE_C_FLAGS}" "${flag}" C_FLAG_FOUND) - - if(${C_FLAG_FOUND} EQUAL -1) - set(CMAKE_C_FLAGS "${CMAKE_C_FLAGS} ${flag}") - endif() -endmacro() - -# Adds $flag to the CXX compiler command line. -macro(append_cxx_flag flag) - unset(CXX_FLAG_FOUND CACHE) - string(FIND "${CMAKE_CXX_FLAGS}" "${flag}" CXX_FLAG_FOUND) - - if(${CXX_FLAG_FOUND} EQUAL -1) - set(CMAKE_CXX_FLAGS "${CMAKE_CXX_FLAGS} ${flag}") - endif() -endmacro() - -# Adds $flag to the C and CXX compiler command lines. -macro(append_compiler_flag flag) - append_c_flag(${flag}) - append_cxx_flag(${flag}) -endmacro() - -# Adds $flag to the executable linker command line. -macro(append_exe_linker_flag flag) - unset(LINKER_FLAG_FOUND CACHE) - string(FIND "${CMAKE_EXE_LINKER_FLAGS}" "${flag}" LINKER_FLAG_FOUND) - - if(${LINKER_FLAG_FOUND} EQUAL -1) - set(CMAKE_EXE_LINKER_FLAGS "${CMAKE_EXE_LINKER_FLAGS} ${flag}") - endif() -endmacro() - -# Adds $flag to the link flags for $target. -function(append_link_flag_to_target target flags) - unset(target_link_flags) - get_target_property(target_link_flags ${target} LINK_FLAGS) - - if(target_link_flags) - unset(link_flag_found) - string(FIND "${target_link_flags}" "${flags}" link_flag_found) - - if(NOT ${link_flag_found} EQUAL -1) - return() - endif() - - set(target_link_flags "${target_link_flags} ${flags}") - else() - set(target_link_flags "${flags}") - endif() - - set_target_properties(${target} PROPERTIES LINK_FLAGS ${target_link_flags}) -endfunction() - -# Adds $flag to executable linker flags, and makes sure C/CXX builds still work. -macro(require_linker_flag flag) - append_exe_linker_flag(${flag}) - - unset(c_passed) - draco_check_c_compiles("LINKER_FLAG_C_TEST(${flag})" "" c_passed) - unset(cxx_passed) - draco_check_cxx_compiles("LINKER_FLAG_CXX_TEST(${flag})" "" cxx_passed) - - if(NOT c_passed OR NOT cxx_passed) - message(FATAL_ERROR "Linker flag test for ${flag} failed.") - endif() -endmacro() diff --git a/contrib/draco/cmake/compiler_tests.cmake b/contrib/draco/cmake/compiler_tests.cmake deleted file mode 100644 index e781a6537..000000000 --- a/contrib/draco/cmake/compiler_tests.cmake +++ /dev/null @@ -1,103 +0,0 @@ -if(DRACO_CMAKE_COMPILER_TESTS_CMAKE_) - return() -endif() -set(DRACO_CMAKE_COMPILER_TESTS_CMAKE_ 1) - -include(CheckCSourceCompiles) -include(CheckCXXSourceCompiles) - -# The basic main() macro used in all compile tests. -set(DRACO_C_MAIN "\nint main(void) { return 0; }") -set(DRACO_CXX_MAIN "\nint main() { return 0; }") - -# Strings containing the names of passed and failed tests. -set(DRACO_C_PASSED_TESTS) -set(DRACO_C_FAILED_TESTS) -set(DRACO_CXX_PASSED_TESTS) -set(DRACO_CXX_FAILED_TESTS) - -macro(draco_push_var var new_value) - set(SAVED_${var} ${var}) - set(${var} ${new_value}) -endmacro() - -macro(draco_pop_var var) - set(var ${SAVED_${var}}) - unset(SAVED_${var}) -endmacro() - -# Confirms $test_source compiles and stores $test_name in one of -# $DRACO_C_PASSED_TESTS or $DRACO_C_FAILED_TESTS depending on out come. When the -# test passes $result_var is set to 1. When it fails $result_var is unset. The -# test is not run if the test name is found in either of the passed or failed -# test variables. -macro(draco_check_c_compiles test_name test_source result_var) - unset(C_TEST_PASSED CACHE) - unset(C_TEST_FAILED CACHE) - string(FIND "${DRACO_C_PASSED_TESTS}" "${test_name}" C_TEST_PASSED) - string(FIND "${DRACO_C_FAILED_TESTS}" "${test_name}" C_TEST_FAILED) - if(${C_TEST_PASSED} EQUAL -1 AND ${C_TEST_FAILED} EQUAL -1) - unset(C_TEST_COMPILED CACHE) - message("Running C compiler test: ${test_name}") - check_c_source_compiles("${test_source} ${DRACO_C_MAIN}" C_TEST_COMPILED) - set(${result_var} ${C_TEST_COMPILED}) - - if(${C_TEST_COMPILED}) - set(DRACO_C_PASSED_TESTS "${DRACO_C_PASSED_TESTS} ${test_name}") - else() - set(DRACO_C_FAILED_TESTS "${DRACO_C_FAILED_TESTS} ${test_name}") - message("C Compiler test ${test_name} failed.") - endif() - elseif(NOT ${C_TEST_PASSED} EQUAL -1) - set(${result_var} 1) - else() # ${C_TEST_FAILED} NOT EQUAL -1 - unset(${result_var}) - endif() -endmacro() - -# Confirms $test_source compiles and stores $test_name in one of -# $DRACO_CXX_PASSED_TESTS or $DRACO_CXX_FAILED_TESTS depending on out come. When -# the test passes $result_var is set to 1. When it fails $result_var is unset. -# The test is not run if the test name is found in either of the passed or -# failed test variables. -macro(draco_check_cxx_compiles test_name test_source result_var) - unset(CXX_TEST_PASSED CACHE) - unset(CXX_TEST_FAILED CACHE) - string(FIND "${DRACO_CXX_PASSED_TESTS}" "${test_name}" CXX_TEST_PASSED) - string(FIND "${DRACO_CXX_FAILED_TESTS}" "${test_name}" CXX_TEST_FAILED) - if(${CXX_TEST_PASSED} EQUAL -1 AND ${CXX_TEST_FAILED} EQUAL -1) - unset(CXX_TEST_COMPILED CACHE) - message("Running CXX compiler test: ${test_name}") - check_cxx_source_compiles("${test_source} ${DRACO_CXX_MAIN}" - CXX_TEST_COMPILED) - set(${result_var} ${CXX_TEST_COMPILED}) - - if(${CXX_TEST_COMPILED}) - set(DRACO_CXX_PASSED_TESTS "${DRACO_CXX_PASSED_TESTS} ${test_name}") - else() - set(DRACO_CXX_FAILED_TESTS "${DRACO_CXX_FAILED_TESTS} ${test_name}") - message("CXX Compiler test ${test_name} failed.") - endif() - elseif(NOT ${CXX_TEST_PASSED} EQUAL -1) - set(${result_var} 1) - else() # ${CXX_TEST_FAILED} NOT EQUAL -1 - unset(${result_var}) - endif() -endmacro() - -# Convenience macro that confirms $test_source compiles as C and C++. -# $result_var is set to 1 when both tests are successful, and 0 when one or both -# tests fail. Note: This macro is intended to be used to write to result -# variables that are expanded via configure_file(). $result_var is set to 1 or 0 -# to allow direct usage of the value in generated source files. -macro(draco_check_source_compiles test_name test_source result_var) - unset(C_PASSED) - unset(CXX_PASSED) - draco_check_c_compiles(${test_name} ${test_source} C_PASSED) - draco_check_cxx_compiles(${test_name} ${test_source} CXX_PASSED) - if(${C_PASSED} AND ${CXX_PASSED}) - set(${result_var} 1) - else() - set(${result_var} 0) - endif() -endmacro() diff --git a/contrib/draco/cmake/draco-config.cmake.template b/contrib/draco/cmake/draco-config.cmake.template index ca4a456bf..ed86823ea 100644 --- a/contrib/draco/cmake/draco-config.cmake.template +++ b/contrib/draco/cmake/draco-config.cmake.template @@ -1,2 +1,3 @@ -set(DRACO_INCLUDE_DIRS "@DRACO_INCLUDE_DIRS@") -set(DRACO_LIBRARIES "draco") +@PACKAGE_INIT@ + +include("${CMAKE_CURRENT_LIST_DIR}/draco-targets.cmake") diff --git a/contrib/draco/cmake/draco.pc.template b/contrib/draco/cmake/draco.pc.template index b8ae48212..050219ccb 100644 --- a/contrib/draco/cmake/draco.pc.template +++ b/contrib/draco/cmake/draco.pc.template @@ -1,11 +1,6 @@ -prefix=@prefix@ -exec_prefix=@exec_prefix@ -libdir=@libdir@ -includedir=@includedir@ - Name: @PROJECT_NAME@ Description: Draco geometry de(com)pression library. Version: @DRACO_VERSION@ -Cflags: -I${includedir} -Libs: -L${libdir} -ldraco +Cflags: -I@includes_path@ +Libs: -L@libs_path@ -ldraco Libs.private: @CMAKE_THREAD_LIBS_INIT@ diff --git a/contrib/draco/cmake/draco_build_definitions.cmake b/contrib/draco/cmake/draco_build_definitions.cmake index f7354c15f..4dc232333 100644 --- a/contrib/draco/cmake/draco_build_definitions.cmake +++ b/contrib/draco/cmake/draco_build_definitions.cmake @@ -1,3 +1,17 @@ +# Copyright 2021 The Draco Authors +# +# Licensed under the Apache License, Version 2.0 (the "License"); you may not +# use this file except in compliance with the License. You may obtain a copy of +# the License at +# +# http://www.apache.org/licenses/LICENSE-2.0 +# +# Unless required by applicable law or agreed to in writing, software +# distributed under the License is distributed on an "AS IS" BASIS, WITHOUT +# WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the +# License for the specific language governing permissions and limitations under +# the License. + if(DRACO_CMAKE_DRACO_BUILD_DEFINITIONS_CMAKE_) return() endif() # DRACO_CMAKE_DRACO_BUILD_DEFINITIONS_CMAKE_ @@ -17,10 +31,6 @@ macro(set_draco_target) endif() set(draco_plugin_dependency draco_static) endif() - - if(BUILD_SHARED_LIBS) - set(CMAKE_POSITION_INDEPENDENT_CODE ON) - endif() endmacro() # Configures flags and sets build system globals. @@ -36,23 +46,37 @@ macro(draco_set_build_definitions) endif() draco_load_version_info() - set(DRACO_SOVERSION 1) + + # Library version info. See the libtool docs for updating the values: + # https://www.gnu.org/software/libtool/manual/libtool.html#Updating-version-info + # + # c=, r=, a= + # + # libtool generates a .so file as .so.[c-a].a.r, while -version-info c:r:a is + # passed to libtool. + # + # We set DRACO_SOVERSION = [c-a].a.r + set(LT_CURRENT 8) + set(LT_REVISION 0) + set(LT_AGE 0) + math(EXPR DRACO_SOVERSION_MAJOR "${LT_CURRENT} - ${LT_AGE}") + set(DRACO_SOVERSION "${DRACO_SOVERSION_MAJOR}.${LT_AGE}.${LT_REVISION}") + unset(LT_CURRENT) + unset(LT_REVISION) + unset(LT_AGE) list(APPEND draco_include_paths "${draco_root}" "${draco_root}/src" "${draco_build}") - if(DRACO_ABSL) - list(APPEND draco_include_path "${draco_root}/third_party/abseil-cpp") + if(DRACO_TRANSCODER_SUPPORTED) + draco_setup_eigen() + draco_setup_filesystem() + draco_setup_tinygltf() + + endif() - list(APPEND draco_gtest_include_paths - "${draco_root}/../googletest/googlemock/include" - "${draco_root}/../googletest/googlemock" - "${draco_root}/../googletest/googletest/include" - "${draco_root}/../googletest/googletest") - list(APPEND draco_test_include_paths ${draco_include_paths} - ${draco_gtest_include_paths}) list(APPEND draco_defines "DRACO_CMAKE=1" "DRACO_FLAGS_SRCDIR=\"${draco_root}\"" "DRACO_FLAGS_TMPDIR=\"/tmp\"") @@ -63,11 +87,22 @@ macro(draco_set_build_definitions) if(BUILD_SHARED_LIBS) set(CMAKE_WINDOWS_EXPORT_ALL_SYMBOLS TRUE) endif() - else() + endif() + + if(NOT MSVC) if(${CMAKE_SIZEOF_VOID_P} EQUAL 8) # Ensure 64-bit platforms can support large files. list(APPEND draco_defines "_LARGEFILE_SOURCE" "_FILE_OFFSET_BITS=64") endif() + + if(NOT DRACO_DEBUG_COMPILER_WARNINGS) + if(CMAKE_CXX_COMPILER_ID STREQUAL "Clang") + list(APPEND draco_clang_cxx_flags + "-Wno-implicit-const-int-float-conversion") + else() + list(APPEND draco_base_cxx_flags "-Wno-deprecated-declarations") + endif() + endif() endif() if(ANDROID) @@ -102,13 +137,9 @@ macro(draco_set_build_definitions) set(draco_neon_source_file_suffix "neon.cc") set(draco_sse4_source_file_suffix "sse4.cc") - if((${CMAKE_CXX_COMPILER_ID} - STREQUAL - "GNU" - AND ${CMAKE_CXX_COMPILER_VERSION} VERSION_LESS 5) - OR (${CMAKE_CXX_COMPILER_ID} - STREQUAL - "Clang" + if((${CMAKE_CXX_COMPILER_ID} STREQUAL "GNU" AND ${CMAKE_CXX_COMPILER_VERSION} + VERSION_LESS 5) + OR (${CMAKE_CXX_COMPILER_ID} STREQUAL "Clang" AND ${CMAKE_CXX_COMPILER_VERSION} VERSION_LESS 4)) message( WARNING "GNU/GCC < v5 or Clang/LLVM < v4, ENABLING COMPATIBILITY MODE.") @@ -117,7 +148,9 @@ macro(draco_set_build_definitions) if(EMSCRIPTEN) draco_check_emscripten_environment() - draco_get_required_emscripten_flags(FLAG_LIST_VAR draco_base_cxx_flags) + draco_get_required_emscripten_flags( + FLAG_LIST_VAR_COMPILER draco_base_cxx_flags + FLAG_LIST_VAR_LINKER draco_base_exe_linker_flags) endif() draco_configure_sanitizer() diff --git a/contrib/draco/cmake/draco_cpu_detection.cmake b/contrib/draco/cmake/draco_cpu_detection.cmake index 96e4a289b..c3b77b80c 100644 --- a/contrib/draco/cmake/draco_cpu_detection.cmake +++ b/contrib/draco/cmake/draco_cpu_detection.cmake @@ -1,3 +1,17 @@ +# Copyright 2021 The Draco Authors +# +# Licensed under the Apache License, Version 2.0 (the "License"); you may not +# use this file except in compliance with the License. You may obtain a copy of +# the License at +# +# http://www.apache.org/licenses/LICENSE-2.0 +# +# Unless required by applicable law or agreed to in writing, software +# distributed under the License is distributed on an "AS IS" BASIS, WITHOUT +# WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the +# License for the specific language governing permissions and limitations under +# the License. + if(DRACO_CMAKE_DRACO_CPU_DETECTION_CMAKE_) return() endif() # DRACO_CMAKE_DRACO_CPU_DETECTION_CMAKE_ diff --git a/contrib/draco/cmake/draco_dependencies.cmake b/contrib/draco/cmake/draco_dependencies.cmake new file mode 100644 index 000000000..91ee0839b --- /dev/null +++ b/contrib/draco/cmake/draco_dependencies.cmake @@ -0,0 +1,136 @@ +# Copyright 2022 The Draco Authors +# +# Licensed under the Apache License, Version 2.0 (the "License"); you may not +# use this file except in compliance with the License. You may obtain a copy of +# the License at +# +# http://www.apache.org/licenses/LICENSE-2.0 +# +# Unless required by applicable law or agreed to in writing, software +# distributed under the License is distributed on an "AS IS" BASIS, WITHOUT +# WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the +# License for the specific language governing permissions and limitations under +# the License. + +if(DRACO_CMAKE_DRACO_DEPENDENCIES_CMAKE) + return() +endif() +set(DRACO_CMAKE_DRACO_DEPENDENCIES_CMAKE 1) + +include("${draco_root}/cmake/draco_variables.cmake") + +# Each variable holds a user specified custom path to a local copy of the +# sources that belong to each project that Draco depends on. When paths are +# empty the build will be generated pointing to the Draco git submodules. +# Otherwise the paths specified by the user will be used in the build +# configuration. + +# Path to the Eigen. The path must contain the Eigen directory. +set(DRACO_EIGEN_PATH) +draco_track_configuration_variable(DRACO_EIGEN_PATH) + +# Path to the gulrak/filesystem installation. The path specified must contain +# the ghc subdirectory that houses the filesystem includes. +set(DRACO_FILESYSTEM_PATH) +draco_track_configuration_variable(DRACO_FILESYSTEM_PATH) + +# Path to the googletest installation. The path must be to the root of the +# Googletest project directory. +set(DRACO_GOOGLETEST_PATH) +draco_track_configuration_variable(DRACO_GOOGLETEST_PATH) + +# Path to the syoyo/tinygltf installation. The path must be to the root of the +# project directory. +set(DRACO_TINYGLTF_PATH) +draco_track_configuration_variable(DRACO_TINYGLTF_PATH) + +# Utility macro for killing the build due to a missing submodule directory. +macro(draco_die_missing_submodule dir) + message(FATAL_ERROR "${dir} missing, run git submodule update --init") +endmacro() + +# Determines the Eigen location and updates the build configuration accordingly. +macro(draco_setup_eigen) + if(DRACO_EIGEN_PATH) + set(eigen_path "${DRACO_EIGEN_PATH}") + + if(NOT IS_DIRECTORY "${eigen_path}") + message(FATAL_ERROR "DRACO_EIGEN_PATH does not exist.") + endif() + else() + set(eigen_path "${draco_root}/third_party/eigen") + + if(NOT IS_DIRECTORY "${eigen_path}") + draco_die_missing_submodule("${eigen_path}") + endif() + endif() + + set(eigen_include_path "${eigen_path}/Eigen") + + if(NOT EXISTS "${eigen_path}/Eigen") + message(FATAL_ERROR "The eigen path does not contain an Eigen directory.") + endif() + + list(APPEND draco_include_paths "${eigen_path}") +endmacro() + +# Determines the gulrak/filesystem location and updates the build configuration +# accordingly. +macro(draco_setup_filesystem) + if(DRACO_FILESYSTEM_PATH) + set(fs_path "${DRACO_FILESYSTEM_PATH}") + + if(NOT IS_DIRECTORY "${fs_path}") + message(FATAL_ERROR "DRACO_FILESYSTEM_PATH does not exist.") + endif() + else() + set(fs_path "${draco_root}/third_party/filesystem/include") + + if(NOT IS_DIRECTORY "${fs_path}") + draco_die_missing_submodule("${fs_path}") + endif() + endif() + + list(APPEND draco_include_paths "${fs_path}") +endmacro() + +# Determines the Googletest location and sets up include and source list vars +# for the draco_tests build. +macro(draco_setup_googletest) + if(DRACO_GOOGLETEST_PATH) + set(gtest_path "${DRACO_GOOGLETEST_PATH}") + if(NOT IS_DIRECTORY "${gtest_path}") + message(FATAL_ERROR "DRACO_GOOGLETEST_PATH does not exist.") + endif() + else() + set(gtest_path "${draco_root}/third_party/googletest") + endif() + + list(APPEND draco_test_include_paths ${draco_include_paths} + "${gtest_path}/include" "${gtest_path}/googlemock" + "${gtest_path}/googletest/include" "${gtest_path}/googletest") + + list(APPEND draco_gtest_all "${gtest_path}/googletest/src/gtest-all.cc") + list(APPEND draco_gtest_main "${gtest_path}/googletest/src/gtest_main.cc") +endmacro() + + +# Determines the location of TinyGLTF and updates the build configuration +# accordingly. +macro(draco_setup_tinygltf) + if(DRACO_TINYGLTF_PATH) + set(tinygltf_path "${DRACO_TINYGLTF_PATH}") + + if(NOT IS_DIRECTORY "${tinygltf_path}") + message(FATAL_ERROR "DRACO_TINYGLTF_PATH does not exist.") + endif() + else() + set(tinygltf_path "${draco_root}/third_party/tinygltf") + + if(NOT IS_DIRECTORY "${tinygltf_path}") + draco_die_missing_submodule("${tinygltf_path}") + endif() + endif() + + list(APPEND draco_include_paths "${tinygltf_path}") +endmacro() diff --git a/contrib/draco/cmake/draco_emscripten.cmake b/contrib/draco/cmake/draco_emscripten.cmake index 10c935043..c9616ae86 100644 --- a/contrib/draco/cmake/draco_emscripten.cmake +++ b/contrib/draco/cmake/draco_emscripten.cmake @@ -1,3 +1,17 @@ +# Copyright 2021 The Draco Authors +# +# Licensed under the Apache License, Version 2.0 (the "License"); you may not +# use this file except in compliance with the License. You may obtain a copy of +# the License at +# +# http://www.apache.org/licenses/LICENSE-2.0 +# +# Unless required by applicable law or agreed to in writing, software +# distributed under the License is distributed on an "AS IS" BASIS, WITHOUT +# WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the +# License for the specific language governing permissions and limitations under +# the License. + if(DRACO_CMAKE_DRACO_EMSCRIPTEN_CMAKE_) return() endif() # DRACO_CMAKE_DRACO_EMSCRIPTEN_CMAKE_ @@ -18,39 +32,64 @@ endmacro() # Obtains the required Emscripten flags for Draco targets. macro(draco_get_required_emscripten_flags) - set(em_FLAG_LIST_VAR) + set(em_FLAG_LIST_VAR_COMPILER) + set(em_FLAG_LIST_VAR_LINKER) set(em_flags) - set(em_single_arg_opts FLAG_LIST_VAR) + set(em_single_arg_opts FLAG_LIST_VAR_COMPILER FLAG_LIST_VAR_LINKER) set(em_multi_arg_opts) cmake_parse_arguments(em "${em_flags}" "${em_single_arg_opts}" "${em_multi_arg_opts}" ${ARGN}) - if(NOT em_FLAG_LIST_VAR) - message(FATAL "draco_get_required_emscripten_flags: FLAG_LIST_VAR required") + if(NOT em_FLAG_LIST_VAR_COMPILER) + message( + FATAL + "draco_get_required_emscripten_flags: FLAG_LIST_VAR_COMPILER required") + endif() + + if(NOT em_FLAG_LIST_VAR_LINKER) + message( + FATAL + "draco_get_required_emscripten_flags: FLAG_LIST_VAR_LINKER required") endif() if(DRACO_JS_GLUE) unset(required_flags) - list(APPEND ${em_FLAG_LIST_VAR} "-sALLOW_MEMORY_GROWTH=1") - list(APPEND ${em_FLAG_LIST_VAR} "-Wno-almost-asm") - list(APPEND ${em_FLAG_LIST_VAR} "--memory-init-file" "0") - list(APPEND ${em_FLAG_LIST_VAR} "-fno-omit-frame-pointer") - list(APPEND ${em_FLAG_LIST_VAR} "-sMODULARIZE=1") - list(APPEND ${em_FLAG_LIST_VAR} "-sNO_FILESYSTEM=1") - list(APPEND ${em_FLAG_LIST_VAR} "-sEXPORTED_RUNTIME_METHODS=[]") - list(APPEND ${em_FLAG_LIST_VAR} "-sPRECISE_F32=1") - list(APPEND ${em_FLAG_LIST_VAR} "-sNODEJS_CATCH_EXIT=0") - list(APPEND ${em_FLAG_LIST_VAR} "-sNODEJS_CATCH_REJECTION=0") + # TODO(tomfinegan): Revisit splitting of compile/link flags for Emscripten, + # and drop -Wno-unused-command-line-argument. Emscripten complains about + # what are supposedly link-only flags sent with compile commands, but then + # proceeds to produce broken code if the warnings are heeded. + list(APPEND ${em_FLAG_LIST_VAR_COMPILER} + "-Wno-unused-command-line-argument") + + list(APPEND ${em_FLAG_LIST_VAR_COMPILER} "-Wno-almost-asm") + list(APPEND ${em_FLAG_LIST_VAR_COMPILER} "--memory-init-file" "0") + list(APPEND ${em_FLAG_LIST_VAR_COMPILER} "-fno-omit-frame-pointer") + + # According to Emscripten the following flags are linker only, but sending + # these flags (en masse) to only the linker results in a broken Emscripten + # build with an empty DracoDecoderModule. + list(APPEND ${em_FLAG_LIST_VAR_COMPILER} "-sALLOW_MEMORY_GROWTH=1") + list(APPEND ${em_FLAG_LIST_VAR_COMPILER} "-sMODULARIZE=1") + list(APPEND ${em_FLAG_LIST_VAR_COMPILER} "-sFILESYSTEM=0") + list(APPEND ${em_FLAG_LIST_VAR_COMPILER} + "-sEXPORTED_FUNCTIONS=[\"_free\",\"_malloc\"]") + list(APPEND ${em_FLAG_LIST_VAR_COMPILER} "-sPRECISE_F32=1") + list(APPEND ${em_FLAG_LIST_VAR_COMPILER} "-sNODEJS_CATCH_EXIT=0") + list(APPEND ${em_FLAG_LIST_VAR_COMPILER} "-sNODEJS_CATCH_REJECTION=0") if(DRACO_FAST) - list(APPEND ${em_FLAG_LIST_VAR} "--llvm-lto" "1") + list(APPEND ${em_FLAG_LIST_VAR_COMPILER} "--llvm-lto" "1") endif() + + # The WASM flag is reported as linker only. if(DRACO_WASM) - list(APPEND ${em_FLAG_LIST_VAR} "-sWASM=1") + list(APPEND ${em_FLAG_LIST_VAR_COMPILER} "-sWASM=1") else() - list(APPEND ${em_FLAG_LIST_VAR} "-sWASM=0") + list(APPEND ${em_FLAG_LIST_VAR_COMPILER} "-sWASM=0") endif() + + # The LEGACY_VM_SUPPORT flag is reported as linker only. if(DRACO_IE_COMPATIBLE) - list(APPEND ${em_FLAG_LIST_VAR} "-sLEGACY_VM_SUPPORT=1") + list(APPEND ${em_FLAG_LIST_VAR_COMPILER} "-sLEGACY_VM_SUPPORT=1") endif() endif() endmacro() @@ -66,10 +105,11 @@ macro(draco_generate_emscripten_glue) "${glue_multi_arg_opts}" ${ARGN}) if(DRACO_VERBOSE GREATER 1) - message("--------- draco_generate_emscripten_glue -----------\n" - "glue_INPUT_IDL=${glue_INPUT_IDL}\n" - "glue_OUTPUT_PATH=${glue_OUTPUT_PATH}\n" ] - "----------------------------------------------------\n") + message( + "--------- draco_generate_emscripten_glue -----------\n" + "glue_INPUT_IDL=${glue_INPUT_IDL}\n" + "glue_OUTPUT_PATH=${glue_OUTPUT_PATH}\n" + "----------------------------------------------------\n") endif() if(NOT glue_INPUT_IDL OR NOT glue_OUTPUT_PATH) @@ -79,22 +119,22 @@ macro(draco_generate_emscripten_glue) endif() # Generate the glue source. - execute_process(COMMAND ${PYTHON_EXECUTABLE} - $ENV{EMSCRIPTEN}/tools/webidl_binder.py - ${glue_INPUT_IDL} ${glue_OUTPUT_PATH}) + execute_process( + COMMAND ${PYTHON_EXECUTABLE} $ENV{EMSCRIPTEN}/tools/webidl_binder.py + ${glue_INPUT_IDL} ${glue_OUTPUT_PATH}) if(NOT EXISTS "${glue_OUTPUT_PATH}.cpp") message(FATAL_ERROR "JS glue generation failed for ${glue_INPUT_IDL}.") endif() # Create a dependency so that it regenerated on edits. - add_custom_command(OUTPUT "${glue_OUTPUT_PATH}.cpp" - COMMAND ${PYTHON_EXECUTABLE} - $ENV{EMSCRIPTEN}/tools/webidl_binder.py - ${glue_INPUT_IDL} ${glue_OUTPUT_PATH} - DEPENDS ${draco_js_dec_idl} - COMMENT "Generating ${glue_OUTPUT_PATH}.cpp." - WORKING_DIRECTORY ${draco_build} - VERBATIM) + add_custom_command( + OUTPUT "${glue_OUTPUT_PATH}.cpp" + COMMAND ${PYTHON_EXECUTABLE} $ENV{EMSCRIPTEN}/tools/webidl_binder.py + ${glue_INPUT_IDL} ${glue_OUTPUT_PATH} + DEPENDS ${draco_js_dec_idl} + COMMENT "Generating ${glue_OUTPUT_PATH}.cpp." + WORKING_DIRECTORY ${draco_build} + VERBATIM) endmacro() # Wrapper for draco_add_executable() that handles the extra work necessary for @@ -120,8 +160,14 @@ macro(draco_add_emscripten_executable) unset(emexe_LINK_FLAGS) set(optional_args) set(single_value_args NAME GLUE_PATH) - set(multi_value_args SOURCES DEFINES FEATURES INCLUDES LINK_FLAGS - PRE_LINK_JS_SOURCES POST_LINK_JS_SOURCES) + set(multi_value_args + SOURCES + DEFINES + FEATURES + INCLUDES + LINK_FLAGS + PRE_LINK_JS_SOURCES + POST_LINK_JS_SOURCES) cmake_parse_arguments(emexe "${optional_args}" "${single_value_args}" "${multi_value_args}" ${ARGN}) @@ -136,49 +182,50 @@ macro(draco_add_emscripten_executable) endif() if(DRACO_VERBOSE GREATER 1) - message("--------- draco_add_emscripten_executable ---------\n" - "emexe_NAME=${emexe_NAME}\n" - "emexe_SOURCES=${emexe_SOURCES}\n" - "emexe_DEFINES=${emexe_DEFINES}\n" - "emexe_INCLUDES=${emexe_INCLUDES}\n" - "emexe_LINK_FLAGS=${emexe_LINK_FLAGS}\n" - "emexe_GLUE_PATH=${emexe_GLUE_PATH}\n" - "emexe_FEATURES=${emexe_FEATURES}\n" - "emexe_PRE_LINK_JS_SOURCES=${emexe_PRE_LINK_JS_SOURCES}\n" - "emexe_POST_LINK_JS_SOURCES=${emexe_POST_LINK_JS_SOURCES}\n" - "----------------------------------------------------\n") + message( + "--------- draco_add_emscripten_executable ---------\n" + "emexe_NAME=${emexe_NAME}\n" + "emexe_SOURCES=${emexe_SOURCES}\n" + "emexe_DEFINES=${emexe_DEFINES}\n" + "emexe_INCLUDES=${emexe_INCLUDES}\n" + "emexe_LINK_FLAGS=${emexe_LINK_FLAGS}\n" + "emexe_GLUE_PATH=${emexe_GLUE_PATH}\n" + "emexe_FEATURES=${emexe_FEATURES}\n" + "emexe_PRE_LINK_JS_SOURCES=${emexe_PRE_LINK_JS_SOURCES}\n" + "emexe_POST_LINK_JS_SOURCES=${emexe_POST_LINK_JS_SOURCES}\n" + "----------------------------------------------------\n") endif() # The Emscripten linker needs the C++ flags in addition to whatever has been # passed in with the target. list(APPEND emexe_LINK_FLAGS ${DRACO_CXX_FLAGS}) - if(DRACO_GLTF) - draco_add_executable(NAME - ${emexe_NAME} - OUTPUT_NAME - ${emexe_NAME}_gltf - SOURCES - ${emexe_SOURCES} - DEFINES - ${emexe_DEFINES} - INCLUDES - ${emexe_INCLUDES} - LINK_FLAGS - ${emexe_LINK_FLAGS}) + if(DRACO_GLTF_BITSTREAM) + # Add "_gltf" suffix to target output name. + draco_add_executable( + NAME ${emexe_NAME} + OUTPUT_NAME ${emexe_NAME}_gltf + SOURCES ${emexe_SOURCES} + DEFINES ${emexe_DEFINES} + INCLUDES ${emexe_INCLUDES} + LINK_FLAGS ${emexe_LINK_FLAGS}) else() - draco_add_executable(NAME ${emexe_NAME} SOURCES ${emexe_SOURCES} DEFINES - ${emexe_DEFINES} INCLUDES ${emexe_INCLUDES} LINK_FLAGS - ${emexe_LINK_FLAGS}) + draco_add_executable( + NAME ${emexe_NAME} + SOURCES ${emexe_SOURCES} + DEFINES ${emexe_DEFINES} + INCLUDES ${emexe_INCLUDES} + LINK_FLAGS ${emexe_LINK_FLAGS}) endif() foreach(feature ${emexe_FEATURES}) draco_enable_feature(FEATURE ${feature} TARGETS ${emexe_NAME}) endforeach() - set_property(SOURCE ${emexe_SOURCES} - APPEND - PROPERTY OBJECT_DEPENDS "${emexe_GLUE_PATH}.cpp") + set_property( + SOURCE ${emexe_SOURCES} + APPEND + PROPERTY OBJECT_DEPENDS "${emexe_GLUE_PATH}.cpp") em_link_pre_js(${emexe_NAME} ${emexe_PRE_LINK_JS_SOURCES}) em_link_post_js(${emexe_NAME} "${emexe_GLUE_PATH}.js" ${emexe_POST_LINK_JS_SOURCES}) diff --git a/contrib/draco/cmake/draco_flags.cmake b/contrib/draco/cmake/draco_flags.cmake index 0397859a4..f3b24c6e1 100644 --- a/contrib/draco/cmake/draco_flags.cmake +++ b/contrib/draco/cmake/draco_flags.cmake @@ -1,3 +1,17 @@ +# Copyright 2021 The Draco Authors +# +# Licensed under the Apache License, Version 2.0 (the "License"); you may not +# use this file except in compliance with the License. You may obtain a copy of +# the License at +# +# http://www.apache.org/licenses/LICENSE-2.0 +# +# Unless required by applicable law or agreed to in writing, software +# distributed under the License is distributed on an "AS IS" BASIS, WITHOUT +# WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the +# License for the specific language governing permissions and limitations under +# the License. + if(DRACO_CMAKE_DRACO_FLAGS_CMAKE_) return() endif() # DRACO_CMAKE_DRACO_FLAGS_CMAKE_ @@ -24,7 +38,7 @@ macro(draco_set_compiler_flags_for_sources) endif() set_source_files_properties(${compiler_SOURCES} PROPERTIES COMPILE_FLAGS - ${compiler_FLAGS}) + ${compiler_FLAGS}) if(DRACO_VERBOSE GREATER 1) foreach(source ${compiler_SOURCES}) @@ -85,8 +99,8 @@ macro(draco_test_cxx_flag) # are passed as a list it will remove the list separators, and attempt to run # a compile command using list entries concatenated together as a single # argument. Avoid the problem by forcing the argument to be a string. - draco_set_and_stringify(SOURCE_VARS all_cxx_flags DEST all_cxx_flags) - check_cxx_compiler_flag("${all_cxx_flags}" draco_all_cxx_flags_pass) + draco_set_and_stringify(SOURCE_VARS all_cxx_flags DEST all_cxx_flags_string) + check_cxx_compiler_flag("${all_cxx_flags_string}" draco_all_cxx_flags_pass) if(cxx_test_FLAG_REQUIRED AND NOT draco_all_cxx_flags_pass) draco_die("Flag test failed for required flag(s): " @@ -245,3 +259,34 @@ macro(draco_set_cxx_flags) draco_test_cxx_flag(FLAG_LIST_VAR_NAMES ${cxx_flag_lists}) endif() endmacro() + +# Collects Draco built-in and user-specified linker flags and tests them. Halts +# configuration and reports the error when any flags cause the build to fail. +# +# Note: draco_test_exe_linker_flag() does the real work of setting the flags and +# running the test compile commands. +macro(draco_set_exe_linker_flags) + unset(linker_flag_lists) + + if(DRACO_VERBOSE) + message("draco_set_exe_linker_flags: " + "draco_base_exe_linker_flags=${draco_base_exe_linker_flags}") + endif() + + if(draco_base_exe_linker_flags) + list(APPEND linker_flag_lists draco_base_exe_linker_flags) + endif() + + if(linker_flag_lists) + unset(test_linker_flags) + + if(DRACO_VERBOSE) + message("draco_set_exe_linker_flags: " + "linker_flag_lists=${linker_flag_lists}") + endif() + + draco_set_and_stringify(DEST test_linker_flags SOURCE_VARS + ${linker_flag_lists}) + draco_test_exe_linker_flag(FLAG_LIST_VAR_NAME test_linker_flags) + endif() +endmacro() diff --git a/contrib/draco/cmake/draco_helpers.cmake b/contrib/draco/cmake/draco_helpers.cmake index 0b3b804cf..69e24c5be 100644 --- a/contrib/draco/cmake/draco_helpers.cmake +++ b/contrib/draco/cmake/draco_helpers.cmake @@ -1,3 +1,17 @@ +# Copyright 2021 The Draco Authors +# +# Licensed under the Apache License, Version 2.0 (the "License"); you may not +# use this file except in compliance with the License. You may obtain a copy of +# the License at +# +# http://www.apache.org/licenses/LICENSE-2.0 +# +# Unless required by applicable law or agreed to in writing, software +# distributed under the License is distributed on an "AS IS" BASIS, WITHOUT +# WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the +# License for the specific language governing permissions and limitations under +# the License. + if(DRACO_CMAKE_DRACO_HELPERS_CMAKE_) return() endif() # DRACO_CMAKE_DRACO_HELPERS_CMAKE_ diff --git a/contrib/draco/cmake/draco_install.cmake b/contrib/draco/cmake/draco_install.cmake index 09bfb591d..3be1ba163 100644 --- a/contrib/draco/cmake/draco_install.cmake +++ b/contrib/draco/cmake/draco_install.cmake @@ -1,32 +1,32 @@ +# Copyright 2021 The Draco Authors +# +# Licensed under the Apache License, Version 2.0 (the "License"); you may not +# use this file except in compliance with the License. You may obtain a copy of +# the License at +# +# http://www.apache.org/licenses/LICENSE-2.0 +# +# Unless required by applicable law or agreed to in writing, software +# distributed under the License is distributed on an "AS IS" BASIS, WITHOUT +# WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the +# License for the specific language governing permissions and limitations under +# the License. + if(DRACO_CMAKE_DRACO_INSTALL_CMAKE_) return() endif() # DRACO_CMAKE_DRACO_INSTALL_CMAKE_ set(DRACO_CMAKE_DRACO_INSTALL_CMAKE_ 1) +include(CMakePackageConfigHelpers) +include(GNUInstallDirs) + # Sets up the draco install targets. Must be called after the static library # target is created. macro(draco_setup_install_target) - include(GNUInstallDirs) - - # pkg-config: draco.pc - set(prefix "${CMAKE_INSTALL_PREFIX}") - set(exec_prefix "\${prefix}") - set(libdir "\${prefix}/${CMAKE_INSTALL_LIBDIR}") - set(includedir "\${prefix}/${CMAKE_INSTALL_INCLUDEDIR}") - set(draco_lib_name "draco") - - configure_file("${draco_root}/cmake/draco.pc.template" - "${draco_build}/draco.pc" @ONLY NEWLINE_STYLE UNIX) - install(FILES "${draco_build}/draco.pc" - DESTINATION "${prefix}/${CMAKE_INSTALL_LIBDIR}/pkgconfig") - - # CMake config: draco-config.cmake - set(DRACO_INCLUDE_DIRS "${prefix}/${CMAKE_INSTALL_INCLUDEDIR}") - configure_file("${draco_root}/cmake/draco-config.cmake.template" - "${draco_build}/draco-config.cmake" @ONLY NEWLINE_STYLE UNIX) - install( - FILES "${draco_build}/draco-config.cmake" - DESTINATION "${CMAKE_INSTALL_PREFIX}/${CMAKE_INSTALL_DATAROOTDIR}/cmake") + set(bin_path "${CMAKE_INSTALL_BINDIR}") + set(data_path "${CMAKE_INSTALL_DATAROOTDIR}") + set(includes_path "${CMAKE_INSTALL_INCLUDEDIR}") + set(libs_path "${CMAKE_INSTALL_LIBDIR}") foreach(file ${draco_sources}) if(file MATCHES "h$") @@ -34,46 +34,88 @@ macro(draco_setup_install_target) endif() endforeach() + list(REMOVE_DUPLICATES draco_api_includes) + # Strip $draco_src_root from the file paths: we need to install relative to # $include_directory. list(TRANSFORM draco_api_includes REPLACE "${draco_src_root}/" "") - set(include_directory "${CMAKE_INSTALL_PREFIX}/${CMAKE_INSTALL_INCLUDEDIR}") foreach(draco_api_include ${draco_api_includes}) get_filename_component(file_directory ${draco_api_include} DIRECTORY) - set(target_directory "${include_directory}/draco/${file_directory}") + set(target_directory "${includes_path}/draco/${file_directory}") install(FILES ${draco_src_root}/${draco_api_include} DESTINATION "${target_directory}") endforeach() - install( - FILES "${draco_build}/draco/draco_features.h" - DESTINATION "${CMAKE_INSTALL_PREFIX}/${CMAKE_INSTALL_INCLUDEDIR}/draco/") + install(FILES "${draco_build}/draco/draco_features.h" + DESTINATION "${includes_path}/draco/") - install(TARGETS draco_decoder DESTINATION - "${CMAKE_INSTALL_PREFIX}/${CMAKE_INSTALL_BINDIR}") - install(TARGETS draco_encoder DESTINATION - "${CMAKE_INSTALL_PREFIX}/${CMAKE_INSTALL_BINDIR}") + install(TARGETS draco_decoder DESTINATION "${bin_path}") + install(TARGETS draco_encoder DESTINATION "${bin_path}") + + if(DRACO_TRANSCODER_SUPPORTED) + install(TARGETS draco_transcoder DESTINATION "${bin_path}") + endif() if(MSVC) - install(TARGETS draco DESTINATION - "${CMAKE_INSTALL_PREFIX}/${CMAKE_INSTALL_LIBDIR}") + install( + TARGETS draco + EXPORT dracoExport + RUNTIME DESTINATION "${bin_path}" + ARCHIVE DESTINATION "${libs_path}" + LIBRARY DESTINATION "${libs_path}") else() - install(TARGETS draco_static DESTINATION - "${CMAKE_INSTALL_PREFIX}/${CMAKE_INSTALL_LIBDIR}") + install( + TARGETS draco_static + EXPORT dracoExport + DESTINATION "${libs_path}") + if(BUILD_SHARED_LIBS) - install(TARGETS draco_shared DESTINATION - "${CMAKE_INSTALL_PREFIX}/${CMAKE_INSTALL_LIBDIR}") + install( + TARGETS draco_shared + EXPORT dracoExport + RUNTIME DESTINATION "${bin_path}" + ARCHIVE DESTINATION "${libs_path}" + LIBRARY DESTINATION "${libs_path}") endif() endif() if(DRACO_UNITY_PLUGIN) - install(TARGETS dracodec_unity DESTINATION - "${CMAKE_INSTALL_PREFIX}/${CMAKE_INSTALL_LIBDIR}") - endif() - if(DRACO_MAYA_PLUGIN) - install(TARGETS draco_maya_wrapper DESTINATION - "${CMAKE_INSTALL_PREFIX}/${CMAKE_INSTALL_LIBDIR}") + install(TARGETS dracodec_unity DESTINATION "${libs_path}") endif() + if(DRACO_MAYA_PLUGIN) + install(TARGETS draco_maya_wrapper DESTINATION "${libs_path}") + endif() + + # pkg-config: draco.pc + configure_file("${draco_root}/cmake/draco.pc.template" + "${draco_build}/draco.pc" @ONLY NEWLINE_STYLE UNIX) + install(FILES "${draco_build}/draco.pc" DESTINATION "${libs_path}/pkgconfig") + + # CMake config: draco-config.cmake + configure_package_config_file( + "${draco_root}/cmake/draco-config.cmake.template" + "${draco_build}/draco-config.cmake" + INSTALL_DESTINATION "${data_path}/cmake/draco") + + write_basic_package_version_file( + "${draco_build}/draco-config-version.cmake" + VERSION ${DRACO_VERSION} + COMPATIBILITY AnyNewerVersion) + + export( + EXPORT dracoExport + NAMESPACE draco:: + FILE "${draco_build}/draco-targets.cmake") + + install( + EXPORT dracoExport + NAMESPACE draco:: + FILE draco-targets.cmake + DESTINATION "${data_path}/cmake/draco") + + install(FILES "${draco_build}/draco-config.cmake" + "${draco_build}/draco-config-version.cmake" + DESTINATION "${data_path}/cmake/draco") endmacro() diff --git a/contrib/draco/cmake/draco_intrinsics.cmake b/contrib/draco/cmake/draco_intrinsics.cmake index 9011c0de5..178df97a6 100644 --- a/contrib/draco/cmake/draco_intrinsics.cmake +++ b/contrib/draco/cmake/draco_intrinsics.cmake @@ -1,3 +1,17 @@ +# Copyright 2021 The Draco Authors +# +# Licensed under the Apache License, Version 2.0 (the "License"); you may not +# use this file except in compliance with the License. You may obtain a copy of +# the License at +# +# http://www.apache.org/licenses/LICENSE-2.0 +# +# Unless required by applicable law or agreed to in writing, software +# distributed under the License is distributed on an "AS IS" BASIS, WITHOUT +# WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the +# License for the specific language governing permissions and limitations under +# the License. + if(DRACO_CMAKE_DRACO_INTRINSICS_CMAKE_) return() endif() # DRACO_CMAKE_DRACO_INTRINSICS_CMAKE_ @@ -61,17 +75,15 @@ macro(draco_process_intrinsics_sources) unset(sse4_sources) list(APPEND sse4_sources ${arg_SOURCES}) - list(FILTER sse4_sources INCLUDE REGEX - "${draco_sse4_source_file_suffix}$") + list(FILTER sse4_sources INCLUDE REGEX "${draco_sse4_source_file_suffix}$") if(sse4_sources) unset(sse4_flags) - draco_get_intrinsics_flag_for_suffix(SUFFIX - ${draco_sse4_source_file_suffix} - VARIABLE sse4_flags) + draco_get_intrinsics_flag_for_suffix( + SUFFIX ${draco_sse4_source_file_suffix} VARIABLE sse4_flags) if(sse4_flags) draco_set_compiler_flags_for_sources(SOURCES ${sse4_sources} FLAGS - ${sse4_flags}) + ${sse4_flags}) endif() endif() endif() @@ -79,17 +91,15 @@ macro(draco_process_intrinsics_sources) if(DRACO_ENABLE_NEON AND draco_have_neon) unset(neon_sources) list(APPEND neon_sources ${arg_SOURCES}) - list(FILTER neon_sources INCLUDE REGEX - "${draco_neon_source_file_suffix}$") + list(FILTER neon_sources INCLUDE REGEX "${draco_neon_source_file_suffix}$") if(neon_sources AND DRACO_NEON_INTRINSICS_FLAG) unset(neon_flags) - draco_get_intrinsics_flag_for_suffix(SUFFIX - ${draco_neon_source_file_suffix} - VARIABLE neon_flags) + draco_get_intrinsics_flag_for_suffix( + SUFFIX ${draco_neon_source_file_suffix} VARIABLE neon_flags) if(neon_flags) draco_set_compiler_flags_for_sources(SOURCES ${neon_sources} FLAGS - ${neon_flags}) + ${neon_flags}) endif() endif() endif() diff --git a/contrib/draco/cmake/draco_options.cmake b/contrib/draco/cmake/draco_options.cmake index 832bfb69f..085149774 100644 --- a/contrib/draco/cmake/draco_options.cmake +++ b/contrib/draco/cmake/draco_options.cmake @@ -1,3 +1,17 @@ +# Copyright 2021 The Draco Authors +# +# Licensed under the Apache License, Version 2.0 (the "License"); you may not +# use this file except in compliance with the License. You may obtain a copy of +# the License at +# +# http://www.apache.org/licenses/LICENSE-2.0 +# +# Unless required by applicable law or agreed to in writing, software +# distributed under the License is distributed on an "AS IS" BASIS, WITHOUT +# WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the +# License for the specific language governing permissions and limitations under +# the License. + if(DRACO_CMAKE_DRACO_OPTIONS_CMAKE_) return() endif() # DRACO_CMAKE_DRACO_OPTIONS_CMAKE_ @@ -18,17 +32,22 @@ macro(draco_option) cmake_parse_arguments(option "${optional_args}" "${single_value_args}" "${multi_value_args}" ${ARGN}) - if(NOT (option_NAME AND option_HELPSTRING AND DEFINED option_VALUE)) + if(NOT + (option_NAME + AND option_HELPSTRING + AND DEFINED option_VALUE)) message(FATAL_ERROR "draco_option: NAME HELPSTRING and VALUE required.") endif() option(${option_NAME} ${option_HELPSTRING} ${option_VALUE}) if(DRACO_VERBOSE GREATER 2) - message("--------- draco_option ---------\n" "option_NAME=${option_NAME}\n" - "option_HELPSTRING=${option_HELPSTRING}\n" - "option_VALUE=${option_VALUE}\n" - "------------------------------------------\n") + message( + "--------- draco_option ---------\n" + "option_NAME=${option_NAME}\n" + "option_HELPSTRING=${option_HELPSTRING}\n" + "option_VALUE=${option_VALUE}\n" + "------------------------------------------\n") endif() list(APPEND draco_options ${option_NAME}) @@ -44,33 +63,74 @@ endmacro() # Set default options. macro(draco_set_default_options) - draco_option(NAME DRACO_FAST HELPSTRING "Try to build faster libs." VALUE OFF) - draco_option(NAME DRACO_JS_GLUE HELPSTRING - "Enable JS Glue and JS targets when using Emscripten." VALUE ON) - draco_option(NAME DRACO_IE_COMPATIBLE HELPSTRING - "Enable support for older IE builds when using Emscripten." VALUE - OFF) - draco_option(NAME DRACO_MESH_COMPRESSION HELPSTRING "Enable mesh compression." - VALUE ON) - draco_option(NAME DRACO_POINT_CLOUD_COMPRESSION HELPSTRING - "Enable point cloud compression." VALUE ON) - draco_option(NAME DRACO_PREDICTIVE_EDGEBREAKER HELPSTRING - "Enable predictive edgebreaker." VALUE ON) - draco_option(NAME DRACO_STANDARD_EDGEBREAKER HELPSTRING - "Enable stand edgebreaker." VALUE ON) - draco_option(NAME DRACO_BACKWARDS_COMPATIBILITY HELPSTRING - "Enable backwards compatibility." VALUE ON) - draco_option(NAME DRACO_DECODER_ATTRIBUTE_DEDUPLICATION HELPSTRING - "Enable attribute deduping." VALUE OFF) - draco_option(NAME DRACO_TESTS HELPSTRING "Enables tests." VALUE OFF) - draco_option(NAME DRACO_WASM HELPSTRING "Enables WASM support." VALUE OFF) - draco_option(NAME DRACO_UNITY_PLUGIN HELPSTRING - "Build plugin library for Unity." VALUE OFF) - draco_option(NAME DRACO_ANIMATION_ENCODING HELPSTRING "Enable animation." - VALUE OFF) - draco_option(NAME DRACO_GLTF HELPSTRING "Support GLTF." VALUE OFF) - draco_option(NAME DRACO_MAYA_PLUGIN HELPSTRING - "Build plugin library for Maya." VALUE OFF) + draco_option( + NAME DRACO_FAST + HELPSTRING "Try to build faster libs." + VALUE OFF) + draco_option( + NAME DRACO_JS_GLUE + HELPSTRING "Enable JS Glue and JS targets when using Emscripten." + VALUE ON) + draco_option( + NAME DRACO_IE_COMPATIBLE + HELPSTRING "Enable support for older IE builds when using Emscripten." + VALUE OFF) + draco_option( + NAME DRACO_MESH_COMPRESSION + HELPSTRING "Enable mesh compression." + VALUE ON) + draco_option( + NAME DRACO_POINT_CLOUD_COMPRESSION + HELPSTRING "Enable point cloud compression." + VALUE ON) + draco_option( + NAME DRACO_PREDICTIVE_EDGEBREAKER + HELPSTRING "Enable predictive edgebreaker." + VALUE ON) + draco_option( + NAME DRACO_STANDARD_EDGEBREAKER + HELPSTRING "Enable stand edgebreaker." + VALUE ON) + draco_option( + NAME DRACO_BACKWARDS_COMPATIBILITY + HELPSTRING "Enable backwards compatibility." + VALUE ON) + draco_option( + NAME DRACO_DECODER_ATTRIBUTE_DEDUPLICATION + HELPSTRING "Enable attribute deduping." + VALUE OFF) + draco_option( + NAME DRACO_TESTS + HELPSTRING "Enables tests." + VALUE OFF) + draco_option( + NAME DRACO_WASM + HELPSTRING "Enables WASM support." + VALUE OFF) + draco_option( + NAME DRACO_UNITY_PLUGIN + HELPSTRING "Build plugin library for Unity." + VALUE OFF) + draco_option( + NAME DRACO_ANIMATION_ENCODING + HELPSTRING "Enable animation." + VALUE OFF) + draco_option( + NAME DRACO_GLTF_BITSTREAM + HELPSTRING "Draco GLTF extension bitstream specified features only." + VALUE OFF) + draco_option( + NAME DRACO_MAYA_PLUGIN + HELPSTRING "Build plugin library for Maya." + VALUE OFF) + draco_option( + NAME DRACO_TRANSCODER_SUPPORTED + HELPSTRING "Enable the Draco transcoder." + VALUE OFF) + draco_option( + NAME DRACO_DEBUG_COMPILER_WARNINGS + HELPSTRING "Turn on more warnings." + VALUE OFF) draco_check_deprecated_options() endmacro() @@ -117,14 +177,16 @@ macro(draco_check_deprecated_options) DRACO_MAYA_PLUGIN) draco_handle_deprecated_option(OLDNAME BUILD_USD_PLUGIN NEWNAME BUILD_SHARED_LIBS) + draco_handle_deprecated_option(OLDNAME DRACO_GLTF NEWNAME + DRACO_GLTF_BITSTREAM) endmacro() # Macro for setting Draco features based on user configuration. Features enabled # by this macro are Draco global. macro(draco_set_optional_features) - if(DRACO_GLTF) - # Override settings when building for GLTF. + if(DRACO_GLTF_BITSTREAM) + # Enable only the features included in the Draco GLTF bitstream spec. draco_enable_feature(FEATURE "DRACO_MESH_COMPRESSION_SUPPORTED") draco_enable_feature(FEATURE "DRACO_NORMAL_ENCODING_SUPPORTED") draco_enable_feature(FEATURE "DRACO_STANDARD_EDGEBREAKER_SUPPORTED") @@ -170,6 +232,11 @@ macro(draco_set_optional_features) set(CMAKE_POSITION_INDEPENDENT_CODE ON) endif() + if(DRACO_TRANSCODER_SUPPORTED) + draco_enable_feature(FEATURE "DRACO_TRANSCODER_SUPPORTED") + endif() + + endmacro() # Macro that handles tracking of Draco preprocessor symbols for the purpose of @@ -221,8 +288,56 @@ function(draco_generate_features_h) file(APPEND "${draco_features_file_name}.new" "#define ${feature}\n") endforeach() + if(MSVC) + if(NOT DRACO_DEBUG_COMPILER_WARNINGS) + file(APPEND "${draco_features_file_name}.new" + "// Enable DRACO_DEBUG_COMPILER_WARNINGS at CMake generation \n" + "// time to remove these pragmas.\n") + + # warning C4018: '': signed/unsigned mismatch. + file(APPEND "${draco_features_file_name}.new" + "#pragma warning(disable:4018)\n") + + # warning C4146: unary minus operator applied to unsigned type, result + # still unsigned + file(APPEND "${draco_features_file_name}.new" + "#pragma warning(disable:4146)\n") + + # warning C4244: 'return': conversion from '' to '', possible + # loss of data. + file(APPEND "${draco_features_file_name}.new" + "#pragma warning(disable:4244)\n") + + # warning C4267: 'initializing' conversion from '' to '', + # possible loss of data. + file(APPEND "${draco_features_file_name}.new" + "#pragma warning(disable:4267)\n") + + # warning C4305: 'context' : truncation from 'type1' to 'type2'. + file(APPEND "${draco_features_file_name}.new" + "#pragma warning(disable:4305)\n") + + # warning C4661: 'identifier' : no suitable definition provided for + # explicit template instantiation request. + file(APPEND "${draco_features_file_name}.new" + "#pragma warning(disable:4661)\n") + + # warning C4800: Implicit conversion from 'type' to bool. Possible + # information loss. + # Also, in older MSVC releases: + # warning C4800: 'type' : forcing value to bool 'true' or 'false' + # (performance warning). + file(APPEND "${draco_features_file_name}.new" + "#pragma warning(disable:4800)\n") + + # warning C4804: '': unsafe use of type '' in operation. + file(APPEND "${draco_features_file_name}.new" + "#pragma warning(disable:4804)\n") + endif() + endif() + file(APPEND "${draco_features_file_name}.new" - "\n#endif // DRACO_FEATURES_H_") + "\n#endif // DRACO_FEATURES_H_\n") # Will replace ${draco_features_file_name} only if the file content has # changed. This prevents forced Draco rebuilds after CMake runs. diff --git a/contrib/draco/cmake/draco_sanitizer.cmake b/contrib/draco/cmake/draco_sanitizer.cmake index d2e41a6cb..77d141481 100644 --- a/contrib/draco/cmake/draco_sanitizer.cmake +++ b/contrib/draco/cmake/draco_sanitizer.cmake @@ -1,3 +1,17 @@ +# Copyright 2021 The Draco Authors +# +# Licensed under the Apache License, Version 2.0 (the "License"); you may not +# use this file except in compliance with the License. You may obtain a copy of +# the License at +# +# http://www.apache.org/licenses/LICENSE-2.0 +# +# Unless required by applicable law or agreed to in writing, software +# distributed under the License is distributed on an "AS IS" BASIS, WITHOUT +# WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the +# License for the specific language governing permissions and limitations under +# the License. + if(DRACO_CMAKE_DRACO_SANITIZER_CMAKE_) return() endif() # DRACO_CMAKE_DRACO_SANITIZER_CMAKE_ @@ -5,7 +19,9 @@ set(DRACO_CMAKE_DRACO_SANITIZER_CMAKE_ 1) # Handles the details of enabling sanitizers. macro(draco_configure_sanitizer) - if(DRACO_SANITIZE AND NOT EMSCRIPTEN AND NOT MSVC) + if(DRACO_SANITIZE + AND NOT EMSCRIPTEN + AND NOT MSVC) if(CMAKE_CXX_COMPILER_ID MATCHES "Clang") if(DRACO_SANITIZE MATCHES "cfi") list(APPEND SAN_CXX_FLAGS "-flto" "-fno-sanitize-trap=cfi") @@ -13,8 +29,8 @@ macro(draco_configure_sanitizer) "-fuse-ld=gold") endif() - if(${CMAKE_SIZEOF_VOID_P} EQUAL 4 - AND DRACO_SANITIZE MATCHES "integer|undefined") + if(${CMAKE_SIZEOF_VOID_P} EQUAL 4 AND DRACO_SANITIZE MATCHES + "integer|undefined") list(APPEND SAN_LINKER_FLAGS "--rtlib=compiler-rt" "-lgcc_s") endif() endif() diff --git a/contrib/draco/cmake/draco_targets.cmake b/contrib/draco/cmake/draco_targets.cmake index 0456c4d7b..c8c79f511 100644 --- a/contrib/draco/cmake/draco_targets.cmake +++ b/contrib/draco/cmake/draco_targets.cmake @@ -1,3 +1,17 @@ +# Copyright 2021 The Draco Authors +# +# Licensed under the Apache License, Version 2.0 (the "License"); you may not +# use this file except in compliance with the License. You may obtain a copy of +# the License at +# +# http://www.apache.org/licenses/LICENSE-2.0 +# +# Unless required by applicable law or agreed to in writing, software +# distributed under the License is distributed on an "AS IS" BASIS, WITHOUT +# WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the +# License for the specific language governing permissions and limitations under +# the License. + if(DRACO_CMAKE_DRACO_TARGETS_CMAKE_) return() endif() # DRACO_CMAKE_DRACO_TARGETS_CMAKE_ @@ -51,26 +65,33 @@ macro(draco_add_executable) unset(exe_LIB_DEPS) set(optional_args TEST) set(single_value_args NAME OUTPUT_NAME) - set(multi_value_args SOURCES DEFINES INCLUDES COMPILE_FLAGS LINK_FLAGS - OBJLIB_DEPS LIB_DEPS) + set(multi_value_args + SOURCES + DEFINES + INCLUDES + COMPILE_FLAGS + LINK_FLAGS + OBJLIB_DEPS + LIB_DEPS) cmake_parse_arguments(exe "${optional_args}" "${single_value_args}" "${multi_value_args}" ${ARGN}) if(DRACO_VERBOSE GREATER 1) - message("--------- draco_add_executable ---------\n" - "exe_TEST=${exe_TEST}\n" - "exe_TEST_DEFINES_MAIN=${exe_TEST_DEFINES_MAIN}\n" - "exe_NAME=${exe_NAME}\n" - "exe_OUTPUT_NAME=${exe_OUTPUT_NAME}\n" - "exe_SOURCES=${exe_SOURCES}\n" - "exe_DEFINES=${exe_DEFINES}\n" - "exe_INCLUDES=${exe_INCLUDES}\n" - "exe_COMPILE_FLAGS=${exe_COMPILE_FLAGS}\n" - "exe_LINK_FLAGS=${exe_LINK_FLAGS}\n" - "exe_OBJLIB_DEPS=${exe_OBJLIB_DEPS}\n" - "exe_LIB_DEPS=${exe_LIB_DEPS}\n" - "------------------------------------------\n") + message( + "--------- draco_add_executable ---------\n" + "exe_TEST=${exe_TEST}\n" + "exe_TEST_DEFINES_MAIN=${exe_TEST_DEFINES_MAIN}\n" + "exe_NAME=${exe_NAME}\n" + "exe_OUTPUT_NAME=${exe_OUTPUT_NAME}\n" + "exe_SOURCES=${exe_SOURCES}\n" + "exe_DEFINES=${exe_DEFINES}\n" + "exe_INCLUDES=${exe_INCLUDES}\n" + "exe_COMPILE_FLAGS=${exe_COMPILE_FLAGS}\n" + "exe_LINK_FLAGS=${exe_LINK_FLAGS}\n" + "exe_OBJLIB_DEPS=${exe_OBJLIB_DEPS}\n" + "exe_LIB_DEPS=${exe_LIB_DEPS}\n" + "------------------------------------------\n") endif() if(NOT (exe_NAME AND exe_SOURCES)) @@ -87,7 +108,12 @@ macro(draco_add_executable) endif() add_executable(${exe_NAME} ${exe_SOURCES}) - set_target_properties(${exe_NAME} PROPERTIES VERSION ${DRACO_VERSION}) + + target_compile_features(${exe_NAME} PUBLIC cxx_std_11) + + if(NOT EMSCRIPTEN) + set_target_properties(${exe_NAME} PROPERTIES VERSION ${DRACO_VERSION}) + endif() if(exe_OUTPUT_NAME) set_target_properties(${exe_NAME} PROPERTIES OUTPUT_NAME ${exe_OUTPUT_NAME}) @@ -104,8 +130,8 @@ macro(draco_add_executable) endif() if(exe_COMPILE_FLAGS OR DRACO_CXX_FLAGS) - target_compile_options(${exe_NAME} - PRIVATE ${exe_COMPILE_FLAGS} ${DRACO_CXX_FLAGS}) + target_compile_options(${exe_NAME} PRIVATE ${exe_COMPILE_FLAGS} + ${DRACO_CXX_FLAGS}) endif() if(exe_LINK_FLAGS OR DRACO_EXE_LINKER_FLAGS) @@ -113,8 +139,8 @@ macro(draco_add_executable) list(APPEND exe_LINK_FLAGS "${DRACO_EXE_LINKER_FLAGS}") # LINK_FLAGS is managed as a string. draco_set_and_stringify(SOURCE "${exe_LINK_FLAGS}" DEST exe_LINK_FLAGS) - set_target_properties(${exe_NAME} - PROPERTIES LINK_FLAGS "${exe_LINK_FLAGS}") + set_target_properties(${exe_NAME} PROPERTIES LINK_FLAGS + "${exe_LINK_FLAGS}") else() target_link_options(${exe_NAME} PRIVATE ${exe_LINK_FLAGS} ${DRACO_EXE_LINKER_FLAGS}) @@ -136,12 +162,7 @@ macro(draco_add_executable) endif() if(exe_LIB_DEPS) - unset(exe_static) - if("${CMAKE_EXE_LINKER_FLAGS} ${DRACO_EXE_LINKER_FLAGS}" MATCHES "static") - set(exe_static ON) - endif() - - if(exe_static AND CMAKE_CXX_COMPILER_ID MATCHES "Clang|GNU") + if(CMAKE_CXX_COMPILER_ID MATCHES "^Clang|^GNU") # Third party dependencies can introduce dependencies on system and test # libraries. Since the target created here is an executable, and CMake # does not provide a method of controlling order of link dependencies, @@ -149,6 +170,10 @@ macro(draco_add_executable) # ensure that dependencies of third party targets can be resolved when # those dependencies happen to be resolved by dependencies of the current # target. + # TODO(tomfinegan): For portability use LINK_GROUP with RESCAN instead of + # directly (ab)using compiler/linker specific flags once CMake v3.24 is in + # wider use. See: + # https://cmake.org/cmake/help/latest/manual/cmake-generator-expressions.7.html#genex:LINK_GROUP list(INSERT exe_LIB_DEPS 0 -Wl,--start-group) list(APPEND exe_LIB_DEPS -Wl,--end-group) endif() @@ -209,27 +234,36 @@ macro(draco_add_library) unset(lib_TARGET_PROPERTIES) set(optional_args TEST) set(single_value_args NAME OUTPUT_NAME TYPE) - set(multi_value_args SOURCES DEFINES INCLUDES COMPILE_FLAGS LINK_FLAGS - OBJLIB_DEPS LIB_DEPS PUBLIC_INCLUDES TARGET_PROPERTIES) + set(multi_value_args + SOURCES + DEFINES + INCLUDES + COMPILE_FLAGS + LINK_FLAGS + OBJLIB_DEPS + LIB_DEPS + PUBLIC_INCLUDES + TARGET_PROPERTIES) cmake_parse_arguments(lib "${optional_args}" "${single_value_args}" "${multi_value_args}" ${ARGN}) if(DRACO_VERBOSE GREATER 1) - message("--------- draco_add_library ---------\n" - "lib_TEST=${lib_TEST}\n" - "lib_NAME=${lib_NAME}\n" - "lib_OUTPUT_NAME=${lib_OUTPUT_NAME}\n" - "lib_TYPE=${lib_TYPE}\n" - "lib_SOURCES=${lib_SOURCES}\n" - "lib_DEFINES=${lib_DEFINES}\n" - "lib_INCLUDES=${lib_INCLUDES}\n" - "lib_COMPILE_FLAGS=${lib_COMPILE_FLAGS}\n" - "lib_LINK_FLAGS=${lib_LINK_FLAGS}\n" - "lib_OBJLIB_DEPS=${lib_OBJLIB_DEPS}\n" - "lib_LIB_DEPS=${lib_LIB_DEPS}\n" - "lib_PUBLIC_INCLUDES=${lib_PUBLIC_INCLUDES}\n" - "---------------------------------------\n") + message( + "--------- draco_add_library ---------\n" + "lib_TEST=${lib_TEST}\n" + "lib_NAME=${lib_NAME}\n" + "lib_OUTPUT_NAME=${lib_OUTPUT_NAME}\n" + "lib_TYPE=${lib_TYPE}\n" + "lib_SOURCES=${lib_SOURCES}\n" + "lib_DEFINES=${lib_DEFINES}\n" + "lib_INCLUDES=${lib_INCLUDES}\n" + "lib_COMPILE_FLAGS=${lib_COMPILE_FLAGS}\n" + "lib_LINK_FLAGS=${lib_LINK_FLAGS}\n" + "lib_OBJLIB_DEPS=${lib_OBJLIB_DEPS}\n" + "lib_LIB_DEPS=${lib_LIB_DEPS}\n" + "lib_PUBLIC_INCLUDES=${lib_PUBLIC_INCLUDES}\n" + "---------------------------------------\n") endif() if(NOT (lib_NAME AND lib_TYPE)) @@ -256,14 +290,24 @@ macro(draco_add_library) endif() add_library(${lib_NAME} ${lib_TYPE} ${lib_SOURCES}) + + target_compile_features(${lib_NAME} PUBLIC cxx_std_11) + + target_include_directories(${lib_NAME} PUBLIC $) + + if(BUILD_SHARED_LIBS) + # Enable PIC for all targets in shared configurations. + set_target_properties(${lib_NAME} PROPERTIES POSITION_INDEPENDENT_CODE ON) + endif() + if(lib_SOURCES) draco_process_intrinsics_sources(TARGET ${lib_NAME} SOURCES ${lib_SOURCES}) endif() if(lib_OUTPUT_NAME) if(NOT (BUILD_SHARED_LIBS AND MSVC)) - set_target_properties(${lib_NAME} - PROPERTIES OUTPUT_NAME ${lib_OUTPUT_NAME}) + set_target_properties(${lib_NAME} PROPERTIES OUTPUT_NAME + ${lib_OUTPUT_NAME}) endif() endif() @@ -280,8 +324,8 @@ macro(draco_add_library) endif() if(lib_COMPILE_FLAGS OR DRACO_CXX_FLAGS) - target_compile_options(${lib_NAME} - PRIVATE ${lib_COMPILE_FLAGS} ${DRACO_CXX_FLAGS}) + target_compile_options(${lib_NAME} PRIVATE ${lib_COMPILE_FLAGS} + ${DRACO_CXX_FLAGS}) endif() if(lib_LINK_FLAGS) @@ -320,11 +364,12 @@ macro(draco_add_library) set_target_properties(${lib_NAME} PROPERTIES PREFIX "") endif() - # VERSION and SOVERSION as necessary - if(NOT lib_TYPE STREQUAL STATIC AND NOT lib_TYPE STREQUAL MODULE) - set_target_properties(${lib_NAME} PROPERTIES VERSION ${DRACO_VERSION}) - if(NOT MSVC) - set_target_properties(${lib_NAME} PROPERTIES SOVERSION ${DRACO_SOVERSION}) + if(NOT EMSCRIPTEN) + # VERSION and SOVERSION as necessary + if((lib_TYPE STREQUAL BUNDLE OR lib_TYPE STREQUAL SHARED) AND NOT MSVC) + set_target_properties( + ${lib_NAME} PROPERTIES VERSION ${DRACO_SOVERSION} + SOVERSION ${DRACO_SOVERSION_MAJOR}) endif() endif() diff --git a/contrib/draco/cmake/draco_test_config.h.cmake b/contrib/draco/cmake/draco_test_config.h.cmake index 77a574123..9bb174569 100644 --- a/contrib/draco/cmake/draco_test_config.h.cmake +++ b/contrib/draco/cmake/draco_test_config.h.cmake @@ -1,3 +1,17 @@ +// Copyright 2021 The Draco Authors +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + #ifndef DRACO_TESTING_DRACO_TEST_CONFIG_H_ #define DRACO_TESTING_DRACO_TEST_CONFIG_H_ @@ -9,5 +23,6 @@ #define DRACO_TEST_DATA_DIR "${DRACO_TEST_DATA_DIR}" #define DRACO_TEST_TEMP_DIR "${DRACO_TEST_TEMP_DIR}" +#define DRACO_TEST_ROOT_DIR "${DRACO_TEST_ROOT_DIR}" #endif // DRACO_TESTING_DRACO_TEST_CONFIG_H_ diff --git a/contrib/draco/cmake/draco_tests.cmake b/contrib/draco/cmake/draco_tests.cmake index a6dfc5b57..1d905a969 100644 --- a/contrib/draco/cmake/draco_tests.cmake +++ b/contrib/draco/cmake/draco_tests.cmake @@ -1,3 +1,17 @@ +# Copyright 2021 The Draco Authors +# +# Licensed under the Apache License, Version 2.0 (the "License"); you may not +# use this file except in compliance with the License. You may obtain a copy of +# the License at +# +# http://www.apache.org/licenses/LICENSE-2.0 +# +# Unless required by applicable law or agreed to in writing, software +# distributed under the License is distributed on an "AS IS" BASIS, WITHOUT +# WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the +# License for the specific language governing permissions and limitations under +# the License. + if(DRACO_CMAKE_DRACO_TESTS_CMAKE) return() endif() @@ -10,6 +24,13 @@ set(draco_factory_test_sources "${draco_src_root}/io/file_reader_factory_test.cc" "${draco_src_root}/io/file_writer_factory_test.cc") +list( + APPEND draco_test_common_sources + "${draco_src_root}/core/draco_test_base.h" + "${draco_src_root}/core/draco_test_utils.cc" + "${draco_src_root}/core/draco_test_utils.h" + "${draco_src_root}/core/status.cc") + list( APPEND draco_test_sources @@ -30,22 +51,23 @@ list( "${draco_src_root}/compression/point_cloud/point_cloud_kd_tree_encoding_test.cc" "${draco_src_root}/compression/point_cloud/point_cloud_sequential_encoding_test.cc" "${draco_src_root}/core/buffer_bit_coding_test.cc" - "${draco_src_root}/core/draco_test_base.h" - "${draco_src_root}/core/draco_test_utils.cc" - "${draco_src_root}/core/draco_test_utils.h" "${draco_src_root}/core/math_utils_test.cc" "${draco_src_root}/core/quantization_utils_test.cc" "${draco_src_root}/core/status_test.cc" "${draco_src_root}/core/vector_d_test.cc" "${draco_src_root}/io/file_reader_test_common.h" "${draco_src_root}/io/file_utils_test.cc" + "${draco_src_root}/io/file_writer_utils_test.cc" "${draco_src_root}/io/stdio_file_reader_test.cc" "${draco_src_root}/io/stdio_file_writer_test.cc" "${draco_src_root}/io/obj_decoder_test.cc" "${draco_src_root}/io/obj_encoder_test.cc" "${draco_src_root}/io/ply_decoder_test.cc" "${draco_src_root}/io/ply_reader_test.cc" + "${draco_src_root}/io/stl_decoder_test.cc" + "${draco_src_root}/io/stl_encoder_test.cc" "${draco_src_root}/io/point_cloud_io_test.cc" + "${draco_src_root}/mesh/corner_table_test.cc" "${draco_src_root}/mesh/mesh_are_equivalent_test.cc" "${draco_src_root}/mesh/mesh_cleanup_test.cc" "${draco_src_root}/mesh/triangle_soup_mesh_builder_test.cc" @@ -54,47 +76,71 @@ list( "${draco_src_root}/point_cloud/point_cloud_builder_test.cc" "${draco_src_root}/point_cloud/point_cloud_test.cc") -list(APPEND draco_gtest_all - "${draco_root}/../googletest/googletest/src/gtest-all.cc") -list(APPEND draco_gtest_main - "${draco_root}/../googletest/googletest/src/gtest_main.cc") +if(DRACO_TRANSCODER_SUPPORTED) + list( + APPEND draco_test_sources + "${draco_src_root}/animation/animation_test.cc" + "${draco_src_root}/io/gltf_decoder_test.cc" + "${draco_src_root}/io/gltf_encoder_test.cc" + "${draco_src_root}/io/gltf_utils_test.cc" + "${draco_src_root}/io/gltf_test_helper.cc" + "${draco_src_root}/io/gltf_test_helper.h" + "${draco_src_root}/io/scene_io_test.cc" + "${draco_src_root}/io/texture_io_test.cc" + "${draco_src_root}/material/material_library_test.cc" + "${draco_src_root}/material/material_test.cc" + "${draco_src_root}/metadata/property_table_test.cc" + "${draco_src_root}/metadata/structural_metadata_test.cc" + "${draco_src_root}/scene/instance_array_test.cc" + "${draco_src_root}/scene/light_test.cc" + "${draco_src_root}/scene/mesh_group_test.cc" + "${draco_src_root}/scene/scene_test.cc" + "${draco_src_root}/scene/scene_are_equivalent_test.cc" + "${draco_src_root}/scene/scene_utils_test.cc" + "${draco_src_root}/scene/trs_matrix_test.cc" + "${draco_src_root}/texture/texture_library_test.cc" + "${draco_src_root}/texture/texture_map_test.cc" + "${draco_src_root}/texture/texture_transform_test.cc") + +endif() macro(draco_setup_test_targets) if(DRACO_TESTS) + draco_setup_googletest() + if(NOT (EXISTS ${draco_gtest_all} AND EXISTS ${draco_gtest_main})) - message(FATAL "googletest must be a sibling directory of ${draco_root}.") + message(FATAL_ERROR "googletest missing, run git submodule update --init") endif() list(APPEND draco_test_defines GTEST_HAS_PTHREAD=0) - draco_add_library(TEST - NAME - draco_gtest - TYPE - STATIC - SOURCES - ${draco_gtest_all} - DEFINES - ${draco_defines} - ${draco_test_defines} - INCLUDES - ${draco_test_include_paths}) + draco_add_library( + TEST + NAME draco_test_common + TYPE STATIC + SOURCES ${draco_test_common_sources} + DEFINES ${draco_defines} ${draco_test_defines} + INCLUDES ${draco_test_include_paths}) - draco_add_library(TEST - NAME - draco_gtest_main - TYPE - STATIC - SOURCES - ${draco_gtest_main} - DEFINES - ${draco_defines} - ${draco_test_defines} - INCLUDES - ${draco_test_include_paths}) + draco_add_library( + TEST + NAME draco_gtest + TYPE STATIC + SOURCES ${draco_gtest_all} + DEFINES ${draco_defines} ${draco_test_defines} + INCLUDES ${draco_test_include_paths}) + + draco_add_library( + TEST + NAME draco_gtest_main + TYPE STATIC + SOURCES ${draco_gtest_main} + DEFINES ${draco_defines} ${draco_test_defines} + INCLUDES ${draco_test_include_paths}) set(DRACO_TEST_DATA_DIR "${draco_root}/testdata") set(DRACO_TEST_TEMP_DIR "${draco_build}/draco_test_temp") + set(DRACO_TEST_ROOT_DIR "${draco_root}") file(MAKE_DIRECTORY "${DRACO_TEST_TEMP_DIR}") # Sets DRACO_TEST_DATA_DIR and DRACO_TEST_TEMP_DIR. @@ -102,32 +148,24 @@ macro(draco_setup_test_targets) "${draco_build}/testing/draco_test_config.h") # Create the test targets. - draco_add_executable(NAME - draco_tests - SOURCES - ${draco_test_sources} - DEFINES - ${draco_defines} - ${draco_test_defines} - INCLUDES - ${draco_test_include_paths} - LIB_DEPS - draco_static - draco_gtest - draco_gtest_main) + draco_add_executable( + TEST + NAME draco_tests + SOURCES ${draco_test_sources} + DEFINES ${draco_defines} ${draco_test_defines} + INCLUDES ${draco_test_include_paths} + LIB_DEPS ${draco_dependency} draco_gtest draco_gtest_main + draco_test_common) + + draco_add_executable( + TEST + NAME draco_factory_tests + SOURCES ${draco_factory_test_sources} + DEFINES ${draco_defines} ${draco_test_defines} + INCLUDES ${draco_test_include_paths} + LIB_DEPS ${draco_dependency} draco_gtest draco_gtest_main + draco_test_common) + - draco_add_executable(NAME - draco_factory_tests - SOURCES - ${draco_factory_test_sources} - DEFINES - ${draco_defines} - ${draco_test_defines} - INCLUDES - ${draco_test_include_paths} - LIB_DEPS - draco_static - draco_gtest - draco_gtest_main) endif() endmacro() diff --git a/contrib/draco/cmake/draco_variables.cmake b/contrib/draco/cmake/draco_variables.cmake index 8dbc77a53..6d1b6a99d 100644 --- a/contrib/draco/cmake/draco_variables.cmake +++ b/contrib/draco/cmake/draco_variables.cmake @@ -1,3 +1,17 @@ +# Copyright 2021 The Draco Authors +# +# Licensed under the Apache License, Version 2.0 (the "License"); you may not +# use this file except in compliance with the License. You may obtain a copy of +# the License at +# +# http://www.apache.org/licenses/LICENSE-2.0 +# +# Unless required by applicable law or agreed to in writing, software +# distributed under the License is distributed on an "AS IS" BASIS, WITHOUT +# WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the +# License for the specific language governing permissions and limitations under +# the License. + if(DRACO_CMAKE_DRACO_VARIABLES_CMAKE_) return() endif() # DRACO_CMAKE_DRACO_VARIABLES_CMAKE_ @@ -14,8 +28,7 @@ macro(draco_variable_must_be_directory variable_name) if("${${variable_name}}" STREQUAL "") message( - FATAL_ERROR - "Empty variable ${variable_name} is required to build draco.") + FATAL_ERROR "Empty variable ${variable_name} is required to build draco.") endif() if(NOT IS_DIRECTORY "${${variable_name}}") @@ -44,11 +57,13 @@ macro(draco_dump_cmake_flag_variables) list(APPEND flag_variables "CMAKE_CXX_FLAGS_INIT" "CMAKE_CXX_FLAGS" "CMAKE_EXE_LINKER_FLAGS_INIT" "CMAKE_EXE_LINKER_FLAGS") if(CMAKE_BUILD_TYPE) - list(APPEND flag_variables "CMAKE_BUILD_TYPE" - "CMAKE_CXX_FLAGS_${CMAKE_BUILD_TYPE}_INIT" - "CMAKE_CXX_FLAGS_${CMAKE_BUILD_TYPE}" - "CMAKE_EXE_LINKER_FLAGS_${CMAKE_BUILD_TYPE}_INIT" - "CMAKE_EXE_LINKER_FLAGS_${CMAKE_BUILD_TYPE}") + list( + APPEND flag_variables + "CMAKE_BUILD_TYPE" + "CMAKE_CXX_FLAGS_${CMAKE_BUILD_TYPE}_INIT" + "CMAKE_CXX_FLAGS_${CMAKE_BUILD_TYPE}" + "CMAKE_EXE_LINKER_FLAGS_${CMAKE_BUILD_TYPE}_INIT" + "CMAKE_EXE_LINKER_FLAGS_${CMAKE_BUILD_TYPE}") endif() foreach(flag_variable ${flag_variables}) message("${flag_variable}:${${flag_variable}}") diff --git a/contrib/draco/cmake/sanitizers.cmake b/contrib/draco/cmake/sanitizers.cmake deleted file mode 100644 index e720bc045..000000000 --- a/contrib/draco/cmake/sanitizers.cmake +++ /dev/null @@ -1,19 +0,0 @@ -if(DRACO_CMAKE_SANITIZERS_CMAKE_) - return() -endif() -set(DRACO_CMAKE_SANITIZERS_CMAKE_ 1) - -if(MSVC OR NOT SANITIZE) - return() -endif() - -include("${draco_root}/cmake/compiler_flags.cmake") - -string(TOLOWER ${SANITIZE} SANITIZE) - -# Require the sanitizer requested. -require_linker_flag("-fsanitize=${SANITIZE}") -require_compiler_flag("-fsanitize=${SANITIZE}" YES) - -# Make callstacks accurate. -require_compiler_flag("-fno-omit-frame-pointer -fno-optimize-sibling-calls" YES) diff --git a/contrib/draco/cmake/toolchains/aarch64-linux-gnu.cmake b/contrib/draco/cmake/toolchains/aarch64-linux-gnu.cmake index 87e0b4a45..a55da20fa 100644 --- a/contrib/draco/cmake/toolchains/aarch64-linux-gnu.cmake +++ b/contrib/draco/cmake/toolchains/aarch64-linux-gnu.cmake @@ -1,3 +1,17 @@ +# Copyright 2021 The Draco Authors +# +# Licensed under the Apache License, Version 2.0 (the "License"); you may not +# use this file except in compliance with the License. You may obtain a copy of +# the License at +# +# http://www.apache.org/licenses/LICENSE-2.0 +# +# Unless required by applicable law or agreed to in writing, software +# distributed under the License is distributed on an "AS IS" BASIS, WITHOUT +# WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the +# License for the specific language governing permissions and limitations under +# the License. + if(DRACO_CMAKE_TOOLCHAINS_AARCH64_LINUX_GNU_CMAKE_) return() endif() # DRACO_CMAKE_TOOLCHAINS_AARCH64_LINUX_GNU_CMAKE_ diff --git a/contrib/draco/cmake/toolchains/android-ndk-common.cmake b/contrib/draco/cmake/toolchains/android-ndk-common.cmake index 5126d6e29..80396af48 100644 --- a/contrib/draco/cmake/toolchains/android-ndk-common.cmake +++ b/contrib/draco/cmake/toolchains/android-ndk-common.cmake @@ -1,3 +1,17 @@ +# Copyright 2021 The Draco Authors +# +# Licensed under the Apache License, Version 2.0 (the "License"); you may not +# use this file except in compliance with the License. You may obtain a copy of +# the License at +# +# http://www.apache.org/licenses/LICENSE-2.0 +# +# Unless required by applicable law or agreed to in writing, software +# distributed under the License is distributed on an "AS IS" BASIS, WITHOUT +# WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the +# License for the specific language governing permissions and limitations under +# the License. + if(DRACO_CMAKE_TOOLCHAINS_ANDROID_NDK_COMMON_CMAKE_) return() endif() diff --git a/contrib/draco/cmake/toolchains/android.cmake b/contrib/draco/cmake/toolchains/android.cmake index b8f576d5e..ba50576b7 100644 --- a/contrib/draco/cmake/toolchains/android.cmake +++ b/contrib/draco/cmake/toolchains/android.cmake @@ -1,3 +1,17 @@ +# Copyright 2021 The Draco Authors +# +# Licensed under the Apache License, Version 2.0 (the "License"); you may not +# use this file except in compliance with the License. You may obtain a copy of +# the License at +# +# http://www.apache.org/licenses/LICENSE-2.0 +# +# Unless required by applicable law or agreed to in writing, software +# distributed under the License is distributed on an "AS IS" BASIS, WITHOUT +# WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the +# License for the specific language governing permissions and limitations under +# the License. + if(DRACO_CMAKE_TOOLCHAINS_ANDROID_CMAKE_) return() endif() # DRACO_CMAKE_TOOLCHAINS_ANDROID_CMAKE_ @@ -16,9 +30,9 @@ if(NOT ANDROID_ABI) set(ANDROID_ABI arm64-v8a) endif() -# Force arm mode for 32-bit targets (instead of the default thumb) to improve -# performance. -if(NOT ANDROID_ARM_MODE) +# Force arm mode for 32-bit arm targets (instead of the default thumb) to +# improve performance. +if(ANDROID_ABI MATCHES "^armeabi" AND NOT ANDROID_ARM_MODE) set(ANDROID_ARM_MODE arm) endif() diff --git a/contrib/draco/cmake/toolchains/arm-ios-common.cmake b/contrib/draco/cmake/toolchains/arm-ios-common.cmake index 65326d1c2..fab54bb39 100644 --- a/contrib/draco/cmake/toolchains/arm-ios-common.cmake +++ b/contrib/draco/cmake/toolchains/arm-ios-common.cmake @@ -1,3 +1,17 @@ +# Copyright 2021 The Draco Authors +# +# Licensed under the Apache License, Version 2.0 (the "License"); you may not +# use this file except in compliance with the License. You may obtain a copy of +# the License at +# +# http://www.apache.org/licenses/LICENSE-2.0 +# +# Unless required by applicable law or agreed to in writing, software +# distributed under the License is distributed on an "AS IS" BASIS, WITHOUT +# WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the +# License for the specific language governing permissions and limitations under +# the License. + if(DRACO_CMAKE_TOOLCHAINS_ARM_IOS_COMMON_CMAKE_) return() endif() @@ -13,5 +27,3 @@ set(CMAKE_C_COMPILER clang) set(CMAKE_C_COMPILER_ARG1 "-arch ${CMAKE_SYSTEM_PROCESSOR}") set(CMAKE_CXX_COMPILER clang++) set(CMAKE_CXX_COMPILER_ARG1 "-arch ${CMAKE_SYSTEM_PROCESSOR}") - -# TODO(tomfinegan): Handle bit code embedding. diff --git a/contrib/draco/cmake/toolchains/arm-linux-gnueabihf.cmake b/contrib/draco/cmake/toolchains/arm-linux-gnueabihf.cmake index 6e45969e9..f1f83d67c 100644 --- a/contrib/draco/cmake/toolchains/arm-linux-gnueabihf.cmake +++ b/contrib/draco/cmake/toolchains/arm-linux-gnueabihf.cmake @@ -1,3 +1,17 @@ +# Copyright 2021 The Draco Authors +# +# Licensed under the Apache License, Version 2.0 (the "License"); you may not +# use this file except in compliance with the License. You may obtain a copy of +# the License at +# +# http://www.apache.org/licenses/LICENSE-2.0 +# +# Unless required by applicable law or agreed to in writing, software +# distributed under the License is distributed on an "AS IS" BASIS, WITHOUT +# WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the +# License for the specific language governing permissions and limitations under +# the License. + if(DRACO_CMAKE_TOOLCHAINS_ARM_LINUX_GNUEABIHF_CMAKE_) return() endif() # DRACO_CMAKE_TOOLCHAINS_ARM_LINUX_GNUEABIHF_CMAKE_ diff --git a/contrib/draco/cmake/toolchains/arm64-android-ndk-libcpp.cmake b/contrib/draco/cmake/toolchains/arm64-android-ndk-libcpp.cmake index 4b6d366f0..80d452f97 100644 --- a/contrib/draco/cmake/toolchains/arm64-android-ndk-libcpp.cmake +++ b/contrib/draco/cmake/toolchains/arm64-android-ndk-libcpp.cmake @@ -1,3 +1,17 @@ +# Copyright 2021 The Draco Authors +# +# Licensed under the Apache License, Version 2.0 (the "License"); you may not +# use this file except in compliance with the License. You may obtain a copy of +# the License at +# +# http://www.apache.org/licenses/LICENSE-2.0 +# +# Unless required by applicable law or agreed to in writing, software +# distributed under the License is distributed on an "AS IS" BASIS, WITHOUT +# WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the +# License for the specific language governing permissions and limitations under +# the License. + if(DRACO_CMAKE_TOOLCHAINS_ARM64_ANDROID_NDK_LIBCPP_CMAKE_) return() endif() diff --git a/contrib/draco/cmake/toolchains/arm64-ios.cmake b/contrib/draco/cmake/toolchains/arm64-ios.cmake index c4ec7e3fa..5365d70f1 100644 --- a/contrib/draco/cmake/toolchains/arm64-ios.cmake +++ b/contrib/draco/cmake/toolchains/arm64-ios.cmake @@ -1,10 +1,23 @@ +# Copyright 2021 The Draco Authors +# +# Licensed under the Apache License, Version 2.0 (the "License"); you may not +# use this file except in compliance with the License. You may obtain a copy of +# the License at +# +# http://www.apache.org/licenses/LICENSE-2.0 +# +# Unless required by applicable law or agreed to in writing, software +# distributed under the License is distributed on an "AS IS" BASIS, WITHOUT +# WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the +# License for the specific language governing permissions and limitations under +# the License. + if(DRACO_CMAKE_TOOLCHAINS_ARM64_IOS_CMAKE_) return() endif() set(DRACO_CMAKE_TOOLCHAINS_ARM64_IOS_CMAKE_ 1) if(XCODE) - # TODO(tomfinegan): Handle arm builds in Xcode. message(FATAL_ERROR "This toolchain does not support Xcode.") endif() diff --git a/contrib/draco/cmake/toolchains/arm64-linux-gcc.cmake b/contrib/draco/cmake/toolchains/arm64-linux-gcc.cmake index 046ff0139..a332760b2 100644 --- a/contrib/draco/cmake/toolchains/arm64-linux-gcc.cmake +++ b/contrib/draco/cmake/toolchains/arm64-linux-gcc.cmake @@ -1,3 +1,17 @@ +# Copyright 2021 The Draco Authors +# +# Licensed under the Apache License, Version 2.0 (the "License"); you may not +# use this file except in compliance with the License. You may obtain a copy of +# the License at +# +# http://www.apache.org/licenses/LICENSE-2.0 +# +# Unless required by applicable law or agreed to in writing, software +# distributed under the License is distributed on an "AS IS" BASIS, WITHOUT +# WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the +# License for the specific language governing permissions and limitations under +# the License. + if(DRACO_CMAKE_TOOLCHAINS_ARM64_LINUX_GCC_CMAKE_) return() endif() diff --git a/contrib/draco/cmake/toolchains/armv7-android-ndk-libcpp.cmake b/contrib/draco/cmake/toolchains/armv7-android-ndk-libcpp.cmake index 80ee98b18..bedcc0cad 100644 --- a/contrib/draco/cmake/toolchains/armv7-android-ndk-libcpp.cmake +++ b/contrib/draco/cmake/toolchains/armv7-android-ndk-libcpp.cmake @@ -1,3 +1,17 @@ +# Copyright 2021 The Draco Authors +# +# Licensed under the Apache License, Version 2.0 (the "License"); you may not +# use this file except in compliance with the License. You may obtain a copy of +# the License at +# +# http://www.apache.org/licenses/LICENSE-2.0 +# +# Unless required by applicable law or agreed to in writing, software +# distributed under the License is distributed on an "AS IS" BASIS, WITHOUT +# WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the +# License for the specific language governing permissions and limitations under +# the License. + if(DRACO_CMAKE_TOOLCHAINS_ARMV7_ANDROID_NDK_LIBCPP_CMAKE_) return() endif() diff --git a/contrib/draco/cmake/toolchains/armv7-ios.cmake b/contrib/draco/cmake/toolchains/armv7-ios.cmake index 8ddd6997b..43e208b1f 100644 --- a/contrib/draco/cmake/toolchains/armv7-ios.cmake +++ b/contrib/draco/cmake/toolchains/armv7-ios.cmake @@ -1,10 +1,23 @@ +# Copyright 2021 The Draco Authors +# +# Licensed under the Apache License, Version 2.0 (the "License"); you may not +# use this file except in compliance with the License. You may obtain a copy of +# the License at +# +# http://www.apache.org/licenses/LICENSE-2.0 +# +# Unless required by applicable law or agreed to in writing, software +# distributed under the License is distributed on an "AS IS" BASIS, WITHOUT +# WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the +# License for the specific language governing permissions and limitations under +# the License. + if(DRACO_CMAKE_TOOLCHAINS_ARMV7_IOS_CMAKE_) return() endif() set(DRACO_CMAKE_TOOLCHAINS_ARMV7_IOS_CMAKE_ 1) if(XCODE) - # TODO(tomfinegan): Handle arm builds in Xcode. message(FATAL_ERROR "This toolchain does not support Xcode.") endif() diff --git a/contrib/draco/cmake/toolchains/armv7-linux-gcc.cmake b/contrib/draco/cmake/toolchains/armv7-linux-gcc.cmake index 9c9472319..730a87f4b 100644 --- a/contrib/draco/cmake/toolchains/armv7-linux-gcc.cmake +++ b/contrib/draco/cmake/toolchains/armv7-linux-gcc.cmake @@ -1,3 +1,17 @@ +# Copyright 2021 The Draco Authors +# +# Licensed under the Apache License, Version 2.0 (the "License"); you may not +# use this file except in compliance with the License. You may obtain a copy of +# the License at +# +# http://www.apache.org/licenses/LICENSE-2.0 +# +# Unless required by applicable law or agreed to in writing, software +# distributed under the License is distributed on an "AS IS" BASIS, WITHOUT +# WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the +# License for the specific language governing permissions and limitations under +# the License. + if(DRACO_CMAKE_TOOLCHAINS_ARMV7_LINUX_GCC_CMAKE_) return() endif() diff --git a/contrib/draco/cmake/toolchains/armv7s-ios.cmake b/contrib/draco/cmake/toolchains/armv7s-ios.cmake index b433025ba..472756117 100644 --- a/contrib/draco/cmake/toolchains/armv7s-ios.cmake +++ b/contrib/draco/cmake/toolchains/armv7s-ios.cmake @@ -1,10 +1,23 @@ +# Copyright 2021 The Draco Authors +# +# Licensed under the Apache License, Version 2.0 (the "License"); you may not +# use this file except in compliance with the License. You may obtain a copy of +# the License at +# +# http://www.apache.org/licenses/LICENSE-2.0 +# +# Unless required by applicable law or agreed to in writing, software +# distributed under the License is distributed on an "AS IS" BASIS, WITHOUT +# WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the +# License for the specific language governing permissions and limitations under +# the License. + if(DRACO_CMAKE_TOOLCHAINS_ARMV7S_IOS_CMAKE_) return() endif() set(DRACO_CMAKE_TOOLCHAINS_ARMV7S_IOS_CMAKE_ 1) if(XCODE) - # TODO(tomfinegan): Handle arm builds in Xcode. message(FATAL_ERROR "This toolchain does not support Xcode.") endif() diff --git a/contrib/draco/cmake/toolchains/i386-ios.cmake b/contrib/draco/cmake/toolchains/i386-ios.cmake index e9a105591..38989d225 100644 --- a/contrib/draco/cmake/toolchains/i386-ios.cmake +++ b/contrib/draco/cmake/toolchains/i386-ios.cmake @@ -1,10 +1,23 @@ +# Copyright 2021 The Draco Authors +# +# Licensed under the Apache License, Version 2.0 (the "License"); you may not +# use this file except in compliance with the License. You may obtain a copy of +# the License at +# +# http://www.apache.org/licenses/LICENSE-2.0 +# +# Unless required by applicable law or agreed to in writing, software +# distributed under the License is distributed on an "AS IS" BASIS, WITHOUT +# WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the +# License for the specific language governing permissions and limitations under +# the License. + if(DRACO_CMAKE_TOOLCHAINS_i386_IOS_CMAKE_) return() endif() set(DRACO_CMAKE_TOOLCHAINS_i386_IOS_CMAKE_ 1) if(XCODE) - # TODO(tomfinegan): Handle arm builds in Xcode. message(FATAL_ERROR "This toolchain does not support Xcode.") endif() diff --git a/contrib/draco/cmake/toolchains/x86-android-ndk-libcpp.cmake b/contrib/draco/cmake/toolchains/x86-android-ndk-libcpp.cmake index d43383640..6f63f2c31 100644 --- a/contrib/draco/cmake/toolchains/x86-android-ndk-libcpp.cmake +++ b/contrib/draco/cmake/toolchains/x86-android-ndk-libcpp.cmake @@ -1,3 +1,17 @@ +# Copyright 2021 The Draco Authors +# +# Licensed under the Apache License, Version 2.0 (the "License"); you may not +# use this file except in compliance with the License. You may obtain a copy of +# the License at +# +# http://www.apache.org/licenses/LICENSE-2.0 +# +# Unless required by applicable law or agreed to in writing, software +# distributed under the License is distributed on an "AS IS" BASIS, WITHOUT +# WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the +# License for the specific language governing permissions and limitations under +# the License. + if(DRACO_CMAKE_TOOLCHAINS_X86_ANDROID_NDK_LIBCPP_CMAKE_) return() endif() diff --git a/contrib/draco/cmake/toolchains/x86_64-android-ndk-libcpp.cmake b/contrib/draco/cmake/toolchains/x86_64-android-ndk-libcpp.cmake index d6fabeacc..7a630f4d4 100644 --- a/contrib/draco/cmake/toolchains/x86_64-android-ndk-libcpp.cmake +++ b/contrib/draco/cmake/toolchains/x86_64-android-ndk-libcpp.cmake @@ -1,3 +1,17 @@ +# Copyright 2021 The Draco Authors +# +# Licensed under the Apache License, Version 2.0 (the "License"); you may not +# use this file except in compliance with the License. You may obtain a copy of +# the License at +# +# http://www.apache.org/licenses/LICENSE-2.0 +# +# Unless required by applicable law or agreed to in writing, software +# distributed under the License is distributed on an "AS IS" BASIS, WITHOUT +# WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the +# License for the specific language governing permissions and limitations under +# the License. + if(DRACO_CMAKE_TOOLCHAINS_X86_64_ANDROID_NDK_LIBCPP_CMAKE_) return() endif() diff --git a/contrib/draco/cmake/toolchains/x86_64-ios.cmake b/contrib/draco/cmake/toolchains/x86_64-ios.cmake index 4c50a72a2..6946ce410 100644 --- a/contrib/draco/cmake/toolchains/x86_64-ios.cmake +++ b/contrib/draco/cmake/toolchains/x86_64-ios.cmake @@ -1,10 +1,23 @@ +# Copyright 2021 The Draco Authors +# +# Licensed under the Apache License, Version 2.0 (the "License"); you may not +# use this file except in compliance with the License. You may obtain a copy of +# the License at +# +# http://www.apache.org/licenses/LICENSE-2.0 +# +# Unless required by applicable law or agreed to in writing, software +# distributed under the License is distributed on an "AS IS" BASIS, WITHOUT +# WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the +# License for the specific language governing permissions and limitations under +# the License. + if(DRACO_CMAKE_TOOLCHAINS_X86_64_IOS_CMAKE_) return() endif() set(DRACO_CMAKE_TOOLCHAINS_X86_64_IOS_CMAKE_ 1) if(XCODE) - # TODO(tomfinegan): Handle arm builds in Xcode. message(FATAL_ERROR "This toolchain does not support Xcode.") endif() diff --git a/contrib/draco/cmake/util.cmake b/contrib/draco/cmake/util.cmake deleted file mode 100644 index 813146a62..000000000 --- a/contrib/draco/cmake/util.cmake +++ /dev/null @@ -1,79 +0,0 @@ -if(DRACO_CMAKE_UTIL_CMAKE_) - return() -endif() -set(DRACO_CMAKE_UTIL_CMAKE_ 1) - -# Creates dummy source file in $draco_build_dir named $basename.$extension and -# returns the full path to the dummy source file via the $out_file_path -# parameter. -function(create_dummy_source_file basename extension out_file_path) - set(dummy_source_file "${draco_build_dir}/${basename}.${extension}") - file(WRITE "${dummy_source_file}.new" - "// Generated file. DO NOT EDIT!\n" - "// ${target_name} needs a ${extension} file to force link language, \n" - "// or to silence a harmless CMake warning: Ignore me.\n" - "void ${target_name}_dummy_function(void) {}\n") - - # Will replace ${dummy_source_file} only if the file content has changed. - # This prevents forced Draco rebuilds after CMake runs. - configure_file("${dummy_source_file}.new" "${dummy_source_file}") - file(REMOVE "${dummy_source_file}.new") - - set(${out_file_path} ${dummy_source_file} PARENT_SCOPE) -endfunction() - -# Convenience function for adding a dummy source file to $target_name using -# $extension as the file extension. Wraps create_dummy_source_file(). -function(add_dummy_source_file_to_target target_name extension) - create_dummy_source_file("${target_name}" "${extension}" "dummy_source_file") - target_sources(${target_name} PRIVATE ${dummy_source_file}) -endfunction() - -# Extracts the version number from $version_file and returns it to the user via -# $version_string_out_var. This is achieved by finding the first instance of the -# kDracoVersion variable and then removing everything but the string literal -# assigned to the variable. Quotes and semicolon are stripped from the returned -# string. -function(extract_version_string version_file version_string_out_var) - file(STRINGS "${version_file}" draco_version REGEX "kDracoVersion") - list(GET draco_version 0 draco_version) - string(REPLACE "static const char kDracoVersion[] = " "" draco_version - "${draco_version}") - string(REPLACE ";" "" draco_version "${draco_version}") - string(REPLACE "\"" "" draco_version "${draco_version}") - set("${version_string_out_var}" "${draco_version}" PARENT_SCOPE) -endfunction() - -# Sets CMake compiler launcher to $launcher_name when $launcher_name is found in -# $PATH. Warns user about ignoring build flag $launcher_flag when $launcher_name -# is not found in $PATH. -function(set_compiler_launcher launcher_flag launcher_name) - find_program(launcher_path "${launcher_name}") - if(launcher_path) - set(CMAKE_C_COMPILER_LAUNCHER "${launcher_path}" PARENT_SCOPE) - set(CMAKE_CXX_COMPILER_LAUNCHER "${launcher_path}" PARENT_SCOPE) - message("--- Using ${launcher_name} as compiler launcher.") - else() - message( - WARNING "--- Cannot find ${launcher_name}, ${launcher_flag} ignored.") - endif() -endfunction() - -# Terminates CMake execution when $var_name is unset in the environment. Sets -# CMake variable to the value of the environment variable when the variable is -# present in the environment. -macro(require_variable var_name) - if("$ENV{${var_name}}" STREQUAL "") - message(FATAL_ERROR "${var_name} must be set in environment.") - endif() - set_variable_if_unset(${var_name} "") -endmacro() - -# Sets $var_name to $default_value if not already set. -macro(set_variable_if_unset var_name default_value) - if(NOT "$ENV{${var_name}}" STREQUAL "") - set(${var_name} $ENV{${var_name}}) - elseif(NOT ${var_name}) - set(${var_name} ${default_value}) - endif() -endmacro() diff --git a/contrib/draco/src/draco/animation/animation.cc b/contrib/draco/src/draco/animation/animation.cc new file mode 100644 index 000000000..471cf2942 --- /dev/null +++ b/contrib/draco/src/draco/animation/animation.cc @@ -0,0 +1,47 @@ +// Copyright 2019 The Draco Authors. +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. +// +#include "draco/animation/animation.h" + +#ifdef DRACO_TRANSCODER_SUPPORTED + +namespace draco { + +void Animation::Copy(const Animation &src) { + name_ = src.name_; + channels_.clear(); + for (int i = 0; i < src.NumChannels(); ++i) { + std::unique_ptr new_channel(new AnimationChannel()); + new_channel->Copy(*src.GetChannel(i)); + channels_.push_back(std::move(new_channel)); + } + + samplers_.clear(); + for (int i = 0; i < src.NumSamplers(); ++i) { + std::unique_ptr new_sampler(new AnimationSampler()); + new_sampler->Copy(*src.GetSampler(i)); + samplers_.push_back(std::move(new_sampler)); + } + + node_animation_data_.clear(); + for (int i = 0; i < src.NumNodeAnimationData(); ++i) { + std::unique_ptr new_data(new NodeAnimationData()); + new_data->Copy(*src.GetNodeAnimationData(i)); + node_animation_data_.push_back(std::move(new_data)); + } +} + +} // namespace draco + +#endif // DRACO_TRANSCODER_SUPPORTED diff --git a/contrib/draco/src/draco/animation/animation.h b/contrib/draco/src/draco/animation/animation.h new file mode 100644 index 000000000..3713f9886 --- /dev/null +++ b/contrib/draco/src/draco/animation/animation.h @@ -0,0 +1,149 @@ +// Copyright 2019 The Draco Authors. +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. +// +#ifndef DRACO_ANIMATION_ANIMATION_H_ +#define DRACO_ANIMATION_ANIMATION_H_ + +#include "draco/draco_features.h" + +#ifdef DRACO_TRANSCODER_SUPPORTED +#include +#include + +#include "draco/animation/node_animation_data.h" +#include "draco/core/status.h" + +namespace draco { + +// Struct to hold information about an animation's sampler. +struct AnimationSampler { + enum class SamplerInterpolation { LINEAR, STEP, CUBICSPLINE }; + + static std::string InterpolationToString(SamplerInterpolation value) { + switch (value) { + case SamplerInterpolation::STEP: + return "STEP"; + case SamplerInterpolation::CUBICSPLINE: + return "CUBICSPLINE"; + default: + return "LINEAR"; + } + } + + AnimationSampler() + : input_index(-1), + interpolation_type(SamplerInterpolation::LINEAR), + output_index(-1) {} + + void Copy(const AnimationSampler &src) { + input_index = src.input_index; + interpolation_type = src.interpolation_type; + output_index = src.output_index; + } + + int input_index; + SamplerInterpolation interpolation_type; + int output_index; +}; + +// Struct to hold information about an animation's channel. +struct AnimationChannel { + enum class ChannelTransformation { TRANSLATION, ROTATION, SCALE, WEIGHTS }; + + static std::string TransformationToString(ChannelTransformation value) { + switch (value) { + case ChannelTransformation::ROTATION: + return "rotation"; + case ChannelTransformation::SCALE: + return "scale"; + case ChannelTransformation::WEIGHTS: + return "weights"; + default: + return "translation"; + } + } + + AnimationChannel() + : target_index(-1), + transformation_type(ChannelTransformation::TRANSLATION), + sampler_index(-1) {} + + void Copy(const AnimationChannel &src) { + target_index = src.target_index; + transformation_type = src.transformation_type; + sampler_index = src.sampler_index; + } + + int target_index; + ChannelTransformation transformation_type; + int sampler_index; +}; + +// This class is used to hold data and information of glTF animations. +class Animation { + public: + Animation() {} + + void Copy(const Animation &src); + + const std::string &GetName() const { return name_; } + void SetName(const std::string &name) { name_ = name; } + + // Returns the number of channels in an animation. + int NumChannels() const { return channels_.size(); } + // Returns the number of samplers in an animation. + int NumSamplers() const { return samplers_.size(); } + // Returns the number of accessors in an animation. + int NumNodeAnimationData() const { return node_animation_data_.size(); } + + // Returns a channel in the animation. + AnimationChannel *GetChannel(int index) { return channels_[index].get(); } + const AnimationChannel *GetChannel(int index) const { + return channels_[index].get(); + } + // Returns a sampler in the animation. + AnimationSampler *GetSampler(int index) { return samplers_[index].get(); } + const AnimationSampler *GetSampler(int index) const { + return samplers_[index].get(); + } + // Returns an accessor in the animation. + NodeAnimationData *GetNodeAnimationData(int index) { + return node_animation_data_[index].get(); + } + const NodeAnimationData *GetNodeAnimationData(int index) const { + return node_animation_data_[index].get(); + } + + void AddNodeAnimationData( + std::unique_ptr node_animation_data) { + node_animation_data_.push_back(std::move(node_animation_data)); + } + void AddSampler(std::unique_ptr sampler) { + samplers_.push_back(std::move(sampler)); + } + void AddChannel(std::unique_ptr channel) { + channels_.push_back(std::move(channel)); + } + + private: + std::string name_; + std::vector> samplers_; + std::vector> channels_; + std::vector> node_animation_data_; +}; + +} // namespace draco + +#endif // DRACO_TRANSCODER_SUPPORTED +#endif // DRACO_ANIMATION_ANIMATION_H_ diff --git a/contrib/draco/src/draco/animation/animation_test.cc b/contrib/draco/src/draco/animation/animation_test.cc new file mode 100644 index 000000000..473938bca --- /dev/null +++ b/contrib/draco/src/draco/animation/animation_test.cc @@ -0,0 +1,71 @@ +// Copyright 2021 The Draco Authors. +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. +// +#include "draco/animation/animation.h" + +#include "draco/core/draco_test_base.h" +#include "draco/draco_features.h" + +namespace { + +#ifdef DRACO_TRANSCODER_SUPPORTED +TEST(AnimationTest, TestCopy) { + // Test copying of animation data. + draco::Animation src_anim; + ASSERT_TRUE(src_anim.GetName().empty()); + src_anim.SetName("Walking"); + ASSERT_EQ(src_anim.GetName(), "Walking"); + + std::unique_ptr src_sampler_0( + new draco::AnimationSampler()); + src_sampler_0->interpolation_type = + draco::AnimationSampler::SamplerInterpolation::CUBICSPLINE; + std::unique_ptr src_sampler_1( + new draco::AnimationSampler()); + src_sampler_1->Copy(*src_sampler_0); + + ASSERT_EQ(src_sampler_0->interpolation_type, + src_sampler_1->interpolation_type); + + src_sampler_1->interpolation_type = + draco::AnimationSampler::SamplerInterpolation::STEP; + + src_anim.AddSampler(std::move(src_sampler_0)); + src_anim.AddSampler(std::move(src_sampler_1)); + ASSERT_EQ(src_anim.NumSamplers(), 2); + + std::unique_ptr src_channel( + new draco::AnimationChannel()); + src_channel->transformation_type = + draco::AnimationChannel::ChannelTransformation::WEIGHTS; + src_anim.AddChannel(std::move(src_channel)); + ASSERT_EQ(src_anim.NumChannels(), 1); + + draco::Animation dst_anim; + dst_anim.Copy(src_anim); + + ASSERT_EQ(dst_anim.GetName(), src_anim.GetName()); + ASSERT_EQ(dst_anim.NumSamplers(), 2); + ASSERT_EQ(dst_anim.NumChannels(), 1); + + ASSERT_EQ(dst_anim.GetSampler(0)->interpolation_type, + src_anim.GetSampler(0)->interpolation_type); + ASSERT_EQ(dst_anim.GetSampler(1)->interpolation_type, + src_anim.GetSampler(1)->interpolation_type); + ASSERT_EQ(dst_anim.GetChannel(0)->transformation_type, + src_anim.GetChannel(0)->transformation_type); +} +#endif // DRACO_TRANSCODER_SUPPORTED + +} // namespace diff --git a/contrib/draco/src/draco/animation/keyframe_animation_encoding_test.cc b/contrib/draco/src/draco/animation/keyframe_animation_encoding_test.cc index 4a6491f9d..fcd0eaa6f 100644 --- a/contrib/draco/src/draco/animation/keyframe_animation_encoding_test.cc +++ b/contrib/draco/src/draco/animation/keyframe_animation_encoding_test.cc @@ -26,8 +26,9 @@ class KeyframeAnimationEncodingTest : public ::testing::Test { bool CreateAndAddTimestamps(int32_t num_frames) { timestamps_.resize(num_frames); - for (int i = 0; i < timestamps_.size(); ++i) + for (int i = 0; i < timestamps_.size(); ++i) { timestamps_[i] = static_cast(i); + } return keyframe_animation_.SetTimestamps(timestamps_); } @@ -35,8 +36,9 @@ class KeyframeAnimationEncodingTest : public ::testing::Test { uint32_t num_components) { // Create and add animation data with. animation_data_.resize(num_frames * num_components); - for (int i = 0; i < animation_data_.size(); ++i) + for (int i = 0; i < animation_data_.size(); ++i) { animation_data_[i] = static_cast(i); + } return keyframe_animation_.AddKeyframes(draco::DT_FLOAT32, num_components, animation_data_); } @@ -49,7 +51,7 @@ class KeyframeAnimationEncodingTest : public ::testing::Test { ASSERT_EQ(animation0.num_animations(), animation1.num_animations()); if (quantized) { - // TODO(hemmer) : Add test for stable quantization. + // TODO(b/199760123) : Add test for stable quantization. // Quantization will result in slightly different values. // Skip comparing values. return; @@ -109,9 +111,8 @@ class KeyframeAnimationEncodingTest : public ::testing::Test { } } - ASSERT_TRUE( - encoder.EncodeKeyframeAnimation(keyframe_animation_, options, &buffer) - .ok()); + DRACO_ASSERT_OK( + encoder.EncodeKeyframeAnimation(keyframe_animation_, options, &buffer)); draco::DecoderBuffer dec_decoder; draco::KeyframeAnimationDecoder decoder; @@ -122,8 +123,8 @@ class KeyframeAnimationEncodingTest : public ::testing::Test { std::unique_ptr decoded_animation( new KeyframeAnimation()); DecoderOptions dec_options; - ASSERT_TRUE( - decoder.Decode(dec_options, &dec_buffer, decoded_animation.get()).ok()); + DRACO_ASSERT_OK( + decoder.Decode(dec_options, &dec_buffer, decoded_animation.get())); // Verify if animation before and after compression is identical. CompareAnimationData(keyframe_animation_, diff --git a/contrib/draco/src/draco/animation/keyframe_animation_test.cc b/contrib/draco/src/draco/animation/keyframe_animation_test.cc index bc92b25ff..94566972b 100644 --- a/contrib/draco/src/draco/animation/keyframe_animation_test.cc +++ b/contrib/draco/src/draco/animation/keyframe_animation_test.cc @@ -24,8 +24,9 @@ class KeyframeAnimationTest : public ::testing::Test { bool CreateAndAddTimestamps(int32_t num_frames) { timestamps_.resize(num_frames); - for (int i = 0; i < timestamps_.size(); ++i) + for (int i = 0; i < timestamps_.size(); ++i) { timestamps_[i] = static_cast(i); + } return keyframe_animation_.SetTimestamps(timestamps_); } @@ -33,8 +34,9 @@ class KeyframeAnimationTest : public ::testing::Test { uint32_t num_components) { // Create and add animation data with. animation_data_.resize(num_frames * num_components); - for (int i = 0; i < animation_data_.size(); ++i) + for (int i = 0; i < animation_data_.size(); ++i) { animation_data_[i] = static_cast(i); + } return keyframe_animation_.AddKeyframes(draco::DT_FLOAT32, num_components, animation_data_); } diff --git a/contrib/draco/src/draco/animation/node_animation_data.h b/contrib/draco/src/draco/animation/node_animation_data.h new file mode 100644 index 000000000..7799e3376 --- /dev/null +++ b/contrib/draco/src/draco/animation/node_animation_data.h @@ -0,0 +1,150 @@ +// Copyright 2019 The Draco Authors. +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. +// +#ifndef DRACO_ANIMATION_NODE_ANIMATION_DATA_H_ +#define DRACO_ANIMATION_NODE_ANIMATION_DATA_H_ + +#include "draco/draco_features.h" + +#ifdef DRACO_TRANSCODER_SUPPORTED + +#include "draco/core/hash_utils.h" +#include "draco/core/status.h" +#include "draco/core/status_or.h" + +namespace draco { + +// This class is used to store information and data for animations that only +// affect the nodes. +// TODO(fgalligan): Think about changing the name of this class now that Skin +// is using it. +class NodeAnimationData { + public: + enum class Type { SCALAR, VEC3, VEC4, MAT4 }; + + NodeAnimationData() : type_(Type::SCALAR), count_(0), normalized_(false) {} + + void Copy(const NodeAnimationData &src) { + type_ = src.type_; + count_ = src.count_; + normalized_ = src.normalized_; + data_ = src.data_; + } + + Type type() const { return type_; } + int count() const { return count_; } + bool normalized() const { return normalized_; } + + std::vector *GetMutableData() { return &data_; } + const std::vector *GetData() const { return &data_; } + + void SetType(Type type) { type_ = type; } + void SetCount(int count) { count_ = count; } + void SetNormalized(bool normalized) { normalized_ = normalized; } + + int ComponentSize() const { return sizeof(float); } + int NumComponents() const { + switch (type_) { + case Type::SCALAR: + return 1; + case Type::VEC3: + return 3; + case Type::MAT4: + return 16; + default: + return 4; + } + } + + std::string TypeAsString() const { + switch (type_) { + case Type::SCALAR: + return "SCALAR"; + case Type::VEC3: + return "VEC3"; + case Type::MAT4: + return "MAT4"; + default: + return "VEC4"; + } + } + + bool operator==(const NodeAnimationData &nad) const { + return type_ == nad.type_ && count_ == nad.count_ && + normalized_ == nad.normalized_ && data_ == nad.data_; + } + + private: + Type type_; + int count_; + bool normalized_; + std::vector data_; +}; + +// Wrapper class for hashing NodeAnimationData. When using different containers, +// this class is preferable instead of copying the data in NodeAnimationData +// every time. +class NodeAnimationDataHash { + public: + NodeAnimationDataHash() = delete; + NodeAnimationDataHash &operator=(const NodeAnimationDataHash &) = delete; + NodeAnimationDataHash(NodeAnimationDataHash &&) = delete; + NodeAnimationDataHash &operator=(NodeAnimationDataHash &&) = delete; + + explicit NodeAnimationDataHash(const NodeAnimationData *nad) + : node_animation_data_(nad) { + hash_ = NodeAnimationDataHash::HashNodeAnimationData(*node_animation_data_); + } + + NodeAnimationDataHash(const NodeAnimationDataHash &nadh) { + node_animation_data_ = nadh.node_animation_data_; + hash_ = nadh.hash_; + } + + bool operator==(const NodeAnimationDataHash &nadh) const { + return *node_animation_data_ == *nadh.node_animation_data_; + } + + struct Hash { + size_t operator()(const NodeAnimationDataHash &nadh) const { + return nadh.hash_; + } + }; + + const NodeAnimationData *GetNodeAnimationData() { + return node_animation_data_; + } + + private: + // Returns a hash of |nad|. + static size_t HashNodeAnimationData(const NodeAnimationData &nad) { + size_t hash = 79; // Magic number. + hash = HashCombine(static_cast(nad.type()), hash); + hash = HashCombine(nad.count(), hash); + hash = HashCombine(nad.normalized(), hash); + const uint64_t data_hash = + FingerprintString(reinterpret_cast(nad.GetData()->data()), + nad.GetData()->size() * sizeof(float)); + hash = HashCombine(data_hash, hash); + return hash; + } + + const NodeAnimationData *node_animation_data_; + size_t hash_; +}; + +} // namespace draco + +#endif // DRACO_TRANSCODER_SUPPORTED +#endif // DRACO_ANIMATION_NODE_ANIMATION_DATA_H_ diff --git a/contrib/draco/src/draco/animation/skin.cc b/contrib/draco/src/draco/animation/skin.cc new file mode 100644 index 000000000..f232978c2 --- /dev/null +++ b/contrib/draco/src/draco/animation/skin.cc @@ -0,0 +1,29 @@ +// Copyright 2019 The Draco Authors. +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. +// +#include "draco/animation/skin.h" + +#ifdef DRACO_TRANSCODER_SUPPORTED + +namespace draco { + +void Skin::Copy(const Skin &s) { + inverse_bind_matrices_.Copy(s.GetInverseBindMatrices()); + joints_ = s.GetJoints(); + joint_root_index_ = s.GetJointRoot(); +} + +} // namespace draco + +#endif // DRACO_TRANSCODER_SUPPORTED diff --git a/contrib/draco/src/draco/animation/skin.h b/contrib/draco/src/draco/animation/skin.h new file mode 100644 index 000000000..81ca997eb --- /dev/null +++ b/contrib/draco/src/draco/animation/skin.h @@ -0,0 +1,64 @@ +// Copyright 2019 The Draco Authors. +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. +// +#ifndef DRACO_ANIMATION_SKIN_H_ +#define DRACO_ANIMATION_SKIN_H_ + +#include "draco/draco_features.h" + +#ifdef DRACO_TRANSCODER_SUPPORTED + +#include + +#include "draco/animation/node_animation_data.h" +#include "draco/scene/scene_indices.h" + +namespace draco { + +// This class is used to store information on animation skins. +class Skin { + public: + Skin() : joint_root_index_(-1) {} + + void Copy(const Skin &s); + + NodeAnimationData &GetInverseBindMatrices() { return inverse_bind_matrices_; } + const NodeAnimationData &GetInverseBindMatrices() const { + return inverse_bind_matrices_; + } + + int AddJoint(SceneNodeIndex index) { + joints_.push_back(index); + return joints_.size() - 1; + } + int NumJoints() const { return joints_.size(); } + SceneNodeIndex GetJoint(int index) const { return joints_[index]; } + SceneNodeIndex &GetJoint(int index) { return joints_[index]; } + const std::vector &GetJoints() const { return joints_; } + + void SetJointRoot(SceneNodeIndex index) { joint_root_index_ = index; } + SceneNodeIndex GetJointRoot() const { return joint_root_index_; } + + private: + NodeAnimationData inverse_bind_matrices_; + + // List of node indices that make up the joint hierarchy. + std::vector joints_; + SceneNodeIndex joint_root_index_; +}; + +} // namespace draco + +#endif // DRACO_TRANSCODER_SUPPORTED +#endif // DRACO_ANIMATION_SKIN_H_ diff --git a/contrib/draco/src/draco/attributes/attribute_transform.cc b/contrib/draco/src/draco/attributes/attribute_transform.cc index 174e6b822..fb2ed1829 100644 --- a/contrib/draco/src/draco/attributes/attribute_transform.cc +++ b/contrib/draco/src/draco/attributes/attribute_transform.cc @@ -28,12 +28,13 @@ std::unique_ptr AttributeTransform::InitTransformedAttribute( const PointAttribute &src_attribute, int num_entries) { const int num_components = GetTransformedNumComponents(src_attribute); const DataType dt = GetTransformedDataType(src_attribute); - GeometryAttribute va; - va.Init(src_attribute.attribute_type(), nullptr, num_components, dt, false, + GeometryAttribute ga; + ga.Init(src_attribute.attribute_type(), nullptr, num_components, dt, false, num_components * DataTypeLength(dt), 0); - std::unique_ptr transformed_attribute(new PointAttribute(va)); + std::unique_ptr transformed_attribute(new PointAttribute(ga)); transformed_attribute->Reset(num_entries); transformed_attribute->SetIdentityMapping(); + transformed_attribute->set_unique_id(src_attribute.unique_id()); return transformed_attribute; } diff --git a/contrib/draco/src/draco/attributes/geometry_attribute.cc b/contrib/draco/src/draco/attributes/geometry_attribute.cc index b62478426..141130f43 100644 --- a/contrib/draco/src/draco/attributes/geometry_attribute.cc +++ b/contrib/draco/src/draco/attributes/geometry_attribute.cc @@ -26,7 +26,7 @@ GeometryAttribute::GeometryAttribute() unique_id_(0) {} void GeometryAttribute::Init(GeometryAttribute::Type attribute_type, - DataBuffer *buffer, int8_t num_components, + DataBuffer *buffer, uint8_t num_components, DataType data_type, bool normalized, int64_t byte_stride, int64_t byte_offset) { buffer_ = buffer; diff --git a/contrib/draco/src/draco/attributes/geometry_attribute.h b/contrib/draco/src/draco/attributes/geometry_attribute.h index f4d099b1b..28f743fa0 100644 --- a/contrib/draco/src/draco/attributes/geometry_attribute.h +++ b/contrib/draco/src/draco/attributes/geometry_attribute.h @@ -15,12 +15,18 @@ #ifndef DRACO_ATTRIBUTES_GEOMETRY_ATTRIBUTE_H_ #define DRACO_ATTRIBUTES_GEOMETRY_ATTRIBUTE_H_ +#include #include +#include #include #include "draco/attributes/geometry_indices.h" #include "draco/core/data_buffer.h" #include "draco/core/hash_utils.h" +#include "draco/draco_features.h" +#ifdef DRACO_TRANSCODER_SUPPORTED +#include "draco/core/status.h" +#endif namespace draco { @@ -51,6 +57,16 @@ class GeometryAttribute { // predefined use case. Such attributes are often used for a shader specific // data. GENERIC, +#ifdef DRACO_TRANSCODER_SUPPORTED + // TODO(ostava): Adding a new attribute would be bit-stream change for GLTF. + // Older decoders wouldn't know what to do with this attribute type. This + // should be open-sourced only when we are ready to increase our bit-stream + // version. + TANGENT, + MATERIAL, + JOINTS, + WEIGHTS, +#endif // Total number of different attribute types. // Always keep behind all named attributes. NAMED_ATTRIBUTES_COUNT, @@ -58,7 +74,7 @@ class GeometryAttribute { GeometryAttribute(); // Initializes and enables the attribute. - void Init(Type attribute_type, DataBuffer *buffer, int8_t num_components, + void Init(Type attribute_type, DataBuffer *buffer, uint8_t num_components, DataType data_type, bool normalized, int64_t byte_stride, int64_t byte_offset); bool IsValid() const { return buffer_ != nullptr; } @@ -129,6 +145,17 @@ class GeometryAttribute { buffer_->Write(byte_pos, value, byte_stride()); } +#ifdef DRACO_TRANSCODER_SUPPORTED + // Sets a value of an attribute entry. The input |value| must have + // |input_num_components| entries and it will be automatically converted to + // the internal format used by the geometry attribute. If the conversion is + // not possible, an error status will be returned. + template + Status ConvertAndSetAttributeValue(AttributeValueIndex avi, + int input_num_components, + const InputT *value); +#endif + // DEPRECATED: Use // ConvertValue(AttributeValueIndex att_id, // int out_num_components, @@ -233,10 +260,11 @@ class GeometryAttribute { // Returns the number of components that are stored for each entry. // For position attribute this is usually three (x,y,z), // while texture coordinates have two components (u,v). - int8_t num_components() const { return num_components_; } + uint8_t num_components() const { return num_components_; } // Indicates whether the data type should be normalized before interpretation, // that is, it should be divided by the max value of the data type. bool normalized() const { return normalized_; } + void set_normalized(bool normalized) { normalized_ = normalized; } // The buffer storing the entire data of the attribute. const DataBuffer *buffer() const { return buffer_; } // Returns the number of bytes between two attribute entries, this is, at @@ -260,7 +288,7 @@ class GeometryAttribute { // T is the stored attribute data type. // OutT is the desired data type of the attribute. template - bool ConvertTypedValue(AttributeValueIndex att_id, int8_t out_num_components, + bool ConvertTypedValue(AttributeValueIndex att_id, uint8_t out_num_components, OutT *out_value) const { const uint8_t *src_address = GetAddress(att_id); @@ -270,29 +298,10 @@ class GeometryAttribute { return false; } const T in_value = *reinterpret_cast(src_address); - - // Make sure the in_value fits within the range of values that OutT - // is able to represent. Perform the check only for integral types. - if (std::is_integral::value && std::is_integral::value) { - static constexpr OutT kOutMin = - std::is_signed::value ? std::numeric_limits::lowest() : 0; - if (in_value < kOutMin || in_value > std::numeric_limits::max()) { - return false; - } + if (!ConvertComponentValue(in_value, normalized_, + out_value + i)) { + return false; } - - out_value[i] = static_cast(in_value); - // When converting integer to floating point, normalize the value if - // necessary. - if (std::is_integral::value && std::is_floating_point::value && - normalized_) { - out_value[i] /= static_cast(std::numeric_limits::max()); - } - // TODO(ostava): Add handling of normalized attributes when converting - // between different integer representations. If the attribute is - // normalized, integer values should be converted as if they represent 0-1 - // range. E.g. when we convert uint16 to uint8, the range <0, 2^16 - 1> - // should be converted to range <0, 2^8 - 1>. src_address += sizeof(T); } // Fill empty data for unused output components if needed. @@ -302,12 +311,128 @@ class GeometryAttribute { return true; } +#ifdef DRACO_TRANSCODER_SUPPORTED + // Function that converts input |value| from type T to the internal attribute + // representation defined by OutT and |num_components_|. + template + Status ConvertAndSetAttributeTypedValue(AttributeValueIndex avi, + int8_t input_num_components, + const T *value) { + uint8_t *address = GetAddress(avi); + + // Convert all components available in both the original and output formats. + for (int i = 0; i < num_components_; ++i) { + if (!IsAddressValid(address)) { + return ErrorStatus("GeometryAttribute: Invalid address."); + } + OutT *const out_value = reinterpret_cast(address); + if (i < input_num_components) { + if (!ConvertComponentValue(*(value + i), normalized_, + out_value)) { + return ErrorStatus( + "GeometryAttribute: Failed to convert component value."); + } + } else { + *out_value = static_cast(0); + } + address += sizeof(OutT); + } + return OkStatus(); + } +#endif // DRACO_TRANSCODER_SUPPORTED + + // Converts |in_value| of type T into |out_value| of type OutT. If + // |normalized| is true, any conversion between floating point and integer + // values will be treating integers as normalized types (the entire integer + // range will be used to represent 0-1 floating point range). + template + static bool ConvertComponentValue(const T &in_value, bool normalized, + OutT *out_value) { + // Make sure the |in_value| can be represented as an integral type OutT. + if (std::is_integral::value) { + // Make sure the |in_value| fits within the range of values that OutT + // is able to represent. Perform the check only for integral types. + if (!std::is_same::value && std::is_integral::value) { + static constexpr OutT kOutMin = + std::is_signed::value ? std::numeric_limits::min() : 0; + if (in_value < kOutMin || in_value > std::numeric_limits::max()) { + return false; + } + } + + // Check conversion of floating point |in_value| to integral value OutT. + if (std::is_floating_point::value) { + // Make sure the floating point |in_value| is not NaN and not Inf as + // integral type OutT is unable to represent these values. + if (sizeof(in_value) > sizeof(double)) { + if (std::isnan(static_cast(in_value)) || + std::isinf(static_cast(in_value))) { + return false; + } + } else if (sizeof(in_value) > sizeof(float)) { + if (std::isnan(static_cast(in_value)) || + std::isinf(static_cast(in_value))) { + return false; + } + } else { + if (std::isnan(static_cast(in_value)) || + std::isinf(static_cast(in_value))) { + return false; + } + } + + // Make sure the floating point |in_value| fits within the range of + // values that integral type OutT is able to represent. + if (in_value < std::numeric_limits::min() || + in_value >= std::numeric_limits::max()) { + return false; + } + } + } + + if (std::is_integral::value && std::is_floating_point::value && + normalized) { + // When converting integer to floating point, normalize the value if + // necessary. + *out_value = static_cast(in_value); + *out_value /= static_cast(std::numeric_limits::max()); + } else if (std::is_floating_point::value && + std::is_integral::value && normalized) { + // Converting from floating point to a normalized integer. + if (in_value > 1 || in_value < 0) { + // Normalized float values need to be between 0 and 1. + return false; + } + // TODO(ostava): Consider allowing float to normalized integer conversion + // for 64-bit integer types. Currently it doesn't work because we don't + // have a floating point type that could store all 64 bit integers. + if (sizeof(OutT) > 4) { + return false; + } + // Expand the float to the range of the output integer and round it to the + // nearest representable value. Use doubles for the math to ensure the + // integer values are represented properly during the conversion process. + *out_value = static_cast(std::floor( + in_value * static_cast(std::numeric_limits::max()) + + 0.5)); + } else { + *out_value = static_cast(in_value); + } + + // TODO(ostava): Add handling of normalized attributes when converting + // between different integer representations. If the attribute is + // normalized, integer values should be converted as if they represent 0-1 + // range. E.g. when we convert uint16 to uint8, the range <0, 2^16 - 1> + // should be converted to range <0, 2^8 - 1>. + return true; + } + DataBuffer *buffer_; // The buffer descriptor is stored at the time the buffer is attached to this // attribute. The purpose is to detect if any changes happened to the buffer // since the time it was attached. DataBufferDescriptor buffer_descriptor_; - int8_t num_components_; + uint8_t num_components_; DataType data_type_; bool normalized_; int64_t byte_stride_; @@ -323,6 +448,54 @@ class GeometryAttribute { friend struct GeometryAttributeHasher; }; +#ifdef DRACO_TRANSCODER_SUPPORTED +template +Status GeometryAttribute::ConvertAndSetAttributeValue(AttributeValueIndex avi, + int input_num_components, + const InputT *value) { + switch (this->data_type()) { + case DT_INT8: + return ConvertAndSetAttributeTypedValue( + avi, input_num_components, value); + case DT_UINT8: + return ConvertAndSetAttributeTypedValue( + avi, input_num_components, value); + case DT_INT16: + return ConvertAndSetAttributeTypedValue( + avi, input_num_components, value); + case DT_UINT16: + return ConvertAndSetAttributeTypedValue( + avi, input_num_components, value); + case DT_INT32: + return ConvertAndSetAttributeTypedValue( + avi, input_num_components, value); + case DT_UINT32: + return ConvertAndSetAttributeTypedValue( + avi, input_num_components, value); + case DT_INT64: + return ConvertAndSetAttributeTypedValue( + avi, input_num_components, value); + case DT_UINT64: + return ConvertAndSetAttributeTypedValue( + avi, input_num_components, value); + case DT_FLOAT32: + return ConvertAndSetAttributeTypedValue( + avi, input_num_components, value); + case DT_FLOAT64: + return ConvertAndSetAttributeTypedValue( + avi, input_num_components, value); + case DT_BOOL: + return ConvertAndSetAttributeTypedValue( + avi, input_num_components, value); + default: + break; + } + return ErrorStatus( + "GeometryAttribute::SetAndConvertAttributeValue: Unsupported " + "attribute type."); +} +#endif + // Hashing support // Function object for using Attribute as a hash key. diff --git a/contrib/draco/src/draco/attributes/point_attribute.cc b/contrib/draco/src/draco/attributes/point_attribute.cc index b28f860c1..e54ab5427 100644 --- a/contrib/draco/src/draco/attributes/point_attribute.cc +++ b/contrib/draco/src/draco/attributes/point_attribute.cc @@ -222,4 +222,47 @@ AttributeValueIndex::ValueType PointAttribute::DeduplicateFormattedValues( } #endif +#ifdef DRACO_TRANSCODER_SUPPORTED +void PointAttribute::RemoveUnusedValues() { + if (is_mapping_identity()) { + return; // For identity mapping, all values are always used. + } + // For explicit mapping we need to check if any point is mapped to a value. + // If not we can delete the value. + IndexTypeVector is_value_used(size(), false); + int num_used_values = 0; + for (PointIndex pi(0); pi < indices_map_.size(); ++pi) { + const AttributeValueIndex avi = indices_map_[pi]; + if (!is_value_used[avi]) { + is_value_used[avi] = true; + num_used_values++; + } + } + if (num_used_values == size()) { + return; // All values are used. + } + + // Remap the values and update the point to value mapping. + IndexTypeVector + old_to_new_value_map(size(), kInvalidAttributeValueIndex); + AttributeValueIndex new_avi(0); + for (AttributeValueIndex avi(0); avi < size(); ++avi) { + if (!is_value_used[avi]) { + continue; + } + if (avi != new_avi) { + SetAttributeValue(new_avi, GetAddress(avi)); + } + old_to_new_value_map[avi] = new_avi++; + } + + // Remap all points to the new attribute values. + for (PointIndex pi(0); pi < indices_map_.size(); ++pi) { + indices_map_[pi] = old_to_new_value_map[indices_map_[pi]]; + } + + num_unique_entries_ = num_used_values; +} +#endif + } // namespace draco diff --git a/contrib/draco/src/draco/attributes/point_attribute.h b/contrib/draco/src/draco/attributes/point_attribute.h index ee3662031..d55c50c8a 100644 --- a/contrib/draco/src/draco/attributes/point_attribute.h +++ b/contrib/draco/src/draco/attributes/point_attribute.h @@ -133,6 +133,12 @@ class PointAttribute : public GeometryAttribute { return attribute_transform_data_.get(); } +#ifdef DRACO_TRANSCODER_SUPPORTED + // Removes unused values from the attribute. Value is unused when no point + // is mapped to the value. Only applicable when the mapping is not identity. + void RemoveUnusedValues(); +#endif + private: #ifdef DRACO_ATTRIBUTE_VALUES_DEDUPLICATION_SUPPORTED template diff --git a/contrib/draco/src/draco/compression/attributes/attributes_encoder.cc b/contrib/draco/src/draco/compression/attributes/attributes_encoder.cc index 797c62f30..480e3ff34 100644 --- a/contrib/draco/src/draco/compression/attributes/attributes_encoder.cc +++ b/contrib/draco/src/draco/compression/attributes/attributes_encoder.cc @@ -15,14 +15,16 @@ #include "draco/compression/attributes/attributes_encoder.h" #include "draco/core/varint_encoding.h" +#include "draco/draco_features.h" namespace draco { AttributesEncoder::AttributesEncoder() : point_cloud_encoder_(nullptr), point_cloud_(nullptr) {} -AttributesEncoder::AttributesEncoder(int att_id) : AttributesEncoder() { - AddAttributeId(att_id); +AttributesEncoder::AttributesEncoder(int point_attrib_id) + : AttributesEncoder() { + AddAttributeId(point_attrib_id); } bool AttributesEncoder::Init(PointCloudEncoder *encoder, const PointCloud *pc) { @@ -37,7 +39,15 @@ bool AttributesEncoder::EncodeAttributesEncoderData(EncoderBuffer *out_buffer) { for (uint32_t i = 0; i < num_attributes(); ++i) { const int32_t att_id = point_attribute_ids_[i]; const PointAttribute *const pa = point_cloud_->attribute(att_id); - out_buffer->Encode(static_cast(pa->attribute_type())); + GeometryAttribute::Type type = pa->attribute_type(); +#ifdef DRACO_TRANSCODER_SUPPORTED + // Attribute types TANGENT, MATERIAL, JOINTS, and WEIGHTS are not supported + // in the official bitstream. They will be encoded as GENERIC. + if (type > GeometryAttribute::GENERIC) { + type = GeometryAttribute::GENERIC; + } +#endif + out_buffer->Encode(static_cast(type)); out_buffer->Encode(static_cast(pa->data_type())); out_buffer->Encode(static_cast(pa->num_components())); out_buffer->Encode(static_cast(pa->normalized())); diff --git a/contrib/draco/src/draco/compression/attributes/kd_tree_attributes_decoder.cc b/contrib/draco/src/draco/compression/attributes/kd_tree_attributes_decoder.cc index e4d53485d..51c41cf7a 100644 --- a/contrib/draco/src/draco/compression/attributes/kd_tree_attributes_decoder.cc +++ b/contrib/draco/src/draco/compression/attributes/kd_tree_attributes_decoder.cc @@ -72,16 +72,19 @@ class PointAttributeVectorOutputIterator { Self &operator*() { return *this; } // Still needed in some cases. - // TODO(hemmer): remove. + // TODO(b/199760123): Remove. // hardcoded to 3 based on legacy usage. const Self &operator=(const VectorD &val) { DRACO_DCHECK_EQ(attributes_.size(), 1); // Expect only ONE attribute. AttributeTuple &att = attributes_[0]; PointAttribute *attribute = std::get<0>(att); + const AttributeValueIndex avi = attribute->mapped_index(point_id_); + if (avi >= static_cast(attribute->size())) { + return *this; + } const uint32_t &offset = std::get<1>(att); DRACO_DCHECK_EQ(offset, 0); // expected to be zero - attribute->SetAttributeValue(attribute->mapped_index(point_id_), - &val[0] + offset); + attribute->SetAttributeValue(avi, &val[0] + offset); return *this; } // Additional operator taking std::vector as argument. @@ -89,6 +92,10 @@ class PointAttributeVectorOutputIterator { for (auto index = 0; index < attributes_.size(); index++) { AttributeTuple &att = attributes_[index]; PointAttribute *attribute = std::get<0>(att); + const AttributeValueIndex avi = attribute->mapped_index(point_id_); + if (avi >= static_cast(attribute->size())) { + return *this; + } const uint32_t &offset = std::get<1>(att); const uint32_t &data_size = std::get<3>(att); const uint32_t &num_components = std::get<4>(att); @@ -103,10 +110,6 @@ class PointAttributeVectorOutputIterator { // redirect to copied data data_source = reinterpret_cast(data_); } - const AttributeValueIndex avi = attribute->mapped_index(point_id_); - if (avi >= static_cast(attribute->size())) { - return *this; - } attribute->SetAttributeValue(avi, data_source); } return *this; @@ -195,54 +198,55 @@ bool KdTreeAttributesDecoder::DecodePortableAttributes( data_size, num_components); total_dimensionality += num_components; } - PointAttributeVectorOutputIterator out_it(atts); + typedef PointAttributeVectorOutputIterator OutIt; + OutIt out_it(atts); switch (compression_level) { case 0: { - DynamicIntegerPointsKdTreeDecoder<0> decoder(total_dimensionality); - if (!decoder.DecodePoints(in_buffer, out_it)) { + if (!DecodePoints<0, OutIt>(total_dimensionality, num_points, in_buffer, + &out_it)) { return false; } break; } case 1: { - DynamicIntegerPointsKdTreeDecoder<1> decoder(total_dimensionality); - if (!decoder.DecodePoints(in_buffer, out_it)) { + if (!DecodePoints<1, OutIt>(total_dimensionality, num_points, in_buffer, + &out_it)) { return false; } break; } case 2: { - DynamicIntegerPointsKdTreeDecoder<2> decoder(total_dimensionality); - if (!decoder.DecodePoints(in_buffer, out_it)) { + if (!DecodePoints<2, OutIt>(total_dimensionality, num_points, in_buffer, + &out_it)) { return false; } break; } case 3: { - DynamicIntegerPointsKdTreeDecoder<3> decoder(total_dimensionality); - if (!decoder.DecodePoints(in_buffer, out_it)) { + if (!DecodePoints<3, OutIt>(total_dimensionality, num_points, in_buffer, + &out_it)) { return false; } break; } case 4: { - DynamicIntegerPointsKdTreeDecoder<4> decoder(total_dimensionality); - if (!decoder.DecodePoints(in_buffer, out_it)) { + if (!DecodePoints<4, OutIt>(total_dimensionality, num_points, in_buffer, + &out_it)) { return false; } break; } case 5: { - DynamicIntegerPointsKdTreeDecoder<5> decoder(total_dimensionality); - if (!decoder.DecodePoints(in_buffer, out_it)) { + if (!DecodePoints<5, OutIt>(total_dimensionality, num_points, in_buffer, + &out_it)) { return false; } break; } case 6: { - DynamicIntegerPointsKdTreeDecoder<6> decoder(total_dimensionality); - if (!decoder.DecodePoints(in_buffer, out_it)) { + if (!DecodePoints<6, OutIt>(total_dimensionality, num_points, in_buffer, + &out_it)) { return false; } break; @@ -253,6 +257,19 @@ bool KdTreeAttributesDecoder::DecodePortableAttributes( return true; } +template +bool KdTreeAttributesDecoder::DecodePoints(int total_dimensionality, + int num_expected_points, + DecoderBuffer *in_buffer, + OutIteratorT *out_iterator) { + DynamicIntegerPointsKdTreeDecoder decoder(total_dimensionality); + if (!decoder.DecodePoints(in_buffer, *out_iterator, num_expected_points) || + decoder.num_decoded_points() != num_expected_points) { + return false; + } + return true; +} + bool KdTreeAttributesDecoder::DecodeDataNeededByPortableTransforms( DecoderBuffer *in_buffer) { if (in_buffer->bitstream_version() >= DRACO_BITSTREAM_VERSION(2, 3)) { @@ -336,6 +353,10 @@ bool KdTreeAttributesDecoder::DecodeDataNeededByPortableTransforms( return false; } if (method == KdTreeAttributesEncodingMethod::kKdTreeQuantizationEncoding) { + // This method only supports one attribute with exactly three components. + if (atts.size() != 1 || std::get<4>(atts[0]) != 3) { + return false; + } uint8_t compression_level = 0; if (!in_buffer->Decode(&compression_level)) { return false; @@ -376,7 +397,7 @@ bool KdTreeAttributesDecoder::DecodeDataNeededByPortableTransforms( GetDecoder()->point_cloud()->attribute(att_id); attr->Reset(num_points); attr->SetIdentityMapping(); - }; + } PointAttributeVectorOutputIterator out_it(atts); @@ -455,7 +476,11 @@ bool KdTreeAttributesDecoder::TransformAttributeBackToSignedType( att->GetValue(avi, &unsigned_val[0]); for (int c = 0; c < att->num_components(); ++c) { // Up-cast |unsigned_val| to int32_t to ensure we don't overflow it for - // smaller data types. + // smaller data types. But first check that the up-casting does not cause + // signed integer overflow. + if (unsigned_val[c] > std::numeric_limits::max()) { + return false; + } signed_val[c] = static_cast( static_cast(unsigned_val[c]) + min_signed_values_[num_processed_signed_components + c]); diff --git a/contrib/draco/src/draco/compression/attributes/kd_tree_attributes_decoder.h b/contrib/draco/src/draco/compression/attributes/kd_tree_attributes_decoder.h index 87338d6b0..4af367a1a 100644 --- a/contrib/draco/src/draco/compression/attributes/kd_tree_attributes_decoder.h +++ b/contrib/draco/src/draco/compression/attributes/kd_tree_attributes_decoder.h @@ -31,6 +31,10 @@ class KdTreeAttributesDecoder : public AttributesDecoder { bool TransformAttributesToOriginalFormat() override; private: + template + bool DecodePoints(int total_dimensionality, int num_expected_points, + DecoderBuffer *in_buffer, OutIteratorT *out_iterator); + template bool TransformAttributeBackToSignedType(PointAttribute *att, int num_processed_signed_components); diff --git a/contrib/draco/src/draco/compression/attributes/normal_compression_utils.h b/contrib/draco/src/draco/compression/attributes/normal_compression_utils.h index 8a6f25b66..b717d0dbe 100644 --- a/contrib/draco/src/draco/compression/attributes/normal_compression_utils.h +++ b/contrib/draco/src/draco/compression/attributes/normal_compression_utils.h @@ -61,7 +61,7 @@ class OctahedronToolBox { return false; } quantization_bits_ = q; - max_quantized_value_ = (1 << quantization_bits_) - 1; + max_quantized_value_ = (1u << quantization_bits_) - 1; max_value_ = max_quantized_value_ - 1; dequantization_scale_ = 2.f / max_value_; center_value_ = max_value_ / 2; @@ -208,7 +208,9 @@ class OctahedronToolBox { DRACO_DCHECK_LE(t, center_value_); DRACO_DCHECK_GE(s, -center_value_); DRACO_DCHECK_GE(t, -center_value_); - return std::abs(s) + std::abs(t) <= center_value_; + const uint32_t st = + static_cast(std::abs(s)) + static_cast(std::abs(t)); + return st <= center_value_; } void InvertDiamond(int32_t *s, int32_t *t) const { @@ -230,19 +232,29 @@ class OctahedronToolBox { sign_t = (*t > 0) ? 1 : -1; } - const int32_t corner_point_s = sign_s * center_value_; - const int32_t corner_point_t = sign_t * center_value_; - *s = 2 * *s - corner_point_s; - *t = 2 * *t - corner_point_t; + // Perform the addition and subtraction using unsigned integers to avoid + // signed integer overflows for bad data. Note that the result will be + // unchanged for non-overflowing cases. + const uint32_t corner_point_s = sign_s * center_value_; + const uint32_t corner_point_t = sign_t * center_value_; + uint32_t us = *s; + uint32_t ut = *t; + us = us + us - corner_point_s; + ut = ut + ut - corner_point_t; if (sign_s * sign_t >= 0) { - int32_t temp = *s; - *s = -*t; - *t = -temp; + uint32_t temp = us; + us = -ut; + ut = -temp; } else { - std::swap(*s, *t); + std::swap(us, ut); } - *s = (*s + corner_point_s) / 2; - *t = (*t + corner_point_t) / 2; + us = us + corner_point_s; + ut = ut + corner_point_t; + + *s = us; + *t = ut; + *s /= 2; + *t /= 2; } void InvertDirection(int32_t *s, int32_t *t) const { @@ -318,7 +330,7 @@ class OctahedronToolBox { // Remaining coordinate can be computed by projecting the (y, z) values onto // the surface of the octahedron. - const float x = 1.f - abs(y) - abs(z); + const float x = 1.f - std::abs(y) - std::abs(z); // |x| is essentially a signed distance from the diagonal edges of the // diamond shown on the figure above. It is positive for all points in the diff --git a/contrib/draco/src/draco/compression/attributes/point_d_vector.h b/contrib/draco/src/draco/compression/attributes/point_d_vector.h index 3b115d500..6ceb454ae 100644 --- a/contrib/draco/src/draco/compression/attributes/point_d_vector.h +++ b/contrib/draco/src/draco/compression/attributes/point_d_vector.h @@ -16,7 +16,9 @@ #ifndef DRACO_COMPRESSION_ATTRIBUTES_POINT_D_VECTOR_H_ #define DRACO_COMPRESSION_ATTRIBUTES_POINT_D_VECTOR_H_ +#include #include +#include #include #include @@ -99,11 +101,17 @@ class PointDVector { data_(n_items * dimensionality), data0_(data_.data()) {} // random access iterator - class PointDVectorIterator - : public std::iterator { + class PointDVectorIterator { friend class PointDVector; public: + // Iterator traits expected by std libraries. + using iterator_category = std::random_access_iterator_tag; + using value_type = size_t; + using difference_type = size_t; + using pointer = PointDVector *; + using reference = PointDVector &; + // std::iter_swap is called inside of std::partition and needs this // specialized support PseudoPointD operator*() const { diff --git a/contrib/draco/src/draco/compression/attributes/prediction_schemes/mesh_prediction_scheme_constrained_multi_parallelogram_decoder.h b/contrib/draco/src/draco/compression/attributes/prediction_schemes/mesh_prediction_scheme_constrained_multi_parallelogram_decoder.h index 36c124baa..17899d054 100644 --- a/contrib/draco/src/draco/compression/attributes/prediction_schemes/mesh_prediction_scheme_constrained_multi_parallelogram_decoder.h +++ b/contrib/draco/src/draco/compression/attributes/prediction_schemes/mesh_prediction_scheme_constrained_multi_parallelogram_decoder.h @@ -22,6 +22,7 @@ #include "draco/compression/attributes/prediction_schemes/mesh_prediction_scheme_decoder.h" #include "draco/compression/attributes/prediction_schemes/mesh_prediction_scheme_parallelogram_shared.h" #include "draco/compression/bit_coders/rans_bit_decoder.h" +#include "draco/core/math_utils.h" #include "draco/core/varint_decoding.h" #include "draco/draco_features.h" @@ -161,7 +162,8 @@ bool MeshPredictionSchemeConstrainedMultiParallelogramDecoder< if (!is_crease) { ++num_used_parallelograms; for (int j = 0; j < num_components; ++j) { - multi_pred_vals[j] += pred_vals[i][j]; + multi_pred_vals[j] = + AddAsUnsigned(multi_pred_vals[j], pred_vals[i][j]); } } } @@ -210,6 +212,9 @@ bool MeshPredictionSchemeConstrainedMultiParallelogramDecoder< if (!DecodeVarint(&num_flags, buffer)) { return false; } + if (num_flags > this->mesh_data().corner_table()->num_corners()) { + return false; + } if (num_flags > 0) { is_crease_edge_[i].resize(num_flags); RAnsBitDecoder decoder; diff --git a/contrib/draco/src/draco/compression/attributes/prediction_schemes/mesh_prediction_scheme_constrained_multi_parallelogram_encoder.h b/contrib/draco/src/draco/compression/attributes/prediction_schemes/mesh_prediction_scheme_constrained_multi_parallelogram_encoder.h index 77df8ee24..736598b15 100644 --- a/contrib/draco/src/draco/compression/attributes/prediction_schemes/mesh_prediction_scheme_constrained_multi_parallelogram_encoder.h +++ b/contrib/draco/src/draco/compression/attributes/prediction_schemes/mesh_prediction_scheme_constrained_multi_parallelogram_encoder.h @@ -392,7 +392,7 @@ bool MeshPredictionSchemeConstrainedMultiParallelogramEncoder< RAnsBitEncoder encoder; encoder.StartEncoding(); // Encode the crease edge flags in the reverse vertex order that is needed - // be the decoder. Note that for the currently supported mode, each vertex + // by the decoder. Note that for the currently supported mode, each vertex // has exactly |num_used_parallelograms| edges that need to be encoded. for (int j = static_cast(is_crease_edge_[i].size()) - num_used_parallelograms; diff --git a/contrib/draco/src/draco/compression/attributes/prediction_schemes/mesh_prediction_scheme_multi_parallelogram_decoder.h b/contrib/draco/src/draco/compression/attributes/prediction_schemes/mesh_prediction_scheme_multi_parallelogram_decoder.h index fc82e0a8f..9825c7261 100644 --- a/contrib/draco/src/draco/compression/attributes/prediction_schemes/mesh_prediction_scheme_multi_parallelogram_decoder.h +++ b/contrib/draco/src/draco/compression/attributes/prediction_schemes/mesh_prediction_scheme_multi_parallelogram_decoder.h @@ -18,6 +18,7 @@ #include "draco/compression/attributes/prediction_schemes/mesh_prediction_scheme_decoder.h" #include "draco/compression/attributes/prediction_schemes/mesh_prediction_scheme_parallelogram_shared.h" +#include "draco/core/math_utils.h" #include "draco/draco_features.h" namespace draco { @@ -89,7 +90,8 @@ bool MeshPredictionSchemeMultiParallelogramDecoder(data[data_offset + 1])); } - void ComputePredictedValue(CornerIndex corner_id, const DataTypeT *data, + bool ComputePredictedValue(CornerIndex corner_id, const DataTypeT *data, int data_id); private: @@ -123,6 +123,10 @@ bool MeshPredictionSchemeTexCoordsDecoder:: ComputeOriginalValues(const CorrType *in_corr, DataTypeT *out_data, int /* size */, int num_components, const PointIndex *entry_to_point_id_map) { + if (num_components != 2) { + // Corrupt/malformed input. Two output components are req'd. + return false; + } num_components_ = num_components; entry_to_point_id_map_ = entry_to_point_id_map; predicted_value_ = @@ -133,7 +137,9 @@ bool MeshPredictionSchemeTexCoordsDecoder:: static_cast(this->mesh_data().data_to_corner_map()->size()); for (int p = 0; p < corner_map_size; ++p) { const CornerIndex corner_id = this->mesh_data().data_to_corner_map()->at(p); - ComputePredictedValue(corner_id, out_data, p); + if (!ComputePredictedValue(corner_id, out_data, p)) { + return false; + } const int dst_offset = p * num_components; this->transform().ComputeOriginalValue( @@ -159,6 +165,11 @@ bool MeshPredictionSchemeTexCoordsDecoder:: if (num_orientations == 0) { return false; } + if (num_orientations > this->mesh_data().corner_table()->num_corners()) { + // We can't have more orientations than the maximum number of decoded + // values. + return false; + } orientations_.resize(num_orientations); bool last_orientation = true; RAnsBitDecoder decoder; @@ -177,7 +188,7 @@ bool MeshPredictionSchemeTexCoordsDecoder:: } template -void MeshPredictionSchemeTexCoordsDecoder:: +bool MeshPredictionSchemeTexCoordsDecoder:: ComputePredictedValue(CornerIndex corner_id, const DataTypeT *data, int data_id) { // Compute the predicted UV coordinate from the positions on all corners @@ -206,9 +217,17 @@ void MeshPredictionSchemeTexCoordsDecoder:: const Vector2f p_uv = GetTexCoordForEntryId(prev_data_id, data); if (p_uv == n_uv) { // We cannot do a reliable prediction on degenerated UV triangles. - predicted_value_[0] = static_cast(p_uv[0]); - predicted_value_[1] = static_cast(p_uv[1]); - return; + // Technically floats > INT_MAX are undefined, but compilers will + // convert those values to INT_MIN. We are being explicit here for asan. + for (const int i : {0, 1}) { + if (std::isnan(p_uv[i]) || static_cast(p_uv[i]) > INT_MAX || + static_cast(p_uv[i]) < INT_MIN) { + predicted_value_[i] = INT_MIN; + } else { + predicted_value_[i] = static_cast(p_uv[i]); + } + } + return true; } // Get positions at all corners. @@ -282,32 +301,40 @@ void MeshPredictionSchemeTexCoordsDecoder:: const float pnvs = pn_uv[1] * s + n_uv[1]; const float pnvt = pn_uv[1] * t; Vector2f predicted_uv; + if (orientations_.empty()) { + return false; + } // When decoding the data, we already know which orientation to use. const bool orientation = orientations_.back(); orientations_.pop_back(); - if (orientation) + if (orientation) { predicted_uv = Vector2f(pnus - pnvt, pnvs + pnut); - else + } else { predicted_uv = Vector2f(pnus + pnvt, pnvs - pnut); - + } if (std::is_integral::value) { // Round the predicted value for integer types. - if (std::isnan(predicted_uv[0])) { + // Technically floats > INT_MAX are undefined, but compilers will + // convert those values to INT_MIN. We are being explicit here for asan. + const double u = floor(predicted_uv[0] + 0.5); + if (std::isnan(u) || u > INT_MAX || u < INT_MIN) { predicted_value_[0] = INT_MIN; } else { - predicted_value_[0] = static_cast(floor(predicted_uv[0] + 0.5)); + predicted_value_[0] = static_cast(u); } - if (std::isnan(predicted_uv[1])) { + const double v = floor(predicted_uv[1] + 0.5); + if (std::isnan(v) || v > INT_MAX || v < INT_MIN) { predicted_value_[1] = INT_MIN; } else { - predicted_value_[1] = static_cast(floor(predicted_uv[1] + 0.5)); + predicted_value_[1] = static_cast(v); } } else { predicted_value_[0] = static_cast(predicted_uv[0]); predicted_value_[1] = static_cast(predicted_uv[1]); } - return; + + return true; } // Else we don't have available textures on both corners. For such case we // can't use positions for predicting the uv value and we resort to delta @@ -330,12 +357,13 @@ void MeshPredictionSchemeTexCoordsDecoder:: for (int i = 0; i < num_components_; ++i) { predicted_value_[i] = 0; } - return; + return true; } } for (int i = 0; i < num_components_; ++i) { predicted_value_[i] = data[data_offset + i]; } + return true; } } // namespace draco diff --git a/contrib/draco/src/draco/compression/attributes/prediction_schemes/mesh_prediction_scheme_tex_coords_portable_encoder.h b/contrib/draco/src/draco/compression/attributes/prediction_schemes/mesh_prediction_scheme_tex_coords_portable_encoder.h index 741ec66dc..44fcc7a6a 100644 --- a/contrib/draco/src/draco/compression/attributes/prediction_schemes/mesh_prediction_scheme_tex_coords_portable_encoder.h +++ b/contrib/draco/src/draco/compression/attributes/prediction_schemes/mesh_prediction_scheme_tex_coords_portable_encoder.h @@ -98,7 +98,10 @@ bool MeshPredictionSchemeTexCoordsPortableEncoder(this->mesh_data().data_to_corner_map()->size() - 1); p >= 0; --p) { const CornerIndex corner_id = this->mesh_data().data_to_corner_map()->at(p); - predictor_.template ComputePredictedValue(corner_id, in_data, p); + if (!predictor_.template ComputePredictedValue(corner_id, in_data, + p)) { + return false; + } const int dst_offset = p * num_components; this->transform().ComputeCorrection(in_data + dst_offset, diff --git a/contrib/draco/src/draco/compression/attributes/prediction_schemes/mesh_prediction_scheme_tex_coords_portable_predictor.h b/contrib/draco/src/draco/compression/attributes/prediction_schemes/mesh_prediction_scheme_tex_coords_portable_predictor.h index f05e5ddd7..26262fb13 100644 --- a/contrib/draco/src/draco/compression/attributes/prediction_schemes/mesh_prediction_scheme_tex_coords_portable_predictor.h +++ b/contrib/draco/src/draco/compression/attributes/prediction_schemes/mesh_prediction_scheme_tex_coords_portable_predictor.h @@ -17,6 +17,9 @@ #include +#include +#include + #include "draco/attributes/point_attribute.h" #include "draco/core/math_utils.h" #include "draco/core/vector_d.h" @@ -105,10 +108,14 @@ bool MeshPredictionSchemeTexCoordsPortablePredictor< next_data_id = mesh_data_.vertex_to_data_map()->at(next_vert_id); prev_data_id = mesh_data_.vertex_to_data_map()->at(prev_vert_id); + typedef VectorD Vec2; + typedef VectorD Vec3; + typedef VectorD Vec2u; + if (prev_data_id < data_id && next_data_id < data_id) { // Both other corners have available UV coordinates for prediction. - const VectorD n_uv = GetTexCoordForEntryId(next_data_id, data); - const VectorD p_uv = GetTexCoordForEntryId(prev_data_id, data); + const Vec2 n_uv = GetTexCoordForEntryId(next_data_id, data); + const Vec2 p_uv = GetTexCoordForEntryId(prev_data_id, data); if (p_uv == n_uv) { // We cannot do a reliable prediction on degenerated UV triangles. predicted_value_[0] = p_uv[0]; @@ -117,9 +124,9 @@ bool MeshPredictionSchemeTexCoordsPortablePredictor< } // Get positions at all corners. - const VectorD tip_pos = GetPositionForEntryId(data_id); - const VectorD next_pos = GetPositionForEntryId(next_data_id); - const VectorD prev_pos = GetPositionForEntryId(prev_data_id); + const Vec3 tip_pos = GetPositionForEntryId(data_id); + const Vec3 next_pos = GetPositionForEntryId(next_data_id); + const Vec3 prev_pos = GetPositionForEntryId(prev_data_id); // We use the positions of the above triangle to predict the texture // coordinate on the tip corner C. // To convert the triangle into the UV coordinate system we first compute @@ -135,17 +142,17 @@ bool MeshPredictionSchemeTexCoordsPortablePredictor< // Where next_pos is point (N), prev_pos is point (P) and tip_pos is the // position of predicted coordinate (C). // - const VectorD pn = prev_pos - next_pos; + const Vec3 pn = prev_pos - next_pos; const uint64_t pn_norm2_squared = pn.SquaredNorm(); if (pn_norm2_squared != 0) { // Compute the projection of C onto PN by computing dot product of CN with // PN and normalizing it by length of PN. This gives us a factor |s| where // |s = PN.Dot(CN) / PN.SquaredNorm2()|. This factor can be used to // compute X in UV space |X_UV| as |X_UV = N_UV + s * PN_UV|. - const VectorD cn = tip_pos - next_pos; + const Vec3 cn = tip_pos - next_pos; const int64_t cn_dot_pn = pn.Dot(cn); - const VectorD pn_uv = p_uv - n_uv; + const Vec2 pn_uv = p_uv - n_uv; // Because we perform all computations with integers, we don't explicitly // compute the normalized factor |s|, but rather we perform all operations // over UV vectors in a non-normalized coordinate system scaled with a @@ -153,19 +160,30 @@ bool MeshPredictionSchemeTexCoordsPortablePredictor< // // x_uv = X_UV * PN.Norm2Squared() // - const VectorD x_uv = - n_uv * pn_norm2_squared + (cn_dot_pn * pn_uv); - + const int64_t n_uv_absmax_element = + std::max(std::abs(n_uv[0]), std::abs(n_uv[1])); + if (n_uv_absmax_element > + std::numeric_limits::max() / pn_norm2_squared) { + // Return false if the below multiplication would overflow. + return false; + } + const int64_t pn_uv_absmax_element = + std::max(std::abs(pn_uv[0]), std::abs(pn_uv[1])); + if (cn_dot_pn > + std::numeric_limits::max() / pn_uv_absmax_element) { + // Return false if squared length calculation would overflow. + return false; + } + const Vec2 x_uv = n_uv * pn_norm2_squared + (cn_dot_pn * pn_uv); const int64_t pn_absmax_element = std::max(std::max(std::abs(pn[0]), std::abs(pn[1])), std::abs(pn[2])); if (cn_dot_pn > std::numeric_limits::max() / pn_absmax_element) { - // return false if squared length calculation would overflow. + // Return false if squared length calculation would overflow. return false; } // Compute squared length of vector CX in position coordinate system: - const VectorD x_pos = - next_pos + (cn_dot_pn * pn) / pn_norm2_squared; + const Vec3 x_pos = next_pos + (cn_dot_pn * pn) / pn_norm2_squared; const uint64_t cx_norm2_squared = (tip_pos - x_pos).SquaredNorm(); // Compute vector CX_UV in the uv space by rotating vector PN_UV by 90 @@ -182,7 +200,7 @@ bool MeshPredictionSchemeTexCoordsPortablePredictor< // // cx_uv = CX.Norm2() * PN.Norm2() * Rot(PN_UV) // - VectorD cx_uv(pn_uv[1], -pn_uv[0]); // Rotated PN_UV. + Vec2 cx_uv(pn_uv[1], -pn_uv[0]); // Rotated PN_UV. // Compute CX.Norm2() * PN.Norm2() const uint64_t norm_squared = IntSqrt(cx_norm2_squared * pn_norm2_squared); @@ -191,17 +209,15 @@ bool MeshPredictionSchemeTexCoordsPortablePredictor< // Predicted uv coordinate is then computed by either adding or // subtracting CX_UV to/from X_UV. - VectorD predicted_uv; + Vec2 predicted_uv; if (is_encoder_t) { // When encoding, compute both possible vectors and determine which one // results in a better prediction. // Both vectors need to be transformed back from the scaled space to // the real UV coordinate space. - const VectorD predicted_uv_0((x_uv + cx_uv) / - pn_norm2_squared); - const VectorD predicted_uv_1((x_uv - cx_uv) / - pn_norm2_squared); - const VectorD c_uv = GetTexCoordForEntryId(data_id, data); + const Vec2 predicted_uv_0((x_uv + cx_uv) / pn_norm2_squared); + const Vec2 predicted_uv_1((x_uv - cx_uv) / pn_norm2_squared); + const Vec2 c_uv = GetTexCoordForEntryId(data_id, data); if ((c_uv - predicted_uv_0).SquaredNorm() < (c_uv - predicted_uv_1).SquaredNorm()) { predicted_uv = predicted_uv_0; @@ -217,10 +233,12 @@ bool MeshPredictionSchemeTexCoordsPortablePredictor< } const bool orientation = orientations_.back(); orientations_.pop_back(); + // Perform operations in unsigned type to avoid signed integer overflow. + // Note that the result will be the same (for non-overflowing values). if (orientation) { - predicted_uv = (x_uv + cx_uv) / pn_norm2_squared; + predicted_uv = Vec2(Vec2u(x_uv) + Vec2u(cx_uv)) / pn_norm2_squared; } else { - predicted_uv = (x_uv - cx_uv) / pn_norm2_squared; + predicted_uv = Vec2(Vec2u(x_uv) - Vec2u(cx_uv)) / pn_norm2_squared; } } predicted_value_[0] = static_cast(predicted_uv[0]); diff --git a/contrib/draco/src/draco/compression/attributes/prediction_schemes/prediction_scheme_encoder_factory.cc b/contrib/draco/src/draco/compression/attributes/prediction_schemes/prediction_scheme_encoder_factory.cc index f410a6cd2..2338f2f76 100644 --- a/contrib/draco/src/draco/compression/attributes/prediction_schemes/prediction_scheme_encoder_factory.cc +++ b/contrib/draco/src/draco/compression/attributes/prediction_schemes/prediction_scheme_encoder_factory.cc @@ -18,22 +18,58 @@ namespace draco { PredictionSchemeMethod SelectPredictionMethod( int att_id, const PointCloudEncoder *encoder) { - if (encoder->options()->GetSpeed() >= 10) { + return SelectPredictionMethod(att_id, *encoder->options(), encoder); +} + +PredictionSchemeMethod SelectPredictionMethod( + int att_id, const EncoderOptions &options, + const PointCloudEncoder *encoder) { + if (options.GetSpeed() >= 10) { // Selected fastest, though still doing some compression. return PREDICTION_DIFFERENCE; } if (encoder->GetGeometryType() == TRIANGULAR_MESH) { // Use speed setting to select the best encoding method. + const int att_quant = + options.GetAttributeInt(att_id, "quantization_bits", -1); const PointAttribute *const att = encoder->point_cloud()->attribute(att_id); - if (att->attribute_type() == GeometryAttribute::TEX_COORD) { - if (encoder->options()->GetSpeed() < 4) { + if (att_quant != -1 && + att->attribute_type() == GeometryAttribute::TEX_COORD && + att->num_components() == 2) { + // Texture coordinate predictor needs a position attribute that is either + // integer or quantized. For numerical reasons, we require the position + // quantization to be at most 21 bits and the 2*position_quantization + + // uv_quantization < 64 (TODO(b/231259902)). + const PointAttribute *const pos_att = + encoder->point_cloud()->GetNamedAttribute( + GeometryAttribute::POSITION); + bool is_pos_att_valid = false; + if (pos_att) { + if (IsDataTypeIntegral(pos_att->data_type())) { + is_pos_att_valid = true; + } else { + // Check quantization of the position attribute. + const int pos_att_id = encoder->point_cloud()->GetNamedAttributeId( + GeometryAttribute::POSITION); + const int pos_quant = + options.GetAttributeInt(pos_att_id, "quantization_bits", -1); + // Must be quantized but the quantization is restricted to 21 bits and + // 2*|pos_quant|+|att_quant| must be smaller than 64 bits. + if (pos_quant > 0 && pos_quant <= 21 && + 2 * pos_quant + att_quant < 64) { + is_pos_att_valid = true; + } + } + } + + if (is_pos_att_valid && options.GetSpeed() < 4) { // Use texture coordinate prediction for speeds 0, 1, 2, 3. return MESH_PREDICTION_TEX_COORDS_PORTABLE; } } if (att->attribute_type() == GeometryAttribute::NORMAL) { #ifdef DRACO_NORMAL_ENCODING_SUPPORTED - if (encoder->options()->GetSpeed() < 4) { + if (options.GetSpeed() < 4) { // Use geometric normal prediction for speeds 0, 1, 2, 3. // For this prediction, the position attribute needs to be either // integer or quantized as well. @@ -43,8 +79,8 @@ PredictionSchemeMethod SelectPredictionMethod( encoder->point_cloud()->GetNamedAttribute( GeometryAttribute::POSITION); if (pos_att && (IsDataTypeIntegral(pos_att->data_type()) || - encoder->options()->GetAttributeInt( - pos_att_id, "quantization_bits", -1) > 0)) { + options.GetAttributeInt(pos_att_id, "quantization_bits", + -1) > 0)) { return MESH_PREDICTION_GEOMETRIC_NORMAL; } } @@ -52,11 +88,10 @@ PredictionSchemeMethod SelectPredictionMethod( return PREDICTION_DIFFERENCE; // default } // Handle other attribute types. - if (encoder->options()->GetSpeed() >= 8) { + if (options.GetSpeed() >= 8) { return PREDICTION_DIFFERENCE; } - if (encoder->options()->GetSpeed() >= 2 || - encoder->point_cloud()->num_points() < 40) { + if (options.GetSpeed() >= 2 || encoder->point_cloud()->num_points() < 40) { // Parallelogram prediction is used for speeds 2 - 7 or when the overhead // of using constrained multi-parallelogram would be too high. return MESH_PREDICTION_PARALLELOGRAM; diff --git a/contrib/draco/src/draco/compression/attributes/prediction_schemes/prediction_scheme_encoder_factory.h b/contrib/draco/src/draco/compression/attributes/prediction_schemes/prediction_scheme_encoder_factory.h index 40a7683aa..11db5a62e 100644 --- a/contrib/draco/src/draco/compression/attributes/prediction_schemes/prediction_scheme_encoder_factory.h +++ b/contrib/draco/src/draco/compression/attributes/prediction_schemes/prediction_scheme_encoder_factory.h @@ -38,6 +38,10 @@ namespace draco { PredictionSchemeMethod SelectPredictionMethod(int att_id, const PointCloudEncoder *encoder); +PredictionSchemeMethod SelectPredictionMethod(int att_id, + const EncoderOptions &options, + const PointCloudEncoder *encoder); + // Factory class for creating mesh prediction schemes. template struct MeshPredictionSchemeEncoderFactory { @@ -97,10 +101,11 @@ CreatePredictionSchemeForEncoder(PredictionSchemeMethod method, int att_id, // template nature of the prediction schemes). const MeshEncoder *const mesh_encoder = static_cast(encoder); + const uint16_t bitstream_version = kDracoMeshBitstreamVersion; auto ret = CreateMeshPredictionScheme< MeshEncoder, PredictionSchemeEncoder, MeshPredictionSchemeEncoderFactory>( - mesh_encoder, method, att_id, transform, kDracoMeshBitstreamVersion); + mesh_encoder, method, att_id, transform, bitstream_version); if (ret) { return ret; } diff --git a/contrib/draco/src/draco/compression/attributes/prediction_schemes/prediction_scheme_normal_octahedron_canonicalized_decoding_transform.h b/contrib/draco/src/draco/compression/attributes/prediction_schemes/prediction_scheme_normal_octahedron_canonicalized_decoding_transform.h index 5a6c7c2dd..e9e345343 100644 --- a/contrib/draco/src/draco/compression/attributes/prediction_schemes/prediction_scheme_normal_octahedron_canonicalized_decoding_transform.h +++ b/contrib/draco/src/draco/compression/attributes/prediction_schemes/prediction_scheme_normal_octahedron_canonicalized_decoding_transform.h @@ -21,6 +21,7 @@ #include "draco/compression/attributes/prediction_schemes/prediction_scheme_normal_octahedron_canonicalized_transform_base.h" #include "draco/core/decoder_buffer.h" #include "draco/core/macros.h" +#include "draco/core/math_utils.h" #include "draco/core/vector_d.h" namespace draco { @@ -98,9 +99,8 @@ class PredictionSchemeNormalOctahedronCanonicalizedDecodingTransform if (!pred_is_in_bottom_left) { pred = this->RotatePoint(pred, rotation_count); } - Point2 orig = pred + corr; - orig[0] = this->ModMax(orig[0]); - orig[1] = this->ModMax(orig[1]); + Point2 orig(this->ModMax(AddAsUnsigned(pred[0], corr[0])), + this->ModMax(AddAsUnsigned(pred[1], corr[1]))); if (!pred_is_in_bottom_left) { const int32_t reverse_rotation_count = (4 - rotation_count) % 4; orig = this->RotatePoint(orig, reverse_rotation_count); diff --git a/contrib/draco/src/draco/compression/attributes/prediction_schemes/prediction_scheme_normal_octahedron_canonicalized_transform_test.cc b/contrib/draco/src/draco/compression/attributes/prediction_schemes/prediction_scheme_normal_octahedron_canonicalized_transform_test.cc index 8c8932f77..298758d8c 100644 --- a/contrib/draco/src/draco/compression/attributes/prediction_schemes/prediction_scheme_normal_octahedron_canonicalized_transform_test.cc +++ b/contrib/draco/src/draco/compression/attributes/prediction_schemes/prediction_scheme_normal_octahedron_canonicalized_transform_test.cc @@ -25,10 +25,10 @@ class PredictionSchemeNormalOctahedronCanonicalizedTransformTest Transform; typedef Transform::Point2 Point2; - void TestComputeCorrection(const Transform &transform, const int32_t &ox, - const int32_t &oy, const int32_t &px, - const int32_t &py, const int32_t &cx, - const int32_t &cy) { + void TestComputeCorrection(const Transform &transform, const int32_t ox, + const int32_t oy, const int32_t px, + const int32_t py, const int32_t cx, + const int32_t cy) { const int32_t o[2] = {ox + 7, oy + 7}; const int32_t p[2] = {px + 7, py + 7}; int32_t corr[2] = {500, 500}; @@ -38,7 +38,7 @@ class PredictionSchemeNormalOctahedronCanonicalizedTransformTest } void TestGetRotationCount(const Transform &transform, const Point2 &pred, - const int32_t &rot_dir) { + const int32_t rot_dir) { const int32_t rotation_count = transform.GetRotationCount(pred); ASSERT_EQ(rot_dir, rotation_count); } diff --git a/contrib/draco/src/draco/compression/attributes/prediction_schemes/prediction_scheme_normal_octahedron_decoding_transform.h b/contrib/draco/src/draco/compression/attributes/prediction_schemes/prediction_scheme_normal_octahedron_decoding_transform.h index a1bc4a327..d3705c8ad 100644 --- a/contrib/draco/src/draco/compression/attributes/prediction_schemes/prediction_scheme_normal_octahedron_decoding_transform.h +++ b/contrib/draco/src/draco/compression/attributes/prediction_schemes/prediction_scheme_normal_octahedron_decoding_transform.h @@ -80,19 +80,31 @@ class PredictionSchemeNormalOctahedronDecodingTransform private: Point2 ComputeOriginalValue(Point2 pred, const Point2 &corr) const { const Point2 t(this->center_value(), this->center_value()); - pred = pred - t; + typedef typename std::make_unsigned::type UnsignedDataTypeT; + typedef VectorD Point2u; + + // Perform the addition in unsigned type to avoid signed integer overflow. + // Note that the result will be the same (for non-overflowing values). + pred = Point2(Point2u(pred) - Point2u(t)); const bool pred_is_in_diamond = this->IsInDiamond(pred[0], pred[1]); if (!pred_is_in_diamond) { this->InvertDiamond(&pred[0], &pred[1]); } - Point2 orig = pred + corr; + + // Perform the addition in unsigned type to avoid signed integer overflow. + // Note that the result will be the same (for non-overflowing values). + Point2 orig(Point2u(pred) + Point2u(corr)); + orig[0] = this->ModMax(orig[0]); orig[1] = this->ModMax(orig[1]); if (!pred_is_in_diamond) { this->InvertDiamond(&orig[0], &orig[1]); } - orig = orig + t; + + // Perform the addition in unsigned type to avoid signed integer overflow. + // Note that the result will be the same (for non-overflowing values). + orig = Point2(Point2u(orig) + Point2u(t)); return orig; } }; diff --git a/contrib/draco/src/draco/compression/attributes/prediction_schemes/prediction_scheme_normal_octahedron_transform_test.cc b/contrib/draco/src/draco/compression/attributes/prediction_schemes/prediction_scheme_normal_octahedron_transform_test.cc index 1001b19fa..1403973c4 100644 --- a/contrib/draco/src/draco/compression/attributes/prediction_schemes/prediction_scheme_normal_octahedron_transform_test.cc +++ b/contrib/draco/src/draco/compression/attributes/prediction_schemes/prediction_scheme_normal_octahedron_transform_test.cc @@ -23,10 +23,10 @@ class PredictionSchemeNormalOctahedronTransformTest : public ::testing::Test { Transform; typedef Transform::Point2 Point2; - void TestComputeCorrection(const Transform &transform, const int32_t &ox, - const int32_t &oy, const int32_t &px, - const int32_t &py, const int32_t &cx, - const int32_t &cy) { + void TestComputeCorrection(const Transform &transform, const int32_t ox, + const int32_t oy, const int32_t px, + const int32_t py, const int32_t cx, + const int32_t cy) { const int32_t o[2] = {ox + 7, oy + 7}; const int32_t p[2] = {px + 7, py + 7}; int32_t corr[2] = {500, 500}; diff --git a/contrib/draco/src/draco/compression/attributes/prediction_schemes/prediction_scheme_wrap_transform_base.h b/contrib/draco/src/draco/compression/attributes/prediction_schemes/prediction_scheme_wrap_transform_base.h index 26f61fbaf..bba3de09c 100644 --- a/contrib/draco/src/draco/compression/attributes/prediction_schemes/prediction_scheme_wrap_transform_base.h +++ b/contrib/draco/src/draco/compression/attributes/prediction_schemes/prediction_scheme_wrap_transform_base.h @@ -70,10 +70,10 @@ class PredictionSchemeWrapTransformBase { clamped_value_[i] = predicted_val[i]; } } - return &clamped_value_[0]; + return clamped_value_.data(); } - // TODO(hemmer): Consider refactoring to avoid this dummy. + // TODO(b/199760123): Consider refactoring to avoid this dummy. int quantization_bits() const { DRACO_DCHECK(false); return -1; diff --git a/contrib/draco/src/draco/compression/attributes/sequential_integer_attribute_decoder.cc b/contrib/draco/src/draco/compression/attributes/sequential_integer_attribute_decoder.cc index 83f42125a..17f32fc16 100644 --- a/contrib/draco/src/draco/compression/attributes/sequential_integer_attribute_decoder.cc +++ b/contrib/draco/src/draco/compression/attributes/sequential_integer_attribute_decoder.cc @@ -148,8 +148,9 @@ bool SequentialIntegerAttributeDecoder::DecodeIntegerValues( return false; } for (size_t i = 0; i < num_values; ++i) { - if (!in_buffer->Decode(portable_attribute_data + i, num_bytes)) + if (!in_buffer->Decode(portable_attribute_data + i, num_bytes)) { return false; + } } } } @@ -228,12 +229,13 @@ void SequentialIntegerAttributeDecoder::StoreTypedValues(uint32_t num_values) { void SequentialIntegerAttributeDecoder::PreparePortableAttribute( int num_entries, int num_components) { - GeometryAttribute va; - va.Init(attribute()->attribute_type(), nullptr, num_components, DT_INT32, + GeometryAttribute ga; + ga.Init(attribute()->attribute_type(), nullptr, num_components, DT_INT32, false, num_components * DataTypeLength(DT_INT32), 0); - std::unique_ptr port_att(new PointAttribute(va)); + std::unique_ptr port_att(new PointAttribute(ga)); port_att->SetIdentityMapping(); port_att->Reset(num_entries); + port_att->set_unique_id(attribute()->unique_id()); SetPortableAttribute(std::move(port_att)); } diff --git a/contrib/draco/src/draco/compression/attributes/sequential_integer_attribute_encoder.cc b/contrib/draco/src/draco/compression/attributes/sequential_integer_attribute_encoder.cc index e66a0a8a4..5f673be42 100644 --- a/contrib/draco/src/draco/compression/attributes/sequential_integer_attribute_encoder.cc +++ b/contrib/draco/src/draco/compression/attributes/sequential_integer_attribute_encoder.cc @@ -138,9 +138,11 @@ bool SequentialIntegerAttributeEncoder::EncodeValues( // All integer values are initialized. Process them using the prediction // scheme if we have one. if (prediction_scheme_) { - prediction_scheme_->ComputeCorrectionValues( - portable_attribute_data, &encoded_data[0], num_values, num_components, - point_ids.data()); + if (!prediction_scheme_->ComputeCorrectionValues( + portable_attribute_data, &encoded_data[0], num_values, + num_components, point_ids.data())) { + return false; + } } if (prediction_scheme_ == nullptr || diff --git a/contrib/draco/src/draco/compression/attributes/sequential_normal_attribute_encoder.cc b/contrib/draco/src/draco/compression/attributes/sequential_normal_attribute_encoder.cc index 2e20e89e6..3c5ef0ebc 100644 --- a/contrib/draco/src/draco/compression/attributes/sequential_normal_attribute_encoder.cc +++ b/contrib/draco/src/draco/compression/attributes/sequential_normal_attribute_encoder.cc @@ -20,8 +20,9 @@ namespace draco { bool SequentialNormalAttributeEncoder::Init(PointCloudEncoder *encoder, int attribute_id) { - if (!SequentialIntegerAttributeEncoder::Init(encoder, attribute_id)) + if (!SequentialIntegerAttributeEncoder::Init(encoder, attribute_id)) { return false; + } // Currently this encoder works only for 3-component normal vectors. if (attribute()->num_components() != 3) { return false; diff --git a/contrib/draco/src/draco/compression/bit_coders/direct_bit_decoder.h b/contrib/draco/src/draco/compression/bit_coders/direct_bit_decoder.h index b9fbc2d6f..6273692a2 100644 --- a/contrib/draco/src/draco/compression/bit_coders/direct_bit_decoder.h +++ b/contrib/draco/src/draco/compression/bit_coders/direct_bit_decoder.h @@ -47,14 +47,13 @@ class DirectBitDecoder { // Decode the next |nbits| and return the sequence in |value|. |nbits| must be // > 0 and <= 32. - void DecodeLeastSignificantBits32(int nbits, uint32_t *value) { + bool DecodeLeastSignificantBits32(int nbits, uint32_t *value) { DRACO_DCHECK_EQ(true, nbits <= 32); DRACO_DCHECK_EQ(true, nbits > 0); const int remaining = 32 - num_used_bits_; if (nbits <= remaining) { if (pos_ == bits_.end()) { - *value = 0; - return; + return false; } *value = (*pos_ << num_used_bits_) >> (32 - nbits); num_used_bits_ += nbits; @@ -64,8 +63,7 @@ class DirectBitDecoder { } } else { if (pos_ + 1 == bits_.end()) { - *value = 0; - return; + return false; } const uint32_t value_l = ((*pos_) << num_used_bits_); num_used_bits_ = nbits - remaining; @@ -73,6 +71,7 @@ class DirectBitDecoder { const uint32_t value_r = (*pos_) >> (32 - num_used_bits_); *value = (value_l >> (32 - num_used_bits_ - remaining)) | value_r; } + return true; } void EndDecoding() {} diff --git a/contrib/draco/src/draco/compression/config/encoder_options.h b/contrib/draco/src/draco/compression/config/encoder_options.h index ed1b02068..e8a55bbba 100644 --- a/contrib/draco/src/draco/compression/config/encoder_options.h +++ b/contrib/draco/src/draco/compression/config/encoder_options.h @@ -65,6 +65,10 @@ class EncoderOptionsBase : public DracoOptions { this->SetGlobalInt("encoding_speed", encoding_speed); this->SetGlobalInt("decoding_speed", decoding_speed); } + bool IsSpeedSet() const { + return this->IsGlobalOptionSet("encoding_speed") || + this->IsGlobalOptionSet("decoding_speed"); + } // Sets a given feature as supported or unsupported by the target decoder. // Encoder will always use only supported features when encoding the input diff --git a/contrib/draco/src/draco/compression/decode_test.cc b/contrib/draco/src/draco/compression/decode_test.cc index 198714690..8f3e7f4e9 100644 --- a/contrib/draco/src/draco/compression/decode_test.cc +++ b/contrib/draco/src/draco/compression/decode_test.cc @@ -17,9 +17,11 @@ #include #include +#include "draco/compression/encode.h" #include "draco/core/draco_test_base.h" #include "draco/core/draco_test_utils.h" #include "draco/io/file_utils.h" +#include "draco/io/obj_encoder.h" namespace { @@ -166,4 +168,78 @@ TEST_F(DecodeTest, TestSkipAttributeTransformWithNoQuantization) { ASSERT_EQ(pos_att->GetAttributeTransformData(), nullptr); } +TEST_F(DecodeTest, TestSkipAttributeTransformUniqueId) { + // Tests that decoders preserve unique id of attributes even when their + // attribute transforms are skipped. + const std::string file_name = "cube_att.obj"; + auto src_mesh = draco::ReadMeshFromTestFile(file_name); + ASSERT_NE(src_mesh, nullptr); + + constexpr int kPosUniqueId = 7; + constexpr int kNormUniqueId = 42; + // Set unique ids for some of the attributes. + src_mesh + ->attribute( + src_mesh->GetNamedAttributeId(draco::GeometryAttribute::POSITION)) + ->set_unique_id(kPosUniqueId); + src_mesh + ->attribute( + src_mesh->GetNamedAttributeId(draco::GeometryAttribute::NORMAL)) + ->set_unique_id(kNormUniqueId); + + draco::EncoderBuffer encoder_buffer; + draco::Encoder encoder; + encoder.SetAttributeQuantization(draco::GeometryAttribute::POSITION, 10); + encoder.SetAttributeQuantization(draco::GeometryAttribute::NORMAL, 11); + encoder.EncodeMeshToBuffer(*src_mesh, &encoder_buffer); + + // Create a draco decoding buffer. + draco::DecoderBuffer buffer; + buffer.Init(encoder_buffer.data(), encoder_buffer.size()); + + // First we decode the mesh without skipping the attribute transforms. + draco::Decoder decoder_no_skip; + std::unique_ptr mesh_no_skip = + decoder_no_skip.DecodeMeshFromBuffer(&buffer).value(); + ASSERT_NE(mesh_no_skip, nullptr); + + // Now we decode it again while skipping some attributes. + draco::Decoder decoder_skip; + // Make sure we skip dequantization for the position and normal attribute. + decoder_skip.SetSkipAttributeTransform(draco::GeometryAttribute::POSITION); + decoder_skip.SetSkipAttributeTransform(draco::GeometryAttribute::NORMAL); + + // Decode the input data into a geometry. + buffer.Init(encoder_buffer.data(), encoder_buffer.size()); + std::unique_ptr mesh_skip = + decoder_skip.DecodeMeshFromBuffer(&buffer).value(); + ASSERT_NE(mesh_skip, nullptr); + + // Compare the unique ids. + const draco::PointAttribute *const pos_att_no_skip = + mesh_no_skip->GetNamedAttribute(draco::GeometryAttribute::POSITION); + ASSERT_NE(pos_att_no_skip, nullptr); + ASSERT_EQ(pos_att_no_skip->data_type(), draco::DataType::DT_FLOAT32); + + const draco::PointAttribute *const pos_att_skip = + mesh_skip->GetNamedAttribute(draco::GeometryAttribute::POSITION); + ASSERT_NE(pos_att_skip, nullptr); + ASSERT_EQ(pos_att_skip->data_type(), draco::DataType::DT_INT32); + + const draco::PointAttribute *const norm_att_no_skip = + mesh_no_skip->GetNamedAttribute(draco::GeometryAttribute::NORMAL); + ASSERT_NE(norm_att_no_skip, nullptr); + ASSERT_EQ(norm_att_no_skip->data_type(), draco::DataType::DT_FLOAT32); + + const draco::PointAttribute *const norm_att_skip = + mesh_skip->GetNamedAttribute(draco::GeometryAttribute::NORMAL); + ASSERT_NE(norm_att_skip, nullptr); + ASSERT_EQ(norm_att_skip->data_type(), draco::DataType::DT_INT32); + + ASSERT_EQ(pos_att_skip->unique_id(), pos_att_no_skip->unique_id()); + ASSERT_EQ(norm_att_skip->unique_id(), norm_att_no_skip->unique_id()); + std::cout << pos_att_skip->unique_id() << " " << norm_att_skip->unique_id() + << std::endl; +} + } // namespace diff --git a/contrib/draco/src/draco/compression/draco_compression_options.cc b/contrib/draco/src/draco/compression/draco_compression_options.cc new file mode 100644 index 000000000..08171c678 --- /dev/null +++ b/contrib/draco/src/draco/compression/draco_compression_options.cc @@ -0,0 +1,59 @@ +// Copyright 2022 The Draco Authors. +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. +// +#include "draco/compression/draco_compression_options.h" + +#ifdef DRACO_TRANSCODER_SUPPORTED + +namespace draco { + +SpatialQuantizationOptions::SpatialQuantizationOptions(int quantization_bits) { + SetQuantizationBits(quantization_bits); +} + +void SpatialQuantizationOptions::SetQuantizationBits(int quantization_bits) { + mode_ = LOCAL_QUANTIZATION_BITS; + quantization_bits_ = quantization_bits; +} + +bool SpatialQuantizationOptions::AreQuantizationBitsDefined() const { + return mode_ == LOCAL_QUANTIZATION_BITS; +} + +SpatialQuantizationOptions &SpatialQuantizationOptions::SetGrid(float spacing) { + mode_ = GLOBAL_GRID; + spacing_ = spacing; + return *this; +} + +bool SpatialQuantizationOptions::operator==( + const SpatialQuantizationOptions &other) const { + if (mode_ != other.mode_) { + return false; + } + if (mode_ == LOCAL_QUANTIZATION_BITS) { + if (quantization_bits_ != other.quantization_bits_) { + return false; + } + } else if (mode_ == GLOBAL_GRID) { + if (spacing_ != other.spacing_) { + return false; + } + } + return true; +} + +} // namespace draco + +#endif // DRACO_TRANSCODER_SUPPORTED diff --git a/contrib/draco/src/draco/compression/draco_compression_options.h b/contrib/draco/src/draco/compression/draco_compression_options.h new file mode 100644 index 000000000..31a4418ed --- /dev/null +++ b/contrib/draco/src/draco/compression/draco_compression_options.h @@ -0,0 +1,141 @@ +// Copyright 2019 The Draco Authors. +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. +// +#ifndef DRACO_COMPRESSION_DRACO_COMPRESSION_OPTIONS_H_ +#define DRACO_COMPRESSION_DRACO_COMPRESSION_OPTIONS_H_ + +#include "draco/draco_features.h" + +#ifdef DRACO_TRANSCODER_SUPPORTED +#include "draco/core/status.h" + +namespace draco { + +// Quantization options for positions. Currently there are two modes for +// quantizing positions: +// +// 1. Quantization bits: +// - User defined number of quantization bits that is evenly distributed +// to cover the compressed geometry. +// 2. Grid: +// - Positions are snapped to a global grid defined by grid spacing. +// - This method is primarily intended to be used when the location of +// quantized vertices needs to be consistent between multiple +// geometries. +class SpatialQuantizationOptions { + public: + explicit SpatialQuantizationOptions(int quantization_bits); + + // Sets quantization bits that are going to be used for the compressed + // geometry. If the geometry is a scene, the same number of quantization bits + // is going to be applied to each mesh of the scene. Quantized values are + // going to be distributed within the bounds of individual meshes. + void SetQuantizationBits(int quantization_bits); + + // If this returns true, quantization_bits() should be used to get the + // desired number of quantization bits for compression. Otherwise the grid + // mode is selected and spacing() should be used to get the desired grid + // spacing. + bool AreQuantizationBitsDefined() const; + const int quantization_bits() const { return quantization_bits_; } + + // Defines quantization grid used for the compressed geometry. All vertices + // are going to be snapped to the nearest grid vertex that corresponds to an + // integer quantized position. |spacing| defines the distance between two grid + // vertices. E.g. a grid with |spacing| = 10 would have grid vertices at + // locations {10 * i, 10 * j, 10 * k} where i, j, k are integer numbers. + SpatialQuantizationOptions &SetGrid(float spacing); + + const float spacing() const { return spacing_; } + + bool operator==(const SpatialQuantizationOptions &other) const; + + private: + enum Mode { LOCAL_QUANTIZATION_BITS, GLOBAL_GRID }; + Mode mode_ = LOCAL_QUANTIZATION_BITS; + int quantization_bits_; // Default quantization bits for positions. + float spacing_ = 0.f; +}; + +// TODO(fgalligan): Add support for unified_position_quantization. +// Struct to hold Draco compression options. +struct DracoCompressionOptions { + int compression_level = 7; // compression level [0-10], most=10, least=0. + SpatialQuantizationOptions quantization_position{11}; + int quantization_bits_normal = 8; + int quantization_bits_tex_coord = 10; + int quantization_bits_color = 8; + int quantization_bits_generic = 8; + int quantization_bits_tangent = 8; + int quantization_bits_weight = 8; + bool find_non_degenerate_texture_quantization = false; + + bool operator==(const DracoCompressionOptions &other) const { + return compression_level == other.compression_level && + quantization_position == other.quantization_position && + quantization_bits_normal == other.quantization_bits_normal && + quantization_bits_tex_coord == other.quantization_bits_tex_coord && + quantization_bits_color == other.quantization_bits_color && + quantization_bits_generic == other.quantization_bits_generic && + quantization_bits_tangent == other.quantization_bits_tangent && + quantization_bits_weight == other.quantization_bits_weight && + find_non_degenerate_texture_quantization == + other.find_non_degenerate_texture_quantization; + } + + bool operator!=(const DracoCompressionOptions &other) const { + return !(*this == other); + } + + Status Check() const { + DRACO_RETURN_IF_ERROR( + Validate("Compression level", compression_level, 0, 10)); + if (quantization_position.AreQuantizationBitsDefined()) { + DRACO_RETURN_IF_ERROR(Validate("Position quantization", + quantization_position.quantization_bits(), + 0, 30)); + } else { + if (quantization_position.spacing() <= 0.f) { + return ErrorStatus("Position quantization spacing is invalid."); + } + } + DRACO_RETURN_IF_ERROR( + Validate("Normals quantization", quantization_bits_normal, 0, 30)); + DRACO_RETURN_IF_ERROR( + Validate("Tex coord quantization", quantization_bits_tex_coord, 0, 30)); + DRACO_RETURN_IF_ERROR( + Validate("Color quantization", quantization_bits_color, 0, 30)); + DRACO_RETURN_IF_ERROR( + Validate("Generic quantization", quantization_bits_generic, 0, 30)); + DRACO_RETURN_IF_ERROR( + Validate("Tangent quantization", quantization_bits_tangent, 0, 30)); + DRACO_RETURN_IF_ERROR( + Validate("Weights quantization", quantization_bits_weight, 0, 30)); + return OkStatus(); + } + + static Status Validate(const std::string &name, int value, int min, int max) { + if (value < min || value > max) { + const std::string range = + "[" + std::to_string(min) + "-" + std::to_string(max) + "]."; + return Status(Status::DRACO_ERROR, name + " is out of range " + range); + } + return OkStatus(); + } +}; + +} // namespace draco + +#endif // DRACO_TRANSCODER_SUPPORTED +#endif // DRACO_COMPRESSION_DRACO_COMPRESSION_OPTIONS_H_ diff --git a/contrib/draco/src/draco/compression/draco_compression_options_test.cc b/contrib/draco/src/draco/compression/draco_compression_options_test.cc new file mode 100644 index 000000000..415295211 --- /dev/null +++ b/contrib/draco/src/draco/compression/draco_compression_options_test.cc @@ -0,0 +1,45 @@ +#include "draco/compression/draco_compression_options.h" + +#include "draco/core/draco_test_utils.h" + +#ifdef DRACO_TRANSCODER_SUPPORTED + +namespace { + +TEST(DracoCompressionOptionsTest, TestPositionQuantizationBits) { + // Test verifies that we can define draco compression options using + // quantization bits. + draco::SpatialQuantizationOptions options(10); + + // Quantization bits should be used by default. + ASSERT_TRUE(options.AreQuantizationBitsDefined()); + ASSERT_EQ(options.quantization_bits(), 10); + + // Change the quantization bits. + options.SetQuantizationBits(9); + ASSERT_TRUE(options.AreQuantizationBitsDefined()); + ASSERT_EQ(options.quantization_bits(), 9); + + // If we select the grid, quantization bits should not be used. + options.SetGrid(0.5f); + ASSERT_FALSE(options.AreQuantizationBitsDefined()); +} + +TEST(DracoCompressionOptionsTest, TestPositionQuantizationGrid) { + // Test verifies that we can define draco compression options using + // quantization grid. + draco::SpatialQuantizationOptions options(10); + + // Quantization bits should be used by default. + ASSERT_TRUE(options.AreQuantizationBitsDefined()); + + // Set the grid parameters. + options.SetGrid(0.25f); + ASSERT_FALSE(options.AreQuantizationBitsDefined()); + + ASSERT_EQ(options.spacing(), 0.25f); +} + +} // namespace + +#endif // DRACO_TRANSCODER_SUPPORTED diff --git a/contrib/draco/src/draco/compression/encode.h b/contrib/draco/src/draco/compression/encode.h index bce8b34c2..00ccb9b2e 100644 --- a/contrib/draco/src/draco/compression/encode.h +++ b/contrib/draco/src/draco/compression/encode.h @@ -129,7 +129,6 @@ class Encoder // call of EncodePointCloudToBuffer or EncodeMeshToBuffer is going to fail. void SetEncodingMethod(int encoding_method); - protected: // Creates encoder options for the expert encoder used during the actual // encoding. EncoderOptions CreateExpertEncoderOptions(const PointCloud &pc) const; diff --git a/contrib/draco/src/draco/compression/encode_base.h b/contrib/draco/src/draco/compression/encode_base.h index c501bc4fa..6211efc22 100644 --- a/contrib/draco/src/draco/compression/encode_base.h +++ b/contrib/draco/src/draco/compression/encode_base.h @@ -98,7 +98,7 @@ class EncoderBase { "Invalid prediction scheme for attribute type."); } } - // TODO(hemmer): Try to enable more prediction schemes for normals. + // TODO(b/199760123): Try to enable more prediction schemes for normals. if (att_type == GeometryAttribute::NORMAL) { if (!(prediction_scheme == PREDICTION_DIFFERENCE || prediction_scheme == MESH_PREDICTION_GEOMETRIC_NORMAL)) { diff --git a/contrib/draco/src/draco/compression/encode_test.cc b/contrib/draco/src/draco/compression/encode_test.cc index fde4f6f5b..00d834703 100644 --- a/contrib/draco/src/draco/compression/encode_test.cc +++ b/contrib/draco/src/draco/compression/encode_test.cc @@ -26,6 +26,7 @@ #include "draco/core/draco_test_base.h" #include "draco/core/draco_test_utils.h" #include "draco/core/vector_d.h" +#include "draco/io/file_utils.h" #include "draco/io/obj_decoder.h" #include "draco/mesh/triangle_soup_mesh_builder.h" #include "draco/point_cloud/point_cloud_builder.h" @@ -213,16 +214,14 @@ class EncodeTest : public ::testing::Test { draco::Decoder decoder; if (mesh) { - auto maybe_mesh = decoder.DecodeMeshFromBuffer(&decoder_buffer); - ASSERT_TRUE(maybe_mesh.ok()); - auto decoded_mesh = std::move(maybe_mesh).value(); + DRACO_ASSIGN_OR_ASSERT(auto decoded_mesh, + decoder.DecodeMeshFromBuffer(&decoder_buffer)); ASSERT_NE(decoded_mesh, nullptr); ASSERT_EQ(decoded_mesh->num_points(), encoder.num_encoded_points()); ASSERT_EQ(decoded_mesh->num_faces(), encoder.num_encoded_faces()); } else { - auto maybe_pc = decoder.DecodePointCloudFromBuffer(&decoder_buffer); - ASSERT_TRUE(maybe_pc.ok()); - auto decoded_pc = std::move(maybe_pc).value(); + DRACO_ASSIGN_OR_ASSERT( + auto decoded_pc, decoder.DecodePointCloudFromBuffer(&decoder_buffer)); ASSERT_EQ(decoded_pc->num_points(), encoder.num_encoded_points()); } } @@ -274,7 +273,7 @@ TEST_F(EncodeTest, TestLinesObj) { encoder.SetAttributeQuantization(draco::GeometryAttribute::POSITION, 16); draco::EncoderBuffer buffer; - ASSERT_TRUE(encoder.EncodePointCloudToBuffer(*pc, &buffer).ok()); + DRACO_ASSERT_OK(encoder.EncodePointCloudToBuffer(*pc, &buffer)); } TEST_F(EncodeTest, TestQuantizedInfinity) { @@ -315,7 +314,7 @@ TEST_F(EncodeTest, TestUnquantizedInfinity) { encoder.SetEncodingMethod(draco::POINT_CLOUD_SEQUENTIAL_ENCODING); draco::EncoderBuffer buffer; - ASSERT_TRUE(encoder.EncodePointCloudToBuffer(*pc, &buffer).ok()); + DRACO_ASSERT_OK(encoder.EncodePointCloudToBuffer(*pc, &buffer)); } TEST_F(EncodeTest, TestQuantizedAndUnquantizedAttributes) { @@ -330,7 +329,7 @@ TEST_F(EncodeTest, TestQuantizedAndUnquantizedAttributes) { encoder.SetAttributeQuantization(draco::GeometryAttribute::POSITION, 11); encoder.SetAttributeQuantization(draco::GeometryAttribute::NORMAL, 0); draco::EncoderBuffer buffer; - ASSERT_TRUE(encoder.EncodePointCloudToBuffer(*pc, &buffer).ok()); + DRACO_ASSERT_OK(encoder.EncodePointCloudToBuffer(*pc, &buffer)); } TEST_F(EncodeTest, TestKdTreeEncoding) { @@ -348,7 +347,7 @@ TEST_F(EncodeTest, TestKdTreeEncoding) { // Now set quantization for the position attribute which should make // the encoder happy. encoder.SetAttributeQuantization(draco::GeometryAttribute::POSITION, 16); - ASSERT_TRUE(encoder.EncodePointCloudToBuffer(*pc, &buffer).ok()); + DRACO_ASSERT_OK(encoder.EncodePointCloudToBuffer(*pc, &buffer)); } TEST_F(EncodeTest, TestTrackingOfNumberOfEncodedEntries) { @@ -373,7 +372,7 @@ TEST_F(EncodeTest, TestTrackingOfNumberOfEncodedEntriesNotSet) { draco::EncoderBuffer buffer; draco::Encoder encoder; - ASSERT_TRUE(encoder.EncodeMeshToBuffer(*mesh, &buffer).ok()); + DRACO_ASSERT_OK(encoder.EncodeMeshToBuffer(*mesh, &buffer)); ASSERT_EQ(encoder.num_encoded_points(), 0); ASSERT_EQ(encoder.num_encoded_faces(), 0); } @@ -404,4 +403,170 @@ TEST_F(EncodeTest, TestNoPosQuantizationNormalCoding) { ASSERT_NE(decoded_mesh, nullptr); } +#ifdef DRACO_TRANSCODER_SUPPORTED +TEST_F(EncodeTest, TestDracoCompressionOptions) { + // This test verifies that we can set the encoder's compression options via + // draco::Mesh's compression options. + const auto mesh = draco::ReadMeshFromTestFile("test_nm.obj"); + ASSERT_NE(mesh, nullptr); + + // First set compression level and quantization manually. + draco::Encoder encoder_manual; + draco::EncoderBuffer buffer_manual; + encoder_manual.SetAttributeQuantization(draco::GeometryAttribute::POSITION, + 8); + encoder_manual.SetAttributeQuantization(draco::GeometryAttribute::NORMAL, 7); + encoder_manual.SetSpeedOptions(4, 4); + + DRACO_ASSERT_OK(encoder_manual.EncodeMeshToBuffer(*mesh, &buffer_manual)); + + // Now do the same with options provided via DracoCompressionOptions. + draco::DracoCompressionOptions compression_options; + compression_options.compression_level = 6; + compression_options.quantization_position.SetQuantizationBits(8); + compression_options.quantization_bits_normal = 7; + mesh->SetCompressionOptions(compression_options); + mesh->SetCompressionEnabled(true); + + draco::Encoder encoder_auto; + draco::EncoderBuffer buffer_auto; + DRACO_ASSERT_OK(encoder_auto.EncodeMeshToBuffer(*mesh, &buffer_auto)); + + // Ensure that both encoders produce the same result. + ASSERT_EQ(buffer_manual.size(), buffer_auto.size()); + + // Now change some of the mesh's compression settings and ensure the + // compression changes as well. + compression_options.compression_level = 7; + mesh->SetCompressionOptions(compression_options); + buffer_auto.Clear(); + DRACO_ASSERT_OK(encoder_auto.EncodeMeshToBuffer(*mesh, &buffer_auto)); + ASSERT_NE(buffer_manual.size(), buffer_auto.size()); + + // Check that |mesh| compression options do not override the encoder options. + mesh->GetCompressionOptions().compression_level = 10; + mesh->GetCompressionOptions().quantization_position.SetQuantizationBits(10); + mesh->GetCompressionOptions().quantization_bits_normal = 10; + draco::EncoderBuffer buffer; + DRACO_ASSERT_OK(encoder_manual.EncodeMeshToBuffer(*mesh, &buffer)); + ASSERT_EQ(buffer.size(), buffer_manual.size()); +} + +TEST_F(EncodeTest, TestDracoCompressionOptionsManualOverride) { + // This test verifies that we can use encoder's option to override compression + // options provided in draco::Mesh's compression options. + const auto mesh = draco::ReadMeshFromTestFile("test_nm.obj"); + ASSERT_NE(mesh, nullptr); + + // Set some compression options. + draco::DracoCompressionOptions compression_options; + compression_options.compression_level = 6; + compression_options.quantization_position.SetQuantizationBits(8); + compression_options.quantization_bits_normal = 7; + mesh->SetCompressionOptions(compression_options); + mesh->SetCompressionEnabled(true); + + draco::Encoder encoder; + draco::EncoderBuffer buffer_no_override; + DRACO_ASSERT_OK(encoder.EncodeMeshToBuffer(*mesh, &buffer_no_override)); + + // Now override some options and ensure the compression is different. + encoder.SetAttributeQuantization(draco::GeometryAttribute::POSITION, 5); + draco::EncoderBuffer buffer_with_override; + DRACO_ASSERT_OK(encoder.EncodeMeshToBuffer(*mesh, &buffer_with_override)); + ASSERT_LT(buffer_with_override.size(), buffer_no_override.size()); +} + +TEST_F(EncodeTest, TestDracoCompressionOptionsGridQuantization) { + // Test verifies that we can set position quantization via grid spacing. + + // 1x1x1 cube. + const auto mesh = draco::ReadMeshFromTestFile("cube_att.obj"); + ASSERT_NE(mesh, nullptr); + mesh->SetCompressionEnabled(true); + + // Set grid quantization for positions. + draco::DracoCompressionOptions compression_options; + // This should result in 10x10x10 quantization. + compression_options.quantization_position.SetGrid(0.1); + mesh->SetCompressionOptions(compression_options); + + draco::ExpertEncoder encoder(*mesh); + draco::EncoderBuffer buffer; + DRACO_ASSERT_OK(encoder.EncodeToBuffer(&buffer)); + + // The grid options should be reflected in the |encoder|. Check that the + // computed values are correct. + const int pos_att_id = + mesh->GetNamedAttributeId(draco::GeometryAttribute::POSITION); + draco::Vector3f origin; + encoder.options().GetAttributeVector(pos_att_id, "quantization_origin", 3, + &origin[0]); + ASSERT_EQ(origin, draco::Vector3f(0.f, 0.f, 0.f)); + + // We need 4 quantization bits (for 10 values). + ASSERT_EQ( + encoder.options().GetAttributeInt(pos_att_id, "quantization_bits", -1), + 4); + + // The quantization range should be ((1 << quantization_bits) - 1) * spacing. + ASSERT_NEAR(encoder.options().GetAttributeFloat(pos_att_id, + "quantization_range", 0.f), + 15.f * 0.1f, 1e-6f); +} + +TEST_F(EncodeTest, TestDracoCompressionOptionsGridQuantizationWithOffset) { + // Test verifies that we can set position quantization via grid spacing when + // the geometry is not perfectly aligned with the quantization grid. + + // 1x1x1 cube. + const auto mesh = draco::ReadMeshFromTestFile("cube_att.obj"); + ASSERT_NE(mesh, nullptr); + + // Move all positions a bit. + auto *pos_att = mesh->attribute( + mesh->GetNamedAttributeId(draco::GeometryAttribute::POSITION)); + for (draco::AttributeValueIndex avi(0); avi < pos_att->size(); ++avi) { + draco::Vector3f pos; + pos_att->GetValue(avi, &pos[0]); + pos = pos + draco::Vector3f(-0.55f, 0.65f, 10.75f); + pos_att->SetAttributeValue(avi, &pos[0]); + } + + mesh->SetCompressionEnabled(true); + + // Set grid quantization for positions. + draco::DracoCompressionOptions compression_options; + // This should result in 16x16x16 quantization if the grid was perfectly + // aligned but since it is not we should expect 17 or 18 values per component. + compression_options.quantization_position.SetGrid(0.0625f); + mesh->SetCompressionOptions(compression_options); + + draco::ExpertEncoder encoder(*mesh); + draco::EncoderBuffer buffer; + DRACO_ASSERT_OK(encoder.EncodeToBuffer(&buffer)); + + // The grid options should be reflected in the |encoder|. Check that the + // computed values are correct. + const int pos_att_id = + mesh->GetNamedAttributeId(draco::GeometryAttribute::POSITION); + draco::Vector3f origin; + encoder.options().GetAttributeVector(pos_att_id, "quantization_origin", 3, + &origin[0]); + // The origin is the first lower value on the quantization grid for each + // component of the mesh. + ASSERT_EQ(origin, draco::Vector3f(-0.5625f, 0.625f, 10.75f)); + + // We need 5 quantization bits (for 17-18 values). + ASSERT_EQ( + encoder.options().GetAttributeInt(pos_att_id, "quantization_bits", -1), + 5); + + // The quantization range should be ((1 << quantization_bits) - 1) * spacing. + ASSERT_NEAR(encoder.options().GetAttributeFloat(pos_att_id, + "quantization_range", 0.f), + 31.f * 0.0625f, 1e-6f); +} +#endif // DRACO_TRANSCODER_SUPPORTED + } // namespace diff --git a/contrib/draco/src/draco/compression/entropy/ans.h b/contrib/draco/src/draco/compression/entropy/ans.h index c71d58975..313546fee 100644 --- a/contrib/draco/src/draco/compression/entropy/ans.h +++ b/contrib/draco/src/draco/compression/entropy/ans.h @@ -391,7 +391,6 @@ class RAnsEncoder { ans_.buf[ans_.buf_offset++] = ans_.state % DRACO_ANS_IO_BASE; ans_.state /= DRACO_ANS_IO_BASE; } - // TODO(ostava): The division and multiplication should be optimized. ans_.state = (ans_.state / p) * rans_precision + ans_.state % p + sym->cum_prob; } diff --git a/contrib/draco/src/draco/compression/entropy/rans_symbol_decoder.h b/contrib/draco/src/draco/compression/entropy/rans_symbol_decoder.h index 10cdc6781..3b408c079 100644 --- a/contrib/draco/src/draco/compression/entropy/rans_symbol_decoder.h +++ b/contrib/draco/src/draco/compression/entropy/rans_symbol_decoder.h @@ -75,6 +75,13 @@ bool RAnsSymbolDecoder::Create( return false; } } + // Check that decoded number of symbols is not unreasonably high. Remaining + // buffer size must be at least |num_symbols| / 64 bytes to contain the + // probability table. The |prob_data| below is one byte but it can be + // theoretically stored for each 64th symbol. + if (num_symbols_ / 64 > buffer->remaining_size()) { + return false; + } probability_table_.resize(num_symbols_); if (num_symbols_ == 0) { return true; diff --git a/contrib/draco/src/draco/compression/entropy/rans_symbol_encoder.h b/contrib/draco/src/draco/compression/entropy/rans_symbol_encoder.h index 4e07ec871..4b738b50a 100644 --- a/contrib/draco/src/draco/compression/entropy/rans_symbol_encoder.h +++ b/contrib/draco/src/draco/compression/entropy/rans_symbol_encoder.h @@ -125,8 +125,8 @@ bool RAnsSymbolEncoder::Create( for (int i = 0; i < num_symbols; ++i) { sorted_probabilities[i] = i; } - std::sort(sorted_probabilities.begin(), sorted_probabilities.end(), - ProbabilityLess(&probability_table_)); + std::stable_sort(sorted_probabilities.begin(), sorted_probabilities.end(), + ProbabilityLess(&probability_table_)); if (total_rans_prob < rans_precision_) { // This happens rather infrequently, just add the extra needed precision // to the most frequent symbol. diff --git a/contrib/draco/src/draco/compression/entropy/symbol_decoding.cc b/contrib/draco/src/draco/compression/entropy/symbol_decoding.cc index 93d29971c..79e811818 100644 --- a/contrib/draco/src/draco/compression/entropy/symbol_decoding.cc +++ b/contrib/draco/src/draco/compression/entropy/symbol_decoding.cc @@ -72,7 +72,7 @@ bool DecodeTaggedSymbols(uint32_t num_values, int num_components, int value_id = 0; for (uint32_t i = 0; i < num_values; i += num_components) { // Decode the tag. - const int bit_length = tag_decoder.DecodeSymbol(); + const uint32_t bit_length = tag_decoder.DecodeSymbol(); // Decode the actual value. for (int j = 0; j < num_components; ++j) { uint32_t val; diff --git a/contrib/draco/src/draco/compression/expert_encode.cc b/contrib/draco/src/draco/compression/expert_encode.cc index f9aec15eb..a3e649193 100644 --- a/contrib/draco/src/draco/compression/expert_encode.cc +++ b/contrib/draco/src/draco/compression/expert_encode.cc @@ -14,6 +14,12 @@ // #include "draco/compression/expert_encode.h" +#include +#include +#include +#include +#include + #include "draco/compression/mesh/mesh_edgebreaker_encoder.h" #include "draco/compression/mesh/mesh_sequential_encoder.h" #ifdef DRACO_POINT_CLOUD_COMPRESSION_SUPPORTED @@ -21,6 +27,9 @@ #include "draco/compression/point_cloud/point_cloud_sequential_encoder.h" #endif +#ifdef DRACO_TRANSCODER_SUPPORTED +#include "draco/core/bit_utils.h" +#endif namespace draco { ExpertEncoder::ExpertEncoder(const PointCloud &point_cloud) @@ -101,6 +110,11 @@ Status ExpertEncoder::EncodePointCloudToBuffer(const PointCloud &pc, Status ExpertEncoder::EncodeMeshToBuffer(const Mesh &m, EncoderBuffer *out_buffer) { +#ifdef DRACO_TRANSCODER_SUPPORTED + // Apply DracoCompressionOptions associated with the mesh. + DRACO_RETURN_IF_ERROR(ApplyCompressionOptions(m)); +#endif // DRACO_TRANSCODER_SUPPORTED + std::unique_ptr encoder; // Select the encoding method only based on the provided options. int encoding_method = options().GetGlobalInt("encoding_method", -1); @@ -118,6 +132,7 @@ Status ExpertEncoder::EncodeMeshToBuffer(const Mesh &m, encoder = std::unique_ptr(new MeshSequentialEncoder()); } encoder->SetMesh(m); + DRACO_RETURN_IF_ERROR(encoder->Encode(options(), out_buffer)); set_num_encoded_points(encoder->num_encoded_points()); @@ -179,4 +194,107 @@ Status ExpertEncoder::SetAttributePredictionScheme( return status; } +#ifdef DRACO_TRANSCODER_SUPPORTED +Status ExpertEncoder::ApplyCompressionOptions(const Mesh &mesh) { + if (!mesh.IsCompressionEnabled()) { + return OkStatus(); + } + const auto &compression_options = mesh.GetCompressionOptions(); + + // Set any encoder options that haven't been explicitly set by users (don't + // override existing options). + if (!options().IsSpeedSet()) { + options().SetSpeed(10 - compression_options.compression_level, + 10 - compression_options.compression_level); + } + + for (int ai = 0; ai < mesh.num_attributes(); ++ai) { + if (options().IsAttributeOptionSet(ai, "quantization_bits")) { + continue; // Don't override options that have been set. + } + int quantization_bits = 0; + const auto type = mesh.attribute(ai)->attribute_type(); + switch (type) { + case GeometryAttribute::POSITION: + if (compression_options.quantization_position + .AreQuantizationBitsDefined()) { + quantization_bits = + compression_options.quantization_position.quantization_bits(); + } else { + DRACO_RETURN_IF_ERROR(ApplyGridQuantization(mesh, ai)); + } + break; + case GeometryAttribute::TEX_COORD: + quantization_bits = compression_options.quantization_bits_tex_coord; + break; + case GeometryAttribute::NORMAL: + quantization_bits = compression_options.quantization_bits_normal; + break; + case GeometryAttribute::COLOR: + quantization_bits = compression_options.quantization_bits_color; + break; + case GeometryAttribute::TANGENT: + quantization_bits = compression_options.quantization_bits_tangent; + break; + case GeometryAttribute::WEIGHTS: + quantization_bits = compression_options.quantization_bits_weight; + break; + case GeometryAttribute::GENERIC: + quantization_bits = compression_options.quantization_bits_generic; + break; + default: + break; + } + if (quantization_bits > 0) { + options().SetAttributeInt(ai, "quantization_bits", quantization_bits); + } + } + return OkStatus(); +} + +Status ExpertEncoder::ApplyGridQuantization(const Mesh &mesh, + int attribute_index) { + const auto compression_options = mesh.GetCompressionOptions(); + if (mesh.attribute(attribute_index)->num_components() != 3) { + return ErrorStatus( + "Invalid number of components: Grid quantization is currently " + "supported only for 3D positions."); + } + const float spacing = compression_options.quantization_position.spacing(); + // Compute quantization properties based on the grid spacing. + const auto &bbox = mesh.ComputeBoundingBox(); + // Snap min and max points of the |bbox| to the quantization grid vertices. + Vector3f min_pos; + int num_values = 0; // Number of values that we need to encode. + for (int c = 0; c < 3; ++c) { + // Min / max position on grid vertices in grid coordinates. + const float min_grid_pos = floor(bbox.GetMinPoint()[c] / spacing); + const float max_grid_pos = ceil(bbox.GetMaxPoint()[c] / spacing); + + // Min pos on grid vertex in mesh coordinates. + min_pos[c] = min_grid_pos * spacing; + + const float component_num_values = + static_cast(max_grid_pos) - static_cast(min_grid_pos) + 1; + if (component_num_values > num_values) { + num_values = component_num_values; + } + } + // Now compute the number of bits needed to encode |num_values|. + int bits = MostSignificantBit(num_values); + if ((1 << bits) < num_values) { + // If the |num_values| is larger than number of values representable by + // |bits|, we need to use one more bit. This will be almost always true + // unless |num_values| was equal to 1 << |bits|. + bits++; + } + // Compute the range in mesh coordinates that matches the quantization bits. + // Note there are n-1 intervals between the |n| quantization values. + const float range = ((1 << bits) - 1) * spacing; + SetAttributeExplicitQuantization(attribute_index, bits, 3, min_pos.data(), + range); + return OkStatus(); +} +#endif // DRACO_TRANSCODER_SUPPORTED + } // namespace draco diff --git a/contrib/draco/src/draco/compression/expert_encode.h b/contrib/draco/src/draco/compression/expert_encode.h index ea59393d3..5c1485e1e 100644 --- a/contrib/draco/src/draco/compression/expert_encode.h +++ b/contrib/draco/src/draco/compression/expert_encode.h @@ -138,6 +138,12 @@ class ExpertEncoder : public EncoderBase { Status EncodeMeshToBuffer(const Mesh &m, EncoderBuffer *out_buffer); +#ifdef DRACO_TRANSCODER_SUPPORTED + // Applies compression options stored in |mesh|. + Status ApplyCompressionOptions(const Mesh &mesh); + Status ApplyGridQuantization(const Mesh &mesh, int attribute_index); +#endif // DRACO_TRANSCODER_SUPPORTED + const PointCloud *point_cloud_; const Mesh *mesh_; }; diff --git a/contrib/draco/src/draco/compression/mesh/mesh_edgebreaker_decoder_impl.cc b/contrib/draco/src/draco/compression/mesh/mesh_edgebreaker_decoder_impl.cc index 0bbbea4af..21ad9959c 100644 --- a/contrib/draco/src/draco/compression/mesh/mesh_edgebreaker_decoder_impl.cc +++ b/contrib/draco/src/draco/compression/mesh/mesh_edgebreaker_decoder_impl.cc @@ -454,7 +454,7 @@ bool MeshEdgebreakerDecoderImpl::DecodeConnectivity() { #endif // Decode connectivity of non-position attributes. - if (attribute_data_.size() > 0) { + if (!attribute_data_.empty()) { #ifdef DRACO_BACKWARDS_COMPATIBILITY_SUPPORTED if (decoder_->bitstream_version() < DRACO_BITSTREAM_VERSION(2, 1)) { for (CornerIndex ci(0); ci < corner_table_->num_corners(); ci += 3) { @@ -484,7 +484,10 @@ bool MeshEdgebreakerDecoderImpl::DecodeConnectivity() { attribute_data_[i].connectivity_data.AddSeamEdge(CornerIndex(c)); } // Recompute vertices from the newly added seam edges. - attribute_data_[i].connectivity_data.RecomputeVertices(nullptr, nullptr); + if (!attribute_data_[i].connectivity_data.RecomputeVertices(nullptr, + nullptr)) { + return false; + } } pos_encoding_data_.Init(corner_table_->num_vertices()); @@ -574,6 +577,17 @@ int MeshEdgebreakerDecoderImpl::DecodeConnectivity( const CornerIndex corner_b = corner_table_->Next(corner_table_->LeftMostCorner(vertex_x)); + if (corner_a == corner_b) { + // All matched corners must be different. + return -1; + } + if (corner_table_->Opposite(corner_a) != kInvalidCornerIndex || + corner_table_->Opposite(corner_b) != kInvalidCornerIndex) { + // One of the corners is already opposite to an existing face, which + // should not happen unless the input was tampered with. + return -1; + } + // New tip corner. const CornerIndex corner(3 * face.value()); // Update opposite corner mappings. @@ -616,6 +630,11 @@ int MeshEdgebreakerDecoderImpl::DecodeConnectivity( return -1; } const CornerIndex corner_a = active_corner_stack.back(); + if (corner_table_->Opposite(corner_a) != kInvalidCornerIndex) { + // Active corner is already opposite to an existing face, which should + // not happen unless the input was tampered with. + return -1; + } // First corner on the new face is either corner "l" or "r". const CornerIndex corner(3 * face.value()); @@ -681,10 +700,14 @@ int MeshEdgebreakerDecoderImpl::DecodeConnectivity( } const CornerIndex corner_a = active_corner_stack.back(); + if (corner_a == corner_b) { + // All matched corners must be different. + return -1; + } if (corner_table_->Opposite(corner_a) != kInvalidCornerIndex || corner_table_->Opposite(corner_b) != kInvalidCornerIndex) { // One of the corners is already opposite to an existing face, which - // should not happen unless the input was tempered with. + // should not happen unless the input was tampered with. return -1; } @@ -713,9 +736,15 @@ int MeshEdgebreakerDecoderImpl::DecodeConnectivity( // Also update the vertex id at corner "n" and all corners that are // connected to it in the CCW direction. + const CornerIndex first_corner = corner_n; while (corner_n != kInvalidCornerIndex) { corner_table_->MapCornerToVertex(corner_n, vertex_p); corner_n = corner_table_->SwingLeft(corner_n); + if (corner_n == first_corner) { + // We reached the start again which should not happen for split + // symbols. + return -1; + } } // Make sure the old vertex n is now mapped to an invalid corner (make it // isolated). @@ -800,7 +829,7 @@ int MeshEdgebreakerDecoderImpl::DecodeConnectivity( return -1; // Unexpected number of decoded vertices. } // Decode start faces and connect them to the faces from the active stack. - while (active_corner_stack.size() > 0) { + while (!active_corner_stack.empty()) { const CornerIndex corner = active_corner_stack.back(); active_corner_stack.pop_back(); const bool interior_face = @@ -842,6 +871,18 @@ int MeshEdgebreakerDecoderImpl::DecodeConnectivity( const CornerIndex corner_c = corner_table_->Next(corner_table_->LeftMostCorner(vert_x)); + if (corner == corner_b || corner == corner_c || corner_b == corner_c) { + // All matched corners must be different. + return -1; + } + if (corner_table_->Opposite(corner) != kInvalidCornerIndex || + corner_table_->Opposite(corner_b) != kInvalidCornerIndex || + corner_table_->Opposite(corner_c) != kInvalidCornerIndex) { + // One of the corners is already opposite to an existing face, which + // should not happen unless the input was tampered with. + return -1; + } + const VertexIndex vert_p = corner_table_->Vertex(corner_table_->Next(corner_c)); @@ -894,6 +935,11 @@ int MeshEdgebreakerDecoderImpl::DecodeConnectivity( VertexCornersIterator vcit(corner_table_.get(), src_vert); for (; !vcit.End(); ++vcit) { const CornerIndex cid = vcit.Corner(); + if (corner_table_->Vertex(cid) != src_vert) { + // Vertex mapped to |cid| was not |src_vert|. This indicates corrupted + // data and we should terminate the decoding. + return -1; + } corner_table_->MapCornerToVertex(cid, invalid_vert); } corner_table_->SetLeftMostCorner(invalid_vert, diff --git a/contrib/draco/src/draco/compression/mesh/mesh_edgebreaker_encoder.cc b/contrib/draco/src/draco/compression/mesh/mesh_edgebreaker_encoder.cc index 5aff5d8cc..a7f381480 100644 --- a/contrib/draco/src/draco/compression/mesh/mesh_edgebreaker_encoder.cc +++ b/contrib/draco/src/draco/compression/mesh/mesh_edgebreaker_encoder.cc @@ -31,7 +31,6 @@ bool MeshEdgebreakerEncoder::InitializeEncoder() { impl_ = nullptr; // For tiny meshes it's usually better to use the basic edgebreaker as the // overhead of the predictive one may turn out to be too big. - // TODO(b/111065939): Check if this can be improved. const bool is_tiny_mesh = mesh()->num_faces() < 1000; int selected_edgebreaker_method = diff --git a/contrib/draco/src/draco/compression/mesh/mesh_edgebreaker_encoder_impl.cc b/contrib/draco/src/draco/compression/mesh/mesh_edgebreaker_encoder_impl.cc index 0791dc670..4bf6aa920 100644 --- a/contrib/draco/src/draco/compression/mesh/mesh_edgebreaker_encoder_impl.cc +++ b/contrib/draco/src/draco/compression/mesh/mesh_edgebreaker_encoder_impl.cc @@ -408,7 +408,7 @@ Status MeshEdgebreakerEncoderImpl::EncodeConnectivity() { init_face_connectivity_corners.begin(), init_face_connectivity_corners.end()); // Encode connectivity for all non-position attributes. - if (attribute_data_.size() > 0) { + if (!attribute_data_.empty()) { // Use the same order of corner that will be used by the decoder. visited_faces_.assign(mesh_->num_faces(), false); for (CornerIndex ci : processed_connectivity_corners_) { diff --git a/contrib/draco/src/draco/compression/mesh/mesh_edgebreaker_encoder_impl.h b/contrib/draco/src/draco/compression/mesh/mesh_edgebreaker_encoder_impl.h index fb3377163..979e1d373 100644 --- a/contrib/draco/src/draco/compression/mesh/mesh_edgebreaker_encoder_impl.h +++ b/contrib/draco/src/draco/compression/mesh/mesh_edgebreaker_encoder_impl.h @@ -177,7 +177,6 @@ class MeshEdgebreakerEncoderImpl : public MeshEdgebreakerEncoderImplInterface { uint32_t num_split_symbols_; // Struct holding data used for encoding each non-position attribute. - // TODO(ostava): This should be probably renamed to something better. struct AttributeData { AttributeData() : attribute_index(-1), is_connectivity_used(true) {} int attribute_index; diff --git a/contrib/draco/src/draco/compression/mesh/mesh_edgebreaker_encoding_test.cc b/contrib/draco/src/draco/compression/mesh/mesh_edgebreaker_encoding_test.cc index 831388245..523303b09 100644 --- a/contrib/draco/src/draco/compression/mesh/mesh_edgebreaker_encoding_test.cc +++ b/contrib/draco/src/draco/compression/mesh/mesh_edgebreaker_encoding_test.cc @@ -44,7 +44,7 @@ class MeshEdgebreakerEncodingTest : public ::testing::Test { EncoderOptions encoder_options = EncoderOptions::CreateDefaultOptions(); encoder_options.SetSpeed(10 - compression_level, 10 - compression_level); encoder.SetMesh(*mesh); - ASSERT_TRUE(encoder.Encode(encoder_options, &buffer).ok()); + DRACO_ASSERT_OK(encoder.Encode(encoder_options, &buffer)); DecoderBuffer dec_buffer; dec_buffer.Init(buffer.data(), buffer.size()); @@ -52,15 +52,14 @@ class MeshEdgebreakerEncodingTest : public ::testing::Test { std::unique_ptr decoded_mesh(new Mesh()); DecoderOptions dec_options; - ASSERT_TRUE( - decoder.Decode(dec_options, &dec_buffer, decoded_mesh.get()).ok()); + DRACO_ASSERT_OK( + decoder.Decode(dec_options, &dec_buffer, decoded_mesh.get())); // Cleanup the input mesh to make sure that input and output can be // compared (edgebreaker method discards degenerated triangles and isolated // vertices). const MeshCleanupOptions options; - MeshCleanup cleanup; - ASSERT_TRUE(cleanup(mesh, options)) << "Failed to clean the input mesh."; + DRACO_ASSERT_OK(MeshCleanup::Cleanup(mesh, options)); MeshAreEquivalent eq; ASSERT_TRUE(eq(*mesh, *decoded_mesh.get())) @@ -102,8 +101,8 @@ TEST_F(MeshEdgebreakerEncodingTest, TestEncoderReuse) { EncoderOptions encoder_options = EncoderOptions::CreateDefaultOptions(); encoder.SetMesh(*mesh); EncoderBuffer buffer_0, buffer_1; - ASSERT_TRUE(encoder.Encode(encoder_options, &buffer_0).ok()); - ASSERT_TRUE(encoder.Encode(encoder_options, &buffer_1).ok()); + DRACO_ASSERT_OK(encoder.Encode(encoder_options, &buffer_0)); + DRACO_ASSERT_OK(encoder.Encode(encoder_options, &buffer_1)); // Make sure both buffer are identical. ASSERT_EQ(buffer_0.size(), buffer_1.size()); @@ -123,7 +122,7 @@ TEST_F(MeshEdgebreakerEncodingTest, TestDecoderReuse) { EncoderOptions encoder_options = EncoderOptions::CreateDefaultOptions(); encoder.SetMesh(*mesh); EncoderBuffer buffer; - ASSERT_TRUE(encoder.Encode(encoder_options, &buffer).ok()); + DRACO_ASSERT_OK(encoder.Encode(encoder_options, &buffer)); DecoderBuffer dec_buffer; dec_buffer.Init(buffer.data(), buffer.size()); @@ -133,13 +132,13 @@ TEST_F(MeshEdgebreakerEncodingTest, TestDecoderReuse) { // Decode the mesh two times. std::unique_ptr decoded_mesh_0(new Mesh()); DecoderOptions dec_options; - ASSERT_TRUE( - decoder.Decode(dec_options, &dec_buffer, decoded_mesh_0.get()).ok()); + DRACO_ASSERT_OK( + decoder.Decode(dec_options, &dec_buffer, decoded_mesh_0.get())); dec_buffer.Init(buffer.data(), buffer.size()); std::unique_ptr decoded_mesh_1(new Mesh()); - ASSERT_TRUE( - decoder.Decode(dec_options, &dec_buffer, decoded_mesh_1.get()).ok()); + DRACO_ASSERT_OK( + decoder.Decode(dec_options, &dec_buffer, decoded_mesh_1.get())); // Make sure both of the meshes are identical. MeshAreEquivalent eq; @@ -169,7 +168,7 @@ TEST_F(MeshEdgebreakerEncodingTest, TestSingleConnectivityEncoding) { encoder.SetAttributeQuantization(GeometryAttribute::TEX_COORD, 8); encoder.SetAttributeQuantization(GeometryAttribute::NORMAL, 8); encoder.SetEncodingMethod(MESH_EDGEBREAKER_ENCODING); - ASSERT_TRUE(encoder.EncodeMeshToBuffer(*mesh, &buffer).ok()); + DRACO_ASSERT_OK(encoder.EncodeMeshToBuffer(*mesh, &buffer)); DecoderBuffer dec_buffer; dec_buffer.Init(buffer.data(), buffer.size()); @@ -216,7 +215,7 @@ TEST_F(MeshEdgebreakerEncodingTest, TestWrongAttributeOrder) { encoder.SetAttributeQuantization(GeometryAttribute::POSITION, 8); encoder.SetAttributeQuantization(GeometryAttribute::NORMAL, 8); encoder.SetEncodingMethod(MESH_EDGEBREAKER_ENCODING); - ASSERT_TRUE(encoder.EncodeMeshToBuffer(*mesh, &buffer).ok()); + DRACO_ASSERT_OK(encoder.EncodeMeshToBuffer(*mesh, &buffer)); DecoderBuffer dec_buffer; dec_buffer.Init(buffer.data(), buffer.size()); diff --git a/contrib/draco/src/draco/compression/mesh/mesh_edgebreaker_shared.h b/contrib/draco/src/draco/compression/mesh/mesh_edgebreaker_shared.h index cb3c29dd6..c650bc352 100644 --- a/contrib/draco/src/draco/compression/mesh/mesh_edgebreaker_shared.h +++ b/contrib/draco/src/draco/compression/mesh/mesh_edgebreaker_shared.h @@ -50,8 +50,6 @@ namespace draco { // \ / S \ / / E \ // *-------* *-------* // -// TODO(ostava): Get rid of the topology bit pattern. It's important only for -// encoding but the algorithms should use EdgebreakerSymbol instead. enum EdgebreakerTopologyBitPattern { TOPOLOGY_C = 0x0, // 0 TOPOLOGY_S = 0x1, // 1 0 0 diff --git a/contrib/draco/src/draco/compression/mesh/mesh_edgebreaker_traversal_valence_decoder.h b/contrib/draco/src/draco/compression/mesh/mesh_edgebreaker_traversal_valence_decoder.h index c00373727..89553e909 100644 --- a/contrib/draco/src/draco/compression/mesh/mesh_edgebreaker_traversal_valence_decoder.h +++ b/contrib/draco/src/draco/compression/mesh/mesh_edgebreaker_traversal_valence_decoder.h @@ -129,7 +129,11 @@ class MeshEdgebreakerTraversalValenceDecoder if (context_counter < 0) { return TOPOLOGY_INVALID; } - const int symbol_id = context_symbols_[active_context_][context_counter]; + const uint32_t symbol_id = + context_symbols_[active_context_][context_counter]; + if (symbol_id > 4) { + return TOPOLOGY_INVALID; + } last_symbol_ = edge_breaker_symbol_to_topology_id[symbol_id]; } else { #ifdef DRACO_BACKWARDS_COMPATIBILITY_SUPPORTED diff --git a/contrib/draco/src/draco/compression/mesh/mesh_encoder_test.cc b/contrib/draco/src/draco/compression/mesh/mesh_encoder_test.cc index 55f683696..2dfdb58ef 100644 --- a/contrib/draco/src/draco/compression/mesh/mesh_encoder_test.cc +++ b/contrib/draco/src/draco/compression/mesh/mesh_encoder_test.cc @@ -78,9 +78,10 @@ class MeshEncoderTest : public ::testing::TestWithParam { encoder.SetAttributeQuantization(i, 12); } EncoderBuffer buffer; - ASSERT_TRUE(encoder.EncodeToBuffer(&buffer).ok()) - << "Failed encoding test mesh " << file_name << " with method " - << GetParam().encoding_method; + const Status status = encoder.EncodeToBuffer(&buffer); + EXPECT_TRUE(status.ok()) << "Failed encoding test mesh " << file_name + << " with method " << GetParam().encoding_method; + DRACO_ASSERT_OK(status); // Check that the encoded mesh was really encoded with the selected method. DecoderBuffer decoder_buffer; decoder_buffer.Init(buffer.data(), buffer.size()); @@ -88,6 +89,7 @@ class MeshEncoderTest : public ::testing::TestWithParam { uint8_t encoded_method; ASSERT_TRUE(decoder_buffer.Decode(&encoded_method)); ASSERT_EQ(encoded_method, method); + if (!FLAGS_update_golden_files) { EXPECT_TRUE( CompareGoldenFile(golden_file_name, buffer.data(), buffer.size())) diff --git a/contrib/draco/src/draco/compression/mesh/mesh_sequential_decoder.cc b/contrib/draco/src/draco/compression/mesh/mesh_sequential_decoder.cc index be349f543..595a487a4 100644 --- a/contrib/draco/src/draco/compression/mesh/mesh_sequential_decoder.cc +++ b/contrib/draco/src/draco/compression/mesh/mesh_sequential_decoder.cc @@ -96,7 +96,7 @@ bool MeshSequentialDecoder::DecodeConnectivity() { } mesh()->AddFace(face); } - } else if (mesh()->num_points() < (1 << 21) && + } else if (num_points < (1 << 21) && bitstream_version() >= DRACO_BITSTREAM_VERSION(2, 2)) { // Decode indices as uint32_t. for (uint32_t i = 0; i < num_faces; ++i) { @@ -158,6 +158,10 @@ bool MeshSequentialDecoder::DecodeAndDecompressIndices(uint32_t num_faces) { index_diff = -index_diff; } const int32_t index_value = index_diff + last_index_value; + if (index_value < 0) { + // Negative indices are not allowed. + return false; + } face[j] = index_value; last_index_value = index_value; } diff --git a/contrib/draco/src/draco/compression/mesh/mesh_sequential_encoder.cc b/contrib/draco/src/draco/compression/mesh/mesh_sequential_encoder.cc index 02ac7779e..fd8b11392 100644 --- a/contrib/draco/src/draco/compression/mesh/mesh_sequential_encoder.cc +++ b/contrib/draco/src/draco/compression/mesh/mesh_sequential_encoder.cc @@ -32,8 +32,6 @@ Status MeshSequentialEncoder::EncodeConnectivity() { EncodeVarint(static_cast(mesh()->num_points()), buffer()); // We encode all attributes in the original (possibly duplicated) format. - // TODO(ostava): This may not be optimal if we have only one attribute or if - // all attributes share the same index mapping. if (options()->GetGlobalBool("compress_connectivity", false)) { // 0 = Encode compressed indices. buffer()->Encode(static_cast(0)); @@ -44,8 +42,6 @@ Status MeshSequentialEncoder::EncodeConnectivity() { // 1 = Encode indices directly. buffer()->Encode(static_cast(1)); // Store vertex indices using a smallest data type that fits their range. - // TODO(ostava): This can be potentially improved by using a tighter - // fit that is not bound by a bit-length of any particular data type. if (mesh()->num_points() < 256) { // Serialize indices as uint8_t. for (FaceIndex i(0); i < num_faces; ++i) { diff --git a/contrib/draco/src/draco/compression/mesh/mesh_sequential_encoder.h b/contrib/draco/src/draco/compression/mesh/mesh_sequential_encoder.h index 672609642..6e2b05877 100644 --- a/contrib/draco/src/draco/compression/mesh/mesh_sequential_encoder.h +++ b/contrib/draco/src/draco/compression/mesh/mesh_sequential_encoder.h @@ -33,7 +33,6 @@ namespace draco { // Class that encodes mesh data using a simple binary representation of mesh's // connectivity and geometry. -// TODO(ostava): Use a better name. class MeshSequentialEncoder : public MeshEncoder { public: MeshSequentialEncoder(); diff --git a/contrib/draco/src/draco/compression/mesh/traverser/mesh_attribute_indices_encoding_observer.h b/contrib/draco/src/draco/compression/mesh/traverser/mesh_attribute_indices_encoding_observer.h index e66dd14b2..dd9738ba2 100644 --- a/contrib/draco/src/draco/compression/mesh/traverser/mesh_attribute_indices_encoding_observer.h +++ b/contrib/draco/src/draco/compression/mesh/traverser/mesh_attribute_indices_encoding_observer.h @@ -25,7 +25,7 @@ namespace draco { // values based on the traversal of the encoded mesh. The class should be used // as the TraversalObserverT member of a Traverser class such as the // DepthFirstTraverser (depth_first_traverser.h). -// TODO(hemmer): rename to AttributeIndicesCodingTraverserObserver +// TODO(b/199760123): Rename to AttributeIndicesCodingTraverserObserver. template class MeshAttributeIndicesEncodingObserver { public: diff --git a/contrib/draco/src/draco/compression/mesh/traverser/mesh_traversal_sequencer.h b/contrib/draco/src/draco/compression/mesh/traverser/mesh_traversal_sequencer.h index ebe1d5f7a..e55c93a79 100644 --- a/contrib/draco/src/draco/compression/mesh/traverser/mesh_traversal_sequencer.h +++ b/contrib/draco/src/draco/compression/mesh/traverser/mesh_traversal_sequencer.h @@ -25,7 +25,7 @@ namespace draco { // Sequencer that generates point sequence in an order given by a deterministic // traversal on the mesh surface. Note that all attributes encoded with this // sequence must share the same connectivity. -// TODO(hemmer): Consider refactoring such that this is an observer. +// TODO(b/199760123): Consider refactoring such that this is an observer. template class MeshTraversalSequencer : public PointsSequencer { public: diff --git a/contrib/draco/src/draco/compression/point_cloud/algorithms/dynamic_integer_points_kd_tree_decoder.h b/contrib/draco/src/draco/compression/point_cloud/algorithms/dynamic_integer_points_kd_tree_decoder.h index 87bc2b7ef..55bafe7c4 100644 --- a/contrib/draco/src/draco/compression/point_cloud/algorithms/dynamic_integer_points_kd_tree_decoder.h +++ b/contrib/draco/src/draco/compression/point_cloud/algorithms/dynamic_integer_points_kd_tree_decoder.h @@ -18,8 +18,10 @@ #define DRACO_COMPRESSION_POINT_CLOUD_ALGORITHMS_DYNAMIC_INTEGER_POINTS_KD_TREE_DECODER_H_ #include +#include #include #include +#include #include "draco/compression/bit_coders/adaptive_rans_bit_decoder.h" #include "draco/compression/bit_coders/direct_bit_decoder.h" @@ -92,17 +94,29 @@ class DynamicIntegerPointsKdTreeDecoder { base_stack_(32 * dimension + 1, VectorUint32(dimension, 0)), levels_stack_(32 * dimension + 1, VectorUint32(dimension, 0)) {} - // Decodes a integer point cloud from |buffer|. + // Decodes an integer point cloud from |buffer|. Optional |oit_max_points| can + // be used to tell the decoder the maximum number of points accepted by the + // iterator. template bool DecodePoints(DecoderBuffer *buffer, OutputIteratorT &oit); + template + bool DecodePoints(DecoderBuffer *buffer, OutputIteratorT &oit, + uint32_t oit_max_points); + #ifndef DRACO_OLD_GCC template bool DecodePoints(DecoderBuffer *buffer, OutputIteratorT &&oit); + template + bool DecodePoints(DecoderBuffer *buffer, OutputIteratorT &&oit, + uint32_t oit_max_points); #endif // DRACO_OLD_GCC const uint32_t dimension() const { return dimension_; } + // Returns the number of decoded points. Must be called after DecodePoints(). + uint32_t num_decoded_points() const { return num_decoded_points_; } + private: uint32_t GetAxis(uint32_t num_remaining_points, const VectorUint32 &levels, uint32_t last_axis); @@ -146,8 +160,15 @@ template template bool DynamicIntegerPointsKdTreeDecoder::DecodePoints( DecoderBuffer *buffer, OutputIteratorT &&oit) { + return DecodePoints(buffer, oit, std::numeric_limits::max()); +} + +template +template +bool DynamicIntegerPointsKdTreeDecoder::DecodePoints( + DecoderBuffer *buffer, OutputIteratorT &&oit, uint32_t oit_max_points) { OutputIteratorT local = std::forward(oit); - return DecodePoints(buffer, local); + return DecodePoints(buffer, local, oit_max_points); } #endif // DRACO_OLD_GCC @@ -155,6 +176,13 @@ template template bool DynamicIntegerPointsKdTreeDecoder::DecodePoints( DecoderBuffer *buffer, OutputIteratorT &oit) { + return DecodePoints(buffer, oit, std::numeric_limits::max()); +} + +template +template +bool DynamicIntegerPointsKdTreeDecoder::DecodePoints( + DecoderBuffer *buffer, OutputIteratorT &oit, uint32_t oit_max_points) { if (!buffer->Decode(&bit_length_)) { return false; } @@ -167,6 +195,9 @@ bool DynamicIntegerPointsKdTreeDecoder::DecodePoints( if (num_points_ == 0) { return true; } + if (num_points_ > oit_max_points) { + return false; + } num_decoded_points_ = 0; if (!numbers_decoder_.StartDecoding(buffer)) { @@ -227,7 +258,7 @@ bool DynamicIntegerPointsKdTreeDecoder::DecodeInternal( std::stack status_stack; status_stack.push(init_status); - // TODO(hemmer): use preallocated vector instead of stack. + // TODO(b/199760123): Use preallocated vector instead of stack. while (!status_stack.empty()) { const DecodingStatus status = status_stack.top(); status_stack.pop(); @@ -263,7 +294,8 @@ bool DynamicIntegerPointsKdTreeDecoder::DecodeInternal( // Fast decoding of remaining bits if number of points is 1 or 2. if (num_remaining_points <= 2) { - // TODO(hemmer): axes_ not necessary, remove would change bitstream! + // TODO(b/199760123): |axes_| not necessary, remove would change + // bitstream! axes_[0] = axis; for (uint32_t i = 1; i < dimension_; i++) { axes_[i] = DRACO_INCREMENT_MOD(axes_[i - 1], dimension_); @@ -273,8 +305,10 @@ bool DynamicIntegerPointsKdTreeDecoder::DecodeInternal( p_[axes_[j]] = 0; const uint32_t num_remaining_bits = bit_length_ - levels[axes_[j]]; if (num_remaining_bits) { - remaining_bits_decoder_.DecodeLeastSignificantBits32( - num_remaining_bits, &p_[axes_[j]]); + if (!remaining_bits_decoder_.DecodeLeastSignificantBits32( + num_remaining_bits, &p_[axes_[j]])) { + return false; + } } p_[axes_[j]] = old_base[axes_[j]] | p_[axes_[j]]; } @@ -299,7 +333,12 @@ bool DynamicIntegerPointsKdTreeDecoder::DecodeInternal( uint32_t number = 0; DecodeNumber(incoming_bits, &number); - uint32_t first_half = num_remaining_points / 2 - number; + uint32_t first_half = num_remaining_points / 2; + if (first_half < number) { + // Invalid |number|. + return false; + } + first_half -= number; uint32_t second_half = num_remaining_points - first_half; if (first_half != second_half) { diff --git a/contrib/draco/src/draco/compression/point_cloud/algorithms/dynamic_integer_points_kd_tree_encoder.h b/contrib/draco/src/draco/compression/point_cloud/algorithms/dynamic_integer_points_kd_tree_encoder.h index 14fa32d70..65b3d07a6 100644 --- a/contrib/draco/src/draco/compression/point_cloud/algorithms/dynamic_integer_points_kd_tree_encoder.h +++ b/contrib/draco/src/draco/compression/point_cloud/algorithms/dynamic_integer_points_kd_tree_encoder.h @@ -280,7 +280,7 @@ void DynamicIntegerPointsKdTreeEncoder::EncodeInternal( std::stack status_stack; status_stack.push(init_status); - // TODO(hemmer): use preallocated vector instead of stack. + // TODO(b/199760123): Use preallocated vector instead of stack. while (!status_stack.empty()) { Status status = status_stack.top(); status_stack.pop(); @@ -305,7 +305,8 @@ void DynamicIntegerPointsKdTreeEncoder::EncodeInternal( // Fast encoding of remaining bits if number of points is 1 or 2. // Doing this also for 2 gives a slight additional speed up. if (num_remaining_points <= 2) { - // TODO(hemmer): axes_ not necessary, remove would change bitstream! + // TODO(b/199760123): |axes_| not necessary, remove would change + // bitstream! axes_[0] = axis; for (uint32_t i = 1; i < dimension_; i++) { axes_[i] = DRACO_INCREMENT_MOD(axes_[i - 1], dimension_); diff --git a/contrib/draco/src/draco/compression/point_cloud/algorithms/float_points_tree_encoder.h b/contrib/draco/src/draco/compression/point_cloud/algorithms/float_points_tree_encoder.h index 26ba94f1f..44c1b3d3a 100644 --- a/contrib/draco/src/draco/compression/point_cloud/algorithms/float_points_tree_encoder.h +++ b/contrib/draco/src/draco/compression/point_cloud/algorithms/float_points_tree_encoder.h @@ -44,7 +44,7 @@ namespace draco { // there are more leading zeros, which is then compressed better by the // arithmetic encoding. -// TODO(hemmer): Remove class because it duplicates quantization code. +// TODO(b/199760123): Remove class because it duplicates quantization code. class FloatPointsTreeEncoder { public: explicit FloatPointsTreeEncoder(PointCloudCompressionMethod method); @@ -91,7 +91,7 @@ bool FloatPointsTreeEncoder::EncodePointCloud(InputIteratorT points_begin, // Collect necessary data for encoding. num_points_ = std::distance(points_begin, points_end); - // TODO(hemmer): Extend quantization tools to make this more automatic. + // TODO(b/199760123): Extend quantization tools to make this more automatic. // Compute range of points for quantization std::vector qpoints; qpoints.reserve(num_points_); diff --git a/contrib/draco/src/draco/compression/point_cloud/algorithms/integer_points_kd_tree_decoder.h b/contrib/draco/src/draco/compression/point_cloud/algorithms/integer_points_kd_tree_decoder.h index 94e523cad..bc31af586 100644 --- a/contrib/draco/src/draco/compression/point_cloud/algorithms/integer_points_kd_tree_decoder.h +++ b/contrib/draco/src/draco/compression/point_cloud/algorithms/integer_points_kd_tree_decoder.h @@ -12,7 +12,8 @@ // See the License for the specific language governing permissions and // limitations under the License. // -// TODO(hemmer): Make this a wrapper using DynamicIntegerPointsKdTreeDecoder. +// TODO(b/199760123): Make this a wrapper using +// DynamicIntegerPointsKdTreeDecoder. // // See integer_points_kd_tree_encoder.h for documentation. diff --git a/contrib/draco/src/draco/compression/point_cloud/algorithms/integer_points_kd_tree_encoder.h b/contrib/draco/src/draco/compression/point_cloud/algorithms/integer_points_kd_tree_encoder.h index b8811092e..654f14a78 100644 --- a/contrib/draco/src/draco/compression/point_cloud/algorithms/integer_points_kd_tree_encoder.h +++ b/contrib/draco/src/draco/compression/point_cloud/algorithms/integer_points_kd_tree_encoder.h @@ -12,7 +12,8 @@ // See the License for the specific language governing permissions and // limitations under the License. // -// TODO(hemmer): Make this a wrapper using DynamicIntegerPointsKdTreeEncoder. +// TODO(b/199760123): Make this a wrapper using +// DynamicIntegerPointsKdTreeEncoder. #ifndef DRACO_COMPRESSION_POINT_CLOUD_ALGORITHMS_INTEGER_POINTS_KD_TREE_ENCODER_H_ #define DRACO_COMPRESSION_POINT_CLOUD_ALGORITHMS_INTEGER_POINTS_KD_TREE_ENCODER_H_ diff --git a/contrib/draco/src/draco/compression/point_cloud/algorithms/quantize_points_3.h b/contrib/draco/src/draco/compression/point_cloud/algorithms/quantize_points_3.h index 01943ad9e..8ea0741da 100644 --- a/contrib/draco/src/draco/compression/point_cloud/algorithms/quantize_points_3.h +++ b/contrib/draco/src/draco/compression/point_cloud/algorithms/quantize_points_3.h @@ -22,7 +22,7 @@ namespace draco { -// TODO(hemmer): Make this a stable bounding box. +// TODO(b/199760123): Make this a stable bounding box. struct QuantizationInfo { uint32_t quantization_bits; float range; @@ -41,7 +41,7 @@ OutputIterator QuantizePoints3(const PointIterator &begin, max_range = std::max(std::fabs((*it)[2]), max_range); } - const uint32_t max_quantized_value((1 << info->quantization_bits) - 1); + const uint32_t max_quantized_value((1u << info->quantization_bits) - 1); Quantizer quantize; quantize.Init(max_range, max_quantized_value); info->range = max_range; @@ -66,7 +66,7 @@ void DequantizePoints3(const QPointIterator &begin, const QPointIterator &end, const uint32_t quantization_bits = info.quantization_bits; const float range = info.range; - const uint32_t max_quantized_value((1 << quantization_bits) - 1); + const uint32_t max_quantized_value((1u << quantization_bits) - 1); Dequantizer dequantize; dequantize.Init(range, max_quantized_value); diff --git a/contrib/draco/src/draco/compression/point_cloud/point_cloud_kd_tree_encoding_test.cc b/contrib/draco/src/draco/compression/point_cloud/point_cloud_kd_tree_encoding_test.cc index 2249bb09e..7a7b597f2 100644 --- a/contrib/draco/src/draco/compression/point_cloud/point_cloud_kd_tree_encoding_test.cc +++ b/contrib/draco/src/draco/compression/point_cloud/point_cloud_kd_tree_encoding_test.cc @@ -68,7 +68,7 @@ class PointCloudKdTreeEncodingTest : public ::testing::Test { ++compression_level) { options.SetSpeed(10 - compression_level, 10 - compression_level); encoder.SetPointCloud(pc); - ASSERT_TRUE(encoder.Encode(options, &buffer).ok()); + DRACO_ASSERT_OK(encoder.Encode(options, &buffer)); DecoderBuffer dec_buffer; dec_buffer.Init(buffer.data(), buffer.size()); @@ -76,7 +76,7 @@ class PointCloudKdTreeEncodingTest : public ::testing::Test { std::unique_ptr out_pc(new PointCloud()); DecoderOptions dec_options; - ASSERT_TRUE(decoder.Decode(dec_options, &dec_buffer, out_pc.get()).ok()); + DRACO_ASSERT_OK(decoder.Decode(dec_options, &dec_buffer, out_pc.get())); ComparePointClouds(pc, *out_pc); } diff --git a/contrib/draco/src/draco/core/bounding_box.cc b/contrib/draco/src/draco/core/bounding_box.cc index 8a0709678..8acd6687b 100644 --- a/contrib/draco/src/draco/core/bounding_box.cc +++ b/contrib/draco/src/draco/core/bounding_box.cc @@ -20,11 +20,20 @@ BoundingBox::BoundingBox() : BoundingBox(Vector3f(std::numeric_limits::max(), std::numeric_limits::max(), std::numeric_limits::max()), - Vector3f(-std::numeric_limits::max(), - -std::numeric_limits::max(), - -std::numeric_limits::max())) {} + Vector3f(std::numeric_limits::lowest(), + std::numeric_limits::lowest(), + std::numeric_limits::lowest())) {} BoundingBox::BoundingBox(const Vector3f &min_point, const Vector3f &max_point) : min_point_(min_point), max_point_(max_point) {} +const bool BoundingBox::IsValid() const { + return GetMinPoint()[0] != std::numeric_limits::max() && + GetMinPoint()[1] != std::numeric_limits::max() && + GetMinPoint()[2] != std::numeric_limits::max() && + GetMaxPoint()[0] != std::numeric_limits::lowest() && + GetMaxPoint()[1] != std::numeric_limits::lowest() && + GetMaxPoint()[2] != std::numeric_limits::lowest(); +} + } // namespace draco diff --git a/contrib/draco/src/draco/core/bounding_box.h b/contrib/draco/src/draco/core/bounding_box.h index 31ba2d683..697a73b6f 100644 --- a/contrib/draco/src/draco/core/bounding_box.h +++ b/contrib/draco/src/draco/core/bounding_box.h @@ -38,6 +38,11 @@ class BoundingBox { // Returns the maximum point of the bounding box. inline const Vector3f &GetMaxPoint() const { return max_point_; } + // Checks if the bounding box object was created with the default constructor + // then never updated. Internally, checks if the bounding box minimum and + // maximum points hold the largest positive and smallest negative values. + const bool IsValid() const; + // Conditionally updates the bounding box with a given |new_point|. void Update(const Vector3f &new_point) { for (int i = 0; i < 3; i++) { diff --git a/contrib/draco/src/draco/core/constants.h b/contrib/draco/src/draco/core/constants.h new file mode 100644 index 000000000..3e81992a1 --- /dev/null +++ b/contrib/draco/src/draco/core/constants.h @@ -0,0 +1,6 @@ +#ifndef DRACO_CORE_CONSTANTS_H_ +#define DRACO_CORE_CONSTANTS_H_ + +#define DRACO_PI 3.14159265358979323846 + +#endif // DRACO_CORE_CONSTANTS_H_ diff --git a/contrib/draco/src/draco/core/data_buffer.cc b/contrib/draco/src/draco/core/data_buffer.cc index f0b43d67d..96a378798 100644 --- a/contrib/draco/src/draco/core/data_buffer.cc +++ b/contrib/draco/src/draco/core/data_buffer.cc @@ -52,7 +52,7 @@ void DataBuffer::Resize(int64_t size) { } void DataBuffer::WriteDataToStream(std::ostream &stream) { - if (data_.size() == 0) { + if (data_.empty()) { return; } stream.write(reinterpret_cast(data_.data()), data_.size()); diff --git a/contrib/draco/src/draco/core/data_buffer.h b/contrib/draco/src/draco/core/data_buffer.h index 8ee690540..8eac0f6b4 100644 --- a/contrib/draco/src/draco/core/data_buffer.h +++ b/contrib/draco/src/draco/core/data_buffer.h @@ -67,7 +67,7 @@ class DataBuffer { int64_t update_count() const { return descriptor_.buffer_update_count; } size_t data_size() const { return data_.size(); } const uint8_t *data() const { return data_.data(); } - uint8_t *data() { return &data_[0]; } + uint8_t *data() { return data_.data(); } int64_t buffer_id() const { return descriptor_.buffer_id; } void set_buffer_id(int64_t buffer_id) { descriptor_.buffer_id = buffer_id; } diff --git a/contrib/draco/src/draco/core/decoder_buffer.h b/contrib/draco/src/draco/core/decoder_buffer.h index 0559abbe4..71189b7e7 100644 --- a/contrib/draco/src/draco/core/decoder_buffer.h +++ b/contrib/draco/src/draco/core/decoder_buffer.h @@ -54,12 +54,11 @@ class DecoderBuffer { // Decodes up to 32 bits into out_val. Can be called only in between // StartBitDecoding and EndBitDecoding. Otherwise returns false. - bool DecodeLeastSignificantBits32(int nbits, uint32_t *out_value) { + bool DecodeLeastSignificantBits32(uint32_t nbits, uint32_t *out_value) { if (!bit_decoder_active()) { return false; } - bit_decoder_.GetBits(nbits, out_value); - return true; + return bit_decoder_.GetBits(nbits, out_value); } // Decodes an arbitrary data type. @@ -158,11 +157,12 @@ class DecoderBuffer { inline void ConsumeBits(int k) { bit_offset_ += k; } // Returns |nbits| bits in |x|. - inline bool GetBits(int32_t nbits, uint32_t *x) { - DRACO_DCHECK_GE(nbits, 0); - DRACO_DCHECK_LE(nbits, 32); + inline bool GetBits(uint32_t nbits, uint32_t *x) { + if (nbits > 32) { + return false; + } uint32_t value = 0; - for (int32_t bit = 0; bit < nbits; ++bit) { + for (uint32_t bit = 0; bit < nbits; ++bit) { value |= GetBit() << bit; } *x = value; diff --git a/contrib/draco/src/draco/core/draco_index_type_vector.h b/contrib/draco/src/draco/core/draco_index_type_vector.h index aae1e7aaf..f5256ded9 100644 --- a/contrib/draco/src/draco/core/draco_index_type_vector.h +++ b/contrib/draco/src/draco/core/draco_index_type_vector.h @@ -25,25 +25,32 @@ namespace draco { // A wrapper around the standard std::vector that supports indexing of the // vector entries using the strongly typed indices as defined in -// draco_index_type.h . -// TODO(ostava): Make the interface more complete. It's currently missing -// features such as iterators. -// TODO(vytyaz): Add more unit tests for this class. +// draco_index_type.h. +// TODO(ostava): Make the interface more complete. It's currently missing some +// features. template class IndexTypeVector { public: typedef typename std::vector::const_reference const_reference; typedef typename std::vector::reference reference; + typedef typename std::vector::iterator iterator; + typedef typename std::vector::const_iterator const_iterator; IndexTypeVector() {} explicit IndexTypeVector(size_t size) : vector_(size) {} IndexTypeVector(size_t size, const ValueTypeT &val) : vector_(size, val) {} + iterator begin() { return vector_.begin(); } + const_iterator begin() const { return vector_.begin(); } + iterator end() { return vector_.end(); } + const_iterator end() const { return vector_.end(); } + void clear() { vector_.clear(); } void reserve(size_t size) { vector_.reserve(size); } void resize(size_t size) { vector_.resize(size); } void resize(size_t size, const ValueTypeT &val) { vector_.resize(size, val); } void assign(size_t size, const ValueTypeT &val) { vector_.assign(size, val); } + iterator erase(iterator position) { return vector_.erase(position); } void swap(IndexTypeVector &arg) { vector_.swap(arg.vector_); diff --git a/contrib/draco/src/draco/core/draco_test_utils.cc b/contrib/draco/src/draco/core/draco_test_utils.cc index edca9856d..a71082a86 100644 --- a/contrib/draco/src/draco/core/draco_test_utils.cc +++ b/contrib/draco/src/draco/core/draco_test_utils.cc @@ -16,9 +16,9 @@ #include +#include "draco/core/draco_test_base.h" #include "draco/core/macros.h" #include "draco/io/file_utils.h" -#include "draco_test_base.h" namespace draco { @@ -27,6 +27,8 @@ static constexpr char kTestDataDir[] = DRACO_TEST_DATA_DIR; static constexpr char kTestTempDir[] = DRACO_TEST_TEMP_DIR; } // namespace +std::string GetTestTempDir() { return std::string(kTestDataDir); } + std::string GetTestFileFullPath(const std::string &file_name) { return std::string(kTestDataDir) + std::string("/") + file_name; } @@ -55,11 +57,13 @@ bool CompareGoldenFile(const std::string &golden_file_name, const void *data, size_t remaining_data_size = data_size; int offset = 0; while ((extracted_size = in_file.read(buffer, buffer_size).gcount()) > 0) { - if (remaining_data_size <= 0) + if (remaining_data_size <= 0) { break; // Input and golden sizes are different. + } size_t size_to_check = extracted_size; - if (remaining_data_size < size_to_check) + if (remaining_data_size < size_to_check) { size_to_check = remaining_data_size; + } for (uint32_t i = 0; i < size_to_check; ++i) { if (buffer[i] != data_c8[offset++]) { LOG(INFO) << "Test output differed from golden file at byte " @@ -77,4 +81,20 @@ bool CompareGoldenFile(const std::string &golden_file_name, const void *data, return true; } +#ifdef DRACO_TRANSCODER_SUPPORTED + +template <> +std::unique_ptr ReadGeometryFromTestFile( + const std::string &file_name) { + return ReadMeshFromTestFile(file_name); +} + +template <> +std::unique_ptr ReadGeometryFromTestFile( + const std::string &file_name) { + return ReadSceneFromTestFile(file_name); +} + +#endif // DRACO_TRANSCODER_SUPPORTED + } // namespace draco diff --git a/contrib/draco/src/draco/core/draco_test_utils.h b/contrib/draco/src/draco/core/draco_test_utils.h index fa548f52d..658096fe1 100644 --- a/contrib/draco/src/draco/core/draco_test_utils.h +++ b/contrib/draco/src/draco/core/draco_test_utils.h @@ -15,12 +15,24 @@ #ifndef DRACO_CORE_DRACO_TEST_UTILS_H_ #define DRACO_CORE_DRACO_TEST_UTILS_H_ +#include +#include +#include + #include "draco/core/draco_test_base.h" +#include "draco/draco_features.h" #include "draco/io/mesh_io.h" #include "draco/io/point_cloud_io.h" +#ifdef DRACO_TRANSCODER_SUPPORTED +#include "draco/io/scene_io.h" +#endif + namespace draco { +// Returns test temporary directory. +std::string GetTestTempDir(); + // Returns the full path to a given file system entry, such as test file or test // directory. std::string GetTestFileFullPath(const std::string &entry_name); @@ -65,6 +77,47 @@ inline std::unique_ptr ReadPointCloudFromTestFile( return ReadPointCloudFromFile(path).value(); } +#ifdef DRACO_TRANSCODER_SUPPORTED +inline std::unique_ptr ReadSceneFromTestFile( + const std::string &file_name) { + const std::string path = GetTestFileFullPath(file_name); + return ReadSceneFromFile(path).value(); +} + +// Loads geometry specified by a |file_name| that is going to be automatically +// converted to the correct path available to the testing instance. Supported +// geometry types are Mesh and Scene. +template +std::unique_ptr ReadGeometryFromTestFile(const std::string &file_name); + +#endif // DRACO_TRANSCODER_SUPPORTED + +// Utility class for redirection and capture of stderr/stdout. +class CaptureStream { + public: + explicit CaptureStream(std::ostream &stream) + : old_buffer_(stream.rdbuf(buffer_.rdbuf())), stream_(stream) {} + + ~CaptureStream() { Reset(); } + + std::string GetStringAndRelease() { + Reset(); + return buffer_.str(); + } + + void Reset() { + if (old_buffer_) { + stream_.rdbuf(old_buffer_); + old_buffer_ = nullptr; + } + } + + private: + std::ostringstream buffer_; + std::streambuf *old_buffer_ = nullptr; + std::ostream &stream_; +}; + // Evaluates an expression that returns draco::Status. If the status is not OK, // the macro asserts and logs the error message. #define DRACO_ASSERT_OK(expression) \ diff --git a/contrib/draco/src/draco/core/draco_version.h b/contrib/draco/src/draco/core/draco_version.h index 14a504a50..88856447f 100644 --- a/contrib/draco/src/draco/core/draco_version.h +++ b/contrib/draco/src/draco/core/draco_version.h @@ -18,9 +18,7 @@ namespace draco { // Draco version is comprised of ... -static const char kDracoVersion[] = "1.4.1"; - -const char *Version() { return kDracoVersion; } +static const char kDracoVersion[] = "1.5.6"; } // namespace draco diff --git a/contrib/draco/src/draco/core/macros.h b/contrib/draco/src/draco/core/macros.h index 147bbaafc..a31e7c44b 100644 --- a/contrib/draco/src/draco/core/macros.h +++ b/contrib/draco/src/draco/core/macros.h @@ -15,7 +15,8 @@ #ifndef DRACO_CORE_MACROS_H_ #define DRACO_CORE_MACROS_H_ -#include "assert.h" +#include + #include "draco/draco_features.h" #ifdef ANDROID_LOGGING @@ -37,7 +38,7 @@ namespace draco { #define DISALLOW_COPY_AND_ASSIGN(TypeName) \ TypeName(const TypeName &) = delete; \ void operator=(const TypeName &) = delete; -#endif +#endif // DISALLOW_COPY_AND_ASSIGN #ifndef FALLTHROUGH_INTENDED #if defined(__clang__) && defined(__has_warning) @@ -46,7 +47,7 @@ namespace draco { #endif #elif defined(__GNUC__) && __GNUC__ >= 7 #define FALLTHROUGH_INTENDED [[gnu::fallthrough]] -#endif +#endif // FALLTHROUGH_INTENDED // If FALLTHROUGH_INTENDED is still not defined, define it. #ifndef FALLTHROUGH_INTENDED @@ -54,7 +55,7 @@ namespace draco { do { \ } while (0) #endif -#endif +#endif // FALLTHROUGH_INTENDED #ifndef LOG #define LOG(...) std::cout @@ -84,12 +85,16 @@ namespace draco { #define DRACO_DCHECK_LE(a, b) #define DRACO_DCHECK_LT(a, b) #define DRACO_DCHECK_NOTNULL(x) -#endif +#endif // DRACO_DEBUG // Helper macros for concatenating macro values. #define DRACO_MACROS_IMPL_CONCAT_INNER_(x, y) x##y #define DRACO_MACROS_IMPL_CONCAT_(x, y) DRACO_MACROS_IMPL_CONCAT_INNER_(x, y) +#define DRACO_MACROS_IMPL_CONCAT_INNER_3_(x, y, z) x##y##z +#define DRACO_MACROS_IMPL_CONCAT_3_(x, y, z) \ + DRACO_MACROS_IMPL_CONCAT_INNER_3_(x, y, z) + // Expand the n-th argument of the macro. Used to select an argument based on // the number of entries in a variadic macro argument. Example usage: // @@ -100,9 +105,9 @@ namespace draco { // #define VARIADIC_MACRO(...) // DRACO_SELECT_NTH_FROM_3(__VA_ARGS__, FUNC_3, FUNC_2, FUNC_1) __VA_ARGS__ // -#define DRACO_SELECT_NTH_FROM_2(_1, _2, NAME) NAME -#define DRACO_SELECT_NTH_FROM_3(_1, _2, _3, NAME) NAME -#define DRACO_SELECT_NTH_FROM_4(_1, _2, _3, _4, NAME) NAME +#define DRACO_SELECT_NTH_FROM_2(_1, _2, NAME, ...) NAME +#define DRACO_SELECT_NTH_FROM_3(_1, _2, _3, NAME, ...) NAME +#define DRACO_SELECT_NTH_FROM_4(_1, _2, _3, _4, NAME, ...) NAME // Macro that converts the Draco bit-stream into one uint16_t number. // Useful mostly when checking version numbers. diff --git a/contrib/draco/src/draco/core/math_utils.h b/contrib/draco/src/draco/core/math_utils.h index 7f382fa34..d7732e55d 100644 --- a/contrib/draco/src/draco/core/math_utils.h +++ b/contrib/draco/src/draco/core/math_utils.h @@ -19,6 +19,8 @@ #include "draco/core/vector_d.h" +namespace draco { + #define DRACO_INCREMENT_MOD(I, M) (((I) == ((M)-1)) ? 0 : ((I) + 1)) // Returns floor(sqrt(x)) where x is an integer number. The main intend of this @@ -52,4 +54,26 @@ inline uint64_t IntSqrt(uint64_t number) { return square_root; } +// Performs the addition in unsigned type to avoid signed integer overflow. Note +// that the result will be the same (for non-overflowing values). +template < + typename DataTypeT, + typename std::enable_if::value && + std::is_signed::value>::type * = nullptr> +inline DataTypeT AddAsUnsigned(DataTypeT a, DataTypeT b) { + typedef typename std::make_unsigned::type DataTypeUT; + return static_cast(static_cast(a) + + static_cast(b)); +} + +template ::value || + !std::is_signed::value>::type * = + nullptr> +inline DataTypeT AddAsUnsigned(DataTypeT a, DataTypeT b) { + return a + b; +} + +} // namespace draco + #endif // DRACO_CORE_MATH_UTILS_H_ diff --git a/contrib/draco/src/draco/core/math_utils_test.cc b/contrib/draco/src/draco/core/math_utils_test.cc index 8c255d046..460a67444 100644 --- a/contrib/draco/src/draco/core/math_utils_test.cc +++ b/contrib/draco/src/draco/core/math_utils_test.cc @@ -5,7 +5,7 @@ #include "draco/core/draco_test_base.h" -using draco::Vector3f; +namespace draco { TEST(MathUtils, Mod) { EXPECT_EQ(DRACO_INCREMENT_MOD(1, 1 << 1), 0); } @@ -20,3 +20,5 @@ TEST(MathUtils, IntSqrt) { ASSERT_EQ(IntSqrt(number), static_cast(floor(std::sqrt(number)))); } } + +} // namespace draco diff --git a/contrib/draco/src/draco/core/options.cc b/contrib/draco/src/draco/core/options.cc index 9b81db489..ceb87cccc 100644 --- a/contrib/draco/src/draco/core/options.cc +++ b/contrib/draco/src/draco/core/options.cc @@ -15,13 +15,12 @@ #include "draco/core/options.h" #include +#include #include #include namespace draco { -Options::Options() {} - void Options::MergeAndReplace(const Options &other_options) { for (const auto &item : other_options.options_) { options_[item.first] = item.second; diff --git a/contrib/draco/src/draco/core/options.h b/contrib/draco/src/draco/core/options.h index 1bc4dc0fb..3f15d13ba 100644 --- a/contrib/draco/src/draco/core/options.h +++ b/contrib/draco/src/draco/core/options.h @@ -19,6 +19,8 @@ #include #include +#include "draco/draco_features.h" + namespace draco { // Class for storing generic options as a pair in a string map. @@ -27,7 +29,8 @@ namespace draco { // data type. class Options { public: - Options(); + Options() = default; + ~Options() = default; // Merges |other_options| on top of the existing options of this instance // replacing all entries that are present in both options instances. @@ -71,8 +74,6 @@ class Options { private: // All entries are internally stored as strings and converted to the desired // return type based on the used Get* method. - // TODO(ostava): Consider adding type safety mechanism that would prevent - // unsafe operations such as a conversion from vector to int. std::map options_; }; diff --git a/contrib/draco/src/draco/core/status.cc b/contrib/draco/src/draco/core/status.cc new file mode 100644 index 000000000..ecb0b536e --- /dev/null +++ b/contrib/draco/src/draco/core/status.cc @@ -0,0 +1,44 @@ +// Copyright 2022 The Draco Authors. +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. +#include "draco/core/status.h" + +#include + +namespace draco { + +std::string Status::code_string() const { + switch (code_) { + case Code::OK: + return "OK"; + case Code::DRACO_ERROR: + return "DRACO_ERROR"; + case Code::IO_ERROR: + return "IO_ERROR"; + case Code::INVALID_PARAMETER: + return "INVALID_PARAMETER"; + case Code::UNSUPPORTED_VERSION: + return "UNSUPPORTED_VERSION"; + case Code::UNKNOWN_VERSION: + return "UNKNOWN_VERSION"; + case Code::UNSUPPORTED_FEATURE: + return "UNSUPPORTED_FEATURE"; + } + return "UNKNOWN_STATUS_VALUE"; +} + +std::string Status::code_and_error_string() const { + return code_string() + ": " + error_msg_string(); +} + +} // namespace draco diff --git a/contrib/draco/src/draco/core/status.h b/contrib/draco/src/draco/core/status.h index 449ad8566..fac96046c 100644 --- a/contrib/draco/src/draco/core/status.h +++ b/contrib/draco/src/draco/core/status.h @@ -15,6 +15,7 @@ #ifndef DRACO_CORE_STATUS_H_ #define DRACO_CORE_STATUS_H_ +#include #include namespace draco { @@ -44,6 +45,8 @@ class Status { Code code() const { return code_; } const std::string &error_msg_string() const { return error_msg_; } const char *error_msg() const { return error_msg_.c_str(); } + std::string code_string() const; + std::string code_and_error_string() const; bool operator==(Code code) const { return code == code_; } bool ok() const { return code_ == OK; } @@ -61,6 +64,9 @@ inline std::ostream &operator<<(std::ostream &os, const Status &status) { } inline Status OkStatus() { return Status(Status::OK); } +inline Status ErrorStatus(const std::string &msg) { + return Status(Status::DRACO_ERROR, msg); +} // Evaluates an expression that returns draco::Status. If the status is not OK, // the macro returns the status object. diff --git a/contrib/draco/src/draco/core/status_test.cc b/contrib/draco/src/draco/core/status_test.cc index c1ad4ab30..dc36496d4 100644 --- a/contrib/draco/src/draco/core/status_test.cc +++ b/contrib/draco/src/draco/core/status_test.cc @@ -29,10 +29,17 @@ TEST_F(StatusTest, TestStatusOutput) { // Tests that the Status can be stored in a provided std::ostream. const draco::Status status(draco::Status::DRACO_ERROR, "Error msg."); ASSERT_EQ(status.code(), draco::Status::DRACO_ERROR); + ASSERT_EQ(status.code_string(), "DRACO_ERROR"); std::stringstream str; str << status; ASSERT_EQ(str.str(), "Error msg."); + + const draco::Status status2 = draco::ErrorStatus("Error msg2."); + ASSERT_EQ(status2.code(), draco::Status::DRACO_ERROR); + ASSERT_EQ(status2.error_msg_string(), "Error msg2."); + ASSERT_EQ(status2.code_string(), "DRACO_ERROR"); + ASSERT_EQ(status2.code_and_error_string(), "DRACO_ERROR: Error msg2."); } } // namespace diff --git a/contrib/draco/src/draco/core/vector_d.h b/contrib/draco/src/draco/core/vector_d.h index a3c46a46a..a0ec2dedf 100644 --- a/contrib/draco/src/draco/core/vector_d.h +++ b/contrib/draco/src/draco/core/vector_d.h @@ -34,7 +34,7 @@ class VectorD { typedef ScalarT Scalar; typedef VectorD Self; - // TODO(hemmer): Deprecate. + // TODO(b/199760123): Deprecate. typedef ScalarT CoefficientType; VectorD() { @@ -45,7 +45,7 @@ class VectorD { // The following constructor does not compile in opt mode, which for now led // to the constructors further down, which is not ideal. - // TODO(hemmer): fix constructor below and remove others. + // TODO(b/199760123): Fix constructor below and remove others. // template // explicit VectorD(Args... args) : v_({args...}) {} @@ -111,7 +111,7 @@ class VectorD { Scalar &operator[](int i) { return v_[i]; } const Scalar &operator[](int i) const { return v_[i]; } - // TODO(hemmer): remove. + // TODO(b/199760123): Remove. // Similar to interface of Eigen library. Scalar &operator()(int i) { return v_[i]; } const Scalar &operator()(int i) const { return v_[i]; } diff --git a/contrib/draco/src/draco/core/vector_d_test.cc b/contrib/draco/src/draco/core/vector_d_test.cc index d66128fb1..21c1ca4c5 100644 --- a/contrib/draco/src/draco/core/vector_d_test.cc +++ b/contrib/draco/src/draco/core/vector_d_test.cc @@ -32,16 +32,6 @@ typedef draco::Vector5ui Vector5ui; typedef draco::VectorD Vector3i; typedef draco::VectorD Vector4i; -template -void TestSquaredDistance(const draco::VectorD v1, - const draco::VectorD v2, - const CoeffT result) { - CoeffT squared_distance = SquaredDistance(v1, v2); - ASSERT_EQ(squared_distance, result); - squared_distance = SquaredDistance(v2, v1); - ASSERT_EQ(squared_distance, result); -} - TEST(VectorDTest, TestOperators) { { const Vector3f v; @@ -170,56 +160,6 @@ TEST(VectorTest, TestGetNormalizedWithZeroLengthVector) { ASSERT_EQ(normalized[2], 0); } -TEST(VectorDTest, TestSquaredDistance) { - // Test Vector2f: float, 2D. - Vector2f v1_2f(5.5, 10.5); - Vector2f v2_2f(3.5, 15.5); - float result_f = 29; - TestSquaredDistance(v1_2f, v2_2f, result_f); - - // Test Vector3f: float, 3D. - Vector3f v1_3f(5.5, 10.5, 2.3); - Vector3f v2_3f(3.5, 15.5, 0); - result_f = 34.29; - TestSquaredDistance(v1_3f, v2_3f, result_f); - - // Test Vector4f: float, 4D. - Vector4f v1_4f(5.5, 10.5, 2.3, 7.2); - Vector4f v2_4f(3.5, 15.5, 0, 9.9); - result_f = 41.58; - TestSquaredDistance(v1_4f, v2_4f, result_f); - - // Test Vector5f: float, 5D. - Vector5f v1_5f(5.5, 10.5, 2.3, 7.2, 1.0); - Vector5f v2_5f(3.5, 15.5, 0, 9.9, 0.2); - result_f = 42.22; - TestSquaredDistance(v1_5f, v2_5f, result_f); - - // Test Vector 2ui: uint32_t, 2D. - Vector2ui v1_2ui(5, 10); - Vector2ui v2_2ui(3, 15); - uint32_t result_ui = 29; - TestSquaredDistance(v1_2ui, v2_2ui, result_ui); - - // Test Vector 3ui: uint32_t, 3D. - Vector3ui v1_3ui(5, 10, 2); - Vector3ui v2_3ui(3, 15, 0); - result_ui = 33; - TestSquaredDistance(v1_3ui, v2_3ui, result_ui); - - // Test Vector 4ui: uint32_t, 4D. - Vector4ui v1_4ui(5, 10, 2, 7); - Vector4ui v2_4ui(3, 15, 0, 9); - result_ui = 37; - TestSquaredDistance(v1_4ui, v2_4ui, result_ui); - - // Test Vector 5ui: uint32_t, 5D. - Vector5ui v1_5ui(5, 10, 2, 7, 1); - Vector5ui v2_5ui(3, 15, 0, 9, 12); - result_ui = 158; - TestSquaredDistance(v1_5ui, v2_5ui, result_ui); -} - TEST(VectorDTest, TestCrossProduct3D) { const Vector3i e1(1, 0, 0); const Vector3i e2(0, 1, 0); diff --git a/contrib/draco/src/draco/io/file_reader_factory.cc b/contrib/draco/src/draco/io/file_reader_factory.cc index ac7b09288..a8f15a11f 100644 --- a/contrib/draco/src/draco/io/file_reader_factory.cc +++ b/contrib/draco/src/draco/io/file_reader_factory.cc @@ -1,5 +1,6 @@ #include "draco/io/file_reader_factory.h" +#include #include namespace draco { @@ -38,7 +39,6 @@ std::unique_ptr FileReaderFactory::OpenReader( } return reader; } - FILEREADER_LOG_ERROR("No file reader able to open input"); return nullptr; } diff --git a/contrib/draco/src/draco/io/file_utils.cc b/contrib/draco/src/draco/io/file_utils.cc index f93cbd899..694d259e8 100644 --- a/contrib/draco/src/draco/io/file_utils.cc +++ b/contrib/draco/src/draco/io/file_utils.cc @@ -14,6 +14,8 @@ // #include "draco/io/file_utils.h" +#include + #include "draco/io/file_reader_factory.h" #include "draco/io/file_reader_interface.h" #include "draco/io/file_writer_factory.h" @@ -30,7 +32,7 @@ void SplitPath(const std::string &full_path, std::string *out_folder_path, std::string ReplaceFileExtension(const std::string &in_file_name, const std::string &new_extension) { - const auto pos = in_file_name.find_last_of("."); + const auto pos = in_file_name.find_last_of('.'); if (pos == std::string::npos) { // No extension found. return in_file_name + "." + new_extension; @@ -46,6 +48,22 @@ std::string LowercaseFileExtension(const std::string &filename) { return parser::ToLower(filename.substr(pos + 1)); } +std::string LowercaseMimeTypeExtension(const std::string &mime_type) { + const size_t pos = mime_type.find_last_of('/'); + if (pos == 0 || pos == std::string::npos || pos == mime_type.length() - 1) { + return ""; + } + return parser::ToLower(mime_type.substr(pos + 1)); +} + +std::string RemoveFileExtension(const std::string &filename) { + const size_t pos = filename.find_last_of('.'); + if (pos == 0 || pos == std::string::npos || pos == filename.length() - 1) { + return filename; + } + return filename.substr(0, pos); +} + std::string GetFullPath(const std::string &input_file_relative_path, const std::string &sibling_file_full_path) { const auto pos = sibling_file_full_path.find_last_of("/\\"); @@ -76,6 +94,23 @@ bool ReadFileToBuffer(const std::string &file_name, return file_reader->ReadFileToBuffer(buffer); } +bool ReadFileToString(const std::string &file_name, std::string *contents) { + if (!contents) { + return false; + } + std::unique_ptr file_reader = + FileReaderFactory::OpenReader(file_name); + if (file_reader == nullptr) { + return false; + } + std::vector buffer; + if (!ReadFileToBuffer(file_name, &buffer)) { + return false; + } + contents->assign(buffer.begin(), buffer.end()); + return true; +} + bool WriteBufferToFile(const char *buffer, size_t buffer_size, const std::string &file_name) { std::unique_ptr file_writer = diff --git a/contrib/draco/src/draco/io/file_utils.h b/contrib/draco/src/draco/io/file_utils.h index 4b734e049..7a5fc475b 100644 --- a/contrib/draco/src/draco/io/file_utils.h +++ b/contrib/draco/src/draco/io/file_utils.h @@ -15,6 +15,7 @@ #ifndef DRACO_IO_FILE_UTILS_H_ #define DRACO_IO_FILE_UTILS_H_ +#include #include #include @@ -37,6 +38,13 @@ std::string ReplaceFileExtension(const std::string &in_file_name, // '.' (e.g. Linux hidden files), the first delimiter is ignored. std::string LowercaseFileExtension(const std::string &filename); +// Returns the mime type extension in lowercase if present, else "". Extension +// is defined as the string after the last '/ character. +std::string LowercaseMimeTypeExtension(const std::string &mime_type); + +// Returns the file name without extension. +std::string RemoveFileExtension(const std::string &filename); + // Given a path of the input file |input_file_relative_path| relative to the // parent directory of |sibling_file_full_path|, this function returns full path // to the input file. If |sibling_file_full_path| has no directory, the relative @@ -46,13 +54,18 @@ std::string LowercaseFileExtension(const std::string &filename); std::string GetFullPath(const std::string &input_file_relative_path, const std::string &sibling_file_full_path); -// Convenience method. Uses draco::FileReaderFactory internally. Reads contents +// Convenience methods. Uses draco::FileReaderFactory internally. Reads contents // of file referenced by |file_name| into |buffer| and returns true upon // success. bool ReadFileToBuffer(const std::string &file_name, std::vector *buffer); bool ReadFileToBuffer(const std::string &file_name, std::vector *buffer); +// Convenience method for reading a file into a std::string. Reads contents +// of file referenced by |file_name| into |contents| and returns true upon +// success. +bool ReadFileToString(const std::string &file_name, std::string *contents); + // Convenience method. Uses draco::FileWriterFactory internally. Writes contents // of |buffer| to file referred to by |file_name|. File is overwritten if it // exists. Returns true after successful write. diff --git a/contrib/draco/src/draco/io/file_utils_test.cc b/contrib/draco/src/draco/io/file_utils_test.cc index 4085ff0cd..b55b1e3be 100644 --- a/contrib/draco/src/draco/io/file_utils_test.cc +++ b/contrib/draco/src/draco/io/file_utils_test.cc @@ -14,6 +14,8 @@ // #include "draco/io/file_utils.h" +#include + #include "draco/core/draco_test_base.h" #include "draco/core/draco_test_utils.h" diff --git a/contrib/draco/src/draco/io/file_writer_factory.cc b/contrib/draco/src/draco/io/file_writer_factory.cc index cb6851602..8ffd5400a 100644 --- a/contrib/draco/src/draco/io/file_writer_factory.cc +++ b/contrib/draco/src/draco/io/file_writer_factory.cc @@ -1,5 +1,6 @@ #include "draco/io/file_writer_factory.h" +#include #include namespace draco { diff --git a/contrib/draco/src/draco/io/file_writer_utils.cc b/contrib/draco/src/draco/io/file_writer_utils.cc index bcadccfc6..3dab80bbf 100644 --- a/contrib/draco/src/draco/io/file_writer_utils.cc +++ b/contrib/draco/src/draco/io/file_writer_utils.cc @@ -7,6 +7,10 @@ #include "draco/draco_features.h" +#ifdef DRACO_TRANSCODER_SUPPORTED +#include "ghc/filesystem.hpp" +#endif // DRACO_TRANSCODER_SUPPORTED + namespace draco { void SplitPathPrivate(const std::string &full_path, @@ -30,8 +34,18 @@ void SplitPathPrivate(const std::string &full_path, } } -bool DirectoryExists(const std::string &path) { +bool DirectoryExists(const std::string &path_arg) { struct stat path_stat; + std::string path = path_arg; + +#if defined(_WIN32) && not defined(__MINGW32__) + // Avoid a silly windows issue: stat() will fail on a drive letter missing the + // trailing slash. + if (path.size() > 0 && path[path.size()] != '\\' && + path[path.size()] != '/') { + path.append("\\"); + } +#endif // Check if |path| exists. if (stat(path.c_str(), &path_stat) != 0) { @@ -50,7 +64,12 @@ bool CheckAndCreatePathForFile(const std::string &filename) { std::string basename; SplitPathPrivate(filename, &path, &basename); +#ifdef DRACO_TRANSCODER_SUPPORTED + const ghc::filesystem::path ghc_path(path); + ghc::filesystem::create_directories(ghc_path); +#endif // DRACO_TRANSCODER_SUPPORTED const bool directory_exists = DirectoryExists(path); + return directory_exists; } diff --git a/contrib/draco/src/draco/io/file_writer_utils_test.cc b/contrib/draco/src/draco/io/file_writer_utils_test.cc new file mode 100644 index 000000000..14a3013e0 --- /dev/null +++ b/contrib/draco/src/draco/io/file_writer_utils_test.cc @@ -0,0 +1,49 @@ +#include "draco/io/file_writer_utils.h" + +#include + +#include "draco/core/draco_test_base.h" +#include "draco/core/draco_test_utils.h" + +namespace draco { +namespace { + +TEST(FileWriterUtilsTest, SplitPathPrivateNonWindows) { + const std::string test_path = "/path/to/file"; + std::string directory; + std::string file; + SplitPathPrivate(test_path, &directory, &file); + ASSERT_EQ(directory, "/path/to"); + ASSERT_EQ(file, "file"); +} + +TEST(FileWriterUtilsTest, SplitPathPrivateWindows) { + const std::string test_path = "C:\\path\\to\\file"; + std::string directory; + std::string file; + SplitPathPrivate(test_path, &directory, &file); + ASSERT_EQ(directory, "C:\\path\\to"); + ASSERT_EQ(file, "file"); +} + +TEST(FileWriterUtilsTest, DirectoryExistsTest) { + ASSERT_TRUE(DirectoryExists(GetTestTempDir())); + ASSERT_FALSE(DirectoryExists("fake/test/subdir")); +} + +#ifdef DRACO_TRANSCODER_SUPPORTED +TEST(FileWriterUtilsTest, CheckAndCreatePathForFileTest) { + const std::string fake_file = "fake.file"; + const std::string fake_file_subdir = "a/few/dirs/down"; + const std::string test_temp_dir = GetTestTempDir(); + const std::string fake_file_directory = + test_temp_dir + "/" + fake_file_subdir; + const std::string fake_full_path = + test_temp_dir + "/" + fake_file_subdir + "/" + fake_file; + ASSERT_TRUE(CheckAndCreatePathForFile(fake_full_path)); + ASSERT_TRUE(DirectoryExists(fake_file_directory)); +} +#endif // DRACO_TRANSCODER_SUPPORTED + +} // namespace +} // namespace draco diff --git a/contrib/draco/src/draco/io/gltf_decoder.cc b/contrib/draco/src/draco/io/gltf_decoder.cc new file mode 100644 index 000000000..521b7524f --- /dev/null +++ b/contrib/draco/src/draco/io/gltf_decoder.cc @@ -0,0 +1,2893 @@ +// Copyright 2018 The Draco Authors. +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. +// +#include "draco/io/gltf_decoder.h" + +#ifdef DRACO_TRANSCODER_SUPPORTED +#include +#include +#include +#include +#include +#include +#include + +#include "draco/core/draco_types.h" +#include "draco/core/hash_utils.h" +#include "draco/core/status.h" +#include "draco/core/status_or.h" +#include "draco/io/tiny_gltf_utils.h" +#include "draco/material/material_library.h" +#include "draco/mesh/mesh.h" +#include "draco/mesh/mesh_features.h" +#include "draco/mesh/triangle_soup_mesh_builder.h" +#include "draco/metadata/property_table.h" +#include "draco/point_cloud/point_cloud_builder.h" +#include "draco/scene/scene_indices.h" +#include "draco/texture/source_image.h" +#include "draco/texture/texture_utils.h" + +namespace draco { + +namespace { +draco::DataType GltfComponentTypeToDracoType(int component_type) { + switch (component_type) { + case TINYGLTF_COMPONENT_TYPE_BYTE: + return DT_INT8; + case TINYGLTF_COMPONENT_TYPE_UNSIGNED_BYTE: + return DT_UINT8; + case TINYGLTF_COMPONENT_TYPE_SHORT: + return DT_INT16; + case TINYGLTF_COMPONENT_TYPE_UNSIGNED_SHORT: + return DT_UINT16; + case TINYGLTF_COMPONENT_TYPE_UNSIGNED_INT: + return DT_UINT32; + case TINYGLTF_COMPONENT_TYPE_FLOAT: + return DT_FLOAT32; + } + return DT_INVALID; +} + +GeometryAttribute::Type GltfAttributeToDracoAttribute( + const std::string attribute_name) { + if (attribute_name == "POSITION") { + return GeometryAttribute::POSITION; + } else if (attribute_name == "NORMAL") { + return GeometryAttribute::NORMAL; + } else if (attribute_name == "TEXCOORD_0") { + return GeometryAttribute::TEX_COORD; + } else if (attribute_name == "TEXCOORD_1") { + return GeometryAttribute::TEX_COORD; + } else if (attribute_name == "TANGENT") { + return GeometryAttribute::TANGENT; + } else if (attribute_name == "COLOR_0") { + return GeometryAttribute::COLOR; + } else if (attribute_name == "JOINTS_0") { + return GeometryAttribute::JOINTS; + } else if (attribute_name == "WEIGHTS_0") { + return GeometryAttribute::WEIGHTS; + } else if (attribute_name.rfind("_FEATURE_ID_") == 0) { + // Feature ID attribute like _FEATURE_ID_5 from EXT_mesh_features extension. + return GeometryAttribute::GENERIC; + } + return GeometryAttribute::INVALID; +} + +StatusOr TinyGltfToDracoAxisWrappingMode( + int wrap_mode) { + switch (wrap_mode) { + case TINYGLTF_TEXTURE_WRAP_CLAMP_TO_EDGE: + return TextureMap::CLAMP_TO_EDGE; + case TINYGLTF_TEXTURE_WRAP_MIRRORED_REPEAT: + return TextureMap::MIRRORED_REPEAT; + case TINYGLTF_TEXTURE_WRAP_REPEAT: + return TextureMap::REPEAT; + default: + return Status(Status::UNSUPPORTED_FEATURE, "Unsupported wrapping mode."); + } +} + +StatusOr TinyGltfToDracoFilterType(int filter_type) { + switch (filter_type) { + case -1: + return TextureMap::UNSPECIFIED; + case TINYGLTF_TEXTURE_FILTER_NEAREST: + return TextureMap::NEAREST; + case TINYGLTF_TEXTURE_FILTER_LINEAR: + return TextureMap::LINEAR; + case TINYGLTF_TEXTURE_FILTER_NEAREST_MIPMAP_NEAREST: + return TextureMap::NEAREST_MIPMAP_NEAREST; + case TINYGLTF_TEXTURE_FILTER_LINEAR_MIPMAP_NEAREST: + return TextureMap::LINEAR_MIPMAP_NEAREST; + case TINYGLTF_TEXTURE_FILTER_NEAREST_MIPMAP_LINEAR: + return TextureMap::NEAREST_MIPMAP_LINEAR; + case TINYGLTF_TEXTURE_FILTER_LINEAR_MIPMAP_LINEAR: + return TextureMap::LINEAR_MIPMAP_LINEAR; + default: + return Status(Status::DRACO_ERROR, "Unsupported texture filter type."); + } +} + +StatusOr> CopyDataAsUint32( + const tinygltf::Model &model, const tinygltf::Accessor &accessor) { + if (accessor.componentType == TINYGLTF_COMPONENT_TYPE_BYTE) { + return Status(Status::DRACO_ERROR, "Byte cannot be converted to Uint32."); + } + if (accessor.componentType == TINYGLTF_COMPONENT_TYPE_SHORT) { + return Status(Status::DRACO_ERROR, "Short cannot be converted to Uint32."); + } + if (accessor.componentType == TINYGLTF_COMPONENT_TYPE_INT) { + return Status(Status::DRACO_ERROR, "Int cannot be converted to Uint32."); + } + if (accessor.componentType == TINYGLTF_COMPONENT_TYPE_FLOAT) { + return Status(Status::DRACO_ERROR, "Float cannot be converted to Uint32."); + } + if (accessor.componentType == TINYGLTF_COMPONENT_TYPE_DOUBLE) { + return Status(Status::DRACO_ERROR, "Double cannot be converted to Uint32."); + } + if (accessor.bufferView < 0) { + return Status(Status::DRACO_ERROR, + "Error CopyDataAsUint32() bufferView < 0."); + } + + const tinygltf::BufferView &buffer_view = + model.bufferViews[accessor.bufferView]; + if (buffer_view.buffer < 0) { + return Status(Status::DRACO_ERROR, "Error CopyDataAsUint32() buffer < 0."); + } + + const tinygltf::Buffer &buffer = model.buffers[buffer_view.buffer]; + + const uint8_t *const data_start = + buffer.data.data() + buffer_view.byteOffset + accessor.byteOffset; + const int byte_stride = accessor.ByteStride(buffer_view); + const int component_size = + tinygltf::GetComponentSizeInBytes(accessor.componentType); + const int num_components = + TinyGltfUtils::GetNumComponentsForType(accessor.type); + const int num_elements = accessor.count * num_components; + + std::vector output; + output.resize(num_elements); + + int out_index = 0; + const uint8_t *data = data_start; + for (int i = 0; i < accessor.count; ++i) { + for (int c = 0; c < num_components; ++c) { + uint32_t value = 0; + memcpy(&value, data + (c * component_size), component_size); + output[out_index++] = value; + } + + data += byte_stride; + } + + return output; +} + +// Specialization for arithmetic types. +template < + typename TypeT, + typename std::enable_if::value>::type * = nullptr> +StatusOr> CopyDataAs(const tinygltf::Model &model, + const tinygltf::Accessor &accessor) { + if (std::is_same::value) { + if (TINYGLTF_COMPONENT_TYPE_UNSIGNED_BYTE != accessor.componentType) { + return ErrorStatus("Accessor data cannot be converted to Uint8."); + } + } else if (std::is_same::value) { + if (TINYGLTF_COMPONENT_TYPE_UNSIGNED_BYTE != accessor.componentType && + TINYGLTF_COMPONENT_TYPE_UNSIGNED_SHORT != accessor.componentType) { + return ErrorStatus("Accessor data cannot be converted to Uint16."); + } + } else if (std::is_same::value) { + if (TINYGLTF_COMPONENT_TYPE_UNSIGNED_BYTE != accessor.componentType && + TINYGLTF_COMPONENT_TYPE_UNSIGNED_SHORT != accessor.componentType && + TINYGLTF_COMPONENT_TYPE_UNSIGNED_INT != accessor.componentType) { + return ErrorStatus("Accessor data cannot be converted to Uint32."); + } + } else if (std::is_same::value) { + if (TINYGLTF_COMPONENT_TYPE_FLOAT != accessor.componentType) { + return ErrorStatus("Accessor data cannot be converted to Float."); + } + } + if (accessor.bufferView < 0) { + return Status(Status::DRACO_ERROR, "Error CopyDataAs() bufferView < 0."); + } + + const tinygltf::BufferView &buffer_view = + model.bufferViews[accessor.bufferView]; + if (buffer_view.buffer < 0) { + return Status(Status::DRACO_ERROR, "Error CopyDataAs() buffer < 0."); + } + + const tinygltf::Buffer &buffer = model.buffers[buffer_view.buffer]; + + const uint8_t *const data_start = + buffer.data.data() + buffer_view.byteOffset + accessor.byteOffset; + const int byte_stride = accessor.ByteStride(buffer_view); + const int component_size = + tinygltf::GetComponentSizeInBytes(accessor.componentType); + + std::vector output; + output.resize(accessor.count); + + const int num_components = + TinyGltfUtils::GetNumComponentsForType(accessor.type); + int out_index = 0; + const uint8_t *data = data_start; + for (int i = 0; i < accessor.count; ++i) { + for (int c = 0; c < num_components; ++c) { + TypeT value = 0; + memcpy(&value, data + (c * component_size), component_size); + output[out_index++] = value; + } + data += byte_stride; + } + return output; +} + +// Specialization for remaining types is used for draco::VectorD. +template ::value>::type * = + nullptr> +StatusOr> CopyDataAs(const tinygltf::Model &model, + const tinygltf::Accessor &accessor) { + const int num_components = + TinyGltfUtils::GetNumComponentsForType(accessor.type); + if (num_components != TypeT::dimension) { + return Status(Status::DRACO_ERROR, + "Dimension does not equal num components."); + } + if (accessor.bufferView < 0) { + return Status(Status::DRACO_ERROR, "Error CopyDataAs() bufferView < 0."); + } + + const tinygltf::BufferView &buffer_view = + model.bufferViews[accessor.bufferView]; + if (buffer_view.buffer < 0) { + return Status(Status::DRACO_ERROR, "Error CopyDataAs() buffer < 0."); + } + + const tinygltf::Buffer &buffer = model.buffers[buffer_view.buffer]; + + const uint8_t *const data_start = + buffer.data.data() + buffer_view.byteOffset + accessor.byteOffset; + const int byte_stride = accessor.ByteStride(buffer_view); + const int component_size = + tinygltf::GetComponentSizeInBytes(accessor.componentType); + + std::vector output; + output.resize(accessor.count); + + const uint8_t *data = data_start; + for (int i = 0; i < accessor.count; ++i) { + TypeT values; + for (int c = 0; c < num_components; ++c) { + memcpy(&values[c], data + (c * component_size), component_size); + } + output[i] = values; + data += byte_stride; + } + return output; +} + +// Copies the data referenced from |buffer_view_id| into |data|. Currently only +// supports a byte stride of 0. I.e. tightly packed. +Status CopyDataFromBufferView(const tinygltf::Model &model, int buffer_view_id, + std::vector *data) { + if (buffer_view_id < 0) { + return ErrorStatus("Error CopyDataFromBufferView() bufferView < 0."); + } + const tinygltf::BufferView &buffer_view = model.bufferViews[buffer_view_id]; + if (buffer_view.buffer < 0) { + return ErrorStatus("Error CopyDataFromBufferView() buffer < 0."); + } + if (buffer_view.byteStride != 0) { + return Status(Status::DRACO_ERROR, "Error buffer view byteStride != 0."); + } + + const tinygltf::Buffer &buffer = model.buffers[buffer_view.buffer]; + const uint8_t *const data_start = buffer.data.data() + buffer_view.byteOffset; + + data->resize(buffer_view.byteLength); + memcpy(&(*data)[0], data_start, buffer_view.byteLength); + return OkStatus(); +} + +// Returns a SourceImage created from |image|. +StatusOr> GetSourceImage( + const tinygltf::Model &model, const tinygltf::Image &image, + const Texture &texture) { + std::unique_ptr source_image(new SourceImage()); + // If the image is in an external file then the buffer view is < 0. + if (image.bufferView >= 0) { + DRACO_RETURN_IF_ERROR(CopyDataFromBufferView( + model, image.bufferView, &source_image->MutableEncodedData())); + } + source_image->set_filename(image.uri); + source_image->set_mime_type(image.mimeType); + + return source_image; +} + +std::unique_ptr GetNodeTrsMatrix(const tinygltf::Node &node) { + std::unique_ptr trsm(new TrsMatrix()); + if (node.matrix.size() == 16) { + Eigen::Matrix4d transformation; + // clang-format off + // |node.matrix| is in the column-major order. + transformation << + node.matrix[0], node.matrix[4], node.matrix[8], node.matrix[12], + node.matrix[1], node.matrix[5], node.matrix[9], node.matrix[13], + node.matrix[2], node.matrix[6], node.matrix[10], node.matrix[14], + node.matrix[3], node.matrix[7], node.matrix[11], node.matrix[15]; + // clang-format on + if (transformation != Eigen::Matrix4d::Identity()) { + trsm->SetMatrix(transformation); + } + } + + if (node.translation.size() == 3) { + const Eigen::Vector3d default_translation(0.0, 0.0, 0.0); + const Eigen::Vector3d node_translation( + node.translation[0], node.translation[1], node.translation[2]); + if (node_translation != default_translation) { + trsm->SetTranslation(node_translation); + } + } + if (node.scale.size() == 3) { + const Eigen::Vector3d default_scale(1.0, 1.0, 1.0); + const Eigen::Vector3d node_scale(node.scale[0], node.scale[1], + node.scale[2]); + if (node_scale != default_scale) { + trsm->SetScale(node_scale); + } + } + if (node.rotation.size() == 4) { + // Eigen quaternion is defined in (w, x, y, z) vs glTF that uses + // (x, y, z, w). + const Eigen::Quaterniond default_rotation(0.0, 0.0, 0.0, 1.0); + const Eigen::Quaterniond node_rotation(node.rotation[3], node.rotation[0], + node.rotation[1], node.rotation[2]); + if (node_rotation != default_rotation) { + trsm->SetRotation(node_rotation); + } + } + + return trsm; +} + +Eigen::Matrix4d UpdateMatrixForNormals( + const Eigen::Matrix4d &transform_matrix) { + Eigen::Matrix3d mat3x3; + // clang-format off + mat3x3 << + transform_matrix(0, 0), transform_matrix(0, 1), transform_matrix(0, 2), + transform_matrix(1, 0), transform_matrix(1, 1), transform_matrix(1, 2), + transform_matrix(2, 0), transform_matrix(2, 1), transform_matrix(2, 2); + // clang-format on + + mat3x3 = mat3x3.inverse().transpose(); + Eigen::Matrix4d mat4x4; + // clang-format off + mat4x4 << mat3x3(0, 0), mat3x3(0, 1), mat3x3(0, 2), 0.0, + mat3x3(1, 0), mat3x3(1, 1), mat3x3(1, 2), 0.0, + mat3x3(2, 0), mat3x3(2, 1), mat3x3(2, 2), 0.0, + 0.0, 0.0, 0.0, 1.0; + // clang-format on + return mat4x4; +} + +float Determinant(const Eigen::Matrix4d &transform_matrix) { + Eigen::Matrix3d mat3x3; + // clang-format off + mat3x3 << + transform_matrix(0, 0), transform_matrix(0, 1), transform_matrix(0, 2), + transform_matrix(1, 0), transform_matrix(1, 1), transform_matrix(1, 2), + transform_matrix(2, 0), transform_matrix(2, 1), transform_matrix(2, 2); + // clang-format on + return mat3x3.determinant(); +} + +bool FileExists(const std::string &filepath, void * /*user_data*/) { + return GetFileSize(filepath) != 0; +} + +bool ReadWholeFile(std::vector *out, std::string *err, + const std::string &filepath, void *user_data) { + if (!ReadFileToBuffer(filepath, out)) { + if (err) { + *err = "Unable to read: " + filepath; + } + return false; + } + if (user_data) { + auto *files_vector = + reinterpret_cast *>(user_data); + files_vector->push_back(filepath); + } + return true; +} + +bool WriteWholeFile(std::string * /*err*/, const std::string &filepath, + const std::vector &contents, + void * /*user_data*/) { + return WriteBufferToFile(contents.data(), contents.size(), filepath); +} + +} // namespace + +GltfDecoder::GltfDecoder() + : next_face_id_(0), + next_point_id_(0), + total_face_indices_count_(0), + total_point_indices_count_(0), + material_att_id_(-1) {} + +StatusOr> GltfDecoder::DecodeFromFile( + const std::string &file_name) { + return DecodeFromFile(file_name, nullptr); +} + +StatusOr> GltfDecoder::DecodeFromFile( + const std::string &file_name, std::vector *mesh_files) { + DRACO_RETURN_IF_ERROR(LoadFile(file_name, mesh_files)); + return BuildMesh(); +} + +StatusOr> GltfDecoder::DecodeFromBuffer( + DecoderBuffer *buffer) { + DRACO_RETURN_IF_ERROR(LoadBuffer(*buffer)); + return BuildMesh(); +} + +StatusOr> GltfDecoder::DecodeFromFileToScene( + const std::string &file_name) { + return DecodeFromFileToScene(file_name, nullptr); +} + +StatusOr> GltfDecoder::DecodeFromFileToScene( + const std::string &file_name, std::vector *scene_files) { + DRACO_RETURN_IF_ERROR(LoadFile(file_name, scene_files)); + scene_ = std::unique_ptr(new Scene()); + DRACO_RETURN_IF_ERROR(DecodeGltfToScene()); + return std::move(scene_); +} + +StatusOr> GltfDecoder::DecodeFromBufferToScene( + DecoderBuffer *buffer) { + DRACO_RETURN_IF_ERROR(LoadBuffer(*buffer)); + scene_ = std::unique_ptr(new Scene()); + DRACO_RETURN_IF_ERROR(DecodeGltfToScene()); + return std::move(scene_); +} + +Status GltfDecoder::LoadFile(const std::string &file_name, + std::vector *input_files) { + const std::string extension = LowercaseFileExtension(file_name); + tinygltf::TinyGLTF loader; + std::string err; + std::string warn; + + const tinygltf::FsCallbacks fs_callbacks = { + &FileExists, + // TinyGLTF's ExpandFilePath does not do filesystem i/o, so it's safe to + // use in all environments. + &tinygltf::ExpandFilePath, &ReadWholeFile, &WriteWholeFile, + reinterpret_cast(input_files)}; + + loader.SetFsCallbacks(fs_callbacks); + + if (extension == "glb") { + if (!loader.LoadBinaryFromFile(&gltf_model_, &err, &warn, file_name)) { + return Status(Status::DRACO_ERROR, + "TinyGLTF failed to load glb file: " + err); + } + } else if (extension == "gltf") { + if (!loader.LoadASCIIFromFile(&gltf_model_, &err, &warn, file_name)) { + return Status(Status::DRACO_ERROR, + "TinyGLTF failed to load glTF file: " + err); + } + } else { + return Status(Status::DRACO_ERROR, "Unknown input file extension."); + } + DRACO_RETURN_IF_ERROR(CheckUnsupportedFeatures()); + input_file_name_ = file_name; + return OkStatus(); +} + +Status GltfDecoder::LoadBuffer(const DecoderBuffer &buffer) { + tinygltf::TinyGLTF loader; + std::string err; + std::string warn; + + if (!loader.LoadBinaryFromMemory( + &gltf_model_, &err, &warn, + reinterpret_cast(buffer.data_head()), + buffer.remaining_size())) { + return Status(Status::DRACO_ERROR, + "TinyGLTF failed to load glb buffer: " + err); + } + DRACO_RETURN_IF_ERROR(CheckUnsupportedFeatures()); + input_file_name_.clear(); + return OkStatus(); +} + +StatusOr> GltfDecoder::BuildMesh() { + DRACO_RETURN_IF_ERROR(GatherAttributeAndMaterialStats()); + if (total_face_indices_count_ > 0 && total_point_indices_count_ > 0) { + return ErrorStatus( + "Decoding to mesh can't handle triangle and point primitives at the " + "same time."); + } + if (total_face_indices_count_ > 0) { + mb_.Start(total_face_indices_count_ / 3); + DRACO_RETURN_IF_ERROR(AddAttributesToDracoMesh(&mb_)); + } else { + pb_.Start(total_point_indices_count_); + DRACO_RETURN_IF_ERROR(AddAttributesToDracoMesh(&pb_)); + } + + for (const tinygltf::Scene &scene : gltf_model_.scenes) { + for (int i = 0; i < scene.nodes.size(); ++i) { + const Eigen::Matrix4d parent_matrix = Eigen::Matrix4d::Identity(); + DRACO_RETURN_IF_ERROR(DecodeNode(scene.nodes[i], parent_matrix)); + } + } + DRACO_ASSIGN_OR_RETURN( + std::unique_ptr mesh, + BuildMeshFromBuilder(total_face_indices_count_ > 0, &mb_, &pb_)); + + DRACO_RETURN_IF_ERROR(CopyTextures(mesh.get())); + SetAttributePropertiesOnDracoMesh(mesh.get()); + DRACO_RETURN_IF_ERROR(AddMaterialsToDracoMesh(mesh.get())); + DRACO_RETURN_IF_ERROR(AddMeshFeaturesToDracoMesh(mesh.get())); + DRACO_RETURN_IF_ERROR(AddStructuralMetadataToGeometry(mesh.get())); + MoveNonMaterialTextures(mesh.get()); + return mesh; +} + +Status GltfDecoder::AddMeshFeaturesToDracoMesh(Mesh *mesh) { + for (const tinygltf::Scene &scene : gltf_model_.scenes) { + for (int i = 0; i < scene.nodes.size(); ++i) { + DRACO_RETURN_IF_ERROR(AddMeshFeaturesToDracoMesh(scene.nodes[i], mesh)); + } + } + return OkStatus(); +} + +Status GltfDecoder::AddMeshFeaturesToDracoMesh(int node_index, Mesh *mesh) { + const tinygltf::Node &node = gltf_model_.nodes[node_index]; + if (node.mesh >= 0) { + const tinygltf::Mesh &gltf_mesh = gltf_model_.meshes[node.mesh]; + for (const auto &primitive : gltf_mesh.primitives) { + // Decode mesh feature ID sets if present in this primitive. + DRACO_RETURN_IF_ERROR(DecodeMeshFeatures( + primitive, &mesh->GetMaterialLibrary().MutableTextureLibrary(), + mesh)); + } + } + for (int i = 0; i < node.children.size(); ++i) { + DRACO_RETURN_IF_ERROR(AddMeshFeaturesToDracoMesh(node.children[i], mesh)); + } + return OkStatus(); +} + +Status GltfDecoder::CheckUnsupportedFeatures() { + // Check for morph targets. + for (const auto &mesh : gltf_model_.meshes) { + for (const auto &primitive : mesh.primitives) { + if (!primitive.targets.empty()) { + return Status(Status::UNSUPPORTED_FEATURE, + "Morph targets are unsupported."); + } + } + } + + // Check for sparse accessors. + for (const auto &accessor : gltf_model_.accessors) { + if (accessor.sparse.isSparse) { + return Status(Status::UNSUPPORTED_FEATURE, + "Sparse accessors are unsupported."); + } + } + + // Check for extensions. + for (const auto &extension : gltf_model_.extensionsRequired) { + if (extension != "KHR_materials_unlit" && + extension != "KHR_texture_transform" && + extension != "KHR_draco_mesh_compression") { + return Status(Status::UNSUPPORTED_FEATURE, + extension + " is unsupported."); + } + } + return OkStatus(); +} + +Status GltfDecoder::DecodeNode(int node_index, + const Eigen::Matrix4d &parent_matrix) { + const tinygltf::Node &node = gltf_model_.nodes[node_index]; + const std::unique_ptr trsm = GetNodeTrsMatrix(node); + const Eigen::Matrix4d node_matrix = + parent_matrix * trsm->ComputeTransformationMatrix(); + + if (node.mesh >= 0) { + const tinygltf::Mesh &mesh = gltf_model_.meshes[node.mesh]; + for (const auto &primitive : mesh.primitives) { + DRACO_RETURN_IF_ERROR(DecodePrimitive(primitive, node_matrix)); + } + } + for (int i = 0; i < node.children.size(); ++i) { + DRACO_RETURN_IF_ERROR(DecodeNode(node.children[i], node_matrix)); + } + return OkStatus(); +} + +StatusOr GltfDecoder::DecodePrimitiveAttributeCount( + const tinygltf::Primitive &primitive) const { + // Use the first primitive attribute as all attributes have the same entry + // count according to glTF 2.0 spec. + if (primitive.attributes.empty()) { + return Status(Status::DRACO_ERROR, "Primitive has no attributes."); + } + const tinygltf::Accessor &accessor = + gltf_model_.accessors[primitive.attributes.begin()->second]; + return accessor.count; +} + +StatusOr GltfDecoder::DecodePrimitiveIndicesCount( + const tinygltf::Primitive &primitive) const { + if (primitive.indices < 0) { + // Primitive has implicit indices [0, 1, 2, 3, ...]. Determine indices count + // based on entry count of a primitive attribute. + return DecodePrimitiveAttributeCount(primitive); + } + const tinygltf::Accessor &indices = gltf_model_.accessors[primitive.indices]; + return indices.count; +} + +StatusOr> GltfDecoder::DecodePrimitiveIndices( + const tinygltf::Primitive &primitive) const { + std::vector indices_data; + if (primitive.indices < 0) { + // Primitive has implicit indices [0, 1, 2, 3, ...]. Create indices based on + // entry count of a primitive attribute. + DRACO_ASSIGN_OR_RETURN(const int num_vertices, + DecodePrimitiveAttributeCount(primitive)); + indices_data.reserve(num_vertices); + for (int i = 0; i < num_vertices; i++) { + indices_data.push_back(i); + } + } else { + // Get indices from the primitive's indices property. + const tinygltf::Accessor &indices = + gltf_model_.accessors[primitive.indices]; + if (indices.count <= 0) { + return Status(Status::DRACO_ERROR, "Could not convert indices."); + } + DRACO_ASSIGN_OR_RETURN(indices_data, + CopyDataAsUint32(gltf_model_, indices)); + } + return indices_data; +} + +Status GltfDecoder::DecodePrimitive(const tinygltf::Primitive &primitive, + const Eigen::Matrix4d &transform_matrix) { + if (primitive.mode != TINYGLTF_MODE_TRIANGLES && + primitive.mode != TINYGLTF_MODE_POINTS) { + return Status(Status::DRACO_ERROR, + "Primitive does not contain triangles or points."); + } + + // Store the transformation scale of this primitive loading as draco::Mesh. + if (scene_ == nullptr) { + // TODO(vytyaz): Do something for non-uniform scaling. + const float scale = transform_matrix.col(0).norm(); + gltf_primitive_material_to_scales_[primitive.material].push_back(scale); + } + + // Handle indices first. + DRACO_ASSIGN_OR_RETURN(const std::vector indices_data, + DecodePrimitiveIndices(primitive)); + const int number_of_faces = indices_data.size() / 3; + const int number_of_points = indices_data.size(); + + for (const auto &attribute : primitive.attributes) { + const tinygltf::Accessor &accessor = + gltf_model_.accessors[attribute.second]; + + const int att_id = + attribute_name_to_draco_mesh_attribute_id_[attribute.first]; + if (att_id == -1) { + continue; + } + + if (primitive.mode == TINYGLTF_MODE_TRIANGLES) { + DRACO_RETURN_IF_ERROR(AddAttributeValuesToBuilder( + attribute.first, accessor, indices_data, att_id, number_of_faces, + transform_matrix, &mb_)); + } else { + DRACO_RETURN_IF_ERROR(AddAttributeValuesToBuilder( + attribute.first, accessor, indices_data, att_id, number_of_points, + transform_matrix, &pb_)); + } + } + + // Add the material data only if there is more than one material. + if (gltf_primitive_material_to_draco_material_.size() > 1) { + const int material_index = primitive.material; + const auto it = + gltf_primitive_material_to_draco_material_.find(material_index); + if (it != gltf_primitive_material_to_draco_material_.end()) { + if (primitive.mode == TINYGLTF_MODE_TRIANGLES) { + DRACO_RETURN_IF_ERROR( + AddMaterialDataToBuilder(it->second, number_of_faces, &mb_)); + } else { + DRACO_RETURN_IF_ERROR( + AddMaterialDataToBuilder(it->second, number_of_points, &pb_)); + } + } + } + + next_face_id_ += number_of_faces; + next_point_id_ += number_of_points; + return OkStatus(); +} + +Status GltfDecoder::NodeGatherAttributeAndMaterialStats( + const tinygltf::Node &node) { + if (node.mesh >= 0) { + const tinygltf::Mesh &mesh = gltf_model_.meshes[node.mesh]; + for (const auto &primitive : mesh.primitives) { + DRACO_RETURN_IF_ERROR(AccumulatePrimitiveStats(primitive)); + + const auto it = + gltf_primitive_material_to_draco_material_.find(primitive.material); + if (it == gltf_primitive_material_to_draco_material_.end()) { + gltf_primitive_material_to_draco_material_[primitive.material] = + gltf_primitive_material_to_draco_material_.size(); + } + } + } + for (int i = 0; i < node.children.size(); ++i) { + const tinygltf::Node &child = gltf_model_.nodes[node.children[i]]; + DRACO_RETURN_IF_ERROR(NodeGatherAttributeAndMaterialStats(child)); + } + + return OkStatus(); +} + +Status GltfDecoder::GatherAttributeAndMaterialStats() { + for (const auto &scene : gltf_model_.scenes) { + for (int i = 0; i < scene.nodes.size(); ++i) { + const tinygltf::Node &node = gltf_model_.nodes[scene.nodes[i]]; + DRACO_RETURN_IF_ERROR(NodeGatherAttributeAndMaterialStats(node)); + } + } + return OkStatus(); +} + +void GltfDecoder::SumAttributeStats(const std::string &attribute_name, + int count) { + // We know that there must be a valid entry for |attribute_name| at this time. + mesh_attribute_data_[attribute_name].total_attribute_counts += count; +} + +Status GltfDecoder::CheckTypes(const std::string &attribute_name, + int component_type, int type, bool normalized) { + auto it_mad = mesh_attribute_data_.find(attribute_name); + + if (it_mad == mesh_attribute_data_.end()) { + MeshAttributeData mad; + mad.component_type = component_type; + mad.attribute_type = type; + mad.normalized = normalized; + mesh_attribute_data_[attribute_name] = mad; + return OkStatus(); + } + if (it_mad->second.component_type != component_type) { + return Status( + Status::DRACO_ERROR, + attribute_name + " attribute component type does not match previous."); + } + if (it_mad->second.attribute_type != type) { + return Status(Status::DRACO_ERROR, + attribute_name + " attribute type does not match previous."); + } + if (it_mad->second.normalized != normalized) { + return Status( + Status::DRACO_ERROR, + attribute_name + + " attribute normalized property does not match previous."); + } + + return OkStatus(); +} + +Status GltfDecoder::AccumulatePrimitiveStats( + const tinygltf::Primitive &primitive) { + DRACO_ASSIGN_OR_RETURN(const int indices_count, + DecodePrimitiveIndicesCount(primitive)); + if (primitive.mode == TINYGLTF_MODE_TRIANGLES) { + total_face_indices_count_ += indices_count; + } else if (primitive.mode == TINYGLTF_MODE_POINTS) { + total_point_indices_count_ += indices_count; + } else { + return ErrorStatus("Unsupported primitive indices mode."); + } + + for (const auto &attribute : primitive.attributes) { + if (attribute.second >= gltf_model_.accessors.size()) { + return ErrorStatus("Invalid accessor."); + } + const tinygltf::Accessor &accessor = + gltf_model_.accessors[attribute.second]; + + DRACO_RETURN_IF_ERROR(CheckTypes(attribute.first, accessor.componentType, + accessor.type, accessor.normalized)); + SumAttributeStats(attribute.first, accessor.count); + } + return OkStatus(); +} + +template +Status GltfDecoder::AddAttributesToDracoMesh(BuilderT *builder) { + for (const auto &attribute : mesh_attribute_data_) { + const GeometryAttribute::Type draco_att_type = + GltfAttributeToDracoAttribute(attribute.first); + if (draco_att_type == GeometryAttribute::INVALID) { + // Map an invalid attribute to attribute id -1 that will be ignored and + // not included in the Draco mesh. + attribute_name_to_draco_mesh_attribute_id_[attribute.first] = -1; + continue; + } + DRACO_ASSIGN_OR_RETURN( + const int att_id, + AddAttribute(draco_att_type, attribute.second.component_type, + attribute.second.attribute_type, builder)); + attribute_name_to_draco_mesh_attribute_id_[attribute.first] = att_id; + } + + // Add the material attribute. + if (gltf_model_.materials.size() > 1) { + draco::DataType component_type = DT_UINT32; + if (gltf_model_.materials.size() < 256) { + component_type = DT_UINT8; + } else if (gltf_model_.materials.size() < (1 << 16)) { + component_type = DT_UINT16; + } + material_att_id_ = + builder->AddAttribute(GeometryAttribute::MATERIAL, 1, component_type); + } + + return OkStatus(); +} + +template +Status GltfDecoder::AddAttributeValuesToBuilder( + const std::string &attribute_name, const tinygltf::Accessor &accessor, + const std::vector &indices_data, int att_id, + int number_of_elements, const Eigen::Matrix4d &transform_matrix, + BuilderT *builder) { + const bool reverse_winding = Determinant(transform_matrix) < 0; + if (attribute_name == "TEXCOORD_0" || attribute_name == "TEXCOORD_1") { + DRACO_RETURN_IF_ERROR(AddTexCoordToBuilder(accessor, indices_data, att_id, + number_of_elements, + reverse_winding, builder)); + } else if (attribute_name == "TANGENT") { + const Eigen::Matrix4d matrix = UpdateMatrixForNormals(transform_matrix); + DRACO_RETURN_IF_ERROR(AddTangentToBuilder(accessor, indices_data, att_id, + number_of_elements, matrix, + reverse_winding, builder)); + } else if (attribute_name == "POSITION" || attribute_name == "NORMAL") { + const Eigen::Matrix4d matrix = + (attribute_name == "NORMAL") ? UpdateMatrixForNormals(transform_matrix) + : transform_matrix; + const bool normalize = (attribute_name == "NORMAL"); + DRACO_RETURN_IF_ERROR(AddTransformedDataToBuilder( + accessor, indices_data, att_id, number_of_elements, matrix, normalize, + reverse_winding, builder)); + } else if (attribute_name.rfind("_FEATURE_ID_") == 0) { + DRACO_RETURN_IF_ERROR(AddFeatureIdToBuilder( + accessor, indices_data, att_id, number_of_elements, reverse_winding, + attribute_name, builder)); + } else { + DRACO_RETURN_IF_ERROR(AddAttributeDataByTypes(accessor, indices_data, + att_id, number_of_elements, + reverse_winding, builder)); + } + return OkStatus(); +} + +template +Status GltfDecoder::AddTangentToBuilder( + const tinygltf::Accessor &accessor, + const std::vector &indices_data, int att_id, + int number_of_elements, const Eigen::Matrix4d &transform_matrix, + bool reverse_winding, BuilderT *builder) { + DRACO_ASSIGN_OR_RETURN( + std::vector data, + TinyGltfUtils::CopyDataAsFloat(gltf_model_, accessor)); + + for (int v = 0; v < data.size(); ++v) { + Eigen::Vector4d vec4(data[v][0], data[v][1], data[v][2], 1); + vec4 = transform_matrix * vec4; + + // Normalize the data. + Eigen::Vector3d vec3(vec4[0], vec4[1], vec4[2]); + vec3 = vec3.normalized(); + for (int i = 0; i < 3; ++i) { + vec4[i] = vec3[i]; + } + + // Add back the original w component. + vec4[3] = data[v][3]; + for (int i = 0; i < 4; ++i) { + data[v][i] = vec4[i]; + } + } + + SetValuesForBuilder(indices_data, att_id, number_of_elements, data, + reverse_winding, builder); + return OkStatus(); +} + +template +Status GltfDecoder::AddTexCoordToBuilder( + const tinygltf::Accessor &accessor, + const std::vector &indices_data, int att_id, + int number_of_elements, bool reverse_winding, BuilderT *builder) { + DRACO_ASSIGN_OR_RETURN( + std::vector data, + TinyGltfUtils::CopyDataAsFloat(gltf_model_, accessor)); + + // glTF stores texture coordinates flipped on the horizontal axis compared to + // how Draco stores texture coordinates. + for (auto &uv : data) { + uv[1] = 1.0 - uv[1]; + } + + SetValuesForBuilder(indices_data, att_id, number_of_elements, data, + reverse_winding, builder); + return OkStatus(); +} + +template +Status GltfDecoder::AddFeatureIdToBuilder( + const tinygltf::Accessor &accessor, + const std::vector &indices_data, int att_id, + int number_of_elements, bool reverse_winding, + const std::string &attribute_name, BuilderT *builder) { + // Check that the feature ID attribute has correct type. + const int num_components = + TinyGltfUtils::GetNumComponentsForType(accessor.type); + if (num_components != 1) { + return ErrorStatus("Invalid feature ID attribute type."); + } + const draco::DataType draco_component_type = + GltfComponentTypeToDracoType(accessor.componentType); + if (draco_component_type != DT_UINT8 && draco_component_type != DT_UINT16 && + draco_component_type != DT_FLOAT32) { + return ErrorStatus("Invalid feature ID attribute component type."); + } + + // Set feature ID attribute values to mesh faces. + DRACO_RETURN_IF_ERROR(AddAttributeDataByTypes(accessor, indices_data, att_id, + number_of_elements, + reverse_winding, builder)); + + // Store feature ID attribute name with index like _FEATURE_ID_5 in Draco + // attribute metadata. + std::unique_ptr metadata(new draco::AttributeMetadata()); + metadata->AddEntryString("attribute_name", attribute_name); + builder->AddAttributeMetadata(att_id, std::move(metadata)); + return OkStatus(); +} + +template +Status GltfDecoder::AddTransformedDataToBuilder( + const tinygltf::Accessor &accessor, + const std::vector &indices_data, int att_id, + int number_of_elements, const Eigen::Matrix4d &transform_matrix, + bool normalize, bool reverse_winding, BuilderT *builder) { + DRACO_ASSIGN_OR_RETURN( + std::vector data, + TinyGltfUtils::CopyDataAsFloat(gltf_model_, accessor)); + + for (int v = 0; v < data.size(); ++v) { + Eigen::Vector4d vec4(data[v][0], data[v][1], data[v][2], 1); + vec4 = transform_matrix * vec4; + Eigen::Vector3d vec3(vec4[0], vec4[1], vec4[2]); + if (normalize) { + vec3 = vec3.normalized(); + } + for (int i = 0; i < 3; ++i) { + data[v][i] = vec3[i]; + } + } + + SetValuesForBuilder(indices_data, att_id, number_of_elements, data, + reverse_winding, builder); + return OkStatus(); +} + +template +void GltfDecoder::SetValuesForBuilder(const std::vector &indices_data, + int att_id, int number_of_elements, + const std::vector &data, + bool reverse_winding, + TriangleSoupMeshBuilder *builder) { + SetValuesPerFace(indices_data, att_id, number_of_elements, data, + reverse_winding, builder); +} + +template +void GltfDecoder::SetValuesForBuilder(const std::vector &indices_data, + int att_id, int number_of_elements, + const std::vector &data, + bool reverse_winding, + PointCloudBuilder *builder) { + for (int i = 0; i < number_of_elements; ++i) { + const uint32_t v_id = indices_data[i]; + const PointIndex pi(v_id + next_point_id_); + builder->SetAttributeValueForPoint(att_id, pi, + GetDataContentAddress(data[v_id])); + } +} + +template +void GltfDecoder::SetValuesPerFace(const std::vector &indices_data, + int att_id, int number_of_faces, + const std::vector &data, + bool reverse_winding, + TriangleSoupMeshBuilder *mb) { + for (int f = 0; f < number_of_faces; ++f) { + const int base_corner = f * 3; + const uint32_t v_id = indices_data[base_corner]; + const int next_offset = reverse_winding ? 2 : 1; + const int prev_offset = reverse_winding ? 1 : 2; + const uint32_t v_next_id = indices_data[base_corner + next_offset]; + const uint32_t v_prev_id = indices_data[base_corner + prev_offset]; + + const FaceIndex face_index(f + next_face_id_); + mb->SetAttributeValuesForFace(att_id, face_index, + GetDataContentAddress(data[v_id]), + GetDataContentAddress(data[v_next_id]), + GetDataContentAddress(data[v_prev_id])); + } +} + +// Get the address of data content for arithmetic types |T|. +template +const void *GetDataContentAddressImpl(const T &data, + std::true_type /* is_arithmetic */) { + return &data; +} + +// Get the address of data content for vector types |T|. +template +const void *GetDataContentAddressImpl(const T &data, + std::false_type /* is_arithmetic */) { + return data.data(); +} + +template +const void *GltfDecoder::GetDataContentAddress(const T &data) const { + return GetDataContentAddressImpl(data, std::is_arithmetic()); +} + +template +Status GltfDecoder::AddAttributeDataByTypes( + const tinygltf::Accessor &accessor, + const std::vector &indices_data, int att_id, + int number_of_elements, bool reverse_winding, BuilderT *builder) { + typedef VectorD Vector2u8i; + typedef VectorD Vector3u8i; + typedef VectorD Vector4u8i; + typedef VectorD Vector2u16i; + typedef VectorD Vector3u16i; + typedef VectorD Vector4u16i; + switch (accessor.type) { + case TINYGLTF_TYPE_SCALAR: + switch (accessor.componentType) { + case TINYGLTF_COMPONENT_TYPE_UNSIGNED_BYTE: { + DRACO_ASSIGN_OR_RETURN(std::vector data, + CopyDataAs(gltf_model_, accessor)); + SetValuesForBuilder(indices_data, att_id, number_of_elements, + data, reverse_winding, builder); + } break; + case TINYGLTF_COMPONENT_TYPE_UNSIGNED_SHORT: { + DRACO_ASSIGN_OR_RETURN(std::vector data, + CopyDataAs(gltf_model_, accessor)); + SetValuesForBuilder(indices_data, att_id, + number_of_elements, data, + reverse_winding, builder); + } break; + case TINYGLTF_COMPONENT_TYPE_UNSIGNED_INT: { + DRACO_ASSIGN_OR_RETURN(std::vector data, + CopyDataAs(gltf_model_, accessor)); + SetValuesForBuilder(indices_data, att_id, + number_of_elements, data, + reverse_winding, builder); + } break; + case TINYGLTF_COMPONENT_TYPE_FLOAT: { + DRACO_ASSIGN_OR_RETURN(std::vector data, + CopyDataAs(gltf_model_, accessor)); + SetValuesForBuilder(indices_data, att_id, number_of_elements, + data, reverse_winding, builder); + } break; + default: + return ErrorStatus("Add attribute data, unknown component type."); + } + break; + case TINYGLTF_TYPE_VEC2: + switch (accessor.componentType) { + case TINYGLTF_COMPONENT_TYPE_UNSIGNED_BYTE: { + DRACO_ASSIGN_OR_RETURN(std::vector data, + CopyDataAs(gltf_model_, accessor)); + SetValuesForBuilder(indices_data, att_id, + number_of_elements, data, + reverse_winding, builder); + } break; + case TINYGLTF_COMPONENT_TYPE_UNSIGNED_SHORT: { + DRACO_ASSIGN_OR_RETURN( + std::vector data, + CopyDataAs(gltf_model_, accessor)); + SetValuesForBuilder(indices_data, att_id, + number_of_elements, data, + reverse_winding, builder); + } break; + case TINYGLTF_COMPONENT_TYPE_FLOAT: { + DRACO_ASSIGN_OR_RETURN( + std::vector data, + TinyGltfUtils::CopyDataAsFloat(gltf_model_, accessor)); + SetValuesForBuilder(indices_data, att_id, + number_of_elements, data, + reverse_winding, builder); + } break; + default: + return Status(Status::DRACO_ERROR, + "Add attribute data, unknown component type."); + } + break; + case TINYGLTF_TYPE_VEC3: + switch (accessor.componentType) { + case TINYGLTF_COMPONENT_TYPE_UNSIGNED_BYTE: { + DRACO_ASSIGN_OR_RETURN(std::vector data, + CopyDataAs(gltf_model_, accessor)); + SetValuesForBuilder(indices_data, att_id, + number_of_elements, data, + reverse_winding, builder); + } break; + case TINYGLTF_COMPONENT_TYPE_UNSIGNED_SHORT: { + DRACO_ASSIGN_OR_RETURN( + std::vector data, + CopyDataAs(gltf_model_, accessor)); + SetValuesForBuilder(indices_data, att_id, + number_of_elements, data, + reverse_winding, builder); + } break; + case TINYGLTF_COMPONENT_TYPE_FLOAT: { + DRACO_ASSIGN_OR_RETURN( + std::vector data, + TinyGltfUtils::CopyDataAsFloat(gltf_model_, accessor)); + SetValuesForBuilder(indices_data, att_id, + number_of_elements, data, + reverse_winding, builder); + } break; + default: + return Status(Status::DRACO_ERROR, + "Add attribute data, unknown component type."); + } + break; + case TINYGLTF_TYPE_VEC4: + switch (accessor.componentType) { + case TINYGLTF_COMPONENT_TYPE_UNSIGNED_BYTE: { + DRACO_ASSIGN_OR_RETURN(std::vector data, + CopyDataAs(gltf_model_, accessor)); + SetValuesForBuilder(indices_data, att_id, + number_of_elements, data, + reverse_winding, builder); + } break; + case TINYGLTF_COMPONENT_TYPE_UNSIGNED_SHORT: { + DRACO_ASSIGN_OR_RETURN( + std::vector data, + CopyDataAs(gltf_model_, accessor)); + SetValuesForBuilder(indices_data, att_id, + number_of_elements, data, + reverse_winding, builder); + } break; + case TINYGLTF_COMPONENT_TYPE_FLOAT: { + DRACO_ASSIGN_OR_RETURN( + std::vector data, + TinyGltfUtils::CopyDataAsFloat(gltf_model_, accessor)); + SetValuesForBuilder(indices_data, att_id, + number_of_elements, data, + reverse_winding, builder); + } break; + default: + return Status(Status::DRACO_ERROR, + "Add attribute data, unknown component type."); + } + break; + default: + return Status(Status::DRACO_ERROR, "Add attribute data, unknown type."); + } + return OkStatus(); +} + +template +Status GltfDecoder::CopyTextures(T *owner) { + for (int i = 0; i < gltf_model_.images.size(); ++i) { + const tinygltf::Image &image = gltf_model_.images[i]; + if (image.width == -1 || image.height == -1 || image.component == -1) { + // TinyGLTF does not return an error when it cannot find an image. It will + // add an image with negative values. + return Status(Status::DRACO_ERROR, "Error loading image."); + } + + std::unique_ptr draco_texture(new Texture()); + + // Update mapping between glTF images and textures in the texture library. + gltf_image_to_draco_texture_[i] = draco_texture.get(); + + DRACO_ASSIGN_OR_RETURN(std::unique_ptr source_image, + GetSourceImage(gltf_model_, image, *draco_texture)); + if (source_image->encoded_data().empty() && + !source_image->filename().empty()) { + // Update filename of source image to be relative of the glTF file. + std::string dirname; + std::string basename; + SplitPath(input_file_name_, &dirname, &basename); + source_image->set_filename(dirname + "/" + source_image->filename()); + } + draco_texture->set_source_image(*source_image); + + owner->GetMaterialLibrary().MutableTextureLibrary().PushTexture( + std::move(draco_texture)); + } + return OkStatus(); +} + +void GltfDecoder::SetAttributePropertiesOnDracoMesh(Mesh *mesh) { + for (const auto &mad : mesh_attribute_data_) { + const int att_id = attribute_name_to_draco_mesh_attribute_id_[mad.first]; + if (att_id == -1) { + continue; + } + if (mad.second.normalized) { + mesh->attribute(att_id)->set_normalized(true); + } + } +} + +Status GltfDecoder::AddMaterialsToDracoMesh(Mesh *mesh) { + bool is_normal_map_used = false; + + int default_material_index = -1; + const auto it = gltf_primitive_material_to_draco_material_.find(-1); + if (it != gltf_primitive_material_to_draco_material_.end()) { + default_material_index = it->second; + } + + int output_material_index = 0; + for (int input_material_index = 0; + input_material_index < gltf_model_.materials.size(); + ++input_material_index) { + if (default_material_index == input_material_index) { + // Insert a default material here for primitives that did not have a + // material index. + mesh->GetMaterialLibrary().MutableMaterial(output_material_index++); + } + + Material *const output_material = + mesh->GetMaterialLibrary().MutableMaterial(output_material_index++); + DRACO_RETURN_IF_ERROR( + AddGltfMaterial(input_material_index, output_material)); + if (output_material->GetTextureMapByType( + TextureMap::NORMAL_TANGENT_SPACE)) { + is_normal_map_used = true; + } + } + + return OkStatus(); +} + +template +Status GltfDecoder::AddMaterialDataToBuilder(int material_value, + int number_of_elements, + BuilderT *builder) { + if (gltf_primitive_material_to_draco_material_.size() < 256) { + const uint8_t typed_material_value = material_value; + DRACO_RETURN_IF_ERROR(AddMaterialDataToBuilderInternal( + typed_material_value, number_of_elements, builder)); + } else if (gltf_primitive_material_to_draco_material_.size() < (1 << 16)) { + const uint16_t typed_material_value = material_value; + DRACO_RETURN_IF_ERROR(AddMaterialDataToBuilderInternal( + typed_material_value, number_of_elements, builder)); + } else { + const uint32_t typed_material_value = material_value; + DRACO_RETURN_IF_ERROR(AddMaterialDataToBuilderInternal( + typed_material_value, number_of_elements, builder)); + } + return OkStatus(); +} + +template +Status GltfDecoder::AddMaterialDataToBuilderInternal( + T material_value, int number_of_faces, TriangleSoupMeshBuilder *builder) { + for (int f = 0; f < number_of_faces; ++f) { + const FaceIndex face_index(f + next_face_id_); + builder->SetPerFaceAttributeValueForFace(material_att_id_, face_index, + &material_value); + } + return OkStatus(); +} + +template +Status GltfDecoder::AddMaterialDataToBuilderInternal( + T material_value, int number_of_points, PointCloudBuilder *builder) { + for (int pi = 0; pi < number_of_points; ++pi) { + const PointIndex point_index(pi + next_point_id_); + builder->SetAttributeValueForPoint(material_att_id_, point_index, + &material_value); + } + return OkStatus(); +} + +Status GltfDecoder::CheckAndAddTextureToDracoMaterial( + int texture_index, int tex_coord_attribute_index, + const tinygltf::ExtensionMap &tex_info_ext, Material *material, + TextureMap::Type type) { + if (texture_index < 0) { + return OkStatus(); + } + + const tinygltf::Texture &input_texture = gltf_model_.textures[texture_index]; + int source_index = input_texture.source; + + const auto texture_it = gltf_image_to_draco_texture_.find(source_index); + if (texture_it != gltf_image_to_draco_texture_.end()) { + Texture *const texture = texture_it->second; + // Default GLTF 2.0 sampler uses REPEAT mode along both S and T directions. + TextureMap::WrappingMode wrapping_mode(TextureMap::REPEAT); + TextureMap::FilterType min_filter = TextureMap::UNSPECIFIED; + TextureMap::FilterType mag_filter = TextureMap::UNSPECIFIED; + + if (input_texture.sampler >= 0) { + const tinygltf::Sampler &sampler = + gltf_model_.samplers[input_texture.sampler]; + DRACO_ASSIGN_OR_RETURN(wrapping_mode.s, + TinyGltfToDracoAxisWrappingMode(sampler.wrapS)); + DRACO_ASSIGN_OR_RETURN(wrapping_mode.t, + TinyGltfToDracoAxisWrappingMode(sampler.wrapT)); + DRACO_ASSIGN_OR_RETURN(min_filter, + TinyGltfToDracoFilterType(sampler.minFilter)); + DRACO_ASSIGN_OR_RETURN(mag_filter, + TinyGltfToDracoFilterType(sampler.magFilter)); + } + if (tex_coord_attribute_index < 0 || tex_coord_attribute_index > 1) { + return Status(Status::DRACO_ERROR, "Incompatible tex coord index."); + } + TextureTransform transform; + DRACO_ASSIGN_OR_RETURN(const bool has_transform, + CheckKhrTextureTransform(tex_info_ext, &transform)); + if (has_transform) { + DRACO_RETURN_IF_ERROR(material->SetTextureMap( + texture, type, wrapping_mode, min_filter, mag_filter, transform, + tex_coord_attribute_index)); + } else { + DRACO_RETURN_IF_ERROR( + material->SetTextureMap(texture, type, wrapping_mode, min_filter, + mag_filter, tex_coord_attribute_index)); + } + } + return OkStatus(); +} + +Status GltfDecoder::DecodeGltfToScene() { + DRACO_RETURN_IF_ERROR(GatherAttributeAndMaterialStats()); + DRACO_RETURN_IF_ERROR(AddLightsToScene()); + DRACO_RETURN_IF_ERROR(AddMaterialsVariantsNamesToScene()); + DRACO_RETURN_IF_ERROR(AddStructuralMetadataToGeometry(scene_.get())); + DRACO_RETURN_IF_ERROR(CopyTextures(scene_.get())); + for (const tinygltf::Scene &scene : gltf_model_.scenes) { + for (int i = 0; i < scene.nodes.size(); ++i) { + DRACO_RETURN_IF_ERROR( + DecodeNodeForScene(scene.nodes[i], kInvalidSceneNodeIndex)); + scene_->AddRootNodeIndex(gltf_node_to_scenenode_index_[scene.nodes[i]]); + } + } + + DRACO_RETURN_IF_ERROR(AddAnimationsToScene()); + DRACO_RETURN_IF_ERROR(AddMaterialsToScene()); + DRACO_RETURN_IF_ERROR(AddSkinsToScene()); + MoveNonMaterialTextures(scene_.get()); + + return OkStatus(); +} + +Status GltfDecoder::AddLightsToScene() { + // Add all lights to Draco scene. + for (const auto &light : gltf_model_.lights) { + // Add a new light to the scene. + const LightIndex light_index = scene_->AddLight(); + Light *scene_light = scene_->GetLight(light_index); + + // Decode light type. + const std::map types = { + {"directional", Light::DIRECTIONAL}, + {"point", Light::POINT}, + {"spot", Light::SPOT}}; + if (types.count(light.type) == 0) { + return ErrorStatus("Light type is invalid."); + } + scene_light->SetType(types.at(light.type)); + + // Decode spot light properties. + if (scene_light->GetType() == Light::SPOT) { + scene_light->SetInnerConeAngle(light.spot.innerConeAngle); + scene_light->SetOuterConeAngle(light.spot.outerConeAngle); + } + + // Decode other light properties. + scene_light->SetName(light.name); + if (!light.color.empty()) { // Empty means that color is not specified. + if (light.color.size() != 3) { + return ErrorStatus("Light color is malformed."); + } + scene_light->SetColor( + Vector3f(light.color[0], light.color[1], light.color[2])); + } + scene_light->SetIntensity(light.intensity); + if (light.range != 0.0) { // Zero means that range is not specified. + if (light.range < 0.0) { + return ErrorStatus("Light range must be positive."); + } + scene_light->SetRange(light.range); + } + } + return OkStatus(); +} + +Status GltfDecoder::AddMaterialsVariantsNamesToScene() { + // Check whether the scene has materials variants. + const auto &e = gltf_model_.extensions.find("KHR_materials_variants"); + if (e == gltf_model_.extensions.end()) { + // The scene has no materials variants. + return OkStatus(); + } + + // Decode all materials variants names into Draco scene from JSON like this: + // "KHR_materials_variants": { + // "variants": [ + // {"name": "Loki" }, + // {"name": "Odin" }, + // ] + // } + const tinygltf::Value::Object &o = e->second.Get(); + const auto &variants = o.find("variants"); + if (variants == o.end()) { + return ErrorStatus("Materials variants extension with names is malformed."); + } + const tinygltf::Value &variants_array = variants->second; + if (!variants_array.IsArray()) { + return ErrorStatus("Materials variants names array is malformed."); + } + for (int i = 0; i < variants_array.Size(); i++) { + const auto &variant_object = variants_array.Get(i); + if (!variant_object.IsObject() || !variant_object.Has("name")) { + return ErrorStatus("Materials variants name is missing."); + } + const auto &name_string = variant_object.Get("name"); + if (!name_string.IsString()) { + return ErrorStatus("Materials variant name is malformed."); + } + const std::string &name = name_string.Get(); + scene_->GetMaterialLibrary().AddMaterialsVariant(name); + } + return OkStatus(); +} + +template +Status GltfDecoder::AddStructuralMetadataToGeometry(GeometryT *geometry) { + // Check whether the glTF model has structural metadata. + const auto &e = gltf_model_.extensions.find("EXT_structural_metadata"); + if (e == gltf_model_.extensions.end()) { + // The glTF model has no structural metadata. + return OkStatus(); + } + const tinygltf::Value::Object &o = e->second.Get(); + + // Decode property table schema. + { + const auto &value = o.find("schema"); + if (value == o.end()) { + return ErrorStatus("Structural metadata extension has no schema."); + } + const tinygltf::Value &object = value->second; + if (!object.IsObject()) { + return ErrorStatus("Structural metadata extension schema is malformed."); + } + + // Decodes tinygltf::Value into PropertyTable::Schema::Object. + struct SchemaParser { + static Status Parse(const tinygltf::Value &value, + PropertyTable::Schema::Object *object) { + switch (value.Type()) { + case tinygltf::OBJECT_TYPE: { + for (auto &it : value.Get()) { + object->SetObjects().emplace_back(it.first); + DRACO_RETURN_IF_ERROR( + Parse(it.second, &object->SetObjects().back())); + } + } break; + case tinygltf::ARRAY_TYPE: { + for (int i = 0; i < value.ArrayLen(); ++i) { + object->SetArray().emplace_back(); + DRACO_RETURN_IF_ERROR( + Parse(value.Get(i), &object->SetArray().back())); + } + } break; + case tinygltf::STRING_TYPE: + object->SetString(value.Get()); + break; + case tinygltf::INT_TYPE: + object->SetInteger(value.Get()); + break; + case tinygltf::BOOL_TYPE: + object->SetBoolean(value.Get()); + break; + case tinygltf::REAL_TYPE: + case tinygltf::BINARY_TYPE: + case tinygltf::NULL_TYPE: + default: + // Not used in the schema JSON. + return ErrorStatus("Unsupported JSON type in schema."); + } + return OkStatus(); + } + }; + + // Parse property table schema and set it to |geometry|. + PropertyTable::Schema schema; + DRACO_RETURN_IF_ERROR(SchemaParser::Parse(object, &schema.json)); + geometry->GetStructuralMetadata().SetPropertyTableSchema(schema); + } + + // Decode property tables. + { + const auto &tables = o.find("propertyTables"); + if (tables == o.end()) { + return ErrorStatus( + "Structural metadata extension has no property tables."); + } + const tinygltf::Value &tables_array = tables->second; + if (!tables_array.IsArray()) { + return ErrorStatus("Property tables array is malformed."); + } + + // Loop over all property tables. + for (int i = 0; i < tables_array.Size(); i++) { + // Create a property table and populate it below. + std::unique_ptr property_table(new PropertyTable()); + + const auto &object = tables_array.Get(i); + if (!object.IsObject()) { + return ErrorStatus("Property table is malformed."); + } + const auto o = object.Get(); + + // The "class" property is required. + bool success; + std::string str_value; + DRACO_ASSIGN_OR_RETURN(success, DecodeString("class", o, &str_value)); + if (success) { + property_table->SetClass(str_value); + } else { + return ErrorStatus("Property class is malformed."); + } + + // The "count" property is required. + int int_value; + DRACO_ASSIGN_OR_RETURN(success, DecodeInt("count", o, &int_value)); + if (success) { + property_table->SetCount(int_value); + } else { + return ErrorStatus("Property count is malformed."); + } + + // The "name" property is optional. + DRACO_ASSIGN_OR_RETURN(success, DecodeString("name", o, &str_value)); + if (success) { + property_table->SetName(str_value); + } + + // Decode property table properties (columns). + { + constexpr char kName[] = "properties"; + if (!object.Has(kName)) { + return ErrorStatus("Property table is malformed."); + } + const tinygltf::Value &value = object.Get(kName); + if (!value.IsObject()) { + return ErrorStatus( + "Property table properties property is malformed."); + } + + // Loop over property table properties. + for (const auto &key : value.Keys()) { + // Create a property table property and populate it below. + std::unique_ptr property( + new PropertyTable::Property()); + + const auto &property_object = value.Get(key); + if (!property_object.IsObject()) { + return ErrorStatus("Property entry is malformed."); + } + property->SetName(key); + const auto o = property_object.Get(); + + // The "values" property is required. + DRACO_ASSIGN_OR_RETURN( + success, + DecodePropertyTableData("values", o, &property->GetData())); + if (!success) { + return ErrorStatus("Property values property is malformed."); + } + + // All other properties are not required. + DRACO_ASSIGN_OR_RETURN( + success, DecodeString("stringOffsetType", o, &str_value)); + if (success) { + property->GetStringOffsets().type = str_value; + } + DRACO_ASSIGN_OR_RETURN( + success, DecodeString("arrayOffsetType", o, &str_value)); + if (success) { + property->GetArrayOffsets().type = str_value; + } + DRACO_ASSIGN_OR_RETURN( + success, + DecodePropertyTableData("arrayOffsets", o, + &property->GetArrayOffsets().data)); + DRACO_ASSIGN_OR_RETURN( + success, + DecodePropertyTableData("stringOffsets", o, + &property->GetStringOffsets().data)); + + // Add property to the property table. + property_table->AddProperty(std::move(property)); + } + } + + // Add property table to structural metadata. + geometry->GetStructuralMetadata().AddPropertyTable( + std::move(property_table)); + } + } + return OkStatus(); +} + +Status GltfDecoder::AddAnimationsToScene() { + for (const auto &animation : gltf_model_.animations) { + const AnimationIndex animation_index = scene_->AddAnimation(); + Animation *const encoder_animation = scene_->GetAnimation(animation_index); + encoder_animation->SetName(animation.name); + + for (const tinygltf::AnimationChannel &channel : animation.channels) { + const auto it = gltf_node_to_scenenode_index_.find(channel.target_node); + if (it == gltf_node_to_scenenode_index_.end()) { + return Status(Status::DRACO_ERROR, "Could not find Node in the scene."); + } + DRACO_RETURN_IF_ERROR(TinyGltfUtils::AddChannelToAnimation( + gltf_model_, animation, channel, it->second.value(), + encoder_animation)); + } + } + return OkStatus(); +} + +Status GltfDecoder::DecodeNodeForScene(int node_index, + SceneNodeIndex parent_index) { + SceneNodeIndex scene_node_index = kInvalidSceneNodeIndex; + SceneNode *scene_node = nullptr; + bool is_new_node; + if (gltf_scene_graph_mode_ == GltfSceneGraphMode::DAG && + gltf_node_to_scenenode_index_.find(node_index) != + gltf_node_to_scenenode_index_.end()) { + // Node has been decoded already. + scene_node_index = gltf_node_to_scenenode_index_[node_index]; + scene_node = scene_->GetNode(scene_node_index); + is_new_node = false; + } else { + scene_node_index = scene_->AddNode(); + // Update mapping between glTF Nodes and indices in the scene. + gltf_node_to_scenenode_index_[node_index] = scene_node_index; + + scene_node = scene_->GetNode(scene_node_index); + is_new_node = true; + } + + if (parent_index != kInvalidSceneNodeIndex) { + scene_node->AddParentIndex(parent_index); + SceneNode *const parent_node = scene_->GetNode(parent_index); + parent_node->AddChildIndex(scene_node_index); + } + + if (!is_new_node) { + return OkStatus(); + } + const tinygltf::Node &node = gltf_model_.nodes[node_index]; + if (!node.name.empty()) { + scene_node->SetName(node.name); + } + std::unique_ptr trsm = GetNodeTrsMatrix(node); + scene_node->SetTrsMatrix(*trsm); + if (node.skin >= 0) { + // Save the index to the source skins in the node. This will be updated + // later when the skins are processed. + scene_node->SetSkinIndex(SkinIndex(node.skin)); + } + if (node.mesh >= 0) { + // Check if we have already parsed this glTF Mesh. + const auto it = gltf_mesh_to_scene_mesh_group_.find(node.mesh); + if (it != gltf_mesh_to_scene_mesh_group_.end()) { + // We already processed this glTF mesh. + scene_node->SetMeshGroupIndex(it->second); + } else { + const MeshGroupIndex scene_mesh_group_index = scene_->AddMeshGroup(); + MeshGroup *const scene_mesh = + scene_->GetMeshGroup(scene_mesh_group_index); + + const tinygltf::Mesh &mesh = gltf_model_.meshes[node.mesh]; + if (!mesh.name.empty()) { + scene_mesh->SetName(mesh.name); + } + for (const auto &primitive : mesh.primitives) { + DRACO_RETURN_IF_ERROR(DecodePrimitiveForScene(primitive, scene_mesh)); + } + scene_node->SetMeshGroupIndex(scene_mesh_group_index); + gltf_mesh_to_scene_mesh_group_[node.mesh] = scene_mesh_group_index; + } + } + + // Decode light index. + const auto &e = node.extensions.find("KHR_lights_punctual"); + if (e != node.extensions.end()) { + const tinygltf::Value::Object &o = e->second.Get(); + const auto &light = o.find("light"); + if (light != o.end()) { + const tinygltf::Value &value = light->second; + if (!value.IsInt()) { + return ErrorStatus("Node light index is malformed."); + } + const int light_index = value.Get(); + if (light_index < 0 || light_index >= scene_->NumLights()) { + return ErrorStatus("Node light index is out of bounds."); + } + scene_node->SetLightIndex(LightIndex(light_index)); + } + } + + for (int i = 0; i < node.children.size(); ++i) { + DRACO_RETURN_IF_ERROR( + DecodeNodeForScene(node.children[i], scene_node_index)); + } + return OkStatus(); +} + +Status GltfDecoder::DecodePrimitiveForScene( + const tinygltf::Primitive &primitive, MeshGroup *mesh_group) { + if (primitive.mode != TINYGLTF_MODE_TRIANGLES && + primitive.mode != TINYGLTF_MODE_POINTS) { + return Status(Status::DRACO_ERROR, + "Primitive does not contain triangles or points."); + } + + // Decode materials variants mappings if present in this primitive. + std::vector mappings; + const auto &e = primitive.extensions.find("KHR_materials_variants"); + if (e != primitive.extensions.end()) { + DRACO_RETURN_IF_ERROR(DecodeMaterialsVariantsMappings( + e->second.Get(), &mappings)); + } + + const PrimitiveSignature signature(primitive); + const auto existing_mesh_index = + gltf_primitive_to_draco_mesh_index_.find(signature); + if (existing_mesh_index != gltf_primitive_to_draco_mesh_index_.end()) { + mesh_group->AddMeshInstance( + {existing_mesh_index->second, primitive.material, mappings}); + return OkStatus(); + } + + // Handle indices first. + DRACO_ASSIGN_OR_RETURN(const std::vector indices_data, + DecodePrimitiveIndices(primitive)); + const int number_of_faces = indices_data.size() / 3; + const int number_of_points = indices_data.size(); + + // Note that glTF mesh |primitive| has no name; no name is set to Draco mesh. + TriangleSoupMeshBuilder mb; + PointCloudBuilder pb; + if (primitive.mode == TINYGLTF_MODE_TRIANGLES) { + mb.Start(number_of_faces); + } else { + pb.Start(number_of_points); + } + + std::set normalized_attributes; + for (const auto &attribute : primitive.attributes) { + if (attribute.second >= gltf_model_.accessors.size()) { + return ErrorStatus("Invalid accessor."); + } + const tinygltf::Accessor &accessor = + gltf_model_.accessors[attribute.second]; + const int component_type = accessor.componentType; + const int type = accessor.type; + const bool normalized = accessor.normalized; + int att_id = -1; + if (primitive.mode == TINYGLTF_MODE_TRIANGLES) { + DRACO_ASSIGN_OR_RETURN( + att_id, AddAttribute(attribute.first, component_type, type, &mb)); + } else { + DRACO_ASSIGN_OR_RETURN( + att_id, AddAttribute(attribute.first, component_type, type, &pb)); + } + if (att_id == -1) { + continue; + } + if (normalized) { + normalized_attributes.insert(att_id); + } + + if (primitive.mode == TINYGLTF_MODE_TRIANGLES) { + DRACO_RETURN_IF_ERROR(AddAttributeValuesToBuilder( + attribute.first, accessor, indices_data, att_id, number_of_faces, + Eigen::Matrix4d::Identity(), &mb)); + } else { + DRACO_RETURN_IF_ERROR(AddAttributeValuesToBuilder( + attribute.first, accessor, indices_data, att_id, number_of_points, + Eigen::Matrix4d::Identity(), &pb)); + } + } + + int material_index = primitive.material; + + DRACO_ASSIGN_OR_RETURN( + std::unique_ptr mesh, + BuildMeshFromBuilder(primitive.mode == TINYGLTF_MODE_TRIANGLES, &mb, + &pb)); + + // Set all normalized flags for appropriate attributes. + for (const int32_t att_id : normalized_attributes) { + mesh->attribute(att_id)->set_normalized(true); + } + // Decode mesh feature ID sets if present in this primitive. + DRACO_RETURN_IF_ERROR(DecodeMeshFeatures( + primitive, &scene_->GetMaterialLibrary().MutableTextureLibrary(), + mesh.get())); + + const MeshIndex mesh_index = scene_->AddMesh(std::move(mesh)); + if (mesh_index == kInvalidMeshIndex) { + return Status(Status::DRACO_ERROR, "Could not add Draco mesh to scene."); + } + mesh_group->AddMeshInstance({mesh_index, material_index, mappings}); + + gltf_primitive_to_draco_mesh_index_[signature] = mesh_index; + return OkStatus(); +} + +Status GltfDecoder::DecodeMaterialsVariantsMappings( + const tinygltf::Value::Object &extension, + std::vector *mappings) { + // Decode all materials variants mappings from JSON like this: + // "KHR_materials_variants" : { + // "mappings": [ + // { + // "material": 2, + // "variants": [0, 2, 4] + // }, + // { + // "material": 3, + // "variants": [1, 3] + // } + // ] + // } + const auto &mappings_object = extension.find("mappings"); + if (mappings_object == extension.end()) { + return ErrorStatus("Materials variants extension is malformed."); + } + const tinygltf::Value &mappings_array = mappings_object->second; + if (!mappings_array.IsArray()) { + return ErrorStatus("Materials variants mappings array is malformed."); + } + for (int i = 0; i < mappings_array.Size(); i++) { + const auto &mapping_object = mappings_array.Get(i); + if (!mapping_object.IsObject() || !mapping_object.Has("material") || + !mapping_object.Has("variants")) { + return ErrorStatus("Materials variants mapping is malformed."); + } + const tinygltf::Value &material_int = mapping_object.Get("material"); + if (!material_int.IsInt()) { + return ErrorStatus("Materials variant mapping material is malformed."); + } + const int material = material_int.Get(); + const tinygltf::Value &variants_array = mapping_object.Get("variants"); + if (!variants_array.IsArray()) { + return ErrorStatus("Materials variant mapping variants is malformed."); + } + std::vector variants; + for (int j = 0; j < variants_array.Size(); j++) { + const tinygltf::Value &variant_int = variants_array.Get(j); + if (!variant_int.IsInt()) { + return ErrorStatus("Materials variants mapping variant is malformed."); + } + variants.push_back(variant_int.Get()); + } + mappings->push_back({material, variants}); + } + return OkStatus(); +} + +Status GltfDecoder::DecodeMeshFeatures(const tinygltf::Primitive &primitive, + TextureLibrary *texture_library, + Mesh *mesh) { + const auto &e = primitive.extensions.find("EXT_mesh_features"); + if (e == primitive.extensions.end()) { + return OkStatus(); + } + std::vector> mesh_features; + DRACO_RETURN_IF_ERROR( + DecodeMeshFeatures(e->second.Get(), + texture_library, &mesh_features)); + for (int i = 0; i < mesh_features.size(); i++) { + const MeshFeaturesIndex mfi = + mesh->AddMeshFeatures(std::move(mesh_features[i])); + if (scene_ == nullptr) { + // If we are decoding to a mesh, we need to restrict the mesh features to + // the primitive's material. + // TODO(ostava): This will not work properly when two primitives share the + // same material but have different mesh features. We will need to + // duplicate the materials in this case. + const auto mat_it = + gltf_primitive_material_to_draco_material_.find(primitive.material); + if (mat_it != gltf_primitive_material_to_draco_material_.end()) { + mesh->AddMeshFeaturesMaterialMask(mfi, mat_it->second); + } + } + } + return OkStatus(); +} + +Status GltfDecoder::DecodeMeshFeatures( + const tinygltf::Value::Object &extension, TextureLibrary *texture_library, + std::vector> *mesh_features) { + // Decode all mesh feature ID sets from JSON like this: + // "EXT_mesh_features": { + // "featureIds": [ + // { + // "label": "water", + // "featureCount": 2, + // "propertyTable": 0, + // "attribute": 0 + // }, + // { + // "featureCount": 12, + // "nullFeatureId": 100, + // "texture" : { + // "index": 0, + // "texCoord": 0, + // "channels": [0, 1, 2, 3] + // } + // } + // ] + // } + const auto &object = extension.find("featureIds"); + if (object == extension.end()) { + return ErrorStatus("Mesh features extension is malformed."); + } + const tinygltf::Value &array = object->second; + if (!array.IsArray()) { + return ErrorStatus("Mesh features array is malformed."); + } + for (int i = 0; i < array.Size(); i++) { + // Create a new feature ID set object and populate it below. + mesh_features->push_back(std::unique_ptr(new MeshFeatures())); + MeshFeatures &features = *mesh_features->back(); + + const auto &object = array.Get(i); + if (!object.IsObject()) { + return ErrorStatus("Mesh features array entry is malformed."); + } + + // The "featureCount" property is required. + { + constexpr char kName[] = "featureCount"; + if (!object.Has(kName)) { + return ErrorStatus("Mesh features is malformed."); + } + const tinygltf::Value &value = object.Get(kName); + if (!value.IsInt()) { + return ErrorStatus("Feature count property is malformed."); + } + features.SetFeatureCount(value.Get()); + } + + // All other properties are optional. + { + constexpr char kName[] = "nullFeatureId"; + if (object.Has(kName)) { + const tinygltf::Value &value = object.Get(kName); + if (!value.IsInt()) { + return ErrorStatus("Null feature ID property is malformed."); + } + features.SetNullFeatureId(value.Get()); + } + } + { + constexpr char kName[] = "label"; + if (object.Has(kName)) { + const tinygltf::Value &value = object.Get(kName); + if (!value.IsString()) { + return ErrorStatus("Label property is malformed."); + } + features.SetLabel(value.Get()); + } + } + { + constexpr char kName[] = "attribute"; + if (object.Has(kName)) { + const tinygltf::Value &value = object.Get(kName); + if (!value.IsInt()) { + return ErrorStatus("Attribute property is malformed."); + } + features.SetAttributeIndex(value.Get()); + } + } + { + constexpr char kName[] = "texture"; + if (object.Has(kName)) { + const tinygltf::Value &value = object.Get(kName); + if (!value.IsObject()) { + return ErrorStatus("Texture property is malformed."); + } + + // Decode texture contining mesh feature IDs into the |features| object + // via a temporary |material| object. + Material material(texture_library); + const auto &container_object = object.Get(); + DRACO_RETURN_IF_ERROR(DecodeTexture(kName, TextureMap::GENERIC, + container_object, &material)); + features.SetTextureMap( + *material.GetTextureMapByType(TextureMap::GENERIC)); + + // Decode array of texture channel indices. + std::vector channels; + { + constexpr char kName[] = "channels"; + if (value.Has(kName)) { + const tinygltf::Value &array = value.Get(kName); + if (!array.IsArray()) { + return ErrorStatus("Channels property is malformed."); + } + for (int i = 0; i < array.Size(); i++) { + const tinygltf::Value &value = array.Get(i); + if (!value.IsNumber()) { + return Status(Status::DRACO_ERROR, + "Channels value is malformed."); + } + channels.push_back(value.Get()); + } + } else { + channels = {0}; + } + } + features.SetTextureChannels(channels); + } + } + { + constexpr char kName[] = "propertyTable"; + if (object.Has(kName)) { + const tinygltf::Value &value = object.Get(kName); + if (!value.IsInt()) { + return ErrorStatus("Property table property is malformed."); + } + features.SetPropertyTableIndex(value.Get()); + } + } + } + return OkStatus(); +} + +template +StatusOr GltfDecoder::AddAttribute(const std::string &attribute_name, + int component_type, int type, + BuilderT *builder) { + const GeometryAttribute::Type draco_att_type = + GltfAttributeToDracoAttribute(attribute_name); + if (draco_att_type == GeometryAttribute::INVALID) { + // Return attribute id -1 that will be ignored and not included in the mesh. + return -1; + } + DRACO_ASSIGN_OR_RETURN( + const int att_id, + AddAttribute(draco_att_type, component_type, type, builder)); + return att_id; +} + +template +StatusOr GltfDecoder::AddAttribute(GeometryAttribute::Type attribute_type, + int component_type, int type, + BuilderT *builder) { + const int num_components = TinyGltfUtils::GetNumComponentsForType(type); + if (num_components == 0) { + return Status(Status::DRACO_ERROR, + "Could not add attribute with 0 components."); + } + + const draco::DataType draco_component_type = + GltfComponentTypeToDracoType(component_type); + if (draco_component_type == DT_INVALID) { + return Status(Status::DRACO_ERROR, + "Could not add attribute with invalid type."); + } + const int att_id = builder->AddAttribute(attribute_type, num_components, + draco_component_type); + if (att_id < 0) { + return Status(Status::DRACO_ERROR, "Could not add attribute."); + } + return att_id; +} + +StatusOr GltfDecoder::CheckKhrTextureTransform( + const tinygltf::ExtensionMap &extension, TextureTransform *transform) { + bool transform_set = false; + + const auto &e = extension.find("KHR_texture_transform"); + if (e == extension.end()) { + return false; + } + const tinygltf::Value::Object &o = e->second.Get(); + const auto &scale = o.find("scale"); + if (scale != o.end()) { + const tinygltf::Value &array = scale->second; + if (!array.IsArray() || array.Size() != 2) { + return Status(Status::DRACO_ERROR, + "KhrTextureTransform scale is malformed."); + } + std::array scale; + for (int i = 0; i < array.Size(); i++) { + const tinygltf::Value &value = array.Get(i); + if (!value.IsNumber()) { + return Status(Status::DRACO_ERROR, + "KhrTextureTransform scale is malformed."); + } + scale[i] = value.Get(); + transform_set = true; + } + transform->set_scale(scale); + } + const auto &rotation = o.find("rotation"); + if (rotation != o.end()) { + const tinygltf::Value &value = rotation->second; + if (!value.IsNumber()) { + return Status(Status::DRACO_ERROR, + "KhrTextureTransform rotation is malformed."); + } + transform->set_rotation(value.Get()); + transform_set = true; + } + const auto &offset = o.find("offset"); + if (offset != o.end()) { + const tinygltf::Value &array = offset->second; + if (!array.IsArray() || array.Size() != 2) { + return Status(Status::DRACO_ERROR, + "KhrTextureTransform offset is malformed."); + } + std::array offset; + for (int i = 0; i < array.Size(); i++) { + const tinygltf::Value &value = array.Get(i); + if (!value.IsNumber()) { + return Status(Status::DRACO_ERROR, + "KhrTextureTransform offset is malformed."); + } + offset[i] = value.Get(); + transform_set = true; + } + transform->set_offset(offset); + } + const auto &tex_coord = o.find("texCoord"); + if (tex_coord != o.end()) { + const tinygltf::Value &value = tex_coord->second; + if (!value.IsInt()) { + return Status(Status::DRACO_ERROR, + "KhrTextureTransform texCoord is malformed."); + } + transform->set_tex_coord(value.Get()); + transform_set = true; + } + return transform_set; +} + +Status GltfDecoder::AddGltfMaterial(int input_material_index, + Material *output_material) { + const tinygltf::Material &input_material = + gltf_model_.materials[input_material_index]; + + output_material->SetName(input_material.name); + output_material->SetTransparencyMode( + TinyGltfUtils::TextToMaterialMode(input_material.alphaMode)); + output_material->SetAlphaCutoff(input_material.alphaCutoff); + if (input_material.emissiveFactor.size() == 3) { + output_material->SetEmissiveFactor(Vector3f( + input_material.emissiveFactor[0], input_material.emissiveFactor[1], + input_material.emissiveFactor[2])); + } + const tinygltf::PbrMetallicRoughness &pbr = + input_material.pbrMetallicRoughness; + + if (pbr.baseColorFactor.size() == 4) { + output_material->SetColorFactor( + Vector4f(pbr.baseColorFactor[0], pbr.baseColorFactor[1], + pbr.baseColorFactor[2], pbr.baseColorFactor[3])); + } + output_material->SetMetallicFactor(pbr.metallicFactor); + output_material->SetRoughnessFactor(pbr.roughnessFactor); + output_material->SetDoubleSided(input_material.doubleSided); + + DRACO_RETURN_IF_ERROR(CheckAndAddTextureToDracoMaterial( + pbr.baseColorTexture.index, pbr.baseColorTexture.texCoord, + pbr.baseColorTexture.extensions, output_material, TextureMap::COLOR)); + DRACO_RETURN_IF_ERROR(CheckAndAddTextureToDracoMaterial( + pbr.metallicRoughnessTexture.index, pbr.metallicRoughnessTexture.texCoord, + pbr.metallicRoughnessTexture.extensions, output_material, + TextureMap::METALLIC_ROUGHNESS)); + + DRACO_RETURN_IF_ERROR(CheckAndAddTextureToDracoMaterial( + input_material.normalTexture.index, input_material.normalTexture.texCoord, + input_material.normalTexture.extensions, output_material, + TextureMap::NORMAL_TANGENT_SPACE)); + if (input_material.normalTexture.scale != 1.0) { + output_material->SetNormalTextureScale(input_material.normalTexture.scale); + } + DRACO_RETURN_IF_ERROR(CheckAndAddTextureToDracoMaterial( + input_material.occlusionTexture.index, + input_material.occlusionTexture.texCoord, + input_material.occlusionTexture.extensions, output_material, + TextureMap::AMBIENT_OCCLUSION)); + DRACO_RETURN_IF_ERROR(CheckAndAddTextureToDracoMaterial( + input_material.emissiveTexture.index, + input_material.emissiveTexture.texCoord, + input_material.emissiveTexture.extensions, output_material, + TextureMap::EMISSIVE)); + + // Decode material extensions. + DecodeMaterialUnlitExtension(input_material, output_material); + DRACO_RETURN_IF_ERROR( + DecodeMaterialSheenExtension(input_material, output_material)); + DRACO_RETURN_IF_ERROR( + DecodeMaterialTransmissionExtension(input_material, output_material)); + DRACO_RETURN_IF_ERROR( + DecodeMaterialClearcoatExtension(input_material, output_material)); + DRACO_RETURN_IF_ERROR(DecodeMaterialVolumeExtension( + input_material, input_material_index, output_material)); + DRACO_RETURN_IF_ERROR( + DecodeMaterialIorExtension(input_material, output_material)); + DRACO_RETURN_IF_ERROR( + DecodeMaterialSpecularExtension(input_material, output_material)); + + return OkStatus(); +} + +void GltfDecoder::DecodeMaterialUnlitExtension( + const tinygltf::Material &input_material, Material *output_material) { + // Do nothing if extension is absent. + const auto &extension_it = + input_material.extensions.find("KHR_materials_unlit"); + if (extension_it == input_material.extensions.end()) { + return; + } + + // Set the unlit property in Draco material. + output_material->SetUnlit(true); +} + +Status GltfDecoder::DecodeMaterialSheenExtension( + const tinygltf::Material &input_material, Material *output_material) { + // Do nothing if extension is absent. + const auto &extension_it = + input_material.extensions.find("KHR_materials_sheen"); + if (extension_it == input_material.extensions.end()) { + return OkStatus(); + } + + output_material->SetHasSheen(true); + const tinygltf::Value::Object &extension_object = + extension_it->second.Get(); + + // Decode sheen color factor. + Vector3f vector; + bool success; + DRACO_ASSIGN_OR_RETURN( + success, DecodeVector3f("sheenColorFactor", extension_object, &vector)); + if (success) { + output_material->SetSheenColorFactor(vector); + } + + // Decode sheen roughness factor. + float value; + DRACO_ASSIGN_OR_RETURN( + success, DecodeFloat("sheenRoughnessFactor", extension_object, &value)); + if (success) { + output_material->SetSheenRoughnessFactor(value); + } + + // Decode sheen color texture. + DRACO_RETURN_IF_ERROR(DecodeTexture("sheenColorTexture", + TextureMap::SHEEN_COLOR, extension_object, + output_material)); + + // Decode sheen roughness texture. + DRACO_RETURN_IF_ERROR(DecodeTexture("sheenRoughnessTexture", + TextureMap::SHEEN_ROUGHNESS, + extension_object, output_material)); + + return OkStatus(); +} + +Status GltfDecoder::DecodeMaterialTransmissionExtension( + const tinygltf::Material &input_material, Material *output_material) { + // Do nothing if extension is absent. + const auto &extension_it = + input_material.extensions.find("KHR_materials_transmission"); + if (extension_it == input_material.extensions.end()) { + return OkStatus(); + } + + output_material->SetHasTransmission(true); + const tinygltf::Value::Object &extension_object = + extension_it->second.Get(); + + // Decode transmission factor. + float value; + DRACO_ASSIGN_OR_RETURN( + const bool success, + DecodeFloat("transmissionFactor", extension_object, &value)); + if (success) { + output_material->SetTransmissionFactor(value); + } + + // Decode transmission texture. + DRACO_RETURN_IF_ERROR(DecodeTexture("transmissionTexture", + TextureMap::TRANSMISSION, + extension_object, output_material)); + + return OkStatus(); +} + +Status GltfDecoder::DecodeMaterialClearcoatExtension( + const tinygltf::Material &input_material, Material *output_material) { + // Do nothing if extension is absent. + const auto &extension_it = + input_material.extensions.find("KHR_materials_clearcoat"); + if (extension_it == input_material.extensions.end()) { + return OkStatus(); + } + + output_material->SetHasClearcoat(true); + const tinygltf::Value::Object &extension_object = + extension_it->second.Get(); + + // Decode clearcoat factor. + float value; + bool success; + DRACO_ASSIGN_OR_RETURN( + success, DecodeFloat("clearcoatFactor", extension_object, &value)); + if (success) { + output_material->SetClearcoatFactor(value); + } + + // Decode clearcoat roughness factor. + DRACO_ASSIGN_OR_RETURN(success, DecodeFloat("clearcoatRoughnessFactor", + extension_object, &value)); + if (success) { + output_material->SetClearcoatRoughnessFactor(value); + } + + // Decode clearcoat texture. + DRACO_RETURN_IF_ERROR(DecodeTexture("clearcoatTexture", TextureMap::CLEARCOAT, + extension_object, output_material)); + + // Decode clearcoat roughness texture. + DRACO_RETURN_IF_ERROR(DecodeTexture("clearcoatRoughnessTexture", + TextureMap::CLEARCOAT_ROUGHNESS, + extension_object, output_material)); + + // Decode clearcoat normal texture. + DRACO_RETURN_IF_ERROR(DecodeTexture("clearcoatNormalTexture", + TextureMap::CLEARCOAT_NORMAL, + extension_object, output_material)); + + return OkStatus(); +} + +Status GltfDecoder::DecodeMaterialVolumeExtension( + const tinygltf::Material &input_material, int input_material_index, + Material *output_material) { + // Do nothing if extension is absent. + const auto &extension_it = + input_material.extensions.find("KHR_materials_volume"); + if (extension_it == input_material.extensions.end()) { + return OkStatus(); + } + + output_material->SetHasVolume(true); + const tinygltf::Value::Object &extension_object = + extension_it->second.Get(); + + // Decode thickness factor. + float value; + bool success; + DRACO_ASSIGN_OR_RETURN( + success, DecodeFloat("thicknessFactor", extension_object, &value)); + if (success) { + // Volume thickness factor is given in the coordinate space of the model. + // When the model is loaded as draco::Mesh, the scene graph transformations + // are applied to position attribute. Since this effectively scales the + // model coordinate space, the volume thickness factor also must be scaled. + // No scaling is done when the model is loaded as draco::Scene. + float scale = 1.0f; + if (scene_ == nullptr) { + if (gltf_primitive_material_to_scales_.count(input_material_index) == 1) { + const std::vector &scales = + gltf_primitive_material_to_scales_[input_material_index]; + + // It is only possible to scale the volume thickness factor if all + // primitives using this material have the same transformation scale. + // An alternative would be to create a separate meterial for each scale. + scale = scales[0]; + for (int i = 1; i < scales.size(); i++) { + // Note that close-enough scales could also be permitted. + if (scales[i] != scale) { + return ErrorStatus("Cannot represent volume thickness in a mesh."); + } + } + } + } + output_material->SetThicknessFactor(scale * value); + } + + // Decode attenuation distance. + DRACO_ASSIGN_OR_RETURN( + success, DecodeFloat("attenuationDistance", extension_object, &value)); + if (success) { + output_material->SetAttenuationDistance(value); + } + + // Decode attenuation color. + Vector3f vector; + DRACO_ASSIGN_OR_RETURN( + success, DecodeVector3f("attenuationColor", extension_object, &vector)); + if (success) { + output_material->SetAttenuationColor(vector); + } + + // Decode thickness texture. + DRACO_RETURN_IF_ERROR(DecodeTexture("thicknessTexture", TextureMap::THICKNESS, + extension_object, output_material)); + + return OkStatus(); +} + +Status GltfDecoder::DecodeMaterialIorExtension( + const tinygltf::Material &input_material, Material *output_material) { + // Do nothing if extension is absent. + const auto &extension_it = + input_material.extensions.find("KHR_materials_ior"); + if (extension_it == input_material.extensions.end()) { + return OkStatus(); + } + + output_material->SetHasIor(true); + const tinygltf::Value::Object &extension_object = + extension_it->second.Get(); + + // Decode index of refraction. + float value; + DRACO_ASSIGN_OR_RETURN(const bool success, + DecodeFloat("ior", extension_object, &value)); + if (success) { + output_material->SetIor(value); + } + + return OkStatus(); +} + +Status GltfDecoder::DecodeMaterialSpecularExtension( + const tinygltf::Material &input_material, Material *output_material) { + // Do nothing if extension is absent. + const auto &extension_it = + input_material.extensions.find("KHR_materials_specular"); + if (extension_it == input_material.extensions.end()) { + return OkStatus(); + } + + output_material->SetHasSpecular(true); + const tinygltf::Value::Object &extension_object = + extension_it->second.Get(); + + // Decode specular factor. + float value; + bool success; + DRACO_ASSIGN_OR_RETURN( + success, DecodeFloat("specularFactor", extension_object, &value)); + if (success) { + output_material->SetSpecularFactor(value); + } + + // Decode specular color factor. + Vector3f vector; + DRACO_ASSIGN_OR_RETURN(success, DecodeVector3f("specularColorFactor", + extension_object, &vector)); + if (success) { + output_material->SetSpecularColorFactor(vector); + } + + // Decode speclar texture. + DRACO_RETURN_IF_ERROR(DecodeTexture("specularTexture", TextureMap::SPECULAR, + extension_object, output_material)); + + // Decode specular color texture. + DRACO_RETURN_IF_ERROR(DecodeTexture("specularColorTexture", + TextureMap::SPECULAR_COLOR, + extension_object, output_material)); + + return OkStatus(); +} + +StatusOr GltfDecoder::DecodeFloat(const std::string &name, + const tinygltf::Value::Object &object, + float *value) { + const auto &it = object.find(name); + if (it == object.end()) { + return false; + } + const tinygltf::Value &number = it->second; + if (!number.IsNumber()) { + return Status(Status::DRACO_ERROR, "Invalid " + name + "."); + } + *value = number.Get(); + return true; +} + +StatusOr GltfDecoder::DecodeInt(const std::string &name, + const tinygltf::Value::Object &object, + int *value) { + const auto &it = object.find(name); + if (it == object.end()) { + return false; + } + const tinygltf::Value &number = it->second; + if (!number.IsNumber()) { + return ErrorStatus("Invalid " + name + "."); + } + *value = number.Get(); + return true; +} + +StatusOr GltfDecoder::DecodeString(const std::string &name, + const tinygltf::Value::Object &object, + std::string *value) { + const auto &it = object.find(name); + if (it == object.end()) { + return false; + } + const tinygltf::Value &string = it->second; + if (!string.IsString()) { + return ErrorStatus("Invalid " + name + "."); + } + *value = string.Get(); + return true; +} + +StatusOr GltfDecoder::DecodePropertyTableData( + const std::string &name, const tinygltf::Value::Object &object, + PropertyTable::Property::Data *data) { + int buffer_view_index; + DRACO_ASSIGN_OR_RETURN(const bool success, + DecodeInt(name, object, &buffer_view_index)); + if (!success) { + return false; + } + DRACO_RETURN_IF_ERROR( + CopyDataFromBufferView(gltf_model_, buffer_view_index, &data->data)); + data->target = gltf_model_.bufferViews[buffer_view_index].target; + return true; +} + +StatusOr GltfDecoder::DecodeVector3f( + const std::string &name, const tinygltf::Value::Object &object, + Vector3f *value) { + const auto &it = object.find(name); + if (it == object.end()) { + return false; + } + const tinygltf::Value &array = it->second; + if (!array.IsArray() || array.Size() != 3) { + return Status(Status::DRACO_ERROR, "Invalid " + name + "."); + } + for (int i = 0; i < array.Size(); i++) { + const tinygltf::Value &array_entry = array.Get(i); + if (!array_entry.IsNumber()) { + return Status(Status::DRACO_ERROR, "Invalid " + name + "."); + } + (*value)[i] = array_entry.Get(); + } + return true; +} + +Status GltfDecoder::DecodeTexture(const std::string &name, + TextureMap::Type type, + const tinygltf::Value::Object &object, + Material *material) { + tinygltf::TextureInfo info; + DRACO_RETURN_IF_ERROR(ParseTextureInfo(name, object, &info)); + DRACO_RETURN_IF_ERROR(CheckAndAddTextureToDracoMaterial( + info.index, info.texCoord, info.extensions, material, type)); + return OkStatus(); +} + +Status GltfDecoder::ParseTextureInfo( + const std::string &texture_name, + const tinygltf::Value::Object &container_object, + tinygltf::TextureInfo *texture_info) { + // Note that tinygltf only parses material textures and not material extension + // textures. This method mimics the behavior of tinygltf's private function + // ParseTextureInfo() in order for Draco to decode extension textures. + + // Do nothing if texture with such name is absent. + const auto &texture_object_it = container_object.find(texture_name); + if (texture_object_it == container_object.end()) { + return OkStatus(); + } + + const tinygltf::Value::Object &texture_object = + texture_object_it->second.Get(); + + // Decode texture index. + const auto &index_it = texture_object.find("index"); + if (index_it != texture_object.end()) { + const tinygltf::Value &value = index_it->second; + if (!value.IsNumber()) { + return Status(Status::DRACO_ERROR, "Invalid texture index."); + } + texture_info->index = value.Get(); + } + + // Decode texture coordinate index. + const auto &tex_coord_it = texture_object.find("texCoord"); + if (tex_coord_it != texture_object.end()) { + const tinygltf::Value &value = tex_coord_it->second; + if (!value.IsInt()) { + return Status(Status::DRACO_ERROR, "Invalid texture texCoord."); + } + texture_info->texCoord = value.Get(); + } + + // Decode texture extensions. + const auto &extensions_it = texture_object.find("extensions"); + if (extensions_it != texture_object.end()) { + const tinygltf::Value &extensions = extensions_it->second; + if (!extensions.IsObject()) { + return Status(Status::DRACO_ERROR, "Invalid extension."); + } + for (const std::string &key : extensions.Keys()) { + texture_info->extensions[key] = extensions.Get(key); + } + } + + // Decode texture extras. + const auto &extras_it = texture_object.find("extras"); + if (extras_it != texture_object.end()) { + texture_info->extras = extras_it->second; + } + + return OkStatus(); +} + +Status GltfDecoder::AddMaterialsToScene() { + for (int input_material_index = 0; + input_material_index < gltf_model_.materials.size(); + ++input_material_index) { + Material *const output_material = + scene_->GetMaterialLibrary().MutableMaterial(input_material_index); + DRACO_RETURN_IF_ERROR( + AddGltfMaterial(input_material_index, output_material)); + } + + // Check if we need to add a default material for primitives without an + // assigned material. + const int default_material_index = + scene_->GetMaterialLibrary().NumMaterials(); + bool default_material_needed = false; + for (MeshGroupIndex mgi(0); mgi < scene_->NumMeshGroups(); ++mgi) { + MeshGroup *const mg = scene_->GetMeshGroup(mgi); + for (int mi = 0; mi < mg->NumMeshInstances(); ++mi) { + MeshGroup::MeshInstance &mesh_instance = mg->GetMeshInstance(mi); + if (mesh_instance.material_index == -1) { + mesh_instance.material_index = default_material_index; + default_material_needed = true; + } + } + } + if (default_material_needed) { + // Create an empty default material (our defaults correspond to glTF + // defaults). + scene_->GetMaterialLibrary().MutableMaterial(default_material_index); + } + + std::unordered_set meshes_that_need_tangents; + // Check if we need to generate tangent space for any of the loaded meshes. + for (MeshGroupIndex mgi(0); mgi < scene_->NumMeshGroups(); ++mgi) { + const MeshGroup *const mg = scene_->GetMeshGroup(mgi); + for (int mi = 0; mi < mg->NumMeshInstances(); ++mi) { + const MeshGroup::MeshInstance &mesh_instance = mg->GetMeshInstance(mi); + const auto tangent_map = + scene_->GetMaterialLibrary() + .GetMaterial(mesh_instance.material_index) + ->GetTextureMapByType(TextureMap::NORMAL_TANGENT_SPACE); + if (tangent_map != nullptr) { + Mesh &mesh = scene_->GetMesh(mesh_instance.mesh_index); + if (mesh.GetNamedAttribute(GeometryAttribute::TANGENT) == nullptr) { + meshes_that_need_tangents.insert(&mesh); + } + } + } + } + + return OkStatus(); +} + +Status GltfDecoder::AddSkinsToScene() { + for (int source_skin_index = 0; source_skin_index < gltf_model_.skins.size(); + ++source_skin_index) { + const tinygltf::Skin &skin = gltf_model_.skins[source_skin_index]; + const SkinIndex skin_index = scene_->AddSkin(); + Skin *const new_skin = scene_->GetSkin(skin_index); + + // The skin index was set previously while processing the nodes. + if (skin_index.value() != source_skin_index) { + return Status(Status::DRACO_ERROR, "Skin indices are mismatched."); + } + + if (skin.inverseBindMatrices >= 0) { + const tinygltf::Accessor &accessor = + gltf_model_.accessors[skin.inverseBindMatrices]; + DRACO_RETURN_IF_ERROR(TinyGltfUtils::AddAccessorToAnimationData( + gltf_model_, accessor, &new_skin->GetInverseBindMatrices())); + } + + if (skin.skeleton >= 0) { + const auto it = gltf_node_to_scenenode_index_.find(skin.skeleton); + if (it == gltf_node_to_scenenode_index_.end()) { + // TODO(b/200317162): If skeleton is not found set the default. + return Status(Status::DRACO_ERROR, + "Could not find skeleton in the skin."); + } + new_skin->SetJointRoot(it->second); + } + + for (int joint : skin.joints) { + const auto it = gltf_node_to_scenenode_index_.find(joint); + if (it == gltf_node_to_scenenode_index_.end()) { + // TODO(b/200317162): If skeleton is not found set the default. + return Status(Status::DRACO_ERROR, + "Could not find skeleton in the skin."); + } + new_skin->AddJoint(it->second); + } + } + return OkStatus(); +} + +void GltfDecoder::MoveNonMaterialTextures(Mesh *mesh) { + std::unordered_set non_material_textures; + for (MeshFeaturesIndex i(0); i < mesh->NumMeshFeatures(); i++) { + Texture *const texture = mesh->GetMeshFeatures(i).GetTextureMap().texture(); + if (texture != nullptr) { + non_material_textures.insert(texture); + } + } + MoveNonMaterialTextures(non_material_textures, + &mesh->GetMaterialLibrary().MutableTextureLibrary(), + &mesh->GetNonMaterialTextureLibrary()); +} + +void GltfDecoder::MoveNonMaterialTextures(Scene *scene) { + std::unordered_set non_material_textures; + for (MeshIndex i(0); i < scene->NumMeshes(); i++) { + for (MeshFeaturesIndex j(0); j < scene->GetMesh(i).NumMeshFeatures(); j++) { + Texture *const texture = + scene->GetMesh(i).GetMeshFeatures(j).GetTextureMap().texture(); + if (texture != nullptr) { + non_material_textures.insert(texture); + } + } + } + MoveNonMaterialTextures(non_material_textures, + &scene->GetMaterialLibrary().MutableTextureLibrary(), + &scene->GetNonMaterialTextureLibrary()); +} + +void GltfDecoder::MoveNonMaterialTextures( + const std::unordered_set &non_material_textures, + TextureLibrary *material_tl, TextureLibrary *non_material_tl) { + // TODO(vytyaz): Consider textures that are both material and non-material. + for (int i = 0; i < material_tl->NumTextures(); i++) { + // Move non-material texture from material to non-material texture library. + if (non_material_textures.count(material_tl->GetTexture(i)) == 1) { + non_material_tl->PushTexture(material_tl->RemoveTexture(i--)); + } + } +} + +bool GltfDecoder::PrimitiveSignature::operator==( + const PrimitiveSignature &signature) const { + return primitive.indices == signature.primitive.indices && + primitive.attributes == signature.primitive.attributes && + primitive.extras == signature.primitive.extras && + primitive.extensions == signature.primitive.extensions && + primitive.mode == signature.primitive.mode && + primitive.targets == signature.primitive.targets; +} + +size_t GltfDecoder::PrimitiveSignature::Hash::operator()( + const PrimitiveSignature &signature) const { + size_t hash = 79; // Magic number. + hash = HashCombine(signature.primitive.attributes.size(), hash); + for (auto it = signature.primitive.attributes.begin(); + it != signature.primitive.attributes.end(); ++it) { + hash = HashCombine(it->first, hash); + hash = HashCombine(it->second, hash); + } + hash = HashCombine(signature.primitive.indices, hash); + hash = HashCombine(signature.primitive.mode, hash); + return hash; +} + +StatusOr> GltfDecoder::BuildMeshFromBuilder( + bool use_mesh_builder, TriangleSoupMeshBuilder *mb, PointCloudBuilder *pb) { + std::unique_ptr mesh; + if (use_mesh_builder) { + mesh = mb->Finalize(); + } else { + std::unique_ptr pc = pb->Finalize(true); + if (pc) { + mesh.reset(new Mesh()); + PointCloud *mesh_pc = mesh.get(); + mesh_pc->Copy(*pc); + } + } + if (!mesh) { + return ErrorStatus("Failed to build Draco mesh from glTF data."); + } + return mesh; +} + +} // namespace draco + +#endif // DRACO_TRANSCODER_SUPPORTED diff --git a/contrib/draco/src/draco/io/gltf_decoder.h b/contrib/draco/src/draco/io/gltf_decoder.h new file mode 100644 index 000000000..2ae12106e --- /dev/null +++ b/contrib/draco/src/draco/io/gltf_decoder.h @@ -0,0 +1,524 @@ +// Copyright 2018 The Draco Authors. +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. +// +#ifndef DRACO_IO_GLTF_DECODER_H_ +#define DRACO_IO_GLTF_DECODER_H_ + +#include "draco/draco_features.h" + +#ifdef DRACO_TRANSCODER_SUPPORTED +#include +#include +#include +#include +#include +#include + +#include "draco/core/decoder_buffer.h" +#include "draco/core/status.h" +#include "draco/core/status_or.h" +#include "draco/io/tiny_gltf_utils.h" +#include "draco/mesh/mesh.h" +#include "draco/mesh/triangle_soup_mesh_builder.h" +#include "draco/point_cloud/point_cloud_builder.h" +#include "draco/scene/scene.h" + +namespace draco { + +// Decodes a glTF file and returns a draco::Mesh. All of the |mesh|'s attributes +// will be merged into one draco::Mesh +class GltfDecoder { + public: + GltfDecoder(); + + // Decodes a glTF file stored in the input |file_name| or |buffer| to a Mesh. + // The second form returns a vector of files used as input to the mesh during + // the decoding process. Returns nullptr when decode fails. + StatusOr> DecodeFromFile(const std::string &file_name); + StatusOr> DecodeFromFile( + const std::string &file_name, std::vector *mesh_files); + StatusOr> DecodeFromBuffer(DecoderBuffer *buffer); + + // Decodes a glTF file stored in the input |file_name| or |buffer| to a Scene. + // The second form returns a vector of files used as input to the scene during + // the decoding process. Returns nullptr if the decode fails. + StatusOr> DecodeFromFileToScene( + const std::string &file_name); + StatusOr> DecodeFromFileToScene( + const std::string &file_name, std::vector *scene_files); + StatusOr> DecodeFromBufferToScene( + DecoderBuffer *buffer); + + // Scene graph can be loaded either as a tree or a general directed acyclic + // graph (DAG) that allows multiple parent nodes. By default. we decode the + // scene graph as a tree. If the tree mode is selected and the input contains + // nodes with multiple parents, these nodes are duplicated to form a tree. + // TODO(ostava): Add support for DAG mode to other parts of the Draco + // library. + enum class GltfSceneGraphMode { TREE, DAG }; + void SetSceneGraphMode(GltfSceneGraphMode mode) { + gltf_scene_graph_mode_ = mode; + } + + private: + // Loads |file_name| into |gltf_model_|. Fills |input_files| with paths to all + // input files when non-null. + Status LoadFile(const std::string &file_name, + std::vector *input_files); + + // Loads |gltf_model_| from |buffer| in GLB format. + Status LoadBuffer(const DecoderBuffer &buffer); + + // Builds mesh from |gltf_model_|. + StatusOr> BuildMesh(); + + // Checks |gltf_model_| for unsupported features. If |gltf_model_| contains + // unsupported features then the function will return with a status code of + // UNSUPPORTED_FEATURE. + Status CheckUnsupportedFeatures(); + + // Decodes a glTF Node as well as any child Nodes. If |node| contains a mesh + // it will process all of the mesh's primitives. + Status DecodeNode(int node_index, const Eigen::Matrix4d &parent_matrix); + + // Decodes the number of entries in the first attribute of a given glTF + // |primitive|. Note that all attributes have the same entry count according + // to glTF 2.0 spec. + StatusOr DecodePrimitiveAttributeCount( + const tinygltf::Primitive &primitive) const; + + // Decodes the number of indices in a given glTF |primitive|. If primitive's + // indices property is not defined, the index count is implied from the entry + // count of a primitive attribute. + StatusOr DecodePrimitiveIndicesCount( + const tinygltf::Primitive &primitive) const; + + // Decodes indices property of a given glTF |primitive|. If primitive's + // indices property is not defined, the indices are generated based on entry + // count of a primitive attribute. + StatusOr> DecodePrimitiveIndices( + const tinygltf::Primitive &primitive) const; + + // Decodes a glTF Primitive. All of the |primitive|'s attributes will be + // merged into the draco::Mesh output if they are of the same type that + // already has been decoded. + Status DecodePrimitive(const tinygltf::Primitive &primitive, + const Eigen::Matrix4d &transform_matrix); + + // Sums the number of elements per attribute for |node|'s mesh and any of + // |node|'s children. Fills out the material index map. + Status NodeGatherAttributeAndMaterialStats(const tinygltf::Node &node); + + // Sums the number of elements per attribute for all of the meshes and + // primitives. + Status GatherAttributeAndMaterialStats(); + + // Sums the attribute counts into total_attribute_counts_. + void SumAttributeStats(const std::string &attribute_name, int count); + + // Checks that all the same glTF attribute types in different meshes and + // primitives contain the same characteristics. + Status CheckTypes(const std::string &attribute_name, int component_type, + int type, bool normalized); + + // Accumulates the number of elements per attribute for |primitive|. + Status AccumulatePrimitiveStats(const tinygltf::Primitive &primitive); + + // Adds all of the attributes from the glTF file to a Draco mesh. + // GatherAttributeAndMaterialStats() must be called before this function. The + // GeometryAttribute::MATERIAL attribute will be created only if the glTF file + // contains more than one material. + template + Status AddAttributesToDracoMesh(BuilderT *builder); + + // Copies attribute data from |accessor| and adds it to a Draco mesh using the + // geometry builder |builder|. + template + Status AddAttributeValuesToBuilder(const std::string &attribute_name, + const tinygltf::Accessor &accessor, + const std::vector &indices_data, + int att_id, int number_of_elements, + const Eigen::Matrix4d &transform_matrix, + BuilderT *builder); + + // Copies the tangent attribute data from |accessor| and adds it to a Draco + // mesh. This function will transform all of the data by |transform_matrix| + // and then normalize before adding the data to the Draco mesh. + // |indices_data| is the indices data from the glTF file. |att_id| is the + // attribute id of the tangent attribute in the Draco mesh. + // |number_of_elements| is the number of faces or points this function will + // process. |reverse_winding| if set will change the orientation of the data. + template + Status AddTangentToBuilder(const tinygltf::Accessor &accessor, + const std::vector &indices_data, + int att_id, int number_of_elements, + const Eigen::Matrix4d &transform_matrix, + bool reverse_winding, BuilderT *builder); + + // Copies the texture coordinate attribute data from |accessor| and adds it to + // a Draco mesh. This function will flip the data on the horizontal axis as + // Draco meshes store the texture coordinates differently than glTF. + // |indices_data| is the indices data from the glTF file. |att_id| is the + // attribute id of the texture coordinate attribute in the Draco mesh. + // |number_of_elements| is the number of faces or points this function will + // process. |reverse_winding| if set will change the orientation of the data. + template + Status AddTexCoordToBuilder(const tinygltf::Accessor &accessor, + const std::vector &indices_data, + int att_id, int number_of_elements, + bool reverse_winding, BuilderT *builder); + + // Copies the mesh feature ID attribute data from |accessor| and adds it to a + // Draco mesh. |indices_data| is the indices data from the glTF file. |att_id| + // is the attribute ID of the mesh feature ID attribute in the Draco mesh. + // |number_of_elements| is the number of faces or points this function will + // process. |reverse_winding| if set will change the orientation of the data. + template + Status AddFeatureIdToBuilder(const tinygltf::Accessor &accessor, + const std::vector &indices_data, + int att_id, int number_of_elements, + bool reverse_winding, + const std::string &attribute_name, + BuilderT *builder); + + // Copies the attribute data from |accessor| and adds it to a Draco mesh. + // This function will transform all of the data by |transform_matrix| before + // adding the data to the Draco mesh. |indices_data| is the indices data + // from the glTF file. |att_id| is the attribute id of the attribute in the + // Draco mesh. |number_of_elements| is the number of faces or points this + // function will process. |normalize| if set will normalize all of the vector + // data after transformation. |reverse_winding| if set will change the + // orientation of the data. + template + Status AddTransformedDataToBuilder(const tinygltf::Accessor &accessor, + const std::vector &indices_data, + int att_id, int number_of_elements, + const Eigen::Matrix4d &transform_matrix, + bool normalize, bool reverse_winding, + BuilderT *builder); + + // Sets values in |data| into the builder |builder| for |att_id|. + template + void SetValuesForBuilder(const std::vector &indices_data, + int att_id, int number_of_elements, + const std::vector &data, bool reverse_winding, + TriangleSoupMeshBuilder *builder); + template + void SetValuesForBuilder(const std::vector &indices_data, + int att_id, int number_of_elements, + const std::vector &data, bool reverse_winding, + PointCloudBuilder *builder); + + // Sets values in |data| into the mesh builder |mb| for |att_id|. + // |reverse_winding| if set will change the orientation of the data. + template + void SetValuesPerFace(const std::vector &indices_data, int att_id, + int number_of_faces, const std::vector &data, + bool reverse_winding, TriangleSoupMeshBuilder *mb); + + // Returns an address pointing to the content stored in |data|. This is used + // when passing values to mesh / point cloud builder when the input type can + // be either a VectorD or an arithmetic type. + template + const void *GetDataContentAddress(const T &data) const; + + // Adds the attribute data in |accessor| to |mb| for unique attribute + // |att_id|. |indices_data| is the mesh's indices data. |reverse_winding| if + // set will change the orientation of the data. + template + Status AddAttributeDataByTypes(const tinygltf::Accessor &accessor, + const std::vector &indices_data, + int att_id, int number_of_elements, + bool reverse_winding, BuilderT *builder); + + // Adds the textures to |owner|. + template + Status CopyTextures(T *owner); + + // Sets extra attribute properties on a constructed draco mesh. + void SetAttributePropertiesOnDracoMesh(Mesh *mesh); + + // Adds the materials to |mesh|. + Status AddMaterialsToDracoMesh(Mesh *mesh); + + // Adds the material data for the GeometryAttribute::MATERIAL attribute to the + // Draco mesh. + template + Status AddMaterialDataToBuilder(int material_value, int number_of_elements, + BuilderT *builder); + template + Status AddMaterialDataToBuilderInternal(T material_value, int number_of_faces, + TriangleSoupMeshBuilder *builder); + template + Status AddMaterialDataToBuilderInternal(T material_value, + int number_of_points, + PointCloudBuilder *builder); + + // Checks if the glTF file contains a texture. If there is a texture, this + // function will read the texture data and add it to the Draco |material|. If + // there is no texture, this function will return OkStatus(). |texture_info| + // is the data structure containing information about the texture in the glTF + // file. |type| is the type of texture defined by Draco. This is not the same + // as the texture coordinate attribute id. + Status CheckAndAddTextureToDracoMaterial( + int texture_index, int tex_coord_attribute_index, + const tinygltf::ExtensionMap &tex_info_ext, Material *material, + TextureMap::Type type); + + // Decode glTF file to scene. + Status DecodeGltfToScene(); + + // Decode glTF lights into a scene. + Status AddLightsToScene(); + + // Decodes glTF materials variants names into a scene. + Status AddMaterialsVariantsNamesToScene(); + + // Decode glTF animations into a scene. All of the glTF nodes must be decoded + // to the scene before this function is called. + Status AddAnimationsToScene(); + + // Decode glTF node into a Draco scene. |parent_index| is the index of the + // parent node. If |node| is a root node set |parent_index| to + // |kInvalidSceneNodeIndex|. All glTF lights must be decoded to the scene + // before this function is called. + Status DecodeNodeForScene(int node_index, SceneNodeIndex parent_index); + + // Decode glTF primitive into a Draco scene. + Status DecodePrimitiveForScene(const tinygltf::Primitive &primitive, + MeshGroup *mesh_group); + + // Decodes glTF materials variants from |extension| and adds it into materials + // variants |mappings|. Before calling this function, all materials variants + // names must be decoded by calling AddMaterialsVariantsNamesToScene(). + Status DecodeMaterialsVariantsMappings( + const tinygltf::Value::Object &extension, + std::vector *mappings); + + // Decodes glTF mesh feature ID sets from all glTF primitives and adds them to + // |mesh|. + Status AddMeshFeaturesToDracoMesh(Mesh *mesh); + + // Decodes glTF mesh feature ID sets from glTF primitive in glTF node at + // |node_index| and adds them to |mesh|. + Status AddMeshFeaturesToDracoMesh(int node_index, Mesh *mesh); + + // Decodes glTF structural metadata from glTF model and adds it to |geometry|. + template + Status AddStructuralMetadataToGeometry(GeometryT *geometry); + + // Decodes glTF mesh feature ID sets from |primitive| and adds them to |mesh|. + Status DecodeMeshFeatures(const tinygltf::Primitive &primitive, + TextureLibrary *texture_library, Mesh *mesh); + + // Decodes glTF mesh feature ID sets from |extension| and adds them to the + // |mesh_features| vector. + Status DecodeMeshFeatures( + const tinygltf::Value::Object &extension, TextureLibrary *texture_library, + std::vector> *mesh_features); + + // Adds an attribute of type |attribute_name| to |builder|. Returns the + // attribute id. + template + StatusOr AddAttribute(const std::string &attribute_name, + int component_type, int type, BuilderT *builder); + + // Adds an attribute of |attribute_type| to |builder|. Returns the attribute + // id. + template + StatusOr AddAttribute(GeometryAttribute::Type attribute_type, + int component_type, int type, BuilderT *builder); + + // Returns true if the KHR_texture_transform extension is set in |extension|. + // If the KHR_texture_transform extension is set then the values are returned + // in |transform|. + StatusOr CheckKhrTextureTransform( + const tinygltf::ExtensionMap &extension, TextureTransform *transform); + + // Adds glTF material |input_material_index| to |output_material|. + Status AddGltfMaterial(int input_material_index, Material *output_material); + + // Adds unlit property from glTF |input_material| to |output_material|. + void DecodeMaterialUnlitExtension(const tinygltf::Material &input_material, + Material *output_material); + + // Adds sheen properties from glTF |input_material| to |output_material|. + Status DecodeMaterialSheenExtension(const tinygltf::Material &input_material, + Material *output_material); + + // Adds transmission from glTF |input_material| to |output_material|. + Status DecodeMaterialTransmissionExtension( + const tinygltf::Material &input_material, Material *output_material); + + // Adds clearcoat properties from glTF |input_material| to |output_material|. + Status DecodeMaterialClearcoatExtension( + const tinygltf::Material &input_material, Material *output_material); + + // Adds volume properties from glTF |input_material| to |output_material|. + Status DecodeMaterialVolumeExtension(const tinygltf::Material &input_material, + int input_material_index, + Material *output_material); + + // Adds ior properties from glTF |input_material| to |output_material|. + Status DecodeMaterialIorExtension(const tinygltf::Material &input_material, + Material *output_material); + + // Adds specular properties from glTF |input_material| to |output_material|. + Status DecodeMaterialSpecularExtension( + const tinygltf::Material &input_material, Material *output_material); + + // Decodes a float value with |name| from |object| to |value| and returns true + // if a well-formed value with such |name| is present. + static StatusOr DecodeFloat(const std::string &name, + const tinygltf::Value::Object &object, + float *value); + + // Decodes an integer value with |name| from |object| to |value| and returns + // true if a well-formed value with such |name| is present. + static StatusOr DecodeInt(const std::string &name, + const tinygltf::Value::Object &object, + int *value); + + // Decodes a string value with |name| from |object| to |value| and returns + // true if a well-formed value with such |name| is present. + static StatusOr DecodeString(const std::string &name, + const tinygltf::Value::Object &object, + std::string *value); + + // Decodes data and data target from buffer view index with |name| in |object| + // to |data| and returns true if a well-formed data is present. + StatusOr DecodePropertyTableData(const std::string &name, + const tinygltf::Value::Object &object, + PropertyTable::Property::Data *data); + + // Decodes a 3D vector with |name| from |object| to |value| and returns true + // if a well-formed vector with such |name| is present. + static StatusOr DecodeVector3f(const std::string &name, + const tinygltf::Value::Object &object, + Vector3f *value); + + // Decodes a texture with |name| from |object| and adds it to |material| as a + // texture map of |type|. + Status DecodeTexture(const std::string &name, TextureMap::Type type, + const tinygltf::Value::Object &object, + Material *material); + + // Reads texture with |texture_name| from |container_object| into + // |texture_info|. + static Status ParseTextureInfo( + const std::string &texture_name, + const tinygltf::Value::Object &container_object, + tinygltf::TextureInfo *texture_info); + + // Adds the materials to the scene. + Status AddMaterialsToScene(); + + // Adds the skins to the scene. + Status AddSkinsToScene(); + + // All material and non-material textures (e.g., from EXT_mesh_features) are + // initially loaded into a texture library inside the the material library. + // These methods move |non_material_textures| from material texture library + // |material_tl| to non-material texture library |non_material_tl|. + static void MoveNonMaterialTextures(Mesh *mesh); + static void MoveNonMaterialTextures(Scene *scene); + static void MoveNonMaterialTextures( + const std::unordered_set &non_material_textures, + TextureLibrary *material_tl, TextureLibrary *non_material_tl); + + // Builds and returns a mesh constructed from either mesh builder |mb| or + // point cloud builder |pb|. Mesh builder is used if |use_mesh_builder| is set + // to true. + static StatusOr> BuildMeshFromBuilder( + bool use_mesh_builder, TriangleSoupMeshBuilder *mb, + PointCloudBuilder *pb); + + // Map of glTF Mesh to Draco scene mesh group. + std::map gltf_mesh_to_scene_mesh_group_; + + // Data structure that stores the glTF data. + tinygltf::Model gltf_model_; + + // Path to the glTF file. + std::string input_file_name_; + + // Class used to build the Draco mesh. + TriangleSoupMeshBuilder mb_; + PointCloudBuilder pb_; + + // Next face index used when adding attribute data to the Draco mesh. + int next_face_id_; + + // Next point index used when adding attribute data to the point cloud. + int next_point_id_; + + // Total number of indices from all the meshes and primitives. + int total_face_indices_count_; + int total_point_indices_count_; + + // This is the id of the GeometryAttribute::MATERIAL attribute added to the + // Draco mesh. + int material_att_id_; + + // Data used when decoding the entire glTF asset into a single draco::Mesh. + // The struct tracks the total number of elements across all matching + // attributes and it ensures all matching attributes are compatible. + struct MeshAttributeData { + int component_type = 0; + int attribute_type = 0; + bool normalized = false; + int total_attribute_counts = 0; + }; + + // Map of glTF attribute name to attribute component type. + std::map mesh_attribute_data_; + + // Map of glTF attribute name to Draco mesh attribute id. + std::map attribute_name_to_draco_mesh_attribute_id_; + + // Map of glTF material to Draco material index. + std::map gltf_primitive_material_to_draco_material_; + + // Map of glTF material index to transformation scales of primitives. + std::map> gltf_primitive_material_to_scales_; + + // Map of glTF image to Draco textures. + std::map gltf_image_to_draco_texture_; + + std::unique_ptr scene_; + + // Map of glTF Node to local store order. + std::map gltf_node_to_scenenode_index_; + + // Selected mode of the decoded scene graph. + GltfSceneGraphMode gltf_scene_graph_mode_ = GltfSceneGraphMode::TREE; + + // Functionality for deduping primitives on decode. + struct PrimitiveSignature { + const tinygltf::Primitive &primitive; + explicit PrimitiveSignature(const tinygltf::Primitive &primitive) + : primitive(primitive) {} + bool operator==(const PrimitiveSignature &signature) const; + struct Hash { + size_t operator()(const PrimitiveSignature &signature) const; + }; + }; + std::unordered_map + gltf_primitive_to_draco_mesh_index_; +}; + +} // namespace draco + +#endif // DRACO_TRANSCODER_SUPPORTED +#endif // DRACO_IO_GLTF_DECODER_H_ diff --git a/contrib/draco/src/draco/io/gltf_decoder_test.cc b/contrib/draco/src/draco/io/gltf_decoder_test.cc new file mode 100644 index 000000000..fade3ee26 --- /dev/null +++ b/contrib/draco/src/draco/io/gltf_decoder_test.cc @@ -0,0 +1,1402 @@ +// Copyright 2018 The Draco Authors. +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. +// +#include "draco/io/gltf_decoder.h" + +#include +#include +#include +#include +#include +#include + +#include "draco/material/material_library.h" +#include "draco/scene/mesh_group.h" + +#ifdef DRACO_TRANSCODER_SUPPORTED +#include "draco/core/constants.h" +#include "draco/core/draco_test_base.h" +#include "draco/core/draco_test_utils.h" +#include "draco/core/draco_types.h" +#include "draco/io/gltf_test_helper.h" +#include "draco/io/texture_io.h" +#include "draco/mesh/mesh_are_equivalent.h" +#include "draco/mesh/mesh_utils.h" +#include "draco/scene/scene_indices.h" +#include "draco/scene/scene_utils.h" +#include "draco/texture/texture_utils.h" + +namespace draco { + +namespace { +std::unique_ptr DecodeGltfFile(const std::string &file_name) { + const std::string path = GetTestFileFullPath(file_name); + GltfDecoder decoder; + + auto maybe_geometry = decoder.DecodeFromFile(path); + if (!maybe_geometry.ok()) { + return nullptr; + } + std::unique_ptr geometry = std::move(maybe_geometry).value(); + return geometry; +} + +std::unique_ptr DecodeGltfFileToScene(const std::string &file_name) { + const std::string path = GetTestFileFullPath(file_name); + GltfDecoder decoder; + + auto maybe_scene = decoder.DecodeFromFileToScene(path); + if (!maybe_scene.ok()) { + return nullptr; + } + std::unique_ptr scene = std::move(maybe_scene).value(); + return scene; +} + +void CompareVectorArray(const std::array &a, + const std::array &b) { + for (int v = 0; v < 3; ++v) { + for (int c = 0; c < 3; ++c) { + EXPECT_FLOAT_EQ(a[v][c], b[v][c]) << "v:" << v << " c:" << c; + } + } +} +} // namespace + +// Tests multiple textures. +TEST(GltfDecoderTest, SphereGltf) { + const std::string file_name = "sphere.gltf"; + const std::unique_ptr mesh(DecodeGltfFile(file_name)); + EXPECT_EQ(mesh->num_attributes(), 4) << "Unexpected number of attributes."; + EXPECT_EQ(mesh->num_points(), 231) << "Unexpected number of vertices."; + EXPECT_EQ(mesh->num_faces(), 224) << "Unexpected number of faces."; + ASSERT_EQ(mesh->GetMaterialLibrary().NumMaterials(), 1); + ASSERT_EQ(mesh->GetMaterialLibrary().GetMaterial(0)->NumTextureMaps(), 2); +} + +TEST(GltfDecoderTest, TriangleGltf) { + const std::string file_name = "one_face_123.gltf"; + const std::unique_ptr mesh(DecodeGltfFile(file_name)); + EXPECT_EQ(mesh->num_attributes(), 1) << "Unexpected number of attributes."; + EXPECT_EQ(mesh->num_points(), 3) << "Unexpected number of vertices."; + EXPECT_EQ(mesh->num_faces(), 1) << "Unexpected number of faces."; + ASSERT_EQ(mesh->GetMaterialLibrary().NumMaterials(), 1); + ASSERT_EQ(mesh->GetMaterialLibrary().GetMaterial(0)->NumTextureMaps(), 0); + + const auto *const pos_attribute = + mesh->GetNamedAttribute(GeometryAttribute::POSITION); + EXPECT_NE(pos_attribute, nullptr); + const auto &face = mesh->face(FaceIndex(0)); + std::array pos; + for (int c = 0; c < 3; ++c) { + pos_attribute->GetMappedValue(face[c], &pos[c][0]); + } + + // Test position values match. + std::array pos_test; + pos_test[0] = Vector3f(1, 0.0999713, 0); + pos_test[1] = Vector3f(2.00006104, 0.01, 0); + pos_test[2] = Vector3f(3, 0.10998169, 0); + CompareVectorArray(pos, pos_test); +} + +TEST(GltfDecoderTest, MirroredTriangleGltf) { + const std::string file_name = "one_face_123_mirror.gltf"; + const std::unique_ptr mesh(DecodeGltfFile(file_name)); + EXPECT_EQ(mesh->num_attributes(), 1) << "Unexpected number of attributes."; + EXPECT_EQ(mesh->num_points(), 3) << "Unexpected number of vertices."; + EXPECT_EQ(mesh->num_faces(), 1) << "Unexpected number of faces."; + ASSERT_EQ(mesh->GetMaterialLibrary().NumMaterials(), 1); + ASSERT_EQ(mesh->GetMaterialLibrary().GetMaterial(0)->NumTextureMaps(), 0); + + const auto *const pos_attribute = + mesh->GetNamedAttribute(GeometryAttribute::POSITION); + EXPECT_NE(pos_attribute, nullptr); + const auto &face = mesh->face(FaceIndex(0)); + std::array pos; + for (int c = 0; c < 3; ++c) { + pos_attribute->GetMappedValue(face[c], &pos[c][0]); + } + + // Test position values match. + std::array pos_test; + pos_test[0] = Vector3f(-1, -0.0999713, 0); + pos_test[1] = Vector3f(-3, -0.10998169, 0); + pos_test[2] = Vector3f(-2.00006104, -0.01, 0); + CompareVectorArray(pos, pos_test); +} + +TEST(GltfDecoderTest, TranslateTriangleGltf) { + const std::string file_name = "one_face_123_translated.gltf"; + const std::unique_ptr mesh(DecodeGltfFile(file_name)); + EXPECT_EQ(mesh->num_attributes(), 1) << "Unexpected number of attributes."; + EXPECT_EQ(mesh->num_points(), 3) << "Unexpected number of vertices."; + EXPECT_EQ(mesh->num_faces(), 1) << "Unexpected number of faces."; + ASSERT_EQ(mesh->GetMaterialLibrary().NumMaterials(), 1); + ASSERT_EQ(mesh->GetMaterialLibrary().GetMaterial(0)->NumTextureMaps(), 0); + + const auto *const pos_attribute = + mesh->GetNamedAttribute(GeometryAttribute::POSITION); + EXPECT_NE(pos_attribute, nullptr); + const auto &face = mesh->face(FaceIndex(0)); + std::array pos; + for (int c = 0; c < 3; ++c) { + pos_attribute->GetMappedValue(face[c], &pos[c][0]); + } + + // Test position values match. The glTF file contains a matrix in the main + // node. The matrix defines a translation of (-1.5, 5.0, 2.3). + std::array pos_test; + pos_test[0] = Vector3f(1, 0.0999713, 0); + pos_test[1] = Vector3f(2.00006104, 0.01, 0); + pos_test[2] = Vector3f(3, 0.10998169, 0); + const Vector3f translate(-1.5, 5.0, 2.3); + for (int v = 0; v < 3; ++v) { + pos_test[v] = pos_test[v] + translate; + } + CompareVectorArray(pos, pos_test); +} + +// Tests multiple materials. +TEST(GltfDecoderTest, MilkTruckGltf) { + const std::string file_name = "CesiumMilkTruck/glTF/CesiumMilkTruck.gltf"; + const std::unique_ptr mesh(DecodeGltfFile(file_name)); + EXPECT_EQ(mesh->num_attributes(), 4) << "Unexpected number of attributes."; + EXPECT_EQ(mesh->num_points(), 3564) << "Unexpected number of vertices."; + EXPECT_EQ(mesh->num_faces(), 3624) << "Unexpected number of faces."; + ASSERT_EQ(mesh->GetMaterialLibrary().NumMaterials(), 4); + ASSERT_EQ(mesh->GetMaterialLibrary().GetMaterial(0)->NumTextureMaps(), 1); + ASSERT_EQ(mesh->GetMaterialLibrary().GetMaterial(1)->NumTextureMaps(), 0); + ASSERT_EQ(mesh->GetMaterialLibrary().GetMaterial(2)->NumTextureMaps(), 0); + ASSERT_EQ(mesh->GetMaterialLibrary().GetMaterial(3)->NumTextureMaps(), 1); + ASSERT_EQ(mesh->GetMaterialLibrary().GetMaterial(0)->GetName(), "truck"); + ASSERT_EQ(mesh->GetMaterialLibrary().GetMaterial(1)->GetName(), "glass"); + ASSERT_EQ(mesh->GetMaterialLibrary().GetMaterial(2)->GetName(), + "window_trim"); + ASSERT_EQ(mesh->GetMaterialLibrary().GetMaterial(3)->GetName(), "wheels"); +} + +TEST(GltfDecoderTest, SceneMilkTruckGltf) { + const std::string file_name = "CesiumMilkTruck/glTF/CesiumMilkTruck.gltf"; + const std::unique_ptr scene(DecodeGltfFileToScene(file_name)); + + ASSERT_EQ(scene->NumMeshes(), 4); + ASSERT_EQ(scene->NumMeshGroups(), 2); + ASSERT_EQ(scene->NumNodes(), 5); + ASSERT_EQ(scene->NumRootNodes(), 1); + ASSERT_EQ(scene->NumLights(), 0); + ASSERT_EQ(scene->GetMaterialLibrary().NumMaterials(), 4); + ASSERT_EQ(scene->GetMaterialLibrary().GetMaterial(0)->NumTextureMaps(), 1); + ASSERT_EQ(scene->GetMaterialLibrary().GetMaterial(1)->NumTextureMaps(), 0); + ASSERT_EQ(scene->GetMaterialLibrary().GetMaterial(2)->NumTextureMaps(), 0); + ASSERT_EQ(scene->GetMaterialLibrary().GetMaterial(3)->NumTextureMaps(), 1); + ASSERT_EQ(scene->GetMaterialLibrary().GetMaterial(0)->GetName(), "truck"); + ASSERT_EQ(scene->GetMaterialLibrary().GetMaterial(1)->GetName(), "glass"); + ASSERT_EQ(scene->GetMaterialLibrary().GetMaterial(2)->GetName(), + "window_trim"); + ASSERT_EQ(scene->GetMaterialLibrary().GetMaterial(3)->GetName(), "wheels"); + ASSERT_EQ(scene->NumAnimations(), 1); + ASSERT_EQ(scene->NumSkins(), 0); + for (AnimationIndex i(0); i < scene->NumAnimations(); ++i) { + const Animation *const animation = scene->GetAnimation(i); + ASSERT_NE(animation, nullptr); + ASSERT_EQ(animation->NumSamplers(), 2); + ASSERT_EQ(animation->NumChannels(), 2); + } + + ASSERT_EQ(scene->GetMeshGroup(MeshGroupIndex(0))->GetName(), + "Cesium_Milk_Truck"); + ASSERT_EQ(scene->GetMeshGroup(MeshGroupIndex(1))->GetName(), "Wheels"); + + // Check all of the meshes do not have any materials. + for (MeshIndex i(0); i < scene->NumMeshes(); ++i) { + const Mesh &mesh = scene->GetMesh(i); + ASSERT_EQ(mesh.GetMaterialLibrary().NumMaterials(), 0); + } +} + +TEST(GltfDecoderTest, AnimatedBonesGltf) { + const std::string file_name = "CesiumMan/glTF/CesiumMan.gltf"; + const std::unique_ptr scene(DecodeGltfFileToScene(file_name)); + + ASSERT_EQ(scene->NumMeshes(), 1); + ASSERT_EQ(scene->NumMeshGroups(), 1); + const MeshGroup &mesh_group = *scene->GetMeshGroup(MeshGroupIndex(0)); + ASSERT_EQ(mesh_group.NumMeshInstances(), 1); + ASSERT_EQ(mesh_group.GetMeshInstance(0).material_index, 0); + ASSERT_EQ(scene->NumNodes(), 22); + ASSERT_EQ(scene->NumRootNodes(), 1); + ASSERT_EQ(scene->GetMaterialLibrary().NumMaterials(), 1); + ASSERT_EQ(scene->GetMaterialLibrary().GetMaterial(0)->NumTextureMaps(), 1); + ASSERT_EQ(scene->NumAnimations(), 1); + ASSERT_EQ(scene->NumSkins(), 1); + for (AnimationIndex i(0); i < scene->NumAnimations(); ++i) { + const Animation *const animation = scene->GetAnimation(i); + ASSERT_NE(animation, nullptr); + ASSERT_EQ(animation->NumSamplers(), 57); + ASSERT_EQ(animation->NumChannels(), 57); + } + + // Check all of the meshes do not have any materials. + for (MeshIndex i(0); i < scene->NumMeshes(); ++i) { + const Mesh &mesh = scene->GetMesh(i); + ASSERT_EQ(mesh.GetMaterialLibrary().NumMaterials(), 0); + } +} + +TEST(GltfDecoderTest, AnimatedBonesGlb) { + const std::string file_name = "CesiumMan/glTF_Binary/CesiumMan.glb"; + const std::unique_ptr scene(DecodeGltfFileToScene(file_name)); + ASSERT_EQ(scene->NumMeshes(), 1); + ASSERT_EQ(scene->NumMeshGroups(), 1); + const MeshGroup &mesh_group = *scene->GetMeshGroup(MeshGroupIndex(0)); + ASSERT_EQ(mesh_group.NumMeshInstances(), 1); + ASSERT_EQ(mesh_group.GetMeshInstance(0).material_index, 0); + ASSERT_EQ(scene->NumNodes(), 22); + ASSERT_EQ(scene->NumRootNodes(), 1); + ASSERT_EQ(scene->GetMaterialLibrary().NumMaterials(), 1); + ASSERT_EQ(scene->GetMaterialLibrary().GetMaterial(0)->NumTextureMaps(), 1); + ASSERT_EQ(scene->NumAnimations(), 1); + ASSERT_EQ(scene->NumSkins(), 1); + for (AnimationIndex i(0); i < scene->NumAnimations(); ++i) { + const Animation *const animation = scene->GetAnimation(i); + ASSERT_NE(animation, nullptr); + ASSERT_EQ(animation->NumSamplers(), 57); + ASSERT_EQ(animation->NumChannels(), 57); + } + + // Check all of the meshes do not have any materials. + for (MeshIndex i(0); i < scene->NumMeshes(); ++i) { + const Mesh &mesh = scene->GetMesh(i); + ASSERT_EQ(mesh.GetMaterialLibrary().NumMaterials(), 0); + } +} + +// Tests multiple primitives with the same material index. +TEST(GltfDecoderTest, LanternGltf) { + const std::string file_name = "Lantern/glTF/Lantern.gltf"; + const std::unique_ptr mesh(DecodeGltfFile(file_name)); + + EXPECT_EQ(mesh->num_attributes(), 4) << "Unexpected number of attributes."; + EXPECT_EQ(mesh->num_points(), 4145) << "Unexpected number of vertices."; + EXPECT_EQ(mesh->num_faces(), 5394) << "Unexpected number of faces."; + ASSERT_EQ(mesh->GetMaterialLibrary().NumMaterials(), 1); + ASSERT_EQ(mesh->GetMaterialLibrary().GetMaterial(0)->NumTextureMaps(), 4); +} + +// Tests COLOR_0 input attribute. +TEST(GltfDecoderTest, ColorAttributeGltf) { + const std::string file_name = "test_pos_color.gltf"; + const std::unique_ptr mesh(DecodeGltfFile(file_name)); + EXPECT_EQ(mesh->num_attributes(), 2) << "Unexpected number of attributes."; + EXPECT_EQ(mesh->num_points(), 114) << "Unexpected number of vertices."; + EXPECT_EQ(mesh->num_faces(), 224) << "Unexpected number of faces."; + ASSERT_EQ(mesh->GetMaterialLibrary().NumMaterials(), 1); + ASSERT_EQ(mesh->GetMaterialLibrary().GetMaterial(0)->NumTextureMaps(), 0); + ASSERT_NE(mesh->GetNamedAttribute(GeometryAttribute::COLOR), nullptr); + ASSERT_EQ(mesh->GetNamedAttribute(GeometryAttribute::COLOR)->data_type(), + draco::DT_UINT8); + // Ensure the normalized property for the color attribute is set properly. + ASSERT_TRUE(mesh->GetNamedAttribute(GeometryAttribute::COLOR)->normalized()); +} + +// Tests COLOR_0 input attribute when the asset is loaded into a scene. +TEST(GltfDecoderTest, ColorAttributeGltfScene) { + const std::string file_name = "test_pos_color.gltf"; + const std::unique_ptr scene(DecodeGltfFileToScene(file_name)); + ASSERT_EQ(scene->NumMeshes(), 1); + const Mesh &mesh = scene->GetMesh(MeshIndex(0)); + ASSERT_NE(mesh.GetNamedAttribute(GeometryAttribute::COLOR), nullptr); + ASSERT_EQ(mesh.GetNamedAttribute(GeometryAttribute::COLOR)->data_type(), + draco::DT_UINT8); + // Ensure the normalized property for the color attribute is set properly. + ASSERT_TRUE(mesh.GetNamedAttribute(GeometryAttribute::COLOR)->normalized()); +} + +// Tests a mesh with two sets of texture coordinates. +TEST(GltfDecoderTest, TwoTexCoordAttributesGltf) { + const std::string file_name = "sphere_two_tex_coords.gltf"; + const std::unique_ptr mesh(DecodeGltfFile(file_name)); + ASSERT_NE(mesh, nullptr); + ASSERT_EQ(mesh->NumNamedAttributes(GeometryAttribute::TEX_COORD), 2); +} + +// Tests an input with a valid tangent attribute does not auto generate the +// tangent attribute. +TEST(GltfDecoderTest, TestSceneWithTangents) { + const std::string file_name = "Lantern/glTF/Lantern.gltf"; + const std::unique_ptr scene(DecodeGltfFileToScene(file_name)); + ASSERT_NE(scene, nullptr); + + // Ensure no mesh has auto-generated tangents (and that some meshes have the + // tangent attribute). + int num_tangent_attributes = 0; + for (MeshIndex mi(0); mi < scene->NumMeshes(); ++mi) { + if (scene->GetMesh(mi).GetNamedAttribute(GeometryAttribute::TANGENT) != + nullptr) { + num_tangent_attributes++; + ASSERT_FALSE(MeshUtils::HasAutoGeneratedTangents(scene->GetMesh(mi))); + } + } + ASSERT_GT(num_tangent_attributes, 0); +} + +// Tests an input file where multiple textures share the same image asset. +TEST(GltfDecoderTest, SharedImages) { + const std::string file_name = "SphereAllSame/sphere_texture_all.gltf"; + const std::unique_ptr mesh(DecodeGltfFile(file_name)); + ASSERT_NE(mesh, nullptr); + ASSERT_EQ(mesh->GetMaterialLibrary().NumMaterials(), 1); + ASSERT_EQ(mesh->GetMaterialLibrary().GetMaterial(0)->NumTextureMaps(), 5); + ASSERT_EQ(mesh->GetMaterialLibrary().GetTextureLibrary().NumTextures(), 4); +} + +TEST(GltfDecoderTest, TextureNamesAreNotEmpty) { + const std::string file_name = "SphereAllSame/sphere_texture_all.gltf"; + const std::unique_ptr mesh(DecodeGltfFile(file_name)); + ASSERT_NE(mesh, nullptr); + ASSERT_EQ(mesh->GetMaterialLibrary().NumMaterials(), 1); + ASSERT_EQ(mesh->GetMaterialLibrary().GetMaterial(0)->NumTextureMaps(), 5); + ASSERT_EQ(mesh->GetMaterialLibrary().GetTextureLibrary().NumTextures(), 4); + const std::vector textures = { + mesh->GetMaterialLibrary().GetTextureLibrary().GetTexture(0), + mesh->GetMaterialLibrary().GetTextureLibrary().GetTexture(1), + mesh->GetMaterialLibrary().GetTextureLibrary().GetTexture(2), + mesh->GetMaterialLibrary().GetTextureLibrary().GetTexture(3)}; + EXPECT_EQ(TextureUtils::GetTargetStem(*textures[0]), "256x256_all_orange"); + EXPECT_EQ(TextureUtils::GetTargetStem(*textures[1]), "256x256_all_blue"); + EXPECT_EQ(TextureUtils::GetTargetStem(*textures[2]), "256x256_all_red"); + EXPECT_EQ(TextureUtils::GetTargetStem(*textures[3]), "256x256_all_green"); + EXPECT_EQ(TextureUtils::GetTargetFormat(*textures[0]), ImageFormat::PNG); + EXPECT_EQ(TextureUtils::GetTargetFormat(*textures[1]), ImageFormat::PNG); + EXPECT_EQ(TextureUtils::GetTargetFormat(*textures[2]), ImageFormat::PNG); + EXPECT_EQ(TextureUtils::GetTargetFormat(*textures[3]), ImageFormat::PNG); +} + +TEST(GltfDecoderTest, TestTexCoord1) { + const std::string file_name = "MultiUVTest/glTF/MultiUVTest.gltf"; + const std::unique_ptr mesh(DecodeGltfFile(file_name)); + ASSERT_NE(mesh, nullptr); + ASSERT_EQ(mesh->GetMaterialLibrary().NumMaterials(), 1); + ASSERT_EQ(mesh->GetMaterialLibrary().GetMaterial(0)->NumTextureMaps(), 2); + ASSERT_EQ(mesh->GetMaterialLibrary().GetTextureLibrary().NumTextures(), 2); + const std::vector textures = { + mesh->GetMaterialLibrary().GetTextureLibrary().GetTexture(0), + mesh->GetMaterialLibrary().GetTextureLibrary().GetTexture(1)}; + EXPECT_EQ(TextureUtils::GetTargetStem(*textures[0]), "uv0"); + EXPECT_EQ(TextureUtils::GetTargetStem(*textures[1]), "uv1"); + EXPECT_EQ(TextureUtils::GetTargetFormat(*textures[0]), ImageFormat::PNG); + EXPECT_EQ(TextureUtils::GetTargetFormat(*textures[1]), ImageFormat::PNG); + ASSERT_EQ(mesh->NumNamedAttributes(GeometryAttribute::TEX_COORD), 2); + ASSERT_EQ(mesh->NumNamedAttributes(GeometryAttribute::POSITION), 1); + ASSERT_EQ(mesh->NumNamedAttributes(GeometryAttribute::NORMAL), 1); + ASSERT_EQ(mesh->NumNamedAttributes(GeometryAttribute::TANGENT), 1); +} + +TEST(GltfDecoderTest, SimpleScene) { + const std::string file_name = "Box/glTF/Box.gltf"; + const std::unique_ptr scene(DecodeGltfFileToScene(file_name)); + + ASSERT_EQ(scene->NumMeshes(), 1); + ASSERT_EQ(scene->NumMeshGroups(), 1); + const MeshGroup &mesh_group = *scene->GetMeshGroup(MeshGroupIndex(0)); + ASSERT_EQ(mesh_group.NumMeshInstances(), 1); + ASSERT_EQ(mesh_group.GetMeshInstance(0).material_index, 0); + ASSERT_EQ(scene->NumNodes(), 2); + ASSERT_EQ(scene->NumRootNodes(), 1); + ASSERT_EQ(scene->GetMaterialLibrary().NumMaterials(), 1); + ASSERT_EQ(scene->GetMaterialLibrary().GetMaterial(0)->NumTextureMaps(), 0); + ASSERT_EQ(scene->NumSkins(), 0); + ASSERT_EQ(scene->NumAnimations(), 0); + + // Check all of the meshes do not have any materials. + for (MeshIndex i(0); i < scene->NumMeshes(); ++i) { + const Mesh &mesh = scene->GetMesh(i); + ASSERT_EQ(mesh.GetMaterialLibrary().NumMaterials(), 0); + } + + // Check names of nodes are empty. + EXPECT_TRUE(scene->GetNode(SceneNodeIndex(0))->GetName().empty()); + EXPECT_TRUE(scene->GetNode(SceneNodeIndex(1))->GetName().empty()); +} + +TEST(GltfDecoderTest, LanternScene) { + const std::string file_name = "Lantern/glTF/Lantern.gltf"; + const std::unique_ptr scene(DecodeGltfFileToScene(file_name)); + + EXPECT_EQ(scene->NumMeshes(), 3); + EXPECT_EQ(scene->NumMeshGroups(), 3); + EXPECT_EQ(scene->NumNodes(), 4); + EXPECT_EQ(scene->NumRootNodes(), 1); + EXPECT_EQ(scene->GetMaterialLibrary().NumMaterials(), 1); + EXPECT_EQ(scene->GetMaterialLibrary().GetMaterial(0)->NumTextureMaps(), 4); + EXPECT_EQ(scene->GetMaterialLibrary().GetMaterial(0)->GetDoubleSided(), + false); + EXPECT_EQ(scene->NumSkins(), 0); + EXPECT_EQ(scene->NumAnimations(), 0); + + // Check names of nodes have been populated. + EXPECT_EQ(scene->GetNode(SceneNodeIndex(0))->GetName(), "Lantern"); + EXPECT_EQ(scene->GetNode(SceneNodeIndex(1))->GetName(), "LanternPole_Body"); + EXPECT_EQ(scene->GetNode(SceneNodeIndex(2))->GetName(), "LanternPole_Chain"); + EXPECT_EQ(scene->GetNode(SceneNodeIndex(3))->GetName(), + "LanternPole_Lantern"); +} + +TEST(GltfDecoderTest, SimpleTriangleMesh) { + const std::string file_name = "Triangle/glTF/Triangle.gltf"; + const std::unique_ptr mesh(DecodeGltfFile(file_name)); + + EXPECT_EQ(mesh->num_attributes(), 1) << "Unexpected number of attributes."; + EXPECT_EQ(mesh->num_points(), 3) << "Unexpected number of vertices."; + EXPECT_EQ(mesh->num_faces(), 1) << "Unexpected number of faces."; + EXPECT_EQ(mesh->GetMaterialLibrary().NumMaterials(), 0); +} + +TEST(GltfDecoderTest, SimpleTriangleScene) { + const std::string file_name = "Triangle/glTF/Triangle.gltf"; + const std::unique_ptr scene(DecodeGltfFileToScene(file_name)); + + EXPECT_EQ(scene->NumMeshes(), 1); + EXPECT_EQ(scene->NumMeshGroups(), 1); + const MeshGroup &mesh_group = *scene->GetMeshGroup(MeshGroupIndex(0)); + ASSERT_EQ(mesh_group.NumMeshInstances(), 1); + ASSERT_EQ(mesh_group.GetMeshInstance(0).material_index, 0); + EXPECT_EQ(scene->NumNodes(), 1); + EXPECT_EQ(scene->NumRootNodes(), 1); + EXPECT_EQ(scene->GetMaterialLibrary().NumMaterials(), 1); + EXPECT_EQ(scene->NumSkins(), 0); + EXPECT_EQ(scene->NumAnimations(), 0); +} + +TEST(GltfDecoderTest, ThreeMeshesOneNoMaterialScene) { + const std::string file_name = + "three_meshes_two_materials_one_no_material/" + "three_meshes_two_materials_one_no_material.gltf"; + const std::unique_ptr scene(DecodeGltfFileToScene(file_name)); + + EXPECT_EQ(scene->NumMeshes(), 3); + EXPECT_EQ(scene->NumMeshGroups(), 3); + EXPECT_EQ(scene->NumNodes(), 4); + EXPECT_EQ(scene->NumRootNodes(), 1); + EXPECT_EQ(scene->GetMaterialLibrary().NumMaterials(), 3); + EXPECT_EQ(scene->NumSkins(), 0); + EXPECT_EQ(scene->NumAnimations(), 0); +} + +TEST(GltfDecoderTest, ThreeMeshesOneNoMaterialMesh) { + const std::string file_name = + "three_meshes_two_materials_one_no_material/" + "three_meshes_two_materials_one_no_material.gltf"; + const std::unique_ptr mesh(DecodeGltfFile(file_name)); + + EXPECT_EQ(mesh->num_attributes(), 4) << "Unexpected number of attributes."; + EXPECT_EQ(mesh->num_points(), 72) << "Unexpected number of vertices."; + EXPECT_EQ(mesh->num_faces(), 36) << "Unexpected number of faces."; + EXPECT_EQ(mesh->GetMaterialLibrary().NumMaterials(), 3); +} + +TEST(GltfDecoderTest, DoubleSidedMaterial) { + const std::string file_name = "TwoSidedPlane/glTF/TwoSidedPlane.gltf"; + const std::unique_ptr mesh(DecodeGltfFile(file_name)); + EXPECT_EQ(mesh->GetMaterialLibrary().NumMaterials(), 1); + EXPECT_EQ(mesh->GetMaterialLibrary().GetMaterial(0)->GetDoubleSided(), true); + + const std::unique_ptr scene(DecodeGltfFileToScene(file_name)); + EXPECT_EQ(scene->GetMaterialLibrary().NumMaterials(), 1); + EXPECT_EQ(scene->GetMaterialLibrary().GetMaterial(0)->GetDoubleSided(), true); +} + +TEST(GltfDecoderTest, VertexColorTest) { + const std::string file_name = "VertexColorTest/glTF/VertexColorTest.gltf"; + const std::unique_ptr mesh(DecodeGltfFile(file_name)); + EXPECT_EQ(mesh->GetMaterialLibrary().NumMaterials(), 2); + EXPECT_EQ(mesh->NumNamedAttributes(GeometryAttribute::COLOR), 1); + + const std::unique_ptr scene(DecodeGltfFileToScene(file_name)); + EXPECT_EQ(scene->GetMaterialLibrary().NumMaterials(), 2); + EXPECT_EQ(scene->NumMeshes(), 2); + const Mesh &second_mesh = scene->GetMesh(MeshIndex(1)); + EXPECT_EQ(second_mesh.NumNamedAttributes(GeometryAttribute::COLOR), 1); +} + +TEST(GltfDecoderTest, MorphTargets) { + const std::string filename = + "KhronosSampleModels/AnimatedMorphCube/glTF/AnimatedMorphCube.gltf"; + const std::string path = GetTestFileFullPath(filename); + GltfDecoder decoder; + const auto maybe_scene = decoder.DecodeFromFileToScene(path); + EXPECT_FALSE(maybe_scene.ok()); + EXPECT_EQ(maybe_scene.status().code(), Status::Code::UNSUPPORTED_FEATURE); +} + +TEST(GltfDecoderTest, SparseAccessors) { + const std::string filename = + "KhronosSampleModels/SimpleSparseAccessor/glTF/SimpleSparseAccessor.gltf"; + const std::string path = GetTestFileFullPath(filename); + GltfDecoder decoder; + const auto maybe_scene = decoder.DecodeFromFileToScene(path); + EXPECT_FALSE(maybe_scene.ok()); + EXPECT_EQ(maybe_scene.status().code(), Status::Code::UNSUPPORTED_FEATURE); +} + +TEST(GltfDecoderTest, PbrSpecularGlossinessExtension) { + const std::string filename = + "KhronosSampleModels/SpecGlossVsMetalRough/glTF/" + "SpecGlossVsMetalRough.gltf"; + const std::string path = GetTestFileFullPath(filename); + GltfDecoder decoder; + const auto maybe_scene = decoder.DecodeFromFileToScene(path); + EXPECT_FALSE(maybe_scene.ok()); + EXPECT_EQ(maybe_scene.status().code(), Status::Code::UNSUPPORTED_FEATURE); +} + +TEST(GltfDecoderTest, DifferentWrappingModes) { + const std::string filename = + "KhronosSampleModels/TextureSettingsTest/glTF/TextureSettingsTest.gltf"; + const std::string path = GetTestFileFullPath(filename); + GltfDecoder decoder; + const auto maybe_scene = decoder.DecodeFromFileToScene(path); + EXPECT_TRUE(maybe_scene.ok()); + const draco::Scene &scene = *maybe_scene.value(); + ASSERT_EQ(scene.GetMaterialLibrary().GetTextureLibrary().NumTextures(), 3); + ASSERT_EQ(scene.GetMaterialLibrary().NumMaterials(), 10); + const draco::Material &material = *scene.GetMaterialLibrary().GetMaterial(0); + ASSERT_EQ(material.NumTextureMaps(), 1); + ASSERT_EQ(material.GetTextureMapByIndex(0)->wrapping_mode().s, + draco::TextureMap::REPEAT); + ASSERT_EQ(material.GetTextureMapByIndex(0)->wrapping_mode().t, + draco::TextureMap::MIRRORED_REPEAT); +} + +TEST(GltfDecoderTest, KhrMaterialsUnlitExtension) { + const std::string no_unlit_filename = "Box/glTF/Box.gltf"; + const std::unique_ptr scene_no_unlit( + DecodeGltfFileToScene(no_unlit_filename)); + EXPECT_EQ(scene_no_unlit->GetMaterialLibrary().NumMaterials(), 1); + EXPECT_EQ(scene_no_unlit->GetMaterialLibrary().GetMaterial(0)->GetUnlit(), + false); + + const std::string filename = + "KhronosSampleModels/UnlitTest/glTF/UnlitTest.gltf"; + const std::unique_ptr mesh(DecodeGltfFile(filename)); + EXPECT_EQ(mesh->GetMaterialLibrary().NumMaterials(), 2); + EXPECT_EQ(mesh->GetMaterialLibrary().GetMaterial(0)->GetUnlit(), true); + EXPECT_EQ(mesh->GetMaterialLibrary().GetMaterial(1)->GetUnlit(), true); + + const std::unique_ptr scene(DecodeGltfFileToScene(filename)); + EXPECT_EQ(scene->GetMaterialLibrary().NumMaterials(), 2); + EXPECT_EQ(scene->GetMaterialLibrary().GetMaterial(0)->GetUnlit(), true); + EXPECT_EQ(scene->GetMaterialLibrary().GetMaterial(1)->GetUnlit(), true); +} + +TEST(GltfDecoderTest, KhrMaterialsSheenExtension) { + // Check that a model with no sheen is loaded with no sheen. + { + const std::unique_ptr scene( + DecodeGltfFileToScene("Box/glTF/Box.gltf")); + EXPECT_EQ(scene->GetMaterialLibrary().NumMaterials(), 1); + + // Check that material has no sheen. + const Material &material = *scene->GetMaterialLibrary().GetMaterial(0); + EXPECT_FALSE(material.HasSheen()); + + // Check that sheen color and roughness factors have default values. + EXPECT_EQ(material.GetSheenColorFactor(), Vector3f(0.f, 0.f, 0.f)); + EXPECT_EQ(material.GetSheenRoughnessFactor(), 0.f); + + // Check that sheen textures are absent. + EXPECT_EQ(material.GetTextureMapByType(TextureMap::SHEEN_COLOR), nullptr); + EXPECT_EQ(material.GetTextureMapByType(TextureMap::SHEEN_ROUGHNESS), + nullptr); + } + + // Check that a model with sheen is loaded as a mesh with sheen. + { + // Load model as a mesh. + const std::unique_ptr mesh( + DecodeGltfFile("KhronosSampleModels/SheenCloth/glTF/SheenCloth.gltf")); + EXPECT_NE(mesh, nullptr); + const Material &material = *mesh->GetMaterialLibrary().GetMaterial(0); + + // Check that material has sheen. + EXPECT_TRUE(material.HasSheen()); + + // Check that sheen color and roughness factors are present. + EXPECT_EQ(material.GetSheenColorFactor(), Vector3f(1.f, 1.f, 1.f)); + EXPECT_EQ(material.GetSheenRoughnessFactor(), 1.f); + + // Check that sheen color and roughness textures are present. + EXPECT_NE(material.GetTextureMapByType(TextureMap::SHEEN_COLOR), nullptr); + EXPECT_NE(material.GetTextureMapByType(TextureMap::SHEEN_ROUGHNESS), + nullptr); + + // Check that sheen color and roughness textures are shared. + EXPECT_EQ( + material.GetTextureMapByType(TextureMap::SHEEN_COLOR)->texture(), + material.GetTextureMapByType(TextureMap::SHEEN_ROUGHNESS)->texture()); + } + + // Check that a model with sheen is loaded as a scene with sheen. + { + // Load model as a scene. + const std::unique_ptr scene(DecodeGltfFileToScene( + "KhronosSampleModels/SheenCloth/glTF/SheenCloth.gltf")); + EXPECT_EQ(scene->GetMaterialLibrary().NumMaterials(), 1); + const Material &material = *scene->GetMaterialLibrary().GetMaterial(0); + + // Check that material has sheen. + EXPECT_TRUE(material.HasSheen()); + + // Check that sheen color and roughness factors are present. + EXPECT_EQ(material.GetSheenColorFactor(), Vector3f(1.f, 1.f, 1.f)); + EXPECT_EQ(material.GetSheenRoughnessFactor(), 1.f); + + // Check that sheen color and roughness textures are present. + EXPECT_NE(material.GetTextureMapByType(TextureMap::SHEEN_COLOR), nullptr); + EXPECT_NE(material.GetTextureMapByType(TextureMap::SHEEN_ROUGHNESS), + nullptr); + + // Check that sheen color and roughness textures are shared. + EXPECT_EQ( + material.GetTextureMapByType(TextureMap::SHEEN_COLOR)->texture(), + material.GetTextureMapByType(TextureMap::SHEEN_ROUGHNESS)->texture()); + } +} + +TEST(GltfDecoderTest, PbrNextExtensions) { + // Check that a model with no material extensions is loaded correctly. + { + const std::unique_ptr scene( + DecodeGltfFileToScene("Box/glTF/Box.gltf")); + EXPECT_EQ(scene->GetMaterialLibrary().NumMaterials(), 1); + const Material &m = *scene->GetMaterialLibrary().GetMaterial(0); + + // Check that material has no extensions. + EXPECT_FALSE(m.HasSheen()); + EXPECT_FALSE(m.HasTransmission()); + EXPECT_FALSE(m.HasClearcoat()); + EXPECT_FALSE(m.HasVolume()); + EXPECT_FALSE(m.HasIor()); + EXPECT_FALSE(m.HasSpecular()); + } + + // Check that a model with material extensions is loaded correctly. + { + const std::unique_ptr mesh( + DecodeGltfFile("pbr_next/sphere/glTF/sphere.gltf")); + EXPECT_NE(mesh, nullptr); + const Material &m = *mesh->GetMaterialLibrary().GetMaterial(0); + + // Check that material has extensions. + EXPECT_TRUE(m.HasSheen()); + EXPECT_TRUE(m.HasTransmission()); + EXPECT_TRUE(m.HasClearcoat()); + EXPECT_TRUE(m.HasVolume()); + EXPECT_TRUE(m.HasIor()); + EXPECT_TRUE(m.HasSpecular()); + + // Check that material has correct extension properties. + EXPECT_EQ(m.GetSheenColorFactor(), Vector3f(1.0f, 0.329f, 0.1f)); + EXPECT_EQ(m.GetSheenRoughnessFactor(), 0.8f); + EXPECT_EQ(m.GetTransmissionFactor(), 0.75f); + EXPECT_EQ(m.GetClearcoatFactor(), 0.95f); + EXPECT_EQ(m.GetClearcoatRoughnessFactor(), 0.03f); + EXPECT_EQ(m.GetAttenuationColor(), Vector3f(0.921f, 0.640f, 0.064f)); + EXPECT_EQ(m.GetAttenuationDistance(), 0.155f); + EXPECT_EQ(m.GetThicknessFactor(), 2.27f); + EXPECT_EQ(m.GetIor(), 1.55f); + EXPECT_EQ(m.GetSpecularFactor(), 0.3f); + EXPECT_EQ(m.GetSpecularColorFactor(), Vector3f(0.212f, 0.521f, 0.051f)); + + // Check that material has all extension textures. + EXPECT_NE(m.GetTextureMapByType(TextureMap::SHEEN_COLOR), nullptr); + EXPECT_NE(m.GetTextureMapByType(TextureMap::SHEEN_ROUGHNESS), nullptr); + EXPECT_NE(m.GetTextureMapByType(TextureMap::TRANSMISSION), nullptr); + EXPECT_NE(m.GetTextureMapByType(TextureMap::CLEARCOAT), nullptr); + EXPECT_NE(m.GetTextureMapByType(TextureMap::CLEARCOAT_ROUGHNESS), nullptr); + EXPECT_NE(m.GetTextureMapByType(TextureMap::CLEARCOAT_NORMAL), nullptr); + EXPECT_NE(m.GetTextureMapByType(TextureMap::THICKNESS), nullptr); + EXPECT_NE(m.GetTextureMapByType(TextureMap::SPECULAR), nullptr); + EXPECT_NE(m.GetTextureMapByType(TextureMap::SPECULAR_COLOR), nullptr); + } +} + +TEST(GltfDecoderTest, TextureTransformTest) { + const std::string filename = + "KhronosSampleModels/TextureTransformTest/glTF/TextureTransformTest.gltf"; + const std::unique_ptr mesh(DecodeGltfFile(filename)); + EXPECT_EQ(mesh->GetMaterialLibrary().NumMaterials(), 9); + for (int i = 0; i < 6; ++i) { + EXPECT_FALSE(TextureTransform::IsDefault(mesh->GetMaterialLibrary() + .GetMaterial(i) + ->GetTextureMapByIndex(0) + ->texture_transform())); + } + for (int i = 6; i < 9; ++i) { + EXPECT_TRUE(TextureTransform::IsDefault(mesh->GetMaterialLibrary() + .GetMaterial(i) + ->GetTextureMapByIndex(0) + ->texture_transform())); + } + + const std::unique_ptr scene(DecodeGltfFileToScene(filename)); + EXPECT_EQ(scene->GetMaterialLibrary().NumMaterials(), 9); + for (int i = 0; i < 6; ++i) { + EXPECT_FALSE(TextureTransform::IsDefault(scene->GetMaterialLibrary() + .GetMaterial(i) + ->GetTextureMapByIndex(0) + ->texture_transform())); + } + for (int i = 6; i < 9; ++i) { + EXPECT_TRUE(TextureTransform::IsDefault(scene->GetMaterialLibrary() + .GetMaterial(i) + ->GetTextureMapByIndex(0) + ->texture_transform())); + } +} + +TEST(GltfDecoderTest, GlbTextureSource) { + const std::string file_name = "KhronosSampleModels/Duck/glTF_Binary/Duck.glb"; + const std::unique_ptr scene(DecodeGltfFileToScene(file_name)); + EXPECT_EQ(scene->NumMeshes(), 1); + EXPECT_EQ(scene->NumMeshGroups(), 1); + const MeshGroup &mesh_group = *scene->GetMeshGroup(MeshGroupIndex(0)); + ASSERT_EQ(mesh_group.NumMeshInstances(), 1); + ASSERT_EQ(mesh_group.GetMeshInstance(0).material_index, 0); + EXPECT_EQ(scene->NumNodes(), 3); + EXPECT_EQ(scene->NumRootNodes(), 1); + EXPECT_EQ(scene->GetMaterialLibrary().NumMaterials(), 1); + EXPECT_EQ(scene->GetMaterialLibrary().GetMaterial(0)->NumTextureMaps(), 1); + EXPECT_EQ(scene->NumAnimations(), 0); + EXPECT_EQ(scene->NumSkins(), 0); + EXPECT_EQ(scene->GetMaterialLibrary().GetTextureLibrary().NumTextures(), 1); + const Texture *const texture = + scene->GetMaterialLibrary().GetTextureLibrary().GetTexture(0); + ASSERT_NE(texture, nullptr); + const SourceImage &source_image = texture->source_image(); + EXPECT_EQ(source_image.encoded_data().size(), 16302); + EXPECT_EQ(source_image.filename(), ""); + EXPECT_EQ(source_image.mime_type(), "image/png"); +} + +TEST(GltfDecoderTest, GltfTextureSource) { + const std::string file_name = "KhronosSampleModels/Duck/glTF/Duck.gltf"; + const std::unique_ptr scene(DecodeGltfFileToScene(file_name)); + EXPECT_EQ(scene->NumMeshes(), 1); + EXPECT_EQ(scene->NumMeshGroups(), 1); + const MeshGroup &mesh_group = *scene->GetMeshGroup(MeshGroupIndex(0)); + ASSERT_EQ(mesh_group.NumMeshInstances(), 1); + ASSERT_EQ(mesh_group.GetMeshInstance(0).material_index, 0); + EXPECT_EQ(scene->NumNodes(), 3); + EXPECT_EQ(scene->NumRootNodes(), 1); + EXPECT_EQ(scene->GetMaterialLibrary().NumMaterials(), 1); + EXPECT_EQ(scene->GetMaterialLibrary().GetMaterial(0)->NumTextureMaps(), 1); + EXPECT_EQ(scene->NumAnimations(), 0); + EXPECT_EQ(scene->NumSkins(), 0); + EXPECT_EQ(scene->GetMaterialLibrary().GetTextureLibrary().NumTextures(), 1); + const Texture *const texture = + scene->GetMaterialLibrary().GetTextureLibrary().GetTexture(0); + ASSERT_NE(texture, nullptr); + const SourceImage &source_image = texture->source_image(); + EXPECT_EQ(source_image.encoded_data().size(), 0); + EXPECT_FALSE(source_image.filename().empty()); + EXPECT_EQ(source_image.mime_type(), ""); +} + +TEST(GltfDecoderTest, GltfDecodeWithDraco) { + // Tests that we can decode a glTF containing Draco compressed geometry. + const std::string file_name = "Box/glTF_Binary/Box.glb"; + const std::string file_name_with_draco = "Box/glTF_Binary/Box_Draco.glb"; + const std::unique_ptr scene(DecodeGltfFileToScene(file_name)); + const std::unique_ptr scene_draco( + DecodeGltfFileToScene(file_name_with_draco)); + ASSERT_NE(scene, nullptr); + ASSERT_NE(scene_draco, nullptr); + EXPECT_EQ(scene->NumMeshes(), scene_draco->NumMeshes()); + EXPECT_EQ(scene->NumMeshGroups(), scene_draco->NumMeshGroups()); + EXPECT_EQ(scene->NumNodes(), scene_draco->NumNodes()); + EXPECT_EQ(scene->NumRootNodes(), scene_draco->NumRootNodes()); + EXPECT_EQ(scene->GetMaterialLibrary().NumMaterials(), + scene_draco->GetMaterialLibrary().NumMaterials()); + EXPECT_EQ(scene->NumAnimations(), scene_draco->NumAnimations()); + EXPECT_EQ(scene->NumSkins(), scene_draco->NumSkins()); + + EXPECT_EQ(scene->NumMeshes(), 1); + EXPECT_EQ(scene->GetMesh(draco::MeshIndex(0)).num_faces(), + scene_draco->GetMesh(draco::MeshIndex(0)).num_faces()); +} + +TEST(GltfDecoderTest, TestAnimationNames) { + const std::string file_name = "InterpolationTest/glTF/InterpolationTest.gltf"; + const std::unique_ptr scene(DecodeGltfFileToScene(file_name)); + ASSERT_NE(scene, nullptr); + + EXPECT_EQ(scene->NumAnimations(), 9); + + const std::vector animation_names{ + "Step Scale", "Linear Scale", + "CubicSpline Scale", "Step Rotation", + "CubicSpline Rotation", "Linear Rotation", + "Step Translation", "CubicSpline Translation", + "Linear Translation"}; + for (int i = 0; i < scene->NumAnimations(); ++i) { + const Animation *const anim = scene->GetAnimation(AnimationIndex(i)); + ASSERT_NE(anim, nullptr); + ASSERT_EQ(anim->GetName(), animation_names[i]); + } +} + +TEST(GltfDecoderTest, DuplicatePrimitives) { + const std::string file_name = "DuplicateMeshes/duplicate_meshes.gltf"; + const std::unique_ptr scene(DecodeGltfFileToScene(file_name)); + ASSERT_NE(scene, nullptr); + + // There should be only one unique base mesh in the scene and four mesh + // groups (instances). + ASSERT_EQ(scene->NumMeshes(), 1); + ASSERT_EQ(scene->NumMeshGroups(), 4); + + // There should be two materials used by the instances. + ASSERT_EQ(scene->GetMaterialLibrary().NumMaterials(), 2); +} + +TEST(GltfDecoderTest, SimpleSkin) { + // This is a simple skin example from glTF tutorial. + const std::string file_name = "simple_skin.gltf"; + const std::unique_ptr scene(DecodeGltfFileToScene(file_name)); + ASSERT_NE(scene, nullptr); + + // Check scene size. + ASSERT_EQ(scene->NumMeshes(), 1); + ASSERT_EQ(scene->NumMeshGroups(), 1); + ASSERT_EQ(scene->GetMeshGroup(draco::MeshGroupIndex(0))->NumMeshInstances(), + 1); + ASSERT_EQ(scene->NumNodes(), 3); + ASSERT_EQ(scene->NumRootNodes(), 1); + ASSERT_EQ(scene->GetMaterialLibrary().NumMaterials(), 1); + ASSERT_EQ(scene->NumAnimations(), 1); + ASSERT_EQ(scene->NumSkins(), 1); + + // Check animation size. + const Animation *const animation = scene->GetAnimation(AnimationIndex(0)); + ASSERT_NE(animation, nullptr); + ASSERT_EQ(animation->NumSamplers(), 1); + ASSERT_EQ(animation->NumChannels(), 1); + ASSERT_EQ(animation->NumNodeAnimationData(), 2); + + // Check animation sampler. + const AnimationSampler *const sampler = animation->GetSampler(0); + ASSERT_NE(sampler, nullptr); + ASSERT_EQ(sampler->input_index, 0); + ASSERT_EQ(sampler->interpolation_type, + AnimationSampler::SamplerInterpolation::LINEAR); + ASSERT_EQ(sampler->output_index, 1); + + // Check animation channel. + const AnimationChannel *const channel = animation->GetChannel(0); + ASSERT_NE(channel, nullptr); + ASSERT_EQ(channel->sampler_index, 0); + ASSERT_EQ(channel->target_index, 2); + ASSERT_EQ(channel->transformation_type, + AnimationChannel::ChannelTransformation::ROTATION); + + // Check the first node animation data. + { + const NodeAnimationData *const node_animation = + animation->GetNodeAnimationData(0); + ASSERT_EQ(node_animation->ComponentSize(), 4); + ASSERT_EQ(node_animation->NumComponents(), 1); + ASSERT_EQ(node_animation->count(), 12); + ASSERT_EQ(node_animation->type(), NodeAnimationData::Type::SCALAR); + ASSERT_FALSE(node_animation->normalized()); + const std::vector &node_animation_data = *node_animation->GetData(); + const std::vector expected_node_animation_data{ + 0.0f, 0.5f, 1.0f, 1.5f, 2.0f, 2.5f, 3.0f, 3.5f, 4.0f, 4.5f, 5.0f, 5.5f}; + ASSERT_EQ(node_animation_data, expected_node_animation_data); + } + + // Check the second node animation data. + { + const NodeAnimationData *const node_animation = + animation->GetNodeAnimationData(1); + ASSERT_EQ(node_animation->ComponentSize(), 4); + ASSERT_EQ(node_animation->NumComponents(), 4); + ASSERT_EQ(node_animation->count(), 12); + ASSERT_EQ(node_animation->type(), NodeAnimationData::Type::VEC4); + ASSERT_FALSE(node_animation->normalized()); + const std::vector &node_animation_data = *node_animation->GetData(); + std::cout << std::endl; + // clang-format off + const std::vector expected_node_animation_data{ + 0.000f, 0.000f, 0.000f, 1.000f, + 0.000f, 0.000f, 0.383f, 0.924f, + 0.000f, 0.000f, 0.707f, 0.707f, + 0.000f, 0.000f, 0.707f, 0.707f, + 0.000f, 0.000f, 0.383f, 0.924f, + 0.000f, 0.000f, 0.000f, 1.000f, + 0.000f, 0.000f, 0.000f, 1.000f, + 0.000f, 0.000f, -0.383f, 0.924f, + 0.000f, 0.000f, -0.707f, 0.707f, + 0.000f, 0.000f, -0.707f, 0.707f, + 0.000f, 0.000f, -0.383f, 0.924f, + 0.000f, 0.000f, 0.000f, 1.000f}; + // clang-format on + ASSERT_EQ(node_animation_data, expected_node_animation_data); + } + + // Check skin. + const Skin *const skin = scene->GetSkin(SkinIndex(0)); + ASSERT_NE(skin, nullptr); + ASSERT_EQ(skin->NumJoints(), 2); + ASSERT_EQ(skin->GetJointRoot(), kInvalidSceneNodeIndex); + ASSERT_EQ(skin->GetJoint(0), SceneNodeIndex(1)); + ASSERT_EQ(skin->GetJoint(1), SceneNodeIndex(2)); + + // Check inverse bind matrices. + const NodeAnimationData &bind_matrices = skin->GetInverseBindMatrices(); + ASSERT_EQ(bind_matrices.type(), NodeAnimationData::Type::MAT4); + ASSERT_EQ(bind_matrices.count(), 2); + ASSERT_EQ(bind_matrices.normalized(), false); + ASSERT_NE(bind_matrices.GetData(), nullptr); + const std::vector &bind_matrices_data = *bind_matrices.GetData(); + // clang-format off + const std::vector expected_bind_matrices_data{ + // First matrix. + 1.0f, 0.0f, 0.0f, 0.0f, + 0.0f, 1.0f, 0.0f, 0.0f, + 0.0f, 0.0f, 1.0f, 0.0f, + -0.5f, -1.0f, 0.0f, 1.0f, + // Second matrix. + 1.0f, 0.0f, 0.0f, 0.0f, + 0.0f, 1.0f, 0.0f, 0.0f, + 0.0f, 0.0f, 1.0f, 0.0f, + -0.5f, -1.0f, 0.0f, 1.0f}; + // clang-format on + ASSERT_EQ(bind_matrices_data, expected_bind_matrices_data); + + // Check mesh size. + const Mesh &mesh = scene->GetMesh(MeshIndex(0)); + ASSERT_EQ(mesh.num_faces(), 8); + ASSERT_EQ(mesh.num_points(), 10); + ASSERT_EQ(mesh.num_attributes(), 3); + + // Check vertex joint indices. + const PointAttribute *const joints_att = + mesh.GetNamedAttribute(GeometryAttribute::JOINTS); + ASSERT_NE(joints_att, nullptr); + ASSERT_EQ(joints_att->data_type(), DT_UINT16); + ASSERT_EQ(joints_att->num_components(), 4); + ASSERT_EQ(joints_att->size(), 1); + // clang-format off + const std::array expected_joints = { + // Each vertex is associated with four joints. + 0, 1, 0, 0, + 0, 1, 0, 0, + 0, 1, 0, 0, + 0, 1, 0, 0, + 0, 1, 0, 0, + 0, 1, 0, 0, + 0, 1, 0, 0, + 0, 1, 0, 0, + 0, 1, 0, 0, + 0, 1, 0, 0 }; + // clang-format on + std::array joints; + for (draco::PointIndex pi(0); pi < mesh.num_points(); ++pi) { + joints_att->GetMappedValue(pi, &joints[4 * pi.value()]); + } + ASSERT_EQ(joints, expected_joints); + + // Check vertex joint weights. + const PointAttribute *const weights_att = + mesh.GetNamedAttribute(GeometryAttribute::WEIGHTS); + ASSERT_NE(weights_att, nullptr); + ASSERT_EQ(weights_att->data_type(), DT_FLOAT32); + ASSERT_EQ(weights_att->num_components(), 4); + ASSERT_EQ(weights_att->size(), 5); + // clang-format off + const std::array expected_weights = { + // Each vertex has four joint weights. + 1.00f, 0.00f, 0.00f, 0.00f, + 1.00f, 0.00f, 0.00f, 0.00f, + 0.75f, 0.25f, 0.00f, 0.00f, + 0.75f, 0.25f, 0.00f, 0.00f, + 0.50f, 0.50f, 0.00f, 0.00f, + 0.50f, 0.50f, 0.00f, 0.00f, + 0.25f, 0.75f, 0.00f, 0.00f, + 0.25f, 0.75f, 0.00f, 0.00f, + 0.00f, 1.00f, 0.00f, 0.00f, + 0.00f, 1.00f, 0.00f, 0.00f }; + // clang-format on + std::array weights; + for (draco::PointIndex pi(0); pi < mesh.num_points(); ++pi) { + weights_att->GetMappedValue(pi, &weights[4 * pi.value()]); + } + ASSERT_EQ(weights, expected_weights); +} + +TEST(GltfDecoderTest, DecodeMeshWithImplicitPrimitiveIndices) { + // Check that glTF primitives with implicit indices can be loaded as a mesh. + const std::string file_name = "Fox/glTF/Fox.gltf"; + const std::unique_ptr mesh(DecodeGltfFile(file_name)); + ASSERT_NE(mesh, nullptr); + ASSERT_EQ(mesh->num_faces(), 576); +} + +TEST(GltfDecoderTest, DecodeSceneWithImplicitPrimitiveIndices) { + // Check that glTF primitives with implicit indices can be loaded as a scene. + const std::string file_name = "Fox/glTF/Fox.gltf"; + const std::unique_ptr scene(DecodeGltfFileToScene(file_name)); + ASSERT_NE(scene, nullptr); + ASSERT_EQ(scene->NumMeshes(), 1); + ASSERT_EQ(scene->GetMesh(MeshIndex(0)).num_faces(), 576); +} + +TEST(GltfDecoderTest, DecodeFromBufferToMesh) { + // Checks that a mesh can be decoded from buffer in GLB format. + // Read GLB file contents into a buffer. + const std::string file_name = "KhronosSampleModels/Duck/glTF_Binary/Duck.glb"; + const std::string file_path = GetTestFileFullPath(file_name); + std::vector file_data; + ASSERT_TRUE(ReadFileToBuffer(file_path, &file_data)); + DecoderBuffer buffer; + buffer.Init(file_data.data(), file_data.size()); + + // Decode mesh from buffer. + GltfDecoder decoder; + DRACO_ASSIGN_OR_ASSERT(auto mesh, decoder.DecodeFromBuffer(&buffer)); + ASSERT_NE(mesh, nullptr); + + // Decode mesh from GLB file. + const std::unique_ptr expected_mesh(DecodeGltfFile(file_name)); + ASSERT_NE(expected_mesh, nullptr); + + // Check that meshes decoded from the buffer and from GLB file are equivalent. + MeshAreEquivalent eq; + ASSERT_TRUE(eq(*mesh, *expected_mesh)); +} + +TEST(GltfDecoderTest, DecodeGraph) { + // Checks that we can decode a scene with a general graph structure where a + // node has multiple parents. + // The input model has one root node, 4 children nodes that all point to a + // single node that contains the cube mesh. + const std::string file_name = "CubeScaledInstances/glTF/cube_att.gltf"; + const std::string file_path = GetTestFileFullPath(file_name); + + // First decode the scene into a tree-graph. + draco::GltfDecoder dec_tree; + DRACO_ASSIGN_OR_ASSERT(auto scene_tree, + dec_tree.DecodeFromFileToScene(file_path)); + // We expect to have 9 nodes with 4 mesh instances. The leaf node with the + // cube is duplicated 4 times, once for each instance. + ASSERT_EQ(scene_tree->NumNodes(), 9); + auto instances_tree = draco::SceneUtils::ComputeAllInstances(*scene_tree); + ASSERT_EQ(instances_tree.size(), 4); + + // Decode the scene into a scene-graph. + draco::GltfDecoder dec_graph; + dec_graph.SetSceneGraphMode(draco::GltfDecoder::GltfSceneGraphMode::DAG); + DRACO_ASSIGN_OR_ASSERT(auto scene_graph, + dec_graph.DecodeFromFileToScene(file_path)); + + // We expect to have 6 nodes with 4 mesh instances. The leaf node is shared + // for all mesh instances. + ASSERT_EQ(scene_graph->NumNodes(), 6); + auto instances_graph = draco::SceneUtils::ComputeAllInstances(*scene_graph); + ASSERT_EQ(instances_graph.size(), 4); + + // Check that all instances share the same scene node. + for (draco::MeshInstanceIndex mii(1); mii < 4; ++mii) { + ASSERT_EQ(instances_graph[mii - 1].scene_node_index, + instances_graph[mii].scene_node_index); + } +} + +TEST(GltfDecoderTest, CorrectVolumeThicknessFactor) { + // Checks that when a model is decoded as draco::Mesh the PBR material volume + // thickness factor is corrected according to geometry transformation scale in + // the scene graph. + constexpr float kDragonScale = 0.25f; + constexpr float kDragonVolumeThickness = 2.27f; + + // Read model as draco::Scene and check dragon mesh transformation scale and + // its PBR material volume thickness factor. + const std::unique_ptr scene = draco::ReadSceneFromTestFile( + "KhronosSampleModels/DragonAttenuation/glTF/DragonAttenuation.gltf"); + ASSERT_NE(scene, nullptr); + auto instances = draco::SceneUtils::ComputeAllInstances(*scene); + ASSERT_EQ(instances.size(), 2); + ASSERT_EQ(instances[MeshInstanceIndex(0)].transform.col(0).norm(), + kDragonScale); + ASSERT_EQ(scene->GetMaterialLibrary().GetMaterial(1)->GetThicknessFactor(), + kDragonVolumeThickness); + + // Read model as draco::Mesh and check corrected volume thickness factor. + const std::unique_ptr mesh = draco::ReadMeshFromTestFile( + "KhronosSampleModels/DragonAttenuation/glTF/DragonAttenuation.gltf"); + ASSERT_NE(mesh, nullptr); + ASSERT_EQ(mesh->GetMaterialLibrary().GetMaterial(1)->GetThicknessFactor(), + kDragonScale * kDragonVolumeThickness); +} + +TEST(GltfDecoderTest, DecodeLightsIntoMesh) { + // Checks that a model with lights can be decoded into draco::Mesh with the + // lights discarded. + const std::string file_name = "sphere_lights.gltf"; + const std::unique_ptr mesh(DecodeGltfFile(file_name)); + ASSERT_NE(mesh, nullptr); + ASSERT_EQ(mesh->num_faces(), 224); +} + +TEST(GltfDecoderTest, DecodeLightsIntoScene) { + // Checks that a model with lights can be decoded into draco::Scene. + const std::string file_name = "sphere_lights.gltf"; + const std::unique_ptr scene(DecodeGltfFileToScene(file_name)); + ASSERT_NE(scene, nullptr); + ASSERT_EQ(scene->NumLights(), 4); + + // Check spot light with all properties specified. + Light &light = *scene->GetLight(LightIndex(0)); + ASSERT_EQ(light.GetName(), "Blue Lightsaber"); + ASSERT_EQ(light.GetColor(), draco::Vector3f(0.72f, 0.71f, 1.00f)); + ASSERT_EQ(light.GetIntensity(), 3.0); + ASSERT_EQ(light.GetType(), draco::Light::SPOT); + ASSERT_EQ(light.GetRange(), 100); + ASSERT_EQ(light.GetInnerConeAngle(), 0.2); + ASSERT_EQ(light.GetOuterConeAngle(), 0.8); + + // Check point light with all properties specified. + light = *scene->GetLight(LightIndex(1)); + ASSERT_EQ(light.GetName(), "The Star of Earendil"); + ASSERT_EQ(light.GetColor(), draco::Vector3f(0.90f, 0.97f, 1.0f)); + ASSERT_EQ(light.GetIntensity(), 5.0); + ASSERT_EQ(light.GetType(), draco::Light::POINT); + ASSERT_EQ(light.GetRange(), 1000); + ASSERT_EQ(light.GetInnerConeAngle(), 0.0); + ASSERT_NEAR(light.GetOuterConeAngle(), DRACO_PI / 4.0f, 1e-8); + + // Check directional light with some properties specified. + light = *scene->GetLight(LightIndex(2)); + ASSERT_EQ(light.GetName(), "Arc Reactor"); + ASSERT_EQ(light.GetColor(), draco::Vector3f(0.9f, 0.9, 0.9f)); + ASSERT_EQ(light.GetIntensity(), 1.0); + ASSERT_EQ(light.GetType(), draco::Light::DIRECTIONAL); + ASSERT_EQ(light.GetRange(), 200.0); + + // Check spot light with no properties specified. + light = *scene->GetLight(LightIndex(3)); + ASSERT_EQ(light.GetName(), ""); + ASSERT_EQ(light.GetColor(), draco::Vector3f(1.0f, 1.0f, 1.0f)); + ASSERT_EQ(light.GetIntensity(), 1.0); + ASSERT_EQ(light.GetType(), draco::Light::SPOT); + ASSERT_EQ(light.GetRange(), std::numeric_limits::max()); + ASSERT_EQ(light.GetInnerConeAngle(), 0.0); + ASSERT_NEAR(light.GetOuterConeAngle(), DRACO_PI / 4.0f, 1e-8); + + // Check that lights are referenced by the scene nodes. + ASSERT_EQ(scene->GetNode(SceneNodeIndex(0))->GetLightIndex(), + kInvalidLightIndex); + ASSERT_EQ(scene->GetNode(SceneNodeIndex(1))->GetLightIndex(), LightIndex(0)); + ASSERT_EQ(scene->GetNode(SceneNodeIndex(2))->GetLightIndex(), LightIndex(2)); + ASSERT_EQ(scene->GetNode(SceneNodeIndex(3))->GetLightIndex(), LightIndex(3)); + ASSERT_EQ(scene->GetNode(SceneNodeIndex(4))->GetLightIndex(), LightIndex(1)); +} + +TEST(GltfDecoderTest, MaterialsVariants) { + // Checks that a model with KHR_materials_variants extension can be decoded. + draco::GltfDecoder decoder; + DRACO_ASSIGN_OR_ASSERT(auto scene, + decoder.DecodeFromFileToScene(GetTestFileFullPath( + "KhronosSampleModels/DragonAttenuation/glTF/" + "DragonAttenuation.gltf"))); + ASSERT_NE(scene, nullptr); + const draco::MaterialLibrary &library = scene->GetMaterialLibrary(); + ASSERT_EQ(library.NumMaterialsVariants(), 2); + ASSERT_EQ(library.GetMaterialsVariantName(0), "Attenuation"); + ASSERT_EQ(library.GetMaterialsVariantName(1), "Surface Color"); + + // Check that the cloth mesh has no material variants. + const draco::MeshGroup &cloth_group = + *scene->GetMeshGroup(draco::MeshGroupIndex(0)); + ASSERT_EQ(cloth_group.GetName(), "Cloth Backdrop"); + ASSERT_EQ(cloth_group.NumMeshInstances(), 1); + const auto &cloth_mappings = + cloth_group.GetMeshInstance(0).materials_variants_mappings; + ASSERT_EQ(cloth_mappings.size(), 0); + + // Check that the dragon has correct materials variants. + const draco::MeshGroup &dragon_group = + *scene->GetMeshGroup(draco::MeshGroupIndex(1)); + ASSERT_EQ(dragon_group.GetName(), "Dragon"); + ASSERT_EQ(dragon_group.NumMeshInstances(), 1); + const auto &dragon_mappings = + dragon_group.GetMeshInstance(0).materials_variants_mappings; + ASSERT_EQ(dragon_mappings.size(), 2); + ASSERT_EQ(dragon_mappings[0].material, 1); + ASSERT_EQ(dragon_mappings[1].material, 2); + ASSERT_EQ(dragon_mappings[0].variants.size(), 1); + ASSERT_EQ(dragon_mappings[1].variants.size(), 1); + ASSERT_EQ(dragon_mappings[0].variants[0], 0); + ASSERT_EQ(dragon_mappings[1].variants[0], 1); +} + +TEST(GltfDecoderTest, DecodeMeshWithMeshFeaturesWithStructuralMetadata) { + // Checks decoding of a simple glTF with mesh features and structural metadata + // property table as draco::Mesh. + constexpr bool kDracoCompressionEnabled = false; + const auto path = GetTestFileFullPath("BoxMeta/glTF/BoxMeta.gltf"); + draco::GltfDecoder decoder; + DRACO_ASSIGN_OR_ASSERT(auto mesh, decoder.DecodeFromFile(path)); + ASSERT_NE(mesh, nullptr); + GltfTestHelper::CheckBoxMetaMeshFeatures(*mesh, kDracoCompressionEnabled); + GltfTestHelper::CheckBoxMetaStructuralMetadata(*mesh); +} + +TEST(GltfDecoderTest, DecodeMeshWithMeshFeaturesWithDracoCompression) { + // Checks decoding of a simple glTF with mesh features compressed with Draco + // as draco::Mesh. + constexpr bool kDracoCompressionEnabled = true; + const auto path = GetTestFileFullPath("BoxMetaDraco/glTF/BoxMetaDraco.gltf"); + draco::GltfDecoder decoder; + DRACO_ASSIGN_OR_ASSERT(auto mesh, decoder.DecodeFromFile(path)); + ASSERT_NE(mesh, nullptr); + GltfTestHelper::CheckBoxMetaMeshFeatures(*mesh, kDracoCompressionEnabled); +} + +TEST(GltfDecoderTest, DecodeSceneWithMeshFeaturesWithStructuralMetadata) { + // Checks decoding of a simple glTF with mesh features and structural metadata + // property table as draco::Scene. + constexpr bool kHasDracoCompression = false; + const auto path = GetTestFileFullPath("BoxMeta/glTF/BoxMeta.gltf"); + draco::GltfDecoder decoder; + DRACO_ASSIGN_OR_ASSERT(auto scene, decoder.DecodeFromFileToScene(path)); + ASSERT_NE(scene, nullptr); + GltfTestHelper::CheckBoxMetaMeshFeatures(*scene, kHasDracoCompression); + GltfTestHelper::CheckBoxMetaStructuralMetadata(*scene); +} + +TEST(GltfDecoderTest, DecodeSceneWithMeshFeaturesWithDracoCompression) { + // Checks decoding of a simple glTF with mesh features compressed with Draco + // as draco::Scene. + constexpr bool kHasDracoCompression = true; + const auto path = GetTestFileFullPath("BoxMetaDraco/glTF/BoxMetaDraco.gltf"); + draco::GltfDecoder decoder; + DRACO_ASSIGN_OR_ASSERT(auto scene, decoder.DecodeFromFileToScene(path)); + ASSERT_NE(scene, nullptr); + GltfTestHelper::CheckBoxMetaMeshFeatures(*scene, kHasDracoCompression); +} + +TEST(GltfDecoderTest, DecodePointCloudToMesh) { + // Checks decoding of a simple glTF with point primitives (no meshes). + const auto path = GetTestFileFullPath( + "SphereTwoMaterials/sphere_two_materials_point_cloud.gltf"); + draco::GltfDecoder decoder; + DRACO_ASSIGN_OR_ASSERT(auto mesh, decoder.DecodeFromFile(path)); + ASSERT_NE(mesh, nullptr); + + // Check the point cloud has expected number of points and attributes. + ASSERT_EQ(mesh->num_faces(), 0); + ASSERT_EQ(mesh->num_points(), 462); + + ASSERT_EQ(mesh->NumNamedAttributes(draco::GeometryAttribute::NORMAL), 1); + ASSERT_EQ(mesh->NumNamedAttributes(draco::GeometryAttribute::TEX_COORD), 1); + ASSERT_EQ(mesh->NumNamedAttributes(draco::GeometryAttribute::TANGENT), 1); + ASSERT_EQ(mesh->NumNamedAttributes(draco::GeometryAttribute::MATERIAL), 1); + + // Check the point cloud has two materials. + ASSERT_EQ(mesh->GetNamedAttribute(draco::GeometryAttribute::MATERIAL)->size(), + 2); +} + +TEST(GltfDecoderTest, DecodeMeshAndPointCloudToMesh) { + // Checks decoding of a simple glTF with a mesh and point primitives into + // draco::Mesh. This should fail (draco::Mesh can't support mixed primitives). + const auto path = GetTestFileFullPath( + "SphereTwoMaterials/sphere_two_materials_mesh_and_point_cloud.gltf"); + draco::GltfDecoder decoder; + ASSERT_FALSE(decoder.DecodeFromFile(path).ok()); +} + +TEST(GltfDecoderTest, DecodePointCloudToScene) { + // Checks decoding of a simple glTF with point primitives (no meshes) into + // draco::Scene. + const auto path = GetTestFileFullPath( + "SphereTwoMaterials/sphere_two_materials_point_cloud.gltf"); + draco::GltfDecoder decoder; + DRACO_ASSIGN_OR_ASSERT(auto scene, decoder.DecodeFromFileToScene(path)); + ASSERT_NE(scene, nullptr); + + ASSERT_EQ(scene->NumMeshes(), 2); + + // Check that each point cloud has expected number of points and attributes. + for (draco::MeshIndex mi(0); mi < scene->NumMeshes(); ++mi) { + const auto &mesh = scene->GetMesh(mi); + ASSERT_EQ(mesh.num_faces(), 0); + ASSERT_EQ(mesh.num_points(), 231); + + ASSERT_EQ(mesh.NumNamedAttributes(draco::GeometryAttribute::NORMAL), 1); + ASSERT_EQ(mesh.NumNamedAttributes(draco::GeometryAttribute::TEX_COORD), 1); + ASSERT_EQ(mesh.NumNamedAttributes(draco::GeometryAttribute::TANGENT), 1); + ASSERT_EQ(mesh.NumNamedAttributes(draco::GeometryAttribute::MATERIAL), 0); + } + + // Check the materials are properly assigned to each point cloud. + const auto instances = draco::SceneUtils::ComputeAllInstances(*scene); + ASSERT_EQ(instances.size(), 2); + ASSERT_EQ(draco::SceneUtils::GetMeshInstanceMaterialIndex( + *scene, instances[draco::MeshInstanceIndex(0)]), + 0); + ASSERT_EQ(draco::SceneUtils::GetMeshInstanceMaterialIndex( + *scene, instances[draco::MeshInstanceIndex(1)]), + 1); +} + +TEST(GltfDecoderTest, DecodeMeshAndPointCloudToScene) { + // Checks decoding of a simple glTF with a mesh and point primitives into + // draco::Scene. + const auto path = GetTestFileFullPath( + "SphereTwoMaterials/sphere_two_materials_mesh_and_point_cloud.gltf"); + draco::GltfDecoder decoder; + DRACO_ASSIGN_OR_ASSERT(auto scene, decoder.DecodeFromFileToScene(path)); + ASSERT_NE(scene, nullptr); + + ASSERT_EQ(scene->NumMeshes(), 2); + + // First mesh should be a real mesh while the other one should be a point + // cloud (no faces). Otherwise, they should have the same properties. + for (draco::MeshIndex mi(0); mi < scene->NumMeshes(); ++mi) { + const auto &mesh = scene->GetMesh(mi); + ASSERT_EQ(mesh.num_faces(), mi.value() == 0 ? 224 : 0); + ASSERT_EQ(mesh.num_points(), 231); + + ASSERT_EQ(mesh.NumNamedAttributes(draco::GeometryAttribute::NORMAL), 1); + ASSERT_EQ(mesh.NumNamedAttributes(draco::GeometryAttribute::TEX_COORD), 1); + ASSERT_EQ(mesh.NumNamedAttributes(draco::GeometryAttribute::TANGENT), 1); + } +} + +TEST(GltfDecoderTest, TestLoadUnsupportedTexCoordAttributes) { + // Checks that unsupported attributes (TEXCOORD_2 ... TEXCOORD_7) are ignored + // without causing the decoder to fail. + auto scene = draco::ReadSceneFromTestFile("UnusedTexCoords/TexCoord2.gltf"); + ASSERT_NE(scene, nullptr); + ASSERT_EQ(scene->GetMesh(draco::MeshIndex(0)) + .NumNamedAttributes(draco::GeometryAttribute::TEX_COORD), + 2); +} + +} // namespace draco +#endif // DRACO_TRANSCODER_SUPPORTED diff --git a/contrib/draco/src/draco/io/gltf_encoder.cc b/contrib/draco/src/draco/io/gltf_encoder.cc new file mode 100644 index 000000000..0509b588f --- /dev/null +++ b/contrib/draco/src/draco/io/gltf_encoder.cc @@ -0,0 +1,3662 @@ +// Copyright 2018 The Draco Authors. +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. +// +#include "draco/io/gltf_encoder.h" + +#ifdef DRACO_TRANSCODER_SUPPORTED +#include + +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include + +#include "draco/attributes/geometry_attribute.h" +#include "draco/attributes/point_attribute.h" +#include "draco/compression/draco_compression_options.h" +#include "draco/compression/expert_encode.h" +#include "draco/core/draco_types.h" +#include "draco/core/vector_d.h" +#include "draco/io/file_utils.h" +#include "draco/io/file_writer_utils.h" +#include "draco/io/gltf_utils.h" +#include "draco/io/texture_io.h" +#include "draco/mesh/mesh_features.h" +#include "draco/mesh/mesh_splitter.h" +#include "draco/mesh/mesh_utils.h" +#include "draco/scene/instance_array.h" +#include "draco/scene/scene_indices.h" +#include "draco/scene/scene_utils.h" +#include "draco/texture/texture_utils.h" + +namespace draco { + +// Values are specfified from glTF 2.0 sampler spec. See here for more +// information: +// https://github.com/KhronosGroup/glTF/tree/master/specification/2.0#sampler +int TextureFilterTypeToGltfValue(TextureMap::FilterType filter_type) { + switch (filter_type) { + case TextureMap::NEAREST: + return 9728; + case TextureMap::LINEAR: + return 9729; + case TextureMap::NEAREST_MIPMAP_NEAREST: + return 9984; + case TextureMap::LINEAR_MIPMAP_NEAREST: + return 9985; + case TextureMap::NEAREST_MIPMAP_LINEAR: + return 9986; + case TextureMap::LINEAR_MIPMAP_LINEAR: + return 9987; + default: + return -1; + } +} + +// Values are specfified from glTF 2.0 sampler spec. See here for more +// information: +// https://github.com/KhronosGroup/glTF/tree/master/specification/2.0#sampler +int TextureAxisWrappingModeToGltfValue(TextureMap::AxisWrappingMode mode) { + switch (mode) { + case TextureMap::CLAMP_TO_EDGE: + return 33071; + case TextureMap::MIRRORED_REPEAT: + return 33648; + case TextureMap::REPEAT: + return 10497; + default: + return -1; + } +} + +// Checks |att| metadata entry in |mesh| with key "attribute_name" and returns +// entry value if it begins with "_FEATURE_ID_", or an empty string otherwise. +std::string GetFeatureIdAttributeName(const PointAttribute &att, + const Mesh &mesh) { + const auto *const metadata = + mesh.GetAttributeMetadataByAttributeId(att.unique_id()); + if (metadata) { + std::string attribute_name; + if (metadata->GetEntryString("attribute_name", &attribute_name)) { + constexpr char kPrefix[] = "_FEATURE_ID_"; + if (attribute_name.rfind(kPrefix) == 0) { + return attribute_name; + } + } + } + return std::string(); +} + +// Struct to hold glTF Scene data. +struct GltfScene { + std::vector node_indices; +}; + +// Struct to hold glTF Node data. +struct GltfNode { + GltfNode() + : mesh_index(-1), + skin_index(-1), + light_index(-1), + instance_array_index(-1), + root_node(false) {} + + std::string name; + std::vector childern_indices; + int mesh_index; + int skin_index; + int light_index; + int instance_array_index; + bool root_node; + TrsMatrix trs_matrix; +}; + +// Struct to hold image data. +struct GltfImage { + std::string image_name; + const Texture *texture; + std::unique_ptr owned_texture; + int num_components = 0; + int buffer_view = -1; + std::string mime_type; +}; + +// Struct to hold texture filtering options. The members are based on glTF 2.0 +// samplers. For more information see: +// https://github.com/KhronosGroup/glTF/tree/master/specification/2.0#samplers +struct TextureSampler { + TextureSampler(TextureMap::FilterType min, TextureMap::FilterType mag, + TextureMap::WrappingMode mode) + : min_filter(min), mag_filter(mag), wrapping_mode(mode) {} + + bool operator==(const TextureSampler &other) const { + if (min_filter != other.min_filter) { + return false; + } + if (mag_filter != other.mag_filter) { + return false; + } + return wrapping_mode.s == other.wrapping_mode.s && + wrapping_mode.t == other.wrapping_mode.t; + } + + TextureMap::FilterType min_filter = TextureMap::UNSPECIFIED; + TextureMap::FilterType mag_filter = TextureMap::UNSPECIFIED; + TextureMap::WrappingMode wrapping_mode = {TextureMap::CLAMP_TO_EDGE, + TextureMap::CLAMP_TO_EDGE}; +}; + +// Struct to hold texture data. Multiple textures can reference the same image. +struct GltfTexture { + GltfTexture(int image, int sampler) + : image_index(image), sampler_index(sampler) {} + bool operator==(const GltfTexture &other) const { + return image_index == other.image_index && + sampler_index == other.sampler_index; + } + int image_index; + int sampler_index; +}; + +// Struct to hold glTF Accessor data. +struct GltfAccessor { + GltfAccessor() + : buffer_view_index(-1), + byte_stride(0), + component_type(-1), + normalized(false) {} + + int buffer_view_index; + int byte_stride; + int component_type; + int64_t count; + std::vector max; + std::vector min; + std::string type; + bool normalized; +}; + +// Struct to hold glTF BufferView data. Currently there is only one Buffer, so +// there is no need to store a buffer index. +struct GltfBufferView { + int64_t buffer_byte_offset = -1; + int64_t byte_length = 0; + int target = 0; +}; + +// Struct to hold information about a Draco compressed mesh. +struct GltfDracoCompressedMesh { + int buffer_view_index = -1; + std::map attributes; +}; + +// Struct to hold glTF Primitive data. +struct GltfPrimitive { + GltfPrimitive() : indices(-1), mode(4), material(0) {} + + int indices; + int mode; + int material; + std::vector material_variants_mappings; + std::vector mesh_features; + std::map attributes; + GltfDracoCompressedMesh compressed_mesh_info; +}; + +struct GltfMesh { + std::string name; + std::vector primitives; +}; + +// Class to hold and output glTF data. +class GltfAsset { + public: + // glTF value types and values. + enum ComponentType { + BYTE = 5120, + UNSIGNED_BYTE = 5121, + SHORT = 5122, + UNSIGNED_SHORT = 5123, + UNSIGNED_INT = 5125, + FLOAT = 5126 + }; + // Return the size of the component based on |max_value|. + static int UnsignedIntComponentSize(unsigned int max_value); + + // Return component type based on |max_value|. + static ComponentType UnsignedIntComponentType(unsigned int max_value); + + GltfAsset(); + + std::string generator() const { return generator_; } + std::string version() const { return version_; } + std::string buffer_name() const { return buffer_name_; } + void buffer_name(const std::string &name) { buffer_name_ = name; } + const EncoderBuffer *Buffer() const { return &buffer_; } + + // Convert a Draco Mesh to glTF data. + bool AddDracoMesh(const Mesh &mesh); + + // Convert a Draco Scene to glTF data. + Status AddScene(const Scene &scene); + + // Copy the glTF data to |buf_out|. + Status Output(EncoderBuffer *buf_out); + + // Return the output image referenced by |index|. + const GltfImage *GetImage(int index) const; + + // Return the number of images added to the GltfAsset. + int NumImages() const { return images_.size(); } + + const std::string &image_name(int i) const { return images_[i].image_name; } + + void set_add_images_to_buffer(bool flag) { add_images_to_buffer_ = flag; } + bool add_images_to_buffer() const { return add_images_to_buffer_; } + void set_output_type(GltfEncoder::OutputType type) { output_type_ = type; } + GltfEncoder::OutputType output_type() const { return output_type_; } + void set_json_output_mode(JsonWriter::Mode mode) { gltf_json_.SetMode(mode); } + + private: + // Pad |buffer_| to 4 byte boundary. + bool PadBuffer(); + + // Returns the index of the scene that was added. -1 on error. + int AddScene(); + + // Add a glTF attribute index to |draco_extension|. + void AddAttributeToDracoExtension( + const Mesh &mesh, GeometryAttribute::Type type, int index, + const std::string &name, GltfDracoCompressedMesh *compressed_mesh_info); + + // Compresses |mesh| using Draco. On success returns the buffer_view in + // |primitive| and number of encoded points and faces. + Status CompressMeshWithDraco(const Mesh &mesh, + const Eigen::Matrix4d &transform, + GltfPrimitive *primitive, + int64_t *num_encoded_points, + int64_t *num_encoded_faces); + + // Adds a Draco mesh associated with a material id and material variants. + bool AddDracoMesh(const Mesh &mesh, int material_id, + const std::vector + &material_variants_mappings, + const Eigen::Matrix4d &transform); + + // Add the Draco mesh indices to the glTF data. |num_encoded_faces| is the + // number of faces encoded in |mesh|, which can be different than + // mesh.numfaces(). Returns the index of the accessor that was added. -1 on + // error. + int AddDracoIndices(const Mesh &mesh, int64_t num_encoded_faces); + + // Add the Draco mesh positions attribute to the glTF data. + // |num_encoded_points| is the number of points encoded in |mesh|, which can + // be different than mesh.num_points(). Returns the index of the accessor that + // was added. -1 on error. + int AddDracoPositions(const Mesh &mesh, int num_encoded_points); + + // Add the Draco mesh normals attribute to the glTF data. |num_encoded_points| + // is the number of points encoded in |mesh|, which can be different than + // mesh.num_points(). Returns the index of + // the accessor that was added. -1 on error. + int AddDracoNormals(const Mesh &mesh, int num_encoded_points); + + // Add the Draco mesh vertex color attribute to the glTF data. + // |num_encoded_points| is the number of points encoded in |mesh|, which can + // be different than mesh.num_points(). Returns the index of the accessor that + // was added. -1 on error. + int AddDracoColors(const Mesh &mesh, int num_encoded_points); + + // Add the Draco mesh texture attribute to the glTF data. |tex_coord_index| is + // the index into the texture coordinates added to |mesh|. + // |num_encoded_points| is the number of points encoded in |mesh|, which can + // be different than mesh.num_points(). Returns the index of the accessor that + // was added. -1 on error. + int AddDracoTexture(const Mesh &mesh, int tex_coord_index, + int num_encoded_points); + + // Add the Draco mesh tangent attribute to the glTF data. The Draco mesh + // tangents only contains the x, y, and z components and glTF needs the + // x, y, z, and w components for glTF mesh tangents. Note this is not true + // for tangents of glTF morph targets. This function will add the w component + // to the glTF tangents. |num_encoded_points| is the + // number of points encoded in |mesh|, which can be different than + // mesh.num_points(). Returns the index of the accessor that was added. + // -1 on error. + // Note: Tangents are not added if the attribute contains "auto_generated" + // metadata. See go/tangents_and_draco_simplifier for more details. + int AddDracoTangents(const Mesh &mesh, int num_encoded_points); + + int AddDracoJoints(const Mesh &mesh, int num_encoded_points); + int AddDracoWeights(const Mesh &mesh, int num_encoded_points); + std::vector> AddDracoGenerics( + const Mesh &mesh, int num_encoded_points); + + // Iterate through the materials that are associated with |mesh| and add them + // to the asset. Returns true if |mesh| does not contain any materials or all + // the materials are supported. Returns false if |mesh| contains materials + // that are not supported. + bool AddMaterials(const Mesh &mesh); + + // Checks whether a given Draco |attribute| has data of expected |data_type| + // and whether the data has one of expected |num_components|. Returns true + // when the |attribute| meets expectations, false otherwise. + static bool CheckDracoAttribute(const PointAttribute *attribute, + const std::set &data_types, + const std::set &num_components); + + // Returns the name of |texture|. If |texture|'s name is empty then it will + // generate a name using |texture_index| and |suffix|. If it cannot generate a + // name then it will return an empty string. + std::string GetTextureName(const Texture &texture, int texture_index, + const std::string &suffix) const; + + // Adds a new glTF image to the asset and returns its index. |owned_texture| + // is an optional argument that can be used when the added image is not + // contained in the encoded MaterialLibrary (e.g. for images that are locally + // modified before they are encoded to disk). The image file name is generated + // by combining |image_stem| and image mime type contained in the |texture|. + StatusOr AddImage(const std::string &image_stem, const Texture *texture, + int num_components); + StatusOr AddImage(const std::string &image_stem, const Texture *texture, + std::unique_ptr owned_texture, + int num_components); + + // Saves an image with a given |image_index| into a buffer. + Status SaveImageToBuffer(int image_index); + + // Adds |sampler| to vector of samplers and returns the index. If |sampler| is + // equal to default values then |sampler| is not added to the vector and + // returns -1. + StatusOr AddTextureSampler(const TextureSampler &sampler); + + // Adds a Draco SceneNode, referenced by |scene_node_index|, to the glTF data. + Status AddSceneNode(const Scene &scene, SceneNodeIndex scene_node_index); + + // Iterate through the materials that are associated with |scene| and add them + // to the asset. Returns true if |scene| does not contain any materials or all + // the materials are supported. Returns false if |scene| contains materials + // that are not supported. + bool AddMaterials(const Scene &scene); + + // Iterate through the animations that are associated with |scene| and add + // them to the asset. Returns OkStatus() if |scene| does not contain any + // animations. + Status AddAnimations(const Scene &scene); + + // Converts the data associated with |node_animation_data| and adds that to + // the encoder as an accessor. + StatusOr AddNodeAnimationData( + const NodeAnimationData &node_animation_data); + + // Iterate through the skins that are associated with |scene| and add + // them to the asset. Returns OkStatus() if |scene| does not contain any + // skins. + Status AddSkins(const Scene &scene); + + // Iterate through the lights that are associated with |scene| and add them to + // the asset. Returns OkStatus() if |scene| does not contain any lights. + Status AddLights(const Scene &scene); + + // Iterate through materials variants names that are associated with |scene| + // and add them to the asset. Returns OkStatus() if |scene| does not contain + // any materials variants. + Status AddMaterialsVariantsNames(const Scene &scene); + + // Iterate through the mesh group instance arrays that are associated with + // |scene| and add them to the asset. Returns OkStatus() if |scene| does not + // contain any mesh group instance arrays. + Status AddInstanceArrays(const Scene &scene); + + // Adds structural metadata from |geometry| to the asset, if any. + template + void AddStructuralMetadata(const GeometryT &geometry); + + // Adds float |data| representing |num_components|-length vectors to the + // encoder as accessor and return the new accessor index. + StatusOr AddData(const std::vector &data, int num_components); + + // Adds property table |data| as buffer view and returns buffer view index. + StatusOr AddBufferView(const PropertyTable::Property::Data &data); + + bool EncodeAssetProperty(EncoderBuffer *buf_out); + bool EncodeScenesProperty(EncoderBuffer *buf_out); + bool EncodeInitialSceneProperty(EncoderBuffer *buf_out); + bool EncodeNodesProperty(EncoderBuffer *buf_out); + Status EncodeMeshesProperty(EncoderBuffer *buf_out); + Status EncodePrimitiveExtensionsProperty(const GltfPrimitive &primitive, + EncoderBuffer *buf_out); + Status EncodeMaterials(EncoderBuffer *buf_out); + + // Encodes a color material. |red|, |green|, |blue|, |alpha|, and + // |metallic_factor| are values in the range of 0.0 - 1.0. + void EncodeColorMaterial(float red, float green, float blue, float alpha, + float metallic_factor); + Status EncodeDefaultMaterial(EncoderBuffer *buf_out); + + // Encodes a texture map. |object_name| is the name of the texture map. + // |image_index| is the index into the texture image array. |tex_coord_index| + // is the index into the texture coordinates. |texture_map| is a reference to + // the texture map that is going to be encoded. + Status EncodeTextureMap(const std::string &object_name, int image_index, + int tex_coord_index, const Material &material, + const TextureMap &texture_map); + + // Encodes a texture map similar to the method above. When the |object_name| + // is "texture" and |channels| is not empty, then the |channels| is encoded + // into the "channels" property as required by the "texture" object of the + // EXT_mesh_features extension. + Status EncodeTextureMap(const std::string &object_name, int image_index, + int tex_coord_index, const Material &material, + const TextureMap &texture_map, + const std::vector &channels); + Status EncodeMaterialsProperty(EncoderBuffer *buf_out); + + void EncodeMaterialUnlitExtension(const Material &material); + Status EncodeMaterialSheenExtension(const Material &material, + const Material &defaults, + int material_index); + Status EncodeMaterialTransmissionExtension(const Material &material, + const Material &defaults, + int material_index); + Status EncodeMaterialClearcoatExtension(const Material &material, + const Material &defaults, + int material_index); + Status EncodeMaterialVolumeExtension(const Material &material, + const Material &defaults, + int material_index); + Status EncodeMaterialIorExtension(const Material &material, + const Material &defaults); + Status EncodeMaterialSpecularExtension(const Material &material, + const Material &defaults, + int material_index); + Status EncodeTexture(const std::string &name, const std::string &stem_suffix, + TextureMap::Type type, int num_components, + const Material &material, int material_index); + Status EncodeAnimationsProperty(EncoderBuffer *buf_out); + Status EncodeSkinsProperty(EncoderBuffer *buf_out); + Status EncodeTopLevelExtensionsProperty(EncoderBuffer *buf_out); + Status EncodeLightsProperty(EncoderBuffer *buf_out); + Status EncodeMaterialsVariantsNamesProperty(EncoderBuffer *buf_out); + Status EncodeStructuralMetadataProperty(EncoderBuffer *buf_out); + bool EncodeAccessorsProperty(EncoderBuffer *buf_out); + bool EncodeBufferViewsProperty(EncoderBuffer *buf_out); + bool EncodeBuffersProperty(EncoderBuffer *buf_out); + Status EncodeExtensionsProperties(EncoderBuffer *buf_out); + + // Encodes a draco::VectorNX as a glTF array. + template + void EncodeVectorArray(const std::string &array_name, T vec) { + gltf_json_.BeginArray(array_name); + for (int i = 0; i < T::dimension; ++i) { + gltf_json_.OutputValue(vec[i]); + } + gltf_json_.EndArray(); + } + + // Add a mesh Draco attribute |att| that is comprised of floats to the glTF + // data. Returns the index accessor added to the glTF data. Returns -1 on + // error. + template + int AddAttribute(const PointAttribute &att, int num_points, + int num_encoded_points, bool compress) { + const int num_components = att.num_components(); + switch (num_components) { + case 1: + return AddAttribute<1, att_data_t>(att, num_points, num_encoded_points, + "SCALAR", compress); + break; + case 2: + return AddAttribute<2, att_data_t>(att, num_points, num_encoded_points, + "VEC2", compress); + break; + case 3: + return AddAttribute<3, att_data_t>(att, num_points, num_encoded_points, + "VEC3", compress); + break; + case 4: + return AddAttribute<4, att_data_t>(att, num_points, num_encoded_points, + "VEC4", compress); + break; + default: + break; + } + return -1; + } + + // Template method only has specialized implementations for known glTF types. + template + ComponentType GetComponentType() const = delete; + + template + int AddAttribute(const PointAttribute &att, int num_points, + int num_encoded_points, const std::string &type, + bool compress); + + std::string generator_; + std::string version_; + std::vector scenes_; + + // Initial scene to load. + int scene_index_; + + std::vector nodes_; + std::vector accessors_; + std::vector buffer_views_; + std::vector meshes_; + + // Data structure to copy the input meshes materials. + MaterialLibrary material_library_; + + std::vector images_; + std::vector textures_; + + std::unordered_map texture_to_image_index_map_; + + std::string buffer_name_; + EncoderBuffer buffer_; + JsonWriter gltf_json_; + + // Keeps track if the glTF mesh has been added. + std::map mesh_group_index_to_gltf_mesh_; + std::map> mesh_index_to_gltf_mesh_primitive_; + IndexTypeVector base_mesh_transforms_; + + struct EncoderAnimation { + std::string name; + std::vector> samplers; + std::vector> channels; + }; + std::vector> animations_; + + struct EncoderSkin { + EncoderSkin() : inverse_bind_matrices_index(-1), skeleton_index(-1) {} + int inverse_bind_matrices_index; + std::vector joints; + int skeleton_index; + }; + + // Instance array is represented by its attribute accessors. + struct EncoderInstanceArray { + EncoderInstanceArray() : translation(-1), rotation(-1), scale(-1) {} + int translation; + int rotation; + int scale; + }; + + std::vector> skins_; + std::vector> lights_; + std::vector materials_variants_names_; + std::vector instance_arrays_; + PropertyTable::Schema property_table_schema_; + std::vector property_tables_; + + // Indicates whether Draco compression is used for any of the asset meshes. + bool draco_compression_used_; + + // Indicates whether mesh features are used. + bool mesh_features_used_; + + // Counter for naming mesh feature textures. + int mesh_features_texture_index_; + + // If set GltfAsset will add the images to |buffer_| instead of writing the + // images to separate files. + bool add_images_to_buffer_; + + // Used to hold the extensions used and required by the glTF asset. + std::set extensions_used_; + std::set extensions_required_; + + std::vector texture_samplers_; + + GltfEncoder::OutputType output_type_; + + // Temporary storage for meshes created during the runtime of the GltfEncoder. + // We need to store them here to ensure their content doesn't get deleted + // before it is used by the encoder. + std::vector> local_meshes_; +}; + +int GltfAsset::UnsignedIntComponentSize(unsigned int max_value) { + // According to GLTF 2.0 spec, 0xff (and 0xffff respectively) are reserved for + // the primitive restart symbol. + if (max_value < 0xff) { + return 1; + } else if (max_value < 0xffff) { + return 2; + } + return 4; +} + +GltfAsset::ComponentType GltfAsset::UnsignedIntComponentType( + unsigned int max_value) { + // According to GLTF 2.0 spec, 0xff (and 0xffff respectively) are reserved for + // the primitive restart symbol. + if (max_value < 0xff) { + return UNSIGNED_BYTE; + } else if (max_value < 0xffff) { + return UNSIGNED_SHORT; + } + return UNSIGNED_INT; +} + +GltfAsset::GltfAsset() + : generator_("draco_decoder"), + version_("2.0"), + scene_index_(-1), + buffer_name_("buffer0.bin"), + draco_compression_used_(false), + mesh_features_used_(false), + mesh_features_texture_index_(0), + add_images_to_buffer_(false), + output_type_(GltfEncoder::COMPACT) {} + +bool GltfAsset::AddDracoMesh(const Mesh &mesh) { + const int scene_index = AddScene(); + if (scene_index < 0) { + return false; + } + if (!AddMaterials(mesh)) { + return false; + } + + GltfMesh gltf_mesh; + meshes_.push_back(gltf_mesh); + + AddStructuralMetadata(mesh); + + const int32_t material_att_id = + mesh.GetNamedAttributeId(GeometryAttribute::MATERIAL); + if (material_att_id == -1) { + if (!AddDracoMesh(mesh, 0, {}, Eigen::Matrix4d::Identity())) { + return false; + } + } else { + const auto mat_att = mesh.GetNamedAttribute(GeometryAttribute::MATERIAL); + + // Split mesh using the material attribute. + MeshSplitter splitter; + auto split_maybe = splitter.SplitMesh(mesh, material_att_id); + if (!split_maybe.ok()) { + return false; + } + auto split_meshes = std::move(split_maybe).value(); + for (int i = 0; i < split_meshes.size(); ++i) { + if (split_meshes[i] == nullptr) { + continue; // Empty mesh. Ignore. + } + uint32_t mat_index = 0; + mat_att->GetValue(AttributeValueIndex(i), &mat_index); + + // Copy over mesh features for a given material index. + Mesh::CopyMeshFeaturesForMaterial(mesh, split_meshes[i].get(), mat_index); + + // Move the split mesh to a temporary storage of the GltfAsset. This will + // ensure the mesh will stay alive as long the asset needs it. We have to + // do this because the split mesh may contain mesh features data that are + // used later in the encoding process. + local_meshes_.push_back(std::move(split_meshes[i])); + + // The material index in the glTF file corresponds to the index of the + // split mesh. + if (!AddDracoMesh(*(local_meshes_.back().get()), mat_index, {}, + Eigen::Matrix4d::Identity())) { + return false; + } + } + } + + // Currently output only one mesh. + GltfNode mesh_node; + mesh_node.mesh_index = 0; + nodes_.push_back(mesh_node); + nodes_.back().root_node = true; + return true; +} + +int GltfAsset::AddScene() { + GltfScene scene; + scenes_.push_back(scene); + const int scene_index = static_cast(scenes_.size()) - 1; + + if (scene_index_ == -1) { + scene_index_ = scene_index; + } + return scene_index; +} + +Status GltfAsset::Output(EncoderBuffer *buf_out) { + gltf_json_.BeginObject(); + if (!EncodeAssetProperty(buf_out)) { + return Status(Status::DRACO_ERROR, "Failed encoding asset."); + } + if (!EncodeScenesProperty(buf_out)) { + return Status(Status::DRACO_ERROR, "Failed encoding scenes."); + } + if (!EncodeInitialSceneProperty(buf_out)) { + return Status(Status::DRACO_ERROR, "Failed encoding initial scene."); + } + if (!EncodeNodesProperty(buf_out)) { + return Status(Status::DRACO_ERROR, "Failed encoding nodes."); + } + DRACO_RETURN_IF_ERROR(EncodeMeshesProperty(buf_out)); + DRACO_RETURN_IF_ERROR(EncodeMaterials(buf_out)); + if (!EncodeAccessorsProperty(buf_out)) { + return Status(Status::DRACO_ERROR, "Failed encoding accessors."); + } + DRACO_RETURN_IF_ERROR(EncodeAnimationsProperty(buf_out)); + DRACO_RETURN_IF_ERROR(EncodeSkinsProperty(buf_out)); + DRACO_RETURN_IF_ERROR(EncodeTopLevelExtensionsProperty(buf_out)); + if (!EncodeBufferViewsProperty(buf_out)) { + return Status(Status::DRACO_ERROR, "Failed encoding buffer views."); + } + if (!EncodeBuffersProperty(buf_out)) { + return Status(Status::DRACO_ERROR, "Failed encoding buffers."); + } + DRACO_RETURN_IF_ERROR(EncodeExtensionsProperties(buf_out)); + gltf_json_.EndObject(); + + const std::string asset_str = gltf_json_.MoveData(); + if (!buf_out->Encode(asset_str.data(), asset_str.length())) { + return Status(Status::DRACO_ERROR, "Failed encoding json data."); + } + if (!buf_out->Encode("\n", 1)) { + return Status(Status::DRACO_ERROR, "Failed encoding json data."); + } + return OkStatus(); +} + +const GltfImage *GltfAsset::GetImage(int index) const { + if (index < 0 || index >= images_.size()) { + return nullptr; + } + return &images_[index]; +} + +bool GltfAsset::PadBuffer() { + if (buffer_.size() % 4 != 0) { + const int pad_bytes = 4 - buffer_.size() % 4; + const int pad_data = 0; + if (!buffer_.Encode(&pad_data, pad_bytes)) { + return false; + } + } + return true; +} + +void GltfAsset::AddAttributeToDracoExtension( + const Mesh &mesh, GeometryAttribute::Type type, int index, + const std::string &name, GltfDracoCompressedMesh *compressed_mesh_info) { + if (mesh.IsCompressionEnabled()) { + const PointAttribute *const att = mesh.GetNamedAttribute(type, index); + if (att) { + compressed_mesh_info->attributes.insert( + std::pair(name, att->unique_id())); + } + } +} + +Status GltfAsset::CompressMeshWithDraco(const Mesh &mesh, + const Eigen::Matrix4d &transform, + GltfPrimitive *primitive, + int64_t *num_encoded_points, + int64_t *num_encoded_faces) { + // Check that geometry comression options are valid. + DracoCompressionOptions compression_options = mesh.GetCompressionOptions(); + DRACO_RETURN_IF_ERROR(compression_options.Check()); + + // Make a copy of the mesh. It will be modified and compressed. + std::unique_ptr mesh_copy(new Mesh()); + mesh_copy->Copy(mesh); + + // Delete auto-generated tangents. + if (MeshUtils::HasAutoGeneratedTangents(*mesh_copy)) { + for (int i = 0; i < mesh_copy->num_attributes(); ++i) { + PointAttribute *const att = mesh_copy->attribute(i); + if (att->attribute_type() == GeometryAttribute::TANGENT) { + while (mesh_copy->GetNamedAttribute(GeometryAttribute::TANGENT)) { + mesh_copy->DeleteAttribute( + mesh_copy->GetNamedAttributeId(GeometryAttribute::TANGENT)); + } + break; + } + } + } + + // Create Draco encoder. + EncoderBuffer buffer; + ExpertEncoder encoder(*mesh_copy); + encoder.SetTrackEncodedProperties(true); + + // Convert compression level to speed (that 0 = slowest, 10 = fastest). + const int speed = 10 - compression_options.compression_level; + encoder.SetSpeedOptions(speed, speed); + + // Configure attribute quantization. + for (int i = 0; i < mesh_copy->num_attributes(); ++i) { + const PointAttribute *const att = mesh_copy->attribute(i); + if (att->attribute_type() == GeometryAttribute::POSITION && + !compression_options.quantization_position + .AreQuantizationBitsDefined()) { + // Desired spacing in the "global" coordinate system. + const float global_spacing = + compression_options.quantization_position.spacing(); + + // Note: Ideally we would transform the whole mesh before encoding and + // apply the original global spacing on the transformed mesh. But neither + // KHR_draco_mesh_compression, nor Draco bitstream support post-decoding + // transformations so we have to modify the grid settings here. + + // Transform this spacing to the local coordinate system of the base mesh. + // We will get the largest scale factor from the transformation matrix and + // use it to adjust the grid spacing. + const Vector3f scale_vec(transform.col(0).norm(), transform.col(1).norm(), + transform.col(2).norm()); + + const float max_scale = scale_vec.MaxCoeff(); + + // Spacing is inverse to the scale. The larger the scale, the smaller the + // spacing must be. + const float local_spacing = global_spacing / max_scale; + + // Update the compression options of the processed mesh. + compression_options.quantization_position.SetGrid(local_spacing); + } else { + int num_quantization_bits = -1; + switch (att->attribute_type()) { + case GeometryAttribute::POSITION: + num_quantization_bits = + compression_options.quantization_position.quantization_bits(); + break; + case GeometryAttribute::NORMAL: + num_quantization_bits = compression_options.quantization_bits_normal; + break; + case GeometryAttribute::TEX_COORD: + num_quantization_bits = + compression_options.quantization_bits_tex_coord; + break; + case GeometryAttribute::TANGENT: + num_quantization_bits = compression_options.quantization_bits_tangent; + break; + case GeometryAttribute::WEIGHTS: + num_quantization_bits = compression_options.quantization_bits_weight; + break; + case GeometryAttribute::GENERIC: + if (GetFeatureIdAttributeName(*att, *mesh_copy).empty()) { + num_quantization_bits = + compression_options.quantization_bits_generic; + } else { + // Quantization is explicitly disabled for feature ID attributes. + encoder.SetAttributeQuantization(i, -1); + } + break; + default: + break; + } + if (num_quantization_bits > 0) { + encoder.SetAttributeQuantization(i, num_quantization_bits); + } + } + } + + // Flip UV values as required by glTF Draco and non-Draco files. + for (int i = 0; i < mesh_copy->num_attributes(); ++i) { + PointAttribute *const att = mesh_copy->attribute(i); + if (att->attribute_type() == GeometryAttribute::TEX_COORD) { + if (!MeshUtils::FlipTextureUvValues(false, true, att)) { + return Status(Status::DRACO_ERROR, "Could not flip texture UV values."); + } + } + } + + // Change tangents, joints, and weights attribute types to generic. The + // original mesh's attribute type is unchanged and the mapping of the glTF + // attribute type to Draco compressed attribute id is written to the output + // glTF file. + for (int i = 0; i < mesh_copy->num_attributes(); ++i) { + PointAttribute *const att = mesh_copy->attribute(i); + if (att->attribute_type() == GeometryAttribute::TANGENT || + att->attribute_type() == GeometryAttribute::JOINTS || + att->attribute_type() == GeometryAttribute::WEIGHTS) { + att->set_attribute_type(GeometryAttribute::GENERIC); + } + } + + // |compression_options| may have been modified and we need to update them + // before we start the encoding. + mesh_copy->SetCompressionOptions(compression_options); + DRACO_RETURN_IF_ERROR(encoder.EncodeToBuffer(&buffer)); + *num_encoded_points = encoder.num_encoded_points(); + *num_encoded_faces = encoder.num_encoded_faces(); + const size_t buffer_start_offset = buffer_.size(); + if (!buffer_.Encode(buffer.data(), buffer.size())) { + return Status(Status::DRACO_ERROR, "Could not copy Draco compressed data."); + } + if (!PadBuffer()) { + return Status(Status::DRACO_ERROR, "Could not pad glTF buffer."); + } + + GltfBufferView buffer_view; + buffer_view.buffer_byte_offset = buffer_start_offset; + buffer_view.byte_length = buffer_.size() - buffer_start_offset; + buffer_views_.push_back(buffer_view); + primitive->compressed_mesh_info.buffer_view_index = + static_cast(buffer_views_.size() - 1); + return OkStatus(); +} + +bool CheckAndGetTexCoordAttributeOrder(const Mesh &mesh, + std::vector *tex_coord_order) { + // We will only consider at most two texture coordinate attributes. + *tex_coord_order = {0, 1}; + const int num_attributes = + std::min(mesh.NumNamedAttributes(GeometryAttribute::TEX_COORD), 2); + + // Collect texture coordinate attribute names from metadata. + std::vector names(num_attributes, ""); + for (int i = 0; i < num_attributes; i++) { + const auto metadata = mesh.GetAttributeMetadataByAttributeId( + mesh.GetNamedAttributeId(GeometryAttribute::TEX_COORD, i)); + std::string attribute_name; + if (metadata != nullptr) { + metadata->GetEntryString("attribute_name", &attribute_name); + names[i] = attribute_name; + } + } + + // Attribute names may be absent. + if (num_attributes == 0 || + std::all_of(names.begin(), names.end(), + [](const std::string &name) { return name.empty(); })) { + return true; + } + + // Attribute names must be unique. + const std::unordered_set unique_names(names.begin(), + names.end()); + if (unique_names.size() != num_attributes) { + return false; + } + + // Attribute names must be valid. + if (std::any_of(names.begin(), names.end(), [](const std::string &name) { + return name != "TEXCOORD_0" && name != "TEXCOORD_1"; + })) { + return false; + } + + // Populate texture coordinate order index based on attribute names. + if (names[0] == "TEXCOORD_1") { + *tex_coord_order = {1, 0}; + } + return true; +} + +bool GltfAsset::AddDracoMesh( + const Mesh &mesh, int material_id, + const std::vector + &material_variants_mappings, + const Eigen::Matrix4d &transform) { + GltfPrimitive primitive; + int64_t num_encoded_points = mesh.num_points(); + int64_t num_encoded_faces = mesh.num_faces(); + if (num_encoded_faces > 0 && mesh.IsCompressionEnabled()) { + const Status status = CompressMeshWithDraco( + mesh, transform, &primitive, &num_encoded_points, &num_encoded_faces); + if (!status.ok()) { + return false; + } + draco_compression_used_ = true; + } + int indices_index = -1; + if (num_encoded_faces > 0) { + indices_index = AddDracoIndices(mesh, num_encoded_faces); + if (indices_index < 0) { + return false; + } + } + const int position_index = AddDracoPositions(mesh, num_encoded_points); + if (position_index < 0) { + return false; + } + // Check texture coordinate attributes and get the desired encoding order. + std::vector tex_coord_order; + if (!CheckAndGetTexCoordAttributeOrder(mesh, &tex_coord_order)) { + return false; + } + const int normals_accessor_index = AddDracoNormals(mesh, num_encoded_points); + const int colors_accessor_index = AddDracoColors(mesh, num_encoded_points); + const int texture0_accessor_index = + AddDracoTexture(mesh, tex_coord_order[0], num_encoded_points); + const int texture1_accessor_index = + AddDracoTexture(mesh, tex_coord_order[1], num_encoded_points); + const int tangent_accessor_index = AddDracoTangents(mesh, num_encoded_points); + const int joints_accessor_index = AddDracoJoints(mesh, num_encoded_points); + const int weights_accessor_index = AddDracoWeights(mesh, num_encoded_points); + const std::vector> generics_accessors = + AddDracoGenerics(mesh, num_encoded_points); + + if (num_encoded_faces == 0) { + primitive.mode = 0; // POINTS mode. + } + primitive.material = material_id; + primitive.material_variants_mappings = material_variants_mappings; + primitive.mesh_features.reserve(mesh.NumMeshFeatures()); + for (MeshFeaturesIndex i(0); i < mesh.NumMeshFeatures(); ++i) { + primitive.mesh_features.push_back(&mesh.GetMeshFeatures(i)); + } + primitive.indices = indices_index; + primitive.attributes.insert( + std::pair("POSITION", position_index)); + AddAttributeToDracoExtension(mesh, GeometryAttribute::POSITION, 0, "POSITION", + &primitive.compressed_mesh_info); + if (normals_accessor_index > 0) { + primitive.attributes.insert( + std::pair("NORMAL", normals_accessor_index)); + AddAttributeToDracoExtension(mesh, GeometryAttribute::NORMAL, 0, "NORMAL", + &primitive.compressed_mesh_info); + } + if (colors_accessor_index > 0) { + primitive.attributes.insert( + std::pair("COLOR_0", colors_accessor_index)); + AddAttributeToDracoExtension(mesh, GeometryAttribute::COLOR, 0, "COLOR_0", + &primitive.compressed_mesh_info); + } + if (texture0_accessor_index > 0) { + primitive.attributes.insert( + std::pair("TEXCOORD_0", texture0_accessor_index)); + AddAttributeToDracoExtension(mesh, GeometryAttribute::TEX_COORD, 0, + "TEXCOORD_0", &primitive.compressed_mesh_info); + } + if (texture1_accessor_index > 0) { + primitive.attributes.insert( + std::pair("TEXCOORD_1", texture1_accessor_index)); + AddAttributeToDracoExtension(mesh, GeometryAttribute::TEX_COORD, 1, + "TEXCOORD_1", &primitive.compressed_mesh_info); + } + if (tangent_accessor_index > 0) { + primitive.attributes.insert( + std::pair("TANGENT", tangent_accessor_index)); + AddAttributeToDracoExtension(mesh, GeometryAttribute::TANGENT, 0, "TANGENT", + &primitive.compressed_mesh_info); + } + if (joints_accessor_index > 0) { + primitive.attributes.insert( + std::pair("JOINTS_0", joints_accessor_index)); + AddAttributeToDracoExtension(mesh, GeometryAttribute::JOINTS, 0, "JOINTS_0", + &primitive.compressed_mesh_info); + } + if (weights_accessor_index > 0) { + primitive.attributes.insert( + std::pair("WEIGHTS_0", weights_accessor_index)); + AddAttributeToDracoExtension(mesh, GeometryAttribute::WEIGHTS, 0, + "WEIGHTS_0", &primitive.compressed_mesh_info); + } + for (int att_index = 0; att_index < generics_accessors.size(); ++att_index) { + const std::string &attribute_name = generics_accessors[att_index].first; + if (!attribute_name.empty()) { + primitive.attributes.insert(generics_accessors[att_index]); + AddAttributeToDracoExtension(mesh, GeometryAttribute::GENERIC, att_index, + attribute_name, + &primitive.compressed_mesh_info); + } + } + + meshes_.back().primitives.push_back(primitive); + return true; +} + +int GltfAsset::AddDracoIndices(const Mesh &mesh, int64_t num_encoded_faces) { + // Get the min and max value for the indices. + uint32_t min_index = 0xffffffff; + uint32_t max_index = 0; + for (FaceIndex i(0); i < mesh.num_faces(); ++i) { + const auto &f = mesh.face(i); + + for (int j = 0; j < 3; ++j) { + if (f[j] < min_index) { + min_index = f[j].value(); + } + if (f[j] > max_index) { + max_index = f[j].value(); + } + } + } + + const int component_size = GltfAsset::UnsignedIntComponentSize(max_index); + + GltfAccessor accessor; + if (!mesh.IsCompressionEnabled()) { + const size_t buffer_start_offset = buffer_.size(); + for (FaceIndex i(0); i < mesh.num_faces(); ++i) { + const auto &f = mesh.face(i); + for (int j = 0; j < 3; ++j) { + int index = f[j].value(); + if (!buffer_.Encode(&index, component_size)) { + return -1; + } + } + } + + if (!PadBuffer()) { + return -1; + } + + GltfBufferView buffer_view; + buffer_view.buffer_byte_offset = buffer_start_offset; + buffer_view.byte_length = buffer_.size() - buffer_start_offset; + buffer_views_.push_back(buffer_view); + accessor.buffer_view_index = static_cast(buffer_views_.size() - 1); + } + + accessor.component_type = UnsignedIntComponentType(max_index); + accessor.count = num_encoded_faces * 3; + if (output_type_ == GltfEncoder::VERBOSE) { + accessor.max.push_back(GltfValue(max_index)); + accessor.min.push_back(GltfValue(min_index)); + } + accessor.type = "SCALAR"; + accessors_.push_back(accessor); + return static_cast(accessors_.size() - 1); +} + +int GltfAsset::AddDracoPositions(const Mesh &mesh, int num_encoded_points) { + const PointAttribute *const att = + mesh.GetNamedAttribute(GeometryAttribute::POSITION); + if (!CheckDracoAttribute(att, {DT_FLOAT32}, {3})) { + return -1; + } + return AddAttribute(*att, mesh.num_points(), num_encoded_points, + mesh.IsCompressionEnabled()); +} + +int GltfAsset::AddDracoNormals(const Mesh &mesh, int num_encoded_points) { + const PointAttribute *const att = + mesh.GetNamedAttribute(GeometryAttribute::NORMAL); + if (!CheckDracoAttribute(att, {DT_FLOAT32}, {3})) { + return -1; + } + return AddAttribute(*att, mesh.num_points(), num_encoded_points, + mesh.IsCompressionEnabled()); +} + +int GltfAsset::AddDracoColors(const Mesh &mesh, int num_encoded_points) { + const PointAttribute *const att = + mesh.GetNamedAttribute(GeometryAttribute::COLOR); + // TODO(b/200302561): Add support for DT_UINT16 with COLOR. + if (!CheckDracoAttribute(att, {DT_UINT8, DT_FLOAT32}, {3, 4})) { + return -1; + } + if (att->data_type() == DT_FLOAT32) { + return AddAttribute(*att, mesh.num_points(), num_encoded_points, + mesh.IsCompressionEnabled()); + } + return AddAttribute(*att, mesh.num_points(), num_encoded_points, + mesh.IsCompressionEnabled()); +} + +int GltfAsset::AddDracoTexture(const Mesh &mesh, int tex_coord_index, + int num_encoded_points) { + const PointAttribute *const att = + mesh.GetNamedAttribute(GeometryAttribute::TEX_COORD, tex_coord_index); + // TODO(b/200303080): Add support for DT_UINT8 and DT_UINT16 with TEX_COORD. + if (!CheckDracoAttribute(att, {DT_FLOAT32}, {2})) { + return -1; + } + + // glTF stores texture coordinates flipped on the horizontal axis compared to + // how Draco stores texture coordinates. + GeometryAttribute ga; + ga.Init(GeometryAttribute::TEX_COORD, nullptr, 2, att->data_type(), false, + DataTypeLength(att->data_type()) * 2, 0); + PointAttribute ta(ga); + ta.SetIdentityMapping(); + ta.Reset(mesh.num_points()); + + std::array value; + for (PointIndex v(0); v < mesh.num_points(); ++v) { + if (!att->GetValue(att->mapped_index(v), &value)) { + return -1; + } + + // Draco texture v component needs to be flipped. + Vector2f texture_coord(value[0], 1.0 - value[1]); + ta.SetAttributeValue(AttributeValueIndex(v.value()), texture_coord.data()); + } + return AddAttribute(ta, mesh.num_points(), num_encoded_points, + mesh.IsCompressionEnabled()); +} + +int GltfAsset::AddDracoTangents(const Mesh &mesh, int num_encoded_points) { + const PointAttribute *const att = + mesh.GetNamedAttribute(GeometryAttribute::TANGENT); + if (!CheckDracoAttribute(att, {DT_FLOAT32}, {3, 4})) { + return -1; + } + if (MeshUtils::HasAutoGeneratedTangents(mesh)) { + // Ignore auto-generated tangents. See go/tangents_and_draco_simplifier. + return -1; + } + + if (att->num_components() == 4) { + return AddAttribute(*att, mesh.num_points(), num_encoded_points, + mesh.IsCompressionEnabled()); + } + + // glTF mesh needs the w component. + GeometryAttribute ga; + ga.Init(GeometryAttribute::TANGENT, nullptr, 4, DT_FLOAT32, false, + DataTypeLength(DT_FLOAT32) * 4, 0); + PointAttribute ta(ga); + ta.SetIdentityMapping(); + ta.Reset(mesh.num_points()); + + std::array value; + for (PointIndex v(0); v < mesh.num_points(); ++v) { + if (!att->GetValue(att->mapped_index(v), &value)) { + return -1; + } + + // Draco tangent w component is always 1.0. + Vector4f tangent(value[0], value[1], value[2], 1.0); + ta.SetAttributeValue(AttributeValueIndex(v.value()), tangent.data()); + } + return AddAttribute(ta, mesh.num_points(), num_encoded_points, + mesh.IsCompressionEnabled()); +} + +int GltfAsset::AddDracoJoints(const Mesh &mesh, int num_encoded_points) { + const PointAttribute *const att = + mesh.GetNamedAttribute(GeometryAttribute::JOINTS); + if (!CheckDracoAttribute(att, {DT_UINT8, DT_UINT16}, {4})) { + return -1; + } + if (att->data_type() == DT_UINT16) { + return AddAttribute(*att, mesh.num_points(), num_encoded_points, + mesh.IsCompressionEnabled()); + } + return AddAttribute(*att, mesh.num_points(), num_encoded_points, + mesh.IsCompressionEnabled()); +} + +int GltfAsset::AddDracoWeights(const Mesh &mesh, int num_encoded_points) { + const PointAttribute *const att = + mesh.GetNamedAttribute(GeometryAttribute::WEIGHTS); + // TODO(b/200303026): Add support for DT_UINT8 and DT_UINT16 with WEIGHTS. + if (!CheckDracoAttribute(att, {DT_FLOAT32}, {4})) { + return -1; + } + return AddAttribute(*att, mesh.num_points(), num_encoded_points, + mesh.IsCompressionEnabled()); +} + +// Adds generic attributes that have metadata describing the attribute name. +// This allows for export of application-specific attributes and feature ID +// attributes defined in glTF extension EXT_mesh_features. Returns a vector of +// attribute-name, accessor pairs for each valid attribute. The length of the +// vector is equal to the number of generic attributes. Vector entries +// corresponding to unsupported attributes (e.g., with no metadata) contain +// empty attribute names. +std::vector> GltfAsset::AddDracoGenerics( + const Mesh &mesh, int num_encoded_points) { + const int num_attributes = + mesh.NumNamedAttributes(GeometryAttribute::GENERIC); + std::vector> attrs(num_attributes); + for (int i = 0; i < num_attributes; ++i) { + const PointAttribute *const att = + mesh.GetNamedAttribute(GeometryAttribute::GENERIC, i); + auto const *metadata = + mesh.GetAttributeMetadataByAttributeId(att->unique_id()); + if (metadata) { + std::string attr_name; + if (metadata->GetEntryString(GltfEncoder::kDracoMetadataGltfAttributeName, + &attr_name)) { + if (att->data_type() == DT_FLOAT32) { + int accessor = + AddAttribute(*att, mesh.num_points(), num_encoded_points, + mesh.IsCompressionEnabled()); + attrs[i] = {attr_name, accessor}; + } + } else { + // Try to find feature ID attribute name like "_FEATURE_ID_5" then check + // that the attribute stores scalar values of complient data types as + // defined by the EXT_mesh_features glTF extension. + attr_name = GetFeatureIdAttributeName(*att, mesh); + if (!attr_name.empty() && att->num_components() == 1) { + int accessor = -1; + switch (att->data_type()) { + case DT_UINT8: + accessor = AddAttribute(*att, mesh.num_points(), + num_encoded_points, + mesh.IsCompressionEnabled()); + break; + case DT_UINT16: + accessor = AddAttribute(*att, mesh.num_points(), + num_encoded_points, + mesh.IsCompressionEnabled()); + break; + case DT_FLOAT32: + accessor = AddAttribute(*att, mesh.num_points(), + num_encoded_points, + mesh.IsCompressionEnabled()); + break; + default: + continue; + } + attrs[i] = {attr_name, accessor}; + } + } + } + } + return attrs; +} + +bool GltfAsset::AddMaterials(const Mesh &mesh) { + if (mesh.GetMaterialLibrary().NumMaterials() == 0) { + return true; + } + material_library_.Copy(mesh.GetMaterialLibrary()); + return true; +} + +bool GltfAsset::CheckDracoAttribute(const PointAttribute *attribute, + const std::set &data_types, + const std::set &num_components) { + // Attribute must be valid. + if (attribute == nullptr || attribute->size() == 0) { + return false; + } + + // Attribute must have an expected data type. + if (data_types.find(attribute->data_type()) == data_types.end()) { + return false; + } + + // Attribute must have an expected number of components. + if (num_components.find(attribute->num_components()) == + num_components.end()) { + return false; + } + + return true; +} + +StatusOr GltfAsset::AddImage(const std::string &image_stem, + const Texture *texture, int num_components) { + return AddImage(image_stem, texture, nullptr, num_components); +} + +StatusOr GltfAsset::AddImage(const std::string &image_stem, + const Texture *texture, + std::unique_ptr owned_texture, + int num_components) { + const auto it = texture_to_image_index_map_.find(texture); + if (it != texture_to_image_index_map_.end()) { + // We already have an image for the given |texture|. Update its number of + // components if needed. + GltfImage &image = images_[it->second]; + if (image.num_components < num_components) { + image.num_components = num_components; + } + return it->second; + } + std::string extension = TextureUtils::GetTargetExtension(*texture); + if (extension.empty()) { + // Try to get extension from the source file name. + extension = LowercaseFileExtension(texture->source_image().filename()); + } + GltfImage image; + image.image_name = image_stem + "." + extension; + image.texture = texture; + image.owned_texture = std::move(owned_texture); + image.num_components = num_components; + + // Always maintain the mime_type. Used elsewhere to determine image type. + if (extension == "jpg") { + image.mime_type = "image/jpeg"; + } else { + image.mime_type = "image/" + extension; + } + + // For KTX2 with Basis compression, state that its extension is required. + if (extension == "ktx2") { + extensions_used_.insert("KHR_texture_basisu"); + extensions_required_.insert("KHR_texture_basisu"); + } + + // If this is webp, state that its extension is required. + if (extension == "webp") { + extensions_used_.insert("EXT_texture_webp"); + extensions_required_.insert("EXT_texture_webp"); + } + + images_.push_back(std::move(image)); + texture_to_image_index_map_[texture] = images_.size() - 1; + return images_.size() - 1; +} + +Status GltfAsset::SaveImageToBuffer(int image_index) { + GltfImage &image = images_[image_index]; + const Texture *const texture = image.texture; + const int num_components = image.num_components; + std::vector buffer; + DRACO_RETURN_IF_ERROR(WriteTextureToBuffer(*texture, &buffer)); + + // Add the image data to the buffer. + const size_t buffer_start_offset = buffer_.size(); + buffer_.Encode(buffer.data(), buffer.size()); + if (!PadBuffer()) { + return Status(Status::DRACO_ERROR, + "Could not pad buffer in SaveImageToBuffer."); + } + + // Add a buffer view pointing to the image data in the buffer. + GltfBufferView buffer_view; + buffer_view.buffer_byte_offset = buffer_start_offset; + buffer_view.byte_length = buffer_.size() - buffer_start_offset; + buffer_views_.push_back(buffer_view); + + image.buffer_view = buffer_views_.size() - 1; + return OkStatus(); +} + +// TODO(vytyaz): The return type could be int. +StatusOr GltfAsset::AddTextureSampler(const TextureSampler &sampler) { + // If sampler is equal to defaults do not add to vector and return -1. + if (sampler.min_filter == TextureMap::UNSPECIFIED && + sampler.mag_filter == TextureMap::UNSPECIFIED && + sampler.wrapping_mode.s == TextureMap::REPEAT && + sampler.wrapping_mode.t == TextureMap::REPEAT) { + return -1; + } + + const auto &it = + std::find(texture_samplers_.begin(), texture_samplers_.end(), sampler); + if (it != texture_samplers_.end()) { + const int index = std::distance(texture_samplers_.begin(), it); + return index; + } + + texture_samplers_.push_back(sampler); + return texture_samplers_.size() - 1; +} + +Status GltfAsset::AddScene(const Scene &scene) { + const int scene_index = AddScene(); + if (scene_index < 0) { + return Status(Status::DRACO_ERROR, "Error creating a new scene."); + } + if (!AddMaterials(scene)) { + return Status(Status::DRACO_ERROR, "Error adding materials to the scene."); + } + // Initialize base mesh transforms that may be needed when the base meshes are + // compressed with Draco. + base_mesh_transforms_ = SceneUtils::FindLargestBaseMeshTransforms(scene); + for (SceneNodeIndex i(0); i < scene.NumNodes(); ++i) { + DRACO_RETURN_IF_ERROR(AddSceneNode(scene, i)); + } + // There is 1:1 mapping between draco::Scene node indices and |nodes_|. + for (int i = 0; i < scene.NumRootNodes(); ++i) { + nodes_[scene.GetRootNodeIndex(i).value()].root_node = true; + } + DRACO_RETURN_IF_ERROR(AddAnimations(scene)); + DRACO_RETURN_IF_ERROR(AddSkins(scene)); + DRACO_RETURN_IF_ERROR(AddLights(scene)); + DRACO_RETURN_IF_ERROR(AddMaterialsVariantsNames(scene)); + DRACO_RETURN_IF_ERROR(AddInstanceArrays(scene)); + AddStructuralMetadata(scene); + return OkStatus(); +} + +Status GltfAsset::AddSceneNode(const Scene &scene, + SceneNodeIndex scene_node_index) { + const SceneNode *const scene_node = scene.GetNode(scene_node_index); + if (scene_node == nullptr) { + return Status(Status::DRACO_ERROR, "Could not find node in scene."); + } + + GltfNode node; + node.name = scene_node->GetName(); + node.trs_matrix.Copy(scene_node->GetTrsMatrix()); + + for (int i = 0; i < scene_node->NumChildren(); ++i) { + node.childern_indices.push_back(scene_node->Child(i).value()); + } + + const MeshGroupIndex mesh_group_index = scene_node->GetMeshGroupIndex(); + if (mesh_group_index != kInvalidMeshGroupIndex) { + const auto it = mesh_group_index_to_gltf_mesh_.find(mesh_group_index); + if (it == mesh_group_index_to_gltf_mesh_.end()) { + GltfMesh gltf_mesh; + const MeshGroup *const mesh_group = scene.GetMeshGroup(mesh_group_index); + if (!mesh_group->GetName().empty()) { + gltf_mesh.name = mesh_group->GetName(); + } + meshes_.push_back(gltf_mesh); + + for (int i = 0; i < mesh_group->NumMeshInstances(); ++i) { + const MeshGroup::MeshInstance &instance = + mesh_group->GetMeshInstance(i); + const auto mi_it = + mesh_index_to_gltf_mesh_primitive_.find(instance.mesh_index); + if (mi_it == mesh_index_to_gltf_mesh_primitive_.end()) { + // We have not added the mesh to the scene yet. + const Mesh &mesh = scene.GetMesh(instance.mesh_index); + if (!AddDracoMesh(mesh, instance.material_index, + instance.materials_variants_mappings, + base_mesh_transforms_[instance.mesh_index])) { + return Status(Status::DRACO_ERROR, "Adding a Draco mesh failed."); + } + const int gltf_mesh_index = meshes_.size() - 1; + const int gltf_primitive_index = meshes_.back().primitives.size() - 1; + mesh_index_to_gltf_mesh_primitive_[instance.mesh_index] = + std::make_pair(gltf_mesh_index, gltf_primitive_index); + } else { + // The mesh was already added to the scene. This is a copy instance + // that may have a different material. + const int gltf_mesh_index = mi_it->second.first; + const int gltf_primitive_index = mi_it->second.second; + GltfPrimitive primitive = + meshes_[gltf_mesh_index].primitives[gltf_primitive_index]; + primitive.material = instance.material_index; + primitive.material_variants_mappings = + instance.materials_variants_mappings; + const Mesh &mesh = scene.GetMesh(instance.mesh_index); + primitive.mesh_features.clear(); + primitive.mesh_features.reserve(mesh.NumMeshFeatures()); + for (MeshFeaturesIndex j(0); j < mesh.NumMeshFeatures(); ++j) { + primitive.mesh_features.push_back(&mesh.GetMeshFeatures(j)); + } + meshes_.back().primitives.push_back(primitive); + } + } + mesh_group_index_to_gltf_mesh_[mesh_group_index] = meshes_.size() - 1; + } + node.mesh_index = mesh_group_index_to_gltf_mesh_[mesh_group_index]; + } + node.skin_index = scene_node->GetSkinIndex().value(); + node.light_index = scene_node->GetLightIndex().value(); + node.instance_array_index = scene_node->GetInstanceArrayIndex().value(); + + nodes_.push_back(node); + return OkStatus(); +} + +bool GltfAsset::AddMaterials(const Scene &scene) { + if (scene.GetMaterialLibrary().NumMaterials() == 0) { + return true; + } + material_library_.Copy(scene.GetMaterialLibrary()); + return true; +} + +Status GltfAsset::AddAnimations(const Scene &scene) { + if (scene.NumAnimations() == 0) { + return OkStatus(); + } + // Mapping of the node animation data to the output accessors. The first part + // of the key is the animation index and the second part of the key is the + // node animation data index. + std::map, int> node_animation_data_to_accessor; + + // Mapping of the node animation data to the output accessors. + std::unordered_map + data_to_index_map; + + // First add all the accessors and create a mapping from animation accessors + // to accessors owned by the encoder. + for (AnimationIndex i(0); i < scene.NumAnimations(); ++i) { + const Animation *const animation = scene.GetAnimation(i); + + for (int j = 0; j < animation->NumNodeAnimationData(); ++j) { + const NodeAnimationData *const node_animation_data = + animation->GetNodeAnimationData(j); + + int index = -1; + + NodeAnimationDataHash nadh(node_animation_data); + if (data_to_index_map.find(nadh) == data_to_index_map.end()) { + // The current data is new, add it to the encoder. + DRACO_ASSIGN_OR_RETURN( + index, AddNodeAnimationData(*nadh.GetNodeAnimationData())); + data_to_index_map[nadh] = index; + } else { + index = data_to_index_map[nadh]; + } + + const auto key = std::make_pair(i.value(), j); + node_animation_data_to_accessor[key] = index; + } + } + + // Add all the samplers and channels. + for (AnimationIndex i(0); i < scene.NumAnimations(); ++i) { + const Animation *const animation = scene.GetAnimation(i); + std::unique_ptr new_animation(new EncoderAnimation); + new_animation->name = animation->GetName(); + + for (int j = 0; j < animation->NumSamplers(); ++j) { + const AnimationSampler *const sampler = animation->GetSampler(j); + const auto input_key = std::make_pair(i.value(), sampler->input_index); + const auto input_it = node_animation_data_to_accessor.find(input_key); + if (input_it == node_animation_data_to_accessor.end()) { + return Status(Status::DRACO_ERROR, + "Could not find animation accessor input index."); + } + const auto output_key = std::make_pair(i.value(), sampler->output_index); + const auto output_it = node_animation_data_to_accessor.find(output_key); + if (output_it == node_animation_data_to_accessor.end()) { + return Status(Status::DRACO_ERROR, + "Could not find animation accessor output index."); + } + + std::unique_ptr new_sampler(new AnimationSampler()); + new_sampler->input_index = input_it->second; + new_sampler->output_index = output_it->second; + + if (output_type_ == GltfEncoder::COMPACT) { + // Remove min/max from output accessor. + accessors_[new_sampler->output_index].min.clear(); + accessors_[new_sampler->output_index].max.clear(); + } + + new_sampler->interpolation_type = sampler->interpolation_type; + + new_animation->samplers.push_back(std::move(new_sampler)); + } + + for (int j = 0; j < animation->NumChannels(); ++j) { + const AnimationChannel *const channel = animation->GetChannel(j); + std::unique_ptr new_channel(new AnimationChannel()); + new_channel->Copy(*channel); + new_animation->channels.push_back(std::move(new_channel)); + } + + animations_.push_back(std::move(new_animation)); + } + return OkStatus(); +} + +StatusOr GltfAsset::AddNodeAnimationData( + const NodeAnimationData &node_animation_data) { + const size_t buffer_start_offset = buffer_.size(); + + const int component_size = node_animation_data.ComponentSize(); + const int num_components = node_animation_data.NumComponents(); + const std::vector *data = node_animation_data.GetData(); + + std::vector min_values; + min_values.resize(num_components); + for (int j = 0; j < num_components; ++j) { + min_values[j] = (*data)[j]; + } + std::vector max_values = min_values; + + for (int i = 0; i < node_animation_data.count(); ++i) { + for (int j = 0; j < num_components; ++j) { + const float value = (*data)[(i * num_components) + j]; + if (value < min_values[j]) { + min_values[j] = value; + } + if (value > max_values[j]) { + max_values[j] = value; + } + + buffer_.Encode(&value, component_size); + } + } + + if (!PadBuffer()) { + return Status(Status::DRACO_ERROR, + "AddNodeAnimationData: PadBuffer returned DRACO_ERROR."); + } + + GltfBufferView buffer_view; + buffer_view.buffer_byte_offset = buffer_start_offset; + buffer_view.byte_length = buffer_.size() - buffer_start_offset; + buffer_views_.push_back(buffer_view); + + GltfAccessor accessor; + accessor.buffer_view_index = static_cast(buffer_views_.size() - 1); + accessor.component_type = ComponentType::FLOAT; + accessor.count = node_animation_data.count(); + for (int j = 0; j < num_components; ++j) { + accessor.max.push_back(GltfValue(max_values[j])); + accessor.min.push_back(GltfValue(min_values[j])); + } + accessor.type = node_animation_data.TypeAsString(); + accessor.normalized = node_animation_data.normalized(); + accessors_.push_back(accessor); + return static_cast(accessors_.size() - 1); +} + +Status GltfAsset::AddSkins(const Scene &scene) { + if (scene.NumSkins() == 0) { + return OkStatus(); + } + + for (SkinIndex i(0); i < scene.NumSkins(); ++i) { + const Skin *const skin = scene.GetSkin(i); + DRACO_ASSIGN_OR_RETURN( + const int output_accessor_index, + AddNodeAnimationData(skin->GetInverseBindMatrices())); + + std::unique_ptr encoder_skin(new EncoderSkin); + encoder_skin->inverse_bind_matrices_index = output_accessor_index; + encoder_skin->joints.reserve(skin->NumJoints()); + for (int j = 0; j < skin->NumJoints(); j++) { + encoder_skin->joints.push_back(skin->GetJoint(j).value()); + } + encoder_skin->skeleton_index = skin->GetJointRoot().value(); + skins_.push_back(std::move(encoder_skin)); + } + return OkStatus(); +} + +Status GltfAsset::AddLights(const Scene &scene) { + if (scene.NumLights() == 0) { + return OkStatus(); + } + + for (LightIndex i(0); i < scene.NumLights(); ++i) { + std::unique_ptr light = std::unique_ptr(new Light()); + light->Copy(*scene.GetLight(i)); + lights_.push_back(std::move(light)); + } + return OkStatus(); +} + +Status GltfAsset::AddMaterialsVariantsNames(const Scene &scene) { + const MaterialLibrary &library = scene.GetMaterialLibrary(); + for (int i = 0; i < library.NumMaterialsVariants(); ++i) { + materials_variants_names_.push_back(library.GetMaterialsVariantName(i)); + } + return OkStatus(); +} + +Status GltfAsset::AddInstanceArrays(const Scene &scene) { + if (scene.NumInstanceArrays() == 0) { + return OkStatus(); + } + + // Add each of the instance arrays. + std::vector t_data; + std::vector r_data; + std::vector s_data; + for (InstanceArrayIndex i(0); i < scene.NumInstanceArrays(); ++i) { + // Find which of the optional TRS components are set. + // TODO(vytyaz): Treat default TRS component vectors as absent. + const InstanceArray &array = *scene.GetInstanceArray(i); + bool is_t_set = false; + bool is_r_set = false; + bool is_s_set = false; + for (int i = 0; i < array.NumInstances(); i++) { + const InstanceArray::Instance &instance = array.GetInstance(i); + if (instance.trs.TranslationSet()) { + is_t_set = true; + } + if (instance.trs.RotationSet()) { + is_r_set = true; + } + if (instance.trs.ScaleSet()) { + is_s_set = true; + } + } + + // Create contiguous data vectors for individual TRS components. + t_data.clear(); + r_data.clear(); + s_data.clear(); + if (is_t_set) { + t_data.reserve(array.NumInstances() * 3); + } + if (is_r_set) { + r_data.reserve(array.NumInstances() * 4); + } + if (is_s_set) { + s_data.reserve(array.NumInstances() * 3); + } + + // Add TRS vectors of each instance to corresponding data vectors. + for (int i = 0; i < array.NumInstances(); i++) { + const InstanceArray::Instance &instance = array.GetInstance(i); + if (is_t_set) { + DRACO_ASSIGN_OR_RETURN(const auto &t_vector, + instance.trs.Translation()); + t_data.push_back(t_vector.x()); + t_data.push_back(t_vector.y()); + t_data.push_back(t_vector.z()); + } + if (is_r_set) { + DRACO_ASSIGN_OR_RETURN(const auto &r_vector, instance.trs.Rotation()); + r_data.push_back(r_vector.x()); + r_data.push_back(r_vector.y()); + r_data.push_back(r_vector.z()); + r_data.push_back(r_vector.w()); + } + if (is_s_set) { + DRACO_ASSIGN_OR_RETURN(const auto &s_vector, instance.trs.Scale()); + s_data.push_back(s_vector.x()); + s_data.push_back(s_vector.y()); + s_data.push_back(s_vector.z()); + } + } + + // Add TRS vectors to attribute buffers and collect their accessor indices. + EncoderInstanceArray accessors; + if (is_t_set) { + DRACO_ASSIGN_OR_RETURN(accessors.translation, AddData(t_data, 3)); + } + if (is_r_set) { + DRACO_ASSIGN_OR_RETURN(accessors.rotation, AddData(r_data, 4)); + } + if (is_s_set) { + DRACO_ASSIGN_OR_RETURN(accessors.scale, AddData(s_data, 3)); + } + + // Store accessors for later to encode as EXT_mesh_gpu_instancing extension. + instance_arrays_.push_back(accessors); + } + return OkStatus(); +} + +template +void GltfAsset::AddStructuralMetadata(const GeometryT &geometry) { + const StructuralMetadata &structural_metadata = + geometry.GetStructuralMetadata(); + if (!structural_metadata.GetPropertyTableSchema().Empty()) { + property_table_schema_ = structural_metadata.GetPropertyTableSchema(); + for (int i = 0; i < structural_metadata.NumPropertyTables(); ++i) { + property_tables_.push_back(&structural_metadata.GetPropertyTable(i)); + } + } +} + +StatusOr GltfAsset::AddData(const std::vector &data, + int num_components) { + std::string type; + switch (num_components) { + case 3: + type = "VEC3"; + break; + case 4: + type = "VEC4"; + break; + default: + return ErrorStatus("Unsupported number of components."); + } + + const size_t buffer_start_offset = buffer_.size(); + + std::vector min_values(num_components); + for (int j = 0; j < num_components; ++j) { + min_values[j] = data[j]; + } + std::vector max_values = min_values; + + const int count = data.size() / num_components; + for (int i = 0; i < count; ++i) { + for (int j = 0; j < num_components; ++j) { + const float value = data[(i * num_components) + j]; + if (value < min_values[j]) { + min_values[j] = value; + } + if (value > max_values[j]) { + max_values[j] = value; + } + buffer_.Encode(&value, sizeof(float)); + } + } + + if (!PadBuffer()) { + return ErrorStatus("AddArray: PadBuffer returned DRACO_ERROR."); + } + + GltfBufferView buffer_view; + buffer_view.buffer_byte_offset = buffer_start_offset; + buffer_view.byte_length = buffer_.size() - buffer_start_offset; + buffer_views_.push_back(buffer_view); + + GltfAccessor accessor; + accessor.buffer_view_index = static_cast(buffer_views_.size() - 1); + accessor.component_type = ComponentType::FLOAT; + accessor.count = count; + for (int j = 0; j < num_components; ++j) { + accessor.max.push_back(GltfValue(max_values[j])); + accessor.min.push_back(GltfValue(min_values[j])); + } + accessor.type = type; + accessor.normalized = false; + accessors_.push_back(accessor); + return static_cast(accessors_.size() - 1); +} + +StatusOr GltfAsset::AddBufferView( + const PropertyTable::Property::Data &data) { + const size_t buffer_start_offset = buffer_.size(); + buffer_.Encode(data.data.data(), data.data.size()); + if (!PadBuffer()) { + return ErrorStatus("AddBufferView: PadBuffer returned DRACO_ERROR."); + } + GltfBufferView buffer_view; + buffer_view.buffer_byte_offset = buffer_start_offset; + buffer_view.byte_length = buffer_.size() - buffer_start_offset; + buffer_view.target = data.target; + buffer_views_.push_back(buffer_view); + return static_cast(buffer_views_.size() - 1); +} + +bool GltfAsset::EncodeAssetProperty(EncoderBuffer *buf_out) { + gltf_json_.BeginObject("asset"); + gltf_json_.OutputValue("version", version_); + gltf_json_.OutputValue("generator", generator_); + gltf_json_.EndObject(); + + const std::string asset_str = gltf_json_.MoveData(); + return buf_out->Encode(asset_str.data(), asset_str.length()); +} + +bool GltfAsset::EncodeScenesProperty(EncoderBuffer *buf_out) { + // We currently only support one scene. + gltf_json_.BeginArray("scenes"); + gltf_json_.BeginObject(); + gltf_json_.BeginArray("nodes"); + + for (int i = 0; i < nodes_.size(); ++i) { + if (nodes_[i].root_node) { + gltf_json_.OutputValue(i); + } + } + gltf_json_.EndArray(); + gltf_json_.EndObject(); + gltf_json_.EndArray(); + + const std::string asset_str = gltf_json_.MoveData(); + return buf_out->Encode(asset_str.data(), asset_str.length()); +} + +bool GltfAsset::EncodeInitialSceneProperty(EncoderBuffer *buf_out) { + gltf_json_.OutputValue("scene", scene_index_); + const std::string asset_str = gltf_json_.MoveData(); + return buf_out->Encode(asset_str.data(), asset_str.length()); +} + +bool GltfAsset::EncodeNodesProperty(EncoderBuffer *buf_out) { + gltf_json_.BeginArray("nodes"); + + for (int i = 0; i < nodes_.size(); ++i) { + gltf_json_.BeginObject(); + if (!nodes_[i].name.empty()) { + gltf_json_.OutputValue("name", nodes_[i].name); + } + if (nodes_[i].mesh_index >= 0) { + gltf_json_.OutputValue("mesh", nodes_[i].mesh_index); + } + if (nodes_[i].skin_index >= 0) { + gltf_json_.OutputValue("skin", nodes_[i].skin_index); + } + if (nodes_[i].instance_array_index >= 0 || nodes_[i].light_index >= 0) { + gltf_json_.BeginObject("extensions"); + if (nodes_[i].instance_array_index >= 0) { + gltf_json_.BeginObject("EXT_mesh_gpu_instancing"); + gltf_json_.BeginObject("attributes"); + const int index = nodes_[i].instance_array_index; + const EncoderInstanceArray &accessors = instance_arrays_[index]; + if (accessors.translation != -1) { + gltf_json_.OutputValue("TRANSLATION", accessors.translation); + } + if (accessors.rotation != -1) { + gltf_json_.OutputValue("ROTATION", accessors.rotation); + } + if (accessors.scale != -1) { + gltf_json_.OutputValue("SCALE", accessors.scale); + } + gltf_json_.EndObject(); + gltf_json_.EndObject(); + } + if (nodes_[i].light_index >= 0) { + gltf_json_.BeginObject("KHR_lights_punctual"); + gltf_json_.OutputValue("light", nodes_[i].light_index); + gltf_json_.EndObject(); + } + gltf_json_.EndObject(); + } + + if (!nodes_[i].childern_indices.empty()) { + gltf_json_.BeginArray("children"); + for (int j = 0; j < nodes_[i].childern_indices.size(); ++j) { + gltf_json_.OutputValue(nodes_[i].childern_indices[j]); + } + gltf_json_.EndArray(); + } + + if (!nodes_[i].trs_matrix.IsMatrixIdentity()) { + const auto maybe_transformation = nodes_[i].trs_matrix.Matrix(); + const auto transformation = maybe_transformation.ValueOrDie(); + + if (nodes_[i].trs_matrix.IsMatrixTranslationOnly()) { + gltf_json_.BeginArray("translation"); + for (int j = 0; j < 3; ++j) { + gltf_json_.OutputValue(transformation(j, 3)); + } + gltf_json_.EndArray(); + } else { + gltf_json_.BeginArray("matrix"); + for (int j = 0; j < 4; ++j) { + for (int k = 0; k < 4; ++k) { + gltf_json_.OutputValue(transformation(k, j)); + } + } + gltf_json_.EndArray(); + } + } else { + if (nodes_[i].trs_matrix.TranslationSet()) { + const auto maybe_translation = nodes_[i].trs_matrix.Translation(); + const auto translation = maybe_translation.ValueOrDie(); + gltf_json_.BeginArray("translation"); + for (int j = 0; j < 3; ++j) { + gltf_json_.OutputValue(translation[j]); + } + gltf_json_.EndArray(); + } + if (nodes_[i].trs_matrix.RotationSet()) { + const auto maybe_rotation = nodes_[i].trs_matrix.Rotation(); + const auto rotation = maybe_rotation.ValueOrDie(); + gltf_json_.BeginArray("rotation"); + for (int j = 0; j < 4; ++j) { + // Note: coeffs() returns quaternion values as (x, y, z, w) which is + // the expected format of glTF. + gltf_json_.OutputValue(rotation.coeffs()[j]); + } + gltf_json_.EndArray(); + } + if (nodes_[i].trs_matrix.ScaleSet()) { + const auto maybe_scale = nodes_[i].trs_matrix.Scale(); + const auto scale = maybe_scale.ValueOrDie(); + gltf_json_.BeginArray("scale"); + for (int j = 0; j < 3; ++j) { + gltf_json_.OutputValue(scale[j]); + } + gltf_json_.EndArray(); + } + } + + gltf_json_.EndObject(); + } + + gltf_json_.EndArray(); + + const std::string asset_str = gltf_json_.MoveData(); + return buf_out->Encode(asset_str.data(), asset_str.length()); +} + +Status GltfAsset::EncodeMeshesProperty(EncoderBuffer *buf_out) { + mesh_features_texture_index_ = 0; + gltf_json_.BeginArray("meshes"); + + for (int i = 0; i < meshes_.size(); ++i) { + gltf_json_.BeginObject(); + + if (!meshes_[i].name.empty()) { + gltf_json_.OutputValue("name", meshes_[i].name); + } + + if (!meshes_[i].primitives.empty()) { + gltf_json_.BeginArray("primitives"); + + for (int j = 0; j < meshes_[i].primitives.size(); ++j) { + const GltfPrimitive &primitive = meshes_[i].primitives[j]; + gltf_json_.BeginObject(); + + gltf_json_.BeginObject("attributes"); + for (auto const &it : primitive.attributes) { + gltf_json_.OutputValue(it.first, it.second); + } + gltf_json_.EndObject(); + + if (primitive.indices >= 0) { + gltf_json_.OutputValue("indices", primitive.indices); + } + gltf_json_.OutputValue("mode", primitive.mode); + if (primitive.material >= 0) { + gltf_json_.OutputValue("material", primitive.material); + } + DRACO_RETURN_IF_ERROR( + EncodePrimitiveExtensionsProperty(primitive, buf_out)); + gltf_json_.EndObject(); + } + + gltf_json_.EndArray(); + } + + gltf_json_.EndObject(); + } + + gltf_json_.EndArray(); + + const std::string asset_str = gltf_json_.MoveData(); + if (!buf_out->Encode(asset_str.data(), asset_str.length())) { + return ErrorStatus("Failed encoding meshes."); + } + return OkStatus(); +} + +Status GltfAsset::EncodePrimitiveExtensionsProperty( + const GltfPrimitive &primitive, EncoderBuffer *buf_out) { + // Return if the primitive has no extensions to encode. + const bool has_draco_mesh_compression = + primitive.compressed_mesh_info.buffer_view_index >= 0; + const bool has_materials_variants = + !primitive.material_variants_mappings.empty(); + const bool has_mesh_features = !primitive.mesh_features.empty(); + if (!has_draco_mesh_compression && !has_materials_variants && + !has_mesh_features) { + return OkStatus(); + } + + // Encode primitive extensions. + gltf_json_.BeginObject("extensions"); + if (has_draco_mesh_compression) { + gltf_json_.BeginObject("KHR_draco_mesh_compression"); + gltf_json_.OutputValue("bufferView", + primitive.compressed_mesh_info.buffer_view_index); + gltf_json_.BeginObject("attributes"); + for (auto const &it : primitive.compressed_mesh_info.attributes) { + gltf_json_.OutputValue(it.first, it.second); + } + gltf_json_.EndObject(); // attributes entry. + gltf_json_.EndObject(); // KHR_draco_mesh_compression entry. + } + if (has_materials_variants) { + gltf_json_.BeginObject("KHR_materials_variants"); + gltf_json_.BeginArray("mappings"); + for (const auto &mapping : primitive.material_variants_mappings) { + gltf_json_.BeginObject(); + gltf_json_.OutputValue("material", mapping.material); + gltf_json_.BeginArray("variants"); + for (const int variant : mapping.variants) { + gltf_json_.OutputValue(variant); + } + gltf_json_.EndArray(); // variants array. + gltf_json_.EndObject(); + } + gltf_json_.EndArray(); // mappings array. + gltf_json_.EndObject(); // KHR_materials_variants entry. + } + if (has_mesh_features) { + gltf_json_.BeginObject("EXT_mesh_features"); + gltf_json_.BeginArray("featureIds"); + for (int i = 0; i < primitive.mesh_features.size(); i++) { + const auto &features = primitive.mesh_features[i]; + gltf_json_.BeginObject(); + if (!features->GetLabel().empty()) { + gltf_json_.OutputValue("label", features->GetLabel()); + } + gltf_json_.OutputValue("featureCount", features->GetFeatureCount()); + if (features->GetAttributeIndex() != -1) { + gltf_json_.OutputValue("attribute", features->GetAttributeIndex()); + } + if (features->GetPropertyTableIndex() != -1) { + gltf_json_.OutputValue("propertyTable", + features->GetPropertyTableIndex()); + } + if (features->GetTextureMap().tex_coord_index() != -1) { + const TextureMap &texture_map = features->GetTextureMap(); + const std::string texture_stem = TextureUtils::GetOrGenerateTargetStem( + *texture_map.texture(), mesh_features_texture_index_++, + "_MeshFeatures"); + + // Save image as RGBA if the A channel is used to store feature ID. + const auto &channels = features->GetTextureChannels(); + const int num_channels = + std::count(channels.begin(), channels.end(), 3) == 1 ? 4 : 3; + DRACO_ASSIGN_OR_RETURN( + const int image_index, + AddImage(texture_stem, texture_map.texture(), num_channels)); + const int tex_coord_index = texture_map.tex_coord_index(); + Material dummy_material; + DRACO_RETURN_IF_ERROR(EncodeTextureMap("texture", image_index, + tex_coord_index, dummy_material, + texture_map, channels)); + } + if (features->GetNullFeatureId() != -1) { + gltf_json_.OutputValue("nullFeatureId", features->GetNullFeatureId()); + } + gltf_json_.EndObject(); + mesh_features_used_ = true; + } + gltf_json_.EndArray(); // featureIds array. + gltf_json_.EndObject(); // EXT_mesh_features entry. + } + gltf_json_.EndObject(); // extensions entry. + return OkStatus(); +} + +Status GltfAsset::EncodeMaterials(EncoderBuffer *buf_out) { + // Check if we have textures to write. + if (material_library_.NumMaterials() == 0) { + return EncodeDefaultMaterial(buf_out); + } + return EncodeMaterialsProperty(buf_out); +} + +void GltfAsset::EncodeColorMaterial(float red, float green, float blue, + float alpha, float metallic_factor) { + gltf_json_.BeginObject("pbrMetallicRoughness"); + + gltf_json_.BeginArray("baseColorFactor"); + gltf_json_.OutputValue(red); + gltf_json_.OutputValue(green); + gltf_json_.OutputValue(blue); + gltf_json_.OutputValue(alpha); + gltf_json_.EndArray(); + gltf_json_.OutputValue("metallicFactor", metallic_factor); + + gltf_json_.EndObject(); // pbrMetallicRoughness +} + +Status GltfAsset::EncodeDefaultMaterial(EncoderBuffer *buf_out) { + gltf_json_.BeginArray("materials"); + gltf_json_.BeginObject(); + EncodeColorMaterial(0.75, 0.75, 0.75, 1.0, 0.0); + gltf_json_.EndObject(); + gltf_json_.EndArray(); // materials + + const std::string asset_str = gltf_json_.MoveData(); + if (!buf_out->Encode(asset_str.data(), asset_str.length())) { + return Status(Status::DRACO_ERROR, "Error encoding default material."); + } + return OkStatus(); +} + +Status GltfAsset::EncodeTextureMap(const std::string &object_name, + int image_index, int tex_coord_index, + const Material &material, + const TextureMap &texture_map) { + return EncodeTextureMap(object_name, image_index, tex_coord_index, material, + texture_map, {}); +} + +Status GltfAsset::EncodeTextureMap(const std::string &object_name, + int image_index, int tex_coord_index, + const Material &material, + const TextureMap &texture_map, + const std::vector &channels) { + // Create a new texture sampler (or reuse an existing one if possible). + const TextureSampler sampler(texture_map.min_filter(), + texture_map.mag_filter(), + texture_map.wrapping_mode()); + DRACO_ASSIGN_OR_RETURN(const int sampler_index, AddTextureSampler(sampler)); + + // Check if we can reuse an existing texture object. + const GltfTexture texture(image_index, sampler_index); + const auto texture_it = + std::find(textures_.begin(), textures_.end(), texture); + int texture_index; + if (texture_it == textures_.end()) { + // Create a new texture object for this texture map. + texture_index = textures_.size(); + textures_.push_back(GltfTexture(image_index, sampler_index)); + } else { + // Reuse an existing texture object. + texture_index = std::distance(textures_.begin(), texture_it); + } + + gltf_json_.BeginObject(object_name); + gltf_json_.OutputValue("index", texture_index); + gltf_json_.OutputValue("texCoord", tex_coord_index); + if (object_name == "normalTexture") { + const float scale = material.GetNormalTextureScale(); + if (scale != 1.0f) { + gltf_json_.OutputValue("scale", scale); + } + } + + // The "texture" object of the EXT_mesh_features extension has a custom + // property "channels" that is encoded here. + if (object_name == "texture" && !channels.empty()) { + gltf_json_.BeginArray("channels"); + for (const int channel : channels) { + gltf_json_.OutputValue(channel); + } + gltf_json_.EndArray(); // channels array. + } + + // Check if |texture_map| is using the KHR_texture_transform extension. + if (!TextureTransform::IsDefault(texture_map.texture_transform())) { + gltf_json_.BeginObject("extensions"); + gltf_json_.BeginObject("KHR_texture_transform"); + if (texture_map.texture_transform().IsOffsetSet()) { + const std::array &offset = + texture_map.texture_transform().offset(); + gltf_json_.BeginArray("offset"); + gltf_json_.OutputValue(offset[0]); + gltf_json_.OutputValue(offset[1]); + gltf_json_.EndArray(); + } + if (texture_map.texture_transform().IsRotationSet()) { + gltf_json_.OutputValue("rotation", + texture_map.texture_transform().rotation()); + } + if (texture_map.texture_transform().IsScaleSet()) { + const std::array &scale = + texture_map.texture_transform().scale(); + gltf_json_.BeginArray("scale"); + gltf_json_.OutputValue(scale[0]); + gltf_json_.OutputValue(scale[1]); + gltf_json_.EndArray(); + } + // TODO(fgalligan): The spec says the extension is not required if the + // pre-transform and the post-transform tex coords are the same. But I'm not + // sure why. I have filed a bug asking for clarification. + // https://github.com/KhronosGroup/glTF/issues/1724 + if (texture_map.texture_transform().IsTexCoordSet()) { + gltf_json_.OutputValue("texCoord", + texture_map.texture_transform().tex_coord()); + } else { + extensions_required_.insert("KHR_texture_transform"); + } + gltf_json_.EndObject(); + gltf_json_.EndObject(); + + extensions_used_.insert("KHR_texture_transform"); + } + gltf_json_.EndObject(); + return OkStatus(); +} + +Status GltfAsset::EncodeMaterialsProperty(EncoderBuffer *buf_out) { + gltf_json_.BeginArray("materials"); + for (int i = 0; i < material_library_.NumMaterials(); ++i) { + const Material *const material = material_library_.GetMaterial(i); + if (!material) { + return Status(Status::DRACO_ERROR, "Error getting material."); + } + + const TextureMap *const color = + material->GetTextureMapByType(TextureMap::COLOR); + const TextureMap *const metallic = + material->GetTextureMapByType(TextureMap::METALLIC_ROUGHNESS); + const TextureMap *const normal = + material->GetTextureMapByType(TextureMap::NORMAL_TANGENT_SPACE); + const TextureMap *const occlusion = + material->GetTextureMapByType(TextureMap::AMBIENT_OCCLUSION); + const TextureMap *const emissive = + material->GetTextureMapByType(TextureMap::EMISSIVE); + + // Check if material is unlit and does not have a fallback. + if (material->GetUnlit() && + (!color || metallic || normal || occlusion || emissive || + material->GetMetallicFactor() != 0.0 || + material->GetRoughnessFactor() <= 0.5 || + material->GetEmissiveFactor() != Vector3f(0.0, 0.0, 0.0))) { + // If we find one material that is unlit and does not contain a fallback + // we must set "KHR_materials_unlit" in extensions reqruied for the entire + // glTF file. + extensions_required_.insert("KHR_materials_unlit"); + } + + int occlusion_metallic_roughness_image_index = -1; + + gltf_json_.BeginObject(); // material object. + + gltf_json_.BeginObject("pbrMetallicRoughness"); + if (color) { + const bool rgba = true; // Unused for now. + const std::string texture_stem = TextureUtils::GetOrGenerateTargetStem( + *color->texture(), i, "_BaseColor"); + DRACO_ASSIGN_OR_RETURN( + const int color_image_index, + AddImage(texture_stem, color->texture(), rgba ? 4 : 3)); + DRACO_RETURN_IF_ERROR( + EncodeTextureMap("baseColorTexture", color_image_index, + color->tex_coord_index(), *material, *color)); + } + // Try to combine metallic and occlusion only if they have the same tex + // coord index. + // TODO(b/145991271): Check out if we need to check texture indices. + if (metallic && occlusion && + metallic->tex_coord_index() == occlusion->tex_coord_index()) { + if (metallic->texture() == occlusion->texture()) { + const std::string texture_stem = TextureUtils::GetOrGenerateTargetStem( + *metallic->texture(), i, "_OcclusionMetallicRoughness"); + // Metallic and occlusion textures are already combined. + DRACO_ASSIGN_OR_RETURN(occlusion_metallic_roughness_image_index, + AddImage(texture_stem, metallic->texture(), 3)); + } + if (occlusion_metallic_roughness_image_index != -1) + DRACO_RETURN_IF_ERROR(EncodeTextureMap( + "metallicRoughnessTexture", + occlusion_metallic_roughness_image_index, + metallic->tex_coord_index(), *material, *metallic)); + } + + if (metallic && occlusion_metallic_roughness_image_index == -1) { + const std::string texture_stem = TextureUtils::GetOrGenerateTargetStem( + *metallic->texture(), i, "_MetallicRoughness"); + DRACO_ASSIGN_OR_RETURN(const int metallic_roughness_image_index, + AddImage(texture_stem, metallic->texture(), 3)); + DRACO_RETURN_IF_ERROR(EncodeTextureMap( + "metallicRoughnessTexture", metallic_roughness_image_index, + metallic->tex_coord_index(), *material, *metallic)); + } + + EncodeVectorArray("baseColorFactor", material->GetColorFactor()); + gltf_json_.OutputValue("metallicFactor", material->GetMetallicFactor()); + gltf_json_.OutputValue("roughnessFactor", material->GetRoughnessFactor()); + gltf_json_.EndObject(); // pbrMetallicRoughness + + if (normal) { + const std::string texture_stem = TextureUtils::GetOrGenerateTargetStem( + *normal->texture(), i, "_Normal"); + DRACO_ASSIGN_OR_RETURN(const int normal_image_index, + AddImage(texture_stem, normal->texture(), 3)); + DRACO_RETURN_IF_ERROR( + EncodeTextureMap("normalTexture", normal_image_index, + normal->tex_coord_index(), *material, *normal)); + } + + if (occlusion_metallic_roughness_image_index != -1) { + DRACO_RETURN_IF_ERROR(EncodeTextureMap( + "occlusionTexture", occlusion_metallic_roughness_image_index, + metallic->tex_coord_index(), *material, *metallic)); + } else if (occlusion) { + // Store occlusion texture in a grayscale format, unless it is used by + // metallic-roughness map of some other matierial. It is possible that + // this material uses occlusion (R channel) and some other material uses + // metallic-roughness (GB channels) from this texture. + const int num_components = TextureUtils::ComputeRequiredNumChannels( + *occlusion->texture(), material_library_); + const std::string suffix = + (num_components == 1) ? "_Occlusion" : "_OcclusionMetallicRoughness"; + const std::string texture_stem = TextureUtils::GetOrGenerateTargetStem( + *occlusion->texture(), i, suffix); + DRACO_ASSIGN_OR_RETURN( + const int occlusion_image_index, + AddImage(texture_stem, occlusion->texture(), num_components)); + DRACO_RETURN_IF_ERROR(EncodeTextureMap( + "occlusionTexture", occlusion_image_index, + occlusion->tex_coord_index(), *material, *occlusion)); + } + + if (emissive) { + const std::string texture_stem = TextureUtils::GetOrGenerateTargetStem( + *emissive->texture(), i, "_Emissive"); + DRACO_ASSIGN_OR_RETURN(const int emissive_image_index, + AddImage(texture_stem, emissive->texture(), 3)); + DRACO_RETURN_IF_ERROR( + EncodeTextureMap("emissiveTexture", emissive_image_index, + emissive->tex_coord_index(), *material, *emissive)); + } + + EncodeVectorArray("emissiveFactor", + material->GetEmissiveFactor()); + + switch (material->GetTransparencyMode()) { + case Material::TransparencyMode::TRANSPARENCY_MASK: + gltf_json_.OutputValue("alphaMode", "MASK"); + gltf_json_.OutputValue("alphaCutoff", material->GetAlphaCutoff()); + break; + case Material::TransparencyMode::TRANSPARENCY_BLEND: + gltf_json_.OutputValue("alphaMode", "BLEND"); + break; + default: + gltf_json_.OutputValue("alphaMode", "OPAQUE"); + break; + } + if (!material->GetName().empty()) { + gltf_json_.OutputValue("name", material->GetName()); + } + + // Output doubleSided if different than the default. + if (material->GetDoubleSided()) { + gltf_json_.OutputValue("doubleSided", material->GetDoubleSided()); + } + + // Encode material extensions if any. + if (material->GetUnlit() || material->HasSheen() || + material->HasTransmission() || material->HasClearcoat() || + material->HasVolume() || material->HasIor() || + material->HasSpecular()) { + gltf_json_.BeginObject("extensions"); + + // Encode individual material extensions. + if (material->GetUnlit()) { + EncodeMaterialUnlitExtension(*material); + } else { + // PBR extensions can only be added to non-unlit materials. + Material defaults; + if (material->HasSheen()) { + DRACO_RETURN_IF_ERROR( + EncodeMaterialSheenExtension(*material, defaults, i)); + } + if (material->HasTransmission()) { + DRACO_RETURN_IF_ERROR( + EncodeMaterialTransmissionExtension(*material, defaults, i)); + } + if (material->HasClearcoat()) { + DRACO_RETURN_IF_ERROR( + EncodeMaterialClearcoatExtension(*material, defaults, i)); + } + if (material->HasVolume()) { + DRACO_RETURN_IF_ERROR( + EncodeMaterialVolumeExtension(*material, defaults, i)); + } + if (material->HasIor()) { + DRACO_RETURN_IF_ERROR( + EncodeMaterialIorExtension(*material, defaults)); + } + if (material->HasSpecular()) { + DRACO_RETURN_IF_ERROR( + EncodeMaterialSpecularExtension(*material, defaults, i)); + } + } + + gltf_json_.EndObject(); // extensions object. + } + + gltf_json_.EndObject(); // material object. + } + + gltf_json_.EndArray(); // materials array. + + if (!textures_.empty()) { + gltf_json_.BeginArray("textures"); + for (int i = 0; i < textures_.size(); ++i) { + const int image_index = textures_[i].image_index; + gltf_json_.BeginObject(); + if (images_[image_index].mime_type == "image/webp") { + gltf_json_.BeginObject("extensions"); + gltf_json_.BeginObject("EXT_texture_webp"); + gltf_json_.OutputValue("source", image_index); + gltf_json_.EndObject(); + gltf_json_.EndObject(); + } else if (images_[image_index].mime_type == "image/ktx2") { + gltf_json_.BeginObject("extensions"); + gltf_json_.BeginObject("KHR_texture_basisu"); + gltf_json_.OutputValue("source", image_index); + gltf_json_.EndObject(); + gltf_json_.EndObject(); + } else { + gltf_json_.OutputValue("source", image_index); + } + if (textures_[i].sampler_index >= 0) { + gltf_json_.OutputValue("sampler", textures_[i].sampler_index); + } + gltf_json_.EndObject(); + } + gltf_json_.EndArray(); + } + + if (!texture_samplers_.empty()) { + gltf_json_.BeginArray("samplers"); + for (int i = 0; i < texture_samplers_.size(); ++i) { + gltf_json_.BeginObject(); + + const int mode_s = TextureAxisWrappingModeToGltfValue( + texture_samplers_[i].wrapping_mode.s); + const int mode_t = TextureAxisWrappingModeToGltfValue( + texture_samplers_[i].wrapping_mode.t); + gltf_json_.OutputValue("wrapS", mode_s); + gltf_json_.OutputValue("wrapT", mode_t); + + if (texture_samplers_[i].min_filter != TextureMap::UNSPECIFIED) { + gltf_json_.OutputValue( + "minFilter", + TextureFilterTypeToGltfValue(texture_samplers_[i].min_filter)); + } + if (texture_samplers_[i].mag_filter != TextureMap::UNSPECIFIED) { + gltf_json_.OutputValue( + "magFilter", + TextureFilterTypeToGltfValue(texture_samplers_[i].mag_filter)); + } + + gltf_json_.EndObject(); + } + gltf_json_.EndArray(); + } + + if (!images_.empty()) { + gltf_json_.BeginArray("images"); + for (int i = 0; i < images_.size(); ++i) { + if (add_images_to_buffer_) { + DRACO_RETURN_IF_ERROR(SaveImageToBuffer(i)); + } + gltf_json_.BeginObject(); + if (images_[i].buffer_view >= 0) { + gltf_json_.OutputValue("bufferView", images_[i].buffer_view); + gltf_json_.OutputValue("mimeType", images_[i].mime_type); + } else { + gltf_json_.OutputValue("uri", images_[i].image_name); + } + gltf_json_.EndObject(); + } + gltf_json_.EndArray(); + } + + const std::string asset_str = gltf_json_.MoveData(); + if (!buf_out->Encode(asset_str.data(), asset_str.length())) { + return Status(Status::DRACO_ERROR, "Error encoding materials."); + } + return OkStatus(); +} + +void GltfAsset::EncodeMaterialUnlitExtension(const Material &material) { + extensions_used_.insert("KHR_materials_unlit"); + gltf_json_.BeginObject("KHR_materials_unlit"); + gltf_json_.EndObject(); +} + +Status GltfAsset::EncodeMaterialSheenExtension(const Material &material, + const Material &defaults, + int material_index) { + extensions_used_.insert("KHR_materials_sheen"); + gltf_json_.BeginObject("KHR_materials_sheen"); + + // Add sheen color factor, unless it is the default. + if (material.GetSheenColorFactor() != defaults.GetSheenColorFactor()) { + EncodeVectorArray("sheenColorFactor", + material.GetSheenColorFactor()); + } + + // Add sheen roughness factor, unless it is the default. + if (material.GetSheenRoughnessFactor() != + defaults.GetSheenRoughnessFactor()) { + gltf_json_.OutputValue("sheenRoughnessFactor", + material.GetSheenRoughnessFactor()); + } + + // Add sheen color texture (RGB channels) if present. + // TODO(vytyaz): Combine sheen color and roughness images if possible. + DRACO_RETURN_IF_ERROR(EncodeTexture("sheenColorTexture", "_SheenColor", + TextureMap::SHEEN_COLOR, -1, material, + material_index)); + + // Add sheen roughness texture (A channel) if present. + DRACO_RETURN_IF_ERROR( + EncodeTexture("sheenRoughnessTexture", "_SheenRoughness", + TextureMap::SHEEN_ROUGHNESS, 4, material, material_index)); + + gltf_json_.EndObject(); // KHR_materials_sheen object. + + return OkStatus(); +} + +Status GltfAsset::EncodeMaterialTransmissionExtension(const Material &material, + const Material &defaults, + int material_index) { + extensions_used_.insert("KHR_materials_transmission"); + gltf_json_.BeginObject("KHR_materials_transmission"); + + // Add transmission factor, unless it is the default. + if (material.GetTransmissionFactor() != defaults.GetTransmissionFactor()) { + gltf_json_.OutputValue("transmissionFactor", + material.GetTransmissionFactor()); + } + + // Add transmission texture (R channel) if present. + // TODO(vytyaz): Store texture in a grayscale format if possible. + DRACO_RETURN_IF_ERROR(EncodeTexture("transmissionTexture", "_Transmission", + TextureMap::TRANSMISSION, 3, material, + material_index)); + + gltf_json_.EndObject(); // KHR_materials_transmission object. + + return OkStatus(); +} + +Status GltfAsset::EncodeMaterialClearcoatExtension(const Material &material, + const Material &defaults, + int material_index) { + extensions_used_.insert("KHR_materials_clearcoat"); + gltf_json_.BeginObject("KHR_materials_clearcoat"); + + // Add clearcoat factor, unless it is the default. + if (material.GetClearcoatFactor() != defaults.GetClearcoatFactor()) { + gltf_json_.OutputValue("clearcoatFactor", material.GetClearcoatFactor()); + } + + // Add clearcoat roughness factor, unless it is the default. + if (material.GetClearcoatRoughnessFactor() != + defaults.GetClearcoatRoughnessFactor()) { + gltf_json_.OutputValue("clearcoatRoughnessFactor", + material.GetClearcoatRoughnessFactor()); + } + + // Add clearcoat texture (R channel) if present. + // TODO(vytyaz): Combine clearcoat and clearcoat roughness images if possible. + // TODO(vytyaz): Store texture in a grayscale format if possible. + DRACO_RETURN_IF_ERROR(EncodeTexture("clearcoatTexture", "_Clearcoat", + TextureMap::CLEARCOAT, 3, material, + material_index)); + + // Add clearcoat roughness texture (G channel) if present. + DRACO_RETURN_IF_ERROR(EncodeTexture( + "clearcoatRoughnessTexture", "_ClearcoatRoughness", + TextureMap::CLEARCOAT_ROUGHNESS, 3, material, material_index)); + + // Add clearcoat normal texture (RGB channels) if present. + DRACO_RETURN_IF_ERROR( + EncodeTexture("clearcoatNormalTexture", "_ClearcoatNormal", + TextureMap::CLEARCOAT_NORMAL, 3, material, material_index)); + + gltf_json_.EndObject(); // KHR_materials_clearcoat object. + + return OkStatus(); +} + +Status GltfAsset::EncodeMaterialVolumeExtension(const Material &material, + const Material &defaults, + int material_index) { + extensions_used_.insert("KHR_materials_volume"); + gltf_json_.BeginObject("KHR_materials_volume"); + + // Add thickness factor, unless it is the default. + if (material.GetThicknessFactor() != defaults.GetThicknessFactor()) { + gltf_json_.OutputValue("thicknessFactor", material.GetThicknessFactor()); + } + + // Add attenuation distance, unless it is the default. + if (material.GetAttenuationDistance() != defaults.GetAttenuationDistance()) { + gltf_json_.OutputValue("attenuationDistance", + material.GetAttenuationDistance()); + } + + // Add attenuation color, unless it is the default. + if (material.GetAttenuationColor() != defaults.GetAttenuationColor()) { + EncodeVectorArray("attenuationColor", + material.GetAttenuationColor()); + } + + // Add thickness texture (G channel) if present. + DRACO_RETURN_IF_ERROR(EncodeTexture("thicknessTexture", "_Thickness", + TextureMap::THICKNESS, 3, material, + material_index)); + + gltf_json_.EndObject(); // KHR_materials_volume object. + + return OkStatus(); +} + +Status GltfAsset::EncodeMaterialIorExtension(const Material &material, + const Material &defaults) { + extensions_used_.insert("KHR_materials_ior"); + gltf_json_.BeginObject("KHR_materials_ior"); + + // Add ior, unless it is the default. + if (material.GetIor() != defaults.GetIor()) { + gltf_json_.OutputValue("ior", material.GetIor()); + } + + gltf_json_.EndObject(); // KHR_materials_ior object. + + return OkStatus(); +} + +Status GltfAsset::EncodeMaterialSpecularExtension(const Material &material, + const Material &defaults, + int material_index) { + extensions_used_.insert("KHR_materials_specular"); + gltf_json_.BeginObject("KHR_materials_specular"); + + // Add specular factor, unless it is the default. + if (material.GetSpecularFactor() != defaults.GetSpecularFactor()) { + gltf_json_.OutputValue("specularFactor", material.GetSpecularFactor()); + } + + // Add specular color factor, unless it is the default. + if (material.GetSpecularColorFactor() != defaults.GetSpecularColorFactor()) { + EncodeVectorArray("specularColorFactor", + material.GetSpecularColorFactor()); + } + + // Add specular texture (A channel) if present. + // TODO(vytyaz): Combine specular and specular color images if possible. + DRACO_RETURN_IF_ERROR(EncodeTexture("specularTexture", "_Specular", + TextureMap::SPECULAR, 4, material, + material_index)); + + // Add specular color texture (RGB channels) if present. + DRACO_RETURN_IF_ERROR(EncodeTexture("specularColorTexture", "_SpecularColor", + TextureMap::SPECULAR_COLOR, -1, material, + material_index)); + + gltf_json_.EndObject(); // KHR_materials_specular object. + + return OkStatus(); +} + +Status GltfAsset::EncodeTexture(const std::string &name, + const std::string &stem_suffix, + TextureMap::Type type, int num_components, + const Material &material, int material_index) { + const TextureMap *const texture_map = material.GetTextureMapByType(type); + if (texture_map) { + if (num_components == -1) { + const bool rgba = true; // Unused for now. + num_components = rgba ? 4 : 3; + } + const std::string texture_stem = TextureUtils::GetOrGenerateTargetStem( + *texture_map->texture(), material_index, stem_suffix); + DRACO_ASSIGN_OR_RETURN( + const int image_index, + AddImage(texture_stem, texture_map->texture(), num_components)); + DRACO_RETURN_IF_ERROR(EncodeTextureMap(name, image_index, + texture_map->tex_coord_index(), + material, *texture_map)); + } + return OkStatus(); +} + +Status GltfAsset::EncodeAnimationsProperty(EncoderBuffer *buf_out) { + if (animations_.empty()) { + return OkStatus(); + } + + gltf_json_.BeginArray("animations"); + for (int i = 0; i < animations_.size(); ++i) { + gltf_json_.BeginObject(); + + if (!animations_[i]->name.empty()) { + gltf_json_.OutputValue("name", animations_[i]->name); + } + + gltf_json_.BeginArray("samplers"); + for (int j = 0; j < animations_[i]->samplers.size(); ++j) { + gltf_json_.BeginObject(); + gltf_json_.OutputValue("input", animations_[i]->samplers[j]->input_index); + gltf_json_.OutputValue( + "interpolation", + AnimationSampler::InterpolationToString( + animations_[i]->samplers[j]->interpolation_type)); + gltf_json_.OutputValue("output", + animations_[i]->samplers[j]->output_index); + gltf_json_.EndObject(); + } + gltf_json_.EndArray(); + + gltf_json_.BeginArray("channels"); + for (int j = 0; j < animations_[i]->channels.size(); ++j) { + gltf_json_.BeginObject(); + gltf_json_.OutputValue("sampler", + animations_[i]->channels[j]->sampler_index); + + gltf_json_.BeginObject("target"); + gltf_json_.OutputValue("node", animations_[i]->channels[j]->target_index); + gltf_json_.OutputValue( + "path", AnimationChannel::TransformationToString( + animations_[i]->channels[j]->transformation_type)); + gltf_json_.EndObject(); + + gltf_json_.EndObject(); // Channel entry. + } + gltf_json_.EndArray(); + + gltf_json_.EndObject(); // Animmation entry. + } + gltf_json_.EndArray(); + + const std::string asset_str = gltf_json_.MoveData(); + if (!buf_out->Encode(asset_str.data(), asset_str.length())) { + return Status(Status::DRACO_ERROR, "Could not encode animations."); + } + return OkStatus(); +} + +Status GltfAsset::EncodeSkinsProperty(EncoderBuffer *buf_out) { + if (skins_.empty()) { + return OkStatus(); + } + + gltf_json_.BeginArray("skins"); + for (int i = 0; i < skins_.size(); ++i) { + gltf_json_.BeginObject(); + + if (skins_[i]->inverse_bind_matrices_index >= 0) { + gltf_json_.OutputValue("inverseBindMatrices", + skins_[i]->inverse_bind_matrices_index); + } + if (skins_[i]->skeleton_index >= 0) { + gltf_json_.OutputValue("skeleton", skins_[i]->skeleton_index); + } + + if (!skins_[i]->joints.empty()) { + gltf_json_.BeginArray("joints"); + for (int j = 0; j < skins_[i]->joints.size(); ++j) { + gltf_json_.OutputValue(skins_[i]->joints[j]); + } + gltf_json_.EndArray(); + } + gltf_json_.EndObject(); // Skin entry. + } + gltf_json_.EndArray(); + + const std::string asset_str = gltf_json_.MoveData(); + if (!buf_out->Encode(asset_str.data(), asset_str.length())) { + return Status(Status::DRACO_ERROR, "Could not encode animations."); + } + return OkStatus(); +} + +Status GltfAsset::EncodeTopLevelExtensionsProperty(EncoderBuffer *buf_out) { + // Return if there are no top-level asset extensions to encode. + if (lights_.empty() && materials_variants_names_.empty() && + property_tables_.empty()) { + return OkStatus(); + } + + // Encode top-level extensions. + gltf_json_.BeginObject("extensions"); + DRACO_RETURN_IF_ERROR(EncodeLightsProperty(buf_out)); + DRACO_RETURN_IF_ERROR(EncodeMaterialsVariantsNamesProperty(buf_out)); + DRACO_RETURN_IF_ERROR(EncodeStructuralMetadataProperty(buf_out)); + gltf_json_.EndObject(); // extensions entry. + return OkStatus(); +} + +Status GltfAsset::EncodeLightsProperty(EncoderBuffer *buf_out) { + if (lights_.empty()) { + return OkStatus(); + } + + gltf_json_.BeginObject("KHR_lights_punctual"); + gltf_json_.BeginArray("lights"); + const Light defaults; + for (const auto &light : lights_) { + gltf_json_.BeginObject(); + if (light->GetName() != defaults.GetName()) { + gltf_json_.OutputValue("name", light->GetName()); + } + if (light->GetColor() != defaults.GetColor()) { + gltf_json_.BeginArray("color"); + gltf_json_.OutputValue(light->GetColor()[0]); + gltf_json_.OutputValue(light->GetColor()[1]); + gltf_json_.OutputValue(light->GetColor()[2]); + gltf_json_.EndArray(); + } + if (light->GetIntensity() != defaults.GetIntensity()) { + gltf_json_.OutputValue("intensity", light->GetIntensity()); + } + switch (light->GetType()) { + case Light::DIRECTIONAL: + gltf_json_.OutputValue("type", "directional"); + break; + case Light::POINT: + gltf_json_.OutputValue("type", "point"); + break; + case Light::SPOT: + gltf_json_.OutputValue("type", "spot"); + break; + } + if (light->GetRange() != defaults.GetRange()) { + gltf_json_.OutputValue("range", light->GetRange()); + } + if (light->GetType() == Light::SPOT) { + gltf_json_.BeginObject("spot"); + if (light->GetInnerConeAngle() != defaults.GetInnerConeAngle()) { + gltf_json_.OutputValue("innerConeAngle", light->GetInnerConeAngle()); + } + if (light->GetOuterConeAngle() != defaults.GetOuterConeAngle()) { + gltf_json_.OutputValue("outerConeAngle", light->GetOuterConeAngle()); + } + gltf_json_.EndObject(); + } + gltf_json_.EndObject(); + } + gltf_json_.EndArray(); + gltf_json_.EndObject(); // KHR_lights_punctual entry. + return OkStatus(); +} + +Status GltfAsset::EncodeMaterialsVariantsNamesProperty(EncoderBuffer *buf_out) { + if (materials_variants_names_.empty()) { + return OkStatus(); + } + + gltf_json_.BeginObject("KHR_materials_variants"); + gltf_json_.BeginArray("variants"); + for (const std::string &name : materials_variants_names_) { + gltf_json_.BeginObject(); + gltf_json_.OutputValue("name", name); + gltf_json_.EndObject(); + } + gltf_json_.EndArray(); + gltf_json_.EndObject(); // KHR_materials_variants entry. + return OkStatus(); +} + +Status GltfAsset::EncodeStructuralMetadataProperty(EncoderBuffer *buf_out) { + if (property_table_schema_.Empty()) { + return OkStatus(); + } + + gltf_json_.BeginObject("EXT_structural_metadata"); + + // Encodes property table schema. + struct SchemaWriter { + static void Write(const PropertyTable::Schema::Object &object, + JsonWriter *json_writer) { + switch (object.GetType()) { + case PropertyTable::Schema::Object::OBJECT: + json_writer->BeginObject(object.GetName()); + for (const PropertyTable::Schema::Object &obj : object.GetObjects()) { + Write(obj, json_writer); + } + json_writer->EndObject(); + break; + case PropertyTable::Schema::Object::ARRAY: + json_writer->BeginArray(object.GetName()); + for (const PropertyTable::Schema::Object &obj : object.GetArray()) { + Write(obj, json_writer); + } + json_writer->EndArray(); + break; + case PropertyTable::Schema::Object::STRING: + json_writer->OutputValue(object.GetName(), object.GetString()); + break; + case PropertyTable::Schema::Object::INTEGER: + json_writer->OutputValue(object.GetName(), object.GetInteger()); + break; + case PropertyTable::Schema::Object::BOOLEAN: + json_writer->OutputValue(object.GetName(), object.GetBoolean()); + break; + } + } + }; + + // Encode property table schema. + SchemaWriter::Write(property_table_schema_.json, &gltf_json_); + + // Encode all property tables. + gltf_json_.BeginArray("propertyTables"); + for (const PropertyTable *const table : property_tables_) { + gltf_json_.BeginObject(); + if (!table->GetName().empty()) { + gltf_json_.OutputValue("name", table->GetName()); + } + if (!table->GetClass().empty()) { + gltf_json_.OutputValue("class", table->GetClass()); + } + gltf_json_.OutputValue("count", table->GetCount()); + + // Encoder all property table properties. + gltf_json_.BeginObject("properties"); + for (int i = 0; i < table->NumProperties(); ++i) { + const PropertyTable::Property &property = table->GetProperty(i); + gltf_json_.BeginObject(property.GetName()); + + // Encode property values. + DRACO_ASSIGN_OR_RETURN(const int buffer_view_index, + AddBufferView(property.GetData())); + gltf_json_.OutputValue("values", buffer_view_index); + + // Encode offsets for variable-length arrays. + if (!property.GetArrayOffsets().data.data.empty()) { + if (!property.GetArrayOffsets().type.empty()) { + gltf_json_.OutputValue("arrayOffsetType", + property.GetArrayOffsets().type); + } + DRACO_ASSIGN_OR_RETURN(const int buffer_view_index, + AddBufferView(property.GetArrayOffsets().data)); + gltf_json_.OutputValue("arrayOffsets", buffer_view_index); + } + + // Encode offsets for strings. + if (!property.GetStringOffsets().data.data.empty()) { + if (!property.GetStringOffsets().type.empty()) { + gltf_json_.OutputValue("stringOffsetType", + property.GetStringOffsets().type); + } + DRACO_ASSIGN_OR_RETURN(const int buffer_view_index, + AddBufferView(property.GetStringOffsets().data)); + gltf_json_.OutputValue("stringOffsets", buffer_view_index); + } + gltf_json_.EndObject(); // Named property entry. + } + gltf_json_.EndObject(); // properties entry. + gltf_json_.EndObject(); + } + gltf_json_.EndArray(); // propertyTables entry. + gltf_json_.EndObject(); // EXT_structural_metadata entry. + return OkStatus(); +} + +bool GltfAsset::EncodeAccessorsProperty(EncoderBuffer *buf_out) { + gltf_json_.BeginArray("accessors"); + + for (int i = 0; i < accessors_.size(); ++i) { + gltf_json_.BeginObject(); + + if (accessors_[i].buffer_view_index >= 0) { + gltf_json_.OutputValue("bufferView", accessors_[i].buffer_view_index); + if (output_type_ == GltfEncoder::VERBOSE) { + gltf_json_.OutputValue("byteOffset", 0); + } + } + gltf_json_.OutputValue("componentType", accessors_[i].component_type); + gltf_json_.OutputValue("count", accessors_[i].count); + if (accessors_[i].normalized) { + gltf_json_.OutputValue("normalized", accessors_[i].normalized); + } + + if (!accessors_[i].max.empty()) { + gltf_json_.BeginArray("max"); + for (int j = 0; j < accessors_[i].max.size(); ++j) { + gltf_json_.OutputValue(accessors_[i].max[j]); + } + gltf_json_.EndArray(); + } + + if (!accessors_[i].min.empty()) { + gltf_json_.BeginArray("min"); + for (int j = 0; j < accessors_[i].min.size(); ++j) { + gltf_json_.OutputValue(accessors_[i].min[j]); + } + gltf_json_.EndArray(); + } + + gltf_json_.OutputValue("type", accessors_[i].type); + + gltf_json_.EndObject(); + } + + gltf_json_.EndArray(); + + const std::string asset_str = gltf_json_.MoveData(); + return buf_out->Encode(asset_str.data(), asset_str.length()); +} + +bool GltfAsset::EncodeBufferViewsProperty(EncoderBuffer *buf_out) { + // We currently only support one buffer. + gltf_json_.BeginArray("bufferViews"); + + for (int i = 0; i < buffer_views_.size(); ++i) { + gltf_json_.BeginObject(); + gltf_json_.OutputValue("buffer", 0); + gltf_json_.OutputValue("byteOffset", buffer_views_[i].buffer_byte_offset); + gltf_json_.OutputValue("byteLength", buffer_views_[i].byte_length); + if (buffer_views_[i].target != 0) { + gltf_json_.OutputValue("target", buffer_views_[i].target); + } + gltf_json_.EndObject(); + } + + gltf_json_.EndArray(); + + const std::string asset_str = gltf_json_.MoveData(); + return buf_out->Encode(asset_str.data(), asset_str.length()); +} + +bool GltfAsset::EncodeBuffersProperty(EncoderBuffer *buf_out) { + if (buffer_.size() == 0) { + return true; + } + // We currently only support one buffer. + gltf_json_.BeginArray("buffers"); + gltf_json_.BeginObject(); + gltf_json_.OutputValue("byteLength", buffer_.size()); + if (!buffer_name_.empty()) { + gltf_json_.OutputValue("uri", buffer_name_); + } + gltf_json_.EndObject(); + gltf_json_.EndArray(); + + const std::string asset_str = gltf_json_.MoveData(); + return buf_out->Encode(asset_str.data(), asset_str.length()); +} + +Status GltfAsset::EncodeExtensionsProperties(EncoderBuffer *buf_out) { + if (draco_compression_used_) { + const std::string draco_tag = "KHR_draco_mesh_compression"; + extensions_used_.insert(draco_tag); + extensions_required_.insert(draco_tag); + } + if (!lights_.empty()) { + extensions_used_.insert("KHR_lights_punctual"); + } + if (!materials_variants_names_.empty()) { + extensions_used_.insert("KHR_materials_variants"); + } + if (!instance_arrays_.empty()) { + extensions_used_.insert("EXT_mesh_gpu_instancing"); + extensions_required_.insert("EXT_mesh_gpu_instancing"); + } + if (mesh_features_used_) { + extensions_used_.insert("EXT_mesh_features"); + } + if (!property_table_schema_.Empty()) { + extensions_used_.insert("EXT_structural_metadata"); + } + + if (!extensions_required_.empty()) { + gltf_json_.BeginArray("extensionsRequired"); + for (const auto &extension : extensions_required_) { + gltf_json_.OutputValue(extension); + } + gltf_json_.EndArray(); + } + if (!extensions_used_.empty()) { + gltf_json_.BeginArray("extensionsUsed"); + for (const auto &extension : extensions_used_) { + gltf_json_.OutputValue(extension); + } + gltf_json_.EndArray(); + } + + const std::string asset_str = gltf_json_.MoveData(); + if (!asset_str.empty()) { + if (!buf_out->Encode(asset_str.data(), asset_str.length())) { + return Status(Status::DRACO_ERROR, "Could not encode extensions."); + } + } + return OkStatus(); +} + +template <> +GltfAsset::ComponentType GltfAsset::GetComponentType() const { + return BYTE; +} + +template <> +GltfAsset::ComponentType GltfAsset::GetComponentType() const { + return UNSIGNED_BYTE; +} + +template <> +GltfAsset::ComponentType GltfAsset::GetComponentType() const { + return SHORT; +} + +template <> +GltfAsset::ComponentType GltfAsset::GetComponentType() const { + return UNSIGNED_SHORT; +} + +template <> +GltfAsset::ComponentType GltfAsset::GetComponentType() const { + return UNSIGNED_INT; +} + +template <> +GltfAsset::ComponentType GltfAsset::GetComponentType() const { + return FLOAT; +} + +template +int GltfAsset::AddAttribute(const PointAttribute &att, int num_points, + int num_encoded_points, const std::string &type, + bool compress) { + if (att.size() == 0) { + return -1; // Attribute size must be greater than 0. + } + + std::array value; + std::array min_values; + std::array max_values; + + // Set min and max values. + if (!att.ConvertValue(AttributeValueIndex(0), + &min_values[0])) { + return -1; + } + max_values = min_values; + + if (output_type_ == GltfEncoder::VERBOSE || + att.attribute_type() == GeometryAttribute::POSITION) { + for (AttributeValueIndex i(1); i < static_cast(att.size()); ++i) { + if (!att.ConvertValue(i, &value[0])) { + return -1; + } + for (int j = 0; j < att_components_t; ++j) { + if (value[j] < min_values[j]) { + min_values[j] = value[j]; + } + if (value[j] > max_values[j]) { + max_values[j] = value[j]; + } + } + } + } + + const int kComponentSize = sizeof(att_data_t); + + GltfAccessor accessor; + if (!compress) { + const size_t buffer_start_offset = buffer_.size(); + for (PointIndex v(0); v < num_points; ++v) { + if (!att.ConvertValue(att.mapped_index(v), + &value[0])) { + return -1; + } + + for (int j = 0; j < att_components_t; ++j) { + buffer_.Encode(&value[j], kComponentSize); + } + } + + if (!PadBuffer()) { + return -1; + } + + GltfBufferView buffer_view; + buffer_view.buffer_byte_offset = buffer_start_offset; + buffer_view.byte_length = buffer_.size() - buffer_start_offset; + buffer_views_.push_back(buffer_view); + accessor.buffer_view_index = static_cast(buffer_views_.size() - 1); + } + + accessor.component_type = GetComponentType(); + accessor.count = num_encoded_points; + if (output_type_ == GltfEncoder::VERBOSE || + att.attribute_type() == GeometryAttribute::POSITION) { + for (int j = 0; j < att_components_t; ++j) { + accessor.max.push_back(GltfValue(max_values[j])); + accessor.min.push_back(GltfValue(min_values[j])); + } + } + accessor.type = type; + accessor.normalized = att.attribute_type() == GeometryAttribute::COLOR && + att.data_type() != DT_FLOAT32; + accessors_.push_back(accessor); + return static_cast(accessors_.size() - 1); +} + +const char GltfEncoder::kDracoMetadataGltfAttributeName[] = + "//GLTF/ApplicationSpecificAttributeName"; + +GltfEncoder::GltfEncoder() : out_buffer_(nullptr), output_type_(COMPACT) {} + +template +bool GltfEncoder::EncodeToFile(const T &geometry, const std::string &file_name, + const std::string &base_dir) { + const std::string buffer_name = base_dir + "/buffer0.bin"; + return EncodeFile(geometry, file_name, buffer_name, base_dir).ok(); +} + +template +Status GltfEncoder::EncodeFile(const T &geometry, const std::string &filename) { + if (filename.empty()) { + return Status(Status::DRACO_ERROR, "Output parameter is empty."); + } + + std::string dir_path; + std::string basename; + draco::SplitPath(filename, &dir_path, &basename); + const std::string bin_basename = ReplaceFileExtension(basename, "bin"); + const std::string bin_filename = dir_path + "/" + bin_basename; + return EncodeFile(geometry, filename, bin_filename, dir_path); +} + +template +Status GltfEncoder::EncodeFile(const T &geometry, const std::string &filename, + const std::string &bin_filename) { + if (filename.empty()) { + return Status(Status::DRACO_ERROR, "Output parameter is empty."); + } + + std::string dir_path; + std::string basename; + draco::SplitPath(filename, &dir_path, &basename); + return EncodeFile(geometry, filename, bin_filename, dir_path); +} + +template +Status GltfEncoder::EncodeFile(const T &geometry, const std::string &filename, + const std::string &bin_filename, + const std::string &resource_dir) { + if (filename.empty() || bin_filename.empty() || resource_dir.empty()) { + return Status(Status::DRACO_ERROR, "Output parameter is empty."); + } + const std::string extension = LowercaseFileExtension(filename); + if (extension != "gltf" && extension != "glb") { + return Status(Status::DRACO_ERROR, + "gltf_encoder only supports .gltf or .glb output."); + } + + GltfAsset gltf_asset; + gltf_asset.set_output_type(output_type_); + + if (extension == "gltf") { + std::string bin_path; + std::string bin_basename; + draco::SplitPath(bin_filename, &bin_path, &bin_basename); + gltf_asset.buffer_name(bin_basename); + } else { + gltf_asset.buffer_name(""); + gltf_asset.set_add_images_to_buffer(true); + } + + // Encode the geometry into a buffer. + EncoderBuffer buffer; + DRACO_RETURN_IF_ERROR(EncodeToBuffer(geometry, &gltf_asset, &buffer)); + if (extension == "glb") { + return WriteGlbFile(gltf_asset, buffer, filename); + } + return WriteGltfFiles(gltf_asset, buffer, filename, bin_filename, + resource_dir); +} + +template +Status GltfEncoder::EncodeToBuffer(const T &geometry, + EncoderBuffer *out_buffer) { + GltfAsset gltf_asset; + gltf_asset.set_output_type(output_type_); + gltf_asset.buffer_name(""); + gltf_asset.set_add_images_to_buffer(true); + + // Encode the geometry into a buffer. + EncoderBuffer buffer; + DRACO_RETURN_IF_ERROR(EncodeToBuffer(geometry, &gltf_asset, &buffer)); + + // Define a function for concatenating GLB file chunks into a single buffer. + const auto encode_chunk_to_buffer = + [&out_buffer](const EncoderBuffer &chunk) -> Status { + if (!out_buffer->Encode(chunk.data(), chunk.size())) { + return Status(Status::DRACO_ERROR, "Error writing to buffer."); + } + return OkStatus(); + }; + + // Create GLB file chunks and concatenate them to a single buffer. + return ProcessGlbFileChunks(gltf_asset, buffer, encode_chunk_to_buffer); +} + +// Explicit instantiation for Mesh and Scene. +template bool GltfEncoder::EncodeToFile(const Mesh &geometry, + const std::string &file_name, + const std::string &base_dir); +template bool GltfEncoder::EncodeToFile(const Scene &geometry, + const std::string &file_name, + const std::string &base_dir); +template Status GltfEncoder::EncodeFile(const Mesh &geometry, + const std::string &filename); +template Status GltfEncoder::EncodeFile(const Scene &geometry, + const std::string &filename); +template Status GltfEncoder::EncodeFile(const Mesh &geometry, + const std::string &filename, + const std::string &bin_filename); +template Status GltfEncoder::EncodeFile(const Scene &geometry, + const std::string &filename, + const std::string &bin_filename); +template Status GltfEncoder::EncodeFile(const Mesh &geometry, + const std::string &filename, + const std::string &bin_filename, + const std::string &resource_dir); +template Status GltfEncoder::EncodeFile(const Scene &geometry, + const std::string &filename, + const std::string &bin_filename, + const std::string &resource_dir); +template Status GltfEncoder::EncodeToBuffer(const Mesh &geometry, + EncoderBuffer *out_buffer); +template Status GltfEncoder::EncodeToBuffer(const Scene &geometry, + EncoderBuffer *out_buffer); + +Status GltfEncoder::EncodeToBuffer(const Mesh &mesh, GltfAsset *gltf_asset, + EncoderBuffer *out_buffer) { + out_buffer_ = out_buffer; + SetJsonWriterMode(gltf_asset); + if (!gltf_asset->AddDracoMesh(mesh)) { + return Status(Status::DRACO_ERROR, "Error adding Draco mesh."); + } + return gltf_asset->Output(out_buffer); +} + +Status GltfEncoder::EncodeToBuffer(const Scene &scene, GltfAsset *gltf_asset, + EncoderBuffer *out_buffer) { + out_buffer_ = out_buffer; + SetJsonWriterMode(gltf_asset); + DRACO_RETURN_IF_ERROR(gltf_asset->AddScene(scene)); + return gltf_asset->Output(out_buffer); +} + +void GltfEncoder::SetJsonWriterMode(class GltfAsset *gltf_asset) { + if (gltf_asset->output_type() == COMPACT && + gltf_asset->add_images_to_buffer()) { + gltf_asset->set_json_output_mode(JsonWriter::COMPACT); + } else { + gltf_asset->set_json_output_mode(JsonWriter::READABLE); + } +} + +Status GltfEncoder::WriteGltfFiles(const GltfAsset &gltf_asset, + const EncoderBuffer &buffer, + const std::string &filename, + const std::string &bin_filename, + const std::string &resource_dir) { + std::unique_ptr file = + FileWriterFactory::OpenWriter(filename); + if (!file) { + return Status(Status::DRACO_ERROR, "Output glTF file could not be opened."); + } + std::unique_ptr bin_file = + FileWriterFactory::OpenWriter(bin_filename); + if (!bin_file) { + return Status(Status::DRACO_ERROR, + "Output glTF bin file could not be opened."); + } + + // Write the glTF data into the file. + if (!file->Write(buffer.data(), buffer.size())) { + return Status(Status::DRACO_ERROR, "Error writing to glTF file."); + } + + // Write the glTF buffer into the file. + if (!bin_file->Write(gltf_asset.Buffer()->data(), + gltf_asset.Buffer()->size())) { + return Status(Status::DRACO_ERROR, "Error writing to glTF bin file."); + } + + for (int i = 0; i < gltf_asset.NumImages(); ++i) { + const std::string name = resource_dir + "/" + gltf_asset.image_name(i); + const GltfImage *const image = gltf_asset.GetImage(i); + if (!image) { + return Status(Status::DRACO_ERROR, "Error getting glTF image."); + } + DRACO_RETURN_IF_ERROR(WriteTextureToFile(name, *image->texture)); + } + return OkStatus(); +} + +Status GltfEncoder::WriteGlbFile(const GltfAsset &gltf_asset, + const EncoderBuffer &json_data, + const std::string &filename) { + std::unique_ptr file = + FileWriterFactory::OpenWriter(filename); + if (!file) { + return Status(Status::DRACO_ERROR, "Output glb file could not be opened."); + } + + // Define a function for writing GLB file chunks to |file|. + const auto write_chunk_to_file = + [&file](const EncoderBuffer &chunk) -> Status { + if (!file->Write(chunk.data(), chunk.size())) { + return Status(Status::DRACO_ERROR, "Error writing to glb file."); + } + return OkStatus(); + }; + + // Create GLB file chunks and write them to file. + return ProcessGlbFileChunks(gltf_asset, json_data, write_chunk_to_file); +} + +Status GltfEncoder::ProcessGlbFileChunks( + const class GltfAsset &gltf_asset, const EncoderBuffer &json_data, + const std::function &process_chunk) const { + // The json data must be padded so the next chunk starts on a 4-byte boundary. + const uint32_t json_pad_length = + (json_data.size() % 4) ? 4 - json_data.size() % 4 : 0; + const uint32_t json_length = json_data.size() + json_pad_length; + const uint32_t total_length = + 12 + 8 + json_length + 8 + gltf_asset.Buffer()->size(); + + EncoderBuffer header; + // Write the glb file header. + const uint32_t gltf_version = 2; + if (!header.Encode("glTF", 4)) { + return Status(Status::DRACO_ERROR, "Error writing to glb file."); + } + if (!header.Encode(gltf_version)) { + return Status(Status::DRACO_ERROR, "Error writing to glb file."); + } + if (!header.Encode(total_length)) { + return Status(Status::DRACO_ERROR, "Error writing to glb file."); + } + + // Write the JSON chunk. + const uint32_t json_chunk_type = 0x4E4F534A; + if (!header.Encode(json_length)) { + return Status(Status::DRACO_ERROR, "Error writing to glb file."); + } + if (!header.Encode(json_chunk_type)) { + return Status(Status::DRACO_ERROR, "Error writing to glb file."); + } + DRACO_RETURN_IF_ERROR(process_chunk(header)); + DRACO_RETURN_IF_ERROR(process_chunk(json_data)); + + // Pad the data if needed. + header.Clear(); + if (json_pad_length > 0) { + if (!header.Encode(" ", json_pad_length)) { + return Status(Status::DRACO_ERROR, "Error writing to glb file."); + } + } + + // Write the binary buffer chunk. + const uint32_t bin_chunk_type = 0x004E4942; + const uint32_t gltf_bin_size = gltf_asset.Buffer()->size(); + if (!header.Encode(gltf_bin_size)) { + return Status(Status::DRACO_ERROR, "Error writing to glb file."); + } + if (!header.Encode(bin_chunk_type)) { + return Status(Status::DRACO_ERROR, "Error writing to glb file."); + } + DRACO_RETURN_IF_ERROR(process_chunk(header)); + DRACO_RETURN_IF_ERROR(process_chunk(*gltf_asset.Buffer())); + return OkStatus(); +} + +} // namespace draco + +#endif // DRACO_TRANSCODER_SUPPORTED diff --git a/contrib/draco/src/draco/io/gltf_encoder.h b/contrib/draco/src/draco/io/gltf_encoder.h new file mode 100644 index 000000000..16403ac31 --- /dev/null +++ b/contrib/draco/src/draco/io/gltf_encoder.h @@ -0,0 +1,134 @@ +// Copyright 2018 The Draco Authors. +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. +// +#ifndef DRACO_IO_GLTF_ENCODER_H_ +#define DRACO_IO_GLTF_ENCODER_H_ + +#include "draco/draco_features.h" + +#ifdef DRACO_TRANSCODER_SUPPORTED +#include +#include +#include +#include +#include +#include + +#include "draco/core/encoder_buffer.h" +#include "draco/io/file_writer_factory.h" +#include "draco/io/file_writer_interface.h" +#include "draco/io/texture_io.h" +#include "draco/mesh/mesh.h" +#include "draco/scene/scene.h" + +namespace draco { + +// Class for encoding draco::Mesh into the glTF file format. +class GltfEncoder { + public: + // Types of output modes for the glTF data encoder. |COMPACT| will output + // required and non-default glTF data. |VERBOSE| will output required and + // default glTF data as well as readable JSON even when the output is saved in + // a glTF-Binary file. + enum OutputType { COMPACT, VERBOSE }; + + GltfEncoder(); + + // Encodes the geometry and saves it into a file. Returns false when either + // the encoding failed or when the file couldn't be opened. + template + bool EncodeToFile(const T &geometry, const std::string &file_name, + const std::string &base_dir); + + // Saves |geometry| into glTF 2.0 format. |filename| is the name of the + // glTF file. The glTF bin file (if needed) will be named stem(|filename|) + + // “.bin”. The other files (if needed) will be saved to basedir(|filename|). + // If |filename| has the extension "glb" then |filename| will be written as a + // glTF-Binary file. Otherwise |filename| will be written as non-binary glTF + // file. + template + Status EncodeFile(const T &geometry, const std::string &filename); + + // Saves |geometry| into glTF 2.0 format. |filename| is the name of the + // glTF file. |bin_filename| is the name of the glTF bin file. The other + // files (if needed) will be saved to basedir(|filename|). |bin_filename| will + // be ignored if output is glTF-Binary. + template + Status EncodeFile(const T &geometry, const std::string &filename, + const std::string &bin_filename); + + // Saves |geometry| into glTF 2.0 format. |filename| is the name of the + // glTF file. |bin_filename| is the name of the glTF bin file. The other + // files will be saved to |resource_dir|. |bin_filename| and |resource_dir| + // will be ignored if output is glTF-Binary. + template + Status EncodeFile(const T &geometry, const std::string &filename, + const std::string &bin_filename, + const std::string &resource_dir); + + // Encodes |geometry| to |out_buffer| in glTF 2.0 GLB format. + template + Status EncodeToBuffer(const T &geometry, EncoderBuffer *out_buffer); + + void set_output_type(OutputType type) { output_type_ = type; } + OutputType output_type() const { return output_type_; } + + // The name of the attribute metadata that contains the glTF attribute + // name. For application-specific generic attributes, if the metadata for + // an attribute contains this key, then the value will be used as the + // encoded attribute name in the output GLTF. + static const char kDracoMetadataGltfAttributeName[]; + + private: + // Encodes the mesh or the point cloud into a buffer. + Status EncodeToBuffer(const Mesh &mesh, class GltfAsset *gltf_asset, + EncoderBuffer *out_buffer); + Status EncodeToBuffer(const Scene &scene, class GltfAsset *gltf_asset, + EncoderBuffer *out_buffer); + + // Sets appropriate Json writer mode based on the provided |gltf_asset| + // options. + static void SetJsonWriterMode(class GltfAsset *gltf_asset); + + // Writes the ".gltf" and associted files. |gltf_asset| holds the glTF data. + // |buffer| is the encoded glTF json data. |filename| is the name of the + // ".gltf" file. |bin_filename| is the name of the glTF bin file. The other + // files will be saved to |resource_dir|. + Status WriteGltfFiles(const class GltfAsset &gltf_asset, + const EncoderBuffer &buffer, + const std::string &filename, + const std::string &bin_filename, + const std::string &resource_dir); + + // Writes the ".glb" file. |gltf_asset| holds the glTF data. |json_data| is + // the encoded glTF json data. |filename| is the name of the ".glb" file. + Status WriteGlbFile(const class GltfAsset &gltf_asset, + const EncoderBuffer &json_data, + const std::string &filename); + + // Creates GLB file chunks and passes them to |process_chunk| function for + // processing. |gltf_asset| holds the glTF data. |json_data| is the encoded + // glTF json data. + Status ProcessGlbFileChunks( + const class GltfAsset &gltf_asset, const EncoderBuffer &json_data, + const std::function &process_chunk) const; + + EncoderBuffer *out_buffer_; + OutputType output_type_; +}; + +} // namespace draco + +#endif // DRACO_TRANSCODER_SUPPORTED +#endif // DRACO_IO_GLTF_ENCODER_H_ diff --git a/contrib/draco/src/draco/io/gltf_encoder_test.cc b/contrib/draco/src/draco/io/gltf_encoder_test.cc new file mode 100644 index 000000000..179256dfd --- /dev/null +++ b/contrib/draco/src/draco/io/gltf_encoder_test.cc @@ -0,0 +1,1717 @@ +// Copyright 2018 The Draco Authors. +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. +// +#include "draco/io/gltf_encoder.h" + +#ifdef DRACO_TRANSCODER_SUPPORTED +#include +#include +#include +#include + +#include "draco/core/draco_test_base.h" +#include "draco/core/draco_test_utils.h" +#include "draco/io/file_reader_factory.h" +#include "draco/io/file_reader_interface.h" +#include "draco/io/file_utils.h" +#include "draco/io/gltf_decoder.h" +#include "draco/io/gltf_test_helper.h" +#include "draco/io/parser_utils.h" +#include "draco/io/texture_io.h" +#include "draco/material/material_utils.h" +#include "draco/mesh/mesh_utils.h" +#include "draco/scene/mesh_group.h" +#include "draco/scene/scene.h" +#include "draco/scene/scene_utils.h" +#include "draco/texture/texture_utils.h" + +namespace draco { + +namespace { +std::unique_ptr DecodeFullPathGltfFileToScene( + const std::string &file_name) { + GltfDecoder decoder; + + auto maybe_scene = decoder.DecodeFromFileToScene(file_name); + if (!maybe_scene.ok()) { + std::cout << maybe_scene.status().error_msg_string() << std::endl; + return nullptr; + } + std::unique_ptr scene = std::move(maybe_scene).value(); + return scene; +} + +std::unique_ptr DecodeTestGltfFileToScene(const std::string &file_name) { + const std::string path = GetTestFileFullPath(file_name); + return DecodeFullPathGltfFileToScene(path); +} +} // namespace + +class GltfEncoderTest : public ::testing::Test { + protected: + // This function searches for the |search| string and checks that there are at + // least |count| occurrences. + void CheckGltfFileAtLeastStringCount(const std::string &gltf_file, + const std::string &search, int count) { + std::vector data; + ASSERT_TRUE(ReadFileToBuffer(gltf_file, &data)); + + draco::DecoderBuffer buffer; + buffer.Init(data.data(), data.size()); + + int strings_found = 0; + do { + std::string gltf_line; + draco::parser::ParseLine(&buffer, &gltf_line); + if (gltf_line.empty()) { + break; + } + + if (gltf_line.find(search) != std::string::npos) { + strings_found++; + } + // No need to keep counting pass |count|. + } while (strings_found < count); + ASSERT_GE(strings_found, count); + } + + // This function searches for the |search| string and checks that there no + // occurrences. + void CheckGltfFileNoString(const std::string &gltf_file, + const std::string &search) { + std::vector data; + ASSERT_TRUE(ReadFileToBuffer(gltf_file, &data)); + + draco::DecoderBuffer buffer; + buffer.Init(data.data(), data.size()); + + do { + std::string gltf_line; + draco::parser::ParseLine(&buffer, &gltf_line); + if (gltf_line.empty()) { + break; + } + ASSERT_TRUE(gltf_line.find(search) == std::string::npos); + } while (true); + } + + void CheckAnimationAccessors(const Scene &scene, + int expected_num_input_accessors, + int expected_num_output_accessors) { + int num_input_accessors = 0; + int num_output_accessors = 0; + + for (int i = 0; i < scene.NumAnimations(); ++i) { + const Animation *anim = scene.GetAnimation(AnimationIndex(i)); + ASSERT_NE(anim, nullptr); + + // The animation accessors in Draco are relative to the Animation object. + // While in glTF the animation accessors are relative to the global + // accessors. + std::unordered_set seen_accessors; + + for (int j = 0; j < anim->NumSamplers(); ++j) { + const AnimationSampler *const sampler = anim->GetSampler(j); + ASSERT_NE(sampler, nullptr); + + if (seen_accessors.find(sampler->input_index) == seen_accessors.end()) { + seen_accessors.insert(sampler->input_index); + num_input_accessors++; + } + if (seen_accessors.find(sampler->output_index) == + seen_accessors.end()) { + seen_accessors.insert(sampler->output_index); + num_output_accessors++; + } + } + } + + EXPECT_EQ(expected_num_input_accessors, num_input_accessors); + EXPECT_EQ(expected_num_output_accessors, num_output_accessors); + } + + void CompareMeshes(const Mesh *mesh0, const Mesh *mesh1) { + ASSERT_EQ(mesh0->num_faces(), mesh1->num_faces()); + ASSERT_EQ(mesh0->num_attributes(), mesh1->num_attributes()); + for (int att_id = 0; att_id < mesh0->num_attributes(); ++att_id) { + const GeometryAttribute::Type att_type = + mesh0->attribute(att_id)->attribute_type(); + const PointAttribute *const att = mesh1->GetNamedAttribute(att_type); + ASSERT_EQ(mesh0->attribute(att_id)->size(), att->size()) + << "Attribute id:" << att_id << " is not equal."; + } + + // Check materials are the same. + if (mesh0->GetMaterialLibrary().NumMaterials() == 0) { + // We add a default material if the source had no materials. + ASSERT_EQ(mesh1->GetMaterialLibrary().NumMaterials(), 1); + } else if (mesh1->GetMaterialLibrary().NumMaterials() == 0) { + // We add a default material if the source had no materials. + ASSERT_EQ(mesh0->GetMaterialLibrary().NumMaterials(), 1); + } else { + ASSERT_EQ(mesh0->GetMaterialLibrary().NumMaterials(), + mesh1->GetMaterialLibrary().NumMaterials()); + for (int i = 0; i < mesh0->GetMaterialLibrary().NumMaterials(); ++i) { + ASSERT_EQ(mesh0->GetMaterialLibrary().GetMaterial(i)->NumTextureMaps(), + mesh1->GetMaterialLibrary().GetMaterial(i)->NumTextureMaps()); + ASSERT_EQ(mesh0->GetMaterialLibrary().GetMaterial(i)->GetName(), + mesh1->GetMaterialLibrary().GetMaterial(i)->GetName()); + } + } + } + + void CompareScenes(const Scene *scene0, const Scene *scene1) { + ASSERT_EQ(scene0->NumMeshes(), scene1->NumMeshes()); + ASSERT_EQ(scene0->NumMeshGroups(), scene1->NumMeshGroups()); + ASSERT_EQ(scene0->NumNodes(), scene1->NumNodes()); + ASSERT_EQ(scene0->GetMaterialLibrary().NumMaterials(), + scene1->GetMaterialLibrary().NumMaterials()); + ASSERT_EQ(scene0->NumAnimations(), scene1->NumAnimations()); + ASSERT_EQ(scene0->NumSkins(), scene1->NumSkins()); + ASSERT_EQ(scene0->NumLights(), scene1->NumLights()); + + // Check materials are the same. + for (int i = 0; i < scene0->GetMaterialLibrary().NumMaterials(); ++i) { + ASSERT_EQ(scene0->GetMaterialLibrary().GetMaterial(i)->NumTextureMaps(), + scene1->GetMaterialLibrary().GetMaterial(i)->NumTextureMaps()); + ASSERT_EQ(scene0->GetMaterialLibrary().GetMaterial(i)->GetName(), + scene1->GetMaterialLibrary().GetMaterial(i)->GetName()); + } + + // Check that materials variants names are the same. + ASSERT_EQ(scene0->GetMaterialLibrary().NumMaterialsVariants(), + scene1->GetMaterialLibrary().NumMaterialsVariants()); + for (int i = 0; i < scene0->GetMaterialLibrary().NumMaterialsVariants(); + i++) { + ASSERT_EQ(scene0->GetMaterialLibrary().GetMaterialsVariantName(i), + scene1->GetMaterialLibrary().GetMaterialsVariantName(i)); + } + + // Check Nodes are the same. + for (draco::SceneNodeIndex i(0); i < scene0->NumNodes(); ++i) { + const SceneNode *const scene_node0 = scene0->GetNode(i); + const SceneNode *const scene_node1 = scene1->GetNode(i); + ASSERT_NE(scene_node0, nullptr); + ASSERT_NE(scene_node1, nullptr); + ASSERT_EQ(scene_node0->GetName(), scene_node1->GetName()); + ASSERT_EQ(scene_node0->GetLightIndex(), scene_node1->GetLightIndex()); + } + + // Check MeshGroups are the same. + for (draco::MeshGroupIndex i(0); i < scene0->NumMeshGroups(); ++i) { + const MeshGroup *const mesh_group0 = scene0->GetMeshGroup(i); + const MeshGroup *const mesh_group1 = scene1->GetMeshGroup(i); + ASSERT_NE(mesh_group0, nullptr); + ASSERT_NE(mesh_group1, nullptr); + ASSERT_EQ(mesh_group0->GetName(), mesh_group1->GetName()); + ASSERT_EQ(mesh_group0->NumMeshInstances(), + mesh_group1->NumMeshInstances()); + + // Check that mesh instanes are the same. + for (int j = 0; j < mesh_group1->NumMeshInstances(); j++) { + const MeshGroup::MeshInstance &instance0 = + mesh_group0->GetMeshInstance(j); + const MeshGroup::MeshInstance &instance1 = + mesh_group1->GetMeshInstance(j); + ASSERT_EQ(instance0.mesh_index, instance1.mesh_index); + ASSERT_EQ(instance0.material_index, instance1.material_index); + ASSERT_EQ(instance0.materials_variants_mappings.size(), + instance1.materials_variants_mappings.size()); + + // Check that materials variants mappings are the same. + for (int k = 0; k < instance0.materials_variants_mappings.size(); k++) { + const MeshGroup::MaterialsVariantsMapping &mapping0 = + instance0.materials_variants_mappings[k]; + const MeshGroup::MaterialsVariantsMapping &mapping1 = + instance1.materials_variants_mappings[k]; + ASSERT_EQ(mapping0.material, mapping1.material); + ASSERT_EQ(mapping0.variants.size(), mapping1.variants.size()); + for (int l = 0; l < mapping0.variants.size(); l++) { + ASSERT_EQ(mapping0.variants[l], mapping1.variants[l]); + } + } + } + } + + // Check Animations are the same. + for (draco::AnimationIndex i(0); i < scene0->NumAnimations(); ++i) { + const Animation *const animation0 = scene0->GetAnimation(i); + const Animation *const animation1 = scene1->GetAnimation(i); + ASSERT_NE(animation0, nullptr); + ASSERT_NE(animation1, nullptr); + ASSERT_EQ(animation0->NumSamplers(), animation1->NumSamplers()); + ASSERT_EQ(animation0->NumChannels(), animation1->NumChannels()); + ASSERT_EQ(animation0->NumNodeAnimationData(), + animation1->NumNodeAnimationData()); + } + + // Check that lights are the same. + for (draco::LightIndex i(0); i < scene0->NumLights(); ++i) { + const Light *const light0 = scene0->GetLight(i); + const Light *const light1 = scene1->GetLight(i); + ASSERT_NE(light0, nullptr); + ASSERT_NE(light1, nullptr); + ASSERT_EQ(light0->GetName(), light1->GetName()); + ASSERT_EQ(light0->GetColor(), light1->GetColor()); + ASSERT_EQ(light0->GetIntensity(), light1->GetIntensity()); + ASSERT_EQ(light0->GetType(), light1->GetType()); + ASSERT_EQ(light0->GetRange(), light1->GetRange()); + if (light0->GetType() == Light::SPOT) { + ASSERT_EQ(light0->GetInnerConeAngle(), light1->GetInnerConeAngle()); + ASSERT_EQ(light0->GetOuterConeAngle(), light1->GetOuterConeAngle()); + } + } + } + + void EncodeMeshToFile(const Mesh &mesh, + const std::string &gltf_file_full_path) { + std::string folder_path; + std::string gltf_file_name; + draco::SplitPath(gltf_file_full_path, &folder_path, &gltf_file_name); + GltfEncoder gltf_encoder; + ASSERT_TRUE( + gltf_encoder.EncodeToFile(mesh, gltf_file_full_path, folder_path)) + << "Failed gltf_file_full_path:" << gltf_file_full_path + << " folder_path:" << folder_path; + } + + void EncodeSceneToFile(const Scene &scene, + const std::string &gltf_file_full_path) { + std::string folder_path; + std::string gltf_file_name; + draco::SplitPath(gltf_file_full_path, &folder_path, &gltf_file_name); + GltfEncoder gltf_encoder; + ASSERT_TRUE(gltf_encoder.EncodeToFile(scene, gltf_file_full_path, + folder_path)) + << "Failed gltf_file_full_path:" << gltf_file_full_path + << " folder_path:" << folder_path; + } + + // Encode |mesh| to a temporary glTF file. Then decode the glTF file and + // return the mesh in |mesh_gltf|. + void MeshToDecodedGltfMesh(const Mesh &mesh, + std::unique_ptr *mesh_gltf) { + const std::string gltf_file_full_path = + draco::GetTestTempFileFullPath("test.gltf"); + EncodeMeshToFile(mesh, gltf_file_full_path); + *mesh_gltf = std::move(ReadMeshFromFile(gltf_file_full_path)).value(); + ASSERT_NE(*mesh_gltf, nullptr); + } + + // Encode |mesh| to a temporary glTF file. Then decode the glTF file as a + // scene and return it in |scene_gltf|. + void MeshToDecodedGltfScene(const Mesh &mesh, + std::unique_ptr *scene_gltf) { + const std::string gltf_file_full_path = + draco::GetTestTempFileFullPath("test.gltf"); + EncodeMeshToFile(mesh, gltf_file_full_path); + *scene_gltf = std::move(ReadSceneFromFile(gltf_file_full_path)).value(); + ASSERT_NE(*scene_gltf, nullptr); + } + + // Encode |scene| to a temporary glTF file. Then decode the glTF file and + // return the scene in |scene_gltf|. + void SceneToDecodedGltfScene(const Scene &scene, + const std::string &temp_basename, + std::unique_ptr *scene_gltf) { + const std::string gltf_file_full_path = + draco::GetTestTempFileFullPath(temp_basename); + EncodeSceneToFile(scene, gltf_file_full_path); + + *scene_gltf = DecodeFullPathGltfFileToScene(gltf_file_full_path); + if (SceneUtils::IsDracoCompressionEnabled(scene)) { + // Two occurrences of the Draco compression string is the least amount for + // a valid Draco compressed glTF file. + const std::string khr_draco_compression = "KHR_draco_mesh_compression"; + CheckGltfFileAtLeastStringCount(gltf_file_full_path, + khr_draco_compression, 2); + } + ASSERT_NE((*scene_gltf).get(), nullptr); + } + + void SceneToDecodedGltfScene(const Scene &scene, + std::unique_ptr *scene_gltf) { + SceneToDecodedGltfScene(scene, "test.gltf", scene_gltf); + } + + void EncodeMeshToGltfAndCompare(Mesh *mesh) { + ASSERT_GT(mesh->num_faces(), 0); + + std::unique_ptr mesh_from_gltf; + MeshToDecodedGltfMesh(*mesh, &mesh_from_gltf); + + mesh->DeduplicatePointIds(); + ASSERT_TRUE(mesh->DeduplicateAttributeValues()); + CompareMeshes(mesh, mesh_from_gltf.get()); + } + + void EncodeSceneToGltfAndCompare(Scene *scene) { + std::unique_ptr scene_from_gltf; + SceneToDecodedGltfScene(*scene, &scene_from_gltf); + if (!SceneUtils::IsDracoCompressionEnabled(*scene)) { + CompareScenes(scene, scene_from_gltf.get()); + } + } + + void test_encoding(const std::string &file_name) { + const std::unique_ptr mesh(ReadMeshFromTestFile(file_name, true)); + + ASSERT_NE(mesh, nullptr) << "Failed to load test model " << file_name; + EncodeMeshToGltfAndCompare(mesh.get()); + } +}; + +TEST_F(GltfEncoderTest, TestGltfEncodingAll) { + // Test decoded mesh from encoded glTF file stays the same. + test_encoding("test_nm.obj.edgebreaker.cl4.2.2.drc"); + test_encoding("cube_att.drc"); + test_encoding("car.drc"); + test_encoding("bunny_gltf.drc"); +} + +TEST_F(GltfEncoderTest, ImportTangentAttribute) { + auto mesh = draco::ReadMeshFromTestFile("sphere.gltf"); + ASSERT_NE(mesh, nullptr); + + const draco::PointAttribute *const tangent_att = + mesh->GetNamedAttribute(draco::GeometryAttribute::TANGENT); + ASSERT_NE(tangent_att, nullptr); + + std::unique_ptr mesh_from_gltf; + MeshToDecodedGltfMesh(*mesh, &mesh_from_gltf); + ASSERT_EQ(mesh->num_attributes(), mesh_from_gltf->num_attributes()); +} + +TEST_F(GltfEncoderTest, EncodeColorTexture) { + const std::string tex_file_name = draco::GetTestFileFullPath("test.png"); + std::unique_ptr texture = + draco::ReadTextureFromFile(tex_file_name).value(); + ASSERT_NE(texture, nullptr); + + std::unique_ptr mesh = + draco::ReadMeshFromTestFile("cube_att.obj"); + ASSERT_NE(mesh, nullptr); + + mesh->GetMaterialLibrary().MutableMaterial(0)->SetTextureMap( + std::move(texture), draco::TextureMap::COLOR, 0); + + EncodeMeshToGltfAndCompare(mesh.get()); +} + +TEST_F(GltfEncoderTest, EncodeColors) { + auto mesh = draco::ReadMeshFromTestFile("test_pos_color.ply"); + ASSERT_NE(mesh, nullptr); + + const draco::PointAttribute *const color_att = + mesh->GetNamedAttribute(draco::GeometryAttribute::COLOR); + ASSERT_NE(color_att, nullptr); + + std::unique_ptr mesh_from_gltf; + MeshToDecodedGltfMesh(*mesh, &mesh_from_gltf); + + ASSERT_EQ(mesh->num_faces(), mesh_from_gltf->num_faces()); + ASSERT_EQ(mesh->num_attributes(), mesh_from_gltf->num_attributes()); + ASSERT_EQ( + mesh->NumNamedAttributes(draco::GeometryAttribute::COLOR), + mesh_from_gltf->NumNamedAttributes(draco::GeometryAttribute::COLOR)); +} + +TEST_F(GltfEncoderTest, EncodeNamedGenericAttribute) { + // Load some base mesh. + auto mesh = draco::ReadMeshFromTestFile("test_generic.ply"); + ASSERT_NE(mesh, nullptr); + const draco::PointAttribute *const pos_att = + mesh->GetNamedAttribute(draco::GeometryAttribute::POSITION); + ASSERT_NE(pos_att, nullptr); + int num_vertices = pos_att->size(); + + // Add two new scalar attributes where each value corresponds to the position + // value index (vertex). The first attribute will have metadata, the second + // attribute won't. + std::unique_ptr pa_0(new draco::PointAttribute()); + std::unique_ptr pa_1(new draco::PointAttribute()); + pa_0->Init(draco::GeometryAttribute::GENERIC, /* scalar */ 1, + draco::DT_FLOAT32, false, + /* one value per position value */ num_vertices); + pa_1->Init(draco::GeometryAttribute::GENERIC, /* scalar */ 1, + draco::DT_FLOAT32, false, + /* one value per position value */ num_vertices); + + // Set the values for the new attributes. + for (draco::AttributeValueIndex avi(0); avi < num_vertices; ++avi) { + const float att_value = avi.value(); + pa_0->SetAttributeValue(avi, &att_value); + pa_1->SetAttributeValue(avi, &att_value); + } + + // Add the attribute to the existing mesh. + const int new_att_id_0 = mesh->AddPerVertexAttribute(std::move(pa_0)); + const int new_att_id_1 = mesh->AddPerVertexAttribute(std::move(pa_1)); + ASSERT_NE(new_att_id_0, -1); + ASSERT_NE(new_att_id_1, -1); + + // Set metadata for first attribute so it gets written out by glTF encoder. + std::unique_ptr am(new draco::AttributeMetadata()); + constexpr char kAttributeName[] = "MyAttributeName"; + constexpr char kDracoMetadataGltfAttributeName[] = + "//GLTF/ApplicationSpecificAttributeName"; + am->AddEntryString(kDracoMetadataGltfAttributeName, kAttributeName); + mesh->AddAttributeMetadata(new_att_id_0, std::move(am)); + + // Make sure the GLTF contains a reference to the named attribute. + const std::string gltf_file_full_path = + draco::GetTestTempFileFullPath("GenericAttribute.gltf"); + std::string folder_path; + std::string gltf_file_name; + draco::SplitPath(gltf_file_full_path, &folder_path, &gltf_file_name); + GltfEncoder gltf_encoder; + ASSERT_TRUE(gltf_encoder.EncodeToFile(*(mesh.get()), + gltf_file_full_path, folder_path)) + << "Failed gltf_file_full_path:" << gltf_file_full_path + << " folder_path:" << folder_path; + CheckGltfFileAtLeastStringCount(gltf_file_full_path, kAttributeName, 1); + + // The decoder does not yet support generic attribute names, so instead of + // using the decoder we compare against a golden file. + const std::string gltf_generated_bin_filename = + draco::GetTestTempFileFullPath("buffer0.bin"); + std::vector generated_buffer; + ASSERT_TRUE(ReadFileToBuffer(gltf_generated_bin_filename, &generated_buffer)); + std::string generated_str(generated_buffer.data(), generated_buffer.size()); + + const std::string gltf_expected_bin_filename = + GetTestFileFullPath("test_generic_golden.bin"); + const bool kUpdateGoldens = false; + if (kUpdateGoldens) { + ASSERT_TRUE(WriteBufferToFile(generated_buffer.data(), + generated_buffer.size(), + gltf_expected_bin_filename)); + } + std::vector expected_buffer; + ASSERT_TRUE(ReadFileToBuffer(gltf_expected_bin_filename, &expected_buffer)); + std::string expected_str(expected_buffer.data(), expected_buffer.size()); + + EXPECT_TRUE(generated_str == expected_str); +} + +TEST_F(GltfEncoderTest, EncodeMetallicRoughnessTexture) { + const std::string tex_file_name = draco::GetTestFileFullPath("test.png"); + std::unique_ptr texture = + draco::ReadTextureFromFile(tex_file_name).value(); + ASSERT_NE(texture, nullptr); + + std::unique_ptr mesh = + draco::ReadMeshFromTestFile("cube_att.obj"); + ASSERT_NE(mesh, nullptr); + + mesh->GetMaterialLibrary().MutableMaterial(0)->SetTextureMap( + std::move(texture), draco::TextureMap::METALLIC_ROUGHNESS, 0); + + EncodeMeshToGltfAndCompare(mesh.get()); +} + +TEST_F(GltfEncoderTest, EncodeOcclusionTexture) { + const std::string tex_file_name = draco::GetTestFileFullPath("test.png"); + std::unique_ptr texture = + draco::ReadTextureFromFile(tex_file_name).value(); + ASSERT_NE(texture, nullptr); + + std::unique_ptr mesh = + draco::ReadMeshFromTestFile("cube_att.obj"); + ASSERT_NE(mesh, nullptr); + + mesh->GetMaterialLibrary().MutableMaterial(0)->SetTextureMap( + std::move(texture), draco::TextureMap::AMBIENT_OCCLUSION, 0); + + EncodeMeshToGltfAndCompare(mesh.get()); +} + +TEST_F(GltfEncoderTest, EncodeEmissiveTexture) { + const std::string tex_file_name = draco::GetTestFileFullPath("test.png"); + std::unique_ptr texture = + draco::ReadTextureFromFile(tex_file_name).value(); + ASSERT_NE(texture, nullptr); + + std::unique_ptr mesh = + draco::ReadMeshFromTestFile("cube_att.obj"); + ASSERT_NE(mesh, nullptr); + + mesh->GetMaterialLibrary().MutableMaterial(0)->SetTextureMap( + std::move(texture), draco::TextureMap::EMISSIVE, 0); + + EncodeMeshToGltfAndCompare(mesh.get()); +} + +// Tests splitting the mesh into multiple primitives. +TEST_F(GltfEncoderTest, EncodeSplitMesh) { + std::unique_ptr mesh = + draco::ReadMeshFromTestFile("CesiumMilkTruck/glTF/CesiumMilkTruck.gltf"); + ASSERT_NE(mesh, nullptr); + const int32_t material_att_id = + mesh->GetNamedAttributeId(draco::GeometryAttribute::MATERIAL); + ASSERT_NE(material_att_id, -1); + EncodeMeshToGltfAndCompare(mesh.get()); +} + +// Tests encoding a scene from a glTF with multiple meshes and primitives, +// including mesh instances. +TEST_F(GltfEncoderTest, EncodeInstancedScene) { + const std::string file_name = "CesiumMilkTruck/glTF/CesiumMilkTruck.gltf"; + const std::unique_ptr scene(DecodeTestGltfFileToScene(file_name)); + ASSERT_NE(scene, nullptr); + + std::unique_ptr transcoded_scene; + SceneToDecodedGltfScene(*scene, "EncodeInstancedScene.gltf", + &transcoded_scene); + ASSERT_NE(transcoded_scene, nullptr); + CompareScenes(scene.get(), transcoded_scene.get()); + EXPECT_EQ(transcoded_scene->NumAnimations(), 1); + + const int num_input_accessors = 2; + const int num_output_accessors = 2; + CheckAnimationAccessors(*transcoded_scene, num_input_accessors, + num_output_accessors); +} + +// Tests encoding a scene from a glTF with multiple meshes and primitives, +// including mesh instances. +TEST_F(GltfEncoderTest, EncodeBoneAnimation) { + const std::string file_name = "CesiumMan/glTF/CesiumMan.gltf"; + const std::unique_ptr scene(DecodeTestGltfFileToScene(file_name)); + ASSERT_NE(scene, nullptr); + + std::unique_ptr transcoded_scene; + SceneToDecodedGltfScene(*scene, "EncodeBoneAnimation.gltf", + &transcoded_scene); + ASSERT_NE(transcoded_scene, nullptr); + CompareScenes(scene.get(), transcoded_scene.get()); + EXPECT_EQ(transcoded_scene->NumAnimations(), 1); + + const Animation *anim = scene->GetAnimation(AnimationIndex(0)); + ASSERT_NE(anim, nullptr); + ASSERT_TRUE(anim->GetName().empty()); + + // TODO(b/145703399): Figure out how to test that all of the input accessors + // in animation channels in the encoded glTF file will be the same for this + // test file. + const int num_input_accessors = 57; + const int num_output_accessors = 57; + CheckAnimationAccessors(*transcoded_scene, num_input_accessors, + num_output_accessors); +} + +// Tests encoding a scene from a glTF with nodes that have names. +TEST_F(GltfEncoderTest, EncodeSceneWithNodeNames) { + const std::string file_name = "Lantern/glTF/Lantern.gltf"; + const std::unique_ptr scene(DecodeTestGltfFileToScene(file_name)); + ASSERT_NE(scene, nullptr); + EncodeSceneToGltfAndCompare(scene.get()); +} + +// Tests encoding a simple glTF with Draco compression. +TEST_F(GltfEncoderTest, EncodeWithDracoCompression) { + const std::string file_name = "Box/glTF/Box.gltf"; + const std::unique_ptr scene(DecodeTestGltfFileToScene(file_name)); + ASSERT_NE(scene, nullptr); + const DracoCompressionOptions options; + SceneUtils::SetDracoCompressionOptions(&options, scene.get()); + EncodeSceneToGltfAndCompare(scene.get()); +} + +TEST_F(GltfEncoderTest, EncodeWeightsJointsWithDracoCompression) { + const std::string file_name = "CesiumMan/glTF/CesiumMan.gltf"; + const std::unique_ptr scene(DecodeTestGltfFileToScene(file_name)); + ASSERT_NE(scene, nullptr); + const DracoCompressionOptions options; + SceneUtils::SetDracoCompressionOptions(&options, scene.get()); + EncodeSceneToGltfAndCompare(scene.get()); +} + +TEST_F(GltfEncoderTest, EncodeTangentsWithDracoCompression) { + const std::string file_name = "Lantern/glTF/Lantern.gltf"; + const std::unique_ptr scene(DecodeTestGltfFileToScene(file_name)); + ASSERT_NE(scene, nullptr); + const DracoCompressionOptions options; + SceneUtils::SetDracoCompressionOptions(&options, scene.get()); + EncodeSceneToGltfAndCompare(scene.get()); +} + +TEST_F(GltfEncoderTest, TestDracoCompressionWithGeneratedPoints) { + const std::string basename = "test_nm.obj"; + std::unique_ptr mesh = draco::ReadMeshFromTestFile(basename); + ASSERT_NE(mesh, nullptr) << "Failed to load " << basename; + + auto maybe_scene = draco::SceneUtils::MeshToScene(std::move(mesh)); + ASSERT_TRUE(maybe_scene.ok()) << "Failed Mesh to Scene conversion."; + const std::unique_ptr scene = std::move(maybe_scene).value(); + ASSERT_NE(scene, nullptr); + const DracoCompressionOptions options; + SceneUtils::SetDracoCompressionOptions(&options, scene.get()); + EncodeSceneToGltfAndCompare(scene.get()); +} + +TEST_F(GltfEncoderTest, TestDracoCompressionWithDegenerateFaces) { + const std::string basename = "deg_faces.obj"; + std::unique_ptr mesh = draco::ReadMeshFromTestFile(basename); + ASSERT_NE(mesh, nullptr) << "Failed to load " << basename; + ASSERT_EQ(mesh->num_faces(), 4); + + auto maybe_scene = draco::SceneUtils::MeshToScene(std::move(mesh)); + ASSERT_TRUE(maybe_scene.ok()) << "Failed Mesh to Scene conversion."; + const std::unique_ptr scene = std::move(maybe_scene).value(); + ASSERT_NE(scene, nullptr); + const Mesh &scene_first_mesh = scene->GetMesh(MeshIndex(0)); + ASSERT_EQ(scene_first_mesh.num_faces(), 4); + + std::unique_ptr scene_from_gltf; + const DracoCompressionOptions options; + SceneUtils::SetDracoCompressionOptions(&options, scene.get()); + SceneToDecodedGltfScene(*scene, &scene_from_gltf); + const Mesh &scene_from_gltf_first_mesh = + scene_from_gltf->GetMesh(MeshIndex(0)); + ASSERT_EQ(scene_from_gltf_first_mesh.num_faces(), 3); + + CompareScenes(scene.get(), scene_from_gltf.get()); +} + +TEST_F(GltfEncoderTest, DracoCompressionCheckOptions) { + const std::string file_name = "CesiumMan/glTF/CesiumMan.gltf"; + const std::unique_ptr scene(DecodeTestGltfFileToScene(file_name)); + ASSERT_NE(scene, nullptr); + + const std::string gltf_file_full_path = + draco::GetTestTempFileFullPath("test.gltf"); + std::string folder_path; + std::string gltf_file_name; + draco::SplitPath(gltf_file_full_path, &folder_path, &gltf_file_name); + GltfEncoder gltf_encoder; + DracoCompressionOptions options; + SceneUtils::SetDracoCompressionOptions(&options, scene.get()); + + ASSERT_TRUE(gltf_encoder.EncodeToFile(*scene, gltf_file_full_path, + folder_path)) + << "Failed gltf_file_full_path:" << gltf_file_full_path + << " folder_path:" << folder_path; + + const std::string gltf_bin_filename = + draco::GetTestTempFileFullPath("buffer0.bin"); + const size_t default_bin_size = draco::GetFileSize(gltf_bin_filename); + + // Test applying more quantization will make the compressed size smaller. + options.quantization_position.SetQuantizationBits(6); + options.quantization_bits_normal = 6; + options.quantization_bits_tex_coord = 6; + SceneUtils::SetDracoCompressionOptions(&options, scene.get()); + + ASSERT_TRUE(gltf_encoder.EncodeToFile(*scene, gltf_file_full_path, + folder_path)) + << "Failed gltf_file_full_path:" << gltf_file_full_path + << " folder_path:" << folder_path; + const size_t more_quantization_bin_size = + draco::GetFileSize(gltf_bin_filename); + ASSERT_LT(more_quantization_bin_size, default_bin_size); + + // Test setting more weight quantization then the default makes the compressed + // size smaller. + options.quantization_bits_weight = 6; + SceneUtils::SetDracoCompressionOptions(&options, scene.get()); + + ASSERT_TRUE(gltf_encoder.EncodeToFile(*scene, gltf_file_full_path, + folder_path)) + << "Failed gltf_file_full_path:" << gltf_file_full_path + << " folder_path:" << folder_path; + const size_t more_weight_quantization_bin_size = + draco::GetFileSize(gltf_bin_filename); + ASSERT_LT(more_weight_quantization_bin_size, more_quantization_bin_size); + + options.quantization_position.SetQuantizationBits(20); + options.quantization_bits_normal = 20; + options.quantization_bits_tex_coord = 20; + options.quantization_bits_weight = 20; + SceneUtils::SetDracoCompressionOptions(&options, scene.get()); + + ASSERT_TRUE(gltf_encoder.EncodeToFile(*scene, gltf_file_full_path, + folder_path)) + << "Failed gltf_file_full_path:" << gltf_file_full_path + << " folder_path:" << folder_path; + const size_t less_quantization_bin_size = + draco::GetFileSize(gltf_bin_filename); + ASSERT_GT(less_quantization_bin_size, default_bin_size); + + DracoCompressionOptions level_options; + level_options.compression_level = 10; // compression level [0-10]. + SceneUtils::SetDracoCompressionOptions(&level_options, scene.get()); + ASSERT_TRUE(gltf_encoder.EncodeToFile(*scene, gltf_file_full_path, + folder_path)) + << "Failed gltf_file_full_path:" << gltf_file_full_path + << " folder_path:" << folder_path; + const size_t most_compression_bin_size = + draco::GetFileSize(gltf_bin_filename); + ASSERT_LT(most_compression_bin_size, default_bin_size); + + level_options.compression_level = 4; + SceneUtils::SetDracoCompressionOptions(&level_options, scene.get()); + ASSERT_TRUE(gltf_encoder.EncodeToFile(*scene, gltf_file_full_path, + folder_path)) + << "Failed gltf_file_full_path:" << gltf_file_full_path + << " folder_path:" << folder_path; + const size_t less_compression_bin_size = + draco::GetFileSize(gltf_bin_filename); + ASSERT_GT(less_compression_bin_size, default_bin_size); + + level_options.compression_level = 0; + SceneUtils::SetDracoCompressionOptions(&level_options, scene.get()); + ASSERT_TRUE(gltf_encoder.EncodeToFile(*scene, gltf_file_full_path, + folder_path)) + << "Failed gltf_file_full_path:" << gltf_file_full_path + << " folder_path:" << folder_path; + const size_t least_compression_bin_size = + draco::GetFileSize(gltf_bin_filename); + ASSERT_GT(least_compression_bin_size, less_compression_bin_size); +} + +TEST_F(GltfEncoderTest, TestQuantizationPerAttribute) { + const std::string file_name = "sphere.gltf"; + const std::unique_ptr scene(DecodeTestGltfFileToScene(file_name)); + ASSERT_NE(scene, nullptr); + + const std::string gltf_file_full_path = + draco::GetTestTempFileFullPath("test.gltf"); + std::string folder_path; + std::string gltf_file_name; + draco::SplitPath(gltf_file_full_path, &folder_path, &gltf_file_name); + GltfEncoder gltf_encoder; + DracoCompressionOptions options; + SceneUtils::SetDracoCompressionOptions(&options, scene.get()); + + ASSERT_TRUE(gltf_encoder.EncodeToFile(*scene, gltf_file_full_path, + folder_path)) + << "Failed gltf_file_full_path:" << gltf_file_full_path + << " folder_path:" << folder_path; + + const std::string gltf_bin_filename = + draco::GetTestTempFileFullPath("buffer0.bin"); + const size_t default_bin_size = draco::GetFileSize(gltf_bin_filename); + + // Test setting more position quantization then the default makes the + // compressed size smaller. + options.quantization_position.SetQuantizationBits(6); + SceneUtils::SetDracoCompressionOptions(&options, scene.get()); + ASSERT_TRUE(gltf_encoder.EncodeToFile(*scene, gltf_file_full_path, + folder_path)) + << "Failed gltf_file_full_path:" << gltf_file_full_path + << " folder_path:" << folder_path; + const size_t position_quantization_bin_size = + draco::GetFileSize(gltf_bin_filename); + ASSERT_LT(position_quantization_bin_size, default_bin_size); + + // Test setting more normal quantization then the default makes the compressed + // size smaller. + options.quantization_bits_normal = 6; + SceneUtils::SetDracoCompressionOptions(&options, scene.get()); + ASSERT_TRUE(gltf_encoder.EncodeToFile(*scene, gltf_file_full_path, + folder_path)) + << "Failed gltf_file_full_path:" << gltf_file_full_path + << " folder_path:" << folder_path; + const size_t normal_quantization_bin_size = + draco::GetFileSize(gltf_bin_filename); + ASSERT_LT(normal_quantization_bin_size, position_quantization_bin_size); + + // Test setting more tex_coord quantization then the default makes the + // compressed size smaller. + options.quantization_bits_tex_coord = 6; + SceneUtils::SetDracoCompressionOptions(&options, scene.get()); + ASSERT_TRUE(gltf_encoder.EncodeToFile(*scene, gltf_file_full_path, + folder_path)) + << "Failed gltf_file_full_path:" << gltf_file_full_path + << " folder_path:" << folder_path; + const size_t tex_coord_quantization_bin_size = + draco::GetFileSize(gltf_bin_filename); + ASSERT_LT(tex_coord_quantization_bin_size, normal_quantization_bin_size); + + // Test setting more tangent quantization then the default makes the + // compressed size smaller. Weight is tested in DracoCompressionCheckOptions. + options.quantization_bits_tangent = 6; + SceneUtils::SetDracoCompressionOptions(&options, scene.get()); + ASSERT_TRUE(gltf_encoder.EncodeToFile(*scene, gltf_file_full_path, + folder_path)) + << "Failed gltf_file_full_path:" << gltf_file_full_path + << " folder_path:" << folder_path; + const size_t tangent_quantization_bin_size = + draco::GetFileSize(gltf_bin_filename); + ASSERT_LT(tangent_quantization_bin_size, tex_coord_quantization_bin_size); +} + +// Tests encoding a glTF with multiple scaled instances with Draco compression +// using grid options for position quantization. +TEST_F(GltfEncoderTest, TestDracoCompressionWithGridOptions) { + const std::string file_name = + "SpheresScaledInstances/glTF/spheres_scaled_instances.gltf"; + std::unique_ptr scene(DecodeTestGltfFileToScene(file_name)); + ASSERT_NE(scene, nullptr); + + const auto bbox = scene->GetMesh(MeshIndex(0)).ComputeBoundingBox(); + const float mesh_size = bbox.Size().MaxCoeff(); + + // All dimensions of the original mesh are between [-1, 1]. Let's move the + // mesh to [0, 2] which will allow us to match grid quantization with the + // regular quantization (grid quantization is always aligned with 0). + Mesh &mesh = scene->GetMesh(MeshIndex(0)); + PointAttribute *pos_att = + mesh.attribute(mesh.GetNamedAttributeId(GeometryAttribute::POSITION)); + for (AttributeValueIndex avi(0); avi < pos_att->size(); ++avi) { + Vector3f pos; + pos_att->GetValue(avi, &pos[0]); + pos += Vector3f(1.f, 1.f, 1.f); + pos_att->SetAttributeValue(avi, &pos[0]); + } + + DracoCompressionOptions options; + + // First quantize the scene with 8 bits and save the result. + options.quantization_position.SetQuantizationBits(8); + SceneUtils::SetDracoCompressionOptions(&options, scene.get()); + + const std::string gltf_filename = draco::GetTestTempFileFullPath("temp.glb"); + GltfEncoder encoder; + DRACO_ASSERT_OK(encoder.EncodeFile(*scene, gltf_filename)); + // Get the size of the generated file. + const size_t qb_file_size = draco::GetFileSize(gltf_filename); + + // Now set grid quantization and ensure the encoded file size is about the + // same. The max instance scale is 3 and model size is |mesh_size| so the grid + // scale must account for that. + options.quantization_position.SetGrid(mesh_size * 3. / 255.); + SceneUtils::SetDracoCompressionOptions(&options, scene.get()); + + DRACO_ASSERT_OK(encoder.EncodeFile(*scene, gltf_filename)); + // Get the size of the generated file. + const size_t grid_file_size = draco::GetFileSize(gltf_filename); + + ASSERT_EQ(grid_file_size, qb_file_size); + + // Now set grid quantization to different settings and ensure the encoded size + // changed. We reduce spacing which should increase the size. + options.quantization_position.SetGrid(mesh_size * 3. / 511.); + SceneUtils::SetDracoCompressionOptions(&options, scene.get()); + + DRACO_ASSERT_OK(encoder.EncodeFile(*scene, gltf_filename)); + + // Get the size of the generated file. + const size_t grid_file_size_2 = draco::GetFileSize(gltf_filename); + ASSERT_GT(grid_file_size_2, grid_file_size); +} + +TEST_F(GltfEncoderTest, TestOutputType) { + const std::string file_name = "sphere.gltf"; + const std::unique_ptr scene(DecodeTestGltfFileToScene(file_name)); + ASSERT_NE(scene, nullptr); + + const std::string gltf_file_full_path = + draco::GetTestTempFileFullPath("test.gltf"); + std::string folder_path; + std::string gltf_file_name; + draco::SplitPath(gltf_file_full_path, &folder_path, &gltf_file_name); + GltfEncoder gltf_encoder; + + ASSERT_TRUE(gltf_encoder.EncodeToFile(*scene, gltf_file_full_path, + folder_path)) + << "Failed gltf_file_full_path:" << gltf_file_full_path + << " folder_path:" << folder_path; + + const size_t default_gltf_size = draco::GetFileSize(gltf_file_full_path); + + // Test setting VERBOSE output type will increase the size of the gltf file. + gltf_encoder.set_output_type(GltfEncoder::VERBOSE); + ASSERT_TRUE(gltf_encoder.EncodeToFile(*scene, gltf_file_full_path, + folder_path)) + << "Failed gltf_file_full_path:" << gltf_file_full_path + << " folder_path:" << folder_path; + const size_t verbose_gltf_size = draco::GetFileSize(gltf_file_full_path); + ASSERT_GT(verbose_gltf_size, default_gltf_size); +} + +// Tests copying the name of the input texture file to the encoded texture file. +TEST_F(GltfEncoderTest, CopyTextureName) { + std::unique_ptr mesh = + draco::ReadMeshFromTestFile("CesiumMilkTruck/glTF/CesiumMilkTruck.gltf"); + ASSERT_NE(mesh, nullptr); + + std::unique_ptr mesh_from_gltf; + MeshToDecodedGltfMesh(*mesh, &mesh_from_gltf); + const Material *material = mesh->GetMaterialLibrary().GetMaterial(0); + ASSERT_NE(material, nullptr); + const Texture *texture = + mesh->GetMaterialLibrary().GetTextureLibrary().GetTexture(0); + ASSERT_NE(texture, nullptr); + ASSERT_EQ(draco::TextureUtils::GetTargetStem(*texture), "CesiumMilkTruck"); + ASSERT_EQ(draco::TextureUtils::GetTargetFormat(*texture), + draco::ImageFormat::PNG); +} + +TEST_F(GltfEncoderTest, EncodeTexCoord1) { + std::unique_ptr mesh = + draco::ReadMeshFromTestFile("MultiUVTest/glTF/MultiUVTest.gltf"); + + std::unique_ptr mesh_from_gltf; + MeshToDecodedGltfMesh(*mesh, &mesh_from_gltf); + ASSERT_EQ(mesh_from_gltf->GetMaterialLibrary().NumMaterials(), 1); + ASSERT_EQ( + mesh_from_gltf->GetMaterialLibrary().GetMaterial(0)->NumTextureMaps(), 2); + ASSERT_EQ( + mesh_from_gltf->GetMaterialLibrary().GetTextureLibrary().NumTextures(), + 2); + const std::vector textures = { + mesh_from_gltf->GetMaterialLibrary().GetTextureLibrary().GetTexture(0), + mesh_from_gltf->GetMaterialLibrary().GetTextureLibrary().GetTexture(1)}; + EXPECT_EQ(draco::TextureUtils::GetTargetStem(*textures[0]), "uv0"); + EXPECT_EQ(draco::TextureUtils::GetTargetStem(*textures[1]), "uv1"); + EXPECT_EQ(draco::TextureUtils::GetTargetFormat(*textures[0]), + draco::ImageFormat::PNG); + EXPECT_EQ(draco::TextureUtils::GetTargetFormat(*textures[1]), + draco::ImageFormat::PNG); + ASSERT_EQ(mesh_from_gltf->NumNamedAttributes(GeometryAttribute::TEX_COORD), + 2); + ASSERT_EQ(mesh_from_gltf->NumNamedAttributes(GeometryAttribute::POSITION), 1); + ASSERT_EQ(mesh_from_gltf->NumNamedAttributes(GeometryAttribute::NORMAL), 1); + ASSERT_EQ(mesh_from_gltf->NumNamedAttributes(GeometryAttribute::TANGENT), 1); +} + +TEST_F(GltfEncoderTest, TestEncodeFileFunctions) { + const std::string file_name = "sphere.gltf"; + const std::unique_ptr scene(DecodeTestGltfFileToScene(file_name)); + ASSERT_NE(scene, nullptr); + + // Test encoding with only the gltf filename parameter will output the correct + // bin filename and the textures will be in the same directory as the output + // glTF file. + const std::string output_gltf_filename = + draco::GetTestTempFileFullPath("encoded_example.gltf"); + std::string output_gltf_dir; + std::string output_gltf_basename; + draco::SplitPath(output_gltf_filename, &output_gltf_dir, + &output_gltf_basename); + + GltfEncoder gltf_encoder; + ASSERT_TRUE(gltf_encoder.EncodeFile(*scene, output_gltf_filename).ok()) + << "Failed to encode glTF filename:" << output_gltf_filename; + + const std::string output_bin_filename = + draco::GetTestTempFileFullPath("encoded_example.bin"); + const size_t output_bin_size = draco::GetFileSize(output_bin_filename); + ASSERT_GT(output_bin_size, 0); + const std::string output_png_filename = + draco::GetTestTempFileFullPath("sphere_Texture0_Normal.png"); + const size_t output_png_size = draco::GetFileSize(output_png_filename); + ASSERT_GT(output_png_size, 0); + + // Test encoding with the gltf and bin filename parameter, the textures will + // be in the same directory as the output glTF file. + const std::string new_bin_filename = + draco::GetTestTempFileFullPath("different_stem_name.bin"); + ASSERT_TRUE( + gltf_encoder + .EncodeFile(*scene, output_gltf_filename, new_bin_filename) + .ok()) + << "Failed to encode glTF filename:" << output_gltf_filename; + + const size_t new_bin_size = draco::GetFileSize(new_bin_filename); + ASSERT_GT(new_bin_size, 0); + ASSERT_EQ(new_bin_size, output_bin_size); + + // Test encoding with the gltf and bin filename and resource_dir parameter, + // the textures will be in the resource_dir directory. + const std::string new_resource_dir = output_gltf_dir + "/textures"; + ASSERT_TRUE(gltf_encoder + .EncodeFile(*scene, output_gltf_filename, + new_bin_filename, new_resource_dir) + .ok()) + << "Failed to encode glTF filename:" << output_gltf_filename; + + const std::string new_png_filename = + draco::GetTestTempFileFullPath("textures/sphere_Texture0_Normal.png"); + const size_t newest_bin_size = draco::GetFileSize(new_bin_filename); + ASSERT_GT(new_bin_size, 0); + ASSERT_EQ(new_bin_size, output_bin_size); + ASSERT_EQ(newest_bin_size, new_bin_size); + const size_t new_png_size = draco::GetFileSize(new_png_filename); + ASSERT_GT(new_png_size, 0); + ASSERT_EQ(new_png_size, output_png_size); +} + +TEST_F(GltfEncoderTest, DoubleSidedMaterial) { + const std::string file_name = "TwoSidedPlane/glTF/TwoSidedPlane.gltf"; + const std::unique_ptr scene(DecodeTestGltfFileToScene(file_name)); + ASSERT_NE(scene, nullptr); + EXPECT_EQ(scene->GetMaterialLibrary().NumMaterials(), 1); + EXPECT_EQ(scene->GetMaterialLibrary().GetMaterial(0)->GetDoubleSided(), true); + + std::unique_ptr scene_from_gltf; + SceneToDecodedGltfScene(*scene, &scene_from_gltf); + EXPECT_EQ(scene_from_gltf->GetMaterialLibrary().NumMaterials(), 1); + EXPECT_EQ( + scene_from_gltf->GetMaterialLibrary().GetMaterial(0)->GetDoubleSided(), + true); +} + +TEST_F(GltfEncoderTest, EncodeGlb) { + const std::string file_name = "sphere.gltf"; + const std::unique_ptr scene(DecodeTestGltfFileToScene(file_name)); + ASSERT_NE(scene, nullptr); + + std::unique_ptr scene_from_gltf; + SceneToDecodedGltfScene(*scene, "temp.gltf", &scene_from_gltf); + + std::unique_ptr scene_from_glb; + SceneToDecodedGltfScene(*scene, "temp.glb", &scene_from_glb); + + CompareScenes(scene_from_gltf.get(), scene_from_glb.get()); +} + +TEST_F(GltfEncoderTest, EncodeVertexColor) { + const std::string file_name = "VertexColorTest/glTF/VertexColorTest.gltf"; + const std::unique_ptr scene(DecodeTestGltfFileToScene(file_name)); + ASSERT_NE(scene, nullptr); + EXPECT_EQ(scene->NumMeshes(), 2); + const Mesh &mesh = scene->GetMesh(MeshIndex(1)); + EXPECT_EQ(mesh.NumNamedAttributes(GeometryAttribute::COLOR), 1); + + std::unique_ptr scene_from_gltf; + SceneToDecodedGltfScene(*scene, "temp.gltf", &scene_from_gltf); + EXPECT_EQ(scene_from_gltf->NumMeshes(), 2); + const Mesh &encoded_mesh = scene_from_gltf->GetMesh(MeshIndex(1)); + EXPECT_EQ(encoded_mesh.NumNamedAttributes(GeometryAttribute::COLOR), 1); +} + +TEST_F(GltfEncoderTest, InterpolationTest) { + const std::string file_name = "InterpolationTest/glTF/InterpolationTest.gltf"; + const std::unique_ptr scene(DecodeTestGltfFileToScene(file_name)); + ASSERT_NE(scene, nullptr); + + std::unique_ptr transcoded_scene; + SceneToDecodedGltfScene(*scene, "InterpolationTest.gltf", &transcoded_scene); + ASSERT_NE(transcoded_scene, nullptr); + CompareScenes(scene.get(), transcoded_scene.get()); + EXPECT_EQ(transcoded_scene->NumAnimations(), 9); + + const std::vector animation_names{ + "Step Scale", "Linear Scale", + "CubicSpline Scale", "Step Rotation", + "CubicSpline Rotation", "Linear Rotation", + "Step Translation", "CubicSpline Translation", + "Linear Translation"}; + for (int i = 0; i < scene->NumAnimations(); ++i) { + const Animation *const anim = scene->GetAnimation(AnimationIndex(i)); + ASSERT_NE(anim, nullptr); + ASSERT_EQ(anim->GetName(), animation_names[i]); + } + + // Currently all animation data is unique. See b/145703399. + const int num_input_accessors = 9; + const int num_output_accessors = 9; + CheckAnimationAccessors(*transcoded_scene, num_input_accessors, + num_output_accessors); +} + +TEST_F(GltfEncoderTest, KhrMaterialUnlit) { + const std::string filename = + "KhronosSampleModels/UnlitTest/glTF/UnlitTest.gltf"; + const std::unique_ptr scene(DecodeTestGltfFileToScene(filename)); + ASSERT_NE(scene, nullptr); + + const std::string output_gltf_filename = + draco::GetTestTempFileFullPath("encoded_example.gltf"); + std::string output_gltf_dir; + std::string output_gltf_basename; + draco::SplitPath(output_gltf_filename, &output_gltf_dir, + &output_gltf_basename); + + GltfEncoder gltf_encoder; + ASSERT_TRUE(gltf_encoder.EncodeFile(*scene, output_gltf_filename).ok()) + << "Failed to encode glTF filename:" << output_gltf_filename; + // glTF file should have four occurences of "KHR_materials_unlit". Two in the + // materials and one in extensionsUsed and one in extensionsRequired. + CheckGltfFileAtLeastStringCount(output_gltf_filename, "KHR_materials_unlit", + 4); +} + +TEST_F(GltfEncoderTest, OneMaterialUnlitWithFallback) { + const std::string filename = + "UnlitWithFallback/one_material_all_fallback/" + "one_material_all_fallback.gltf"; + const std::unique_ptr scene(DecodeTestGltfFileToScene(filename)); + ASSERT_NE(scene, nullptr); + + const std::string output_gltf_filename = + draco::GetTestTempFileFullPath("encoded_example.gltf"); + std::string output_gltf_dir; + std::string output_gltf_basename; + draco::SplitPath(output_gltf_filename, &output_gltf_dir, + &output_gltf_basename); + + GltfEncoder gltf_encoder; + ASSERT_TRUE(gltf_encoder.EncodeFile(*scene, output_gltf_filename).ok()) + << "Failed to encode glTF filename:" << output_gltf_filename; + + // glTF file should have two occurences of "KHR_materials_unlit". One in the + // materials and one in extensionsUsed. + CheckGltfFileAtLeastStringCount(output_gltf_filename, "KHR_materials_unlit", + 2); + + // The glTF file should provide a fallback to "KHR_materials_unlit", so there + // should be no "extensionsRequired" element. + CheckGltfFileNoString(output_gltf_filename, "extensionsRequired"); +} + +TEST_F(GltfEncoderTest, MultipleMaterialsUnlitWithFallback) { + std::string filename = + "UnlitWithFallback/three_materials_all_fallback/" + "three_materials_all_fallback.gltf"; + const std::unique_ptr scene_all_fallback( + DecodeTestGltfFileToScene(filename)); + ASSERT_NE(scene_all_fallback, nullptr); + + const std::string output_gltf_filename = + draco::GetTestTempFileFullPath("encoded_example.gltf"); + std::string output_gltf_dir; + std::string output_gltf_basename; + draco::SplitPath(output_gltf_filename, &output_gltf_dir, + &output_gltf_basename); + + GltfEncoder gltf_encoder; + ASSERT_TRUE( + gltf_encoder.EncodeFile(*scene_all_fallback, output_gltf_filename) + .ok()) + << "Failed to encode glTF filename:" << output_gltf_filename; + + // glTF file should have four occurences of "KHR_materials_unlit". Three in + // the materials and one in extensionsUsed. + CheckGltfFileAtLeastStringCount(output_gltf_filename, "KHR_materials_unlit", + 4); + + // The glTF file should provide a fallback to "KHR_materials_unlit", so there + // should be no "extensionsRequired" element. + CheckGltfFileNoString(output_gltf_filename, "extensionsRequired"); + + filename = + "UnlitWithFallback/three_materials_one_fallback/" + "three_materials_one_fallback.gltf"; + const std::unique_ptr scene_one_fallback( + DecodeTestGltfFileToScene(filename)); + ASSERT_NE(scene_one_fallback, nullptr); + + ASSERT_TRUE( + gltf_encoder.EncodeFile(*scene_one_fallback, output_gltf_filename) + .ok()) + << "Failed to encode glTF filename:" << output_gltf_filename; + + // glTF file should have three occurences of "KHR_materials_unlit". One in the + // materials, one in extensionsUsed, and one in extensionsRequired. + CheckGltfFileAtLeastStringCount(output_gltf_filename, "KHR_materials_unlit", + 3); + + // The glTF file only has one material with a fallback for + // "KHR_materials_unlit". The other two materials have "KHR_materials_unlit" + // set without a fallback, so there should be an "extensionsRequired" element. + CheckGltfFileAtLeastStringCount(output_gltf_filename, "extensionsRequired", + 1); +} + +TEST_F(GltfEncoderTest, KhrMaterialsSheenExtension) { + const std::string filename = + "KhronosSampleModels/SheenCloth/glTF/SheenCloth.gltf"; + const std::unique_ptr scene(DecodeTestGltfFileToScene(filename)); + ASSERT_NE(scene, nullptr); + + const std::string out_filename = + draco::GetTestTempFileFullPath("encoded_example.gltf"); + std::string output_gltf_dir; + std::string output_gltf_basename; + draco::SplitPath(out_filename, &output_gltf_dir, &output_gltf_basename); + + GltfEncoder gltf_encoder; + ASSERT_TRUE(gltf_encoder.EncodeFile(*scene, out_filename).ok()) + << "Failed to encode glTF filename:" << out_filename; + + // The "KHR_materials_sheen" should be in material and in extensionsUsed. + CheckGltfFileAtLeastStringCount(out_filename, "KHR_materials_sheen", 2); + CheckGltfFileAtLeastStringCount(out_filename, "sheenColorFactor", 1); + CheckGltfFileAtLeastStringCount(out_filename, "sheenColorTexture", 1); + CheckGltfFileAtLeastStringCount(out_filename, "sheenRoughnessFactor", 1); + CheckGltfFileAtLeastStringCount(out_filename, "sheenRoughnessTexture", 1); +} + +TEST_F(GltfEncoderTest, PbrNextExtensions) { + // Check that a model with PBR material extensions is encoded correctly. This + // is done by encoding an original model with all PBR material extension + // properties and textures, then decoding it and checking that it matches the + // original model. + // TODO(vytyaz): Test multiple materials with various sets of extensions. + + // Read the original model. + const std::string orig_name = "pbr_next/sphere/glTF/sphere.gltf"; + const std::unique_ptr original(DecodeTestGltfFileToScene(orig_name)); + ASSERT_NE(original, nullptr); + const Material &original_mat = *original->GetMaterialLibrary().GetMaterial(0); + + // Check that the original material has PBR extensions. + EXPECT_TRUE(original_mat.HasSheen()); + EXPECT_TRUE(original_mat.HasTransmission()); + EXPECT_TRUE(original_mat.HasClearcoat()); + EXPECT_TRUE(original_mat.HasVolume()); + EXPECT_TRUE(original_mat.HasIor()); + EXPECT_TRUE(original_mat.HasSpecular()); + + // Write the original model to a temporary file. + GltfEncoder encoder; + const std::string tmp_name = draco::GetTestTempFileFullPath("tmp.gltf"); + DRACO_ASSERT_OK(encoder.EncodeFile(*original, tmp_name)); + + // Read model from the temporay file. + GltfDecoder decoder; + DRACO_ASSIGN_OR_ASSERT(auto encoded, decoder.DecodeFromFileToScene(tmp_name)); + ASSERT_NE(encoded, nullptr); +} + +TEST_F(GltfEncoderTest, KhrTextureTransformWithoutFallback) { + // This is the example from Khronos, which should have "KHR_texture_transform" + // listed in the extensionsRequired, but does not for testing out client + // implementations. + const std::string filename = + "KhronosSampleModels/TextureTransformTest/glTF/TextureTransformTest.gltf"; + const std::unique_ptr scene(DecodeTestGltfFileToScene(filename)); + ASSERT_NE(scene, nullptr); + + const std::string output_gltf_filename = + draco::GetTestTempFileFullPath("encoded_example.gltf"); + std::string output_gltf_dir; + std::string output_gltf_basename; + draco::SplitPath(output_gltf_filename, &output_gltf_dir, + &output_gltf_basename); + + GltfEncoder gltf_encoder; + ASSERT_TRUE(gltf_encoder.EncodeFile(*scene, output_gltf_filename).ok()) + << "Failed to encode glTF filename:" << output_gltf_filename; + // glTF file should have eight occurences of "KHR_materials_unlit". Six in the + // materials and one in extensionsUsed and one in extensionsRequired. + CheckGltfFileAtLeastStringCount(output_gltf_filename, "KHR_texture_transform", + 8); + + // glTF file should still contain only two occurences of '"sampler": 0'. + CheckGltfFileAtLeastStringCount(output_gltf_filename, "\"sampler\": 0", 2); + + // glTF file should have one occurence of "wrapS", "wrapT", "minFilter", and + // "magFilter". + CheckGltfFileAtLeastStringCount(output_gltf_filename, "wrapS", 1); + CheckGltfFileAtLeastStringCount(output_gltf_filename, "wrapT", 1); + CheckGltfFileAtLeastStringCount(output_gltf_filename, "minFilter", 1); + CheckGltfFileAtLeastStringCount(output_gltf_filename, "magFilter", 1); +} + +TEST_F(GltfEncoderTest, KhrTextureTransformWithoutFallbackRequried) { + // This is the example from Khronos, changed to list "KHR_texture_transform" + // in extensionsRequired. + const std::string filename = + "glTF/TextureTransformTestWithRequired/" + "TextureTransformTestWithRequired.gltf"; + const std::unique_ptr scene(DecodeTestGltfFileToScene(filename)); + ASSERT_NE(scene, nullptr); + + const std::string output_gltf_filename = + draco::GetTestTempFileFullPath("encoded_example.gltf"); + std::string output_gltf_dir; + std::string output_gltf_basename; + draco::SplitPath(output_gltf_filename, &output_gltf_dir, + &output_gltf_basename); + + GltfEncoder gltf_encoder; + ASSERT_TRUE(gltf_encoder.EncodeFile(*scene, output_gltf_filename).ok()) + << "Failed to encode glTF filename:" << output_gltf_filename; + // glTF file should have eight occurences of "KHR_materials_unlit". Six in the + // materials and one in extensionsUsed and one in extensionsRequired. + CheckGltfFileAtLeastStringCount(output_gltf_filename, "KHR_texture_transform", + 8); +} + +TEST_F(GltfEncoderTest, KhrTextureTransformWithFallback) { + // This is an example of "KHR_texture_transform" extension with fallback data. + const std::string filename = + "glTF/KhrTextureTransformWithFallback/" + "KhrTextureTransformWithFallback.gltf"; + const std::unique_ptr scene(DecodeTestGltfFileToScene(filename)); + ASSERT_NE(scene, nullptr); + + const std::string output_gltf_filename = + draco::GetTestTempFileFullPath("encoded_example.gltf"); + std::string output_gltf_dir; + std::string output_gltf_basename; + draco::SplitPath(output_gltf_filename, &output_gltf_dir, + &output_gltf_basename); + + GltfEncoder gltf_encoder; + ASSERT_TRUE(gltf_encoder.EncodeFile(*scene, output_gltf_filename).ok()) + << "Failed to encode glTF filename:" << output_gltf_filename; + // glTF file should have two occurences of "KHR_materials_unlit". One in the + // materials and one in extensionsUsed. + CheckGltfFileAtLeastStringCount(output_gltf_filename, "KHR_texture_transform", + 2); +} + +// Tests if the source file has a node with an identity matrix, that we do not +// output the identiy matrix. +TEST_F(GltfEncoderTest, MeshWithIdentityTransformation) { + const std::string gltf_source_full_path = + GetTestFileFullPath("Triangle/glTF/Triangle_identity_matrix.gltf"); + + // Check that the source file contains one "matrix" and no "translation" + // strings. + CheckGltfFileAtLeastStringCount(gltf_source_full_path, "matrix", 1); + CheckGltfFileNoString(gltf_source_full_path, "translation"); + + std::unique_ptr scene = draco::ReadSceneFromTestFile( + "Triangle/glTF/Triangle_identity_matrix.gltf"); + ASSERT_NE(scene, nullptr); + SceneNode *scene_node = scene->GetNode(SceneNodeIndex(0)); + ASSERT_NE(scene_node, nullptr); + const TrsMatrix &trs_matrix = scene_node->GetTrsMatrix(); + + // gltf_decoder will not set the trs matrix if the matrix is identity. + ASSERT_FALSE(trs_matrix.MatrixSet()); + + // Add the identity matrix. + TrsMatrix trsm; + trsm.SetMatrix(Eigen::Matrix4d::Identity()); + scene_node->SetTrsMatrix(trsm); + + const TrsMatrix &check_trs_matrix = scene_node->GetTrsMatrix(); + ASSERT_TRUE(check_trs_matrix.MatrixSet()); + ASSERT_EQ(check_trs_matrix.IsMatrixIdentity(), true); + + const std::string gltf_file_full_path = + draco::GetTestTempFileFullPath("MeshWithIdentityTransformation.gltf"); + std::string folder_path; + std::string gltf_file_name; + draco::SplitPath(gltf_file_full_path, &folder_path, &gltf_file_name); + GltfEncoder gltf_encoder; + + ASSERT_TRUE(gltf_encoder.EncodeToFile( + *scene.get(), gltf_file_full_path, folder_path)) + << "Failed gltf_file_full_path:" << gltf_file_full_path + << " folder_path:" << folder_path; + std::unique_ptr scene_gltf = + std::move(ReadSceneFromFile(gltf_file_full_path)).value(); + ASSERT_NE(scene_gltf, nullptr); + // Check that the output file contains no "matrix" or "translation" strings. + CheckGltfFileNoString(gltf_file_full_path, "matrix"); + CheckGltfFileNoString(gltf_file_full_path, "translation"); +} + +// Tests if the source file has a node with a matrix that only has the +// translation values set. If it does then instead of outputting the full matrix +// we only output the "translation" glTF element. +TEST_F(GltfEncoderTest, MeshWithTranslationOnlyMatrix) { + std::unique_ptr scene = draco::ReadSceneFromTestFile( + "Triangle/glTF/Triangle_translation_only_matrix.gltf"); + ASSERT_NE(scene, nullptr); + SceneNode *scene_node = scene->GetNode(SceneNodeIndex(0)); + ASSERT_NE(scene_node, nullptr); + const TrsMatrix &input_trs_matrix = scene_node->GetTrsMatrix(); + ASSERT_TRUE(input_trs_matrix.MatrixSet()); + ASSERT_FALSE(input_trs_matrix.TranslationSet()); + ASSERT_FALSE(input_trs_matrix.RotationSet()); + ASSERT_FALSE(input_trs_matrix.ScaleSet()); + ASSERT_TRUE(input_trs_matrix.IsMatrixTranslationOnly()); + + const std::string gltf_file_full_path = + draco::GetTestTempFileFullPath("MeshWithTranslationOnlyMatrix.gltf"); + std::string folder_path; + std::string gltf_file_name; + draco::SplitPath(gltf_file_full_path, &folder_path, &gltf_file_name); + GltfEncoder gltf_encoder; + + ASSERT_TRUE(gltf_encoder.EncodeToFile( + *scene.get(), gltf_file_full_path, folder_path)) + << "Failed gltf_file_full_path:" << gltf_file_full_path + << " folder_path:" << folder_path; + std::unique_ptr scene_gltf = + std::move(ReadSceneFromFile(gltf_file_full_path)).value(); + ASSERT_NE(scene_gltf, nullptr); + SceneNode *output_scene_node = scene_gltf->GetNode(SceneNodeIndex(0)); + ASSERT_NE(output_scene_node, nullptr); + const TrsMatrix &output_trs_matrix = output_scene_node->GetTrsMatrix(); + ASSERT_FALSE(output_trs_matrix.MatrixSet()); + ASSERT_TRUE(output_trs_matrix.TranslationSet()); + ASSERT_FALSE(output_trs_matrix.RotationSet()); + ASSERT_FALSE(output_trs_matrix.ScaleSet()); +} + +// Tests that a scene can be encoded to buffer in GLB format. +TEST_F(GltfEncoderTest, EncodeToBuffer) { + // Load scene from file. + const std::string file_name = "CesiumMilkTruck/glTF/CesiumMilkTruck.gltf"; + const std::unique_ptr scene = ReadSceneFromTestFile(file_name); + ASSERT_NE(scene, nullptr); + + // Encode scene to buffer in GLB format. + GltfEncoder encoder; + EncoderBuffer buffer; + DRACO_ASSERT_OK(encoder.EncodeToBuffer(*scene, &buffer)); + ASSERT_NE(buffer.size(), 0); + + // Write scene to file in GLB format. + const std::string glb_file_path = draco::GetTestTempFileFullPath("temp.glb"); + std::string folder_path; + std::string glb_file_name; + draco::SplitPath(glb_file_path, &folder_path, &glb_file_name); + encoder.EncodeToFile(*scene, glb_file_path, folder_path); + + // Check that the buffer contents match the GLB file contents. + ASSERT_EQ(buffer.size(), draco::GetFileSize(glb_file_path)); + std::vector file_data; + ASSERT_TRUE(ReadFileToBuffer(glb_file_path, &file_data)); + ASSERT_EQ(std::memcmp(file_data.data(), buffer.data(), buffer.size()), 0); +} + +// Tests that a scene with lights can be encoded into a file. +TEST_F(GltfEncoderTest, EncodeLights) { + const std::string file_name = "sphere_lights.gltf"; + const std::unique_ptr scene = ReadSceneFromTestFile(file_name); + ASSERT_NE(scene, nullptr); + ASSERT_EQ(scene->NumLights(), 4); + EncodeSceneToGltfAndCompare(scene.get()); +} + +// Helper method for adding mesh group GPU instancing to the milk truck scene. +draco::Status AddGpuInstancingToMilkTruck(draco::Scene *scene) { + // Create an instance and set its transformation TRS vectors. + draco::InstanceArray::Instance instance_0; + instance_0.trs.SetTranslation(Eigen::Vector3d(-0.2, 0.0, 0.0)); + instance_0.trs.SetScale(Eigen::Vector3d(1.0, 1.0, 1.0)); + + // Create another instance. + draco::InstanceArray::Instance instance_1; + instance_1.trs.SetTranslation(Eigen::Vector3d(1.0, 0.0, 0.0)); + instance_1.trs.SetScale(Eigen::Vector3d(2.0, 2.0, 2.0)); + + // Add an empty GPU instancing object to the scene. + const draco::InstanceArrayIndex index = scene->AddInstanceArray(); + draco::InstanceArray *gpu_instancing = scene->GetInstanceArray(index); + + // Add two instances to the GPU instancing object stored in the scene. + DRACO_RETURN_IF_ERROR(gpu_instancing->AddInstance(instance_0)); + DRACO_RETURN_IF_ERROR(gpu_instancing->AddInstance(instance_1)); + + // Assign the GPU instancing object to two mesh groups in two scene nodes. + scene->GetNode(draco::SceneNodeIndex(2))->SetInstanceArrayIndex(index); + scene->GetNode(draco::SceneNodeIndex(4))->SetInstanceArrayIndex(index); + + return draco::OkStatus(); +} + +// Tests that a scene with instance arrays can be encoded into a file. Decoder +// has no GPU instancing support, so we will compare encoded file to a golden +// file. +TEST_F(GltfEncoderTest, EncodeInstanceArrays) { + // Read the milk truck. + auto scene = + draco::ReadSceneFromTestFile("CesiumMilkTruck/glTF/CesiumMilkTruck.gltf"); + ASSERT_NE(scene, nullptr); + + // Add GPU instancing to the scene for testing. + DRACO_ASSERT_OK(AddGpuInstancingToMilkTruck(scene.get())); + ASSERT_EQ(scene->NumInstanceArrays(), 1); + ASSERT_EQ(scene->NumNodes(), 5); + + // Prepare file paths. + const std::string temp_path = draco::GetTestTempFileFullPath("Truck.glb"); + const std::string golden_path = + GetTestFileFullPath("CesiumRowingTruckWithGpuInstancing.glb"); + + // Encode scene to a temporary file in GLB format. + std::string folder; + std::string name; + draco::SplitPath(temp_path, &folder, &name); + GltfEncoder encoder; + ASSERT_TRUE(encoder.EncodeToFile(*scene, temp_path, folder)) + << "Failed to encode to temporary file:" << temp_path; + + // Read encoded file to buffer. + std::vector encoded_data; + ASSERT_TRUE(ReadFileToBuffer(temp_path, &encoded_data)); +} + +// Tests that a scene with materials variants can be encoded into a file. +TEST_F(GltfEncoderTest, EncodeMaterialsVariants) { + const std::string file_name = + "KhronosSampleModels/DragonAttenuation/glTF/DragonAttenuation.gltf"; + const std::unique_ptr scene = ReadSceneFromTestFile(file_name); + ASSERT_NE(scene, nullptr); + ASSERT_EQ(scene->GetMaterialLibrary().NumMaterialsVariants(), 2); + EncodeSceneToGltfAndCompare(scene.get()); +} + +// Tests encoding of draco::Scene to glTF with various mesh feature ID sets and +// structural metadata property table. +TEST_F(GltfEncoderTest, EncodeSceneWithMeshFeaturesWithStructuralMetadata) { + const std::string file_name = "BoxMeta/glTF/BoxMeta.gltf"; + constexpr bool kHasMeshFeatures = true; + constexpr bool kHasStructuralMetadata = true; + constexpr bool kHasDracoCompression = false; + + // Read test file from file. + const std::unique_ptr scene(DecodeTestGltfFileToScene(file_name)); + ASSERT_NE(scene, nullptr); + + // Encode the scene to glTF and decode it back to draco::Scene and check. + std::unique_ptr scene_from_gltf; + SceneToDecodedGltfScene(*scene, &scene_from_gltf); + ASSERT_NE(scene_from_gltf, nullptr); + GltfTestHelper::CheckBoxMetaMeshFeatures(*scene_from_gltf, + kHasDracoCompression); + GltfTestHelper::CheckBoxMetaStructuralMetadata(*scene_from_gltf); +} + +// Tests encoding of draco::Scene with Draco compression to glTF with various +// mesh feature ID sets. +TEST_F(GltfEncoderTest, EncodeSceneWithMeshFeaturesWithDracoCompression) { + const std::string file_name = "BoxMetaDraco/glTF/BoxMetaDraco.gltf"; + constexpr bool kHasMeshFeatures = true; + constexpr bool kHasStructuralMetadata = false; + constexpr bool kHasDracoCompression = true; + + // Read test file from file. + const std::unique_ptr scene(DecodeTestGltfFileToScene(file_name)); + ASSERT_NE(scene, nullptr); + + // Encode the scene to glTF and decode it back to draco::Scene and check. + std::unique_ptr scene_from_gltf; + SceneToDecodedGltfScene(*scene, &scene_from_gltf); + ASSERT_NE(scene_from_gltf, nullptr); + GltfTestHelper::CheckBoxMetaMeshFeatures(*scene_from_gltf, + kHasDracoCompression); +} + +// Tests encoding of draco::Mesh to glTF with various mesh feature ID sets and +// structural metadata property table. +TEST_F(GltfEncoderTest, EncodeMeshWithMeshFeaturesWithStructuralMetadata) { + const std::string file_name = "BoxMeta/glTF/BoxMeta.gltf"; + constexpr bool kHasDracoCompression = false; + + // Read test file from file. + const std::unique_ptr mesh(ReadMeshFromTestFile(file_name)); + ASSERT_NE(mesh, nullptr); + + // Encode the scene to glTF and decode it back to draco::Mesh and check. + std::unique_ptr mesh_from_gltf; + MeshToDecodedGltfMesh(*mesh, &mesh_from_gltf); + ASSERT_NE(mesh_from_gltf, nullptr); + GltfTestHelper::CheckBoxMetaMeshFeatures(*mesh_from_gltf, + kHasDracoCompression); + GltfTestHelper::CheckBoxMetaStructuralMetadata(*mesh_from_gltf); +} + +// Tests encoding of draco::Mesh with Draco compression to glTF with various +// mesh feature ID sets. +TEST_F(GltfEncoderTest, EncodeMeshWithMeshFeaturesWithDracoCompression) { + constexpr bool kHasDracoCompression = true; + const std::string file_name = "BoxMetaDraco/glTF/BoxMetaDraco.gltf"; + + // Read test file from file. + const std::unique_ptr mesh(ReadMeshFromTestFile(file_name)); + ASSERT_NE(mesh, nullptr); + + // Encode the scene to glTF and decode it back to draco::Mesh and check. + std::unique_ptr mesh_from_gltf; + MeshToDecodedGltfMesh(*mesh, &mesh_from_gltf); + ASSERT_NE(mesh_from_gltf, nullptr); + GltfTestHelper::CheckBoxMetaMeshFeatures(*mesh_from_gltf, + kHasDracoCompression); +} + +// Tests encoding of draco::Mesh with mesh features associated with different +// mesh primitives. +TEST_F(GltfEncoderTest, EncodeMeshWithMeshFeaturesWithMultiplePrimitives) { + const std::string file_name = "BoxesMeta/glTF/BoxesMeta.gltf"; + + // Read test file from file. + const std::unique_ptr mesh(ReadMeshFromTestFile(file_name)); + ASSERT_NE(mesh, nullptr); + // All mesh features should share two textures. + ASSERT_EQ(mesh->GetNonMaterialTextureLibrary().NumTextures(), 2); + + // Encode the scene to glTF and decode it back to draco::Mesh and check. + std::unique_ptr mesh_from_gltf; + MeshToDecodedGltfMesh(*mesh, &mesh_from_gltf); + ASSERT_NE(mesh_from_gltf, nullptr); + + ASSERT_EQ(mesh_from_gltf->GetMaterialLibrary().NumMaterials(), 2); + ASSERT_EQ(mesh_from_gltf->NumMeshFeatures(), 5); + + // First two mesh features should be used by material 0 and the reamining by + // material 1. + for (draco::MeshFeaturesIndex mfi(0); mfi < 5; ++mfi) { + // Each mesh feature should be used by a single material. + ASSERT_EQ(mesh_from_gltf->NumMeshFeaturesMaterialMasks(mfi), 1); + if (mfi.value() < 2) { + ASSERT_EQ(mesh_from_gltf->GetMeshFeaturesMaterialMask(mfi, 0), 0); + } else { + ASSERT_EQ(mesh_from_gltf->GetMeshFeaturesMaterialMask(mfi, 0), 1); + } + } + // All mesh features should share two textures. + ASSERT_EQ(mesh_from_gltf->GetNonMaterialTextureLibrary().NumTextures(), 2); + + // Ensure it still works correctly when we re-encode the source |mesh| as a + // scene. + std::unique_ptr scene_from_gltf; + MeshToDecodedGltfScene(*mesh, &scene_from_gltf); + ASSERT_NE(scene_from_gltf, nullptr); + + ASSERT_EQ(scene_from_gltf->NumMeshes(), 2); + + // First mesh should have 2 mesh features and the other one 3 mesh features. + ASSERT_EQ(scene_from_gltf->GetMesh(draco::MeshIndex(0)).NumMeshFeatures(), 2); + ASSERT_EQ(scene_from_gltf->GetMesh(draco::MeshIndex(1)).NumMeshFeatures(), 3); + + // All mesh features should share two textures. + ASSERT_EQ(scene_from_gltf->GetNonMaterialTextureLibrary().NumTextures(), 2); +} + +// Tests encoding of draco::Mesh containing a point cloud and two materials. +TEST_F(GltfEncoderTest, EncodePointCloudWithMaterials) { + const std::string file_name = + "SphereTwoMaterials/sphere_two_materials_point_cloud.gltf"; + + // Read test file from file. + const std::unique_ptr mesh(ReadMeshFromTestFile(file_name)); + ASSERT_NE(mesh, nullptr); + + // Input should have no faces. + ASSERT_EQ(mesh->num_faces(), 0); + + // There should be two materials + ASSERT_EQ(mesh->GetMaterialLibrary().NumMaterials(), 2); + + // Encode the mesh to glTF and decode it back to draco::Mesh and check. + std::unique_ptr mesh_from_gltf; + MeshToDecodedGltfMesh(*mesh, &mesh_from_gltf); + ASSERT_NE(mesh_from_gltf, nullptr); + + ASSERT_EQ(mesh_from_gltf->num_faces(), 0); + ASSERT_EQ(mesh_from_gltf->GetMaterialLibrary().NumMaterials(), 2); +} + +} // namespace draco + +#endif // DRACO_TRANSCODER_SUPPORTED diff --git a/contrib/draco/src/draco/io/gltf_test_helper.cc b/contrib/draco/src/draco/io/gltf_test_helper.cc new file mode 100644 index 000000000..13cce6f4e --- /dev/null +++ b/contrib/draco/src/draco/io/gltf_test_helper.cc @@ -0,0 +1,823 @@ +// Copyright 2022 The Draco Authors. +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. +// +#include "draco/io/gltf_test_helper.h" + +#include +#include +#include +#include +#include + +#include "draco/core/draco_test_base.h" +#include "draco/core/draco_test_utils.h" +#include "draco/metadata/property_table.h" +#include "draco/texture/texture_library.h" + +namespace draco { + +#ifdef DRACO_TRANSCODER_SUPPORTED + +void GltfTestHelper::AddBoxMetaMeshFeatures(Scene *scene) { + // Check the scene. + ASSERT_NE(scene, nullptr); + ASSERT_EQ(scene->NumMeshes(), 1); + TextureLibrary &texture_library = scene->GetNonMaterialTextureLibrary(); + ASSERT_EQ(texture_library.NumTextures(), 0); + + // Check the mesh. + Mesh &mesh = scene->GetMesh(MeshIndex(0)); + ASSERT_EQ(mesh.num_faces(), 12); + ASSERT_EQ(mesh.num_attributes(), 2); + ASSERT_EQ(mesh.num_points(), 24); + + // Get mesh element counts. + const int num_faces = mesh.num_faces(); + const int num_corners = 3 * mesh.num_faces(); + const int num_vertices = + mesh.GetNamedAttribute(GeometryAttribute::POSITION)->size(); + + // Add feature ID set with per-face Uint8 attribute named _FEATURE_ID_0. + { + // Create feature ID attribute. + constexpr DataType kType = DataType::DT_UINT8; + std::unique_ptr pa(new PointAttribute()); + pa->Init(GeometryAttribute::GENERIC, 1, kType, false, mesh.num_faces()); + for (AttributeValueIndex avi(0); avi < num_faces; ++avi) { + const int8_t val = avi.value(); + pa->SetAttributeValue(avi, &val); + } + const int att_id = mesh.AddPerFaceAttribute(std::move(pa)); + std::unique_ptr metadata(new AttributeMetadata()); + metadata->AddEntryString("attribute_name", "_FEATURE_ID_0"); + mesh.AddAttributeMetadata(att_id, std::move(metadata)); + + // Add feature ID set to the mesh. + std::unique_ptr features(new MeshFeatures()); + features->SetLabel("faces"); + features->SetFeatureCount(num_faces); + features->SetNullFeatureId(100); + features->SetPropertyTableIndex(0); + features->SetAttributeIndex(0); + mesh.AddMeshFeatures(std::move(features)); + } + + // Add feature ID set with per-vertex Uint16 attribute named _FEATURE_ID_1. + { + // Create feature ID attribute. + constexpr DataType kType = DataType::DT_UINT16; + std::unique_ptr pa(new PointAttribute()); + pa->Init(GeometryAttribute::GENERIC, 1, kType, false, num_vertices); + for (AttributeValueIndex avi(0); avi < num_vertices; ++avi) { + const uint16_t val = avi.value(); + pa->SetAttributeValue(avi, &val); + } + const int att_id = mesh.AddPerVertexAttribute(std::move(pa)); + std::unique_ptr metadata(new AttributeMetadata()); + metadata->AddEntryString("attribute_name", "_FEATURE_ID_1"); + mesh.AddAttributeMetadata(att_id, std::move(metadata)); + + // Add feature ID set to the mesh. + std::unique_ptr features(new MeshFeatures()); + features->SetLabel("vertices"); + features->SetFeatureCount(num_vertices); + features->SetNullFeatureId(101); + features->SetPropertyTableIndex(1); + features->SetAttributeIndex(1); + mesh.AddMeshFeatures(std::move(features)); + } + + // Add feature ID set with per-corner Float attribute named _FEATURE_ID_2. + { + // Create feature ID attribute. + constexpr DataType kType = DataType::DT_FLOAT32; + std::unique_ptr pa(new PointAttribute()); + pa->Init(GeometryAttribute::GENERIC, 1, kType, false, num_corners); + IndexTypeVector corner_to_value( + num_corners); + for (AttributeValueIndex avi(0); avi < num_corners; ++avi) { + const float val = avi.value(); + pa->SetAttributeValue(avi, &val); + corner_to_value[CornerIndex(avi.value())] = avi; + } + const int att_id = + mesh.AddAttributeWithConnectivity(std::move(pa), corner_to_value); + std::unique_ptr metadata(new AttributeMetadata()); + metadata->AddEntryString("attribute_name", "_FEATURE_ID_2"); + mesh.AddAttributeMetadata(att_id, std::move(metadata)); + + // Add feature ID set to the mesh. + std::unique_ptr features(new MeshFeatures()); + features->SetFeatureCount(num_corners); + features->SetAttributeIndex(2); + mesh.AddMeshFeatures(std::move(features)); + } + + // Add feature ID set with the IDs stored in the R texture channel and + // accessible via the first texture coordinate attribute. + { + // Add the first texture coordinate attribute. + constexpr DataType kType = DataType::DT_FLOAT32; + std::unique_ptr pa(new PointAttribute()); + pa->Init(GeometryAttribute::TEX_COORD, 2, kType, false, num_vertices); + std::vector> uv = { + {0.0000f, 0.0000f}, {0.0000f, 0.5000f}, {0.0000f, 1.0000f}, + {0.5000f, 0.0000f}, {0.5000f, 0.5000f}, {0.5000f, 1.0000f}, + {1.0000f, 0.0000f}, {1.0000f, 0.5000f}}; + for (AttributeValueIndex avi(0); avi < num_vertices; ++avi) { + const int index = avi.value(); + pa->SetAttributeValue(avi, uv[index].data()); + } + mesh.AddPerVertexAttribute(std::move(pa)); + } + + // Add feature ID set with the IDs stored in the GBA texture channels and + // accessible via the second texture coordinate attribute. + { + // Add the second texture coordinate attribute. + constexpr DataType kType = DataType::DT_FLOAT32; + std::unique_ptr pa(new PointAttribute()); + pa->Init(GeometryAttribute::TEX_COORD, 2, kType, false, num_vertices); + std::vector> uv = { + {0.0000f, 0.0000f}, {0.0000f, 0.5000f}, {0.0000f, 1.0000f}, + {0.5000f, 0.0000f}, {0.5000f, 0.5000f}, {0.5000f, 1.0000f}, + {1.0000f, 0.0000f}, {1.0000f, 0.5000f}}; + for (AttributeValueIndex avi(0); avi < num_vertices; ++avi) { + const int index = avi.value(); + pa->SetAttributeValue(avi, uv[index].data()); + } + mesh.AddPerVertexAttribute(std::move(pa)); + ASSERT_EQ(mesh.NumNamedAttributes(GeometryAttribute::TEX_COORD), 2); + } +} + +void GltfTestHelper::AddBoxMetaStructuralMetadata(Scene *scene) { + // Add structural metadata property table schema in the following JSON: + // "schema": { + // "id": "galaxy", + // "classes": { + // "planet": { + // "properties": { + // "color": { + // "componentType": "UINT8", + // "description": "The RGB color.", + // "required": true, + // "type": "VEC3" + // }, + // "name": { + // "description": "The name.", + // "required": true, + // "type": "STRING" + // } + // "sequence": { + // "description": "The number sequence.", + // "required": false, + // "type": "SCALAR" + // } + // } + // } + // }, + // "enums": { + // "classifications": { + // "description": "Classifications of planets.", + // "name": "classifications", + // "values": [ + // { "name": "Unspecified", "value": 0 }, + // { "name": "Gas Giant", "value": 1 }, + // { "name": "Waterworld", "value": 2 }, + // { "name": "Agriworld", "value": 3 }, + // { "name": "Ordnance", "value": 4 } + // ] + // } + // } + // } + typedef PropertyTable::Schema::Object Object; + PropertyTable::Schema schema; + Object &json = schema.json; + json.SetObjects().emplace_back("id", "galaxy"); + json.SetObjects().emplace_back("classes"); + json.SetObjects().back().SetObjects().emplace_back("planet"); + Object &planet = json.SetObjects().back().SetObjects().back(); + planet.SetObjects().emplace_back("properties"); + Object &properties = planet.SetObjects().back(); + + properties.SetObjects().emplace_back("color"); + Object &color = properties.SetObjects().back(); + color.SetObjects().emplace_back("componentType", "UINT8"); + color.SetObjects().emplace_back("description", "The RGB color."); + color.SetObjects().emplace_back("required", true); + color.SetObjects().emplace_back("type", "VEC3"); + + properties.SetObjects().emplace_back("name"); + Object &name = properties.SetObjects().back(); + name.SetObjects().emplace_back("description", "The name."); + name.SetObjects().emplace_back("required", true); + name.SetObjects().emplace_back("type", "STRING"); + + properties.SetObjects().emplace_back("sequence"); + Object &sequence = properties.SetObjects().back(); + sequence.SetObjects().emplace_back("description", "The number sequence."); + sequence.SetObjects().emplace_back("required", false); + sequence.SetObjects().emplace_back("type", "SCALAR"); + + json.SetObjects().emplace_back("enums"); + json.SetObjects().back().SetObjects().emplace_back("classifications"); + Object &classifications = json.SetObjects().back().SetObjects().back(); + classifications.SetObjects().emplace_back("description", + "Classifications of planets."); + classifications.SetObjects().emplace_back("name", "classifications"); + classifications.SetObjects().emplace_back("values"); + Object &values = classifications.SetObjects().back(); + + values.SetArray().emplace_back(); + values.SetArray().back().SetObjects().emplace_back("name", "Unspecified"); + values.SetArray().back().SetObjects().emplace_back("value", 0); + + values.SetArray().emplace_back(); + values.SetArray().back().SetObjects().emplace_back("name", "Gas Giant"); + values.SetArray().back().SetObjects().emplace_back("value", 1); + + values.SetArray().emplace_back(); + values.SetArray().back().SetObjects().emplace_back("name", "Waterworld"); + values.SetArray().back().SetObjects().emplace_back("value", 2); + + values.SetArray().emplace_back(); + values.SetArray().back().SetObjects().emplace_back("name", "Agriworld"); + values.SetArray().back().SetObjects().emplace_back("value", 3); + + values.SetArray().emplace_back(); + values.SetArray().back().SetObjects().emplace_back("name", "Ordnance"); + values.SetArray().back().SetObjects().emplace_back("value", 4); + + // Add property table schema to the scene. + scene->GetStructuralMetadata().SetPropertyTableSchema(schema); + + // Add structural metadata property table. + std::unique_ptr table(new PropertyTable()); + table->SetName("Galaxy far far away."); + table->SetClass("planet"); + table->SetCount(16); + + // Add property describing RGB color components of the planet class. + { + std::unique_ptr property( + new PropertyTable::Property()); + property->SetName("color"); + property->GetData().target = 34962; // ARRAY_BUFFER. + property->GetData().data = {94, 94, 194, // Tatooine + 94, 145, 161, // Corusant + 118, 171, 91, // Naboo + 103, 139, 178, // Alderaan + 83, 98, 154, // Dagobah + 91, 177, 175, // Mandalore + 190, 92, 108, // Corellia + 72, 69, 169, // Kamino + 154, 90, 101, // Kashyyyk + 174, 85, 175, // Dantooine + 184, 129, 96, // Hoth + 185, 91, 180, // Mustafar + 194, 150, 83, // Bespin + 204, 111, 134, // Yavin + 182, 90, 89, // Geonosis + 0, 0, 0}; // UNLABELED + table->AddProperty(std::move(property)); + } + + // Add property that describes names of the planet class. + { + std::unique_ptr property( + new PropertyTable::Property()); + property->SetName("name"); + property->GetData().target = 34963; // ELEMENT_ARRAY_BUFFER. + const std::string data = + "named_class:Tatooine" + "named_class:Corusant" + "named_class:Naboo" + "named_class:Alderaan" + "named_class:Dagobah" + "named_class:Mandalore" + "named_class:Corellia" + "named_class:Kamino" + "named_class:Kashyyyk" + "named_class:Dantooine" + "named_class:Hoth" + "named_class:Mustafar" + "named_class:Bespin" + "named_class:Yavin" + "named_class:Geonosis" + "UNLABELED"; + property->GetData().data.assign(data.begin(), data.end()); + property->GetStringOffsets().type = "UINT32"; + property->GetStringOffsets().data.target = 34963; // ELEMENT_ARRAY_BUFFER. + property->GetStringOffsets().data.data = {0, 0, 0, 0, // Tatooine + 20, 0, 0, 0, // Corusant + 40, 0, 0, 0, // Naboo + 57, 0, 0, 0, // Alderaan + 77, 0, 0, 0, // Dagobah + 96, 0, 0, 0, // Mandalore + 117, 0, 0, 0, // Corellia + 137, 0, 0, 0, // Kamino + 155, 0, 0, 0, // Kashyyyk + 175, 0, 0, 0, // Dantooine + 196, 0, 0, 0, // Hoth + 212, 0, 0, 0, // Mustafar + 232, 0, 0, 0, // Bespin + 250, 0, 0, 0, // Yavin + 12, 1, 0, 0, // Geonosis + 32, 1, 0, 0, // UNLABELED + 41, 1, 0, 0}; + table->AddProperty(std::move(property)); + } + + // Add property that contains variable-length number sequence of the planet + // class. + { + std::unique_ptr property( + new PropertyTable::Property()); + property->SetName("sequence"); + property->GetData().target = 34963; // ELEMENT_ARRAY_BUFFER. + const std::vector data = { + 0.5f, 1.5f, 2.5f, 3.5f, 4.5f, 5.5f, // Tatooine + 6.5f, 7.5f, // Corusant + 8.5f, // Naboo + 9.5f, // Alderaan + 10.5f, 11.5f, // Dagobah + 12.5f, 13.5f, 14.5f, 15.5f, // Mandalore + 16.5f, 17.5f, // Corellia + 18.5f, 19.5f, // Kamino + 20.5f, 21.5f, 22.5f, // Kashyyyk + 23.5f, 24.5f, 25.5f, // Dantooine + 26.5f, 27.5f, // Hoth + 28.5f, 29.5f, // Mustafar + 30.5f, 31.5f, 32.5f, // Bespin + 33.5f, 34.5f, 35.5f, // Yavin + 36.5f, 37.5f, 38.5f, 39.5f, 40.5f // Geonosis + }; // UNLABELED (empty array). + property->GetData().data.resize(4 * data.size()); + memcpy(property->GetData().data.data(), data.data(), 4 * data.size()); + property->GetArrayOffsets().type = "UINT8"; + property->GetArrayOffsets().data.target = 34963; // ELEMENT_ARRAY_BUFFER. + property->GetArrayOffsets().data.data = { + 0 * 4, // Tatooine + 6 * 4, // Corusant + 8 * 4, // Naboo + 9 * 4, // Alderaan + 10 * 4, // Dagobah + 12 * 4, // Mandalore + 16 * 4, // Corellia + 18 * 4, // Kamino + 20 * 4, // Kashyyyk + 23 * 4, // Dantooine + 26 * 4, // Hoth + 28 * 4, // Mustafar + 30 * 4, // Bespin + 33 * 4, // Yavin + 36 * 4, // Geonosis + 41 * 4, // UNLABELED (empty array). + 41 * 4}; + table->AddProperty(std::move(property)); + } + + // Add property table to the scene. + scene->GetStructuralMetadata().AddPropertyTable(std::move(table)); +} + +template <> +void GltfTestHelper::CheckBoxMetaMeshFeatures(const Mesh &geometry, + bool has_draco_compression) { + CheckBoxMetaMeshFeatures(geometry, geometry.GetNonMaterialTextureLibrary(), + has_draco_compression); +} + +template <> +void GltfTestHelper::CheckBoxMetaMeshFeatures(const Scene &geometry, + bool has_draco_compression) { + ASSERT_EQ(geometry.NumMeshes(), 1); + CheckBoxMetaMeshFeatures(geometry.GetMesh(MeshIndex(0)), + geometry.GetNonMaterialTextureLibrary(), + has_draco_compression); +} + +void GltfTestHelper::CheckBoxMetaMeshFeatures(const Mesh &mesh, + const TextureLibrary &texture_lib, + bool has_draco_compression) { + // Check texture library. + ASSERT_EQ(texture_lib.NumTextures(), 2); + + // Check basic mesh properties. + ASSERT_EQ(mesh.NumMeshFeatures(), 5); + ASSERT_EQ(mesh.num_faces(), 12); + ASSERT_EQ(mesh.num_attributes(), 7); + ASSERT_EQ(mesh.num_points(), 36); + ASSERT_EQ(mesh.NumNamedAttributes(GeometryAttribute::GENERIC), 3); + ASSERT_EQ(mesh.NumNamedAttributes(GeometryAttribute::TEX_COORD), 2); + + // Get mesh element counts. + const int num_faces = mesh.num_faces(); + const int num_corners = 3 * mesh.num_faces(); + const int num_vertices = + mesh.GetNamedAttribute(GeometryAttribute::POSITION)->size(); + + // Check mesh feature ID set at index 0. + { + // Check mesh features. + const MeshFeatures &features = mesh.GetMeshFeatures(MeshFeaturesIndex(0)); + ASSERT_EQ(features.GetLabel(), "faces"); + ASSERT_EQ(features.GetFeatureCount(), num_faces); + ASSERT_EQ(features.GetNullFeatureId(), 100); + ASSERT_EQ(features.GetPropertyTableIndex(), 0); + ASSERT_EQ(features.GetAttributeIndex(), 0); + ASSERT_TRUE(features.GetTextureChannels().empty()); + ASSERT_EQ(features.GetTextureMap().texture(), nullptr); + ASSERT_EQ(features.GetTextureMap().tex_coord_index(), -1); + + // Check per-face Uint8 attribute named _FEATURE_ID_0. + const int att_id = + mesh.GetAttributeIdByMetadataEntry("attribute_name", "_FEATURE_ID_0"); + auto att = mesh.GetAttributeByUniqueId(att_id); + ASSERT_NE(att, nullptr); + ASSERT_EQ(att->attribute_type(), GeometryAttribute::GENERIC); + ASSERT_EQ(att->data_type(), DataType::DT_UINT8); + ASSERT_EQ(att->num_components(), 1); + ASSERT_EQ(att->size(), num_faces); + ASSERT_EQ(att->indices_map_size(), num_corners); + + // Check that the values are all the numbers from 0 to 12. + const std::vector expected_values = + has_draco_compression + ? std::vector{7, 11, 10, 3, 2, 5, 4, 1, 6, 9, 8, 0} + : std::vector{0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11}; + for (int i = 0; i < num_faces; i++) { + uint8_t val; + att->GetValue(AttributeValueIndex(i), &val); + ASSERT_EQ(val, expected_values[i]); + } + + // Check that the corners of each face have a common value. + for (int i = 0; i < num_faces; i++) { + const auto face = mesh.face(FaceIndex(i)); + ASSERT_EQ(*att->GetAddressOfMappedIndex(face[0]), + *att->GetAddressOfMappedIndex(face[1])); + ASSERT_EQ(*att->GetAddressOfMappedIndex(face[0]), + *att->GetAddressOfMappedIndex(face[2])); + } + } + + // Check the 2nd mesh feature ID set at index 1. + { + // Check mesh features. + const MeshFeatures &features = mesh.GetMeshFeatures(MeshFeaturesIndex(1)); + ASSERT_EQ(features.GetLabel(), "vertices"); + ASSERT_EQ(features.GetFeatureCount(), num_vertices); + ASSERT_EQ(features.GetNullFeatureId(), 101); + ASSERT_EQ(features.GetPropertyTableIndex(), 1); + ASSERT_EQ(features.GetAttributeIndex(), 1); + ASSERT_TRUE(features.GetTextureChannels().empty()); + ASSERT_EQ(features.GetTextureMap().texture(), nullptr); + ASSERT_EQ(features.GetTextureMap().tex_coord_index(), -1); + + // Check per-vertex Uint16 attribute named _FEATURE_ID_1. + const int att_id = + mesh.GetAttributeIdByMetadataEntry("attribute_name", "_FEATURE_ID_1"); + auto att = mesh.GetAttributeByUniqueId(att_id); + ASSERT_NE(att, nullptr); + ASSERT_EQ(att->attribute_type(), GeometryAttribute::GENERIC); + ASSERT_EQ(att->data_type(), DataType::DT_UINT16); + ASSERT_EQ(att->num_components(), 1); + ASSERT_EQ(att->size(), num_vertices); + ASSERT_EQ(att->indices_map_size(), num_corners); + + // Check that the values are all the numbers from 0 to 7. + const std::vector expected_values = + has_draco_compression ? std::vector{3, 6, 7, 4, 5, 0, 1, 2} + : std::vector{0, 1, 2, 3, 4, 5, 6, 7}; + for (int i = 0; i < num_vertices; i++) { + uint16_t val; + att->GetValue(AttributeValueIndex(i), &val); + ASSERT_EQ(val, expected_values[i]); + } + + // Check that the corners of a face have unique values. + for (int i = 0; i < num_faces; i++) { + const auto face = mesh.face(FaceIndex(i)); + ASSERT_NE(*att->GetAddressOfMappedIndex(face[0]), + *att->GetAddressOfMappedIndex(face[1])); + ASSERT_NE(*att->GetAddressOfMappedIndex(face[1]), + *att->GetAddressOfMappedIndex(face[2])); + ASSERT_NE(*att->GetAddressOfMappedIndex(face[2]), + *att->GetAddressOfMappedIndex(face[0])); + } + } + + // Check the 3rd mesh feature ID set at index 2. + { + // Check mesh features. + const MeshFeatures &features = mesh.GetMeshFeatures(MeshFeaturesIndex(2)); + ASSERT_TRUE(features.GetLabel().empty()); + ASSERT_EQ(features.GetFeatureCount(), num_corners); + ASSERT_EQ(features.GetNullFeatureId(), -1); + ASSERT_EQ(features.GetPropertyTableIndex(), -1); + ASSERT_EQ(features.GetAttributeIndex(), 2); + ASSERT_TRUE(features.GetTextureChannels().empty()); + ASSERT_EQ(features.GetTextureMap().texture(), nullptr); + ASSERT_EQ(features.GetTextureMap().tex_coord_index(), -1); + + // Check per-corner Float attribute named _FEATURE_ID_2. + const int att_id = + mesh.GetAttributeIdByMetadataEntry("attribute_name", "_FEATURE_ID_2"); + auto att = mesh.GetAttributeByUniqueId(att_id); + ASSERT_NE(att, nullptr); + ASSERT_EQ(att->attribute_type(), GeometryAttribute::GENERIC); + ASSERT_EQ(att->data_type(), DataType::DT_FLOAT32); + ASSERT_EQ(att->num_components(), 1); + ASSERT_EQ(att->size(), num_corners); + ASSERT_EQ(att->indices_map_size(), 0); + ASSERT_TRUE(att->is_mapping_identity()); + + // Check that the values are from 0 to 35. + const std::vector expected_values = + has_draco_compression + ? std::vector{23, 21, 22, 33, 34, 35, 31, 32, 30, 9, 10, 11, + 7, 8, 6, 15, 16, 17, 14, 12, 13, 5, 3, 4, + 19, 20, 18, 27, 28, 29, 26, 24, 25, 1, 2, 0} + : std::vector{0, 1, 2, 3, 4, 5, 6, 7, 8, + 9, 10, 11, 12, 13, 14, 15, 16, 17, + 18, 19, 20, 21, 22, 23, 24, 25, 26, + 27, 28, 29, 30, 31, 32, 33, 34, 35}; + for (int i = 0; i < num_corners; i++) { + float val; + att->GetValue(AttributeValueIndex(i), &val); + ASSERT_EQ(val, expected_values[i]); + } + + // Check that the corners have unique values. + for (int i = 0; i < num_faces; i++) { + const auto face = mesh.face(FaceIndex(i)); + float v0, v1, v2; + att->GetMappedValue(face[0], &v0); + att->GetMappedValue(face[1], &v1); + att->GetMappedValue(face[2], &v2); + ASSERT_EQ(v0, expected_values[3 * i + 0]); + ASSERT_EQ(v1, expected_values[3 * i + 1]); + ASSERT_EQ(v2, expected_values[3 * i + 2]); + } + } + + // Check mesh feature ID set at index 3. + { + // Check mesh features. + const MeshFeatures &features = mesh.GetMeshFeatures(MeshFeaturesIndex(3)); + ASSERT_TRUE(features.GetLabel().empty()); + ASSERT_EQ(features.GetFeatureCount(), 6); + ASSERT_EQ(features.GetNullFeatureId(), -1); + ASSERT_EQ(features.GetPropertyTableIndex(), -1); + ASSERT_EQ(features.GetAttributeIndex(), -1); + } + + // Check mesh feature ID set at index 4. + { + // Check mesh features. + const MeshFeatures &features = mesh.GetMeshFeatures(MeshFeaturesIndex(4)); + ASSERT_EQ(features.GetLabel(), "water"); + ASSERT_EQ(features.GetFeatureCount(), 2); + ASSERT_EQ(features.GetNullFeatureId(), -1); + ASSERT_EQ(features.GetPropertyTableIndex(), -1); + ASSERT_EQ(features.GetAttributeIndex(), -1); + } +} + +void GltfTestHelper::CheckBoxMetaStructuralMetadata( + const StructuralMetadata &structural_metadata) { + // Check property table schema. + { + const PropertyTable::Schema &schema = + structural_metadata.GetPropertyTableSchema(); + ASSERT_FALSE(schema.Empty()); + const PropertyTable::Schema::Object &json = schema.json; + ASSERT_EQ(json.GetObjects().size(), 3); + ASSERT_EQ(json.GetObjects()[0].GetName(), "classes"); + ASSERT_EQ(json.GetObjects()[0].GetObjects().size(), 1); + ASSERT_EQ(json.GetObjects()[0].GetObjects()[0].GetName(), "planet"); + ASSERT_EQ(json.GetObjects()[0].GetObjects()[0].GetObjects().size(), 1); + + const auto &properties = + json.GetObjects()[0].GetObjects()[0].GetObjects()[0]; + ASSERT_EQ(properties.GetName(), "properties"); + ASSERT_EQ(properties.GetObjects().size(), 3); + + const auto &color = properties.GetObjects()[0]; + ASSERT_EQ(color.GetName(), "color"); + ASSERT_EQ(color.GetObjects().size(), 4); + ASSERT_EQ(color.GetObjects()[0].GetName(), "componentType"); + ASSERT_EQ(color.GetObjects()[1].GetName(), "description"); + ASSERT_EQ(color.GetObjects()[2].GetName(), "required"); + ASSERT_EQ(color.GetObjects()[3].GetName(), "type"); + ASSERT_EQ(color.GetObjects()[0].GetString(), "UINT8"); + ASSERT_EQ(color.GetObjects()[1].GetString(), "The RGB color."); + ASSERT_TRUE(color.GetObjects()[2].GetBoolean()); + ASSERT_EQ(color.GetObjects()[3].GetString(), "VEC3"); + + const auto &name = properties.GetObjects()[1]; + ASSERT_EQ(name.GetName(), "name"); + ASSERT_EQ(name.GetObjects().size(), 3); + ASSERT_EQ(name.GetObjects()[0].GetName(), "description"); + ASSERT_EQ(name.GetObjects()[1].GetName(), "required"); + ASSERT_EQ(name.GetObjects()[2].GetName(), "type"); + ASSERT_EQ(name.GetObjects()[0].GetString(), "The name."); + ASSERT_TRUE(name.GetObjects()[1].GetBoolean()); + ASSERT_EQ(name.GetObjects()[2].GetString(), "STRING"); + + const auto &sequence = properties.GetObjects()[2]; + ASSERT_EQ(sequence.GetName(), "sequence"); + ASSERT_EQ(sequence.GetObjects().size(), 3); + ASSERT_EQ(sequence.GetObjects()[0].GetName(), "description"); + ASSERT_EQ(sequence.GetObjects()[1].GetName(), "required"); + ASSERT_EQ(sequence.GetObjects()[2].GetName(), "type"); + ASSERT_EQ(sequence.GetObjects()[0].GetString(), "The number sequence."); + ASSERT_FALSE(sequence.GetObjects()[1].GetBoolean()); + ASSERT_EQ(sequence.GetObjects()[2].GetString(), "SCALAR"); + + ASSERT_EQ(json.GetObjects()[1].GetName(), "enums"); + const auto &classifications = json.GetObjects()[1].GetObjects()[0]; + ASSERT_EQ(classifications.GetName(), "classifications"); + ASSERT_EQ(classifications.GetObjects()[0].GetName(), "description"); + ASSERT_EQ(classifications.GetObjects()[0].GetString(), + "Classifications of planets."); + ASSERT_EQ(classifications.GetObjects()[1].GetName(), "name"); + ASSERT_EQ(classifications.GetObjects()[1].GetString(), "classifications"); + ASSERT_EQ(classifications.GetObjects()[2].GetName(), "values"); + const auto &values = classifications.GetObjects()[2]; + ASSERT_EQ(values.GetArray()[0].GetObjects()[0].GetName(), "name"); + ASSERT_EQ(values.GetArray()[1].GetObjects()[0].GetName(), "name"); + ASSERT_EQ(values.GetArray()[2].GetObjects()[0].GetName(), "name"); + ASSERT_EQ(values.GetArray()[3].GetObjects()[0].GetName(), "name"); + ASSERT_EQ(values.GetArray()[4].GetObjects()[0].GetName(), "name"); + ASSERT_EQ(values.GetArray()[0].GetObjects()[0].GetString(), "Unspecified"); + ASSERT_EQ(values.GetArray()[1].GetObjects()[0].GetString(), "Gas Giant"); + ASSERT_EQ(values.GetArray()[2].GetObjects()[0].GetString(), "Waterworld"); + ASSERT_EQ(values.GetArray()[3].GetObjects()[0].GetString(), "Agriworld"); + ASSERT_EQ(values.GetArray()[4].GetObjects()[0].GetString(), "Ordnance"); + ASSERT_EQ(values.GetArray()[0].GetObjects()[1].GetName(), "value"); + ASSERT_EQ(values.GetArray()[1].GetObjects()[1].GetName(), "value"); + ASSERT_EQ(values.GetArray()[2].GetObjects()[1].GetName(), "value"); + ASSERT_EQ(values.GetArray()[3].GetObjects()[1].GetName(), "value"); + ASSERT_EQ(values.GetArray()[4].GetObjects()[1].GetName(), "value"); + ASSERT_EQ(values.GetArray()[0].GetObjects()[1].GetInteger(), 0); + ASSERT_EQ(values.GetArray()[1].GetObjects()[1].GetInteger(), 1); + ASSERT_EQ(values.GetArray()[2].GetObjects()[1].GetInteger(), 2); + ASSERT_EQ(values.GetArray()[3].GetObjects()[1].GetInteger(), 3); + ASSERT_EQ(values.GetArray()[4].GetObjects()[1].GetInteger(), 4); + + ASSERT_EQ(json.GetObjects()[2].GetName(), "id"); + ASSERT_EQ(json.GetObjects()[2].GetString(), "galaxy"); + } + + // Check property table. + constexpr int kRows = 16; + ASSERT_EQ(structural_metadata.NumPropertyTables(), 1); + const PropertyTable &table = structural_metadata.GetPropertyTable(0); + ASSERT_EQ(table.GetName(), "Galaxy far far away."); + ASSERT_EQ(table.GetClass(), "planet"); + ASSERT_EQ(table.GetCount(), kRows); + ASSERT_EQ(table.NumProperties(), 3); + + // Check property that describes RGB color components of the planet class. + { + const PropertyTable::Property &property = table.GetProperty(0); + ASSERT_EQ(property.GetName(), "color"); + + ASSERT_EQ(property.GetData().data.size(), kRows * 3); // RGB components. + ASSERT_EQ(property.GetData().target, 34962); // ARRAY_BUFFER. + + ASSERT_EQ(property.GetData().data[0], 94); // Tatooine [94, 94, 194]. + ASSERT_EQ(property.GetData().data[1], 94); + ASSERT_EQ(property.GetData().data[2], 194); + ASSERT_EQ(property.GetData().data[18], 190); // Corellia [190, 92, 108]. + ASSERT_EQ(property.GetData().data[19], 92); + ASSERT_EQ(property.GetData().data[20], 108); + ASSERT_EQ(property.GetData().data[45], 0); // UNLABELED [0, 0, 0]. + ASSERT_EQ(property.GetData().data[46], 0); + ASSERT_EQ(property.GetData().data[47], 0); + + ASSERT_TRUE(property.GetArrayOffsets().type.empty()); + ASSERT_TRUE(property.GetArrayOffsets().data.data.empty()); + ASSERT_EQ(property.GetArrayOffsets().data.target, 0); + ASSERT_TRUE(property.GetStringOffsets().type.empty()); + ASSERT_TRUE(property.GetStringOffsets().data.data.empty()); + ASSERT_EQ(property.GetStringOffsets().data.target, 0); + } + + // Check property that describes names of the planet class. + { + const PropertyTable::Property &property = table.GetProperty(1); + ASSERT_EQ(property.GetName(), "name"); + const std::vector &data = property.GetData().data; + const std::vector &offsets = property.GetStringOffsets().data.data; + + ASSERT_EQ(data.size(), 296); // Concatenated label strings. + ASSERT_EQ(property.GetData().target, 34963); // ELEMENT_ARRAY_BUFFER. + + ASSERT_EQ(property.GetStringOffsets().type, "UINT32"); + ASSERT_EQ(offsets.size(), 4 * (kRows + 1)); + ASSERT_EQ(property.GetStringOffsets().data.target, 34963); + + ASSERT_EQ(offsets[0], 0); // Tatooine 0. + ASSERT_EQ(offsets[1], 0); + ASSERT_EQ(offsets[2], 0); + ASSERT_EQ(offsets[3], 0); + ASSERT_EQ(offsets[60], 32); // UNLABELED 287. + ASSERT_EQ(offsets[61], 1); + ASSERT_EQ(offsets[62], 0); + ASSERT_EQ(offsets[63], 0); + ASSERT_EQ(offsets[64], 41); // Beyond UNLABELED 296. + ASSERT_EQ(offsets[65], 1); + ASSERT_EQ(offsets[66], 0); + ASSERT_EQ(offsets[67], 0); + + struct Name { + static std::string Extract(const std::vector &data, + const std::vector &offsets, int row) { + const int b = offsets[4 * (row + 0)] + 255 * offsets[4 * (row + 0) + 1]; + const int e = offsets[4 * (row + 1)] + 255 * offsets[4 * (row + 1) + 1]; + return std::string(data.begin() + b, data.begin() + e); + } + }; + + // Check that the names can be extracted from the data. + ASSERT_EQ(Name::Extract(data, offsets, 0), "named_class:Tatooine"); + ASSERT_EQ(Name::Extract(data, offsets, 6), "named_class:Corellia"); + ASSERT_EQ(Name::Extract(data, offsets, 15), "UNLABELED"); + + ASSERT_TRUE(property.GetArrayOffsets().type.empty()); + ASSERT_TRUE(property.GetArrayOffsets().data.data.empty()); + ASSERT_EQ(property.GetArrayOffsets().data.target, 0); + } + + // Check property that describes number sequence of the planet class. + { + const PropertyTable::Property &property = table.GetProperty(2); + ASSERT_EQ(property.GetName(), "sequence"); + const std::vector &data = property.GetData().data; + const std::vector &offsets = property.GetArrayOffsets().data.data; + + ASSERT_EQ(data.size(), 41 * 4); // Concatenated float arrays. + ASSERT_EQ(property.GetData().target, 34963); // ELEMENT_ARRAY_BUFFER. + + ASSERT_EQ(property.GetArrayOffsets().type, "UINT8"); + ASSERT_EQ(offsets.size(), 20); // kRows + 1 + padding. + ASSERT_EQ(property.GetArrayOffsets().data.target, 34963); + + ASSERT_EQ(offsets[0], 0 * 4); // Tatooine + ASSERT_EQ(offsets[1], 6 * 4); // Corusant + ASSERT_EQ(offsets[6], 16 * 4); // Corellia + ASSERT_EQ(offsets[14], 36 * 4); // Geonosis + ASSERT_EQ(offsets[15], 41 * 4); // UNLABELED (empty array). + ASSERT_EQ(offsets[16], 41 * 4); // Beyond UNLABELED (empty array). + + struct Sequence { + static std::vector Extract(const std::vector &data, + const std::vector &offsets, + int row) { + const int n = (offsets[row + 1] - offsets[row]) / 4; + std::vector result; + result.reserve(n); + for (int i = 0; i < n; ++i) { + const void *const pointer = &data[offsets[row] + 4 * i]; + result.push_back(*static_cast(pointer)); + } + return result; + } + }; + + // Check that the number sequence arrays can be extracted from the data. + ASSERT_EQ( + Sequence::Extract(data, offsets, 0), + (std::vector{0.5f, 1.5f, 2.5f, 3.5f, 4.5f, 5.5f})); // Tatooine + ASSERT_EQ(Sequence::Extract(data, offsets, 1), + (std::vector{6.5f, 7.5f})); // Corusant + ASSERT_EQ( + Sequence::Extract(data, offsets, 14), + (std::vector{36.5f, 37.5f, 38.5f, 39.5f, 40.5f})); // Geonosis + ASSERT_TRUE(Sequence::Extract(data, offsets, 15) + .empty()); // UNLABELED (empty array). + + ASSERT_TRUE(property.GetStringOffsets().type.empty()); + ASSERT_TRUE(property.GetStringOffsets().data.data.empty()); + ASSERT_EQ(property.GetStringOffsets().data.target, 0); + } +} + +#endif // DRACO_TRANSCODER_SUPPORTED + +} // namespace draco diff --git a/contrib/draco/src/draco/io/gltf_test_helper.h b/contrib/draco/src/draco/io/gltf_test_helper.h new file mode 100644 index 000000000..91aec9b08 --- /dev/null +++ b/contrib/draco/src/draco/io/gltf_test_helper.h @@ -0,0 +1,61 @@ +// Copyright 2022 The Draco Authors. +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. +// +#ifndef DRACO_IO_GLTF_DECODER_TEST_HELPER_H_ +#define DRACO_IO_GLTF_DECODER_TEST_HELPER_H_ + +#include "draco/draco_features.h" + +#ifdef DRACO_TRANSCODER_SUPPORTED +#include "draco/scene/scene.h" + +namespace draco { + +// Helper class for testing Draco glTF encoder and decoder. +class GltfTestHelper { + public: + // Adds various mesh feature ID sets (via attributes and via textures) and + // structural metadata property table and property table schema to the box + // |scene| loaded from the test file testdata/Box/glTF/Box.gltf. + static void AddBoxMetaMeshFeatures(Scene *scene); + static void AddBoxMetaStructuralMetadata(Scene *scene); + + // Checks the box |geometry| (draco::Mesh or draco::Scene) with mesh features + // loaded from one of these test files, with or without Draco compression: + // 1. testdata/BoxMeta/glTF/BoxMeta.gltf + // 2. testdata/BoxMetaDraco/glTF/BoxMetaDraco.gltf + template + static void CheckBoxMetaMeshFeatures(const GeometryT &geometry, + bool has_draco_compression); + + // Checks the box |geometry| (draco::Mesh or draco::Scene) with structural + // metadata that includes property table and property table schema loaded from + // test file testdata/BoxMeta/glTF/BoxMeta.gltf. + template + static void CheckBoxMetaStructuralMetadata(const GeometryT &geometry) { + CheckBoxMetaStructuralMetadata(geometry.GetStructuralMetadata()); + } + + private: + static void CheckBoxMetaMeshFeatures(const Mesh &mesh, + const TextureLibrary &texture_lib, + bool has_draco_compression); + static void CheckBoxMetaStructuralMetadata( + const StructuralMetadata &structural_metadata); +}; + +} // namespace draco + +#endif // DRACO_TRANSCODER_SUPPORTED +#endif // DRACO_IO_GLTF_DECODER_TEST_HELPER_H_ diff --git a/contrib/draco/src/draco/io/gltf_utils.cc b/contrib/draco/src/draco/io/gltf_utils.cc new file mode 100644 index 000000000..bf5c048ef --- /dev/null +++ b/contrib/draco/src/draco/io/gltf_utils.cc @@ -0,0 +1,154 @@ +// Copyright 2018 The Draco Authors. +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. +// +#include "draco/io/gltf_utils.h" + +#include +#include + +#ifdef DRACO_TRANSCODER_SUPPORTED +namespace draco { + +std::ostream &operator<<(std::ostream &os, const GltfValue &value) { + if (value.type_ == GltfValue::INT) { + os << value.value_int_; + } else { + os << value.value_double_; + } + return os; +} + +Indent::Indent() : indent_space_count_(2) {} + +void Indent::Increase() { indent_ += std::string(indent_space_count_, ' '); } + +void Indent::Decrease() { indent_.erase(0, indent_space_count_); } + +std::ostream &operator<<(std::ostream &os, const Indent &indent) { + return os << indent.indent_; +} + +std::ostream &operator<<(std::ostream &os, + const JsonWriter::IndentWrapper &indent) { + if (indent.writer.mode_ == JsonWriter::READABLE) { + os << indent.writer.indent_writer_; + } + return os; +} + +std::ostream &operator<<(std::ostream &os, + const JsonWriter::Separator &separator) { + if (separator.writer.mode_ == JsonWriter::READABLE) { + os << " "; + } + return os; +} + +void JsonWriter::Reset() { + last_type_ = START; + o_.clear(); + o_.str(""); +} + +void JsonWriter::BeginObject() { BeginObject(""); } + +void JsonWriter::BeginObject(const std::string &name) { + FinishPreviousLine(BEGIN); + o_ << indent_; + if (!name.empty()) { + o_ << "\"" << name << "\":" << separator_; + } + o_ << "{"; + indent_writer_.Increase(); +} + +void JsonWriter::EndObject() { + FinishPreviousLine(END); + indent_writer_.Decrease(); + o_ << indent_ << "}"; +} + +void JsonWriter::BeginArray(const std::string &name) { + FinishPreviousLine(BEGIN); + o_ << indent_ << "\"" << name << "\":" << separator_ << "["; + indent_writer_.Increase(); +} + +void JsonWriter::EndArray() { + FinishPreviousLine(END); + indent_writer_.Decrease(); + o_ << indent_ << "]"; +} + +void JsonWriter::FinishPreviousLine(OutputType curr_type) { + if (last_type_ != START) { + if ((last_type_ == VALUE && curr_type == VALUE) || + (last_type_ == VALUE && curr_type == BEGIN) || + (last_type_ == END && curr_type == BEGIN) || + (last_type_ == END && curr_type == VALUE)) { + o_ << ","; + } + if (mode_ == READABLE) { + o_ << std::endl; + } + } + last_type_ = curr_type; +} + +std::string JsonWriter::MoveData() { + const std::string str = o_.str(); + o_.str(""); + return str; +} + +std::string JsonWriter::EscapeCharacter(const std::string &str, + const char character) { + size_t start = 0; + if ((start = str.find(character, start)) != std::string::npos) { + std::string s = str; + std::string escaped_character = "\\"; + escaped_character += character; + do { + s.replace(start, 1, escaped_character); + start += escaped_character.length(); + } while ((start = s.find(character, start)) != std::string::npos); + return s; + } + return str; +} + +std::string JsonWriter::EscapeJsonSpecialCharacters(const std::string &str) { + std::string s = str; + const char backspace = '\b'; + const char form_feed = '\f'; + const char newline = '\n'; + const char carriage_return = '\r'; + const char tab = '\t'; + const char double_quote = '\"'; + const char backslash = '\\'; + + // Backslash must come first. + s = EscapeCharacter(s, backslash); + s = EscapeCharacter(s, backspace); + s = EscapeCharacter(s, form_feed); + s = EscapeCharacter(s, newline); + s = EscapeCharacter(s, carriage_return); + s = EscapeCharacter(s, tab); + s = EscapeCharacter(s, double_quote); + return s; +} + +} // namespace draco + +#endif // DRACO_TRANSCODER_SUPPORTED diff --git a/contrib/draco/src/draco/io/gltf_utils.h b/contrib/draco/src/draco/io/gltf_utils.h new file mode 100644 index 000000000..2cf12fdc7 --- /dev/null +++ b/contrib/draco/src/draco/io/gltf_utils.h @@ -0,0 +1,186 @@ +// Copyright 2018 The Draco Authors. +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. +// +#ifndef DRACO_IO_GLTF_UTILS_H_ +#define DRACO_IO_GLTF_UTILS_H_ + +#include "draco/draco_features.h" + +#ifdef DRACO_TRANSCODER_SUPPORTED +#include +#include +#include + +namespace draco { + +// Class used to store integer or float values supported by glTF. +class GltfValue { + public: + enum ValueType { INT, DOUBLE }; + + explicit GltfValue(int8_t value) + : type_(INT), value_int_(value), value_double_(-1.0) {} + + explicit GltfValue(uint8_t value) + : type_(INT), value_int_(value), value_double_(-1.0) {} + + explicit GltfValue(int16_t value) + : type_(INT), value_int_(value), value_double_(-1.0) {} + + explicit GltfValue(uint16_t value) + : type_(INT), value_int_(value), value_double_(-1.0) {} + + explicit GltfValue(uint32_t value) + : type_(INT), value_int_(value), value_double_(-1.0) {} + + explicit GltfValue(float value) + : type_(DOUBLE), value_int_(-1), value_double_(value) {} + + friend std::ostream &operator<<(std::ostream &os, const GltfValue &value); + + private: + ValueType type_; + int64_t value_int_; + double value_double_; +}; + +// Utility class used to help with indentation of glTF file. +class Indent { + public: + Indent(); + + void Increase(); + void Decrease(); + + friend std::ostream &operator<<(std::ostream &os, const Indent &indent); + + private: + // Variables used for spacing of the glTF file. + std::string indent_; + const int indent_space_count_; +}; + +// Class used to keep track of the json state. +class JsonWriter { + public: + enum OutputType { START, BEGIN, END, VALUE }; + enum Mode { READABLE, COMPACT }; + + JsonWriter() + : last_type_(START), mode_(READABLE), indent_(*this), separator_(*this) {} + void SetMode(Mode mode) { mode_ = mode; } + + // Clear the stringstream and set last type to START. + void Reset(); + + // Every call to BeginObject should have a matching call to EndObject. + void BeginObject(); + void BeginObject(const std::string &name); + void EndObject(); + + // Every call to BeginArray should have a matching call to EndArray. + void BeginArray(const std::string &name); + void EndArray(); + + template + void OutputValue(const T &value) { + FinishPreviousLine(VALUE); + o_ << indent_ << std::setprecision(17) << value; + } + + void OutputValue(const bool &value) { + FinishPreviousLine(VALUE); + o_ << indent_ << ToString(value); + } + + void OutputValue(const std::string &name) { + const std::string escaped_name = EscapeJsonSpecialCharacters(name); + FinishPreviousLine(VALUE); + o_ << indent_ << "\"" << escaped_name << "\""; + } + + void OutputValue(const std::string &name, const std::string &value) { + const std::string escaped_name = EscapeJsonSpecialCharacters(name); + const std::string escaped_value = EscapeJsonSpecialCharacters(value); + FinishPreviousLine(VALUE); + o_ << indent_ << "\"" << escaped_name << "\":" << separator_ << "\"" + << escaped_value << "\""; + } + + void OutputValue(const std::string &name, const char *value) { + const std::string escaped_name = EscapeJsonSpecialCharacters(name); + const std::string escaped_value = EscapeJsonSpecialCharacters(value); + FinishPreviousLine(VALUE); + o_ << indent_ << "\"" << escaped_name << "\":" << separator_ << "\"" + << escaped_value << "\""; + } + + template + void OutputValue(const std::string &name, const T &value) { + const std::string escaped_name = EscapeJsonSpecialCharacters(name); + FinishPreviousLine(VALUE); + o_ << indent_ << "\"" << escaped_name << "\":" << separator_ << value; + } + + void OutputValue(const std::string &name, const bool &value) { + const std::string escaped_name = EscapeJsonSpecialCharacters(name); + FinishPreviousLine(VALUE); + o_ << indent_ << "\"" << escaped_name << "\":" << separator_ + << ToString(value); + } + + // Return the current output and then clear the stringstream. + std::string MoveData(); + + private: + // Check if a comma needs to be added to the output and then add a new line. + void FinishPreviousLine(OutputType curr_type); + + // Returns a string escaping all instances of |character| in |str|. + std::string EscapeCharacter(const std::string &str, const char character); + + // Returns a string escaping all of the Json special characters in |str|. + // Carriage return is not handled. + std::string EscapeJsonSpecialCharacters(const std::string &str); + + // Returns string representation of a Boolean |value|. + static std::string ToString(bool value) { return value ? "true" : "false"; } + + // Helper struct used for conditional indent writing to the output stream. + struct IndentWrapper { + explicit IndentWrapper(const JsonWriter &writer) : writer(writer) {} + const JsonWriter &writer; + }; + friend std::ostream &operator<<(std::ostream &os, + const IndentWrapper &indent); + + // Helper struct used for conditional separator writing to the output stream. + struct Separator { + explicit Separator(const JsonWriter &writer) : writer(writer) {} + const JsonWriter &writer; + }; + friend std::ostream &operator<<(std::ostream &os, const Separator &separator); + + std::stringstream o_; + Indent indent_writer_; + OutputType last_type_; + Mode mode_; + IndentWrapper indent_; + Separator separator_; +}; + +} // namespace draco + +#endif // DRACO_TRANSCODER_SUPPORTED +#endif // DRACO_IO_GLTF_UTILS_H_ diff --git a/contrib/draco/src/draco/io/gltf_utils_test.cc b/contrib/draco/src/draco/io/gltf_utils_test.cc new file mode 100644 index 000000000..01a2d144c --- /dev/null +++ b/contrib/draco/src/draco/io/gltf_utils_test.cc @@ -0,0 +1,366 @@ +// Copyright 2018 The Draco Authors. +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. +// +#include "draco/io/gltf_utils.h" + +#ifdef DRACO_TRANSCODER_SUPPORTED +#include +#include + +#include "draco/core/draco_test_base.h" +#include "draco/core/draco_test_utils.h" + +namespace draco { + +class GltfUtilsTest : public ::testing::Test { + protected: + void CompareGolden(JsonWriter *json_writer, const std::string &golden_str) { + const std::string json = json_writer->MoveData(); + ASSERT_EQ(golden_str, json); + } +}; + +TEST_F(GltfUtilsTest, TestNoData) { + const std::string golden = ""; + JsonWriter json_writer; + CompareGolden(&json_writer, golden); +} + +TEST_F(GltfUtilsTest, TestValues) { + JsonWriter json_writer; + json_writer.OutputValue(0); + CompareGolden(&json_writer, "0"); + + json_writer.Reset(); + json_writer.OutputValue(1); + CompareGolden(&json_writer, "1"); + + json_writer.Reset(); + json_writer.OutputValue(-1); + CompareGolden(&json_writer, "-1"); + + json_writer.Reset(); + json_writer.OutputValue(0.0); + CompareGolden(&json_writer, "0"); + + json_writer.Reset(); + json_writer.OutputValue(1.0); + CompareGolden(&json_writer, "1"); + + json_writer.Reset(); + json_writer.OutputValue(0.25); + CompareGolden(&json_writer, "0.25"); + + json_writer.Reset(); + json_writer.OutputValue(-0.25); + CompareGolden(&json_writer, "-0.25"); + + json_writer.Reset(); + json_writer.OutputValue(false); + CompareGolden(&json_writer, "false"); + + json_writer.Reset(); + json_writer.OutputValue(true); + CompareGolden(&json_writer, "true"); + + json_writer.Reset(); + json_writer.OutputValue("test int", -1); + CompareGolden(&json_writer, "\"test int\": -1"); + + json_writer.Reset(); + json_writer.OutputValue("test float", -10.25); + CompareGolden(&json_writer, "\"test float\": -10.25"); + + json_writer.Reset(); + json_writer.OutputValue("test char*", "I am the string!"); + CompareGolden(&json_writer, "\"test char*\": \"I am the string!\""); + + json_writer.Reset(); + const std::string value = "I am the string!"; + json_writer.OutputValue("test string", value); + CompareGolden(&json_writer, "\"test string\": \"I am the string!\""); + + json_writer.Reset(); + json_writer.OutputValue("test bool", false); + CompareGolden(&json_writer, "\"test bool\": false"); + + json_writer.Reset(); + json_writer.OutputValue("test bool", true); + CompareGolden(&json_writer, "\"test bool\": true"); +} + +TEST_F(GltfUtilsTest, TestSpecialCharacters) { + JsonWriter json_writer; + const std::string test_double_quote = "I am double quote\""; + json_writer.OutputValue("test double quote", test_double_quote); + CompareGolden(&json_writer, + "\"test double quote\": \"I am double quote\\\"\""); + + json_writer.Reset(); + const std::string test_backspace = "I am backspace\b"; + json_writer.OutputValue("test backspace", test_backspace); + CompareGolden(&json_writer, "\"test backspace\": \"I am backspace\\\b\""); + + json_writer.Reset(); + const std::string test_form_feed = "I am form feed\f"; + json_writer.OutputValue("test form feed", test_form_feed); + CompareGolden(&json_writer, "\"test form feed\": \"I am form feed\\\f\""); + + json_writer.Reset(); + const std::string test_newline = "I am newline\n"; + json_writer.OutputValue("test newline", test_newline); + CompareGolden(&json_writer, "\"test newline\": \"I am newline\\\n\""); + + json_writer.Reset(); + const std::string test_tab = "I am tab\t"; + json_writer.OutputValue("test tab", test_tab); + CompareGolden(&json_writer, "\"test tab\": \"I am tab\\\t\""); + + json_writer.Reset(); + const std::string test_backslash = "I am backslash\\"; + json_writer.OutputValue("test backslash", test_backslash); + CompareGolden(&json_writer, "\"test backslash\": \"I am backslash\\\\\""); + + json_writer.Reset(); + const std::string test_multiple_special_characters = "\"break\"and\\more\"\\"; + json_writer.OutputValue("test multiple_special_characters", + test_multiple_special_characters); + CompareGolden(&json_writer, + "\"test multiple_special_characters\": " + "\"\\\"break\\\"and\\\\more\\\"\\\\\""); +} + +TEST_F(GltfUtilsTest, TestObjects) { + JsonWriter json_writer; + json_writer.BeginObject(); + json_writer.EndObject(); + CompareGolden(&json_writer, "{\n}"); + + json_writer.Reset(); + json_writer.BeginObject("object"); + json_writer.EndObject(); + CompareGolden(&json_writer, "\"object\": {\n}"); + + json_writer.Reset(); + json_writer.BeginObject("object"); + json_writer.OutputValue(0); + json_writer.EndObject(); + CompareGolden(&json_writer, "\"object\": {\n 0\n}"); + + json_writer.Reset(); + json_writer.BeginObject("object"); + json_writer.OutputValue(0); + json_writer.OutputValue(1); + json_writer.OutputValue(2); + json_writer.OutputValue(3); + json_writer.EndObject(); + CompareGolden(&json_writer, "\"object\": {\n 0,\n 1,\n 2,\n 3\n}"); + + json_writer.Reset(); + json_writer.BeginObject("object1"); + json_writer.EndObject(); + json_writer.BeginObject("object2"); + json_writer.EndObject(); + CompareGolden(&json_writer, "\"object1\": {\n},\n\"object2\": {\n}"); + + json_writer.Reset(); + json_writer.BeginObject("object1"); + json_writer.BeginObject("object2"); + json_writer.EndObject(); + json_writer.EndObject(); + CompareGolden(&json_writer, "\"object1\": {\n \"object2\": {\n }\n}"); +} + +TEST_F(GltfUtilsTest, TestArrays) { + JsonWriter json_writer; + json_writer.BeginArray("array"); + json_writer.EndArray(); + CompareGolden(&json_writer, "\"array\": [\n]"); + + json_writer.Reset(); + json_writer.BeginArray("array"); + json_writer.OutputValue(0); + json_writer.EndArray(); + CompareGolden(&json_writer, "\"array\": [\n 0\n]"); + + json_writer.Reset(); + json_writer.BeginArray("array"); + json_writer.OutputValue(0); + json_writer.OutputValue(1); + json_writer.OutputValue(2); + json_writer.OutputValue(3); + json_writer.EndArray(); + CompareGolden(&json_writer, "\"array\": [\n 0,\n 1,\n 2,\n 3\n]"); + + json_writer.Reset(); + json_writer.BeginArray("array1"); + json_writer.EndArray(); + json_writer.BeginArray("array2"); + json_writer.EndArray(); + CompareGolden(&json_writer, "\"array1\": [\n],\n\"array2\": [\n]"); + + json_writer.Reset(); + json_writer.BeginArray("array1"); + json_writer.BeginArray("array2"); + json_writer.EndArray(); + json_writer.EndArray(); + CompareGolden(&json_writer, "\"array1\": [\n \"array2\": [\n ]\n]"); +} + +TEST_F(GltfUtilsTest, TestGltfValues) { + JsonWriter json_writer; + const int8_t int8_value_min = std::numeric_limits::min(); + const int8_t int8_value_max = std::numeric_limits::max(); + const GltfValue int8_value_low(int8_value_min); + const GltfValue int8_value_high(int8_value_max); + json_writer.OutputValue(int8_value_low); + json_writer.OutputValue(int8_value_high); + CompareGolden(&json_writer, "-128,\n127"); + + json_writer.Reset(); + const uint8_t uint8_value_min = std::numeric_limits::min(); + const uint8_t uint8_value_max = std::numeric_limits::max(); + const GltfValue uint8_value_low(uint8_value_min); + const GltfValue uint8_value_high(uint8_value_max); + json_writer.OutputValue(uint8_value_low); + json_writer.OutputValue(uint8_value_high); + CompareGolden(&json_writer, "0,\n255"); + + json_writer.Reset(); + const int16_t int16_value_min = std::numeric_limits::min(); + const int16_t int16_value_max = std::numeric_limits::max(); + const GltfValue int16_value_low(int16_value_min); + const GltfValue int16_value_high(int16_value_max); + json_writer.OutputValue(int16_value_low); + json_writer.OutputValue(int16_value_high); + CompareGolden(&json_writer, "-32768,\n32767"); + + json_writer.Reset(); + const uint16_t uint16_value_min = std::numeric_limits::min(); + const uint16_t uint16_value_max = std::numeric_limits::max(); + const GltfValue uint16_value_low(uint16_value_min); + const GltfValue uint16_value_high(uint16_value_max); + json_writer.OutputValue(uint16_value_low); + json_writer.OutputValue(uint16_value_high); + CompareGolden(&json_writer, "0,\n65535"); + + json_writer.Reset(); + const uint32_t uint32_value_min = std::numeric_limits::min(); + const uint32_t uint32_value_max = std::numeric_limits::max(); + const GltfValue uint32_value_low(uint32_value_min); + const GltfValue uint32_value_high(uint32_value_max); + json_writer.OutputValue(uint32_value_low); + json_writer.OutputValue(uint32_value_high); + CompareGolden(&json_writer, "0,\n4294967295"); + + json_writer.Reset(); + const float float_value_min = std::numeric_limits::min(); + const float float_value_max = std::numeric_limits::max(); + const GltfValue float_value_low(float_value_min); + const GltfValue float_value_high(float_value_max); + json_writer.OutputValue(float_value_low); + json_writer.OutputValue(float_value_high); + CompareGolden(&json_writer, + "1.1754943508222875e-38,\n3.4028234663852886e+38"); + + json_writer.Reset(); + const GltfValue float_value_0(0.1f); + const GltfValue float_value_1(1.f); + json_writer.OutputValue(float_value_0); + json_writer.OutputValue(float_value_1); + CompareGolden(&json_writer, "0.10000000149011612,\n1"); +} + +TEST_F(GltfUtilsTest, TestObjectsCompact) { + JsonWriter json_writer; + json_writer.SetMode(JsonWriter::COMPACT); + json_writer.BeginObject(); + json_writer.EndObject(); + CompareGolden(&json_writer, "{}"); + + json_writer.Reset(); + json_writer.BeginObject("object"); + json_writer.EndObject(); + CompareGolden(&json_writer, "\"object\":{}"); + + json_writer.Reset(); + json_writer.BeginObject("object"); + json_writer.OutputValue(0); + json_writer.EndObject(); + CompareGolden(&json_writer, "\"object\":{0}"); + + json_writer.Reset(); + json_writer.BeginObject("object"); + json_writer.OutputValue(0); + json_writer.OutputValue(1); + json_writer.OutputValue(2); + json_writer.OutputValue(3); + json_writer.EndObject(); + CompareGolden(&json_writer, "\"object\":{0,1,2,3}"); + + json_writer.Reset(); + json_writer.BeginObject("object1"); + json_writer.EndObject(); + json_writer.BeginObject("object2"); + json_writer.EndObject(); + CompareGolden(&json_writer, "\"object1\":{},\"object2\":{}"); + + json_writer.Reset(); + json_writer.BeginObject("object1"); + json_writer.BeginObject("object2"); + json_writer.EndObject(); + json_writer.EndObject(); + CompareGolden(&json_writer, "\"object1\":{\"object2\":{}}"); +} + +TEST_F(GltfUtilsTest, TestArraysCompact) { + JsonWriter json_writer; + json_writer.SetMode(JsonWriter::COMPACT); + json_writer.BeginArray("array"); + json_writer.EndArray(); + CompareGolden(&json_writer, "\"array\":[]"); + + json_writer.Reset(); + json_writer.BeginArray("array"); + json_writer.OutputValue(0); + json_writer.EndArray(); + CompareGolden(&json_writer, "\"array\":[0]"); + + json_writer.Reset(); + json_writer.BeginArray("array"); + json_writer.OutputValue(0); + json_writer.OutputValue(1); + json_writer.OutputValue(2); + json_writer.OutputValue(3); + json_writer.EndArray(); + CompareGolden(&json_writer, "\"array\":[0,1,2,3]"); + + json_writer.Reset(); + json_writer.BeginArray("array1"); + json_writer.EndArray(); + json_writer.BeginArray("array2"); + json_writer.EndArray(); + CompareGolden(&json_writer, "\"array1\":[],\"array2\":[]"); + + json_writer.Reset(); + json_writer.BeginArray("array1"); + json_writer.BeginArray("array2"); + json_writer.EndArray(); + json_writer.EndArray(); + CompareGolden(&json_writer, "\"array1\":[\"array2\":[]]"); +} + +} // namespace draco + +#endif // DRACO_TRANSCODER_SUPPORTED diff --git a/contrib/draco/src/draco/io/image_compression_options.h b/contrib/draco/src/draco/io/image_compression_options.h new file mode 100644 index 000000000..722bdbd64 --- /dev/null +++ b/contrib/draco/src/draco/io/image_compression_options.h @@ -0,0 +1,31 @@ +// Copyright 2020 The Draco Authors. +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. +// +#ifndef DRACO_IO_IMAGE_COMPRESSION_OPTIONS_H_ +#define DRACO_IO_IMAGE_COMPRESSION_OPTIONS_H_ + +#include "draco/draco_features.h" + +#ifdef DRACO_TRANSCODER_SUPPORTED +#include + +namespace draco { + +// Enum defining image compression formats. +enum class ImageFormat { NONE, PNG, JPEG, BASIS, WEBP }; + +} // namespace draco + +#endif // DRACO_TRANSCODER_SUPPORTED +#endif // DRACO_IO_IMAGE_COMPRESSION_OPTIONS_H_ diff --git a/contrib/draco/src/draco/io/mesh_io.cc b/contrib/draco/src/draco/io/mesh_io.cc index e0dc69c6f..4975d9236 100644 --- a/contrib/draco/src/draco/io/mesh_io.cc +++ b/contrib/draco/src/draco/io/mesh_io.cc @@ -18,8 +18,18 @@ #include #include "draco/io/file_utils.h" +#include "draco/io/file_writer_interface.h" #include "draco/io/obj_decoder.h" #include "draco/io/ply_decoder.h" +#include "draco/io/stl_decoder.h" +#ifdef DRACO_TRANSCODER_SUPPORTED +#include "draco/compression/draco_compression_options.h" +#include "draco/compression/encode.h" +#include "draco/io/gltf_decoder.h" +#include "draco/io/gltf_encoder.h" +#include "draco/io/obj_encoder.h" +#include "draco/io/ply_encoder.h" +#endif namespace draco { @@ -46,27 +56,40 @@ StatusOr> ReadMeshFromFile( std::unique_ptr mesh(new Mesh()); // Analyze file extension. const std::string extension = LowercaseFileExtension(file_name); - if (extension != "gltf" && mesh_files) { - // The GLTF decoder will fill |mesh_files|, but for other file types we set - // the root file here to avoid duplicating code. + if (extension != "gltf" && extension != "obj" && mesh_files) { + // The GLTF/OBJ decoder will fill |mesh_files|, but for other file types we + // set the root file here to avoid duplicating code. mesh_files->push_back(file_name); } if (extension == "obj") { // Wavefront OBJ file format. ObjDecoder obj_decoder; obj_decoder.set_use_metadata(options.GetBool("use_metadata", false)); - const Status obj_status = obj_decoder.DecodeFromFile(file_name, mesh.get()); + obj_decoder.set_preserve_polygons(options.GetBool("preserve_polygons")); + const Status obj_status = + obj_decoder.DecodeFromFile(file_name, mesh.get(), mesh_files); if (!obj_status.ok()) { return obj_status; } return std::move(mesh); } if (extension == "ply") { - // Wavefront PLY file format. + // Stanford PLY file format. PlyDecoder ply_decoder; DRACO_RETURN_IF_ERROR(ply_decoder.DecodeFromFile(file_name, mesh.get())); return std::move(mesh); } + if (extension == "stl") { + // STL file format. + StlDecoder stl_decoder; + return stl_decoder.DecodeFromFile(file_name); + } +#ifdef DRACO_TRANSCODER_SUPPORTED + if (extension == "gltf" || extension == "glb") { + GltfDecoder gltf_decoder; + return gltf_decoder.DecodeFromFile(file_name, mesh_files); + } +#endif // Otherwise not an obj file. Assume the file was encoded with one of the // draco encoding methods. diff --git a/contrib/draco/src/draco/io/obj_decoder.cc b/contrib/draco/src/draco/io/obj_decoder.cc index 9b4eab626..c233c2b56 100644 --- a/contrib/draco/src/draco/io/obj_decoder.cc +++ b/contrib/draco/src/draco/io/obj_decoder.cc @@ -14,8 +14,10 @@ // #include "draco/io/obj_decoder.h" +#include #include #include +#include #include "draco/io/file_utils.h" #include "draco/io/parser_utils.h" @@ -36,15 +38,25 @@ ObjDecoder::ObjDecoder() norm_att_id_(-1), material_att_id_(-1), sub_obj_att_id_(-1), + added_edge_att_id_(-1), deduplicate_input_values_(true), last_material_id_(0), use_metadata_(false), + preserve_polygons_(false), + has_polygons_(false), + mesh_files_(nullptr), out_mesh_(nullptr), out_point_cloud_(nullptr) {} Status ObjDecoder::DecodeFromFile(const std::string &file_name, Mesh *out_mesh) { + return DecodeFromFile(file_name, out_mesh, nullptr); +} + +Status ObjDecoder::DecodeFromFile(const std::string &file_name, Mesh *out_mesh, + std::vector *mesh_files) { out_mesh_ = out_mesh; + mesh_files_ = mesh_files; return DecodeFromFile(file_name, static_cast(out_mesh)); } @@ -90,6 +102,10 @@ Status ObjDecoder::DecodeInternal() { return status; } + if (mesh_files_ && !input_file_name_.empty()) { + mesh_files_->push_back(input_file_name_); + } + bool use_identity_mapping = false; if (num_obj_faces_ == 0) { // Mesh has no faces. In this case we try to read the geometry as a point @@ -146,6 +162,24 @@ Status ObjDecoder::DecodeInternal() { norm_att_id_ = out_point_cloud_->AddAttribute(va, use_identity_mapping, num_normals_); } + if (preserve_polygons_ && has_polygons_) { + // Create attribute for polygon reconstruction. + GeometryAttribute va; + va.Init(GeometryAttribute::GENERIC, nullptr, 1, DT_UINT8, false, 1, 0); + PointCloud *const pc = out_point_cloud_; + added_edge_att_id_ = pc->AddAttribute(va, false, 2); + + // Set attribute values to zero and one representing old edge and new edge. + for (const uint8_t i : {0, 1}) { + const AttributeValueIndex avi(i); + pc->attribute(added_edge_att_id_)->SetAttributeValue(avi, &i); + } + + // Add attribute metadata with name. + std::unique_ptr metadata(new draco::AttributeMetadata()); + metadata->AddEntryString("name", "added_edges"); + pc->AddAttributeMetadata(added_edge_att_id_, std::move(metadata)); + } if (num_materials_ > 0 && num_obj_faces_ > 0) { GeometryAttribute va; const auto geometry_attribute_type = GeometryAttribute::GENERIC; @@ -381,6 +415,7 @@ bool ObjDecoder::ParseTexCoord(Status *status) { } bool ObjDecoder::ParseFace(Status *status) { + constexpr int kMaxCorners = 8; char c; if (!buffer()->Peek(&c)) { return false; @@ -391,37 +426,35 @@ bool ObjDecoder::ParseFace(Status *status) { // Face definition found! buffer()->Advance(1); if (!counting_mode_) { - std::array indices[4]; - // Parse face indices (we try to look for up to four to support quads). + std::array indices[kMaxCorners]; + // Parse face indices. int num_valid_indices = 0; - for (int i = 0; i < 4; ++i) { + for (int i = 0; i < kMaxCorners; ++i) { if (!ParseVertexIndices(&indices[i])) { - if (i == 3) { - break; // It's OK if there is no fourth vertex index. + if (i >= 3) { + break; // It's OK if there is no fourth or higher vertex index. } *status = Status(Status::DRACO_ERROR, "Failed to parse vertex indices"); return true; } ++num_valid_indices; } - // Process the first face. - for (int i = 0; i < 3; ++i) { - const PointIndex vert_id(3 * num_obj_faces_ + i); - MapPointToVertexIndices(vert_id, indices[i]); - } - ++num_obj_faces_; - if (num_valid_indices == 4) { - // Add an additional triangle for the quad. - // - // 3----2 - // | / | - // | / | - // 0----1 - // - const PointIndex vert_id(3 * num_obj_faces_); - MapPointToVertexIndices(vert_id, indices[0]); - MapPointToVertexIndices(vert_id + 1, indices[2]); - MapPointToVertexIndices(vert_id + 2, indices[3]); + // Split quads and other n-gons into n - 2 triangles. + const int nt = num_valid_indices - 2; + // Iterate over triangles. + for (int t = 0; t < nt; t++) { + // Iterate over corners. + for (int c = 0; c < 3; c++) { + const PointIndex vert_id(3 * num_obj_faces_ + c); + const int triangulated_index = Triangulate(t, c); + MapPointToVertexIndices(vert_id, indices[triangulated_index]); + // Save info about new edges that will allow us to reconstruct polygons. + if (added_edge_att_id_ >= 0) { + const AttributeValueIndex avi(IsNewEdge(nt, t, c)); + out_point_cloud_->attribute(added_edge_att_id_) + ->SetPointMapEntry(vert_id, avi); + } + } ++num_obj_faces_; } } else { @@ -443,12 +476,14 @@ bool ObjDecoder::ParseFace(Status *status) { } } } - if (num_indices < 3 || num_indices > 4) { - *status = - Status(Status::DRACO_ERROR, "Invalid number of indices on a face"); + if (num_indices > 3) { + has_polygons_ = true; + } + if (num_indices < 3 || num_indices > kMaxCorners) { + *status = ErrorStatus("Invalid number of indices on a face"); return false; } - // Either one or two new triangles. + // Either one or more new triangles. num_obj_faces_ += num_indices - 2; } parser::SkipLine(buffer()); @@ -478,6 +513,9 @@ bool ObjDecoder::ParseMaterialLib(Status *status) { parser::SkipLine(&line_buffer); if (!material_file_name_.empty()) { + if (mesh_files_) { + mesh_files_->push_back(material_file_name_); + } if (!ParseMaterialFile(material_file_name_, status)) { // Silently ignore problems with material files for now. return true; @@ -705,4 +743,44 @@ bool ObjDecoder::ParseMaterialFileDefinition(Status * /* status */) { return true; } +// Methods Triangulate() and IsNewEdge() are used for polygon triangulation and +// representation as an attribute for reconstruction in the decoder. +// +// Polygon reconstruction attribute is associated with every triangle corner and +// has values zero or one. Zero indicates that an edge opposite to the corner is +// present in the original mesh (dashed lines), and one indicates that the +// opposite edge has been added during polygon triangulation (dotted lines). +// +// Polygon triangulation is illustrated below. Pentagon ABCDE is split into +// three triangles ABC, ACD, ADE. It is sufficient to set polygon reconstruction +// attribute at corners ABC and ACD. The attribute at the second corner of all +// triangles except for the last is set to one. +// +// C D +// * --------- * +// /. 1 0 .| +// / . . | +// / . . | +// / 0 . . 0 | +// / . . | +// B * 1 . . | +// \ . . | +// \ 0 . 0 . | +// \ . . | +// \ . . | +// \.. 0 0 | +// *-----------* +// A E +// +inline int ObjDecoder::Triangulate(int tri_index, int tri_corner) { + return tri_corner == 0 ? 0 : tri_index + tri_corner; +} + +inline bool ObjDecoder::IsNewEdge(int tri_count, int tri_index, + int tri_corner) { + // All but the last triangle of the triangulated polygon have an added edge + // opposite of corner 1. + return tri_index != tri_count - 1 && tri_corner == 1; +} + } // namespace draco diff --git a/contrib/draco/src/draco/io/obj_decoder.h b/contrib/draco/src/draco/io/obj_decoder.h index baeab5b0c..18dc9aadd 100644 --- a/contrib/draco/src/draco/io/obj_decoder.h +++ b/contrib/draco/src/draco/io/obj_decoder.h @@ -34,8 +34,12 @@ class ObjDecoder { ObjDecoder(); // Decodes an obj file stored in the input file. - // Returns nullptr if the decoding failed. + // Optional argument |mesh_files| will be populated with all paths to files + // relevant to the loaded mesh. Status DecodeFromFile(const std::string &file_name, Mesh *out_mesh); + Status DecodeFromFile(const std::string &file_name, Mesh *out_mesh, + std::vector *mesh_files); + Status DecodeFromFile(const std::string &file_name, PointCloud *out_point_cloud); @@ -50,6 +54,8 @@ class ObjDecoder { // Flag for whether using metadata to record other information in the obj // file, e.g. material names, object names. void set_use_metadata(bool flag) { use_metadata_ = flag; } + // Enables preservation of polygons. + void set_preserve_polygons(bool flag) { preserve_polygons_ = flag; } protected: Status DecodeInternal(); @@ -88,6 +94,11 @@ class ObjDecoder { bool ParseMaterialFile(const std::string &file_name, Status *status); bool ParseMaterialFileDefinition(Status *status); + // Methods related to polygon triangulation and preservation. + static int Triangulate(int tri_index, int tri_corner); + static bool IsNewEdge(int tri_count, int tri_index, int tri_corner); + + private: // If set to true, the parser will count the number of various definitions // but it will not parse the actual data or add any new entries to the mesh. bool counting_mode_; @@ -102,7 +113,8 @@ class ObjDecoder { int tex_att_id_; int norm_att_id_; int material_att_id_; - int sub_obj_att_id_; // Attribute id for storing sub-objects. + int sub_obj_att_id_; // Attribute id for storing sub-objects. + int added_edge_att_id_; // Attribute id for polygon reconstruction. bool deduplicate_input_values_; @@ -116,6 +128,12 @@ class ObjDecoder { bool use_metadata_; + // Polygon preservation flags. + bool preserve_polygons_; + bool has_polygons_; + + std::vector *mesh_files_; + DecoderBuffer buffer_; // Data structure that stores the decoded data. |out_point_cloud_| must be diff --git a/contrib/draco/src/draco/io/obj_decoder_test.cc b/contrib/draco/src/draco/io/obj_decoder_test.cc index b19fe6e2c..a46a15a8b 100644 --- a/contrib/draco/src/draco/io/obj_decoder_test.cc +++ b/contrib/draco/src/draco/io/obj_decoder_test.cc @@ -54,6 +54,20 @@ class ObjDecoderTest : public ::testing::Test { return geometry; } + template + std::unique_ptr DecodeObjWithPolygons( + const std::string &file_name, bool regularize_quads, + bool store_added_edges_per_vertex) const { + const std::string path = GetTestFileFullPath(file_name); + ObjDecoder decoder; + decoder.set_preserve_polygons(true); + std::unique_ptr geometry(new Geometry()); + if (!decoder.DecodeFromFile(path, geometry.get()).ok()) { + return nullptr; + } + return geometry; + } + void test_decoding(const std::string &file_name) { const std::unique_ptr mesh(DecodeObj(file_name)); ASSERT_NE(mesh, nullptr) << "Failed to load test model " << file_name; @@ -113,7 +127,7 @@ TEST_F(ObjDecoderTest, SubObjectsWithMetadata) { ASSERT_EQ(sub_obj_id, 2); } -TEST_F(ObjDecoderTest, QuadOBJ) { +TEST_F(ObjDecoderTest, QuadTriangulateOBJ) { // Tests loading an Obj with quad faces. const std::string file_name = "cube_quads.obj"; const std::unique_ptr mesh(DecodeObj(file_name)); @@ -124,11 +138,114 @@ TEST_F(ObjDecoderTest, QuadOBJ) { ASSERT_EQ(mesh->num_points(), 4 * 6); // Four points per quad face. } -TEST_F(ObjDecoderTest, ComplexPolyOBJ) { - // Tests that we fail to load an obj with complex polygon (expected failure). - const std::string file_name = "invalid/complex_poly.obj"; +TEST_F(ObjDecoderTest, QuadPreserveOBJ) { + // Tests loading an Obj with quad faces preserved as an attribute. + const std::string file_name = "cube_quads.obj"; + constexpr bool kRegularizeQuads = false; + constexpr bool kStoreAddedEdgesPerVertex = false; + const std::unique_ptr mesh(DecodeObjWithPolygons( + file_name, kRegularizeQuads, kStoreAddedEdgesPerVertex)); + ASSERT_NE(mesh, nullptr) << "Failed to load test model " << file_name; + ASSERT_EQ(mesh->num_faces(), 12); + + ASSERT_EQ(mesh->num_attributes(), 4); + ASSERT_EQ(mesh->num_points(), 4 * 6); // Four points per quad face. + + // Expect a new generic attribute. + ASSERT_EQ(mesh->attribute(3)->attribute_type(), GeometryAttribute::GENERIC); + + // Expect the new attribute to have two values to describe old and new edge. + ASSERT_EQ(mesh->attribute(3)->size(), 2); + const auto new_edge_value = + mesh->attribute(3)->GetValue(AttributeValueIndex(0))[0]; + const auto old_edge_value = + mesh->attribute(3)->GetValue(AttributeValueIndex(1))[0]; + ASSERT_EQ(new_edge_value, 0); + ASSERT_EQ(old_edge_value, 1); + + // Expect one new edge on each of the six cube quads. + for (int i = 0; i < 6; i++) { + ASSERT_EQ(mesh->attribute(3)->mapped_index(PointIndex(4 * i + 0)), 0); + // New edge. + ASSERT_EQ(mesh->attribute(3)->mapped_index(PointIndex(4 * i + 1)), 1); + ASSERT_EQ(mesh->attribute(3)->mapped_index(PointIndex(4 * i + 2)), 0); + ASSERT_EQ(mesh->attribute(3)->mapped_index(PointIndex(4 * i + 3)), 0); + } + + // Expect metadata entry on the new attribute. + const AttributeMetadata *const metadata = + mesh->GetAttributeMetadataByAttributeId(3); + ASSERT_NE(metadata, nullptr); + ASSERT_TRUE(metadata->sub_metadatas().empty()); + ASSERT_EQ(metadata->entries().size(), 1); + std::string name; + metadata->GetEntryString("name", &name); + ASSERT_EQ(name, "added_edges"); +} + +TEST_F(ObjDecoderTest, OctagonTriangulatedOBJ) { + // Tests that we can load an obj with an octagon triangulated. + const std::string file_name = "octagon.obj"; const std::unique_ptr mesh(DecodeObj(file_name)); - ASSERT_EQ(mesh, nullptr); + ASSERT_NE(mesh, nullptr) << "Failed to load test model " << file_name; + + ASSERT_EQ(mesh->num_attributes(), 1); + ASSERT_EQ(mesh->num_points(), 8); + ASSERT_EQ(mesh->attribute(0)->attribute_type(), GeometryAttribute::POSITION); + ASSERT_EQ(mesh->attribute(0)->size(), 8); +} + +TEST_F(ObjDecoderTest, OctagonPreservedOBJ) { + // Tests that we can load an obj with an octagon preserved as an attribute. + const std::string file_name = "octagon.obj"; + constexpr bool kRegularizeQuads = false; + constexpr bool kStoreAddedEdgesPerVertex = false; + const std::unique_ptr mesh(DecodeObjWithPolygons( + file_name, kRegularizeQuads, kStoreAddedEdgesPerVertex)); + ASSERT_NE(mesh, nullptr) << "Failed to load test model " << file_name; + + ASSERT_EQ(mesh->num_attributes(), 2); + ASSERT_EQ(mesh->attribute(0)->attribute_type(), GeometryAttribute::POSITION); + ASSERT_EQ(mesh->attribute(0)->size(), 8); + + // Expect a new generic attribute. + ASSERT_EQ(mesh->attribute(1)->attribute_type(), GeometryAttribute::GENERIC); + + // There are four vertices with both old and new edges in their ring. + ASSERT_EQ(mesh->num_points(), 8 + 4); + + // Expect the new attribute to have two values to describe old and new edge. + ASSERT_EQ(mesh->attribute(1)->size(), 2); + const auto new_edge_value = + mesh->attribute(1)->GetValue(AttributeValueIndex(0))[0]; + const auto old_edge_value = + mesh->attribute(1)->GetValue(AttributeValueIndex(1))[0]; + ASSERT_EQ(new_edge_value, 0); + ASSERT_EQ(old_edge_value, 1); + + // Five new edges are introduced while triangulating as octagon. + ASSERT_EQ(mesh->attribute(1)->mapped_index(PointIndex(0)), 0); + ASSERT_EQ(mesh->attribute(1)->mapped_index(PointIndex(1)), 1); // New edge. + ASSERT_EQ(mesh->attribute(1)->mapped_index(PointIndex(2)), 0); + ASSERT_EQ(mesh->attribute(1)->mapped_index(PointIndex(3)), 1); // New edge. + ASSERT_EQ(mesh->attribute(1)->mapped_index(PointIndex(4)), 0); + ASSERT_EQ(mesh->attribute(1)->mapped_index(PointIndex(5)), 1); // New edge. + ASSERT_EQ(mesh->attribute(1)->mapped_index(PointIndex(6)), 0); + ASSERT_EQ(mesh->attribute(1)->mapped_index(PointIndex(7)), 1); // New edge. + ASSERT_EQ(mesh->attribute(1)->mapped_index(PointIndex(8)), 0); + ASSERT_EQ(mesh->attribute(1)->mapped_index(PointIndex(9)), 1); // New edge. + ASSERT_EQ(mesh->attribute(1)->mapped_index(PointIndex(10)), 0); + ASSERT_EQ(mesh->attribute(1)->mapped_index(PointIndex(11)), 0); + + // Expect metadata entry on the new attribute. + const AttributeMetadata *const metadata = + mesh->GetAttributeMetadataByAttributeId(1); + ASSERT_NE(metadata, nullptr); + ASSERT_TRUE(metadata->sub_metadatas().empty()); + ASSERT_EQ(metadata->entries().size(), 1); + std::string name; + metadata->GetEntryString("name", &name); + ASSERT_EQ(name, "added_edges"); } TEST_F(ObjDecoderTest, EmptyNameOBJ) { @@ -167,7 +284,6 @@ TEST_F(ObjDecoderTest, WrongAttributeMapping) { TEST_F(ObjDecoderTest, TestObjDecodingAll) { // test if we can read all obj that are currently in test folder. test_decoding("bunny_norm.obj"); - // test_decoding("complex_poly.obj"); // not supported see test above test_decoding("cube_att.obj"); test_decoding("cube_att_partial.obj"); test_decoding("cube_att_sub_o.obj"); diff --git a/contrib/draco/src/draco/io/obj_encoder.cc b/contrib/draco/src/draco/io/obj_encoder.cc index 29c6ca8f0..1ddfd92bd 100644 --- a/contrib/draco/src/draco/io/obj_encoder.cc +++ b/contrib/draco/src/draco/io/obj_encoder.cc @@ -16,8 +16,10 @@ #include +#include "draco/attributes/geometry_attribute.h" #include "draco/io/file_writer_factory.h" #include "draco/io/file_writer_interface.h" +#include "draco/mesh/mesh_misc_functions.h" #include "draco/metadata/geometry_metadata.h" namespace draco { @@ -28,6 +30,7 @@ ObjEncoder::ObjEncoder() normal_att_(nullptr), material_att_(nullptr), sub_obj_att_(nullptr), + added_edges_att_(nullptr), out_buffer_(nullptr), in_point_cloud_(nullptr), in_mesh_(nullptr), @@ -78,11 +81,15 @@ bool ObjEncoder::EncodeInternal() { normal_att_ = nullptr; material_att_ = nullptr; sub_obj_att_ = nullptr; + added_edges_att_ = nullptr; current_sub_obj_id_ = -1; current_material_id_ = -1; if (!GetSubObjects()) { return false; } + if (in_mesh_ && !GetAddedEdges()) { + return false; + } if (!EncodeMaterialFileName()) { return false; } @@ -110,12 +117,38 @@ bool ObjEncoder::ExitAndCleanup(bool return_value) { normal_att_ = nullptr; material_att_ = nullptr; sub_obj_att_ = nullptr; + added_edges_att_ = nullptr; current_sub_obj_id_ = -1; current_material_id_ = -1; file_name_.clear(); return return_value; } +bool ObjEncoder::GetAddedEdges() { + const GeometryMetadata *mesh_metadata = in_mesh_->GetMetadata(); + if (!mesh_metadata) { + return true; + } + + // Try to get a per-corner attribute describing added edges. + { + const AttributeMetadata *att_metadata = + mesh_metadata->GetAttributeMetadataByStringEntry("name", "added_edges"); + if (att_metadata) { + const auto att = + in_mesh_->GetAttributeByUniqueId(att_metadata->att_unique_id()); + if (att->size() == 0 || att->num_components() != 1 || + att->data_type() != DataType::DT_UINT8) { + return false; + } + added_edges_att_ = att; + return true; + } + } + + return true; +} + bool ObjEncoder::GetSubObjects() { const GeometryMetadata *pc_metadata = in_point_cloud_->GetMetadata(); if (!pc_metadata) { @@ -137,7 +170,8 @@ bool ObjEncoder::GetSubObjects() { } sub_obj_att_ = in_point_cloud_->GetAttributeByUniqueId( sub_obj_metadata->att_unique_id()); - if (sub_obj_att_ == nullptr || sub_obj_att_->size() == 0) { + if (sub_obj_att_ == nullptr || sub_obj_att_->size() == 0 || + sub_obj_att_->num_components() != 1) { return false; } return true; @@ -236,17 +270,11 @@ bool ObjEncoder::EncodeNormals() { } bool ObjEncoder::EncodeFaces() { + if (added_edges_att_ != nullptr) { + return EncodePolygonalFaces(); + } for (FaceIndex i(0); i < in_mesh_->num_faces(); ++i) { - if (sub_obj_att_) { - if (!EncodeSubObject(i)) { - return false; - } - } - if (material_att_) { - if (!EncodeMaterial(i)) { - return false; - } - } + EncodeFaceAttributes(i); buffer()->Encode('f'); for (int j = 0; j < 3; ++j) { if (!EncodeFaceCorner(i, j)) { @@ -258,6 +286,56 @@ bool ObjEncoder::EncodeFaces() { return true; } +bool ObjEncoder::EncodePolygonalFaces() { + // TODO(vytyaz): This could be a much smaller set of visited face indices. + std::vector triangle_visited(in_mesh_->num_faces(), false); + PolygonEdges polygon_edges; + std::unique_ptr corner_table = + CreateCornerTableFromPositionAttribute(in_mesh_); + for (FaceIndex fi(0); fi < in_mesh_->num_faces(); ++fi) { + EncodeFaceAttributes(fi); + // Reconstruct polygon from the added edges attribute if available. + polygon_edges.clear(); + FindOriginalFaceEdges(fi, *corner_table, &triangle_visited, &polygon_edges); + + // Polygon edges could be empty if this triangle has been visited as part + // of a polygon discovery that started from an earler face. + if (polygon_edges.empty()) { + continue; + } + + // Traverse a polygon by following its edges. The starting point is not + // guaranteed to be the same as in the original polygon. It is + // deterministic, however, and defined by std::map behavior. + const AttributeValueIndex first_position_index = + polygon_edges.begin()->first; + AttributeValueIndex position_index = first_position_index; + buffer()->Encode('f'); + do { + // Get the next polygon point index by following polygon edge. + const PointIndex pi = polygon_edges[position_index]; + EncodeFaceCorner(pi); + position_index = pos_att_->mapped_index(pi).value(); + } while (position_index != first_position_index); + buffer()->Encode("\n", 1); + } + return true; +} + +bool ObjEncoder::EncodeFaceAttributes(FaceIndex face_id) { + if (sub_obj_att_) { + if (!EncodeSubObject(face_id)) { + return false; + } + } + if (material_att_) { + if (!EncodeMaterial(face_id)) { + return false; + } + } + return true; +} + bool ObjEncoder::EncodeMaterial(FaceIndex face_id) { int material_id = 0; // Pick the first corner, all corners of a face should have same id. @@ -304,8 +382,12 @@ bool ObjEncoder::EncodeSubObject(FaceIndex face_id) { } bool ObjEncoder::EncodeFaceCorner(FaceIndex face_id, int local_corner_id) { - buffer()->Encode(' '); const PointIndex vert_index = in_mesh_->face(face_id)[local_corner_id]; + return EncodeFaceCorner(vert_index); +} + +bool ObjEncoder::EncodeFaceCorner(PointIndex vert_index) { + buffer()->Encode(' '); // Note that in the OBJ format, all indices are encoded starting from index 1. // Encode position index. EncodeInt(pos_att_->mapped_index(vert_index).value() + 1); @@ -343,4 +425,67 @@ void ObjEncoder::EncodeInt(int32_t val) { buffer()->Encode(num_buffer_, strlen(num_buffer_)); } +bool ObjEncoder::IsNewEdge(const CornerTable &ct, CornerIndex ci) const { + const PointIndex pi = in_mesh_->CornerToPointId(ci); + if (added_edges_att_ != nullptr) { + uint8_t value; + added_edges_att_->GetMappedValue(pi, &value); + return value == 1; + } + return false; +} + +void ObjEncoder::FindOriginalFaceEdges(FaceIndex face_index, + const CornerTable &corner_table, + std::vector *triangle_visited, + PolygonEdges *polygon_edges) { + // Do not add any edges if this triangular face has already been visited. + if ((*triangle_visited)[face_index.value()]) { + return; + } + (*triangle_visited)[face_index.value()] = true; + const Mesh::Face &face = in_mesh_->face(face_index); + for (size_t c = 0; c < 3; c++) { + // Check for added edge using this corner. + const CornerIndex ci = corner_table.FirstCorner(face_index) + c; + const CornerIndex co = corner_table.Opposite(ci); + bool is_new_edge = IsNewEdge(corner_table, ci); + + // Check for the new edge using the opposite corner. + if (!is_new_edge && co != kInvalidCornerIndex) { + is_new_edge = IsNewEdge(corner_table, co); + } + // The new edge may become a boundary edge when a degenerate triangle + // created by polygon triangulation is removed by Draco encoder, hence |co| + // is checked below. This can happen when an isolated (boundary) quad only + // has three distinct vertex positions. + // + // TODO(vytyaz): Fix polygon reconstruction with other possible cases of + // degenerate triangles. There are two known sources of degenerate triangles + // that affect polygon reconstruction: + // + // 1. Degenerate triangles created during polygon triangulation are removed + // by Draco encoder, which invalidates the "added_edges" attribute. + // Solution is to discard those triangles before creating the attribute. + // + // 2. Degenerate triangles created by position quantization are encoded and + // decoded by Draco, but not captured into the |corner_table|, causing a + // mismatch between the corner table and the "added_edges" attribute. + // Solution is to use corner table from draco::MeshDecoder here. + // + if (is_new_edge && co != kInvalidCornerIndex) { + // Visit triangle across the new edge. + const FaceIndex opposite_face_index = corner_table.Face(co); + FindOriginalFaceEdges(opposite_face_index, corner_table, triangle_visited, + polygon_edges); + } else { + // Insert the original edge to the map. + const PointIndex point_from = face[(c + 1) % 3]; + const PointIndex point_to = face[(c + 2) % 3]; + polygon_edges->insert( + {PositionIndex(pos_att_->mapped_index(point_from)), point_to}); + } + } +} + } // namespace draco diff --git a/contrib/draco/src/draco/io/obj_encoder.h b/contrib/draco/src/draco/io/obj_encoder.h index 509d39baf..1d67b5306 100644 --- a/contrib/draco/src/draco/io/obj_encoder.h +++ b/contrib/draco/src/draco/io/obj_encoder.h @@ -18,6 +18,7 @@ #include #include "draco/core/encoder_buffer.h" +#include "draco/mesh/corner_table.h" #include "draco/mesh/mesh.h" namespace draco { @@ -44,19 +45,30 @@ class ObjEncoder { bool ExitAndCleanup(bool return_value); private: + typedef AttributeValueIndex PositionIndex; + typedef std::map PolygonEdges; + bool GetAddedEdges(); bool GetSubObjects(); bool EncodeMaterialFileName(); bool EncodePositions(); bool EncodeTextureCoordinates(); bool EncodeNormals(); bool EncodeFaces(); + bool EncodePolygonalFaces(); + bool EncodeFaceAttributes(FaceIndex face_id); bool EncodeSubObject(FaceIndex face_id); bool EncodeMaterial(FaceIndex face_id); bool EncodeFaceCorner(FaceIndex face_id, int local_corner_id); + bool EncodeFaceCorner(PointIndex vert_index); void EncodeFloat(float val); void EncodeFloatList(float *vals, int num_vals); void EncodeInt(int32_t val); + bool IsNewEdge(const CornerTable &ct, CornerIndex ci) const; + void FindOriginalFaceEdges(FaceIndex face_index, + const CornerTable &corner_table, + std::vector *triangle_visited, + PolygonEdges *polygon_edges); // Various attributes used by the encoder. If an attribute is not used, it is // set to nullptr. @@ -66,6 +78,9 @@ class ObjEncoder { const PointAttribute *material_att_; const PointAttribute *sub_obj_att_; + // Stores per-corner triangulation information for polygon reconstruction. + const PointAttribute *added_edges_att_; + // Buffer used for encoding float/int numbers. char num_buffer_[20]; diff --git a/contrib/draco/src/draco/io/obj_encoder_test.cc b/contrib/draco/src/draco/io/obj_encoder_test.cc index 4838e56ca..782983fad 100644 --- a/contrib/draco/src/draco/io/obj_encoder_test.cc +++ b/contrib/draco/src/draco/io/obj_encoder_test.cc @@ -16,10 +16,12 @@ #include +#include "draco/attributes/geometry_attribute.h" #include "draco/core/draco_test_base.h" #include "draco/core/draco_test_utils.h" #include "draco/io/file_reader_factory.h" #include "draco/io/file_reader_interface.h" +#include "draco/io/file_utils.h" #include "draco/io/obj_decoder.h" namespace draco { @@ -27,6 +29,8 @@ namespace draco { class ObjEncoderTest : public ::testing::Test { protected: void CompareMeshes(const Mesh *mesh0, const Mesh *mesh1) { + ASSERT_NE(mesh0, nullptr); + ASSERT_NE(mesh1, nullptr); ASSERT_EQ(mesh0->num_faces(), mesh1->num_faces()); ASSERT_EQ(mesh0->num_attributes(), mesh1->num_attributes()); for (size_t att_id = 0; att_id < mesh0->num_attributes(); ++att_id) { @@ -107,4 +111,34 @@ TEST_F(ObjEncoderTest, TestObjEncodingAll) { test_encoding("two_faces_312.obj"); } +TEST_F(ObjEncoderTest, TestObjOctagonPreserved) { + // Test verifies that OBJ encoder can reconstruct and encode an octagon. + // Decode triangulated octagon and an extra attribute for reconstruction. + std::unique_ptr mesh = + ReadMeshFromTestFile("octagon_preserved.drc"); + ASSERT_NE(mesh, nullptr); + ASSERT_EQ(mesh->num_faces(), 6); + ASSERT_EQ(mesh->NumNamedAttributes(GeometryAttribute::GENERIC), 1); + ASSERT_NE(mesh->GetMetadata()->GetAttributeMetadataByStringEntry( + "name", "added_edges"), + nullptr); + + // Reconstruct octagon and encode it into an OBJ file. + draco::ObjEncoder obj_encoder; + ASSERT_TRUE(obj_encoder.EncodeToFile( + *mesh, draco::GetTestTempFileFullPath("encoded.obj"))); + + // Read encoded OBJ file and golden OBJ file contents into buffers. + std::vector data_encoded; + std::vector data_golden; + ASSERT_TRUE( + ReadFileToBuffer(GetTestTempFileFullPath("encoded.obj"), &data_encoded)); + ASSERT_TRUE(ReadFileToBuffer(GetTestFileFullPath("octagon_preserved.obj"), + &data_golden)); + + // Check that encoded OBJ file contents are correct. + ASSERT_EQ(data_encoded.size(), data_golden.size()); + ASSERT_EQ(data_encoded, data_golden); +} + } // namespace draco diff --git a/contrib/draco/src/draco/io/parser_utils.cc b/contrib/draco/src/draco/io/parser_utils.cc index 12afacff6..378de7378 100644 --- a/contrib/draco/src/draco/io/parser_utils.cc +++ b/contrib/draco/src/draco/io/parser_utils.cc @@ -203,31 +203,40 @@ void ParseLine(DecoderBuffer *buffer, std::string *out_string) { out_string->clear(); } char c; - bool delim_reached = false; + int num_delims = 0; + char last_delim; while (buffer->Peek(&c)) { - // Check if |c| is a delimeter. We want to parse all delimeters until we - // reach a non-delimeter symbol. (E.g. we want to ignore '\r\n' at the end - // of the line). + // Check if |c| is a delimiter symbol. We want to identify all possible + // delimiters that can occur on different platforms (i.e. we want to detect + // '\r\n', '\r', '\n'). const bool is_delim = (c == '\r' || c == '\n'); - // If |c| is a delimeter or it is a non-delimeter symbol before any - // delimeter was found, we advance the buffer to the next character. - if (is_delim || !delim_reached) { - buffer->Advance(1); + if (is_delim) { + if (num_delims == 0) { + last_delim = c; + } else if (num_delims == 1) { + // We already parsed either '\r' or '\n'. Ensure the new delim symbol is + // '\n' and different from the previous symbol. + if (c == last_delim || c != '\n') { + return; // Same delimiter symbol already processed. + } + } else { + // Too many delimiter symbols. + return; + } + num_delims++; } - if (is_delim) { - // Mark that we found a delimeter symbol. - delim_reached = true; - continue; - } - if (delim_reached) { - // We reached a non-delimeter symbol after a delimeter was already found. + if (!is_delim && num_delims > 0) { + // We reached a non-delimiter symbol after a delimiter was already found. // Stop the parsing. return; } - // Otherwise we put the non-delimeter symbol into the output string. - if (out_string) { + + buffer->Advance(1); + + // We put the non-delimiter symbol into the output string. + if (!is_delim && out_string) { out_string->push_back(c); } } diff --git a/contrib/draco/src/draco/io/ply_decoder_test.cc b/contrib/draco/src/draco/io/ply_decoder_test.cc index 97977c8cc..1dd70d5cb 100644 --- a/contrib/draco/src/draco/io/ply_decoder_test.cc +++ b/contrib/draco/src/draco/io/ply_decoder_test.cc @@ -88,6 +88,7 @@ TEST_F(PlyDecoderTest, TestPlyDecodingAll) { // test_decoding("test_pos_color.ply"); // tested test_decoding("cube_quads.ply"); test_decoding("Box.ply"); + test_decoding("delim_test.ply"); } } // namespace draco diff --git a/contrib/draco/src/draco/io/ply_encoder.cc b/contrib/draco/src/draco/io/ply_encoder.cc index 2f6a1a2a8..0fe611f1c 100644 --- a/contrib/draco/src/draco/io/ply_encoder.cc +++ b/contrib/draco/src/draco/io/ply_encoder.cc @@ -143,7 +143,8 @@ bool PlyEncoder::EncodeInternal() { buffer()->Encode(header_str.data(), header_str.length()); // Store point attributes. - for (PointIndex v(0); v < in_point_cloud_->num_points(); ++v) { + const int num_points = in_point_cloud_->num_points(); + for (PointIndex v(0); v < num_points; ++v) { const auto *const pos_att = in_point_cloud_->attribute(pos_att_id); buffer()->Encode(pos_att->GetAddress(pos_att->mapped_index(v)), pos_att->byte_stride()); @@ -166,9 +167,13 @@ bool PlyEncoder::EncodeInternal() { buffer()->Encode(static_cast(3)); const auto &f = in_mesh_->face(i); - buffer()->Encode(f[0]); - buffer()->Encode(f[1]); - buffer()->Encode(f[2]); + for (int c = 0; c < 3; ++c) { + if (f[c] >= num_points) { + // Invalid point stored on the |in_mesh_| face. + return false; + } + buffer()->Encode(f[c]); + } if (tex_coord_att_id >= 0) { // Two coordinates for every corner -> 6. diff --git a/contrib/draco/src/draco/io/ply_reader_test.cc b/contrib/draco/src/draco/io/ply_reader_test.cc index 05ff63dd4..9612f6377 100644 --- a/contrib/draco/src/draco/io/ply_reader_test.cc +++ b/contrib/draco/src/draco/io/ply_reader_test.cc @@ -39,7 +39,7 @@ TEST_F(PlyReaderTest, TestReader) { buf.Init(data.data(), data.size()); PlyReader reader; Status status = reader.Read(&buf); - ASSERT_TRUE(status.ok()) << status; + DRACO_ASSERT_OK(status); ASSERT_EQ(reader.num_elements(), 2); ASSERT_EQ(reader.element(0).num_properties(), 7); ASSERT_EQ(reader.element(1).num_properties(), 1); @@ -64,14 +64,14 @@ TEST_F(PlyReaderTest, TestReaderAscii) { buf.Init(data.data(), data.size()); PlyReader reader; Status status = reader.Read(&buf); - ASSERT_TRUE(status.ok()) << status; + DRACO_ASSERT_OK(status); const std::string file_name_ascii = "test_pos_color_ascii.ply"; const std::vector data_ascii = ReadPlyFile(file_name_ascii); buf.Init(data_ascii.data(), data_ascii.size()); PlyReader reader_ascii; status = reader_ascii.Read(&buf); - ASSERT_TRUE(status.ok()) << status; + DRACO_ASSERT_OK(status); ASSERT_EQ(reader.num_elements(), reader_ascii.num_elements()); ASSERT_EQ(reader.element(0).num_properties(), reader_ascii.element(0).num_properties()); @@ -96,7 +96,7 @@ TEST_F(PlyReaderTest, TestReaderExtraWhitespace) { buf.Init(data.data(), data.size()); PlyReader reader; Status status = reader.Read(&buf); - ASSERT_TRUE(status.ok()) << status; + DRACO_ASSERT_OK(status); ASSERT_EQ(reader.num_elements(), 2); ASSERT_EQ(reader.element(0).num_properties(), 7); @@ -122,7 +122,7 @@ TEST_F(PlyReaderTest, TestReaderMoreDataTypes) { buf.Init(data.data(), data.size()); PlyReader reader; Status status = reader.Read(&buf); - ASSERT_TRUE(status.ok()) << status; + DRACO_ASSERT_OK(status); ASSERT_EQ(reader.num_elements(), 2); ASSERT_EQ(reader.element(0).num_properties(), 7); diff --git a/contrib/draco/src/draco/io/scene_io.cc b/contrib/draco/src/draco/io/scene_io.cc new file mode 100644 index 000000000..e41d2e1fa --- /dev/null +++ b/contrib/draco/src/draco/io/scene_io.cc @@ -0,0 +1,127 @@ +// Copyright 2019 The Draco Authors. +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. +// +#include "draco/io/scene_io.h" + +#include + +#ifdef DRACO_TRANSCODER_SUPPORTED +#include "draco/io/file_utils.h" +#include "draco/io/gltf_decoder.h" +#include "draco/io/gltf_encoder.h" +#include "draco/io/obj_encoder.h" +#include "draco/io/ply_encoder.h" + +namespace draco { + +enum SceneFileFormat { UNKNOWN, GLTF, USD, PLY, OBJ }; + +SceneFileFormat GetSceneFileFormat(const std::string &file_name) { + const std::string extension = LowercaseFileExtension(file_name); + if (extension == "gltf" || extension == "glb") { + return GLTF; + } + if (extension == "usd" || extension == "usda" || extension == "usdc" || + extension == "usdz") { + return USD; + } + if (extension == "obj") { + return OBJ; + } + if (extension == "ply") { + return PLY; + } + return UNKNOWN; +} + +StatusOr> ReadSceneFromFile( + const std::string &file_name) { + return ReadSceneFromFile(file_name, nullptr); +} + +StatusOr> ReadSceneFromFile( + const std::string &file_name, std::vector *scene_files) { + std::unique_ptr scene(new Scene()); + switch (GetSceneFileFormat(file_name)) { + case GLTF: { + GltfDecoder decoder; + return decoder.DecodeFromFileToScene(file_name, scene_files); + } + case USD: { + return Status(Status::DRACO_ERROR, "USD is not supported yet."); + } + default: { + return Status(Status::DRACO_ERROR, "Unknown input file format."); + } + } +} + +Status WriteSceneToFile(const std::string &file_name, const Scene &scene) { + Options options; + return WriteSceneToFile(file_name, scene, options); +} + +Status WriteSceneToFile(const std::string &file_name, const Scene &scene, + const Options &options) { + const std::string extension = LowercaseFileExtension(file_name); + std::string folder_path; + std::string out_file_name; + draco::SplitPath(file_name, &folder_path, &out_file_name); + const auto format = GetSceneFileFormat(file_name); + switch (format) { + case GLTF: { + GltfEncoder encoder; + if (!encoder.EncodeToFile(scene, file_name, folder_path)) { + return Status(Status::DRACO_ERROR, "Failed to encode the scene."); + } + return OkStatus(); + } + case USD: { + return Status(Status::DRACO_ERROR, "USD is not supported yet."); + } + case PLY: + case OBJ: { + // Convert the scene to mesh and save the scene as a mesh. For now we do + // that by converting the scene to GLB and decoding the GLB into a mesh. + GltfEncoder gltf_encoder; + EncoderBuffer buffer; + DRACO_RETURN_IF_ERROR(gltf_encoder.EncodeToBuffer(scene, &buffer)); + GltfDecoder gltf_decoder; + DecoderBuffer dec_buffer; + dec_buffer.Init(buffer.data(), buffer.size()); + DRACO_ASSIGN_OR_RETURN(auto mesh, + gltf_decoder.DecodeFromBuffer(&dec_buffer)); + if (format == PLY) { + PlyEncoder ply_encoder; + if (!ply_encoder.EncodeToFile(*mesh, file_name)) { + return ErrorStatus("Failed to encode the scene as PLY."); + } + } + if (format == OBJ) { + ObjEncoder obj_encoder; + if (!obj_encoder.EncodeToFile(*mesh, file_name)) { + return ErrorStatus("Failed to encode the scene as OBJ."); + } + } + return OkStatus(); + } + default: { + return Status(Status::DRACO_ERROR, "Unknown output file format."); + } + } +} + +} // namespace draco + +#endif // DRACO_TRANSCODER_SUPPORTED diff --git a/contrib/draco/src/draco/io/scene_io.h b/contrib/draco/src/draco/io/scene_io.h new file mode 100644 index 000000000..964faac3c --- /dev/null +++ b/contrib/draco/src/draco/io/scene_io.h @@ -0,0 +1,55 @@ +// Copyright 2019 The Draco Authors. +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. +// +#ifndef DRACO_IO_SCENE_IO_H_ +#define DRACO_IO_SCENE_IO_H_ + +#include "draco/draco_features.h" + +#ifdef DRACO_TRANSCODER_SUPPORTED +#include +#include + +#include "draco/core/options.h" +#include "draco/core/status_or.h" +#include "draco/scene/scene.h" + +namespace draco { + +// Reads a scene from a file. Currently only GLTF 2.0 scene files are supported. +// The second form returns the files associated with the scene via the +// |scene_files| argument. +StatusOr> ReadSceneFromFile( + const std::string &file_name); +StatusOr> ReadSceneFromFile( + const std::string &file_name, std::vector *scene_files); + +// Writes a scene into a file. +Status WriteSceneToFile(const std::string &file_name, const Scene &scene); + +// Writes a scene into a file, configurable with |options|. +// +// Supported options: +// +// force_usd_vertex_interpolation= - forces implicit vertex +// interpolation while exporting to USD +// (default = false) +// +Status WriteSceneToFile(const std::string &file_name, const Scene &scene, + const Options &options); + +} // namespace draco + +#endif // DRACO_TRANSCODER_SUPPORTED +#endif // DRACO_IO_SCENE_IO_H_ diff --git a/contrib/draco/src/draco/io/scene_io_test.cc b/contrib/draco/src/draco/io/scene_io_test.cc new file mode 100644 index 000000000..828065693 --- /dev/null +++ b/contrib/draco/src/draco/io/scene_io_test.cc @@ -0,0 +1,86 @@ +// Copyright 2019 The Draco Authors. +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. +// +#include "draco/io/scene_io.h" + +#include +#include + +#ifdef DRACO_TRANSCODER_SUPPORTED +#include "draco/core/draco_test_utils.h" +#include "draco/io/file_utils.h" +#include "draco/io/mesh_io.h" + +namespace { + +TEST(SceneTest, TestSceneIO) { + // A simple test that verifies that the scene is loaded and saved using the + // scene_io.h API. + const std::string file_name = + draco::GetTestFileFullPath("CesiumMilkTruck/glTF/CesiumMilkTruck.gltf"); + draco::StatusOr> maybe_scene = + draco::ReadSceneFromFile(file_name); + ASSERT_TRUE(maybe_scene.status().ok()); + std::unique_ptr scene = std::move(maybe_scene).value(); + ASSERT_NE(scene, nullptr); + + const std::string out_file_name = + draco::GetTestTempFileFullPath("out_scene.gltf"); + ASSERT_TRUE(draco::WriteSceneToFile(out_file_name, *scene).ok()); + + // Ensure all files related to the scene are saved. + ASSERT_GT(draco::GetFileSize(out_file_name), 0); + ASSERT_GT( + draco::GetFileSize(draco::GetTestTempFileFullPath("CesiumMilkTruck.png")), + 0); + ASSERT_GT(draco::GetFileSize(draco::GetTestTempFileFullPath("buffer0.bin")), + 0); +} + +TEST(SceneTest, TestSaveToPly) { + // A simple test that verifies that a loaded scene can be stored in a PLY file + // format. + const std::string file_name = + draco::GetTestFileFullPath("CesiumMilkTruck/glTF/CesiumMilkTruck.gltf"); + DRACO_ASSIGN_OR_ASSERT(std::unique_ptr scene, + draco::ReadSceneFromFile(file_name)); + + const std::string out_file_name = + draco::GetTestTempFileFullPath("out_scene.ply"); + DRACO_ASSERT_OK(draco::WriteSceneToFile(out_file_name, *scene)); + + // Verify that we can read the saved mesh. + DRACO_ASSIGN_OR_ASSERT(auto mesh, draco::ReadMeshFromFile(out_file_name)); + ASSERT_NE(mesh, nullptr); +} + +TEST(SceneTest, TestSaveToObj) { + // A simple test that verifies that a loaded scene can be stored in an OBJ + // file format. + const std::string file_name = + draco::GetTestFileFullPath("CesiumMilkTruck/glTF/CesiumMilkTruck.gltf"); + DRACO_ASSIGN_OR_ASSERT(std::unique_ptr scene, + draco::ReadSceneFromFile(file_name)); + + const std::string out_file_name = + draco::GetTestTempFileFullPath("out_scene.obj"); + DRACO_ASSERT_OK(draco::WriteSceneToFile(out_file_name, *scene)); + + // Verify that we can read the saved mesh. + DRACO_ASSIGN_OR_ASSERT(auto mesh, draco::ReadMeshFromFile(out_file_name)); + ASSERT_NE(mesh, nullptr); +} + +} // namespace +#endif // DRACO_TRANSCODER_SUPPORTED diff --git a/contrib/draco/src/draco/io/stdio_file_reader_test.cc b/contrib/draco/src/draco/io/stdio_file_reader_test.cc index 487819a02..212945f90 100644 --- a/contrib/draco/src/draco/io/stdio_file_reader_test.cc +++ b/contrib/draco/src/draco/io/stdio_file_reader_test.cc @@ -9,7 +9,7 @@ namespace { TEST(StdioFileReaderTest, FailOpen) { EXPECT_EQ(StdioFileReader::Open(""), nullptr); - EXPECT_EQ(StdioFileReader::Open("fake file"), nullptr); + EXPECT_EQ(StdioFileReader::Open("stdio reader fake file"), nullptr); } TEST(StdioFileReaderTest, Open) { diff --git a/contrib/draco/src/draco/io/stl_decoder.cc b/contrib/draco/src/draco/io/stl_decoder.cc new file mode 100644 index 000000000..1e5d3a938 --- /dev/null +++ b/contrib/draco/src/draco/io/stl_decoder.cc @@ -0,0 +1,77 @@ +// Copyright 2022 The Draco Authors. +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. +// +#include "draco/io/stl_decoder.h" + +#include + +#include "draco/core/macros.h" +#include "draco/core/status.h" +#include "draco/core/status_or.h" +#include "draco/io/file_utils.h" +#include "draco/mesh/triangle_soup_mesh_builder.h" + +namespace draco { + +StatusOr> StlDecoder::DecodeFromFile( + const std::string &file_name) { + std::vector data; + if (!ReadFileToBuffer(file_name, &data)) { + return Status(Status::IO_ERROR, "Unable to read input file."); + } + DecoderBuffer buffer; + buffer.Init(data.data(), data.size()); + return DecodeFromBuffer(&buffer); +} + +StatusOr> StlDecoder::DecodeFromBuffer( + DecoderBuffer *buffer) { + if (!strncmp(buffer->data_head(), "solid ", 6)) { + return Status(Status::IO_ERROR, + "Currently only binary STL files are supported."); + } + buffer->Advance(80); + uint32_t face_count; + buffer->Decode(&face_count, 4); + + TriangleSoupMeshBuilder builder; + builder.Start(face_count); + + const int32_t pos_att_id = + builder.AddAttribute(GeometryAttribute::POSITION, 3, DT_FLOAT32); + const int32_t norm_att_id = + builder.AddAttribute(GeometryAttribute::NORMAL, 3, DT_FLOAT32); + + for (uint32_t i = 0; i < face_count; i++) { + float data[48]; + buffer->Decode(data, 48); + uint16_t unused; + buffer->Decode(&unused, 2); + + builder.SetPerFaceAttributeValueForFace( + norm_att_id, draco::FaceIndex(i), + draco::Vector3f(data[0], data[1], data[2]).data()); + + builder.SetAttributeValuesForFace( + pos_att_id, draco::FaceIndex(i), + draco::Vector3f(data[3], data[4], data[5]).data(), + draco::Vector3f(data[6], data[7], data[8]).data(), + draco::Vector3f(data[9], data[10], data[11]).data()); + } + + std::unique_ptr mesh = builder.Finalize(); + return mesh; +} + +} // namespace draco diff --git a/contrib/draco/src/draco/io/stl_decoder.h b/contrib/draco/src/draco/io/stl_decoder.h new file mode 100644 index 000000000..44b35d849 --- /dev/null +++ b/contrib/draco/src/draco/io/stl_decoder.h @@ -0,0 +1,38 @@ +// Copyright 2022 The Draco Authors. +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. +// +#ifndef DRACO_IO_STL_DECODER_H_ +#define DRACO_IO_STL_DECODER_H_ + +#include + +#include "draco/core/decoder_buffer.h" +#include "draco/core/status.h" +#include "draco/core/status_or.h" +#include "draco/draco_features.h" +#include "draco/mesh/mesh.h" + +namespace draco { + +// Decodes an STL file into draco::Mesh (or draco::PointCloud if the +// connectivity data is not needed). +class StlDecoder { + public: + StatusOr> DecodeFromFile(const std::string &file_name); + StatusOr> DecodeFromBuffer(DecoderBuffer *buffer); +}; + +} // namespace draco + +#endif // DRACO_IO_STL_DECODER_H_ diff --git a/contrib/draco/src/draco/io/stl_decoder_test.cc b/contrib/draco/src/draco/io/stl_decoder_test.cc new file mode 100644 index 000000000..886881925 --- /dev/null +++ b/contrib/draco/src/draco/io/stl_decoder_test.cc @@ -0,0 +1,49 @@ +// Copyright 2022 The Draco Authors. +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. +// +#include "draco/io/stl_decoder.h" + +#include + +#include "draco/core/draco_test_base.h" +#include "draco/core/draco_test_utils.h" + +namespace draco { + +class StlDecoderTest : public ::testing::Test { + protected: + void test_decoding(const std::string &file_name) { + const std::string path = GetTestFileFullPath(file_name); + StlDecoder decoder; + DRACO_ASSIGN_OR_ASSERT(std::unique_ptr mesh, + decoder.DecodeFromFile(path)); + ASSERT_GT(mesh->num_faces(), 0); + ASSERT_GT(mesh->num_points(), 0); + } + + void test_decoding_should_fail(const std::string &file_name) { + StlDecoder decoder; + StatusOr> statusOrMesh = + decoder.DecodeFromFile(GetTestFileFullPath(file_name)); + ASSERT_FALSE(statusOrMesh.ok()); + } +}; + +TEST_F(StlDecoderTest, TestStlDecoding) { + test_decoding("STL/bunny.stl"); + test_decoding("STL/test_sphere.stl"); + test_decoding_should_fail("STL/test_sphere_ascii.stl"); +} + +} // namespace draco diff --git a/contrib/draco/src/draco/io/stl_encoder.cc b/contrib/draco/src/draco/io/stl_encoder.cc new file mode 100644 index 000000000..5aa4a0a97 --- /dev/null +++ b/contrib/draco/src/draco/io/stl_encoder.cc @@ -0,0 +1,111 @@ +// Copyright 2022 The Draco Authors. +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. +// +#include "draco/io/stl_encoder.h" + +#include +#include +#include +#include + +#include "draco/io/file_writer_factory.h" +#include "draco/io/file_writer_interface.h" + +namespace draco { + +StlEncoder::StlEncoder() + : out_buffer_(nullptr), in_point_cloud_(nullptr), in_mesh_(nullptr) {} + +Status StlEncoder::EncodeToFile(const Mesh &mesh, + const std::string &file_name) { + in_mesh_ = &mesh; + std::unique_ptr file = + FileWriterFactory::OpenWriter(file_name); + if (!file) { + return Status(Status::IO_ERROR, "File couldn't be opened"); + } + // Encode the mesh into a buffer. + EncoderBuffer buffer; + DRACO_RETURN_IF_ERROR(EncodeToBuffer(mesh, &buffer)); + // Write the buffer into the file. + file->Write(buffer.data(), buffer.size()); + return OkStatus(); +} + +Status StlEncoder::EncodeToBuffer(const Mesh &mesh, EncoderBuffer *out_buffer) { + in_mesh_ = &mesh; + out_buffer_ = out_buffer; + Status s = EncodeInternal(); + in_mesh_ = nullptr; // cleanup + in_point_cloud_ = nullptr; + out_buffer_ = nullptr; + return s; +} + +Status StlEncoder::EncodeInternal() { + // Write STL header. + std::stringstream out; + out << std::left << std::setw(80) + << "generated using Draco"; // header is 80 bytes fixed size. + const std::string header_str = out.str(); + buffer()->Encode(header_str.data(), header_str.length()); + + uint32_t num_faces = in_mesh_->num_faces(); + buffer()->Encode(&num_faces, 4); + + std::vector stl_face; + + const int pos_att_id = + in_mesh_->GetNamedAttributeId(GeometryAttribute::POSITION); + + if (pos_att_id < 0) { + return ErrorStatus("Mesh is missing the position attribute."); + } + + if (in_mesh_->attribute(pos_att_id)->data_type() != DT_FLOAT32) { + return ErrorStatus("Mesh position attribute is not of type float32."); + } + + uint16_t unused = 0; + + if (in_mesh_) { + for (FaceIndex i(0); i < in_mesh_->num_faces(); ++i) { + const auto &f = in_mesh_->face(i); + const auto *const pos_att = in_mesh_->attribute(pos_att_id); + + // The normal attribute can contain arbitrary normals that may not + // correspond to the winding of the face. + // Therefor we simply always calculate them + // using the points of the triangle face: norm(cross(p2-p1, p3-p1)) + + Vector3f pos[3]; + pos_att->GetMappedValue(f[0], &pos[0][0]); + pos_att->GetMappedValue(f[1], &pos[1][0]); + pos_att->GetMappedValue(f[2], &pos[2][0]); + Vector3f norm = CrossProduct(pos[1] - pos[0], pos[2] - pos[0]); + norm.Normalize(); + buffer()->Encode(norm.data(), sizeof(float) * 3); + + for (int c = 0; c < 3; ++c) { + buffer()->Encode(pos_att->GetAddress(pos_att->mapped_index(f[c])), + pos_att->byte_stride()); + } + + buffer()->Encode(&unused, 2); + } + } + return OkStatus(); +} + +} // namespace draco diff --git a/contrib/draco/src/draco/io/stl_encoder.h b/contrib/draco/src/draco/io/stl_encoder.h new file mode 100644 index 000000000..8b185b738 --- /dev/null +++ b/contrib/draco/src/draco/io/stl_encoder.h @@ -0,0 +1,52 @@ +// Copyright 2022 The Draco Authors. +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. +// +#ifndef DRACO_IO_STL_ENCODER_H_ +#define DRACO_IO_STL_ENCODER_H_ + +#include + +#include "draco/core/encoder_buffer.h" +#include "draco/draco_features.h" +#include "draco/mesh/mesh.h" + +namespace draco { + +// Class for encoding draco::Mesh into the STL file format. +class StlEncoder { + public: + StlEncoder(); + + // Encodes the mesh and saves it into a file. + // Returns false when either the encoding failed or when the file couldn't be + // opened. + Status EncodeToFile(const Mesh &mesh, const std::string &file_name); + + // Encodes the mesh into a buffer. + Status EncodeToBuffer(const Mesh &mesh, EncoderBuffer *out_buffer); + + protected: + Status EncodeInternal(); + EncoderBuffer *buffer() const { return out_buffer_; } + + private: + EncoderBuffer *out_buffer_; + + const PointCloud *in_point_cloud_; + const Mesh *in_mesh_; +}; + +} // namespace draco + +#endif // DRACO_IO_STL_ENCODER_H_ diff --git a/contrib/draco/src/draco/io/stl_encoder_test.cc b/contrib/draco/src/draco/io/stl_encoder_test.cc new file mode 100644 index 000000000..da6298d64 --- /dev/null +++ b/contrib/draco/src/draco/io/stl_encoder_test.cc @@ -0,0 +1,78 @@ +// Copyright 2022 The Draco Authors. +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. +// +#include "draco/io/stl_encoder.h" + +#include +#include +#include + +#include "draco/core/draco_test_base.h" +#include "draco/core/draco_test_utils.h" +#include "draco/io/file_reader_factory.h" +#include "draco/io/file_reader_interface.h" +#include "draco/io/stl_decoder.h" + +namespace draco { + +class StlEncoderTest : public ::testing::Test { + protected: + void CompareMeshes(const Mesh *mesh0, const Mesh *mesh1) { + ASSERT_EQ(mesh0->num_faces(), mesh1->num_faces()); + ASSERT_EQ(mesh0->num_attributes(), mesh1->num_attributes()); + for (size_t att_id = 0; att_id < mesh0->num_attributes(); ++att_id) { + ASSERT_EQ(mesh0->attribute(att_id)->size(), + mesh1->attribute(att_id)->size()); + } + } + + // Encode a mesh using the StlEncoder and then decode to verify the encoding. + std::unique_ptr EncodeAndDecodeMesh(const Mesh *mesh) { + EncoderBuffer encoder_buffer; + StlEncoder encoder; + Status status = encoder.EncodeToBuffer(*mesh, &encoder_buffer); + if (!status.ok()) { + return nullptr; + } + + DecoderBuffer decoder_buffer; + decoder_buffer.Init(encoder_buffer.data(), encoder_buffer.size()); + StlDecoder decoder; + StatusOr> status_or_mesh = + decoder.DecodeFromBuffer(&decoder_buffer); + if (!status_or_mesh.ok()) { + return nullptr; + } + std::unique_ptr decoded_mesh = std::move(status_or_mesh).value(); + return decoded_mesh; + } + + void test_encoding(const std::string &file_name) { + const std::unique_ptr mesh(ReadMeshFromTestFile(file_name, true)); + + ASSERT_NE(mesh, nullptr) << "Failed to load test model " << file_name; + ASSERT_GT(mesh->num_faces(), 0); + + const std::unique_ptr decoded_mesh = EncodeAndDecodeMesh(mesh.get()); + CompareMeshes(mesh.get(), decoded_mesh.get()); + } +}; + +TEST_F(StlEncoderTest, TestStlEncoding) { + // Test decoded mesh from encoded stl file stays the same. + test_encoding("STL/bunny.stl"); + test_encoding("STL/test_sphere.stl"); +} + +} // namespace draco diff --git a/contrib/draco/src/draco/io/texture_io.cc b/contrib/draco/src/draco/io/texture_io.cc new file mode 100644 index 000000000..cbe2915b0 --- /dev/null +++ b/contrib/draco/src/draco/io/texture_io.cc @@ -0,0 +1,94 @@ +// Copyright 2018 The Draco Authors. +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. +// +#include "draco/io/texture_io.h" + +#ifdef DRACO_TRANSCODER_SUPPORTED + +#include "draco/io/file_utils.h" + +namespace draco { + +namespace { + +StatusOr> CreateDracoTextureInternal( + const std::vector &image_data, SourceImage *out_source_image) { + std::unique_ptr draco_texture(new Texture()); + out_source_image->MutableEncodedData() = image_data; + return std::move(draco_texture); +} + +} // namespace + +StatusOr> ReadTextureFromFile( + const std::string &file_name) { + std::vector image_data; + if (!ReadFileToBuffer(file_name, &image_data)) { + return Status(Status::IO_ERROR, "Unable to read input texture file."); + } + + SourceImage source_image; + DRACO_ASSIGN_OR_RETURN(auto texture, + CreateDracoTextureInternal(image_data, &source_image)); + source_image.set_filename(file_name); + const std::string extension = LowercaseFileExtension(file_name); + const std::string mime_type = + "image/" + (extension == "jpg" ? "jpeg" : extension); + source_image.set_mime_type(mime_type); + texture->set_source_image(source_image); + return texture; +} + +StatusOr> ReadTextureFromBuffer( + const uint8_t *buffer, size_t buffer_size, const std::string &mime_type) { + SourceImage source_image; + std::vector image_data(buffer, buffer + buffer_size); + DRACO_ASSIGN_OR_RETURN(auto texture, + CreateDracoTextureInternal(image_data, &source_image)); + source_image.set_mime_type(mime_type); + texture->set_source_image(source_image); + return texture; +} + +Status WriteTextureToFile(const std::string &file_name, + const Texture &texture) { + std::vector buffer; + DRACO_RETURN_IF_ERROR(WriteTextureToBuffer(texture, &buffer)); + + if (!WriteBufferToFile(buffer.data(), buffer.size(), file_name)) { + return Status(Status::DRACO_ERROR, "Failed to write image."); + } + + return OkStatus(); +} + +Status WriteTextureToBuffer(const Texture &texture, + std::vector *buffer) { + // Copy data from the encoded source image if possible, otherwise load the + // data from the source file. + if (!texture.source_image().encoded_data().empty()) { + *buffer = texture.source_image().encoded_data(); + } else if (!texture.source_image().filename().empty()) { + if (!ReadFileToBuffer(texture.source_image().filename(), buffer)) { + return Status(Status::IO_ERROR, "Unable to read input texture file."); + } + } else { + return Status(Status::DRACO_ERROR, "Invalid source data for the texture."); + } + return OkStatus(); +} + +} // namespace draco + +#endif // DRACO_TRANSCODER_SUPPORTED diff --git a/contrib/draco/src/draco/io/texture_io.h b/contrib/draco/src/draco/io/texture_io.h new file mode 100644 index 000000000..4dbea7554 --- /dev/null +++ b/contrib/draco/src/draco/io/texture_io.h @@ -0,0 +1,56 @@ +// Copyright 2018 The Draco Authors. +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. +// +#ifndef DRACO_IO_TEXTURE_IO_H_ +#define DRACO_IO_TEXTURE_IO_H_ + +#include "draco/draco_features.h" + +#ifdef DRACO_TRANSCODER_SUPPORTED +#include + +#include "draco/core/draco_types.h" +#include "draco/core/status_or.h" +#include "draco/texture/texture.h" + +namespace draco { + +// Reads a texture from a file. Reads PNG, JPEG and WEBP texture files. +// Returns nullptr with an error status if the decoding failed. +StatusOr> ReadTextureFromFile( + const std::string &file_name); + +// Same as ReadTextureFromFile() but the texture data is parsed from a |buffer|. +// |mime_type| should be set to a type of the texture encoded in |buffer|. +// Supported mime types are "image/jpeg", "image/png" and "image/webp". +// TODO(ostava): We should be able to get the mime type directly from the +// |buffer| but our image decoding library doesn't support this at this time. +StatusOr> ReadTextureFromBuffer( + const uint8_t *buffer, size_t buffer_size, const std::string &mime_type); + +// Writes a texture into a file. Can write PNG, JPEG, WEBP, and KTX2 (with Basis +// compression) texture files depending on the extension specified in +// |file_name| and image format specified in |texture|. Note that images with +// Basis compression can only be saved to files in KTX2 format and not to files +// with "basis" extension. Returns an error status if the writing failed. +Status WriteTextureToFile(const std::string &file_name, const Texture &texture); + +// Writes a |texture| into |buffer|. +Status WriteTextureToBuffer(const Texture &texture, + std::vector *buffer); + +} // namespace draco + +#endif // DRACO_TRANSCODER_SUPPORTED +#endif // DRACO_IO_TEXTURE_IO_H_ diff --git a/contrib/draco/src/draco/io/texture_io_test.cc b/contrib/draco/src/draco/io/texture_io_test.cc new file mode 100644 index 000000000..13f36e44a --- /dev/null +++ b/contrib/draco/src/draco/io/texture_io_test.cc @@ -0,0 +1,55 @@ +// Copyright 2018 The Draco Authors. +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. +// +#include "draco/io/texture_io.h" + +#ifdef DRACO_TRANSCODER_SUPPORTED +#include +#include +#include +#include +#include + +#include "draco/core/draco_test_utils.h" +#include "draco/io/file_utils.h" + +namespace { + +// Tests loading of textures from a buffer. +TEST(TextureIoTest, TestLoadFromBuffer) { + const std::string file_name = draco::GetTestFileFullPath("test.png"); + std::vector image_data; + ASSERT_TRUE(draco::ReadFileToBuffer(file_name, &image_data)); + + DRACO_ASSIGN_OR_ASSERT( + std::unique_ptr texture, + draco::ReadTextureFromBuffer(image_data.data(), image_data.size(), + "image/png")); + ASSERT_NE(texture, nullptr); + + ASSERT_EQ(texture->source_image().mime_type(), "image/png"); + + // Re-encode the texture again to ensure the content hasn't changed. + std::vector encoded_buffer; + DRACO_ASSERT_OK(draco::WriteTextureToBuffer(*texture, &encoded_buffer)); + + ASSERT_EQ(image_data.size(), encoded_buffer.size()); + for (int i = 0; i < encoded_buffer.size(); ++i) { + ASSERT_EQ(image_data[i], encoded_buffer[i]); + } +} + +} // namespace + +#endif // DRACO_TRANSCODER_SUPPORTED diff --git a/contrib/draco/src/draco/io/tiny_gltf_utils.cc b/contrib/draco/src/draco/io/tiny_gltf_utils.cc new file mode 100644 index 000000000..d57e1093c --- /dev/null +++ b/contrib/draco/src/draco/io/tiny_gltf_utils.cc @@ -0,0 +1,230 @@ +// Copyright 2021 The Draco Authors. +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. +// +#include "draco/io/tiny_gltf_utils.h" + +#ifdef DRACO_TRANSCODER_SUPPORTED +#include "draco/animation/animation.h" +#include "draco/animation/node_animation_data.h" +#include "draco/core/status.h" +#include "draco/core/vector_d.h" +#include "tiny_gltf.h" + +namespace draco { + +int TinyGltfUtils::GetNumComponentsForType(int type) { + switch (type) { + case TINYGLTF_TYPE_SCALAR: + return 1; + case TINYGLTF_TYPE_VEC2: + return 2; + case TINYGLTF_TYPE_VEC3: + return 3; + case TINYGLTF_TYPE_VEC4: + case TINYGLTF_TYPE_MAT2: + return 4; + case TINYGLTF_TYPE_MAT3: + return 9; + case TINYGLTF_TYPE_MAT4: + return 16; + } + return 0; +} + +Material::TransparencyMode TinyGltfUtils::TextToMaterialMode( + const std::string &mode) { + if (mode == "MASK") { + return Material::TRANSPARENCY_MASK; + } else if (mode == "BLEND") { + return Material::TRANSPARENCY_BLEND; + } else { + return Material::TRANSPARENCY_OPAQUE; + } +} + +AnimationSampler::SamplerInterpolation +TinyGltfUtils::TextToSamplerInterpolation(const std::string &interpolation) { + if (interpolation == "STEP") { + return AnimationSampler::SamplerInterpolation::STEP; + } else if (interpolation == "CUBICSPLINE") { + return AnimationSampler::SamplerInterpolation::CUBICSPLINE; + } else { + return AnimationSampler::SamplerInterpolation::LINEAR; + } +} + +AnimationChannel::ChannelTransformation +TinyGltfUtils::TextToChannelTransformation(const std::string &path) { + if (path == "rotation") { + return AnimationChannel::ChannelTransformation::ROTATION; + } else if (path == "scale") { + return AnimationChannel::ChannelTransformation::SCALE; + } else if (path == "weights") { + return AnimationChannel::ChannelTransformation::WEIGHTS; + } else { + return AnimationChannel::ChannelTransformation::TRANSLATION; + } +} + +Status TinyGltfUtils::AddChannelToAnimation( + const tinygltf::Model &model, const tinygltf::Animation &input_animation, + const tinygltf::AnimationChannel &channel, int node_index, + Animation *animation) { + std::unique_ptr new_channel(new AnimationChannel()); + + const tinygltf::AnimationSampler &sampler = + input_animation.samplers[channel.sampler]; + // Add the sampler associated with the channel. + DRACO_RETURN_IF_ERROR( + TinyGltfUtils::AddSamplerToAnimation(model, sampler, animation)); + new_channel->sampler_index = animation->NumSamplers() - 1; + new_channel->target_index = node_index; + new_channel->transformation_type = + TinyGltfUtils::TextToChannelTransformation(channel.target_path); + + animation->AddChannel(std::move(new_channel)); + return OkStatus(); +} + +Status TinyGltfUtils::AddSamplerToAnimation( + const tinygltf::Model &model, const tinygltf::AnimationSampler &sampler, + Animation *animation) { + std::unique_ptr node_animation_data( + new NodeAnimationData()); + // TODO(fgalligan): Add support to not copy the accessor data if it is + // referenced more than once. Currently we duplicate all animation data so + // that it is referenced only once in the glTF file. + const tinygltf::Accessor &input_accessor = model.accessors[sampler.input]; + DRACO_RETURN_IF_ERROR(AddAccessorToAnimationData(model, input_accessor, + node_animation_data.get())); + animation->AddNodeAnimationData(std::move(node_animation_data)); + std::unique_ptr new_sampler(new AnimationSampler()); + new_sampler->input_index = animation->NumNodeAnimationData() - 1; + + node_animation_data.reset(new NodeAnimationData()); + const tinygltf::Accessor &output_accessor = model.accessors[sampler.output]; + DRACO_RETURN_IF_ERROR(AddAccessorToAnimationData(model, output_accessor, + node_animation_data.get())); + animation->AddNodeAnimationData(std::move(node_animation_data)); + new_sampler->output_index = animation->NumNodeAnimationData() - 1; + + new_sampler->interpolation_type = + TinyGltfUtils::TextToSamplerInterpolation(sampler.interpolation); + animation->AddSampler(std::move(new_sampler)); + return OkStatus(); +} + +// Specialization for returning the data from |accessor| as a vector of float. +template <> +StatusOr> TinyGltfUtils::CopyDataAsFloat( + const tinygltf::Model &model, const tinygltf::Accessor &accessor) { + const int num_components = GetNumComponentsForType(accessor.type); + if (num_components != 1) { + return Status(Status::DRACO_ERROR, + "Dimension does not equal num components."); + } + return CopyDataAsFloatImpl(model, accessor); +} + +// Specialization for returing the data from |accessor| as a vector of +// Matrix4x4. +template <> +StatusOr> TinyGltfUtils::CopyDataAsFloat( + const tinygltf::Model &model, const tinygltf::Accessor &accessor) { + const int num_components = GetNumComponentsForType(accessor.type); + if (num_components != 16) { + return Status(Status::DRACO_ERROR, + "Dimension does not equal num components."); + } + return CopyDataAsFloatImpl(model, accessor); +} + +Status TinyGltfUtils::AddAccessorToAnimationData( + const tinygltf::Model &model, const tinygltf::Accessor &accessor, + NodeAnimationData *node_animation_data) { + if (accessor.componentType != TINYGLTF_COMPONENT_TYPE_FLOAT) { + return Status(Status::DRACO_ERROR, + "Unsupported ComponentType for NodeAnimationData."); + } + + std::vector *dest_data = node_animation_data->GetMutableData(); + if (accessor.type == TINYGLTF_TYPE_SCALAR) { + DRACO_ASSIGN_OR_RETURN(std::vector data, + CopyDataAsFloat(model, accessor)); + + for (int i = 0; i < data.size(); ++i) { + dest_data->push_back(data[i]); + } + node_animation_data->SetType(NodeAnimationData::Type::SCALAR); + } else if (accessor.type == TINYGLTF_TYPE_VEC3) { + DRACO_ASSIGN_OR_RETURN(std::vector data, + CopyDataAsFloat(model, accessor)); + + for (int i = 0; i < data.size(); ++i) { + for (int j = 0; j < 3; ++j) { + dest_data->push_back(data[i][j]); + } + } + node_animation_data->SetType(NodeAnimationData::Type::VEC3); + } else if (accessor.type == TINYGLTF_TYPE_VEC4) { + DRACO_ASSIGN_OR_RETURN(std::vector data, + CopyDataAsFloat(model, accessor)); + + for (int i = 0; i < data.size(); ++i) { + for (int j = 0; j < 4; ++j) { + dest_data->push_back(data[i][j]); + } + } + node_animation_data->SetType(NodeAnimationData::Type::VEC4); + } else if (accessor.type == TINYGLTF_TYPE_MAT4) { + DRACO_ASSIGN_OR_RETURN(std::vector data, + CopyDataAsFloat(model, accessor)); + + for (int i = 0; i < data.size(); ++i) { + for (int j = 0; j < 16; ++j) { + dest_data->push_back(data[i](j)); + } + } + node_animation_data->SetType(NodeAnimationData::Type::MAT4); + } else { + return Status(Status::DRACO_ERROR, + "Unsupported Type for GltfNodeAnimationData."); + } + node_animation_data->SetCount(accessor.count); + node_animation_data->SetNormalized(accessor.normalized); + return OkStatus(); +} + +template <> +void TinyGltfUtils::SetDataImpl(float value, int index, float *values) { + *values = value; +} + +template <> +void TinyGltfUtils::SetDataImpl(float value, int index, + Eigen::Matrix4f *values) { + (*values)(index) = value; +} + +} // namespace draco + +// Actual definitions needed by the tinygltf library using our configuration. +#define STB_IMAGE_IMPLEMENTATION +#define STB_IMAGE_WRITE_IMPLEMENTATION +#define TINYGLTF_ENABLE_DRACO +#define TINYGLTF_IMPLEMENTATION + +#include "tiny_gltf.h" + +#endif // DRACO_TRANSCODER_SUPPORTED diff --git a/contrib/draco/src/draco/io/tiny_gltf_utils.h b/contrib/draco/src/draco/io/tiny_gltf_utils.h new file mode 100644 index 000000000..a536a70fb --- /dev/null +++ b/contrib/draco/src/draco/io/tiny_gltf_utils.h @@ -0,0 +1,140 @@ +// Copyright 2019 The Draco Authors. +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. +// +#ifndef DRACO_IO_TINY_GLTF_UTILS_H_ +#define DRACO_IO_TINY_GLTF_UTILS_H_ + +#include "draco/draco_features.h" + +#ifdef DRACO_TRANSCODER_SUPPORTED +#include "Eigen/Geometry" +#include "draco/animation/animation.h" +#include "draco/core/status.h" +#include "draco/core/status_or.h" +#include "draco/material/material.h" + +#define TINYGLTF_ENCLOSING_NAMESPACE draco +#include "tiny_gltf.h" + +namespace draco { + +class TinyGltfUtils { + public: + TinyGltfUtils() {} + + // Returns the number of components for the attribute type. + static int GetNumComponentsForType(int type); + + // Returns the material transparency mode in |mode|. + static Material::TransparencyMode TextToMaterialMode(const std::string &mode); + + // Returns the animation sampler interpolation in |interpolation|. + static AnimationSampler::SamplerInterpolation TextToSamplerInterpolation( + const std::string &interpolation); + + // Returns the animation channel transformation in |path|. + static AnimationChannel::ChannelTransformation TextToChannelTransformation( + const std::string &path); + + // Adds all of the animation data associated with a channel. + // The channel references a sampler, whose data will be added to the + // |animation|. The sampler references input and output accessors, + // whose data will be added to the |animation|. + static Status AddChannelToAnimation( + const tinygltf::Model &model, const tinygltf::Animation &input_animation, + const tinygltf::AnimationChannel &channel, int node_index, + Animation *animation); + + // Adds all of the sampler data. The sampler references + // input and output accessors, whose data will be added to the |animation|. + static Status AddSamplerToAnimation(const tinygltf::Model &model, + const tinygltf::AnimationSampler &sampler, + Animation *animation); + + // Converts the gltf2 animation accessor and adds it to + // |node_animation_data|. + static Status AddAccessorToAnimationData( + const tinygltf::Model &model, const tinygltf::Accessor &accessor, + NodeAnimationData *node_animation_data); + + // Returns the data from |accessor| as a vector of |T|. + template + static StatusOr> CopyDataAsFloat( + const tinygltf::Model &model, const tinygltf::Accessor &accessor) { + const int num_components = GetNumComponentsForType(accessor.type); + if (num_components != T::dimension) { + return Status(Status::DRACO_ERROR, + "Dimension does not equal num components."); + } + return CopyDataAsFloatImpl(model, accessor); + } + + private: + template + static StatusOr> CopyDataAsFloatImpl( + const tinygltf::Model &model, const tinygltf::Accessor &accessor) { + if (accessor.componentType != TINYGLTF_COMPONENT_TYPE_FLOAT) { + return Status(Status::DRACO_ERROR, + "Non-float data is not supported by CopyDataAsFloat()."); + } + if (accessor.bufferView < 0) { + return Status(Status::DRACO_ERROR, + "Error CopyDataAsFloat() bufferView < 0."); + } + + const tinygltf::BufferView &buffer_view = + model.bufferViews[accessor.bufferView]; + if (buffer_view.buffer < 0) { + return Status(Status::DRACO_ERROR, "Error CopyDataAsFloat() buffer < 0."); + } + + const tinygltf::Buffer &buffer = model.buffers[buffer_view.buffer]; + + const unsigned char *const data_start = + buffer.data.data() + buffer_view.byteOffset + accessor.byteOffset; + const int byte_stride = accessor.ByteStride(buffer_view); + const int component_size = + tinygltf::GetComponentSizeInBytes(accessor.componentType); + + std::vector output; + output.resize(accessor.count); + + const int num_components = GetNumComponentsForType(accessor.type); + const unsigned char *data = data_start; + for (int i = 0; i < accessor.count; ++i) { + T values; + + for (int c = 0; c < num_components; ++c) { + float value = 0.0f; + memcpy(&value, data + (c * component_size), component_size); + SetDataImpl(value, c, &values); + } + + output[i] = values; + data += byte_stride; + } + + return output; + } + + template + static void SetDataImpl(float value, int index, T *values) { + (*values)[index] = value; + } +}; + +} // namespace draco + +#endif // DRACO_TRANSCODER_SUPPORTED +#endif // DRACO_IO_TINY_GLTF_UTILS_H_ diff --git a/contrib/draco/src/draco/javascript/emscripten/animation_decoder_webidl_wrapper.cc b/contrib/draco/src/draco/javascript/emscripten/animation_decoder_webidl_wrapper.cc deleted file mode 100644 index 7e9e6d15d..000000000 --- a/contrib/draco/src/draco/javascript/emscripten/animation_decoder_webidl_wrapper.cc +++ /dev/null @@ -1,101 +0,0 @@ -// Copyright 2017 The Draco Authors. -// -// Licensed under the Apache License, Version 2.0 (the "License"); -// you may not use this file except in compliance with the License. -// You may obtain a copy of the License at -// -// http://www.apache.org/licenses/LICENSE-2.0 -// -// Unless required by applicable law or agreed to in writing, software -// distributed under the License is distributed on an "AS IS" BASIS, -// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. -// See the License for the specific language governing permissions and -// limitations under the License. -// -#include "draco/javascript/emscripten/animation_decoder_webidl_wrapper.h" - -#include - -#include "draco/compression/decode.h" -#include "draco/mesh/mesh.h" -#include "draco/mesh/mesh_stripifier.h" - -using draco::DecoderBuffer; -using draco::PointAttribute; -using draco::Status; - -DracoFloat32Array::DracoFloat32Array() {} - -float DracoFloat32Array::GetValue(int index) const { return values_[index]; } - -bool DracoFloat32Array::SetValues(const float *values, int count) { - if (values) { - values_.assign(values, values + count); - } else { - values_.resize(count); - } - return true; -} - -AnimationDecoder::AnimationDecoder() {} - -// Decodes animation data from the provided buffer. -const draco::Status *AnimationDecoder::DecodeBufferToKeyframeAnimation( - draco::DecoderBuffer *in_buffer, draco::KeyframeAnimation *animation) { - draco::DecoderOptions dec_options; - last_status_ = decoder_.Decode(dec_options, in_buffer, animation); - return &last_status_; -} - -bool AnimationDecoder::GetTimestamps(const draco::KeyframeAnimation &animation, - DracoFloat32Array *timestamp) { - if (!timestamp) { - return false; - } - const int num_frames = animation.num_frames(); - const draco::PointAttribute *timestamp_att = animation.timestamps(); - // Timestamp attribute has only 1 component, so the number of components is - // equal to the number of frames. - timestamp->SetValues(nullptr, num_frames); - int entry_id = 0; - float timestamp_value = -1.0; - for (draco::PointIndex i(0); i < num_frames; ++i) { - const draco::AttributeValueIndex val_index = timestamp_att->mapped_index(i); - if (!timestamp_att->ConvertValue(val_index, ×tamp_value)) { - return false; - } - timestamp->SetValue(entry_id++, timestamp_value); - } - return true; -} - -bool AnimationDecoder::GetKeyframes(const draco::KeyframeAnimation &animation, - int keyframes_id, - DracoFloat32Array *animation_data) { - const int num_frames = animation.num_frames(); - // Get animation data. - const draco::PointAttribute *animation_data_att = - animation.keyframes(keyframes_id); - if (!animation_data_att) { - return false; - } - - const int components = animation_data_att->num_components(); - const int num_entries = num_frames * components; - const int kMaxAttributeFloatValues = 4; - - std::vector values(components, -1.0); - int entry_id = 0; - animation_data->SetValues(nullptr, num_entries); - for (draco::PointIndex i(0); i < num_frames; ++i) { - const draco::AttributeValueIndex val_index = - animation_data_att->mapped_index(i); - if (!animation_data_att->ConvertValue(val_index, &values[0])) { - return false; - } - for (int j = 0; j < components; ++j) { - animation_data->SetValue(entry_id++, values[j]); - } - } - return true; -} diff --git a/contrib/draco/src/draco/javascript/emscripten/animation_decoder_webidl_wrapper.h b/contrib/draco/src/draco/javascript/emscripten/animation_decoder_webidl_wrapper.h deleted file mode 100644 index 7486d1503..000000000 --- a/contrib/draco/src/draco/javascript/emscripten/animation_decoder_webidl_wrapper.h +++ /dev/null @@ -1,73 +0,0 @@ -// Copyright 2017 The Draco Authors. -// -// Licensed under the Apache License, Version 2.0 (the "License"); -// you may not use this file except in compliance with the License. -// You may obtain a copy of the License at -// -// http://www.apache.org/licenses/LICENSE-2.0 -// -// Unless required by applicable law or agreed to in writing, software -// distributed under the License is distributed on an "AS IS" BASIS, -// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. -// See the License for the specific language governing permissions and -// limitations under the License. -// -#ifndef DRACO_JAVASCRIPT_EMSCRIPTEN_ANIMATION_DECODER_WEBIDL_WRAPPER_H_ -#define DRACO_JAVASCRIPT_EMSCRIPTEN_ANIMATION_DECODER_WEBIDL_WRAPPER_H_ - -#include - -#include "draco/animation/keyframe_animation_decoder.h" -#include "draco/attributes/attribute_transform_type.h" -#include "draco/attributes/point_attribute.h" -#include "draco/compression/config/compression_shared.h" -#include "draco/compression/decode.h" -#include "draco/core/decoder_buffer.h" - -typedef draco::AttributeTransformType draco_AttributeTransformType; -typedef draco::GeometryAttribute draco_GeometryAttribute; -typedef draco_GeometryAttribute::Type draco_GeometryAttribute_Type; -typedef draco::EncodedGeometryType draco_EncodedGeometryType; -typedef draco::Status draco_Status; -typedef draco::Status::Code draco_StatusCode; - -class DracoFloat32Array { - public: - DracoFloat32Array(); - float GetValue(int index) const; - - // In case |values| is nullptr, the data is allocated but not initialized. - bool SetValues(const float *values, int count); - - // Directly sets a value for a specific index. The array has to be already - // allocated at this point (using SetValues() method). - void SetValue(int index, float val) { values_[index] = val; } - - int size() const { return values_.size(); } - - private: - std::vector values_; -}; - -// Class used by emscripten WebIDL Binder [1] to wrap calls to decode animation -// data. -class AnimationDecoder { - public: - AnimationDecoder(); - - // Decodes animation data from the provided buffer. - const draco::Status *DecodeBufferToKeyframeAnimation( - draco::DecoderBuffer *in_buffer, draco::KeyframeAnimation *animation); - - static bool GetTimestamps(const draco::KeyframeAnimation &animation, - DracoFloat32Array *timestamp); - - static bool GetKeyframes(const draco::KeyframeAnimation &animation, - int keyframes_id, DracoFloat32Array *animation_data); - - private: - draco::KeyframeAnimationDecoder decoder_; - draco::Status last_status_; -}; - -#endif // DRACO_JAVASCRIPT_EMSCRIPTEN_ANIMATION_DECODER_WEBIDL_WRAPPER_H_ diff --git a/contrib/draco/src/draco/javascript/emscripten/animation_encoder_webidl_wrapper.cc b/contrib/draco/src/draco/javascript/emscripten/animation_encoder_webidl_wrapper.cc deleted file mode 100644 index 53a10e5e4..000000000 --- a/contrib/draco/src/draco/javascript/emscripten/animation_encoder_webidl_wrapper.cc +++ /dev/null @@ -1,89 +0,0 @@ -// Copyright 2017 The Draco Authors. -// -// Licensed under the Apache License, Version 2.0 (the "License"); -// you may not use this file except in compliance with the License. -// You may obtain a copy of the License at -// -// http://www.apache.org/licenses/LICENSE-2.0 -// -// Unless required by applicable law or agreed to in writing, software -// distributed under the License is distributed on an "AS IS" BASIS, -// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. -// See the License for the specific language governing permissions and -// limitations under the License. -// -#include "draco/javascript/emscripten/animation_encoder_webidl_wrapper.h" - -#include "draco/animation/keyframe_animation.h" -#include "draco/animation/keyframe_animation_encoder.h" - -DracoInt8Array::DracoInt8Array() {} - -int DracoInt8Array::GetValue(int index) const { return values_[index]; } - -bool DracoInt8Array::SetValues(const char *values, int count) { - values_.assign(values, values + count); - return true; -} - -AnimationBuilder::AnimationBuilder() {} - -bool AnimationBuilder::SetTimestamps(draco::KeyframeAnimation *animation, - long num_frames, const float *timestamps) { - if (!animation || !timestamps) { - return false; - } - std::vector timestamps_arr( - timestamps, timestamps + num_frames); - return animation->SetTimestamps(timestamps_arr); -} - -int AnimationBuilder::AddKeyframes(draco::KeyframeAnimation *animation, - long num_frames, long num_components, - const float *animation_data) { - if (!animation || !animation_data) { - return -1; - } - std::vector keyframes_arr( - animation_data, animation_data + num_frames * num_components); - return animation->AddKeyframes(draco::DT_FLOAT32, num_components, - keyframes_arr); -} - -AnimationEncoder::AnimationEncoder() - : timestamps_quantization_bits_(-1), - keyframes_quantization_bits_(-1), - options_(draco::EncoderOptions::CreateDefaultOptions()) {} - -void AnimationEncoder::SetTimestampsQuantization(long quantization_bits) { - timestamps_quantization_bits_ = quantization_bits; -} - -void AnimationEncoder::SetKeyframesQuantization(long quantization_bits) { - keyframes_quantization_bits_ = quantization_bits; -} - -int AnimationEncoder::EncodeAnimationToDracoBuffer( - draco::KeyframeAnimation *animation, DracoInt8Array *draco_buffer) { - if (!animation) { - return 0; - } - draco::EncoderBuffer buffer; - - if (timestamps_quantization_bits_ > 0) { - options_.SetAttributeInt(0, "quantization_bits", - timestamps_quantization_bits_); - } - if (keyframes_quantization_bits_ > 0) { - for (int i = 1; i <= animation->num_animations(); ++i) { - options_.SetAttributeInt(i, "quantization_bits", - keyframes_quantization_bits_); - } - } - if (!encoder_.EncodeKeyframeAnimation(*animation, options_, &buffer).ok()) { - return 0; - } - - draco_buffer->SetValues(buffer.data(), buffer.size()); - return buffer.size(); -} diff --git a/contrib/draco/src/draco/javascript/emscripten/animation_encoder_webidl_wrapper.h b/contrib/draco/src/draco/javascript/emscripten/animation_encoder_webidl_wrapper.h deleted file mode 100644 index f2ac733d1..000000000 --- a/contrib/draco/src/draco/javascript/emscripten/animation_encoder_webidl_wrapper.h +++ /dev/null @@ -1,66 +0,0 @@ -// Copyright 2017 The Draco Authors. -// -// Licensed under the Apache License, Version 2.0 (the "License"); -// you may not use this file except in compliance with the License. -// You may obtain a copy of the License at -// -// http://www.apache.org/licenses/LICENSE-2.0 -// -// Unless required by applicable law or agreed to in writing, software -// distributed under the License is distributed on an "AS IS" BASIS, -// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. -// See the License for the specific language governing permissions and -// limitations under the License. -// -#ifndef DRACO_JAVASCRIPT_EMSCRIPTEN_ANIMATION_ENCODER_WEBIDL_WRAPPER_H_ -#define DRACO_JAVASCRIPT_EMSCRIPTEN_ANIMATION_ENCODER_WEBIDL_WRAPPER_H_ - -#include - -#include "draco/animation/keyframe_animation_encoder.h" -#include "draco/attributes/point_attribute.h" -#include "draco/compression/config/compression_shared.h" -#include "draco/compression/config/encoder_options.h" -#include "draco/compression/encode.h" - -class DracoInt8Array { - public: - DracoInt8Array(); - int GetValue(int index) const; - bool SetValues(const char *values, int count); - - size_t size() { return values_.size(); } - - private: - std::vector values_; -}; - -class AnimationBuilder { - public: - AnimationBuilder(); - - bool SetTimestamps(draco::KeyframeAnimation *animation, long num_frames, - const float *timestamps); - - int AddKeyframes(draco::KeyframeAnimation *animation, long num_frames, - long num_components, const float *animation_data); -}; - -class AnimationEncoder { - public: - AnimationEncoder(); - - void SetTimestampsQuantization(long quantization_bits); - // TODO: Use expert encoder to set per attribute quantization. - void SetKeyframesQuantization(long quantization_bits); - int EncodeAnimationToDracoBuffer(draco::KeyframeAnimation *animation, - DracoInt8Array *draco_buffer); - - private: - draco::KeyframeAnimationEncoder encoder_; - long timestamps_quantization_bits_; - long keyframes_quantization_bits_; - draco::EncoderOptions options_; -}; - -#endif // DRACO_JAVASCRIPT_EMSCRIPTEN_ANIMATION_ENCODER_WEBIDL_WRAPPER_H_ diff --git a/contrib/draco/src/draco/javascript/emscripten/decoder_webidl_wrapper.cc b/contrib/draco/src/draco/javascript/emscripten/decoder_webidl_wrapper.cc index 66fe77dbd..034f3c3b4 100644 --- a/contrib/draco/src/draco/javascript/emscripten/decoder_webidl_wrapper.cc +++ b/contrib/draco/src/draco/javascript/emscripten/decoder_webidl_wrapper.cc @@ -221,14 +221,13 @@ bool Decoder::GetAttributeFloatForAllPoints(const PointCloud &pc, const int components = pa.num_components(); const int num_points = pc.num_points(); const int num_entries = num_points * components; - const int kMaxAttributeFloatValues = 4; - float values[kMaxAttributeFloatValues] = {-2.0, -2.0, -2.0, -2.0}; + std::vector values(components, -2.f); int entry_id = 0; out_values->Resize(num_entries); for (draco::PointIndex i(0); i < num_points; ++i) { const draco::AttributeValueIndex val_index = pa.mapped_index(i); - if (!pa.ConvertValue(val_index, values)) { + if (!pa.ConvertValue(val_index, &values[0])) { return false; } for (int j = 0; j < components; ++j) { @@ -249,17 +248,16 @@ bool Decoder::GetAttributeFloatArrayForAllPoints(const PointCloud &pc, return false; } const bool requested_type_is_float = pa.data_type() == draco::DT_FLOAT32; - const int kMaxAttributeFloatValues = 4; - float values[kMaxAttributeFloatValues] = {-2.0, -2.0, -2.0, -2.0}; + std::vector values(components, -2.f); int entry_id = 0; float *const floats = reinterpret_cast(out_values); for (draco::PointIndex i(0); i < num_points; ++i) { const draco::AttributeValueIndex val_index = pa.mapped_index(i); if (requested_type_is_float) { - pa.GetValue(val_index, values); + pa.GetValue(val_index, &values[0]); } else { - if (!pa.ConvertValue(val_index, values)) { + if (!pa.ConvertValue(val_index, &values[0])) { return false; } } diff --git a/contrib/draco/src/draco/javascript/emscripten/draco_animation_decoder_glue_wrapper.cc b/contrib/draco/src/draco/javascript/emscripten/draco_animation_decoder_glue_wrapper.cc deleted file mode 100644 index 83ed98fdc..000000000 --- a/contrib/draco/src/draco/javascript/emscripten/draco_animation_decoder_glue_wrapper.cc +++ /dev/null @@ -1,28 +0,0 @@ -// Copyright 2017 The Draco Authors. -// -// Licensed under the Apache License, Version 2.0 (the "License"); -// you may not use this file except in compliance with the License. -// You may obtain a copy of the License at -// -// http://www.apache.org/licenses/LICENSE-2.0 -// -// Unless required by applicable law or agreed to in writing, software -// distributed under the License is distributed on an "AS IS" BASIS, -// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. -// See the License for the specific language governing permissions and -// limitations under the License. -// -// This file is used by emscripten's WebIDL Binder. -// http://kripken.github.io/emscripten-site/docs/porting/connecting_cpp_and_javascript/WebIDL-Binder.html -#include "draco/attributes/attribute_octahedron_transform.h" -#include "draco/attributes/attribute_quantization_transform.h" -#include "draco/attributes/geometry_attribute.h" -#include "draco/attributes/point_attribute.h" -#include "draco/compression/decode.h" -#include "draco/core/decoder_buffer.h" -#include "draco/javascript/emscripten/animation_decoder_webidl_wrapper.h" -#include "draco/mesh/mesh.h" -#include "draco/point_cloud/point_cloud.h" - -// glue_animation_decoder.cpp is generated by Makefile.emcc build_glue target. -#include "glue_animation_decoder.cpp" diff --git a/contrib/draco/src/draco/javascript/emscripten/draco_animation_web_decoder.idl b/contrib/draco/src/draco/javascript/emscripten/draco_animation_web_decoder.idl deleted file mode 100644 index c9fe76b59..000000000 --- a/contrib/draco/src/draco/javascript/emscripten/draco_animation_web_decoder.idl +++ /dev/null @@ -1,52 +0,0 @@ -// Interface exposed to emscripten's WebIDL Binder. -// http://kripken.github.io/emscripten-site/docs/porting/connecting_cpp_and_javascript/WebIDL-Binder.html -[Prefix="draco::"] -interface DecoderBuffer { - void DecoderBuffer(); - void Init([Const] byte[] data, unsigned long data_size); -}; - -enum draco_StatusCode { - "draco_Status::OK", - "draco_Status::DRACO_ERROR", - "draco_Status::IO_ERROR", - "draco_Status::INVALID_PARAMETER", - "draco_Status::UNSUPPORTED_VERSION", - "draco_Status::UNKNOWN_VERSION", -}; - -[Prefix="draco::"] -interface Status { - draco_StatusCode code(); - boolean ok(); - [Const] DOMString error_msg(); -}; - -// Draco version of typed arrays. The memory of these arrays is allocated on the -// emscripten heap. -interface DracoFloat32Array { - void DracoFloat32Array(); - float GetValue(long index); - long size(); -}; - -[Prefix="draco::"] -interface KeyframeAnimation { - void KeyframeAnimation(); - long num_frames(); - long num_animations(); -}; - -interface AnimationDecoder { - void AnimationDecoder(); - - [Const] Status DecodeBufferToKeyframeAnimation(DecoderBuffer in_buffer, - KeyframeAnimation animation); - - boolean GetTimestamps([Ref, Const] KeyframeAnimation animation, - DracoFloat32Array timestamp); - - boolean GetKeyframes([Ref, Const] KeyframeAnimation animation, - long keyframes_id, - DracoFloat32Array animation_data); -}; diff --git a/contrib/draco/src/draco/javascript/emscripten/draco_animation_web_encoder.idl b/contrib/draco/src/draco/javascript/emscripten/draco_animation_web_encoder.idl deleted file mode 100644 index e74a4c9e4..000000000 --- a/contrib/draco/src/draco/javascript/emscripten/draco_animation_web_encoder.idl +++ /dev/null @@ -1,34 +0,0 @@ -// Interface exposed to emscripten's WebIDL Binder. -// http://kripken.github.io/emscripten-site/docs/porting/connecting_cpp_and_javascript/WebIDL-Binder.html -// Draco version of typed arrays. The memory of these arrays is allocated on the -// emscripten heap. -interface DracoInt8Array { - void DracoInt8Array(); - long GetValue(long index); - long size(); -}; - -[Prefix="draco::"] -interface KeyframeAnimation { - void KeyframeAnimation(); - long num_frames(); -}; - -interface AnimationBuilder { - void AnimationBuilder(); - boolean SetTimestamps(KeyframeAnimation animation, long num_frames, - [Const] float[] timestamps); - - long AddKeyframes(KeyframeAnimation animation, long num_frames, - long num_components, [Const] float[] animation_data); -}; - -interface AnimationEncoder { - void AnimationEncoder(); - - void SetTimestampsQuantization(long quantization_bits); - void SetKeyframesQuantization(long quantization_bits); - - long EncodeAnimationToDracoBuffer(KeyframeAnimation animation, - DracoInt8Array encoded_data); -}; diff --git a/contrib/draco/src/draco/javascript/emscripten/version.js b/contrib/draco/src/draco/javascript/emscripten/version.js index 46fb25271..b21f3b5e2 100644 --- a/contrib/draco/src/draco/javascript/emscripten/version.js +++ b/contrib/draco/src/draco/javascript/emscripten/version.js @@ -19,7 +19,7 @@ function isVersionSupported(versionString) { const version = versionString.split('.'); if (version.length < 2 || version.length > 3) return false; // Unexpected version string. - if (version[0] == 1 && version[1] >= 0 && version[1] <= 4) + if (version[0] == 1 && version[1] >= 0 && version[1] <= 5) return true; if (version[0] != 0 || version[1] > 10) return false; diff --git a/contrib/draco/src/draco/material/material.cc b/contrib/draco/src/draco/material/material.cc new file mode 100644 index 000000000..da854a172 --- /dev/null +++ b/contrib/draco/src/draco/material/material.cc @@ -0,0 +1,258 @@ +// Copyright 2018 The Draco Authors. +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. +// +#include "draco/material/material.h" + +#ifdef DRACO_TRANSCODER_SUPPORTED + +namespace draco { + +Material::Material() : Material(nullptr) {} + +Material::Material(TextureLibrary *texture_library) + : texture_library_(texture_library) { + Clear(); +} + +void Material::Copy(const Material &src) { + name_ = src.name_; + color_factor_ = src.color_factor_; + metallic_factor_ = src.metallic_factor_; + roughness_factor_ = src.roughness_factor_; + emissive_factor_ = src.emissive_factor_; + transparency_mode_ = src.transparency_mode_; + alpha_cutoff_ = src.alpha_cutoff_; + double_sided_ = src.double_sided_; + normal_texture_scale_ = src.normal_texture_scale_; + + // Copy properties of material extensions. + unlit_ = src.unlit_; + has_sheen_ = src.has_sheen_; + sheen_color_factor_ = src.sheen_color_factor_; + sheen_roughness_factor_ = src.sheen_roughness_factor_; + has_transmission_ = src.has_transmission_; + transmission_factor_ = src.transmission_factor_; + has_clearcoat_ = src.has_clearcoat_; + clearcoat_factor_ = src.clearcoat_factor_; + clearcoat_roughness_factor_ = src.clearcoat_roughness_factor_; + has_volume_ = src.has_volume_; + thickness_factor_ = src.thickness_factor_; + attenuation_distance_ = src.attenuation_distance_; + attenuation_color_ = src.attenuation_color_; + has_ior_ = src.has_ior_; + ior_ = src.ior_; + has_specular_ = src.has_specular_; + specular_factor_ = src.specular_factor_; + specular_color_factor_ = src.specular_color_factor_; + + // Copy texture maps. + texture_map_type_to_index_map_ = src.texture_map_type_to_index_map_; + texture_maps_.resize(src.texture_maps_.size()); + for (int i = 0; i < texture_maps_.size(); ++i) { + texture_maps_[i] = std::unique_ptr(new TextureMap()); + texture_maps_[i]->Copy(*src.texture_maps_[i]); + } +} + +void Material::Clear() { + ClearTextureMaps(); + + // Defaults correspond to the GLTF 2.0 spec. + name_.clear(); + color_factor_ = Vector4f(1.f, 1.f, 1.f, 1.f); + metallic_factor_ = 1.f; + roughness_factor_ = 1.f; + emissive_factor_ = Vector3f(0.f, 0.f, 0.f); + transparency_mode_ = TRANSPARENCY_OPAQUE; + alpha_cutoff_ = 0.5f; + double_sided_ = false; + normal_texture_scale_ = 1.0f; + + // Clear properties of material extensions to glTF 2.0 spec defaults. + unlit_ = false; + has_sheen_ = false; + sheen_color_factor_ = Vector3f(0.f, 0.f, 0.f); + sheen_roughness_factor_ = 0.f; + has_transmission_ = false; + transmission_factor_ = 0.f; + has_clearcoat_ = false; + clearcoat_factor_ = 0.f; + clearcoat_roughness_factor_ = 0.f; + has_volume_ = false; + thickness_factor_ = 0.f; + attenuation_distance_ = std::numeric_limits::max(); // Infinity. + attenuation_color_ = Vector3f(1.f, 1.f, 1.f); + has_ior_ = false; + ior_ = 1.5f; + has_specular_ = false; + specular_factor_ = 1.f; + specular_color_factor_ = Vector3f(1.f, 1.f, 1.f); +} + +void Material::ClearTextureMaps() { + texture_maps_.clear(); + texture_map_type_to_index_map_.clear(); +} + +void Material::SetTextureMap(TextureMap &&texture_map) { + std::unique_ptr new_texture_map(new TextureMap); + *new_texture_map = std::move(texture_map); + SetTextureMap(std::move(new_texture_map)); +} + +void Material::SetTextureMap(std::unique_ptr texture_map) { + const TextureMap::Type type = texture_map->type(); + const auto it = texture_map_type_to_index_map_.find(type); + // Only one texture of a given type is allowed to exist. + if (it == texture_map_type_to_index_map_.end()) { + texture_maps_.push_back(std::move(texture_map)); + texture_map_type_to_index_map_[type] = texture_maps_.size() - 1; + } else { + texture_maps_[it->second] = std::move(texture_map); + } +} + +void Material::SetTextureMap(std::unique_ptr texture, + TextureMap::Type texture_map_type, + int tex_coord_index) { + SetTextureMap(std::move(texture), texture_map_type, + TextureMap::WrappingMode(TextureMap::CLAMP_TO_EDGE), + tex_coord_index); +} + +void Material::SetTextureMap(std::unique_ptr texture, + TextureMap::Type texture_map_type, + TextureMap::WrappingMode wrapping_mode, + int tex_coord_index) { + std::unique_ptr texture_map(new TextureMap); + texture_map->SetProperties(texture_map_type, wrapping_mode, tex_coord_index); + + if (texture_library_) { + texture_map->SetTexture(texture.get()); + texture_library_->PushTexture(std::move(texture)); + } else { + texture_map->SetTexture(std::move(texture)); + } + SetTextureMap(std::move(texture_map)); +} + +Status Material::SetTextureMap(Texture *texture, + TextureMap::Type texture_map_type, + int tex_coord_index) { + return SetTextureMap(texture, texture_map_type, + TextureMap::WrappingMode(TextureMap::CLAMP_TO_EDGE), + TextureMap::UNSPECIFIED, TextureMap::UNSPECIFIED, + tex_coord_index); +} + +Status Material::SetTextureMap(Texture *texture, + TextureMap::Type texture_map_type, + TextureMap::WrappingMode wrapping_mode, + int tex_coord_index) { + std::unique_ptr texture_map(new TextureMap); + return SetTextureMap(std::move(texture_map), texture, texture_map_type, + wrapping_mode, TextureMap::UNSPECIFIED, + TextureMap::UNSPECIFIED, tex_coord_index); +} + +Status Material::SetTextureMap(Texture *texture, + TextureMap::Type texture_map_type, + TextureMap::WrappingMode wrapping_mode, + TextureMap::FilterType min_filter, + TextureMap::FilterType mag_filter, + int tex_coord_index) { + std::unique_ptr texture_map(new TextureMap); + return SetTextureMap(std::move(texture_map), texture, texture_map_type, + wrapping_mode, min_filter, mag_filter, tex_coord_index); +} + +Status Material::SetTextureMap(Texture *texture, + TextureMap::Type texture_map_type, + TextureMap::WrappingMode wrapping_mode, + TextureMap::FilterType min_filter, + TextureMap::FilterType mag_filter, + const TextureTransform &transform, + int tex_coord_index) { + std::unique_ptr texture_map(new TextureMap); + texture_map->SetTransform(transform); + return SetTextureMap(std::move(texture_map), texture, texture_map_type, + wrapping_mode, min_filter, mag_filter, tex_coord_index); +} + +Status Material::SetTextureMap(std::unique_ptr texture_map, + Texture *texture, + TextureMap::Type texture_map_type, + TextureMap::WrappingMode wrapping_mode, + TextureMap::FilterType min_filter, + TextureMap::FilterType mag_filter, + int tex_coord_index) { + if (!IsTextureOwned(*texture)) { + return Status(Status::DRACO_ERROR, + "Provided texture is not owned by the material."); + } + texture_map->SetProperties(texture_map_type, wrapping_mode, tex_coord_index, + min_filter, mag_filter); + texture_map->SetTexture(texture); + SetTextureMap(std::move(texture_map)); + return OkStatus(); +} + +bool Material::IsTextureOwned(const Texture &texture) { + if (texture_library_) { + // Ensure the texture is owned by the texture library. + for (int ti = 0; ti < texture_library_->NumTextures(); ++ti) { + if (texture_library_->GetTexture(ti) == &texture) { + return true; + } + } + return false; + } + // Else we need to check every texture map of this material. + for (int ti = 0; ti < NumTextureMaps(); ++ti) { + if (GetTextureMapByIndex(ti)->texture() == &texture) { + return true; + } + } + return false; +} + +std::unique_ptr Material::RemoveTextureMapByIndex(int index) { + if (index < 0 || index >= texture_maps_.size()) { + return nullptr; + } + std::unique_ptr ret = std::move(texture_maps_[index]); + texture_maps_.erase(texture_maps_.begin() + index); + // A texture map was removed and we need to update + // |texture_map_type_to_index_map_| to reflect the changes. + for (int i = index; i < texture_maps_.size(); ++i) { + texture_map_type_to_index_map_[texture_maps_[i]->type()] = i; + } + // Delete the removed texture map type. + texture_map_type_to_index_map_.erase( + texture_map_type_to_index_map_.find(ret->type())); + return ret; +} + +std::unique_ptr Material::RemoveTextureMapByType( + TextureMap::Type texture_type) { + const auto it = texture_map_type_to_index_map_.find(texture_type); + if (it == texture_map_type_to_index_map_.end()) { + return nullptr; + } + return RemoveTextureMapByIndex(it->second); +} + +} // namespace draco + +#endif // DRACO_TRANSCODER_SUPPORTED diff --git a/contrib/draco/src/draco/material/material.h b/contrib/draco/src/draco/material/material.h new file mode 100644 index 000000000..7c405b45c --- /dev/null +++ b/contrib/draco/src/draco/material/material.h @@ -0,0 +1,276 @@ +// Copyright 2018 The Draco Authors. +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. +// +#ifndef DRACO_MATERIAL_MATERIAL_H_ +#define DRACO_MATERIAL_MATERIAL_H_ + +#include "draco/draco_features.h" + +#ifdef DRACO_TRANSCODER_SUPPORTED +#include +#include + +#include "draco/core/status.h" +#include "draco/core/vector_d.h" +#include "draco/texture/texture_library.h" +#include "draco/texture/texture_map.h" + +namespace draco { + +// Material specification for Draco geometry. Parameters are based on the +// metallic-roughness PBR model adopted by GLTF 2.0 standard: +// https://github.com/KhronosGroup/glTF/tree/master/specification/2.0#materials +class Material { + public: + enum TransparencyMode { + TRANSPARENCY_OPAQUE = 0, + TRANSPARENCY_MASK, + TRANSPARENCY_BLEND + }; + + Material(); + explicit Material(TextureLibrary *texture_library); + + // Copies all material data from the |src| material to this material. + void Copy(const Material &src); + + // Deletes all texture maps and resets all material properties to default + // values. + void Clear(); + + // Deletes all texture maps from the material while keeping other material + // properties unchanged. + void ClearTextureMaps(); + + const std::string &GetName() const { return name_; } + void SetName(const std::string &name) { name_ = name; } + Vector4f GetColorFactor() const { return color_factor_; } + void SetColorFactor(const Vector4f &color_factor) { + color_factor_ = color_factor; + } + float GetMetallicFactor() const { return metallic_factor_; } + void SetMetallicFactor(float metallic_factor) { + metallic_factor_ = metallic_factor; + } + float GetRoughnessFactor() const { return roughness_factor_; } + void SetRoughnessFactor(float roughness_factor) { + roughness_factor_ = roughness_factor; + } + Vector3f GetEmissiveFactor() const { return emissive_factor_; } + void SetEmissiveFactor(const Vector3f &emissive_factor) { + emissive_factor_ = emissive_factor; + } + bool GetDoubleSided() const { return double_sided_; } + void SetDoubleSided(bool double_sided) { double_sided_ = double_sided; } + TransparencyMode GetTransparencyMode() const { return transparency_mode_; } + void SetTransparencyMode(TransparencyMode mode) { transparency_mode_ = mode; } + float GetAlphaCutoff() const { return alpha_cutoff_; } + void SetAlphaCutoff(float alpha_cutoff) { alpha_cutoff_ = alpha_cutoff; } + float GetNormalTextureScale() const { return normal_texture_scale_; } + void SetNormalTextureScale(float scale) { normal_texture_scale_ = scale; } + + // Properties of glTF material extension KHR_materials_unlit. + bool GetUnlit() const { return unlit_; } + void SetUnlit(bool unlit) { unlit_ = unlit; } + + // Properties of glTF material extension KHR_materials_sheen. + bool HasSheen() const { return has_sheen_; } + void SetHasSheen(bool value) { has_sheen_ = value; } + Vector3f GetSheenColorFactor() const { return sheen_color_factor_; } + void SetSheenColorFactor(const Vector3f &value) { + sheen_color_factor_ = value; + } + float GetSheenRoughnessFactor() const { return sheen_roughness_factor_; } + void SetSheenRoughnessFactor(float value) { sheen_roughness_factor_ = value; } + + // Properties of glTF material extension KHR_materials_transmission. + bool HasTransmission() const { return has_transmission_; } + void SetHasTransmission(bool value) { has_transmission_ = value; } + float GetTransmissionFactor() const { return transmission_factor_; } + void SetTransmissionFactor(float value) { transmission_factor_ = value; } + + // Properties of glTF material extension KHR_materials_clearcoat. + bool HasClearcoat() const { return has_clearcoat_; } + void SetHasClearcoat(bool value) { has_clearcoat_ = value; } + float GetClearcoatFactor() const { return clearcoat_factor_; } + void SetClearcoatFactor(float value) { clearcoat_factor_ = value; } + float GetClearcoatRoughnessFactor() const { + return clearcoat_roughness_factor_; + } + void SetClearcoatRoughnessFactor(float value) { + clearcoat_roughness_factor_ = value; + } + + // Properties of glTF material extension KHR_materials_volume. + bool HasVolume() const { return has_volume_; } + void SetHasVolume(bool value) { has_volume_ = value; } + float GetThicknessFactor() const { return thickness_factor_; } + void SetThicknessFactor(float value) { thickness_factor_ = value; } + float GetAttenuationDistance() const { return attenuation_distance_; } + void SetAttenuationDistance(float value) { attenuation_distance_ = value; } + Vector3f GetAttenuationColor() const { return attenuation_color_; } + void SetAttenuationColor(const Vector3f &value) { + attenuation_color_ = value; + } + + // Properties of glTF material extension KHR_materials_ior. + bool HasIor() const { return has_ior_; } + void SetHasIor(bool value) { has_ior_ = value; } + float GetIor() const { return ior_; } + void SetIor(float value) { ior_ = value; } + + // Properties of glTF material extension KHR_materials_specular. + bool HasSpecular() const { return has_specular_; } + void SetHasSpecular(bool value) { has_specular_ = value; } + float GetSpecularFactor() const { return specular_factor_; } + void SetSpecularFactor(float value) { specular_factor_ = value; } + Vector3f GetSpecularColorFactor() const { return specular_color_factor_; } + void SetSpecularColorFactor(const Vector3f &value) { + specular_color_factor_ = value; + } + + // Methods for working with texture maps. + size_t NumTextureMaps() const { return texture_maps_.size(); } + const TextureMap *GetTextureMapByIndex(int index) const { + return texture_maps_[index].get(); + } + TextureMap *GetTextureMapByIndex(int index) { + return texture_maps_[index].get(); + } + const TextureMap *GetTextureMapByType(TextureMap::Type texture_type) const { + const auto it = texture_map_type_to_index_map_.find(texture_type); + if (it == texture_map_type_to_index_map_.end()) { + return nullptr; + } + return GetTextureMapByIndex(it->second); + } + TextureMap *GetTextureMapByType(TextureMap::Type texture_type) { + const auto it = texture_map_type_to_index_map_.find(texture_type); + if (it == texture_map_type_to_index_map_.end()) { + return nullptr; + } + return GetTextureMapByIndex(it->second); + } + + // TODO(b/146061359): Refactor the set texture map code. + // Specifies a new texture map using a texture with a given type. + // |tex_coord_index| defines which texture coordinate attribute should be used + // to map the texture on the underlying geometry (e.g. tex_coord_index 0 would + // use the first texture coordinate attribute). + void SetTextureMap(std::unique_ptr texture, + TextureMap::Type texture_map_type, int tex_coord_index); + void SetTextureMap(std::unique_ptr texture, + TextureMap::Type texture_map_type, + TextureMap::WrappingMode wrapping_mode, + int tex_coord_index); + + // Sets a new texture map using a |texture| that is already owned by this + // material (that is by one of its texture maps or by the unerlying + // |texture_library_|). |transform| is the texture map's transform if set. + // |min_filter| and |mag_filter| are the texture filter types. Returns error + // status if provided |texture| is not owned by the material. + Status SetTextureMap(Texture *texture, TextureMap::Type texture_map_type, + int tex_coord_index); + Status SetTextureMap(Texture *texture, TextureMap::Type texture_map_type, + TextureMap::WrappingMode wrapping_mode, + int tex_coord_index); + Status SetTextureMap(Texture *texture, TextureMap::Type texture_map_type, + TextureMap::WrappingMode wrapping_mode, + TextureMap::FilterType min_filter, + TextureMap::FilterType mag_filter, int tex_coord_index); + Status SetTextureMap(Texture *texture, TextureMap::Type texture_map_type, + TextureMap::WrappingMode wrapping_mode, + TextureMap::FilterType min_filter, + TextureMap::FilterType mag_filter, + const TextureTransform &transform, int tex_coord_index); + + // Removes a texture map from the material based on its index or texture type. + // The material releases the ownership of the texture map and returns it as + // a unique_ptr to allow the caller to use the texture map for other purposes. + std::unique_ptr RemoveTextureMapByIndex(int index); + std::unique_ptr RemoveTextureMapByType( + TextureMap::Type texture_type); + + private: + void SetTextureMap(TextureMap &&texture_map); + void SetTextureMap(std::unique_ptr texture_map); + Status SetTextureMap(std::unique_ptr texture_map, + Texture *texture, TextureMap::Type texture_map_type, + TextureMap::WrappingMode wrapping_mode, + TextureMap::FilterType min_filter, + TextureMap::FilterType mag_filter, int tex_coord_index); + + // Returns true if the |texture| is owned by the material. + bool IsTextureOwned(const Texture &texture); + + private: + std::string name_; + Vector4f color_factor_; + float metallic_factor_; + float roughness_factor_; + Vector3f emissive_factor_; + bool double_sided_; + TransparencyMode transparency_mode_; + float alpha_cutoff_; + float normal_texture_scale_; + + // Properties of glTF material extension KHR_materials_unlit. + bool unlit_; + + // Properties of glTF material extension KHR_materials_sheen. + bool has_sheen_; + Vector3f sheen_color_factor_; + float sheen_roughness_factor_; + + // Properties of glTF material extension KHR_materials_transmission. + bool has_transmission_; + float transmission_factor_; + + // Properties of glTF material extension KHR_materials_clearcoat. + bool has_clearcoat_; + float clearcoat_factor_; + float clearcoat_roughness_factor_; + + // Properties of glTF material extension KHR_materials_volume. + bool has_volume_; + float thickness_factor_; + float attenuation_distance_; + Vector3f attenuation_color_; + + // Properties of glTF material extension KHR_materials_ior. + bool has_ior_; + float ior_; + + // Properties of glTF material extension KHR_materials_specular. + bool has_specular_; + float specular_factor_; + Vector3f specular_color_factor_; + + // Texture maps. + std::vector> texture_maps_; + + // Map between a texture type to texture index in |texture_maps_|. Allows fast + // retrieval of texture maps based on their type. + std::unordered_map texture_map_type_to_index_map_; + + // Optional pointer to a library that holds ownership of textures used for + // this material. If set to nullptr, the texture ownership will be assigned + // to the newly created TextureMaps directly. + TextureLibrary *texture_library_; +}; + +} // namespace draco + +#endif // DRACO_TRANSCODER_SUPPORTED +#endif // DRACO_MATERIAL_MATERIAL_H_ diff --git a/contrib/draco/src/draco/material/material_library.cc b/contrib/draco/src/draco/material/material_library.cc new file mode 100644 index 000000000..f2165295f --- /dev/null +++ b/contrib/draco/src/draco/material/material_library.cc @@ -0,0 +1,125 @@ +// Copyright 2018 The Draco Authors. +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. +// +#include "draco/material/material_library.h" + +#ifdef DRACO_TRANSCODER_SUPPORTED +namespace draco { + +void MaterialLibrary::Copy(const MaterialLibrary &src) { + Clear(); + Append(src); +} + +void MaterialLibrary::Append(const MaterialLibrary &src) { + const size_t old_num_materials = materials_.size(); + materials_.resize(old_num_materials + src.materials_.size()); + for (int i = 0; i < src.materials_.size(); ++i) { + materials_[old_num_materials + i] = + std::unique_ptr(new Material(&texture_library_)); + materials_[old_num_materials + i]->Copy(*src.materials_[i]); + } + + const size_t old_num_textures = texture_library_.NumTextures(); + texture_library_.Append(src.texture_library_); + for (int i = 0; i < src.materials_variants_names_.size(); i++) { + materials_variants_names_.push_back(src.materials_variants_names_[i]); + } + + // Remap all texture maps to the textures in the new texture library. + + // First gather mapping between texture maps and textures in the old material + // library. + const auto texture_map_to_index = + ComputeTextureMapToTextureIndexMapping(src.texture_library_); + + // Remap all texture maps to textures stored in the new texture library. + for (auto it = texture_map_to_index.begin(); it != texture_map_to_index.end(); + ++it) { + TextureMap *const texture_map = it->first; + const int texture_index = old_num_textures + it->second; + texture_map->SetTexture(texture_library_.GetTexture(texture_index)); + } +} + +std::unique_ptr MaterialLibrary::RemoveMaterial(int index) { + std::unique_ptr ret = std::move(materials_[index]); + materials_.erase(materials_.begin() + index); + return ret; +} + +void MaterialLibrary::RemoveUnusedTextures() { + const auto texture_map_to_index = + ComputeTextureMapToTextureIndexMapping(texture_library_); + + // Mark which textures are used. + std::vector is_texture_used(texture_library_.NumTextures(), false); + for (auto it = texture_map_to_index.begin(); it != texture_map_to_index.end(); + ++it) { + is_texture_used[it->second] = true; + } + + // Remove all textures that are not used (from backwards to avoid updating + // entries in the |is_texture_used| vector). + for (int i = texture_library_.NumTextures() - 1; i >= 0; --i) { + if (!is_texture_used[i]) { + texture_library_.RemoveTexture(i); + } + } +} + +std::map +MaterialLibrary::ComputeTextureMapToTextureIndexMapping( + const TextureLibrary &library) const { + std::map map_to_index; + for (int mi = 0; mi < materials_.size(); ++mi) { + for (int ti = 0; ti < materials_[mi]->NumTextureMaps(); ++ti) { + TextureMap *const texture_map = materials_[mi]->GetTextureMapByIndex(ti); + for (int tli = 0; tli < library.NumTextures(); ++tli) { + if (library.GetTexture(tli) != texture_map->texture()) { + continue; + } + map_to_index[texture_map] = tli; + break; + } + } + } + return map_to_index; +} + +void MaterialLibrary::Clear() { + materials_.clear(); + texture_library_.Clear(); + materials_variants_names_.clear(); +} + +Material *MaterialLibrary::MutableMaterial(int index) { + if (index < 0) { + return nullptr; + } + if (materials_.size() <= index) { + const int old_size = materials_.size(); + materials_.resize(index + 1); + // Ensure all newly created materials are valid. + for (int i = old_size; i < index + 1; ++i) { + materials_[i] = + std::unique_ptr(new Material(&texture_library_)); + } + } + return materials_[index].get(); +} + +} // namespace draco + +#endif // DRACO_TRANSCODER_SUPPORTED diff --git a/contrib/draco/src/draco/material/material_library.h b/contrib/draco/src/draco/material/material_library.h new file mode 100644 index 000000000..574d86b23 --- /dev/null +++ b/contrib/draco/src/draco/material/material_library.h @@ -0,0 +1,104 @@ +// Copyright 2018 The Draco Authors. +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. +// +#ifndef DRACO_MATERIAL_MATERIAL_LIBRARY_H_ +#define DRACO_MATERIAL_MATERIAL_LIBRARY_H_ + +#include "draco/draco_features.h" + +#ifdef DRACO_TRANSCODER_SUPPORTED +#include +#include +#include + +#include "draco/material/material.h" +#include "draco/texture/texture_library.h" + +namespace draco { + +// MaterialLibrary holds an array of materials that are applied to a single +// model. +class MaterialLibrary { + public: + MaterialLibrary() = default; + + // Copies the |src| into this instance. + void Copy(const MaterialLibrary &src); + + // Appends materials from the |src| library to this library. All materials + // and textures are copied over. + void Append(const MaterialLibrary &src); + + // Deletes all materials from the material library. + void Clear(); + + // The number of materials stored in the library. All materials are stored + // with indices <0, num_materials() - 1>. + size_t NumMaterials() const { return materials_.size(); } + + // Returns a material with a given index or nullptr if the index is not valid. + const Material *GetMaterial(int index) const { + if (index < 0 || index >= materials_.size()) { + return nullptr; + } + return materials_[index].get(); + } + + // Returns a mutable pointer to a given material. If the material with the + // specified |index| does not exist, it is automatically created. + Material *MutableMaterial(int index); + + // Removes a material with a given index and returns it. Caller can ignore the + // returned value, in which case the material will be automatically deleted. + // Index of all subsequent materials will be decremented by one. + std::unique_ptr RemoveMaterial(int index); + + const TextureLibrary &GetTextureLibrary() const { return texture_library_; } + TextureLibrary &MutableTextureLibrary() { return texture_library_; } + + // Removes all textures that are not referenced by a TextureMap from the + // texture library. + void RemoveUnusedTextures(); + + // Returns a map between each TextureMap object and associated texture index + // in the texture |library|. + std::map ComputeTextureMapToTextureIndexMapping( + const TextureLibrary &library) const; + + // Creates a named materials variant and returns its index. + int AddMaterialsVariant(const std::string &name) { + materials_variants_names_.push_back(name); + return materials_variants_names_.size() - 1; + } + + // Returns the number of materials variants. + int NumMaterialsVariants() const { return materials_variants_names_.size(); } + + // Returns the name of a materials variant. + const std::string &GetMaterialsVariantName(int index) const { + return materials_variants_names_[index]; + } + + private: + std::vector> materials_; + std::vector materials_variants_names_; + + // Container for storing all textures used by materials of this library. + TextureLibrary texture_library_; +}; + +} // namespace draco + +#endif // DRACO_MATERIAL_MATERIAL_LIBRARY_H_ +#endif // DRACO_TRANSCODER_SUPPORTED diff --git a/contrib/draco/src/draco/material/material_library_test.cc b/contrib/draco/src/draco/material/material_library_test.cc new file mode 100644 index 000000000..a110fa4db --- /dev/null +++ b/contrib/draco/src/draco/material/material_library_test.cc @@ -0,0 +1,155 @@ +// Copyright 2018 The Draco Authors. +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. +// +#include "draco/material/material_library.h" + +#include "draco/core/draco_test_base.h" +#include "draco/core/draco_test_utils.h" + +namespace { + +#ifdef DRACO_TRANSCODER_SUPPORTED +TEST(MaterialLibraryTest, TestMaterials) { + // Test verifies that we can modify materials in a library. + draco::MaterialLibrary library; + ASSERT_EQ(library.NumMaterials(), 0); + + // Add a new material to the library. + const draco::Material *const new_mat = library.MutableMaterial(0); + ASSERT_NE(new_mat, nullptr); + ASSERT_EQ(library.NumMaterials(), 1); + + const draco::Material *const new_mat2 = library.MutableMaterial(2); + ASSERT_NE(new_mat2, nullptr); + ASSERT_EQ(library.NumMaterials(), 3); + ASSERT_EQ(library.GetMaterial(2), new_mat2); + + // Ensure that even though we call mutable_material multiple times, it does + // not increase the number of materials associated to the library. + for (int i = 0; i < library.NumMaterials(); ++i) { + ASSERT_NE(library.MutableMaterial(i), nullptr); + } + ASSERT_EQ(library.NumMaterials(), 3); + + // Check that material variants can be added and cleared. + library.AddMaterialsVariant("Milk Truck"); + library.AddMaterialsVariant("Ice Cream Truck"); + ASSERT_EQ(library.NumMaterialsVariants(), 2); + ASSERT_EQ(library.GetMaterialsVariantName(0), "Milk Truck"); + ASSERT_EQ(library.GetMaterialsVariantName(1), "Ice Cream Truck"); + + library.Clear(); + ASSERT_EQ(library.NumMaterials(), 0); + ASSERT_EQ(library.NumMaterialsVariants(), 0); +} + +TEST(MaterialLibraryTest, TestMaterialsCopy) { + // Test verifies that we can copy a material library. + draco::MaterialLibrary library; + library.MutableMaterial(0)->SetMetallicFactor(2.4f); + library.MutableMaterial(3)->SetRoughnessFactor(1.2f); + library.AddMaterialsVariant("Milk Truck"); + library.AddMaterialsVariant("Ice Cream Truck"); + + draco::MaterialLibrary new_library; + new_library.Copy(library); + ASSERT_EQ(library.NumMaterials(), new_library.NumMaterials()); + ASSERT_EQ(library.GetMaterial(0)->GetMetallicFactor(), + new_library.GetMaterial(0)->GetMetallicFactor()); + ASSERT_EQ(library.GetMaterial(3)->GetRoughnessFactor(), + new_library.GetMaterial(3)->GetRoughnessFactor()); + ASSERT_EQ(new_library.NumMaterialsVariants(), 2); + ASSERT_EQ(new_library.GetMaterialsVariantName(0), "Milk Truck"); + ASSERT_EQ(new_library.GetMaterialsVariantName(1), "Ice Cream Truck"); +} + +TEST(MaterialLibraryTest, TestTextureLibrary) { + // Tests that texture library is properly updated when we add new textures + // to a material belonging to the material library. + std::unique_ptr texture_0(new draco::Texture()); + std::unique_ptr texture_1(new draco::Texture()); + + draco::MaterialLibrary library; + library.MutableMaterial(0)->SetTextureMap(std::move(texture_0), + draco::TextureMap::COLOR, 0); + ASSERT_EQ(library.GetTextureLibrary().NumTextures(), 1); + library.MutableMaterial(3)->SetTextureMap(std::move(texture_1), + draco::TextureMap::COLOR, 0); + ASSERT_EQ(library.GetTextureLibrary().NumTextures(), 2); +} + +TEST(MaterialLibraryTest, RemoveUnusedTextures) { + // Test verifies that we can remove unusued textures from the material + // library. + draco::MaterialLibrary library; + + // Create dummy textures. + std::unique_ptr texture_0(new draco::Texture()); + std::unique_ptr texture_1(new draco::Texture()); + std::unique_ptr texture_2(new draco::Texture()); + + // Add them to the materials of the library. + library.MutableMaterial(0)->SetTextureMap(std::move(texture_0), + draco::TextureMap::COLOR, 0); + library.MutableMaterial(0)->SetTextureMap( + std::move(texture_1), draco::TextureMap::METALLIC_ROUGHNESS, 0); + library.MutableMaterial(1)->SetTextureMap(std::move(texture_2), + draco::TextureMap::COLOR, 0); + + ASSERT_EQ(library.GetTextureLibrary().NumTextures(), 3); + + library.RemoveUnusedTextures(); + ASSERT_EQ(library.GetTextureLibrary().NumTextures(), 3); + + // Remove texture map from a material. + library.MutableMaterial(0)->RemoveTextureMapByType( + draco::TextureMap::METALLIC_ROUGHNESS); + library.RemoveUnusedTextures(); + ASSERT_EQ(library.GetTextureLibrary().NumTextures(), 2); + + library.MutableMaterial(1)->RemoveTextureMapByType(draco::TextureMap::COLOR); + library.RemoveUnusedTextures(); + ASSERT_EQ(library.GetTextureLibrary().NumTextures(), 1); + + library.MutableMaterial(0)->RemoveTextureMapByType(draco::TextureMap::COLOR); + library.RemoveUnusedTextures(); + ASSERT_EQ(library.GetTextureLibrary().NumTextures(), 0); +} + +TEST(MaterialLibraryTest, RemoveMaterial) { + // Tests that we can safely remove materials from the material library. + draco::MaterialLibrary library; + library.MutableMaterial(0)->SetMetallicFactor(0.f); + library.MutableMaterial(1)->SetMetallicFactor(1.f); + library.MutableMaterial(2)->SetMetallicFactor(2.f); + library.MutableMaterial(3)->SetMetallicFactor(3.f); + + ASSERT_EQ(library.NumMaterials(), 4); + + ASSERT_EQ(library.RemoveMaterial(0)->GetMetallicFactor(), 0.f); + ASSERT_EQ(library.NumMaterials(), 3); + + ASSERT_EQ(library.RemoveMaterial(1)->GetMetallicFactor(), 2.f); + ASSERT_EQ(library.NumMaterials(), 2); + + ASSERT_EQ(library.RemoveMaterial(1)->GetMetallicFactor(), 3.f); + ASSERT_EQ(library.NumMaterials(), 1); + + ASSERT_EQ(library.RemoveMaterial(0)->GetMetallicFactor(), 1.f); + ASSERT_EQ(library.NumMaterials(), 0); +} + +#endif // DRACO_TRANSCODER_SUPPORTED + +} // namespace diff --git a/contrib/draco/src/draco/material/material_test.cc b/contrib/draco/src/draco/material/material_test.cc new file mode 100644 index 000000000..8c999a532 --- /dev/null +++ b/contrib/draco/src/draco/material/material_test.cc @@ -0,0 +1,320 @@ +// Copyright 2018 The Draco Authors. +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. +// +#include "draco/material/material.h" + +#ifdef DRACO_TRANSCODER_SUPPORTED +#include "draco/core/draco_test_utils.h" +#include "draco/io/texture_io.h" + +namespace { + +TEST(MaterialTest, TestMaterialAccess) { + // Tests that we can set and get material properties. + draco::Material material; + + material.SetName("Superalloy"); + ASSERT_EQ(material.GetName(), "Superalloy"); + material.SetColorFactor(draco::Vector4f(1.f, 0.2f, 0.1f, 0.9f)); + ASSERT_EQ(material.GetColorFactor(), draco::Vector4f(1.f, 0.2f, 0.1f, 0.9f)); + material.SetMetallicFactor(0.3f); + ASSERT_EQ(material.GetMetallicFactor(), 0.3f); + material.SetRoughnessFactor(0.2f); + ASSERT_EQ(material.GetRoughnessFactor(), 0.2f); + material.SetEmissiveFactor(draco::Vector3f(0.2f, 0.f, 0.1f)); + ASSERT_EQ(material.GetEmissiveFactor(), draco::Vector3f(0.2f, 0.f, 0.1f)); + + // Set and check the properties of material extensions. + material.SetUnlit(true); + ASSERT_TRUE(material.GetUnlit()); + material.SetHasSheen(true); + ASSERT_TRUE(material.HasSheen()); + material.SetSheenColorFactor(draco::Vector3f(0.4f, 0.2f, 0.8f)); + ASSERT_EQ(material.GetSheenColorFactor(), draco::Vector3f(0.4f, 0.2f, 0.8f)); + material.SetSheenRoughnessFactor(0.428f); + ASSERT_EQ(material.GetSheenRoughnessFactor(), 0.428f); + material.SetHasTransmission(true); + ASSERT_TRUE(material.HasTransmission()); + material.SetTransmissionFactor(0.5f); + ASSERT_EQ(material.GetTransmissionFactor(), 0.5f); + material.SetHasClearcoat(true); + ASSERT_TRUE(material.HasClearcoat()); + material.SetClearcoatFactor(0.6f); + ASSERT_EQ(material.GetClearcoatFactor(), 0.6f); + material.SetClearcoatRoughnessFactor(0.7f); + ASSERT_EQ(material.GetClearcoatRoughnessFactor(), 0.7f); + material.SetHasVolume(true); + ASSERT_TRUE(material.HasVolume()); + material.SetThicknessFactor(0.8f); + ASSERT_EQ(material.GetThicknessFactor(), 0.8f); + material.SetAttenuationDistance(0.9f); + ASSERT_EQ(material.GetAttenuationDistance(), 0.9f); + material.SetAttenuationColor(draco::Vector3f(0.2f, 0.5f, 0.8f)); + ASSERT_EQ(material.GetAttenuationColor(), draco::Vector3f(0.2f, 0.5f, 0.8f)); + material.SetHasIor(true); + ASSERT_TRUE(material.HasIor()); + material.SetIor(1.1f); + ASSERT_EQ(material.GetIor(), 1.1f); + material.SetHasSpecular(true); + ASSERT_TRUE(material.HasSpecular()); + material.SetSpecularFactor(0.01f); + ASSERT_EQ(material.GetSpecularFactor(), 0.01f); + material.SetSpecularColorFactor(draco::Vector3f(0.4f, 1.f, 1.f)); + ASSERT_EQ(material.GetSpecularColorFactor(), draco::Vector3f(0.4f, 1.f, 1.f)); + + ASSERT_EQ(material.GetTextureMapByType(draco::TextureMap::COLOR), nullptr); + ASSERT_EQ(material.NumTextureMaps(), 0); + + std::unique_ptr texture = + draco::ReadTextureFromFile(draco::GetTestFileFullPath("test.png")) + .value(); + ASSERT_NE(texture, nullptr); + + material.SetTextureMap(std::move(texture), draco::TextureMap::COLOR, 0); + + ASSERT_NE(material.GetTextureMapByType(draco::TextureMap::COLOR), nullptr); + ASSERT_EQ(material.NumTextureMaps(), 1); + ASSERT_EQ(material.GetTextureMapByIndex(0), + material.GetTextureMapByType(draco::TextureMap::COLOR)); + + std::unique_ptr texture2 = + draco::ReadTextureFromFile(draco::GetTestFileFullPath("test.png")) + .value(); + ASSERT_NE(texture2, nullptr); + material.SetTextureMap(std::move(texture2), draco::TextureMap::EMISSIVE, 1); + + ASSERT_NE(material.GetTextureMapByType(draco::TextureMap::EMISSIVE), nullptr); + ASSERT_EQ(material.GetTextureMapByType(draco::TextureMap::EMISSIVE) + ->tex_coord_index(), + 1); + ASSERT_EQ(material.NumTextureMaps(), 2); + + // Try to add the emissive texture one more time. This should replace the + // previous instance of the emissive texture on the material. + std::unique_ptr texture3 = + draco::ReadTextureFromFile(draco::GetTestFileFullPath("test.png")) + .value(); + ASSERT_NE(texture3, nullptr); + material.SetTextureMap(std::move(texture2), draco::TextureMap::EMISSIVE, 2); + ASSERT_EQ(material.NumTextureMaps(), 2); + ASSERT_EQ(material.GetTextureMapByType(draco::TextureMap::EMISSIVE) + ->tex_coord_index(), + 2); + + std::unique_ptr texture_map4(new draco::TextureMap()); + std::unique_ptr texture4 = + draco::ReadTextureFromFile(draco::GetTestFileFullPath("test.png")) + .value(); + material.SetTextureMap(std::move(texture4), draco::TextureMap::ROUGHNESS, 0); + ASSERT_EQ(material.NumTextureMaps(), 3); + ASSERT_NE(material.GetTextureMapByType(draco::TextureMap::ROUGHNESS), + nullptr); + + material.SetTransparencyMode(draco::Material::TRANSPARENCY_BLEND); + ASSERT_EQ(material.GetTransparencyMode(), + draco::Material::TRANSPARENCY_BLEND); + material.SetAlphaCutoff(0.2f); + ASSERT_EQ(material.GetAlphaCutoff(), 0.2f); + material.SetNormalTextureScale(0.75f); + ASSERT_EQ(material.GetNormalTextureScale(), 0.75f); + + material.ClearTextureMaps(); + ASSERT_EQ(material.NumTextureMaps(), 0); + ASSERT_EQ(material.GetTextureMapByType(draco::TextureMap::COLOR), nullptr); + + // Metallic factor should be unchanged. + ASSERT_EQ(material.GetMetallicFactor(), 0.3f); + + material.Clear(); + // Metallic factor should be reset to default. + ASSERT_NE(material.GetMetallicFactor(), 0.3f); + + ASSERT_EQ(material.GetDoubleSided(), false); + material.SetDoubleSided(true); + ASSERT_EQ(material.GetDoubleSided(), true); +} + +TEST(MaterialTest, TestMaterialCopy) { + draco::Material material; + material.SetName("Antimatter"); + material.SetColorFactor(draco::Vector4f(0.3f, 0.2f, 0.4f, 0.9f)); + material.SetMetallicFactor(0.2f); + material.SetRoughnessFactor(0.4f); + material.SetEmissiveFactor(draco::Vector3f(0.3f, 0.1f, 0.2f)); + material.SetTransparencyMode(draco::Material::TRANSPARENCY_MASK); + material.SetAlphaCutoff(0.25f); + material.SetDoubleSided(true); + material.SetNormalTextureScale(0.75f); + + // Set the properties of material extensions. + material.SetUnlit(true); + material.SetHasSheen(true); + material.SetSheenColorFactor(draco::Vector3f(0.4f, 0.2f, 0.8f)); + material.SetSheenRoughnessFactor(0.428f); + material.SetHasTransmission(true); + material.SetTransmissionFactor(0.5f); + material.SetHasClearcoat(true); + material.SetClearcoatFactor(0.6f); + material.SetClearcoatRoughnessFactor(0.7f); + material.SetHasVolume(true); + material.SetThicknessFactor(0.8f); + material.SetAttenuationDistance(0.9f); + material.SetAttenuationColor(draco::Vector3f(0.2f, 0.5f, 0.8f)); + material.SetHasIor(true); + material.SetIor(1.1f); + material.SetHasSpecular(true); + material.SetSpecularFactor(0.01f); + material.SetSpecularColorFactor(draco::Vector3f(0.4f, 1.f, 1.f)); + + std::unique_ptr texture = + draco::ReadTextureFromFile(draco::GetTestFileFullPath("test.png")) + .value(); + ASSERT_NE(texture, nullptr); + material.SetTextureMap(std::move(texture), draco::TextureMap::EMISSIVE, 2); + + draco::Material new_material; + new_material.Copy(material); + + ASSERT_EQ(material.GetName(), new_material.GetName()); + ASSERT_EQ(material.GetColorFactor(), new_material.GetColorFactor()); + ASSERT_EQ(material.GetMetallicFactor(), new_material.GetMetallicFactor()); + ASSERT_EQ(material.GetRoughnessFactor(), new_material.GetRoughnessFactor()); + ASSERT_EQ(material.GetEmissiveFactor(), new_material.GetEmissiveFactor()); + ASSERT_EQ(material.GetTransparencyMode(), new_material.GetTransparencyMode()); + ASSERT_EQ(material.GetAlphaCutoff(), new_material.GetAlphaCutoff()); + ASSERT_EQ(material.GetDoubleSided(), new_material.GetDoubleSided()); + ASSERT_EQ(material.GetNormalTextureScale(), + new_material.GetNormalTextureScale()); + + // Check that the properties of material extensions have been copied. + ASSERT_EQ(material.GetUnlit(), new_material.GetUnlit()); + ASSERT_EQ(material.HasSheen(), new_material.HasSheen()); + ASSERT_EQ(material.GetSheenColorFactor(), new_material.GetSheenColorFactor()); + ASSERT_EQ(material.GetSheenRoughnessFactor(), + new_material.GetSheenRoughnessFactor()); + ASSERT_TRUE(material.HasTransmission()); + ASSERT_EQ(material.GetTransmissionFactor(), + new_material.GetTransmissionFactor()); + ASSERT_TRUE(material.HasClearcoat()); + ASSERT_EQ(material.GetClearcoatFactor(), new_material.GetClearcoatFactor()); + ASSERT_EQ(material.GetClearcoatRoughnessFactor(), + new_material.GetClearcoatRoughnessFactor()); + ASSERT_TRUE(material.HasVolume()); + ASSERT_EQ(material.GetThicknessFactor(), new_material.GetThicknessFactor()); + ASSERT_EQ(material.GetAttenuationDistance(), + new_material.GetAttenuationDistance()); + ASSERT_EQ(material.GetAttenuationColor(), new_material.GetAttenuationColor()); + ASSERT_TRUE(material.HasIor()); + ASSERT_EQ(material.GetIor(), new_material.GetIor()); + ASSERT_TRUE(material.HasSpecular()); + ASSERT_EQ(material.GetSpecularFactor(), new_material.GetSpecularFactor()); + ASSERT_EQ(material.GetSpecularColorFactor(), + new_material.GetSpecularColorFactor()); + + for (int i = 0; i < draco::TextureMap::TEXTURE_TYPES_COUNT; ++i) { + const draco::TextureMap::Type texture_map_type = + static_cast(i); + if (material.GetTextureMapByType(texture_map_type) == nullptr) { + ASSERT_EQ(new_material.GetTextureMapByType(texture_map_type), nullptr); + continue; + } + if (material.GetTextureMapByType(texture_map_type)->texture() == nullptr) { + ASSERT_EQ(new_material.GetTextureMapByType(texture_map_type)->texture(), + nullptr); + } else { + ASSERT_NE(new_material.GetTextureMapByType(texture_map_type)->texture(), + nullptr); + ASSERT_EQ( + material.GetTextureMapByType(texture_map_type)->tex_coord_index(), + new_material.GetTextureMapByType(texture_map_type) + ->tex_coord_index()); + } + } + + ASSERT_EQ(material.NumTextureMaps(), new_material.NumTextureMaps()); + for (int i = 0; i < material.NumTextureMaps(); ++i) { + const draco::TextureMap *const tm0 = material.GetTextureMapByIndex(i); + const draco::TextureMap *const tm1 = new_material.GetTextureMapByIndex(i); + ASSERT_NE(tm0, nullptr); + ASSERT_NE(tm1, nullptr); + ASSERT_EQ(tm0->type(), tm1->type()); + } +} + +TEST(MaterialTest, RemoveTextureMap) { + // Tests that we can remove existing texture maps from a material. + draco::Material material; + + // Add some dummy textures to the material. + std::unique_ptr texture = + draco::ReadTextureFromFile(draco::GetTestFileFullPath("test.png")) + .value(); + ASSERT_NE(texture, nullptr); + material.SetTextureMap(std::move(texture), draco::TextureMap::COLOR, 0); + + std::unique_ptr texture_2 = + draco::ReadTextureFromFile(draco::GetTestFileFullPath("test.png")) + .value(); + + material.SetTextureMap(std::move(texture), draco::TextureMap::EMISSIVE, 0); + + ASSERT_EQ(material.NumTextureMaps(), 2); + + // Try to delete the color texture. + std::unique_ptr removed_texture = + material.RemoveTextureMapByType(draco::TextureMap::COLOR); + ASSERT_NE(removed_texture, nullptr); + ASSERT_EQ(removed_texture->type(), draco::TextureMap::COLOR); + ASSERT_EQ(material.NumTextureMaps(), 1); + ASSERT_NE(material.GetTextureMapByType(draco::TextureMap::EMISSIVE), nullptr); + ASSERT_EQ(material.GetTextureMapByIndex(0)->type(), + draco::TextureMap::EMISSIVE); + ASSERT_EQ(material.GetTextureMapByType(draco::TextureMap::COLOR), nullptr); + + removed_texture = material.RemoveTextureMapByIndex(0); + ASSERT_NE(removed_texture, nullptr); + ASSERT_EQ(removed_texture->type(), draco::TextureMap::EMISSIVE); + ASSERT_EQ(material.NumTextureMaps(), 0); + ASSERT_EQ(material.GetTextureMapByType(draco::TextureMap::EMISSIVE), nullptr); +} + +TEST(MaterialTest, SharedTexture) { + // Tests adding shared textures. + draco::Material material; + + // Add some dummy textures to the material. + std::unique_ptr texture = + draco::ReadTextureFromFile(draco::GetTestFileFullPath("test.png")) + .value(); + ASSERT_NE(texture, nullptr); + draco::Texture *texture_raw = texture.get(); + material.SetTextureMap(std::move(texture), draco::TextureMap::COLOR, 0); + + DRACO_ASSERT_OK( + material.SetTextureMap(texture_raw, draco::TextureMap::EMISSIVE, 0)); + + ASSERT_EQ(material.NumTextureMaps(), 2); + + // Read a new texture. + texture = draco::ReadTextureFromFile(draco::GetTestFileFullPath("test.png")) + .value(); + // Texture is not owned by the material so we expect a failure. + ASSERT_FALSE( + material + .SetTextureMap(texture.get(), draco::TextureMap::AMBIENT_OCCLUSION, 0) + .ok()); +} + +} // namespace +#endif // DRACO_TRANSCODER_SUPPORTED diff --git a/contrib/draco/src/draco/material/material_utils.cc b/contrib/draco/src/draco/material/material_utils.cc new file mode 100644 index 000000000..7f9fcb621 --- /dev/null +++ b/contrib/draco/src/draco/material/material_utils.cc @@ -0,0 +1,14 @@ +// Copyright 2020 The Draco Authors. +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. +// diff --git a/contrib/draco/src/draco/material/material_utils.h b/contrib/draco/src/draco/material/material_utils.h new file mode 100644 index 000000000..7f9fcb621 --- /dev/null +++ b/contrib/draco/src/draco/material/material_utils.h @@ -0,0 +1,14 @@ +// Copyright 2020 The Draco Authors. +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. +// diff --git a/contrib/draco/src/draco/material/material_utils_test.cc b/contrib/draco/src/draco/material/material_utils_test.cc new file mode 100644 index 000000000..82a1227a2 --- /dev/null +++ b/contrib/draco/src/draco/material/material_utils_test.cc @@ -0,0 +1,24 @@ +// Copyright 2020 The Draco Authors. +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. +// +#include "draco/material/material_utils.h" + +#include +#include +#include + +#include "draco/core/draco_test_utils.h" +#include "draco/io/texture_io.h" + +namespace {} // namespace diff --git a/contrib/draco/src/draco/mesh/corner_table.cc b/contrib/draco/src/draco/mesh/corner_table.cc index 3f92f651a..6494c1572 100644 --- a/contrib/draco/src/draco/mesh/corner_table.cc +++ b/contrib/draco/src/draco/mesh/corner_table.cc @@ -15,6 +15,7 @@ #include "draco/mesh/corner_table.h" #include +#include #include "draco/attributes/geometry_indices.h" #include "draco/mesh/corner_table_iterators.h" diff --git a/contrib/draco/src/draco/mesh/corner_table.h b/contrib/draco/src/draco/mesh/corner_table.h index 3aa720fde..3088931c1 100644 --- a/contrib/draco/src/draco/mesh/corner_table.h +++ b/contrib/draco/src/draco/mesh/corner_table.h @@ -21,6 +21,7 @@ #include "draco/attributes/geometry_indices.h" #include "draco/core/draco_index_type_vector.h" #include "draco/core/macros.h" +#include "draco/draco_features.h" #include "draco/mesh/valence_cache.h" namespace draco { diff --git a/contrib/draco/src/draco/mesh/corner_table_iterators.h b/contrib/draco/src/draco/mesh/corner_table_iterators.h index 7122aa1be..72c70ac32 100644 --- a/contrib/draco/src/draco/mesh/corner_table_iterators.h +++ b/contrib/draco/src/draco/mesh/corner_table_iterators.h @@ -15,15 +15,23 @@ #ifndef DRACO_MESH_CORNER_TABLE_ITERATORS_H_ #define DRACO_MESH_CORNER_TABLE_ITERATORS_H_ +#include + #include "draco/mesh/corner_table.h" namespace draco { // Class for iterating over vertices in a 1-ring around the specified vertex. template -class VertexRingIterator - : public std::iterator { +class VertexRingIterator { public: + // Iterator traits expected by std libraries. + using iterator_category = std::forward_iterator_tag; + using value_type = VertexIndex; + using difference_type = std::ptrdiff_t; + using pointer = VertexIndex *; + using reference = VertexIndex &; + // std::iterator interface requires a default constructor. VertexRingIterator() : corner_table_(nullptr), @@ -111,9 +119,15 @@ class VertexRingIterator // Class for iterating over faces adjacent to the specified input face. template -class FaceAdjacencyIterator - : public std::iterator { +class FaceAdjacencyIterator { public: + // Iterator traits expected by std libraries. + using iterator_category = std::forward_iterator_tag; + using value_type = FaceIndex; + using difference_type = std::ptrdiff_t; + using pointer = FaceIndex *; + using reference = FaceIndex &; + // std::iterator interface requires a default constructor. FaceAdjacencyIterator() : corner_table_(nullptr), @@ -193,9 +207,15 @@ class FaceAdjacencyIterator // Class for iterating over corners attached to a specified vertex. template -class VertexCornersIterator - : public std::iterator { +class VertexCornersIterator { public: + // Iterator traits expected by std libraries. + using iterator_category = std::forward_iterator_tag; + using value_type = CornerIndex; + using difference_type = std::ptrdiff_t; + using pointer = CornerIndex *; + using reference = CornerIndex &; + // std::iterator interface requires a default constructor. VertexCornersIterator() : corner_table_(nullptr), diff --git a/contrib/draco/src/draco/mesh/corner_table_test.cc b/contrib/draco/src/draco/mesh/corner_table_test.cc new file mode 100644 index 000000000..f88d3ec96 --- /dev/null +++ b/contrib/draco/src/draco/mesh/corner_table_test.cc @@ -0,0 +1,126 @@ +#include "draco/mesh/corner_table.h" + +#include + +#include "draco/core/draco_test_utils.h" +#include "draco/io/obj_decoder.h" +#include "draco/mesh/mesh_connected_components.h" +#include "draco/mesh/mesh_misc_functions.h" + +namespace draco { + +class CornerTableTest : public ::testing::Test { + protected: + std::unique_ptr DecodeObj(const std::string &file_name) const { + const std::string path = GetTestFileFullPath(file_name); + ObjDecoder decoder; + std::unique_ptr mesh(new Mesh()); + if (!decoder.DecodeFromFile(path, mesh.get()).ok()) { + return nullptr; + } + return mesh; + } + + void TestEncodingCube() { + // Build a CornerTable looking at the mesh and verify that the caching of + // valences are reasonably correct and within range of expectations. This + // test is built specifically for working with 'cubes' and has expectations + // about the degree of each corner. + const std::string file_name = "cube_att.obj"; + std::unique_ptr in_mesh = DecodeObj(file_name); + ASSERT_NE(in_mesh, nullptr) << "Failed to load test model " << file_name; + draco::Mesh *mesh = nullptr; + mesh = in_mesh.get(); + + std::unique_ptr utable = + draco::CreateCornerTableFromPositionAttribute(mesh); + draco::CornerTable *table = utable.get(); + + table->GetValenceCache().CacheValences(); + table->GetValenceCache().CacheValencesInaccurate(); + + for (VertexIndex index = static_cast(0); + index < static_cast(table->num_vertices()); index++) { + const auto valence = table->Valence(index); + const auto valence2 = table->GetValenceCache().ValenceFromCache(index); + const auto valence3 = + table->GetValenceCache().ValenceFromCacheInaccurate(index); + ASSERT_EQ(valence, valence2); + ASSERT_GE(valence, valence3); // may be clipped. + + // No more than 6 triangles can touch a cube corner. + ASSERT_LE(valence, 6); + ASSERT_LE(valence2, 6); + ASSERT_LE(valence3, 6); + + // No less than 3 triangles can touch a cube corner. + ASSERT_GE(valence, 3); + ASSERT_GE(valence2, 3); + ASSERT_GE(valence3, 3); + } + + for (CornerIndex index = static_cast(0); + index < static_cast(table->num_corners()); index++) { + const auto valence = table->Valence(index); + const auto valence2 = table->GetValenceCache().ValenceFromCache(index); + const auto valence3 = + table->GetValenceCache().ValenceFromCacheInaccurate(index); + ASSERT_EQ(valence, valence2); + ASSERT_GE(valence, valence3); // may be clipped. + + // No more than 6 triangles can touch a cube corner, 6 edges result. + ASSERT_LE(valence, 6); + ASSERT_LE(valence2, 6); + ASSERT_LE(valence3, 6); + + // No less than 3 triangles can touch a cube corner, 3 edges result. + ASSERT_GE(valence, 3); + ASSERT_GE(valence2, 3); + ASSERT_GE(valence3, 3); + } + + table->GetValenceCache().ClearValenceCache(); + table->GetValenceCache().ClearValenceCacheInaccurate(); + } +}; + +TEST_F(CornerTableTest, NormalWithSeams) { TestEncodingCube(); } + +TEST_F(CornerTableTest, TestNonManifoldEdges) { + std::unique_ptr mesh = DecodeObj("non_manifold_wrap.obj"); + ASSERT_NE(mesh, nullptr); + std::unique_ptr ct = + draco::CreateCornerTableFromPositionAttribute(mesh.get()); + ASSERT_NE(ct, nullptr); + + MeshConnectedComponents connected_components; + connected_components.FindConnectedComponents(ct.get()); + ASSERT_EQ(connected_components.NumConnectedComponents(), 2); +} + +TEST_F(CornerTableTest, TestNewFace) { + // Tests that we can add a new face to the corner table. + const std::string file_name = "cube_att.obj"; + std::unique_ptr mesh = DecodeObj(file_name); + ASSERT_NE(mesh, nullptr); + + std::unique_ptr ct = + draco::CreateCornerTableFromPositionAttribute(mesh.get()); + ASSERT_NE(ct, nullptr); + ASSERT_EQ(ct->num_faces(), 12); + ASSERT_EQ(ct->num_corners(), 3 * 12); + ASSERT_EQ(ct->num_vertices(), 8); + + const VertexIndex new_vi = ct->AddNewVertex(); + ASSERT_EQ(ct->num_vertices(), 9); + + ASSERT_EQ(ct->AddNewFace({VertexIndex(6), VertexIndex(7), new_vi}), 12); + ASSERT_EQ(ct->num_faces(), 13); + ASSERT_EQ(ct->num_corners(), 3 * 13); + + ASSERT_EQ(ct->Vertex(CornerIndex(3 * 12 + 0)), 6); + ASSERT_EQ(ct->Vertex(CornerIndex(3 * 12) + 1), 7); + ASSERT_EQ(ct->Vertex(CornerIndex(3 * 12) + 2), new_vi); +} + +} // namespace draco diff --git a/contrib/draco/src/draco/mesh/mesh.cc b/contrib/draco/src/draco/mesh/mesh.cc index 3be4b1494..b287ecb45 100644 --- a/contrib/draco/src/draco/mesh/mesh.cc +++ b/contrib/draco/src/draco/mesh/mesh.cc @@ -15,6 +15,10 @@ #include "draco/mesh/mesh.h" #include +#include +#include +#include +#include namespace draco { @@ -22,7 +26,436 @@ namespace draco { template using conditional_t = typename std::conditional::type; +#ifdef DRACO_TRANSCODER_SUPPORTED +Mesh::Mesh() : compression_enabled_(false) {} +#else Mesh::Mesh() {} +#endif + +#ifdef DRACO_TRANSCODER_SUPPORTED +void Mesh::Copy(const Mesh &src) { + PointCloud::Copy(src); + name_ = src.name_; + faces_ = src.faces_; + attribute_data_ = src.attribute_data_; + material_library_.Copy(src.material_library_); + compression_enabled_ = src.compression_enabled_; + compression_options_ = src.compression_options_; + + // Copy mesh feature ID sets. + mesh_features_.clear(); + for (MeshFeaturesIndex i(0); i < src.NumMeshFeatures(); i++) { + std::unique_ptr mesh_features(new MeshFeatures()); + mesh_features->Copy(src.GetMeshFeatures(i)); + AddMeshFeatures(std::move(mesh_features)); + } + mesh_features_material_mask_ = src.mesh_features_material_mask_; + + // Copy non-material textures. + non_material_texture_library_.Copy(src.non_material_texture_library_); + + // Update pointers to non-material textures in mesh feature ID sets. + if (non_material_texture_library_.NumTextures() != 0) { + const auto texture_to_index_map = + src.non_material_texture_library_.ComputeTextureToIndexMap(); + for (MeshFeaturesIndex j(0); j < NumMeshFeatures(); ++j) { + Mesh::UpdateMeshFeaturesTexturePointer(texture_to_index_map, + &non_material_texture_library_, + &GetMeshFeatures(j)); + } + } + + // Copy structural metadata. + structural_metadata_.Copy(src.structural_metadata_); +} + +namespace { +// A helper struct that augments a point index with an attribute value index. +// A unique combination of |point_index| and |attribute_value_index| +// corresponds to a unique point on the mesh. Used to identify unique points +// after a new attribute is added to the mesh. +struct AugmentedPointData { + PointIndex point_index; + AttributeValueIndex attribute_value_index; + bool operator<(const AugmentedPointData &pd) const { + if (point_index < pd.point_index) { + return true; + } + if (point_index > pd.point_index) { + return false; + } + return attribute_value_index < pd.attribute_value_index; + } +}; +} // namespace + +int32_t Mesh::AddAttributeWithConnectivity( + std::unique_ptr att, + const IndexTypeVector &corner_to_value) { + // Map between augmented point and new point indices (one augmented point + // corresponds to one PointIndex). + std::map old_to_new_point_map; + + // Map between corners and the new point indices. + IndexTypeVector corner_to_point(num_faces() * 3, + kInvalidPointIndex); + + // Flag whether a given existing point index has been used. Used to ensure + // that mapping between existing and new point indices that are smaller + // than num_points() is identity. In other words, we want to keep indices of + // the existing points intact and add new points to end. + IndexTypeVector is_point_used(num_points(), false); + + int new_num_points = num_points(); + for (CornerIndex ci(0); ci < num_faces() * 3; ++ci) { + AugmentedPointData apd; + apd.point_index = CornerToPointId(ci); + apd.attribute_value_index = corner_to_value[ci]; + const auto it = old_to_new_point_map.find(apd); + if (it != old_to_new_point_map.end()) { + // Augmented point is already mapped to a point index. Reuse it. + corner_to_point[ci] = it->second; + } else { + // New combination of point index + attribute value index. Map it to a + // unique point index. + PointIndex new_point_index; + if (!is_point_used[apd.point_index]) { + // Reuse the existing (old) point index. + new_point_index = apd.point_index; + is_point_used[apd.point_index] = true; + } else { + // Add a new point index to the end. + new_point_index = PointIndex(new_num_points++); + } + old_to_new_point_map[apd] = new_point_index; + corner_to_point[ci] = new_point_index; + } + } + + // Update point to attribute value mapping for the new attribute. + att->SetExplicitMapping(new_num_points); + for (CornerIndex ci(0); ci < num_faces() * 3; ++ci) { + att->SetPointMapEntry(corner_to_point[ci], corner_to_value[ci]); + } + + // Update point to attribute value mapping on the remaining attributes if + // needed. + if (new_num_points > num_points()) { + set_num_points(new_num_points); + + // Setup attributes for the new number of points. + for (int ai = 0; ai < num_attributes(); ++ai) { + const bool mapping_was_identity = attribute(ai)->is_mapping_identity(); + attribute(ai)->SetExplicitMapping(new_num_points); + if (mapping_was_identity) { + // Convert all old points from identity to explicit mapping. + for (AttributeValueIndex avi(0); avi < attribute(ai)->size(); ++avi) { + attribute(ai)->SetPointMapEntry(PointIndex(avi.value()), avi); + } + } + } + + for (CornerIndex ci(0); ci < num_faces() * 3; ++ci) { + const PointIndex old_point_index = CornerToPointId(ci); + const PointIndex new_point_index = corner_to_point[ci]; + if (old_point_index == new_point_index) { + continue; + } + // Update point to value mapping for all existing attributes. + for (int ai = 0; ai < num_attributes(); ++ai) { + attribute(ai)->SetPointMapEntry( + new_point_index, attribute(ai)->mapped_index(old_point_index)); + } + // Update mapping between the corner and the new point index. + faces_[FaceIndex(ci.value() / 3)][ci.value() % 3] = new_point_index; + } + } + + // If any of the old points have not been used, initialize dummy mapping for + // the new attribute. + for (PointIndex pi(0); pi < is_point_used.size(); ++pi) { + if (!is_point_used[pi]) { + att->SetPointMapEntry(pi, AttributeValueIndex(0)); + } + } + + return PointCloud::AddAttribute(std::move(att)); +} + +int32_t Mesh::AddPerVertexAttribute(std::unique_ptr att) { + const PointAttribute *const pos_att = + GetNamedAttribute(GeometryAttribute::POSITION); + if (pos_att == nullptr) { + return -1; + } + if (att->size() != pos_att->size()) { + return -1; // Number of values must be same as in the position attribute. + } + + if (pos_att->is_mapping_identity()) { + att->SetIdentityMapping(); + } else { + // Copy point to attribute value mapping from the position attribute to + // |att|. + att->SetExplicitMapping(num_points()); + for (PointIndex pi(0); pi < num_points(); ++pi) { + att->SetPointMapEntry(pi, pos_att->mapped_index(pi)); + } + } + + return PointCloud::AddAttribute(std::move(att)); +} + +void Mesh::RemoveIsolatedPoints() { + // For each point, check if it is mapped to a face. + IndexTypeVector is_point_used(num_points(), false); + int num_used_points = 0; + for (FaceIndex fi(0); fi < num_faces(); ++fi) { + const auto &f = face(fi); + for (int c = 0; c < 3; ++c) { + if (!is_point_used[f[c]]) { + num_used_points++; + is_point_used[f[c]] = true; + } + } + } + if (num_used_points == num_points()) { + return; // All points are used. + } + + // Create mapping between the old and new point indices. + IndexTypeVector old_to_new_point_map( + num_points(), kInvalidPointIndex); + PointIndex new_point_index(0); + for (PointIndex pi(0); pi < num_points(); ++pi) { + if (is_point_used[pi]) { + old_to_new_point_map[pi] = new_point_index++; + } + } + + // Update point to attribute value index map for all attributes. + for (int ai = 0; ai < num_attributes(); ++ai) { + PointAttribute *att = attribute(ai); + if (att->is_mapping_identity()) { + // When the attribute uses identity mapping we need to reorder to the + // attribute values to match the new point indices. + for (PointIndex pi(0); pi < num_points(); ++pi) { + const PointIndex new_pi = old_to_new_point_map[pi]; + if (new_pi == pi || new_pi == kInvalidPointIndex) { + continue; + } + att->SetAttributeValue( + AttributeValueIndex(new_pi.value()), + att->GetAddress(AttributeValueIndex(pi.value()))); + } + att->Resize(num_used_points); + } else { + // For explicitly mapped attributes, we first update the point to + // attribute value mapping and then we remove all unused values from the + // attribute. + for (PointIndex pi(0); pi < num_points(); ++pi) { + const PointIndex new_pi = old_to_new_point_map[pi]; + if (new_pi == pi || new_pi == kInvalidPointIndex) { + continue; + } + att->SetPointMapEntry(new_pi, att->mapped_index(pi)); + } + att->SetExplicitMapping(num_used_points); + + att->RemoveUnusedValues(); + } + } + + // Update the mapping between faces and point indices. + for (FaceIndex fi(0); fi < num_faces(); ++fi) { + auto &f = faces_[fi]; + for (int c = 0; c < 3; ++c) { + f[c] = old_to_new_point_map[f[c]]; + } + } + + set_num_points(num_used_points); +} + +void Mesh::RemoveUnusedMaterials() { RemoveUnusedMaterials(true); } + +void Mesh::RemoveUnusedMaterials(bool remove_unused_material_indices) { + const int mat_att_index = GetNamedAttributeId(GeometryAttribute::MATERIAL); + if (mat_att_index == -1) { + // Remove all materials except for the first one. + while (GetMaterialLibrary().NumMaterials() > 1) { + GetMaterialLibrary().RemoveMaterial(1); + } + GetMaterialLibrary().RemoveUnusedTextures(); + return; + } + auto mat_att = attribute(mat_att_index); + + // Deduplicate attribute values in the material attribute to ensure that one + // attribute value index corresponds to one unique material index. + // Note that this does not remove unused material indices. + mat_att->DeduplicateValues(*mat_att); + + // Gather all material indices that are referenced by faces of the mesh. + const int num_materials = GetMaterialLibrary().NumMaterials(); + std::vector is_material_used(num_materials, false); + int num_used_materials = 0; + + // Helper function that updates |is_material_used| for the processed mesh. + auto update_used_materials = [&is_material_used, &num_used_materials, mat_att, + num_materials](PointIndex pi) { + uint32_t mat_index = 0; + mat_att->GetMappedValue(pi, &mat_index); + if (mat_index < num_materials) { + if (!is_material_used[mat_index]) { + is_material_used[mat_index] = true; + num_used_materials++; + } + } + }; + + if (num_faces() > 0) { + for (FaceIndex fi(0); fi < num_faces(); ++fi) { + update_used_materials(faces_[fi][0]); + } + } else { + // Handle the mesh as a point cloud and check materials used by points. + for (PointIndex pi(0); pi < num_points(); ++pi) { + update_used_materials(pi); + } + } + + // Check if any of the (unused) materials is used by mesh features. If so, + // user should remove unused mesh features first. + for (MeshFeaturesIndex mfi(0); mfi < NumMeshFeatures(); ++mfi) { + for (int mask_index = 0; mask_index < NumMeshFeaturesMaterialMasks(mfi); + ++mask_index) { + const int mat_index = GetMeshFeaturesMaterialMask(mfi, mask_index); + if (mat_index < num_materials && !is_material_used[mat_index]) { + is_material_used[mat_index] = true; + num_used_materials++; + } + } + } + + if (num_used_materials == num_materials) { + return; // All materials are used, don't do anything. + } + + // Remove unused materials from the material library or replace them with + // default materials if we do not remove unused material indices. + for (int mi = num_materials - 1; mi >= 0; --mi) { + if (!is_material_used[mi] && mi < GetMaterialLibrary().NumMaterials()) { + if (remove_unused_material_indices) { + GetMaterialLibrary().RemoveMaterial(mi); + } else { + GetMaterialLibrary().MutableMaterial(mi)->Clear(); + } + } + } + GetMaterialLibrary().RemoveUnusedTextures(); + + if (!remove_unused_material_indices) { + // All the code below handles updating of material indices. Since we do not + // want to update them, we can return early. + return; + } + + // Compute map between old and new material indices. + std::vector old_to_new_material_index_map(num_materials, -1); + for (int mi = 0, new_material_index = 0; mi < num_materials; ++mi) { + if (is_material_used[mi]) { + old_to_new_material_index_map[mi] = new_material_index; + ++new_material_index; + } + } + IndexTypeVector + old_to_new_material_attribute_value_index_map(mat_att->size(), -1); + for (AttributeValueIndex avi(0); avi < mat_att->size(); ++avi) { + uint32_t mat_index = 0; + mat_att->GetValue(avi, &mat_index); + if (mat_index < num_materials && is_material_used[mat_index]) { + old_to_new_material_attribute_value_index_map[avi] = + old_to_new_material_index_map[mat_index]; + } + } + + // Update attribute values with the new number of materials. + mat_att->Reset(num_used_materials); + + // Set identity mapping between AttributeValueIndex and material indices. + for (AttributeValueIndex avi(0); avi < mat_att->size(); ++avi) { + const uint32_t mat_index = avi.value(); + mat_att->SetAttributeValue(avi, &mat_index); + } + + // Update mapping between points and attribute values. + for (PointIndex pi(0); pi < num_points(); ++pi) { + const AttributeValueIndex old_avi = mat_att->mapped_index(pi); + mat_att->SetPointMapEntry( + pi, AttributeValueIndex( + old_to_new_material_attribute_value_index_map[old_avi])); + } + + // Update material indices on mesh features. + for (MeshFeaturesIndex mfi(0); mfi < NumMeshFeatures(); ++mfi) { + for (int mask_index = 0; mask_index < NumMeshFeaturesMaterialMasks(mfi); + ++mask_index) { + const int old_mat_index = GetMeshFeaturesMaterialMask(mfi, mask_index); + if (old_mat_index < num_materials && is_material_used[old_mat_index]) { + mesh_features_material_mask_[mfi][mask_index] = + old_to_new_material_index_map[old_mat_index]; + } + } + } +} + +void Mesh::UpdateMeshFeaturesTexturePointer( + const std::unordered_map &texture_to_index_map, + TextureLibrary *texture_library, MeshFeatures *mesh_features) { + TextureMap &texture_map = mesh_features->GetTextureMap(); + if (texture_map.texture() == nullptr) { + return; + } + const auto it = texture_to_index_map.find(texture_map.texture()); + DRACO_DCHECK(it != texture_to_index_map.end()); + const int texture_index = it->second; + DRACO_DCHECK(texture_index < texture_library->NumTextures()); + texture_map.SetTexture(texture_library->GetTexture(texture_index)); +} + +void Mesh::CopyMeshFeaturesForMaterial(const Mesh &source_mesh, + Mesh *target_mesh, int material_index) { + for (MeshFeaturesIndex mfi(0); mfi < source_mesh.NumMeshFeatures(); ++mfi) { + // Mesh features is used if it doesn't have any material mask or if one + // of the material masks matches |material_index|. + bool is_used = source_mesh.NumMeshFeaturesMaterialMasks(mfi) == 0; + for (int mask_index = 0; + !is_used && mask_index < source_mesh.NumMeshFeaturesMaterialMasks(mfi); + ++mask_index) { + if (source_mesh.GetMeshFeaturesMaterialMask(mfi, mask_index) == + material_index) { + is_used = true; + } + } + if (is_used) { + // Copy over the mesh features to the target mesh. Note that texture + // pointers are not updated at this step. + std::unique_ptr new_mf(new MeshFeatures()); + new_mf->Copy(source_mesh.GetMeshFeatures(mfi)); + target_mesh->AddMeshFeatures(std::move(new_mf)); + } + } +} + +int32_t Mesh::AddPerFaceAttribute(std::unique_ptr att) { + IndexTypeVector corner_map(num_faces() * 3); + for (CornerIndex ci(0); ci < num_faces() * 3; ++ci) { + corner_map[ci] = AttributeValueIndex(ci.value() / 3); + } + return AddAttributeWithConnectivity(std::move(att), corner_map); +} +#endif // DRACO_TRANSCODER_SUPPORTED #ifdef DRACO_ATTRIBUTE_INDICES_DEDUPLICATION_SUPPORTED void Mesh::ApplyPointIdDeduplication( diff --git a/contrib/draco/src/draco/mesh/mesh.h b/contrib/draco/src/draco/mesh/mesh.h index f4506da81..652c2c010 100644 --- a/contrib/draco/src/draco/mesh/mesh.h +++ b/contrib/draco/src/draco/mesh/mesh.h @@ -16,12 +16,20 @@ #define DRACO_MESH_MESH_H_ #include +#include #include "draco/attributes/geometry_indices.h" #include "draco/core/hash_utils.h" #include "draco/core/macros.h" #include "draco/core/status.h" #include "draco/draco_features.h" +#ifdef DRACO_TRANSCODER_SUPPORTED +#include "draco/compression/draco_compression_options.h" +#include "draco/material/material_library.h" +#include "draco/mesh/mesh_features.h" +#include "draco/mesh/mesh_indices.h" +#include "draco/metadata/structural_metadata.h" +#endif #include "draco/point_cloud/point_cloud.h" namespace draco { @@ -47,6 +55,11 @@ class Mesh : public PointCloud { Mesh(); +#ifdef DRACO_TRANSCODER_SUPPORTED + // Copies all data from the |src| mesh. + void Copy(const Mesh &src); +#endif + void AddFace(const Face &face) { faces_.push_back(face); } void SetFace(FaceIndex face_id, const Face &face) { @@ -83,6 +96,38 @@ class Mesh : public PointCloud { } } +#ifdef DRACO_TRANSCODER_SUPPORTED + // Adds a point attribute |att| to the mesh and returns the index of the + // newly inserted attribute. Attribute connectivity data is specified in + // |corner_to_value| array that contains mapping between face corners and + // attribute value indices. + // The purpose of this function is to allow users to add attributes with + // arbitrary connectivity to an existing mesh. New points will be + // automatically created if needed. + int32_t AddAttributeWithConnectivity( + std::unique_ptr att, + const IndexTypeVector &corner_to_value); + + // Adds a point attribute |att| to the mesh and returns the index of the + // newly inserted attribute. The inserted attribute must have the same + // connectivity as the position attribute of the mesh (that is, the attribute + // values are defined per-vertex). Each attribute value entry in |att| + // corresponds to the corresponding attribute value entry in the position + // attribute (AttributeValueIndex in both attributes refer to the same + // spatial vertex). + // Returns -1 in case of error. + int32_t AddPerVertexAttribute(std::unique_ptr att); + + // Removes points that are not mapped to any face of the mesh. All attribute + // values are going to be removed as well. + void RemoveIsolatedPoints(); + + // Adds a point attribute |att| to the mesh and returns the index of the + // newly inserted attribute. Attribute values are mapped 1:1 to face indices. + // Returns -1 in case of error. + int32_t AddPerFaceAttribute(std::unique_ptr att); +#endif // DRACO_TRANSCODER_SUPPORTED + MeshAttributeElementType GetAttributeElementType(int att_id) const { return attribute_data_[att_id].element_type; } @@ -109,6 +154,103 @@ class Mesh : public PointCloud { MeshAttributeElementType element_type; }; +#ifdef DRACO_TRANSCODER_SUPPORTED + void SetName(const std::string &name) { name_ = name; } + const std::string &GetName() const { return name_; } + const MaterialLibrary &GetMaterialLibrary() const { + return material_library_; + } + MaterialLibrary &GetMaterialLibrary() { return material_library_; } + + // Removes all materials that are not referenced by any face of the mesh. + // Optional argument |remove_unused_material_indices| can be used to control + // whether unusued material indices are removed as well (default = true). + // If material indices are not removed, the unused material indices will + // point to empty (default) materials. + void RemoveUnusedMaterials(); + void RemoveUnusedMaterials(bool remove_unused_material_indices); + + // Enables or disables Draco geometry compression for this mesh. + void SetCompressionEnabled(bool enabled) { compression_enabled_ = enabled; } + bool IsCompressionEnabled() const { return compression_enabled_; } + + // Sets |options| that configure Draco geometry compression. This does not + // enable or disable compression. + void SetCompressionOptions(const DracoCompressionOptions &options) { + compression_options_ = options; + } + const DracoCompressionOptions &GetCompressionOptions() const { + return compression_options_; + } + DracoCompressionOptions &GetCompressionOptions() { + return compression_options_; + } + + // Library that contains non-material textures. + const TextureLibrary &GetNonMaterialTextureLibrary() const { + return non_material_texture_library_; + } + TextureLibrary &GetNonMaterialTextureLibrary() { + return non_material_texture_library_; + } + + // Mesh feature ID sets as defined by EXT_mesh_features glTF extension. + MeshFeaturesIndex AddMeshFeatures( + std::unique_ptr mesh_features) { + mesh_features_.push_back(std::move(mesh_features)); + mesh_features_material_mask_.push_back({}); + return MeshFeaturesIndex(mesh_features_.size() - 1); + } + int NumMeshFeatures() const { return mesh_features_.size(); } + const MeshFeatures &GetMeshFeatures(MeshFeaturesIndex index) const { + return *mesh_features_[index]; + } + MeshFeatures &GetMeshFeatures(MeshFeaturesIndex index) { + return *mesh_features_[index]; + } + void RemoveMeshFeatures(MeshFeaturesIndex index) { + mesh_features_.erase(mesh_features_.begin() + index.value()); + mesh_features_material_mask_.erase(mesh_features_material_mask_.begin() + + index.value()); + } + + // Restricts given mesh features to faces mapped to a material with + // |material_index|. Note that single mesh features can be restricted to + // multiple materials. + void AddMeshFeaturesMaterialMask(MeshFeaturesIndex index, + int material_index) { + mesh_features_material_mask_[index].push_back(material_index); + } + + size_t NumMeshFeaturesMaterialMasks(MeshFeaturesIndex index) const { + return mesh_features_material_mask_[index].size(); + } + int GetMeshFeaturesMaterialMask(MeshFeaturesIndex index, + int mask_index) const { + return mesh_features_material_mask_[index][mask_index]; + } + + // Updates mesh features texture pointer to point to a new |texture_library|. + // The current texture pointer is used to determine the texture index in the + // new texture library via a given |texture_to_index_map|. + static void UpdateMeshFeaturesTexturePointer( + const std::unordered_map &texture_to_index_map, + TextureLibrary *texture_library, MeshFeatures *mesh_features); + + // Copies over mesh features from |source_mesh| and stores them in + // |target_mesh| as long as the mesh features material mask is valid for + // given |material_index|. + static void CopyMeshFeaturesForMaterial(const Mesh &source_mesh, + Mesh *target_mesh, + int material_index); + + // Structural metadata. + const StructuralMetadata &GetStructuralMetadata() const { + return structural_metadata_; + } + StructuralMetadata &GetStructuralMetadata() { return structural_metadata_; } +#endif // DRACO_TRANSCODER_SUPPORTED + protected: #ifdef DRACO_ATTRIBUTE_INDICES_DEDUPLICATION_SUPPORTED // Extends the point deduplication to face corners. This method is called from @@ -119,6 +261,10 @@ class Mesh : public PointCloud { const std::vector &unique_point_ids) override; #endif + // Exposes |faces_|. Use |faces_| at your own risk. DO NOT store the + // reference: the |faces_| object is destroyed with the mesh. + IndexTypeVector &faces() { return faces_; } + private: // Mesh specific per-attribute data. std::vector attribute_data_; @@ -127,6 +273,40 @@ class Mesh : public PointCloud { // that converts vertex indices into attribute indices. IndexTypeVector faces_; +#ifdef DRACO_TRANSCODER_SUPPORTED + // Mesh name. + std::string name_; + + // Materials applied to to this mesh. + MaterialLibrary material_library_; + + // Compression options for this mesh. + // TODO(vytyaz): Store encoded bitstream that this mesh compresses into. + bool compression_enabled_; + DracoCompressionOptions compression_options_; + + // Sets of feature IDs as defined by EXT_mesh_features glTF extension. + IndexTypeVector> + mesh_features_; + + // When the Mesh contains multiple materials, |mesh_features_material_mask_| + // can be used to limit specific MeshFeaturesIndex to a vector of material + // indices. If for a given mesh feature index, the material indices are empty, + // the corresponding mesh features are applied to the entire mesh. + IndexTypeVector> + mesh_features_material_mask_; + + // Texture library for storing non-material textures used by this mesh, e.g., + // textures containing mesh feature IDs of EXT_mesh_features glTF extension. + // If the mesh is part of the scene then the textures are stored in the scene. + // Note that mesh features contain pointers to non-material textures. It is + // responsibility of class user to update these pointers when updating the + // textures. See Mesh::Copy() for example. + TextureLibrary non_material_texture_library_; + + // Structural metadata defined by the EXT_structural_metadata glTF extension. + StructuralMetadata structural_metadata_; +#endif // DRACO_TRANSCODER_SUPPORTED friend struct MeshHasher; }; diff --git a/contrib/draco/src/draco/mesh/mesh_are_equivalent.cc b/contrib/draco/src/draco/mesh/mesh_are_equivalent.cc index b832379af..305811f10 100644 --- a/contrib/draco/src/draco/mesh/mesh_are_equivalent.cc +++ b/contrib/draco/src/draco/mesh/mesh_are_equivalent.cc @@ -15,6 +15,9 @@ #include "draco/mesh/mesh_are_equivalent.h" #include +#include + +#include "draco/texture/texture_utils.h" namespace draco { @@ -114,6 +117,55 @@ bool MeshAreEquivalent::operator()(const Mesh &mesh0, const Mesh &mesh1) { // face with respect to lex order. Init(mesh0, mesh1); +#ifdef DRACO_TRANSCODER_SUPPORTED + // Compare geometry compression settings. + if (mesh0.IsCompressionEnabled() != mesh1.IsCompressionEnabled()) { + return false; + } + if (mesh0.GetCompressionOptions() != mesh1.GetCompressionOptions()) { + return false; + } + + // Compare non-material texture library sizes. + if (mesh0.GetNonMaterialTextureLibrary().NumTextures() != + mesh1.GetNonMaterialTextureLibrary().NumTextures()) { + return false; + } + + // Compare mesh feature ID sets. + if (mesh0.NumMeshFeatures() != mesh1.NumMeshFeatures()) { + return false; + } + for (MeshFeaturesIndex i(0); i < mesh0.NumMeshFeatures(); ++i) { + const MeshFeatures &features0 = mesh0.GetMeshFeatures(i); + const MeshFeatures &features1 = mesh1.GetMeshFeatures(i); + if (features0.GetAttributeIndex() != features1.GetAttributeIndex()) { + return false; + } + if (features0.GetFeatureCount() != features1.GetFeatureCount()) { + return false; + } + if (features0.GetLabel() != features1.GetLabel()) { + return false; + } + if (features0.GetNullFeatureId() != features1.GetNullFeatureId()) { + return false; + } + if (features0.GetTextureChannels() != features1.GetTextureChannels()) { + return false; + } + if (features0.GetPropertyTableIndex() != + features1.GetPropertyTableIndex()) { + return false; + } + const TextureMap &map0 = features0.GetTextureMap(); + const TextureMap &map1 = features1.GetTextureMap(); + if (map0.tex_coord_index() != map1.tex_coord_index()) { + return false; + } + } +#endif // DRACO_TRANSCODER_SUPPORTED + // Check for every attribute that is valid that every corner is identical. typedef GeometryAttribute::Type AttributeType; const int att_max = AttributeType::NAMED_ATTRIBUTES_COUNT; diff --git a/contrib/draco/src/draco/mesh/mesh_are_equivalent_test.cc b/contrib/draco/src/draco/mesh/mesh_are_equivalent_test.cc index 74db3f7de..94d8c9c16 100644 --- a/contrib/draco/src/draco/mesh/mesh_are_equivalent_test.cc +++ b/contrib/draco/src/draco/mesh/mesh_are_equivalent_test.cc @@ -15,6 +15,7 @@ #include "draco/mesh/mesh_are_equivalent.h" #include +#include #include "draco/core/draco_test_base.h" #include "draco/core/draco_test_utils.h" @@ -30,6 +31,14 @@ TEST_F(MeshAreEquivalentTest, TestOnIndenticalMesh) { const std::string file_name = "test_nm.obj"; const std::unique_ptr mesh(ReadMeshFromTestFile(file_name)); ASSERT_NE(mesh, nullptr) << "Failed to load test model." << file_name; + +#ifdef DRACO_TRANSCODER_SUPPORTED + // Add mesh feature ID set to the mesh. + std::unique_ptr mesh_features(new MeshFeatures()); + mesh->AddMeshFeatures(std::move(mesh_features)); +#endif + + // Check that mesh is equivalent to itself. MeshAreEquivalent equiv; ASSERT_TRUE(equiv(*mesh, *mesh)); } @@ -95,4 +104,32 @@ TEST_F(MeshAreEquivalentTest, TestOnBigMesh) { ASSERT_TRUE(equiv(*mesh0, *mesh1)); } +#ifdef DRACO_TRANSCODER_SUPPORTED + +TEST_F(MeshAreEquivalentTest, TestMeshFeatures) { + const std::string file_name = "test_nm.obj"; + const std::unique_ptr mesh0(ReadMeshFromTestFile(file_name)); + const std::unique_ptr mesh1(ReadMeshFromTestFile(file_name)); + ASSERT_NE(mesh0, nullptr); + ASSERT_NE(mesh1, nullptr); + + // Add identical mesh feature ID sets to meshes. + mesh0->AddMeshFeatures(std::unique_ptr(new MeshFeatures())); + mesh1->AddMeshFeatures(std::unique_ptr(new MeshFeatures())); + + // Empty feature sets should match. + MeshAreEquivalent equiv; + ASSERT_TRUE(equiv(*mesh0, *mesh1)); + + // Make mesh features different and check that the meshes are not equivalent. + mesh0->GetMeshFeatures(MeshFeaturesIndex(0)).SetFeatureCount(5); + mesh1->GetMeshFeatures(MeshFeaturesIndex(0)).SetFeatureCount(6); + ASSERT_FALSE(equiv(*mesh0, *mesh1)); + + // Make mesh features identical and check that the meshes are equivalent. + mesh0->GetMeshFeatures(MeshFeaturesIndex(0)).SetFeatureCount(1); + mesh1->GetMeshFeatures(MeshFeaturesIndex(0)).SetFeatureCount(1); + ASSERT_TRUE(equiv(*mesh0, *mesh1)); +} +#endif // DRACO_TRANSCODER_SUPPORTED } // namespace draco diff --git a/contrib/draco/src/draco/mesh/mesh_attribute_corner_table.cc b/contrib/draco/src/draco/mesh/mesh_attribute_corner_table.cc index 28b68d5fd..54801ce5c 100644 --- a/contrib/draco/src/draco/mesh/mesh_attribute_corner_table.cc +++ b/contrib/draco/src/draco/mesh/mesh_attribute_corner_table.cc @@ -126,18 +126,18 @@ void MeshAttributeCornerTable::AddSeamEdge(CornerIndex c) { } } -void MeshAttributeCornerTable::RecomputeVertices(const Mesh *mesh, +bool MeshAttributeCornerTable::RecomputeVertices(const Mesh *mesh, const PointAttribute *att) { DRACO_DCHECK(GetValenceCache().IsCacheEmpty()); if (mesh != nullptr && att != nullptr) { - RecomputeVerticesInternal(mesh, att); + return RecomputeVerticesInternal(mesh, att); } else { - RecomputeVerticesInternal(nullptr, nullptr); + return RecomputeVerticesInternal(nullptr, nullptr); } } template -void MeshAttributeCornerTable::RecomputeVerticesInternal( +bool MeshAttributeCornerTable::RecomputeVerticesInternal( const Mesh *mesh, const PointAttribute *att) { DRACO_DCHECK(GetValenceCache().IsCacheEmpty()); vertex_to_attribute_entry_id_map_.clear(); @@ -167,6 +167,11 @@ void MeshAttributeCornerTable::RecomputeVerticesInternal( while (act_c != kInvalidCornerIndex) { first_c = act_c; act_c = SwingLeft(act_c); + if (act_c == c) { + // We reached the initial corner which shouldn't happen when we swing + // left from |c|. + return false; + } } } corner_to_vertex_map_[first_c.value()] = VertexIndex(first_vert_id.value()); @@ -189,6 +194,7 @@ void MeshAttributeCornerTable::RecomputeVerticesInternal( act_c = corner_table_->SwingRight(act_c); } } + return true; } int MeshAttributeCornerTable::Valence(VertexIndex v) const { diff --git a/contrib/draco/src/draco/mesh/mesh_attribute_corner_table.h b/contrib/draco/src/draco/mesh/mesh_attribute_corner_table.h index 7dad25cf1..c60be7c86 100644 --- a/contrib/draco/src/draco/mesh/mesh_attribute_corner_table.h +++ b/contrib/draco/src/draco/mesh/mesh_attribute_corner_table.h @@ -40,7 +40,7 @@ class MeshAttributeCornerTable { // whenever the seam edges are updated). // |mesh| and |att| can be null, in which case mapping between vertices and // attribute value ids is set to identity. - void RecomputeVertices(const Mesh *mesh, const PointAttribute *att); + bool RecomputeVertices(const Mesh *mesh, const PointAttribute *att); inline bool IsCornerOppositeToSeamEdge(CornerIndex corner) const { return is_edge_on_seam_[corner.value()]; @@ -130,6 +130,12 @@ class MeshAttributeCornerTable { return false; } + bool IsDegenerated(FaceIndex face) const { + // Introducing seams can't change the degeneracy of the individual faces, + // therefore we can delegate the check to the original |corner_table_|. + return corner_table_->IsDegenerated(face); + } + bool no_interior_seams() const { return no_interior_seams_; } const CornerTable *corner_table() const { return corner_table_; } @@ -166,7 +172,7 @@ class MeshAttributeCornerTable { private: template - void RecomputeVerticesInternal(const Mesh *mesh, const PointAttribute *att); + bool RecomputeVerticesInternal(const Mesh *mesh, const PointAttribute *att); std::vector is_edge_on_seam_; std::vector is_vertex_on_seam_; diff --git a/contrib/draco/src/draco/mesh/mesh_cleanup.cc b/contrib/draco/src/draco/mesh/mesh_cleanup.cc index 75b55f045..a6dc1823e 100644 --- a/contrib/draco/src/draco/mesh/mesh_cleanup.cc +++ b/contrib/draco/src/draco/mesh/mesh_cleanup.cc @@ -14,21 +14,25 @@ // #include "draco/mesh/mesh_cleanup.h" +#include +#include #include +#include +#include #include "draco/core/hash_utils.h" namespace draco { -bool MeshCleanup::operator()(Mesh *mesh, const MeshCleanupOptions &options) { +Status MeshCleanup::Cleanup(Mesh *mesh, const MeshCleanupOptions &options) { if (!options.remove_degenerated_faces && !options.remove_unused_attributes && !options.remove_duplicate_faces && !options.make_geometry_manifold) { - return true; // Nothing to cleanup. + return OkStatus(); // Nothing to cleanup. } const PointAttribute *const pos_att = mesh->GetNamedAttribute(GeometryAttribute::POSITION); if (pos_att == nullptr) { - return false; + return Status(Status::DRACO_ERROR, "Missing position attribute."); } if (options.remove_degenerated_faces) { @@ -43,7 +47,7 @@ bool MeshCleanup::operator()(Mesh *mesh, const MeshCleanupOptions &options) { RemoveUnusedAttributes(mesh); } - return true; + return OkStatus(); } void MeshCleanup::RemoveDegeneratedFaces(Mesh *mesh) { diff --git a/contrib/draco/src/draco/mesh/mesh_cleanup.h b/contrib/draco/src/draco/mesh/mesh_cleanup.h index 09aae2e1c..c6bdfc6c0 100644 --- a/contrib/draco/src/draco/mesh/mesh_cleanup.h +++ b/contrib/draco/src/draco/mesh/mesh_cleanup.h @@ -16,42 +16,38 @@ #define DRACO_MESH_MESH_CLEANUP_H_ #include "draco/core/status.h" +#include "draco/draco_features.h" #include "draco/mesh/mesh.h" namespace draco { // Options used by the MeshCleanup class. struct MeshCleanupOptions { - MeshCleanupOptions() - : remove_degenerated_faces(true), - remove_duplicate_faces(true), - remove_unused_attributes(true), - make_geometry_manifold(false) {} // If true, the cleanup tool removes any face where two or more vertices // share the same position index. - bool remove_degenerated_faces; + bool remove_degenerated_faces = true; // If true, the cleanup tool removes all duplicate faces. A pair of faces is // duplicate if both faces share the same position indices on all vertices // (that is, position values have to be duduplicated). Note that all // non-position properties are currently ignored. - bool remove_duplicate_faces; + bool remove_duplicate_faces = true; // If true, the cleanup tool removes any unused attribute value or unused // point id. For example, it can be used to remove isolated vertices. - bool remove_unused_attributes; + bool remove_unused_attributes = true; // If true, the cleanup tool splits vertices along non-manifold edges and // vertices. This ensures that the connectivity defined by position indices // is manifold. - bool make_geometry_manifold; + bool make_geometry_manifold = false; }; // Tool that can be used for removing bad or unused data from draco::Meshes. class MeshCleanup { public: // Performs in-place cleanup of the input mesh according to the input options. - bool operator()(Mesh *mesh, const MeshCleanupOptions &options); + static Status Cleanup(Mesh *mesh, const MeshCleanupOptions &options); private: static void RemoveDegeneratedFaces(Mesh *mesh); diff --git a/contrib/draco/src/draco/mesh/mesh_cleanup_test.cc b/contrib/draco/src/draco/mesh/mesh_cleanup_test.cc index 89c350e94..76e5206ae 100644 --- a/contrib/draco/src/draco/mesh/mesh_cleanup_test.cc +++ b/contrib/draco/src/draco/mesh/mesh_cleanup_test.cc @@ -15,6 +15,7 @@ #include "draco/mesh/mesh_cleanup.h" #include "draco/core/draco_test_base.h" +#include "draco/core/draco_test_utils.h" #include "draco/core/vector_d.h" #include "draco/mesh/triangle_soup_mesh_builder.h" @@ -43,9 +44,7 @@ TEST_F(MeshCleanupTest, TestDegneratedFaces) { ASSERT_NE(mesh, nullptr) << "Failed to build the test mesh."; ASSERT_EQ(mesh->num_faces(), 2) << "Wrong number of faces in the input mesh."; MeshCleanupOptions cleanup_options; - MeshCleanup cleanup; - ASSERT_TRUE(cleanup(mesh.get(), cleanup_options)) - << "Failed to cleanup the mesh."; + DRACO_ASSERT_OK(MeshCleanup::Cleanup(mesh.get(), cleanup_options)); ASSERT_EQ(mesh->num_faces(), 1) << "Failed to remove degenerated faces."; } @@ -89,9 +88,7 @@ TEST_F(MeshCleanupTest, TestDegneratedFacesAndIsolatedVertices) { << "Wrong number of point ids in the input mesh."; ASSERT_EQ(mesh->attribute(int_att_id)->size(), 3); const MeshCleanupOptions cleanup_options; - MeshCleanup cleanup; - ASSERT_TRUE(cleanup(mesh.get(), cleanup_options)) - << "Failed to cleanup the mesh."; + DRACO_ASSERT_OK(MeshCleanup::Cleanup(mesh.get(), cleanup_options)); ASSERT_EQ(mesh->num_faces(), 1) << "Failed to remove degenerated faces."; ASSERT_EQ(mesh->num_points(), 3) << "Failed to remove isolated attribute indices."; @@ -133,9 +130,7 @@ TEST_F(MeshCleanupTest, TestAttributes) { ASSERT_EQ(mesh->attribute(1)->size(), 2u) << "Wrong number of generic attribute entries."; const MeshCleanupOptions cleanup_options; - MeshCleanup cleanup; - ASSERT_TRUE(cleanup(mesh.get(), cleanup_options)) - << "Failed to cleanup the mesh."; + DRACO_ASSERT_OK(MeshCleanup::Cleanup(mesh.get(), cleanup_options)); ASSERT_EQ(mesh->num_faces(), 1) << "Failed to remove degenerated faces."; ASSERT_EQ(mesh->num_points(), 3) << "Failed to remove isolated attribute indices."; @@ -184,8 +179,7 @@ TEST_F(MeshCleanupTest, TestDuplicateFaces) { ASSERT_NE(mesh, nullptr); ASSERT_EQ(mesh->num_faces(), 5); const MeshCleanupOptions cleanup_options; - MeshCleanup cleanup; - ASSERT_TRUE(cleanup(mesh.get(), cleanup_options)); + DRACO_ASSERT_OK(MeshCleanup::Cleanup(mesh.get(), cleanup_options)); ASSERT_EQ(mesh->num_faces(), 2); } diff --git a/contrib/draco/src/draco/mesh/mesh_connected_components.h b/contrib/draco/src/draco/mesh/mesh_connected_components.h new file mode 100644 index 000000000..6ee30551e --- /dev/null +++ b/contrib/draco/src/draco/mesh/mesh_connected_components.h @@ -0,0 +1,161 @@ +// Copyright 2016 The Draco Authors. +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. +// +#ifndef DRACO_MESH_MESH_CONNECTED_COMPONENTS_H_ +#define DRACO_MESH_MESH_CONNECTED_COMPONENTS_H_ + +#include + +#include "draco/mesh/corner_table.h" + +namespace draco { + +// Class for detecting connected components on an input mesh defined by a +// corner table. Degenerated faces and their vertices are not assigned to any +// component. +class MeshConnectedComponents { + public: + MeshConnectedComponents() = default; + + // Initializes the class with the component data of the input mesh. No other + // method should be called before this one. + template + void FindConnectedComponents(const CornerTableT *corner_table); + int NumConnectedComponents() const { return components_.size(); } + + struct ConnectedComponent { + std::vector vertices; + std::vector faces; + std::vector boundary_edges; + }; + + const ConnectedComponent &GetConnectedComponent(int index) const { + return components_[index]; + } + + // Returns the id of an component attached to a given vertex. Returns -1 when + // the vertex was not assigned to any component. + int GetConnectedComponentIdAtVertex(int vertex_id) const { + return vertex_to_component_map_[vertex_id]; + } + + // Returns the number of vertices that belong to the input component. + int NumConnectedComponentVertices(int component_id) const { + return components_[component_id].vertices.size(); + } + + // Returns the i-th vertex of the input component. + int GetConnectedComponentVertex(int component_id, int i) const { + return components_[component_id].vertices[i]; + } + + // Returns the id of an component attached to a given face. Returns -1 when + // the face was not assigned to any component. + int GetConnectedComponentIdAtFace(int face_id) const { + return face_to_component_map_[face_id]; + } + + // Returns the number of faces that belong to the input component. + int NumConnectedComponentFaces(int component_id) const { + return components_[component_id].faces.size(); + } + + // Returns the i-th face of the input component. + int GetConnectedComponentFace(int component_id, int i) const { + return components_[component_id].faces[i]; + } + + // Returns the number of boundary edges that belong to the input component. + int NumConnectedComponentBoundaryEdges(int component_id) const { + return components_[component_id].boundary_edges.size(); + } + + // Returns the i-th boundary edge of the input component. + int GetConnectedComponentBoundaryEdge(int component_id, int i) const { + return components_[component_id].boundary_edges[i]; + } + + private: + std::vector vertex_to_component_map_; + std::vector face_to_component_map_; + std::vector boundary_corner_to_component_map_; + std::vector components_; +}; + +template +void MeshConnectedComponents::FindConnectedComponents( + const CornerTableT *corner_table) { + components_.clear(); + vertex_to_component_map_.assign(corner_table->num_vertices(), -1); + face_to_component_map_.assign(corner_table->num_faces(), -1); + boundary_corner_to_component_map_.assign(corner_table->num_corners(), -1); + std::vector is_face_visited(corner_table->num_faces(), false); + std::vector face_stack; + // Go over all faces of the mesh and for each unvisited face, recursively + // traverse its neighborhood and mark all traversed faces as visited. All + // faces visited during one traversal belong to one mesh component. + for (int face_id = 0; face_id < corner_table->num_faces(); ++face_id) { + if (is_face_visited[face_id]) { + continue; + } + if (corner_table->IsDegenerated(FaceIndex(face_id))) { + continue; + } + const int component_id = components_.size(); + components_.push_back(ConnectedComponent()); + face_stack.push_back(face_id); + is_face_visited[face_id] = true; + while (!face_stack.empty()) { + const int act_face_id = face_stack.back(); + if (face_to_component_map_[act_face_id] == -1) { + face_to_component_map_[act_face_id] = component_id; + components_[component_id].faces.push_back(act_face_id); + } + face_stack.pop_back(); + // Gather all neighboring faces. + std::array corners = + corner_table->AllCorners(FaceIndex(act_face_id)); + for (int c = 0; c < 3; ++c) { + // Update vertex to component mapping. + const int vertex_id = corner_table->Vertex(corners[c]).value(); + if (vertex_to_component_map_[vertex_id] == -1) { + vertex_to_component_map_[vertex_id] = component_id; + components_[component_id].vertices.push_back(vertex_id); + } + // Traverse component to neighboring faces (add the faces to the stack). + const CornerIndex opp_corner = corner_table->Opposite(corners[c]); + if (opp_corner == kInvalidCornerIndex) { + if (boundary_corner_to_component_map_[corners[c].value()] == -1) { + boundary_corner_to_component_map_[corners[c].value()] = + component_id; + components_[component_id].boundary_edges.push_back( + corners[c].value()); + } + continue; // Invalid corner (mesh boundary). + } + + const int opp_face_id = corner_table->Face(opp_corner).value(); + if (is_face_visited[opp_face_id]) { + continue; // Opposite face has been already reached. + } + is_face_visited[opp_face_id] = true; + face_stack.push_back(opp_face_id); + } + } + } +} + +} // namespace draco + +#endif // DRACO_MESH_MESH_CONNECTED_COMPONENTS_H_ diff --git a/contrib/draco/src/draco/mesh/mesh_features.cc b/contrib/draco/src/draco/mesh/mesh_features.cc new file mode 100644 index 000000000..f859ae411 --- /dev/null +++ b/contrib/draco/src/draco/mesh/mesh_features.cc @@ -0,0 +1,98 @@ +// Copyright 2022 The Draco Authors. +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. +// +#include "draco/mesh/mesh_features.h" + +#include +#include + +#ifdef DRACO_TRANSCODER_SUPPORTED + +namespace draco { + +MeshFeatures::MeshFeatures() + : feature_count_(0), + null_feature_id_(-1), + attribute_index_(-1), + property_table_index_(-1) {} + +void MeshFeatures::Copy(const MeshFeatures &src) { + label_ = src.label_; + feature_count_ = src.feature_count_; + null_feature_id_ = src.null_feature_id_; + attribute_index_ = src.attribute_index_; + texture_map_.Copy(src.texture_map_); + texture_channels_ = src.texture_channels_; + property_table_index_ = src.property_table_index_; +} + +void MeshFeatures::SetLabel(const std::string &label) { label_ = label; } + +const std::string &MeshFeatures::GetLabel() const { return label_; } + +void MeshFeatures::SetFeatureCount(int feature_count) { + feature_count_ = feature_count; +} + +int MeshFeatures::GetFeatureCount() const { return feature_count_; } + +void MeshFeatures::SetNullFeatureId(int null_feature_id) { + null_feature_id_ = null_feature_id; +} + +int MeshFeatures::GetNullFeatureId() const { return null_feature_id_; } + +void MeshFeatures::SetAttributeIndex(int attribute_index) { + attribute_index_ = attribute_index; +} + +int MeshFeatures::GetAttributeIndex() const { return attribute_index_; } + +void MeshFeatures::SetTextureMap(const TextureMap &texture_map) { + texture_map_.Copy(texture_map); +} + +void MeshFeatures::SetTextureMap(Texture *texture, int tex_coord_index) { + texture_map_.SetProperties(TextureMap::GENERIC, tex_coord_index); + texture_map_.SetTexture(texture); +} + +const TextureMap &MeshFeatures::GetTextureMap() const { return texture_map_; } + +TextureMap &MeshFeatures::GetTextureMap() { return texture_map_; } + +void MeshFeatures::SetTextureChannels( + const std::vector &texture_channels) { + texture_channels_ = texture_channels; +} + +const std::vector &MeshFeatures::GetTextureChannels() const { + return texture_channels_; +} + +std::vector &MeshFeatures::GetTextureChannels() { + return texture_channels_; +} + +void MeshFeatures::SetPropertyTableIndex(int property_table_index) { + property_table_index_ = property_table_index; +} + +int MeshFeatures::GetPropertyTableIndex() const { + return property_table_index_; +} + +} // namespace draco + +#endif // DRACO_TRANSCODER_SUPPORTED diff --git a/contrib/draco/src/draco/mesh/mesh_features.h b/contrib/draco/src/draco/mesh/mesh_features.h new file mode 100644 index 000000000..af024013f --- /dev/null +++ b/contrib/draco/src/draco/mesh/mesh_features.h @@ -0,0 +1,93 @@ +// Copyright 2022 The Draco Authors. +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. +// +#ifndef DRACO_MESH_MESH_FEATURES_H_ +#define DRACO_MESH_MESH_FEATURES_H_ + +#include "draco/draco_features.h" + +#ifdef DRACO_TRANSCODER_SUPPORTED +#include +#include + +#include "draco/texture/texture_library.h" +#include "draco/texture/texture_map.h" + +namespace draco { + +// Describes a mesh feature ID set according to the EXT_mesh_features glTF +// extension. Feature IDs are either associated with geometry vertices or with +// texture pixels and stored in a geometry attribute or in texture channels, +// respectively. Optionally, the feature ID set may be associated with a +// property table defined in the EXT_structural_metadata glTF extension. +class MeshFeatures { + public: + // Creates an empty feature ID set that is associated neither with vertices, + // nor with texture pixels, nor with property tables. + MeshFeatures(); + + // Copies all data from |src| mesh feature ID set. + void Copy(const MeshFeatures &src); + + // Label assigned to this feature ID set. + void SetLabel(const std::string &label); + const std::string &GetLabel() const; + + // The number of unique features in this feature ID set. + void SetFeatureCount(int feature_count); + int GetFeatureCount() const; + + // Non-negative null feature ID value indicating the absence of an associated + // feature. The value of -1 indicates that the null feature ID is not set. + void SetNullFeatureId(int null_feature_id); + int GetNullFeatureId() const; + + // Index of the feature ID vertex attribute, e.g., 5 for an attribute named + // _FEATURE_ID_5, or -1 if the feature ID is not associated with vertices. + void SetAttributeIndex(int attribute_index); + int GetAttributeIndex() const; + + // Feature ID texture map and texture channels containing feature IDs + // associated with texture pixels. Only used when |attribute_index_| is -1. + // The RGBA channels are numbered from 0 to 3. See the glTF extension + // documentation for reconstruction of feature ID from the channel values. + void SetTextureMap(const TextureMap &texture_map); + void SetTextureMap(Texture *texture, int tex_coord_index); + const TextureMap &GetTextureMap() const; + TextureMap &GetTextureMap(); + void SetTextureChannels(const std::vector &texture_channels); + const std::vector &GetTextureChannels() const; + std::vector &GetTextureChannels(); + + // Non-negative index of the property table this feature ID set is associated + // with. Property tables are defined in the EXT_structural_metadata glTF + // extension. The value of -1 indicates that this feature ID set is not + // associated with any property tables. + void SetPropertyTableIndex(int property_table_index); + int GetPropertyTableIndex() const; + + private: + std::string label_; + int feature_count_; + int null_feature_id_; + int attribute_index_; + TextureMap texture_map_; + std::vector texture_channels_; + int property_table_index_; +}; + +} // namespace draco + +#endif // DRACO_TRANSCODER_SUPPORTED +#endif // DRACO_MESH_MESH_FEATURES_H_ diff --git a/contrib/draco/src/draco/mesh/mesh_features_test.cc b/contrib/draco/src/draco/mesh/mesh_features_test.cc new file mode 100644 index 000000000..0e67af2b1 --- /dev/null +++ b/contrib/draco/src/draco/mesh/mesh_features_test.cc @@ -0,0 +1,98 @@ +// Copyright 2022 The Draco Authors. +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. +// +#include "draco/mesh/mesh_features.h" + +#include +#include + +#include "draco/core/draco_test_base.h" +#include "draco/core/draco_test_utils.h" +#include "draco/texture/texture_map.h" + +namespace { + +#ifdef DRACO_TRANSCODER_SUPPORTED + +TEST(MeshFeaturesTest, TestDefaults) { + // Test construction of an empty feature ID set. + draco::MeshFeatures mesh_features; + ASSERT_TRUE(mesh_features.GetLabel().empty()); + ASSERT_EQ(mesh_features.GetFeatureCount(), 0); + ASSERT_EQ(mesh_features.GetNullFeatureId(), -1); + ASSERT_EQ(mesh_features.GetAttributeIndex(), -1); + ASSERT_EQ(mesh_features.GetPropertyTableIndex(), -1); + ASSERT_TRUE(mesh_features.GetTextureChannels().empty()); + ASSERT_EQ(mesh_features.GetTextureMap().texture(), nullptr); + ASSERT_EQ(mesh_features.GetTextureMap().type(), draco::TextureMap::GENERIC); +} + +TEST(MeshFeaturesTest, TestSettersAndGetters) { + // Test setter and getter methods of the feature ID set. + draco::MeshFeatures mesh_features; + mesh_features.SetLabel("continent"); + mesh_features.SetFeatureCount(8); + mesh_features.SetNullFeatureId(0); + mesh_features.SetAttributeIndex(2); + mesh_features.SetPropertyTableIndex(10); + std::vector channels = {2, 3}; + mesh_features.SetTextureChannels({2, 3}); + draco::TextureMap texture_map; + texture_map.SetProperties(draco::TextureMap::GENERIC, 1); + std::unique_ptr texture(new draco::Texture()); + texture_map.SetTexture(texture.get()); + mesh_features.SetTextureMap(texture_map); + + // Check that mesh feature set properties can be accessed via getters. + ASSERT_EQ(mesh_features.GetLabel(), "continent"); + ASSERT_EQ(mesh_features.GetFeatureCount(), 8); + ASSERT_EQ(mesh_features.GetNullFeatureId(), 0); + ASSERT_EQ(mesh_features.GetAttributeIndex(), 2); + ASSERT_EQ(mesh_features.GetPropertyTableIndex(), 10); + ASSERT_EQ(mesh_features.GetTextureChannels(), channels); + ASSERT_EQ(mesh_features.GetTextureMap().texture(), texture.get()); + ASSERT_EQ(mesh_features.GetTextureMap().type(), draco::TextureMap::GENERIC); +} + +TEST(MeshFeaturesTest, TestCopy) { + // Test that feature ID set can be copied. + draco::MeshFeatures mesh_features; + mesh_features.SetLabel("continent"); + mesh_features.SetFeatureCount(8); + mesh_features.SetNullFeatureId(0); + mesh_features.SetAttributeIndex(2); + mesh_features.SetPropertyTableIndex(10); + std::vector channels = {2, 3}; + mesh_features.SetTextureChannels({2, 3}); + std::unique_ptr texture(new draco::Texture()); + mesh_features.SetTextureMap(texture.get(), 1); + + // Make a copy. + draco::MeshFeatures copy; + copy.Copy(mesh_features); + + // Check the copy. + ASSERT_EQ(copy.GetLabel(), "continent"); + ASSERT_EQ(copy.GetFeatureCount(), 8); + ASSERT_EQ(copy.GetNullFeatureId(), 0); + ASSERT_EQ(copy.GetAttributeIndex(), 2); + ASSERT_EQ(copy.GetPropertyTableIndex(), 10); + ASSERT_EQ(copy.GetTextureChannels(), channels); + ASSERT_EQ(copy.GetTextureMap().texture(), texture.get()); + ASSERT_EQ(copy.GetTextureMap().type(), draco::TextureMap::GENERIC); +} + +#endif // DRACO_TRANSCODER_SUPPORTED + +} // namespace diff --git a/contrib/draco/src/draco/mesh/mesh_indices.h b/contrib/draco/src/draco/mesh/mesh_indices.h new file mode 100644 index 000000000..5df28d550 --- /dev/null +++ b/contrib/draco/src/draco/mesh/mesh_indices.h @@ -0,0 +1,37 @@ +// Copyright 2022 The Draco Authors. +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. +// +#ifdef DRACO_TRANSCODER_SUPPORTED +#ifndef DRACO_MESH_MESH_INDICES_H_ +#define DRACO_MESH_MESH_INDICES_H_ + +#include + +#include + +#include "draco/core/draco_index_type.h" + +namespace draco { + +// Index of a mesh feature ID set. +DEFINE_NEW_DRACO_INDEX_TYPE(uint32_t, MeshFeaturesIndex) + +// Constants denoting invalid indices. +static constexpr MeshFeaturesIndex kInvalidMeshFeaturesIndex( + std::numeric_limits::max()); + +} // namespace draco + +#endif // DRACO_MESH_MESH_INDICES_H_ +#endif // DRACO_TRANSCODER_SUPPORTED diff --git a/contrib/draco/src/draco/mesh/mesh_misc_functions.h b/contrib/draco/src/draco/mesh/mesh_misc_functions.h index b450bc80c..0a3bcf497 100644 --- a/contrib/draco/src/draco/mesh/mesh_misc_functions.h +++ b/contrib/draco/src/draco/mesh/mesh_misc_functions.h @@ -67,7 +67,6 @@ inline bool IsCornerOppositeToAttributeSeam(CornerIndex ci, // Interpolates an attribute value on a face using given barycentric // coordinates. InterpolatedVectorT should be a VectorD that corresponds to the // values stored in the attribute. -// TODO(ostava): Find a better place for this. template InterpolatedVectorT ComputeInterpolatedAttributeValueOnMeshFace( const Mesh &mesh, const PointAttribute &attribute, FaceIndex fi, diff --git a/contrib/draco/src/draco/mesh/mesh_splitter.cc b/contrib/draco/src/draco/mesh/mesh_splitter.cc new file mode 100644 index 000000000..ac3c4661c --- /dev/null +++ b/contrib/draco/src/draco/mesh/mesh_splitter.cc @@ -0,0 +1,451 @@ +// Copyright 2017 The Draco Authors. +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. +// +#include "draco/mesh/mesh_splitter.h" + +#ifdef DRACO_TRANSCODER_SUPPORTED +#include +#include +#include + +#include "draco/mesh/mesh_utils.h" +#include "draco/mesh/triangle_soup_mesh_builder.h" +#include "draco/point_cloud/point_cloud_builder.h" + +namespace draco { + +// Helper class that handles splitting of meshes with faces / without faces, +// i.e. point clouds. +template +class MeshSplitterInternal { + public: + struct WorkData : public MeshSplitter::WorkData { + // TriangleSoupMeshBuilder or PointCloudBuilder. + std::vector builders; + }; + + // Computes number of elements (faces or points) for each sub-mesh. + Status InitializeWorkDataNumElements(const Mesh &mesh, int split_attribute_id, + WorkData *work_data) const; + // Initializes a builder for a given sub-mesh. + void InitializeBuilder(int b_index, int num_elements, const Mesh &mesh, + int ignored_attribute_id, WorkData *work_data) const; + // Add all faces or points to the builders. + void AddElementsToBuilder(const Mesh &mesh, + const PointAttribute *split_attribute, + WorkData *work_data) const; + // Builds the meshes from the data accumulated in the builders. + StatusOr BuildMeshes(const Mesh &mesh, + WorkData *work_data) const; +}; + +namespace { + +// Helper functions for copying single element from source |mesh| to a target +// builder |b_index| stored in |work_data|. +void AddElementToBuilder( + int b_index, FaceIndex source_i, FaceIndex target_i, const Mesh &mesh, + MeshSplitterInternal::WorkData *work_data); +void AddElementToBuilder( + int b_index, PointIndex source_i, PointIndex target_i, const Mesh &mesh, + MeshSplitterInternal::WorkData *work_data); +} // namespace + +MeshSplitter::MeshSplitter() + : preserve_materials_(false), + remove_unused_material_indices_(true), + preserve_mesh_features_(false) {} + +StatusOr MeshSplitter::SplitMesh( + const Mesh &mesh, uint32_t split_attribute_id) { + if (mesh.num_attributes() <= split_attribute_id) { + return Status(Status::DRACO_ERROR, "Invalid attribute id."); + } + if (mesh.num_faces() == 0) { + return SplitMeshInternal(mesh, split_attribute_id); + } else { + return SplitMeshInternal(mesh, split_attribute_id); + } +} + +template +StatusOr MeshSplitter::SplitMeshInternal( + const Mesh &mesh, int split_attribute_id) { + const PointAttribute *const split_attribute = + mesh.attribute(split_attribute_id); + + // Preserve the split attribute only if it is the material attribute and the + // |preserve_materials_| flag is set. Othwerwise the split attribute will get + // discarded. + // TODO(ostava): We may revisit this later and add an option to always + // preserve the split attribute. + const bool preserve_split_attribute = + preserve_materials_ && + split_attribute->attribute_type() == GeometryAttribute::MATERIAL; + + const int num_out_meshes = split_attribute->size(); + MeshSplitterInternal splitter_internal; + typename MeshSplitterInternal::WorkData work_data; + work_data.num_sub_mesh_elements.resize(num_out_meshes, 0); + work_data.split_by_materials = + (split_attribute->attribute_type() == GeometryAttribute::MATERIAL); + + DRACO_RETURN_IF_ERROR(splitter_internal.InitializeWorkDataNumElements( + mesh, split_attribute_id, &work_data)); + + // Create the sub-meshes. + work_data.builders.resize(num_out_meshes); + // Map between attribute ids of the input and output meshes. + work_data.att_id_map.resize(mesh.num_attributes(), -1); + const int ignored_att_id = + (!preserve_split_attribute ? split_attribute_id : -1); + for (int mi = 0; mi < num_out_meshes; ++mi) { + if (work_data.num_sub_mesh_elements[mi] == 0) { + continue; // Empty mesh, don't initialize it. + } + + const int num_elements = work_data.num_sub_mesh_elements[mi]; + splitter_internal.InitializeBuilder(mi, num_elements, mesh, ignored_att_id, + &work_data); + + // Reset the element counter for the sub-mesh. It will be used to keep track + // of number of elements added to the sub-mesh. + work_data.num_sub_mesh_elements[mi] = 0; + } + + splitter_internal.AddElementsToBuilder(mesh, split_attribute, &work_data); + + DRACO_ASSIGN_OR_RETURN(MeshVector out_meshes, + splitter_internal.BuildMeshes(mesh, &work_data)); + return FinalizeMeshes(mesh, work_data, std::move(out_meshes)); +} + +template <> +Status +MeshSplitterInternal::InitializeWorkDataNumElements( + const Mesh &mesh, int split_attribute_id, WorkData *work_data) const { + const PointAttribute *const split_attribute = + mesh.attribute(split_attribute_id); + // Verify that the attribute values are defined "per-face", i.e., all points + // on a face are always mapped to the same attribute value. + for (FaceIndex fi(0); fi < mesh.num_faces(); ++fi) { + const auto face = mesh.face(fi); + const AttributeValueIndex avi = split_attribute->mapped_index(face[0]); + for (int c = 1; c < 3; ++c) { + if (split_attribute->mapped_index(face[c]) != avi) { + return Status(Status::DRACO_ERROR, + "Attribute values not consistent on a face."); + } + } + work_data->num_sub_mesh_elements[avi.value()] += 1; + } + return OkStatus(); +} + +template <> +Status MeshSplitterInternal::InitializeWorkDataNumElements( + const Mesh &mesh, int split_attribute_id, WorkData *work_data) const { + const PointAttribute *const split_attribute = + mesh.attribute(split_attribute_id); + // Each point can have a different value. Just accumulate the number of points + // with the same attribute value index. + for (PointIndex pi(0); pi < mesh.num_points(); ++pi) { + const AttributeValueIndex avi = split_attribute->mapped_index(pi); + work_data->num_sub_mesh_elements[avi.value()] += 1; + } + return OkStatus(); +} + +template +void MeshSplitterInternal::InitializeBuilder( + int b_index, int num_elements, const Mesh &mesh, int ignored_attribute_id, + WorkData *work_data) const { + work_data->builders[b_index].Start(num_elements); + + // Add all attributes. + for (int ai = 0; ai < mesh.num_attributes(); ++ai) { + if (ai == ignored_attribute_id) { + continue; + } + const GeometryAttribute *const src_att = mesh.attribute(ai); + work_data->att_id_map[ai] = work_data->builders[b_index].AddAttribute( + src_att->attribute_type(), src_att->num_components(), + src_att->data_type()); + } +} + +template <> +void MeshSplitterInternal::AddElementsToBuilder( + const Mesh &mesh, const PointAttribute *split_attribute, + WorkData *work_data) const { + // Go over all faces of the input mesh and add them to the appropriate + // sub-mesh. + for (FaceIndex fi(0); fi < mesh.num_faces(); ++fi) { + const auto face = mesh.face(fi); + const int sub_mesh_id = split_attribute->mapped_index(face[0]).value(); + const FaceIndex target_fi(work_data->num_sub_mesh_elements[sub_mesh_id]++); + AddElementToBuilder(sub_mesh_id, fi, target_fi, mesh, work_data); + } +} + +template <> +void MeshSplitterInternal::AddElementsToBuilder( + const Mesh &mesh, const PointAttribute *split_attribute, + WorkData *work_data) const { + // Go over all points of the input mesh and add them to the appropriate + // sub-mesh. + for (PointIndex pi(0); pi < mesh.num_points(); ++pi) { + const int sub_mesh_id = split_attribute->mapped_index(pi).value(); + const PointIndex target_pi(work_data->num_sub_mesh_elements[sub_mesh_id]++); + AddElementToBuilder(sub_mesh_id, pi, target_pi, mesh, work_data); + } +} + +namespace { + +void AddElementToBuilder( + int b_index, FaceIndex source_i, FaceIndex target_i, const Mesh &mesh, + MeshSplitterInternal::WorkData *work_data) { + const auto &face = mesh.face(source_i); + for (int ai = 0; ai < mesh.num_attributes(); ++ai) { + const PointAttribute *const src_att = mesh.attribute(ai); + const int target_att_id = work_data->att_id_map[ai]; + if (target_att_id == -1) { + continue; + } + // Add value for each corner of the face. + work_data->builders[b_index].SetAttributeValuesForFace( + target_att_id, target_i, src_att->GetAddressOfMappedIndex(face[0]), + src_att->GetAddressOfMappedIndex(face[1]), + src_att->GetAddressOfMappedIndex(face[2])); + } +} + +void AddElementToBuilder( + int b_index, PointIndex source_i, PointIndex target_i, const Mesh &mesh, + MeshSplitterInternal::WorkData *work_data) { + for (int ai = 0; ai < mesh.num_attributes(); ++ai) { + const PointAttribute *const src_att = mesh.attribute(ai); + const int target_att_id = work_data->att_id_map[ai]; + if (target_att_id == -1) { + continue; + } + // Add value for the point |target_i|. + work_data->builders[b_index].SetAttributeValueForPoint( + target_att_id, target_i, src_att->GetAddressOfMappedIndex(source_i)); + } +} + +} // namespace + +template <> +StatusOr +MeshSplitterInternal::BuildMeshes( + const Mesh &mesh, WorkData *work_data) const { + const int num_out_meshes = work_data->builders.size(); + MeshSplitter::MeshVector out_meshes(num_out_meshes); + for (int mi = 0; mi < num_out_meshes; ++mi) { + if (work_data->num_sub_mesh_elements[mi] == 0) { + continue; + } + out_meshes[mi] = work_data->builders[mi].Finalize(); + if (out_meshes[mi] == nullptr) { + continue; + } + } + return out_meshes; +} + +template <> +StatusOr +MeshSplitterInternal::BuildMeshes( + const Mesh &mesh, WorkData *work_data) const { + const int num_out_meshes = work_data->builders.size(); + MeshSplitter::MeshVector out_meshes(num_out_meshes); + for (int mi = 0; mi < num_out_meshes; ++mi) { + if (work_data->num_sub_mesh_elements[mi] == 0) { + continue; + } + // For point clouds, we first build a point cloud and copy it over into + // a draco::Mesh. + std::unique_ptr pc = work_data->builders[mi].Finalize(true); + if (pc == nullptr) { + continue; + } + std::unique_ptr mesh(new Mesh()); + PointCloud *mesh_pc = mesh.get(); + mesh_pc->Copy(*pc); + out_meshes[mi] = std::move(mesh); + } + return out_meshes; +} + +StatusOr MeshSplitter::FinalizeMeshes( + const Mesh &mesh, const WorkData &work_data, MeshVector out_meshes) const { + // Finalize meshes. + const int num_out_meshes = out_meshes.size(); + + // If we are going to preserve mesh features, we will need to update texture + // pointers for all mesh feature textures. Here we store the mapping between + // the old texture pointers and their indices. + std::unordered_map features_texture_to_index_map; + if (preserve_mesh_features_) { + features_texture_to_index_map = + mesh.GetNonMaterialTextureLibrary().ComputeTextureToIndexMap(); + } + + for (int mi = 0; mi < num_out_meshes; ++mi) { + if (out_meshes[mi] == nullptr) { + continue; + } + out_meshes[mi]->SetName(mesh.GetName()); + if (preserve_materials_) { + out_meshes[mi]->GetMaterialLibrary().Copy(mesh.GetMaterialLibrary()); + } + + // Copy metadata of the original mesh to the output meshes. + if (mesh.GetMetadata() != nullptr) { + const GeometryMetadata &metadata = *mesh.GetMetadata(); + out_meshes[mi]->AddMetadata( + std::unique_ptr(new GeometryMetadata(metadata))); + } + + // Copy over attribute unique ids. + for (int att_id = 0; att_id < mesh.num_attributes(); ++att_id) { + const int mapped_att_id = work_data.att_id_map[att_id]; + if (mapped_att_id == -1) { + continue; + } + const PointAttribute *const src_att = mesh.attribute(att_id); + PointAttribute *const dst_att = out_meshes[mi]->attribute(mapped_att_id); + dst_att->set_unique_id(src_att->unique_id()); + } + + // Copy compression settings of the original mesh to the output meshes. + out_meshes[mi]->SetCompressionEnabled(mesh.IsCompressionEnabled()); + out_meshes[mi]->SetCompressionOptions(mesh.GetCompressionOptions()); + + if (preserve_mesh_features_) { + // Copy mesh features from the source |mesh| to the |out_meshes[mi]|. + for (MeshFeaturesIndex mfi(0); mfi < mesh.NumMeshFeatures(); ++mfi) { + if (work_data.split_by_materials) { + // Copy over only those mesh features that were masked to the material + // corresponding to |mi|. + bool is_used = false; + if (mesh.NumMeshFeaturesMaterialMasks(mfi) == 0) { + is_used = true; + } else { + for (int mask_index = 0; + mask_index < mesh.NumMeshFeaturesMaterialMasks(mfi); + ++mask_index) { + if (mesh.GetMeshFeaturesMaterialMask(mfi, mask_index) == mi) { + is_used = true; + break; + } + } + } + if (!is_used) { + // Ignore this mesh features. + continue; + } + } + // Create a copy of source mesh features. + std::unique_ptr mf(new MeshFeatures()); + mf->Copy(mesh.GetMeshFeatures(mfi)); + const MeshFeaturesIndex new_mfi = + out_meshes[mi]->AddMeshFeatures(std::move(mf)); + if (work_data.split_by_materials && !preserve_materials_) { + // If the input |mesh| was split by materials and we didn't preserve + // the materials, all mesh features must be masked to material 0. + out_meshes[mi]->AddMeshFeaturesMaterialMask(new_mfi, 0); + } else { + // Otherwise mesh features use same masking as the source mesh because + // the material attribute is still present in the split meshes. + // Note that this masking can be later changed in + // RemoveUnusedMaterials() call below. + for (int mask_index = 0; + mask_index < mesh.NumMeshFeaturesMaterialMasks(mfi); + ++mask_index) { + out_meshes[mi]->AddMeshFeaturesMaterialMask( + new_mfi, mesh.GetMeshFeaturesMaterialMask(mfi, mask_index)); + } + } + } + + // Copy over all features textures to the split mesh. + out_meshes[mi]->GetNonMaterialTextureLibrary().Copy( + mesh.GetNonMaterialTextureLibrary()); + + // Update mesh features texture pointers to the new library. + for (MeshFeaturesIndex mfi(0); mfi < out_meshes[mi]->NumMeshFeatures(); + ++mfi) { + Mesh::UpdateMeshFeaturesTexturePointer( + features_texture_to_index_map, + &out_meshes[mi]->GetNonMaterialTextureLibrary(), + &out_meshes[mi]->GetMeshFeatures(mfi)); + } + + // This will remove any mesh features that may not be be actually used + // by this |out_meshes[mi]| (e.g. because corresponding material indices + // were not present in this split mesh). This also removes any unused + // features textures from the non-material texture library. + DRACO_RETURN_IF_ERROR( + MeshUtils::RemoveUnusedMeshFeatures(out_meshes[mi].get())); + } + + // Remove unused materials after we remove mesh features because some of + // the mesh features may have referenced old material indices. + if (preserve_materials_) { + out_meshes[mi]->RemoveUnusedMaterials(remove_unused_material_indices_); + } + + // Copy structural metadata from input mesh to each of the output meshes. + out_meshes[mi]->GetStructuralMetadata().Copy(mesh.GetStructuralMetadata()); + } + return std::move(out_meshes); +} + +StatusOr MeshSplitter::SplitMeshToComponents( + const Mesh &mesh, const MeshConnectedComponents &connected_components) { + // Create the sub-meshes. + const int num_out_meshes = connected_components.NumConnectedComponents(); + MeshSplitterInternal splitter_internal; + typename MeshSplitterInternal::WorkData work_data; + work_data.builders.resize(num_out_meshes); + work_data.num_sub_mesh_elements.resize(num_out_meshes, 0); + work_data.att_id_map.resize(mesh.num_attributes(), -1); + for (int mi = 0; mi < num_out_meshes; ++mi) { + const int num_faces = connected_components.NumConnectedComponentFaces(mi); + work_data.num_sub_mesh_elements[mi] = num_faces; + splitter_internal.InitializeBuilder(mi, num_faces, mesh, -1, &work_data); + } + + // Go over all faces of the input mesh and add them to the appropriate + // sub-mesh. + for (int mi = 0; mi < num_out_meshes; ++mi) { + for (int cfi = 0; cfi < connected_components.NumConnectedComponentFaces(mi); + ++cfi) { + const FaceIndex fi( + connected_components.GetConnectedComponent(mi).faces[cfi]); + const FaceIndex target_fi(cfi); + AddElementToBuilder(mi, fi, target_fi, mesh, &work_data); + } + } + DRACO_ASSIGN_OR_RETURN(auto out_meshes, + splitter_internal.BuildMeshes(mesh, &work_data)); + return FinalizeMeshes(mesh, work_data, std::move(out_meshes)); +} + +} // namespace draco +#endif // DRACO_TRANSCODER_SUPPORTED diff --git a/contrib/draco/src/draco/mesh/mesh_splitter.h b/contrib/draco/src/draco/mesh/mesh_splitter.h new file mode 100644 index 000000000..bf5cd9794 --- /dev/null +++ b/contrib/draco/src/draco/mesh/mesh_splitter.h @@ -0,0 +1,109 @@ +// Copyright 2017 The Draco Authors. +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. +// +#ifndef DRACO_MESH_MESH_SPLITTER_H_ +#define DRACO_MESH_MESH_SPLITTER_H_ + +#include +#include + +#include "draco/draco_features.h" + +#ifdef DRACO_TRANSCODER_SUPPORTED +#include "draco/core/status_or.h" +#include "draco/mesh/mesh.h" +#include "draco/mesh/mesh_connected_components.h" +#include "draco/mesh/triangle_soup_mesh_builder.h" + +namespace draco { + +// Class that can be used to split a single mesh into multiple sub-meshes +// according to specified criteria. +class MeshSplitter { + public: + typedef std::vector> MeshVector; + MeshSplitter(); + + // Sets a flag that tells the splitter to preserve all materials on the input + // mesh during mesh splitting. When set, the materials used on sub-meshes are + // going to be copied over. Any redundant materials on sub-meshes are going to + // be deleted but material indices may still be preserved depending on the + // SetRemoveUnusedMaterialIndices() flag. + // Default = false. + void SetPreserveMaterials(bool flag) { preserve_materials_ = flag; } + + // Sets a flag that tells the splitter to delete any unused material indices + // on the generated sub-meshes. This option is currently used only when + // SetPreserveMaterials() was set to true. If this option is set to false, the + // material indices of the MATERIAL attribute will be the same as in the + // source mesh. If the flag is true, then the unused material indices will be + // removed and they may no longer correspond to the source mesh. Note that + // when this flag is false, any unused materials would be replaced with empty + // (default) materials. + // Default = true. + void SetRemoveUnusedMaterialIndices(bool flag) { + remove_unused_material_indices_ = flag; + } + + // Sets a flag that tells the splitter to preserve all mesh features on the + // input mesh during mesh splitting. When set, the mesh features used on + // sub-meshes are going to be copied over. Any redundant mesh features on + // sub-meshes are going to be deleted. + // Default = false. + void SetPreserveMeshFeatures(bool flag) { preserve_mesh_features_ = flag; } + + // Splits the input |mesh| according to attribute values stored in the + // specified attribute. If the |mesh| contains faces, the attribute values + // need to be defined per-face, that is, all points attached to a single face + // must share the same attribute value. Meshes without faces are treated as + // point clouds and the attribute values can be defined per-point. Each + // attribute value (AttributeValueIndex) is mapped to a single output mesh. If + // an AttributeValueIndex is unused, no mesh is created for the given value. + StatusOr SplitMesh(const Mesh &mesh, uint32_t split_attribute_id); + + // Splits the input |mesh| into separate components defined in + // |connected_components|. That is, all faces associated with a given + // component index will be stored in the same mesh. The number of generated + // meshes will correspond to |connected_components.NumConnectedComponents()|. + StatusOr SplitMeshToComponents( + const Mesh &mesh, const MeshConnectedComponents &connected_components); + + private: + struct WorkData { + // Map between attribute ids of the input and output meshes. + std::vector att_id_map; + std::vector num_sub_mesh_elements; + bool split_by_materials = false; + }; + + template + StatusOr SplitMeshInternal(const Mesh &mesh, + int split_attribute_id); + + StatusOr FinalizeMeshes(const Mesh &mesh, + const WorkData &work_data, + MeshVector out_meshes) const; + + bool preserve_materials_; + bool remove_unused_material_indices_; + bool preserve_mesh_features_; + + template + friend class MeshSplitterInternal; +}; + +} // namespace draco + +#endif // DRACO_TRANSCODER_SUPPORTED +#endif // DRACO_MESH_MESH_SPLITTER_H_ diff --git a/contrib/draco/src/draco/javascript/emscripten/draco_animation_encoder_glue_wrapper.cc b/contrib/draco/src/draco/mesh/mesh_splitter_test.cc similarity index 51% rename from contrib/draco/src/draco/javascript/emscripten/draco_animation_encoder_glue_wrapper.cc rename to contrib/draco/src/draco/mesh/mesh_splitter_test.cc index 29e7ed3ba..7432c4736 100644 --- a/contrib/draco/src/draco/javascript/emscripten/draco_animation_encoder_glue_wrapper.cc +++ b/contrib/draco/src/draco/mesh/mesh_splitter_test.cc @@ -12,14 +12,17 @@ // See the License for the specific language governing permissions and // limitations under the License. // -// This file is used by emscripten's WebIDL Binder. -// http://kripken.github.io/emscripten-site/docs/porting/connecting_cpp_and_javascript/WebIDL-Binder.html -#include "draco/attributes/geometry_attribute.h" -#include "draco/attributes/point_attribute.h" -#include "draco/compression/encode.h" -#include "draco/javascript/emscripten/animation_encoder_webidl_wrapper.h" -#include "draco/mesh/mesh.h" -#include "draco/point_cloud/point_cloud.h" +#include "draco/mesh/mesh_splitter.h" -// glue_animation_encoder.cpp is generated by Makefile.emcc build_glue target. -#include "glue_animation_encoder.cpp" +#ifdef DRACO_TRANSCODER_SUPPORTED +#include +#include + +#include "draco/core/draco_test_base.h" +#include "draco/core/draco_test_utils.h" +#include "draco/core/vector_d.h" +#include "draco/io/mesh_io.h" +#include "draco/mesh/mesh_misc_functions.h" + +namespace {} // namespace +#endif // DRACO_TRANSCODER_SUPPORTED diff --git a/contrib/draco/src/draco/mesh/mesh_stripifier.h b/contrib/draco/src/draco/mesh/mesh_stripifier.h index 262e3c792..8e8d8d9f2 100644 --- a/contrib/draco/src/draco/mesh/mesh_stripifier.h +++ b/contrib/draco/src/draco/mesh/mesh_stripifier.h @@ -71,8 +71,6 @@ class MeshStripifier { mesh_ = &mesh; num_strips_ = 0; num_encoded_faces_ = 0; - // TODO(ostava): We may be able to avoid computing the corner table if we - // already have it stored somewhere. corner_table_ = CreateCornerTableFromPositionAttribute(mesh_); if (corner_table_ == nullptr) { return false; diff --git a/contrib/draco/src/draco/mesh/mesh_test.cc b/contrib/draco/src/draco/mesh/mesh_test.cc new file mode 100644 index 000000000..7cc046a7e --- /dev/null +++ b/contrib/draco/src/draco/mesh/mesh_test.cc @@ -0,0 +1,644 @@ +// Copyright 2018 The Draco Authors. +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. +// +#include "draco/mesh/mesh.h" + +#include +#include + +#include "draco/core/draco_test_base.h" +#include "draco/core/draco_test_utils.h" + +#ifdef DRACO_TRANSCODER_SUPPORTED +#include "draco/compression/draco_compression_options.h" +#include "draco/material/material_utils.h" +#include "draco/mesh/mesh_are_equivalent.h" +#include "draco/mesh/mesh_features.h" +#include "draco/mesh/mesh_utils.h" +#include "draco/mesh/triangle_soup_mesh_builder.h" +#endif // DRACO_TRANSCODER_SUPPORTED + +namespace { + +#ifdef DRACO_TRANSCODER_SUPPORTED +// Tests naming of a mesh. +TEST(MeshTest, MeshName) { + draco::Mesh mesh; + ASSERT_TRUE(mesh.GetName().empty()); + mesh.SetName("Bob"); + ASSERT_EQ(mesh.GetName(), "Bob"); +} + +// Tests copying of a mesh. +TEST(MeshTest, MeshCopy) { + const std::unique_ptr mesh = + draco::ReadMeshFromTestFile("cube_att.obj"); + ASSERT_NE(mesh, nullptr); + draco::Mesh mesh_copy; + mesh_copy.Copy(*mesh); + draco::MeshAreEquivalent eq; + ASSERT_TRUE(eq(*mesh, mesh_copy)); +} + +// Tests that we can copy a mesh to a different mesh that already contains some +// data. +TEST(MeshTest, MeshCopyToExistingMesh) { + const std::unique_ptr mesh_0 = + draco::ReadMeshFromTestFile("cube_att.obj"); + const std::unique_ptr mesh_1 = + draco::ReadMeshFromTestFile("test_nm.obj"); + ASSERT_NE(mesh_0, nullptr); + ASSERT_NE(mesh_1, nullptr); + draco::MeshAreEquivalent eq; + ASSERT_FALSE(eq(*mesh_0, *mesh_1)); + + mesh_1->Copy(*mesh_0); + ASSERT_TRUE(eq(*mesh_0, *mesh_1)); +} + +// Tests that we can remove unused materials from a mesh. +TEST(MeshTest, RemoveUnusedMaterials) { + // Input mesh has 29 materials defined in the source file but only 7 are + // actually used. + const std::unique_ptr mesh = + draco::ReadMeshFromTestFile("mat_test.obj"); + ASSERT_NE(mesh, nullptr); + + const draco::PointAttribute *const mat_att = + mesh->GetNamedAttribute(draco::GeometryAttribute::MATERIAL); + ASSERT_NE(mat_att, nullptr); + ASSERT_EQ(mat_att->size(), 29); + + ASSERT_EQ(mesh->GetMaterialLibrary().NumMaterials(), mat_att->size()); + + // Get materials on all faces. + std::vector face_materials(mesh->num_faces(), + nullptr); + for (draco::FaceIndex fi(0); fi < mesh->num_faces(); ++fi) { + uint32_t mat_index = 0; + mat_att->GetMappedValue(mesh->face(fi)[0], &mat_index); + face_materials[fi.value()] = + mesh->GetMaterialLibrary().GetMaterial(mat_index); + } + + mesh->RemoveUnusedMaterials(); + + ASSERT_EQ(mesh->GetMaterialLibrary().NumMaterials(), 7); + + // Ensure the material attribute contains material indices in the valid range. + for (draco::AttributeValueIndex avi(0); avi < mat_att->size(); ++avi) { + uint32_t mat_index = 0; + mat_att->GetValue(avi, &mat_index); + ASSERT_LT(mat_index, mesh->GetMaterialLibrary().NumMaterials()); + } + + // Ensure all materials are still the same for all faces. + for (draco::FaceIndex fi(0); fi < mesh->num_faces(); ++fi) { + uint32_t mat_index = 0; + mat_att->GetMappedValue(mesh->face(fi)[0], &mat_index); + ASSERT_EQ(mesh->GetMaterialLibrary().GetMaterial(mat_index), + face_materials[fi.value()]); + } +} + +TEST(MeshTest, RemoveUnusedMaterialsOnPointClud) { + // Input mesh has 29 materials defined in the source file but only 7 are + // actually used. Same as above test but we remove all faces and treat the + // model as a point cloud. + const std::unique_ptr mesh = + draco::ReadMeshFromTestFile("mat_test.obj"); + ASSERT_NE(mesh, nullptr); + + // Make it a point cloud. + mesh->SetNumFaces(0); + + const draco::PointAttribute *const mat_att = + mesh->GetNamedAttribute(draco::GeometryAttribute::MATERIAL); + ASSERT_NE(mat_att, nullptr); + ASSERT_EQ(mat_att->size(), 29); + + ASSERT_EQ(mesh->GetMaterialLibrary().NumMaterials(), mat_att->size()); + + // Get materials on all points. + std::vector point_materials(mesh->num_points(), + nullptr); + for (draco::PointIndex pi(0); pi < mesh->num_points(); ++pi) { + uint32_t mat_index = 0; + mat_att->GetMappedValue(pi, &mat_index); + point_materials[pi.value()] = + mesh->GetMaterialLibrary().GetMaterial(mat_index); + } + + mesh->RemoveUnusedMaterials(); + + ASSERT_EQ(mesh->GetMaterialLibrary().NumMaterials(), 7); + + // Ensure the material attribute contains material indices in the valid range. + for (draco::AttributeValueIndex avi(0); avi < mat_att->size(); ++avi) { + uint32_t mat_index = 0; + mat_att->GetValue(avi, &mat_index); + ASSERT_LT(mat_index, mesh->GetMaterialLibrary().NumMaterials()); + } + + // Ensure all materials are still the same for all points. + for (draco::PointIndex pi(0); pi < mesh->num_points(); ++pi) { + uint32_t mat_index = 0; + mat_att->GetMappedValue(pi, &mat_index); + ASSERT_EQ(mesh->GetMaterialLibrary().GetMaterial(mat_index), + point_materials[pi.value()]); + } +} + +TEST(MeshTest, RemoveUnusedMaterialsNoIndices) { + // The same as above but we actually want to remove only materials and not + // material indices. Therefore we should end up with the same number of + // materials as source but all unused materials should be "default". + const std::unique_ptr mesh = + draco::ReadMeshFromTestFile("mat_test.obj"); + ASSERT_NE(mesh, nullptr); + + const draco::PointAttribute *const mat_att = + mesh->GetNamedAttribute(draco::GeometryAttribute::MATERIAL); + ASSERT_NE(mat_att, nullptr); + ASSERT_EQ(mat_att->size(), 29); + + ASSERT_EQ(mesh->GetMaterialLibrary().NumMaterials(), mat_att->size()); + + // Do not remove unused material indices. + mesh->RemoveUnusedMaterials(false); + + ASSERT_EQ(mesh->GetMaterialLibrary().NumMaterials(), 29); + + // Gether which materials were actually used and check that all remaining + // materials are "default". + std::vector is_mat_used(mesh->GetMaterialLibrary().NumMaterials(), + false); + for (draco::AttributeValueIndex avi(0); avi < mat_att->size(); ++avi) { + uint32_t mat_index = 0; + mat_att->GetValue(avi, &mat_index); + is_mat_used[mat_index] = true; + } + + for (int mi = 0; mi < mesh->GetMaterialLibrary().NumMaterials(); ++mi) { + if (!is_mat_used[mi]) { + ASSERT_TRUE(draco::MaterialUtils::AreMaterialsEquivalent( + *mesh->GetMaterialLibrary().GetMaterial(mi), draco::Material())); + } + } +} + +TEST(MeshTest, TestAddNewAttributeWithConnectivity) { + // Tests that we can add new attributes with arbitrary connectivity to an + // existing mesh. + + // Create a simple quad. See corner indices of the quad on the figure below: + // + // *-------* + // |2\3 5| + // | \ | + // | \ | + // | \ | + // | \4| + // |0 1\| + // *-------* + // + draco::TriangleSoupMeshBuilder mb; + mb.Start(2); + mb.AddAttribute(draco::GeometryAttribute::POSITION, 3, draco::DT_FLOAT32); + mb.SetAttributeValuesForFace( + 0, draco::FaceIndex(0), draco::Vector3f(0, 0, 0).data(), + draco::Vector3f(1, 0, 0).data(), draco::Vector3f(1, 1, 0).data()); + mb.SetAttributeValuesForFace( + 0, draco::FaceIndex(1), draco::Vector3f(1, 1, 0).data(), + draco::Vector3f(1, 0, 0).data(), draco::Vector3f(1, 1, 1).data()); + std::unique_ptr mesh = mb.Finalize(); + ASSERT_NE(mesh, nullptr); + ASSERT_EQ(mesh->num_points(), 4); + ASSERT_EQ(mesh->GetNamedAttribute(draco::GeometryAttribute::POSITION)->size(), + 4); + + // Create a simple attribute that has a constant value on every corner. + std::unique_ptr pa(new draco::PointAttribute()); + pa->Init(draco::GeometryAttribute::GENERIC, 1 /*One components*/, + draco::DT_UINT8, false, 1); + uint8_t val = 10; + pa->SetAttributeValue(draco::AttributeValueIndex(0), &val); + + // Map all corners to the same value. + draco::IndexTypeVector + corner_to_point(6, draco::AttributeValueIndex(0)); + + // Adding this attribute to the mesh should not increase the number of points. + const int new_att_id_0 = + mesh->AddAttributeWithConnectivity(std::move(pa), corner_to_point); + + ASSERT_EQ(mesh->num_attributes(), 2); + ASSERT_EQ(mesh->num_points(), 4); + + const draco::PointAttribute *const new_att_0 = mesh->attribute(new_att_id_0); + ASSERT_NE(new_att_0, nullptr); + + // All points of the mesh should be mapped to the same attribute value. + for (draco::PointIndex pi(0); pi < mesh->num_points(); ++pi) { + uint8_t att_val = 0; + new_att_0->GetMappedValue(pi, &att_val); + ASSERT_EQ(att_val, 10); + } + + // Add a new attribute with two values and different connectivity. + pa = std::unique_ptr(new draco::PointAttribute()); + pa->Init(draco::GeometryAttribute::GENERIC, 1 /*One components*/, + draco::DT_UINT8, false, 2); + val = 11; + pa->SetAttributeValue(draco::AttributeValueIndex(0), &val); + val = 12; + pa->SetAttributeValue(draco::AttributeValueIndex(1), &val); + + // Map all corners to the value index 0 except for corner 1 that is mapped to + // value index 1. This should result in a new point being created on either + // corner 1 or corner 4 (see figure at the beginning of this test). + corner_to_point.assign(6, draco::AttributeValueIndex(0)); + corner_to_point[draco::CornerIndex(1)] = draco::AttributeValueIndex(1); + + const int new_att_id_1 = + mesh->AddAttributeWithConnectivity(std::move(pa), corner_to_point); + + ASSERT_EQ(mesh->num_attributes(), 3); + + // One new point should have been created by adding the new attribute. + ASSERT_EQ(mesh->num_points(), 5); + + const draco::PointAttribute *const new_att_1 = mesh->attribute(new_att_id_1); + ASSERT_NE(new_att_1, nullptr); + ASSERT_TRUE(mesh->CornerToPointId(1) == draco::PointIndex(4) || + mesh->CornerToPointId(4) == draco::PointIndex(4)); + + new_att_1->GetMappedValue(mesh->CornerToPointId(1), &val); + ASSERT_EQ(val, 12); + + new_att_1->GetMappedValue(mesh->CornerToPointId(4), &val); + ASSERT_EQ(val, 11); + + // Ensure the attribute values of the remaining attributes are well defined + // on the new point. + draco::Vector3f pos; + mesh->attribute(0)->GetMappedValue(draco::PointIndex(4), &pos[0]); + ASSERT_EQ(pos, draco::Vector3f(1, 0, 0)); + + new_att_0->GetMappedValue(draco::PointIndex(4), &val); + ASSERT_EQ(val, 10); + + new_att_0->GetMappedValue(mesh->CornerToPointId(1), &val); + ASSERT_EQ(val, 10); + new_att_0->GetMappedValue(mesh->CornerToPointId(4), &val); + ASSERT_EQ(val, 10); +} + +TEST(MeshTest, TestAddNewAttributeWithConnectivityWithIsolatedVertices) { + // Tests that we can add a new attribute with connectivity to a mesh that + // contains isolated vertices. + const std::unique_ptr mesh = + draco::ReadMeshFromTestFile("isolated_vertices.ply"); + ASSERT_NE(mesh, nullptr); + const draco::PointAttribute *const pos_att = + mesh->GetNamedAttribute(draco::GeometryAttribute::POSITION); + ASSERT_NE(pos_att, nullptr); + ASSERT_TRUE(pos_att->is_mapping_identity()); + ASSERT_EQ(pos_att->size(), 5); + ASSERT_EQ(mesh->num_points(), 5); + ASSERT_EQ(mesh->num_faces(), 2); + + // Add a new attribute with two values (one for each face). + auto pa = std::unique_ptr(new draco::PointAttribute()); + pa->Init(draco::GeometryAttribute::GENERIC, 1 /*One component*/, + draco::DT_UINT8, false, 2); + uint8_t val = 11; + pa->SetAttributeValue(draco::AttributeValueIndex(0), &val); + val = 12; + pa->SetAttributeValue(draco::AttributeValueIndex(1), &val); + + draco::IndexTypeVector + corner_to_point(6, draco::AttributeValueIndex(0)); + // All corners on the second face are mapped to the value 1. + for (draco::CornerIndex ci(3); ci < 6; ++ci) { + corner_to_point[ci] = draco::AttributeValueIndex(1); + } + + const draco::PointAttribute *const pa_raw = pa.get(); + mesh->AddAttributeWithConnectivity(std::move(pa), corner_to_point); + + // Two new point should have been added. + ASSERT_EQ(mesh->num_points(), 7); + + for (draco::PointIndex pi(0); pi < mesh->num_points(); ++pi) { + ASSERT_NE(pa_raw->mapped_index(pi), draco::kInvalidAttributeValueIndex); + ASSERT_NE(pos_att->mapped_index(pi), draco::kInvalidAttributeValueIndex); + } +} + +TEST(MeshTest, TestAddPerVertexAttribute) { + std::unique_ptr mesh = + draco::ReadMeshFromTestFile("cube_att.obj"); + + ASSERT_NE(mesh, nullptr); + const draco::PointAttribute *const pos_att = + mesh->GetNamedAttribute(draco::GeometryAttribute::POSITION); + ASSERT_NE(pos_att, nullptr); + + // The input mesh should have 8 spatial vertices. + ASSERT_EQ(pos_att->size(), 8); + + // Add a new scalar attribute where each value corresponds to the position + // value index (vertex). + std::unique_ptr pa(new draco::PointAttribute()); + pa->Init(draco::GeometryAttribute::GENERIC, /* scalar */ 1, draco::DT_FLOAT32, + false, /* one value per position value */ 8); + + // Set the value for the new attribute. + for (draco::AttributeValueIndex avi(0); avi < 8; ++avi) { + const float att_value = avi.value(); + pa->SetAttributeValue(avi, &att_value); + } + + // Add the attribute to the existing mesh. + const int new_att_id = mesh->AddPerVertexAttribute(std::move(pa)); + ASSERT_NE(new_att_id, -1); + + // Make sure all the attribute values are set correctly for every point of the + // mesh. + for (draco::PointIndex pi(0); pi < mesh->num_points(); ++pi) { + const draco::AttributeValueIndex pos_avi = pos_att->mapped_index(pi); + const draco::AttributeValueIndex new_att_avi = + mesh->attribute(new_att_id)->mapped_index(pi); + ASSERT_EQ(pos_avi, new_att_avi); + + float new_att_value; + mesh->attribute(new_att_id)->GetValue(new_att_avi, &new_att_value); + ASSERT_EQ(new_att_value, new_att_avi.value()); + } +} + +TEST(MeshTest, TestRemovalOfIsolatedPoints) { + const std::unique_ptr mesh = + draco::ReadMeshFromTestFile("isolated_vertices.ply"); + + draco::Mesh mesh_copy; + mesh_copy.Copy(*mesh); + + ASSERT_EQ(mesh_copy.num_points(), 5); + mesh_copy.RemoveIsolatedPoints(); + ASSERT_EQ(mesh_copy.num_points(), 4); + + draco::MeshAreEquivalent eq; + ASSERT_TRUE(eq(*mesh, mesh_copy)); +} + +TEST(MeshTest, TestCompressionSettings) { + // Tests compression settings of a mesh. + const std::unique_ptr mesh = + draco::ReadMeshFromTestFile("cube_att.obj"); + ASSERT_NE(mesh, nullptr); + + // Check that compression is disabled and compression settings are default. + ASSERT_FALSE(mesh->IsCompressionEnabled()); + const draco::DracoCompressionOptions default_compression_options; + ASSERT_EQ(mesh->GetCompressionOptions(), default_compression_options); + + // Check that compression options can be set without enabling compression. + draco::DracoCompressionOptions compression_options; + compression_options.quantization_bits_normal = 12; + mesh->SetCompressionOptions(compression_options); + ASSERT_EQ(mesh->GetCompressionOptions(), compression_options); + ASSERT_FALSE(mesh->IsCompressionEnabled()); + + // Check that compression can be enabled. + mesh->SetCompressionEnabled(true); + ASSERT_TRUE(mesh->IsCompressionEnabled()); + + // Check that individual compression options can be updated. + mesh->GetCompressionOptions().compression_level++; + mesh->GetCompressionOptions().compression_level--; + + // Check that compression settings can be copied. + draco::Mesh mesh_copy; + mesh_copy.Copy(*mesh); + ASSERT_TRUE(mesh_copy.IsCompressionEnabled()); + ASSERT_EQ(mesh_copy.GetCompressionOptions(), compression_options); +} + +// Tests adding and removing of mesh features to a mesh. +TEST(MeshTest, TestMeshFeatures) { + // Create a mesh with two feature ID sets. + draco::Mesh mesh; + ASSERT_EQ(mesh.NumMeshFeatures(), 0); + std::unique_ptr oceans(new draco::MeshFeatures()); + std::unique_ptr continents(new draco::MeshFeatures()); + oceans->SetLabel("oceans"); + continents->SetLabel("continents"); + const draco::MeshFeaturesIndex index_0 = + mesh.AddMeshFeatures(std::move(oceans)); + const draco::MeshFeaturesIndex index_1 = + mesh.AddMeshFeatures(std::move(continents)); + ASSERT_EQ(index_0, draco::MeshFeaturesIndex(0)); + ASSERT_EQ(index_1, draco::MeshFeaturesIndex(1)); + + // Check that the mesh has two feature ID sets. + ASSERT_EQ(mesh.NumMeshFeatures(), 2); + ASSERT_EQ(mesh.GetMeshFeatures(index_0).GetLabel(), "oceans"); + ASSERT_EQ(mesh.GetMeshFeatures(index_1).GetLabel(), "continents"); + + // Remove one feature ID set and check the remaining feature ID set. + mesh.RemoveMeshFeatures(draco::MeshFeaturesIndex(1)); + ASSERT_EQ(mesh.NumMeshFeatures(), 1); + ASSERT_EQ(mesh.GetMeshFeatures(draco::MeshFeaturesIndex(0)).GetLabel(), + "oceans"); + + // Remove the remaining feature ID set and check that no sets remain. + mesh.RemoveMeshFeatures(draco::MeshFeaturesIndex(0)); + ASSERT_EQ(mesh.NumMeshFeatures(), 0); +} + +// Tests copying of a mesh with feature ID sets. +TEST(MeshTest, MeshCopyWithMeshFeatures) { + const std::unique_ptr mesh = + draco::ReadMeshFromTestFile("cube_att.obj"); + ASSERT_NE(mesh, nullptr); + + // Add two textures to the non-material texture library of the mesh. + std::unique_ptr texture0(new draco::Texture()); + std::unique_ptr texture1(new draco::Texture()); + texture0->Resize(128, 128); + texture1->Resize(256, 256); + texture0->FillImage(draco::RGBA(100, 0, 0, 0)); + texture1->FillImage(draco::RGBA(200, 0, 0, 0)); + draco::TextureLibrary &library = mesh->GetNonMaterialTextureLibrary(); + library.PushTexture(std::move(texture0)); + library.PushTexture(std::move(texture1)); + + // Add feature ID set referring to an attribute. + const draco::MeshFeaturesIndex index_0 = mesh->AddMeshFeatures( + std::unique_ptr(new draco::MeshFeatures())); + mesh->GetMeshFeatures(index_0).SetLabel("planet"); + mesh->GetMeshFeatures(index_0).SetFeatureCount(2); + mesh->GetMeshFeatures(index_0).SetAttributeIndex(1); + + // Add feature ID set referring to texture at index 0. + const draco::MeshFeaturesIndex index_1 = mesh->AddMeshFeatures( + std::unique_ptr(new draco::MeshFeatures())); + mesh->GetMeshFeatures(index_1).SetLabel("continents"); + mesh->GetMeshFeatures(index_1).SetFeatureCount(7); + mesh->GetMeshFeatures(index_1).GetTextureMap().SetTexture( + library.GetTexture(0)); + + // Add feature ID set referring to a texture at index 1. + const draco::MeshFeaturesIndex index_2 = mesh->AddMeshFeatures( + std::unique_ptr(new draco::MeshFeatures())); + mesh->GetMeshFeatures(index_2).SetLabel("oceans"); + mesh->GetMeshFeatures(index_2).SetFeatureCount(5); + mesh->GetMeshFeatures(index_2).GetTextureMap().SetTexture( + library.GetTexture(1)); + + // Check mesh feature ID set texture pointers. + ASSERT_EQ(library.NumTextures(), 2); + ASSERT_EQ(mesh->NumMeshFeatures(), 3); + ASSERT_EQ(mesh->GetMeshFeatures(index_0).GetTextureMap().texture(), nullptr); + ASSERT_EQ(mesh->GetMeshFeatures(index_1).GetTextureMap().texture(), + library.GetTexture(0)); + ASSERT_EQ(mesh->GetMeshFeatures(index_2).GetTextureMap().texture(), + library.GetTexture(1)); + + // Copy the mesh. + draco::Mesh mesh_copy; + mesh_copy.Copy(*mesh); + + // Check that the meshes are equivalent. + draco::MeshAreEquivalent eq; + ASSERT_TRUE(eq(*mesh, mesh_copy)); + + // Also check that the texture pointers have been updated correctly. + const draco::TextureLibrary &library_copy = + mesh_copy.GetNonMaterialTextureLibrary(); + ASSERT_EQ(library_copy.NumTextures(), 2); + ASSERT_EQ(mesh_copy.NumMeshFeatures(), 3); + ASSERT_EQ(mesh_copy.GetMeshFeatures(index_0).GetTextureMap().texture(), + nullptr); + ASSERT_EQ(mesh_copy.GetMeshFeatures(index_1).GetTextureMap().texture(), + library_copy.GetTexture(0)); + ASSERT_EQ(mesh_copy.GetMeshFeatures(index_2).GetTextureMap().texture(), + library_copy.GetTexture(1)); +} + +// Tests copying of a mesh with structural metadata. +TEST(MeshTest, TestCopyWithStructuralMetadata) { + const std::unique_ptr mesh = + draco::ReadMeshFromTestFile("cube_att.obj"); + ASSERT_NE(mesh, nullptr); + + // Add structural metadata to the mesh. + draco::PropertyTable::Schema schema; + schema.json.SetString("Data"); + mesh->GetStructuralMetadata().SetPropertyTableSchema(schema); + + // Copy the mesh. + draco::Mesh copy; + copy.Copy(*mesh); + + // Check that the structural metadata has been copied. + ASSERT_EQ( + copy.GetStructuralMetadata().GetPropertyTableSchema().json.GetString(), + "Data"); +} + +// Tests removing of unused materials for a mesh with mesh features. +TEST(MeshTest, RemoveUnusedMaterialsWithMeshFeatures) { + const std::unique_ptr mesh = + draco::ReadMeshFromTestFile("BoxesMeta/glTF/BoxesMeta.gltf"); + ASSERT_NE(mesh, nullptr); + + // Input has five mesh features, two associated with material 0 and three with + // material 1. + ASSERT_EQ(mesh->NumMeshFeatures(), 5); + ASSERT_EQ(mesh->GetMeshFeaturesMaterialMask(draco::MeshFeaturesIndex(0), 0), + 0); + ASSERT_EQ(mesh->GetMeshFeaturesMaterialMask(draco::MeshFeaturesIndex(1), 0), + 0); + ASSERT_EQ(mesh->GetMeshFeaturesMaterialMask(draco::MeshFeaturesIndex(2), 0), + 1); + ASSERT_EQ(mesh->GetMeshFeaturesMaterialMask(draco::MeshFeaturesIndex(3), 0), + 1); + ASSERT_EQ(mesh->GetMeshFeaturesMaterialMask(draco::MeshFeaturesIndex(4), 0), + 1); + + // Remove material 0. + draco::PointAttribute *mat_att = mesh->attribute( + mesh->GetNamedAttributeId(draco::GeometryAttribute::MATERIAL)); + // Map mat value 0 to 1. + uint32_t new_mat_index = 1; + mat_att->SetAttributeValue(draco::AttributeValueIndex(0), &new_mat_index); + + // This should not do anything because we still have the material 0 referenced + // by mesh features 0 and 1. + mesh->RemoveUnusedMaterials(); + + ASSERT_EQ(mesh->GetMaterialLibrary().NumMaterials(), 2); + ASSERT_EQ(mesh->NumMeshFeatures(), 5); + + // Now remove unused mesh features (should be 0 and 1). + DRACO_ASSERT_OK(draco::MeshUtils::RemoveUnusedMeshFeatures(mesh.get())); + + ASSERT_EQ(mesh->NumMeshFeatures(), 3); + // All remaining mesh features should be still mapped to material 1. + ASSERT_EQ(mesh->GetMeshFeaturesMaterialMask(draco::MeshFeaturesIndex(0), 0), + 1); + ASSERT_EQ(mesh->GetMeshFeaturesMaterialMask(draco::MeshFeaturesIndex(1), 0), + 1); + ASSERT_EQ(mesh->GetMeshFeaturesMaterialMask(draco::MeshFeaturesIndex(2), 0), + 1); + + // Now remove the unused materials (0). + mesh->RemoveUnusedMaterials(); + + // Only one material should be remaining and all the mesh features should now + // be mapped to material 0. + ASSERT_EQ(mesh->GetMaterialLibrary().NumMaterials(), 1); + ASSERT_EQ(mesh->GetMeshFeaturesMaterialMask(draco::MeshFeaturesIndex(0), 0), + 0); + ASSERT_EQ(mesh->GetMeshFeaturesMaterialMask(draco::MeshFeaturesIndex(1), 0), + 0); + ASSERT_EQ(mesh->GetMeshFeaturesMaterialMask(draco::MeshFeaturesIndex(2), 0), + 0); +} +#endif // DRACO_TRANSCODER_SUPPORTED + +// Test bounding box. +TEST(MeshTest, TestMeshBoundingBox) { + const draco::Vector3f max_pt(1, 1, 1); + const draco::Vector3f min_pt(0, 0, 0); + + const std::unique_ptr mesh = + draco::ReadMeshFromTestFile("cube_att.obj"); + ASSERT_NE(mesh, nullptr) << "Failed in Loading: " + << "cube_att.obj"; + const draco::BoundingBox bounding_box = mesh->ComputeBoundingBox(); + + EXPECT_EQ(max_pt[0], bounding_box.GetMaxPoint()[0]); + EXPECT_EQ(max_pt[1], bounding_box.GetMaxPoint()[1]); + EXPECT_EQ(max_pt[2], bounding_box.GetMaxPoint()[2]); + + EXPECT_EQ(min_pt[0], bounding_box.GetMinPoint()[0]); + EXPECT_EQ(min_pt[1], bounding_box.GetMinPoint()[1]); + EXPECT_EQ(min_pt[2], bounding_box.GetMinPoint()[2]); +} + +} // namespace diff --git a/contrib/draco/src/draco/mesh/mesh_utils.cc b/contrib/draco/src/draco/mesh/mesh_utils.cc new file mode 100644 index 000000000..0fbe366c1 --- /dev/null +++ b/contrib/draco/src/draco/mesh/mesh_utils.cc @@ -0,0 +1,492 @@ +// Copyright 2019 The Draco Authors. +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. +// +#include "draco/mesh/mesh_utils.h" + +#include +#include +#include + +#ifdef DRACO_TRANSCODER_SUPPORTED +#include "draco/attributes/attribute_quantization_transform.h" +#include "draco/core/quantization_utils.h" + +namespace draco { + +void MeshUtils::TransformMesh(const Eigen::Matrix4d &transform, Mesh *mesh) { + // Transform positions. + PointAttribute *pos_att = + mesh->attribute(mesh->GetNamedAttributeId(GeometryAttribute::POSITION)); + for (AttributeValueIndex avi(0); avi < pos_att->size(); ++avi) { + Vector3f pos_val; + pos_att->GetValue(avi, &pos_val[0]); + Eigen::Vector4d transformed_val(pos_val[0], pos_val[1], pos_val[2], 1); + transformed_val = transform * transformed_val; + pos_val = + Vector3f(transformed_val[0], transformed_val[1], transformed_val[2]); + pos_att->SetAttributeValue(avi, &pos_val[0]); + } + + // Transform normals and tangents. + PointAttribute *normal_att = nullptr; + PointAttribute *tangent_att = nullptr; + if (mesh->NumNamedAttributes(GeometryAttribute::NORMAL) > 0) { + normal_att = + mesh->attribute(mesh->GetNamedAttributeId(GeometryAttribute::NORMAL)); + } + if (mesh->NumNamedAttributes(GeometryAttribute::TANGENT) > 0) { + tangent_att = + mesh->attribute(mesh->GetNamedAttributeId(GeometryAttribute::TANGENT)); + } + + if (normal_att || tangent_att) { + // Use inverse-transpose matrix to transform normals and tangents. + Eigen::Matrix3d it_transform = transform.block<3, 3>(0, 0); + + it_transform = it_transform.inverse().transpose(); + + if (normal_att) { + TransformNormalizedAttribute(it_transform, normal_att); + } + if (tangent_att) { + TransformNormalizedAttribute(it_transform, tangent_att); + } + } +} + +namespace { + +// Merges entries from |src_metadata| to |dst_metadata|. Any metadata entries +// with the same names are left unchanged. +void MergeMetadataInternal(const Metadata &src_metadata, + Metadata *dst_metadata) { + const auto &src_entries = src_metadata.entries(); + const auto &dst_entries = dst_metadata->entries(); + for (const auto &it : src_entries) { + if (dst_entries.find(it.first) != dst_entries.end()) { + // Source entry already exists in the target metadata. + continue; + } + // Copy over the entry (entries don't store the data type so binary copy + // is ok). + dst_metadata->AddEntryBinary(it.first, it.second.data()); + } + + // Merge any sub-metadata. + const auto &src_sub_metadata = src_metadata.sub_metadatas(); + const auto &dst_sub_metadata = dst_metadata->sub_metadatas(); + for (const auto &it : src_sub_metadata) { + if (dst_sub_metadata.find(it.first) == dst_sub_metadata.end()) { + // Source sub-metadata doesn't exists in the target metadata, copy it + // over. + std::unique_ptr sub_metadata(new Metadata(*it.second)); + dst_metadata->AddSubMetadata(it.first, std::move(sub_metadata)); + continue; + } + // Merge entries on the sub-metadata. + MergeMetadataInternal(*it.second, dst_metadata->sub_metadata(it.first)); + } +} + +} // namespace + +void MeshUtils::MergeMetadata(const Mesh &src_mesh, Mesh *dst_mesh) { + const auto *src_metadata = src_mesh.GetMetadata(); + if (src_metadata == nullptr) { + return; // Nothing to merge. + } + if (dst_mesh->GetMetadata() == nullptr) { + // Create new metadata for the |dst_mesh|. We do not copy the metadata + // directly because some of the underlying attribute metadata may need to + // be remapped to the format used by |dst_mesh| (e.g. unique ids of the + // attributes may have changed or some attributes may be missing on the + // |dst_mesh|). + std::unique_ptr new_metadata(new GeometryMetadata()); + dst_mesh->AddMetadata(std::move(new_metadata)); + } + auto *dst_metadata = dst_mesh->metadata(); + + // First go over all entries of the geometry part of |src_metadata|. + MergeMetadataInternal(*src_metadata, dst_metadata); + + // Go over attribute metadata. Merges only metadata for attributes that exist + // both on the source and target meshes. Attribute unique ids are remapped + // if needed. + for (int att_type_i = 0; + att_type_i < GeometryAttribute::NAMED_ATTRIBUTES_COUNT; ++att_type_i) { + const GeometryAttribute::Type att_type = + static_cast(att_type_i); + // TODO(ostava): Handle case when the number of attributes of a given type + // does not match. + if (src_mesh.NumNamedAttributes(att_type) != + dst_mesh->NumNamedAttributes(att_type)) { + continue; + } + for (int j = 0; j < src_mesh.NumNamedAttributes(att_type); ++j) { + // First check if we have a metadata for this attribute. + const PointAttribute *const src_att = + src_mesh.GetNamedAttribute(att_type, j); + const auto *src_metadata = + src_mesh.GetMetadata()->GetAttributeMetadataByUniqueId( + src_att->unique_id()); + if (src_metadata == nullptr) { + // No metadata at the source, ignore the attribute. + continue; + } + // Find target attribute corresponding to the source. + const PointAttribute *const dst_att = + dst_mesh->GetNamedAttribute(att_type, j); + if (dst_att == nullptr) { + // No corresponding attribute found, ignore the source metadata. + continue; + } + auto *dst_metadata = + dst_mesh->metadata()->attribute_metadata(dst_att->unique_id()); + if (dst_metadata == nullptr) { + // Copy over the metadata (with remapped attribute unique id). + std::unique_ptr new_metadata( + new AttributeMetadata(*src_metadata)); + new_metadata->set_att_unique_id(dst_att->unique_id()); + dst_mesh->metadata()->AddAttributeMetadata(std::move(new_metadata)); + continue; + } + // Merge metadata entries. + MergeMetadataInternal(*src_metadata, dst_metadata); + } + } +} + +Status MeshUtils::RemoveUnusedMeshFeatures(Mesh *mesh) { + // Unused mesh features are features that are not used by any face / vertex + // of the |mesh|. Currently, each mesh feature can be "masked" for specific + // materials, in which case we need to check whether the mask materials + // are present in the |mesh|. If not, we can remove the mesh features from the + // mesh. + const PointAttribute *const mat_att = + mesh->GetNamedAttribute(GeometryAttribute::MATERIAL); + // Find which materials are used. + std::unordered_set used_materials; + if (mat_att == nullptr) { + // Only material with index 0 is assumed to be used. + used_materials.insert(0); + } else { + for (AttributeValueIndex avi(0); avi < mat_att->size(); ++avi) { + uint32_t mat_index = 0; + mat_att->GetValue(avi, &mat_index); + used_materials.insert(mat_index); + } + } + + std::vector unused_mesh_features; + for (MeshFeaturesIndex mfi(0); mfi < mesh->NumMeshFeatures(); ++mfi) { + bool is_used = false; + if (mesh->NumMeshFeaturesMaterialMasks(mfi) == 0) { + is_used = true; + } else { + for (int mask_i = 0; mask_i < mesh->NumMeshFeaturesMaterialMasks(mfi); + ++mask_i) { + const int material_index = + mesh->GetMeshFeaturesMaterialMask(mfi, mask_i); + if (used_materials.count(material_index)) { + is_used = true; + break; + } + } + } + if (!is_used) { + unused_mesh_features.push_back(mfi); + } + } + + // Remove the unused mesh features (from back). + for (auto it = unused_mesh_features.rbegin(); + it != unused_mesh_features.rend(); ++it) { + const MeshFeaturesIndex mfi = *it; + mesh->RemoveMeshFeatures(mfi); + } + + // Remove all features textures that are not used anymore. + + // First find which textures are referenced by the mesh features. + std::unordered_set used_textures; + for (MeshFeaturesIndex mfi(0); mfi < mesh->NumMeshFeatures(); ++mfi) { + const Texture *const texture = + mesh->GetMeshFeatures(mfi).GetTextureMap().texture(); + if (texture) { + used_textures.insert(texture); + } + } + + if (!used_textures.empty() && + mesh->GetNonMaterialTextureLibrary().NumTextures() == 0) { + return ErrorStatus( + "Trying to remove mesh features textures that are not owned by the " + "mesh."); + } + + // Remove all unreferenced textures from the non-material texture library. + for (int ti = mesh->GetNonMaterialTextureLibrary().NumTextures() - 1; ti >= 0; + --ti) { + const Texture *const texture = + mesh->GetNonMaterialTextureLibrary().GetTexture(ti); + if (used_textures.count(texture) == 0) { + mesh->GetNonMaterialTextureLibrary().RemoveTexture(ti); + } + } + return OkStatus(); +} + +bool MeshUtils::FlipTextureUvValues(bool flip_u, bool flip_v, + PointAttribute *att) { + if (att->attribute_type() != GeometryAttribute::TEX_COORD) { + return false; + } + if (att->data_type() != DataType::DT_FLOAT32) { + return false; + } + if (att->num_components() != 2) { + return false; + } + + std::array value; + for (AttributeValueIndex avi(0); avi < att->size(); ++avi) { + if (!att->GetValue(avi, &value)) { + return false; + } + if (flip_u) { + value[0] = 1.0 - value[0]; + } + if (flip_v) { + value[1] = 1.0 - value[1]; + } + att->SetAttributeValue(avi, value.data()); + } + return true; +} + +// TODO(fgalligan): Change att_id to be of type const PointAttribute &. +int MeshUtils::CountDegenerateFaces(const Mesh &mesh, int att_id) { + const PointAttribute *const att = mesh.attribute(att_id); + if (att == nullptr) { + return -1; + } + const int num_components = att->num_components(); + switch (num_components) { + case 2: + return MeshUtils::CountDegenerateFaces(mesh, *att); + case 3: + return MeshUtils::CountDegenerateFaces(mesh, *att); + case 4: + return MeshUtils::CountDegenerateFaces(mesh, *att); + default: + break; + } + return -1; +} + +StatusOr MeshUtils::FindLowestTextureQuantization( + const Mesh &mesh, const PointAttribute &pos_att, int pos_quantization_bits, + const PointAttribute &tex_att, int tex_target_quantization_bits) { + if (tex_target_quantization_bits < 0 || tex_target_quantization_bits >= 30) { + return Status(Status::DRACO_ERROR, + "Target texture quantization is out of range."); + } + // The target quantization is no quantization, so return 0. + if (tex_target_quantization_bits == 0) { + return 0; + } + const uint32_t pos_max_quantized_value = (1 << (pos_quantization_bits)) - 1; + AttributeQuantizationTransform pos_transform; + if (!pos_transform.ComputeParameters(pos_att, pos_quantization_bits)) { + return Status(Status::DRACO_ERROR, + "Failed computing position quantization parameters."); + } + + // Get all degenerate faces for positions. If the model already has + // degenerate faces for positions, but valid faces for texture coordinates, + // those will not count as new degenerate faces for texture coordinates, + // because the faces would not have been rendered anyway. + const std::vector pos_degenerate_faces_sorted = + MeshUtils::ListDegenerateQuantizedFaces( + mesh, pos_att, pos_transform.range(), pos_max_quantized_value, false); + + // Initialize return value to zero signifying that it could not find a + // quantization that did not cause any new degenerate faces. + int lowest_quantization_bits = 0; + int min_quantization_bits = tex_target_quantization_bits; + int max_quantization_bits = 29; + while (true) { + const int curr_quantization_bits = + min_quantization_bits + + (max_quantization_bits - min_quantization_bits) / 2; + AttributeQuantizationTransform transform; + if (!transform.ComputeParameters(tex_att, curr_quantization_bits)) { + return Status(Status::DRACO_ERROR, + "Failed computing texture quantization parameters."); + } + + const uint32_t max_quantized_value = (1 << (curr_quantization_bits)) - 1; + + // Get only new degenerate faces for texture coordinates. If the model + // already has degenerate faces for texture coordinates, we don't want to + // take into account those faces in the source, because those faces would + // not have been rendered correctly anyway. + const std::vector tex_degenerate_faces_sorted = + MeshUtils::ListDegenerateQuantizedFaces( + mesh, tex_att, transform.range(), max_quantized_value, true); + + if (tex_degenerate_faces_sorted.size() <= + pos_degenerate_faces_sorted.size()) { + if (std::includes(pos_degenerate_faces_sorted.begin(), + pos_degenerate_faces_sorted.end(), + tex_degenerate_faces_sorted.begin(), + tex_degenerate_faces_sorted.end())) { + // Degenerate texture coordinate faces are a subset of position + // degenerate faces. + lowest_quantization_bits = curr_quantization_bits; + } + } + + if (lowest_quantization_bits == curr_quantization_bits) { + // The lowest quantization is the current quantization, see if lower + // quantization is possible. + max_quantization_bits = curr_quantization_bits - 1; + } else { + min_quantization_bits = curr_quantization_bits + 1; + } + if (min_quantization_bits > max_quantization_bits) { + break; + } + } + return lowest_quantization_bits; +} + +void MeshUtils::TransformNormalizedAttribute(const Eigen::Matrix3d &transform, + PointAttribute *att) { + for (AttributeValueIndex avi(0); avi < att->size(); ++avi) { + // Store up to 4 component values. + Vector4f val(0, 0, 0, 1); + att->GetValue(avi, &val); + // Ignore the last component during transformation. + Eigen::Vector3d transformed_val(val[0], val[1], val[2]); + transformed_val = transform * transformed_val; + transformed_val = transformed_val.normalized(); + // Last component is passed to the transformed value. + val = Vector4f(transformed_val[0], transformed_val[1], transformed_val[2], + val[3]); + + // Set the value to the attribute. Note that in case the attribute is using + // fewer than 4 components, the 4th component is going to be ignored. + att->SetAttributeValue(avi, &val[0]); + } +} + +template +int MeshUtils::CountDegenerateFaces(const Mesh &mesh, + const PointAttribute &att) { + if (att.data_type() != DataType::DT_FLOAT32) { + return -1; + } + std::array values; + int degenerate_values = 0; + for (FaceIndex fi(0); fi < mesh.num_faces(); ++fi) { + const auto &face = mesh.face(fi); + for (int c = 0; c < 3; ++c) { + att.GetMappedValue(face[c], &values[c][0]); + } + if (values[0] == values[1] || values[0] == values[2] || + values[1] == values[2]) { + degenerate_values++; + } + } + return degenerate_values; +} + +std::vector MeshUtils::ListDegenerateQuantizedFaces( + const Mesh &mesh, const PointAttribute &att, float range, + uint32_t max_quantized_value, bool quantized_degenerate_only) { + const int num_components = att.num_components(); + switch (num_components) { + case 2: + return MeshUtils::ListDegenerateQuantizedFaces>( + mesh, att, range, max_quantized_value, quantized_degenerate_only); + case 3: + return MeshUtils::ListDegenerateQuantizedFaces>( + mesh, att, range, max_quantized_value, quantized_degenerate_only); + case 4: + return MeshUtils::ListDegenerateQuantizedFaces>( + mesh, att, range, max_quantized_value, quantized_degenerate_only); + default: + break; + } + return std::vector(); +} + +template +std::vector MeshUtils::ListDegenerateQuantizedFaces( + const Mesh &mesh, const PointAttribute &att, float range, + uint32_t max_quantized_value, bool quantized_degenerate_only) { + std::array values; + std::array quantized_values; + + Quantizer quantizer; + quantizer.Init(range, max_quantized_value); + std::vector degenerate_faces; + + for (FaceIndex fi(0); fi < mesh.num_faces(); ++fi) { + const auto &face = mesh.face(fi); + for (int c = 0; c < 3; ++c) { + att.GetMappedValue(face[c], &values[c][0]); + for (int i = 0; i < att_components_t::dimension; ++i) { + quantized_values[c][i] = quantizer.QuantizeFloat(values[c][i]); + } + } + + if (quantized_degenerate_only && + (values[0] == values[1] || values[0] == values[2] || + values[1] == values[2])) { + continue; + } + if (quantized_values[0] == quantized_values[1] || + quantized_values[0] == quantized_values[2] || + quantized_values[1] == quantized_values[2]) { + degenerate_faces.push_back(fi); + } + } + return degenerate_faces; +} + +bool MeshUtils::HasAutoGeneratedTangents(const Mesh &mesh) { + const int tangent_att_id = + mesh.GetNamedAttributeId(draco::GeometryAttribute::TANGENT); + if (tangent_att_id == -1) { + return false; + } + const auto metadata = mesh.GetAttributeMetadataByAttributeId(tangent_att_id); + if (metadata) { + int is_auto_generated = 0; + if (metadata->GetEntryInt("auto_generated", &is_auto_generated) && + is_auto_generated == 1) { + return true; + } + } + return false; +} + +} // namespace draco + +#endif // DRACO_TRANSCODER_SUPPORTED diff --git a/contrib/draco/src/draco/mesh/mesh_utils.h b/contrib/draco/src/draco/mesh/mesh_utils.h new file mode 100644 index 000000000..e17dfd8ed --- /dev/null +++ b/contrib/draco/src/draco/mesh/mesh_utils.h @@ -0,0 +1,102 @@ +// Copyright 2019 The Draco Authors. +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. +// +#ifndef DRACO_MESH_MESH_UTILS_H_ +#define DRACO_MESH_MESH_UTILS_H_ + +#include "draco/draco_features.h" + +#ifdef DRACO_TRANSCODER_SUPPORTED +#include "Eigen/Geometry" +#include "draco/core/status_or.h" +#include "draco/mesh/mesh.h" + +namespace draco { + +// Helper class containing various utilities operating on draco::Mesh. +// TODO(ostava): Move scattered functions in this folder here (e.g. corner table +// construction). +class MeshUtils { + public: + // Transforms |mesh| using the |transform| matrix. The mesh is transformed + // in-place. + static void TransformMesh(const Eigen::Matrix4d &transform, Mesh *mesh); + + // Merges metadata from |src_mesh| to |dst_mesh|. Any metadata with the same + // names are left unchanged. + static void MergeMetadata(const Mesh &src_mesh, Mesh *dst_mesh); + + // Removes unused MeshFeatures from |mesh|. If the |mesh| contains any mesh + // feature textures, the textures must be owned by the |mesh| otherwise an + // error is returned. + static Status RemoveUnusedMeshFeatures(Mesh *mesh); + + // Flips the UV values of |att|. + static bool FlipTextureUvValues(bool flip_u, bool flip_v, + PointAttribute *att); + + // Counts the number of degenerate faces in |mesh| for attribute |att_id|. + // Returns < 0 if counting of degenerate faces is not supported for |att_id|. + static int CountDegenerateFaces(const Mesh &mesh, int att_id); + + // Searches for the lowest texture quantization bits for |tex_att| that does + // not introduce any new texture coordinate degenerate faces. The range for + // the search is |tex_target_quantization_bits| - 29, inclusive. The function + // does not count texture coordinate degenerate faces already in the source. + // Nor does it count any new texture coordinate degenerate faces that are a + // subset of new position degenerate faces created from the quantization of + // |pos_att| using |pos_quantization_bits|. Returns the lowest quantization + // bits within the specified range or zero signifying that it could not find a + // quantization that did not cause any new degenerate faces. + static StatusOr FindLowestTextureQuantization( + const Mesh &mesh, const PointAttribute &pos_att, + int pos_quantization_bits, const PointAttribute &tex_att, + int tex_target_quantization_bits); + + // Helper function that checks whether a mesh has auto-generated tangents. + // See go/tangents_and_draco_simplifier. + static bool HasAutoGeneratedTangents(const Mesh &mesh); + + private: + static void TransformNormalizedAttribute(const Eigen::Matrix3d &transform, + PointAttribute *att); + + template + static int CountDegenerateFaces(const Mesh &mesh, const PointAttribute &att); + + // Returns a sorted list of degenerate faces for |att|. |att| must use |mesh| + // for its connectivity. |range| and |max_quantized_value| are the values + // passed into the quantizer. |quantized_degenerate_only|, is true will only + // include degenerate faces caused by the quantization. Otherwise all + // degenerate faces will be included, those made by the quantization and those + // already in the source. + static std::vector ListDegenerateQuantizedFaces( + const Mesh &mesh, const PointAttribute &att, float range, + uint32_t max_quantized_value, bool quantized_degenerate_only); + + // Returns a sorted list of degenerate faces for |att|. |att_components_t| is + // the component count for |att| as a VectorD. E.g. Vector2f, Vector3f, or + // Vector4f. |quantized_components_t| is the quantized component count for + // |att| as a VectorD. E.g. VectorD, VectorD, or + // VectorD. + template + static std::vector ListDegenerateQuantizedFaces( + const Mesh &mesh, const PointAttribute &att, float range, + uint32_t max_quantized_value, bool quantized_degenerate_only); +}; + +} // namespace draco + +#endif // DRACO_TRANSCODER_SUPPORTED +#endif // DRACO_MESH_MESH_UTILS_H_ diff --git a/contrib/draco/src/draco/mesh/mesh_utils_test.cc b/contrib/draco/src/draco/mesh/mesh_utils_test.cc new file mode 100644 index 000000000..022669cb0 --- /dev/null +++ b/contrib/draco/src/draco/mesh/mesh_utils_test.cc @@ -0,0 +1,391 @@ +// Copyright 2019 The Draco Authors. +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. +// +#include "draco/mesh/mesh_utils.h" + +#ifdef DRACO_TRANSCODER_SUPPORTED +#include "draco/core/draco_test_base.h" +#include "draco/core/draco_test_utils.h" + +namespace { + +// Compare normal vector rotated by |angle| around the x-axis. +void CompareRotatedNormals(const draco::Mesh &mesh_0, const draco::Mesh &mesh_1, + float angle) { + const draco::PointAttribute *const norm_att_0 = + mesh_0.GetNamedAttribute(draco::GeometryAttribute::NORMAL); + const draco::PointAttribute *const norm_att_1 = + mesh_1.GetNamedAttribute(draco::GeometryAttribute::NORMAL); + ASSERT_EQ(norm_att_0->size(), norm_att_1->size()); + for (draco::AttributeValueIndex avi(0); avi < norm_att_0->size(); ++avi) { + Eigen::Vector3f norm_0, norm_1; + norm_att_0->GetValue(avi, norm_0.data()); + norm_att_1->GetValue(avi, norm_1.data()); + + // Project the normals into yz plane + norm_0[0] = 0.f; + norm_1[0] = 0.f; + + if (norm_0.squaredNorm() < 1e-6f) { + // Normal pointing towards X. Make sure the rotated normal is about the + // same. + ASSERT_NEAR(norm_1.squaredNorm(), 0.f, 1e-6f); + continue; + } + + // Ensure the angle between the normals is as expected. + norm_0.normalize(); + norm_1.normalize(); + const float norm_angle = + std::atan2(norm_0.cross(norm_1).norm(), norm_0.dot(norm_1)); + ASSERT_NEAR(std::abs(norm_angle), angle, 1e-6f); + } +} + +TEST(MeshUtilsTest, TestTransform) { + auto mesh = draco::ReadMeshFromTestFile("cube_att.obj"); + ASSERT_NE(mesh, nullptr); + + draco::Mesh transformed_mesh; + transformed_mesh.Copy(*mesh); + Eigen::Matrix4d transform = Eigen::Matrix4d::Identity(); + draco::MeshUtils::TransformMesh(transform, &transformed_mesh); + + // Rotate the mesh by 45 deg around the x-axis. + transform.block<3, 3>(0, 0) = + Eigen::Quaterniond( + Eigen::AngleAxisd(M_PI / 4.f, Eigen::Vector3d::UnitX())) + .normalized() + .toRotationMatrix(); + draco::MeshUtils::TransformMesh(transform, &transformed_mesh); + CompareRotatedNormals(*mesh, transformed_mesh, M_PI / 4.f); + + // Now rotate the cube back. + transform.block<3, 3>(0, 0) = + Eigen::Quaterniond( + Eigen::AngleAxisd(-M_PI / 4.f, Eigen::Vector3d::UnitX())) + .normalized() + .toRotationMatrix(); + + draco::MeshUtils::TransformMesh(transform, &transformed_mesh); + CompareRotatedNormals(*mesh, transformed_mesh, 0.f); +} + +TEST(MeshUtilsTest, TestTextureUvFlips) { + std::unique_ptr mesh = + draco::ReadMeshFromTestFile("cube_att.obj"); + ASSERT_NE(mesh, nullptr); + + // Check that FlipTextureUvValues() only works on texture coordinates. + draco::PointAttribute *att = mesh->attribute(0); + ASSERT_EQ(att->attribute_type(), draco::GeometryAttribute::POSITION); + ASSERT_FALSE(draco::MeshUtils::FlipTextureUvValues(false, true, att)); + + att = mesh->attribute(1); + ASSERT_EQ(att->attribute_type(), draco::GeometryAttribute::TEX_COORD); + + // Get the values and flip the V values. + std::vector> check_uv_values; + check_uv_values.resize(att->size()); + for (draco::AttributeValueIndex avi(0); avi < att->size(); ++avi) { + att->GetValue(avi, &check_uv_values[avi.value()]); + check_uv_values[avi.value()][1] = 1.0 - check_uv_values[avi.value()][1]; + } + + ASSERT_TRUE(draco::MeshUtils::FlipTextureUvValues(false, true, att)); + + std::array value; + for (draco::AttributeValueIndex avi(0); avi < att->size(); ++avi) { + att->GetValue(avi, &value); + ASSERT_EQ(value[0], check_uv_values[avi.value()][0]); + ASSERT_EQ(value[1], check_uv_values[avi.value()][1]); + } + + // Flip the U values. + for (int i = 0; i < check_uv_values.size(); ++i) { + check_uv_values[i][0] = 1.0 - check_uv_values[i][0]; + } + + ASSERT_TRUE(draco::MeshUtils::FlipTextureUvValues(true, false, att)); + + for (draco::AttributeValueIndex avi(0); avi < att->size(); ++avi) { + att->GetValue(avi, &value); + ASSERT_EQ(value[0], check_uv_values[avi.value()][0]); + ASSERT_EQ(value[1], check_uv_values[avi.value()][1]); + } +} + +// Tests counting degenerate values for positions and texture coordinates for +// both scene and mesh. +TEST(MeshUtilsTest, CountDegenerateValuesLantern) { + int degenerate_positions_scene = 0; + int degenerate_tex_coords_scene = 0; + std::unique_ptr scene = + draco::ReadSceneFromTestFile("Lantern/glTF/Lantern.gltf"); + ASSERT_NE(scene, nullptr); + + for (int mgi = 0; mgi < scene->NumMeshGroups(); ++mgi) { + const draco::MeshGroup *const mesh_group = + scene->GetMeshGroup(draco::MeshGroupIndex(mgi)); + ASSERT_NE(mesh_group, nullptr); + + for (int mi = 0; mi < mesh_group->NumMeshInstances(); ++mi) { + const draco::MeshIndex mesh_index = + mesh_group->GetMeshInstance(mi).mesh_index; + const draco::Mesh &m = scene->GetMesh(mesh_index); + + for (int i = 0; i < m.num_attributes(); ++i) { + const draco::PointAttribute *const att = m.attribute(i); + ASSERT_NE(att, nullptr); + + if (att->attribute_type() == draco::GeometryAttribute::Type::POSITION) { + degenerate_positions_scene += + draco::MeshUtils::CountDegenerateFaces(m, i); + } else if (att->attribute_type() == + draco::GeometryAttribute::Type::TEX_COORD) { + degenerate_tex_coords_scene += + draco::MeshUtils::CountDegenerateFaces(m, i); + } + } + } + } + EXPECT_EQ(degenerate_positions_scene, 0); + EXPECT_EQ(degenerate_tex_coords_scene, 2); + + std::unique_ptr mesh = + draco::ReadMeshFromTestFile("Lantern/glTF/Lantern.gltf"); + ASSERT_NE(mesh, nullptr); + for (int i = 0; i < mesh->num_attributes(); ++i) { + const draco::PointAttribute *const att = mesh->attribute(i); + ASSERT_NE(att, nullptr); + if (att->attribute_type() == draco::GeometryAttribute::Type::POSITION) { + EXPECT_EQ(draco::MeshUtils::CountDegenerateFaces(*mesh, i), + degenerate_positions_scene); + } else if (att->attribute_type() == + draco::GeometryAttribute::Type::TEX_COORD) { + EXPECT_EQ(draco::MeshUtils::CountDegenerateFaces(*mesh, i), + degenerate_tex_coords_scene); + } + } +} + +// Tests finding the lowest quantization bits for the texture coordinate in a +// mesh. +TEST(MeshUtilsTest, FindLowsetTextureQuantizationLanternMesh) { + std::unique_ptr mesh = + draco::ReadMeshFromTestFile("Lantern/glTF/Lantern.gltf"); + ASSERT_NE(mesh, nullptr); + + const int pos_quantization_bits = 11; + const draco::PointAttribute *const pos_att = + mesh->GetNamedAttribute(draco::GeometryAttribute::Type::POSITION, 0); + ASSERT_NE(pos_att, nullptr); + + const draco::PointAttribute *const tex_att = + mesh->GetNamedAttribute(draco::GeometryAttribute::Type::TEX_COORD, 0); + ASSERT_NE(tex_att, nullptr); + + // Tests target no quantization returns no quantization. + const int target_no_quantization_bits = 0; + DRACO_ASSIGN_OR_ASSERT(const int no_quantization_bits, + draco::MeshUtils::FindLowestTextureQuantization( + *mesh, *pos_att, pos_quantization_bits, *tex_att, + target_no_quantization_bits)); + ASSERT_EQ(no_quantization_bits, 0); + + // Test failures. + const int out_of_range_low = -1; + const auto statusor_low = draco::MeshUtils::FindLowestTextureQuantization( + *mesh, *pos_att, pos_quantization_bits, *tex_att, out_of_range_low); + ASSERT_FALSE(statusor_low.ok()); + + const int out_of_range_high = 30; + const auto statusor_high = draco::MeshUtils::FindLowestTextureQuantization( + *mesh, *pos_att, pos_quantization_bits, *tex_att, out_of_range_high); + ASSERT_FALSE(statusor_high.ok()); + + // Tests finding the lowest quantization bits for the texture coordinate. + const int target_bits = 6; + DRACO_ASSIGN_OR_ASSERT( + const int lowest_bits, + draco::MeshUtils::FindLowestTextureQuantization( + *mesh, *pos_att, pos_quantization_bits, *tex_att, target_bits)); + ASSERT_EQ(lowest_bits, 14); +} + +// Tests finding the lowest quantization bits for the texture coordinates for +// the three meshes in the scene. +TEST(MeshUtilsTest, FindLowsetTextureQuantizationLanternScene) { + std::unique_ptr scene = + draco::ReadSceneFromTestFile("Lantern/glTF/Lantern.gltf"); + ASSERT_NE(scene, nullptr); + + const std::vector expected_mesh_quantization_bits{11, 8, 14}; + for (int mi = 0; mi < scene->NumMeshes(); ++mi) { + const draco::Mesh &mesh = scene->GetMesh(draco::MeshIndex(mi)); + + const int pos_quantization_bits = 11; + const draco::PointAttribute *const pos_att = + mesh.GetNamedAttribute(draco::GeometryAttribute::Type::POSITION, 0); + ASSERT_NE(pos_att, nullptr); + + const draco::PointAttribute *const tex_att = + mesh.GetNamedAttribute(draco::GeometryAttribute::Type::TEX_COORD, 0); + ASSERT_NE(tex_att, nullptr); + + const int target_bits = 8; + DRACO_ASSIGN_OR_ASSERT( + const int lowest_bits, + draco::MeshUtils::FindLowestTextureQuantization( + mesh, *pos_att, pos_quantization_bits, *tex_att, target_bits)); + ASSERT_EQ(lowest_bits, expected_mesh_quantization_bits[mi]); + } +} + +TEST(MeshUtilsTest, CheckAutoGeneratedTangents) { + // Test verifies that MeshUtils::HasAutoGeneratedTangents works as intended. + std::unique_ptr mesh = + draco::ReadMeshFromTestFile("sphere_no_tangents.gltf"); + ASSERT_NE(mesh, nullptr); + + ASSERT_TRUE(draco::MeshUtils::HasAutoGeneratedTangents(*mesh)); +} + +TEST(MeshUtilsTest, CheckMergeMetadata) { + // Test verifies that we can merge metadata using MeshUtils::MergeMetadata(). + std::unique_ptr mesh = + draco::ReadMeshFromTestFile("sphere_no_tangents.gltf"); + ASSERT_NE(mesh, nullptr); + + std::unique_ptr other_mesh = + draco::ReadMeshFromTestFile("cube_att.obj"); + + ASSERT_NE(mesh->GetMetadata(), nullptr); + // One attribute metadata (for the tangent attribute) and no other entries. + ASSERT_EQ(mesh->GetMetadata()->attribute_metadatas().size(), 1); + ASSERT_EQ(mesh->GetMetadata()->num_entries(), 0); + + // No metadata at the other attribute. + ASSERT_EQ(other_mesh->GetMetadata(), nullptr); + + // First try to merge |other_mesh| metadata to |mesh|. This shouldn't do + // anything. + draco::MeshUtils::MergeMetadata(*other_mesh, mesh.get()); + ASSERT_EQ(mesh->GetMetadata()->attribute_metadatas().size(), 1); + ASSERT_EQ(mesh->GetMetadata()->num_entries(), 0); + + // Merge |mesh| metadata to |other_mesh|. This will create empty metadata but + // not any attribute metadata because |other_mesh| doesn't have the tangent + // attribute. + draco::MeshUtils::MergeMetadata(*mesh, other_mesh.get()); + ASSERT_NE(other_mesh->GetMetadata(), nullptr); + ASSERT_EQ(other_mesh->GetMetadata()->attribute_metadatas().size(), 0); + ASSERT_EQ(other_mesh->GetMetadata()->num_entries(), 0); + ASSERT_FALSE(draco::MeshUtils::HasAutoGeneratedTangents(*other_mesh)); + + // Add dummy tangent attribute to the |other_mesh|. + std::unique_ptr tang_att(new draco::PointAttribute()); + draco::PointAttribute *const tang_att_ptr = tang_att.get(); + tang_att->set_attribute_type(draco::GeometryAttribute::TANGENT); + other_mesh->AddAttribute(std::move(tang_att)); + + // Merge |mesh| metadata to |other_mesh|. This time the tangent metadata + // should be copied over. + draco::MeshUtils::MergeMetadata(*mesh, other_mesh.get()); + ASSERT_NE(other_mesh->GetMetadata(), nullptr); + ASSERT_EQ(other_mesh->GetMetadata()->attribute_metadatas().size(), 1); + ASSERT_EQ(other_mesh->GetMetadata()->num_entries(), 0); + ASSERT_NE(other_mesh->GetMetadata()->GetAttributeMetadataByUniqueId( + tang_att_ptr->unique_id()), + nullptr); + ASSERT_TRUE(draco::MeshUtils::HasAutoGeneratedTangents(*other_mesh)); + + // Now add some entries to the geometry metadata and merge again. + mesh->metadata()->AddEntryInt("test_int_0", 0); + mesh->metadata()->AddEntryInt("test_int_1", 1); + mesh->metadata()->AddEntryInt("test_int_shared", 2); + other_mesh->metadata()->AddEntryInt("test_int_shared", 3); + + // "test_int_0" and "test_int_1" should be copied over while + // "test_entry_shared" should stay unchanged. + draco::MeshUtils::MergeMetadata(*mesh, other_mesh.get()); + ASSERT_NE(other_mesh->GetMetadata(), nullptr); + // Attribute metadata should stay unchanged. + ASSERT_EQ(other_mesh->GetMetadata()->attribute_metadatas().size(), 1); + ASSERT_NE(other_mesh->GetMetadata()->GetAttributeMetadataByUniqueId( + tang_att_ptr->unique_id()), + nullptr); + ASSERT_EQ(other_mesh->GetMetadata() + ->GetAttributeMetadataByUniqueId(tang_att_ptr->unique_id()) + ->num_entries(), + 1); + + // Check the geometry metadata entries. + ASSERT_EQ(other_mesh->GetMetadata()->num_entries(), 3); + int metadata_value; + ASSERT_TRUE( + other_mesh->GetMetadata()->GetEntryInt("test_int_0", &metadata_value)); + ASSERT_EQ(metadata_value, 0); + ASSERT_TRUE( + other_mesh->GetMetadata()->GetEntryInt("test_int_1", &metadata_value)); + ASSERT_EQ(metadata_value, 1); + + // The shared entry should have an unchanged value. + ASSERT_TRUE(other_mesh->GetMetadata()->GetEntryInt("test_int_shared", + &metadata_value)); + ASSERT_EQ(metadata_value, 3); +} + +TEST(MeshUtilsTest, RemoveUnusedMeshFeatures) { + // Test verifies that MeshUtils::RemoveUnusedMeshFeatures works as intended. + std::unique_ptr mesh = + draco::ReadMeshFromTestFile("BoxesMeta/glTF/BoxesMeta.gltf"); + ASSERT_NE(mesh, nullptr); + + // The input mesh should have five mesh features and two features textures. + ASSERT_EQ(mesh->NumMeshFeatures(), 5); + ASSERT_EQ(mesh->GetNonMaterialTextureLibrary().NumTextures(), 2); + + // All of those features and textures should be used so calling the method + // below shouldn't do anything. + draco::MeshUtils::RemoveUnusedMeshFeatures(mesh.get()); + ASSERT_EQ(mesh->NumMeshFeatures(), 5); + ASSERT_EQ(mesh->GetNonMaterialTextureLibrary().NumTextures(), 2); + + // Now remove material 1 that is mapped to first two mesh features. + draco::PointAttribute *mat_att = mesh->attribute( + mesh->GetNamedAttributeId(draco::GeometryAttribute::MATERIAL)); + + // This basically remaps all faces from material 1 to material 0. + uint32_t mat_index = 0; + mat_att->SetAttributeValue(draco::AttributeValueIndex(1), &mat_index); + + // Try to remove the mesh features again. + draco::MeshUtils::RemoveUnusedMeshFeatures(mesh.get()); + + // Three of the mesh features should have been removed as well as one mesh + // features texture. + ASSERT_EQ(mesh->NumMeshFeatures(), 2); + ASSERT_EQ(mesh->GetNonMaterialTextureLibrary().NumTextures(), 1); + + // Ensure the remaining mesh features are mapped to the correct material. + for (draco::MeshFeaturesIndex mfi(0); mfi < mesh->NumMeshFeatures(); ++mfi) { + ASSERT_EQ(mesh->NumMeshFeaturesMaterialMasks(mfi), 1); + ASSERT_EQ(mesh->GetMeshFeaturesMaterialMask(mfi, 0), 0); + } +} + +} // namespace + +#endif // DRACO_TRANSCODER_SUPPORTED diff --git a/contrib/draco/src/draco/mesh/triangle_soup_mesh_builder.cc b/contrib/draco/src/draco/mesh/triangle_soup_mesh_builder.cc index 60b0c50b8..2af94a052 100644 --- a/contrib/draco/src/draco/mesh/triangle_soup_mesh_builder.cc +++ b/contrib/draco/src/draco/mesh/triangle_soup_mesh_builder.cc @@ -23,11 +23,23 @@ void TriangleSoupMeshBuilder::Start(int num_faces) { attribute_element_types_.clear(); } +#ifdef DRACO_TRANSCODER_SUPPORTED +void TriangleSoupMeshBuilder::SetName(const std::string &name) { + mesh_->SetName(name); +} +#endif // DRACO_TRANSCODER_SUPPORTED + int TriangleSoupMeshBuilder::AddAttribute( GeometryAttribute::Type attribute_type, int8_t num_components, DataType data_type) { + return AddAttribute(attribute_type, num_components, data_type, false); +} + +int TriangleSoupMeshBuilder::AddAttribute( + GeometryAttribute::Type attribute_type, int8_t num_components, + DataType data_type, bool normalized) { GeometryAttribute va; - va.Init(attribute_type, nullptr, num_components, data_type, false, + va.Init(attribute_type, nullptr, num_components, data_type, normalized, DataTypeLength(data_type) * num_components, 0); attribute_element_types_.push_back(-1); return mesh_->AddAttribute(va, true, mesh_->num_points()); @@ -41,8 +53,6 @@ void TriangleSoupMeshBuilder::SetAttributeValuesForFace( att->SetAttributeValue(AttributeValueIndex(start_index), corner_value_0); att->SetAttributeValue(AttributeValueIndex(start_index + 1), corner_value_1); att->SetAttributeValue(AttributeValueIndex(start_index + 2), corner_value_2); - // TODO(ostava): The below code should be called only for one attribute. - // It will work OK even for multiple attributes, but it's redundant. mesh_->SetFace(face_id, {{PointIndex(start_index), PointIndex(start_index + 1), PointIndex(start_index + 2)}}); diff --git a/contrib/draco/src/draco/mesh/triangle_soup_mesh_builder.h b/contrib/draco/src/draco/mesh/triangle_soup_mesh_builder.h index 89466e1d8..503fe84c5 100644 --- a/contrib/draco/src/draco/mesh/triangle_soup_mesh_builder.h +++ b/contrib/draco/src/draco/mesh/triangle_soup_mesh_builder.h @@ -15,7 +15,14 @@ #ifndef DRACO_MESH_TRIANGLE_SOUP_MESH_BUILDER_H_ #define DRACO_MESH_TRIANGLE_SOUP_MESH_BUILDER_H_ +#include +#include + #include "draco/draco_features.h" + +#ifdef DRACO_TRANSCODER_SUPPORTED +#include "draco/core/status.h" +#endif #include "draco/mesh/mesh.h" namespace draco { @@ -25,15 +32,25 @@ namespace draco { // deduplicated. class TriangleSoupMeshBuilder { public: + // Index type of the inserted element. + typedef FaceIndex ElementIndex; + // Starts mesh building for a given number of faces. // TODO(ostava): Currently it's necessary to select the correct number of // faces upfront. This should be generalized, but it will require us to // rewrite our attribute resizing functions. void Start(int num_faces); +#ifdef DRACO_TRANSCODER_SUPPORTED + // Sets mesh name. + void SetName(const std::string &name); +#endif // DRACO_TRANSCODER_SUPPORTED + // Adds an empty attribute to the mesh. Returns the new attribute's id. int AddAttribute(GeometryAttribute::Type attribute_type, int8_t num_components, DataType data_type); + int AddAttribute(GeometryAttribute::Type attribute_type, + int8_t num_components, DataType data_type, bool normalized); // Sets values for a given attribute on all corners of a given face. void SetAttributeValuesForFace(int att_id, FaceIndex face_id, @@ -41,12 +58,34 @@ class TriangleSoupMeshBuilder { const void *corner_value_1, const void *corner_value_2); +#ifdef DRACO_TRANSCODER_SUPPORTED + // Converts input values of type T into internal representation used by + // |att_id|. Each input value needs to have |input_num_components| entries. + template + Status ConvertAndSetAttributeValuesForFace(int att_id, FaceIndex face_id, + int input_num_components, + const T *corner_value_0, + const T *corner_value_1, + const T *corner_value_2); +#endif + // Sets value for a per-face attribute. If all faces of a given attribute are // set with this method, the attribute will be marked as per-face, otherwise // it will be marked as per-corner attribute. void SetPerFaceAttributeValueForFace(int att_id, FaceIndex face_id, const void *value); + // Add metadata. + void AddMetadata(std::unique_ptr metadata) { + mesh_->AddMetadata(std::move(metadata)); + } + + // Add metadata for an attribute. + void AddAttributeMetadata(int32_t att_id, + std::unique_ptr metadata) { + mesh_->AddAttributeMetadata(att_id, std::move(metadata)); + } + // Finalizes the mesh or returns nullptr on error. // Once this function is called, the builder becomes invalid and cannot be // used until the method Start() is called again. @@ -58,6 +97,30 @@ class TriangleSoupMeshBuilder { std::unique_ptr mesh_; }; +#ifdef DRACO_TRANSCODER_SUPPORTED +template +Status TriangleSoupMeshBuilder::ConvertAndSetAttributeValuesForFace( + int att_id, FaceIndex face_id, int input_num_components, + const T *corner_value_0, const T *corner_value_1, const T *corner_value_2) { + const int start_index = 3 * face_id.value(); + PointAttribute *const att = mesh_->attribute(att_id); + DRACO_RETURN_IF_ERROR( + att->ConvertAndSetAttributeValue(AttributeValueIndex(start_index + 0), + input_num_components, corner_value_0)); + DRACO_RETURN_IF_ERROR( + att->ConvertAndSetAttributeValue(AttributeValueIndex(start_index + 1), + input_num_components, corner_value_1)); + DRACO_RETURN_IF_ERROR( + att->ConvertAndSetAttributeValue(AttributeValueIndex(start_index + 2), + input_num_components, corner_value_2)); + mesh_->SetFace(face_id, + {{PointIndex(start_index), PointIndex(start_index + 1), + PointIndex(start_index + 2)}}); + attribute_element_types_[att_id] = MESH_CORNER_ATTRIBUTE; + return OkStatus(); +} +#endif // DRACO_TRANSCODER_SUPPORTED + } // namespace draco #endif // DRACO_MESH_TRIANGLE_SOUP_MESH_BUILDER_H_ diff --git a/contrib/draco/src/draco/mesh/triangle_soup_mesh_builder_test.cc b/contrib/draco/src/draco/mesh/triangle_soup_mesh_builder_test.cc index 171f8fe24..b23641760 100644 --- a/contrib/draco/src/draco/mesh/triangle_soup_mesh_builder_test.cc +++ b/contrib/draco/src/draco/mesh/triangle_soup_mesh_builder_test.cc @@ -14,7 +14,11 @@ // #include "draco/mesh/triangle_soup_mesh_builder.h" +#include +#include + #include "draco/core/draco_test_base.h" +#include "draco/core/draco_test_utils.h" #include "draco/core/vector_d.h" namespace draco { @@ -26,6 +30,9 @@ TEST_F(TriangleSoupMeshBuilderTest, CubeTest) { // of the provided triangle soup data. TriangleSoupMeshBuilder mb; mb.Start(12); +#ifdef DRACO_TRANSCODER_SUPPORTED + mb.SetName("Cube"); +#endif const int pos_att_id = mb.AddAttribute(GeometryAttribute::POSITION, 3, DT_FLOAT32); // clang-format off @@ -92,6 +99,9 @@ TEST_F(TriangleSoupMeshBuilderTest, CubeTest) { std::unique_ptr mesh = mb.Finalize(); ASSERT_NE(mesh, nullptr) << "Failed to build the cube mesh."; +#ifdef DRACO_TRANSCODER_SUPPORTED + EXPECT_EQ(mesh->GetName(), "Cube"); +#endif EXPECT_EQ(mesh->num_points(), 8) << "Unexpected number of vertices."; EXPECT_EQ(mesh->num_faces(), 12) << "Unexpected number of faces."; } @@ -139,7 +149,7 @@ TEST_F(TriangleSoupMeshBuilderTest, TestPerFaceAttribs) { Vector3f(0.f, 1.f, 0.f).data(), Vector3f(1.f, 1.f, 0.f).data(), Vector3f(0.f, 1.f, 1.f).data()); - mb.SetPerFaceAttributeValueForFace(gen_att_id, FaceIndex(4), &bool_false);; + mb.SetPerFaceAttributeValueForFace(gen_att_id, FaceIndex(4), &bool_false); mb.SetAttributeValuesForFace(pos_att_id, FaceIndex(5), Vector3f(0.f, 1.f, 1.f).data(), @@ -189,9 +199,69 @@ TEST_F(TriangleSoupMeshBuilderTest, TestPerFaceAttribs) { std::unique_ptr mesh = mb.Finalize(); ASSERT_NE(mesh, nullptr) << "Failed to build the cube mesh."; +#ifdef DRACO_TRANSCODER_SUPPORTED + EXPECT_TRUE(mesh->GetName().empty()); +#endif EXPECT_EQ(mesh->num_faces(), 12) << "Unexpected number of faces."; EXPECT_EQ(mesh->GetAttributeElementType(gen_att_id), MESH_FACE_ATTRIBUTE) << "Unexpected attribute element type."; } +#ifdef DRACO_TRANSCODER_SUPPORTED +TEST_F(TriangleSoupMeshBuilderTest, NormalizedColor) { + // This tests, verifies that the mesh builder constructs a valid model with + // normalized integer colors using floating points as input. + TriangleSoupMeshBuilder mb; + mb.Start(2); + const int pos_att_id = + mb.AddAttribute(GeometryAttribute::POSITION, 3, DT_FLOAT32); + const int color_att_id = + mb.AddAttribute(GeometryAttribute::COLOR, 3, DT_UINT8, true); + + mb.SetAttributeValuesForFace( + pos_att_id, FaceIndex(0), Vector3f(0.f, 0.f, 0.f).data(), + Vector3f(1.f, 0.f, 0.f).data(), Vector3f(0.f, 1.f, 0.f).data()); + DRACO_ASSERT_OK(mb.ConvertAndSetAttributeValuesForFace( + color_att_id, FaceIndex(0), 4, Vector4f(0.f, 0.f, 0.f, 1.f).data(), + Vector4f(1.f, 1.f, 1.f, 1.f).data(), + Vector4f(0.5f, 0.5f, 0.5f, 1.f).data())); + mb.SetAttributeValuesForFace( + pos_att_id, FaceIndex(1), Vector3f(0.f, 1.f, 0.f).data(), + Vector3f(1.f, 0.f, 0.f).data(), Vector3f(1.f, 1.f, 0.f).data()); + + DRACO_ASSERT_OK(mb.ConvertAndSetAttributeValuesForFace( + color_att_id, FaceIndex(1), 4, Vector4f(0.5f, 0.5f, 0.5f, 1.f).data(), + Vector4f(1.f, 1.f, 1.f, 1.f).data(), + Vector4f(0.25f, 0.0f, 1.f, 1.f).data())); + + std::unique_ptr mesh = mb.Finalize(); + ASSERT_NE(mesh, nullptr) << "Failed to build the test mesh."; + + EXPECT_EQ(mesh->num_points(), 4) << "Unexpected number of vertices."; + EXPECT_EQ(mesh->num_faces(), 2) << "Unexpected number of faces."; + + const auto *col_att = + mesh->GetNamedAttribute(draco::GeometryAttribute::COLOR); + ASSERT_NE(col_att, nullptr) << "Missing color attribute."; + ASSERT_EQ(col_att->size(), 4); + + // All colors should be in range 0-255. + uint8_t max_val = 0, min_val = 255; + for (draco::AttributeValueIndex avi(0); avi < col_att->size(); ++avi) { + VectorD cval; + col_att->GetValue(avi, &cval); + const uint8_t max = cval.MaxCoeff(); + const uint8_t min = cval.MinCoeff(); + if (max > max_val) { + max_val = max; + } + if (min < min_val) { + min_val = min; + } + } + ASSERT_EQ(max_val, 255); + ASSERT_EQ(min_val, 0); +} +#endif + } // namespace draco diff --git a/contrib/draco/src/draco/metadata/geometry_metadata.cc b/contrib/draco/src/draco/metadata/geometry_metadata.cc index b83898140..b6a882c0b 100644 --- a/contrib/draco/src/draco/metadata/geometry_metadata.cc +++ b/contrib/draco/src/draco/metadata/geometry_metadata.cc @@ -18,6 +18,19 @@ namespace draco { +AttributeMetadata::AttributeMetadata(const AttributeMetadata &metadata) + : Metadata(metadata) { + att_unique_id_ = metadata.att_unique_id_; +} + +GeometryMetadata::GeometryMetadata(const GeometryMetadata &metadata) + : Metadata(metadata) { + for (size_t i = 0; i < metadata.att_metadatas_.size(); ++i) { + att_metadatas_.push_back(std::unique_ptr( + new AttributeMetadata(*metadata.att_metadatas_[i]))); + } +} + const AttributeMetadata *GeometryMetadata::GetAttributeMetadataByStringEntry( const std::string &entry_name, const std::string &entry_value) const { for (auto &&att_metadata : att_metadatas_) { @@ -35,7 +48,7 @@ const AttributeMetadata *GeometryMetadata::GetAttributeMetadataByStringEntry( bool GeometryMetadata::AddAttributeMetadata( std::unique_ptr att_metadata) { - if (!att_metadata.get()) { + if (!att_metadata) { return false; } att_metadatas_.push_back(std::move(att_metadata)); diff --git a/contrib/draco/src/draco/metadata/geometry_metadata.h b/contrib/draco/src/draco/metadata/geometry_metadata.h index ec7ecb9ee..531bdef25 100644 --- a/contrib/draco/src/draco/metadata/geometry_metadata.h +++ b/contrib/draco/src/draco/metadata/geometry_metadata.h @@ -25,6 +25,7 @@ namespace draco { class AttributeMetadata : public Metadata { public: AttributeMetadata() : att_unique_id_(0) {} + AttributeMetadata(const AttributeMetadata &metadata); explicit AttributeMetadata(const Metadata &metadata) : Metadata(metadata), att_unique_id_(0) {} @@ -57,6 +58,7 @@ struct AttributeMetadataHasher { class GeometryMetadata : public Metadata { public: GeometryMetadata() {} + GeometryMetadata(const GeometryMetadata &metadata); explicit GeometryMetadata(const Metadata &metadata) : Metadata(metadata) {} const AttributeMetadata *GetAttributeMetadataByStringEntry( diff --git a/contrib/draco/src/draco/metadata/metadata.cc b/contrib/draco/src/draco/metadata/metadata.cc index 9141907ed..51b4e93a3 100644 --- a/contrib/draco/src/draco/metadata/metadata.cc +++ b/contrib/draco/src/draco/metadata/metadata.cc @@ -122,6 +122,14 @@ const Metadata *Metadata::GetSubMetadata(const std::string &name) const { return sub_ptr->second.get(); } +Metadata *Metadata::sub_metadata(const std::string &name) { + auto sub_ptr = sub_metadatas_.find(name); + if (sub_ptr == sub_metadatas_.end()) { + return nullptr; + } + return sub_ptr->second.get(); +} + void Metadata::RemoveEntry(const std::string &name) { // Actually just remove "name", no need to check if it exists. auto entry_ptr = entries_.find(name); diff --git a/contrib/draco/src/draco/metadata/metadata.h b/contrib/draco/src/draco/metadata/metadata.h index 56d05e46a..12c1ba974 100644 --- a/contrib/draco/src/draco/metadata/metadata.h +++ b/contrib/draco/src/draco/metadata/metadata.h @@ -147,6 +147,7 @@ class Metadata { bool AddSubMetadata(const std::string &name, std::unique_ptr sub_metadata); const Metadata *GetSubMetadata(const std::string &name) const; + Metadata *sub_metadata(const std::string &name); void RemoveEntry(const std::string &name); diff --git a/contrib/draco/src/draco/metadata/metadata_decoder.cc b/contrib/draco/src/draco/metadata/metadata_decoder.cc index a8e66f854..6468e3207 100644 --- a/contrib/draco/src/draco/metadata/metadata_decoder.cc +++ b/contrib/draco/src/draco/metadata/metadata_decoder.cc @@ -59,18 +59,25 @@ bool MetadataDecoder::DecodeGeometryMetadata(DecoderBuffer *in_buffer, } bool MetadataDecoder::DecodeMetadata(Metadata *metadata) { - struct MetadataPair { + // Limit metadata nesting depth to avoid stack overflow in destructor. + constexpr int kMaxSubmetadataLevel = 1000; + + struct MetadataTuple { Metadata *parent_metadata; Metadata *decoded_metadata; + int level; }; - std::vector metadata_stack; - metadata_stack.push_back({nullptr, metadata}); + std::vector metadata_stack; + metadata_stack.push_back({nullptr, metadata, 0}); while (!metadata_stack.empty()) { - const MetadataPair mp = metadata_stack.back(); + const MetadataTuple mp = metadata_stack.back(); metadata_stack.pop_back(); metadata = mp.decoded_metadata; if (mp.parent_metadata != nullptr) { + if (mp.level > kMaxSubmetadataLevel) { + return false; + } std::string sub_metadata_name; if (!DecodeName(&sub_metadata_name)) { return false; @@ -105,7 +112,8 @@ bool MetadataDecoder::DecodeMetadata(Metadata *metadata) { return false; } for (uint32_t i = 0; i < num_sub_metadata; ++i) { - metadata_stack.push_back({metadata, nullptr}); + metadata_stack.push_back( + {metadata, nullptr, mp.parent_metadata ? mp.level + 1 : mp.level}); } } return true; @@ -123,6 +131,9 @@ bool MetadataDecoder::DecodeEntry(Metadata *metadata) { if (data_size == 0) { return false; } + if (data_size > buffer_->remaining_size()) { + return false; + } std::vector entry_value(data_size); if (!buffer_->Decode(&entry_value[0], data_size)) { return false; diff --git a/contrib/draco/src/draco/metadata/metadata_test.cc b/contrib/draco/src/draco/metadata/metadata_test.cc index cf7ae6eee..03104e03e 100644 --- a/contrib/draco/src/draco/metadata/metadata_test.cc +++ b/contrib/draco/src/draco/metadata/metadata_test.cc @@ -104,12 +104,16 @@ TEST_F(MetadataTest, TestNestedMetadata) { sub_metadata->AddEntryInt("int", 100); metadata.AddSubMetadata("sub0", std::move(sub_metadata)); - const auto sub_metadata_ptr = metadata.GetSubMetadata("sub0"); + const auto sub_metadata_ptr = metadata.sub_metadata("sub0"); ASSERT_NE(sub_metadata_ptr, nullptr); int32_t int_value = 0; ASSERT_TRUE(sub_metadata_ptr->GetEntryInt("int", &int_value)); ASSERT_EQ(int_value, 100); + + sub_metadata_ptr->AddEntryInt("new_entry", 20); + ASSERT_TRUE(sub_metadata_ptr->GetEntryInt("new_entry", &int_value)); + ASSERT_EQ(int_value, 20); } TEST_F(MetadataTest, TestHardCopyMetadata) { diff --git a/contrib/draco/src/draco/metadata/property_table.cc b/contrib/draco/src/draco/metadata/property_table.cc new file mode 100644 index 000000000..c6a5fd984 --- /dev/null +++ b/contrib/draco/src/draco/metadata/property_table.cc @@ -0,0 +1,183 @@ +// Copyright 2022 The Draco Authors. +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. +// +#include "draco/metadata/property_table.h" + +#include +#include +#include +#include + +#ifdef DRACO_TRANSCODER_SUPPORTED + +namespace draco { + +bool PropertyTable::Schema::Object::operator==(const Object& other) const { + if (type_ != other.type_ || name_ != other.name_) { + return false; + } + switch (type_) { + case OBJECT: + if (objects_.size() != other.objects_.size()) { + return false; + } + for (int i = 0; i < objects_.size(); ++i) { + if (objects_[i] != other.objects_[i]) { + return false; + } + } + break; + case ARRAY: + if (array_.size() != other.array_.size()) { + return false; + } + for (int i = 0; i < array_.size(); ++i) { + if (array_[i] != other.array_[i]) { + return false; + } + } + break; + case STRING: + return string_ == other.string_; + case INTEGER: + return integer_ == other.integer_; + case BOOLEAN: + return boolean_ == other.boolean_; + } + return true; +} + +void PropertyTable::Schema::Object::Copy(const Object& src) { + name_ = src.name_; + type_ = src.type_; + objects_.reserve(src.objects_.size()); + for (const Object& obj : src.objects_) { + objects_.emplace_back(); + objects_.back().Copy(obj); + } + array_.reserve(src.array_.size()); + for (const Object& obj : src.array_) { + array_.emplace_back(); + array_.back().Copy(obj); + } + string_ = src.string_; + integer_ = src.integer_; + boolean_ = src.boolean_; +} + +PropertyTable::Property::Property() {} + +bool PropertyTable::Property::Data::operator==(const Data& other) const { + return data == other.data && target == other.target; +} + +bool PropertyTable::Property::Offsets::operator==(const Offsets& other) const { + return data == other.data && type == other.type; +} + +bool PropertyTable::Property::operator==(const Property& other) const { + return name_ == other.name_ && data_ == other.data_ && + array_offsets_ == other.array_offsets_ && + string_offsets_ == other.string_offsets_; +} + +void PropertyTable::Property::Copy(const Property& src) { + name_ = src.name_; + data_ = src.data_; + array_offsets_ = src.array_offsets_; + string_offsets_ = src.string_offsets_; +} + +void PropertyTable::Property::SetName(const std::string& name) { name_ = name; } +const std::string& PropertyTable::Property::GetName() const { return name_; } + +PropertyTable::Property::Data& PropertyTable::Property::GetData() { + return data_; +} +const PropertyTable::Property::Data& PropertyTable::Property::GetData() const { + return data_; +} + +const PropertyTable::Property::Offsets& +PropertyTable::Property::GetArrayOffsets() const { + return array_offsets_; +} +PropertyTable::Property::Offsets& PropertyTable::Property::GetArrayOffsets() { + return array_offsets_; +} + +const PropertyTable::Property::Offsets& +PropertyTable::Property::GetStringOffsets() const { + return string_offsets_; +} +PropertyTable::Property::Offsets& PropertyTable::Property::GetStringOffsets() { + return string_offsets_; +} + +PropertyTable::PropertyTable() : count_(0) {} + +bool PropertyTable::operator==(const PropertyTable& other) const { + if (name_ != other.name_ || class_ != other.class_ || + count_ != other.count_ || + properties_.size() != other.properties_.size()) { + return false; + } + for (int i = 0; i < properties_.size(); ++i) { + if (*properties_[i] != *other.properties_[i]) { + return false; + } + } + return true; +} + +void PropertyTable::Copy(const PropertyTable& src) { + name_ = src.name_; + class_ = src.class_; + count_ = src.count_; + properties_.clear(); + properties_.reserve(src.properties_.size()); + for (int i = 0; i < src.properties_.size(); ++i) { + std::unique_ptr property(new Property()); + property->Copy(src.GetProperty(i)); + properties_.push_back(std::move(property)); + } +} + +void PropertyTable::SetName(const std::string& value) { name_ = value; } +const std::string& PropertyTable::GetName() const { return name_; } + +void PropertyTable::SetClass(const std::string& value) { class_ = value; } +const std::string& PropertyTable::GetClass() const { return class_; } + +void PropertyTable::SetCount(int count) { count_ = count; } +int PropertyTable::GetCount() const { return count_; } + +int PropertyTable::AddProperty(std::unique_ptr property) { + properties_.push_back(std::move(property)); + return properties_.size() - 1; +} +int PropertyTable::NumProperties() const { return properties_.size(); } +const PropertyTable::Property& PropertyTable::GetProperty(int index) const { + return *properties_[index]; +} +PropertyTable::Property& PropertyTable::GetProperty(int index) { + return *properties_[index]; +} +void PropertyTable::RemoveProperty(int index) { + properties_.erase(properties_.begin() + index); +} + +} // namespace draco + +#endif // DRACO_TRANSCODER_SUPPORTED diff --git a/contrib/draco/src/draco/metadata/property_table.h b/contrib/draco/src/draco/metadata/property_table.h new file mode 100644 index 000000000..41efb0163 --- /dev/null +++ b/contrib/draco/src/draco/metadata/property_table.h @@ -0,0 +1,243 @@ +// Copyright 2022 The Draco Authors. +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. +// +#ifndef DRACO_METADATA_PROPERTY_TABLE_H_ +#define DRACO_METADATA_PROPERTY_TABLE_H_ + +#include "draco/draco_features.h" + +#ifdef DRACO_TRANSCODER_SUPPORTED + +#include +#include +#include + +namespace draco { + +// Describes a property table as defined in the EXT_structural_metadata glTF +// extension, including property table schema and table properties (columns). +class PropertyTable { + public: + // Describes property table schema in the form of a JSON object. + struct Schema { + // JSON object of the schema. + // TODO(vytyaz): Consider using a third_party/json library. Currently there + // is a conflict between Filament's assert_invariant() macro and JSON + // library's assert_invariant() method that causes compile errors in Draco + // visualization library. + class Object { + public: + enum Type { OBJECT, ARRAY, STRING, INTEGER, BOOLEAN }; + + // Constructors. + Object() : Object("") {} + explicit Object(const std::string& name) + : name_(name), type_(OBJECT), integer_(0), boolean_(false) {} + Object(const std::string& name, const std::string& value) : Object(name) { + SetString(value); + } + Object(const std::string& name, const char* value) : Object(name) { + SetString(value); + } + Object(const std::string& name, int value) : Object(name) { + SetInteger(value); + } + Object(const std::string& name, bool value) : Object(name) { + SetBoolean(value); + } + + // Methods for comparing two objects. + bool operator==(const Object& other) const; + bool operator!=(const Object& other) const { return !(*this == other); } + + // Method for copying the object. + void Copy(const Object& src); + + // Methods for getting object name and type. + const std::string& GetName() const { return name_; } + Type GetType() const { return type_; } + + // Methods for getting object value. + const std::vector& GetObjects() const { return objects_; } + const std::vector& GetArray() const { return array_; } + const std::string& GetString() const { return string_; } + int GetInteger() const { return integer_; } + bool GetBoolean() const { return boolean_; } + + // Methods for setting object value. + std::vector& SetObjects() { + type_ = OBJECT; + return objects_; + } + std::vector& SetArray() { + type_ = ARRAY; + return array_; + } + void SetString(const std::string& value) { + type_ = STRING; + string_ = value; + } + void SetInteger(int value) { + type_ = INTEGER; + integer_ = value; + } + void SetBoolean(bool value) { + type_ = BOOLEAN; + boolean_ = value; + } + + private: + std::string name_; + Type type_; + std::vector objects_; + std::vector array_; + std::string string_; + int integer_; + bool boolean_; + }; + + // Valid schema top-level JSON object name is "schema". + Schema() : json("schema") {} + + // Methods for comparing two schemas. + bool operator==(const Schema& other) const { return json == other.json; } + bool operator!=(const Schema& other) const { return !(*this == other); } + + // Valid schema top-level JSON object is required to have child objects. + bool Empty() const { return json.GetObjects().empty(); } + + // Top-level JSON object of the schema. + Object json; + }; + + // Describes a property (column) of a property table. + class Property { + public: + // Describes glTF buffer view data. + struct Data { + // Methods for comparing two data objects. + bool operator==(const Data& other) const; + bool operator!=(const Data& other) const { return !(*this == other); } + + // Buffer view data. + std::vector data; + + // Data target corresponds to the target property of the glTF bufferView + // object and classifies the type or nature of the data. + int target = 0; + }; + + // Describes offsets of the entries in property data when the data + // represents an array of strings or an array of variable-length number + // arrays. + struct Offsets { + // Methods for comparing two offsets. + bool operator==(const Offsets& other) const; + bool operator!=(const Offsets& other) const { return !(*this == other); } + + // Data containing the offset entries. + Data data; + + // Data type of the offset entries. + std::string type; + }; + + // Creates an empty property. + Property(); + + // Methods for comparing two properties. + bool operator==(const Property& other) const; + bool operator!=(const Property& other) const { return !(*this == other); } + + // Copies all data from |src| property. + void Copy(const Property& src); + + // Name of this property. + void SetName(const std::string& name); + const std::string& GetName() const; + + // Property data stores one table column worth of data. For example, when + // the data of type UINT8 is [11, 22] then the property values are 11 and 22 + // for the first and second table rows. See EXT_structural_metadata glTF + // extension documentation for more details. + Data& GetData(); + const Data& GetData() const; + + // Array offsets are used when property data contains a variable-length + // number arrays. For example, when the data is [0, 1, 2, 3, 4] and the + // array offsets are [0, 2, 5] for a two-row table, then the property value + // arrays are [0, 1] and [2, 3, 4] for the first and second table rows, + // respectively. See EXT_structural_metadata glTF extension documentation + // for more details. + const Offsets& GetArrayOffsets() const; + Offsets& GetArrayOffsets(); + + // String offsets are used when property data contains strings. For example, + // when the data is "SeaLand" and the array offsets are [0, 3, 7] for a + // two-row table, then the property strings are "Sea" and "Land" for the + // first and second table rows, respectively. See EXT_structural_metadata + // glTF extension documentation for more details. + const Offsets& GetStringOffsets() const; + Offsets& GetStringOffsets(); + + private: + std::string name_; + Data data_; + Offsets array_offsets_; + Offsets string_offsets_; + // TODO(vytyaz): Support property value modifiers min, max, offset, scale. + }; + + // Creates an empty property table. + PropertyTable(); + + // Methods for comparing two property tables. + bool operator==(const PropertyTable& other) const; + bool operator!=(const PropertyTable& other) const { + return !(*this == other); + } + + // Copies all data from |src| property table. + void Copy(const PropertyTable& src); + + // Name of this property table. + void SetName(const std::string& value); + const std::string& GetName() const; + + // Class of this property table. + void SetClass(const std::string& value); + const std::string& GetClass() const; + + // Number of rows in this property table. + void SetCount(int count); + int GetCount() const; + + // Table properties (columns). + int AddProperty(std::unique_ptr property); + int NumProperties() const; + const Property& GetProperty(int index) const; + Property& GetProperty(int index); + void RemoveProperty(int index); + + private: + std::string name_; + std::string class_; + int count_; + std::vector> properties_; +}; + +} // namespace draco + +#endif // DRACO_TRANSCODER_SUPPORTED +#endif // DRACO_METADATA_PROPERTY_TABLE_H_ diff --git a/contrib/draco/src/draco/metadata/property_table_test.cc b/contrib/draco/src/draco/metadata/property_table_test.cc new file mode 100644 index 000000000..4d5ee2d2c --- /dev/null +++ b/contrib/draco/src/draco/metadata/property_table_test.cc @@ -0,0 +1,624 @@ +// Copyright 2022 The Draco Authors. +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. +// +#include "draco/metadata/property_table.h" + +#include +#include +#include + +#include "draco/core/draco_test_base.h" +#include "draco/core/draco_test_utils.h" + +namespace { + +#ifdef DRACO_TRANSCODER_SUPPORTED + +TEST(PropertyTableTest, TestPropertyDataDefaults) { + // Test construction of an empty property data. + draco::PropertyTable::Property::Data data; + ASSERT_TRUE(data.data.empty()); + ASSERT_EQ(data.target, 0); +} + +TEST(PropertyTableTest, TestPropertyDefaults) { + // Test construction of an empty property table property. + draco::PropertyTable::Property property; + ASSERT_TRUE(property.GetName().empty()); + ASSERT_TRUE(property.GetData().data.empty()); + { + const auto &offsets = property.GetArrayOffsets(); + ASSERT_TRUE(offsets.type.empty()); + ASSERT_TRUE(offsets.data.data.empty()); + ASSERT_EQ(offsets.data.target, 0); + } + { + const auto &offsets = property.GetStringOffsets(); + ASSERT_TRUE(offsets.type.empty()); + ASSERT_TRUE(offsets.data.data.empty()); + ASSERT_EQ(offsets.data.target, 0); + } +} + +TEST(PropertyTableTest, TestPropertyTableDefaults) { + // Test construction of an empty property table. + draco::PropertyTable table; + ASSERT_TRUE(table.GetName().empty()); + ASSERT_TRUE(table.GetClass().empty()); + ASSERT_EQ(table.GetCount(), 0); + ASSERT_EQ(table.NumProperties(), 0); +} + +TEST(PropertyTableTest, TestSchemaDefaults) { + // Test construction of an empty property table schema. + draco::PropertyTable::Schema schema; + ASSERT_TRUE(schema.Empty()); + ASSERT_EQ(schema.json.GetName(), "schema"); + ASSERT_EQ(schema.json.GetType(), + draco::PropertyTable::Schema::Object::OBJECT); + ASSERT_TRUE(schema.json.GetObjects().empty()); + ASSERT_TRUE(schema.json.GetArray().empty()); + ASSERT_TRUE(schema.json.GetString().empty()); + ASSERT_EQ(schema.json.GetInteger(), 0); + ASSERT_FALSE(schema.json.GetBoolean()); +} + +TEST(PropertyTableTest, TestSchemaObjectDefaultConstructor) { + // Test construction of an empty property table schema object. + draco::PropertyTable::Schema::Object object; + ASSERT_TRUE(object.GetName().empty()); + ASSERT_EQ(object.GetType(), draco::PropertyTable::Schema::Object::OBJECT); + ASSERT_TRUE(object.GetObjects().empty()); + ASSERT_TRUE(object.GetArray().empty()); + ASSERT_TRUE(object.GetString().empty()); + ASSERT_EQ(object.GetInteger(), 0); + ASSERT_FALSE(object.GetBoolean()); +} + +TEST(PropertyTableTest, TestSchemaObjectNamedConstructor) { + // Test construction of a named property table schema object. + draco::PropertyTable::Schema::Object object("Flexible Demeanour"); + ASSERT_EQ(object.GetName(), "Flexible Demeanour"); + ASSERT_EQ(object.GetType(), draco::PropertyTable::Schema::Object::OBJECT); + ASSERT_TRUE(object.GetObjects().empty()); +} + +TEST(PropertyTableTest, TestSchemaObjectStringConstructor) { + // Test construction of property table schema object storing a string. + draco::PropertyTable::Schema::Object object("Flexible Demeanour", "GCU"); + ASSERT_EQ(object.GetName(), "Flexible Demeanour"); + ASSERT_EQ(object.GetType(), draco::PropertyTable::Schema::Object::STRING); + ASSERT_EQ(object.GetString(), "GCU"); +} + +TEST(PropertyTableTest, TestSchemaObjectIntegerConstructor) { + // Test construction of property table schema object storing an integer. + draco::PropertyTable::Schema::Object object("Flexible Demeanour", 12); + ASSERT_EQ(object.GetName(), "Flexible Demeanour"); + ASSERT_EQ(object.GetType(), draco::PropertyTable::Schema::Object::INTEGER); + ASSERT_EQ(object.GetInteger(), 12); +} + +TEST(PropertyTableTest, TestSchemaObjectBooleanConstructor) { + // Test construction of property table schema object storing a boolean. + draco::PropertyTable::Schema::Object object("Flexible Demeanour", true); + ASSERT_EQ(object.GetName(), "Flexible Demeanour"); + ASSERT_EQ(object.GetType(), draco::PropertyTable::Schema::Object::BOOLEAN); + ASSERT_TRUE(object.GetBoolean()); +} + +TEST(PropertyTableTest, TestSchemaObjectSettersAndGetters) { + // Test value setters and getters of property table schema object. + typedef draco::PropertyTable::Schema::Object Object; + Object object; + ASSERT_EQ(object.GetType(), Object::OBJECT); + + object.SetArray().push_back(Object("entry", 12)); + ASSERT_EQ(object.GetType(), Object::ARRAY); + ASSERT_EQ(object.GetArray().size(), 1); + ASSERT_EQ(object.GetArray()[0].GetName(), "entry"); + ASSERT_EQ(object.GetArray()[0].GetInteger(), 12); + + object.SetObjects().push_back(Object("object", 9)); + ASSERT_EQ(object.GetType(), Object::OBJECT); + ASSERT_EQ(object.GetObjects().size(), 1); + ASSERT_EQ(object.GetObjects()[0].GetName(), "object"); + ASSERT_EQ(object.GetObjects()[0].GetInteger(), 9); + + object.SetString("matter"); + ASSERT_EQ(object.GetType(), Object::STRING); + ASSERT_EQ(object.GetString(), "matter"); + + object.SetInteger(5); + ASSERT_EQ(object.GetType(), Object::INTEGER); + ASSERT_EQ(object.GetInteger(), 5); + + object.SetBoolean(true); + ASSERT_EQ(object.GetType(), Object::BOOLEAN); + ASSERT_EQ(object.GetBoolean(), true); +} + +TEST(PropertyTableTest, TestSchemaCompare) { + typedef draco::PropertyTable::Schema Schema; + // Test comparison of two schema objects. + { + // Compare the same empty schema object. + Schema a; + ASSERT_TRUE(a == a); + ASSERT_FALSE(a != a); + } + { + // Compare two empty schema objects. + Schema a; + Schema b; + ASSERT_TRUE(a == b); + ASSERT_FALSE(a != b); + } + { + // Compare two schema objects with different JSON objects. + Schema a; + Schema b; + a.json.SetBoolean(true); + b.json.SetBoolean(false); + ASSERT_FALSE(a == b); + ASSERT_TRUE(a != b); + } +} + +TEST(PropertyTableTest, TestSchemaObjectCompare) { + // Test comparison of two schema JSON objects. + typedef draco::PropertyTable::Schema::Object Object; + { + // Compare the same object. + Object a; + ASSERT_TRUE(a == a); + ASSERT_FALSE(a != a); + } + { + // Compare two default objects. + Object a; + Object b; + ASSERT_TRUE(a == b); + ASSERT_FALSE(a != b); + } + { + // Compare two objects with different names. + Object a("one"); + Object b("two"); + ASSERT_FALSE(a == b); + ASSERT_TRUE(a != b); + } + { + // Compare two objects with different types. + Object a; + Object b; + a.SetInteger(1); + b.SetString("one"); + ASSERT_FALSE(a == b); + ASSERT_TRUE(a != b); + } + { + // Compare two identical string-type objects. + Object a; + Object b; + a.SetString("one"); + b.SetString("one"); + ASSERT_TRUE(a == b); + ASSERT_FALSE(a != b); + } + { + // Compare two different string-type objects. + Object a; + Object b; + a.SetString("one"); + b.SetString("two"); + ASSERT_FALSE(a == b); + ASSERT_TRUE(a != b); + } + { + // Compare two identical integer-type objects. + Object a; + Object b; + a.SetInteger(1); + b.SetInteger(1); + ASSERT_TRUE(a == b); + ASSERT_FALSE(a != b); + } + { + // Compare two different integer-type objects. + Object a; + Object b; + a.SetInteger(1); + b.SetInteger(2); + ASSERT_FALSE(a == b); + ASSERT_TRUE(a != b); + } + { + // Compare two identical boolean-type objects. + Object a; + Object b; + a.SetBoolean(true); + b.SetBoolean(true); + ASSERT_TRUE(a == b); + ASSERT_FALSE(a != b); + } + { + // Compare two different boolean-type objects. + Object a; + Object b; + a.SetBoolean(true); + b.SetBoolean(false); + ASSERT_FALSE(a == b); + ASSERT_TRUE(a != b); + } + { + // Compare two identical object-type objects. + Object a; + Object b; + a.SetObjects().emplace_back("one"); + b.SetObjects().emplace_back("one"); + ASSERT_TRUE(a == b); + ASSERT_FALSE(a != b); + } + { + // Compare two different object-type objects. + Object a; + Object b; + a.SetObjects().emplace_back("one"); + b.SetObjects().emplace_back("two"); + ASSERT_FALSE(a == b); + ASSERT_TRUE(a != b); + } + { + // Compare two object-type objects with different counts. + Object a; + Object b; + a.SetObjects().emplace_back("one"); + b.SetObjects().emplace_back("one"); + b.SetObjects().emplace_back("two"); + ASSERT_FALSE(a == b); + ASSERT_TRUE(a != b); + } + { + // Compare two identical array-type objects. + Object a; + Object b; + a.SetArray().emplace_back("", 1); + b.SetArray().emplace_back("", 1); + ASSERT_TRUE(a == b); + ASSERT_FALSE(a != b); + } + { + // Compare two different array-type objects. + Object a; + Object b; + a.SetArray().emplace_back("", 1); + b.SetArray().emplace_back("", 2); + ASSERT_FALSE(a == b); + ASSERT_TRUE(a != b); + } + { + // Compare two array-type objects with different counts. + Object a; + Object b; + a.SetArray().emplace_back("", 1); + b.SetArray().emplace_back("", 1); + b.SetArray().emplace_back("", 2); + ASSERT_FALSE(a == b); + ASSERT_TRUE(a != b); + } +} + +TEST(PropertyTableTest, TestPropertySettersAndGetters) { + // Test setter and getter methods of the property table property. + draco::PropertyTable::Property property; + property.SetName("Unfortunate Conflict Of Evidence"); + property.GetData().data.push_back(2); + + // Check that property members can be accessed via getters. + ASSERT_EQ(property.GetName(), "Unfortunate Conflict Of Evidence"); + ASSERT_EQ(property.GetData().data.size(), 1); + ASSERT_EQ(property.GetData().data[0], 2); +} + +TEST(PropertyTableTest, TestPropertyTableSettersAndGetters) { + // Test setter and getter methods of the property table. + draco::PropertyTable table; + table.SetName("Just Read The Instructions"); + table.SetClass("General Contact Unit"); + table.SetCount(456); + { + std::unique_ptr property( + new draco::PropertyTable::Property()); + property->SetName("Determinist"); + ASSERT_EQ(table.AddProperty(std::move(property)), 0); + } + { + std::unique_ptr property( + new draco::PropertyTable::Property()); + property->SetName("Revisionist"); + ASSERT_EQ(table.AddProperty(std::move(property)), 1); + } + + // Check that property table members can be accessed via getters. + ASSERT_EQ(table.GetName(), "Just Read The Instructions"); + ASSERT_EQ(table.GetClass(), "General Contact Unit"); + ASSERT_EQ(table.GetCount(), 456); + ASSERT_EQ(table.NumProperties(), 2); + ASSERT_EQ(table.GetProperty(0).GetName(), "Determinist"); + ASSERT_EQ(table.GetProperty(1).GetName(), "Revisionist"); + + // Check that proeprties can be removed. + table.RemoveProperty(0); + ASSERT_EQ(table.NumProperties(), 1); + ASSERT_EQ(table.GetProperty(0).GetName(), "Revisionist"); + table.RemoveProperty(0); + ASSERT_EQ(table.NumProperties(), 0); +} + +TEST(PropertyTableTest, TestPropertyCopy) { + // Test that property table property can be copied. + draco::PropertyTable::Property property; + property.SetName("Unfortunate Conflict Of Evidence"); + property.GetData().data.push_back(2); + + // Make a copy. + draco::PropertyTable::Property copy; + copy.Copy(property); + + // Check the copy. + ASSERT_EQ(copy.GetName(), "Unfortunate Conflict Of Evidence"); + ASSERT_EQ(copy.GetData().data.size(), 1); + ASSERT_EQ(copy.GetData().data[0], 2); +} + +TEST(PropertyTableTest, TestPropertyTableCopy) { + // Test that property table can be copied. + draco::PropertyTable table; + table.SetName("Just Read The Instructions"); + table.SetClass("General Contact Unit"); + table.SetCount(456); + { + std::unique_ptr property( + new draco::PropertyTable::Property()); + property->SetName("Determinist"); + table.AddProperty(std::move(property)); + } + { + std::unique_ptr property( + new draco::PropertyTable::Property()); + property->SetName("Revisionist"); + table.AddProperty(std::move(property)); + } + + // Make a copy. + draco::PropertyTable copy; + copy.Copy(table); + + // Check the copy. + ASSERT_EQ(copy.GetName(), "Just Read The Instructions"); + ASSERT_EQ(copy.GetClass(), "General Contact Unit"); + ASSERT_EQ(copy.GetCount(), 456); + ASSERT_EQ(copy.NumProperties(), 2); + ASSERT_EQ(copy.GetProperty(0).GetName(), "Determinist"); + ASSERT_EQ(copy.GetProperty(1).GetName(), "Revisionist"); +} + +TEST(PropertyTableTest, TestPropertyDataCompare) { + // Test comparison of two property data objects. + typedef draco::PropertyTable::Property::Data Data; + { + // Compare the same data object. + Data a; + ASSERT_TRUE(a == a); + ASSERT_FALSE(a != a); + } + { + // Compare two default data objects. + Data a; + Data b; + ASSERT_TRUE(a == b); + ASSERT_FALSE(a != b); + } + { + // Compare two data objects with different targets. + Data a; + Data b; + a.target = 1; + b.target = 2; + ASSERT_FALSE(a == b); + ASSERT_TRUE(a != b); + } + { + // Compare two data objects with different data vectors. + Data a; + Data b; + a.data = {1}; + a.data = {2}; + ASSERT_FALSE(a == b); + ASSERT_TRUE(a != b); + } +} + +TEST(PropertyTableTest, TestPropertyOffsets) { + // Test comparison of two property offsets. + typedef draco::PropertyTable::Property::Offsets Offsets; + { + // Compare the same offsets object. + Offsets a; + ASSERT_TRUE(a == a); + ASSERT_FALSE(a != a); + } + { + // Compare two default offsets objects. + Offsets a; + Offsets b; + ASSERT_TRUE(a == b); + ASSERT_FALSE(a != b); + } + { + // Compare two offsets objects with different types. + Offsets a; + Offsets b; + a.type = 1; + b.type = 2; + ASSERT_FALSE(a == b); + ASSERT_TRUE(a != b); + } + { + // Compare two offsets objects with different data objects. + Offsets a; + Offsets b; + a.data.target = 1; + b.data.target = 2; + ASSERT_FALSE(a == b); + ASSERT_TRUE(a != b); + } +} + +TEST(PropertyTableTest, TestPropertyCompare) { + // Test comparison of two properties. + typedef draco::PropertyTable::Property Property; + { + // Compare the same property object. + Property a; + ASSERT_TRUE(a == a); + ASSERT_FALSE(a != a); + } + { + // Compare two default property objects. + Property a; + Property b; + ASSERT_TRUE(a == b); + ASSERT_FALSE(a != b); + } + { + // Compare two property objects with different names. + Property a; + Property b; + a.SetName("one"); + b.SetName("two"); + ASSERT_FALSE(a == b); + ASSERT_TRUE(a != b); + } + { + // Compare two property objects with different data. + Property a; + Property b; + a.GetData().target = 1; + b.GetData().target = 2; + ASSERT_FALSE(a == b); + ASSERT_TRUE(a != b); + } + { + // Compare two property objects with different array offsets. + Property a; + Property b; + a.GetArrayOffsets().data.target = 1; + b.GetArrayOffsets().data.target = 2; + ASSERT_FALSE(a == b); + ASSERT_TRUE(a != b); + } + { + // Compare two property objects with different string offsets. + Property a; + Property b; + a.GetStringOffsets().data.target = 1; + b.GetStringOffsets().data.target = 2; + ASSERT_FALSE(a == b); + ASSERT_TRUE(a != b); + } +} + +TEST(PropertyTableTest, TestPropertyTableCompare) { + // Test comparison of two property tables. + typedef draco::PropertyTable PropertyTable; + typedef draco::PropertyTable::Property Property; + { + // Compare the same property table object. + PropertyTable a; + ASSERT_TRUE(a == a); + ASSERT_FALSE(a != a); + } + { + // Compare two default property tables. + PropertyTable a; + PropertyTable b; + ASSERT_TRUE(a == b); + ASSERT_FALSE(a != b); + } + { + // Compare two property tables with different names. + PropertyTable a; + PropertyTable b; + a.SetName("one"); + b.SetName("two"); + ASSERT_FALSE(a == b); + ASSERT_TRUE(a != b); + } + { + // Compare two property tables with different classes. + PropertyTable a; + PropertyTable b; + a.SetClass("one"); + b.SetClass("two"); + ASSERT_FALSE(a == b); + ASSERT_TRUE(a != b); + } + { + // Compare two property tables with different counts. + PropertyTable a; + PropertyTable b; + a.SetCount(1); + b.SetCount(2); + ASSERT_FALSE(a == b); + ASSERT_TRUE(a != b); + } + { + // Compare two property tables with identical properties. + PropertyTable a; + PropertyTable b; + a.AddProperty(std::unique_ptr(new Property)); + b.AddProperty(std::unique_ptr(new Property)); + ASSERT_TRUE(a == b); + ASSERT_FALSE(a != b); + } + { + // Compare two property tables with different number of properties. + PropertyTable a; + PropertyTable b; + a.AddProperty(std::unique_ptr(new Property)); + b.AddProperty(std::unique_ptr(new Property)); + b.AddProperty(std::unique_ptr(new Property)); + ASSERT_FALSE(a == b); + ASSERT_TRUE(a != b); + } + { + // Compare two property tables with different properties. + PropertyTable a; + PropertyTable b; + std::unique_ptr p1(new Property); + std::unique_ptr p2(new Property); + p1->SetName("one"); + p2->SetName("two"); + a.AddProperty(std::move(p1)); + b.AddProperty(std::move(p2)); + ASSERT_FALSE(a == b); + ASSERT_TRUE(a != b); + } +} + +#endif // DRACO_TRANSCODER_SUPPORTED + +} // namespace diff --git a/contrib/draco/src/draco/metadata/structural_metadata.cc b/contrib/draco/src/draco/metadata/structural_metadata.cc new file mode 100644 index 000000000..48fff2b25 --- /dev/null +++ b/contrib/draco/src/draco/metadata/structural_metadata.cc @@ -0,0 +1,74 @@ +// Copyright 2022 The Draco Authors. +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. +// +#include "draco/metadata/structural_metadata.h" + +#include +#include + +#ifdef DRACO_TRANSCODER_SUPPORTED + +namespace draco { + +StructuralMetadata::StructuralMetadata() {} + +bool StructuralMetadata::operator==(const StructuralMetadata &other) const { + return property_table_schema_ == other.property_table_schema_ && + property_tables_ == other.property_tables_; +} + +void StructuralMetadata::Copy(const StructuralMetadata &src) { + property_table_schema_.json.Copy(src.property_table_schema_.json); + property_tables_.resize(src.property_tables_.size()); + for (int i = 0; i < property_tables_.size(); ++i) { + property_tables_[i] = std::unique_ptr(new PropertyTable()); + property_tables_[i]->Copy(*src.property_tables_[i]); + } +} + +void StructuralMetadata::SetPropertyTableSchema( + const PropertyTable::Schema &schema) { + property_table_schema_ = schema; +} + +const PropertyTable::Schema &StructuralMetadata::GetPropertyTableSchema() + const { + return property_table_schema_; +} + +int StructuralMetadata::AddPropertyTable( + std::unique_ptr property_table) { + property_tables_.push_back(std::move(property_table)); + return property_tables_.size() - 1; +} + +int StructuralMetadata::NumPropertyTables() const { + return property_tables_.size(); +} + +const PropertyTable &StructuralMetadata::GetPropertyTable(int index) const { + return *property_tables_[index]; +} + +PropertyTable &StructuralMetadata::GetPropertyTable(int index) { + return *property_tables_[index]; +} + +void StructuralMetadata::RemovePropertyTable(int index) { + property_tables_.erase(property_tables_.begin() + index); +} + +} // namespace draco + +#endif // DRACO_TRANSCODER_SUPPORTED diff --git a/contrib/draco/src/draco/metadata/structural_metadata.h b/contrib/draco/src/draco/metadata/structural_metadata.h new file mode 100644 index 000000000..24756c70c --- /dev/null +++ b/contrib/draco/src/draco/metadata/structural_metadata.h @@ -0,0 +1,64 @@ +// Copyright 2022 The Draco Authors. +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. +// +#ifndef DRACO_METADATA_STRUCTURAL_METADATA_H_ +#define DRACO_METADATA_STRUCTURAL_METADATA_H_ + +#include "draco/draco_features.h" + +#ifdef DRACO_TRANSCODER_SUPPORTED + +#include +#include +#include + +#include "draco/metadata/property_table.h" + +namespace draco { + +// Holds data associated with EXT_structural_metadata glTF extension. +class StructuralMetadata { + public: + StructuralMetadata(); + + // Methods for comparing two structural metadata objects. + bool operator==(const StructuralMetadata &other) const; + bool operator!=(const StructuralMetadata &other) const { + return !(*this == other); + } + + // Copies |src| structural metadata into this object. + void Copy(const StructuralMetadata &src); + + // Property table schema. + void SetPropertyTableSchema(const PropertyTable::Schema &schema); + const PropertyTable::Schema &GetPropertyTableSchema() const; + + // Property tables. + int AddPropertyTable(std::unique_ptr property_table); + int NumPropertyTables() const; + const PropertyTable &GetPropertyTable(int index) const; + PropertyTable &GetPropertyTable(int index); + void RemovePropertyTable(int index); + + private: + // Property table schema and property tables. + PropertyTable::Schema property_table_schema_; + std::vector> property_tables_; +}; + +} // namespace draco + +#endif // DRACO_TRANSCODER_SUPPORTED +#endif // DRACO_METADATA_STRUCTURAL_METADATA_H_ diff --git a/contrib/draco/src/draco/metadata/structural_metadata_test.cc b/contrib/draco/src/draco/metadata/structural_metadata_test.cc new file mode 100644 index 000000000..d0429a568 --- /dev/null +++ b/contrib/draco/src/draco/metadata/structural_metadata_test.cc @@ -0,0 +1,170 @@ +// Copyright 2022 The Draco Authors. +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. +// +#include "draco/metadata/structural_metadata.h" + +#include +#include +#include + +#include "draco/core/draco_test_base.h" +#include "draco/core/draco_test_utils.h" + +namespace { + +#ifdef DRACO_TRANSCODER_SUPPORTED + +TEST(StructuralMetadataTest, TestCopy) { + // Tests copying of structural metadata. + draco::StructuralMetadata structural_metadata; + + // Add property table schema to structural metadata. + draco::PropertyTable::Schema schema; + schema.json.SetString("Culture"); + structural_metadata.SetPropertyTableSchema(schema); + + // Add property table to structural metadata. + std::unique_ptr table(new draco::PropertyTable()); + table->SetName("Just Read The Instructions"); + table->SetClass("General Contact Unit"); + table->SetCount(456); + { + std::unique_ptr property( + new draco::PropertyTable::Property()); + property->SetName("Determinist"); + table->AddProperty(std::move(property)); + } + { + std::unique_ptr property( + new draco::PropertyTable::Property()); + property->SetName("Revisionist"); + table->AddProperty(std::move(property)); + } + ASSERT_EQ(structural_metadata.AddPropertyTable(std::move(table)), 0); + + // Copy the structural metadata. + draco::StructuralMetadata copy; + copy.Copy(structural_metadata); + + // Check that the structural metadata property table schema has been copied. + ASSERT_EQ(copy.GetPropertyTableSchema().json.GetString(), "Culture"); + + // Check that the structural metadata property table has been copied. + ASSERT_EQ(copy.NumPropertyTables(), 1); + ASSERT_EQ(copy.GetPropertyTable(0).GetName(), "Just Read The Instructions"); + ASSERT_EQ(copy.GetPropertyTable(0).GetClass(), "General Contact Unit"); + ASSERT_EQ(copy.GetPropertyTable(0).GetCount(), 456); + ASSERT_EQ(copy.GetPropertyTable(0).NumProperties(), 2); + ASSERT_EQ(copy.GetPropertyTable(0).GetProperty(0).GetName(), "Determinist"); + ASSERT_EQ(copy.GetPropertyTable(0).GetProperty(1).GetName(), "Revisionist"); +} + +TEST(StructuralMetadataTest, TestPropertyTables) { + // Tests adding and removing of property tables to structural metadata. + draco::StructuralMetadata structural_metadata; + + // Check that property tables can be added. + { + std::unique_ptr table(new draco::PropertyTable()); + table->SetName("Just Read The Instructions"); + ASSERT_EQ(structural_metadata.AddPropertyTable(std::move(table)), 0); + } + { + std::unique_ptr table(new draco::PropertyTable()); + table->SetName("So Much For Subtlety"); + ASSERT_EQ(structural_metadata.AddPropertyTable(std::move(table)), 1); + } + { + std::unique_ptr table(new draco::PropertyTable()); + table->SetName("Of Course I Still Love You"); + ASSERT_EQ(structural_metadata.AddPropertyTable(std::move(table)), 2); + } + draco::StructuralMetadata &sm = structural_metadata; + + // Check that the property tables can be removed. + ASSERT_EQ(sm.NumPropertyTables(), 3); + ASSERT_EQ(sm.GetPropertyTable(0).GetName(), "Just Read The Instructions"); + ASSERT_EQ(sm.GetPropertyTable(1).GetName(), "So Much For Subtlety"); + ASSERT_EQ(sm.GetPropertyTable(2).GetName(), "Of Course I Still Love You"); + + sm.RemovePropertyTable(1); + ASSERT_EQ(sm.NumPropertyTables(), 2); + ASSERT_EQ(sm.GetPropertyTable(0).GetName(), "Just Read The Instructions"); + ASSERT_EQ(sm.GetPropertyTable(1).GetName(), "Of Course I Still Love You"); + + sm.RemovePropertyTable(1); + ASSERT_EQ(sm.NumPropertyTables(), 1); + ASSERT_EQ(sm.GetPropertyTable(0).GetName(), "Just Read The Instructions"); + + sm.RemovePropertyTable(0); + ASSERT_EQ(sm.NumPropertyTables(), 0); +} + +TEST(StructuralMetadataTest, TestCompare) { + // Test comparison of two structural metadata objects. + typedef draco::PropertyTable PropertyTable; + { + // Compare the same structural metadata object. + draco::StructuralMetadata a; + ASSERT_TRUE(a == a); + ASSERT_FALSE(a != a); + } + { + // Compare two identical structural metadata objects. + draco::StructuralMetadata a; + draco::StructuralMetadata b; + ASSERT_TRUE(a == b); + ASSERT_FALSE(a != b); + } + { + // Compare two structural metadata objects with different schemas. + draco::StructuralMetadata a; + draco::StructuralMetadata b; + PropertyTable::Schema s1; + PropertyTable::Schema s2; + s1.json.SetString("one"); + s2.json.SetString("two"); + a.SetPropertyTableSchema(s1); + b.SetPropertyTableSchema(s2); + ASSERT_FALSE(a == b); + ASSERT_TRUE(a != b); + } + { + // Compare two objects with different number of proeprty tables. + draco::StructuralMetadata a; + draco::StructuralMetadata b; + a.AddPropertyTable(std::unique_ptr(new PropertyTable())); + b.AddPropertyTable(std::unique_ptr(new PropertyTable())); + b.AddPropertyTable(std::unique_ptr(new PropertyTable())); + ASSERT_FALSE(a == b); + ASSERT_TRUE(a != b); + } + { + // Compare two objects with different proeprty tables. + draco::StructuralMetadata a; + draco::StructuralMetadata b; + auto p1 = std::unique_ptr(new PropertyTable()); + auto p2 = std::unique_ptr(new PropertyTable()); + p1->SetName("one"); + p2->SetName("two"); + a.AddPropertyTable(std::move(p1)); + b.AddPropertyTable(std::move(p2)); + ASSERT_FALSE(a == b); + ASSERT_TRUE(a != b); + } +} + +#endif // DRACO_TRANSCODER_SUPPORTED + +} // namespace diff --git a/contrib/draco/src/draco/point_cloud/point_cloud.cc b/contrib/draco/src/draco/point_cloud/point_cloud.cc index a9f9ea2af..039c4f201 100644 --- a/contrib/draco/src/draco/point_cloud/point_cloud.cc +++ b/contrib/draco/src/draco/point_cloud/point_cloud.cc @@ -16,11 +16,41 @@ #include #include +#include + +#ifdef DRACO_TRANSCODER_SUPPORTED +#include "draco/attributes/point_attribute.h" +#endif namespace draco { PointCloud::PointCloud() : num_points_(0) {} +#ifdef DRACO_TRANSCODER_SUPPORTED +void PointCloud::Copy(const PointCloud &src) { + num_points_ = src.num_points_; + for (int i = 0; i < GeometryAttribute::NAMED_ATTRIBUTES_COUNT; ++i) { + named_attribute_index_[i] = src.named_attribute_index_[i]; + } + attributes_.resize(src.attributes_.size()); + for (int i = 0; i < src.attributes_.size(); ++i) { + attributes_[i] = std::unique_ptr(new PointAttribute()); + attributes_[i]->CopyFrom(*src.attributes_[i]); + } + CopyMetadata(src); +} + +void PointCloud::CopyMetadata(const PointCloud &src) { + if (src.metadata_ == nullptr) { + metadata_ = nullptr; + } else { + // Copy base metadata. + const GeometryMetadata *const metadata = src.metadata_.get(); + metadata_.reset(new GeometryMetadata(*metadata)); + } +} +#endif + int32_t PointCloud::NumNamedAttributes(GeometryAttribute::Type type) const { if (type == GeometryAttribute::INVALID || type >= GeometryAttribute::NAMED_ATTRIBUTES_COUNT) { @@ -253,11 +283,16 @@ bool PointCloud::DeduplicateAttributeValues() { } #endif -// TODO(xiaoxumeng): Consider to cash the BBox. +// TODO(b/199760503): Consider to cache the BBox. BoundingBox PointCloud::ComputeBoundingBox() const { BoundingBox bounding_box; auto pc_att = GetNamedAttribute(GeometryAttribute::POSITION); - // TODO(xiaoxumeng): Make the BoundingBox a template type, it may not be easy + if (pc_att == nullptr) { + // Return default invalid bounding box. + return bounding_box; + } + + // TODO(b/199760503): Make the BoundingBox a template type, it may not be easy // because PointCloud is not a template. // Or simply add some preconditioning here to make sure the position attribute // is valid, because the current code works only if the position attribute is diff --git a/contrib/draco/src/draco/point_cloud/point_cloud.h b/contrib/draco/src/draco/point_cloud/point_cloud.h index d11bd47a3..17d0bc392 100644 --- a/contrib/draco/src/draco/point_cloud/point_cloud.h +++ b/contrib/draco/src/draco/point_cloud/point_cloud.h @@ -31,6 +31,11 @@ class PointCloud { PointCloud(); virtual ~PointCloud() = default; +#ifdef DRACO_TRANSCODER_SUPPORTED + // Copies all data from the |src| point cloud. + void Copy(const PointCloud &src); +#endif + // Returns the number of named attributes of a given type. int32_t NumNamedAttributes(GeometryAttribute::Type type) const; @@ -185,6 +190,11 @@ class PointCloud { void set_num_points(PointIndex::ValueType num) { num_points_ = num; } protected: +#ifdef DRACO_TRANSCODER_SUPPORTED + // Copies metadata from the |src| point cloud. + void CopyMetadata(const PointCloud &src); +#endif + #ifdef DRACO_ATTRIBUTE_INDICES_DEDUPLICATION_SUPPORTED // Applies id mapping of deduplicated points (called by DeduplicatePointIds). virtual void ApplyPointIdDeduplication( diff --git a/contrib/draco/src/draco/point_cloud/point_cloud_builder.cc b/contrib/draco/src/draco/point_cloud/point_cloud_builder.cc index 431ae505f..90ec37962 100644 --- a/contrib/draco/src/draco/point_cloud/point_cloud_builder.cc +++ b/contrib/draco/src/draco/point_cloud/point_cloud_builder.cc @@ -14,6 +14,8 @@ // #include "draco/point_cloud/point_cloud_builder.h" +#include + namespace draco { PointCloudBuilder::PointCloudBuilder() {} diff --git a/contrib/draco/src/draco/point_cloud/point_cloud_builder.h b/contrib/draco/src/draco/point_cloud/point_cloud_builder.h index cf55a728b..512b0f71f 100644 --- a/contrib/draco/src/draco/point_cloud/point_cloud_builder.h +++ b/contrib/draco/src/draco/point_cloud/point_cloud_builder.h @@ -15,6 +15,8 @@ #ifndef DRACO_POINT_CLOUD_POINT_CLOUD_BUILDER_H_ #define DRACO_POINT_CLOUD_POINT_CLOUD_BUILDER_H_ +#include + #include "draco/point_cloud/point_cloud.h" namespace draco { @@ -37,6 +39,9 @@ namespace draco { class PointCloudBuilder { public: + // Index type of the inserted element. + typedef PointIndex ElementIndex; + PointCloudBuilder(); // Starts collecting point cloud data. @@ -71,6 +76,12 @@ class PointCloudBuilder { // used until the method Start() is called again. std::unique_ptr Finalize(bool deduplicate_points); + // Add metadata for an attribute. + void AddAttributeMetadata(int32_t att_id, + std::unique_ptr metadata) { + point_cloud_->AddAttributeMetadata(att_id, std::move(metadata)); + } + private: std::unique_ptr point_cloud_; }; diff --git a/contrib/draco/src/draco/point_cloud/point_cloud_test.cc b/contrib/draco/src/draco/point_cloud/point_cloud_test.cc index 4e9460370..1cd780db2 100644 --- a/contrib/draco/src/draco/point_cloud/point_cloud_test.cc +++ b/contrib/draco/src/draco/point_cloud/point_cloud_test.cc @@ -14,6 +14,9 @@ // #include "draco/point_cloud/point_cloud.h" +#include +#include + #include "draco/core/draco_test_base.h" #include "draco/core/draco_test_utils.h" #include "draco/metadata/geometry_metadata.h" @@ -25,6 +28,57 @@ class PointCloudTest : public ::testing::Test { PointCloudTest() {} }; +#ifdef DRACO_TRANSCODER_SUPPORTED +TEST_F(PointCloudTest, PointCloudCopy) { + // Tests that we can copy a point cloud. + std::unique_ptr pc = + draco::ReadPointCloudFromTestFile("pc_kd_color.drc"); + ASSERT_NE(pc, nullptr); + + // Add metadata to the point cloud. + std::unique_ptr metadata( + new draco::GeometryMetadata()); + metadata->AddEntryInt("speed", 1050); + metadata->AddEntryString("code", "YT-1300f"); + + // Add attribute metadata. + std::unique_ptr a_metadata( + new draco::AttributeMetadata()); + a_metadata->set_att_unique_id(pc->attribute(0)->unique_id()); + a_metadata->AddEntryInt("attribute_test", 3); + metadata->AddAttributeMetadata(std::move(a_metadata)); + pc->AddMetadata(std::move(metadata)); + + // Create a copy of the point cloud. + draco::PointCloud pc_copy; + pc_copy.Copy(*pc); + + // Check the point cloud data. + ASSERT_EQ(pc->num_points(), pc_copy.num_points()); + ASSERT_EQ(pc->num_attributes(), pc_copy.num_attributes()); + for (int i = 0; i < pc->num_attributes(); ++i) { + ASSERT_EQ(pc->attribute(i)->attribute_type(), + pc_copy.attribute(i)->attribute_type()); + } + + // Check the point cloud metadata. + int speed; + std::string code; + ASSERT_NE(pc->GetMetadata(), nullptr); + ASSERT_TRUE(pc->GetMetadata()->GetEntryInt("speed", &speed)); + ASSERT_TRUE(pc->GetMetadata()->GetEntryString("code", &code)); + ASSERT_EQ(speed, 1050); + ASSERT_EQ(code, "YT-1300f"); + + const auto *const att_metadata_copy = + pc->GetMetadata()->GetAttributeMetadataByUniqueId(0); + ASSERT_NE(att_metadata_copy, nullptr); + int att_test; + ASSERT_TRUE(att_metadata_copy->GetEntryInt("attribute_test", &att_test)); + ASSERT_EQ(att_test, 3); +} +#endif + TEST_F(PointCloudTest, TestAttributeDeletion) { draco::PointCloud pc; // Test whether we can correctly delete an attribute from a point cloud. diff --git a/contrib/draco/src/draco/scene/instance_array.cc b/contrib/draco/src/draco/scene/instance_array.cc new file mode 100644 index 000000000..bcd49996a --- /dev/null +++ b/contrib/draco/src/draco/scene/instance_array.cc @@ -0,0 +1,45 @@ +// Copyright 2022 The Draco Authors. +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. +// +#include "draco/scene/instance_array.h" + +#ifdef DRACO_TRANSCODER_SUPPORTED + +#include + +namespace draco { + +void InstanceArray::Copy(const InstanceArray &other) { + instances_.resize(other.instances_.size()); + for (int i = 0; i < instances_.size(); i++) { + instances_[i].trs.Copy(other.instances_[i].trs); + } +} + +Status InstanceArray::AddInstance(const Instance &instance) { + // Check that the |instance.trs| does not have the transformation matrix set, + // because the EXT_mesh_gpu_instancing glTF extension dictates that only the + // individual TRS vectors are stored. + if (instance.trs.MatrixSet()) { + return ErrorStatus("Instance must have no matrix set."); + } + + // Move the |instance| to the end of the instances vector. + instances_.push_back(instance); + return OkStatus(); +} + +} // namespace draco + +#endif // DRACO_TRANSCODER_SUPPORTED diff --git a/contrib/draco/src/draco/scene/instance_array.h b/contrib/draco/src/draco/scene/instance_array.h new file mode 100644 index 000000000..fb1fbde1e --- /dev/null +++ b/contrib/draco/src/draco/scene/instance_array.h @@ -0,0 +1,61 @@ +// Copyright 2022 The Draco Authors. +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. +// +#ifndef DRACO_SCENE_INSTANCE_ARRAY_H_ +#define DRACO_SCENE_INSTANCE_ARRAY_H_ + +#include "draco/draco_features.h" + +#ifdef DRACO_TRANSCODER_SUPPORTED +#include +#include + +#include "draco/core/vector_d.h" +#include "draco/scene/trs_matrix.h" + +namespace draco { + +// Describes a mesh group instancing array that includes TRS transformation +// for multiple instance positions and possibly other custom instance attributes +// (not yet supported), following the EXT_mesh_gpu_instancing glTF extension. +class InstanceArray { + public: + struct Instance { + // Translation, rotation, and scale vectors. + TrsMatrix trs; + // TODO(vytyaz): Support custom instance attributes, e.g., _ID, _COLOR, etc. + }; + + InstanceArray() = default; + + void Copy(const InstanceArray &other); + + // Adds one |instance| into this mesh group instance array where the + // |instance.trs| may have optional translation, rotation, and scale set. + Status AddInstance(const Instance &instance); + + // Returns the count of instances in this mesh group instance array. + int NumInstances() const { return instances_.size(); } + + // Returns an instance from this mesh group instance array. + const Instance &GetInstance(int index) const { return instances_[index]; } + + private: + std::vector instances_; +}; + +} // namespace draco + +#endif // DRACO_TRANSCODER_SUPPORTED +#endif // DRACO_SCENE_INSTANCE_ARRAY_H_ diff --git a/contrib/draco/src/draco/scene/instance_array_test.cc b/contrib/draco/src/draco/scene/instance_array_test.cc new file mode 100644 index 000000000..d3802f901 --- /dev/null +++ b/contrib/draco/src/draco/scene/instance_array_test.cc @@ -0,0 +1,179 @@ +// Copyright 2022 The Draco Authors. +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. +// +#include "draco/scene/instance_array.h" + +#include +#include + +#include "draco/core/constants.h" +#include "draco/core/draco_test_base.h" +#include "draco/core/draco_test_utils.h" + +namespace { + +#ifdef DRACO_TRANSCODER_SUPPORTED + +TEST(InstanceArrayTest, TestInstance) { + // Test construction of an empty draco::InstanceArray::Instance struct. + const draco::InstanceArray::Instance instance; + ASSERT_FALSE(instance.trs.TranslationSet()); + ASSERT_FALSE(instance.trs.RotationSet()); + ASSERT_FALSE(instance.trs.ScaleSet()); + ASSERT_FALSE(instance.trs.MatrixSet()); +} + +TEST(InstanceArrayTest, TestDefaults) { + // Test construction of an empty draco::InstanceArray object. + const draco::InstanceArray array; + ASSERT_EQ(array.NumInstances(), 0); +} + +TEST(InstanceArrayTest, TestAddInstance) { + // Test population of draco::InstanceArray object with instances. + draco::InstanceArray array; + + // Create an instance and set its transformation TRS vectors. + const Eigen::Vector3d translation_0(1.0, 2.0, 3.0); + const Eigen::Quaterniond rotation_0(4.0, 5.0, 6.0, 7.0); + const Eigen::Vector3d scale_0(8.0, 9.0, 10.0); + draco::InstanceArray::Instance instance_0; + instance_0.trs.SetTranslation(translation_0); + instance_0.trs.SetRotation(rotation_0); + instance_0.trs.SetScale(scale_0); + + // Create another instance. + const Eigen::Vector3d translation_1(1.1, 2.1, 3.1); + const Eigen::Quaterniond rotation_1(4.1, 5.1, 6.1, 7.1); + const Eigen::Vector3d scale_1(8.1, 9.1, 10.1); + draco::InstanceArray::Instance instance_1; + instance_1.trs.SetTranslation(translation_1); + instance_1.trs.SetRotation(rotation_1); + instance_1.trs.SetScale(scale_1); + + // Add two instances to instance array. + DRACO_ASSERT_OK(array.AddInstance(instance_0)); + DRACO_ASSERT_OK(array.AddInstance(instance_1)); + + // Check that the instances have been added. + ASSERT_EQ(array.NumInstances(), 2); + + // Check transformation of the first instance. + const draco::TrsMatrix &trs_0 = array.GetInstance(0).trs; + ASSERT_TRUE(trs_0.TranslationSet()); + ASSERT_TRUE(trs_0.RotationSet()); + ASSERT_TRUE(trs_0.ScaleSet()); + ASSERT_FALSE(trs_0.MatrixSet()); + ASSERT_EQ(trs_0.Translation().value(), translation_0); + ASSERT_EQ(trs_0.Rotation().value(), rotation_0); + ASSERT_EQ(trs_0.Scale().value(), scale_0); + + // Check transformation of the second instance. + const draco::TrsMatrix &trs_1 = array.GetInstance(1).trs; + ASSERT_TRUE(trs_1.TranslationSet()); + ASSERT_TRUE(trs_1.RotationSet()); + ASSERT_TRUE(trs_1.ScaleSet()); + ASSERT_FALSE(trs_1.MatrixSet()); + ASSERT_EQ(trs_1.Translation().value(), translation_1); + ASSERT_EQ(trs_1.Rotation().value(), rotation_1); + ASSERT_EQ(trs_1.Scale().value(), scale_1); +} + +TEST(InstanceArrayTest, TestAddInstanceWithoutTransform) { + // Test that instance without any transformation can be added. + draco::InstanceArray array; + + // Do not set any transformation. + draco::InstanceArray::Instance instance; + + // Check that such instance can be added. + DRACO_ASSERT_OK(array.AddInstance(instance)); +} + +TEST(InstanceArrayTest, TestAddInstanceWithoutScale) { + // Test that instance without scale can be added. + draco::InstanceArray array; + + // Set only instance translation and rotation. + draco::InstanceArray::Instance instance; + instance.trs.SetTranslation(Eigen::Vector3d(1.0, 2.0, 3.0)); + instance.trs.SetRotation(Eigen::Quaterniond(4.0, 5.0, 6.0, 7.0)); + + // Check that such instance can be added. + DRACO_ASSERT_OK(array.AddInstance(instance)); +} + +TEST(InstanceArrayTest, TestAddInstanceWithMatrixFails) { + // Test that instance without scale cannot be added. + draco::InstanceArray array; + + // Set TRS vectors, as well as the matrix. + draco::InstanceArray::Instance instance; + instance.trs.SetTranslation(Eigen::Vector3d(1.0, 2.0, 3.0)); + instance.trs.SetRotation(Eigen::Quaterniond(4.0, 5.0, 6.0, 7.0)); + instance.trs.SetScale(Eigen::Vector3d(8.0, 9.0, 10.0)); + // clang-format off + Eigen::Matrix4d matrix; + matrix << 1.0, 2.0, 3.0, 4.0, + 5.0, 6.0, 7.0, 8.0, + 9.0, 10.0, 11.0, 12.0, + 13.0, 14.0, 15.0, 16.0; + // clang-format on + instance.trs.SetMatrix(matrix); + + // Check that such instance cannot be added. + const draco::Status status = array.AddInstance(instance); + ASSERT_FALSE(status.ok()); + ASSERT_EQ(status.error_msg_string(), "Instance must have no matrix set."); +} + +TEST(InstanceArrayTest, TestCopy) { + // Test copying of draco::InstanceArray object. + draco::InstanceArray array; + + // Create an instance and set its transformation TRS vectors. + const Eigen::Vector3d translation_0(1.0, 2.0, 3.0); + const Eigen::Quaterniond rotation_0(4.0, 5.0, 6.0, 7.0); + const Eigen::Vector3d scale_0(8.0, 9.0, 10.0); + draco::InstanceArray::Instance instance_0; + instance_0.trs.SetTranslation(translation_0); + instance_0.trs.SetRotation(rotation_0); + instance_0.trs.SetScale(scale_0); + + // Create another instance. + const Eigen::Vector3d translation_1(1.1, 2.1, 3.1); + const Eigen::Quaterniond rotation_1(4.1, 5.1, 6.1, 7.1); + const Eigen::Vector3d scale_1(8.1, 9.1, 10.1); + draco::InstanceArray::Instance instance_1; + instance_1.trs.SetTranslation(translation_1); + instance_1.trs.SetRotation(rotation_1); + instance_1.trs.SetScale(scale_1); + + // Add two instances to the instance array. + DRACO_ASSERT_OK(array.AddInstance(instance_0)); + DRACO_ASSERT_OK(array.AddInstance(instance_1)); + + // Create a copy of the populated instance array object. + draco::InstanceArray copy; + copy.Copy(array); + + // Check that the instances have been copied. + ASSERT_EQ(copy.NumInstances(), 2); + ASSERT_EQ(copy.GetInstance(0).trs, instance_0.trs); + ASSERT_EQ(copy.GetInstance(1).trs, instance_1.trs); +} + +#endif // DRACO_TRANSCODER_SUPPORTED + +} // namespace diff --git a/contrib/draco/src/draco/scene/light.cc b/contrib/draco/src/draco/scene/light.cc new file mode 100644 index 000000000..1fef98c0c --- /dev/null +++ b/contrib/draco/src/draco/scene/light.cc @@ -0,0 +1,45 @@ +// Copyright 2022 The Draco Authors. +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. +// +#include "draco/scene/light.h" + +#ifdef DRACO_TRANSCODER_SUPPORTED + +#include + +#include "draco/core/constants.h" + +namespace draco { + +Light::Light() + : color_(1.0f, 1.0f, 1.0f), + intensity_(1.0), + type_(POINT), + range_(std::numeric_limits::max()), // Infinity. + inner_cone_angle_(0.0), + outer_cone_angle_(DRACO_PI / 4.0) {} + +void Light::Copy(const Light &light) { + name_ = light.name_; + color_ = light.color_; + intensity_ = light.intensity_; + type_ = light.type_; + range_ = light.range_; + inner_cone_angle_ = light.inner_cone_angle_; + outer_cone_angle_ = light.outer_cone_angle_; +} + +} // namespace draco + +#endif // DRACO_TRANSCODER_SUPPORTED diff --git a/contrib/draco/src/draco/scene/light.h b/contrib/draco/src/draco/scene/light.h new file mode 100644 index 000000000..5ff0d4a6b --- /dev/null +++ b/contrib/draco/src/draco/scene/light.h @@ -0,0 +1,81 @@ +// Copyright 2022 The Draco Authors. +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. +// +#ifndef DRACO_SCENE_LIGHT_H_ +#define DRACO_SCENE_LIGHT_H_ + +#include "draco/draco_features.h" + +#ifdef DRACO_TRANSCODER_SUPPORTED +#include + +#include "draco/core/vector_d.h" + +namespace draco { + +// Describes a light in a scene according to the KHR_lights_punctual extension. +class Light { + public: + enum Type { DIRECTIONAL, POINT, SPOT }; + + Light(); + + void Copy(const Light &light); + + // Name. + void SetName(const std::string &name) { name_ = name; } + const std::string &GetName() const { return name_; } + + // Color. + void SetColor(const Vector3f &color) { color_ = color; } + const Vector3f &GetColor() const { return color_; } + + // Intensity. + void SetIntensity(double intensity) { intensity_ = intensity; } + double GetIntensity() const { return intensity_; } + + // Type. + void SetType(Type type) { type_ = type; } + Type GetType() const { return type_; } + + // Range. + void SetRange(double range) { range_ = range; } + double GetRange() const { return range_; } + + // Inner cone angle. + void SetInnerConeAngle(double angle) { inner_cone_angle_ = angle; } + double GetInnerConeAngle() const { return inner_cone_angle_; } + + // Outer cone angle. + void SetOuterConeAngle(double angle) { outer_cone_angle_ = angle; } + double GetOuterConeAngle() const { return outer_cone_angle_; } + + private: + std::string name_; + Vector3f color_; + double intensity_; + Type type_; + + // The range is only applicable to lights with Type::POINT or Type::SPOT. + double range_; + + // The cone angles are only applicable to lights with Type::SPOT. + double inner_cone_angle_; + double outer_cone_angle_; +}; + +} // namespace draco + +#endif // DRACO_TRANSCODER_SUPPORTED +#endif // DRACO_SCENE_LIGHT_H_ diff --git a/contrib/draco/src/draco/scene/light_test.cc b/contrib/draco/src/draco/scene/light_test.cc new file mode 100644 index 000000000..bc24a14ad --- /dev/null +++ b/contrib/draco/src/draco/scene/light_test.cc @@ -0,0 +1,64 @@ +// Copyright 2022 The Draco Authors. +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. +// +#include "draco/scene/light.h" + +#include + +#include "draco/core/constants.h" +#include "draco/core/draco_test_base.h" +#include "draco/core/draco_test_utils.h" + +namespace { + +#ifdef DRACO_TRANSCODER_SUPPORTED + +TEST(LightTest, TestDefaults) { + // Text constructing draco::Light object with default properties. + const draco::Light light; + ASSERT_EQ(light.GetName(), ""); + ASSERT_EQ(light.GetColor(), draco::Vector3f(1.0f, 1.0f, 1.0f)); + ASSERT_EQ(light.GetIntensity(), 1.0); + ASSERT_EQ(light.GetType(), draco::Light::POINT); + ASSERT_EQ(light.GetRange(), std::numeric_limits::max()); + ASSERT_EQ(light.GetInnerConeAngle(), 0.0); + ASSERT_EQ(light.GetOuterConeAngle(), DRACO_PI / 4.0); +} + +TEST(LightTest, TestCopy) { + // Test copying of draco::Light object. + draco::Light light; + light.SetName("The Star of Earendil"); + light.SetColor(draco::Vector3f(0.90, 0.97, 1.00)); + light.SetIntensity(5.0); + light.SetType(draco::Light::SPOT); + light.SetRange(1000.0); + light.SetInnerConeAngle(DRACO_PI / 8.0); + light.SetOuterConeAngle(DRACO_PI / 2.0); + + // Create a copy of the initialized light and check all properties. + draco::Light copy; + copy.Copy(light); + ASSERT_EQ(copy.GetName(), "The Star of Earendil"); + ASSERT_EQ(copy.GetColor(), draco::Vector3f(0.90, 0.97, 1.00)); + ASSERT_EQ(copy.GetIntensity(), 5.0); + ASSERT_EQ(copy.GetType(), draco::Light::SPOT); + ASSERT_EQ(copy.GetRange(), 1000.0); + ASSERT_EQ(copy.GetInnerConeAngle(), DRACO_PI / 8.0); + ASSERT_EQ(copy.GetOuterConeAngle(), DRACO_PI / 2.0); +} + +#endif // DRACO_TRANSCODER_SUPPORTED + +} // namespace diff --git a/contrib/draco/src/draco/scene/mesh_group.h b/contrib/draco/src/draco/scene/mesh_group.h new file mode 100644 index 000000000..852318f16 --- /dev/null +++ b/contrib/draco/src/draco/scene/mesh_group.h @@ -0,0 +1,138 @@ +// Copyright 2019 The Draco Authors. +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. +// +#ifndef DRACO_SCENE_MESH_GROUP_H_ +#define DRACO_SCENE_MESH_GROUP_H_ + +#include "draco/draco_features.h" + +#ifdef DRACO_TRANSCODER_SUPPORTED +#include +#include + +#include "draco/core/macros.h" +#include "draco/scene/scene_indices.h" + +namespace draco { + +// This class is used to hold ordered mesh instances that refer to one or more +// base meshes, materials, and materials variants mappings. +class MeshGroup { + public: + // Stores a mapping from material index to materials variant indices. Each + // mesh instance may have multiple such mappings associated with it. See glTF + // extension KHR_materials_variants for more details. + struct MaterialsVariantsMapping { + MaterialsVariantsMapping() = delete; + MaterialsVariantsMapping(int material, const std::vector &variants) + : material(material), variants(variants) {} + bool operator==(const MaterialsVariantsMapping &other) const { + if (material != other.material) { + return false; + } + if (variants != other.variants) { + return false; + } + return true; + } + bool operator!=(const MaterialsVariantsMapping &other) const { + return !(*this == other); + } + int material; + std::vector variants; + }; + + // Describes mesh instance stored in a mesh group, including base mesh index, + // material index, and materials variants mappings. + struct MeshInstance { + MeshInstance() = delete; + MeshInstance(MeshIndex mesh_index, int material_index) + : MeshInstance(mesh_index, material_index, {}) {} + MeshInstance(MeshIndex mesh_index, int material_index, + const std::vector + &materials_variants_mappings) + : mesh_index(mesh_index), + material_index(material_index), + materials_variants_mappings(materials_variants_mappings) {} + bool operator==(const MeshInstance &other) const { + if (mesh_index != other.mesh_index) { + return false; + } + if (material_index != other.material_index) { + return false; + } + if (materials_variants_mappings.size() != + other.materials_variants_mappings.size()) { + return false; + } + if (materials_variants_mappings != other.materials_variants_mappings) { + return false; + } + return true; + } + bool operator!=(const MeshInstance &other) const { + return !(*this == other); + } + MeshIndex mesh_index; + int material_index; + std::vector materials_variants_mappings; + }; + + MeshGroup() {} + + void Copy(const MeshGroup &mg) { + name_ = mg.name_; + mesh_instances_ = mg.mesh_instances_; + } + + const std::string &GetName() const { return name_; } + void SetName(const std::string &name) { name_ = name; } + + void AddMeshInstance(const MeshInstance &instance) { + mesh_instances_.push_back(instance); + } + + void SetMeshInstance(int index, const MeshInstance &instance) { + mesh_instances_[index] = instance; + } + + const MeshInstance &GetMeshInstance(int index) const { + return mesh_instances_[index]; + } + + MeshInstance &GetMeshInstance(int index) { return mesh_instances_[index]; } + + int NumMeshInstances() const { return mesh_instances_.size(); } + + // Removes all mesh instances referring to base mesh at |mesh_index|. + void RemoveMeshInstances(MeshIndex mesh_index) { + int i = 0; + while (i != mesh_instances_.size()) { + if (mesh_instances_[i].mesh_index == mesh_index) { + mesh_instances_.erase(mesh_instances_.begin() + i); + } else { + i++; + } + } + } + + private: + std::string name_; + std::vector mesh_instances_; +}; + +} // namespace draco + +#endif // DRACO_TRANSCODER_SUPPORTED +#endif // DRACO_SCENE_MESH_GROUP_H_ diff --git a/contrib/draco/src/draco/scene/mesh_group_test.cc b/contrib/draco/src/draco/scene/mesh_group_test.cc new file mode 100644 index 000000000..76f1bf33e --- /dev/null +++ b/contrib/draco/src/draco/scene/mesh_group_test.cc @@ -0,0 +1,196 @@ +// Copyright 2020 The Draco Authors. +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. +// +#include "draco/scene/mesh_group.h" + +#include "draco/core/draco_test_base.h" +#include "draco/core/draco_test_utils.h" +#include "draco/scene/scene_indices.h" + +namespace { + +#ifdef DRACO_TRANSCODER_SUPPORTED + +using draco::MeshGroup; +using draco::MeshIndex; + +// Test helper method generates materials variants mappings based on a |seed|. +std::vector MakeMappings(int seed) { + MeshGroup::MaterialsVariantsMapping a(10 * seed + 0, {seed + 0, seed + 1}); + MeshGroup::MaterialsVariantsMapping b(10 * seed + 1, {seed + 2, seed + 3}); + return {a, b}; +} + +TEST(MeshGroupTest, TestMeshInstanceTwoArgumentConstructor) { + MeshGroup::MeshInstance instance(MeshIndex(2), 3); + ASSERT_EQ(instance.mesh_index, MeshIndex(2)); + ASSERT_EQ(instance.material_index, 3); + ASSERT_EQ(instance.materials_variants_mappings.size(), 0); +} + +TEST(MeshGroupTest, TestMeshInstanceThreeArgumentConstructor) { + const auto mappings = MakeMappings(4); + MeshGroup::MeshInstance instance(MeshIndex(2), 3, mappings); + ASSERT_EQ(instance.mesh_index, MeshIndex(2)); + ASSERT_EQ(instance.material_index, 3); + ASSERT_EQ(instance.materials_variants_mappings, mappings); +} + +TEST(MeshGroupTest, TestMeshInstanceEqualsOperator) { + MeshGroup::MeshInstance instance_a(MeshIndex(2), 3, MakeMappings(4)); + MeshGroup::MeshInstance instance_b(MeshIndex(2), 3, MakeMappings(4)); + ASSERT_TRUE(instance_a == instance_b); + ASSERT_FALSE(instance_a != instance_b); + + MeshGroup::MeshInstance instance_c(MeshIndex(1), 3, MakeMappings(4)); + MeshGroup::MeshInstance instance_d(MeshIndex(2), 1, MakeMappings(4)); + MeshGroup::MeshInstance instance_e(MeshIndex(2), 3, MakeMappings(1)); + ASSERT_FALSE(instance_a == instance_c); + ASSERT_FALSE(instance_a == instance_d); + ASSERT_FALSE(instance_a == instance_e); + ASSERT_TRUE(instance_a != instance_c); + ASSERT_TRUE(instance_a != instance_d); + ASSERT_TRUE(instance_a != instance_e); +} + +TEST(MeshGroupTest, TestRemoveMeshInstanceWithNoOccurrences) { + // Test that no mesh instances are removed from mesh group when removing the + // instances by the base mesh index that is not in the mesh group. + + // Create test mesh group. + MeshGroup mesh_group; + mesh_group.AddMeshInstance({MeshIndex(1), 0, {}}); + mesh_group.AddMeshInstance({MeshIndex(3), 0, {}}); + + // Try to remove mesh that is not in the mesh group. + mesh_group.RemoveMeshInstances(MeshIndex(2)); + + // Check result. + ASSERT_EQ(mesh_group.NumMeshInstances(), 2); + ASSERT_EQ(mesh_group.GetMeshInstance(0).mesh_index, MeshIndex(1)); + ASSERT_EQ(mesh_group.GetMeshInstance(1).mesh_index, MeshIndex(3)); +} + +TEST(MeshGroupTest, TestRemoveTheOnlyMeshInstance) { + // Test that the only mesh instance can be removed from mesh group. + + // Create test mesh group. + MeshGroup mesh_group; + MeshGroup::MaterialsVariantsMapping mapping(70, {0, 1}); + mesh_group.AddMeshInstance({MeshIndex(7), 70, {mapping}}); + + // Remove a mesh instance. + mesh_group.RemoveMeshInstances(MeshIndex(7)); + + // Check result. + ASSERT_EQ(mesh_group.NumMeshInstances(), 0); +} + +TEST(MeshGroupTest, TestRemoveOneMeshInstances) { + // Test a mesh instance can be removed from mesh group. + + // Create test mesh group. + MeshGroup mesh_group; + mesh_group.AddMeshInstance({MeshIndex(1), 0, {}}); + mesh_group.AddMeshInstance({MeshIndex(3), 0, {}}); + mesh_group.AddMeshInstance({MeshIndex(5), 0, {}}); + mesh_group.AddMeshInstance({MeshIndex(7), 0, {}}); + + // Remove a mesh. + mesh_group.RemoveMeshInstances(MeshIndex(3)); + + // Check result. + ASSERT_EQ(mesh_group.NumMeshInstances(), 3); + ASSERT_EQ(mesh_group.GetMeshInstance(0).mesh_index, MeshIndex(1)); + ASSERT_EQ(mesh_group.GetMeshInstance(1).mesh_index, MeshIndex(5)); + ASSERT_EQ(mesh_group.GetMeshInstance(2).mesh_index, MeshIndex(7)); +} + +TEST(MeshGroupTest, TestRemoveThreeMeshInstances) { + // Test that multiple mesh instances can be removed from a mesh group. + + // Create test mesh group. + MeshGroup mesh_group; + mesh_group.AddMeshInstance({MeshIndex(1), 10, MakeMappings(1)}); + mesh_group.AddMeshInstance({MeshIndex(3), 30, MakeMappings(3)}); + mesh_group.AddMeshInstance({MeshIndex(5), 50, MakeMappings(5)}); + mesh_group.AddMeshInstance({MeshIndex(1), 10, MakeMappings(1)}); + mesh_group.AddMeshInstance({MeshIndex(7), 70, MakeMappings(7)}); + mesh_group.AddMeshInstance({MeshIndex(1), 10, MakeMappings(1)}); + + // Remove mesh instances. + mesh_group.RemoveMeshInstances(MeshIndex(1)); + + // Check result. + ASSERT_EQ(mesh_group.NumMeshInstances(), 3); + const MeshGroup::MeshInstance mi0 = mesh_group.GetMeshInstance(0); + const MeshGroup::MeshInstance mi1 = mesh_group.GetMeshInstance(1); + const MeshGroup::MeshInstance mi2 = mesh_group.GetMeshInstance(2); + ASSERT_EQ(mi0.mesh_index, MeshIndex(3)); + ASSERT_EQ(mi1.mesh_index, MeshIndex(5)); + ASSERT_EQ(mi2.mesh_index, MeshIndex(7)); + ASSERT_EQ(mi0.material_index, 30); + ASSERT_EQ(mi1.material_index, 50); + ASSERT_EQ(mi2.material_index, 70); + ASSERT_EQ(mi0.materials_variants_mappings, MakeMappings(3)); + ASSERT_EQ(mi1.materials_variants_mappings, MakeMappings(5)); + ASSERT_EQ(mi2.materials_variants_mappings, MakeMappings(7)); +} + +TEST(MeshGroupTest, TestCopy) { + // Tests that a mesh group can be copied. + + // Create test mesh group. + MeshGroup mesh_group; + mesh_group.SetName("Mesh-1-3-5-7"); + mesh_group.AddMeshInstance({MeshIndex(1), 10, MakeMappings(1)}); + mesh_group.AddMeshInstance({MeshIndex(3), 30, MakeMappings(3)}); + mesh_group.AddMeshInstance({MeshIndex(5), 50, MakeMappings(5)}); + mesh_group.AddMeshInstance({MeshIndex(7), 70, MakeMappings(7)}); + + // Verify source MeshGroup. + ASSERT_EQ(mesh_group.GetName(), "Mesh-1-3-5-7"); + ASSERT_EQ(mesh_group.NumMeshInstances(), 4); + const MeshGroup::MeshInstance mi0 = mesh_group.GetMeshInstance(0); + const MeshGroup::MeshInstance mi1 = mesh_group.GetMeshInstance(1); + const MeshGroup::MeshInstance mi2 = mesh_group.GetMeshInstance(2); + const MeshGroup::MeshInstance mi3 = mesh_group.GetMeshInstance(3); + ASSERT_EQ(mi0.mesh_index, MeshIndex(1)); + ASSERT_EQ(mi1.mesh_index, MeshIndex(3)); + ASSERT_EQ(mi2.mesh_index, MeshIndex(5)); + ASSERT_EQ(mi3.mesh_index, MeshIndex(7)); + ASSERT_EQ(mi0.material_index, 10); + ASSERT_EQ(mi1.material_index, 30); + ASSERT_EQ(mi2.material_index, 50); + ASSERT_EQ(mi3.material_index, 70); + ASSERT_EQ(mi0.materials_variants_mappings, MakeMappings(1)); + ASSERT_EQ(mi1.materials_variants_mappings, MakeMappings(3)); + ASSERT_EQ(mi2.materials_variants_mappings, MakeMappings(5)); + ASSERT_EQ(mi3.materials_variants_mappings, MakeMappings(7)); + + MeshGroup copy; + copy.Copy(mesh_group); + + // Verify that Copy worked. + ASSERT_EQ(mesh_group.GetName(), copy.GetName()); + ASSERT_EQ(mesh_group.NumMeshInstances(), copy.NumMeshInstances()); + ASSERT_EQ(mesh_group.GetMeshInstance(0), copy.GetMeshInstance(0)); + ASSERT_EQ(mesh_group.GetMeshInstance(1), copy.GetMeshInstance(1)); + ASSERT_EQ(mesh_group.GetMeshInstance(2), copy.GetMeshInstance(2)); + ASSERT_EQ(mesh_group.GetMeshInstance(3), copy.GetMeshInstance(3)); +} + +#endif // DRACO_TRANSCODER_SUPPORTED + +} // namespace diff --git a/contrib/draco/src/draco/scene/scene.cc b/contrib/draco/src/draco/scene/scene.cc new file mode 100644 index 000000000..9ad574835 --- /dev/null +++ b/contrib/draco/src/draco/scene/scene.cc @@ -0,0 +1,174 @@ +// Copyright 2019 The Draco Authors. +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. +// +#include "draco/scene/scene.h" + +#include + +#ifdef DRACO_TRANSCODER_SUPPORTED +#include "draco/core/macros.h" +#include "draco/scene/scene_indices.h" + +namespace draco { + +void Scene::Copy(const Scene &s) { + meshes_.resize(s.meshes_.size()); + for (MeshIndex i(0); i < meshes_.size(); ++i) { + meshes_[i] = std::unique_ptr(new Mesh()); + meshes_[i]->Copy(*s.meshes_[i]); + } + + mesh_groups_.resize(s.mesh_groups_.size()); + for (MeshGroupIndex i(0); i < mesh_groups_.size(); ++i) { + mesh_groups_[i] = std::unique_ptr(new MeshGroup()); + mesh_groups_[i]->Copy(*s.mesh_groups_[i]); + } + + nodes_.resize(s.nodes_.size()); + for (SceneNodeIndex i(0); i < nodes_.size(); ++i) { + nodes_[i] = std::unique_ptr(new SceneNode()); + nodes_[i]->Copy(*s.nodes_[i]); + } + + root_node_indices_ = s.root_node_indices_; + + animations_.resize(s.animations_.size()); + for (AnimationIndex i(0); i < animations_.size(); ++i) { + animations_[i] = std::unique_ptr(new Animation()); + animations_[i]->Copy(*s.animations_[i]); + } + + skins_.resize(s.skins_.size()); + for (SkinIndex i(0); i < skins_.size(); ++i) { + skins_[i] = std::unique_ptr(new Skin()); + skins_[i]->Copy(*s.skins_[i]); + } + + lights_.resize(s.lights_.size()); + for (LightIndex i(0); i < lights_.size(); ++i) { + lights_[i] = std::unique_ptr(new Light()); + lights_[i]->Copy(*s.lights_[i]); + } + + instance_arrays_.resize(s.instance_arrays_.size()); + for (InstanceArrayIndex i(0); i < instance_arrays_.size(); ++i) { + instance_arrays_[i] = std::unique_ptr(new InstanceArray()); + instance_arrays_[i]->Copy(*s.instance_arrays_[i]); + } + + material_library_.Copy(s.material_library_); + +#ifdef DRACO_TRANSCODER_SUPPORTED + // Copy non-material textures. + non_material_texture_library_.Copy(s.non_material_texture_library_); + + // Update pointers to non-material textures in mesh feature ID sets of all + // scene meshes. + if (non_material_texture_library_.NumTextures() != 0) { + const auto texture_to_index_map = + s.non_material_texture_library_.ComputeTextureToIndexMap(); + for (MeshIndex i(0); i < NumMeshes(); ++i) { + for (MeshFeaturesIndex j(0); j < GetMesh(i).NumMeshFeatures(); ++j) { + Mesh::UpdateMeshFeaturesTexturePointer(texture_to_index_map, + &non_material_texture_library_, + &GetMesh(i).GetMeshFeatures(j)); + } + } + } +#endif // DRACO_TRANSCODER_SUPPORTED + + // Copy structural metadata. + structural_metadata_.Copy(s.structural_metadata_); +} + +Status Scene::RemoveMesh(MeshIndex index) { + // Remove base mesh at |index| from |meshes_| and corresponding material index + // from |mesh_material_indices_|. + const int new_num_meshes = meshes_.size() - 1; + for (MeshIndex i(index); i < new_num_meshes; i++) { + meshes_[i] = std::move(meshes_[i + 1]); + } + meshes_.resize(new_num_meshes); + + // Remove references to removed base mesh and corresponding materials from + // mesh groups, and update references to remaining base meshes in mesh groups. + for (MeshGroupIndex mgi(0); mgi < NumMeshGroups(); ++mgi) { + MeshGroup *const mesh_group = GetMeshGroup(mgi); + if (!mesh_group) { + return Status(Status::DRACO_ERROR, "MeshGroup is null."); + } + mesh_group->RemoveMeshInstances(index); + for (int i = 0; i < mesh_group->NumMeshInstances(); ++i) { + MeshGroup::MeshInstance &mesh_instance = mesh_group->GetMeshInstance(i); + if (mesh_instance.mesh_index > index && + mesh_instance.mesh_index != kInvalidMeshIndex) { + mesh_instance.mesh_index--; + } + } + } + return OkStatus(); +} + +Status Scene::RemoveMeshGroup(MeshGroupIndex index) { + // Remove mesh group at |index| from |mesh_groups_| vector. + const int new_num_mesh_groups = mesh_groups_.size() - 1; + for (MeshGroupIndex i(index); i < new_num_mesh_groups; i++) { + mesh_groups_[i] = std::move(mesh_groups_[i + 1]); + } + mesh_groups_.resize(new_num_mesh_groups); + + // Invalidate references to removed mesh group in scene nodes, and update + // references to remaining mesh groups in scene nodes. + for (SceneNodeIndex sni(0); sni < NumNodes(); ++sni) { + SceneNode *node = GetNode(sni); + if (!node) { + return Status(Status::DRACO_ERROR, "Node is null."); + } + const MeshGroupIndex mgi = node->GetMeshGroupIndex(); + if (mgi == index) { + // TODO(vytyaz): Remove the node if possible, e.g., when node has no + // geometry, no child nodes, no skins, no lights, and no mesh group + // instance arrays. + node->SetMeshGroupIndex(kInvalidMeshGroupIndex); + } else if (mgi > index && mgi != kInvalidMeshGroupIndex) { + node->SetMeshGroupIndex(mgi - 1); + } + } + return OkStatus(); +} + +Status Scene::RemoveMaterial(int index) { + if (index < 0 || index >= material_library_.NumMaterials()) { + return Status(Status::DRACO_ERROR, "Material index is out of range."); + } + material_library_.RemoveMaterial(index); + + // Update material indices of mesh instances. + for (MeshGroupIndex mgi(0); mgi < NumMeshGroups(); ++mgi) { + MeshGroup *const mesh_group = GetMeshGroup(mgi); + for (int i = 0; i < mesh_group->NumMeshInstances(); i++) { + MeshGroup::MeshInstance &mesh_instance = mesh_group->GetMeshInstance(i); + if (mesh_instance.material_index > index) { + mesh_instance.material_index--; + } else if (mesh_instance.material_index == index) { + return Status(Status::DRACO_ERROR, "Removed material has references."); + } + } + } + return OkStatus(); +} + +} // namespace draco + +#endif // DRACO_TRANSCODER_SUPPORTED diff --git a/contrib/draco/src/draco/scene/scene.h b/contrib/draco/src/draco/scene/scene.h new file mode 100644 index 000000000..3c76ead7a --- /dev/null +++ b/contrib/draco/src/draco/scene/scene.h @@ -0,0 +1,258 @@ +// Copyright 2019 The Draco Authors. +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. +// +#ifndef DRACO_SCENE_SCENE_H_ +#define DRACO_SCENE_SCENE_H_ + +#include "draco/draco_features.h" + +#ifdef DRACO_TRANSCODER_SUPPORTED +#include + +#include "draco/animation/animation.h" +#include "draco/animation/skin.h" +#include "draco/mesh/mesh.h" +#include "draco/metadata/structural_metadata.h" +#include "draco/scene/instance_array.h" +#include "draco/scene/light.h" +#include "draco/scene/mesh_group.h" +#include "draco/scene/scene_indices.h" +#include "draco/scene/scene_node.h" + +namespace draco { + +// Class used to hold all of the geometry to create a scene. A scene is +// comprised of one or more meshes, one or more scene nodes, one or more +// mesh groups, and a material library. The meshes are defined in their +// local space. A mesh group is a list of meshes. The scene nodes create +// a scene hierarchy to transform meshes in their local space into scene space. +// The material library contains all of the materials and textures used by the +// meshes in this scene. +class Scene { + public: + Scene() {} + + void Copy(const Scene &s); + + // Adds a Draco |mesh| to the scene. Returns the index to the stored mesh or + // |kInvalidMeshIndex| if the mesh is a nullptr. + MeshIndex AddMesh(std::unique_ptr mesh) { + if (mesh == nullptr) { + return kInvalidMeshIndex; + } + meshes_.push_back(std::move(mesh)); + return MeshIndex(meshes_.size() - 1); + } + + // Removes base mesh and corresponding material at |index|, removes references + // to removed base mesh and corresponding materials from mesh groups, and + // updates references to remaining base meshes in mesh groups. + Status RemoveMesh(MeshIndex index); + + // Returns the number of meshes in a scene before instancing is applied. + int NumMeshes() const { return meshes_.size(); } + + // Returns a mesh in the scene before instancing is applied. The mesh + // coordinates are local to the mesh. + Mesh &GetMesh(MeshIndex index) { return *meshes_[index]; } + const Mesh &GetMesh(MeshIndex index) const { return *meshes_[index]; } + + // Creates a mesh group and returns the index to the mesh group. + MeshGroupIndex AddMeshGroup() { + std::unique_ptr mesh(new MeshGroup()); + mesh_groups_.push_back(std::move(mesh)); + return MeshGroupIndex(mesh_groups_.size() - 1); + } + + // Removes mesh group at |index|, invalidates references to removed mesh group + // in scene nodes, and updates references to remaining mesh groups in scene + // nodes. + Status RemoveMeshGroup(MeshGroupIndex index); + + // Removes unused material at |index| and updates references to materials at + // indices greater than |index|. Returns error status when |index| is out of + // valid range and when material at |index| is used in the scene. + Status RemoveMaterial(int index); + + // Returns the number of mesh groups in a scene. + int NumMeshGroups() const { return mesh_groups_.size(); } + + // Returns a mesh group in the scene. + MeshGroup *GetMeshGroup(MeshGroupIndex index) { + return mesh_groups_[index].get(); + } + const MeshGroup *GetMeshGroup(MeshGroupIndex index) const { + return mesh_groups_[index].get(); + } + + // Creates a scene node and returns the index to the node. + SceneNodeIndex AddNode() { + std::unique_ptr node(new SceneNode()); + nodes_.push_back(std::move(node)); + return SceneNodeIndex(nodes_.size() - 1); + } + + // Returns the number of nodes in a scene. + int NumNodes() const { return nodes_.size(); } + + // Returns a node in the scene. + SceneNode *GetNode(SceneNodeIndex index) { return nodes_[index].get(); } + const SceneNode *GetNode(SceneNodeIndex index) const { + return nodes_[index].get(); + } + + // Either allocates new nodes or removes existing nodes that are beyond + // |num_nodes|. + void ResizeNodes(int num_nodes) { + const size_t old_num_nodes = nodes_.size(); + nodes_.resize(num_nodes); + for (SceneNodeIndex i(old_num_nodes); i < num_nodes; ++i) { + nodes_[i].reset(new SceneNode()); + } + } + + // Returns the number of root node indices in a scene. + int NumRootNodes() const { return root_node_indices_.size(); } + SceneNodeIndex GetRootNodeIndex(int i) const { return root_node_indices_[i]; } + const std::vector &GetRootNodeIndices() const { + return root_node_indices_; + } + void AddRootNodeIndex(SceneNodeIndex index) { + root_node_indices_.push_back(index); + } + void SetRootNodeIndex(int i, SceneNodeIndex index) { + root_node_indices_[i] = index; + } + void RemoveAllRootNodeIndices() { root_node_indices_.clear(); } + + const MaterialLibrary &GetMaterialLibrary() const { + return material_library_; + } + MaterialLibrary &GetMaterialLibrary() { return material_library_; } + + // Library that contains non-material textures. + const TextureLibrary &GetNonMaterialTextureLibrary() const { + return non_material_texture_library_; + } + TextureLibrary &GetNonMaterialTextureLibrary() { + return non_material_texture_library_; + } + + // Structural metadata. + const StructuralMetadata &GetStructuralMetadata() const { + return structural_metadata_; + } + StructuralMetadata &GetStructuralMetadata() { return structural_metadata_; } + + // Creates an animation and returns the index to the animation. + AnimationIndex AddAnimation() { + std::unique_ptr animation(new Animation()); + animations_.push_back(std::move(animation)); + return AnimationIndex(animations_.size() - 1); + } + + // Returns the number of animations in a scene. + int NumAnimations() const { return animations_.size(); } + + // Returns an animation in the scene. + Animation *GetAnimation(AnimationIndex index) { + return animations_[index].get(); + } + const Animation *GetAnimation(AnimationIndex index) const { + return animations_[index].get(); + } + + // Creates a skin and returns the index to the skin. + SkinIndex AddSkin() { + std::unique_ptr skin(new Skin()); + skins_.push_back(std::move(skin)); + return SkinIndex(skins_.size() - 1); + } + + // Returns the number of skins in a scene. + int NumSkins() const { return skins_.size(); } + + // Returns a skin in the scene. + Skin *GetSkin(SkinIndex index) { return skins_[index].get(); } + const Skin *GetSkin(SkinIndex index) const { return skins_[index].get(); } + + // Creates a light and returns the index to the light. + LightIndex AddLight() { + std::unique_ptr light(new Light()); + lights_.push_back(std::move(light)); + return LightIndex(lights_.size() - 1); + } + + // Returns the number of lights in a scene. + int NumLights() const { return lights_.size(); } + + // Returns a light in the scene. + Light *GetLight(LightIndex index) { return lights_[index].get(); } + const Light *GetLight(LightIndex index) const { return lights_[index].get(); } + + // Creates a mesh group instance array and returns the index to it. This array + // is used for storing the attributes of the EXT_mesh_gpu_instancing glTF + // extension. + InstanceArrayIndex AddInstanceArray() { + std::unique_ptr array(new InstanceArray()); + instance_arrays_.push_back(std::move(array)); + return InstanceArrayIndex(instance_arrays_.size() - 1); + } + + // Returns the number of mesh group instance arrays in a scene. + int NumInstanceArrays() const { return instance_arrays_.size(); } + + // Returns a mesh group instance array in the scene. + InstanceArray *GetInstanceArray(InstanceArrayIndex index) { + return instance_arrays_[index].get(); + } + const InstanceArray *GetInstanceArray(InstanceArrayIndex index) const { + return instance_arrays_[index].get(); + } + + private: + IndexTypeVector> meshes_; + IndexTypeVector> mesh_groups_; + IndexTypeVector> nodes_; + std::vector root_node_indices_; + IndexTypeVector> animations_; + IndexTypeVector> skins_; + + // The lights will be written to the output scene but not used for internal + // rendering in Draco, e.g, while computing distortion metric. + IndexTypeVector> lights_; + + // The mesh group instance array information will be written to the output + // scene but not processed by Draco simplifier modules. + IndexTypeVector> + instance_arrays_; + + // Materials used by this scene. + MaterialLibrary material_library_; + + // Texture library for storing non-material textures used by this scene, e.g., + // textures containing mesh feature IDs of EXT_mesh_features glTF extension. + // Note that scene meshes contain pointers to non-material textures. It is + // responsibility of class user to update these pointers when updating the + // textures. See Scene::Copy() for example. + TextureLibrary non_material_texture_library_; + + // Structural metadata defined by the EXT_structural_metadata glTF extension. + StructuralMetadata structural_metadata_; +}; + +} // namespace draco + +#endif // DRACO_TRANSCODER_SUPPORTED +#endif // DRACO_SCENE_SCENE_H_ diff --git a/contrib/draco/src/draco/scene/scene_are_equivalent.cc b/contrib/draco/src/draco/scene/scene_are_equivalent.cc new file mode 100644 index 000000000..7d0663e08 --- /dev/null +++ b/contrib/draco/src/draco/scene/scene_are_equivalent.cc @@ -0,0 +1,109 @@ +// Copyright 2019 The Draco Authors. +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. +// +#include "draco/scene/scene_are_equivalent.h" + +#ifdef DRACO_TRANSCODER_SUPPORTED +#include "draco/mesh/mesh_are_equivalent.h" + +namespace draco { + +bool SceneAreEquivalent::operator()(const Scene &scene0, const Scene &scene1) { + // Check scene component sizes. + if (scene0.NumAnimations() != scene1.NumAnimations()) { + return false; + } + if (scene0.NumMeshGroups() != scene1.NumMeshGroups()) { + return false; + } + if (scene0.NumSkins() != scene1.NumSkins()) { + return false; + } + + // Check equivalence of each mesh. + if (scene0.NumMeshes() != scene1.NumMeshes()) { + return false; + } + for (MeshIndex i(0); i < scene0.NumMeshes(); i++) { + if (!AreEquivalent(scene0.GetMesh(i), scene1.GetMesh(i))) { + return false; + } + } + + // Check eqiuvalence of each node. + if (scene0.NumNodes() != scene1.NumNodes()) { + return false; + } + for (SceneNodeIndex i(0); i < scene0.NumNodes(); i++) { + if (!AreEquivalent(*scene0.GetNode(i), *scene1.GetNode(i))) { + return false; + } + } + + // Check non-material texture library sizes. + if (scene0.GetNonMaterialTextureLibrary().NumTextures() != + scene1.GetNonMaterialTextureLibrary().NumTextures()) { + return false; + } + + // TODO(vytyaz): Check remaining scene properties like animations and skins. + return true; +} + +bool SceneAreEquivalent::AreEquivalent(const Mesh &mesh0, const Mesh &mesh1) { + MeshAreEquivalent eq; + return eq(mesh0, mesh1); +} + +bool SceneAreEquivalent::AreEquivalent(const SceneNode &node0, + const SceneNode &node1) { + // Check equivalence of node indices. + if (node0.GetMeshGroupIndex() != node1.GetMeshGroupIndex()) { + return false; + } + if (node0.GetSkinIndex() != node1.GetSkinIndex()) { + return false; + } + + // Check equivalence of node transformations. + if (node0.GetTrsMatrix().ComputeTransformationMatrix() != + node1.GetTrsMatrix().ComputeTransformationMatrix()) { + return false; + } + + // Check equivalence of node children. + if (node0.NumChildren() != node1.NumChildren()) { + return false; + } + for (int i = 0; i < node0.NumChildren(); i++) { + if (node0.Child(i) != node1.Child(i)) { + return false; + } + } + + // Check equivalence of node parents. + if (node0.NumParents() != node1.NumParents()) { + return false; + } + for (int i = 0; i < node0.NumParents(); i++) { + if (node0.Parent(i) != node1.Parent(i)) { + return false; + } + } + return true; +} + +} // namespace draco + +#endif // DRACO_TRANSCODER_SUPPORTED diff --git a/contrib/draco/src/draco/scene/scene_are_equivalent.h b/contrib/draco/src/draco/scene/scene_are_equivalent.h new file mode 100644 index 000000000..b309c0338 --- /dev/null +++ b/contrib/draco/src/draco/scene/scene_are_equivalent.h @@ -0,0 +1,42 @@ +// Copyright 2019 The Draco Authors. +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. +// + +#ifndef DRACO_SCENE_SCENE_ARE_EQUIVALENT_H_ +#define DRACO_SCENE_SCENE_ARE_EQUIVALENT_H_ + +#include "draco/draco_features.h" + +#ifdef DRACO_TRANSCODER_SUPPORTED +#include "draco/scene/scene.h" + +namespace draco { + +// A functor to compare two scenes for equivalency up to permutation of mesh +// vertices. +class SceneAreEquivalent { + public: + // Returns true if both scenes are equivalent up to permutation of + // the internal order of mesh vertices. This includes all attributes. + bool operator()(const Scene &scene0, const Scene &scene1); + + private: + static bool AreEquivalent(const Mesh &mesh0, const Mesh &mesh1); + static bool AreEquivalent(const SceneNode &node0, const SceneNode &node1); +}; + +} // namespace draco + +#endif // DRACO_TRANSCODER_SUPPORTED +#endif // DRACO_SCENE_SCENE_ARE_EQUIVALENT_H_ diff --git a/contrib/draco/src/draco/scene/scene_are_equivalent_test.cc b/contrib/draco/src/draco/scene/scene_are_equivalent_test.cc new file mode 100644 index 000000000..3a9edc6c3 --- /dev/null +++ b/contrib/draco/src/draco/scene/scene_are_equivalent_test.cc @@ -0,0 +1,86 @@ +// Copyright 2019 The Draco Authors. +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. +// +#include "draco/scene/scene_are_equivalent.h" + +#include +#include +#include +#include + +#include "draco/core/draco_test_base.h" +#include "draco/core/draco_test_utils.h" +#include "draco/io/scene_io.h" +#include "draco/scene/scene.h" + +namespace draco { + +#ifdef DRACO_TRANSCODER_SUPPORTED +class SceneAreEquivalentTest : public ::testing::Test {}; + +TEST_F(SceneAreEquivalentTest, TestOnIndenticalScenes) { + const std::string file_name = "CesiumMilkTruck/glTF/CesiumMilkTruck.gltf"; + const std::unique_ptr scene(ReadSceneFromTestFile(file_name)); + ASSERT_NE(scene, nullptr) << "Failed to load test scene: " << file_name; + + // Add mesh feature ID set to a scene mesh. + std::unique_ptr mesh_features(new MeshFeatures()); + scene->GetMesh(MeshIndex(2)).AddMeshFeatures(std::move(mesh_features)); + + SceneAreEquivalent equiv; + ASSERT_TRUE(equiv(*scene, *scene)); +} + +TEST_F(SceneAreEquivalentTest, TestOnDifferentScenes) { + const std::string file_name0 = "CesiumMilkTruck/glTF/CesiumMilkTruck.gltf"; + const std::string file_name1 = "Lantern/glTF/Lantern.gltf"; + const std::unique_ptr scene0(ReadSceneFromTestFile(file_name0)); + const std::unique_ptr scene1(ReadSceneFromTestFile(file_name1)); + ASSERT_NE(scene0, nullptr) << "Failed to load test scene: " << file_name0; + ASSERT_NE(scene1, nullptr) << "Failed to load test scene: " << file_name1; + SceneAreEquivalent equiv; + ASSERT_FALSE(equiv(*scene0, *scene1)); +} + +TEST_F(SceneAreEquivalentTest, TestMeshFeatures) { + const std::string file_name = "CesiumMilkTruck/glTF/CesiumMilkTruck.gltf"; + const std::unique_ptr scene0(ReadSceneFromTestFile(file_name)); + const std::unique_ptr scene1(ReadSceneFromTestFile(file_name)); + ASSERT_NE(scene0, nullptr); + ASSERT_NE(scene1, nullptr); + + // Add identical mesh feature ID sets to mesh at index 0. + Mesh &mesh0 = scene0->GetMesh(MeshIndex(0)); + Mesh &mesh1 = scene1->GetMesh(MeshIndex(0)); + mesh0.AddMeshFeatures(std::unique_ptr(new MeshFeatures())); + mesh1.AddMeshFeatures(std::unique_ptr(new MeshFeatures())); + + // Empty feature sets should match. + SceneAreEquivalent equiv; + ASSERT_TRUE(equiv(*scene0, *scene1)); + + // Make mesh features different and check that the meshes are not equivalent. + mesh0.GetMeshFeatures(MeshFeaturesIndex(0)).SetFeatureCount(5); + mesh1.GetMeshFeatures(MeshFeaturesIndex(0)).SetFeatureCount(6); + ASSERT_FALSE(equiv(*scene0, *scene1)); + + // Make mesh features identical and check that the meshes are equivalent. + mesh0.GetMeshFeatures(MeshFeaturesIndex(0)).SetFeatureCount(1); + mesh1.GetMeshFeatures(MeshFeaturesIndex(0)).SetFeatureCount(1); + ASSERT_TRUE(equiv(*scene0, *scene1)); +} + +#endif // DRACO_TRANSCODER_SUPPORTED + +} // namespace draco diff --git a/contrib/draco/src/draco/scene/scene_indices.h b/contrib/draco/src/draco/scene/scene_indices.h new file mode 100644 index 000000000..7b57e3e4a --- /dev/null +++ b/contrib/draco/src/draco/scene/scene_indices.h @@ -0,0 +1,72 @@ +// Copyright 2019 The Draco Authors. +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. +// +#ifdef DRACO_TRANSCODER_SUPPORTED +#ifndef DRACO_SCENE_SCENE_INDICES_H_ +#define DRACO_SCENE_SCENE_INDICES_H_ + +#include + +#include + +#include "draco/core/draco_index_type.h" + +namespace draco { + +// Index of a mesh in a scene. +DEFINE_NEW_DRACO_INDEX_TYPE(uint32_t, MeshIndex) + +// Index of a mesh instance in a scene. +DEFINE_NEW_DRACO_INDEX_TYPE(uint32_t, MeshInstanceIndex) + +// Index of a mesh group in a scene. +DEFINE_NEW_DRACO_INDEX_TYPE(uint32_t, MeshGroupIndex) + +// Index of a node in a scene. +DEFINE_NEW_DRACO_INDEX_TYPE(uint32_t, SceneNodeIndex) + +// Index of an animation in a scene. +DEFINE_NEW_DRACO_INDEX_TYPE(uint32_t, AnimationIndex) + +// Index of a skin in a scene. +DEFINE_NEW_DRACO_INDEX_TYPE(uint32_t, SkinIndex) + +// Index of a light in a scene. +DEFINE_NEW_DRACO_INDEX_TYPE(uint32_t, LightIndex) + +// Index of a mesh group GPU instancing in a scene. +DEFINE_NEW_DRACO_INDEX_TYPE(uint32_t, InstanceArrayIndex) + +// Constants denoting invalid indices. +static constexpr MeshIndex kInvalidMeshIndex( + std::numeric_limits::max()); +static constexpr MeshInstanceIndex kInvalidMeshInstanceIndex( + std::numeric_limits::max()); +static constexpr MeshGroupIndex kInvalidMeshGroupIndex( + std::numeric_limits::max()); +static constexpr SceneNodeIndex kInvalidSceneNodeIndex( + std::numeric_limits::max()); +static constexpr AnimationIndex kInvalidAnimationIndex( + std::numeric_limits::max()); +static constexpr SkinIndex kInvalidSkinIndex( + std::numeric_limits::max()); +static constexpr LightIndex kInvalidLightIndex( + std::numeric_limits::max()); +static constexpr InstanceArrayIndex kInvalidInstanceArrayIndex( + std::numeric_limits::max()); + +} // namespace draco + +#endif // DRACO_SCENE_SCENE_INDICES_H_ +#endif // DRACO_TRANSCODER_SUPPORTED diff --git a/contrib/draco/src/draco/scene/scene_node.h b/contrib/draco/src/draco/scene/scene_node.h new file mode 100644 index 000000000..6cfe04e2e --- /dev/null +++ b/contrib/draco/src/draco/scene/scene_node.h @@ -0,0 +1,105 @@ +// Copyright 2019 The Draco Authors. +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. +// +#ifdef DRACO_TRANSCODER_SUPPORTED +#ifndef DRACO_SCENE_SCENE_NODE_H_ +#define DRACO_SCENE_SCENE_NODE_H_ + +#include "draco/scene/scene_indices.h" +#include "draco/scene/trs_matrix.h" + +namespace draco { + +// This class is used to create a scene hierarchy from meshes in their local +// space transformed into scene space. +class SceneNode { + public: + SceneNode() + : mesh_group_index_(-1), + skin_index_(-1), + light_index_(-1), + instance_array_index_(-1) {} + + void Copy(const SceneNode &sn) { + name_ = sn.name_; + trs_matrix_.Copy(sn.trs_matrix_); + mesh_group_index_ = sn.mesh_group_index_; + skin_index_ = sn.skin_index_; + parents_ = sn.parents_; + children_ = sn.children_; + light_index_ = sn.light_index_; + instance_array_index_ = sn.instance_array_index_; + } + + // Sets a name. + void SetName(const std::string &name) { name_ = name; } + + // Returns the name. + const std::string &GetName() const { return name_; } + + // Set transformation from mesh local space to scene space. + void SetTrsMatrix(const TrsMatrix &trsm) { trs_matrix_.Copy(trsm); } + const TrsMatrix &GetTrsMatrix() const { return trs_matrix_; } + + // Set the index to the mesh group in the scene. + void SetMeshGroupIndex(MeshGroupIndex index) { mesh_group_index_ = index; } + MeshGroupIndex GetMeshGroupIndex() const { return mesh_group_index_; } + + // Set the index to the skin in the scene. + void SetSkinIndex(SkinIndex index) { skin_index_ = index; } + SkinIndex GetSkinIndex() const { return skin_index_; } + + // Set the index to the light in the scene. + void SetLightIndex(LightIndex index) { light_index_ = index; } + LightIndex GetLightIndex() const { return light_index_; } + + // Set the index to the mesh group instance array in the scene. Note that + // according to EXT_mesh_gpu_instancing glTF extension there is no defined + // behavior for a node with instance array and without a mesh group. + void SetInstanceArrayIndex(InstanceArrayIndex index) { + instance_array_index_ = index; + } + InstanceArrayIndex GetInstanceArrayIndex() const { + return instance_array_index_; + } + + // Functions to set and get zero or more parent nodes of this node. + SceneNodeIndex Parent(int index) const { return parents_[index]; } + const std::vector &Parents() const { return parents_; } + void AddParentIndex(SceneNodeIndex index) { parents_.push_back(index); } + int NumParents() const { return parents_.size(); } + void RemoveAllParents() { parents_.clear(); } + + // Functions to set and get zero or more child nodes of this node. + SceneNodeIndex Child(int index) const { return children_[index]; } + const std::vector &Children() const { return children_; } + void AddChildIndex(SceneNodeIndex index) { children_.push_back(index); } + int NumChildren() const { return children_.size(); } + void RemoveAllChildren() { children_.clear(); } + + private: + std::string name_; + TrsMatrix trs_matrix_; + draco::MeshGroupIndex mesh_group_index_; + draco::SkinIndex skin_index_; + std::vector parents_; + std::vector children_; + LightIndex light_index_; + InstanceArrayIndex instance_array_index_; +}; + +} // namespace draco + +#endif // DRACO_SCENE_SCENE_NODE_H_ +#endif // DRACO_TRANSCODER_SUPPORTED diff --git a/contrib/draco/src/draco/scene/scene_test.cc b/contrib/draco/src/draco/scene/scene_test.cc new file mode 100644 index 000000000..d639614c7 --- /dev/null +++ b/contrib/draco/src/draco/scene/scene_test.cc @@ -0,0 +1,295 @@ +// Copyright 2019 The Draco Authors. +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. +// +#include "draco/scene/scene.h" + +#include +#include +#include + +#include "draco/core/draco_test_base.h" +#include "draco/core/draco_test_utils.h" +#include "draco/core/status.h" +#include "draco/mesh/mesh_are_equivalent.h" +#include "draco/scene/scene_are_equivalent.h" +#include "draco/scene/scene_indices.h" + +namespace { + +#ifdef DRACO_TRANSCODER_SUPPORTED + +// Helper method for adding mesh group GPU instancing to the milk truck scene. +draco::Status AddGpuInstancingToMilkTruck(draco::Scene *scene) { + // Create an instance and set its transformation TRS vectors. + draco::InstanceArray::Instance instance_0; + instance_0.trs.SetTranslation(Eigen::Vector3d(1.0, 2.0, 3.0)); + instance_0.trs.SetRotation(Eigen::Quaterniond(4.0, 5.0, 6.0, 7.0)); + instance_0.trs.SetScale(Eigen::Vector3d(8.0, 9.0, 10.0)); + + // Create another instance. + draco::InstanceArray::Instance instance_1; + instance_1.trs.SetTranslation(Eigen::Vector3d(1.1, 2.1, 3.1)); + instance_1.trs.SetRotation(Eigen::Quaterniond(4.1, 5.1, 6.1, 7.1)); + instance_1.trs.SetScale(Eigen::Vector3d(8.1, 9.1, 10.1)); + + // Add an empty GPU instancing object to the scene. + const draco::InstanceArrayIndex index = scene->AddInstanceArray(); + draco::InstanceArray *gpu_instancing = scene->GetInstanceArray(index); + + // Add two instances to the GPU instancing object stored in the scene. + DRACO_RETURN_IF_ERROR(gpu_instancing->AddInstance(instance_0)); + DRACO_RETURN_IF_ERROR(gpu_instancing->AddInstance(instance_1)); + + // Assign the GPU instancing object to two mesh groups in two scene nodes. + scene->GetNode(draco::SceneNodeIndex(2))->SetInstanceArrayIndex(index); + scene->GetNode(draco::SceneNodeIndex(4))->SetInstanceArrayIndex(index); + + return draco::OkStatus(); +} + +TEST(SceneTest, TestCopy) { + // Test copying of scene data. + auto src_scene = + draco::ReadSceneFromTestFile("CesiumMilkTruck/glTF/CesiumMilkTruck.gltf"); + ASSERT_NE(src_scene, nullptr); + + // Add GPU instancing to the scene for testing. + DRACO_ASSERT_OK(AddGpuInstancingToMilkTruck(src_scene.get())); + ASSERT_EQ(src_scene->NumInstanceArrays(), 1); + ASSERT_EQ(src_scene->NumNodes(), 5); + ASSERT_EQ( + src_scene->GetNode(draco::SceneNodeIndex(0))->GetInstanceArrayIndex(), + draco::kInvalidInstanceArrayIndex); + ASSERT_EQ( + src_scene->GetNode(draco::SceneNodeIndex(1))->GetInstanceArrayIndex(), + draco::kInvalidInstanceArrayIndex); + ASSERT_EQ( + src_scene->GetNode(draco::SceneNodeIndex(2))->GetInstanceArrayIndex(), + draco::InstanceArrayIndex(0)); + ASSERT_EQ( + src_scene->GetNode(draco::SceneNodeIndex(3))->GetInstanceArrayIndex(), + draco::kInvalidInstanceArrayIndex); + ASSERT_EQ( + src_scene->GetNode(draco::SceneNodeIndex(4))->GetInstanceArrayIndex(), + draco::InstanceArrayIndex(0)); + + // Make a copy of the scene. + draco::Scene dst_scene; + dst_scene.Copy(*src_scene); + + ASSERT_EQ(src_scene->NumMeshes(), dst_scene.NumMeshes()); + ASSERT_EQ(src_scene->NumMeshGroups(), dst_scene.NumMeshGroups()); + ASSERT_EQ(src_scene->NumNodes(), dst_scene.NumNodes()); + ASSERT_EQ(src_scene->NumAnimations(), dst_scene.NumAnimations()); + ASSERT_EQ(src_scene->NumSkins(), dst_scene.NumSkins()); + ASSERT_EQ(src_scene->NumLights(), dst_scene.NumLights()); + ASSERT_EQ(src_scene->NumInstanceArrays(), dst_scene.NumInstanceArrays()); + + for (draco::MeshIndex i(0); i < src_scene->NumMeshes(); ++i) { + draco::MeshAreEquivalent eq; + ASSERT_TRUE(eq(src_scene->GetMesh(i), dst_scene.GetMesh(i))); + } + for (draco::MeshGroupIndex i(0); i < src_scene->NumMeshGroups(); ++i) { + ASSERT_EQ(src_scene->GetMeshGroup(i)->NumMeshInstances(), + dst_scene.GetMeshGroup(i)->NumMeshInstances()); + for (int j = 0; j < src_scene->GetMeshGroup(i)->NumMeshInstances(); ++j) { + ASSERT_EQ(src_scene->GetMeshGroup(i)->GetMeshInstance(j).mesh_index, + dst_scene.GetMeshGroup(i)->GetMeshInstance(j).mesh_index); + ASSERT_EQ(src_scene->GetMeshGroup(i)->GetMeshInstance(j).material_index, + dst_scene.GetMeshGroup(i)->GetMeshInstance(j).material_index); + ASSERT_EQ(src_scene->GetMeshGroup(i) + ->GetMeshInstance(j) + .materials_variants_mappings.size(), + dst_scene.GetMeshGroup(i) + ->GetMeshInstance(j) + .materials_variants_mappings.size()); + } + } + for (draco::SceneNodeIndex i(0); i < src_scene->NumNodes(); ++i) { + ASSERT_EQ(src_scene->GetNode(i)->NumParents(), + dst_scene.GetNode(i)->NumParents()); + for (int j = 0; j < src_scene->GetNode(i)->NumParents(); ++j) { + ASSERT_EQ(src_scene->GetNode(i)->Parent(j), + dst_scene.GetNode(i)->Parent(j)); + } + ASSERT_EQ(src_scene->GetNode(i)->NumChildren(), + dst_scene.GetNode(i)->NumChildren()); + for (int j = 0; j < src_scene->GetNode(i)->NumChildren(); ++j) { + ASSERT_EQ(src_scene->GetNode(i)->Child(j), + dst_scene.GetNode(i)->Child(j)); + } + ASSERT_EQ(src_scene->GetNode(i)->GetMeshGroupIndex(), + dst_scene.GetNode(i)->GetMeshGroupIndex()); + ASSERT_EQ(src_scene->GetNode(i)->GetSkinIndex(), + dst_scene.GetNode(i)->GetSkinIndex()); + ASSERT_EQ(src_scene->GetNode(i)->GetLightIndex(), + dst_scene.GetNode(i)->GetLightIndex()); + ASSERT_EQ(src_scene->GetNode(i)->GetInstanceArrayIndex(), + dst_scene.GetNode(i)->GetInstanceArrayIndex()); + } +} + +TEST(SceneTest, TestRemoveMesh) { + // Test that a base mesh can be removed from scene. + auto src_scene_ptr = + draco::ReadSceneFromTestFile("CesiumMilkTruck/glTF/CesiumMilkTruck.gltf"); + ASSERT_NE(src_scene_ptr, nullptr); + const draco::Scene &src_scene = *src_scene_ptr; + + // Copy scene. + draco::Scene dst_scene; + dst_scene.Copy(src_scene); + ASSERT_EQ(dst_scene.NumMeshes(), 4); + draco::MeshAreEquivalent eq; + ASSERT_TRUE(eq(dst_scene.GetMesh(draco::MeshIndex(0)), + src_scene.GetMesh(draco::MeshIndex(0)))); + ASSERT_TRUE(eq(dst_scene.GetMesh(draco::MeshIndex(1)), + src_scene.GetMesh(draco::MeshIndex(1)))); + ASSERT_TRUE(eq(dst_scene.GetMesh(draco::MeshIndex(2)), + src_scene.GetMesh(draco::MeshIndex(2)))); + ASSERT_TRUE(eq(dst_scene.GetMesh(draco::MeshIndex(3)), + src_scene.GetMesh(draco::MeshIndex(3)))); + + // Remove base mesh from scene. + dst_scene.RemoveMesh(draco::MeshIndex(2)); + ASSERT_EQ(dst_scene.NumMeshes(), 3); + ASSERT_TRUE(eq(dst_scene.GetMesh(draco::MeshIndex(0)), + src_scene.GetMesh(draco::MeshIndex(0)))); + ASSERT_TRUE(eq(dst_scene.GetMesh(draco::MeshIndex(1)), + src_scene.GetMesh(draco::MeshIndex(1)))); + ASSERT_TRUE(eq(dst_scene.GetMesh(draco::MeshIndex(2)), + src_scene.GetMesh(draco::MeshIndex(3)))); + + // Remove another base mesh from scene. + dst_scene.RemoveMesh(draco::MeshIndex(1)); + ASSERT_EQ(dst_scene.NumMeshes(), 2); + ASSERT_TRUE(eq(dst_scene.GetMesh(draco::MeshIndex(0)), + src_scene.GetMesh(draco::MeshIndex(0)))); + ASSERT_TRUE(eq(dst_scene.GetMesh(draco::MeshIndex(1)), + src_scene.GetMesh(draco::MeshIndex(3)))); +} + +TEST(SceneTest, TestRemoveMeshGroup) { + // Test that a mesh group can be removed from scene. + auto src_scene_ptr = + draco::ReadSceneFromTestFile("CesiumMilkTruck/glTF/CesiumMilkTruck.gltf"); + ASSERT_NE(src_scene_ptr, nullptr); + const draco::Scene &src_scene = *src_scene_ptr; + + // Copy scene. + draco::Scene dst_scene; + dst_scene.Copy(src_scene); + ASSERT_EQ(dst_scene.NumMeshGroups(), 2); + ASSERT_EQ(dst_scene.NumNodes(), 5); + ASSERT_EQ(dst_scene.GetNode(draco::SceneNodeIndex(0))->GetMeshGroupIndex(), + draco::MeshGroupIndex(0)); + ASSERT_EQ(dst_scene.GetNode(draco::SceneNodeIndex(2))->GetMeshGroupIndex(), + draco::MeshGroupIndex(1)); + ASSERT_EQ(dst_scene.GetNode(draco::SceneNodeIndex(4))->GetMeshGroupIndex(), + draco::MeshGroupIndex(1)); + + // Remove mesh group from scene. + dst_scene.RemoveMeshGroup(draco::MeshGroupIndex(0)); + ASSERT_EQ(dst_scene.NumMeshGroups(), 1); + ASSERT_EQ(dst_scene.NumNodes(), 5); + ASSERT_EQ(dst_scene.GetNode(draco::SceneNodeIndex(0))->GetMeshGroupIndex(), + draco::kInvalidMeshGroupIndex); + ASSERT_EQ(dst_scene.GetNode(draco::SceneNodeIndex(2))->GetMeshGroupIndex(), + draco::MeshGroupIndex(0)); + ASSERT_EQ(dst_scene.GetNode(draco::SceneNodeIndex(4))->GetMeshGroupIndex(), + draco::MeshGroupIndex(0)); + + // Remove another mesh group from scene. + dst_scene.RemoveMeshGroup(draco::MeshGroupIndex(0)); + ASSERT_EQ(dst_scene.NumMeshGroups(), 0); + ASSERT_EQ(dst_scene.GetNode(draco::SceneNodeIndex(0))->GetMeshGroupIndex(), + draco::kInvalidMeshGroupIndex); + ASSERT_EQ(dst_scene.GetNode(draco::SceneNodeIndex(2))->GetMeshGroupIndex(), + draco::kInvalidMeshGroupIndex); + ASSERT_EQ(dst_scene.GetNode(draco::SceneNodeIndex(4))->GetMeshGroupIndex(), + draco::kInvalidMeshGroupIndex); +} + +void CheckMeshMaterials(const draco::Scene &scene, + const std::vector &expected_material_indices) { + ASSERT_EQ(scene.NumMeshes(), expected_material_indices.size()); + std::vector scene_material_indices; + for (draco::MeshGroupIndex i(0); i < scene.NumMeshGroups(); i++) { + const auto mg = scene.GetMeshGroup(i); + for (int mi = 0; mi < mg->NumMeshInstances(); ++mi) { + scene_material_indices.push_back(mg->GetMeshInstance(mi).material_index); + } + } + ASSERT_EQ(scene_material_indices, expected_material_indices); +} + +TEST(SceneTest, TestRemoveMaterial) { + // Test that materials can be removed from a scene. + auto src_scene_ptr = + draco::ReadSceneFromTestFile("CesiumMilkTruck/glTF/CesiumMilkTruck.gltf"); + ASSERT_NE(src_scene_ptr, nullptr); + const draco::Scene &src_scene = *src_scene_ptr; + ASSERT_EQ(src_scene.GetMaterialLibrary().NumMaterials(), 4); + CheckMeshMaterials(src_scene, {0, 1, 2, 3}); + + // Copy scene. + draco::Scene dst_scene; + dst_scene.Copy(src_scene); + + // Check that referenced material cannot be removed from the scene. + ASSERT_FALSE(dst_scene.RemoveMaterial(2).ok()); + + // Copy scene again, since failed material removal corrupts the scene. + dst_scene.Copy(src_scene); + + // Remove base mesh from scene. Material at index 2 becomes unreferenced. + DRACO_ASSERT_OK(dst_scene.RemoveMesh(draco::MeshIndex(2))); + ASSERT_EQ(dst_scene.GetMaterialLibrary().NumMaterials(), 4); + CheckMeshMaterials(dst_scene, {0, 1, 3}); + + // Check that unreferenced material can be removed from the scene. + DRACO_ASSERT_OK(dst_scene.RemoveMaterial(2)); + ASSERT_EQ(dst_scene.GetMaterialLibrary().NumMaterials(), 3); + CheckMeshMaterials(dst_scene, {0, 1, 2}); + + // Check that material cannot be removed when material index is out of range. + ASSERT_FALSE(dst_scene.RemoveMaterial(-1).ok()); + ASSERT_FALSE(dst_scene.RemoveMaterial(3).ok()); +} + +TEST(SceneTest, TestCopyWithStructuralMetadata) { + // Tests copying of a scene with structural metadata. + auto scene_ptr = + draco::ReadSceneFromTestFile("CesiumMilkTruck/glTF/CesiumMilkTruck.gltf"); + ASSERT_NE(scene_ptr, nullptr); + draco::Scene &scene = *scene_ptr; + + // Add structural metadata to the scene. + draco::PropertyTable::Schema schema; + schema.json.SetString("Data"); + scene.GetStructuralMetadata().SetPropertyTableSchema(schema); + + // Copy the scene. + draco::Scene copy; + copy.Copy(scene); + + // Check that the structural metadata has been copied. + ASSERT_EQ( + copy.GetStructuralMetadata().GetPropertyTableSchema().json.GetString(), + "Data"); +} + +#endif // DRACO_TRANSCODER_SUPPORTED + +} // namespace diff --git a/contrib/draco/src/draco/scene/scene_utils.cc b/contrib/draco/src/draco/scene/scene_utils.cc new file mode 100644 index 000000000..a7bf1dcb9 --- /dev/null +++ b/contrib/draco/src/draco/scene/scene_utils.cc @@ -0,0 +1,962 @@ +// Copyright 2019 The Draco Authors. +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. +// + +#include "draco/scene/scene_utils.h" + +#ifdef DRACO_TRANSCODER_SUPPORTED +#include +#include +#include +#include +#include +#include + +#include "draco/core/draco_index_type_vector.h" +#include "draco/core/hash_utils.h" +#include "draco/core/vector_d.h" +#include "draco/mesh/mesh_splitter.h" +#include "draco/mesh/mesh_utils.h" +#include "draco/scene/scene_indices.h" +#include "draco/texture/texture_utils.h" + +namespace draco { + +IndexTypeVector +SceneUtils::ComputeAllInstances(const Scene &scene) { + IndexTypeVector instances; + + // Traverse the scene assuming multiple root nodes. + const Eigen::Matrix4d transform = Eigen::Matrix4d::Identity(); + + struct Node { + const SceneNodeIndex scene_node_index; + Eigen::Matrix4d transform; + }; + std::vector nodes; + nodes.reserve(scene.NumRootNodes()); + for (int i = 0; i < scene.NumRootNodes(); ++i) { + nodes.push_back({scene.GetRootNodeIndex(i), transform}); + } + + while (!nodes.empty()) { + const Node node = nodes.back(); + nodes.pop_back(); + const SceneNode &scene_node = *scene.GetNode(node.scene_node_index); + const Eigen::Matrix4d combined_transform = + node.transform * + scene_node.GetTrsMatrix().ComputeTransformationMatrix(); + + // Create instances from node meshes. + const MeshGroupIndex mesh_group_index = scene_node.GetMeshGroupIndex(); + if (mesh_group_index != kInvalidMeshGroupIndex) { + const MeshGroup &mesh_group = *scene.GetMeshGroup(mesh_group_index); + for (int i = 0; i < mesh_group.NumMeshInstances(); i++) { + const MeshIndex mesh_index = mesh_group.GetMeshInstance(i).mesh_index; + if (mesh_index != kInvalidMeshIndex) { + instances.push_back( + {mesh_index, node.scene_node_index, i, combined_transform}); + } + } + } + + // Traverse children nodes. + for (int i = 0; i < scene_node.NumChildren(); i++) { + nodes.push_back({scene_node.Child(i), combined_transform}); + } + } + return instances; +} + +Eigen::Matrix4d SceneUtils::ComputeGlobalNodeTransform(const Scene &scene, + SceneNodeIndex index) { + Eigen::Matrix4d transform = Eigen::Matrix4d::Identity(); + while (index != kInvalidSceneNodeIndex) { + const SceneNode *const node = scene.GetNode(index); + transform = node->GetTrsMatrix().ComputeTransformationMatrix() * transform; + index = node->NumParents() == 1 ? node->Parent(0) : kInvalidSceneNodeIndex; + } + return transform; +} + +IndexTypeVector SceneUtils::NumMeshInstances( + const Scene &scene) { + const auto instances = ComputeAllInstances(scene); + IndexTypeVector num_mesh_instances(scene.NumMeshes(), 0); + for (MeshInstanceIndex i(0); i < instances.size(); i++) { + const MeshInstance &instance = instances[i]; + num_mesh_instances[instance.mesh_index]++; + } + return num_mesh_instances; +} + +int SceneUtils::GetMeshInstanceMaterialIndex(const Scene &scene, + const MeshInstance &instance) { + const auto *const node = scene.GetNode(instance.scene_node_index); + return scene.GetMeshGroup(node->GetMeshGroupIndex()) + ->GetMeshInstance(instance.mesh_group_mesh_index) + .material_index; +} + +int SceneUtils::NumFacesOnBaseMeshes(const Scene &scene) { + int num_faces = 0; + for (MeshIndex i(0); i < scene.NumMeshes(); ++i) { + num_faces += scene.GetMesh(i).num_faces(); + } + return num_faces; +} + +int SceneUtils::NumFacesOnInstancedMeshes(const Scene &scene) { + const auto instances = ComputeAllInstances(scene); + int num_faces = 0; + for (MeshInstanceIndex i(0); i < instances.size(); i++) { + const MeshInstance &instance = instances[i]; + num_faces += scene.GetMesh(instance.mesh_index).num_faces(); + } + return num_faces; +} + +int SceneUtils::NumPointsOnBaseMeshes(const Scene &scene) { + int num_points = 0; + for (MeshIndex i(0); i < scene.NumMeshes(); ++i) { + num_points += scene.GetMesh(i).num_points(); + } + return num_points; +} + +int SceneUtils::NumPointsOnInstancedMeshes(const Scene &scene) { + const auto instances = ComputeAllInstances(scene); + int num_points = 0; + for (MeshInstanceIndex i(0); i < instances.size(); i++) { + const MeshInstance &instance = instances[i]; + num_points += scene.GetMesh(instance.mesh_index).num_points(); + } + return num_points; +} + +int SceneUtils::NumAttEntriesOnBaseMeshes(const Scene &scene, + GeometryAttribute::Type att_type) { + int num_att_entries = 0; + for (MeshIndex i(0); i < scene.NumMeshes(); ++i) { + const Mesh &mesh = scene.GetMesh(i); + const PointAttribute *att = mesh.GetNamedAttribute(att_type); + if (att != nullptr) { + num_att_entries += att->size(); + } + } + return num_att_entries; +} + +int SceneUtils::NumAttEntriesOnInstancedMeshes( + const Scene &scene, GeometryAttribute::Type att_type) { + const auto instances = ComputeAllInstances(scene); + int num_att_entries = 0; + for (MeshInstanceIndex i(0); i < instances.size(); i++) { + const MeshInstance &instance = instances[i]; + const Mesh &mesh = scene.GetMesh(instance.mesh_index); + const PointAttribute *att = mesh.GetNamedAttribute(att_type); + if (att != nullptr) { + num_att_entries += att->size(); + } + } + return num_att_entries; +} + +BoundingBox SceneUtils::ComputeBoundingBox(const Scene &scene) { + // Compute bounding box that includes all scene mesh instances. + const auto instances = ComputeAllInstances(scene); + BoundingBox scene_bbox; + for (MeshInstanceIndex i(0); i < instances.size(); i++) { + const MeshInstance &instance = instances[i]; + const BoundingBox mesh_bbox = + ComputeMeshInstanceBoundingBox(scene, instance); + scene_bbox.Update(mesh_bbox); + } + return scene_bbox; +} + +BoundingBox SceneUtils::ComputeMeshInstanceBoundingBox( + const Scene &scene, const MeshInstance &instance) { + const Mesh &mesh = scene.GetMesh(instance.mesh_index); + BoundingBox mesh_bbox; + auto pc_att = mesh.GetNamedAttribute(GeometryAttribute::POSITION); + Eigen::Vector4d position; + position[3] = 1.0; + for (AttributeValueIndex i(0); i < pc_att->size(); ++i) { + pc_att->ConvertValue(i, &position[0]); + const Eigen::Vector4d transformed = instance.transform * position; + mesh_bbox.Update({static_cast(transformed[0]), + static_cast(transformed[1]), + static_cast(transformed[2])}); + } + return mesh_bbox; +} + +namespace { + +// Updates texture pointers in mesh features of |mesh| to texture pointers +// stored in |new_texture_library|. |texture_to_index_map| stores texture +// indices of the old texture pointers within |mesh|. +void UpdateMeshFeaturesTexturesOnMesh( + const std::unordered_map &texture_to_index_map, + TextureLibrary *new_texture_library, Mesh *mesh) { + for (MeshFeaturesIndex mfi(0); mfi < mesh->NumMeshFeatures(); ++mfi) { + mesh->UpdateMeshFeaturesTexturePointer( + texture_to_index_map, new_texture_library, &mesh->GetMeshFeatures(mfi)); + } +} + +} // namespace + +StatusOr> SceneUtils::MeshToScene( + std::unique_ptr mesh) { + const size_t num_mesh_materials = mesh->GetMaterialLibrary().NumMaterials(); + std::unique_ptr scene(new Scene()); + if (num_mesh_materials > 0) { + scene->GetMaterialLibrary().Copy(mesh->GetMaterialLibrary()); + mesh->GetMaterialLibrary().Clear(); + } else { + // Create a default material for the scene. + scene->GetMaterialLibrary().MutableMaterial(0); + } + + // Copy mesh feature textures. + scene->GetNonMaterialTextureLibrary().Copy( + mesh->GetNonMaterialTextureLibrary()); + + const auto old_texture_to_index_map = + mesh->GetNonMaterialTextureLibrary().ComputeTextureToIndexMap(); + + const SceneNodeIndex scene_node_index = scene->AddNode(); + SceneNode *const scene_node = scene->GetNode(scene_node_index); + const MeshGroupIndex mesh_group_index = scene->AddMeshGroup(); + MeshGroup *const mesh_group = scene->GetMeshGroup(mesh_group_index); + + if (num_mesh_materials <= 1) { + const MeshIndex mesh_index = scene->AddMesh(std::move(mesh)); + if (mesh_index == kInvalidMeshIndex) { + // No idea whether this can happen. It's not covered by any unit test. + return Status(Status::DRACO_ERROR, "Could not add Draco mesh to scene."); + } + mesh_group->AddMeshInstance({mesh_index, 0, {}}); + + UpdateMeshFeaturesTexturesOnMesh(old_texture_to_index_map, + &scene->GetNonMaterialTextureLibrary(), + &scene->GetMesh(mesh_index)); + + } else { + const int32_t mat_att_id = + mesh->GetNamedAttributeId(GeometryAttribute::MATERIAL); + if (mat_att_id == -1) { + // Probably dead code, not covered by any unit test. + return Status(Status::DRACO_ERROR, + "Internal error in MeshToScene: " + "GetNamedAttributeId(MATERIAL) returned -1"); + } + const PointAttribute *const mat_att = + mesh->GetNamedAttribute(GeometryAttribute::MATERIAL); + if (mat_att == nullptr) { + // Probably dead code, not covered by any unit test. + return Status(Status::DRACO_ERROR, + "Internal error in MeshToScene: " + "GetNamedAttribute(MATERIAL) returned nullptr"); + } + + MeshSplitter splitter; + DRACO_ASSIGN_OR_RETURN(MeshSplitter::MeshVector split_meshes, + splitter.SplitMesh(*mesh, mat_att_id)); + // Note: cannot clear mesh here, since mat_att points into it. + for (size_t i = 0; i < split_meshes.size(); ++i) { + if (split_meshes[i] == nullptr) { + // Probably dead code, not covered by any unit test. + continue; + } + const MeshIndex mesh_index = scene->AddMesh(std::move(split_meshes[i])); + if (mesh_index == kInvalidMeshIndex) { + // No idea whether this can happen. It's not covered by any unit test. + return Status(Status::DRACO_ERROR, + "Could not add Draco mesh to scene."); + } + + int material_index = 0; + mat_att->GetValue(AttributeValueIndex(i), &material_index); + mesh_group->AddMeshInstance({mesh_index, material_index, {}}); + + // Copy over mesh features that were associated with the |material_index|. + Mesh &scene_mesh = scene->GetMesh(mesh_index); + Mesh::CopyMeshFeaturesForMaterial(*mesh, &scene_mesh, material_index); + UpdateMeshFeaturesTexturesOnMesh(old_texture_to_index_map, + &scene->GetNonMaterialTextureLibrary(), + &scene_mesh); + } + } + + scene_node->SetMeshGroupIndex(mesh_group_index); + scene->AddRootNodeIndex(scene_node_index); + return scene; +} + +void SceneUtils::PrintInfo(const Scene &input, const Scene &simplified, + bool verbose) { + struct Printer { + Printer(const Scene &input, const Scene &simplified) + : input(input), simplified(simplified), print_instanced_info(false) { + // Info about the instanced meshes is printed if some of the meshes have + // multiple instances and also if the number of base meshes has changed. + auto input_instances = SceneUtils::NumMeshInstances(input); + auto simplified_instances = SceneUtils::NumMeshInstances(simplified); + if (input_instances.size() != simplified_instances.size()) { + print_instanced_info = true; + return; + } + for (MeshIndex i(0); i < input_instances.size(); i++) { + if (input_instances[i] != 1 || simplified_instances[i] != 1) { + print_instanced_info = true; + return; + } + } + } + + void PrintInfoHeader() const { + printf("\n"); + printf("%21s | geometry: base", ""); + if (print_instanced_info) { + printf(" instanced"); + } + printf("\n"); + } + + void PrintInfoRow(const std::string &label, int count_input_base, + int count_input_instanced, int count_simplified_base, + int count_simplified_instanced) const { + // Do not clutter the printout with empty info. + if (count_input_base == 0 && count_input_instanced == 0) { + return; + } + printf(" ----------------------------------------------"); + if (print_instanced_info) { + printf("-------------"); + } + printf("\n"); + printf("%21s | input: %12d", label.c_str(), count_input_base); + if (print_instanced_info) { + printf(" %12d", count_input_instanced); + } + printf("\n"); + printf("%21s | simplified: %12d", "", count_simplified_base); + if (print_instanced_info) { + printf(" %12d", count_simplified_instanced); + } + printf("\n"); + } + + void PrintAttInfoRow(const std::string &label, const draco::Scene &input, + const draco::Scene &simplified, + draco::GeometryAttribute::Type att_type) const { + PrintInfoRow(label, NumAttEntriesOnBaseMeshes(input, att_type), + NumAttEntriesOnInstancedMeshes(input, att_type), + NumAttEntriesOnBaseMeshes(simplified, att_type), + NumAttEntriesOnInstancedMeshes(simplified, att_type)); + } + + const Scene &input; + const Scene &simplified; + bool print_instanced_info; + }; + + // Print information about input and simplified scenes. + const Printer printer(input, simplified); + printer.PrintInfoHeader(); + if (verbose) { + const int num_meshes_input_base = input.NumMeshes(); + const int num_meshes_simplified_base = simplified.NumMeshes(); + const int num_meshes_input_instanced = ComputeAllInstances(input).size(); + const int num_meshes_simplified_instanced = + ComputeAllInstances(simplified).size(); + printer.PrintInfoRow("Number of meshes", num_meshes_input_base, + num_meshes_input_instanced, num_meshes_simplified_base, + num_meshes_simplified_instanced); + } + printer.PrintInfoRow("Number of faces", NumFacesOnBaseMeshes(input), + NumFacesOnInstancedMeshes(input), + NumFacesOnBaseMeshes(simplified), + NumFacesOnInstancedMeshes(simplified)); + if (verbose) { + printer.PrintInfoRow("Number of points", NumPointsOnBaseMeshes(input), + NumPointsOnInstancedMeshes(input), + NumPointsOnBaseMeshes(simplified), + NumPointsOnInstancedMeshes(simplified)); + printer.PrintAttInfoRow("Number of positions", input, simplified, + draco::GeometryAttribute::POSITION); + printer.PrintAttInfoRow("Number of normals", input, simplified, + draco::GeometryAttribute::NORMAL); + printer.PrintAttInfoRow("Number of colors", input, simplified, + draco::GeometryAttribute::COLOR); + printer.PrintInfoRow("Number of materials", + input.GetMaterialLibrary().NumMaterials(), + simplified.GetMaterialLibrary().NumMaterials(), + input.GetMaterialLibrary().NumMaterials(), + simplified.GetMaterialLibrary().NumMaterials()); + } +} + +StatusOr> SceneUtils::InstantiateMesh( + const Scene &scene, const MeshInstance &instance) { + // Check if the |scene| has base mesh corresponding to mesh |instance|. + if (scene.NumMeshes() <= instance.mesh_index.value()) { + Status(Status::DRACO_ERROR, "Scene has no corresponding base mesh."); + } + + // Check that mesh has valid positions. + const Mesh &base_mesh = scene.GetMesh(instance.mesh_index); + const int32_t pos_id = + base_mesh.GetNamedAttributeId(GeometryAttribute::POSITION); + const PointAttribute *const pos_att = base_mesh.attribute(pos_id); + if (pos_att == nullptr) { + return Status(Status::DRACO_ERROR, "Mesh has no positions."); + } + if (pos_att->data_type() != DT_FLOAT32 || pos_att->num_components() != 3) { + return Status(Status::DRACO_ERROR, "Mesh has invalid positions."); + } + + // Copy the base mesh from |scene|. + std::unique_ptr mesh(new Mesh()); + mesh->Copy(base_mesh); + + // Apply transformation to mesh unless transformation is identity. + if (instance.transform != Eigen::Matrix4d::Identity()) { + MeshUtils::TransformMesh(instance.transform, mesh.get()); + } + return mesh; +} + +namespace { + +// Helper class for deleting unused nodes from the scene. +class SceneUnusedNodeRemover { + public: + // Removes unused nodes from the |scene|. + void RemoveUnusedNodes(Scene *scene) { + // Finds all unused nodes and initializes |node_map_| that maps old node + // indices to new node indices. + const int num_unused_nodes = FindUnusedNodes(*scene); + if (num_unused_nodes == 0) { + return; // All nodes are used. + } + + // Update indices of all scene elements accounting for nodes that are going + // to be removed from the scene. + UpdateNodeIndices(scene); + RemoveUnusedNodesFromScene(scene); + } + + private: + // Returns the number of unused nodes. + int FindUnusedNodes(const Scene &scene) { + // First all nodes are considered unused (mapped to invalid index). + // Initially if a node is used, we just map it to its own index. The final + // mapping will be updated once we know all used nodes. + node_map_.resize(scene.NumNodes(), kInvalidSceneNodeIndex); + for (SceneNodeIndex sni(0); sni < scene.NumNodes(); ++sni) { + // If the scene node has a valid mesh group, mark it as used. + if (scene.GetNode(sni)->GetMeshGroupIndex() != kInvalidMeshGroupIndex) { + node_map_[sni] = sni; + } + } + + // Preserve nodes used by animations. + for (AnimationIndex i(0); i < scene.NumAnimations(); i++) { + const Animation &animation = *scene.GetAnimation(i); + for (int channel_i = 0; channel_i < animation.NumChannels(); + channel_i++) { + const SceneNodeIndex node_index( + animation.GetChannel(channel_i)->target_index); + node_map_[node_index] = node_index; + } + } + for (SkinIndex i(0); i < scene.NumSkins(); i++) { + const Skin &skin = *scene.GetSkin(i); + for (int j = 0; j < skin.NumJoints(); j++) { + const SceneNodeIndex node_index = skin.GetJoint(j); + node_map_[node_index] = node_index; + } + const SceneNodeIndex root_index = skin.GetJointRoot(); + if (root_index != kInvalidSceneNodeIndex) { + node_map_[root_index] = root_index; + } + } + + // Ensure that "unused" nodes with used child nodes are marked as used + // (a node can't be deleted as long as it has a used child node). + for (int r = 0; r < scene.NumRootNodes(); ++r) { + UpdateUsedNodesFromSceneGraph(scene, scene.GetRootNodeIndex(r)); + } + + // All used / unused nodes are known. Find new indices for all scene nodes. + int num_valid_nodes = 0; + for (SceneNodeIndex sni(0); sni < scene.NumNodes(); ++sni) { + if (node_map_[sni] != kInvalidSceneNodeIndex) { + node_map_[sni] = SceneNodeIndex(num_valid_nodes++); + } + } + // Return the number of nodes that were unused. + return scene.NumNodes() - num_valid_nodes; + } + + // Recursively traverse node |sni| and mark it as used as long as it has a + // used child node. The function returns true when |sni| is a used node. + bool UpdateUsedNodesFromSceneGraph(const Scene &scene, SceneNodeIndex sni) { + const auto &node = scene.GetNode(sni); + bool is_any_child_node_used = false; + for (int c = 0; c < node->NumChildren(); ++c) { + const SceneNodeIndex cni = node->Child(c); + // Check if the child node is used. + const bool is_c_used = UpdateUsedNodesFromSceneGraph(scene, cni); + if (is_c_used) { + is_any_child_node_used = true; + } + } + if (is_any_child_node_used) { + // The node must be used even if it was previously marked as unused. + node_map_[sni] = sni; + } + // Returns whether this node is used or not. + return node_map_[sni] != kInvalidSceneNodeIndex; + } + + // Remaps existing node indices at various scene elements to new node indices + // defined by |node_map_|. + void UpdateNodeIndices(Scene *scene) const { + // Update node indices on child / parent nodes. + std::vector indices; + for (SceneNodeIndex sni(0); sni < scene->NumNodes(); ++sni) { + indices = scene->GetNode(sni)->Children(); + scene->GetNode(sni)->RemoveAllChildren(); + for (int j = 0; j < indices.size(); ++j) { + const SceneNodeIndex new_sni = node_map_[indices[j]]; + if (new_sni != kInvalidSceneNodeIndex) { + scene->GetNode(sni)->AddChildIndex(new_sni); + } + } + indices = scene->GetNode(sni)->Parents(); + scene->GetNode(sni)->RemoveAllParents(); + for (int j = 0; j < indices.size(); ++j) { + const SceneNodeIndex new_sni = node_map_[indices[j]]; + if (new_sni != kInvalidSceneNodeIndex) { + scene->GetNode(sni)->AddParentIndex(new_sni); + } + } + } + + // Update root node indices. + indices = scene->GetRootNodeIndices(); + scene->RemoveAllRootNodeIndices(); + for (int ri = 0; ri < indices.size(); ++ri) { + const SceneNodeIndex new_rni = node_map_[indices[ri]]; + if (new_rni != kInvalidSceneNodeIndex) { + scene->AddRootNodeIndex(new_rni); + } + } + + // Update node indices used by animations. + for (AnimationIndex i(0); i < scene->NumAnimations(); i++) { + Animation &animation = *scene->GetAnimation(i); + for (int i = 0; i < animation.NumChannels(); i++) { + const SceneNodeIndex node_index(animation.GetChannel(i)->target_index); + animation.GetChannel(i)->target_index = node_map_[node_index].value(); + } + } + for (SkinIndex i(0); i < scene->NumSkins(); i++) { + Skin &skin = *scene->GetSkin(i); + for (int j = 0; j < skin.NumJoints(); j++) { + const SceneNodeIndex node_index = skin.GetJoint(j); + skin.GetJoint(j) = node_map_[node_index]; + } + const SceneNodeIndex root_index = skin.GetJointRoot(); + if (root_index != kInvalidSceneNodeIndex) { + skin.SetJointRoot(node_map_[root_index]); + } + } + } + + // Removes all unused nodes from the scene. + void RemoveUnusedNodesFromScene(Scene *scene) const { + int num_valid_nodes = 0; + // Copy over nodes to their new position in the nodes array. + for (SceneNodeIndex sni(0); sni < scene->NumNodes(); ++sni) { + const SceneNodeIndex new_sni = node_map_[sni]; + if (new_sni == kInvalidSceneNodeIndex) { + continue; + } + num_valid_nodes++; + if (sni != new_sni) { + // Copy over the |sni| node to the new location (|new_sni| is lower than + // |sni|). + scene->GetNode(new_sni)->Copy(*scene->GetNode(sni)); + } + } + // Resize the nodes in the scene to account for the unused ones. This will + // delete all unused nodes. + scene->ResizeNodes(num_valid_nodes); + } + + IndexTypeVector node_map_; +}; + +} // namespace + +void SceneUtils::Cleanup(Scene *scene) { Cleanup(scene, CleanupOptions()); } + +void SceneUtils::Cleanup(Scene *scene, const CleanupOptions &options) { + // Remove invalid mesh indices from mesh groups. + if (options.remove_invalid_mesh_instances) { + for (MeshGroupIndex i(0); i < scene->NumMeshGroups(); i++) { + scene->GetMeshGroup(i)->RemoveMeshInstances(kInvalidMeshIndex); + } + } + + // Find references to mesh groups. + std::vector is_mesh_group_referenced(scene->NumMeshGroups(), false); + for (SceneNodeIndex i(0); i < scene->NumNodes(); i++) { + const SceneNode &node = *scene->GetNode(i); + const MeshGroupIndex mesh_group_index = node.GetMeshGroupIndex(); + if (mesh_group_index != kInvalidMeshGroupIndex) { + is_mesh_group_referenced[mesh_group_index.value()] = true; + } + } + + // Find references to base meshes from referenced mesh groups and find mesh + // groups that have no valid references to base meshes. + std::vector is_base_mesh_referenced(scene->NumMeshes(), false); + std::vector is_mesh_group_empty(scene->NumMeshGroups(), false); + for (MeshGroupIndex i(0); i < scene->NumMeshGroups(); i++) { + if (!is_mesh_group_referenced[i.value()]) { + continue; + } + const MeshGroup &mesh_group = *scene->GetMeshGroup(i); + bool mesh_group_is_empty = true; + for (int j = 0; j < mesh_group.NumMeshInstances(); j++) { + const MeshIndex mesh_index = mesh_group.GetMeshInstance(j).mesh_index; + mesh_group_is_empty = false; + is_base_mesh_referenced[mesh_index.value()] = true; + } + if (mesh_group_is_empty) { + is_mesh_group_empty[i.value()] = true; + } + } + + if (options.remove_unused_meshes) { + // Remove base meshes with no references to them. + for (int i = scene->NumMeshes() - 1; i >= 0; i--) { + const MeshIndex mi(i); + if (!is_base_mesh_referenced[mi.value()]) { + scene->RemoveMesh(mi); + } + } + } + + if (options.remove_unused_mesh_groups) { + // Remove empty mesh groups with no geometry or no references to them. + for (int i = scene->NumMeshGroups() - 1; i >= 0; i--) { + const MeshGroupIndex mgi(i); + if (is_mesh_group_empty[mgi.value()] || + !is_mesh_group_referenced[mgi.value()]) { + scene->RemoveMeshGroup(mgi); + } + } + } + + // Find materials that reference a texture. + MaterialLibrary &material_library = scene->GetMaterialLibrary(); + std::vector materials_with_textures(material_library.NumMaterials(), + false); + for (int i = 0; i < material_library.NumMaterials(); ++i) { + if (material_library.GetMaterial(i)->NumTextureMaps() > 0) { + materials_with_textures[i] = true; + } + } + + // Maps material index to a set of meshes that use that material. + std::vector> material_meshes( + material_library.NumMaterials()); + + // Maps mesh index to a set of materials used by that mesh. + IndexTypeVector> mesh_materials( + scene->NumMeshes()); + + // Maps mesh index to a set of tex coord indices referenced by materials. + IndexTypeVector> tex_coord_referenced( + scene->NumMeshes()); + + // Populate the maps that will be used to remove unused texture coordinates. + for (int mgi = 0; mgi < scene->NumMeshGroups(); ++mgi) { + const MeshGroup *const mesh_group = + scene->GetMeshGroup(MeshGroupIndex(mgi)); + for (int mi = 0; mi < mesh_group->NumMeshInstances(); ++mi) { + const MeshIndex mesh_index = mesh_group->GetMeshInstance(mi).mesh_index; + const int material_index = mesh_group->GetMeshInstance(mi).material_index; + if (material_index == -1) { + continue; + } + + // Populate mesh-material mapping. + material_meshes[material_index].insert(mesh_index); + mesh_materials[mesh_index].insert(material_index); + + // Populate texture coordinate indices referenced by material textures. + const auto material = material_library.GetMaterial(material_index); + for (int i = 0; i < material->NumTextureMaps(); i++) { + const TextureMap *const texture_map = material->GetTextureMapByIndex(i); + const int tex_coord_index = texture_map->tex_coord_index(); + tex_coord_referenced[mesh_index].insert(tex_coord_index); + } + } + } + + // From each mesh, remove texture coordinate attributes that are not + // referenced by any materials and decrement texture coordinate indices in + // texture maps of the mesh materials accordingly. + if (options.remove_unused_tex_coords) { + for (MeshIndex mi(0); mi < scene->NumMeshes(); ++mi) { + // Do not remove unreferenced texture coordinates when the mesh materials + // are used by any other meshes to avoid corrupting those other meshes. + // TODO(vytyaz): Consider removing this limitation. + bool remove_tex_coord = true; + for (const int material_index : mesh_materials[mi]) { + if (material_meshes[material_index].size() != 1) { + // Materials of this mesh are used by other meshes. + remove_tex_coord = false; + break; + } + } + if (!remove_tex_coord) { + continue; + } + + // Remove unreferenced texture coordinate sets from this mesh. + Mesh &mesh = scene->GetMesh(mi); + const int tex_coord_count = + mesh.NumNamedAttributes(GeometryAttribute::TEX_COORD); + for (int tci = tex_coord_count - 1; tci >= 0; tci--) { + if (tex_coord_referenced[mi].count(tci) != 0) { + // Texture coordinate set is referenced. + continue; + } + mesh.DeleteAttribute( + mesh.GetNamedAttributeId(GeometryAttribute::TEX_COORD, tci)); + + // Decrement texture coordinate indices in all materials of this mesh. + for (const int material_index : mesh_materials[mi]) { + auto material = material_library.MutableMaterial(material_index); + for (int i = 0; i < material->NumTextureMaps(); i++) { + auto texture_map = material->GetTextureMapByIndex(i); + // Decrement the indices that are greater than the removed index. + if (texture_map->tex_coord_index() > tci) { + texture_map->SetProperties(texture_map->type(), + texture_map->tex_coord_index() - 1); + } + } + } + } + } + } + + if (options.remove_unused_materials) { + // Remove materials that are not used by any mesh. + for (int i = material_library.NumMaterials() - 1; i >= 0; --i) { + if (material_meshes[i].empty()) { + // Material |i| is not used. + scene->RemoveMaterial(i); + } + } + } + + if (options.remove_unused_nodes) { + SceneUnusedNodeRemover node_remover; + node_remover.RemoveUnusedNodes(scene); + } +} + +void SceneUtils::RemoveMeshInstances(const std::vector &instances, + Scene *scene) { + // Remove mesh instances from the scene. + for (const SceneUtils::MeshInstance &instance : instances) { + const MeshGroupIndex mgi = + scene->GetNode(instance.scene_node_index)->GetMeshGroupIndex(); + + // Create a new mesh group with removed instance (we can't just delete the + // instance from the mesh group directly, because the same mesh group may + // be used by multiple scene nodes). + const MeshGroupIndex new_mesh_group_index = scene->AddMeshGroup(); + MeshGroup &new_mesh_group = *scene->GetMeshGroup(new_mesh_group_index); + + new_mesh_group.Copy(*scene->GetMeshGroup(mgi)); + new_mesh_group.RemoveMeshInstances(instance.mesh_index); + + // Assign the new mesh group to the scene node. Unused mesh groups will be + // automatically removed later during a scene cleanup operation. + scene->GetNode(instance.scene_node_index) + ->SetMeshGroupIndex(new_mesh_group_index); + } + + // Remove duplicate mesh groups that may have been created during the instance + // removal process. + DeduplicateMeshGroups(scene); +} + +void SceneUtils::DeduplicateMeshGroups(Scene *scene) { + if (scene->NumMeshGroups() <= 1) { + return; + } + + // Signature of a mesh group used for detecting duplicates. + struct MeshGroupSignature { + const MeshGroupIndex mesh_group_index; + const MeshGroup &mesh_group; + MeshGroupSignature(MeshGroupIndex mgi, const MeshGroup &mesh_group) + : mesh_group_index(mgi), mesh_group(mesh_group) {} + + bool operator==(const MeshGroupSignature &signature) const { + if (mesh_group.GetName() != signature.mesh_group.GetName()) { + return false; + } + if (mesh_group.NumMeshInstances() != + signature.mesh_group.NumMeshInstances()) { + return false; + } + // TODO(ostava): We may consider sorting meshes within a mesh group to + // make the order of meshes irrelevant. This should be done only for + // meshes with opaque materials though, because for transparent + // geometries, the order matters. + for (int i = 0; i < mesh_group.NumMeshInstances(); ++i) { + if (mesh_group.GetMeshInstance(i) != + signature.mesh_group.GetMeshInstance(i)) { + return false; + } + } + return true; + } + struct Hash { + size_t operator()(const MeshGroupSignature &signature) const { + size_t hash = 79; // Magic number. + const MeshGroup &group = signature.mesh_group; + hash = HashCombine(group.GetName(), hash); + hash = HashCombine(group.NumMeshInstances(), hash); + for (int i = 0; i < group.NumMeshInstances(); ++i) { + const MeshGroup::MeshInstance &instance = group.GetMeshInstance(i); + hash = HashCombine(instance.mesh_index, hash); + hash = HashCombine(instance.material_index, hash); + hash = HashCombine(instance.materials_variants_mappings.size(), hash); + for (const MeshGroup::MaterialsVariantsMapping &mapping : + instance.materials_variants_mappings) { + hash = HashCombine(mapping.material, hash); + hash = HashCombine(mapping.variants.size(), hash); + for (const int &variant : mapping.variants) { + hash = HashCombine(variant, hash); + } + } + } + return hash; + } + }; + }; + + // Set holding unique mesh groups. + std::unordered_set + unique_mesh_groups; + IndexTypeVector parent_mesh_group( + scene->NumMeshGroups()); + for (MeshGroupIndex mgi(0); mgi < scene->NumMeshGroups(); ++mgi) { + const MeshGroup *mg = scene->GetMeshGroup(mgi); + const MeshGroupSignature signature(mgi, *mg); + auto it = unique_mesh_groups.find(signature); + if (it != unique_mesh_groups.end()) { + parent_mesh_group[mgi] = it->mesh_group_index; + } else { + parent_mesh_group[mgi] = kInvalidMeshGroupIndex; + unique_mesh_groups.insert(signature); + } + } + + // Go over all nodes and update mesh groups if needed. + for (SceneNodeIndex sni(0); sni < scene->NumNodes(); ++sni) { + const MeshGroupIndex mgi = scene->GetNode(sni)->GetMeshGroupIndex(); + if (mgi == kInvalidMeshGroupIndex || + parent_mesh_group[mgi] == kInvalidMeshGroupIndex) { + continue; // Nothing to update. + } + scene->GetNode(sni)->SetMeshGroupIndex(parent_mesh_group[mgi]); + } + + // Remove any unused mesh groups. + Cleanup(scene); +} + +void SceneUtils::SetDracoCompressionOptions( + const DracoCompressionOptions *options, Scene *scene) { + for (MeshIndex i(0); i < scene->NumMeshes(); ++i) { + Mesh &mesh = scene->GetMesh(i); + if (options == nullptr) { + mesh.SetCompressionEnabled(false); + } else { + mesh.SetCompressionEnabled(true); + mesh.SetCompressionOptions(*options); + } + } +} + +bool SceneUtils::IsDracoCompressionEnabled(const Scene &scene) { + for (MeshIndex i(0); i < scene.NumMeshes(); ++i) { + if (scene.GetMesh(i).IsCompressionEnabled()) { + return true; + } + } + return false; +} + +IndexTypeVector +SceneUtils::FindLargestBaseMeshTransforms(const Scene &scene) { + IndexTypeVector transforms( + scene.NumMeshes(), Eigen::Matrix4d::Identity()); + + // In case a mesh has multiple instances we want to use the instance with + // the largest scale. + IndexTypeVector transform_scale(scene.NumMeshes(), 0.f); + + const auto instances = SceneUtils::ComputeAllInstances(scene); + for (MeshInstanceIndex i(0); i < instances.size(); ++i) { + const auto &instance = instances[i]; + + // Compute the scale of the transform. + const Vector3f scale_vec(instance.transform.col(0).norm(), + instance.transform.col(1).norm(), + instance.transform.col(2).norm()); + + // In our framework we support uniform scale only. For now, just take the + // maximum scale across all axes. + // TODO(ostava): Investigate how to properly support non-uniform scaling. + const float max_scale = scale_vec.MaxCoeff(); + + if (transform_scale[instance.mesh_index] < max_scale) { + transform_scale[instance.mesh_index] = max_scale; + transforms[instance.mesh_index] = instance.transform; + } + } + + return transforms; +} + +} // namespace draco + +#endif // DRACO_TRANSCODER_SUPPORTED diff --git a/contrib/draco/src/draco/scene/scene_utils.h b/contrib/draco/src/draco/scene/scene_utils.h new file mode 100644 index 000000000..5b978c3c5 --- /dev/null +++ b/contrib/draco/src/draco/scene/scene_utils.h @@ -0,0 +1,150 @@ +// Copyright 2019 The Draco Authors. +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. +// +#ifndef DRACO_SCENE_SCENE_UTILS_H_ +#define DRACO_SCENE_SCENE_UTILS_H_ + +#include "draco/draco_features.h" + +#ifdef DRACO_TRANSCODER_SUPPORTED +#include "draco/attributes/geometry_attribute.h" +#include "draco/scene/scene.h" + +namespace draco { + +// Helper class containing various utility functions operating on draco::Scene. +class SceneUtils { + public: + // Helper struct holding instanced meshes and their transformations. + struct MeshInstance { + // Index of the parent mesh in the draco::Scene. + MeshIndex mesh_index; + // Index of the node in the draco::Scene. + SceneNodeIndex scene_node_index; + // Index of the mesh in the mesh group. + int mesh_group_mesh_index; + // Transform of the instance from the mesh local space to the global space + // of the scene. + Eigen::Matrix4d transform; + }; + + // Computes all mesh instances in the |scene|. + static IndexTypeVector ComputeAllInstances( + const Scene &scene); + + // Computes global transform matrix of a |scene| node given by its |index|. + static Eigen::Matrix4d ComputeGlobalNodeTransform(const Scene &scene, + SceneNodeIndex index); + + // Returns a vector of mesh instance counts for all base meshes. + static IndexTypeVector NumMeshInstances(const Scene &scene); + + // Returns the material index of the given |instance| or -1 if the mesh + // |instance| has a default material. + static int GetMeshInstanceMaterialIndex(const Scene &scene, + const MeshInstance &instance); + + // Returns the total number of faces on all base meshes of the scene (not + // counting instances). + static int NumFacesOnBaseMeshes(const Scene &scene); + + // Returns the total number of faces on all meshes of the scenes, including + // all instances of the same mesh. + static int NumFacesOnInstancedMeshes(const Scene &scene); + + // Returns the total number of points on all base meshes of the scene (not + // counting instances). + static int NumPointsOnBaseMeshes(const Scene &scene); + + // Returns the total number of points on all meshes of the scenes, including + // all instances of the same mesh. + static int NumPointsOnInstancedMeshes(const Scene &scene); + + // Returns the total number of attribute entries on all base meshes of the + // scene (not counting instances) for the first attribute of |att_type|. + static int NumAttEntriesOnBaseMeshes(const Scene &scene, + GeometryAttribute::Type att_type); + + // Returns the total number of attribute ent on all meshes of the scenes, + // including all instances of the same mesh for the first attribute of + // |att_type|. + static int NumAttEntriesOnInstancedMeshes(const Scene &scene, + GeometryAttribute::Type att_type); + + // Returns the bounding box of the scene. + static BoundingBox ComputeBoundingBox(const Scene &scene); + + // Returns the bounding box of a mesh instance. + static BoundingBox ComputeMeshInstanceBoundingBox( + const Scene &scene, const MeshInstance &instance); + + // Prints info about input and simplified scenes. + static void PrintInfo(const Scene &input, const Scene &simplified, + bool verbose); + + // Converts a draco::Mesh into a draco::Scene. If the passed-in `mesh` has + // multiple materials, the returned scene will contain multiple meshes, one + // for each of the source mesh's materials; if `mesh` has no material, one + // will be created for it. + static StatusOr> MeshToScene( + std::unique_ptr mesh); + + // Creates a mesh according to mesh |instance| in |scene|. Error is returned + // if there is no corresponding base mesh in the |scene| or the base mesh has + // no valid positions. + static StatusOr> InstantiateMesh( + const Scene &scene, const MeshInstance &instance); + + // Cleans up a |scene| by removing unused base meshes, unused and empty mesh + // groups, unused materials, unused texture coordinates and unused scene + // nodes. The actual behavior of the cleanup operation can be controller via + // the user provided |options|. + struct CleanupOptions { + bool remove_invalid_mesh_instances = true; + bool remove_unused_mesh_groups = true; + bool remove_unused_meshes = true; + bool remove_unused_nodes = false; + bool remove_unused_tex_coords = false; + bool remove_unused_materials = true; + }; + static void Cleanup(Scene *scene); + static void Cleanup(Scene *scene, const CleanupOptions &options); + + // Removes mesh |instances| from |scene|. + static void RemoveMeshInstances(const std::vector &instances, + Scene *scene); + + // Removes duplicate mesh groups that have the same name and that contain + // exactly the same meshes and materials. + static void DeduplicateMeshGroups(Scene *scene); + + // Enables geometry compression and sets compression |options| to all meshes + // in the |scene|. If |options| is nullptr then geometry compression is + // disabled for all meshes in the |scene|. + static void SetDracoCompressionOptions(const DracoCompressionOptions *options, + Scene *scene); + + // Returns true if geometry compression is eabled for any of |scene| meshes. + static bool IsDracoCompressionEnabled(const Scene &scene); + + // Returns a single tranformation matrix for each base mesh of the |scene| + // corresponding to the instance with the maximum scale. + static IndexTypeVector + FindLargestBaseMeshTransforms(const Scene &scene); +}; + +} // namespace draco + +#endif // DRACO_TRANSCODER_SUPPORTED +#endif // DRACO_SCENE_SCENE_UTILS_H_ diff --git a/contrib/draco/src/draco/scene/scene_utils_test.cc b/contrib/draco/src/draco/scene/scene_utils_test.cc new file mode 100644 index 000000000..4d6bd731d --- /dev/null +++ b/contrib/draco/src/draco/scene/scene_utils_test.cc @@ -0,0 +1,763 @@ +// Copyright 2019 The Draco Authors. +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. +// +#include "draco/scene/scene_utils.h" + +#include +#include + +#ifdef DRACO_TRANSCODER_SUPPORTED +#include "draco/core/bounding_box.h" +#include "draco/core/draco_test_base.h" +#include "draco/core/draco_test_utils.h" +#include "draco/io/texture_io.h" +#include "draco/scene/scene_indices.h" + +namespace { + +using draco::MeshIndex; +using draco::MeshInstanceIndex; + +void AssertMatrixNear(const Eigen::Matrix4d &a, const Eigen::Matrix4d &b, + float tolerance) { + Eigen::Matrix4d diff = a - b; + ASSERT_NEAR(diff.norm(), 0.f, tolerance) << a << " vs " << b; +} + +// TODO(fgalligan): Re-factor this code with gltf_encoder_test. +void CompareScenes(const draco::Scene *scene0, const draco::Scene *scene1) { + ASSERT_EQ(scene0->NumMeshGroups(), scene1->NumMeshGroups()); + ASSERT_EQ(scene0->NumMeshes(), scene1->NumMeshes()); + ASSERT_EQ(scene0->GetMaterialLibrary().NumMaterials(), + scene1->GetMaterialLibrary().NumMaterials()); + ASSERT_EQ(scene0->NumAnimations(), scene1->NumAnimations()); + ASSERT_EQ(scene0->NumSkins(), scene1->NumSkins()); + for (draco::AnimationIndex i(0); i < scene0->NumAnimations(); ++i) { + const draco::Animation *const animation0 = scene0->GetAnimation(i); + const draco::Animation *const animation1 = scene1->GetAnimation(i); + ASSERT_NE(animation0, nullptr); + ASSERT_NE(animation1, nullptr); + ASSERT_EQ(animation0->NumSamplers(), animation1->NumSamplers()); + ASSERT_EQ(animation0->NumChannels(), animation1->NumChannels()); + ASSERT_EQ(animation0->NumNodeAnimationData(), + animation1->NumNodeAnimationData()); + } +} + +TEST(SceneUtilsTest, TestComputeAllInstances) { + // Tests that we can compute all instances in an input scene along with their + // transformations. + + auto scene = + draco::ReadSceneFromTestFile("CesiumMilkTruck/glTF/CesiumMilkTruck.gltf"); + ASSERT_NE(scene, nullptr); + ASSERT_EQ(scene->NumMeshes(), 4); + + // Compute mesh instances. + const auto instances = draco::SceneUtils::ComputeAllInstances(*scene); + ASSERT_EQ(instances.size(), 5); + + // Check base mesh indices. + ASSERT_EQ(instances[MeshInstanceIndex(0)].mesh_index, 0); + ASSERT_EQ(instances[MeshInstanceIndex(1)].mesh_index, 1); + ASSERT_EQ(instances[MeshInstanceIndex(2)].mesh_index, 2); + ASSERT_EQ(instances[MeshInstanceIndex(3)].mesh_index, 3); + ASSERT_EQ(instances[MeshInstanceIndex(4)].mesh_index, 3); + + // Check scene node indices. + ASSERT_EQ(instances[MeshInstanceIndex(0)].scene_node_index, 0); + ASSERT_EQ(instances[MeshInstanceIndex(1)].scene_node_index, 0); + ASSERT_EQ(instances[MeshInstanceIndex(2)].scene_node_index, 0); + ASSERT_EQ(instances[MeshInstanceIndex(3)].scene_node_index, 4); + ASSERT_EQ(instances[MeshInstanceIndex(4)].scene_node_index, 2); + + // Check indices of meshes in mesh group. + ASSERT_EQ(instances[MeshInstanceIndex(0)].mesh_group_mesh_index, 0); + ASSERT_EQ(instances[MeshInstanceIndex(1)].mesh_group_mesh_index, 1); + ASSERT_EQ(instances[MeshInstanceIndex(2)].mesh_group_mesh_index, 2); + ASSERT_EQ(instances[MeshInstanceIndex(3)].mesh_group_mesh_index, 0); + ASSERT_EQ(instances[MeshInstanceIndex(4)].mesh_group_mesh_index, 0); + + // The first three instances should have identity transformation. + for (MeshInstanceIndex i(0); i < 3; ++i) { + AssertMatrixNear(instances[i].transform, Eigen::Matrix4d::Identity(), + 1e-6f); + } + + // Fourth and fifth instances are transformed. + Eigen::Matrix4d expected_transform = Eigen::Matrix4d::Identity(); + // Expected translation. + expected_transform(0, 3) = -1.352329969406128; + expected_transform(1, 3) = 0.4277220070362091; + expected_transform(2, 3) = -2.98022992950564e-8; + + // Expected rotation. + Eigen::Matrix4d expected_rotation = Eigen::Matrix4d::Identity(); + expected_rotation.block<3, 3>(0, 0) = + Eigen::Quaterniond(-0.9960774183273317, -0.0, -0.0, 0.08848590403795243) + .normalized() + .toRotationMatrix(); + expected_transform = expected_transform * expected_rotation; + + AssertMatrixNear(instances[MeshInstanceIndex(3)].transform, + expected_transform, 1e-6f); + + // Last instance differs only in the translation part in X axis. + expected_transform(0, 3) = 1.432669997215271; + + AssertMatrixNear(instances[MeshInstanceIndex(4)].transform, + expected_transform, 1e-6f); +} + +TEST(SceneUtilsTest, TestComputeAllInstancesWithShiftedGeometryRoot) { + // Tests that we can compute all instances in an input scene along with their + // transformations. This scene has light and camera nodes before the geometry + // node. + auto scene = draco::ReadSceneFromTestFile( + "SphereWithCircleTexture/sphere_with_circle_texture.gltf"); + ASSERT_NE(scene, nullptr); + + // There is one base mesh. + ASSERT_EQ(scene->NumMeshes(), 1); + + // There is a single mesh instance. + const auto instances = draco::SceneUtils::ComputeAllInstances(*scene); + ASSERT_EQ(instances.size(), 1); + ASSERT_EQ(instances[MeshInstanceIndex(0)].mesh_index, 0); + + // There is no transformation. + AssertMatrixNear(instances[MeshInstanceIndex(0)].transform, + Eigen::Matrix4d::Identity(), 1e-6); +} + +TEST(SceneUtilsTest, TestNumMeshInstances) { + // Tests that we can compute mesh instance counts for all base meshes in an + // input scene. + + auto scene = + draco::ReadSceneFromTestFile("CesiumMilkTruck/glTF/CesiumMilkTruck.gltf"); + ASSERT_NE(scene, nullptr); + ASSERT_EQ(scene->NumMeshes(), 4); + + const auto num_mesh_instances = draco::SceneUtils::NumMeshInstances(*scene); + ASSERT_EQ(num_mesh_instances.size(), 4); + ASSERT_EQ(num_mesh_instances[draco::MeshIndex(0)], 1); + ASSERT_EQ(num_mesh_instances[draco::MeshIndex(1)], 1); + ASSERT_EQ(num_mesh_instances[draco::MeshIndex(2)], 1); + ASSERT_EQ(num_mesh_instances[draco::MeshIndex(3)], 2); +} + +TEST(SceneUtilsTest, TestNumFacesOnScene) { + auto scene = + draco::ReadSceneFromTestFile("CesiumMilkTruck/glTF/CesiumMilkTruck.gltf"); + ASSERT_NE(scene, nullptr); + ASSERT_EQ(draco::SceneUtils::NumFacesOnBaseMeshes(*scene), 2856); + ASSERT_EQ(draco::SceneUtils::NumFacesOnInstancedMeshes(*scene), 3624); +} + +TEST(SceneUtilsTest, TestNumPointsOnScene) { + auto scene = + draco::ReadSceneFromTestFile("CesiumMilkTruck/glTF/CesiumMilkTruck.gltf"); + ASSERT_NE(scene, nullptr); + ASSERT_EQ(draco::SceneUtils::NumPointsOnBaseMeshes(*scene), 2978); + ASSERT_EQ(draco::SceneUtils::NumPointsOnInstancedMeshes(*scene), 3564); +} + +TEST(SceneUtilsTest, TestNumPositionsOnScene) { + auto scene = + draco::ReadSceneFromTestFile("CesiumMilkTruck/glTF/CesiumMilkTruck.gltf"); + ASSERT_NE(scene, nullptr); + ASSERT_EQ(draco::SceneUtils::NumAttEntriesOnBaseMeshes( + *scene, draco::GeometryAttribute::POSITION), + 1572); + ASSERT_EQ(draco::SceneUtils::NumAttEntriesOnInstancedMeshes( + *scene, draco::GeometryAttribute::POSITION), + 1960); +} + +TEST(SceneUtilsTest, TestNumNormalsOnScene) { + auto scene = + draco::ReadSceneFromTestFile("CesiumMilkTruck/glTF/CesiumMilkTruck.gltf"); + ASSERT_NE(scene, nullptr); + ASSERT_EQ(draco::SceneUtils::NumAttEntriesOnBaseMeshes( + *scene, draco::GeometryAttribute::NORMAL), + 1252); + ASSERT_EQ(draco::SceneUtils::NumAttEntriesOnInstancedMeshes( + *scene, draco::GeometryAttribute::NORMAL), + 1612); +} + +TEST(SceneUtilsTest, TestNumColorsOnScene) { + auto scene = + draco::ReadSceneFromTestFile("CesiumMilkTruck/glTF/CesiumMilkTruck.gltf"); + ASSERT_NE(scene, nullptr); + ASSERT_EQ(draco::SceneUtils::NumAttEntriesOnBaseMeshes( + *scene, draco::GeometryAttribute::COLOR), + 0); + ASSERT_EQ(draco::SceneUtils::NumAttEntriesOnInstancedMeshes( + *scene, draco::GeometryAttribute::COLOR), + 0); +} + +TEST(SceneUtilsTest, TestComputeBoundingBox) { + auto scene = + draco::ReadSceneFromTestFile("CesiumMilkTruck/glTF/CesiumMilkTruck.gltf"); + ASSERT_NE(scene, nullptr); + const draco::BoundingBox bbox = draco::SceneUtils::ComputeBoundingBox(*scene); + const draco::Vector3f min_point = bbox.GetMinPoint(); + const draco::Vector3f max_point = bbox.GetMaxPoint(); + constexpr float tolerance = 1e-4f; + EXPECT_NEAR(min_point[0], -2.43091, tolerance); + EXPECT_NEAR(min_point[1], +0.00145, tolerance); + EXPECT_NEAR(min_point[2], -1.39600, tolerance); + EXPECT_NEAR(max_point[0], +2.43800, tolerance); + EXPECT_NEAR(max_point[1], +2.58437, tolerance); + EXPECT_NEAR(max_point[2], +1.39600, tolerance); +} + +TEST(SceneUtilsTest, TestComputeMeshInstanceBoundingBox) { + auto scene = draco::ReadSceneFromTestFile( + "SphereWithCircleTexture/sphere_with_circle_texture.gltf"); + ASSERT_NE(scene, nullptr); + const draco::BoundingBox scene_bbox = + draco::SceneUtils::ComputeBoundingBox(*scene); + const auto instances = draco::SceneUtils::ComputeAllInstances(*scene); + ASSERT_EQ(instances.size(), 1); + const draco::BoundingBox mesh_bbox = + draco::SceneUtils::ComputeMeshInstanceBoundingBox( + *scene, instances[draco::MeshInstanceIndex(0)]); + ASSERT_EQ(scene_bbox.GetMinPoint(), mesh_bbox.GetMinPoint()); + ASSERT_EQ(scene_bbox.GetMaxPoint(), mesh_bbox.GetMaxPoint()); +} + +TEST(SceneUtilsTest, TestMeshToSceneZeroMaterials) { + const std::string filename = "cube_att.obj"; + std::unique_ptr mesh = draco::ReadMeshFromTestFile(filename); + ASSERT_NE(mesh, nullptr); + ASSERT_EQ(mesh->GetMaterialLibrary().NumMaterials(), 0); + + DRACO_ASSIGN_OR_ASSERT(const std::unique_ptr scene_from_mesh, + draco::SceneUtils::MeshToScene(std::move(mesh))); + ASSERT_NE(scene_from_mesh, nullptr); + ASSERT_EQ(scene_from_mesh->NumMeshes(), 1); + ASSERT_EQ(scene_from_mesh->GetMaterialLibrary().NumMaterials(), 1); + ASSERT_EQ(scene_from_mesh->NumMeshGroups(), 1); + const draco::MeshGroup *const mesh_group = + scene_from_mesh->GetMeshGroup(draco::MeshGroupIndex(0)); + ASSERT_EQ(mesh_group->NumMeshInstances(), 1); +} + +TEST(SceneUtilsTest, TestMeshToSceneOneMaterial) { + const std::string filename = + "SphereWithCircleTexture/sphere_with_circle_texture.gltf"; + auto scene = draco::ReadSceneFromTestFile(filename); + ASSERT_NE(scene, nullptr); + ASSERT_EQ(scene->GetMaterialLibrary().NumMaterials(), 1); + + std::unique_ptr mesh = draco::ReadMeshFromTestFile(filename); + ASSERT_NE(mesh, nullptr); + ASSERT_EQ(mesh->GetMaterialLibrary().NumMaterials(), 1); + + DRACO_ASSIGN_OR_ASSERT(const std::unique_ptr scene_from_mesh, + draco::SceneUtils::MeshToScene(std::move(mesh))); + ASSERT_NE(scene_from_mesh, nullptr); + ASSERT_EQ(scene_from_mesh->NumMeshes(), 1); + ASSERT_EQ(scene_from_mesh->GetMaterialLibrary().NumMaterials(), 1); + ASSERT_EQ(scene_from_mesh->NumMeshGroups(), 1); + const draco::MeshGroup *const mesh_group = + scene_from_mesh->GetMeshGroup(draco::MeshGroupIndex(0)); + ASSERT_EQ(mesh_group->NumMeshInstances(), 1); + + CompareScenes(scene.get(), scene_from_mesh.get()); +} + +TEST(SceneUtilsTest, TestMeshToSceneMultipleMaterials) { + const std::string filename = "CesiumMilkTruck/glTF/CesiumMilkTruck.gltf"; + auto scene = draco::ReadSceneFromTestFile(filename); + ASSERT_NE(scene, nullptr); + + std::unique_ptr mesh = draco::ReadMeshFromTestFile(filename); + ASSERT_NE(mesh, nullptr); + ASSERT_EQ(mesh->GetMaterialLibrary().NumMaterials(), 4); + + DRACO_ASSIGN_OR_ASSERT(const std::unique_ptr scene_from_mesh, + draco::SceneUtils::MeshToScene(std::move(mesh))); + ASSERT_NE(scene_from_mesh, nullptr); + ASSERT_EQ(scene_from_mesh->NumMeshes(), 4); + ASSERT_EQ(scene_from_mesh->GetMaterialLibrary().NumMaterials(), 4); + ASSERT_EQ(scene_from_mesh->NumMeshGroups(), 1); + const draco::MeshGroup *const mesh_group = + scene_from_mesh->GetMeshGroup(draco::MeshGroupIndex(0)); + ASSERT_EQ(mesh_group->NumMeshInstances(), 4); + + // Unfortunately we can't CompareScenes(scene.get(), scene_from_mesh.get()), + // because scene has two mesh groups and scene_from_mesh has only one. +} + +TEST(SceneUtilsTest, TestMeshToSceneMultipleMeshFeatures) { + const std::string filename = "BoxesMeta/glTF/BoxesMeta.gltf"; + std::unique_ptr scene = draco::ReadSceneFromTestFile(filename); + ASSERT_NE(scene, nullptr); + std::unique_ptr mesh = draco::ReadMeshFromTestFile(filename); + ASSERT_NE(mesh, nullptr); + ASSERT_EQ(mesh->GetMaterialLibrary().NumMaterials(), 2); + ASSERT_EQ(mesh->NumMeshFeatures(), 5); + + DRACO_ASSIGN_OR_ASSERT(const std::unique_ptr scene_from_mesh, + draco::SceneUtils::MeshToScene(std::move(mesh))); + ASSERT_NE(scene_from_mesh, nullptr); + ASSERT_EQ(scene_from_mesh->NumMeshes(), 2); + ASSERT_EQ(scene_from_mesh->GetMaterialLibrary().NumMaterials(), 2); + ASSERT_EQ(scene_from_mesh->NumMeshGroups(), 1); + const draco::MeshGroup *const mesh_group = + scene_from_mesh->GetMeshGroup(draco::MeshGroupIndex(0)); + ASSERT_EQ(mesh_group->NumMeshInstances(), 2); + + // Meshes of the new scene should have the same properties as meshes loaded + // directly into |scene|. + for (draco::MeshIndex mi(0); mi < scene->NumMeshes(); ++mi) { + ASSERT_EQ(scene->GetMesh(mi).NumMeshFeatures(), + scene_from_mesh->GetMesh(mi).NumMeshFeatures()); + for (draco::MeshFeaturesIndex mfi(0); + mfi < scene->GetMesh(mi).NumMeshFeatures(); ++mfi) { + const auto &scene_mf = scene->GetMesh(mi).GetMeshFeatures(mfi); + const auto &scene_from_mesh_mf = + scene_from_mesh->GetMesh(mi).GetMeshFeatures(mfi); + ASSERT_EQ(scene_mf.GetAttributeIndex(), + scene_from_mesh_mf.GetAttributeIndex()); + ASSERT_EQ(scene_mf.GetPropertyTableIndex(), + scene_from_mesh_mf.GetPropertyTableIndex()); + ASSERT_EQ(scene_mf.GetLabel(), scene_from_mesh_mf.GetLabel()); + ASSERT_EQ(scene_mf.GetNullFeatureId(), + scene_from_mesh_mf.GetNullFeatureId()); + ASSERT_EQ(scene_mf.GetFeatureCount(), + scene_from_mesh_mf.GetFeatureCount()); + ASSERT_EQ(scene_mf.GetTextureChannels(), + scene_from_mesh_mf.GetTextureChannels()); + ASSERT_EQ(scene_mf.GetTextureMap().texture() != nullptr, + scene_from_mesh_mf.GetTextureMap().texture() != nullptr); + } + } +} + +TEST(SceneUtilsTest, TestInstantiateMeshWithIdentityTransformation) { + auto scene = + draco::ReadSceneFromTestFile("CesiumMilkTruck/glTF/CesiumMilkTruck.gltf"); + ASSERT_NE(scene, nullptr); + + // Compute scene mesh instances. + const auto instances = draco::SceneUtils::ComputeAllInstances(*scene); + ASSERT_EQ(instances.size(), 5); + + // Check instantiation of mesh with identity transformation. + const draco::SceneUtils::MeshInstance instance = + instances[MeshInstanceIndex(0)]; + ASSERT_EQ(instance.transform, Eigen::Matrix4d::Identity()); + + // Instantiate this mesh instance. + DRACO_ASSIGN_OR_ASSERT(auto mesh, + draco::SceneUtils::InstantiateMesh(*scene, instance)); + const draco::Mesh &base_mesh = scene->GetMesh(instance.mesh_index); + + // Check that bounding box of the instanced mesh is same as box of base mesh. + const draco::BoundingBox instanced_bbox = mesh->ComputeBoundingBox(); + const draco::BoundingBox base_bbox = base_mesh.ComputeBoundingBox(); + ASSERT_EQ(instanced_bbox.GetMinPoint()[0], base_bbox.GetMinPoint()[0]); + ASSERT_EQ(instanced_bbox.GetMinPoint()[1], base_bbox.GetMinPoint()[1]); + ASSERT_EQ(instanced_bbox.GetMinPoint()[2], base_bbox.GetMinPoint()[2]); + ASSERT_EQ(instanced_bbox.GetMaxPoint()[0], base_bbox.GetMaxPoint()[0]); + ASSERT_EQ(instanced_bbox.GetMaxPoint()[1], base_bbox.GetMaxPoint()[1]); + ASSERT_EQ(instanced_bbox.GetMaxPoint()[2], base_bbox.GetMaxPoint()[2]); +} + +TEST(SceneUtilsTest, TestInstantiateMesh) { + auto scene = + draco::ReadSceneFromTestFile("CesiumMilkTruck/glTF/CesiumMilkTruck.gltf"); + ASSERT_NE(scene, nullptr); + + // Compute scene mesh instances. + const auto instances = draco::SceneUtils::ComputeAllInstances(*scene); + ASSERT_EQ(instances.size(), 5); + + // Check instantiation of mesh with identity transformation. + const draco::SceneUtils::MeshInstance instance = + instances[MeshInstanceIndex(3)]; + ASSERT_NE(instance.transform, Eigen::Matrix4d::Identity()); + + // Instantiate this mesh instance. + DRACO_ASSIGN_OR_ASSERT(auto mesh, + draco::SceneUtils::InstantiateMesh(*scene, instance)); + const draco::Mesh &base_mesh = scene->GetMesh(instance.mesh_index); + + // Check bounding box of the base mesh. + constexpr float tolerance = 1e-4f; + const draco::BoundingBox base_bbox = base_mesh.ComputeBoundingBox(); + EXPECT_NEAR(base_bbox.GetMinPoint()[0], -0.42780, tolerance); + EXPECT_NEAR(base_bbox.GetMinPoint()[1], -0.42780, tolerance); + EXPECT_NEAR(base_bbox.GetMinPoint()[2], -1.05800, tolerance); + EXPECT_NEAR(base_bbox.GetMaxPoint()[0], +0.42780, tolerance); + EXPECT_NEAR(base_bbox.GetMaxPoint()[1], +0.42780, tolerance); + EXPECT_NEAR(base_bbox.GetMaxPoint()[2], +1.05800, tolerance); + + // Check bounding box of the instanced mesh. It should differ. + const draco::BoundingBox instanced_bbox = mesh->ComputeBoundingBox(); + EXPECT_NEAR(instanced_bbox.GetMinPoint()[0], -1.77860, tolerance); + EXPECT_NEAR(instanced_bbox.GetMinPoint()[1], +0.00145, tolerance); + EXPECT_NEAR(instanced_bbox.GetMinPoint()[2], -1.05800, tolerance); + EXPECT_NEAR(instanced_bbox.GetMaxPoint()[0], -0.92606, tolerance); + EXPECT_NEAR(instanced_bbox.GetMaxPoint()[1], +0.85399, tolerance); + EXPECT_NEAR(instanced_bbox.GetMaxPoint()[2], +1.05800, tolerance); +} + +TEST(SceneUtilsTest, TestCleanupEmptyMeshGroup) { + auto scene = + draco::ReadSceneFromTestFile("CesiumMilkTruck/glTF/CesiumMilkTruck.gltf"); + ASSERT_NE(scene, nullptr); + ASSERT_EQ(scene->NumMeshes(), 4); + ASSERT_EQ(scene->NumMeshGroups(), 2); + ASSERT_EQ(draco::SceneUtils::ComputeAllInstances(*scene).size(), 5); + ASSERT_EQ(scene->GetNode(draco::SceneNodeIndex(0))->GetMeshGroupIndex(), + draco::MeshGroupIndex(0)); + + // Invalidate references to the three truck body parts in mesh group. + draco::MeshGroup &mesh_group = *scene->GetMeshGroup(draco::MeshGroupIndex(0)); + mesh_group.SetMeshInstance(0, {draco::kInvalidMeshIndex, 0}); + mesh_group.SetMeshInstance(1, {draco::kInvalidMeshIndex, 0}); + mesh_group.SetMeshInstance(2, {draco::kInvalidMeshIndex, 0}); + + // Cleanup scene. + draco::SceneUtils::Cleanup(scene.get()); + + // Check cleaned up scene. + ASSERT_EQ(scene->NumMeshes(), 1); + ASSERT_EQ(scene->NumMeshGroups(), 1); + ASSERT_EQ(draco::SceneUtils::ComputeAllInstances(*scene).size(), 2); + ASSERT_EQ(scene->GetNode(draco::SceneNodeIndex(0))->GetMeshGroupIndex(), + draco::kInvalidMeshGroupIndex); +} + +TEST(SceneUtilsTest, TestCleanupUnreferencedMeshGroup) { + auto scene = + draco::ReadSceneFromTestFile("CesiumMilkTruck/glTF/CesiumMilkTruck.gltf"); + ASSERT_NE(scene, nullptr); + ASSERT_EQ(scene->NumMeshes(), 4); + ASSERT_EQ(scene->NumMeshGroups(), 2); + ASSERT_EQ(draco::SceneUtils::ComputeAllInstances(*scene).size(), 5); + + // Invalidate references to truck axle mesh group. + scene->GetNode(draco::SceneNodeIndex(2)) + ->SetMeshGroupIndex(draco::kInvalidMeshGroupIndex); + scene->GetNode(draco::SceneNodeIndex(4)) + ->SetMeshGroupIndex(draco::kInvalidMeshGroupIndex); + + // Cleanup scene. + draco::SceneUtils::Cleanup(scene.get()); + + // Check cleaned up scene. + ASSERT_EQ(scene->NumMeshes(), 3); + ASSERT_EQ(scene->NumMeshGroups(), 1); + ASSERT_EQ(draco::SceneUtils::ComputeAllInstances(*scene).size(), 3); +} + +TEST(SceneUtilsTest, TestCleanupInvalidMeshIndex) { + auto scene = + draco::ReadSceneFromTestFile("CesiumMilkTruck/glTF/CesiumMilkTruck.gltf"); + ASSERT_NE(scene, nullptr); + ASSERT_EQ(scene->NumMeshes(), 4); + ASSERT_EQ(scene->NumMeshGroups(), 2); + ASSERT_EQ(draco::SceneUtils::ComputeAllInstances(*scene).size(), 5); + ASSERT_EQ(scene->GetNode(draco::SceneNodeIndex(0))->GetMeshGroupIndex(), + draco::MeshGroupIndex(0)); + + // Invalidate references to two truck body parts in mesh group. + draco::MeshGroup &mesh_group = *scene->GetMeshGroup(draco::MeshGroupIndex(0)); + ASSERT_EQ(mesh_group.NumMeshInstances(), 3); + mesh_group.SetMeshInstance(0, {draco::kInvalidMeshIndex, 0}); + mesh_group.SetMeshInstance(2, {draco::kInvalidMeshIndex, 0}); + + // Cleanup scene. + draco::SceneUtils::Cleanup(scene.get()); + + // Check cleaned up scene. + ASSERT_EQ(scene->NumMeshes(), 2); + ASSERT_EQ(scene->NumMeshGroups(), 2); + ASSERT_EQ(draco::SceneUtils::ComputeAllInstances(*scene).size(), 3); + ASSERT_EQ(scene->GetMeshGroup(draco::MeshGroupIndex(0))->NumMeshInstances(), + 1); +} + +TEST(SceneUtilsTest, TestCleanupUnusedNodes) { + auto scene = + draco::ReadSceneFromTestFile("CesiumMilkTruck/glTF/CesiumMilkTruck.gltf"); + ASSERT_NE(scene, nullptr); + ASSERT_EQ(scene->NumNodes(), 5); + + draco::SceneUtils::CleanupOptions options; + options.remove_unused_nodes = true; + + // Delete mesh on node 2 and try to remove unused nodes. + // Node 2 is connected to node 1 that has no mesh as well. But node 2 is also + // used in an animation so we don't actually expect anything to be deleted. + scene->GetNode(draco::SceneNodeIndex(2)) + ->SetMeshGroupIndex(draco::kInvalidMeshGroupIndex); + draco::SceneUtils::Cleanup(scene.get(), options); + + ASSERT_EQ(scene->NumNodes(), 5); + + // Now remove the animation channel that used the node and try it again. This + // time, we expect two nodes to be deleted (node 1 and node 2). Node 1 will be + // deleted because it doesn't contain a mesh and all its children are unused. + ASSERT_EQ(scene->GetAnimation(draco::AnimationIndex(0)) + ->GetChannel(0) + ->target_index, + 2); + // Change the mapped node to node 4 (we can't actually remove channel as of + // the time this test was written). + scene->GetAnimation(draco::AnimationIndex(0))->GetChannel(0)->target_index = + 4; + + // Cleanup again. + draco::SceneUtils::Cleanup(scene.get(), options); + ASSERT_EQ(scene->NumNodes(), 3); // Two nodes should be deleted. + + // Ensure all node indices are remapped to the new values. + for (draco::SceneNodeIndex sni(0); sni < scene->NumNodes(); ++sni) { + const auto *node = scene->GetNode(sni); + for (int i = 0; i < node->NumChildren(); ++i) { + ASSERT_LT(node->Child(i).value(), 3); + } + for (int i = 0; i < node->NumParents(); ++i) { + ASSERT_LT(node->Parent(i).value(), 3); + } + } + + // Ensure the animation channels are mapped to the updated node indices (node + // 4 should be new node 2 because two nodes were removed). + ASSERT_EQ(scene->GetAnimation(draco::AnimationIndex(0)) + ->GetChannel(0) + ->target_index, + 2); +} + +TEST(SceneUtilsTest, TestDeduplicateMeshGroups) { + // Input scene has four different mesh groups but only two of them should + // contain unique set of meshes. + auto scene = + draco::ReadSceneFromTestFile("DuplicateMeshes/duplicate_meshes.gltf"); + ASSERT_NE(scene, nullptr); + ASSERT_EQ(scene->NumMeshes(), 1); + ASSERT_EQ(scene->NumMeshGroups(), 4); + ASSERT_EQ(draco::SceneUtils::ComputeAllInstances(*scene).size(), 7); + + draco::SceneUtils::DeduplicateMeshGroups(scene.get()); + + // Check deduplicated scene. + ASSERT_EQ(scene->NumMeshes(), 1); + ASSERT_EQ(scene->NumMeshGroups(), 2); + ASSERT_EQ(draco::SceneUtils::ComputeAllInstances(*scene).size(), 7); +} + +TEST(SceneUtilsTest, TestCleanupUnusedTexCoordsNoTextures) { + // The glTF file has two tex coords that are unused because the materials do + // not reference any textures. + auto scene = draco::ReadSceneFromTestFile("UnusedTexCoords/NoTextures.gltf"); + ASSERT_NE(scene, nullptr); + ASSERT_EQ(scene->GetMesh(draco::MeshIndex(0)) + .NumNamedAttributes(draco::GeometryAttribute::TEX_COORD), + 2); + + // Cleanup scene and check that unused UV are not removed by default. + draco::SceneUtils::Cleanup(scene.get()); + ASSERT_EQ(scene->GetMesh(draco::MeshIndex(0)) + .NumNamedAttributes(draco::GeometryAttribute::TEX_COORD), + 2); + + // Cleanup scene and check that unused UV are removed when requested. + draco::SceneUtils::CleanupOptions options; + options.remove_unused_tex_coords = true; + draco::SceneUtils::Cleanup(scene.get(), options); + ASSERT_EQ(scene->GetMesh(draco::MeshIndex(0)) + .NumNamedAttributes(draco::GeometryAttribute::TEX_COORD), + 0); +} + +TEST(SceneUtilsTest, TestCleanupUnusedTexCoords0NoReferences) { + auto scene = draco::ReadSceneFromTestFile( + "UnusedTexCoords/TexCoord0InvalidTexCoord1Valid.gltf"); + ASSERT_NE(scene, nullptr); + typedef draco::GeometryAttribute Att; + + draco::Mesh &mesh = scene->GetMesh(draco::MeshIndex(0)); + ASSERT_EQ(mesh.NumNamedAttributes(Att::TEX_COORD), 2); + ASSERT_EQ(mesh.GetNamedAttribute(Att::TEX_COORD, 0)->size(), 14); + ASSERT_EQ(mesh.GetNamedAttribute(Att::TEX_COORD, 1)->size(), 4); + auto &ml = scene->GetMaterialLibrary(); + ASSERT_EQ(ml.NumMaterials(), 1); + ASSERT_EQ(ml.GetMaterial(0)->NumTextureMaps(), 1); + ASSERT_EQ(ml.GetMaterial(0)->GetTextureMapByIndex(0)->tex_coord_index(), 1); + + // Cleanup unused texture coordinate attributes. + draco::SceneUtils::CleanupOptions options; + options.remove_unused_tex_coords = true; + draco::SceneUtils::Cleanup(scene.get(), options); + + // Check that the unreferenced attribute was removed. + ASSERT_EQ(mesh.NumNamedAttributes(Att::TEX_COORD), 1); + ASSERT_EQ(mesh.GetNamedAttribute(Att::TEX_COORD, 0)->size(), 4); + ASSERT_EQ(ml.NumMaterials(), 1); + ASSERT_EQ(ml.GetMaterial(0)->NumTextureMaps(), 1); + ASSERT_EQ(ml.GetMaterial(0)->GetTextureMapByIndex(0)->tex_coord_index(), 0); +} + +TEST(SceneUtilsTest, TestCleanupUnusedTexCoords1NoReferences) { + auto scene = draco::ReadSceneFromTestFile( + "UnusedTexCoords/TexCoord0ValidTexCoord1Invalid.gltf"); + ASSERT_NE(scene, nullptr); + typedef draco::GeometryAttribute Att; + + draco::Mesh &mesh = scene->GetMesh(draco::MeshIndex(0)); + ASSERT_EQ(mesh.NumNamedAttributes(Att::TEX_COORD), 2); + ASSERT_EQ(mesh.GetNamedAttribute(Att::TEX_COORD, 0)->size(), 14); + ASSERT_EQ(mesh.GetNamedAttribute(Att::TEX_COORD, 1)->size(), 4); + auto &ml = scene->GetMaterialLibrary(); + ASSERT_EQ(ml.NumMaterials(), 1); + ASSERT_EQ(ml.GetMaterial(0)->NumTextureMaps(), 1); + ASSERT_EQ(ml.GetMaterial(0)->GetTextureMapByIndex(0)->tex_coord_index(), 0); + + // Cleanup unused texture coordinate attributes. + draco::SceneUtils::CleanupOptions options; + options.remove_unused_tex_coords = true; + draco::SceneUtils::Cleanup(scene.get(), options); + + // Check that the unreferenced attribute was removed. + ASSERT_EQ(mesh.NumNamedAttributes(Att::TEX_COORD), 1); + ASSERT_EQ(mesh.GetNamedAttribute(Att::TEX_COORD, 0)->size(), 14); + ASSERT_EQ(ml.NumMaterials(), 1); + ASSERT_EQ(ml.GetMaterial(0)->NumTextureMaps(), 1); + ASSERT_EQ(ml.GetMaterial(0)->GetTextureMapByIndex(0)->tex_coord_index(), 0); +} + +TEST(SceneUtilsTest, TestComputeGlobalNodeTransform) { + // Tests that we can compute global transformation of scene nodes. + + auto scene = draco::ReadSceneFromTestFile("simple_skin.gltf"); + ASSERT_NE(scene, nullptr); + ASSERT_EQ(scene->NumNodes(), 3); + + // Compute and check global node transforms. + constexpr float kTolerance = 1e-6; + // clang-format off + AssertMatrixNear(draco::SceneUtils::ComputeGlobalNodeTransform( + *scene, draco::SceneNodeIndex(0)), + Eigen::Matrix4d::Identity(), + kTolerance); + AssertMatrixNear(draco::SceneUtils::ComputeGlobalNodeTransform( + *scene, draco::SceneNodeIndex(1)), + Eigen::Matrix4d{{1.0, 0.0, 0.0, 0.0}, + {0.0, 1.0, 0.0, 1.0}, + {0.0, 0.0, 1.0, 0.0}, + {0.0, 0.0, 0.0, 1.0}}, + kTolerance); + AssertMatrixNear(draco::SceneUtils::ComputeGlobalNodeTransform( + *scene, draco::SceneNodeIndex(2)), + Eigen::Matrix4d{{1.0, 0.0, 0.0, 0.0}, + {0.0, 1.0, 0.0, 1.0}, + {0.0, 0.0, 1.0, 0.0}, + {0.0, 0.0, 0.0, 1.0}}, + kTolerance); + // clang-format on +} + +TEST(SceneUtilsTest, TestIsDracoCompressionEnabled) { + // Tests that we can determine whether any of the scene meshes have geometry + // compression enabled. + const std::string file = "CesiumMilkTruck/glTF/CesiumMilkTruck.gltf"; + auto scene = draco::ReadSceneFromTestFile(file); + ASSERT_NE(scene, nullptr); + ASSERT_EQ(scene->NumMeshes(), 4); + + // Check that the scene has geometry compression disabled by default. + ASSERT_FALSE(draco::SceneUtils::IsDracoCompressionEnabled(*scene)); + + // Check that geometry compression can be enabled. + scene->GetMesh(MeshIndex(2)).SetCompressionEnabled(true); + ASSERT_TRUE(draco::SceneUtils::IsDracoCompressionEnabled(*scene)); +} + +TEST(SceneUtilsTest, TestSetDracoCompressionOptions) { + // Tests that geometry compression settings can be set for all scene meshes. + const std::string file = "CesiumMilkTruck/glTF/CesiumMilkTruck.gltf"; + auto scene = draco::ReadSceneFromTestFile(file); + ASSERT_NE(scene, nullptr); + ASSERT_EQ(scene->NumMeshes(), 4); + + // Check that compression is initially disabled for all scene meshes. + ASSERT_FALSE(scene->GetMesh(MeshIndex(0)).IsCompressionEnabled()); + ASSERT_FALSE(scene->GetMesh(MeshIndex(1)).IsCompressionEnabled()); + ASSERT_FALSE(scene->GetMesh(MeshIndex(2)).IsCompressionEnabled()); + ASSERT_FALSE(scene->GetMesh(MeshIndex(3)).IsCompressionEnabled()); + + // Check that initially all scene meshes have default compression options. + draco::DracoCompressionOptions defaults; + ASSERT_EQ(scene->GetMesh(MeshIndex(0)).GetCompressionOptions(), defaults); + ASSERT_EQ(scene->GetMesh(MeshIndex(1)).GetCompressionOptions(), defaults); + ASSERT_EQ(scene->GetMesh(MeshIndex(2)).GetCompressionOptions(), defaults); + ASSERT_EQ(scene->GetMesh(MeshIndex(3)).GetCompressionOptions(), defaults); + + // Check geometry compression options can be set to all scene meshes and that + // this also enables compression for all scnene meshes. + draco::DracoCompressionOptions options; + options.compression_level = 10; + options.quantization_bits_normal = 12; + draco::SceneUtils::SetDracoCompressionOptions(&options, scene.get()); + ASSERT_TRUE(scene->GetMesh(MeshIndex(0)).IsCompressionEnabled()); + ASSERT_TRUE(scene->GetMesh(MeshIndex(1)).IsCompressionEnabled()); + ASSERT_TRUE(scene->GetMesh(MeshIndex(2)).IsCompressionEnabled()); + ASSERT_TRUE(scene->GetMesh(MeshIndex(3)).IsCompressionEnabled()); + ASSERT_EQ(scene->GetMesh(MeshIndex(0)).GetCompressionOptions(), options); + ASSERT_EQ(scene->GetMesh(MeshIndex(1)).GetCompressionOptions(), options); + ASSERT_EQ(scene->GetMesh(MeshIndex(2)).GetCompressionOptions(), options); + ASSERT_EQ(scene->GetMesh(MeshIndex(3)).GetCompressionOptions(), options); + + // Check that geometry compression can be disabled for all scene meshes. + draco::SceneUtils::SetDracoCompressionOptions(nullptr, scene.get()); + ASSERT_FALSE(scene->GetMesh(MeshIndex(0)).IsCompressionEnabled()); + ASSERT_FALSE(scene->GetMesh(MeshIndex(1)).IsCompressionEnabled()); + ASSERT_FALSE(scene->GetMesh(MeshIndex(2)).IsCompressionEnabled()); + ASSERT_FALSE(scene->GetMesh(MeshIndex(3)).IsCompressionEnabled()); +} + +TEST(SceneUtilsTest, TestFindLargestBaseMeshTransforms) { + // Tests that FindLargestBaseMeshTransforms() works as expected. + auto scene = + draco::ReadSceneFromTestFile("CubeScaledInstances/glTF/cube_att.gltf"); + ASSERT_NE(scene, nullptr); + + // There should be one base mesh with four instances. + ASSERT_EQ(scene->NumMeshes(), 1); + ASSERT_EQ(draco::SceneUtils::ComputeAllInstances(*scene).size(), 4); + + const auto transforms = + draco::SceneUtils::FindLargestBaseMeshTransforms(*scene); + + ASSERT_EQ(transforms.size(), 1); // One transform for the single base mesh. + + // The largest instance should have a uniform scale 4. + const draco::MeshIndex mi(0); + ASSERT_EQ(transforms[mi].diagonal(), Eigen::Vector4d(4, 4, 4, 1)); +} + +} // namespace + +#endif // DRACO_TRANSCODER_SUPPORTED diff --git a/contrib/draco/src/draco/scene/trs_matrix.cc b/contrib/draco/src/draco/scene/trs_matrix.cc new file mode 100644 index 000000000..6e6dac251 --- /dev/null +++ b/contrib/draco/src/draco/scene/trs_matrix.cc @@ -0,0 +1,102 @@ +// Copyright 2019 The Draco Authors. +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. +// +#include "draco/scene/trs_matrix.h" + +#ifdef DRACO_TRANSCODER_SUPPORTED + +namespace draco { + +void TrsMatrix::Copy(const TrsMatrix &tm) { + matrix_ = tm.matrix_; + translation_ = tm.translation_; + rotation_ = tm.rotation_; + scale_ = tm.scale_; + matrix_set_ = tm.matrix_set_; + translation_set_ = tm.translation_set_; + rotation_set_ = tm.rotation_set_; + scale_set_ = tm.scale_set_; +} + +Eigen::Matrix4d TrsMatrix::ComputeTransformationMatrix() const { + // Return transformation matrix if it has been set. + if (matrix_set_) { + return matrix_; + } + + // Populate translation matrix. + Eigen::Matrix4d translation_matrix = Eigen::Matrix4d::Identity(); + translation_matrix(0, 3) = translation_[0]; + translation_matrix(1, 3) = translation_[1]; + translation_matrix(2, 3) = translation_[2]; + + // Populate rotation matrix using rotation quaternion. + Eigen::Matrix3d rotation_matrix_3 = rotation_.normalized().toRotationMatrix(); + + // Convert the 3x3 matrix to a 4x4 matrix that can be multiplied with the + // other TRS matrices. + Eigen::Matrix4d rotation_matrix = Eigen::Matrix4d::Identity(); + rotation_matrix.block<3, 3>(0, 0) = rotation_matrix_3; + + // Populate scale matrix. + const Eigen::Matrix4d scale_matrix( + Eigen::Vector4d(scale_.x(), scale_.y(), scale_.z(), 1.0).asDiagonal()); + + // Return transformation matrix computed by combining TRS matrices. + return translation_matrix * rotation_matrix * scale_matrix; +} + +bool TrsMatrix::IsMatrixIdentity() const { + if (!matrix_set_) { + return true; + } + return matrix_ == Eigen::Matrix4d::Identity(); +} + +bool TrsMatrix::IsMatrixTranslationOnly() const { + if (!matrix_set_) { + return false; + } + Eigen::Matrix4d translation_check = matrix_; + translation_check(0, 3) = 0.0; + translation_check(1, 3) = 0.0; + translation_check(2, 3) = 0.0; + return translation_check == Eigen::Matrix4d::Identity(); +} + +bool TrsMatrix::operator==(const TrsMatrix &trs_matrix) const { + if (matrix_set_ != trs_matrix.matrix_set_ || + translation_set_ != trs_matrix.translation_set_ || + rotation_set_ != trs_matrix.rotation_set_ || + scale_set_ != trs_matrix.scale_set_) { + return false; + } + if (matrix_set_ && matrix_ != trs_matrix.matrix_) { + return false; + } + if (translation_set_ && translation_ != trs_matrix.translation_) { + return false; + } + if (rotation_set_ && rotation_ != trs_matrix.rotation_) { + return false; + } + if (scale_set_ && scale_set_ != trs_matrix.scale_set_) { + return false; + } + return true; +} + +} // namespace draco + +#endif // DRACO_TRANSCODER_SUPPORTED diff --git a/contrib/draco/src/draco/scene/trs_matrix.h b/contrib/draco/src/draco/scene/trs_matrix.h new file mode 100644 index 000000000..6c2ab7388 --- /dev/null +++ b/contrib/draco/src/draco/scene/trs_matrix.h @@ -0,0 +1,124 @@ +// Copyright 2019 The Draco Authors. +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. +// +#ifndef DRACO_SCENE_TRS_MATRIX_H_ +#define DRACO_SCENE_TRS_MATRIX_H_ + +#include "draco/draco_features.h" + +#ifdef DRACO_TRANSCODER_SUPPORTED +#include "Eigen/Geometry" +#include "draco/core/status_or.h" + +namespace draco { + +// This class is used to store one or more of a translation, rotation, scale +// vectors or a transformation matrix. +class TrsMatrix { + public: + TrsMatrix() + : matrix_(Eigen::Matrix4d::Identity()), + translation_(0.0, 0.0, 0.0), + rotation_(1.0, 0.0, 0.0, 0.0), // (w, x, y, z) + scale_(1.0, 1.0, 1.0), + matrix_set_(false), + translation_set_(false), + rotation_set_(false), + scale_set_(false) {} + + void Copy(const TrsMatrix &tm); + + void SetMatrix(const Eigen::Matrix4d &matrix) { + matrix_ = matrix; + matrix_set_ = true; + } + bool MatrixSet() const { return matrix_set_; } + StatusOr Matrix() const { + if (!matrix_set_) { + return Status(Status::DRACO_ERROR, "Matrix is not set."); + } + return matrix_; + } + + void SetTranslation(const Eigen::Vector3d &translation) { + translation_ = translation; + translation_set_ = true; + } + bool TranslationSet() const { return translation_set_; } + StatusOr Translation() const { + if (!translation_set_) { + return Status(Status::DRACO_ERROR, "Translation is not set."); + } + return translation_; + } + + void SetRotation(const Eigen::Quaterniond &rotation) { + rotation_ = rotation; + rotation_set_ = true; + } + bool RotationSet() const { return rotation_set_; } + StatusOr Rotation() const { + if (!rotation_set_) { + return Status(Status::DRACO_ERROR, "Rotation is not set."); + } + return rotation_; + } + + void SetScale(const Eigen::Vector3d &scale) { + scale_ = scale; + scale_set_ = true; + } + bool ScaleSet() const { return scale_set_; } + StatusOr Scale() const { + if (!scale_set_) { + return Status(Status::DRACO_ERROR, "Scale is not set."); + } + return scale_; + } + + // Returns true if the matrix is not set or if matrix is set and is equal to + // identity. + bool IsMatrixIdentity() const; + + // Returns true if matrix is set and only the translation elements may differ + // from identity. Returns false if matrix is not set. + bool IsMatrixTranslationOnly() const; + + // Returns transformation matrix if it has been set. Otherwise, computes + // transformation matrix from TRS vectors and returns it. + Eigen::Matrix4d ComputeTransformationMatrix() const; + + // Returns a boolean indicating whether any of the transforms have been set. + // Can be used to check whether this object represents a default transform. + bool TransformSet() const { + return matrix_set_ || translation_set_ || rotation_set_ || scale_set_; + } + + bool operator==(const TrsMatrix &trs_matrix) const; + + private: + Eigen::Matrix4d matrix_; + Eigen::Vector3d translation_; + Eigen::Quaterniond rotation_; + Eigen::Vector3d scale_; + bool matrix_set_; + bool translation_set_; + bool rotation_set_; + bool scale_set_; +}; + +} // namespace draco + +#endif // DRACO_TRANSCODER_SUPPORTED +#endif // DRACO_SCENE_TRS_MATRIX_H_ diff --git a/contrib/draco/src/draco/scene/trs_matrix_test.cc b/contrib/draco/src/draco/scene/trs_matrix_test.cc new file mode 100644 index 000000000..d7938e974 --- /dev/null +++ b/contrib/draco/src/draco/scene/trs_matrix_test.cc @@ -0,0 +1,79 @@ +// Copyright 2019 The Draco Authors. +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. +// +#include "draco/scene/trs_matrix.h" + +#include "draco/core/draco_test_base.h" +#include "draco/core/draco_test_utils.h" + +namespace { + +#ifdef DRACO_TRANSCODER_SUPPORTED + +TEST(TrsMatrixTest, TestIsMatrixIdentity) { + draco::TrsMatrix trs; + ASSERT_EQ(trs.MatrixSet(), false); + ASSERT_EQ(trs.IsMatrixIdentity(), true); + + // clang-format off + Eigen::Matrix4d matrix; + matrix << 1, 2, 3, 4, + 5, 6, 7, 8, + 9, 10, 11, 12, + 13, 14, 15, 16; + // clang-format on + trs.SetMatrix(matrix); + ASSERT_EQ(trs.MatrixSet(), true); + ASSERT_EQ(trs.IsMatrixIdentity(), false); + + trs.SetMatrix(Eigen::Matrix4d::Identity()); + ASSERT_EQ(trs.MatrixSet(), true); + ASSERT_EQ(trs.IsMatrixIdentity(), true); +} + +TEST(TrsMatrixTest, TestIsMatrixTranslationOnly) { + draco::TrsMatrix trs; + ASSERT_EQ(trs.MatrixSet(), false); + ASSERT_EQ(trs.IsMatrixTranslationOnly(), false); + + trs.SetMatrix(Eigen::Matrix4d::Identity()); + ASSERT_EQ(trs.MatrixSet(), true); + ASSERT_EQ(trs.IsMatrixTranslationOnly(), true); + + // clang-format off + Eigen::Matrix4d matrix; + matrix << 1, 2, 3, 4, + 5, 6, 7, 8, + 9, 10, 11, 12, + 13, 14, 15, 16; + // clang-format on + trs.SetMatrix(matrix); + ASSERT_EQ(trs.MatrixSet(), true); + ASSERT_EQ(trs.IsMatrixTranslationOnly(), false); + + // clang-format off + Eigen::Matrix4d translation; + translation << 1, 0, 0, 1, + 0, 1, 0, 2, + 0, 0, 1, 3, + 0, 0, 0, 1; + // clang-format on + trs.SetMatrix(translation); + ASSERT_EQ(trs.MatrixSet(), true); + ASSERT_EQ(trs.IsMatrixTranslationOnly(), true); +} + +#endif // DRACO_TRANSCODER_SUPPORTED + +} // namespace diff --git a/contrib/draco/src/draco/texture/source_image.cc b/contrib/draco/src/draco/texture/source_image.cc new file mode 100644 index 000000000..b4d493250 --- /dev/null +++ b/contrib/draco/src/draco/texture/source_image.cc @@ -0,0 +1,29 @@ +// Copyright 2021 The Draco Authors. +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. +// +#include "draco/texture/source_image.h" + +#ifdef DRACO_TRANSCODER_SUPPORTED + +namespace draco { + +void SourceImage::Copy(const SourceImage &src) { + mime_type_ = src.mime_type_; + filename_ = src.filename_; + encoded_data_ = src.encoded_data_; +} + +} // namespace draco + +#endif // DRACO_TRANSCODER_SUPPORTED diff --git a/contrib/draco/src/draco/texture/source_image.h b/contrib/draco/src/draco/texture/source_image.h new file mode 100644 index 000000000..5827918e4 --- /dev/null +++ b/contrib/draco/src/draco/texture/source_image.h @@ -0,0 +1,72 @@ +// Copyright 2021 The Draco Authors. +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. +// +#ifndef DRACO_TEXTURE_SOURCE_IMAGE_H_ +#define DRACO_TEXTURE_SOURCE_IMAGE_H_ + +#include "draco/draco_features.h" + +#ifdef DRACO_TRANSCODER_SUPPORTED +#include +#include +#include + +#include "draco/core/status.h" + +namespace draco { + +// This class is used to hold the encoded and decoded data and characteristics +// for an image. In order for the image to contain "valid" encoded data, either +// the |filename_| must point to a valid image file or the |mime_type_| and +// |encoded_data_| must contain valid image data. +class SourceImage { + public: + SourceImage() {} + + // No copy constructors. + SourceImage(const SourceImage &) = delete; + SourceImage &operator=(const SourceImage &) = delete; + // No move constructors. + SourceImage(SourceImage &&) = delete; + SourceImage &operator=(SourceImage &&) = delete; + + void Copy(const SourceImage &src); + + // Sets the name of the source image file. + void set_filename(const std::string &filename) { filename_ = filename; } + const std::string &filename() const { return filename_; } + + void set_mime_type(const std::string &mime_type) { mime_type_ = mime_type; } + const std::string &mime_type() const { return mime_type_; } + + std::vector &MutableEncodedData() { return encoded_data_; } + const std::vector &encoded_data() const { return encoded_data_; } + + private: + // The filename of the image. This field can be empty as long as |mime_type_| + // and |encoded_data_| is not empty. + std::string filename_; + + // The mimetype of the |encoded_data_|. + std::string mime_type_; + + // The encoded data of the image. This field can be empty as long as + // |filename_| is not empty. + std::vector encoded_data_; +}; + +} // namespace draco + +#endif // DRACO_TRANSCODER_SUPPORTED +#endif // DRACO_TEXTURE_SOURCE_IMAGE_H_ diff --git a/contrib/draco/src/draco/texture/texture.h b/contrib/draco/src/draco/texture/texture.h new file mode 100644 index 000000000..1d3b6e382 --- /dev/null +++ b/contrib/draco/src/draco/texture/texture.h @@ -0,0 +1,46 @@ +// Copyright 2021 The Draco Authors. +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. +// +#ifndef DRACO_TEXTURE_TEXTURE_H_ +#define DRACO_TEXTURE_TEXTURE_H_ + +#include "draco/draco_features.h" + +#ifdef DRACO_TRANSCODER_SUPPORTED +#include +#include + +#include "draco/io/image_compression_options.h" +#include "draco/texture/source_image.h" + +namespace draco { + +// Texture class storing the source image data. +class Texture { + public: + void Copy(Texture &other) { source_image_.Copy(other.source_image_); } + + void set_source_image(const SourceImage &image) { source_image_.Copy(image); } + const SourceImage &source_image() const { return source_image_; } + SourceImage &source_image() { return source_image_; } + + private: + // If set this is the image that this texture is based from. + SourceImage source_image_; +}; + +} // namespace draco + +#endif // DRACO_TRANSCODER_SUPPORTED +#endif // DRACO_TEXTURE_TEXTURE_H_ diff --git a/contrib/draco/src/draco/texture/texture_library.cc b/contrib/draco/src/draco/texture/texture_library.cc new file mode 100644 index 000000000..221ff28d4 --- /dev/null +++ b/contrib/draco/src/draco/texture/texture_library.cc @@ -0,0 +1,61 @@ +// Copyright 2019 The Draco Authors. +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. +// +#include "draco/texture/texture_library.h" + +#include + +#ifdef DRACO_TRANSCODER_SUPPORTED + +namespace draco { + +void TextureLibrary::Copy(const TextureLibrary &src) { + Clear(); + Append(src); +} + +void TextureLibrary::Append(const TextureLibrary &src) { + const size_t old_num_textures = textures_.size(); + textures_.resize(old_num_textures + src.textures_.size()); + for (int i = 0; i < src.textures_.size(); ++i) { + textures_[old_num_textures + i] = std::unique_ptr(new Texture()); + textures_[old_num_textures + i]->Copy(*src.textures_[i]); + } +} + +void TextureLibrary::Clear() { textures_.clear(); } + +int TextureLibrary::PushTexture(std::unique_ptr texture) { + textures_.push_back(std::move(texture)); + return textures_.size() - 1; +} + +std::unordered_map +TextureLibrary::ComputeTextureToIndexMap() const { + std::unordered_map ret; + for (int i = 0; i < textures_.size(); ++i) { + ret[textures_[i].get()] = i; + } + return ret; +} + +std::unique_ptr TextureLibrary::RemoveTexture(int index) { + std::unique_ptr ret = std::move(textures_[index]); + textures_.erase(textures_.begin() + index); + return ret; +} + +} // namespace draco + +#endif // DRACO_TRANSCODER_SUPPORTED diff --git a/contrib/draco/src/draco/texture/texture_library.h b/contrib/draco/src/draco/texture/texture_library.h new file mode 100644 index 000000000..a377d8fbc --- /dev/null +++ b/contrib/draco/src/draco/texture/texture_library.h @@ -0,0 +1,67 @@ +// Copyright 2019 The Draco Authors. +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. +// +#ifndef DRACO_TEXTURE_TEXTURE_LIBRARY_H_ +#define DRACO_TEXTURE_TEXTURE_LIBRARY_H_ + +#include "draco/draco_features.h" + +#ifdef DRACO_TRANSCODER_SUPPORTED +#include +#include +#include + +#include "draco/texture/texture.h" + +namespace draco { + +// Container class for storing draco::Texture objects in an indexed list. +class TextureLibrary { + public: + // Copies textures from the source library to this library. Order of the + // copied textures is preserved. + void Copy(const TextureLibrary &src); + + // Appends all textures from the source library to this library. All textures + // are copied over. + void Append(const TextureLibrary &src); + + // Removes all textures from the library. + void Clear(); + + // Pushes a new texture into the library. Returns an index of the newly + // inserted texture. + int PushTexture(std::unique_ptr texture); + + size_t NumTextures() const { return textures_.size(); } + + Texture *GetTexture(int index) { return textures_[index].get(); } + const Texture *GetTexture(int index) const { return textures_[index].get(); } + + // Returns a map from texture pointer to texture index for all textures. + std::unordered_map ComputeTextureToIndexMap() const; + + // Removes and returns a texture from the library. The returned texture can be + // either used by the caller or ignored in which case it would be + // automatically deleted. + std::unique_ptr RemoveTexture(int index); + + private: + std::vector> textures_; +}; + +} // namespace draco + +#endif // DRACO_TRANSCODER_SUPPORTED +#endif // DRACO_TEXTURE_TEXTURE_LIBRARY_H_ diff --git a/contrib/draco/src/draco/texture/texture_library_test.cc b/contrib/draco/src/draco/texture/texture_library_test.cc new file mode 100644 index 000000000..4d681fdd2 --- /dev/null +++ b/contrib/draco/src/draco/texture/texture_library_test.cc @@ -0,0 +1,22 @@ +// Copyright 2019 The Draco Authors. +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. +// +#include "draco/texture/texture_library.h" + +#include + +#include "draco/core/draco_test_utils.h" +#include "draco/io/texture_io.h" + +namespace {} // namespace diff --git a/contrib/draco/src/draco/texture/texture_map.cc b/contrib/draco/src/draco/texture/texture_map.cc new file mode 100644 index 000000000..459d3f600 --- /dev/null +++ b/contrib/draco/src/draco/texture/texture_map.cc @@ -0,0 +1,86 @@ +// Copyright 2021 The Draco Authors. +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. +// +#include "draco/texture/texture_map.h" + +#ifdef DRACO_TRANSCODER_SUPPORTED + +namespace draco { + +TextureMap::TextureMap() + : type_(TextureMap::GENERIC), + wrapping_mode_(CLAMP_TO_EDGE), + tex_coord_index_(-1), + min_filter_(UNSPECIFIED), + mag_filter_(UNSPECIFIED), + texture_(nullptr) {} + +void TextureMap::Copy(const TextureMap &src) { + type_ = src.type_; + wrapping_mode_ = src.wrapping_mode_; + tex_coord_index_ = src.tex_coord_index_; + min_filter_ = src.min_filter_; + mag_filter_ = src.mag_filter_; + if (src.owned_texture_ == nullptr) { + owned_texture_ = nullptr; + texture_ = src.texture_; + } else { + std::unique_ptr new_texture(new Texture()); + new_texture->Copy(*src.owned_texture_); + owned_texture_ = std::move(new_texture); + texture_ = owned_texture_.get(); + } + texture_transform_.Copy(src.texture_transform_); +} + +void TextureMap::SetProperties(Type type) { + SetProperties(type, WrappingMode(CLAMP_TO_EDGE), 0); +} + +void TextureMap::SetProperties(TextureMap::Type type, int tex_coord_index) { + SetProperties(type, WrappingMode(CLAMP_TO_EDGE), tex_coord_index); +} + +void TextureMap::SetProperties(Type type, WrappingMode wrapping_mode, + int tex_coord_index) { + SetProperties(type, wrapping_mode, tex_coord_index, UNSPECIFIED, UNSPECIFIED); +} + +void TextureMap::SetProperties(Type type, WrappingMode wrapping_mode, + int tex_coord_index, FilterType min_filter, + FilterType mag_filter) { + type_ = type; + wrapping_mode_ = wrapping_mode; + tex_coord_index_ = tex_coord_index; + min_filter_ = min_filter; + mag_filter_ = mag_filter; +} + +void TextureMap::SetTexture(std::unique_ptr texture) { + owned_texture_ = std::move(texture); + texture_ = owned_texture_.get(); +} + +void TextureMap::SetTexture(Texture *texture) { + owned_texture_ = nullptr; + texture_ = texture; +} + +void TextureMap::SetTransform(const TextureTransform &transform) { + texture_transform_.Copy(transform); +} + +} // namespace draco + +#endif // DRACO_TRANSCODER_SUPPORTED diff --git a/contrib/draco/src/draco/texture/texture_map.h b/contrib/draco/src/draco/texture/texture_map.h new file mode 100644 index 000000000..f3a95b501 --- /dev/null +++ b/contrib/draco/src/draco/texture/texture_map.h @@ -0,0 +1,175 @@ +// Copyright 2021 The Draco Authors. +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. +// +#ifndef DRACO_TEXTURE_TEXTURE_MAP_H_ +#define DRACO_TEXTURE_TEXTURE_MAP_H_ + +#include "draco/draco_features.h" + +#ifdef DRACO_TRANSCODER_SUPPORTED +#include + +#include "draco/texture/texture.h" +#include "draco/texture/texture_transform.h" + +namespace draco { + +// Class representing mapping of one texture to a mesh. A texture map +// specifies the mesh attribute that contains texture coordinates used by the +// texture. The class also defines an intended use of the texture as a so called +// mapping type (COLOR, NORMAL_TANGENT_SPACE, etc..). Mapping types are roughly +// based on GLTF 2.0 material spec that describes a metallic-roughness PBR +// material model. More details can be found here: +// https://github.com/KhronosGroup/glTF/tree/master/specification/2.0#materials +class TextureMap { + public: + enum Type { + // Generic purpose texture (not GLTF compliant). + GENERIC = 0, + // Color data with optional alpha channel for transparency (GLTF compliant). + COLOR = 1, + // Dedicated texture for storing transparency (not GLTF compliant). + OPACITY = 2, + // Dedicated texture for storing metallic property (not GLTF compliant). + METALLIC = 3, + // Dedicated texture for storing roughness property (not GLTF compliant). + ROUGHNESS = 4, + // Combined texture for storing metallic and roughness properties. + // B == metallic, G == roughness (GLTF compliant). + METALLIC_ROUGHNESS = 5, + // Normal map defined in the object space of the mesh (not GLTF compliant). + NORMAL_OBJECT_SPACE = 6, + // Normal map defined in the tangent space of the mesh (GLTF compliant). + NORMAL_TANGENT_SPACE = 7, + // Precomputed ambient occlusion on the surface (GLTF compliant). + AMBIENT_OCCLUSION = 8, + // Emissive color (GLTF compliant). + EMISSIVE = 9, + // Texture types of glTF material extension KHR_materials_sheen. + SHEEN_COLOR = 10, + SHEEN_ROUGHNESS = 11, + // Texture types of glTF material extension KHR_materials_transmission. + TRANSMISSION = 12, + // Texture types of glTF material extension KHR_materials_clearcoat. + CLEARCOAT = 13, + CLEARCOAT_ROUGHNESS = 14, + CLEARCOAT_NORMAL = 15, + // Texture types of glTF material extension KHR_materials_volume. + THICKNESS = 16, + // Texture types of glTF material extension KHR_materials_specular. + SPECULAR = 17, + SPECULAR_COLOR = 18, + // The number of texture types. + TEXTURE_TYPES_COUNT + }; + + enum AxisWrappingMode { + // Out of bounds access along a texture axis should be clamped to the + // nearest edge (default). + CLAMP_TO_EDGE = 0, + // Texture is repeated along a texture axis in a mirrored pattern. + MIRRORED_REPEAT, + // Texture is repeated along a texture axis (tiled textures). + REPEAT + }; + + struct WrappingMode { + explicit WrappingMode(AxisWrappingMode mode) : WrappingMode(mode, mode) {} + WrappingMode(AxisWrappingMode s, AxisWrappingMode t) : s(s), t(t) {} + AxisWrappingMode s; + AxisWrappingMode t; + }; + + // Filter types are roughly based on glTF 2.0 samplers spec. + // https://github.com/KhronosGroup/glTF/tree/master/specification/2.0#samplers + enum FilterType { + UNSPECIFIED = 0, + NEAREST, + LINEAR, + NEAREST_MIPMAP_NEAREST, + LINEAR_MIPMAP_NEAREST, + NEAREST_MIPMAP_LINEAR, + LINEAR_MIPMAP_LINEAR + }; + + TextureMap(); + TextureMap(TextureMap &&) = default; + + // Copies texture map data from the |src| texture map to this texture map. + void Copy(const TextureMap &src); + + // Sets the mapping information between the texture and the target mesh. + // |tex_coord_index| is the local index of the texture coordinates that is + // used to map the texture on the mesh. + void SetProperties(Type type); + void SetProperties(Type type, int tex_coord_index); + void SetProperties(Type type, WrappingMode wrapping_mode, + int tex_coord_index); + void SetProperties(Type type, WrappingMode wrapping_mode, int tex_coord_index, + FilterType min_filter, FilterType mag_filter); + + // Set texture and transfer its ownership to the TextureMap object. + // + // Note that this should not be used if this TextureMap is part of a + // MaterialLibrary. For such cases, the TextureMap's texture should refer to + // an entry in the MaterialLibrary's TextureLibrary. + void SetTexture(std::unique_ptr texture); + + // Set texture and without transferring the ownership. The caller needs to + // ensure the texture is valid during the lifetime of the TextureMap object. + void SetTexture(Texture *texture); + + void SetTransform(const TextureTransform &transform); + const TextureTransform &texture_transform() const { + return texture_transform_; + } + + const Texture *texture() const { return texture_; } + Texture *texture() { return texture_; } + Type type() const { return type_; } + WrappingMode wrapping_mode() const { return wrapping_mode_; } + int tex_coord_index() const { return tex_coord_index_; } + FilterType min_filter() const { return min_filter_; } + FilterType mag_filter() const { return mag_filter_; } + + TextureMap &operator=(TextureMap &&) = default; + + private: + Type type_; + WrappingMode wrapping_mode_; + + // Local index of the texture coordinates that is used to map the texture on + // the mesh. For example, |tex_coord_index_ == 0| would correspond to the + // first TEX_COORD attribute of the mesh. + int tex_coord_index_; + + FilterType min_filter_; + FilterType mag_filter_; + + // Used when the texture object is owned by TextureMap, otherwise set to + // nullptr. + std::unique_ptr owned_texture_; + + // Either raw pointer owned by |owned_texture_| or a pointer to a user + // specified texture in case |owned_texture_| is nullptr. + Texture *texture_; + + // Transformation values of the texture map. + TextureTransform texture_transform_; +}; + +} // namespace draco + +#endif // DRACO_TRANSCODER_SUPPORTED +#endif // DRACO_TEXTURE_TEXTURE_MAP_H_ diff --git a/contrib/draco/src/draco/texture/texture_map_test.cc b/contrib/draco/src/draco/texture/texture_map_test.cc new file mode 100644 index 000000000..e69de29bb diff --git a/contrib/draco/src/draco/texture/texture_transform.cc b/contrib/draco/src/draco/texture/texture_transform.cc new file mode 100644 index 000000000..ccb00d59f --- /dev/null +++ b/contrib/draco/src/draco/texture/texture_transform.cc @@ -0,0 +1,79 @@ +// Copyright 2021 The Draco Authors. +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. +// +#include "draco/texture/texture_transform.h" + +#ifdef DRACO_TRANSCODER_SUPPORTED + +namespace draco { + +TextureTransform::TextureTransform() { Clear(); } + +void TextureTransform::Clear() { + offset_ = TextureTransform::GetDefaultOffset(); + rotation_ = TextureTransform::GetDefaultRotation(); + scale_ = TextureTransform::GetDefaultScale(); + tex_coord_ = TextureTransform::GetDefaultTexCoord(); +} + +void TextureTransform::Copy(const TextureTransform &src) { + offset_ = src.offset_; + rotation_ = src.rotation_; + scale_ = src.scale_; + tex_coord_ = src.tex_coord_; +} + +bool TextureTransform::IsDefault(const TextureTransform &tt) { + const TextureTransform defaults; + if (tt == defaults) { + return true; + } + return false; +} + +bool TextureTransform::IsOffsetSet() const { + return offset_ != TextureTransform::GetDefaultOffset(); +} + +bool TextureTransform::IsRotationSet() const { + return rotation_ != TextureTransform::GetDefaultRotation(); +} + +bool TextureTransform::IsScaleSet() const { + return scale_ != TextureTransform::GetDefaultScale(); +} + +bool TextureTransform::IsTexCoordSet() const { + return tex_coord_ != TextureTransform::GetDefaultTexCoord(); +} + +bool TextureTransform::operator==(const TextureTransform &tt) const { + if (tex_coord_ != tt.tex_coord_) { + return false; + } + if (rotation_ != tt.rotation_) { + return false; + } + if (offset_ != tt.offset_) { + return false; + } + if (scale_ != tt.scale_) { + return false; + } + return true; +} + +} // namespace draco + +#endif // DRACO_TRANSCODER_SUPPORTED diff --git a/contrib/draco/src/draco/texture/texture_transform.h b/contrib/draco/src/draco/texture/texture_transform.h new file mode 100644 index 000000000..b2ec47f2e --- /dev/null +++ b/contrib/draco/src/draco/texture/texture_transform.h @@ -0,0 +1,75 @@ +// Copyright 2021 The Draco Authors. +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. +// +#ifndef DRACO_TEXTURE_TEXTURE_TRANSFORM_H_ +#define DRACO_TEXTURE_TEXTURE_TRANSFORM_H_ + +#include "draco/draco_features.h" + +#ifdef DRACO_TRANSCODER_SUPPORTED +#include +#include + +namespace draco { + +// Class to hold texture transformations. Parameters are based on the glTF 2.0 +// extension KHR_texture_transform: +// https://github.com/KhronosGroup/glTF/tree/master/extensions/2.0/Khronos/KHR_texture_transform +class TextureTransform { + public: + TextureTransform(); + + // Resets the values back to defaults. + void Clear(); + + // Copies texture transform data from the |src| texture transform to this + // texture transform. + void Copy(const TextureTransform &src); + + // Returns true if |tt| contains all default values. + static bool IsDefault(const TextureTransform &tt); + + bool IsOffsetSet() const; + bool IsRotationSet() const; + bool IsScaleSet() const; + bool IsTexCoordSet() const; + + void set_offset(const std::array &offset) { offset_ = offset; } + const std::array &offset() const { return offset_; } + void set_scale(const std::array &scale) { scale_ = scale; } + const std::array &scale() const { return scale_; } + + void set_rotation(double rotation) { rotation_ = rotation; } + double rotation() const { return rotation_; } + void set_tex_coord(int tex_coord) { tex_coord_ = tex_coord; } + int tex_coord() const { return tex_coord_; } + + bool operator==(const TextureTransform &tt) const; + + private: + static std::array GetDefaultOffset() { return {0.0, 0.0}; } + static float GetDefaultRotation() { return 0.0; } + static std::array GetDefaultScale() { return {0.0, 0.0}; } + static int GetDefaultTexCoord() { return -1; } + + std::array offset_; + double rotation_; + std::array scale_; + int tex_coord_; +}; + +} // namespace draco + +#endif // DRACO_TRANSCODER_SUPPORTED +#endif // DRACO_TEXTURE_TEXTURE_TRANSFORM_H_ diff --git a/contrib/draco/src/draco/texture/texture_transform_test.cc b/contrib/draco/src/draco/texture/texture_transform_test.cc new file mode 100644 index 000000000..e69de29bb diff --git a/contrib/draco/src/draco/texture/texture_utils.cc b/contrib/draco/src/draco/texture/texture_utils.cc new file mode 100644 index 000000000..7598ac780 --- /dev/null +++ b/contrib/draco/src/draco/texture/texture_utils.cc @@ -0,0 +1,144 @@ +// Copyright 2019 The Draco Authors. +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. +// +#include "draco/texture/texture_utils.h" + +#ifdef DRACO_TRANSCODER_SUPPORTED +#include +#include +#include +#include +#include +#include +#include + +namespace draco { + +std::string TextureUtils::GetTargetStem(const Texture &texture) { + // Return stem of the source image if there is one. + if (!texture.source_image().filename().empty()) { + const std::string &full_path = texture.source_image().filename(); + std::string folder_path; + std::string filename; + SplitPath(full_path, &folder_path, &filename); + return RemoveFileExtension(filename); + } + + // Return an empty stem. + return ""; +} + +std::string TextureUtils::GetOrGenerateTargetStem(const Texture &texture, + int index, + const std::string &suffix) { + // Return target stem from |texture| if there is one. + const std::string name = GetTargetStem(texture); + if (!name.empty()) { + return name; + } + + // Return target stem generated from |index| and |suffix|. + return "Texture" + std::to_string(index) + suffix; +} + +ImageFormat TextureUtils::GetTargetFormat(const Texture &texture) { + // Return format based on source image mime type. + return GetSourceFormat(texture); +} + +std::string TextureUtils::GetTargetExtension(const Texture &texture) { + return GetExtension(GetTargetFormat(texture)); +} + +ImageFormat TextureUtils::GetSourceFormat(const Texture &texture) { + // Try to get the extension based on source image mime type. + std::string extension = + LowercaseMimeTypeExtension(texture.source_image().mime_type()); + if (extension.empty() && !texture.source_image().filename().empty()) { + // Try to get the extension from the source image filename. + extension = LowercaseFileExtension(texture.source_image().filename()); + } + if (extension.empty()) { + // Default to png. + extension = "png"; + } + return GetFormat(extension); +} + +ImageFormat TextureUtils::GetFormat(const std::string &extension) { + if (extension == "png") { + return ImageFormat::PNG; + } else if (extension == "jpg" || extension == "jpeg") { + return ImageFormat::JPEG; + } else if (extension == "basis" || extension == "ktx2") { + return ImageFormat::BASIS; + } else if (extension == "webp") { + return ImageFormat::WEBP; + } + return ImageFormat::NONE; +} + +std::string TextureUtils::GetExtension(ImageFormat format) { + switch (format) { + case ImageFormat::PNG: + return "png"; + case ImageFormat::JPEG: + return "jpg"; + case ImageFormat::BASIS: + return "ktx2"; + case ImageFormat::WEBP: + return "webp"; + case ImageFormat::NONE: + default: + return ""; + } +} + +int TextureUtils::ComputeRequiredNumChannels( + const Texture &texture, const MaterialLibrary &material_library) { + // TODO(vytyaz): Consider a case where |texture| is not only used in OMR but + // also in other texture map types. + const auto mr_textures = TextureUtils::FindTextures( + TextureMap::METALLIC_ROUGHNESS, &material_library); + if (std::find(mr_textures.begin(), mr_textures.end(), &texture) == + mr_textures.end()) { + // Occlusion-only texture. + return 1; + } + // Occlusion-metallic-roughness texture. + return 3; +} + +std::vector TextureUtils::FindTextures( + const TextureMap::Type texture_type, + const MaterialLibrary *material_library) { + // Find textures with no duplicates. + std::unordered_set textures; + for (int i = 0; i < material_library->NumMaterials(); ++i) { + const TextureMap *const texture_map = + material_library->GetMaterial(i)->GetTextureMapByType(texture_type); + if (texture_map != nullptr && texture_map->texture() != nullptr) { + textures.insert(texture_map->texture()); + } + } + + // Return the textures as a vector. + std::vector result; + result.insert(result.end(), textures.begin(), textures.end()); + return result; +} + +} // namespace draco + +#endif // DRACO_TRANSCODER_SUPPORTED diff --git a/contrib/draco/src/draco/texture/texture_utils.h b/contrib/draco/src/draco/texture/texture_utils.h new file mode 100644 index 000000000..18d29950a --- /dev/null +++ b/contrib/draco/src/draco/texture/texture_utils.h @@ -0,0 +1,78 @@ +// Copyright 2019 The Draco Authors. +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. +// +#ifndef DRACO_TEXTURE_TEXTURE_UTILS_H_ +#define DRACO_TEXTURE_TEXTURE_UTILS_H_ + +#include "draco/draco_features.h" + +#ifdef DRACO_TRANSCODER_SUPPORTED +#include "draco/core/status.h" +#include "draco/core/status_or.h" +#include "draco/io/file_utils.h" +#include "draco/material/material_library.h" +#include "draco/texture/texture_library.h" +#include "draco/texture/texture_map.h" + +namespace draco { + +// Helper class implementing various utilities operating on draco::Texture. +class TextureUtils { + public: + // Returns |texture| image stem (file basename without extension) based on the + // source image filename or an empty string when source image is not set. + static std::string GetTargetStem(const Texture &texture); + + // Returns |texture| image stem (file basename without extension) based on the + // source image filename or a name generated from |index| and |suffix| like + // "Texture5_BaseColor" when source image is not set. + static std::string GetOrGenerateTargetStem(const Texture &texture, int index, + const std::string &suffix); + + // Returns |texture| format based on compression settings, the source image + // mime type or the source image filename. + static ImageFormat GetTargetFormat(const Texture &texture); + + // Returns |texture| image file extension based on compression settings, the + // source image mime type or the source image filename. + static std::string GetTargetExtension(const Texture &texture); + + // Returns |texture| format based on source image mime type or the source + // image filename. + static ImageFormat GetSourceFormat(const Texture &texture); + + // Returns image format corresponding to a given image file |extension|. NONE + // is returned when |extension| is empty or unknown. + static ImageFormat GetFormat(const std::string &extension); + + // Returns image file extension corresponding to a given image |format|. Empty + // extension is returned when the |format| is NONE. + static std::string GetExtension(ImageFormat format); + + // Returns the number of channels required for encoding a |texture| from a + // given |material_library|, taking into account texture opacity and assuming + // that occlusion and metallic-roughness texture maps may share a texture. + // TODO(vytyaz): Move this and FindTextures() to MaterialLibrary class. + static int ComputeRequiredNumChannels( + const Texture &texture, const MaterialLibrary &material_library); + + static std::vector FindTextures( + const TextureMap::Type texture_type, + const MaterialLibrary *material_library); +}; + +} // namespace draco + +#endif // DRACO_TRANSCODER_SUPPORTED +#endif // DRACO_TEXTURE_TEXTURE_UTILS_H_ diff --git a/contrib/draco/src/draco/texture/texture_utils_test.cc b/contrib/draco/src/draco/texture/texture_utils_test.cc new file mode 100644 index 000000000..45873ea7a --- /dev/null +++ b/contrib/draco/src/draco/texture/texture_utils_test.cc @@ -0,0 +1,163 @@ +// Copyright 2019 The Draco Authors. +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. +// +#include "draco/texture/texture_utils.h" + +#ifdef DRACO_TRANSCODER_SUPPORTED +#include + +#include "draco/core/draco_test_utils.h" +#include "draco/io/texture_io.h" +#include "draco/texture/color_utils.h" + +namespace { + +TEST(TextureUtilsTest, TestGetTargetNameForTextureLoadedFromFile) { + // Tests that correct target stem and format are returned by texture utils for + // texture loaded from image file (stem and format from source file). + std::unique_ptr texture = + draco::ReadTextureFromFile(draco::GetTestFileFullPath("fast.jpg")) + .value(); + ASSERT_NE(texture, nullptr); + ASSERT_EQ(draco::TextureUtils::GetTargetStem(*texture), "fast"); + ASSERT_EQ(draco::TextureUtils::GetTargetExtension(*texture), "jpg"); + ASSERT_EQ(draco::TextureUtils::GetTargetFormat(*texture), + draco::ImageFormat::JPEG); + ASSERT_EQ(draco::TextureUtils::GetOrGenerateTargetStem(*texture, 5, "_Color"), + "fast"); +} + +TEST(TextureUtilsTest, TestGetTargetNameForNewTexture) { + // Tests that correct target stem and format are returned by texture utils for + // a newly created texture (empty stem and PNG image type by default). + std::unique_ptr texture(new draco::Texture()); + ASSERT_NE(texture, nullptr); + ASSERT_EQ(draco::TextureUtils::GetTargetStem(*texture), ""); + ASSERT_EQ(draco::TextureUtils::GetOrGenerateTargetStem(*texture, 5, "_Color"), + "Texture5_Color"); + ASSERT_EQ(draco::TextureUtils::GetTargetExtension(*texture), "png"); + ASSERT_EQ(draco::TextureUtils::GetTargetFormat(*texture), + draco::ImageFormat::PNG); +} + +TEST(TextureUtilsTest, TestGetSourceFormat) { + // Tests that the source format is determined correctly for new textures and + // for textures loaded from file. + std::unique_ptr new_texture(new draco::Texture()); + DRACO_ASSIGN_OR_ASSERT( + std::unique_ptr png_texture, + draco::ReadTextureFromFile(draco::GetTestFileFullPath("test.png"))); + DRACO_ASSIGN_OR_ASSERT( + std::unique_ptr jpg_texture, + draco::ReadTextureFromFile(draco::GetTestFileFullPath("fast.jpg"))); + + // Check source formats. + ASSERT_EQ(draco::TextureUtils::GetSourceFormat(*new_texture), + draco::ImageFormat::PNG); + ASSERT_EQ(draco::TextureUtils::GetSourceFormat(*png_texture), + draco::ImageFormat::PNG); + ASSERT_EQ(draco::TextureUtils::GetSourceFormat(*jpg_texture), + draco::ImageFormat::JPEG); + + // Remove the mime-type from the jpeg texture and ensure the source format is + // still detected properly based on the filename. + jpg_texture->source_image().set_mime_type(""); + ASSERT_EQ(draco::TextureUtils::GetSourceFormat(*jpg_texture), + draco::ImageFormat::JPEG); +} + +TEST(TextureUtilsTest, TestGetFormat) { + typedef draco::ImageFormat ImageFormat; + ASSERT_EQ(draco::TextureUtils::GetFormat("png"), ImageFormat::PNG); + ASSERT_EQ(draco::TextureUtils::GetFormat("jpg"), ImageFormat::JPEG); + ASSERT_EQ(draco::TextureUtils::GetFormat("jpeg"), ImageFormat::JPEG); + ASSERT_EQ(draco::TextureUtils::GetFormat("basis"), ImageFormat::BASIS); + ASSERT_EQ(draco::TextureUtils::GetFormat("ktx2"), ImageFormat::BASIS); + ASSERT_EQ(draco::TextureUtils::GetFormat("webp"), ImageFormat::WEBP); + ASSERT_EQ(draco::TextureUtils::GetFormat(""), ImageFormat::NONE); + ASSERT_EQ(draco::TextureUtils::GetFormat("bmp"), ImageFormat::NONE); +} + +TEST(TextureUtilsTest, TestGetExtension) { + typedef draco::ImageFormat ImageFormat; + ASSERT_EQ(draco::TextureUtils::GetExtension(ImageFormat::PNG), "png"); + ASSERT_EQ(draco::TextureUtils::GetExtension(ImageFormat::JPEG), "jpg"); + ASSERT_EQ(draco::TextureUtils::GetExtension(ImageFormat::BASIS), "ktx2"); + ASSERT_EQ(draco::TextureUtils::GetExtension(ImageFormat::WEBP), "webp"); + ASSERT_EQ(draco::TextureUtils::GetExtension(ImageFormat::NONE), ""); +} + +TEST(TextureUtilsTest, TestComputeRequiredNumChannels) { + // Tests that the number of texture channels can be computed. Material library + // under test is created programmatically. + + // Load textures. + DRACO_ASSIGN_OR_ASSERT( + auto texture0, draco::ReadTextureFromFile( + draco::GetTestFileFullPath("fully_transparent.png"))); + ASSERT_NE(texture0, nullptr); + draco::Texture *texture0_ptr = texture0.get(); + DRACO_ASSIGN_OR_ASSERT( + auto texture1, + draco::ReadTextureFromFile(draco::GetTestFileFullPath("squares.png"))); + ASSERT_NE(texture1, nullptr); + const draco::Texture *texture1_ptr = texture1.get(); + DRACO_ASSIGN_OR_ASSERT( + auto texture2, draco::ReadTextureFromFile( + draco::GetTestFileFullPath("fully_transparent.png"))); + ASSERT_NE(texture2, nullptr); + const draco::Texture *texture2_ptr = texture2.get(); + + // Compute number of channels for occlusion-only texture. + draco::MaterialLibrary library; + draco::Material *const material0 = library.MutableMaterial(0); + material0->SetTextureMap(std::move(texture0), + draco::TextureMap::AMBIENT_OCCLUSION, 0); + ASSERT_EQ( + draco::TextureUtils::ComputeRequiredNumChannels(*texture0_ptr, library), + 1); + + // Compute number of channels for occlusion-only texture with MR present but + // not using the same texture. + draco::Material *const material1 = library.MutableMaterial(1); + material1->SetTextureMap(std::move(texture1), + draco::TextureMap::METALLIC_ROUGHNESS, 0); + ASSERT_EQ( + draco::TextureUtils::ComputeRequiredNumChannels(*texture0_ptr, library), + 1); + + // Compute number of channels for metallic-roughness texture. + ASSERT_EQ( + draco::TextureUtils::ComputeRequiredNumChannels(*texture1_ptr, library), + 3); + + // Compute number of channels texture that is used for occlusin map in one + // material and also shared with metallic-roughness map in another material. + draco::Material *const material2 = library.MutableMaterial(2); + DRACO_ASSERT_OK(material2->SetTextureMap( + texture0_ptr, draco::TextureMap::METALLIC_ROUGHNESS, 0)); + ASSERT_EQ( + draco::TextureUtils::ComputeRequiredNumChannels(*texture0_ptr, library), + 3); + + // Compute number of channels for non-opaque texture. + material0->SetTextureMap(std::move(texture2), draco::TextureMap::COLOR, 0); + ASSERT_EQ( + draco::TextureUtils::ComputeRequiredNumChannels(*texture2_ptr, library), + 4); +} + +} // namespace + +#endif // DRACO_TRANSCODER_SUPPORTED diff --git a/contrib/draco/src/draco/tools/draco_decoder.cc b/contrib/draco/src/draco/tools/draco_decoder.cc index 610709d62..cf5f18094 100644 --- a/contrib/draco/src/draco/tools/draco_decoder.cc +++ b/contrib/draco/src/draco/tools/draco_decoder.cc @@ -20,6 +20,7 @@ #include "draco/io/obj_encoder.h" #include "draco/io/parser_utils.h" #include "draco/io/ply_encoder.h" +#include "draco/io/stl_encoder.h" namespace { @@ -126,7 +127,6 @@ int main(int argc, char **argv) { } // Save the decoded geometry into a file. - // TODO(fgalligan): Change extension code to look for '.'. const std::string extension = draco::parser::ToLower( options.output.size() >= 4 ? options.output.substr(options.output.size() - 4) @@ -140,7 +140,7 @@ int main(int argc, char **argv) { return -1; } } else { - if (!obj_encoder.EncodeToFile(*pc.get(), options.output)) { + if (!obj_encoder.EncodeToFile(*pc, options.output)) { printf("Failed to store the decoded point cloud as OBJ.\n"); return -1; } @@ -153,13 +153,25 @@ int main(int argc, char **argv) { return -1; } } else { - if (!ply_encoder.EncodeToFile(*pc.get(), options.output)) { + if (!ply_encoder.EncodeToFile(*pc, options.output)) { printf("Failed to store the decoded point cloud as PLY.\n"); return -1; } } + } else if (extension == ".stl") { + draco::StlEncoder stl_encoder; + if (mesh) { + draco::Status s = stl_encoder.EncodeToFile(*mesh, options.output); + if (s.code() != draco::Status::OK) { + printf("Failed to store the decoded mesh as STL.\n"); + return -1; + } + } else { + printf("Can't store a point cloud as STL.\n"); + return -1; + } } else { - printf("Invalid extension of the output file. Use either .ply or .obj.\n"); + printf("Invalid output file extension. Use .obj .ply or .stl.\n"); return -1; } printf("Decoded geometry saved to %s (%" PRId64 " ms to decode)\n", diff --git a/contrib/draco/src/draco/tools/draco_encoder.cc b/contrib/draco/src/draco/tools/draco_encoder.cc index 7e3632d7d..ec639453b 100644 --- a/contrib/draco/src/draco/tools/draco_encoder.cc +++ b/contrib/draco/src/draco/tools/draco_encoder.cc @@ -15,7 +15,9 @@ #include #include +#include "draco/compression/config/compression_shared.h" #include "draco/compression/encode.h" +#include "draco/compression/expert_encode.h" #include "draco/core/cycle_timer.h" #include "draco/io/file_utils.h" #include "draco/io/mesh_io.h" @@ -35,6 +37,7 @@ struct Options { int generic_quantization_bits; bool generic_deleted; int compression_level; + bool preserve_polygons; bool use_metadata; std::string input; std::string output; @@ -50,6 +53,7 @@ Options::Options() generic_quantization_bits(8), generic_deleted(false), compression_level(7), + preserve_polygons(false), use_metadata(false) {} void Usage() { @@ -83,6 +87,11 @@ void Usage() { printf( " --metadata use metadata to encode extra information in " "mesh files.\n"); + // Mesh with polygonal faces loaded from OBJ format is converted to triangular + // mesh and polygon reconstruction information is encoded into a new generic + // attribute. + printf(" -preserve_polygons encode polygon info as an attribute.\n"); + printf( "\nUse negative quantization values to skip the specified attribute\n"); } @@ -138,12 +147,12 @@ void PrintOptions(const draco::PointCloud &pc, const Options &options) { } int EncodePointCloudToFile(const draco::PointCloud &pc, const std::string &file, - draco::Encoder *encoder) { + draco::ExpertEncoder *encoder) { draco::CycleTimer timer; // Encode the geometry. draco::EncoderBuffer buffer; timer.Start(); - const draco::Status status = encoder->EncodePointCloudToBuffer(pc, &buffer); + const draco::Status status = encoder->EncodeToBuffer(&buffer); if (!status.ok()) { printf("Failed to encode the point cloud.\n"); printf("%s\n", status.error_msg()); @@ -162,12 +171,12 @@ int EncodePointCloudToFile(const draco::PointCloud &pc, const std::string &file, } int EncodeMeshToFile(const draco::Mesh &mesh, const std::string &file, - draco::Encoder *encoder) { + draco::ExpertEncoder *encoder) { draco::CycleTimer timer; // Encode the geometry. draco::EncoderBuffer buffer; timer.Start(); - const draco::Status status = encoder->EncodeMeshToBuffer(mesh, &buffer); + const draco::Status status = encoder->EncodeToBuffer(&buffer); if (!status.ok()) { printf("Failed to encode the mesh.\n"); printf("%s\n", status.error_msg()); @@ -249,6 +258,8 @@ int main(int argc, char **argv) { ++i; } else if (!strcmp("--metadata", argv[i])) { options.use_metadata = true; + } else if (!strcmp("-preserve_polygons", argv[i])) { + options.preserve_polygons = true; } } if (argc < 3 || options.input.empty()) { @@ -259,8 +270,10 @@ int main(int argc, char **argv) { std::unique_ptr pc; draco::Mesh *mesh = nullptr; if (!options.is_point_cloud) { - auto maybe_mesh = - draco::ReadMeshFromFile(options.input, options.use_metadata); + draco::Options load_options; + load_options.SetBool("use_metadata", options.use_metadata); + load_options.SetBool("preserve_polygons", options.preserve_polygons); + auto maybe_mesh = draco::ReadMeshFromFile(options.input, load_options); if (!maybe_mesh.ok()) { printf("Failed loading the input mesh: %s.\n", maybe_mesh.status().error_msg()); @@ -350,14 +363,36 @@ int main(int argc, char **argv) { options.output = options.input + ".drc"; } - PrintOptions(*pc.get(), options); + PrintOptions(*pc, options); + + const bool input_is_mesh = mesh && mesh->num_faces() > 0; + + // Convert to ExpertEncoder that allows us to set per-attribute options. + std::unique_ptr expert_encoder; + if (input_is_mesh) { + expert_encoder.reset(new draco::ExpertEncoder(*mesh)); + } else { + expert_encoder.reset(new draco::ExpertEncoder(*pc)); + } + expert_encoder->Reset(encoder.CreateExpertEncoderOptions(*pc)); + + // Check if there is an attribute that stores polygon edges. If so, we disable + // the default prediction scheme for the attribute as it actually makes the + // compression worse. + const int poly_att_id = + pc->GetAttributeIdByMetadataEntry("name", "added_edges"); + if (poly_att_id != -1) { + expert_encoder->SetAttributePredictionScheme( + poly_att_id, draco::PredictionSchemeMethod::PREDICTION_NONE); + } int ret = -1; - const bool input_is_mesh = mesh && mesh->num_faces() > 0; - if (input_is_mesh) - ret = EncodeMeshToFile(*mesh, options.output, &encoder); - else - ret = EncodePointCloudToFile(*pc.get(), options.output, &encoder); + + if (input_is_mesh) { + ret = EncodeMeshToFile(*mesh, options.output, expert_encoder.get()); + } else { + ret = EncodePointCloudToFile(*pc, options.output, expert_encoder.get()); + } if (ret != -1 && options.compression_level < 10) { printf( diff --git a/contrib/draco/src/draco/tools/draco_transcoder.cc b/contrib/draco/src/draco/tools/draco_transcoder.cc new file mode 100644 index 000000000..ad0f27714 --- /dev/null +++ b/contrib/draco/src/draco/tools/draco_transcoder.cc @@ -0,0 +1,130 @@ +// Copyright 2019 The Draco Authors. +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. +// +#include +#include + +#include "draco/core/cycle_timer.h" +#include "draco/core/status.h" +#include "draco/draco_features.h" +#include "draco/texture/texture_utils.h" +#include "draco/tools/draco_transcoder_lib.h" + +namespace { + +// TODO(fgalligan): Add support for no compression to the transcoder lib. +void Usage() { + // TODO(b/204212351): Revisit using a raw string literal here for readability. + printf("Usage: draco_transcoder [options] -i input -o output\n\n"); + printf("Main options:\n"); + printf(" -h | -? show help.\n"); + printf(" -i input file name.\n"); + printf(" -o output file name.\n"); + printf(" -qp quantization bits for the position attribute, "); + printf("default=11.\n"); + printf(" -qt quantization bits for the texture coordinate "); + printf("attribute, default=10.\n"); + printf(" -qn quantization bits for the normal vector attribute"); + printf(", default=8.\n"); + printf(" -qc quantization bits for the color attribute, "); + printf("default=8.\n"); + printf(" -qtg quantization bits for the tangent attribute, "); + printf("default=8.\n"); + printf(" -qw quantization bits for the weight attribute, "); + printf("default=8.\n"); + printf(" -qg quantization bits for any generic attribute, "); + printf("default=8.\n"); + + printf("\nBoolean options may be negated by prefixing 'no'.\n"); +} + +int StringToInt(const std::string &s) { + char *end; + return strtol(s.c_str(), &end, 10); // NOLINT +} + +bool MatchesBooleanOption(const std::string &option, const std::string &value) { + const std::string opt = "-" + option; + const std::string noopt = "-no" + option; + return value == opt || value == noopt; +} + +draco::Status TranscodeFile( + const draco::DracoTranscoder::FileOptions &file_options, + const draco::DracoTranscodingOptions &transcode_options) { + draco::CycleTimer timer; + timer.Start(); + DRACO_ASSIGN_OR_RETURN(std::unique_ptr dt, + draco::DracoTranscoder::Create(transcode_options)); + + DRACO_RETURN_IF_ERROR(dt->Transcode(file_options)); + timer.Stop(); + printf("Transcode\t%s\t%" PRId64 "\n", file_options.input_filename.c_str(), + timer.GetInMs()); + + return draco::OkStatus(); +} + +} // anonymous namespace + +int main(int argc, char **argv) { + draco::DracoTranscoder::FileOptions file_options; + draco::DracoTranscodingOptions transcode_options; + const int argc_check = argc - 1; + + for (int i = 1; i < argc; ++i) { + if (!strcmp("-h", argv[i]) || !strcmp("-?", argv[i])) { + Usage(); + return 0; + } else if (!strcmp("-i", argv[i]) && i < argc_check) { + file_options.input_filename = argv[++i]; + } else if (!strcmp("-o", argv[i]) && i < argc_check) { + file_options.output_filename = argv[++i]; + } else if (!strcmp("-qp", argv[i]) && i < argc_check) { + transcode_options.geometry.quantization_position.SetQuantizationBits( + StringToInt(argv[++i])); + } else if (!strcmp("-qt", argv[i]) && i < argc_check) { + transcode_options.geometry.quantization_bits_tex_coord = + StringToInt(argv[++i]); + } else if (!strcmp("-qn", argv[i]) && i < argc_check) { + transcode_options.geometry.quantization_bits_normal = + StringToInt(argv[++i]); + } else if (!strcmp("-qc", argv[i]) && i < argc_check) { + transcode_options.geometry.quantization_bits_color = + StringToInt(argv[++i]); + } else if (!strcmp("-qtg", argv[i]) && i < argc_check) { + transcode_options.geometry.quantization_bits_tangent = + StringToInt(argv[++i]); + } else if (!strcmp("-qw", argv[i]) && i < argc_check) { + transcode_options.geometry.quantization_bits_weight = + StringToInt(argv[++i]); + } else if (!strcmp("-qg", argv[i]) && i < argc_check) { + transcode_options.geometry.quantization_bits_generic = + StringToInt(argv[++i]); + } + } + if (argc < 3 || file_options.input_filename.empty() || + file_options.output_filename.empty()) { + Usage(); + return -1; + } + + const draco::Status status = TranscodeFile(file_options, transcode_options); + if (!status.ok()) { + printf("Failed\t%s\t%s\n", file_options.input_filename.c_str(), + status.error_msg()); + return -1; + } + return 0; +} diff --git a/contrib/draco/src/draco/tools/draco_transcoder_lib.cc b/contrib/draco/src/draco/tools/draco_transcoder_lib.cc new file mode 100644 index 000000000..b0bc43843 --- /dev/null +++ b/contrib/draco/src/draco/tools/draco_transcoder_lib.cc @@ -0,0 +1,86 @@ +// Copyright 2021 The Draco Authors. +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. +// +#include "draco/tools/draco_transcoder_lib.h" + +#ifdef DRACO_TRANSCODER_SUPPORTED +#include "draco/core/status_or.h" +#include "draco/io/file_utils.h" +#include "draco/io/scene_io.h" +#include "draco/scene/scene_utils.h" +#include "draco/texture/texture_utils.h" + +namespace draco { + +DracoTranscoder::DracoTranscoder() {} + +StatusOr> DracoTranscoder::Create( + const DracoTranscodingOptions &options) { + DRACO_RETURN_IF_ERROR(options.geometry.Check()); + std::unique_ptr dt(new DracoTranscoder()); + dt->transcoding_options_ = options; + return dt; +} + +StatusOr> DracoTranscoder::Create( + const DracoCompressionOptions &options) { + DracoTranscodingOptions new_options; + new_options.geometry = options; + return Create(new_options); +} + +Status DracoTranscoder::Transcode(const FileOptions &file_options) { + DRACO_RETURN_IF_ERROR(ReadScene(file_options)); + DRACO_RETURN_IF_ERROR(CompressScene()); + DRACO_RETURN_IF_ERROR(WriteScene(file_options)); + return OkStatus(); +} + +Status DracoTranscoder::ReadScene(const FileOptions &file_options) { + if (file_options.input_filename.empty()) { + return Status(Status::DRACO_ERROR, "Input filename is empty."); + } else if (file_options.output_filename.empty()) { + return Status(Status::DRACO_ERROR, "Output filename is empty."); + } + DRACO_ASSIGN_OR_RETURN(scene_, + ReadSceneFromFile(file_options.input_filename)); + return OkStatus(); +} + +Status DracoTranscoder::WriteScene(const FileOptions &file_options) { + if (!file_options.output_bin_filename.empty() && + !file_options.output_resource_directory.empty()) { + DRACO_RETURN_IF_ERROR(gltf_encoder_.EncodeFile( + *scene_, file_options.output_filename, file_options.output_bin_filename, + file_options.output_resource_directory)); + } else if (!file_options.output_bin_filename.empty()) { + DRACO_RETURN_IF_ERROR( + gltf_encoder_.EncodeFile(*scene_, file_options.output_filename, + file_options.output_bin_filename)); + } else { + DRACO_RETURN_IF_ERROR( + gltf_encoder_.EncodeFile(*scene_, file_options.output_filename)); + } + return OkStatus(); +} + +Status DracoTranscoder::CompressScene() { + // Apply geometry compression settings to all scene meshes. + SceneUtils::SetDracoCompressionOptions(&transcoding_options_.geometry, + scene_.get()); + return OkStatus(); +} + +} // namespace draco +#endif // DRACO_TRANSCODER_SUPPORTED diff --git a/contrib/draco/src/draco/tools/draco_transcoder_lib.h b/contrib/draco/src/draco/tools/draco_transcoder_lib.h new file mode 100644 index 000000000..c94d19de7 --- /dev/null +++ b/contrib/draco/src/draco/tools/draco_transcoder_lib.h @@ -0,0 +1,103 @@ +// Copyright 2021 The Draco Authors. +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. +// +#ifndef DRACO_TOOLS_DRACO_TRANSCODER_LIB_H_ +#define DRACO_TOOLS_DRACO_TRANSCODER_LIB_H_ + +#include "draco/draco_features.h" + +#ifdef DRACO_TRANSCODER_SUPPORTED +#include + +#include "draco/compression/draco_compression_options.h" +#include "draco/core/options.h" +#include "draco/io/gltf_encoder.h" +#include "draco/io/image_compression_options.h" + +namespace draco { + +// Struct to hold Draco transcoding options. +struct DracoTranscodingOptions { + DracoTranscodingOptions() {} + + // Options used when geometry compression optimization is disabled. + DracoCompressionOptions geometry; +}; + +// Class that supports input of glTF (and some simple USD) files, encodes +// them with Draco compression, and outputs glTF Draco compressed files. +// +// glTF supported extensions: +// Input and Output: +// KHR_draco_mesh_compression. http://shortn/_L5tPQqdwWf +// KHR_materials_unlit. http://shortn/_3eaDLoIGam +// KHR_texture_transform. http://shortn/_PORWgVTEe8 +// +// glTF unsupported features: +// Input and Output: +// Morph targets. http://shortn/_zE5DLw8a9B +// Sparse accessors. http://shortn/_h3FwbzQl4f +// KHR_lights_punctual. http://shortn/_nzGk80wKtK +// KHR_materials_pbrSpecularGlossiness. http://shortn/_iz0VC6dIKe +// All vendor extensions. +class DracoTranscoder { + public: + struct FileOptions { + std::string input_filename; // Must be non-empty. + std::string output_filename; // Must be non-empty. + std::string output_bin_filename = ""; + std::string output_resource_directory = ""; + }; + + DracoTranscoder(); + + // Creates a DracoTranscoder object. |options| sets the compression options + // used in the Encode function. + static StatusOr> Create( + const DracoTranscodingOptions &options); + + // Deprecated. + // TODO(fgalligan): Remove when function is not being used anymore. + static StatusOr> Create( + const DracoCompressionOptions &options); + + // Encodes the input with Draco compression using the compression options + // passed in the Create function. The recommended use case is to create a + // transcoder once and call Transcode for multiple files. + Status Transcode(const FileOptions &file_options); + + private: + // Read scene from file. + Status ReadScene(const FileOptions &file_options); + + // Write scene to file. + Status WriteScene(const FileOptions &file_options); + + // Apply compression settings to the scene. + Status CompressScene(); + + private: + GltfEncoder gltf_encoder_; + + // The scene being transcoded. + std::unique_ptr scene_; + + // Copy of the transcoding options passed into the Create function. + DracoTranscodingOptions transcoding_options_; +}; + +} // namespace draco + +#endif // DRACO_TRANSCODER_SUPPORTED +#endif // DRACO_TOOLS_DRACO_TRANSCODER_LIB_H_ diff --git a/contrib/draco/src/draco/tools/draco_transcoder_lib_test.cc b/contrib/draco/src/draco/tools/draco_transcoder_lib_test.cc new file mode 100644 index 000000000..a87a158e0 --- /dev/null +++ b/contrib/draco/src/draco/tools/draco_transcoder_lib_test.cc @@ -0,0 +1,172 @@ +// Copyright 2021 The Draco Authors. +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. +// +#ifdef DRACO_TRANSCODER_SUPPORTED + +#include "draco/tools/draco_transcoder_lib.h" + +#include "draco/core/draco_test_base.h" +#include "draco/core/draco_test_utils.h" +#include "draco/io/file_utils.h" + +// Tests encoding a .gltf file with default Draco compression. +TEST(DracoTranscoderTest, DefaultDracoCompression) { + const std::string input_name = "sphere.gltf"; + const std::string input_filename = draco::GetTestFileFullPath(input_name); + const std::string output_filename = + draco::GetTestTempFileFullPath("test.gltf"); + + const draco::DracoTranscodingOptions options; + DRACO_ASSIGN_OR_ASSERT(std::unique_ptr dt, + draco::DracoTranscoder::Create(options)); + + draco::DracoTranscoder::FileOptions file_options; + file_options.input_filename = input_filename; + file_options.output_filename = output_filename; + DRACO_ASSERT_OK(dt->Transcode(file_options)); + + const std::string output_bin_filename = + draco::GetTestTempFileFullPath("test.bin"); + const size_t output_bin_size = draco::GetFileSize(output_bin_filename); + ASSERT_GT(output_bin_size, 0); +} + +// Tests setting the output glTF .bin name. +TEST(DracoTranscoderTest, TestBinName) { + const std::string input_name = "sphere.gltf"; + const std::string input_filename = draco::GetTestFileFullPath(input_name); + const std::string output_filename = + draco::GetTestTempFileFullPath("test.gltf"); + const std::string output_bin_filename = + draco::GetTestTempFileFullPath("different_name.bin"); + + const draco::DracoTranscodingOptions options; + DRACO_ASSIGN_OR_ASSERT(std::unique_ptr dt, + draco::DracoTranscoder::Create(options)); + + draco::DracoTranscoder::FileOptions file_options; + file_options.input_filename = input_filename; + file_options.output_filename = output_filename; + file_options.output_bin_filename = output_bin_filename; + DRACO_ASSERT_OK(dt->Transcode(file_options)); + + const size_t output_bin_size = draco::GetFileSize(output_bin_filename); + ASSERT_GT(output_bin_size, 0); +} + +// Tests setting the output glTF resource directory. +TEST(DracoTranscoderTest, TestResourceDirName) { + const std::string input_name = "sphere.gltf"; + const std::string input_filename = draco::GetTestFileFullPath(input_name); + const std::string output_filename = + draco::GetTestTempFileFullPath("test.gltf"); + const std::string output_bin_filename = + draco::GetTestTempFileFullPath("another_name.bin"); + const std::string output_resource_directory = + draco::GetTestTempFileFullPath("res/other_files"); + + const draco::DracoTranscodingOptions options; + DRACO_ASSIGN_OR_ASSERT(std::unique_ptr dt, + draco::DracoTranscoder::Create(options)); + + draco::DracoTranscoder::FileOptions file_options; + file_options.input_filename = input_filename; + file_options.output_filename = output_filename; + file_options.output_bin_filename = output_bin_filename; + file_options.output_resource_directory = output_resource_directory; + DRACO_ASSERT_OK(dt->Transcode(file_options)); + + const size_t output_bin_size = draco::GetFileSize(output_bin_filename); + ASSERT_GT(output_bin_size, 0); + + const std::string res_dir_png_filename = draco::GetTestTempFileFullPath( + "res/other_files/sphere_Texture0_Normal.png"); + const size_t output_png_size = draco::GetFileSize(res_dir_png_filename); + ASSERT_GT(output_png_size, 0); +} + +// Tests creating one transcoder to encode multiple files. +TEST(DracoTranscoderTest, EncodeMultipleFiles) { + const draco::DracoTranscodingOptions options; + DRACO_ASSIGN_OR_ASSERT(std::unique_ptr dt, + draco::DracoTranscoder::Create(options)); + + draco::DracoTranscoder::FileOptions file_options; + file_options.input_filename = draco::GetTestFileFullPath("sphere.gltf"); + file_options.output_filename = draco::GetTestTempFileFullPath("first.gltf"); + DRACO_ASSERT_OK(dt->Transcode(file_options)); + const size_t first_bin_size = + draco::GetFileSize(draco::GetTestTempFileFullPath("first.bin")); + ASSERT_GT(first_bin_size, 0); + + file_options.input_filename = + draco::GetTestFileFullPath("CesiumMan/glTF/CesiumMan.gltf"); + file_options.output_filename = draco::GetTestTempFileFullPath("second.gltf"); + DRACO_ASSERT_OK(dt->Transcode(file_options)); + const size_t second_bin_size = + draco::GetFileSize(draco::GetTestTempFileFullPath("second.bin")); + ASSERT_GT(second_bin_size, 0); +} + +// Tests using glTF binary as input. +TEST(DracoTranscoderTest, SimpleGlbInput) { + const std::string input_name = "Box/glTF_Binary/Box.glb"; + const std::string input_filename = draco::GetTestFileFullPath(input_name); + const std::string output_filename = + draco::GetTestTempFileFullPath("test.gltf"); + + const draco::DracoTranscodingOptions options; + DRACO_ASSIGN_OR_ASSERT(std::unique_ptr dt, + draco::DracoTranscoder::Create(options)); + + draco::DracoTranscoder::FileOptions file_options; + file_options.input_filename = input_filename; + file_options.output_filename = output_filename; + DRACO_ASSERT_OK(dt->Transcode(file_options)); + + const std::string output_bin_filename = + draco::GetTestTempFileFullPath("test.bin"); + const size_t output_bin_size = draco::GetFileSize(output_bin_filename); + ASSERT_GT(output_bin_size, 0); +} + +// Simple test to check glb input and setting smaller position quantizations +// outputs a smaller file overall. +TEST(DracoTranscoderTest, TestPositionQuantization) { + const std::string input_name = + "KhronosSampleModels/Duck/glTF_Binary/Duck.glb"; + const std::string input_filename = draco::GetTestFileFullPath(input_name); + + draco::DracoTranscodingOptions options; + DRACO_ASSIGN_OR_ASSERT(std::unique_ptr dt, + draco::DracoTranscoder::Create(options)); + + draco::DracoTranscoder::FileOptions file_options; + file_options.input_filename = input_filename; + file_options.output_filename = draco::GetTestTempFileFullPath("first.glb"); + DRACO_ASSERT_OK(dt->Transcode(file_options)); + const size_t first_glb_size = + draco::GetFileSize(draco::GetTestTempFileFullPath("first.glb")); + + options.geometry.quantization_position.SetQuantizationBits(10); + DRACO_ASSIGN_OR_ASSERT(std::unique_ptr dt2, + draco::DracoTranscoder::Create(options)); + file_options.output_filename = draco::GetTestTempFileFullPath("second.glb"); + DRACO_ASSERT_OK(dt2->Transcode(file_options)); + const size_t second_glb_size = + draco::GetFileSize(draco::GetTestTempFileFullPath("second.glb")); + ASSERT_GT(first_glb_size, second_glb_size); +} + +#endif // DRACO_TRANSCODER_SUPPORTED diff --git a/contrib/draco/src/draco/tools/fuzz/build.sh b/contrib/draco/src/draco/tools/fuzz/build.sh index bbeb10591..3e48409fc 100644 --- a/contrib/draco/src/draco/tools/fuzz/build.sh +++ b/contrib/draco/src/draco/tools/fuzz/build.sh @@ -19,7 +19,7 @@ cmake $SRC/draco # The draco_decoder and draco_encoder binaries don't build nicely with OSS-Fuzz # options, so just build the Draco shared libraries. -make -j$(nproc) draco +make -j$(nproc) # build fuzzers for fuzzer in $(find $SRC/draco/src/draco/tools/fuzz -name '*.cc'); do diff --git a/contrib/draco/src/draco/tools/install_test/CMakeLists.txt b/contrib/draco/src/draco/tools/install_test/CMakeLists.txt new file mode 100644 index 000000000..800dc9c9b --- /dev/null +++ b/contrib/draco/src/draco/tools/install_test/CMakeLists.txt @@ -0,0 +1,25 @@ +# Copyright 2022 The Draco Authors +# +# Licensed under the Apache License, Version 2.0 (the "License"); you may not +# use this file except in compliance with the License. You may obtain a copy of +# the License at +# +# http://www.apache.org/licenses/LICENSE-2.0 +# +# Unless required by applicable law or agreed to in writing, software +# distributed under the License is distributed on an "AS IS" BASIS, WITHOUT +# WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the +# License for the specific language governing permissions and limitations under +# the License. + +cmake_minimum_required(VERSION 3.12) +project(install_test C CXX) + +include(GNUInstallDirs) + +find_package(draco REQUIRED CONFIG) + +add_executable(install_check main.cc) +target_link_libraries(install_check PRIVATE draco::draco) + +install(TARGETS install_check DESTINATION ${CMAKE_INSTALL_BINDIR}) diff --git a/contrib/draco/src/draco/tools/install_test/main.cc b/contrib/draco/src/draco/tools/install_test/main.cc new file mode 100644 index 000000000..e76793b64 --- /dev/null +++ b/contrib/draco/src/draco/tools/install_test/main.cc @@ -0,0 +1,44 @@ +// Copyright 2022 The Draco Authors. +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. +// + +// This program is used to test the installed version of Draco. It does just +// enough to confirm that an application using Draco can compile and link +// against an installed version of Draco without errors. It does not perform +// any sort of library tests. + +#include +#include + +#include "draco/core/decoder_buffer.h" + +#if defined DRACO_TRANSCODER_SUPPORTED +#include "draco/scene/scene.h" +#include "draco/scene/scene_utils.h" +#endif + +int main(int /*argc*/, char** /*argv*/) { + std::vector empty_buffer; + draco::DecoderBuffer buffer; + buffer.Init(empty_buffer.data(), empty_buffer.size()); + +#if defined DRACO_TRANSCODER_SUPPORTED + draco::Scene empty_scene; + const int num_meshes = empty_scene.NumMeshes(); + (void)num_meshes; +#endif + + printf("Partial sanity test passed.\n"); + return 0; +} diff --git a/contrib/draco/src/draco/tools/install_test/test.py b/contrib/draco/src/draco/tools/install_test/test.py new file mode 100644 index 000000000..8612e70b5 --- /dev/null +++ b/contrib/draco/src/draco/tools/install_test/test.py @@ -0,0 +1,456 @@ +#!/usr/bin/python3 +# +# Copyright 2022 The Draco Authors +# +# Licensed under the Apache License, Version 2.0 (the "License"); +# you may not use this file except in compliance with the License. +# You may obtain a copy of the License at +# +# http://www.apache.org/licenses/LICENSE-2.0 +# +# Unless required by applicable law or agreed to in writing, software +# distributed under the License is distributed on an "AS IS" BASIS, +# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +# See the License for the specific language governing permissions and +# limitations under the License. +"""Tests installations of the Draco library. + +Builds the library in shared and static configurations on the current host +system, and then confirms that a simple test application can link in both +configurations. +""" + +import argparse +import multiprocessing +import os +import pathlib +import shlex +import shutil +import subprocess +import sys + +# CMake executable. +CMAKE = shutil.which('cmake') + +# List of generators available in the current CMake executable. +CMAKE_AVAILABLE_GENERATORS = [] + +# List of variable defs to be passed through to CMake via its -D argument. +CMAKE_DEFINES = [] + +# CMake builds use the specified generator. +CMAKE_GENERATOR = None + +# Enable the transcoder before running tests (sets DRACO_TRANSCODER_SUPPORTED +# and builds transcoder support dependencies). +ENABLE_TRANSCODER = False + +# The Draco tree that this script uses. +DRACO_SOURCES_PATH = os.path.abspath(os.path.join('..', '..', '..', '..')) + +# Path to this script and the rest of the test project files. +TEST_SOURCES_PATH = os.path.dirname(os.path.abspath(__file__)) + +# The Draco build directories. +DRACO_SHARED_BUILD_PATH = os.path.join(TEST_SOURCES_PATH, '_draco_build_shared') +DRACO_STATIC_BUILD_PATH = os.path.join(TEST_SOURCES_PATH, '_draco_build_static') + +# The Draco install roots. +DRACO_SHARED_INSTALL_PATH = os.path.join(TEST_SOURCES_PATH, + '_draco_install_shared') +DRACO_STATIC_INSTALL_PATH = os.path.join(TEST_SOURCES_PATH, + '_draco_install_static') + +DRACO_SHARED_INSTALL_BIN_PATH = os.path.join(DRACO_SHARED_INSTALL_PATH, 'bin') + +DRACO_SHARED_INSTALL_LIB_PATH = os.path.join(DRACO_SHARED_INSTALL_PATH, 'lib') + +# Argument for -j when using make, or -m when using Visual Studio. Number of +# build jobs. +NUM_PROCESSES = multiprocessing.cpu_count() - 1 + +# The test project build directories. +TEST_SHARED_BUILD_PATH = os.path.join(TEST_SOURCES_PATH, '_test_build_shared') +TEST_STATIC_BUILD_PATH = os.path.join(TEST_SOURCES_PATH, '_test_build_static') + +# The test project install directories. +TEST_SHARED_INSTALL_PATH = os.path.join(TEST_SOURCES_PATH, + '_test_install_shared') +TEST_STATIC_INSTALL_PATH = os.path.join(TEST_SOURCES_PATH, + '_test_install_static') + +# Show configuration and build output. +VERBOSE = False + + +def cmake_get_available_generators(): + """Returns list of generators available in current CMake executable.""" + result = run_process_and_capture_output(f'{CMAKE} --help') + + if result[0] != 0: + raise Exception(f'cmake --help failed, exit code: {result[0]}\n{result[1]}') + + help_text = result[1].splitlines() + generators_start_index = help_text.index('Generators') + 3 + generators_text = help_text[generators_start_index::] + + generators = [] + for gen in generators_text: + gen = gen.split('=')[0].strip().replace('* ', '') + + if gen and gen[0] != '=': + generators.append(gen) + + return generators + + +def cmake_get_generator(): + """Returns the CMake generator from CMakeCache.txt in the current dir.""" + cmake_cache_file_path = os.path.join(os.getcwd(), 'CMakeCache.txt') + cmake_cache_text = '' + with open(cmake_cache_file_path, 'r') as cmake_cache_file: + cmake_cache_text = cmake_cache_file.read() + + if not cmake_cache_text: + raise FileNotFoundError(f'{cmake_cache_file_path} missing or empty.') + + generator = '' + for line in cmake_cache_text.splitlines(): + if line.startswith('CMAKE_GENERATOR:INTERNAL='): + generator = line.split('=')[1] + + return generator + + +def run_process_and_capture_output(cmd, env=None): + """Runs |cmd| as a child process. + + Returns process exit code and output. Streams process output to stdout when + VERBOSE is true. + + Args: + cmd: String containing the command to execute. + env: Optional dict of environment variables. + + Returns: + Tuple of exit code and output. + """ + if not cmd: + raise ValueError('run_process_and_capture_output requires cmd argument.') + + if os.name == 'posix': + # On posix systems subprocess.Popen will treat |cmd| as the program name + # when it is passed as a string. Unconditionally split the command so + # callers don't need to care about this detail. + cmd = shlex.split(cmd) + + proc = subprocess.Popen( + cmd, stdout=subprocess.PIPE, stderr=subprocess.STDOUT, env=env) + + if VERBOSE: + print('COMMAND output:') + + stdout = '' + for line in iter(proc.stdout.readline, b''): + decoded_line = line.decode('utf-8') + if VERBOSE: + sys.stdout.write(decoded_line) + sys.stdout.flush() + stdout += decoded_line + + # Wait for the process to exit so that the exit code is available. + proc.wait() + return [proc.returncode, stdout] + + +def create_output_directories(): + """Creates the build output directores for the test.""" + pathlib.Path(DRACO_SHARED_BUILD_PATH).mkdir(parents=True, exist_ok=True) + pathlib.Path(DRACO_STATIC_BUILD_PATH).mkdir(parents=True, exist_ok=True) + pathlib.Path(TEST_SHARED_BUILD_PATH).mkdir(parents=True, exist_ok=True) + pathlib.Path(TEST_STATIC_BUILD_PATH).mkdir(parents=True, exist_ok=True) + + +def cleanup(): + """Removes the build output directories from the test.""" + shutil.rmtree(DRACO_SHARED_BUILD_PATH) + shutil.rmtree(DRACO_STATIC_BUILD_PATH) + shutil.rmtree(DRACO_SHARED_INSTALL_PATH) + shutil.rmtree(DRACO_STATIC_INSTALL_PATH) + shutil.rmtree(TEST_SHARED_BUILD_PATH) + shutil.rmtree(TEST_STATIC_BUILD_PATH) + shutil.rmtree(TEST_SHARED_INSTALL_PATH) + shutil.rmtree(TEST_STATIC_INSTALL_PATH) + + +def cmake_configure(source_path, cmake_args=None): + """Configures a CMake build.""" + command = f'{CMAKE} {source_path}' + + if CMAKE_GENERATOR: + if ' ' in CMAKE_GENERATOR: + command += f' -G "{CMAKE_GENERATOR}"' + else: + command += f' -G {CMAKE_GENERATOR}' + + if cmake_args: + for arg in cmake_args: + command += f' {arg}' + + if CMAKE_DEFINES: + for arg in CMAKE_DEFINES: + command += f' -D{arg}' + + if VERBOSE: + print(f'CONFIGURE command:\n{command}') + + result = run_process_and_capture_output(command) + + if result[0] != 0: + raise Exception(f'CONFIGURE failed!\nexit_code: {result[0]}\n{result[1]}') + + +def cmake_build(cmake_args=None, build_args=None): + """Runs a CMake build.""" + command = f'{CMAKE} --build .' + + if cmake_args: + for arg in cmake_args: + command += f' {arg}' + + if not build_args: + build_args = [] + + generator = cmake_get_generator() + if generator.endswith('Makefiles'): + build_args.append(f'-j {NUM_PROCESSES}') + elif generator.startswith('Visual'): + build_args.append(f'-m:{NUM_PROCESSES}') + + if build_args: + command += ' --' + for arg in build_args: + command += f' {arg}' + + if VERBOSE: + print(f'BUILD command:\n{command}') + + result = run_process_and_capture_output(f'{command}') + + if result[0] != 0: + raise Exception(f'BUILD failed!\nexit_code: {result[0]}\n{result[1]}') + + +def run_install_check(install_path): + """Runs the install_check program.""" + cmd = os.path.join(install_path, 'bin', 'install_check') + if VERBOSE: + print(f'RUN command: {cmd}') + + result = run_process_and_capture_output( + cmd, + # On Windows, add location of draco.dll into PATH env var + {'PATH': DRACO_SHARED_INSTALL_BIN_PATH + os.pathsep + os.environ['PATH']}, + ) + if result[0] != 0: + raise Exception( + f'install_check run failed!\nexit_code: {result[0]}\n{result[1]}') + + +def build_and_install_transcoder_dependencies(): + """Builds and installs Draco dependencies for transcoder enabled builds.""" + orig_dir = os.getcwd() + + # The Eigen CMake build in the release Draco has pinned is, to put it mildly, + # user unfriendly. Instead of wasting time trying to integrate it here, just + # shutil.copytree() everything in $eigen_submodule_path to + # $CMAKE_INSTALL_PREFIX/include/Eigen. + # Eigen claims to be header-only, so this should be adequate for Draco's + # needs here. + eigen_submodule_path = os.path.join( + DRACO_SOURCES_PATH, 'third_party', 'eigen', 'Eigen') + + # "Install" Eigen for the shared install root. + eigen_install_path = os.path.join( + DRACO_SHARED_INSTALL_PATH, 'include', 'Eigen') + shutil.copytree(src=eigen_submodule_path, dst=eigen_install_path) + + # "Install" Eigen for the static install root. + eigen_install_path = os.path.join( + DRACO_STATIC_INSTALL_PATH, 'include', 'Eigen') + shutil.copytree(src=eigen_submodule_path, dst=eigen_install_path) + + # Build and install gulrak/filesystem for shared and static configurations. + # Note that this is basically running gulrak/filesystem's CMake build as an + # install script. + fs_submodule_path = os.path.join( + DRACO_SOURCES_PATH, 'third_party', 'filesystem') + + # Install gulrak/filesystem in the shared draco install root. + fs_shared_build = os.path.join(DRACO_SHARED_BUILD_PATH, '_fs') + pathlib.Path(fs_shared_build).mkdir(parents=True, exist_ok=True) + os.chdir(fs_shared_build) + cmake_args = [] + cmake_args.append(f'-DCMAKE_INSTALL_PREFIX={DRACO_SHARED_INSTALL_PATH}') + cmake_args.append('-DBUILD_SHARED_LIBS=ON') + cmake_args.append('-DGHC_FILESYSTEM_BUILD_TESTING=OFF') + cmake_args.append('-DGHC_FILESYSTEM_BUILD_EXAMPLES=OFF') + cmake_configure(source_path=fs_submodule_path, cmake_args=cmake_args) + cmake_build(cmake_args=['--target install']) + + # Install gulrak/filesystem in the shared draco install root. + fs_static_build = os.path.join(DRACO_STATIC_BUILD_PATH, '_fs') + pathlib.Path(fs_static_build).mkdir(parents=True, exist_ok=True) + os.chdir(fs_static_build) + cmake_args = [] + cmake_args.append(f'-DCMAKE_INSTALL_PREFIX={DRACO_SHARED_INSTALL_PATH}') + cmake_args.append('-DBUILD_SHARED_LIBS=OFF') + cmake_args.append('-DGHC_FILESYSTEM_BUILD_TESTING=OFF') + cmake_args.append('-DGHC_FILESYSTEM_BUILD_EXAMPLES=OFF') + cmake_configure(source_path=fs_submodule_path, cmake_args=cmake_args) + cmake_build(cmake_args=['--target install']) + + # Build and install TinyGLTF for shared and static configurations. + # Note, as above, that this is basically running TinyGLTF's CMake build as an + # install script. + tinygltf_submodule_path = os.path.join( + DRACO_SOURCES_PATH, 'third_party', 'tinygltf') + + # Install TinyGLTF in the shared draco install root. + tinygltf_shared_build = os.path.join(DRACO_SHARED_BUILD_PATH, '_TinyGLTF') + pathlib.Path(tinygltf_shared_build).mkdir(parents=True, exist_ok=True) + os.chdir(tinygltf_shared_build) + cmake_args = [] + cmake_args.append(f'-DCMAKE_INSTALL_PREFIX={DRACO_SHARED_INSTALL_PATH}') + cmake_args.append('-DTINYGLTF_BUILD_EXAMPLES=OFF') + cmake_configure(source_path=tinygltf_submodule_path, cmake_args=cmake_args) + cmake_build(cmake_args=['--target install']) + + # Install TinyGLTF in the static draco install root. + tinygltf_static_build = os.path.join(DRACO_STATIC_BUILD_PATH, '_TinyGLTF') + pathlib.Path(tinygltf_static_build).mkdir(parents=True, exist_ok=True) + os.chdir(tinygltf_static_build) + cmake_args = [] + cmake_args.append(f'-DCMAKE_INSTALL_PREFIX={DRACO_STATIC_INSTALL_PATH}') + cmake_args.append('-DTINYGLTF_BUILD_EXAMPLES=OFF') + cmake_configure(source_path=tinygltf_submodule_path, cmake_args=cmake_args) + cmake_build(cmake_args=['--target install']) + + os.chdir(orig_dir) + + +def build_and_install_draco(): + """Builds Draco in shared and static configurations.""" + orig_dir = os.getcwd() + + if ENABLE_TRANSCODER: + build_and_install_transcoder_dependencies() + + # Build and install Draco in shared library config for the current host + # machine. + os.chdir(DRACO_SHARED_BUILD_PATH) + cmake_args = [] + cmake_args.append(f'-DCMAKE_INSTALL_PREFIX={DRACO_SHARED_INSTALL_PATH}') + cmake_args.append('-DBUILD_SHARED_LIBS=ON') + if ENABLE_TRANSCODER: + cmake_args.append('-DDRACO_TRANSCODER_SUPPORTED=ON') + cmake_configure(source_path=DRACO_SOURCES_PATH, cmake_args=cmake_args) + cmake_build(cmake_args=['--target install']) + + # Build and install Draco in the static config for the current host machine. + os.chdir(DRACO_STATIC_BUILD_PATH) + cmake_args = [] + cmake_args.append(f'-DCMAKE_INSTALL_PREFIX={DRACO_STATIC_INSTALL_PATH}') + cmake_args.append('-DBUILD_SHARED_LIBS=OFF') + if ENABLE_TRANSCODER: + cmake_args.append('-DDRACO_TRANSCODER_SUPPORTED=ON') + cmake_configure(source_path=DRACO_SOURCES_PATH, cmake_args=cmake_args) + cmake_build(cmake_args=['--target install']) + + os.chdir(orig_dir) + + +def build_test_project(): + """Builds the test application in shared and static configurations.""" + orig_dir = os.getcwd() + + # Configure the test project against draco shared and build it. + os.chdir(TEST_SHARED_BUILD_PATH) + cmake_args = [] + cmake_args.append(f'-DCMAKE_INSTALL_PREFIX={TEST_SHARED_INSTALL_PATH}') + cmake_args.append(f'-DCMAKE_PREFIX_PATH={DRACO_SHARED_INSTALL_PATH}') + cmake_args.append(f'-DCMAKE_INSTALL_RPATH={DRACO_SHARED_INSTALL_LIB_PATH}') + cmake_configure(source_path=f'{TEST_SOURCES_PATH}', cmake_args=cmake_args) + cmake_build(cmake_args=['--target install']) + run_install_check(TEST_SHARED_INSTALL_PATH) + + # Configure the test project against draco static and build it. + os.chdir(TEST_STATIC_BUILD_PATH) + cmake_args = [] + cmake_args.append(f'-DCMAKE_INSTALL_PREFIX={TEST_STATIC_INSTALL_PATH}') + cmake_args.append(f'-DCMAKE_PREFIX_PATH={DRACO_STATIC_INSTALL_PATH}') + cmake_configure(source_path=f'{TEST_SOURCES_PATH}', cmake_args=cmake_args) + cmake_build(cmake_args=['--target install']) + run_install_check(TEST_STATIC_INSTALL_PATH) + + os.chdir(orig_dir) + + +def test_draco_install(): + create_output_directories() + build_and_install_draco() + build_test_project() + cleanup() + + +if __name__ == '__main__': + CMAKE_AVAILABLE_GENERATORS = cmake_get_available_generators() + + parser = argparse.ArgumentParser() + parser.add_argument( + '-G', '--generator', help='CMake builds use the specified generator.') + parser.add_argument( + '-D', '--cmake_define', + action='append', + help='Passes argument through to CMake as a CMake variable via cmake -D.') + parser.add_argument( + '-t', '--with_transcoder', + action='store_true', + help='Run tests with Draco transcoder support enabled.') + parser.add_argument( + '-v', + '--verbose', + action='store_true', + help='Show configuration and build output.') + args = parser.parse_args() + + if args.cmake_define: + CMAKE_DEFINES = args.cmake_define + if args.generator: + CMAKE_GENERATOR = args.generator + if args.verbose: + VERBOSE = True + if args.with_transcoder: + ENABLE_TRANSCODER = True + + if VERBOSE: + print(f'CMAKE={CMAKE}') + print(f'CMAKE_DEFINES={CMAKE_DEFINES}') + print(f'CMAKE_GENERATOR={CMAKE_GENERATOR}') + print(f'CMAKE_AVAILABLE_GENERATORS={CMAKE_AVAILABLE_GENERATORS}') + print(f'ENABLE_TRANSCODER={ENABLE_TRANSCODER}') + print(f'DRACO_SOURCES_PATH={DRACO_SOURCES_PATH}') + print(f'DRACO_SHARED_BUILD_PATH={DRACO_SHARED_BUILD_PATH}') + print(f'DRACO_STATIC_BUILD_PATH={DRACO_STATIC_BUILD_PATH}') + print(f'DRACO_SHARED_INSTALL_PATH={DRACO_SHARED_INSTALL_PATH}') + print(f'DRACO_STATIC_INSTALL_PATH={DRACO_STATIC_INSTALL_PATH}') + print(f'NUM_PROCESSES={NUM_PROCESSES}') + print(f'TEST_SHARED_BUILD_PATH={TEST_SHARED_BUILD_PATH}') + print(f'TEST_STATIC_BUILD_PATH={TEST_STATIC_BUILD_PATH}') + print(f'TEST_SOURCES_PATH={TEST_SOURCES_PATH}') + print(f'VERBOSE={VERBOSE}') + + if CMAKE_GENERATOR and CMAKE_GENERATOR not in CMAKE_AVAILABLE_GENERATORS: + raise ValueError(f'CMake generator unavailable: {CMAKE_GENERATOR}.') + + test_draco_install() From f7f54036f20547b446600476abf1cae902d8148d Mon Sep 17 00:00:00 2001 From: Jackie9527 <80555200+Jackie9527@users.noreply.github.com> Date: Sat, 25 Feb 2023 10:10:03 +0800 Subject: [PATCH 08/61] bugfix the three vertices are collinear when converting a polygon to a triangle. Signed-off-by: Jackie9527 <80555200+Jackie9527@users.noreply.github.com> --- code/PostProcessing/TriangulateProcess.cpp | 15 +++++++++++++++ 1 file changed, 15 insertions(+) diff --git a/code/PostProcessing/TriangulateProcess.cpp b/code/PostProcessing/TriangulateProcess.cpp index 52e760361..8ba6456b7 100644 --- a/code/PostProcessing/TriangulateProcess.cpp +++ b/code/PostProcessing/TriangulateProcess.cpp @@ -468,6 +468,21 @@ bool TriangulateProcess::TriangulateMesh( aiMesh* pMesh) continue; } + // Skip when three point is in a line + aiVector2D left = *pnt0 - *pnt1; + aiVector2D right = *pnt2 - *pnt1; + + left.Normalize(); + right.Normalize(); + auto mul = left * right; + + // if the angle is 0 or 180 + if (std::abs(mul - 1.f) < ai_epsilon || std::abs(mul + 1.f) < ai_epsilon) { + // skip this ear + ASSIMP_LOG_WARN("Skip a ear, due to its angle is near 0 or 180."); + continue; + } + // and no other point may be contained in this triangle for ( tmp = 0; tmp < max; ++tmp) { From 1092f0d94e4cf60a28ce96a51334c9f243b997e0 Mon Sep 17 00:00:00 2001 From: Kim Kulling Date: Wed, 1 Mar 2023 21:40:45 +0100 Subject: [PATCH 09/61] Fix:Use correct encoding --- include/assimp/Base64.hpp | 14 ++- samples/SharedCode/UTFConverter.cpp | 52 --------- samples/SharedCode/UTFConverter.h | 103 ------------------ .../SimpleTexturedDirectx11/CMakeLists.txt | 2 - .../SimpleTexturedDirectx11/main.cpp | 19 +++- samples/SimpleTexturedOpenGL/CMakeLists.txt | 2 - tools/assimp_view/AnimEvaluator.cpp | 6 - tools/assimp_view/AnimEvaluator.h | 2 +- tools/assimp_view/AssetHelper.h | 17 ++- tools/assimp_view/Material.cpp | 22 ++-- tools/assimp_view/assimp_view.cpp | 9 +- tools/assimp_view/assimp_view.h | 6 + 12 files changed, 49 insertions(+), 205 deletions(-) delete mode 100644 samples/SharedCode/UTFConverter.cpp delete mode 100644 samples/SharedCode/UTFConverter.h diff --git a/include/assimp/Base64.hpp b/include/assimp/Base64.hpp index 403723857..10288713c 100644 --- a/include/assimp/Base64.hpp +++ b/include/assimp/Base64.hpp @@ -43,6 +43,8 @@ OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. #ifndef AI_BASE64_HPP_INC #define AI_BASE64_HPP_INC +#include + #include #include #include @@ -54,35 +56,35 @@ namespace Base64 { /// @param in The UTF-64 buffer. /// @param inLength The size of the buffer /// @param out The encoded ASCII string. -void Encode(const uint8_t *in, size_t inLength, std::string &out); +ASSIMP_API void Encode(const uint8_t *in, size_t inLength, std::string &out); /// @brief Will encode the given character buffer from UTF64 to ASCII. /// @param in A vector, which contains the buffer for encoding. /// @param out The encoded ASCII string. -void Encode(const std::vector& in, std::string &out); +ASSIMP_API void Encode(const std::vector &in, std::string &out); /// @brief Will encode the given character buffer from UTF64 to ASCII. /// @param in A vector, which contains the buffer for encoding. /// @return The encoded ASCII string. -std::string Encode(const std::vector& in); +ASSIMP_API std::string Encode(const std::vector &in); /// @brief Will decode the given character buffer from ASCII to UTF64. /// @param in The ASCII buffer to decode. /// @param inLength The size of the buffer. /// @param out The decoded buffer. /// @return The new buffer size. -size_t Decode(const char *in, size_t inLength, uint8_t *&out); +ASSIMP_API size_t Decode(const char *in, size_t inLength, uint8_t *&out); /// @brief Will decode the given character buffer from ASCII to UTF64. /// @param in The ASCII buffer to decode as a std::string. /// @param out The decoded buffer. /// @return The new buffer size. -size_t Decode(const std::string& in, std::vector& out); +ASSIMP_API size_t Decode(const std::string &in, std::vector &out); /// @brief Will decode the given character buffer from ASCII to UTF64. /// @param in The ASCII string. /// @return The decoded buffer in a vector. -std::vector Decode(const std::string& in); +ASSIMP_API std::vector Decode(const std::string &in); } // namespace Base64 } // namespace Assimp diff --git a/samples/SharedCode/UTFConverter.cpp b/samples/SharedCode/UTFConverter.cpp deleted file mode 100644 index e6c07e946..000000000 --- a/samples/SharedCode/UTFConverter.cpp +++ /dev/null @@ -1,52 +0,0 @@ -/* ---------------------------------------------------------------------------- -Open Asset Import Library (assimp) ---------------------------------------------------------------------------- - -Copyright (c) 2006-2020, assimp team - - - -All rights reserved. - -Redistribution and use of this software in source and binary forms, -with or without modification, are permitted provided that the following -conditions are met: - -* Redistributions of source code must retain the above - copyright notice, this list of conditions and the - following disclaimer. - -* Redistributions in binary form must reproduce the above - copyright notice, this list of conditions and the - following disclaimer in the documentation and/or other - materials provided with the distribution. - -* Neither the name of the assimp team, nor the names of its - contributors may be used to endorse or promote products - derived from this software without specific prior - written permission of the assimp team. - -THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS -"AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT -LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR -A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT -OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, -SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT -LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, -DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY -THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT -(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE -OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. ---------------------------------------------------------------------------- -*/ - -#include "UTFConverter.h" - -namespace AssimpSamples { -namespace SharedCode { - -//typename UTFConverter::UTFConverterImpl UTFConverter::impl_; - -} -} diff --git a/samples/SharedCode/UTFConverter.h b/samples/SharedCode/UTFConverter.h deleted file mode 100644 index 34b2293de..000000000 --- a/samples/SharedCode/UTFConverter.h +++ /dev/null @@ -1,103 +0,0 @@ -/* ---------------------------------------------------------------------------- -Open Asset Import Library (assimp) ---------------------------------------------------------------------------- - -Copyright (c) 2006-2020, assimp team - - - -All rights reserved. - -Redistribution and use of this software in source and binary forms, -with or without modification, are permitted provided that the following -conditions are met: - -* Redistributions of source code must retain the above - copyright notice, this list of conditions and the - following disclaimer. - -* Redistributions in binary form must reproduce the above - copyright notice, this list of conditions and the - following disclaimer in the documentation and/or other - materials provided with the distribution. - -* Neither the name of the assimp team, nor the names of its - contributors may be used to endorse or promote products - derived from this software without specific prior - written permission of the assimp team. - -THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS -"AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT -LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR -A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT -OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, -SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT -LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, -DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY -THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT -(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE -OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. ---------------------------------------------------------------------------- -*/ - -#ifndef ASSIMP_SAMPLES_SHARED_CODE_UTFCONVERTER_H -#define ASSIMP_SAMPLES_SHARED_CODE_UTFCONVERTER_H - -#include -#include - -#ifdef ASSIMP_USE_HUNTER -#include -#else -#include "../contrib/utf8cpp/source/utf8.h" -#endif - -namespace AssimpSamples { -namespace SharedCode { - -// Used to convert between multibyte and unicode strings. -class UTFConverter { -public: - //utf8::utf16to8(start, end, back_inserter(str)); - - UTFConverter(const char* s) : s_(s), ws_() { - std::vector str; - utf8::utf8to16(s, s + std::strlen(s) + 1, back_inserter(str)); - } - - UTFConverter(const wchar_t* s) : s_(),ws_(s) { - std::vector str; - utf8::utf16to8(s, s + ws_.size() + 1, back_inserter(str)); - } - - UTFConverter(const std::string& s) : s_(s), ws_() { - std::vector str; - utf8::utf8to16(s.c_str(), s.c_str() + s.size() + 1, back_inserter(str)); - } - - UTFConverter(const std::wstring& s) : s_(), ws_(s) { - std::vector str; - utf8::utf16to8(s.c_str(), s.c_str() + ws_.size() + 1, back_inserter(str)); - } - - inline const char* c_str() const { - return s_.c_str(); - } - - inline const std::string& str() const { - return s_; - } - - inline const wchar_t* c_wstr() const { - return ws_.c_str(); - } -private: - std::string s_; - std::wstring ws_; -}; - -} -} - -#endif // ASSIMP_SAMPLES_SHARED_CODE_UTFCONVERTER_H diff --git a/samples/SimpleTexturedDirectx11/CMakeLists.txt b/samples/SimpleTexturedDirectx11/CMakeLists.txt index 007ada3af..f1e03888c 100644 --- a/samples/SimpleTexturedDirectx11/CMakeLists.txt +++ b/samples/SimpleTexturedDirectx11/CMakeLists.txt @@ -33,8 +33,6 @@ ADD_EXECUTABLE( assimp_simpletextureddirectx11 WIN32 #SimpleTexturedDirectx11/VertexShader.hlsl SimpleTexturedDirectx11/main.cpp SimpleTexturedDirectx11/SafeRelease.hpp - ${SAMPLES_SHARED_CODE_DIR}/UTFConverter.cpp - ${SAMPLES_SHARED_CODE_DIR}/UTFConverter.h ) TARGET_USE_COMMON_OUTPUT_DIRECTORY(assimp_simpletextureddirectx11) diff --git a/samples/SimpleTexturedDirectx11/SimpleTexturedDirectx11/main.cpp b/samples/SimpleTexturedDirectx11/SimpleTexturedDirectx11/main.cpp index f7b35024b..7f0d0c84e 100644 --- a/samples/SimpleTexturedDirectx11/SimpleTexturedDirectx11/main.cpp +++ b/samples/SimpleTexturedDirectx11/SimpleTexturedDirectx11/main.cpp @@ -21,8 +21,12 @@ #include #include #include +#ifdef ASSIMP_USE_HUNTER +#include +#else +#include "../contrib/utf8cpp/source/utf8.h" +#endif #include "ModelLoader.h" -#include "UTFConverter.h" #include "SafeRelease.hpp" #ifdef _MSC_VER @@ -33,7 +37,6 @@ #endif // _MSC_VER using namespace DirectX; -using namespace AssimpSamples::SharedCode; #define VERTEX_SHADER_FILE L"VertexShader.hlsl" #define PIXEL_SHADER_FILE L"PixelShader.hlsl" @@ -154,8 +157,14 @@ int WINAPI wWinMain(HINSTANCE hInstance, HINSTANCE /*hPrevInstance*/, } // Retrieve the model file path. - g_ModelPath = UTFConverter(argv[1]).str(); + std::wstring filename(argv[1]); + + char *targetStart = new char[filename.size()+1]; + memset(targetStart, '\0', filename.size() + 1); + utf8::utf16to8(filename.c_str(), filename.c_str() + filename.size(), targetStart); + g_ModelPath = targetStart; + delete[] targetStart; free_command_line_allocated_memory(); WNDCLASSEX wc; @@ -511,9 +520,9 @@ void InitPipeline() { ID3DBlob *VS, *PS; if(FAILED(CompileShaderFromFile(SHADER_PATH VERTEX_SHADER_FILE, 0, "main", "vs_4_0", &VS))) - Throwanerror(UTFConverter(L"Failed to compile shader from file " VERTEX_SHADER_FILE).c_str()); + Throwanerror("Failed to compile shader from file"); if(FAILED(CompileShaderFromFile(SHADER_PATH PIXEL_SHADER_FILE, 0, "main", "ps_4_0", &PS))) - Throwanerror(UTFConverter(L"Failed to compile shader from file " PIXEL_SHADER_FILE).c_str()); + Throwanerror("Failed to compile shader from file "); dev->CreateVertexShader(VS->GetBufferPointer(), VS->GetBufferSize(), nullptr, &pVS); dev->CreatePixelShader(PS->GetBufferPointer(), PS->GetBufferSize(), nullptr, &pPS); diff --git a/samples/SimpleTexturedOpenGL/CMakeLists.txt b/samples/SimpleTexturedOpenGL/CMakeLists.txt index 1837af033..70837e87c 100644 --- a/samples/SimpleTexturedOpenGL/CMakeLists.txt +++ b/samples/SimpleTexturedOpenGL/CMakeLists.txt @@ -30,8 +30,6 @@ LINK_DIRECTORIES( ADD_EXECUTABLE( assimp_simpletexturedogl WIN32 SimpleTexturedOpenGL/src/model_loading.cpp - ${SAMPLES_SHARED_CODE_DIR}/UTFConverter.cpp - ${SAMPLES_SHARED_CODE_DIR}/UTFConverter.h ) TARGET_USE_COMMON_OUTPUT_DIRECTORY(assimp_simpletexturedogl) diff --git a/tools/assimp_view/AnimEvaluator.cpp b/tools/assimp_view/AnimEvaluator.cpp index ad8e7f5b2..4f8d1bda8 100644 --- a/tools/assimp_view/AnimEvaluator.cpp +++ b/tools/assimp_view/AnimEvaluator.cpp @@ -55,12 +55,6 @@ AnimEvaluator::AnimEvaluator(const aiAnimation *pAnim) : mLastPositions.resize(pAnim->mNumChannels, std::make_tuple(0, 0, 0)); } -// ------------------------------------------------------------------------------------------------ -// Destructor. -AnimEvaluator::~AnimEvaluator() { - // empty -} - // ------------------------------------------------------------------------------------------------ // Evaluates the animation tracks for a given time stamp. void AnimEvaluator::Evaluate(double pTime) { diff --git a/tools/assimp_view/AnimEvaluator.h b/tools/assimp_view/AnimEvaluator.h index 76b22ea8a..aa44ab211 100644 --- a/tools/assimp_view/AnimEvaluator.h +++ b/tools/assimp_view/AnimEvaluator.h @@ -66,7 +66,7 @@ public: AnimEvaluator(const aiAnimation *pAnim); /// @brief The class destructor. - ~AnimEvaluator(); + ~AnimEvaluator() = default; /// @brief Evaluates the animation tracks for a given time stamp. /// The calculated pose can be retrieved as an array of transformation diff --git a/tools/assimp_view/AssetHelper.h b/tools/assimp_view/AssetHelper.h index 1ae469f85..8661d875f 100644 --- a/tools/assimp_view/AssetHelper.h +++ b/tools/assimp_view/AssetHelper.h @@ -77,6 +77,13 @@ public: pcScene = NULL; } + // set the normal set to be used + void SetNormalSet(unsigned int iSet); + + // flip all normal vectors + void FlipNormals(); + void FlipNormalsInt(); + //--------------------------------------------------------------- // default vertex data structure // (even if tangents, bitangents or normals aren't @@ -221,16 +228,8 @@ public: // Specifies the normal set to be used unsigned int iNormalSet; - - // ------------------------------------------------------------------ - // set the normal set to be used - void SetNormalSet(unsigned int iSet); - - // ------------------------------------------------------------------ - // flip all normal vectors - void FlipNormals(); - void FlipNormalsInt(); }; + } // namespace AssimpView #endif // !! IG diff --git a/tools/assimp_view/Material.cpp b/tools/assimp_view/Material.cpp index e3c023bd9..c28231332 100644 --- a/tools/assimp_view/Material.cpp +++ b/tools/assimp_view/Material.cpp @@ -175,33 +175,29 @@ VOID WINAPI FillFunc(D3DXVECTOR4* pOut, pOut->x = pOut->y = 1.0f; pOut->z = 0.0f; } - return; } //------------------------------------------------------------------------------- -int CMaterialManager::UpdateSpecularMaterials() - { - if (g_pcAsset && g_pcAsset->pcScene) - { - for (unsigned int i = 0; i < g_pcAsset->pcScene->mNumMeshes;++i) - { - if (aiShadingMode_Phong == g_pcAsset->apcMeshes[i]->eShadingMode) - { +int CMaterialManager::UpdateSpecularMaterials() { + if (g_pcAsset && g_pcAsset->pcScene) { + for (unsigned int i = 0; i < g_pcAsset->pcScene->mNumMeshes;++i) { + if (aiShadingMode_Phong == g_pcAsset->apcMeshes[i]->eShadingMode) { this->DeleteMaterial(g_pcAsset->apcMeshes[i]); this->CreateMaterial(g_pcAsset->apcMeshes[i],g_pcAsset->pcScene->mMeshes[i]); - } } } - return 1; } + return 1; +} + //------------------------------------------------------------------------------- -int CMaterialManager::SetDefaultTexture(IDirect3DTexture9** p_ppiOut) -{ +int CMaterialManager::SetDefaultTexture(IDirect3DTexture9** p_ppiOut) { if (sDefaultTexture) { sDefaultTexture->AddRef(); *p_ppiOut = sDefaultTexture; return 1; } + if(FAILED(g_piDevice->CreateTexture( 256, 256, diff --git a/tools/assimp_view/assimp_view.cpp b/tools/assimp_view/assimp_view.cpp index c5c48fd93..e00c6e39d 100644 --- a/tools/assimp_view/assimp_view.cpp +++ b/tools/assimp_view/assimp_view.cpp @@ -145,9 +145,7 @@ float g_fLoadTime = 0.0f; // The loader thread loads the asset while the progress dialog displays the // smart progress bar //------------------------------------------------------------------------------- -DWORD WINAPI LoadThreadProc(LPVOID lpParameter) { - UNREFERENCED_PARAMETER(lpParameter); - +DWORD WINAPI LoadThreadProc(LPVOID) { // get current time double fCur = (double)timeGetTime(); @@ -367,7 +365,7 @@ int CalculateBounds(aiNode *piNode, aiVector3D *p_avOut, const aiMatrix4x4 &piMa // The function calculates the boundaries of the mesh and modifies the // global world transformation matrix according to the aset AABB //------------------------------------------------------------------------------- -int ScaleAsset(void) { +int ScaleAsset() { aiVector3D aiVecs[2] = { aiVector3D(1e10f, 1e10f, 1e10f), aiVector3D(-1e10f, -1e10f, -1e10f) }; @@ -521,8 +519,7 @@ int CreateAssetData() { } } else { // create 16 bit index buffer - if (FAILED(g_piDevice->CreateIndexBuffer(2 * -numIndices, + if (FAILED(g_piDevice->CreateIndexBuffer(2 * numIndices, D3DUSAGE_WRITEONLY | dwUsage, D3DFMT_INDEX16, D3DPOOL_DEFAULT, diff --git a/tools/assimp_view/assimp_view.h b/tools/assimp_view/assimp_view.h index cbcee3cac..e67cc9fd0 100644 --- a/tools/assimp_view/assimp_view.h +++ b/tools/assimp_view/assimp_view.h @@ -98,6 +98,12 @@ namespace AssimpView { //------------------------------------------------------------------------------- // Function prototypes //------------------------------------------------------------------------------- +class AssimpVew { +public: + AssimpVew(); + ~AssimpVew(); +}; + int InitD3D(void); int ShutdownD3D(void); int CreateDevice(bool p_bMultiSample, bool p_bSuperSample, bool bHW = true); From 02a427692481e340a051a3e56504748e5a05fb06 Mon Sep 17 00:00:00 2001 From: Jackie9527 <80555200+Jackie9527@users.noreply.github.com> Date: Thu, 2 Mar 2023 09:11:54 +0800 Subject: [PATCH 10/61] upgrade stb_image to v2.28. Signed-off-by: Jackie9527 <80555200+Jackie9527@users.noreply.github.com> --- contrib/stb/stb_image.h | 427 +++++++++++++++++++++++++++++++--------- 1 file changed, 329 insertions(+), 98 deletions(-) diff --git a/contrib/stb/stb_image.h b/contrib/stb/stb_image.h index 8d173c66a..5e807a0a6 100644 --- a/contrib/stb/stb_image.h +++ b/contrib/stb/stb_image.h @@ -1,4 +1,4 @@ -/* stb_image - v2.26 - public domain image loader - http://nothings.org/stb +/* stb_image - v2.28 - public domain image loader - http://nothings.org/stb no warranty implied; use at your own risk Do this: @@ -48,6 +48,8 @@ LICENSE RECENT REVISION HISTORY: + 2.28 (2023-01-29) many error fixes, security errors, just tons of stuff + 2.27 (2021-07-11) document stbi_info better, 16-bit PNM support, bug fixes 2.26 (2020-07-13) many minor fixes 2.25 (2020-02-02) fix warnings 2.24 (2020-02-02) fix warnings; thread-local failure_reason and flip_vertically @@ -89,7 +91,7 @@ RECENT REVISION HISTORY: Jeremy Sawicki (handle all ImageNet JPGs) Optimizations & bugfixes Mikhail Morozov (1-bit BMP) Fabian "ryg" Giesen Anael Seghezzi (is-16-bit query) - Arseny Kapoulkine + Arseny Kapoulkine Simon Breuss (16-bit PNM) John-Mark Allen Carmelo J Fdez-Aguera @@ -102,19 +104,21 @@ RECENT REVISION HISTORY: Thomas Ruf Ronny Chevalier github:rlyeh Janez Zemva John Bartholomew Michal Cichon github:romigrou Jonathan Blow Ken Hamada Tero Hanninen github:svdijk - Laurent Gomila Cort Stratton github:snagar + Eugene Golushkov Laurent Gomila Cort Stratton github:snagar Aruelien Pocheville Sergio Gonzalez Thibault Reuille github:Zelex Cass Everitt Ryamond Barbiero github:grim210 Paul Du Bois Engin Manap Aldo Culquicondor github:sammyhw Philipp Wiesemann Dale Weiler Oriol Ferrer Mesia github:phprus - Josh Tobin Matthew Gregan github:poppolopoppo + Josh Tobin Neil Bickford Matthew Gregan github:poppolopoppo Julian Raschke Gregory Mullen Christian Floisand github:darealshinji Baldur Karlsson Kevin Schmidt JR Smith github:Michaelangel007 - Brad Weinberger Matvey Cherevko [reserved] + Brad Weinberger Matvey Cherevko github:mosra Luca Sas Alexander Veselov Zack Middleton [reserved] Ryan C. Gordon [reserved] [reserved] DO NOT ADD YOUR NAME HERE + Jacko Dirks + To add your name to the credits, pick a random blank space in the middle and fill it. 80% of merge conflicts on stb PRs are due to people adding their name at the end of the credits. @@ -137,7 +141,7 @@ RECENT REVISION HISTORY: // // ... x = width, y = height, n = # 8-bit components per pixel ... // // ... replace '0' with '1'..'4' to force that many components per pixel // // ... but 'n' will always be the number that it would have been if you said 0 -// stbi_image_free(data) +// stbi_image_free(data); // // Standard parameters: // int *x -- outputs image width in pixels @@ -176,6 +180,32 @@ RECENT REVISION HISTORY: // // Paletted PNG, BMP, GIF, and PIC images are automatically depalettized. // +// To query the width, height and component count of an image without having to +// decode the full file, you can use the stbi_info family of functions: +// +// int x,y,n,ok; +// ok = stbi_info(filename, &x, &y, &n); +// // returns ok=1 and sets x, y, n if image is a supported format, +// // 0 otherwise. +// +// Note that stb_image pervasively uses ints in its public API for sizes, +// including sizes of memory buffers. This is now part of the API and thus +// hard to change without causing breakage. As a result, the various image +// loaders all have certain limits on image size; these differ somewhat +// by format but generally boil down to either just under 2GB or just under +// 1GB. When the decoded image would be larger than this, stb_image decoding +// will fail. +// +// Additionally, stb_image will reject image files that have any of their +// dimensions set to a larger value than the configurable STBI_MAX_DIMENSIONS, +// which defaults to 2**24 = 16777216 pixels. Due to the above memory limit, +// the only way to have an image with such dimensions load correctly +// is for it to have a rather extreme aspect ratio. Either way, the +// assumption here is that such larger images are likely to be malformed +// or malicious. If you do need to load an image with individual dimensions +// larger than that, and it still fits in the overall size limit, you can +// #define STBI_MAX_DIMENSIONS on your own to be something larger. +// // =========================================================================== // // UNICODE: @@ -281,11 +311,10 @@ RECENT REVISION HISTORY: // // iPhone PNG support: // -// By default we convert iphone-formatted PNGs back to RGB, even though -// they are internally encoded differently. You can disable this conversion -// by calling stbi_convert_iphone_png_to_rgb(0), in which case -// you will always just get the native iphone "format" through (which -// is BGR stored in RGB). +// We optionally support converting iPhone-formatted PNGs (which store +// premultiplied BGRA) back to RGB, even though they're internally encoded +// differently. To enable this conversion, call +// stbi_convert_iphone_png_to_rgb(1). // // Call stbi_set_unpremultiply_on_load(1) as well to force a divide per // pixel to remove any premultiplied alpha *only* if the image file explicitly @@ -489,6 +518,8 @@ STBIDEF void stbi_set_flip_vertically_on_load(int flag_true_if_should_flip); // as above, but only applies to images loaded on the thread that calls the function // this function is only available if your compiler supports thread-local variables; // calling it will fail to link if your compiler doesn't +STBIDEF void stbi_set_unpremultiply_on_load_thread(int flag_true_if_should_unpremultiply); +STBIDEF void stbi_convert_iphone_png_to_rgb_thread(int flag_true_if_should_convert); STBIDEF void stbi_set_flip_vertically_on_load_thread(int flag_true_if_should_flip); // ZLIB client - used by PNG, available for other purposes @@ -605,7 +636,7 @@ STBIDEF int stbi_zlib_decode_noheader_buffer(char *obuffer, int olen, const ch #endif #endif -#ifdef _MSC_VER +#if defined(_MSC_VER) || defined(__SYMBIAN32__) typedef unsigned short stbi__uint16; typedef signed short stbi__int16; typedef unsigned int stbi__uint32; @@ -634,7 +665,7 @@ typedef unsigned char validate_uint32[sizeof(stbi__uint32)==4 ? 1 : -1]; #ifdef STBI_HAS_LROTL #define stbi_lrot(x,y) _lrotl(x,y) #else - #define stbi_lrot(x,y) (((x) << (y)) | ((x) >> (32 - (y)))) + #define stbi_lrot(x,y) (((x) << (y)) | ((x) >> (-(y) & 31))) #endif #if defined(STBI_MALLOC) && defined(STBI_FREE) && (defined(STBI_REALLOC) || defined(STBI_REALLOC_SIZED)) @@ -748,9 +779,12 @@ static int stbi__sse2_available(void) #ifdef STBI_NEON #include -// assume GCC or Clang on ARM targets +#ifdef _MSC_VER +#define STBI_SIMD_ALIGN(type, name) __declspec(align(16)) type name +#else #define STBI_SIMD_ALIGN(type, name) type name __attribute__((aligned(16))) #endif +#endif #ifndef STBI_SIMD_ALIGN #define STBI_SIMD_ALIGN(type, name) type name @@ -924,6 +958,7 @@ static int stbi__gif_info(stbi__context *s, int *x, int *y, int *comp); static int stbi__pnm_test(stbi__context *s); static void *stbi__pnm_load(stbi__context *s, int *x, int *y, int *comp, int req_comp, stbi__result_info *ri); static int stbi__pnm_info(stbi__context *s, int *x, int *y, int *comp); +static int stbi__pnm_is16(stbi__context *s); #endif static @@ -998,7 +1033,7 @@ static int stbi__mad3sizes_valid(int a, int b, int c, int add) } // returns 1 if "a*b*c*d + add" has no negative terms/factors and doesn't overflow -#if !defined(STBI_NO_LINEAR) || !defined(STBI_NO_HDR) +#if !defined(STBI_NO_LINEAR) || !defined(STBI_NO_HDR) || !defined(STBI_NO_PNM) static int stbi__mad4sizes_valid(int a, int b, int c, int d, int add) { return stbi__mul2sizes_valid(a, b) && stbi__mul2sizes_valid(a*b, c) && @@ -1021,7 +1056,7 @@ static void *stbi__malloc_mad3(int a, int b, int c, int add) return stbi__malloc(a*b*c + add); } -#if !defined(STBI_NO_LINEAR) || !defined(STBI_NO_HDR) +#if !defined(STBI_NO_LINEAR) || !defined(STBI_NO_HDR) || !defined(STBI_NO_PNM) static void *stbi__malloc_mad4(int a, int b, int c, int d, int add) { if (!stbi__mad4sizes_valid(a, b, c, d, add)) return NULL; @@ -1029,6 +1064,23 @@ static void *stbi__malloc_mad4(int a, int b, int c, int d, int add) } #endif +// returns 1 if the sum of two signed ints is valid (between -2^31 and 2^31-1 inclusive), 0 on overflow. +static int stbi__addints_valid(int a, int b) +{ + if ((a >= 0) != (b >= 0)) return 1; // a and b have different signs, so no overflow + if (a < 0 && b < 0) return a >= INT_MIN - b; // same as a + b >= INT_MIN; INT_MIN - b cannot overflow since b < 0. + return a <= INT_MAX - b; +} + +// returns 1 if the product of two signed shorts is valid, 0 on overflow. +static int stbi__mul2shorts_valid(short a, short b) +{ + if (b == 0 || b == -1) return 1; // multiplication by 0 is always 0; check for -1 so SHRT_MIN/b doesn't overflow + if ((a >= 0) == (b >= 0)) return a <= SHRT_MAX/b; // product is positive, so similar to mul2sizes_valid + if (b < 0) return a <= SHRT_MIN / b; // same as a * b >= SHRT_MIN + return a >= SHRT_MIN / b; +} + // stbi__err - error // stbi__errpf - error returning pointer to float // stbi__errpuc - error returning pointer to unsigned char @@ -1087,9 +1139,8 @@ static void *stbi__load_main(stbi__context *s, int *x, int *y, int *comp, int re ri->channel_order = STBI_ORDER_RGB; // all current input & output are this, but this is here so we can add BGR order ri->num_channels = 0; - #ifndef STBI_NO_JPEG - if (stbi__jpeg_test(s)) return stbi__jpeg_load(s,x,y,comp,req_comp, ri); - #endif + // test the formats with a very explicit header first (at least a FOURCC + // or distinctive magic number first) #ifndef STBI_NO_PNG if (stbi__png_test(s)) return stbi__png_load(s,x,y,comp,req_comp, ri); #endif @@ -1107,6 +1158,13 @@ static void *stbi__load_main(stbi__context *s, int *x, int *y, int *comp, int re #ifndef STBI_NO_PIC if (stbi__pic_test(s)) return stbi__pic_load(s,x,y,comp,req_comp, ri); #endif + + // then the formats that can end up attempting to load with just 1 or 2 + // bytes matching expectations; these are prone to false positives, so + // try them later + #ifndef STBI_NO_JPEG + if (stbi__jpeg_test(s)) return stbi__jpeg_load(s,x,y,comp,req_comp, ri); + #endif #ifndef STBI_NO_PNM if (stbi__pnm_test(s)) return stbi__pnm_load(s,x,y,comp,req_comp, ri); #endif @@ -1262,12 +1320,12 @@ static void stbi__float_postprocess(float *result, int *x, int *y, int *comp, in #ifndef STBI_NO_STDIO -#if defined(_MSC_VER) && defined(STBI_WINDOWS_UTF8) +#if defined(_WIN32) && defined(STBI_WINDOWS_UTF8) STBI_EXTERN __declspec(dllimport) int __stdcall MultiByteToWideChar(unsigned int cp, unsigned long flags, const char *str, int cbmb, wchar_t *widestr, int cchwide); STBI_EXTERN __declspec(dllimport) int __stdcall WideCharToMultiByte(unsigned int cp, unsigned long flags, const wchar_t *widestr, int cchwide, char *str, int cbmb, const char *defchar, int *used_default); #endif -#if defined(_MSC_VER) && defined(STBI_WINDOWS_UTF8) +#if defined(_WIN32) && defined(STBI_WINDOWS_UTF8) STBIDEF int stbi_convert_wchar_to_utf8(char *buffer, size_t bufferlen, const wchar_t* input) { return WideCharToMultiByte(65001 /* UTF8 */, 0, input, -1, buffer, (int) bufferlen, NULL, NULL); @@ -1277,16 +1335,16 @@ STBIDEF int stbi_convert_wchar_to_utf8(char *buffer, size_t bufferlen, const wch static FILE *stbi__fopen(char const *filename, char const *mode) { FILE *f; -#if defined(_MSC_VER) && defined(STBI_WINDOWS_UTF8) +#if defined(_WIN32) && defined(STBI_WINDOWS_UTF8) wchar_t wMode[64]; wchar_t wFilename[1024]; - if (0 == MultiByteToWideChar(65001 /* UTF8 */, 0, filename, -1, wFilename, sizeof(wFilename))) + if (0 == MultiByteToWideChar(65001 /* UTF8 */, 0, filename, -1, wFilename, sizeof(wFilename)/sizeof(*wFilename))) return 0; - if (0 == MultiByteToWideChar(65001 /* UTF8 */, 0, mode, -1, wMode, sizeof(wMode))) + if (0 == MultiByteToWideChar(65001 /* UTF8 */, 0, mode, -1, wMode, sizeof(wMode)/sizeof(*wMode))) return 0; -#if _MSC_VER >= 1400 +#if defined(_MSC_VER) && _MSC_VER >= 1400 if (0 != _wfopen_s(&f, wFilename, wMode)) f = 0; #else @@ -1662,7 +1720,8 @@ static int stbi__get16le(stbi__context *s) static stbi__uint32 stbi__get32le(stbi__context *s) { stbi__uint32 z = stbi__get16le(s); - return z + (stbi__get16le(s) << 16); + z += (stbi__uint32)stbi__get16le(s) << 16; + return z; } #endif @@ -1944,9 +2003,12 @@ static int stbi__build_huffman(stbi__huffman *h, int *count) int i,j,k=0; unsigned int code; // build size list for each symbol (from JPEG spec) - for (i=0; i < 16; ++i) - for (j=0; j < count[i]; ++j) + for (i=0; i < 16; ++i) { + for (j=0; j < count[i]; ++j) { h->size[k++] = (stbi_uc) (i+1); + if(k >= 257) return stbi__err("bad size list","Corrupt JPEG"); + } + } h->size[k] = 0; // compute actual symbols (from jpeg spec) @@ -2071,6 +2133,8 @@ stbi_inline static int stbi__jpeg_huff_decode(stbi__jpeg *j, stbi__huffman *h) // convert the huffman code to the symbol id c = ((j->code_buffer >> (32 - k)) & stbi__bmask[k]) + h->delta[k]; + if(c < 0 || c >= 256) // symbol id out of bounds! + return -1; STBI_ASSERT((((j->code_buffer) >> (32 - h->size[c])) & stbi__bmask[h->size[c]]) == h->code[c]); // convert the id to a symbol @@ -2089,14 +2153,14 @@ stbi_inline static int stbi__extend_receive(stbi__jpeg *j, int n) unsigned int k; int sgn; if (j->code_bits < n) stbi__grow_buffer_unsafe(j); + if (j->code_bits < n) return 0; // ran out of bits from stream, return 0s intead of continuing - sgn = (stbi__int32)j->code_buffer >> 31; // sign bit is always in MSB + sgn = j->code_buffer >> 31; // sign bit always in MSB; 0 if MSB clear (positive), 1 if MSB set (negative) k = stbi_lrot(j->code_buffer, n); - if (n < 0 || n >= (int) (sizeof(stbi__bmask)/sizeof(*stbi__bmask))) return 0; j->code_buffer = k & ~stbi__bmask[n]; k &= stbi__bmask[n]; j->code_bits -= n; - return k + (stbi__jbias[n] & ~sgn); + return k + (stbi__jbias[n] & (sgn - 1)); } // get some unsigned bits @@ -2104,6 +2168,7 @@ stbi_inline static int stbi__jpeg_get_bits(stbi__jpeg *j, int n) { unsigned int k; if (j->code_bits < n) stbi__grow_buffer_unsafe(j); + if (j->code_bits < n) return 0; // ran out of bits from stream, return 0s intead of continuing k = stbi_lrot(j->code_buffer, n); j->code_buffer = k & ~stbi__bmask[n]; k &= stbi__bmask[n]; @@ -2115,6 +2180,7 @@ stbi_inline static int stbi__jpeg_get_bit(stbi__jpeg *j) { unsigned int k; if (j->code_bits < 1) stbi__grow_buffer_unsafe(j); + if (j->code_bits < 1) return 0; // ran out of bits from stream, return 0s intead of continuing k = j->code_buffer; j->code_buffer <<= 1; --j->code_bits; @@ -2146,14 +2212,16 @@ static int stbi__jpeg_decode_block(stbi__jpeg *j, short data[64], stbi__huffman if (j->code_bits < 16) stbi__grow_buffer_unsafe(j); t = stbi__jpeg_huff_decode(j, hdc); - if (t < 0) return stbi__err("bad huffman code","Corrupt JPEG"); + if (t < 0 || t > 15) return stbi__err("bad huffman code","Corrupt JPEG"); // 0 all the ac values now so we can do it 32-bits at a time memset(data,0,64*sizeof(data[0])); diff = t ? stbi__extend_receive(j, t) : 0; + if (!stbi__addints_valid(j->img_comp[b].dc_pred, diff)) return stbi__err("bad delta","Corrupt JPEG"); dc = j->img_comp[b].dc_pred + diff; j->img_comp[b].dc_pred = dc; + if (!stbi__mul2shorts_valid(dc, dequant[0])) return stbi__err("can't merge dc and ac", "Corrupt JPEG"); data[0] = (short) (dc * dequant[0]); // decode AC components, see JPEG spec @@ -2167,6 +2235,7 @@ static int stbi__jpeg_decode_block(stbi__jpeg *j, short data[64], stbi__huffman if (r) { // fast-AC path k += (r >> 4) & 15; // run s = r & 15; // combined length + if (s > j->code_bits) return stbi__err("bad huffman code", "Combined length longer than code bits available"); j->code_buffer <<= s; j->code_bits -= s; // decode into unzigzag'd location @@ -2203,12 +2272,14 @@ static int stbi__jpeg_decode_block_prog_dc(stbi__jpeg *j, short data[64], stbi__ // first scan for DC coefficient, must be first memset(data,0,64*sizeof(data[0])); // 0 all the ac values now t = stbi__jpeg_huff_decode(j, hdc); - if (t == -1) return stbi__err("can't merge dc and ac", "Corrupt JPEG"); + if (t < 0 || t > 15) return stbi__err("can't merge dc and ac", "Corrupt JPEG"); diff = t ? stbi__extend_receive(j, t) : 0; + if (!stbi__addints_valid(j->img_comp[b].dc_pred, diff)) return stbi__err("bad delta", "Corrupt JPEG"); dc = j->img_comp[b].dc_pred + diff; j->img_comp[b].dc_pred = dc; - data[0] = (short) (dc << j->succ_low); + if (!stbi__mul2shorts_valid(dc, 1 << j->succ_low)) return stbi__err("can't merge dc and ac", "Corrupt JPEG"); + data[0] = (short) (dc * (1 << j->succ_low)); } else { // refinement scan for DC coefficient if (stbi__jpeg_get_bit(j)) @@ -2242,10 +2313,11 @@ static int stbi__jpeg_decode_block_prog_ac(stbi__jpeg *j, short data[64], stbi__ if (r) { // fast-AC path k += (r >> 4) & 15; // run s = r & 15; // combined length + if (s > j->code_bits) return stbi__err("bad huffman code", "Combined length longer than code bits available"); j->code_buffer <<= s; j->code_bits -= s; zig = stbi__jpeg_dezigzag[k++]; - data[zig] = (short) ((r >> 8) << shift); + data[zig] = (short) ((r >> 8) * (1 << shift)); } else { int rs = stbi__jpeg_huff_decode(j, hac); if (rs < 0) return stbi__err("bad huffman code","Corrupt JPEG"); @@ -2263,7 +2335,7 @@ static int stbi__jpeg_decode_block_prog_ac(stbi__jpeg *j, short data[64], stbi__ } else { k += r; zig = stbi__jpeg_dezigzag[k++]; - data[zig] = (short) (stbi__extend_receive(j,s) << shift); + data[zig] = (short) (stbi__extend_receive(j,s) * (1 << shift)); } } } while (k <= j->spec_end); @@ -3062,6 +3134,7 @@ static int stbi__process_marker(stbi__jpeg *z, int m) sizes[i] = stbi__get8(z->s); n += sizes[i]; } + if(n > 256) return stbi__err("bad DHT header","Corrupt JPEG"); // Loop over i < n would write past end of values! L -= 17; if (tc == 0) { if (!stbi__build_huffman(z->huff_dc+th, sizes)) return 0; @@ -3227,6 +3300,13 @@ static int stbi__process_frame_header(stbi__jpeg *z, int scan) if (z->img_comp[i].v > v_max) v_max = z->img_comp[i].v; } + // check that plane subsampling factors are integer ratios; our resamplers can't deal with fractional ratios + // and I've never seen a non-corrupted JPEG file actually use them + for (i=0; i < s->img_n; ++i) { + if (h_max % z->img_comp[i].h != 0) return stbi__err("bad H","Corrupt JPEG"); + if (v_max % z->img_comp[i].v != 0) return stbi__err("bad V","Corrupt JPEG"); + } + // compute interleaved mcu info z->img_h_max = h_max; z->img_v_max = v_max; @@ -3304,6 +3384,28 @@ static int stbi__decode_jpeg_header(stbi__jpeg *z, int scan) return 1; } +static int stbi__skip_jpeg_junk_at_end(stbi__jpeg *j) +{ + // some JPEGs have junk at end, skip over it but if we find what looks + // like a valid marker, resume there + while (!stbi__at_eof(j->s)) { + int x = stbi__get8(j->s); + while (x == 255) { // might be a marker + if (stbi__at_eof(j->s)) return STBI__MARKER_none; + x = stbi__get8(j->s); + if (x != 0x00 && x != 0xff) { + // not a stuffed zero or lead-in to another marker, looks + // like an actual marker, return it + return x; + } + // stuffed zero has x=0 now which ends the loop, meaning we go + // back to regular scan loop. + // repeated 0xff keeps trying to read the next byte of the marker. + } + } + return STBI__MARKER_none; +} + // decode image to YCbCr format static int stbi__decode_jpeg_image(stbi__jpeg *j) { @@ -3320,25 +3422,22 @@ static int stbi__decode_jpeg_image(stbi__jpeg *j) if (!stbi__process_scan_header(j)) return 0; if (!stbi__parse_entropy_coded_data(j)) return 0; if (j->marker == STBI__MARKER_none ) { - // handle 0s at the end of image data from IP Kamera 9060 - while (!stbi__at_eof(j->s)) { - int x = stbi__get8(j->s); - if (x == 255) { - j->marker = stbi__get8(j->s); - break; - } - } + j->marker = stbi__skip_jpeg_junk_at_end(j); // if we reach eof without hitting a marker, stbi__get_marker() below will fail and we'll eventually return 0 } + m = stbi__get_marker(j); + if (STBI__RESTART(m)) + m = stbi__get_marker(j); } else if (stbi__DNL(m)) { int Ld = stbi__get16be(j->s); stbi__uint32 NL = stbi__get16be(j->s); if (Ld != 4) return stbi__err("bad DNL len", "Corrupt JPEG"); if (NL != j->s->img_y) return stbi__err("bad DNL height", "Corrupt JPEG"); + m = stbi__get_marker(j); } else { - if (!stbi__process_marker(j, m)) return 0; + if (!stbi__process_marker(j, m)) return 1; + m = stbi__get_marker(j); } - m = stbi__get_marker(j); } if (j->progressive) stbi__jpeg_finish(j); @@ -3782,6 +3881,10 @@ static stbi_uc *load_jpeg_image(stbi__jpeg *z, int *out_x, int *out_y, int *comp else decode_n = z->s->img_n; + // nothing to do if no components requested; check this now to avoid + // accessing uninitialized coutput[0] later + if (decode_n <= 0) { stbi__cleanup_jpeg(z); return NULL; } + // resample and color-convert { int k; @@ -3924,6 +4027,8 @@ static void *stbi__jpeg_load(stbi__context *s, int *x, int *y, int *comp, int re { unsigned char* result; stbi__jpeg* j = (stbi__jpeg*) stbi__malloc(sizeof(stbi__jpeg)); + if (!j) return stbi__errpuc("outofmem", "Out of memory"); + memset(j, 0, sizeof(stbi__jpeg)); STBI_NOTUSED(ri); j->s = s; stbi__setup_jpeg(j); @@ -3936,6 +4041,8 @@ static int stbi__jpeg_test(stbi__context *s) { int r; stbi__jpeg* j = (stbi__jpeg*)stbi__malloc(sizeof(stbi__jpeg)); + if (!j) return stbi__err("outofmem", "Out of memory"); + memset(j, 0, sizeof(stbi__jpeg)); j->s = s; stbi__setup_jpeg(j); r = stbi__decode_jpeg_header(j, STBI__SCAN_type); @@ -3960,6 +4067,8 @@ static int stbi__jpeg_info(stbi__context *s, int *x, int *y, int *comp) { int result; stbi__jpeg* j = (stbi__jpeg*) (stbi__malloc(sizeof(stbi__jpeg))); + if (!j) return stbi__err("outofmem", "Out of memory"); + memset(j, 0, sizeof(stbi__jpeg)); j->s = s; result = stbi__jpeg_info_raw(j, x, y, comp); STBI_FREE(j); @@ -3979,6 +4088,7 @@ static int stbi__jpeg_info(stbi__context *s, int *x, int *y, int *comp) // fast-way is faster to check than jpeg huffman, but slow way is slower #define STBI__ZFAST_BITS 9 // accelerate all cases in default tables #define STBI__ZFAST_MASK ((1 << STBI__ZFAST_BITS) - 1) +#define STBI__ZNSYMS 288 // number of symbols in literal/length alphabet // zlib-style huffman encoding // (jpegs packs from left, zlib from right, so can't share code) @@ -3988,8 +4098,8 @@ typedef struct stbi__uint16 firstcode[16]; int maxcode[17]; stbi__uint16 firstsymbol[16]; - stbi_uc size[288]; - stbi__uint16 value[288]; + stbi_uc size[STBI__ZNSYMS]; + stbi__uint16 value[STBI__ZNSYMS]; } stbi__zhuffman; stbi_inline static int stbi__bitreverse16(int n) @@ -4120,7 +4230,7 @@ static int stbi__zhuffman_decode_slowpath(stbi__zbuf *a, stbi__zhuffman *z) if (s >= 16) return -1; // invalid code! // code size is s, so: b = (k >> (16-s)) - z->firstcode[s] + z->firstsymbol[s]; - if ((unsigned int)b >= sizeof (z->size)) return -1; // some data was corrupt somewhere! + if (b >= STBI__ZNSYMS) return -1; // some data was corrupt somewhere! if (z->size[b] != s) return -1; // was originally an assert, but report failure instead. a->code_buffer >>= s; a->num_bits -= s; @@ -4201,11 +4311,12 @@ static int stbi__parse_huffman_block(stbi__zbuf *a) a->zout = zout; return 1; } + if (z >= 286) return stbi__err("bad huffman code","Corrupt PNG"); // per DEFLATE, length codes 286 and 287 must not appear in compressed data z -= 257; len = stbi__zlength_base[z]; if (stbi__zlength_extra[z]) len += stbi__zreceive(a, stbi__zlength_extra[z]); z = stbi__zhuffman_decode(a, &a->z_distance); - if (z < 0) return stbi__err("bad huffman code","Corrupt PNG"); + if (z < 0 || z >= 30) return stbi__err("bad huffman code","Corrupt PNG"); // per DEFLATE, distance codes 30 and 31 must not appear in compressed data dist = stbi__zdist_base[z]; if (stbi__zdist_extra[z]) dist += stbi__zreceive(a, stbi__zdist_extra[z]); if (zout - a->zout_start < dist) return stbi__err("bad dist","Corrupt PNG"); @@ -4317,7 +4428,7 @@ static int stbi__parse_zlib_header(stbi__zbuf *a) return 1; } -static const stbi_uc stbi__zdefault_length[288] = +static const stbi_uc stbi__zdefault_length[STBI__ZNSYMS] = { 8,8,8,8,8,8,8,8,8,8,8,8,8,8,8,8, 8,8,8,8,8,8,8,8,8,8,8,8,8,8,8,8, 8,8,8,8,8,8,8,8,8,8,8,8,8,8,8,8, 8,8,8,8,8,8,8,8,8,8,8,8,8,8,8,8, @@ -4363,7 +4474,7 @@ static int stbi__parse_zlib(stbi__zbuf *a, int parse_header) } else { if (type == 1) { // use fixed code lengths - if (!stbi__zbuild_huffman(&a->z_length , stbi__zdefault_length , 288)) return 0; + if (!stbi__zbuild_huffman(&a->z_length , stbi__zdefault_length , STBI__ZNSYMS)) return 0; if (!stbi__zbuild_huffman(&a->z_distance, stbi__zdefault_distance, 32)) return 0; } else { if (!stbi__compute_huffman_codes(a)) return 0; @@ -4759,6 +4870,7 @@ static int stbi__create_png_image(stbi__png *a, stbi_uc *image_data, stbi__uint3 // de-interlacing final = (stbi_uc *) stbi__malloc_mad3(a->s->img_x, a->s->img_y, out_bytes, 0); + if (!final) return stbi__err("outofmem", "Out of memory"); for (p=0; p < 7; ++p) { int xorig[] = { 0,4,0,2,0,1,0 }; int yorig[] = { 0,0,4,0,2,0,1 }; @@ -4879,19 +4991,46 @@ static int stbi__expand_png_palette(stbi__png *a, stbi_uc *palette, int len, int return 1; } -static int stbi__unpremultiply_on_load = 0; -static int stbi__de_iphone_flag = 0; +static int stbi__unpremultiply_on_load_global = 0; +static int stbi__de_iphone_flag_global = 0; STBIDEF void stbi_set_unpremultiply_on_load(int flag_true_if_should_unpremultiply) { - stbi__unpremultiply_on_load = flag_true_if_should_unpremultiply; + stbi__unpremultiply_on_load_global = flag_true_if_should_unpremultiply; } STBIDEF void stbi_convert_iphone_png_to_rgb(int flag_true_if_should_convert) { - stbi__de_iphone_flag = flag_true_if_should_convert; + stbi__de_iphone_flag_global = flag_true_if_should_convert; } +#ifndef STBI_THREAD_LOCAL +#define stbi__unpremultiply_on_load stbi__unpremultiply_on_load_global +#define stbi__de_iphone_flag stbi__de_iphone_flag_global +#else +static STBI_THREAD_LOCAL int stbi__unpremultiply_on_load_local, stbi__unpremultiply_on_load_set; +static STBI_THREAD_LOCAL int stbi__de_iphone_flag_local, stbi__de_iphone_flag_set; + +STBIDEF void stbi_set_unpremultiply_on_load_thread(int flag_true_if_should_unpremultiply) +{ + stbi__unpremultiply_on_load_local = flag_true_if_should_unpremultiply; + stbi__unpremultiply_on_load_set = 1; +} + +STBIDEF void stbi_convert_iphone_png_to_rgb_thread(int flag_true_if_should_convert) +{ + stbi__de_iphone_flag_local = flag_true_if_should_convert; + stbi__de_iphone_flag_set = 1; +} + +#define stbi__unpremultiply_on_load (stbi__unpremultiply_on_load_set \ + ? stbi__unpremultiply_on_load_local \ + : stbi__unpremultiply_on_load_global) +#define stbi__de_iphone_flag (stbi__de_iphone_flag_set \ + ? stbi__de_iphone_flag_local \ + : stbi__de_iphone_flag_global) +#endif // STBI_THREAD_LOCAL + static void stbi__de_iphone(stbi__png *z) { stbi__context *s = z->s; @@ -4941,7 +5080,7 @@ static int stbi__parse_png_file(stbi__png *z, int scan, int req_comp) { stbi_uc palette[1024], pal_img_n=0; stbi_uc has_trans=0, tc[3]={0}; - stbi__uint16 tc16[3]={0}; + stbi__uint16 tc16[3]; stbi__uint32 ioff=0, idata_limit=0, i, pal_len=0; int first=1,k,interlace=0, color=0, is_iphone=0; stbi__context *s = z->s; @@ -4981,14 +5120,13 @@ static int stbi__parse_png_file(stbi__png *z, int scan, int req_comp) if (!pal_img_n) { s->img_n = (color & 2 ? 3 : 1) + (color & 4 ? 1 : 0); if ((1 << 30) / s->img_x / s->img_n < s->img_y) return stbi__err("too large", "Image too large to decode"); - if (scan == STBI__SCAN_header) return 1; } else { // if paletted, then pal_n is our final components, and // img_n is # components to decompress/filter. s->img_n = 1; if ((1 << 30) / s->img_x / 4 < s->img_y) return stbi__err("too large","Corrupt PNG"); - // if SCAN_header, have to scan to see if we have a tRNS } + // even with SCAN_header, have to scan to see if we have a tRNS break; } @@ -5020,6 +5158,8 @@ static int stbi__parse_png_file(stbi__png *z, int scan, int req_comp) if (!(s->img_n & 1)) return stbi__err("tRNS with alpha","Corrupt PNG"); if (c.length != (stbi__uint32) s->img_n*2) return stbi__err("bad tRNS len","Corrupt PNG"); has_trans = 1; + // non-paletted with tRNS = constant alpha. if header-scanning, we can stop now. + if (scan == STBI__SCAN_header) { ++s->img_n; return 1; } if (z->depth == 16) { for (k = 0; k < s->img_n; ++k) tc16[k] = (stbi__uint16)stbi__get16be(s); // copy the values as-is } else { @@ -5032,7 +5172,13 @@ static int stbi__parse_png_file(stbi__png *z, int scan, int req_comp) case STBI__PNG_TYPE('I','D','A','T'): { if (first) return stbi__err("first not IHDR", "Corrupt PNG"); if (pal_img_n && !pal_len) return stbi__err("no PLTE","Corrupt PNG"); - if (scan == STBI__SCAN_header) { s->img_n = pal_img_n; return 1; } + if (scan == STBI__SCAN_header) { + // header scan definitely stops at first IDAT + if (pal_img_n) + s->img_n = pal_img_n; + return 1; + } + if (c.length > (1u << 30)) return stbi__err("IDAT size limit", "IDAT section larger than 2^30 bytes"); if ((int)(ioff + c.length) < (int)ioff) return 0; if (ioff + c.length > idata_limit) { stbi__uint32 idata_limit_old = idata_limit; @@ -5272,6 +5418,32 @@ typedef struct int extra_read; } stbi__bmp_data; +static int stbi__bmp_set_mask_defaults(stbi__bmp_data *info, int compress) +{ + // BI_BITFIELDS specifies masks explicitly, don't override + if (compress == 3) + return 1; + + if (compress == 0) { + if (info->bpp == 16) { + info->mr = 31u << 10; + info->mg = 31u << 5; + info->mb = 31u << 0; + } else if (info->bpp == 32) { + info->mr = 0xffu << 16; + info->mg = 0xffu << 8; + info->mb = 0xffu << 0; + info->ma = 0xffu << 24; + info->all_a = 0; // if all_a is 0 at end, then we loaded alpha channel but it was all 0 + } else { + // otherwise, use defaults, which is all-0 + info->mr = info->mg = info->mb = info->ma = 0; + } + return 1; + } + return 0; // error +} + static void *stbi__bmp_parse_header(stbi__context *s, stbi__bmp_data *info) { int hsz; @@ -5299,6 +5471,8 @@ static void *stbi__bmp_parse_header(stbi__context *s, stbi__bmp_data *info) if (hsz != 12) { int compress = stbi__get32le(s); if (compress == 1 || compress == 2) return stbi__errpuc("BMP RLE", "BMP type not supported: RLE"); + if (compress >= 4) return stbi__errpuc("BMP JPEG/PNG", "BMP type not supported: unsupported compression"); // this includes PNG/JPEG modes + if (compress == 3 && info->bpp != 16 && info->bpp != 32) return stbi__errpuc("bad BMP", "bad BMP"); // bitfields requires 16 or 32 bits/pixel stbi__get32le(s); // discard sizeof stbi__get32le(s); // discard hres stbi__get32le(s); // discard vres @@ -5313,17 +5487,7 @@ static void *stbi__bmp_parse_header(stbi__context *s, stbi__bmp_data *info) } if (info->bpp == 16 || info->bpp == 32) { if (compress == 0) { - if (info->bpp == 32) { - info->mr = 0xffu << 16; - info->mg = 0xffu << 8; - info->mb = 0xffu << 0; - info->ma = 0xffu << 24; - info->all_a = 0; // if all_a is 0 at end, then we loaded alpha channel but it was all 0 - } else { - info->mr = 31u << 10; - info->mg = 31u << 5; - info->mb = 31u << 0; - } + stbi__bmp_set_mask_defaults(info, compress); } else if (compress == 3) { info->mr = stbi__get32le(s); info->mg = stbi__get32le(s); @@ -5338,6 +5502,7 @@ static void *stbi__bmp_parse_header(stbi__context *s, stbi__bmp_data *info) return stbi__errpuc("bad BMP", "bad BMP"); } } else { + // V4/V5 header int i; if (hsz != 108 && hsz != 124) return stbi__errpuc("bad BMP", "bad BMP"); @@ -5345,6 +5510,8 @@ static void *stbi__bmp_parse_header(stbi__context *s, stbi__bmp_data *info) info->mg = stbi__get32le(s); info->mb = stbi__get32le(s); info->ma = stbi__get32le(s); + if (compress != 3) // override mr/mg/mb unless in BI_BITFIELDS mode, as per docs + stbi__bmp_set_mask_defaults(info, compress); stbi__get32le(s); // discard color space for (i=0; i < 12; ++i) stbi__get32le(s); // discard color space parameters @@ -5394,9 +5561,22 @@ static void *stbi__bmp_load(stbi__context *s, int *x, int *y, int *comp, int req psize = (info.offset - info.extra_read - info.hsz) >> 2; } if (psize == 0) { - STBI_ASSERT(info.offset == s->callback_already_read + (int) (s->img_buffer - s->img_buffer_original)); - if (info.offset != s->callback_already_read + (s->img_buffer - s->buffer_start)) { - return stbi__errpuc("bad offset", "Corrupt BMP"); + // accept some number of extra bytes after the header, but if the offset points either to before + // the header ends or implies a large amount of extra data, reject the file as malformed + int bytes_read_so_far = s->callback_already_read + (int)(s->img_buffer - s->img_buffer_original); + int header_limit = 1024; // max we actually read is below 256 bytes currently. + int extra_data_limit = 256*4; // what ordinarily goes here is a palette; 256 entries*4 bytes is its max size. + if (bytes_read_so_far <= 0 || bytes_read_so_far > header_limit) { + return stbi__errpuc("bad header", "Corrupt BMP"); + } + // we established that bytes_read_so_far is positive and sensible. + // the first half of this test rejects offsets that are either too small positives, or + // negative, and guarantees that info.offset >= bytes_read_so_far > 0. this in turn + // ensures the number computed in the second half of the test can't overflow. + if (info.offset < bytes_read_so_far || info.offset - bytes_read_so_far > extra_data_limit) { + return stbi__errpuc("bad offset", "Corrupt BMP"); + } else { + stbi__skip(s, info.offset - bytes_read_so_far); } } @@ -6342,6 +6522,7 @@ static void *stbi__pic_load(stbi__context *s,int *px,int *py,int *comp,int req_c // intermediate buffer is RGBA result = (stbi_uc *) stbi__malloc_mad3(x, y, 4, 0); + if (!result) return stbi__errpuc("outofmem", "Out of memory"); memset(result, 0xff, x*y*4); if (!stbi__pic_load_core(s,x,y,comp, result)) { @@ -6457,6 +6638,7 @@ static int stbi__gif_header(stbi__context *s, stbi__gif *g, int *comp, int is_in static int stbi__gif_info_raw(stbi__context *s, int *x, int *y, int *comp) { stbi__gif* g = (stbi__gif*) stbi__malloc(sizeof(stbi__gif)); + if (!g) return stbi__err("outofmem", "Out of memory"); if (!stbi__gif_header(s, g, comp, 1)) { STBI_FREE(g); stbi__rewind( s ); @@ -6766,6 +6948,17 @@ static stbi_uc *stbi__gif_load_next(stbi__context *s, stbi__gif *g, int *comp, i } } +static void *stbi__load_gif_main_outofmem(stbi__gif *g, stbi_uc *out, int **delays) +{ + STBI_FREE(g->out); + STBI_FREE(g->history); + STBI_FREE(g->background); + + if (out) STBI_FREE(out); + if (delays && *delays) STBI_FREE(*delays); + return stbi__errpuc("outofmem", "Out of memory"); +} + static void *stbi__load_gif_main(stbi__context *s, int **delays, int *x, int *y, int *z, int *comp, int req_comp) { if (stbi__gif_test(s)) { @@ -6775,6 +6968,12 @@ static void *stbi__load_gif_main(stbi__context *s, int **delays, int *x, int *y, stbi_uc *two_back = 0; stbi__gif g; int stride; + int out_size = 0; + int delays_size = 0; + + STBI_NOTUSED(out_size); + STBI_NOTUSED(delays_size); + memset(&g, 0, sizeof(g)); if (delays) { *delays = 0; @@ -6791,24 +6990,31 @@ static void *stbi__load_gif_main(stbi__context *s, int **delays, int *x, int *y, stride = g.w * g.h * 4; if (out) { - void *tmp = (stbi_uc*) STBI_REALLOC( out, layers * stride ); - if (NULL == tmp) { - STBI_FREE(g.out); - STBI_FREE(g.history); - STBI_FREE(g.background); - return stbi__errpuc("outofmem", "Out of memory"); - } + void *tmp = (stbi_uc*) STBI_REALLOC_SIZED( out, out_size, layers * stride ); + if (!tmp) + return stbi__load_gif_main_outofmem(&g, out, delays); else { out = (stbi_uc*) tmp; + out_size = layers * stride; } if (delays) { - *delays = (int*) STBI_REALLOC( *delays, sizeof(int) * layers ); + int *new_delays = (int*) STBI_REALLOC_SIZED( *delays, delays_size, sizeof(int) * layers ); + if (!new_delays) + return stbi__load_gif_main_outofmem(&g, out, delays); + *delays = new_delays; + delays_size = layers * sizeof(int); } } else { out = (stbi_uc*)stbi__malloc( layers * stride ); + if (!out) + return stbi__load_gif_main_outofmem(&g, out, delays); + out_size = layers * stride; if (delays) { *delays = (int*) stbi__malloc( layers * sizeof(int) ); + if (!*delays) + return stbi__load_gif_main_outofmem(&g, out, delays); + delays_size = layers * sizeof(int); } } memcpy( out + ((layers - 1) * stride), u, stride ); @@ -7058,12 +7264,12 @@ static float *stbi__hdr_load(stbi__context *s, int *x, int *y, int *comp, int re // Run value = stbi__get8(s); count -= 128; - if (count > nleft) { STBI_FREE(hdr_data); STBI_FREE(scanline); return stbi__errpf("corrupt", "bad RLE data in HDR"); } + if ((count == 0) || (count > nleft)) { STBI_FREE(hdr_data); STBI_FREE(scanline); return stbi__errpf("corrupt", "bad RLE data in HDR"); } for (z = 0; z < count; ++z) scanline[i++ * 4 + k] = value; } else { // Dump - if (count > nleft) { STBI_FREE(hdr_data); STBI_FREE(scanline); return stbi__errpf("corrupt", "bad RLE data in HDR"); } + if ((count == 0) || (count > nleft)) { STBI_FREE(hdr_data); STBI_FREE(scanline); return stbi__errpf("corrupt", "bad RLE data in HDR"); } for (z = 0; z < count; ++z) scanline[i++ * 4 + k] = stbi__get8(s); } @@ -7132,9 +7338,10 @@ static int stbi__bmp_info(stbi__context *s, int *x, int *y, int *comp) info.all_a = 255; p = stbi__bmp_parse_header(s, &info); - stbi__rewind( s ); - if (p == NULL) + if (p == NULL) { + stbi__rewind( s ); return 0; + } if (x) *x = s->img_x; if (y) *y = s->img_y; if (comp) { @@ -7200,8 +7407,8 @@ static int stbi__psd_is16(stbi__context *s) stbi__rewind( s ); return 0; } - (void) stbi__get32be(s); - (void) stbi__get32be(s); + STBI_NOTUSED(stbi__get32be(s)); + STBI_NOTUSED(stbi__get32be(s)); depth = stbi__get16be(s); if (depth != 16) { stbi__rewind( s ); @@ -7280,7 +7487,6 @@ static int stbi__pic_info(stbi__context *s, int *x, int *y, int *comp) // Known limitations: // Does not support comments in the header section // Does not support ASCII image data (formats P2 and P3) -// Does not support 16-bit-per-channel #ifndef STBI_NO_PNM @@ -7301,7 +7507,8 @@ static void *stbi__pnm_load(stbi__context *s, int *x, int *y, int *comp, int req stbi_uc *out; STBI_NOTUSED(ri); - if (!stbi__pnm_info(s, (int *)&s->img_x, (int *)&s->img_y, (int *)&s->img_n)) + ri->bits_per_channel = stbi__pnm_info(s, (int *)&s->img_x, (int *)&s->img_y, (int *)&s->img_n); + if (ri->bits_per_channel == 0) return 0; if (s->img_y > STBI_MAX_DIMENSIONS) return stbi__errpuc("too large","Very large image (corrupt?)"); @@ -7311,15 +7518,22 @@ static void *stbi__pnm_load(stbi__context *s, int *x, int *y, int *comp, int req *y = s->img_y; if (comp) *comp = s->img_n; - if (!stbi__mad3sizes_valid(s->img_n, s->img_x, s->img_y, 0)) + if (!stbi__mad4sizes_valid(s->img_n, s->img_x, s->img_y, ri->bits_per_channel / 8, 0)) return stbi__errpuc("too large", "PNM too large"); - out = (stbi_uc *) stbi__malloc_mad3(s->img_n, s->img_x, s->img_y, 0); + out = (stbi_uc *) stbi__malloc_mad4(s->img_n, s->img_x, s->img_y, ri->bits_per_channel / 8, 0); if (!out) return stbi__errpuc("outofmem", "Out of memory"); - stbi__getn(s, out, s->img_n * s->img_x * s->img_y); + if (!stbi__getn(s, out, s->img_n * s->img_x * s->img_y * (ri->bits_per_channel / 8))) { + STBI_FREE(out); + return stbi__errpuc("bad PNM", "PNM file truncated"); + } if (req_comp && req_comp != s->img_n) { - out = stbi__convert_format(out, s->img_n, req_comp, s->img_x, s->img_y); + if (ri->bits_per_channel == 16) { + out = (stbi_uc *) stbi__convert_format16((stbi__uint16 *) out, s->img_n, req_comp, s->img_x, s->img_y); + } else { + out = stbi__convert_format(out, s->img_n, req_comp, s->img_x, s->img_y); + } if (out == NULL) return out; // stbi__convert_format frees input on failure } return out; @@ -7356,6 +7570,8 @@ static int stbi__pnm_getinteger(stbi__context *s, char *c) while (!stbi__at_eof(s) && stbi__pnm_isdigit(*c)) { value = value*10 + (*c - '0'); *c = (char) stbi__get8(s); + if((value > 214748364) || (value == 214748364 && *c > '7')) + return stbi__err("integer parse overflow", "Parsing an integer in the PPM header overflowed a 32-bit int"); } return value; @@ -7386,17 +7602,29 @@ static int stbi__pnm_info(stbi__context *s, int *x, int *y, int *comp) stbi__pnm_skip_whitespace(s, &c); *x = stbi__pnm_getinteger(s, &c); // read width + if(*x == 0) + return stbi__err("invalid width", "PPM image header had zero or overflowing width"); stbi__pnm_skip_whitespace(s, &c); *y = stbi__pnm_getinteger(s, &c); // read height + if (*y == 0) + return stbi__err("invalid width", "PPM image header had zero or overflowing width"); stbi__pnm_skip_whitespace(s, &c); maxv = stbi__pnm_getinteger(s, &c); // read max value - - if (maxv > 255) - return stbi__err("max value > 255", "PPM image not 8-bit"); + if (maxv > 65535) + return stbi__err("max value > 65535", "PPM image supports only 8-bit and 16-bit images"); + else if (maxv > 255) + return 16; else - return 1; + return 8; +} + +static int stbi__pnm_is16(stbi__context *s) +{ + if (stbi__pnm_info(s, NULL, NULL, NULL) == 16) + return 1; + return 0; } #endif @@ -7452,6 +7680,9 @@ static int stbi__is_16_main(stbi__context *s) if (stbi__psd_is16(s)) return 1; #endif + #ifndef STBI_NO_PNM + if (stbi__pnm_is16(s)) return 1; + #endif return 0; } From 011382424b9bea9984f294a2cf7ec43f378c4e6c Mon Sep 17 00:00:00 2001 From: Urs Hanselmann Date: Fri, 3 Mar 2023 19:31:50 +0100 Subject: [PATCH 11/61] remove debug message from MemoryIOStream (used by public Importer::ReadFileFromMemory method) --- include/assimp/MemoryIOWrapper.h | 1 - 1 file changed, 1 deletion(-) diff --git a/include/assimp/MemoryIOWrapper.h b/include/assimp/MemoryIOWrapper.h index 77071e96f..1b986ff1b 100644 --- a/include/assimp/MemoryIOWrapper.h +++ b/include/assimp/MemoryIOWrapper.h @@ -150,7 +150,6 @@ public: // ------------------------------------------------------------------- /// @brief Tests for the existence of a file at the given path. bool Exists(const char* pFile) const override { - printf("Exists\n"); if (0 == strncmp( pFile, AI_MEMORYIO_MAGIC_FILENAME, AI_MEMORYIO_MAGIC_FILENAME_LENGTH ) ) { return true; } From 424f53b4d6055abb582741377f900cbf5b7bdf9a Mon Sep 17 00:00:00 2001 From: Jackie9527 <80555200+Jackie9527@users.noreply.github.com> Date: Sat, 25 Feb 2023 10:08:40 +0800 Subject: [PATCH 12/61] bugfix remove duplicated data. Signed-off-by: Jackie9527 <80555200+Jackie9527@users.noreply.github.com> --- code/AssetLib/FBX/FBXConverter.cpp | 33 ++++++++++++++++----------- code/AssetLib/FBX/FBXDeformer.cpp | 12 ++++++---- code/AssetLib/FBX/FBXDocument.h | 9 ++++---- code/AssetLib/FBX/FBXMeshGeometry.cpp | 7 ++++-- code/AssetLib/FBX/FBXMeshGeometry.h | 9 ++++---- 5 files changed, 43 insertions(+), 27 deletions(-) diff --git a/code/AssetLib/FBX/FBXConverter.cpp b/code/AssetLib/FBX/FBXConverter.cpp index d45919e10..e77dd2fc6 100644 --- a/code/AssetLib/FBX/FBXConverter.cpp +++ b/code/AssetLib/FBX/FBXConverter.cpp @@ -1176,15 +1176,23 @@ unsigned int FBXConverter::ConvertMeshSingleMaterial(const MeshGeometry &mesh, c std::vector animMeshes; for (const BlendShape *blendShape : mesh.GetBlendShapes()) { for (const BlendShapeChannel *blendShapeChannel : blendShape->BlendShapeChannels()) { - const std::vector &shapeGeometries = blendShapeChannel->GetShapeGeometries(); - for (size_t i = 0; i < shapeGeometries.size(); i++) { + const auto& shapeGeometries = blendShapeChannel->GetShapeGeometries(); + for (const ShapeGeometry *shapeGeometry : shapeGeometries) { aiAnimMesh *animMesh = aiCreateAnimMesh(out_mesh); - const ShapeGeometry *shapeGeometry = shapeGeometries.at(i); - const std::vector &curVertices = shapeGeometry->GetVertices(); - const std::vector &curNormals = shapeGeometry->GetNormals(); - const std::vector &curIndices = shapeGeometry->GetIndices(); + const auto &curVertices = shapeGeometry->GetVertices(); + const auto &curNormals = shapeGeometry->GetNormals(); + const auto &curIndices = shapeGeometry->GetIndices(); //losing channel name if using shapeGeometry->Name() - animMesh->mName.Set(FixAnimMeshName(blendShapeChannel->Name())); + // if blendShapeChannel Name is empty or don't have a ".", add geoMetryName; + auto aniName = FixAnimMeshName(blendShapeChannel->Name()); + auto geoMetryName = FixAnimMeshName(shapeGeometry->Name()); + if (aniName.empty()) { + aniName = geoMetryName; + } + else if (aniName.find('.') == aniName.npos) { + aniName += "." + geoMetryName; + } + animMesh->mName.Set(aniName); for (size_t j = 0; j < curIndices.size(); j++) { const unsigned int curIndex = curIndices.at(j); aiVector3D vertex = curVertices.at(j); @@ -1406,13 +1414,12 @@ unsigned int FBXConverter::ConvertMeshMultiMaterial(const MeshGeometry &mesh, co std::vector animMeshes; for (const BlendShape *blendShape : mesh.GetBlendShapes()) { for (const BlendShapeChannel *blendShapeChannel : blendShape->BlendShapeChannels()) { - const std::vector &shapeGeometries = blendShapeChannel->GetShapeGeometries(); - for (size_t i = 0; i < shapeGeometries.size(); i++) { + const auto& shapeGeometries = blendShapeChannel->GetShapeGeometries(); + for (const ShapeGeometry *shapeGeometry : shapeGeometries) { aiAnimMesh *animMesh = aiCreateAnimMesh(out_mesh); - const ShapeGeometry *shapeGeometry = shapeGeometries.at(i); - const std::vector &curVertices = shapeGeometry->GetVertices(); - const std::vector &curNormals = shapeGeometry->GetNormals(); - const std::vector &curIndices = shapeGeometry->GetIndices(); + const auto& curVertices = shapeGeometry->GetVertices(); + const auto& curNormals = shapeGeometry->GetNormals(); + const auto& curIndices = shapeGeometry->GetIndices(); animMesh->mName.Set(FixAnimMeshName(shapeGeometry->Name())); for (size_t j = 0; j < curIndices.size(); j++) { unsigned int curIndex = curIndices.at(j); diff --git a/code/AssetLib/FBX/FBXDeformer.cpp b/code/AssetLib/FBX/FBXDeformer.cpp index df134a401..1aab55ea9 100644 --- a/code/AssetLib/FBX/FBXDeformer.cpp +++ b/code/AssetLib/FBX/FBXDeformer.cpp @@ -154,8 +154,10 @@ BlendShape::BlendShape(uint64_t id, const Element& element, const Document& doc, for (const Connection* con : conns) { const BlendShapeChannel* const bspc = ProcessSimpleConnection(*con, false, "BlendShapeChannel -> BlendShape", element); if (bspc) { - blendShapeChannels.push_back(bspc); - continue; + auto pr = blendShapeChannels.insert(bspc); + if (!pr.second) { + FBXImporter::LogWarn("there is the same blendShapeChannel id ", bspc->ID()); + } } } } @@ -179,8 +181,10 @@ BlendShapeChannel::BlendShapeChannel(uint64_t id, const Element& element, const for (const Connection* con : conns) { const ShapeGeometry* const sg = ProcessSimpleConnection(*con, false, "Shape -> BlendShapeChannel", element); if (sg) { - shapeGeometries.push_back(sg); - continue; + auto pr = shapeGeometries.insert(sg); + if (!pr.second) { + FBXImporter::LogWarn("there is the same shapeGeometrie id ", sg->ID()); + } } } } diff --git a/code/AssetLib/FBX/FBXDocument.h b/code/AssetLib/FBX/FBXDocument.h index 8873d65fd..821d4d5cb 100644 --- a/code/AssetLib/FBX/FBXDocument.h +++ b/code/AssetLib/FBX/FBXDocument.h @@ -46,6 +46,7 @@ OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. #define INCLUDED_AI_FBX_DOCUMENT_H #include +#include #include #include #include "FBXProperties.h" @@ -855,14 +856,14 @@ public: return fullWeights; } - const std::vector& GetShapeGeometries() const { + const std::unordered_set& GetShapeGeometries() const { return shapeGeometries; } private: float percent; WeightArray fullWeights; - std::vector shapeGeometries; + std::unordered_set shapeGeometries; }; /** DOM class for BlendShape deformers */ @@ -872,12 +873,12 @@ public: virtual ~BlendShape(); - const std::vector& BlendShapeChannels() const { + const std::unordered_set& BlendShapeChannels() const { return blendShapeChannels; } private: - std::vector blendShapeChannels; + std::unordered_set blendShapeChannels; }; /** DOM class for skin deformer clusters (aka sub-deformers) */ diff --git a/code/AssetLib/FBX/FBXMeshGeometry.cpp b/code/AssetLib/FBX/FBXMeshGeometry.cpp index ace4ad749..fcbaac169 100644 --- a/code/AssetLib/FBX/FBXMeshGeometry.cpp +++ b/code/AssetLib/FBX/FBXMeshGeometry.cpp @@ -69,13 +69,16 @@ Geometry::Geometry(uint64_t id, const Element& element, const std::string& name, } const BlendShape* const bsp = ProcessSimpleConnection(*con, false, "BlendShape -> Geometry", element); if (bsp) { - blendShapes.push_back(bsp); + auto pr = blendShapes.insert(bsp); + if (!pr.second) { + FBXImporter::LogWarn("there is the same blendShape id ", bsp->ID()); + } } } } // ------------------------------------------------------------------------------------------------ -const std::vector& Geometry::GetBlendShapes() const { +const std::unordered_set& Geometry::GetBlendShapes() const { return blendShapes; } diff --git a/code/AssetLib/FBX/FBXMeshGeometry.h b/code/AssetLib/FBX/FBXMeshGeometry.h index f4a1a2673..3d67ec567 100644 --- a/code/AssetLib/FBX/FBXMeshGeometry.h +++ b/code/AssetLib/FBX/FBXMeshGeometry.h @@ -62,7 +62,7 @@ public: /// @param name The name instance /// @param doc The document instance Geometry( uint64_t id, const Element& element, const std::string& name, const Document& doc ); - + /// @brief The class destructor, default. virtual ~Geometry() = default; @@ -72,11 +72,12 @@ public: /// @brief Get the BlendShape attached to this geometry or nullptr /// @return The blendshape arrays. - const std::vector& GetBlendShapes() const; + const std::unordered_set& GetBlendShapes() const; private: const Skin* skin; - std::vector blendShapes; + std::unordered_set blendShapes; + }; typedef std::vector MatIndexArray; @@ -112,7 +113,7 @@ public: /// @return The binomal vector. const std::vector& GetBinormals() const; - /// @brief Return list of faces - each entry denotes a face and specifies how many vertices it has. + /// @brief Return list of faces - each entry denotes a face and specifies how many vertices it has. /// Vertices are taken from the vertex data arrays in sequential order. /// @return The face indices vector. const std::vector& GetFaceIndexCounts() const; From 74c406dd262e3c92229760683ce814d12116ada5 Mon Sep 17 00:00:00 2001 From: Urs Hanselmann Date: Sat, 4 Mar 2023 14:27:58 +0100 Subject: [PATCH 13/61] add ci script to scan for unexpected printf statements --- .github/workflows/sanitizer.yml | 10 ++++++++++ scripts/scan_printf.sh | 20 ++++++++++++++++++++ 2 files changed, 30 insertions(+) create mode 100755 scripts/scan_printf.sh diff --git a/.github/workflows/sanitizer.yml b/.github/workflows/sanitizer.yml index 57d6e78f1..b23f4520f 100644 --- a/.github/workflows/sanitizer.yml +++ b/.github/workflows/sanitizer.yml @@ -57,3 +57,13 @@ jobs: - name: test run: cd build/bin && ./unit shell: bash + + job3: + name: printf-sanitizer + runs-on: ubuntu-latest + steps: + - uses: actions/checkout@v3 + + - name: run scan_printf script + run: ./scripts/scan_printf.sh + shell: bash diff --git a/scripts/scan_printf.sh b/scripts/scan_printf.sh new file mode 100755 index 000000000..b507e6438 --- /dev/null +++ b/scripts/scan_printf.sh @@ -0,0 +1,20 @@ +#!/bin/sh + +PATHS="include code" +FILTER_INCLUDE='\*.{c,cpp,h}' +FILTER_EXCLUDE="{include/assimp/Compiler/pstdint.h,code/AssetLib/M3D/m3d.h}" + +PATTERN='^\s*printf' + +grep \ + --include=\*.{c,cpp,h} \ + --exclude={include/assimp/Compiler/pstdint.h,code/AssetLib/M3D/m3d.h} \ + -rnw include code \ + -e '^\s*printf' + +if [ $? ] +then + echo "Debug statement(s) detected. Please remove, or manually add to exclude filter, if appropriate" + exit 1 +fi + From 1520aff68027047d3c86d64c26f6ee3148af3423 Mon Sep 17 00:00:00 2001 From: Urs Hanselmann Date: Sat, 4 Mar 2023 14:41:10 +0100 Subject: [PATCH 14/61] fix scan_printf script in linux bash --- scripts/scan_printf.sh | 10 ++-------- 1 file changed, 2 insertions(+), 8 deletions(-) diff --git a/scripts/scan_printf.sh b/scripts/scan_printf.sh index b507e6438..90ab7c870 100755 --- a/scripts/scan_printf.sh +++ b/scripts/scan_printf.sh @@ -1,14 +1,8 @@ -#!/bin/sh - -PATHS="include code" -FILTER_INCLUDE='\*.{c,cpp,h}' -FILTER_EXCLUDE="{include/assimp/Compiler/pstdint.h,code/AssetLib/M3D/m3d.h}" - -PATTERN='^\s*printf' +#!/bin/bash grep \ --include=\*.{c,cpp,h} \ - --exclude={include/assimp/Compiler/pstdint.h,code/AssetLib/M3D/m3d.h} \ + --exclude={pstdint,m3d}.h \ -rnw include code \ -e '^\s*printf' From 4fa433c8ff9839ac466c4c4bb333d7113db33d78 Mon Sep 17 00:00:00 2001 From: Urs Hanselmann Date: Sat, 4 Mar 2023 14:52:49 +0100 Subject: [PATCH 15/61] improve scan_printf ci script error message --- scripts/scan_printf.sh | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/scripts/scan_printf.sh b/scripts/scan_printf.sh index 90ab7c870..a71fab756 100755 --- a/scripts/scan_printf.sh +++ b/scripts/scan_printf.sh @@ -8,7 +8,7 @@ grep \ if [ $? ] then - echo "Debug statement(s) detected. Please remove, or manually add to exclude filter, if appropriate" + echo "Debug statement(s) detected. Please uncomment (using single-line comment), remove, or manually add to exclude filter, if appropriate" exit 1 fi From 2efd48dee2208a255ca4bfa3a821bfd3615e6924 Mon Sep 17 00:00:00 2001 From: Urs Hanselmann Date: Sat, 4 Mar 2023 14:53:48 +0100 Subject: [PATCH 16/61] disable another debug print message --- code/AssetLib/Ogre/OgreXmlSerializer.cpp | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/code/AssetLib/Ogre/OgreXmlSerializer.cpp b/code/AssetLib/Ogre/OgreXmlSerializer.cpp index cd9d6dcc2..623f2961e 100644 --- a/code/AssetLib/Ogre/OgreXmlSerializer.cpp +++ b/code/AssetLib/Ogre/OgreXmlSerializer.cpp @@ -490,7 +490,7 @@ bool OgreXmlSerializer::ImportSkeleton(Assimp::IOSystem *pIOHandler, MeshXml *me OgreXmlSerializer serializer(xmlParser.get()); XmlNode root = xmlParser->getRootNode(); if (std::string(root.name()) != nnSkeleton) { - printf("\nSkeleton is not a valid root: %s\n", root.name()); + // printf("\nSkeleton is not a valid root: %s\n", root.name()); for (auto &a : root.children()) { if (std::string(a.name()) == nnSkeleton) { root = a; From dcb89cf1070ed8cc7676f8f00cf8951906d5b2b6 Mon Sep 17 00:00:00 2001 From: Urs Hanselmann Date: Sat, 4 Mar 2023 15:00:43 +0100 Subject: [PATCH 17/61] fix scan_printf script error code handling --- scripts/scan_printf.sh | 3 +-- 1 file changed, 1 insertion(+), 2 deletions(-) diff --git a/scripts/scan_printf.sh b/scripts/scan_printf.sh index a71fab756..f8c902941 100755 --- a/scripts/scan_printf.sh +++ b/scripts/scan_printf.sh @@ -6,8 +6,7 @@ grep \ -rnw include code \ -e '^\s*printf' -if [ $? ] -then +if [ $? -eq 0 ]; then echo "Debug statement(s) detected. Please uncomment (using single-line comment), remove, or manually add to exclude filter, if appropriate" exit 1 fi From c089f117680c4f99f02b4a1e6771fe348acda2dd Mon Sep 17 00:00:00 2001 From: Kim Kulling Date: Mon, 6 Mar 2023 19:56:11 +0100 Subject: [PATCH 18/61] Update utf82utf16. --- include/assimp/types.h | 6 + .../SimpleTexturedDirectx11/main.cpp | 14 +- .../src/model_loading.cpp | 155 ++++++------------ 3 files changed, 64 insertions(+), 111 deletions(-) diff --git a/include/assimp/types.h b/include/assimp/types.h index a41363b8a..be2aad18b 100644 --- a/include/assimp/types.h +++ b/include/assimp/types.h @@ -57,6 +57,12 @@ OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. #include #include +#ifdef ASSIMP_USE_HUNTER +#include +#else +#include "../contrib/utf8cpp/source/utf8.h" +#endif + // Our compile configuration #include diff --git a/samples/SimpleTexturedDirectx11/SimpleTexturedDirectx11/main.cpp b/samples/SimpleTexturedDirectx11/SimpleTexturedDirectx11/main.cpp index 7f0d0c84e..4da5820a1 100644 --- a/samples/SimpleTexturedDirectx11/SimpleTexturedDirectx11/main.cpp +++ b/samples/SimpleTexturedDirectx11/SimpleTexturedDirectx11/main.cpp @@ -13,6 +13,8 @@ // Written by IAS. :) // --------------------------------------------------------------------------- +#include + #include #include #include @@ -21,11 +23,7 @@ #include #include #include -#ifdef ASSIMP_USE_HUNTER -#include -#else -#include "../contrib/utf8cpp/source/utf8.h" -#endif + #include "ModelLoader.h" #include "SafeRelease.hpp" @@ -53,10 +51,10 @@ struct ConstantBuffer { // ------------------------------------------------------------ // Window Variables // ------------------------------------------------------------ -#define SCREEN_WIDTH 800 -#define SCREEN_HEIGHT 600 +static constexpr uint32_t SCREEN_WIDTH = 800; +static constexpr uint32_t SCREEN_HEIGHT = 600; -const char g_szClassName[] = "directxWindowClass"; +constexpr char g_szClassName[] = "directxWindowClass"; static std::string g_ModelPath; diff --git a/samples/SimpleTexturedOpenGL/SimpleTexturedOpenGL/src/model_loading.cpp b/samples/SimpleTexturedOpenGL/SimpleTexturedOpenGL/src/model_loading.cpp index 48066f189..2eb73b403 100644 --- a/samples/SimpleTexturedOpenGL/SimpleTexturedOpenGL/src/model_loading.cpp +++ b/samples/SimpleTexturedOpenGL/SimpleTexturedOpenGL/src/model_loading.cpp @@ -41,15 +41,14 @@ #include #include #include -#include "UTFConverter.h" // The default hard-coded path. Can be overridden by supplying a path through the command line. static std::string modelpath = "../../test/models/OBJ/spider.obj"; -HGLRC hRC=nullptr; // Permanent Rendering Context -HDC hDC=nullptr; // Private GDI Device Context -HWND g_hWnd=nullptr; // Holds Window Handle -HINSTANCE g_hInstance=nullptr; // Holds The Instance Of The Application +HGLRC hRC = nullptr; // Permanent Rendering Context +HDC hDC = nullptr; // Private GDI Device Context +HWND g_hWnd = nullptr; // Holds Window Handle +HINSTANCE g_hInstance = nullptr; // Holds The Instance Of The Application bool keys[256]; // Array used for Keyboard Routine; bool active=TRUE; // Window Active Flag Set To TRUE by Default @@ -69,8 +68,6 @@ GLfloat LightAmbient[]= { 0.5f, 0.5f, 0.5f, 1.0f }; GLfloat LightDiffuse[]= { 1.0f, 1.0f, 1.0f, 1.0f }; GLfloat LightPosition[]= { 0.0f, 0.0f, 15.0f, 1.0f }; - - // the global Assimp scene object const aiScene* g_scene = nullptr; GLuint scene_list = 0; @@ -83,12 +80,8 @@ GLuint* textureIds; // pointer to texture Array // Create an instance of the Importer class Assimp::Importer importer; -using namespace AssimpSamples::SharedCode; - -void createAILogger() -{ - // Change this line to normal if you not want to analyse the import process - //Assimp::Logger::LogSeverity severity = Assimp::Logger::NORMAL; +void createAILogger() { + // Change this line to normal if you not want to analyze the import process Assimp::Logger::LogSeverity severity = Assimp::Logger::VERBOSE; // Create a logger instance for Console Output @@ -101,62 +94,52 @@ void createAILogger() Assimp::DefaultLogger::get()->info("this is my info-call"); } -void destroyAILogger() -{ - // Kill it after the work is done +void destroyAILogger() { Assimp::DefaultLogger::kill(); } -void logInfo(std::string logString) -{ - // Will add message to File with "info" Tag +void logInfo(const std::string &logString) { Assimp::DefaultLogger::get()->info(logString.c_str()); } -void logDebug(const char* logString) -{ - // Will add message to File with "debug" Tag +void logDebug(const char* logString) { Assimp::DefaultLogger::get()->debug(logString); } -bool Import3DFromFile( const std::string& pFile) -{ +bool Import3DFromFile( const std::string &filename) { // Check if file exists - std::ifstream fin(pFile.c_str()); - if(!fin.fail()) - { - fin.close(); + std::ifstream fin(filename.c_str()); + if(fin.fail()) { + std::string message = "Couldn't open file: " + filename; + std::wstring targetMessage; + //utf8::utf8to16(message.c_str(), message.c_str() + message.size(), targetMessage); + ::MessageBox(nullptr, targetMessage.c_str(), L"Error", MB_OK | MB_ICONEXCLAMATION); + logInfo(importer.GetErrorString()); + return false; } - else - { - MessageBox(nullptr, UTFConverter("Couldn't open file: " + pFile).c_wstr() , TEXT("ERROR"), MB_OK | MB_ICONEXCLAMATION); - logInfo( importer.GetErrorString()); - return false; - } - - g_scene = importer.ReadFile(pFile, aiProcessPreset_TargetRealtime_Quality); + + fin.close(); + + g_scene = importer.ReadFile(filename, aiProcessPreset_TargetRealtime_Quality); // If the import failed, report it - if(!g_scene) - { + if (g_scene == nullptr) { logInfo( importer.GetErrorString()); return false; } // Now we can access the file's contents. - logInfo("Import of scene " + pFile + " succeeded."); + logInfo("Import of scene " + filename + " succeeded."); // We're done. Everything will be cleaned up by the importer destructor return true; } // Resize And Initialize The GL Window -void ReSizeGLScene(GLsizei width, GLsizei height) -{ +void ReSizeGLScene(GLsizei width, GLsizei height) { // Prevent A Divide By Zero By - if (height==0) - { + if (height == 0) { // Making Height Equal One height=1; } @@ -174,43 +157,26 @@ void ReSizeGLScene(GLsizei width, GLsizei height) } -std::string getBasePath(const std::string& path) -{ +std::string getBasePath(const std::string& path) { size_t pos = path.find_last_of("\\/"); return (std::string::npos == pos) ? "" : path.substr(0, pos + 1); } -void freeTextureIds() -{ - textureIdMap.clear(); //no need to delete pointers in it manually here. (Pointers point to textureIds deleted in next step) +void freeTextureIds() { + // no need to delete pointers in it manually here. (Pointers point to textureIds deleted in next step) + textureIdMap.clear(); - if (textureIds) - { + if (textureIds) { delete[] textureIds; textureIds = nullptr; } } -int LoadGLTextures(const aiScene* scene) -{ +int LoadGLTextures(const aiScene* scene) { freeTextureIds(); - //ILboolean success; - - /* Before calling ilInit() version should be checked. */ - /*if (ilGetInteger(IL_VERSION_NUM) < IL_VERSION) - { - /// wrong DevIL version /// - std::string err_msg = "Wrong DevIL version. Old devil.dll in system32/SysWow64?"; - char* cErr_msg = (char *) err_msg.c_str(); - abortGLInit(cErr_msg); - return -1; - }*/ - - //ilInit(); /* Initialization of DevIL */ - - if (scene->HasTextures()) return 1; - //abortGLInit("Support for meshes with embedded textures is not implemented"); + if (scene->HasTextures()) + return 1; /* getTexture Filenames and Numb of Textures */ for (unsigned int m=0; mmNumMaterials; m++) @@ -230,14 +196,6 @@ int LoadGLTextures(const aiScene* scene) const size_t numTextures = textureIdMap.size(); - - /* array with DevIL image IDs */ - //ILuint* imageIds = NULL; -// imageIds = new ILuint[numTextures]; - - /* generate DevIL Image IDs */ -// ilGenImages(numTextures, imageIds); /* Generation of numTextures image names */ - /* create and fill array with GL texture ids */ textureIds = new GLuint[numTextures]; glGenTextures(static_cast(numTextures), textureIds); /* Texture name generation */ @@ -248,29 +206,17 @@ int LoadGLTextures(const aiScene* scene) std::string basepath = getBasePath(modelpath); for (size_t i=0; i 1) { std::wstring modelpathW(argv[1]); - modelpath = UTFConverter(modelpathW).str(); + utf8::utf16to8(modelpathW.c_str(), modelpathW.c_str() + modelpathW.size(), back_inserter(modelpath)); } if (!Import3DFromFile(modelpath)) From 8171e041fafea7432b397ef30f7576e0b6156178 Mon Sep 17 00:00:00 2001 From: Kim Kulling Date: Mon, 6 Mar 2023 20:56:09 +0100 Subject: [PATCH 19/61] Update utf82utf16. --- .../src/model_loading.cpp | 32 +++++++++++++------ 1 file changed, 22 insertions(+), 10 deletions(-) diff --git a/samples/SimpleTexturedOpenGL/SimpleTexturedOpenGL/src/model_loading.cpp b/samples/SimpleTexturedOpenGL/SimpleTexturedOpenGL/src/model_loading.cpp index 2eb73b403..89731bd9b 100644 --- a/samples/SimpleTexturedOpenGL/SimpleTexturedOpenGL/src/model_loading.cpp +++ b/samples/SimpleTexturedOpenGL/SimpleTexturedOpenGL/src/model_loading.cpp @@ -233,13 +233,15 @@ int LoadGLTextures(const aiScene* scene) { glPixelStorei( GL_UNPACK_SKIP_PIXELS, 0 ); glPixelStorei( GL_UNPACK_SKIP_ROWS, 0 ); stbi_image_free(data); - } - else - { - /* Error occurred */ + } else { + /* Error occurred */ const std::string message = "Couldn't load Image: " + fileloc; std::wstring targetMessage; - utf8::utf8to16(message.c_str(), message.c_str() + message.size(), back_inserter(targetMessage)); + wchar_t *tmp = new wchar_t[message.size() + 1]; + memset(tmp, L'\0', sizeof(wchar_t) *(message.size() + 1)); + utf8::utf8to16(message.c_str(), message.c_str() + message.size(), tmp); + targetMessage = tmp; + delete [] tmp; MessageBox(nullptr, targetMessage.c_str(), TEXT("ERROR"), MB_OK | MB_ICONEXCLAMATION); } } @@ -535,7 +537,12 @@ GLboolean abortGLInit(const char* abortMessage) KillGLWindow(); const std::string message = abortMessage; std::wstring targetMessage; - utf8::utf8to16(message.c_str(), message.c_str() + message.size(), back_inserter(targetMessage)); + const size_t len = std::strlen(abortMessage) + 1; + wchar_t *tmp = new wchar_t[len]; + memset(tmp, L'\0', len); + utf8::utf8to16(message.c_str(), message.c_str() + message.size(), tmp); + targetMessage = tmp; + delete [] tmp; MessageBox(nullptr, targetMessage.c_str(), TEXT("ERROR"), MB_OK|MB_ICONEXCLAMATION); return FALSE; // quit and return False @@ -587,7 +594,8 @@ BOOL CreateGLWindow(const char* title, int width, int height, int bits, bool ful if (ChangeDisplaySettings(&dmScreenSettings, CDS_FULLSCREEN)!=DISP_CHANGE_SUCCESSFUL) { // If The Mode Fails, Offer Two Options. Quit Or Run In A Window. - if (MessageBox(nullptr,TEXT("The Requested Fullscreen Mode Is Not Supported By\nYour Video Card. Use Windowed Mode Instead?"),TEXT("NeHe GL"),MB_YESNO|MB_ICONEXCLAMATION)==IDYES) + if (MessageBox(nullptr,TEXT("The Requested Fullscreen Mode Is Not Supported By\nYour Video Card. Use Windowed Mode Instead?"), + TEXT("NeHe GL"),MB_YESNO|MB_ICONEXCLAMATION)==IDYES) { fullscreen = FALSE; // Select Windowed Mode (Fullscreen = FALSE) } @@ -618,7 +626,7 @@ BOOL CreateGLWindow(const char* title, int width, int height, int bits, bool ful std::wstring targetMessage; utf8::utf8to16(message.c_str(), message.c_str() + message.size(), back_inserter(targetMessage)); - if (nullptr == (g_hWnd=CreateWindowEx(dwExStyle, // Extended Style For The Window + if (nullptr == (g_hWnd = CreateWindowEx(dwExStyle, // Extended Style For The Window TEXT("OpenGL"), // Class Name targetMessage.c_str(), // Window Title WS_CLIPSIBLINGS | // Required Window Style @@ -792,7 +800,11 @@ int WINAPI WinMain( HINSTANCE /*hInstance*/, // The instance if (argv != nullptr && argc > 1) { std::wstring modelpathW(argv[1]); - utf8::utf16to8(modelpathW.c_str(), modelpathW.c_str() + modelpathW.size(), back_inserter(modelpath)); + char *tmp = new char[modelpathW.size() + 1]; + memset(tmp, '\0', modelpathW.size() + 1); + utf8::utf16to8(modelpathW.c_str(), modelpathW.c_str() + modelpathW.size(), tmp); + modelpath = tmp; + delete[]tmp; } if (!Import3DFromFile(modelpath)) @@ -820,7 +832,7 @@ int WINAPI WinMain( HINSTANCE /*hInstance*/, // The instance { if (msg.message==WM_QUIT) { - done=TRUE; + done = TRUE; } else { From 5082c940d0d76871288024ba406864f36bcc8eb8 Mon Sep 17 00:00:00 2001 From: Kim Kulling Date: Mon, 6 Mar 2023 21:13:40 +0100 Subject: [PATCH 20/61] Fix: Replace back_inserter usage. --- .../SimpleTexturedOpenGL/src/model_loading.cpp | 9 ++++++--- 1 file changed, 6 insertions(+), 3 deletions(-) diff --git a/samples/SimpleTexturedOpenGL/SimpleTexturedOpenGL/src/model_loading.cpp b/samples/SimpleTexturedOpenGL/SimpleTexturedOpenGL/src/model_loading.cpp index 89731bd9b..7d730a630 100644 --- a/samples/SimpleTexturedOpenGL/SimpleTexturedOpenGL/src/model_loading.cpp +++ b/samples/SimpleTexturedOpenGL/SimpleTexturedOpenGL/src/model_loading.cpp @@ -622,9 +622,12 @@ BOOL CreateGLWindow(const char* title, int width, int height, int bits, bool ful AdjustWindowRectEx(&WindowRect, dwStyle, FALSE, dwExStyle); // Adjust Window To True Requested Size - const std::string message = title; - std::wstring targetMessage; - utf8::utf8to16(message.c_str(), message.c_str() + message.size(), back_inserter(targetMessage)); + const size_t len = std::strlen(title) + 1; + wchar_t *tmp = new wchar_t[len]; + memset(tmp, L'\0', sizeof(wchar_t) * len); + utf8::utf8to16(title, title+len, tmp); + std::wstring targetMessage = tmp; + delete[] tmp; if (nullptr == (g_hWnd = CreateWindowEx(dwExStyle, // Extended Style For The Window TEXT("OpenGL"), // Class Name From 44c2785663d38f79614138bfa87d91d0b0ad69c7 Mon Sep 17 00:00:00 2001 From: Kim Kulling Date: Tue, 7 Mar 2023 17:01:08 +0100 Subject: [PATCH 21/61] Make debug message more professional. --- code/AssetLib/Ogre/OgreXmlSerializer.cpp | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/code/AssetLib/Ogre/OgreXmlSerializer.cpp b/code/AssetLib/Ogre/OgreXmlSerializer.cpp index 623f2961e..a8faaec34 100644 --- a/code/AssetLib/Ogre/OgreXmlSerializer.cpp +++ b/code/AssetLib/Ogre/OgreXmlSerializer.cpp @@ -490,7 +490,7 @@ bool OgreXmlSerializer::ImportSkeleton(Assimp::IOSystem *pIOHandler, MeshXml *me OgreXmlSerializer serializer(xmlParser.get()); XmlNode root = xmlParser->getRootNode(); if (std::string(root.name()) != nnSkeleton) { - // printf("\nSkeleton is not a valid root: %s\n", root.name()); + ASSIMP_LOG_VERBOSE_DEBUG("nSkeleton is not a valid root: ", root.name(), "."); for (auto &a : root.children()) { if (std::string(a.name()) == nnSkeleton) { root = a; From 069b3ecdf814784f8f80f3858863222184f15172 Mon Sep 17 00:00:00 2001 From: Florian Born Date: Tue, 7 Mar 2023 17:44:48 +0100 Subject: [PATCH 22/61] After Kim's addition to meta data types, use it in the FBX converter --- code/AssetLib/FBX/FBXConverter.cpp | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/code/AssetLib/FBX/FBXConverter.cpp b/code/AssetLib/FBX/FBXConverter.cpp index d45919e10..37654746e 100644 --- a/code/AssetLib/FBX/FBXConverter.cpp +++ b/code/AssetLib/FBX/FBXConverter.cpp @@ -873,8 +873,12 @@ void FBXConverter::SetupNodeMetadata(const Model &model, aiNode &nd) { data->Set(index++, prop.first, interpretedBool->Value()); } else if (const TypedProperty *interpretedInt = prop.second->As>()) { data->Set(index++, prop.first, interpretedInt->Value()); + } else if (const TypedProperty *interpretedUInt = prop.second->As>()) { + data->Set(index++, prop.first, interpretedUInt->Value()); } else if (const TypedProperty *interpretedUint64 = prop.second->As>()) { data->Set(index++, prop.first, interpretedUint64->Value()); + } else if (const TypedProperty *interpretedint64 = prop.second->As>()) { + data->Set(index++, prop.first, interpretedint64->Value()); } else if (const TypedProperty *interpretedFloat = prop.second->As>()) { data->Set(index++, prop.first, interpretedFloat->Value()); } else if (const TypedProperty *interpretedString = prop.second->As>()) { From 4f48348af8f2d0b046788edab8f952af9bf2d52b Mon Sep 17 00:00:00 2001 From: Kim Kulling Date: Tue, 7 Mar 2023 18:55:18 +0100 Subject: [PATCH 23/61] Fix: Move c++ include to c++ section --- include/assimp/types.h | 12 ++++++------ 1 file changed, 6 insertions(+), 6 deletions(-) diff --git a/include/assimp/types.h b/include/assimp/types.h index be2aad18b..605dc590f 100644 --- a/include/assimp/types.h +++ b/include/assimp/types.h @@ -57,12 +57,6 @@ OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. #include #include -#ifdef ASSIMP_USE_HUNTER -#include -#else -#include "../contrib/utf8cpp/source/utf8.h" -#endif - // Our compile configuration #include @@ -79,6 +73,12 @@ typedef uint32_t ai_uint32; #ifdef __cplusplus +#ifdef ASSIMP_USE_HUNTER +# include +#else +# include "../contrib/utf8cpp/source/utf8.h" +#endif + #include #include // for std::nothrow_t #include // for aiString::Set(const std::string&) From b5345841989a53979260e136c5ca53b181676e13 Mon Sep 17 00:00:00 2001 From: Turo Lamminen Date: Wed, 8 Mar 2023 16:10:40 +0200 Subject: [PATCH 24/61] Improve unit tests which load subdivision models --- test/unit/utACImportExport.cpp | 23 +++++++++++++++++++++++ test/unit/utBlenderImportExport.cpp | 22 ++++++++++++++++++++++ 2 files changed, 45 insertions(+) diff --git a/test/unit/utACImportExport.cpp b/test/unit/utACImportExport.cpp index 9615a3a3e..c844603cf 100644 --- a/test/unit/utACImportExport.cpp +++ b/test/unit/utACImportExport.cpp @@ -43,6 +43,8 @@ OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. #include #include +#include + using namespace Assimp; @@ -68,6 +70,27 @@ TEST(utACImportExport, importSampleSubdiv) { Assimp::Importer importer; const aiScene *scene = importer.ReadFile(ASSIMP_TEST_MODELS_DIR "/AC/sample_subdiv.ac", aiProcess_ValidateDataStructure); ASSERT_NE(nullptr, scene); + + // check approximate shape by averaging together all vertices + ASSERT_EQ(scene->mNumMeshes, 1u); + aiVector3D vertexAvg(0.0, 0.0, 0.0); + for (unsigned int i = 0; i < scene->mNumMeshes; i++) { + const aiMesh *mesh = scene->mMeshes[i]; + ASSERT_NE(mesh, nullptr); + + ai_real invVertexCount = 1.0 / mesh->mNumVertices; + for (unsigned int j = 0; j < mesh->mNumVertices; j++) { + vertexAvg += mesh->mVertices[j] * invVertexCount; + } + } + + // must not be inf or nan + ASSERT_TRUE(std::isfinite(vertexAvg.x)); + ASSERT_TRUE(std::isfinite(vertexAvg.y)); + ASSERT_TRUE(std::isfinite(vertexAvg.z)); + EXPECT_NEAR(vertexAvg.x, 0.079997420310974121, 0.0001); + EXPECT_NEAR(vertexAvg.y, 0.099498569965362549, 0.0001); + EXPECT_NEAR(vertexAvg.z, -0.10344827175140381, 0.0001); } TEST(utACImportExport, importSphereWithLight) { diff --git a/test/unit/utBlenderImportExport.cpp b/test/unit/utBlenderImportExport.cpp index c9cce72b4..c220b7daa 100644 --- a/test/unit/utBlenderImportExport.cpp +++ b/test/unit/utBlenderImportExport.cpp @@ -45,6 +45,7 @@ OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. #include #include +#include using namespace Assimp; @@ -156,6 +157,27 @@ TEST(utBlenderImporter, importSuzanneSubdiv_252) { Assimp::Importer importer; const aiScene *scene = importer.ReadFile(ASSIMP_TEST_MODELS_DIR "/BLEND/SuzanneSubdiv_252.blend", aiProcess_ValidateDataStructure); ASSERT_NE(nullptr, scene); + + // check approximate shape by averaging together all vertices + ASSERT_EQ(scene->mNumMeshes, 1u); + aiVector3D vertexAvg(0.0, 0.0, 0.0); + for (unsigned int i = 0; i < scene->mNumMeshes; i++) { + const aiMesh *mesh = scene->mMeshes[i]; + ASSERT_NE(mesh, nullptr); + + ai_real invVertexCount = 1.0 / mesh->mNumVertices; + for (unsigned int j = 0; j < mesh->mNumVertices; j++) { + vertexAvg += mesh->mVertices[j] * invVertexCount; + } + } + + // must not be inf or nan + ASSERT_TRUE(std::isfinite(vertexAvg.x)); + ASSERT_TRUE(std::isfinite(vertexAvg.y)); + ASSERT_TRUE(std::isfinite(vertexAvg.z)); + EXPECT_NEAR(vertexAvg.x, 6.4022515289252624e-08, 0.0001); + EXPECT_NEAR(vertexAvg.y, 0.060569953173398972, 0.0001); + EXPECT_NEAR(vertexAvg.z, 0.31429031491279602, 0.0001); } TEST(utBlenderImporter, importTexturedCube_ImageGlob_248) { From f3767a4eb21f2f272102d0fe4020d4e4ca3154bc Mon Sep 17 00:00:00 2001 From: Turo Lamminen Date: Wed, 8 Mar 2023 16:18:10 +0200 Subject: [PATCH 25/61] Use unordered_map for subdivision process edge map --- code/Common/Subdivision.cpp | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/code/Common/Subdivision.cpp b/code/Common/Subdivision.cpp index 705ea3fb3..ac4078b47 100644 --- a/code/Common/Subdivision.cpp +++ b/code/Common/Subdivision.cpp @@ -50,6 +50,8 @@ OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. #include +#include + using namespace Assimp; void mydummy() {} @@ -78,7 +80,7 @@ public: }; typedef std::vector UIntVector; - typedef std::map EdgeMap; + typedef std::unordered_map EdgeMap; // --------------------------------------------------------------------------- // Hashing function to derive an index into an #EdgeMap from two given From c82a6d05b0be9cdd5e16420ff06bd28190508ea7 Mon Sep 17 00:00:00 2001 From: Kim Kulling Date: Fri, 10 Mar 2023 08:43:12 +0100 Subject: [PATCH 26/61] Code cleanup --- code/CApi/CInterfaceIOWrapper.cpp | 20 ++++++++++---------- 1 file changed, 10 insertions(+), 10 deletions(-) diff --git a/code/CApi/CInterfaceIOWrapper.cpp b/code/CApi/CInterfaceIOWrapper.cpp index 579545ecc..f0e46cd08 100644 --- a/code/CApi/CInterfaceIOWrapper.cpp +++ b/code/CApi/CInterfaceIOWrapper.cpp @@ -5,8 +5,6 @@ Open Asset Import Library (assimp) Copyright (c) 2006-2022, assimp team - - All rights reserved. Redistribution and use of this software in source and binary forms, @@ -47,14 +45,16 @@ OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. namespace Assimp { +// ------------------------------------------------------------------------------------------------ CIOStreamWrapper::~CIOStreamWrapper() { - /* Various places depend on this destructor to close the file */ - if (mFile) { + // Various places depend on this destructor to close the file + if (mFile != nullptr) { + mIO->mFileSystem->CloseProc(mIO->mFileSystem, mFile); } } -// ................................................................... +// ------------------------------------------------------------------------------------------------ size_t CIOStreamWrapper::Read(void *pvBuffer, size_t pSize, size_t pCount) { @@ -62,7 +62,7 @@ size_t CIOStreamWrapper::Read(void *pvBuffer, return mFile->ReadProc(mFile, (char *)pvBuffer, pSize, pCount); } -// ................................................................... +// ------------------------------------------------------------------------------------------------ size_t CIOStreamWrapper::Write(const void *pvBuffer, size_t pSize, size_t pCount) { @@ -70,23 +70,23 @@ size_t CIOStreamWrapper::Write(const void *pvBuffer, return mFile->WriteProc(mFile, (const char *)pvBuffer, pSize, pCount); } -// ................................................................... +// ------------------------------------------------------------------------------------------------ aiReturn CIOStreamWrapper::Seek(size_t pOffset, aiOrigin pOrigin) { return mFile->SeekProc(mFile, pOffset, pOrigin); } -// ................................................................... +// ------------------------------------------------------------------------------------------------ size_t CIOStreamWrapper::Tell() const { return mFile->TellProc(mFile); } -// ................................................................... +// ------------------------------------------------------------------------------------------------ size_t CIOStreamWrapper::FileSize() const { return mFile->FileSizeProc(mFile); } -// ................................................................... +// ------------------------------------------------------------------------------------------------ void CIOStreamWrapper::Flush() { return mFile->FlushProc(mFile); } From 63dae0a7f24c0bc965f936e5b3b96b8d83a93e5f Mon Sep 17 00:00:00 2001 From: Kim Kulling Date: Fri, 10 Mar 2023 08:48:11 +0100 Subject: [PATCH 27/61] Fix: Add security asserts. --- code/CApi/CInterfaceIOWrapper.h | 55 ++++++++++++++++++++------------- 1 file changed, 33 insertions(+), 22 deletions(-) diff --git a/code/CApi/CInterfaceIOWrapper.h b/code/CApi/CInterfaceIOWrapper.h index 768be3746..28d4c3e75 100644 --- a/code/CApi/CInterfaceIOWrapper.h +++ b/code/CApi/CInterfaceIOWrapper.h @@ -47,48 +47,59 @@ OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. #include #include #include +#include namespace Assimp { class CIOSystemWrapper; // ------------------------------------------------------------------------------------------------ -// Custom IOStream implementation for the C-API -class CIOStreamWrapper : public IOStream { +/// @brief Custom IOStream implementation for the C-API- +// ------------------------------------------------------------------------------------------------ +class CIOStreamWrapper final : public IOStream { public: - explicit CIOStreamWrapper(aiFile *pFile, CIOSystemWrapper *io) : - mFile(pFile), - mIO(io) {} - ~CIOStreamWrapper(void); - - size_t Read(void *pvBuffer, size_t pSize, size_t pCount); - size_t Write(const void *pvBuffer, size_t pSize, size_t pCount); - aiReturn Seek(size_t pOffset, aiOrigin pOrigin); - size_t Tell(void) const; - size_t FileSize() const; - void Flush(); + explicit CIOStreamWrapper(aiFile *pFile, CIOSystemWrapper *io); + ~CIOStreamWrapper() override; + size_t Read(void *pvBuffer, size_t pSize, size_t pCount) override; + size_t Write(const void *pvBuffer, size_t pSize, size_t pCount) override; + aiReturn Seek(size_t pOffset, aiOrigin pOrigin) override; + size_t Tell(void) const override; + size_t FileSize() const override; + void Flush() override; private: aiFile *mFile; CIOSystemWrapper *mIO; }; -class CIOSystemWrapper : public IOSystem { +inline CIOStreamWrapper::CIOStreamWrapper(aiFile *pFile, CIOSystemWrapper *io) : + mFile(pFile), + mIO(io) { + ai_assert(io != nullptr); +} + +// ------------------------------------------------------------------------------------------------ +/// @brief Custom IO-System wrapper implementation for the C-API. +// ------------------------------------------------------------------------------------------------ +class CIOSystemWrapper final : public IOSystem { friend class CIOStreamWrapper; public: - explicit CIOSystemWrapper(aiFileIO *pFile) : - mFileSystem(pFile) {} - - bool Exists(const char *pFile) const; - char getOsSeparator() const; - IOStream *Open(const char *pFile, const char *pMode = "rb"); - void Close(IOStream *pFile); + explicit CIOSystemWrapper(aiFileIO *pFile); + ~CIOSystemWrapper() override = default; + bool Exists(const char *pFile) const override; + char getOsSeparator() const override; + IOStream *Open(const char *pFile, const char *pMode = "rb") override; + void Close(IOStream *pFile) override; private: aiFileIO *mFileSystem; }; +inline CIOSystemWrapper::CIOSystemWrapper(aiFileIO *pFile) : mFileSystem(pFile) { + ai_assert(pFile != nullptr); +} + } // namespace Assimp -#endif +#endif // AI_CIOSYSTEM_H_INCLUDED From 2f7882cb8d42e41d5330b154316da3d5617f5769 Mon Sep 17 00:00:00 2001 From: Kim Kulling Date: Fri, 10 Mar 2023 08:49:58 +0100 Subject: [PATCH 28/61] Update: Small code cleanup --- code/CApi/AssimpCExport.cpp | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/code/CApi/AssimpCExport.cpp b/code/CApi/AssimpCExport.cpp index 5e43958d0..e3d85504d 100644 --- a/code/CApi/AssimpCExport.cpp +++ b/code/CApi/AssimpCExport.cpp @@ -5,8 +5,6 @@ Open Asset Import Library (assimp) Copyright (c) 2006-2022, assimp team - - All rights reserved. Redistribution and use of this software in source and binary forms, @@ -52,7 +50,7 @@ Assimp C export interface. See Exporter.cpp for some notes. #include #include -using namespace Assimp; +namespace Assimp { // ------------------------------------------------------------------------------------------------ ASSIMP_API size_t aiGetExportFormatCount(void) { @@ -141,4 +139,6 @@ ASSIMP_API C_STRUCT void aiReleaseExportBlob(const aiExportDataBlob *pData) { delete pData; } +} // namespace Assimp + #endif // !ASSIMP_BUILD_NO_EXPORT From ffd222334f647f8d65762343a9ebc4ff6247c272 Mon Sep 17 00:00:00 2001 From: Kim Kulling Date: Fri, 10 Mar 2023 09:00:37 +0100 Subject: [PATCH 29/61] Fix: Remove buggy namespace declaration --- code/CApi/AssimpCExport.cpp | 4 +--- 1 file changed, 1 insertion(+), 3 deletions(-) diff --git a/code/CApi/AssimpCExport.cpp b/code/CApi/AssimpCExport.cpp index e3d85504d..21e40205c 100644 --- a/code/CApi/AssimpCExport.cpp +++ b/code/CApi/AssimpCExport.cpp @@ -50,7 +50,7 @@ Assimp C export interface. See Exporter.cpp for some notes. #include #include -namespace Assimp { +using namespace Assimp; // ------------------------------------------------------------------------------------------------ ASSIMP_API size_t aiGetExportFormatCount(void) { @@ -139,6 +139,4 @@ ASSIMP_API C_STRUCT void aiReleaseExportBlob(const aiExportDataBlob *pData) { delete pData; } -} // namespace Assimp - #endif // !ASSIMP_BUILD_NO_EXPORT From 4b4cb55f22c28af5637819d7b2a3ecffd48fc372 Mon Sep 17 00:00:00 2001 From: Marc-Antoine Lortie Date: Sat, 11 Mar 2023 16:25:04 -0500 Subject: [PATCH 30/61] Fix HL1MDLLoader flattened bone hierarchy. --- code/AssetLib/MDL/HalfLife/HL1MDLLoader.cpp | 43 ++++++++++++++++++--- code/AssetLib/MDL/HalfLife/HL1MDLLoader.h | 9 +++++ 2 files changed, 47 insertions(+), 5 deletions(-) diff --git a/code/AssetLib/MDL/HalfLife/HL1MDLLoader.cpp b/code/AssetLib/MDL/HalfLife/HL1MDLLoader.cpp index 93d37536c..237ccf3d8 100644 --- a/code/AssetLib/MDL/HalfLife/HL1MDLLoader.cpp +++ b/code/AssetLib/MDL/HalfLife/HL1MDLLoader.cpp @@ -472,12 +472,13 @@ void HL1MDLLoader::read_bones() { aiNode *bones_node = new aiNode(AI_MDL_HL1_NODE_BONES); rootnode_children_.push_back(bones_node); - bones_node->mNumChildren = static_cast(header_->numbones); - bones_node->mChildren = new aiNode *[bones_node->mNumChildren]; + + // Store roots bones IDs temporarily. + std::vector roots; // Create bone matrices in local space. for (int i = 0; i < header_->numbones; ++i) { - aiNode *bone_node = temp_bones_[i].node = bones_node->mChildren[i] = new aiNode(unique_bones_names[i]); + aiNode *bone_node = temp_bones_[i].node = new aiNode(unique_bones_names[i]); aiVector3D angles(pbone[i].value[3], pbone[i].value[4], pbone[i].value[5]); temp_bones_[i].absolute_transform = bone_node->mTransformation = @@ -485,9 +486,11 @@ void HL1MDLLoader::read_bones() { aiVector3D(pbone[i].value[0], pbone[i].value[1], pbone[i].value[2])); if (pbone[i].parent == -1) { - bone_node->mParent = scene_->mRootNode; + bone_node->mParent = bones_node; + roots.push_back(i); // This bone has no parent. Add it to the roots list. } else { - bone_node->mParent = bones_node->mChildren[pbone[i].parent]; + bone_node->mParent = temp_bones_[pbone[i].parent].node; + temp_bones_[pbone[i].parent].children.push_back(i); // Add this bone to the parent bone's children list. temp_bones_[i].absolute_transform = temp_bones_[pbone[i].parent].absolute_transform * bone_node->mTransformation; @@ -496,6 +499,36 @@ void HL1MDLLoader::read_bones() { temp_bones_[i].offset_matrix = temp_bones_[i].absolute_transform; temp_bones_[i].offset_matrix.Inverse(); } + + // Create the 'bones' root node that will contain all bone nodes. + bones_node->mNumChildren = static_cast(roots.size()); + bones_node->mChildren = new aiNode *[bones_node->mNumChildren]; + + // Build all bones children hierarchy starting from each root bone. + for (size_t i = 0; i < roots.size(); ++i) + { + const TempBone &root_bone = temp_bones_[roots[i]]; + bones_node->mChildren[i] = root_bone.node; + build_bone_children_hierarchy(root_bone); + } +} + +void HL1MDLLoader::build_bone_children_hierarchy(const TempBone &bone) +{ + if (bone.children.size() > 0) + { + aiNode* bone_node = bone.node; + bone_node->mNumChildren = static_cast(bone.children.size()); + bone_node->mChildren = new aiNode *[bone_node->mNumChildren]; + + // Build each child bone's hierarchy recursively. + for (size_t i = 0; i < bone.children.size(); ++i) + { + const TempBone &child_bone = temp_bones_[bone.children[i]]; + bone_node->mChildren[i] = child_bone.node; + build_bone_children_hierarchy(child_bone); + } + } } // ------------------------------------------------------------------------------------------------ diff --git a/code/AssetLib/MDL/HalfLife/HL1MDLLoader.h b/code/AssetLib/MDL/HalfLife/HL1MDLLoader.h index 0dba5099d..3fc84c1be 100644 --- a/code/AssetLib/MDL/HalfLife/HL1MDLLoader.h +++ b/code/AssetLib/MDL/HalfLife/HL1MDLLoader.h @@ -143,6 +143,14 @@ private: */ static bool get_num_blend_controllers(const int num_blend_animations, int &num_blend_controllers); + /** + * \brief Build a bone's node children hierarchy. + * + * \param[in] bone The bone for which we must build all children hierarchy. + */ + struct TempBone; + void build_bone_children_hierarchy(const TempBone& bone); + /** Output scene to be filled */ aiScene *scene_; @@ -203,6 +211,7 @@ private: aiNode *node; aiMatrix4x4 absolute_transform; aiMatrix4x4 offset_matrix; + std::vector children; // Bone children }; std::vector temp_bones_; From 3c2a42586925115df891df4146181e8d08563e31 Mon Sep 17 00:00:00 2001 From: Marc-Antoine Lortie Date: Sat, 11 Mar 2023 20:46:42 -0500 Subject: [PATCH 31/61] Added a test to validate HL1 MDL bone hierarchy. --- test/models/MDL/MDL (HL1)/multiple_roots.mdl | Bin 0 -> 15372 bytes .../MDL/utMDLImporter_HL1_Nodes.cpp | 67 ++++++++++++++++++ 2 files changed, 67 insertions(+) create mode 100644 test/models/MDL/MDL (HL1)/multiple_roots.mdl diff --git a/test/models/MDL/MDL (HL1)/multiple_roots.mdl b/test/models/MDL/MDL (HL1)/multiple_roots.mdl new file mode 100644 index 0000000000000000000000000000000000000000..f8fc1eed708c8b3f95c5faf7c55e78cb07434771 GIT binary patch literal 15372 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 Hierarchy; + public: /** * @note The following tests require a basic understanding @@ -63,6 +69,49 @@ public: * (Valve Developer Community). */ + // Given a model, verify that the bones nodes hierarchy is correctly formed. + void checkBoneHierarchy() { + Assimp::Importer importer; + const aiScene *scene = importer.ReadFile(ASSIMP_TEST_MDL_HL1_MODELS_DIR "multiple_roots.mdl", aiProcess_ValidateDataStructure); + ASSERT_NE(nullptr, scene); + ASSERT_NE(nullptr, scene->mRootNode); + + const aiNode* node_MDL_root = scene->mRootNode->FindNode(AI_MDL_HL1_NODE_ROOT); + ASSERT_NE(nullptr, node_MDL_root); + + const aiNode *node_MDL_bones = scene->mRootNode->FindNode(AI_MDL_HL1_NODE_BONES); + ASSERT_NE(nullptr, node_MDL_bones); + ASSERT_NE(nullptr, node_MDL_bones->mParent); + ASSERT_EQ(node_MDL_root, node_MDL_bones->mParent); + + const Hierarchy expected_hierarchy = { + { 0, AI_MDL_HL1_NODE_BONES }, + { 1, "root1_bone1" }, + { 2, "root1_bone2" }, + { 3, "root1_bone4" }, + { 3, "root1_bone5" }, + { 2, "root1_bone3" }, + { 3, "root1_bone6" }, + { 1, "root2_bone1" }, + { 2, "root2_bone2" }, + { 2, "root2_bone3" }, + { 3, "root2_bone5" }, + { 2, "root2_bone4" }, + { 3, "root2_bone6" }, + { 1, "root3_bone1" }, + { 2, "root3_bone2" }, + { 2, "root3_bone3" }, + { 2, "root3_bone4" }, + { 3, "root3_bone5" }, + { 4, "root3_bone6" }, + { 4, "root3_bone7" }, + }; + + Hierarchy actual_hierarchy; + flatten_hierarchy(node_MDL_bones, actual_hierarchy); + ASSERT_EQ(expected_hierarchy, actual_hierarchy); + } + /* Given a model with bones that have empty names, verify that all the bones of the imported model have unique and no empty names. @@ -416,8 +465,26 @@ private: EXPECT_NEAR(expected[i][j], actual[i][j], abs_error); } } + + void flatten_hierarchy(const aiNode *node, Hierarchy &hierarchy) + { + flatten_hierarchy(node, hierarchy, 0); + } + + void flatten_hierarchy(const aiNode *node, Hierarchy &hierarchy, unsigned int level) + { + hierarchy.push_back({ level, node->mName.C_Str() }); + for (size_t i = 0; i < node->mNumChildren; ++i) + { + flatten_hierarchy(node->mChildren[i], hierarchy, level + 1); + } + } }; +TEST_F(utMDLImporter_HL1_Nodes, checkBoneHierarchy) { + checkBoneHierarchy(); +} + TEST_F(utMDLImporter_HL1_Nodes, emptyBonesNames) { emptyBonesNames(); } From d500f604903d982c321851d3f108098ab8ff2608 Mon Sep 17 00:00:00 2001 From: Marc-Antoine Lortie Date: Sat, 11 Mar 2023 20:48:17 -0500 Subject: [PATCH 32/61] Adjust emptyBonesNames test. --- .../ImportExport/MDL/utMDLImporter_HL1_Nodes.cpp | 13 ++++++++++++- 1 file changed, 12 insertions(+), 1 deletion(-) diff --git a/test/unit/ImportExport/MDL/utMDLImporter_HL1_Nodes.cpp b/test/unit/ImportExport/MDL/utMDLImporter_HL1_Nodes.cpp index d2984477b..c94fa3f3f 100644 --- a/test/unit/ImportExport/MDL/utMDLImporter_HL1_Nodes.cpp +++ b/test/unit/ImportExport/MDL/utMDLImporter_HL1_Nodes.cpp @@ -143,7 +143,9 @@ public: "Bone_7" }; - expect_named_children(scene, AI_MDL_HL1_NODE_BONES, expected_bones_names); + std::vector actual_bones_names; + get_node_children_names(scene->mRootNode->FindNode(AI_MDL_HL1_NODE_BONES), actual_bones_names); + ASSERT_EQ(expected_bones_names, actual_bones_names); } /* Given a model with bodyparts that have empty names, @@ -479,6 +481,15 @@ private: flatten_hierarchy(node->mChildren[i], hierarchy, level + 1); } } + + void get_node_children_names(const aiNode *node, std::vector &names) + { + for (size_t i = 0; i < node->mNumChildren; ++i) + { + names.push_back(node->mChildren[i]->mName.C_Str()); + get_node_children_names(node->mChildren[i], names); + } + } }; TEST_F(utMDLImporter_HL1_Nodes, checkBoneHierarchy) { From 7bc4c12956a60e563df7cd08b8677f7b8ef8c355 Mon Sep 17 00:00:00 2001 From: Marc-Antoine Lortie Date: Sat, 11 Mar 2023 22:03:29 -0500 Subject: [PATCH 33/61] Simplified HL1 MDL nodes tests. --- .../MDL/utMDLImporter_HL1_Nodes.cpp | 98 ++++++++++++------- 1 file changed, 63 insertions(+), 35 deletions(-) diff --git a/test/unit/ImportExport/MDL/utMDLImporter_HL1_Nodes.cpp b/test/unit/ImportExport/MDL/utMDLImporter_HL1_Nodes.cpp index c94fa3f3f..af6512c87 100644 --- a/test/unit/ImportExport/MDL/utMDLImporter_HL1_Nodes.cpp +++ b/test/unit/ImportExport/MDL/utMDLImporter_HL1_Nodes.cpp @@ -61,6 +61,11 @@ class utMDLImporter_HL1_Nodes : public ::testing::Test { */ typedef std::vector> Hierarchy; + /** + * @note A vector of strings. Used for symplifying syntax. + */ + typedef std::vector StringVector; + public: /** * @note The following tests require a basic understanding @@ -131,7 +136,7 @@ public: const aiScene *scene = importer.ReadFile(ASSIMP_TEST_MDL_HL1_MODELS_DIR "unnamed_bones.mdl", aiProcess_ValidateDataStructure); EXPECT_NE(nullptr, scene); - const std::vector expected_bones_names = { + const StringVector expected_bones_names = { "Bone", "Bone_0", "Bone_1", @@ -143,7 +148,7 @@ public: "Bone_7" }; - std::vector actual_bones_names; + StringVector actual_bones_names; get_node_children_names(scene->mRootNode->FindNode(AI_MDL_HL1_NODE_BONES), actual_bones_names); ASSERT_EQ(expected_bones_names, actual_bones_names); } @@ -167,7 +172,7 @@ public: const aiScene *scene = importer.ReadFile(ASSIMP_TEST_MDL_HL1_MODELS_DIR "unnamed_bodyparts.mdl", aiProcess_ValidateDataStructure); EXPECT_NE(nullptr, scene); - const std::vector expected_bodyparts_names = { + const StringVector expected_bodyparts_names = { "Bodypart", "Bodypart_1", "Bodypart_5", @@ -179,7 +184,10 @@ public: "Bodypart_7" }; - expect_named_children(scene, AI_MDL_HL1_NODE_BODYPARTS, expected_bodyparts_names); + StringVector actual_bodyparts_names; + // Get the bodyparts names "without" the submodels. + get_node_children_names(scene->mRootNode->FindNode(AI_MDL_HL1_NODE_BODYPARTS), actual_bodyparts_names, 0); + ASSERT_EQ(expected_bodyparts_names, actual_bodyparts_names); } /* Given a model with bodyparts that have duplicate names, @@ -201,7 +209,7 @@ public: const aiScene *scene = importer.ReadFile(ASSIMP_TEST_MDL_HL1_MODELS_DIR "duplicate_bodyparts.mdl", aiProcess_ValidateDataStructure); EXPECT_NE(nullptr, scene); - const std::vector expected_bodyparts_names = { + const StringVector expected_bodyparts_names = { "Bodypart", "Bodypart_1", "Bodypart_2", @@ -213,7 +221,10 @@ public: "Bodypart_4" }; - expect_named_children(scene, AI_MDL_HL1_NODE_BODYPARTS, expected_bodyparts_names); + StringVector actual_bodyparts_names; + // Get the bodyparts names "without" the submodels. + get_node_children_names(scene->mRootNode->FindNode(AI_MDL_HL1_NODE_BODYPARTS), actual_bodyparts_names, 0); + ASSERT_EQ(expected_bodyparts_names, actual_bodyparts_names); } /* Given a model with several bodyparts that contains multiple @@ -243,7 +254,7 @@ public: const aiScene *scene = importer.ReadFile(ASSIMP_TEST_MDL_HL1_MODELS_DIR "duplicate_submodels.mdl", aiProcess_ValidateDataStructure); EXPECT_NE(nullptr, scene); - const std::vector> expected_bodypart_sub_models_names = { + const std::vector expected_bodypart_sub_models_names = { { "triangle", "triangle_0", @@ -261,9 +272,13 @@ public: const aiNode *bodyparts_node = scene->mRootNode->FindNode(AI_MDL_HL1_NODE_BODYPARTS); EXPECT_NE(nullptr, bodyparts_node); EXPECT_EQ(3u, bodyparts_node->mNumChildren); - for (unsigned int i = 0; i < bodyparts_node->mNumChildren; ++i) { - expect_named_children(bodyparts_node->mChildren[i], - expected_bodypart_sub_models_names[i]); + + StringVector actual_submodels_names; + for (unsigned int i = 0; i < bodyparts_node->mNumChildren; ++i) + { + actual_submodels_names.clear(); + get_node_children_names(bodyparts_node->mChildren[i], actual_submodels_names); + ASSERT_EQ(expected_bodypart_sub_models_names[i], actual_submodels_names); } } @@ -286,7 +301,7 @@ public: const aiScene *scene = importer.ReadFile(ASSIMP_TEST_MDL_HL1_MODELS_DIR "duplicate_sequences.mdl", aiProcess_ValidateDataStructure); EXPECT_NE(nullptr, scene); - const std::vector expected_sequence_names = { + const StringVector expected_sequence_names = { "idle_1", "idle", "idle_2", @@ -298,7 +313,9 @@ public: "idle_7" }; - expect_named_children(scene, AI_MDL_HL1_NODE_SEQUENCE_INFOS, expected_sequence_names); + StringVector actual_sequence_names; + get_node_children_names(scene->mRootNode->FindNode(AI_MDL_HL1_NODE_SEQUENCE_INFOS), actual_sequence_names); + ASSERT_EQ(expected_sequence_names, actual_sequence_names); } /* Given a model with sequences that have empty names, verify @@ -320,7 +337,7 @@ public: const aiScene *scene = importer.ReadFile(ASSIMP_TEST_MDL_HL1_MODELS_DIR "unnamed_sequences.mdl", aiProcess_ValidateDataStructure); EXPECT_NE(nullptr, scene); - const std::vector expected_sequence_names = { + const StringVector expected_sequence_names = { "Sequence", "Sequence_1", "Sequence_0", @@ -332,7 +349,9 @@ public: "Sequence_6" }; - expect_named_children(scene, AI_MDL_HL1_NODE_SEQUENCE_INFOS, expected_sequence_names); + StringVector actual_sequence_names; + get_node_children_names(scene->mRootNode->FindNode(AI_MDL_HL1_NODE_SEQUENCE_INFOS), actual_sequence_names); + ASSERT_EQ(expected_sequence_names, actual_sequence_names); } /* Given a model with sequence groups that have duplicate names, @@ -355,7 +374,7 @@ public: const aiScene *scene = importer.ReadFile(ASSIMP_TEST_MDL_HL1_MODELS_DIR "duplicate_sequence_groups/duplicate_sequence_groups.mdl", aiProcess_ValidateDataStructure); EXPECT_NE(nullptr, scene); - const std::vector expected_sequence_names = { + const StringVector expected_sequence_names = { "default", "SequenceGroup", "SequenceGroup_1", @@ -368,7 +387,9 @@ public: "SequenceGroup_2" }; - expect_named_children(scene, AI_MDL_HL1_NODE_SEQUENCE_GROUPS, expected_sequence_names); + StringVector actual_sequence_names; + get_node_children_names(scene->mRootNode->FindNode(AI_MDL_HL1_NODE_SEQUENCE_GROUPS), actual_sequence_names); + ASSERT_EQ(expected_sequence_names, actual_sequence_names); } /* Given a model with sequence groups that have empty names, @@ -391,7 +412,7 @@ public: const aiScene *scene = importer.ReadFile(ASSIMP_TEST_MDL_HL1_MODELS_DIR "unnamed_sequence_groups/unnamed_sequence_groups.mdl", aiProcess_ValidateDataStructure); EXPECT_NE(nullptr, scene); - const std::vector expected_sequence_names = { + const StringVector expected_sequence_names = { "default", "SequenceGroup", "SequenceGroup_2", @@ -404,7 +425,9 @@ public: "SequenceGroup_4" }; - expect_named_children(scene, AI_MDL_HL1_NODE_SEQUENCE_GROUPS, expected_sequence_names); + StringVector actual_sequence_names; + get_node_children_names(scene->mRootNode->FindNode(AI_MDL_HL1_NODE_SEQUENCE_GROUPS), actual_sequence_names); + ASSERT_EQ(expected_sequence_names, actual_sequence_names); } /* Verify that mOffsetMatrix applies the correct @@ -449,18 +472,6 @@ public: } private: - void expect_named_children(const aiNode *parent_node, const std::vector &expected_names) { - EXPECT_NE(nullptr, parent_node); - EXPECT_EQ(expected_names.size(), parent_node->mNumChildren); - - for (unsigned int i = 0; i < parent_node->mNumChildren; ++i) - EXPECT_EQ(expected_names[i], parent_node->mChildren[i]->mName.C_Str()); - } - - void expect_named_children(const aiScene *scene, const char *node_name, const std::vector &expected_names) { - expect_named_children(scene->mRootNode->FindNode(node_name), expected_names); - } - void expect_equal_matrices(const aiMatrix4x4 &expected, const aiMatrix4x4 &actual, float abs_error) { for (int i = 0; i < 4; ++i) { for (int j = 0; j < 4; ++j) @@ -468,26 +479,43 @@ private: } } + /** Get a flattened representation of a node's hierarchy. + * \param[in] node The node. + * \param[out] hierarchy The flattened node's hierarchy. + */ void flatten_hierarchy(const aiNode *node, Hierarchy &hierarchy) { - flatten_hierarchy(node, hierarchy, 0); + flatten_hierarchy_impl(node, hierarchy, 0); } - void flatten_hierarchy(const aiNode *node, Hierarchy &hierarchy, unsigned int level) + void flatten_hierarchy_impl(const aiNode *node, Hierarchy &hierarchy, unsigned int level) { hierarchy.push_back({ level, node->mName.C_Str() }); for (size_t i = 0; i < node->mNumChildren; ++i) { - flatten_hierarchy(node->mChildren[i], hierarchy, level + 1); + flatten_hierarchy_impl(node->mChildren[i], hierarchy, level + 1); } } - void get_node_children_names(const aiNode *node, std::vector &names) + /** Get all node's children names beneath max_level. + * \param[in] node The parent node from which to get all children names. + * \param[out] names The list of children names. + * \param[in] max_level If set to -1, all children names will be collected. + */ + void get_node_children_names(const aiNode *node, StringVector &names, const int max_level = -1) + { + get_node_children_names_impl(node, names, 0, max_level); + } + + void get_node_children_names_impl(const aiNode *node, StringVector &names, int level, const int max_level = -1) { for (size_t i = 0; i < node->mNumChildren; ++i) { names.push_back(node->mChildren[i]->mName.C_Str()); - get_node_children_names(node->mChildren[i], names); + if (max_level == -1 || level < max_level) + { + get_node_children_names_impl(node->mChildren[i], names, level + 1, max_level); + } } } }; From 054dacd0687cb2c2bca6fe14b61b8063ec7ba6ac Mon Sep 17 00:00:00 2001 From: Marc-Antoine Lortie Date: Sat, 11 Mar 2023 22:32:48 -0500 Subject: [PATCH 34/61] Improved comments. --- code/AssetLib/MDL/HalfLife/HL1MDLLoader.cpp | 5 +++-- test/unit/ImportExport/MDL/utMDLImporter_HL1_Nodes.cpp | 2 ++ 2 files changed, 5 insertions(+), 2 deletions(-) diff --git a/code/AssetLib/MDL/HalfLife/HL1MDLLoader.cpp b/code/AssetLib/MDL/HalfLife/HL1MDLLoader.cpp index 237ccf3d8..f3a383e8e 100644 --- a/code/AssetLib/MDL/HalfLife/HL1MDLLoader.cpp +++ b/code/AssetLib/MDL/HalfLife/HL1MDLLoader.cpp @@ -470,6 +470,7 @@ void HL1MDLLoader::read_bones() { temp_bones_.resize(header_->numbones); + // Create the main 'bones' node that will contain all MDL root bones. aiNode *bones_node = new aiNode(AI_MDL_HL1_NODE_BONES); rootnode_children_.push_back(bones_node); @@ -500,11 +501,11 @@ void HL1MDLLoader::read_bones() { temp_bones_[i].offset_matrix.Inverse(); } - // Create the 'bones' root node that will contain all bone nodes. + // Allocate memory for each MDL root bone. bones_node->mNumChildren = static_cast(roots.size()); bones_node->mChildren = new aiNode *[bones_node->mNumChildren]; - // Build all bones children hierarchy starting from each root bone. + // Build all bones children hierarchy starting from each MDL root bone. for (size_t i = 0; i < roots.size(); ++i) { const TempBone &root_bone = temp_bones_[roots[i]]; diff --git a/test/unit/ImportExport/MDL/utMDLImporter_HL1_Nodes.cpp b/test/unit/ImportExport/MDL/utMDLImporter_HL1_Nodes.cpp index af6512c87..5a258d0a4 100644 --- a/test/unit/ImportExport/MDL/utMDLImporter_HL1_Nodes.cpp +++ b/test/unit/ImportExport/MDL/utMDLImporter_HL1_Nodes.cpp @@ -81,6 +81,7 @@ public: ASSERT_NE(nullptr, scene); ASSERT_NE(nullptr, scene->mRootNode); + // First, check that "" and "" are linked. const aiNode* node_MDL_root = scene->mRootNode->FindNode(AI_MDL_HL1_NODE_ROOT); ASSERT_NE(nullptr, node_MDL_root); @@ -89,6 +90,7 @@ public: ASSERT_NE(nullptr, node_MDL_bones->mParent); ASSERT_EQ(node_MDL_root, node_MDL_bones->mParent); + // Second, verify "" hierarchy. const Hierarchy expected_hierarchy = { { 0, AI_MDL_HL1_NODE_BONES }, { 1, "root1_bone1" }, From 4c015077b840ddf87d42e70300f51161cd77c415 Mon Sep 17 00:00:00 2001 From: Marc-Antoine Lortie Date: Sun, 12 Mar 2023 13:26:50 -0400 Subject: [PATCH 35/61] Add missing member initializer. --- code/AssetLib/MDL/HalfLife/HL1MDLLoader.h | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/code/AssetLib/MDL/HalfLife/HL1MDLLoader.h b/code/AssetLib/MDL/HalfLife/HL1MDLLoader.h index 3fc84c1be..286b6e64c 100644 --- a/code/AssetLib/MDL/HalfLife/HL1MDLLoader.h +++ b/code/AssetLib/MDL/HalfLife/HL1MDLLoader.h @@ -206,7 +206,8 @@ private: TempBone() : node(nullptr), absolute_transform(), - offset_matrix() {} + offset_matrix(), + children() {} aiNode *node; aiMatrix4x4 absolute_transform; From 25ab05eb49c901b54b8f8695dbcc05ab1376ac09 Mon Sep 17 00:00:00 2001 From: Marc-Antoine Lortie Date: Tue, 14 Mar 2023 09:17:39 -0400 Subject: [PATCH 36/61] Replace typedef by using. --- test/unit/ImportExport/MDL/utMDLImporter_HL1_Nodes.cpp | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/test/unit/ImportExport/MDL/utMDLImporter_HL1_Nodes.cpp b/test/unit/ImportExport/MDL/utMDLImporter_HL1_Nodes.cpp index 5a258d0a4..712f4da11 100644 --- a/test/unit/ImportExport/MDL/utMDLImporter_HL1_Nodes.cpp +++ b/test/unit/ImportExport/MDL/utMDLImporter_HL1_Nodes.cpp @@ -59,12 +59,12 @@ class utMDLImporter_HL1_Nodes : public ::testing::Test { * @note Represents a flattened node hierarchy where each item is a pair * containing the node level and it's name. */ - typedef std::vector> Hierarchy; + using Hierarchy = std::vector>; /** * @note A vector of strings. Used for symplifying syntax. */ - typedef std::vector StringVector; + using StringVector = std::vector; public: /** From eb3b48e5239fc0dfab9d97ec2224aa65e1712dad Mon Sep 17 00:00:00 2001 From: Marc-Antoine Lortie Date: Tue, 14 Mar 2023 09:21:45 -0400 Subject: [PATCH 37/61] Invert logic in build_bone_children_hierarchy. --- code/AssetLib/MDL/HalfLife/HL1MDLLoader.cpp | 24 ++++++++++----------- 1 file changed, 12 insertions(+), 12 deletions(-) diff --git a/code/AssetLib/MDL/HalfLife/HL1MDLLoader.cpp b/code/AssetLib/MDL/HalfLife/HL1MDLLoader.cpp index f3a383e8e..a8141fcc1 100644 --- a/code/AssetLib/MDL/HalfLife/HL1MDLLoader.cpp +++ b/code/AssetLib/MDL/HalfLife/HL1MDLLoader.cpp @@ -516,19 +516,19 @@ void HL1MDLLoader::read_bones() { void HL1MDLLoader::build_bone_children_hierarchy(const TempBone &bone) { - if (bone.children.size() > 0) - { - aiNode* bone_node = bone.node; - bone_node->mNumChildren = static_cast(bone.children.size()); - bone_node->mChildren = new aiNode *[bone_node->mNumChildren]; + if (bone.children.empty()) + return; - // Build each child bone's hierarchy recursively. - for (size_t i = 0; i < bone.children.size(); ++i) - { - const TempBone &child_bone = temp_bones_[bone.children[i]]; - bone_node->mChildren[i] = child_bone.node; - build_bone_children_hierarchy(child_bone); - } + aiNode* bone_node = bone.node; + bone_node->mNumChildren = static_cast(bone.children.size()); + bone_node->mChildren = new aiNode *[bone_node->mNumChildren]; + + // Build each child bone's hierarchy recursively. + for (size_t i = 0; i < bone.children.size(); ++i) + { + const TempBone &child_bone = temp_bones_[bone.children[i]]; + bone_node->mChildren[i] = child_bone.node; + build_bone_children_hierarchy(child_bone); } } From 2acfc125c3dfc295136b81050425ac3e23d37654 Mon Sep 17 00:00:00 2001 From: Kim Kulling Date: Tue, 14 Mar 2023 20:03:14 +0100 Subject: [PATCH 38/61] Refactoring: Make GeoUtils reusable --- code/CMakeLists.txt | 7 ++++ code/Common/Subdivision.cpp | 1 + code/Geometry/GeometryUtils.cpp | 40 +++++++++++++++++++ code/Geometry/GeometryUtils.h | 13 ++++++ code/PostProcessing/FindDegenerates.cpp | 38 +----------------- code/PostProcessing/FindDegenerates.h | 14 +++---- code/PostProcessing/FindInstancesProcess.cpp | 4 -- code/PostProcessing/FindInstancesProcess.h | 10 ++--- .../PostProcessing/FindInvalidDataProcess.cpp | 4 -- code/PostProcessing/FindInvalidDataProcess.h | 2 +- code/PostProcessing/FixNormalsStep.cpp | 15 +------ code/PostProcessing/FixNormalsStep.h | 7 ++-- .../GenBoundingBoxesProcess.cpp | 4 -- code/PostProcessing/GenBoundingBoxesProcess.h | 11 ++--- code/PostProcessing/GenFaceNormalsProcess.cpp | 8 ---- code/PostProcessing/GenFaceNormalsProcess.h | 17 ++++---- .../GenVertexNormalsProcess.cpp | 13 +++--- code/PostProcessing/GenVertexNormalsProcess.h | 2 +- 18 files changed, 96 insertions(+), 114 deletions(-) create mode 100644 code/Geometry/GeometryUtils.cpp create mode 100644 code/Geometry/GeometryUtils.h diff --git a/code/CMakeLists.txt b/code/CMakeLists.txt index a098f3e85..ba5415fe0 100644 --- a/code/CMakeLists.txt +++ b/code/CMakeLists.txt @@ -218,6 +218,12 @@ SET( CApi_SRCS ) SOURCE_GROUP(CApi FILES ${CApi_SRCS}) +SET(Geometry_SRCS + Geometry/GeometryUtils.h + Geometry/GeometryUtils.cpp +) +SOURCE_GROUP(Geometry FILES ${Geometry_SRCS}) + SET( STEPParser_SRCS AssetLib/STEPParser/STEPFileReader.h AssetLib/STEPParser/STEPFileReader.cpp @@ -1129,6 +1135,7 @@ SET( assimp_src ${Core_SRCS} ${CApi_SRCS} ${Common_SRCS} + ${Geometry_SRCS} ${Logging_SRCS} ${Exporter_SRCS} ${PostProcessing_SRCS} diff --git a/code/Common/Subdivision.cpp b/code/Common/Subdivision.cpp index ac4078b47..3aea5d4c5 100644 --- a/code/Common/Subdivision.cpp +++ b/code/Common/Subdivision.cpp @@ -53,6 +53,7 @@ OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. #include using namespace Assimp; + void mydummy() {} #ifdef _MSC_VER diff --git a/code/Geometry/GeometryUtils.cpp b/code/Geometry/GeometryUtils.cpp new file mode 100644 index 000000000..9b29af1dd --- /dev/null +++ b/code/Geometry/GeometryUtils.cpp @@ -0,0 +1,40 @@ +#include "GeometryUtils.h" + +#include + +namespace Assimp { + +ai_real GeometryUtils::heron( ai_real a, ai_real b, ai_real c ) { + ai_real s = (a + b + c) / 2; + ai_real area = pow((s * ( s - a ) * ( s - b ) * ( s - c ) ), (ai_real)0.5 ); + return area; +} + +ai_real GeometryUtils::distance3D( const aiVector3D &vA, aiVector3D &vB ) { + const ai_real lx = ( vB.x - vA.x ); + const ai_real ly = ( vB.y - vA.y ); + const ai_real lz = ( vB.z - vA.z ); + ai_real a = lx*lx + ly*ly + lz*lz; + ai_real d = pow( a, (ai_real)0.5 ); + + return d; +} + + + +ai_real GeometryUtils::calculateAreaOfTriangle( const aiFace& face, aiMesh* mesh ) { + ai_real area = 0; + + aiVector3D vA( mesh->mVertices[ face.mIndices[ 0 ] ] ); + aiVector3D vB( mesh->mVertices[ face.mIndices[ 1 ] ] ); + aiVector3D vC( mesh->mVertices[ face.mIndices[ 2 ] ] ); + + ai_real a( distance3D( vA, vB ) ); + ai_real b( distance3D( vB, vC ) ); + ai_real c( distance3D( vC, vA ) ); + area = heron( a, b, c ); + + return area; +} + +} // namespace Assimp diff --git a/code/Geometry/GeometryUtils.h b/code/Geometry/GeometryUtils.h new file mode 100644 index 000000000..2eb96926d --- /dev/null +++ b/code/Geometry/GeometryUtils.h @@ -0,0 +1,13 @@ +#include +#include + +namespace Assimp { + +class GeometryUtils { +public: + static ai_real heron( ai_real a, ai_real b, ai_real c ); + static ai_real distance3D( const aiVector3D &vA, aiVector3D &vB ); + static ai_real calculateAreaOfTriangle( const aiFace& face, aiMesh* mesh ); +}; + +} // namespace Assimp diff --git a/code/PostProcessing/FindDegenerates.cpp b/code/PostProcessing/FindDegenerates.cpp index 344979949..5874c17d2 100644 --- a/code/PostProcessing/FindDegenerates.cpp +++ b/code/PostProcessing/FindDegenerates.cpp @@ -45,6 +45,7 @@ OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. #include "ProcessHelper.h" #include "FindDegenerates.h" +#include "Geometry/GeometryUtils.h" #include @@ -63,10 +64,6 @@ FindDegeneratesProcess::FindDegeneratesProcess() : // empty } -// ------------------------------------------------------------------------------------------------ -// Destructor, private as well -FindDegeneratesProcess::~FindDegeneratesProcess() = default; - // ------------------------------------------------------------------------------------------------ // Returns whether the processing step is present in the given flag field. bool FindDegeneratesProcess::IsActive( unsigned int pFlags) const { @@ -132,37 +129,6 @@ static void updateSceneGraph(aiNode* pNode, const std::unordered_mapmVertices[ face.mIndices[ 0 ] ] ); - aiVector3D vB( mesh->mVertices[ face.mIndices[ 1 ] ] ); - aiVector3D vC( mesh->mVertices[ face.mIndices[ 2 ] ] ); - - ai_real a( distance3D( vA, vB ) ); - ai_real b( distance3D( vB, vC ) ); - ai_real c( distance3D( vC, vA ) ); - area = heron( a, b, c ); - - return area; -} - // ------------------------------------------------------------------------------------------------ // Executes the post processing step on the given imported mesh bool FindDegeneratesProcess::ExecuteOnMesh( aiMesh* mesh) { @@ -218,7 +184,7 @@ bool FindDegeneratesProcess::ExecuteOnMesh( aiMesh* mesh) { if ( mConfigCheckAreaOfTriangle ) { if ( face.mNumIndices == 3 ) { - ai_real area = calculateAreaOfTriangle( face, mesh ); + ai_real area = GeometryUtils::calculateAreaOfTriangle( face, mesh ); if (area < ai_epsilon) { if ( mConfigRemoveDegenerates ) { remove_me[ a ] = true; diff --git a/code/PostProcessing/FindDegenerates.h b/code/PostProcessing/FindDegenerates.h index 6fe1e929b..55a9dd981 100644 --- a/code/PostProcessing/FindDegenerates.h +++ b/code/PostProcessing/FindDegenerates.h @@ -59,7 +59,7 @@ namespace Assimp { class ASSIMP_API FindDegeneratesProcess : public BaseProcess { public: FindDegeneratesProcess(); - ~FindDegeneratesProcess(); + ~FindDegeneratesProcess() = default; // ------------------------------------------------------------------- // Check whether step is active @@ -105,23 +105,19 @@ private: bool mConfigCheckAreaOfTriangle; }; -inline -void FindDegeneratesProcess::EnableInstantRemoval(bool enabled) { +inline void FindDegeneratesProcess::EnableInstantRemoval(bool enabled) { mConfigRemoveDegenerates = enabled; } -inline -bool FindDegeneratesProcess::IsInstantRemoval() const { +inline bool FindDegeneratesProcess::IsInstantRemoval() const { return mConfigRemoveDegenerates; } -inline -void FindDegeneratesProcess::EnableAreaCheck( bool enabled ) { +inline void FindDegeneratesProcess::EnableAreaCheck( bool enabled ) { mConfigCheckAreaOfTriangle = enabled; } -inline -bool FindDegeneratesProcess::isAreaCheckEnabled() const { +inline bool FindDegeneratesProcess::isAreaCheckEnabled() const { return mConfigCheckAreaOfTriangle; } diff --git a/code/PostProcessing/FindInstancesProcess.cpp b/code/PostProcessing/FindInstancesProcess.cpp index 07a0f66db..55974b1c3 100644 --- a/code/PostProcessing/FindInstancesProcess.cpp +++ b/code/PostProcessing/FindInstancesProcess.cpp @@ -58,10 +58,6 @@ FindInstancesProcess::FindInstancesProcess() : configSpeedFlag (false) {} -// ------------------------------------------------------------------------------------------------ -// Destructor, private as well -FindInstancesProcess::~FindInstancesProcess() = default; - // ------------------------------------------------------------------------------------------------ // Returns whether the processing step is present in the given flag field. bool FindInstancesProcess::IsActive( unsigned int pFlags) const diff --git a/code/PostProcessing/FindInstancesProcess.h b/code/PostProcessing/FindInstancesProcess.h index b501d88d5..d1daeb1f4 100644 --- a/code/PostProcessing/FindInstancesProcess.h +++ b/code/PostProcessing/FindInstancesProcess.h @@ -107,14 +107,11 @@ inline bool CompareArrays(const aiColor4D* first, const aiColor4D* second, // --------------------------------------------------------------------------- /** @brief A post-processing steps to search for instanced meshes */ -class FindInstancesProcess : public BaseProcess -{ +class FindInstancesProcess : public BaseProcess { public: - FindInstancesProcess(); - ~FindInstancesProcess(); + ~FindInstancesProcess() = default; -public: // ------------------------------------------------------------------- // Check whether step is active in given flags combination bool IsActive( unsigned int pFlags) const; @@ -128,10 +125,9 @@ public: void SetupProperties(const Importer* pImp); private: - bool configSpeedFlag; - }; // ! end class FindInstancesProcess + } // ! end namespace Assimp #endif // !! AI_FINDINSTANCES_H_INC diff --git a/code/PostProcessing/FindInvalidDataProcess.cpp b/code/PostProcessing/FindInvalidDataProcess.cpp index c65208cbd..bb8e365a1 100644 --- a/code/PostProcessing/FindInvalidDataProcess.cpp +++ b/code/PostProcessing/FindInvalidDataProcess.cpp @@ -60,10 +60,6 @@ FindInvalidDataProcess::FindInvalidDataProcess() : // nothing to do here } -// ------------------------------------------------------------------------------------------------ -// Destructor, private as well -FindInvalidDataProcess::~FindInvalidDataProcess() = default; - // ------------------------------------------------------------------------------------------------ // Returns whether the processing step is present in the given flag field. bool FindInvalidDataProcess::IsActive(unsigned int pFlags) const { diff --git a/code/PostProcessing/FindInvalidDataProcess.h b/code/PostProcessing/FindInvalidDataProcess.h index 5ea895c59..c5c7067a6 100644 --- a/code/PostProcessing/FindInvalidDataProcess.h +++ b/code/PostProcessing/FindInvalidDataProcess.h @@ -65,7 +65,7 @@ namespace Assimp { class ASSIMP_API FindInvalidDataProcess : public BaseProcess { public: FindInvalidDataProcess(); - ~FindInvalidDataProcess(); + ~FindInvalidDataProcess() = default; // ------------------------------------------------------------------- // diff --git a/code/PostProcessing/FixNormalsStep.cpp b/code/PostProcessing/FixNormalsStep.cpp index 3791bd35a..54ac05cc8 100644 --- a/code/PostProcessing/FixNormalsStep.cpp +++ b/code/PostProcessing/FixNormalsStep.cpp @@ -56,26 +56,15 @@ OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. using namespace Assimp; - -// ------------------------------------------------------------------------------------------------ -// Constructor to be privately used by Importer -FixInfacingNormalsProcess::FixInfacingNormalsProcess() = default; - -// ------------------------------------------------------------------------------------------------ -// Destructor, private as well -FixInfacingNormalsProcess::~FixInfacingNormalsProcess() = default; - // ------------------------------------------------------------------------------------------------ // Returns whether the processing step is present in the given flag field. -bool FixInfacingNormalsProcess::IsActive( unsigned int pFlags) const -{ +bool FixInfacingNormalsProcess::IsActive( unsigned int pFlags) const { return (pFlags & aiProcess_FixInfacingNormals) != 0; } // ------------------------------------------------------------------------------------------------ // Executes the post processing step on the given imported data. -void FixInfacingNormalsProcess::Execute( aiScene* pScene) -{ +void FixInfacingNormalsProcess::Execute( aiScene* pScene) { ASSIMP_LOG_DEBUG("FixInfacingNormalsProcess begin"); bool bHas( false ); diff --git a/code/PostProcessing/FixNormalsStep.h b/code/PostProcessing/FixNormalsStep.h index b7d3ba386..ec546c987 100644 --- a/code/PostProcessing/FixNormalsStep.h +++ b/code/PostProcessing/FixNormalsStep.h @@ -49,8 +49,7 @@ OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. struct aiMesh; -namespace Assimp -{ +namespace Assimp { // --------------------------------------------------------------------------- /** The FixInfacingNormalsProcess tries to determine whether the normal @@ -59,8 +58,8 @@ namespace Assimp */ class FixInfacingNormalsProcess : public BaseProcess { public: - FixInfacingNormalsProcess(); - ~FixInfacingNormalsProcess(); + FixInfacingNormalsProcess() = default; + ~FixInfacingNormalsProcess() = default; // ------------------------------------------------------------------- /** Returns whether the processing step is present in the given flag field. diff --git a/code/PostProcessing/GenBoundingBoxesProcess.cpp b/code/PostProcessing/GenBoundingBoxesProcess.cpp index 52a0861e5..ca8e4d6d0 100644 --- a/code/PostProcessing/GenBoundingBoxesProcess.cpp +++ b/code/PostProcessing/GenBoundingBoxesProcess.cpp @@ -48,10 +48,6 @@ OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. namespace Assimp { -GenBoundingBoxesProcess::GenBoundingBoxesProcess() = default; - -GenBoundingBoxesProcess::~GenBoundingBoxesProcess() = default; - bool GenBoundingBoxesProcess::IsActive(unsigned int pFlags) const { return 0 != ( pFlags & aiProcess_GenBoundingBoxes ); } diff --git a/code/PostProcessing/GenBoundingBoxesProcess.h b/code/PostProcessing/GenBoundingBoxesProcess.h index 0b7591b6d..a880a0638 100644 --- a/code/PostProcessing/GenBoundingBoxesProcess.h +++ b/code/PostProcessing/GenBoundingBoxesProcess.h @@ -19,7 +19,7 @@ conditions are met: copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution. - +s * Neither the name of the assimp team, nor the names of its contributors may be used to endorse or promote products derived from this software without specific prior @@ -54,15 +54,16 @@ OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. namespace Assimp { -/** Post-processing process to find axis-aligned bounding volumes for amm meshes - * used in a scene +/** + * @brief Post-processing process to find axis-aligned bounding volumes for amm meshes + * used in a scene. */ class ASSIMP_API GenBoundingBoxesProcess : public BaseProcess { public: /// The class constructor. - GenBoundingBoxesProcess(); + GenBoundingBoxesProcess() = default; /// The class destructor. - ~GenBoundingBoxesProcess(); + ~GenBoundingBoxesProcess() = default; /// Will return true, if aiProcess_GenBoundingBoxes is defined. bool IsActive(unsigned int pFlags) const override; /// The execution callback. diff --git a/code/PostProcessing/GenFaceNormalsProcess.cpp b/code/PostProcessing/GenFaceNormalsProcess.cpp index d3520d4b2..1d259ce22 100644 --- a/code/PostProcessing/GenFaceNormalsProcess.cpp +++ b/code/PostProcessing/GenFaceNormalsProcess.cpp @@ -54,14 +54,6 @@ OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. using namespace Assimp; -// ------------------------------------------------------------------------------------------------ -// Constructor to be privately used by Importer -GenFaceNormalsProcess::GenFaceNormalsProcess() = default; - -// ------------------------------------------------------------------------------------------------ -// Destructor, private as well -GenFaceNormalsProcess::~GenFaceNormalsProcess() = default; - // ------------------------------------------------------------------------------------------------ // Returns whether the processing step is present in the given flag field. bool GenFaceNormalsProcess::IsActive(unsigned int pFlags) const { diff --git a/code/PostProcessing/GenFaceNormalsProcess.h b/code/PostProcessing/GenFaceNormalsProcess.h index c2f157e20..68e3fee0b 100644 --- a/code/PostProcessing/GenFaceNormalsProcess.h +++ b/code/PostProcessing/GenFaceNormalsProcess.h @@ -47,20 +47,17 @@ OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. #include "Common/BaseProcess.h" #include -namespace Assimp -{ +namespace Assimp { // --------------------------------------------------------------------------- -/** The GenFaceNormalsProcess computes face normals for all faces of all meshes -*/ -class ASSIMP_API_WINONLY GenFaceNormalsProcess : public BaseProcess -{ +/** + * @brief The GenFaceNormalsProcess computes face normals for all faces of all meshes + */ +class ASSIMP_API_WINONLY GenFaceNormalsProcess : public BaseProcess { public: + GenFaceNormalsProcess() = default; + ~GenFaceNormalsProcess() = default; - GenFaceNormalsProcess(); - ~GenFaceNormalsProcess(); - -public: // ------------------------------------------------------------------- /** Returns whether the processing step is present in the given flag field. * @param pFlags The processing flags the importer was called with. A bitwise diff --git a/code/PostProcessing/GenVertexNormalsProcess.cpp b/code/PostProcessing/GenVertexNormalsProcess.cpp index 5b9033383..c8afac297 100644 --- a/code/PostProcessing/GenVertexNormalsProcess.cpp +++ b/code/PostProcessing/GenVertexNormalsProcess.cpp @@ -60,10 +60,6 @@ GenVertexNormalsProcess::GenVertexNormalsProcess() : // empty } -// ------------------------------------------------------------------------------------------------ -// Destructor, private as well -GenVertexNormalsProcess::~GenVertexNormalsProcess() = default; - // ------------------------------------------------------------------------------------------------ // Returns whether the processing step is present in the given flag field. bool GenVertexNormalsProcess::IsActive(unsigned int pFlags) const { @@ -109,10 +105,10 @@ void GenVertexNormalsProcess::Execute(aiScene *pScene) { // Executes the post processing step on the given imported data. bool GenVertexNormalsProcess::GenMeshVertexNormals(aiMesh *pMesh, unsigned int meshIndex) { if (nullptr != pMesh->mNormals) { - if (force_) - delete[] pMesh->mNormals; - else + if (!force_) { return false; + } + delete[] pMesh->mNormals; } // If the mesh consists of lines and/or points but not of @@ -144,8 +140,9 @@ bool GenVertexNormalsProcess::GenMeshVertexNormals(aiMesh *pMesh, unsigned int m const aiVector3D *pV3 = &pMesh->mVertices[face.mIndices[face.mNumIndices - 1]]; // Boolean XOR - if either but not both of these flags is set, then the winding order has // changed and the cross product to calculate the normal needs to be reversed - if (flippedWindingOrder_ != leftHanded_) + if (flippedWindingOrder_ != leftHanded_) { std::swap(pV2, pV3); + } const aiVector3D vNor = ((*pV2 - *pV1) ^ (*pV3 - *pV1)).NormalizeSafe(); for (unsigned int i = 0; i < face.mNumIndices; ++i) { diff --git a/code/PostProcessing/GenVertexNormalsProcess.h b/code/PostProcessing/GenVertexNormalsProcess.h index 370bf42b1..3a15bf4a8 100644 --- a/code/PostProcessing/GenVertexNormalsProcess.h +++ b/code/PostProcessing/GenVertexNormalsProcess.h @@ -61,7 +61,7 @@ namespace Assimp { class ASSIMP_API GenVertexNormalsProcess : public BaseProcess { public: GenVertexNormalsProcess(); - ~GenVertexNormalsProcess(); + ~GenVertexNormalsProcess() = default; // ------------------------------------------------------------------- /** Returns whether the processing step is present in the given flag. From 1147f0c8bde73b8e86adf24d1ef986cd841e80f1 Mon Sep 17 00:00:00 2001 From: Kim Kulling Date: Tue, 14 Mar 2023 21:04:43 +0100 Subject: [PATCH 39/61] Refactoring: Code cleanup post-processing. --- code/PostProcessing/DeboneProcess.cpp | 79 +++----- code/PostProcessing/DeboneProcess.h | 2 +- .../PostProcessing/DropFaceNormalsProcess.cpp | 8 - code/PostProcessing/DropFaceNormalsProcess.h | 4 +- code/PostProcessing/EmbedTexturesProcess.cpp | 4 - code/PostProcessing/EmbedTexturesProcess.h | 4 +- code/PostProcessing/FindDegenerates.h | 2 +- code/PostProcessing/FindInstancesProcess.h | 2 +- code/PostProcessing/FindInvalidDataProcess.h | 24 +-- code/PostProcessing/FixNormalsStep.h | 4 +- code/PostProcessing/GenBoundingBoxesProcess.h | 14 +- code/PostProcessing/GenFaceNormalsProcess.h | 4 +- code/PostProcessing/GenVertexNormalsProcess.h | 4 +- code/PostProcessing/ImproveCacheLocality.cpp | 4 - code/PostProcessing/ImproveCacheLocality.h | 13 +- code/PostProcessing/JoinVerticesProcess.h | 12 +- .../LimitBoneWeightsProcess.cpp | 8 +- code/PostProcessing/LimitBoneWeightsProcess.h | 4 +- code/PostProcessing/MakeVerboseFormat.cpp | 4 - code/PostProcessing/MakeVerboseFormat.h | 13 +- code/PostProcessing/OptimizeGraph.cpp | 4 - code/PostProcessing/OptimizeGraph.h | 4 +- code/PostProcessing/OptimizeMeshes.cpp | 4 - code/PostProcessing/OptimizeMeshes.h | 7 +- code/PostProcessing/PretransformVertices.cpp | 4 - code/PostProcessing/PretransformVertices.h | 4 +- .../RemoveRedundantMaterials.cpp | 4 - .../PostProcessing/RemoveRedundantMaterials.h | 7 +- code/PostProcessing/RemoveVCProcess.cpp | 4 - code/PostProcessing/RemoveVCProcess.h | 7 +- code/PostProcessing/ScaleProcess.cpp | 43 ++-- code/PostProcessing/ScaleProcess.h | 7 +- code/PostProcessing/SortByPTypeProcess.cpp | 4 - code/PostProcessing/SortByPTypeProcess.h | 4 +- .../SplitByBoneCountProcess.cpp | 184 ++++++------------ code/PostProcessing/SplitByBoneCountProcess.h | 37 ++-- code/PostProcessing/SplitLargeMeshes.cpp | 6 - code/PostProcessing/SplitLargeMeshes.h | 23 +-- code/PostProcessing/TextureTransform.cpp | 34 +--- code/PostProcessing/TextureTransform.h | 17 +- code/PostProcessing/TriangulateProcess.cpp | 9 - code/PostProcessing/TriangulateProcess.h | 6 +- code/PostProcessing/ValidateDataStructure.cpp | 7 +- code/PostProcessing/ValidateDataStructure.h | 6 +- 44 files changed, 235 insertions(+), 414 deletions(-) diff --git a/code/PostProcessing/DeboneProcess.cpp b/code/PostProcessing/DeboneProcess.cpp index 22a4397bf..2a8499dc5 100644 --- a/code/PostProcessing/DeboneProcess.cpp +++ b/code/PostProcessing/DeboneProcess.cpp @@ -43,42 +43,26 @@ OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. /// @file DeboneProcess.cpp /** Implementation of the DeboneProcess post processing step */ - - // internal headers of the post-processing framework #include "ProcessHelper.h" #include "DeboneProcess.h" #include - using namespace Assimp; // ------------------------------------------------------------------------------------------------ // Constructor to be privately used by Importer -DeboneProcess::DeboneProcess() -{ - mNumBones = 0; - mNumBonesCanDoWithout = 0; - - mThreshold = AI_DEBONE_THRESHOLD; - mAllOrNone = false; -} - -// ------------------------------------------------------------------------------------------------ -// Destructor, private as well -DeboneProcess::~DeboneProcess() = default; +DeboneProcess::DeboneProcess() : mNumBones(0), mNumBonesCanDoWithout(0), mThreshold(AI_DEBONE_THRESHOLD), mAllOrNone(false) {} // ------------------------------------------------------------------------------------------------ // Returns whether the processing step is present in the given flag field. -bool DeboneProcess::IsActive( unsigned int pFlags) const -{ +bool DeboneProcess::IsActive( unsigned int pFlags) const { return (pFlags & aiProcess_Debone) != 0; } // ------------------------------------------------------------------------------------------------ // Executes the post processing step on the given imported data. -void DeboneProcess::SetupProperties(const Importer* pImp) -{ +void DeboneProcess::SetupProperties(const Importer* pImp) { // get the current value of the property mAllOrNone = pImp->GetPropertyInteger(AI_CONFIG_PP_DB_ALL_OR_NONE,0)?true:false; mThreshold = pImp->GetPropertyFloat(AI_CONFIG_PP_DB_THRESHOLD,AI_DEBONE_THRESHOLD); @@ -86,8 +70,7 @@ void DeboneProcess::SetupProperties(const Importer* pImp) // ------------------------------------------------------------------------------------------------ // Executes the post processing step on the given imported data. -void DeboneProcess::Execute( aiScene* pScene) -{ +void DeboneProcess::Execute( aiScene* pScene) { ASSIMP_LOG_DEBUG("DeboneProcess begin"); if(!pScene->mNumMeshes) { @@ -117,10 +100,8 @@ void DeboneProcess::Execute( aiScene* pScene) // build a new array of meshes for the scene std::vector meshes; - for(unsigned int a=0;amNumMeshes;a++) - { + for (unsigned int a=0;amNumMeshes; ++a) { aiMesh* srcMesh = pScene->mMeshes[a]; - std::vector > newMeshes; if(splitList[a]) { @@ -150,8 +131,7 @@ void DeboneProcess::Execute( aiScene* pScene) // and destroy the source mesh. It should be completely contained inside the new submeshes delete srcMesh; - } - else { + } else { // Mesh is kept unchanged - store it's new place in the mesh array mSubMeshIndices[a].emplace_back(static_cast(meshes.size()), (aiNode *)nullptr); meshes.push_back(srcMesh); @@ -173,8 +153,7 @@ void DeboneProcess::Execute( aiScene* pScene) // ------------------------------------------------------------------------------------------------ // Counts bones total/removable in a given mesh. -bool DeboneProcess::ConsiderMesh(const aiMesh* pMesh) -{ +bool DeboneProcess::ConsiderMesh(const aiMesh* pMesh) { if(!pMesh->HasBones()) { return false; } @@ -193,25 +172,23 @@ bool DeboneProcess::ConsiderMesh(const aiMesh* pMesh) for(unsigned int i=0;imNumBones;i++) { for(unsigned int j=0;jmBones[i]->mNumWeights;j++) { float w = pMesh->mBones[i]->mWeights[j].mWeight; - - if(w==0.0f) { + if (w == 0.0f) { continue; } unsigned int vid = pMesh->mBones[i]->mWeights[j].mVertexId; - if(w>=mThreshold) { - - if(vertexBones[vid]!=cUnowned) { - if(vertexBones[vid]==i) //double entry - { + if (w >= mThreshold) { + if (vertexBones[vid] != cUnowned) { + //double entry + if(vertexBones[vid]==i) { ASSIMP_LOG_WARN("Encountered double entry in bone weights"); - } - else //TODO: track attraction in order to break tie - { + } else { + //TODO: track attraction in order to break tie vertexBones[vid] = cCoowned; } - } - else vertexBones[vid] = i; + } else { + vertexBones[vid] = i; + } } if(!isBoneNecessary[i]) { @@ -227,13 +204,16 @@ bool DeboneProcess::ConsiderMesh(const aiMesh* pMesh) if(isInterstitialRequired) { for(unsigned int i=0;imNumFaces;i++) { unsigned int v = vertexBones[pMesh->mFaces[i].mIndices[0]]; - - for(unsigned int j=1;jmFaces[i].mNumIndices;j++) { + for (unsigned int j=1;jmFaces[i].mNumIndices;j++) { unsigned int w = vertexBones[pMesh->mFaces[i].mIndices[j]]; - if(v!=w) { - if(vmNumBones) isBoneNecessary[v] = true; - if(wmNumBones) isBoneNecessary[w] = true; + if (v != w) { + if(vmNumBones) { + isBoneNecessary[v] = true; + } + if (wmNumBones) { + isBoneNecessary[w] = true; + } } } } @@ -252,8 +232,7 @@ bool DeboneProcess::ConsiderMesh(const aiMesh* pMesh) // ------------------------------------------------------------------------------------------------ // Splits the given mesh by bone count. -void DeboneProcess::SplitMesh( const aiMesh* pMesh, std::vector< std::pair< aiMesh*,const aiBone* > >& poNewMeshes) const -{ +void DeboneProcess::SplitMesh( const aiMesh* pMesh, std::vector< std::pair< aiMesh*,const aiBone* > >& poNewMeshes) const { // same deal here as ConsiderMesh basically std::vector isBoneNecessary(pMesh->mNumBones,false); @@ -371,8 +350,7 @@ void DeboneProcess::SplitMesh( const aiMesh* pMesh, std::vector< std::pair< aiMe // ------------------------------------------------------------------------------------------------ // Recursively updates the node's mesh list to account for the changed mesh list -void DeboneProcess::UpdateNode(aiNode* pNode) const -{ +void DeboneProcess::UpdateNode(aiNode* pNode) const { // rebuild the node's mesh index list std::vector newMeshList; @@ -430,8 +408,7 @@ void DeboneProcess::UpdateNode(aiNode* pNode) const // ------------------------------------------------------------------------------------------------ // Apply the node transformation to a mesh -void DeboneProcess::ApplyTransform(aiMesh* mesh, const aiMatrix4x4& mat)const -{ +void DeboneProcess::ApplyTransform(aiMesh* mesh, const aiMatrix4x4& mat)const { // Check whether we need to transform the coordinates at all if (!mat.IsIdentity()) { diff --git a/code/PostProcessing/DeboneProcess.h b/code/PostProcessing/DeboneProcess.h index cb072b7eb..080bc30d1 100644 --- a/code/PostProcessing/DeboneProcess.h +++ b/code/PostProcessing/DeboneProcess.h @@ -70,7 +70,7 @@ namespace Assimp { class DeboneProcess : public BaseProcess { public: DeboneProcess(); - ~DeboneProcess(); + ~DeboneProcess() override = default; // ------------------------------------------------------------------- /** Returns whether the processing step is present in the given flag. diff --git a/code/PostProcessing/DropFaceNormalsProcess.cpp b/code/PostProcessing/DropFaceNormalsProcess.cpp index f85daa588..223482374 100644 --- a/code/PostProcessing/DropFaceNormalsProcess.cpp +++ b/code/PostProcessing/DropFaceNormalsProcess.cpp @@ -54,14 +54,6 @@ OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. using namespace Assimp; -// ------------------------------------------------------------------------------------------------ -// Constructor to be privately used by Importer -DropFaceNormalsProcess::DropFaceNormalsProcess() = default; - -// ------------------------------------------------------------------------------------------------ -// Destructor, private as well -DropFaceNormalsProcess::~DropFaceNormalsProcess() = default; - // ------------------------------------------------------------------------------------------------ // Returns whether the processing step is present in the given flag field. bool DropFaceNormalsProcess::IsActive( unsigned int pFlags) const { diff --git a/code/PostProcessing/DropFaceNormalsProcess.h b/code/PostProcessing/DropFaceNormalsProcess.h index 50abdc727..719c98dc7 100644 --- a/code/PostProcessing/DropFaceNormalsProcess.h +++ b/code/PostProcessing/DropFaceNormalsProcess.h @@ -55,8 +55,8 @@ namespace Assimp { */ class ASSIMP_API_WINONLY DropFaceNormalsProcess : public BaseProcess { public: - DropFaceNormalsProcess(); - ~DropFaceNormalsProcess(); + DropFaceNormalsProcess() = default; + ~DropFaceNormalsProcess() override = default; // ------------------------------------------------------------------- /** Returns whether the processing step is present in the given flag field. diff --git a/code/PostProcessing/EmbedTexturesProcess.cpp b/code/PostProcessing/EmbedTexturesProcess.cpp index dc7e54ac1..d5d2ef872 100644 --- a/code/PostProcessing/EmbedTexturesProcess.cpp +++ b/code/PostProcessing/EmbedTexturesProcess.cpp @@ -49,10 +49,6 @@ OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. using namespace Assimp; -EmbedTexturesProcess::EmbedTexturesProcess() = default; - -EmbedTexturesProcess::~EmbedTexturesProcess() = default; - bool EmbedTexturesProcess::IsActive(unsigned int pFlags) const { return (pFlags & aiProcess_EmbedTextures) != 0; } diff --git a/code/PostProcessing/EmbedTexturesProcess.h b/code/PostProcessing/EmbedTexturesProcess.h index c3e63612c..e09fa0896 100644 --- a/code/PostProcessing/EmbedTexturesProcess.h +++ b/code/PostProcessing/EmbedTexturesProcess.h @@ -62,10 +62,10 @@ namespace Assimp { class ASSIMP_API EmbedTexturesProcess : public BaseProcess { public: /// The default class constructor. - EmbedTexturesProcess(); + EmbedTexturesProcess() = default; /// The class destructor. - virtual ~EmbedTexturesProcess(); + ~EmbedTexturesProcess() override = default; /// Overwritten, @see BaseProcess virtual bool IsActive(unsigned int pFlags) const; diff --git a/code/PostProcessing/FindDegenerates.h b/code/PostProcessing/FindDegenerates.h index 55a9dd981..d1eb81615 100644 --- a/code/PostProcessing/FindDegenerates.h +++ b/code/PostProcessing/FindDegenerates.h @@ -59,7 +59,7 @@ namespace Assimp { class ASSIMP_API FindDegeneratesProcess : public BaseProcess { public: FindDegeneratesProcess(); - ~FindDegeneratesProcess() = default; + ~FindDegeneratesProcess() override = default; // ------------------------------------------------------------------- // Check whether step is active diff --git a/code/PostProcessing/FindInstancesProcess.h b/code/PostProcessing/FindInstancesProcess.h index d1daeb1f4..b6c61527a 100644 --- a/code/PostProcessing/FindInstancesProcess.h +++ b/code/PostProcessing/FindInstancesProcess.h @@ -110,7 +110,7 @@ inline bool CompareArrays(const aiColor4D* first, const aiColor4D* second, class FindInstancesProcess : public BaseProcess { public: FindInstancesProcess(); - ~FindInstancesProcess() = default; + ~FindInstancesProcess() override = default; // ------------------------------------------------------------------- // Check whether step is active in given flags combination diff --git a/code/PostProcessing/FindInvalidDataProcess.h b/code/PostProcessing/FindInvalidDataProcess.h index c5c7067a6..14746864f 100644 --- a/code/PostProcessing/FindInvalidDataProcess.h +++ b/code/PostProcessing/FindInvalidDataProcess.h @@ -64,35 +64,37 @@ namespace Assimp { * which have zero normal vectors. */ class ASSIMP_API FindInvalidDataProcess : public BaseProcess { public: + // ------------------------------------------------------------------- + /// The default class constructor / destructor. FindInvalidDataProcess(); - ~FindInvalidDataProcess() = default; + ~FindInvalidDataProcess() override = default; // ------------------------------------------------------------------- - // + /// Returns active state. bool IsActive(unsigned int pFlags) const; // ------------------------------------------------------------------- - // Setup import settings + /// Setup import settings void SetupProperties(const Importer *pImp); // ------------------------------------------------------------------- - // Run the step + /// Run the step void Execute(aiScene *pScene); // ------------------------------------------------------------------- - /** Executes the post-processing step on the given mesh - * @param pMesh The mesh to process. - * @return 0 - nothing, 1 - removed sth, 2 - please delete me */ + /// Executes the post-processing step on the given mesh + /// @param pMesh The mesh to process. + /// @return 0 - nothing, 1 - removed sth, 2 - please delete me */ int ProcessMesh(aiMesh *pMesh); // ------------------------------------------------------------------- - /** Executes the post-processing step on the given animation - * @param anim The animation to process. */ + /// Executes the post-processing step on the given animation + /// @param anim The animation to process. */ void ProcessAnimation(aiAnimation *anim); // ------------------------------------------------------------------- - /** Executes the post-processing step on the given anim channel - * @param anim The animation channel to process.*/ + /// Executes the post-processing step on the given anim channel + /// @param anim The animation channel to process.*/ void ProcessAnimationChannel(aiNodeAnim *anim); private: diff --git a/code/PostProcessing/FixNormalsStep.h b/code/PostProcessing/FixNormalsStep.h index ec546c987..e5f5c8a1f 100644 --- a/code/PostProcessing/FixNormalsStep.h +++ b/code/PostProcessing/FixNormalsStep.h @@ -58,8 +58,10 @@ namespace Assimp { */ class FixInfacingNormalsProcess : public BaseProcess { public: + // ------------------------------------------------------------------- + /// The default class constructor / destructor. FixInfacingNormalsProcess() = default; - ~FixInfacingNormalsProcess() = default; + ~FixInfacingNormalsProcess() override = default; // ------------------------------------------------------------------- /** Returns whether the processing step is present in the given flag field. diff --git a/code/PostProcessing/GenBoundingBoxesProcess.h b/code/PostProcessing/GenBoundingBoxesProcess.h index a880a0638..0cf8514f4 100644 --- a/code/PostProcessing/GenBoundingBoxesProcess.h +++ b/code/PostProcessing/GenBoundingBoxesProcess.h @@ -60,13 +60,17 @@ namespace Assimp { */ class ASSIMP_API GenBoundingBoxesProcess : public BaseProcess { public: - /// The class constructor. + // ------------------------------------------------------------------- + /// The default class constructor / destructor. GenBoundingBoxesProcess() = default; - /// The class destructor. - ~GenBoundingBoxesProcess() = default; - /// Will return true, if aiProcess_GenBoundingBoxes is defined. + ~GenBoundingBoxesProcess() override = default; + + // ------------------------------------------------------------------- + /// @brief Will return true, if aiProcess_GenBoundingBoxes is defined. bool IsActive(unsigned int pFlags) const override; - /// The execution callback. + + // ------------------------------------------------------------------- + /// @brief The execution callback. void Execute(aiScene* pScene) override; }; diff --git a/code/PostProcessing/GenFaceNormalsProcess.h b/code/PostProcessing/GenFaceNormalsProcess.h index 68e3fee0b..b1babca28 100644 --- a/code/PostProcessing/GenFaceNormalsProcess.h +++ b/code/PostProcessing/GenFaceNormalsProcess.h @@ -55,8 +55,10 @@ namespace Assimp { */ class ASSIMP_API_WINONLY GenFaceNormalsProcess : public BaseProcess { public: + // ------------------------------------------------------------------- + /// The default class constructor / destructor. GenFaceNormalsProcess() = default; - ~GenFaceNormalsProcess() = default; + ~GenFaceNormalsProcess() override = default; // ------------------------------------------------------------------- /** Returns whether the processing step is present in the given flag field. diff --git a/code/PostProcessing/GenVertexNormalsProcess.h b/code/PostProcessing/GenVertexNormalsProcess.h index 3a15bf4a8..3999fc3e9 100644 --- a/code/PostProcessing/GenVertexNormalsProcess.h +++ b/code/PostProcessing/GenVertexNormalsProcess.h @@ -60,8 +60,10 @@ namespace Assimp { */ class ASSIMP_API GenVertexNormalsProcess : public BaseProcess { public: + // ------------------------------------------------------------------- + /// The default class constructor / destructor. GenVertexNormalsProcess(); - ~GenVertexNormalsProcess() = default; + ~GenVertexNormalsProcess() override = default; // ------------------------------------------------------------------- /** Returns whether the processing step is present in the given flag. diff --git a/code/PostProcessing/ImproveCacheLocality.cpp b/code/PostProcessing/ImproveCacheLocality.cpp index 197856171..9336d6b17 100644 --- a/code/PostProcessing/ImproveCacheLocality.cpp +++ b/code/PostProcessing/ImproveCacheLocality.cpp @@ -68,10 +68,6 @@ ImproveCacheLocalityProcess::ImproveCacheLocalityProcess() // empty } -// ------------------------------------------------------------------------------------------------ -// Destructor, private as well -ImproveCacheLocalityProcess::~ImproveCacheLocalityProcess() = default; - // ------------------------------------------------------------------------------------------------ // Returns whether the processing step is present in the given flag field. bool ImproveCacheLocalityProcess::IsActive( unsigned int pFlags) const { diff --git a/code/PostProcessing/ImproveCacheLocality.h b/code/PostProcessing/ImproveCacheLocality.h index b2074a17c..34a3883da 100644 --- a/code/PostProcessing/ImproveCacheLocality.h +++ b/code/PostProcessing/ImproveCacheLocality.h @@ -51,8 +51,7 @@ OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. struct aiMesh; -namespace Assimp -{ +namespace Assimp { // --------------------------------------------------------------------------- /** The ImproveCacheLocalityProcess reorders all faces for improved vertex @@ -61,14 +60,12 @@ namespace Assimp * * @note This step expects triagulated input data. */ -class ImproveCacheLocalityProcess : public BaseProcess -{ +class ImproveCacheLocalityProcess : public BaseProcess { public: - + // ------------------------------------------------------------------- + /// The default class constructor / destructor. ImproveCacheLocalityProcess(); - ~ImproveCacheLocalityProcess(); - -public: + ~ImproveCacheLocalityProcess() override = default; // ------------------------------------------------------------------- // Check whether the pp step is active diff --git a/code/PostProcessing/JoinVerticesProcess.h b/code/PostProcessing/JoinVerticesProcess.h index b05d74ef5..de8cea691 100644 --- a/code/PostProcessing/JoinVerticesProcess.h +++ b/code/PostProcessing/JoinVerticesProcess.h @@ -51,8 +51,7 @@ OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. struct aiMesh; -namespace Assimp -{ +namespace Assimp { // --------------------------------------------------------------------------- /** The JoinVerticesProcess unites identical vertices in all imported meshes. @@ -65,12 +64,9 @@ namespace Assimp class ASSIMP_API JoinVerticesProcess : public BaseProcess { public: // ------------------------------------------------------------------- - /// @brief The default class constructor. - JoinVerticesProcess() = default; - - // ------------------------------------------------------------------- - /// @brief The default class destructor. - ~JoinVerticesProcess() = default; + /// The default class constructor / destructor. + JoinVerticesProcess() = default; + ~JoinVerticesProcess() override = default; // ------------------------------------------------------------------- /** Returns whether the processing step is present in the given flag field. diff --git a/code/PostProcessing/LimitBoneWeightsProcess.cpp b/code/PostProcessing/LimitBoneWeightsProcess.cpp index 51fb43dfc..7047ec0f1 100644 --- a/code/PostProcessing/LimitBoneWeightsProcess.cpp +++ b/code/PostProcessing/LimitBoneWeightsProcess.cpp @@ -53,11 +53,9 @@ namespace Assimp { // ------------------------------------------------------------------------------------------------ // Constructor to be privately used by Importer -LimitBoneWeightsProcess::LimitBoneWeightsProcess() : mMaxWeights(AI_LMW_MAX_WEIGHTS) {} - -// ------------------------------------------------------------------------------------------------ -// Destructor, private as well -LimitBoneWeightsProcess::~LimitBoneWeightsProcess() = default; +LimitBoneWeightsProcess::LimitBoneWeightsProcess() : mMaxWeights(AI_LMW_MAX_WEIGHTS) { + // empty +} // ------------------------------------------------------------------------------------------------ // Returns whether the processing step is present in the given flag field. diff --git a/code/PostProcessing/LimitBoneWeightsProcess.h b/code/PostProcessing/LimitBoneWeightsProcess.h index 22d286b68..855c8628a 100644 --- a/code/PostProcessing/LimitBoneWeightsProcess.h +++ b/code/PostProcessing/LimitBoneWeightsProcess.h @@ -74,8 +74,10 @@ namespace Assimp { */ class ASSIMP_API LimitBoneWeightsProcess : public BaseProcess { public: + // ------------------------------------------------------------------- + /// The default class constructor / destructor. LimitBoneWeightsProcess(); - ~LimitBoneWeightsProcess(); + ~LimitBoneWeightsProcess() override = default; // ------------------------------------------------------------------- /** Returns whether the processing step is present in the given flag. diff --git a/code/PostProcessing/MakeVerboseFormat.cpp b/code/PostProcessing/MakeVerboseFormat.cpp index 0f5276cf3..1cc2fdc02 100644 --- a/code/PostProcessing/MakeVerboseFormat.cpp +++ b/code/PostProcessing/MakeVerboseFormat.cpp @@ -49,10 +49,6 @@ OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. using namespace Assimp; -// ------------------------------------------------------------------------------------------------ -MakeVerboseFormatProcess::MakeVerboseFormatProcess() = default; -// ------------------------------------------------------------------------------------------------ -MakeVerboseFormatProcess::~MakeVerboseFormatProcess() = default; // ------------------------------------------------------------------------------------------------ // Executes the post processing step on the given imported data. void MakeVerboseFormatProcess::Execute(aiScene *pScene) { diff --git a/code/PostProcessing/MakeVerboseFormat.h b/code/PostProcessing/MakeVerboseFormat.h index 6b81da622..b7ac10019 100644 --- a/code/PostProcessing/MakeVerboseFormat.h +++ b/code/PostProcessing/MakeVerboseFormat.h @@ -66,15 +66,12 @@ namespace Assimp { * The step has been added because it was required by the viewer, however * it has been moved to the main library since others might find it * useful, too. */ -class ASSIMP_API_WINONLY MakeVerboseFormatProcess : public BaseProcess -{ -public: - - - MakeVerboseFormatProcess(); - ~MakeVerboseFormatProcess(); - +class ASSIMP_API_WINONLY MakeVerboseFormatProcess : public BaseProcess { public: + // ------------------------------------------------------------------- + /// The default class constructor / destructor. + MakeVerboseFormatProcess() = default; + ~MakeVerboseFormatProcess() override = default; // ------------------------------------------------------------------- /** Returns whether the processing step is present in the given flag field. diff --git a/code/PostProcessing/OptimizeGraph.cpp b/code/PostProcessing/OptimizeGraph.cpp index 26b06e9b6..bcd654634 100644 --- a/code/PostProcessing/OptimizeGraph.cpp +++ b/code/PostProcessing/OptimizeGraph.cpp @@ -78,10 +78,6 @@ OptimizeGraphProcess::OptimizeGraphProcess() : // empty } -// ------------------------------------------------------------------------------------------------ -// Destructor, private as well -OptimizeGraphProcess::~OptimizeGraphProcess() = default; - // ------------------------------------------------------------------------------------------------ // Returns whether the processing step is present in the given flag field. bool OptimizeGraphProcess::IsActive(unsigned int pFlags) const { diff --git a/code/PostProcessing/OptimizeGraph.h b/code/PostProcessing/OptimizeGraph.h index f5caa139c..23e59e67d 100644 --- a/code/PostProcessing/OptimizeGraph.h +++ b/code/PostProcessing/OptimizeGraph.h @@ -71,8 +71,10 @@ namespace Assimp { */ class OptimizeGraphProcess : public BaseProcess { public: + // ------------------------------------------------------------------- + /// The default class constructor / destructor. OptimizeGraphProcess(); - ~OptimizeGraphProcess(); + ~OptimizeGraphProcess() override = default; // ------------------------------------------------------------------- bool IsActive( unsigned int pFlags) const override; diff --git a/code/PostProcessing/OptimizeMeshes.cpp b/code/PostProcessing/OptimizeMeshes.cpp index a8c01e2d7..0fd597808 100644 --- a/code/PostProcessing/OptimizeMeshes.cpp +++ b/code/PostProcessing/OptimizeMeshes.cpp @@ -69,10 +69,6 @@ OptimizeMeshesProcess::OptimizeMeshesProcess() // empty } -// ------------------------------------------------------------------------------------------------ -// Destructor, private as well -OptimizeMeshesProcess::~OptimizeMeshesProcess() = default; - // ------------------------------------------------------------------------------------------------ // Returns whether the processing step is present in the given flag field. bool OptimizeMeshesProcess::IsActive( unsigned int pFlags) const diff --git a/code/PostProcessing/OptimizeMeshes.h b/code/PostProcessing/OptimizeMeshes.h index b80f98d5d..1109a30e7 100644 --- a/code/PostProcessing/OptimizeMeshes.h +++ b/code/PostProcessing/OptimizeMeshes.h @@ -68,11 +68,10 @@ namespace Assimp { */ class OptimizeMeshesProcess : public BaseProcess { public: - /// @brief The class constructor. + // ------------------------------------------------------------------- + /// The default class constructor / destructor. OptimizeMeshesProcess(); - - /// @brief The class destructor. - ~OptimizeMeshesProcess(); + ~OptimizeMeshesProcess() override = default; /** @brief Internal utility to store additional mesh info */ diff --git a/code/PostProcessing/PretransformVertices.cpp b/code/PostProcessing/PretransformVertices.cpp index 9ac90d277..b6bb6155e 100644 --- a/code/PostProcessing/PretransformVertices.cpp +++ b/code/PostProcessing/PretransformVertices.cpp @@ -68,10 +68,6 @@ PretransformVertices::PretransformVertices() : // empty } -// ------------------------------------------------------------------------------------------------ -// Destructor, private as well -PretransformVertices::~PretransformVertices() = default; - // ------------------------------------------------------------------------------------------------ // Returns whether the processing step is present in the given flag field. bool PretransformVertices::IsActive(unsigned int pFlags) const { diff --git a/code/PostProcessing/PretransformVertices.h b/code/PostProcessing/PretransformVertices.h index 14e5139ec..7c2b5e99e 100644 --- a/code/PostProcessing/PretransformVertices.h +++ b/code/PostProcessing/PretransformVertices.h @@ -68,8 +68,10 @@ namespace Assimp { */ class ASSIMP_API PretransformVertices : public BaseProcess { public: + // ------------------------------------------------------------------- + /// The default class constructor / destructor. PretransformVertices(); - ~PretransformVertices(); + ~PretransformVertices() override = default; // ------------------------------------------------------------------- // Check whether step is active diff --git a/code/PostProcessing/RemoveRedundantMaterials.cpp b/code/PostProcessing/RemoveRedundantMaterials.cpp index 3c3cd59e0..dbc3c8822 100644 --- a/code/PostProcessing/RemoveRedundantMaterials.cpp +++ b/code/PostProcessing/RemoveRedundantMaterials.cpp @@ -62,10 +62,6 @@ RemoveRedundantMatsProcess::RemoveRedundantMatsProcess() // nothing to do here } -// ------------------------------------------------------------------------------------------------ -// Destructor, private as well -RemoveRedundantMatsProcess::~RemoveRedundantMatsProcess() = default; - // ------------------------------------------------------------------------------------------------ // Returns whether the processing step is present in the given flag field. bool RemoveRedundantMatsProcess::IsActive( unsigned int pFlags) const diff --git a/code/PostProcessing/RemoveRedundantMaterials.h b/code/PostProcessing/RemoveRedundantMaterials.h index e8c1478fd..0fbf33c1b 100644 --- a/code/PostProcessing/RemoveRedundantMaterials.h +++ b/code/PostProcessing/RemoveRedundantMaterials.h @@ -59,11 +59,10 @@ namespace Assimp { */ class ASSIMP_API RemoveRedundantMatsProcess : public BaseProcess { public: - /// The default class constructor. + // ------------------------------------------------------------------- + /// The default class constructor / destructor. RemoveRedundantMatsProcess(); - - /// The class destructor. - ~RemoveRedundantMatsProcess(); + ~RemoveRedundantMatsProcess() override = default; // ------------------------------------------------------------------- // Check whether step is active diff --git a/code/PostProcessing/RemoveVCProcess.cpp b/code/PostProcessing/RemoveVCProcess.cpp index 8bbe791f6..35047dc0a 100644 --- a/code/PostProcessing/RemoveVCProcess.cpp +++ b/code/PostProcessing/RemoveVCProcess.cpp @@ -56,10 +56,6 @@ using namespace Assimp; RemoveVCProcess::RemoveVCProcess() : configDeleteFlags(), mScene() {} -// ------------------------------------------------------------------------------------------------ -// Destructor, private as well -RemoveVCProcess::~RemoveVCProcess() = default; - // ------------------------------------------------------------------------------------------------ // Returns whether the processing step is present in the given flag field. bool RemoveVCProcess::IsActive(unsigned int pFlags) const { diff --git a/code/PostProcessing/RemoveVCProcess.h b/code/PostProcessing/RemoveVCProcess.h index cf1086882..dfd9b59ff 100644 --- a/code/PostProcessing/RemoveVCProcess.h +++ b/code/PostProcessing/RemoveVCProcess.h @@ -58,11 +58,10 @@ namespace Assimp { */ class ASSIMP_API RemoveVCProcess : public BaseProcess { public: - /// The default class constructor. + // ------------------------------------------------------------------- + /// The default class constructor / destructor. RemoveVCProcess(); - - /// The class destructor. - ~RemoveVCProcess(); + ~RemoveVCProcess() override = default; // ------------------------------------------------------------------- /** Returns whether the processing step is present in the given flag field. diff --git a/code/PostProcessing/ScaleProcess.cpp b/code/PostProcessing/ScaleProcess.cpp index 34f68539a..665f28a7e 100644 --- a/code/PostProcessing/ScaleProcess.cpp +++ b/code/PostProcessing/ScaleProcess.cpp @@ -47,25 +47,27 @@ OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. namespace Assimp { -ScaleProcess::ScaleProcess() -: BaseProcess() -, mScale( AI_CONFIG_GLOBAL_SCALE_FACTOR_DEFAULT ) { +// ------------------------------------------------------------------------------------------------ +ScaleProcess::ScaleProcess() : BaseProcess(), mScale( AI_CONFIG_GLOBAL_SCALE_FACTOR_DEFAULT ) { + // empty } -ScaleProcess::~ScaleProcess() = default; - +// ------------------------------------------------------------------------------------------------ void ScaleProcess::setScale( ai_real scale ) { mScale = scale; } +// ------------------------------------------------------------------------------------------------ ai_real ScaleProcess::getScale() const { return mScale; } +// ------------------------------------------------------------------------------------------------ bool ScaleProcess::IsActive( unsigned int pFlags ) const { return ( pFlags & aiProcess_GlobalScale ) != 0; } +// ------------------------------------------------------------------------------------------------ void ScaleProcess::SetupProperties( const Importer* pImp ) { // User scaling mScale = pImp->GetPropertyFloat( AI_CONFIG_GLOBAL_SCALE_FACTOR_KEY, 1.0f ); @@ -78,6 +80,7 @@ void ScaleProcess::SetupProperties( const Importer* pImp ) { mScale *= importerScale; } +// ------------------------------------------------------------------------------------------------ void ScaleProcess::Execute( aiScene* pScene ) { if(mScale == 1.0f) { return; // nothing to scale @@ -96,37 +99,30 @@ void ScaleProcess::Execute( aiScene* pScene ) { } // Process animations and update position transform to new unit system - for( unsigned int animationID = 0; animationID < pScene->mNumAnimations; animationID++ ) - { + for( unsigned int animationID = 0; animationID < pScene->mNumAnimations; animationID++ ) { aiAnimation* animation = pScene->mAnimations[animationID]; - for( unsigned int animationChannel = 0; animationChannel < animation->mNumChannels; animationChannel++) - { + for( unsigned int animationChannel = 0; animationChannel < animation->mNumChannels; animationChannel++) { aiNodeAnim* anim = animation->mChannels[animationChannel]; - for( unsigned int posKey = 0; posKey < anim->mNumPositionKeys; posKey++) - { + for( unsigned int posKey = 0; posKey < anim->mNumPositionKeys; posKey++) { aiVectorKey& vectorKey = anim->mPositionKeys[posKey]; vectorKey.mValue *= mScale; } } } - for( unsigned int meshID = 0; meshID < pScene->mNumMeshes; meshID++) - { + for( unsigned int meshID = 0; meshID < pScene->mNumMeshes; meshID++) { aiMesh *mesh = pScene->mMeshes[meshID]; // Reconstruct mesh vertices to the new unit system - for( unsigned int vertexID = 0; vertexID < mesh->mNumVertices; vertexID++) - { + for( unsigned int vertexID = 0; vertexID < mesh->mNumVertices; vertexID++) { aiVector3D& vertex = mesh->mVertices[vertexID]; vertex *= mScale; } - // bone placement / scaling - for( unsigned int boneID = 0; boneID < mesh->mNumBones; boneID++) - { + for( unsigned int boneID = 0; boneID < mesh->mNumBones; boneID++) { // Reconstruct matrix by transform rather than by scale // This prevent scale values being changed which can // be meaningful in some cases @@ -152,12 +148,10 @@ void ScaleProcess::Execute( aiScene* pScene ) { // animation mesh processing // convert by position rather than scale. - for( unsigned int animMeshID = 0; animMeshID < mesh->mNumAnimMeshes; animMeshID++) - { + for( unsigned int animMeshID = 0; animMeshID < mesh->mNumAnimMeshes; animMeshID++) { aiAnimMesh * animMesh = mesh->mAnimMeshes[animMeshID]; - for( unsigned int vertexID = 0; vertexID < animMesh->mNumVertices; vertexID++) - { + for( unsigned int vertexID = 0; vertexID < animMesh->mNumVertices; vertexID++) { aiVector3D& vertex = animMesh->mVertices[vertexID]; vertex *= mScale; } @@ -167,16 +161,17 @@ void ScaleProcess::Execute( aiScene* pScene ) { traverseNodes( pScene->mRootNode ); } +// ------------------------------------------------------------------------------------------------ void ScaleProcess::traverseNodes( aiNode *node, unsigned int nested_node_id ) { applyScaling( node ); - for( size_t i = 0; i < node->mNumChildren; i++) - { + for( size_t i = 0; i < node->mNumChildren; i++) { // recurse into the tree until we are done! traverseNodes( node->mChildren[i], nested_node_id+1 ); } } +// ------------------------------------------------------------------------------------------------ void ScaleProcess::applyScaling( aiNode *currentNode ) { if ( nullptr != currentNode ) { // Reconstruct matrix by transform rather than by scale diff --git a/code/PostProcessing/ScaleProcess.h b/code/PostProcessing/ScaleProcess.h index b6eb75de7..4d706bfc3 100644 --- a/code/PostProcessing/ScaleProcess.h +++ b/code/PostProcessing/ScaleProcess.h @@ -62,11 +62,10 @@ namespace Assimp { */ class ASSIMP_API ScaleProcess : public BaseProcess { public: - /// The default class constructor. + // ------------------------------------------------------------------- + /// The default class constructor / destructor. ScaleProcess(); - - /// The class destructor. - virtual ~ScaleProcess(); + ~ScaleProcess() override = default; /// Will set the scale manually. void setScale( ai_real scale ); diff --git a/code/PostProcessing/SortByPTypeProcess.cpp b/code/PostProcessing/SortByPTypeProcess.cpp index 6312fa173..1be75fc48 100644 --- a/code/PostProcessing/SortByPTypeProcess.cpp +++ b/code/PostProcessing/SortByPTypeProcess.cpp @@ -59,10 +59,6 @@ SortByPTypeProcess::SortByPTypeProcess() : // empty } -// ------------------------------------------------------------------------------------------------ -// Destructor, private as well -SortByPTypeProcess::~SortByPTypeProcess() = default; - // ------------------------------------------------------------------------------------------------ // Returns whether the processing step is present in the given flag field. bool SortByPTypeProcess::IsActive(unsigned int pFlags) const { diff --git a/code/PostProcessing/SortByPTypeProcess.h b/code/PostProcessing/SortByPTypeProcess.h index e30342a86..c004e0549 100644 --- a/code/PostProcessing/SortByPTypeProcess.h +++ b/code/PostProcessing/SortByPTypeProcess.h @@ -60,8 +60,10 @@ namespace Assimp { */ class ASSIMP_API SortByPTypeProcess : public BaseProcess { public: + // ------------------------------------------------------------------- + /// The default class constructor / destructor. SortByPTypeProcess(); - ~SortByPTypeProcess(); + ~SortByPTypeProcess() override = default; // ------------------------------------------------------------------- bool IsActive( unsigned int pFlags) const; diff --git a/code/PostProcessing/SplitByBoneCountProcess.cpp b/code/PostProcessing/SplitByBoneCountProcess.cpp index a501d3bd6..5324160d4 100644 --- a/code/PostProcessing/SplitByBoneCountProcess.cpp +++ b/code/PostProcessing/SplitByBoneCountProcess.cpp @@ -40,7 +40,6 @@ OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. ---------------------------------------------------------------------- */ - /// @file SplitByBoneCountProcess.cpp /// Implementation of the SplitByBoneCount postprocessing step @@ -59,47 +58,36 @@ using namespace Assimp::Formatter; // ------------------------------------------------------------------------------------------------ // Constructor -SplitByBoneCountProcess::SplitByBoneCountProcess() -{ - // set default, might be overridden by importer config - mMaxBoneCount = AI_SBBC_DEFAULT_MAX_BONES; +SplitByBoneCountProcess::SplitByBoneCountProcess() : mMaxBoneCount(AI_SBBC_DEFAULT_MAX_BONES) { + // empty } -// ------------------------------------------------------------------------------------------------ -// Destructor -SplitByBoneCountProcess::~SplitByBoneCountProcess() = default; - // ------------------------------------------------------------------------------------------------ // Returns whether the processing step is present in the given flag. -bool SplitByBoneCountProcess::IsActive( unsigned int pFlags) const -{ +bool SplitByBoneCountProcess::IsActive( unsigned int pFlags) const { return !!(pFlags & aiProcess_SplitByBoneCount); } // ------------------------------------------------------------------------------------------------ // Updates internal properties -void SplitByBoneCountProcess::SetupProperties(const Importer* pImp) -{ +void SplitByBoneCountProcess::SetupProperties(const Importer* pImp) { mMaxBoneCount = pImp->GetPropertyInteger(AI_CONFIG_PP_SBBC_MAX_BONES,AI_SBBC_DEFAULT_MAX_BONES); } // ------------------------------------------------------------------------------------------------ // Executes the post processing step on the given imported data. -void SplitByBoneCountProcess::Execute( aiScene* pScene) -{ +void SplitByBoneCountProcess::Execute( aiScene* pScene) { ASSIMP_LOG_DEBUG("SplitByBoneCountProcess begin"); // early out bool isNecessary = false; for( unsigned int a = 0; a < pScene->mNumMeshes; ++a) - if( pScene->mMeshes[a]->mNumBones > mMaxBoneCount ) - { + if( pScene->mMeshes[a]->mNumBones > mMaxBoneCount ) { isNecessary = true; break; } - if( !isNecessary ) - { + if( !isNecessary ) { ASSIMP_LOG_DEBUG("SplitByBoneCountProcess early-out: no meshes with more than ", mMaxBoneCount, " bones." ); return; } @@ -111,28 +99,23 @@ void SplitByBoneCountProcess::Execute( aiScene* pScene) // build a new array of meshes for the scene std::vector meshes; - for( unsigned int a = 0; a < pScene->mNumMeshes; ++a) - { + for( unsigned int a = 0; a < pScene->mNumMeshes; ++a) { aiMesh* srcMesh = pScene->mMeshes[a]; std::vector newMeshes; SplitMesh( pScene->mMeshes[a], newMeshes); // mesh was split - if( !newMeshes.empty() ) - { + if( !newMeshes.empty() ) { // store new meshes and indices of the new meshes - for( unsigned int b = 0; b < newMeshes.size(); ++b) - { + for( unsigned int b = 0; b < newMeshes.size(); ++b) { mSubMeshIndices[a].push_back( static_cast(meshes.size())); meshes.push_back( newMeshes[b]); } // and destroy the source mesh. It should be completely contained inside the new submeshes delete srcMesh; - } - else - { + } else { // Mesh is kept unchanged - store it's new place in the mesh array mSubMeshIndices[a].push_back( static_cast(meshes.size())); meshes.push_back( srcMesh); @@ -153,11 +136,9 @@ void SplitByBoneCountProcess::Execute( aiScene* pScene) // ------------------------------------------------------------------------------------------------ // Splits the given mesh by bone count. -void SplitByBoneCountProcess::SplitMesh( const aiMesh* pMesh, std::vector& poNewMeshes) const -{ +void SplitByBoneCountProcess::SplitMesh( const aiMesh* pMesh, std::vector& poNewMeshes) const { // skip if not necessary - if( pMesh->mNumBones <= mMaxBoneCount ) - { + if( pMesh->mNumBones <= mMaxBoneCount ) { return; } @@ -165,27 +146,22 @@ void SplitByBoneCountProcess::SplitMesh( const aiMesh* pMesh, std::vector BoneWeight; std::vector< std::vector > vertexBones( pMesh->mNumVertices); - for( unsigned int a = 0; a < pMesh->mNumBones; ++a) - { + for( unsigned int a = 0; a < pMesh->mNumBones; ++a) { const aiBone* bone = pMesh->mBones[a]; - for( unsigned int b = 0; b < bone->mNumWeights; ++b) - { - if (bone->mWeights[b].mWeight > 0.0f) - { - int vertexId = bone->mWeights[b].mVertexId; - vertexBones[vertexId].emplace_back(a, bone->mWeights[b].mWeight); - if (vertexBones[vertexId].size() > mMaxBoneCount) - { - throw DeadlyImportError("SplitByBoneCountProcess: Single face requires more bones than specified max bone count!"); + for( unsigned int b = 0; b < bone->mNumWeights; ++b) { + if (bone->mWeights[b].mWeight > 0.0f) { + int vertexId = bone->mWeights[b].mVertexId; + vertexBones[vertexId].emplace_back(a, bone->mWeights[b].mWeight); + if (vertexBones[vertexId].size() > mMaxBoneCount) { + throw DeadlyImportError("SplitByBoneCountProcess: Single face requires more bones than specified max bone count!"); + } } - } } } unsigned int numFacesHandled = 0; std::vector isFaceHandled( pMesh->mNumFaces, false); - while( numFacesHandled < pMesh->mNumFaces ) - { + while( numFacesHandled < pMesh->mNumFaces ) { // which bones are used in the current submesh unsigned int numBones = 0; std::vector isBoneUsed( pMesh->mNumBones, false); @@ -196,11 +172,9 @@ void SplitByBoneCountProcess::SplitMesh( const aiMesh* pMesh, std::vectormNumFaces; ++a) - { + for( unsigned int a = 0; a < pMesh->mNumFaces; ++a) { // skip if the face is already stored in a submesh - if( isFaceHandled[a] ) - { + if( isFaceHandled[a] ) { continue; } // a small local set of new bones for the current face. State of all used bones for that face @@ -209,33 +183,27 @@ void SplitByBoneCountProcess::SplitMesh( const aiMesh* pMesh, std::vectormFaces[a]; // check every vertex if its bones would still fit into the current submesh - for( unsigned int b = 0; b < face.mNumIndices; ++b ) - { - const std::vector& vb = vertexBones[face.mIndices[b]]; - for( unsigned int c = 0; c < vb.size(); ++c) - { - unsigned int boneIndex = vb[c].first; - if( !isBoneUsed[boneIndex] ) - { - newBonesAtCurrentFace.insert(boneIndex); + for( unsigned int b = 0; b < face.mNumIndices; ++b ) { + const std::vector& vb = vertexBones[face.mIndices[b]]; + for( unsigned int c = 0; c < vb.size(); ++c) { + unsigned int boneIndex = vb[c].first; + if( !isBoneUsed[boneIndex] ) { + newBonesAtCurrentFace.insert(boneIndex); + } } - } } // leave out the face if the new bones required for this face don't fit the bone count limit anymore - if( numBones + newBonesAtCurrentFace.size() > mMaxBoneCount ) - { + if( numBones + newBonesAtCurrentFace.size() > mMaxBoneCount ) { continue; } // mark all new bones as necessary - for (std::set::iterator it = newBonesAtCurrentFace.begin(); it != newBonesAtCurrentFace.end(); ++it) - { - if (!isBoneUsed[*it]) - { - isBoneUsed[*it] = true; - numBones++; - } + for (std::set::iterator it = newBonesAtCurrentFace.begin(); it != newBonesAtCurrentFace.end(); ++it) { + if (!isBoneUsed[*it]) { + isBoneUsed[*it] = true; + numBones++; + } } // store the face index and the vertex count @@ -261,27 +229,21 @@ void SplitByBoneCountProcess::SplitMesh( const aiMesh* pMesh, std::vectormNumVertices = numSubMeshVertices; newMesh->mNumFaces = static_cast(subMeshFaces.size()); newMesh->mVertices = new aiVector3D[newMesh->mNumVertices]; - if( pMesh->HasNormals() ) - { + if( pMesh->HasNormals() ) { newMesh->mNormals = new aiVector3D[newMesh->mNumVertices]; } - if( pMesh->HasTangentsAndBitangents() ) - { + if( pMesh->HasTangentsAndBitangents() ) { newMesh->mTangents = new aiVector3D[newMesh->mNumVertices]; newMesh->mBitangents = new aiVector3D[newMesh->mNumVertices]; } - for( unsigned int a = 0; a < AI_MAX_NUMBER_OF_TEXTURECOORDS; ++a ) - { - if( pMesh->HasTextureCoords( a) ) - { + for( unsigned int a = 0; a < AI_MAX_NUMBER_OF_TEXTURECOORDS; ++a ) { + if( pMesh->HasTextureCoords( a) ) { newMesh->mTextureCoords[a] = new aiVector3D[newMesh->mNumVertices]; } newMesh->mNumUVComponents[a] = pMesh->mNumUVComponents[a]; } - for( unsigned int a = 0; a < AI_MAX_NUMBER_OF_COLOR_SETS; ++a ) - { - if( pMesh->HasVertexColors( a) ) - { + for( unsigned int a = 0; a < AI_MAX_NUMBER_OF_COLOR_SETS; ++a ) { + if( pMesh->HasVertexColors( a) ) { newMesh->mColors[a] = new aiColor4D[newMesh->mNumVertices]; } } @@ -290,41 +252,33 @@ void SplitByBoneCountProcess::SplitMesh( const aiMesh* pMesh, std::vectormFaces = new aiFace[subMeshFaces.size()]; unsigned int nvi = 0; // next vertex index std::vector previousVertexIndices( numSubMeshVertices, std::numeric_limits::max()); // per new vertex: its index in the source mesh - for( unsigned int a = 0; a < subMeshFaces.size(); ++a ) - { + for( unsigned int a = 0; a < subMeshFaces.size(); ++a ) { const aiFace& srcFace = pMesh->mFaces[subMeshFaces[a]]; aiFace& dstFace = newMesh->mFaces[a]; dstFace.mNumIndices = srcFace.mNumIndices; dstFace.mIndices = new unsigned int[dstFace.mNumIndices]; // accumulate linearly all the vertices of the source face - for( unsigned int b = 0; b < dstFace.mNumIndices; ++b ) - { + for( unsigned int b = 0; b < dstFace.mNumIndices; ++b ) { unsigned int srcIndex = srcFace.mIndices[b]; dstFace.mIndices[b] = nvi; previousVertexIndices[nvi] = srcIndex; newMesh->mVertices[nvi] = pMesh->mVertices[srcIndex]; - if( pMesh->HasNormals() ) - { + if( pMesh->HasNormals() ) { newMesh->mNormals[nvi] = pMesh->mNormals[srcIndex]; } - if( pMesh->HasTangentsAndBitangents() ) - { + if( pMesh->HasTangentsAndBitangents() ) { newMesh->mTangents[nvi] = pMesh->mTangents[srcIndex]; newMesh->mBitangents[nvi] = pMesh->mBitangents[srcIndex]; } - for( unsigned int c = 0; c < AI_MAX_NUMBER_OF_TEXTURECOORDS; ++c ) - { - if( pMesh->HasTextureCoords( c) ) - { + for( unsigned int c = 0; c < AI_MAX_NUMBER_OF_TEXTURECOORDS; ++c ) { + if( pMesh->HasTextureCoords( c) ) { newMesh->mTextureCoords[c][nvi] = pMesh->mTextureCoords[c][srcIndex]; } } - for( unsigned int c = 0; c < AI_MAX_NUMBER_OF_COLOR_SETS; ++c ) - { - if( pMesh->HasVertexColors( c) ) - { + for( unsigned int c = 0; c < AI_MAX_NUMBER_OF_COLOR_SETS; ++c ) { + if( pMesh->HasVertexColors( c) ) { newMesh->mColors[c][nvi] = pMesh->mColors[c][srcIndex]; } } @@ -340,10 +294,8 @@ void SplitByBoneCountProcess::SplitMesh( const aiMesh* pMesh, std::vectormBones = new aiBone*[numBones]; std::vector mappedBoneIndex( pMesh->mNumBones, std::numeric_limits::max()); - for( unsigned int a = 0; a < pMesh->mNumBones; ++a ) - { - if( !isBoneUsed[a] ) - { + for( unsigned int a = 0; a < pMesh->mNumBones; ++a ) { + if( !isBoneUsed[a] ) { continue; } @@ -360,24 +312,20 @@ void SplitByBoneCountProcess::SplitMesh( const aiMesh* pMesh, std::vectormNumBones == numBones ); // iterate over all new vertices and count which bones affected its old vertex in the source mesh - for( unsigned int a = 0; a < numSubMeshVertices; ++a ) - { + for( unsigned int a = 0; a < numSubMeshVertices; ++a ) { unsigned int oldIndex = previousVertexIndices[a]; const std::vector& bonesOnThisVertex = vertexBones[oldIndex]; - for( unsigned int b = 0; b < bonesOnThisVertex.size(); ++b ) - { + for( unsigned int b = 0; b < bonesOnThisVertex.size(); ++b ) { unsigned int newBoneIndex = mappedBoneIndex[ bonesOnThisVertex[b].first ]; - if( newBoneIndex != std::numeric_limits::max() ) - { + if( newBoneIndex != std::numeric_limits::max() ) { newMesh->mBones[newBoneIndex]->mNumWeights++; } } } // allocate all bone weight arrays accordingly - for( unsigned int a = 0; a < newMesh->mNumBones; ++a ) - { + for( unsigned int a = 0; a < newMesh->mNumBones; ++a ) { aiBone* bone = newMesh->mBones[a]; ai_assert( bone->mNumWeights > 0 ); bone->mWeights = new aiVertexWeight[bone->mNumWeights]; @@ -385,16 +333,14 @@ void SplitByBoneCountProcess::SplitMesh( const aiMesh* pMesh, std::vector& bonesOnThisVertex = vertexBones[previousIndex]; // all of the bones affecting it should be present in the new submesh, or else // the face it comprises shouldn't be present - for( unsigned int b = 0; b < bonesOnThisVertex.size(); ++b) - { + for( unsigned int b = 0; b < bonesOnThisVertex.size(); ++b) { unsigned int newBoneIndex = mappedBoneIndex[ bonesOnThisVertex[b].first ]; ai_assert( newBoneIndex != std::numeric_limits::max() ); aiVertexWeight* dstWeight = newMesh->mBones[newBoneIndex]->mWeights + newMesh->mBones[newBoneIndex]->mNumWeights; @@ -450,14 +396,11 @@ void SplitByBoneCountProcess::SplitMesh( const aiMesh* pMesh, std::vectormNumMeshes > 0 ) - { + if( pNode->mNumMeshes == 0 ) { std::vector newMeshList; - for( unsigned int a = 0; a < pNode->mNumMeshes; ++a) - { + for( unsigned int a = 0; a < pNode->mNumMeshes; ++a) { unsigned int srcIndex = pNode->mMeshes[a]; const std::vector& replaceMeshes = mSubMeshIndices[srcIndex]; newMeshList.insert( newMeshList.end(), replaceMeshes.begin(), replaceMeshes.end()); @@ -470,8 +413,7 @@ void SplitByBoneCountProcess::UpdateNode( aiNode* pNode) const } // do that also recursively for all children - for( unsigned int a = 0; a < pNode->mNumChildren; ++a ) - { + for( unsigned int a = 0; a < pNode->mNumChildren; ++a ) { UpdateNode( pNode->mChildren[a]); } } diff --git a/code/PostProcessing/SplitByBoneCountProcess.h b/code/PostProcessing/SplitByBoneCountProcess.h index 938b00c7f..e2377a995 100644 --- a/code/PostProcessing/SplitByBoneCountProcess.h +++ b/code/PostProcessing/SplitByBoneCountProcess.h @@ -51,9 +51,7 @@ OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. #include #include -namespace Assimp -{ - +namespace Assimp { /** Postprocessing filter to split meshes with many bones into submeshes * so that each submesh has a certain max bone count. @@ -61,33 +59,28 @@ namespace Assimp * Applied BEFORE the JoinVertices-Step occurs. * Returns NON-UNIQUE vertices, splits by bone count. */ -class SplitByBoneCountProcess : public BaseProcess -{ +class SplitByBoneCountProcess : public BaseProcess { public: - + // ------------------------------------------------------------------- + /// The default class constructor / destructor. SplitByBoneCountProcess(); - ~SplitByBoneCountProcess(); + ~SplitByBoneCountProcess() override = default; -public: - /** Returns whether the processing step is present in the given flag. - * @param pFlags The processing flags the importer was called with. A - * bitwise combination of #aiPostProcessSteps. - * @return true if the process is present in this flag fields, - * false if not. - */ + /// @brief Returns whether the processing step is present in the given flag. + /// @param pFlags The processing flags the importer was called with. A + /// bitwise combination of #aiPostProcessSteps. + /// @return true if the process is present in this flag fields, false if not. bool IsActive( unsigned int pFlags) const; - /** Called prior to ExecuteOnScene(). - * The function is a request to the process to update its configuration - * basing on the Importer's configuration property list. - */ + /// @brief Called prior to ExecuteOnScene(). + /// The function is a request to the process to update its configuration + /// basing on the Importer's configuration property list. virtual void SetupProperties(const Importer* pImp); protected: - /** Executes the post processing step on the given imported data. - * At the moment a process is not supposed to fail. - * @param pScene The imported data to work at. - */ + /// Executes the post processing step on the given imported data. + /// At the moment a process is not supposed to fail. + /// @param pScene The imported data to work at. void Execute( aiScene* pScene); /// Splits the given mesh by bone count. diff --git a/code/PostProcessing/SplitLargeMeshes.cpp b/code/PostProcessing/SplitLargeMeshes.cpp index 151ac4991..73e0cc5d8 100644 --- a/code/PostProcessing/SplitLargeMeshes.cpp +++ b/code/PostProcessing/SplitLargeMeshes.cpp @@ -55,9 +55,6 @@ SplitLargeMeshesProcess_Triangle::SplitLargeMeshesProcess_Triangle() { LIMIT = AI_SLM_DEFAULT_MAX_TRIANGLES; } -// ------------------------------------------------------------------------------------------------ -SplitLargeMeshesProcess_Triangle::~SplitLargeMeshesProcess_Triangle() = default; - // ------------------------------------------------------------------------------------------------ // Returns whether the processing step is present in the given flag field. bool SplitLargeMeshesProcess_Triangle::IsActive( unsigned int pFlags) const { @@ -329,9 +326,6 @@ SplitLargeMeshesProcess_Vertex::SplitLargeMeshesProcess_Vertex() { LIMIT = AI_SLM_DEFAULT_MAX_VERTICES; } -// ------------------------------------------------------------------------------------------------ -SplitLargeMeshesProcess_Vertex::~SplitLargeMeshesProcess_Vertex() = default; - // ------------------------------------------------------------------------------------------------ // Returns whether the processing step is present in the given flag field. bool SplitLargeMeshesProcess_Vertex::IsActive( unsigned int pFlags) const { diff --git a/code/PostProcessing/SplitLargeMeshes.h b/code/PostProcessing/SplitLargeMeshes.h index e5a8d4c1b..605f0477d 100644 --- a/code/PostProcessing/SplitLargeMeshes.h +++ b/code/PostProcessing/SplitLargeMeshes.h @@ -83,16 +83,15 @@ class SplitLargeMeshesProcess_Vertex; * Applied BEFORE the JoinVertices-Step occurs. * Returns NON-UNIQUE vertices, splits by triangle number. */ -class ASSIMP_API SplitLargeMeshesProcess_Triangle : public BaseProcess -{ +class ASSIMP_API SplitLargeMeshesProcess_Triangle : public BaseProcess { friend class SplitLargeMeshesProcess_Vertex; public: - + // ------------------------------------------------------------------- + /// The default class constructor / destructor. SplitLargeMeshesProcess_Triangle(); - ~SplitLargeMeshesProcess_Triangle(); + ~SplitLargeMeshesProcess_Triangle() override = default; -public: // ------------------------------------------------------------------- /** Returns whether the processing step is present in the given flag. * @param pFlags The processing flags the importer was called with. A @@ -102,14 +101,12 @@ public: */ bool IsActive( unsigned int pFlags) const; - // ------------------------------------------------------------------- /** Called prior to ExecuteOnScene(). * The function is a request to the process to update its configuration * basing on the Importer's configuration property list. */ - virtual void SetupProperties(const Importer* pImp); - + void SetupProperties(const Importer* pImp) override; //! Set the split limit - needed for unit testing inline void SetLimit(unsigned int l) @@ -119,8 +116,6 @@ public: inline unsigned int GetLimit() const {return LIMIT;} -public: - // ------------------------------------------------------------------- /** Executes the post processing step on the given imported data. * At the moment a process is not supposed to fail. @@ -144,21 +139,17 @@ public: unsigned int LIMIT; }; - // --------------------------------------------------------------------------- /** Post-processing filter to split large meshes into sub-meshes * * Applied AFTER the JoinVertices-Step occurs. * Returns UNIQUE vertices, splits by vertex number. */ -class ASSIMP_API SplitLargeMeshesProcess_Vertex : public BaseProcess -{ +class ASSIMP_API SplitLargeMeshesProcess_Vertex : public BaseProcess { public: - SplitLargeMeshesProcess_Vertex(); - ~SplitLargeMeshesProcess_Vertex(); + ~SplitLargeMeshesProcess_Vertex() override = default; -public: // ------------------------------------------------------------------- /** Returns whether the processing step is present in the given flag field. * @param pFlags The processing flags the importer was called with. A bitwise diff --git a/code/PostProcessing/TextureTransform.cpp b/code/PostProcessing/TextureTransform.cpp index efbf4d2c6..2ed17f390 100644 --- a/code/PostProcessing/TextureTransform.cpp +++ b/code/PostProcessing/TextureTransform.cpp @@ -56,33 +56,24 @@ using namespace Assimp; // ------------------------------------------------------------------------------------------------ // Constructor to be privately used by Importer -TextureTransformStep::TextureTransformStep() : - configFlags() -{ +TextureTransformStep::TextureTransformStep() : configFlags() { // nothing to do here } -// ------------------------------------------------------------------------------------------------ -// Destructor, private as well -TextureTransformStep::~TextureTransformStep() = default; - // ------------------------------------------------------------------------------------------------ // Returns whether the processing step is present in the given flag field. -bool TextureTransformStep::IsActive( unsigned int pFlags) const -{ +bool TextureTransformStep::IsActive( unsigned int pFlags) const { return (pFlags & aiProcess_TransformUVCoords) != 0; } // ------------------------------------------------------------------------------------------------ // Setup properties -void TextureTransformStep::SetupProperties(const Importer* pImp) -{ +void TextureTransformStep::SetupProperties(const Importer* pImp) { configFlags = pImp->GetPropertyInteger(AI_CONFIG_PP_TUV_EVALUATE,AI_UVTRAFO_ALL); } // ------------------------------------------------------------------------------------------------ -void TextureTransformStep::PreProcessUVTransform(STransformVecInfo& info) -{ +void TextureTransformStep::PreProcessUVTransform(STransformVecInfo& info) { /* This function tries to simplify the input UV transformation. * That's very important as it allows us to reduce the number * of output UV channels. The order in which the transformations @@ -90,7 +81,7 @@ void TextureTransformStep::PreProcessUVTransform(STransformVecInfo& info) */ int rounded; - char szTemp[512]; + char szTemp[512] = {}; /* Optimize the rotation angle. That's slightly difficult as * we have an inprecise floating-point number (when comparing @@ -98,12 +89,10 @@ void TextureTransformStep::PreProcessUVTransform(STransformVecInfo& info) * an epsilon of 5 degrees). If there is a rotation value, we can't * perform any further optimizations. */ - if (info.mRotation) - { + if (info.mRotation) { float out = info.mRotation; rounded = static_cast((info.mRotation / static_cast(AI_MATH_TWO_PI))); - if (rounded) - { + if (rounded) { out -= rounded * static_cast(AI_MATH_PI); ASSIMP_LOG_INFO("Texture coordinate rotation ", info.mRotation, " can be simplified to ", out); } @@ -187,8 +176,7 @@ void TextureTransformStep::PreProcessUVTransform(STransformVecInfo& info) } // ------------------------------------------------------------------------------------------------ -void UpdateUVIndex(const std::list& l, unsigned int n) -{ +void UpdateUVIndex(const std::list& l, unsigned int n) { // Don't set if == 0 && wasn't set before for (std::list::const_iterator it = l.begin();it != l.end(); ++it) { const TTUpdateInfo& info = *it; @@ -203,8 +191,7 @@ void UpdateUVIndex(const std::list& l, unsigned int n) } // ------------------------------------------------------------------------------------------------ -inline const char* MappingModeToChar(aiTextureMapMode map) -{ +inline static const char* MappingModeToChar(aiTextureMapMode map) { if (aiTextureMapMode_Wrap == map) return "-w"; @@ -215,8 +202,7 @@ inline const char* MappingModeToChar(aiTextureMapMode map) } // ------------------------------------------------------------------------------------------------ -void TextureTransformStep::Execute( aiScene* pScene) -{ +void TextureTransformStep::Execute( aiScene* pScene) { ASSIMP_LOG_DEBUG("TransformUVCoordsProcess begin"); diff --git a/code/PostProcessing/TextureTransform.h b/code/PostProcessing/TextureTransform.h index c1cccf8ef..873789f3e 100644 --- a/code/PostProcessing/TextureTransform.h +++ b/code/PostProcessing/TextureTransform.h @@ -193,14 +193,12 @@ struct STransformVecInfo : public aiUVTransform { /** Helper step to compute final UV coordinate sets if there are scalings * or rotations in the original data read from the file. */ -class TextureTransformStep : public BaseProcess -{ +class TextureTransformStep : public BaseProcess { public: - + // ------------------------------------------------------------------- + /// The default class constructor / destructor. TextureTransformStep(); - ~TextureTransformStep(); - -public: + ~TextureTransformStep() override = default; // ------------------------------------------------------------------- bool IsActive( unsigned int pFlags) const; @@ -213,8 +211,6 @@ public: protected: - - // ------------------------------------------------------------------- /** Preprocess a specific UV transformation setup * @@ -223,10 +219,9 @@ protected: void PreProcessUVTransform(STransformVecInfo& info); private: - unsigned int configFlags; }; - -} + +} // namespace Assimp #endif //! AI_TEXTURE_TRANSFORM_H_INCLUDED diff --git a/code/PostProcessing/TriangulateProcess.cpp b/code/PostProcessing/TriangulateProcess.cpp index 8ba6456b7..52cfa66bf 100644 --- a/code/PostProcessing/TriangulateProcess.cpp +++ b/code/PostProcessing/TriangulateProcess.cpp @@ -156,15 +156,6 @@ namespace { } - -// ------------------------------------------------------------------------------------------------ -// Constructor to be privately used by Importer -TriangulateProcess::TriangulateProcess() = default; - -// ------------------------------------------------------------------------------------------------ -// Destructor, private as well -TriangulateProcess::~TriangulateProcess() = default; - // ------------------------------------------------------------------------------------------------ // Returns whether the processing step is present in the given flag field. bool TriangulateProcess::IsActive( unsigned int pFlags) const diff --git a/code/PostProcessing/TriangulateProcess.h b/code/PostProcessing/TriangulateProcess.h index ed5f4a587..fefeac61c 100644 --- a/code/PostProcessing/TriangulateProcess.h +++ b/code/PostProcessing/TriangulateProcess.h @@ -61,8 +61,10 @@ namespace Assimp { */ class ASSIMP_API TriangulateProcess : public BaseProcess { public: - TriangulateProcess(); - ~TriangulateProcess(); + // ------------------------------------------------------------------- + /// The default class constructor / destructor. + TriangulateProcess() = default; + ~TriangulateProcess() override = default; // ------------------------------------------------------------------- /** Returns whether the processing step is present in the given flag field. diff --git a/code/PostProcessing/ValidateDataStructure.cpp b/code/PostProcessing/ValidateDataStructure.cpp index d234e220b..cae35b895 100644 --- a/code/PostProcessing/ValidateDataStructure.cpp +++ b/code/PostProcessing/ValidateDataStructure.cpp @@ -60,12 +60,7 @@ using namespace Assimp; // ------------------------------------------------------------------------------------------------ // Constructor to be privately used by Importer -ValidateDSProcess::ValidateDSProcess() : - mScene() {} - -// ------------------------------------------------------------------------------------------------ -// Destructor, private as well -ValidateDSProcess::~ValidateDSProcess() = default; +ValidateDSProcess::ValidateDSProcess() : mScene(nullptr) {} // ------------------------------------------------------------------------------------------------ // Returns whether the processing step is present in the given flag field. diff --git a/code/PostProcessing/ValidateDataStructure.h b/code/PostProcessing/ValidateDataStructure.h index 077a47b70..87c88669f 100644 --- a/code/PostProcessing/ValidateDataStructure.h +++ b/code/PostProcessing/ValidateDataStructure.h @@ -72,11 +72,11 @@ namespace Assimp { class ValidateDSProcess : public BaseProcess { public: - + // ------------------------------------------------------------------- + /// The default class constructor / destructor. ValidateDSProcess(); - ~ValidateDSProcess(); + ~ValidateDSProcess() override = default; -public: // ------------------------------------------------------------------- bool IsActive( unsigned int pFlags) const; From 31ae9cde1ca1bd1df71c38fd39c2dab6a4ecba1a Mon Sep 17 00:00:00 2001 From: Kim Kulling Date: Tue, 14 Mar 2023 23:32:03 +0100 Subject: [PATCH 40/61] Refactoring: Code cleanup post-processing. --- code/PostProcessing/CalcTangentsProcess.cpp | 4 --- code/PostProcessing/CalcTangentsProcess.h | 15 ++++------- .../ComputeUVMappingProcess.cpp | 8 ------ code/PostProcessing/ComputeUVMappingProcess.h | 19 +++++-------- code/PostProcessing/ConvertToLHProcess.cpp | 16 ----------- code/PostProcessing/ConvertToLHProcess.h | 27 +++++++------------ code/PostProcessing/DeboneProcess.h | 4 +-- code/PostProcessing/DropFaceNormalsProcess.h | 5 ++-- code/PostProcessing/EmbedTexturesProcess.h | 6 ++--- code/PostProcessing/FindDegenerates.h | 6 ++--- code/PostProcessing/FindInstancesProcess.h | 15 +++++------ code/PostProcessing/FindInvalidDataProcess.h | 6 ++--- code/PostProcessing/FixNormalsStep.h | 4 +-- code/PostProcessing/GenFaceNormalsProcess.h | 5 ++-- code/PostProcessing/GenVertexNormalsProcess.h | 7 +++-- code/PostProcessing/ImproveCacheLocality.h | 6 ++--- code/PostProcessing/JoinVerticesProcess.h | 4 +-- code/PostProcessing/LimitBoneWeightsProcess.h | 18 ++++++------- code/PostProcessing/MakeVerboseFormat.h | 4 +-- code/PostProcessing/OptimizeMeshes.h | 8 +++--- .../PostProcessing/RemoveRedundantMaterials.h | 6 ++--- code/PostProcessing/RemoveVCProcess.h | 12 ++++----- code/PostProcessing/ScaleProcess.h | 6 ++--- code/PostProcessing/SortByPTypeProcess.h | 6 ++--- code/PostProcessing/SplitByBoneCountProcess.h | 2 +- code/PostProcessing/SplitLargeMeshes.h | 4 +-- code/PostProcessing/TextureTransform.h | 7 +++-- code/PostProcessing/TriangulateProcess.h | 4 +-- code/PostProcessing/ValidateDataStructure.h | 8 +++--- 29 files changed, 93 insertions(+), 149 deletions(-) diff --git a/code/PostProcessing/CalcTangentsProcess.cpp b/code/PostProcessing/CalcTangentsProcess.cpp index efc457766..a23ac856b 100644 --- a/code/PostProcessing/CalcTangentsProcess.cpp +++ b/code/PostProcessing/CalcTangentsProcess.cpp @@ -60,10 +60,6 @@ CalcTangentsProcess::CalcTangentsProcess() : // nothing to do here } -// ------------------------------------------------------------------------------------------------ -// Destructor, private as well -CalcTangentsProcess::~CalcTangentsProcess() = default; - // ------------------------------------------------------------------------------------------------ // Returns whether the processing step is present in the given flag field. bool CalcTangentsProcess::IsActive(unsigned int pFlags) const { diff --git a/code/PostProcessing/CalcTangentsProcess.h b/code/PostProcessing/CalcTangentsProcess.h index 018789bae..94be99cd6 100644 --- a/code/PostProcessing/CalcTangentsProcess.h +++ b/code/PostProcessing/CalcTangentsProcess.h @@ -59,14 +59,11 @@ namespace Assimp * because the joining of vertices also considers tangents and bitangents for * uniqueness. */ -class ASSIMP_API_WINONLY CalcTangentsProcess : public BaseProcess -{ +class ASSIMP_API_WINONLY CalcTangentsProcess : public BaseProcess { public: - CalcTangentsProcess(); - ~CalcTangentsProcess(); + ~CalcTangentsProcess() override = default; -public: // ------------------------------------------------------------------- /** Returns whether the processing step is present in the given flag. * @param pFlags The processing flags the importer was called with. @@ -74,19 +71,17 @@ public: * @return true if the process is present in this flag fields, * false if not. */ - bool IsActive( unsigned int pFlags) const; + bool IsActive( unsigned int pFlags) const override; // ------------------------------------------------------------------- /** Called prior to ExecuteOnScene(). * The function is a request to the process to update its configuration * basing on the Importer's configuration property list. */ - void SetupProperties(const Importer* pImp); - + void SetupProperties(const Importer* pImp) override; // setter for configMaxAngle - inline void SetMaxSmoothAngle(float f) - { + void SetMaxSmoothAngle(float f) { configMaxAngle =f; } diff --git a/code/PostProcessing/ComputeUVMappingProcess.cpp b/code/PostProcessing/ComputeUVMappingProcess.cpp index 237409f02..a5472668b 100644 --- a/code/PostProcessing/ComputeUVMappingProcess.cpp +++ b/code/PostProcessing/ComputeUVMappingProcess.cpp @@ -57,14 +57,6 @@ namespace { const static ai_real angle_epsilon = ai_real( 0.95 ); } -// ------------------------------------------------------------------------------------------------ -// Constructor to be privately used by Importer -ComputeUVMappingProcess::ComputeUVMappingProcess() = default; - -// ------------------------------------------------------------------------------------------------ -// Destructor, private as well -ComputeUVMappingProcess::~ComputeUVMappingProcess() = default; - // ------------------------------------------------------------------------------------------------ // Returns whether the processing step is present in the given flag field. bool ComputeUVMappingProcess::IsActive( unsigned int pFlags) const diff --git a/code/PostProcessing/ComputeUVMappingProcess.h b/code/PostProcessing/ComputeUVMappingProcess.h index 74744be7f..c4158f402 100644 --- a/code/PostProcessing/ComputeUVMappingProcess.h +++ b/code/PostProcessing/ComputeUVMappingProcess.h @@ -59,13 +59,10 @@ namespace Assimp { /** ComputeUVMappingProcess - converts special mappings, such as spherical, * cylindrical or boxed to proper UV coordinates for rendering. */ -class ComputeUVMappingProcess : public BaseProcess -{ -public: - ComputeUVMappingProcess(); - ~ComputeUVMappingProcess(); - +class ComputeUVMappingProcess : public BaseProcess { public: + ComputeUVMappingProcess() = default; + ~ComputeUVMappingProcess() override = default; // ------------------------------------------------------------------- /** Returns whether the processing step is present in the given flag field. @@ -73,14 +70,14 @@ public: * combination of #aiPostProcessSteps. * @return true if the process is present in this flag fields, false if not. */ - bool IsActive( unsigned int pFlags) const; + bool IsActive( unsigned int pFlags) const override; // ------------------------------------------------------------------- /** Executes the post processing step on the given imported data. * At the moment a process is not supposed to fail. * @param pScene The imported data to work at. */ - void Execute( aiScene* pScene); + void Execute( aiScene* pScene) override; protected: @@ -125,8 +122,7 @@ protected: private: // temporary structure to describe a mapping - struct MappingInfo - { + struct MappingInfo { explicit MappingInfo(aiTextureMapping _type) : type (_type) , axis (0.f,1.f,0.f) @@ -137,8 +133,7 @@ private: aiVector3D axis; unsigned int uv; - bool operator== (const MappingInfo& other) - { + bool operator== (const MappingInfo& other) { return type == other.type && axis == other.axis; } }; diff --git a/code/PostProcessing/ConvertToLHProcess.cpp b/code/PostProcessing/ConvertToLHProcess.cpp index 359c5a284..08e3fe48a 100644 --- a/code/PostProcessing/ConvertToLHProcess.cpp +++ b/code/PostProcessing/ConvertToLHProcess.cpp @@ -79,14 +79,6 @@ void flipUVs(aiMeshType *pMesh) { } // namespace -// ------------------------------------------------------------------------------------------------ -// Constructor to be privately used by Importer -MakeLeftHandedProcess::MakeLeftHandedProcess() = default; - -// ------------------------------------------------------------------------------------------------ -// Destructor, private as well -MakeLeftHandedProcess::~MakeLeftHandedProcess() = default; - // ------------------------------------------------------------------------------------------------ // Returns whether the processing step is present in the given flag field. bool MakeLeftHandedProcess::IsActive(unsigned int pFlags) const { @@ -305,14 +297,6 @@ void FlipUVsProcess::ProcessMesh(aiMesh *pMesh) { #ifndef ASSIMP_BUILD_NO_FLIPWINDING_PROCESS // # FlipWindingOrderProcess -// ------------------------------------------------------------------------------------------------ -// Constructor to be privately used by Importer -FlipWindingOrderProcess::FlipWindingOrderProcess() = default; - -// ------------------------------------------------------------------------------------------------ -// Destructor, private as well -FlipWindingOrderProcess::~FlipWindingOrderProcess() = default; - // ------------------------------------------------------------------------------------------------ // Returns whether the processing step is present in the given flag field. bool FlipWindingOrderProcess::IsActive(unsigned int pFlags) const { diff --git a/code/PostProcessing/ConvertToLHProcess.h b/code/PostProcessing/ConvertToLHProcess.h index 474056c3a..d0532277d 100644 --- a/code/PostProcessing/ConvertToLHProcess.h +++ b/code/PostProcessing/ConvertToLHProcess.h @@ -4,7 +4,6 @@ Open Asset Import Library (assimp) Copyright (c) 2006-2022, assimp team - All rights reserved. Redistribution and use of this software in source and binary forms, @@ -72,22 +71,18 @@ namespace Assimp { * * @note RH-LH and LH-RH is the same, so this class can be used for both */ -class MakeLeftHandedProcess : public BaseProcess -{ - - +class MakeLeftHandedProcess : public BaseProcess { public: - MakeLeftHandedProcess(); - ~MakeLeftHandedProcess(); + MakeLeftHandedProcess() = default; + ~MakeLeftHandedProcess() override = default; // ------------------------------------------------------------------- - bool IsActive( unsigned int pFlags) const; + bool IsActive( unsigned int pFlags) const override; // ------------------------------------------------------------------- - void Execute( aiScene* pScene); + void Execute( aiScene* pScene) override; protected: - // ------------------------------------------------------------------- /** Recursively converts a node and all of its children */ @@ -120,24 +115,22 @@ protected: // --------------------------------------------------------------------------- /** Postprocessing step to flip the face order of the imported data */ -class FlipWindingOrderProcess : public BaseProcess -{ +class FlipWindingOrderProcess : public BaseProcess { friend class Importer; public: /** Constructor to be privately used by Importer */ - FlipWindingOrderProcess(); + FlipWindingOrderProcess() = default; /** Destructor, private as well */ - ~FlipWindingOrderProcess(); + ~FlipWindingOrderProcess() override = default; // ------------------------------------------------------------------- - bool IsActive( unsigned int pFlags) const; + bool IsActive( unsigned int pFlags) const override; // ------------------------------------------------------------------- - void Execute( aiScene* pScene); + void Execute( aiScene* pScene) override; -public: /** Some other types of post-processing require winding order flips */ static void ProcessMesh( aiMesh* pMesh); }; diff --git a/code/PostProcessing/DeboneProcess.h b/code/PostProcessing/DeboneProcess.h index 080bc30d1..6e55ce238 100644 --- a/code/PostProcessing/DeboneProcess.h +++ b/code/PostProcessing/DeboneProcess.h @@ -79,14 +79,14 @@ public: * @return true if the process is present in this flag fields, * false if not. */ - bool IsActive( unsigned int pFlags) const; + bool IsActive( unsigned int pFlags) const override; // ------------------------------------------------------------------- /** Called prior to ExecuteOnScene(). * The function is a request to the process to update its configuration * basing on the Importer's configuration property list. */ - void SetupProperties(const Importer* pImp); + void SetupProperties(const Importer* pImp) override; protected: // ------------------------------------------------------------------- diff --git a/code/PostProcessing/DropFaceNormalsProcess.h b/code/PostProcessing/DropFaceNormalsProcess.h index 719c98dc7..df542f2ba 100644 --- a/code/PostProcessing/DropFaceNormalsProcess.h +++ b/code/PostProcessing/DropFaceNormalsProcess.h @@ -64,15 +64,14 @@ public: * combination of #aiPostProcessSteps. * @return true if the process is present in this flag fields, false if not. */ - bool IsActive( unsigned int pFlags) const; + bool IsActive( unsigned int pFlags) const override; // ------------------------------------------------------------------- /** Executes the post processing step on the given imported data. * At the moment a process is not supposed to fail. * @param pScene The imported data to work at. */ - void Execute( aiScene* pScene); - + void Execute( aiScene* pScene) override; private: bool DropMeshFaceNormals(aiMesh* pcMesh); diff --git a/code/PostProcessing/EmbedTexturesProcess.h b/code/PostProcessing/EmbedTexturesProcess.h index e09fa0896..77d4d9c72 100644 --- a/code/PostProcessing/EmbedTexturesProcess.h +++ b/code/PostProcessing/EmbedTexturesProcess.h @@ -68,13 +68,13 @@ public: ~EmbedTexturesProcess() override = default; /// Overwritten, @see BaseProcess - virtual bool IsActive(unsigned int pFlags) const; + bool IsActive(unsigned int pFlags) const override; /// Overwritten, @see BaseProcess - virtual void SetupProperties(const Importer* pImp); + void SetupProperties(const Importer* pImp) override; /// Overwritten, @see BaseProcess - virtual void Execute(aiScene* pScene); + virtual void Execute(aiScene* pScene) override; private: // Resolve the path and add the file content to the scene as a texture. diff --git a/code/PostProcessing/FindDegenerates.h b/code/PostProcessing/FindDegenerates.h index d1eb81615..6b37a47cf 100644 --- a/code/PostProcessing/FindDegenerates.h +++ b/code/PostProcessing/FindDegenerates.h @@ -63,15 +63,15 @@ public: // ------------------------------------------------------------------- // Check whether step is active - bool IsActive( unsigned int pFlags) const; + bool IsActive( unsigned int pFlags) const override; // ------------------------------------------------------------------- // Execute step on a given scene - void Execute( aiScene* pScene); + void Execute( aiScene* pScene) override; // ------------------------------------------------------------------- // Setup import settings - void SetupProperties(const Importer* pImp); + void SetupProperties(const Importer* pImp) override; // ------------------------------------------------------------------- // Execute step on a given mesh diff --git a/code/PostProcessing/FindInstancesProcess.h b/code/PostProcessing/FindInstancesProcess.h index b6c61527a..6927301ca 100644 --- a/code/PostProcessing/FindInstancesProcess.h +++ b/code/PostProcessing/FindInstancesProcess.h @@ -50,7 +50,8 @@ OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. #include "PostProcessing/ProcessHelper.h" class FindInstancesProcessTest; -namespace Assimp { + +namespace Assimp { // ------------------------------------------------------------------------------- /** @brief Get a pseudo(!)-hash representing a mesh. @@ -60,8 +61,7 @@ namespace Assimp { * @param in Input mesh * @return Hash. */ -inline -uint64_t GetMeshHash(aiMesh* in) { +inline uint64_t GetMeshHash(aiMesh* in) { ai_assert(nullptr != in); // ... get an unique value representing the vertex format of the mesh @@ -83,8 +83,7 @@ uint64_t GetMeshHash(aiMesh* in) { * @param e Epsilon * @return true if the arrays are identical */ -inline -bool CompareArrays(const aiVector3D* first, const aiVector3D* second, +inline bool CompareArrays(const aiVector3D* first, const aiVector3D* second, unsigned int size, float e) { for (const aiVector3D* end = first+size; first != end; ++first,++second) { if ( (*first - *second).SquareLength() >= e) @@ -114,15 +113,15 @@ public: // ------------------------------------------------------------------- // Check whether step is active in given flags combination - bool IsActive( unsigned int pFlags) const; + bool IsActive( unsigned int pFlags) const override; // ------------------------------------------------------------------- // Execute step on a given scene - void Execute( aiScene* pScene); + void Execute( aiScene* pScene) override; // ------------------------------------------------------------------- // Setup properties prior to executing the process - void SetupProperties(const Importer* pImp); + void SetupProperties(const Importer* pImp) override; private: bool configSpeedFlag; diff --git a/code/PostProcessing/FindInvalidDataProcess.h b/code/PostProcessing/FindInvalidDataProcess.h index 14746864f..024eb9b1e 100644 --- a/code/PostProcessing/FindInvalidDataProcess.h +++ b/code/PostProcessing/FindInvalidDataProcess.h @@ -71,15 +71,15 @@ public: // ------------------------------------------------------------------- /// Returns active state. - bool IsActive(unsigned int pFlags) const; + bool IsActive(unsigned int pFlags) const override; // ------------------------------------------------------------------- /// Setup import settings - void SetupProperties(const Importer *pImp); + void SetupProperties(const Importer *pImp) override; // ------------------------------------------------------------------- /// Run the step - void Execute(aiScene *pScene); + void Execute(aiScene *pScene) override; // ------------------------------------------------------------------- /// Executes the post-processing step on the given mesh diff --git a/code/PostProcessing/FixNormalsStep.h b/code/PostProcessing/FixNormalsStep.h index e5f5c8a1f..20be1958b 100644 --- a/code/PostProcessing/FixNormalsStep.h +++ b/code/PostProcessing/FixNormalsStep.h @@ -69,14 +69,14 @@ public: * combination of #aiPostProcessSteps. * @return true if the process is present in this flag fields, false if not. */ - bool IsActive( unsigned int pFlags) const; + bool IsActive( unsigned int pFlags) const override; // ------------------------------------------------------------------- /** Executes the post processing step on the given imported data. * At the moment a process is not supposed to fail. * @param pScene The imported data to work at. */ - void Execute( aiScene* pScene); + void Execute( aiScene* pScene) override; protected: diff --git a/code/PostProcessing/GenFaceNormalsProcess.h b/code/PostProcessing/GenFaceNormalsProcess.h index b1babca28..94794631e 100644 --- a/code/PostProcessing/GenFaceNormalsProcess.h +++ b/code/PostProcessing/GenFaceNormalsProcess.h @@ -66,15 +66,14 @@ public: * combination of #aiPostProcessSteps. * @return true if the process is present in this flag fields, false if not. */ - bool IsActive( unsigned int pFlags) const; + bool IsActive( unsigned int pFlags) const override; // ------------------------------------------------------------------- /** Executes the post processing step on the given imported data. * At the moment a process is not supposed to fail. * @param pScene The imported data to work at. */ - void Execute( aiScene* pScene); - + void Execute( aiScene* pScene) override; private: bool GenMeshFaceNormals(aiMesh* pcMesh); diff --git a/code/PostProcessing/GenVertexNormalsProcess.h b/code/PostProcessing/GenVertexNormalsProcess.h index 3999fc3e9..b7db9c4f2 100644 --- a/code/PostProcessing/GenVertexNormalsProcess.h +++ b/code/PostProcessing/GenVertexNormalsProcess.h @@ -72,22 +72,21 @@ public: * @return true if the process is present in this flag fields, * false if not. */ - bool IsActive( unsigned int pFlags) const; + bool IsActive( unsigned int pFlags) const override; // ------------------------------------------------------------------- /** Called prior to ExecuteOnScene(). * The function is a request to the process to update its configuration * basing on the Importer's configuration property list. */ - void SetupProperties(const Importer* pImp); + void SetupProperties(const Importer* pImp) override; // ------------------------------------------------------------------- /** Executes the post processing step on the given imported data. * At the moment a process is not supposed to fail. * @param pScene The imported data to work at. */ - void Execute( aiScene* pScene); - + void Execute( aiScene* pScene) override; // setter for configMaxAngle inline void SetMaxSmoothAngle(ai_real f) { diff --git a/code/PostProcessing/ImproveCacheLocality.h b/code/PostProcessing/ImproveCacheLocality.h index 34a3883da..6f4d55719 100644 --- a/code/PostProcessing/ImproveCacheLocality.h +++ b/code/PostProcessing/ImproveCacheLocality.h @@ -69,15 +69,15 @@ public: // ------------------------------------------------------------------- // Check whether the pp step is active - bool IsActive( unsigned int pFlags) const; + bool IsActive( unsigned int pFlags) const override; // ------------------------------------------------------------------- // Executes the pp step on a given scene - void Execute( aiScene* pScene); + void Execute( aiScene* pScene) override; // ------------------------------------------------------------------- // Configures the pp step - void SetupProperties(const Importer* pImp); + void SetupProperties(const Importer* pImp) override; protected: // ------------------------------------------------------------------- diff --git a/code/PostProcessing/JoinVerticesProcess.h b/code/PostProcessing/JoinVerticesProcess.h index de8cea691..aa8dc5794 100644 --- a/code/PostProcessing/JoinVerticesProcess.h +++ b/code/PostProcessing/JoinVerticesProcess.h @@ -74,14 +74,14 @@ public: * combination of #aiPostProcessSteps. * @return true if the process is present in this flag fields, false if not. */ - bool IsActive( unsigned int pFlags) const; + bool IsActive( unsigned int pFlags) const override; // ------------------------------------------------------------------- /** Executes the post processing step on the given imported data. * At the moment a process is not supposed to fail. * @param pScene The imported data to work at. */ - void Execute( aiScene* pScene); + void Execute( aiScene* pScene) override; // ------------------------------------------------------------------- /** Unites identical vertices in the given mesh. diff --git a/code/PostProcessing/LimitBoneWeightsProcess.h b/code/PostProcessing/LimitBoneWeightsProcess.h index 855c8628a..b19d536cf 100644 --- a/code/PostProcessing/LimitBoneWeightsProcess.h +++ b/code/PostProcessing/LimitBoneWeightsProcess.h @@ -86,27 +86,27 @@ public: * @return true if the process is present in this flag fields, * false if not. */ - bool IsActive( unsigned int pFlags) const; + bool IsActive( unsigned int pFlags) const override; // ------------------------------------------------------------------- /** Called prior to ExecuteOnScene(). * The function is a request to the process to update its configuration * basing on the Importer's configuration property list. */ - void SetupProperties(const Importer* pImp); - - // ------------------------------------------------------------------- - /** Limits the bone weight count for all vertices in the given mesh. - * @param pMesh The mesh to process. - */ - void ProcessMesh( aiMesh* pMesh); + void SetupProperties(const Importer* pImp) override; // ------------------------------------------------------------------- /** Executes the post processing step on the given imported data. * At the moment a process is not supposed to fail. * @param pScene The imported data to work at. */ - void Execute( aiScene* pScene); + void Execute( aiScene* pScene) override; + + // ------------------------------------------------------------------- + /** Limits the bone weight count for all vertices in the given mesh. + * @param pMesh The mesh to process. + */ + void ProcessMesh( aiMesh* pMesh); // ------------------------------------------------------------------- /** Describes a bone weight on a vertex */ diff --git a/code/PostProcessing/MakeVerboseFormat.h b/code/PostProcessing/MakeVerboseFormat.h index b7ac10019..f21f5919e 100644 --- a/code/PostProcessing/MakeVerboseFormat.h +++ b/code/PostProcessing/MakeVerboseFormat.h @@ -78,7 +78,7 @@ public: * @param pFlags The processing flags the importer was called with. A bitwise * combination of #aiPostProcessSteps. * @return true if the process is present in this flag fields, false if not */ - bool IsActive( unsigned int /*pFlags*/ ) const + bool IsActive( unsigned int /*pFlags*/ ) const override { // NOTE: There is no direct flag that corresponds to // this postprocess step. @@ -89,7 +89,7 @@ public: /** Executes the post processing step on the given imported data. * At the moment a process is not supposed to fail. * @param pScene The imported data to work at. */ - void Execute( aiScene* pScene); + void Execute( aiScene* pScene) override; public: diff --git a/code/PostProcessing/OptimizeMeshes.h b/code/PostProcessing/OptimizeMeshes.h index 1109a30e7..0b062959a 100644 --- a/code/PostProcessing/OptimizeMeshes.h +++ b/code/PostProcessing/OptimizeMeshes.h @@ -93,16 +93,14 @@ public: unsigned int output_id; }; -public: // ------------------------------------------------------------------- - bool IsActive( unsigned int pFlags) const; + bool IsActive( unsigned int pFlags) const override; // ------------------------------------------------------------------- - void Execute( aiScene* pScene); + void Execute( aiScene* pScene) override; // ------------------------------------------------------------------- - void SetupProperties(const Importer* pImp); - + void SetupProperties(const Importer* pImp) override; // ------------------------------------------------------------------- /** @brief Specify whether you want meshes with different diff --git a/code/PostProcessing/RemoveRedundantMaterials.h b/code/PostProcessing/RemoveRedundantMaterials.h index 0fbf33c1b..1b42bea55 100644 --- a/code/PostProcessing/RemoveRedundantMaterials.h +++ b/code/PostProcessing/RemoveRedundantMaterials.h @@ -66,15 +66,15 @@ public: // ------------------------------------------------------------------- // Check whether step is active - bool IsActive( unsigned int pFlags) const; + bool IsActive( unsigned int pFlags) const override; // ------------------------------------------------------------------- // Execute step on a given scene - void Execute( aiScene* pScene); + void Execute( aiScene* pScene) override; // ------------------------------------------------------------------- // Setup import settings - void SetupProperties(const Importer* pImp); + void SetupProperties(const Importer* pImp) override; // ------------------------------------------------------------------- /** @brief Set list of fixed (inmutable) materials diff --git a/code/PostProcessing/RemoveVCProcess.h b/code/PostProcessing/RemoveVCProcess.h index dfd9b59ff..45c0b3a71 100644 --- a/code/PostProcessing/RemoveVCProcess.h +++ b/code/PostProcessing/RemoveVCProcess.h @@ -69,37 +69,35 @@ public: * combination of #aiPostProcessSteps. * @return true if the process is present in this flag fields, false if not. */ - bool IsActive( unsigned int pFlags) const; + bool IsActive( unsigned int pFlags) const override; // ------------------------------------------------------------------- /** Executes the post processing step on the given imported data. * At the moment a process is not supposed to fail. * @param pScene The imported data to work at. */ - void Execute( aiScene* pScene); + void Execute( aiScene* pScene) override; // ------------------------------------------------------------------- /** Called prior to ExecuteOnScene(). * The function is a request to the process to update its configuration * basing on the Importer's configuration property list. */ - virtual void SetupProperties(const Importer* pImp); + virtual void SetupProperties(const Importer* pImp) override; // ------------------------------------------------------------------- /** Manually setup the configuration flags for the step * * @param Bitwise combination of the #aiComponent enumerated values. */ - void SetDeleteFlags(unsigned int f) - { + void SetDeleteFlags(unsigned int f) { configDeleteFlags = f; } // ------------------------------------------------------------------- /** Query the current configuration. */ - unsigned int GetDeleteFlags() const - { + unsigned int GetDeleteFlags() const { return configDeleteFlags; } diff --git a/code/PostProcessing/ScaleProcess.h b/code/PostProcessing/ScaleProcess.h index 4d706bfc3..ae1c3ed00 100644 --- a/code/PostProcessing/ScaleProcess.h +++ b/code/PostProcessing/ScaleProcess.h @@ -74,13 +74,13 @@ public: ai_real getScale() const; /// Overwritten, @see BaseProcess - virtual bool IsActive( unsigned int pFlags ) const; + virtual bool IsActive( unsigned int pFlags ) const override; /// Overwritten, @see BaseProcess - virtual void SetupProperties( const Importer* pImp ); + virtual void SetupProperties( const Importer* pImp ) override; /// Overwritten, @see BaseProcess - virtual void Execute( aiScene* pScene ); + virtual void Execute( aiScene* pScene ) override; private: void traverseNodes( aiNode *currentNode, unsigned int nested_node_id = 0 ); diff --git a/code/PostProcessing/SortByPTypeProcess.h b/code/PostProcessing/SortByPTypeProcess.h index c004e0549..ce4f7da62 100644 --- a/code/PostProcessing/SortByPTypeProcess.h +++ b/code/PostProcessing/SortByPTypeProcess.h @@ -66,13 +66,13 @@ public: ~SortByPTypeProcess() override = default; // ------------------------------------------------------------------- - bool IsActive( unsigned int pFlags) const; + bool IsActive( unsigned int pFlags) const override; // ------------------------------------------------------------------- - void Execute( aiScene* pScene); + void Execute( aiScene* pScene) override; // ------------------------------------------------------------------- - void SetupProperties(const Importer* pImp); + void SetupProperties(const Importer* pImp) override; private: int mConfigRemoveMeshes; diff --git a/code/PostProcessing/SplitByBoneCountProcess.h b/code/PostProcessing/SplitByBoneCountProcess.h index e2377a995..e8a36140d 100644 --- a/code/PostProcessing/SplitByBoneCountProcess.h +++ b/code/PostProcessing/SplitByBoneCountProcess.h @@ -75,7 +75,7 @@ public: /// @brief Called prior to ExecuteOnScene(). /// The function is a request to the process to update its configuration /// basing on the Importer's configuration property list. - virtual void SetupProperties(const Importer* pImp); + virtual void SetupProperties(const Importer* pImp) override; protected: /// Executes the post processing step on the given imported data. diff --git a/code/PostProcessing/SplitLargeMeshes.h b/code/PostProcessing/SplitLargeMeshes.h index 605f0477d..955b03aa6 100644 --- a/code/PostProcessing/SplitLargeMeshes.h +++ b/code/PostProcessing/SplitLargeMeshes.h @@ -99,7 +99,7 @@ public: * @return true if the process is present in this flag fields, * false if not. */ - bool IsActive( unsigned int pFlags) const; + bool IsActive( unsigned int pFlags) const override; // ------------------------------------------------------------------- /** Called prior to ExecuteOnScene(). @@ -121,7 +121,7 @@ public: * At the moment a process is not supposed to fail. * @param pScene The imported data to work at. */ - void Execute( aiScene* pScene); + void Execute( aiScene* pScene) override; // ------------------------------------------------------------------- //! Apply the algorithm to a given mesh diff --git a/code/PostProcessing/TextureTransform.h b/code/PostProcessing/TextureTransform.h index 873789f3e..c9f0480ba 100644 --- a/code/PostProcessing/TextureTransform.h +++ b/code/PostProcessing/TextureTransform.h @@ -201,14 +201,13 @@ public: ~TextureTransformStep() override = default; // ------------------------------------------------------------------- - bool IsActive( unsigned int pFlags) const; + bool IsActive( unsigned int pFlags) const override; // ------------------------------------------------------------------- - void Execute( aiScene* pScene); + void Execute( aiScene* pScene) override; // ------------------------------------------------------------------- - void SetupProperties(const Importer* pImp); - + void SetupProperties(const Importer* pImp) override; protected: // ------------------------------------------------------------------- diff --git a/code/PostProcessing/TriangulateProcess.h b/code/PostProcessing/TriangulateProcess.h index fefeac61c..ac31e4377 100644 --- a/code/PostProcessing/TriangulateProcess.h +++ b/code/PostProcessing/TriangulateProcess.h @@ -72,14 +72,14 @@ public: * combination of #aiPostProcessSteps. * @return true if the process is present in this flag fields, false if not. */ - bool IsActive( unsigned int pFlags) const; + bool IsActive( unsigned int pFlags) const override; // ------------------------------------------------------------------- /** Executes the post processing step on the given imported data. * At the moment a process is not supposed to fail. * @param pScene The imported data to work at. */ - void Execute( aiScene* pScene); + void Execute( aiScene* pScene) override; // ------------------------------------------------------------------- /** Triangulates the given mesh. diff --git a/code/PostProcessing/ValidateDataStructure.h b/code/PostProcessing/ValidateDataStructure.h index 87c88669f..9cfd4ced1 100644 --- a/code/PostProcessing/ValidateDataStructure.h +++ b/code/PostProcessing/ValidateDataStructure.h @@ -69,8 +69,7 @@ namespace Assimp { /** Validates the whole ASSIMP scene data structure for correctness. * ImportErrorException is thrown of the scene is corrupt.*/ // -------------------------------------------------------------------------------------- -class ValidateDSProcess : public BaseProcess -{ +class ValidateDSProcess : public BaseProcess { public: // ------------------------------------------------------------------- /// The default class constructor / destructor. @@ -78,13 +77,12 @@ public: ~ValidateDSProcess() override = default; // ------------------------------------------------------------------- - bool IsActive( unsigned int pFlags) const; + bool IsActive( unsigned int pFlags) const override; // ------------------------------------------------------------------- - void Execute( aiScene* pScene); + void Execute( aiScene* pScene) override; protected: - // ------------------------------------------------------------------- /** Report a validation error. This will throw an exception, * control won't return. From 45c1da26b3916a49478ed196b80ba9b5dc9590d2 Mon Sep 17 00:00:00 2001 From: Kim Kulling Date: Tue, 14 Mar 2023 23:34:31 +0100 Subject: [PATCH 41/61] Refactoring: Code cleanup post-processing. --- code/PostProcessing/DeboneProcess.h | 2 +- code/PostProcessing/SplitByBoneCountProcess.h | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/code/PostProcessing/DeboneProcess.h b/code/PostProcessing/DeboneProcess.h index 6e55ce238..ae4448e0e 100644 --- a/code/PostProcessing/DeboneProcess.h +++ b/code/PostProcessing/DeboneProcess.h @@ -94,7 +94,7 @@ protected: * At the moment a process is not supposed to fail. * @param pScene The imported data to work at. */ - void Execute( aiScene* pScene); + void Execute( aiScene* pScene) override; // ------------------------------------------------------------------- /** Counts bones total/removable in a given mesh. diff --git a/code/PostProcessing/SplitByBoneCountProcess.h b/code/PostProcessing/SplitByBoneCountProcess.h index e8a36140d..270e00c49 100644 --- a/code/PostProcessing/SplitByBoneCountProcess.h +++ b/code/PostProcessing/SplitByBoneCountProcess.h @@ -81,7 +81,7 @@ protected: /// Executes the post processing step on the given imported data. /// At the moment a process is not supposed to fail. /// @param pScene The imported data to work at. - void Execute( aiScene* pScene); + void Execute( aiScene* pScene) override; /// Splits the given mesh by bone count. /// @param pMesh the Mesh to split. Is not changed at all, but might be superfluous in case it was split. From 59d97119283aac5f4404c4badcc17618279b7e89 Mon Sep 17 00:00:00 2001 From: Kim Kulling Date: Tue, 14 Mar 2023 23:37:10 +0100 Subject: [PATCH 42/61] Refactoring: Code cleanup post-processing. --- code/PostProcessing/SplitLargeMeshes.h | 9 +++------ 1 file changed, 3 insertions(+), 6 deletions(-) diff --git a/code/PostProcessing/SplitLargeMeshes.h b/code/PostProcessing/SplitLargeMeshes.h index 955b03aa6..4e0d764c1 100644 --- a/code/PostProcessing/SplitLargeMeshes.h +++ b/code/PostProcessing/SplitLargeMeshes.h @@ -156,15 +156,14 @@ public: * combination of #aiPostProcessSteps. * @return true if the process is present in this flag fields, false if not. */ - bool IsActive( unsigned int pFlags) const; + bool IsActive( unsigned int pFlags) const override; // ------------------------------------------------------------------- /** Called prior to ExecuteOnScene(). * The function is a request to the process to update its configuration * basing on the Importer's configuration property list. */ - virtual void SetupProperties(const Importer* pImp); - + void SetupProperties(const Importer* pImp) override; //! Set the split limit - needed for unit testing inline void SetLimit(unsigned int l) @@ -174,14 +173,12 @@ public: inline unsigned int GetLimit() const {return LIMIT;} -public: - // ------------------------------------------------------------------- /** Executes the post processing step on the given imported data. * At the moment a process is not supposed to fail. * @param pScene The imported data to work at. */ - void Execute( aiScene* pScene); + void Execute( aiScene* pScene) override; // ------------------------------------------------------------------- //! Apply the algorithm to a given mesh From c537bd78d0f3c80d0048845a427adc2dd3b1f2c7 Mon Sep 17 00:00:00 2001 From: Kim Kulling Date: Tue, 14 Mar 2023 23:39:36 +0100 Subject: [PATCH 43/61] Refactoring: Code cleanup post-processing. --- code/PostProcessing/CalcTangentsProcess.h | 4 +--- code/PostProcessing/SplitByBoneCountProcess.h | 2 +- 2 files changed, 2 insertions(+), 4 deletions(-) diff --git a/code/PostProcessing/CalcTangentsProcess.h b/code/PostProcessing/CalcTangentsProcess.h index 94be99cd6..aaccb5307 100644 --- a/code/PostProcessing/CalcTangentsProcess.h +++ b/code/PostProcessing/CalcTangentsProcess.h @@ -86,7 +86,6 @@ public: } protected: - // ------------------------------------------------------------------- /** Calculates tangents and bitangents for a specific mesh. * @param pMesh The mesh to process. @@ -98,10 +97,9 @@ protected: /** Executes the post processing step on the given imported data. * @param pScene The imported data to work at. */ - void Execute( aiScene* pScene); + void Execute( aiScene* pScene) override; private: - /** Configuration option: maximum smoothing angle, in radians*/ float configMaxAngle; unsigned int configSourceUV; diff --git a/code/PostProcessing/SplitByBoneCountProcess.h b/code/PostProcessing/SplitByBoneCountProcess.h index 270e00c49..98ca6a61e 100644 --- a/code/PostProcessing/SplitByBoneCountProcess.h +++ b/code/PostProcessing/SplitByBoneCountProcess.h @@ -70,7 +70,7 @@ public: /// @param pFlags The processing flags the importer was called with. A /// bitwise combination of #aiPostProcessSteps. /// @return true if the process is present in this flag fields, false if not. - bool IsActive( unsigned int pFlags) const; + bool IsActive( unsigned int pFlags) const override; /// @brief Called prior to ExecuteOnScene(). /// The function is a request to the process to update its configuration From 7e5a178637ff4dbac91e55937035af0434d86bb0 Mon Sep 17 00:00:00 2001 From: Kim Kulling Date: Tue, 14 Mar 2023 23:49:41 +0100 Subject: [PATCH 44/61] Update: Add missing geo doc. --- code/Geometry/GeometryUtils.cpp | 43 ++++++++++++++- code/Geometry/GeometryUtils.h | 54 +++++++++++++++++++ code/PostProcessing/SplitByBoneCountProcess.h | 1 - 3 files changed, 95 insertions(+), 3 deletions(-) diff --git a/code/Geometry/GeometryUtils.cpp b/code/Geometry/GeometryUtils.cpp index 9b29af1dd..ab735aa6e 100644 --- a/code/Geometry/GeometryUtils.cpp +++ b/code/Geometry/GeometryUtils.cpp @@ -1,3 +1,44 @@ +/* +Open Asset Import Library (assimp) +---------------------------------------------------------------------- + +Copyright (c) 2006-2022, assimp team + +All rights reserved. + +Redistribution and use of this software in source and binary forms, +with or without modification, are permitted provided that the +following conditions are met: + +* Redistributions of source code must retain the above + copyright notice, this list of conditions and the + following disclaimer. + +* Redistributions in binary form must reproduce the above + copyright notice, this list of conditions and the + following disclaimer in the documentation and/or other + materials provided with the distribution. + +* Neither the name of the assimp team, nor the names of its + contributors may be used to endorse or promote products + derived from this software without specific prior + written permission of the assimp team. + +THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS +"AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT +LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR +A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT +OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, +SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT +LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, +DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY +THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT +(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE +OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. + +---------------------------------------------------------------------- +*/ + #include "GeometryUtils.h" #include @@ -20,8 +61,6 @@ ai_real GeometryUtils::distance3D( const aiVector3D &vA, aiVector3D &vB ) { return d; } - - ai_real GeometryUtils::calculateAreaOfTriangle( const aiFace& face, aiMesh* mesh ) { ai_real area = 0; diff --git a/code/Geometry/GeometryUtils.h b/code/Geometry/GeometryUtils.h index 2eb96926d..ab49380de 100644 --- a/code/Geometry/GeometryUtils.h +++ b/code/Geometry/GeometryUtils.h @@ -1,12 +1,66 @@ +/* +Open Asset Import Library (assimp) +---------------------------------------------------------------------- + +Copyright (c) 2006-2022, assimp team + +All rights reserved. + +Redistribution and use of this software in source and binary forms, +with or without modification, are permitted provided that the +following conditions are met: + +* Redistributions of source code must retain the above + copyright notice, this list of conditions and the + following disclaimer. + +* Redistributions in binary form must reproduce the above + copyright notice, this list of conditions and the + following disclaimer in the documentation and/or other + materials provided with the distribution. + +* Neither the name of the assimp team, nor the names of its + contributors may be used to endorse or promote products + derived from this software without specific prior + written permission of the assimp team. + +THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS +"AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT +LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR +A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT +OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, +SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT +LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, +DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY +THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT +(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE +OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. + +---------------------------------------------------------------------- +*/ + #include #include namespace Assimp { +// --------------------------------------------------------------------------- +/// @brief This helper class supports some basic geometry algorithms. +// --------------------------------------------------------------------------- class GeometryUtils { public: static ai_real heron( ai_real a, ai_real b, ai_real c ); + + /// @brief Will compute the distance between 2 3D-vectors + /// @param vA Vector a. + /// @param vB Vector b. + /// @return The distance. static ai_real distance3D( const aiVector3D &vA, aiVector3D &vB ); + + /// @brief Will calculate the area of a triangle described by a aiFace. + /// @param face The face + /// @param mesh The mesh containing the face + /// @return The area. static ai_real calculateAreaOfTriangle( const aiFace& face, aiMesh* mesh ); }; diff --git a/code/PostProcessing/SplitByBoneCountProcess.h b/code/PostProcessing/SplitByBoneCountProcess.h index 98ca6a61e..625019e0c 100644 --- a/code/PostProcessing/SplitByBoneCountProcess.h +++ b/code/PostProcessing/SplitByBoneCountProcess.h @@ -4,7 +4,6 @@ Open Asset Import Library (assimp) Copyright (c) 2006-2022, assimp team - All rights reserved. Redistribution and use of this software in source and binary forms, From 16f9ba4935c2b1c83e13cc4081a92294c792c9f0 Mon Sep 17 00:00:00 2001 From: Kim Kulling Date: Wed, 15 Mar 2023 13:26:24 +0100 Subject: [PATCH 45/61] Remove alarm badge --- Readme.md | 1 - 1 file changed, 1 deletion(-) diff --git a/Readme.md b/Readme.md index 917b8e8aa..1af71fad8 100644 --- a/Readme.md +++ b/Readme.md @@ -14,7 +14,6 @@ A library to import and export various 3d-model-formats including scene-post-pro [![Join the chat at https://gitter.im/assimp/assimp](https://badges.gitter.im/assimp/assimp.svg)](https://gitter.im/assimp/assimp?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge) [![Average time to resolve an issue](http://isitmaintained.com/badge/resolution/assimp/assimp.svg)](http://isitmaintained.com/project/assimp/assimp "Average time to resolve an issue") [![Percentage of issues still open](http://isitmaintained.com/badge/open/assimp/assimp.svg)](http://isitmaintained.com/project/assimp/assimp "Percentage of issues still open") -[![Total alerts](https://img.shields.io/lgtm/alerts/g/assimp/assimp.svg?logo=lgtm&logoWidth=18)](https://lgtm.com/projects/g/assimp/assimp/alerts/)
APIs are provided for C and C++. There are various bindings to other languages (C#, Java, Python, Delphi, D). Assimp also runs on Android and iOS. From 95616cf5b56af37df8d299a89a99450643e688aa Mon Sep 17 00:00:00 2001 From: Steve M Date: Fri, 17 Mar 2023 22:13:40 -0700 Subject: [PATCH 46/61] Add UTF-8 versions of UTF-16LE files Also duplicate missing textures for local model access --- test/models-nonbsd/BLEND/guard1_body.png | Bin 0 -> 233429 bytes test/models-nonbsd/BLEND/guard1_face.png | Bin 0 -> 121149 bytes test/models-nonbsd/BLEND/guard1_helmet.png | Bin 0 -> 47481 bytes test/models-nonbsd/BLEND/iron_grill.png | Bin 0 -> 65146 bytes test/models-nonbsd/BLEND/round_grill.png | Bin 0 -> 48671 bytes test/models-nonbsd/IRR/skybox.xml | Bin 23794 -> 11642 bytes test/models-nonbsd/IRR/skybox_UTF16LE.xml | Bin 0 -> 23794 bytes test/models/IRR/1.png | Bin 0 -> 28975 bytes .../IRR/EpisodeII_TheDwarfesStrikeBack.irr | Bin 95946 -> 46924 bytes ...EpisodeII_TheDwarfesStrikeBack_UTF16LE.irr | Bin 0 -> 95946 bytes test/models/IRR/EpisodeI_ANewDwarf.irr | Bin 72612 -> 35514 bytes .../models/IRR/EpisodeI_ANewDwarf_UTF16LE.irr | Bin 0 -> 72612 bytes test/models/IRR/animMesh.irr | Bin 12938 -> 6324 bytes test/models/IRR/animMesh_UTF16LE.irr | Bin 0 -> 12938 bytes test/models/IRR/box.irr | Bin 5368 -> 2618 bytes test/models/IRR/box_UTF16LE.irr | Bin 0 -> 5368 bytes test/models/IRR/brownground_1-1.jpg | Bin 0 -> 66623 bytes test/models/IRR/crackedground_1-6.jpg | Bin 0 -> 41455 bytes .../models/IRR/dawfInCellar_ChildOfCellar.irr | Bin 21892 -> 10707 bytes .../dawfInCellar_ChildOfCellar_UTF16LE.irr | Bin 0 -> 21892 bytes .../models/IRR/dawfInCellar_SameHierarchy.irr | Bin 21630 -> 10576 bytes .../dawfInCellar_SameHierarchy_UTF16LE.irr | Bin 0 -> 21630 bytes test/models/IRR/multipleAnimators.irr | Bin 6654 -> 3244 bytes test/models/IRR/multipleAnimators_UTF16LE.irr | Bin 0 -> 6654 bytes test/models/IRR/scenegraphAnim.irr | Bin 47716 -> 23306 bytes test/models/IRR/scenegraphAnim_UTF16LE.irr | Bin 0 -> 47716 bytes test/models/IRR/sphere.irr | Bin 5588 -> 2726 bytes test/models/IRR/sphere_UTF16LE.irr | Bin 0 -> 5588 bytes test/models/IRRMesh/cellar.irrmesh | Bin 188818 -> 93467 bytes test/models/IRRMesh/cellar_UTF16LE.irrmesh | Bin 0 -> 188818 bytes test/models/IRRMesh/spider.irrmesh | Bin 293192 -> 144852 bytes test/models/IRRMesh/spider_UTF16LE.irrmesh | Bin 0 -> 293192 bytes test/models/IRRMesh/testFormatDetection.xml | Bin 53842 -> 26504 bytes .../IRRMesh/testFormatDetection_UTF16LE.xml | Bin 0 -> 53842 bytes 34 files changed, 0 insertions(+), 0 deletions(-) create mode 100644 test/models-nonbsd/BLEND/guard1_body.png create mode 100644 test/models-nonbsd/BLEND/guard1_face.png create mode 100644 test/models-nonbsd/BLEND/guard1_helmet.png create mode 100644 test/models-nonbsd/BLEND/iron_grill.png create mode 100644 test/models-nonbsd/BLEND/round_grill.png create mode 100644 test/models-nonbsd/IRR/skybox_UTF16LE.xml create mode 100644 test/models/IRR/1.png create mode 100644 test/models/IRR/EpisodeII_TheDwarfesStrikeBack_UTF16LE.irr create mode 100644 test/models/IRR/EpisodeI_ANewDwarf_UTF16LE.irr create mode 100644 test/models/IRR/animMesh_UTF16LE.irr create mode 100644 test/models/IRR/box_UTF16LE.irr create mode 100644 test/models/IRR/brownground_1-1.jpg create mode 100644 test/models/IRR/crackedground_1-6.jpg create mode 100644 test/models/IRR/dawfInCellar_ChildOfCellar_UTF16LE.irr create mode 100644 test/models/IRR/dawfInCellar_SameHierarchy_UTF16LE.irr create mode 100644 test/models/IRR/multipleAnimators_UTF16LE.irr create mode 100644 test/models/IRR/scenegraphAnim_UTF16LE.irr create mode 100644 test/models/IRR/sphere_UTF16LE.irr create mode 100644 test/models/IRRMesh/cellar_UTF16LE.irrmesh create mode 100644 test/models/IRRMesh/spider_UTF16LE.irrmesh create mode 100644 test/models/IRRMesh/testFormatDetection_UTF16LE.xml diff --git a/test/models-nonbsd/BLEND/guard1_body.png b/test/models-nonbsd/BLEND/guard1_body.png new file mode 100644 index 0000000000000000000000000000000000000000..2eb3f2caaddd89d6c69c10983e5df684ca339aae GIT binary patch literal 233429 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

P#Z!*8z+dW{BJKx?@gG{%doq$!csU#TE_I=B$A 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 literal 0 HcmV?d00001 diff --git a/test/models-nonbsd/BLEND/guard1_face.png b/test/models-nonbsd/BLEND/guard1_face.png new file mode 100644 index 0000000000000000000000000000000000000000..b7e17d37598ba766b5535b44dd32ba59a0c7038d GIT binary patch literal 121149 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 literal 0 HcmV?d00001 diff --git a/test/models-nonbsd/BLEND/guard1_helmet.png b/test/models-nonbsd/BLEND/guard1_helmet.png new file mode 100644 index 0000000000000000000000000000000000000000..166d790fd4f30e332a422d61434bd6a4a1eff5f3 GIT binary patch literal 47481 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®|n?^N>qUHr6C2YrAHp#7-q0@K4 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 z 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 Z{U1?;VVMpbh8X|=002ovPDHLkV1nGxqoV)- literal 0 HcmV?d00001 diff --git a/test/models-nonbsd/BLEND/iron_grill.png b/test/models-nonbsd/BLEND/iron_grill.png new file mode 100644 index 0000000000000000000000000000000000000000..53a3bbbcc2893daded718aa58051eb7d173c0668 GIT binary patch literal 65146 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 M07*qoM6N<$f;iJ4T>t<8 literal 0 HcmV?d00001 diff --git a/test/models-nonbsd/IRR/skybox.xml b/test/models-nonbsd/IRR/skybox.xml index a572e473f27f5d25ab1829395068acb74215dd2b..a2be5b785eb0e191c1cab65400fa6b5f22bd00fc 100644 GIT binary patch literal 11642 zcmeHN-A>yu6uwTMqRRC~3+yt0=zs}nVrWG};s&{?Qw&ZV`KN-t+Aj7;dxg3AJ5Exk zX45X1+>0tv&v$%2`<(M7u7Cab8J#?*biBq~5SAT<`+L*y^$>p*!c)wr&95c#zQdyj) z3xYHGnXDc(zH&C*n--sUKjJVq2&N-uOZx&5mqj0Iz~ z;_;0LvM}(HEA6aU=^(_@km!XGz05K~w+&X7LO!)andL)E!~kxHrPM z6ovhl#iO3)t-iaN5JWm0%!wX;la{>51Zh2 z7=GAdXyoB7;W*JV1FO`^?;tX4KQYCTTFxKP(kuwGf?D=P7c?#HuJ3L+k@!4AW@&cJ zq15hXDoHS8ijh%9xHA+#B`C(-0=C9`!B)c&7|yR4PZ1^Gad`n**a_Nz%!uwI81V~2 zbsa;pSmS8}AT=BTkRpx%NEIvKhFeJ3X?Gw%!x;iZoFPEP4mr(;V3M<(#N8!%1;~X@ zZzLB+J&=`?p;}cZy5%T060B@b_c29jUVcN<*bW9(Rhz279OoFxU1*^9Cura~gl@~D z*Tc7`hx=X+%}2?Wbb39kACs&CYP2Zh5xzBxZ2>j9k{iHiL^eQ2+@R;$6{G_J8qN?P z;tT;Qc1TZfT-fwLE_`|*7e+mhmD6@f12%10DO7Qnq5-Qm*z2MBHtF9F>#kL0$*bNE zr(O@e9{TsgX1~I&R2>O*QI8J9svXATMo(}+LF}RRK%gA20J$*gjb!EI_0aE^hHvlv z@X+g_*F&#|UJo(%dZ;%z+kfztd%ByAUeNuacT>M#8bs#*fp1R_Rqh4R3!)c9FNj_c zixV(j5UUe4uzPLp#{TyQYL=N7L@$V55WOIJLHq}T7){Irr_p3{5?P-;jwa@r>fd&} B@`eBa literal 23794 zcmeHPQE%He5Wd$A*ncScyscTY$81Hiv_pZRD;8q~`Vu&f?WK#8K(>o)KYrWyi83Tw zN7AC{q7Mhdh$7K<$NP@Q`$S6r{d*!WnjXx&_?V9z~%$1Bf0X*ZCt+LH4|uIrYcAg`72E&9^`{RDDv@vUUGCFK-$ zU7;83<4S(T(Omv)Z15!?)jm3cpWNpgNXk9uTX=%rhW)wm_#N!OhMiAg-QV)i_-rYE z;lDFndqlsx7^P8SiyWNzn=yR30&)+q$Jubz*x+MF9s8k235?hY^bx^hc)^dTcR0^z zUg67#?nhP`oLpqbZTTG*&^up(Ef??^$Hr9gh#T>nSUwU)^DgK7$aNke@*H12Dt`bC zqH-0mfZ2m1Uz5nuxW>rzC7$9OV_?zvcOpOI%q>2Qu({I9S>69-K#LZa=V;4}Hkb2S z%UDwVVBYMC0}sVI6pDh-!y(`Gc>P1( znheypdRa%pO_Q6uS=`BMGx0XI-8|fvJ45E~e)>LVk3!PV;Q{`74gYJSp(~lk!=%50 zry1*vc4mjZ_3b!wN5kY_)Y*Pg$2#+FU;b|P&oEN%Yt((;Utq@LSm2lQ_)^iZok8^; zgfzT^)(YQ6Gdss;)?C>yvh8O5@`zEmhLxOQyY>2kEkRjvnGDD(G|{=F6Zcy zf5BKF-bCtJI0nY}8=6VNvla7>uA!|aLsIiB{~+&SH|w3LysBe0G{>go)2{8h`U9%T zb)79aa}a+&+O_#E?1M9Sb%Gj|mXJxLX6zh4zXp=?Jw2f#_!g3@dLCts@el0pp3(AT z%Hz78Ge~z;%oKjAHSt*=r2Uv|7rq zRxW|+E!r;7x_hiwB|~&;n8kFn2H`yya;E*YYbbs`?HaE6+T(0=!y}DrZtimK#??Yh z*0|;-qKs?CxhC)C8Q0WvwO)lA*X-ZLHLmI34Kl9j)}uCASRYBoHMds;!gomG98jx~ z^LR{Lk5&&KLXTGY9zu^+fyc%MHwyx=C89#PLxSQ3kd20D__jOIK4jb3hX9~SSHm+%0 z({ZRUGcc}cT$35R60JJs%9p->E*w#D4yermd7LS(N2`Yqp{E>wiT6iCC$B$go>UH_ zw61bErFE6VDy=IAuOWO-!^p41x@(!;W4(eHqFci(rrWrtaZP`g4Xr#H*EFsf+r8{( znZt3-W8<3Gfuhe8#x?tUs&${(x~4xujcfX|pdK~0u4(I}dvQY?DuK>J_f7Y;M2fXyon6+dL_&-9_+g z;O;8&C3c3yo>sM8w0<>WE1R~m`6aAuUgNC>#x{*@8ruxN(QlQp>(SOW{kyKVw%L7S zY)(YQ*XXqUe|hX8uBRM}iR&rHVB&hTDmTw>X;xMaqqMGaIHh%!!z!&S2d^QFPs1q2 ldhD6aGH)l+aEo)KYrWyi83Tw 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 literal 0 HcmV?d00001 diff --git a/test/models/IRR/EpisodeII_TheDwarfesStrikeBack.irr b/test/models/IRR/EpisodeII_TheDwarfesStrikeBack.irr index 1f0916d4d9e64229b276098dd3a83315a29f4370..94d0bae6f2c454bc6d66ac4cddbad8798a9400a5 100644 GIT binary patch literal 46924 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 diff --git a/test/models/IRR/EpisodeI_ANewDwarf_UTF16LE.irr b/test/models/IRR/EpisodeI_ANewDwarf_UTF16LE.irr new file mode 100644 index 0000000000000000000000000000000000000000..39d99e440925950cf4460a8794aeb968a445ef30 GIT binary patch literal 72612 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 literal 0 HcmV?d00001 diff --git a/test/models/IRR/animMesh.irr b/test/models/IRR/animMesh.irr index d1c9e10183ae5671b19e5b50b4de56393f03b1b0..c1c247ff2274d0d3a03e0ed897cf9cbd04fd0020 100644 GIT binary patch literal 6324 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 B5!nC$ literal 5368 zcmc&&T~8W86uqxD>3=Xjx0TjD(i*7Rm^9WDQxjhZtbnwzm}N1xKfdibGpoD9+}(u{ zYzVUM%$|GaocjfT|1{-L?qwYVAbavw-be$Vhw@Qg$_r^?Ey1gc zT@iN2c-s}O?qIzqDP9To^<{yp0e0FQJ7#^Jt;RBf#Tfgi*h5=q+4Y|Bqz8`{*-8R` zW_XS(`wrR|2Be}_ZaFH8^ zqXu}guU9|{z2|z^#A(aNBb<|p9pKb%1fAnPqc_Ey5$s3OW^}QUTCyC&KF-X1a#i^bHK{}ocUBnjdF$Sg?zmbW$ z3Gf+VBjuFz>|V8?#pDsZVf7lxk+IN|x-+mw`th#waSAqa3twUBM;6t-Izyw?yo8-0 zPCPRny8Lv&!|&{wWwn~fPR>gca<|ewv zS$!{d0*jYdbC(admixFvRR7{@nUiYtBQU_H7tmG9up%}yL{7~AR5wv8VhBrBHndu@X&YK?*|ZI<)`Zx&0PpK5 z5~h2#9Zi*O*wK{Ph8<0vFgqyaO>6IH|=z= YZ@MUL_}@19{KGF``7e>YTlGujKaRB&;Q#;t diff --git a/test/models/IRR/box_UTF16LE.irr b/test/models/IRR/box_UTF16LE.irr new file mode 100644 index 0000000000000000000000000000000000000000..efc165d934a0dfede0a168772740e9c8cc57f088 GIT binary patch literal 5368 zcmc&&T~8W86uqxD>3=Xjx0TjD(i*7Rm^9WDQxjhZtbnwzm}N1xKfdibGpoD9+}(u{ zYzVUM%$|GaocjfT|1{-L?qwYVAbavw-be$Vhw@Qg$_r^?Ey1gc zT@iN2c-s}O?qIzqDP9To^<{yp0e0FQJ7#^Jt;RBf#Tfgi*h5=q+4Y|Bqz8`{*-8R` zW_XS(`wrR|2Be}_ZaFH8^ zqXu}guU9|{z2|z^#A(aNBb<|p9pKb%1fAnPqc_Ey5$s3OW^}QUTCyC&KF-X1a#i^bHK{}ocUBnjdF$Sg?zmbW$ z3Gf+VBjuFz>|V8?#pDsZVf7lxk+IN|x-+mw`th#waSAqa3twUBM;6t-Izyw?yo8-0 zPCPRny8Lv&!|&{wWwn~fPR>gca<|ewv zS$!{d0*jYdbC(admixFvRR7{@nUiYtBQU_H7tmG9up%}yL{7~AR5wv8VhBrBHndu@X&YK?*|ZI<)`Zx&0PpK5 z5~h2#9Zi*O*wK{Ph8<0vFgqyaO>6IH|=z= YZ@MUL_}@19{KGF``7e>YTlGujKaRB&;Q#;t literal 0 HcmV?d00001 diff --git a/test/models/IRR/brownground_1-1.jpg b/test/models/IRR/brownground_1-1.jpg new file mode 100644 index 0000000000000000000000000000000000000000..fda7d45c6e9b1b1d36d37b9cc16c8776693d030a GIT binary patch literal 66623 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

DsW;M~OSyXw=|Do>DsW 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 Yg&ixoukO6~VPpBD%;w6S;~#7O1N6d`kpKVy literal 21892 zcmeHPYj4{&6y?_r*ncScc}??d7a&{FuI&(DeV{Scp=w)vtc&z z{?zUUC0se)rOx0`U^< zFVKcqZ|3I@3QdO4=yrZ*3Vp8dIo^5XNIQds*^-caW5N&DHP#z4hC(wD=|TA4AXk(C%+@ zJ+~RHdIOCgIQ+yJVv7`xT+J=l-PoZf9FZgRiwy0cm+pvphwB`zGaMYT)WPLu58UjT z@69&Y-vTS-hGTjU=R0N>f1ecB9^$_Z9OY}fHdf-=yoV06f-j#oc}9h`ZP+qLuo_4I zMA(G=-$&1PVV5nOl{P8IFW=QQ#qcru%o*hJ@+W}%ju8-K0g0~xwb^J5)H9leI`|=#v0N;D3oLqiN6H z19gab`4%jk!~480tjAU4Y~GJHJ#6CdXk|MJswj&UhWGtGlXJ(;A3e?na}QeAnj_7w z07SpW3V4ATR38JxU#u$2qqw@J)GOXkiPX1A`a*c{v%`sV*-%S4#jKiy91h}?8!dl3g&x14NMj+5XKPlD*+ZWvf zAHqAJPH|kotJbw&_Wh}{?aJh?a?NBj7Q2J@yoHvG7OJt=z`3XN*IwipvaZZukab#| z-QsMFxv^y!Z*9QOUC+I9HEy#ru(>{}&sra1UKiSE`!>hi5gc}vY5j%EotCNBkq;QX zs*N3i{O-B!Bux0M~ zHRq>e#4qKcV^?4H+ay0NCG)+V^gcf=M^~SpR(HARUm0~zFly^L>f=5~H3QgYu`i(f zp`M94%jt8}`hIwyqgMBt`W)3hxhws(o=1I-y8H~nzqb_59aU_dmj8rtR201m92GCG z0!OU`X*luxDj!F2tb9DhvGQ>h$4cR=O_r!QO3#!yo7%DPTs0{~ z@Xy;a6DMEpb4vUC_BVK%F`gguNzVy5Ruwz`KIE-FAx^yB&iaOsceE|y{*HLQ70}l4 z)vd;Tem)(u6^_f^ff9YYZ*DzfU2>D^ije#!yL%&OSH9E?4#|)2@39AauuOThMQB!m z67xdrgKr0}X$?vjjP6w^p&l%xt9YzQ9SWtpu}fMd3O&aV{$c{J;jc1jho<`E8%53g zpkl}FQdLaold4yM?mKm~u9lszp2UyQwW7o?InRC_<*SuFt*XSYZO*z9KT7vqJHPB| zB}tCj5h47_b1d^xzWd^6UvAwjH{C^US{`i?`rLFedVSgTmzA4VceVQb z)PBR)H|li`+2^Oe?7GiS>oqogeyVnZ^~?%o!8#_(odxU2D>sUcuToILS!2$eCyb=n zNzJapNQ$A=ASsqok>XiZPOjo;Ir)mC<>V}mmd0C~{7`Y#B|mDLA1e0NiLdxvC%$61 z3x1!UGH&7bDBWjXU&^!7&EmW7{B0Cpr0&ar`~39l$WMK|y0h9HodfLYExsS1d}4R0 z%F}h1s{EHvs*aTV9JJ3to99)14%*ySeGaOA|H{^mX(H;J{tqu%p<)04 diff --git a/test/models/IRR/dawfInCellar_ChildOfCellar_UTF16LE.irr b/test/models/IRR/dawfInCellar_ChildOfCellar_UTF16LE.irr new file mode 100644 index 0000000000000000000000000000000000000000..698530d3ae82b215d0e886047e6cfaca47d60871 GIT binary patch literal 21892 zcmeHPYj4{&6y?_r*ncScc}??d7a&{FuI&(DeV{Scp=w)vtc&z z{?zUUC0se)rOx0`U^< zFVKcqZ|3I@3QdO4=yrZ*3Vp8dIo^5XNIQds*^-caW5N&DHP#z4hC(wD=|TA4AXk(C%+@ zJ+~RHdIOCgIQ+yJVv7`xT+J=l-PoZf9FZgRiwy0cm+pvphwB`zGaMYT)WPLu58UjT z@69&Y-vTS-hGTjU=R0N>f1ecB9^$_Z9OY}fHdf-=yoV06f-j#oc}9h`ZP+qLuo_4I zMA(G=-$&1PVV5nOl{P8IFW=QQ#qcru%o*hJ@+W}%ju8-K0g0~xwb^J5)H9leI`|=#v0N;D3oLqiN6H z19gab`4%jk!~480tjAU4Y~GJHJ#6CdXk|MJswj&UhWGtGlXJ(;A3e?na}QeAnj_7w z07SpW3V4ATR38JxU#u$2qqw@J)GOXkiPX1A`a*c{v%`sV*-%S4#jKiy91h}?8!dl3g&x14NMj+5XKPlD*+ZWvf zAHqAJPH|kotJbw&_Wh}{?aJh?a?NBj7Q2J@yoHvG7OJt=z`3XN*IwipvaZZukab#| z-QsMFxv^y!Z*9QOUC+I9HEy#ru(>{}&sra1UKiSE`!>hi5gc}vY5j%EotCNBkq;QX zs*N3i{O-B!Bux0M~ zHRq>e#4qKcV^?4H+ay0NCG)+V^gcf=M^~SpR(HARUm0~zFly^L>f=5~H3QgYu`i(f zp`M94%jt8}`hIwyqgMBt`W)3hxhws(o=1I-y8H~nzqb_59aU_dmj8rtR201m92GCG z0!OU`X*luxDj!F2tb9DhvGQ>h$4cR=O_r!QO3#!yo7%DPTs0{~ z@Xy;a6DMEpb4vUC_BVK%F`gguNzVy5Ruwz`KIE-FAx^yB&iaOsceE|y{*HLQ70}l4 z)vd;Tem)(u6^_f^ff9YYZ*DzfU2>D^ije#!yL%&OSH9E?4#|)2@39AauuOThMQB!m z67xdrgKr0}X$?vjjP6w^p&l%xt9YzQ9SWtpu}fMd3O&aV{$c{J;jc1jho<`E8%53g zpkl}FQdLaold4yM?mKm~u9lszp2UyQwW7o?InRC_<*SuFt*XSYZO*z9KT7vqJHPB| zB}tCj5h47_b1d^xzWd^6UvAwjH{C^US{`i?`rLFedVSgTmzA4VceVQb z)PBR)H|li`+2^Oe?7GiS>oqogeyVnZ^~?%o!8#_(odxU2D>sUcuToILS!2$eCyb=n zNzJapNQ$A=ASsqok>XiZPOjo;Ir)mC<>V}mmd0C~{7`Y#B|mDLA1e0NiLdxvC%$61 z3x1!UGH&7bDBWjXU&^!7&EmW7{B0Cpr0&ar`~39l$WMK|y0h9HodfLYExsS1d}4R0 z%F}h1s{EHvs*aTV9JJ3to99)14%*ySeGaOA|H{^mX(H;J{tqu%p<)04 literal 0 HcmV?d00001 diff --git a/test/models/IRR/dawfInCellar_SameHierarchy.irr b/test/models/IRR/dawfInCellar_SameHierarchy.irr index 83d4ab93268633be3fddabd308b869bf098b73e6..5fbfbe6553b75d091ae91b7565e37d3bcb4497e3 100644 GIT binary patch literal 10576 zcmeHN+iu%95Pep@!tiq<%a(Hk)D+F8T?E)(kOZ5eF9t194!e?QP*R%q*Y;sQX@6m< z8;7DqnGUc;TSx)|*_kuq84l-=1ONN?Ki6-lz%a-b@}NA96wiJjuRp`JiH)K1>T9Dv=>3 z^)M}On1bLK#y1JHl8R#C2NQzh8gmQ5K#<6s0hhRyMvZ=DJBB+n!zD+!SBU zd>loH**vYwY-o5$ue!k~c%MXH-=YjN!rvg=$gflL%KiI4M$8udnmVC?B_gw z1Kz`kqGr9{K9GbYIE4^8_UUo)3K+X={{b-+^TMF4`vK#{fN_SOvYg>Mig(o~@Gd3A zn$a)GhS59;R`a8|{dvo?x5{wK>vaR~mE6qjZISkaKvxWShapdfIt*YaW$8U(IONfS znUk}V=bvQzJIxu&gWCrb$m>#G$SwP_`pTAi*Preg$?)q0=_-U=H$PqGVTd7l8VP8R z_7eGjg~-Qh8PN{+4c#aM(2w^WWig7#H(WhHV(KB6gjX|+*c%e@1rGV69ZwqonPLcl z3^4>irf30oOhZCXTY&%#V+as2h5!{koj9STeZ=+V$o2<6k6x9i7D@}Wo`VK{&p`vx zA+)NM-b_AZdb6UpQTAnim?p=$?K#L#@CC8ZhOUc5 z@q2eSQW_E7^=r<=^8Tyt^@(%taHpcXTl34S-*;!X7KX<`arc||^flU9VtI0(qOY$p zWdFVU8Xsrq3GcNtgRs=~sNFSzVzKYhI**A7AL|b+2S~UGFxyrUShsw4J)Ly^g zQ6M1k#t=w#V+bU@9@5$Bn6T-9O!#y_CX6~DEvIoOwr79;$5Fs#P~1?MWikHc6tLO@ z?bFGJz>FHm`*LIFUhGV@3e|33K%q4RK#|n~6hSjl4FzJN843i5=mkxI02Mu?BQhpz zIv^819gqp54oJ&s)WDxs1CO2JhEo5lY9KJ|6*E{wI}Bmr>@bAI0*2$sPc%NHP>d(P m@#I(iN^TFSgax|?2o~=iAXvx>XjHxO=ZyV5cyA{EQu04u@Q~pE literal 21630 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 literal 47716 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 literal 5588 zcmcgw+fLg+5S>>l^&b$=1p;aNlok;#6;ca`M5W~gkt=CKf*c!#etg?=b{*`E$Cns` zEaPQ&Ju`dG+?;=Z8?q;Jxs$Q1%Y*dAlbMWUDiir68?qx?Qp0mkKFeEqBMq#1xUR9Q zi`^64c7>~JSicb;mxp~F2{7tor`@q;)@R}BM265f!Tvk!p{~<#ykRW4fki>M;=!IN z-s8%)BW(l;{*s&%>6x7mkQd3=#95N>cOiF-+mpePlzrIM!6|q~U%p~Al-tk-S8~l@ zR0B@-dIw2m=UfXLIBhzf3&ba|zXvfp0ATOO13z#Dq-@TtkKNHAY@Jz%wwp z@P{IO2eDLM;?IH-i{wKxU_FGnZxkXKRUodX=Tyd(jV;{=+hK-H;yW`qjl$X!uToZC zRB2q++&Yt#J3wWMUrCgCqBQA;K!9)4C$u~em(1~M(vN^NqnvThT$Hpvo=-SlO@7N% zvo5S3gELQ&U(Eirh-slh(&u@zPtoFLIbZ81NYij`>}HQ+yAQWARV8~@L8h2&_Gfcs z(*WqQgNXNIZD&ohe+xNf8@DTDGccpT>7P|ib6A=xu^mfhDM*dL$K@@P3dO-Q%>oy{D_ z=6|y5sTs8lN?AIzTvD|TEw@yyL(4T~bhJ%$t-?q--m~>+th|ICjhUCwqp?#?&pz@N zJ2HNS@>dhq;I8CF%}eR3j;H){RmWAnt}=Y3eNV*uFV-%0PFkR>sQ$S DdUQ3y diff --git a/test/models/IRR/sphere_UTF16LE.irr b/test/models/IRR/sphere_UTF16LE.irr new file mode 100644 index 0000000000000000000000000000000000000000..ab42192680779a9f3f98321fcf9788a22ee6138a GIT binary patch literal 5588 zcmcgw+fLg+5S>>l^&b$=1p;aNlok;#6;ca`M5W~gkt=CKf*c!#etg?=b{*`E$Cns` zEaPQ&Ju`dG+?;=Z8?q;Jxs$Q1%Y*dAlbMWUDiir68?qx?Qp0mkKFeEqBMq#1xUR9Q zi`^64c7>~JSicb;mxp~F2{7tor`@q;)@R}BM265f!Tvk!p{~<#ykRW4fki>M;=!IN z-s8%)BW(l;{*s&%>6x7mkQd3=#95N>cOiF-+mpePlzrIM!6|q~U%p~Al-tk-S8~l@ zR0B@-dIw2m=UfXLIBhzf3&ba|zXvfp0ATOO13z#Dq-@TtkKNHAY@Jz%wwp z@P{IO2eDLM;?IH-i{wKxU_FGnZxkXKRUodX=Tyd(jV;{=+hK-H;yW`qjl$X!uToZC zRB2q++&Yt#J3wWMUrCgCqBQA;K!9)4C$u~em(1~M(vN^NqnvThT$Hpvo=-SlO@7N% zvo5S3gELQ&U(Eirh-slh(&u@zPtoFLIbZ81NYij`>}HQ+yAQWARV8~@L8h2&_Gfcs z(*WqQgNXNIZD&ohe+xNf8@DTDGccpT>7P|ib6A=xu^mfhDM*dL$K@@P3dO-Q%>oy{D_ z=6|y5sTs8lN?AIzTvD|TEw@yyL(4T~bhJ%$t-?q--m~>+th|ICjhUCwqp?#?&pz@N zJ2HNS@>dhq;I8CF%}eR3j;H){RmWAnt}=Y3eNV*uFV-%0PFkR>sQ$S DdUQ3y literal 0 HcmV?d00001 diff --git a/test/models/IRRMesh/cellar.irrmesh b/test/models/IRRMesh/cellar.irrmesh index d8d3a661bd05d9c37e5c8ffc2f281e3a7061eb68..0278c9239513164d67efc07781ee05b033381a27 100644 GIT binary patch literal 93467 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%0Ar%LjP&YQDFR4^ytDZc@| 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 P5ywbg9T#tY{>T3Tm)Ue} literal 293192 zcmeF)U5_Q(ao+j5)d2Gy&iJ11;@g0>A<2@*fX6mQ0tDzrpvXgt7DWn&hZ5}%KQsC3 zKSL{P@67I9Reh>^(~ZKZ>b-X6TCrk1@x&96yXyRZ|L>0;{{6%69{%y+mk*yk{PV-- z4_`d|=HV9)zkc}D!@qs_HxJ)>`1->)x1az1;om*{?+^dm!;iKrKi{tS`|axP`qlQz zm4E;6<@WVY5C7-GH@2@|Z1a4v&H0OmpS*eJ>)Tboe)#P+_LJ@YpKbsC;^F7pzrMb$ z^Z9n)Hy-}e!~e5={ofCN{_vL%|JTFcZma%q`~L0i=Qkg|zs>(P>&CYK_OH*jpGLlXW9MhPy}9PIZT#=w-20y{ zcJtY0<*zpTU1jd}^N(+4`t0FfwsCiU_VCBse~t3%FShr8xvlv1H&$lzA8j7}yEmTs z)x%HU%=hz$Kiyvc?#-R%|MP8}r}+4558vH<@%7C!-+B1n=9_Ol{9wE8Yuh^C-bTN@ zjechv`S$jn(Qj>@``$MGz3uvMZKFKNk1YD#qj`V$=Kk+(vw!!^EZ^O(`p%n`zPsJ? zo$Y?(pKWs=&G(JpW23$NcJs#1HhaJL*U_i#@td2)f4tfI!)>ka{eFMn+D5*<+41c+ zJNKUbdF9&gY&L#>`})?&?#$!vAHMmrhtIZq8{@IO_Swa3-+nXO+M8Wmp5>h3A3b>Y z^X;^LyIu3y_VdTv&(7?x9{$G`6`#ME?VsNu;J3ejM?{E_pI)tGHhBHz_TLv5^Zm&- z^WSZES?$Y%S$ThU<);(h@8WH9|A%c}_y2Z7>5;|W+kZV}?myq`7L(Wo&lJ%jV*CN0 z`>&_W{+Dlj{F802Uv57B;$U`mzialNz416cczlL``G!w^wOKCS?cvCJOu4>}tUsIo zzrC>;X2S4eoQQ}uZ!vs%qVJwLJU@NrFSi~4Zu1E4#&wUey?^h>_HS&qe|^K>f88+q z-?yLt@+Jblw?(T{`rFNuV(ORM*VniA|7l~oBfs5l!_h8ZHe(U=*l#bJ@sAJCb2Ov8 zfCC=;{I53@I*Ffc-(wl~KDO^?Z+tp2e2JCgdH>_KmNWkG_Wh?@4*vV?Uz3rpSNL+f zQrzBd_kZ5({`oemTq}3Jk2(M5;jcG4WZTc*WaJ-jD3k4?{x zbJ}lT<>)lt|0+i(^8QyjI+f?F@+TWVQBJ?!Sn7-I`#){3e)7&J`D#{rU+44gJ-x3p zdiP3CKc_RLzgI&t(~q~aI#NZC^~~RHr%AQ`<97AmZg+jY{ltV{9%k34tbKG^ueJ8k z`MuWKM<@E+wSTm!*7LgWN5Aix)Im@i=o(bzjK1?snY|w*SvHx@&X;^a#Gcz2C?; zw^up=W^Ck#Z>r{RZ}WVA8`)QO{ynSdB7AqdONHHiEK`wuYkNmm$SS%Lx&^utY+$>} z+<)JCGyiwCk#BDEsODWY^Q-H1dsOi=W`0+G|IH5V=ZD)}uF4PBwz|d@*89Qsm8Ir! zr)~yIt)(OK?KeB}lcny}7hq}k{@~4Qe8+-s{;OTQ`t9wS?`~I)FLY1%X#D(x?HaTA ze&kiF@zM7;yLhsBoYo(2bMRt5)$_2UZ*3#ah^6&;Ix$!C7r%N3dU$bs*uCyvmN_ve zHzU@Et?zHMoZ0%=t09n|oT5sOwO;dK2>#}_=4ab~b!T9QH`=FH&d5oQr6JY%!!!Tz z-FLPbAiWXm@l7Z^K7ZE0sXJ$GyKVja`mJqU(GgCk!^GE+1s6qwt2(9czqxwmGscHM z+-9AzZ*KP(ab?yzM=PCKYj$4Zu{>edMHIaL;Eh-BhXEkj`P)y3g;u*X#tXa?D-`|w zIN0Y;T;|IB2a~*@3)l#5Sv}9|^ADHb+3p+0?7m@yVSusJ&+orkmsPL|6QL}ojTiQv zmu7Sy%e>zRyN!w9S#{la6jx)dj_X*_n0>+)M8#Na>nd??O)+cCb-ou#xB+(HxR`H7 z9&p`?E?(6`=Hcu$bFnLO&b;fC!fVVElZjDh_nkZBtwF=bk6UMY8xF9}unR;k-S93X zgqP=I0cz{B$6sc;Er*5Z;z$hNp2f2Hxp}NCI?(m$H`kVs%tTIc2PWd zY~@`nVeT_EQznB>Pa765#KgEVUbxNDp7g{sR?OFVB z5tJTCl@317F~El@g~5RHupeA`8wRWxN1I7zX^)o}xF78$w$gso?_^o=20x-}zf0%M z|BJt{8HDD4sBnj9Tgrh3>opF!&SZJj3}w&pDs>@hsCftobB~`x;#F5sF79^kIR>az z@5;QhO1p=(Q94T}oZE|uWOeqnW_WU>~pC zV(~4wWwA3i_b^A^OmXwue!tgvz&Z5#_qLzomud++9uH$Z+NPTAe;q{J8f~y#wh@CV z?m7GOc*9~{_1uUPAF<*Of6uvM6Cz^H;wuF2D>G02V`FFB>SIfH7TYuSxH`+`r`Knq z3HIR&p0fFN44-@X-6$SEKM%*(e!itv=Vj5p>h(Cq*t_cW?0rtfo{zDByX!99mvVsA zTRKeq+s^7T?JKr-b(zM$6cPn1Qm%Q;Nr{KmX9~lv=UeP5)6swG^mp|ck3MlzMtE1R zabiv%K*q+**YWxoD!Be?>Uam@*c$@!(7|U$Co;N zxXE2IX?pU$VopAWo^mctz;niAT-cd9;vB{G)9N#f-(gLbG4qV+rT9u2AN%+g9MdgM zgU&H$`Gd_>J!~#(omZQ7{KA*yc-Iz{+*KS=WZO{FPFqGrL=? z=KFIt=F2L~WgkVA5?o_6@(;G1q^OT=zU-hL@i9hucenpzioRPJE*(Uprz>t_H|Gi? zPvy3_L$0gu8yB;|T%CM)2qR&q4u41&M^<&lp^HK=8|)jwefEP18=<(uz%g>;y{h*z z!pvkIv(1wfmcE-I_Bl?aHc|g>c4$XWy|%lI1Cj zUv-=aa1wQQ>N!BE7-mWR9?HXYMN8j{1n-L|wRR)$W=A-CqGjE8lpl&Rb-hfbH#l)| zS=ZlBhg!tl2Y1Pg5CDhpSfuNcIz_!Z7!as@)WJT7rOb*;o;ZINSmcNjxvorit!0j~Sha+xoh}*nx<4%37G>uihSImG zgymrzrcyd*u*W*#*u%G~FBaQd9efIGbj@qmm&3V!PGo+}&xps~`-wVPw;HE<5cg3s z_5XNXHi?1hix2-~@E$8-Y9`&A_T^E!jY6KURVB-LeNE@Q=*PvQbSP*!bJZNqPZmtu zUo-Kwh8mVw3aQEmB4Qj>21JAs>PR1jnuiG0C+q9zS0PzNCql)to~^ipR$KK@)fUYq zZy#Gr?c4bv(A;%^(%D&?_O3d?sAtw7!-IqVn6k=j#1#fs-8H$+1(kxWbHL~9a%eLkC}^K;azP!e#KiN zRrIIO?a_5_<1RC?cD!?|tsg7T9^Y&d!$*EYY=lp&L{*tv|6Ju5J?fKPR z^EqEv$!g7Y{*>p4vnU1s(L`|;yvDCaabg-qR^P|gV{4~3YYptABTyvC#no#Qe=LQx zs-xrBIe~_F0CV_5GZg?jHlg zt`x=@yB>R%N{L(N#6?2Y?R0Umv0x%q#Hv+`8vy8N1mOrusybxiC?ceyyk-25gT69 z0OJjjMHA>2O>|+mqVUYGw;)zzUn2I%*2nsF_|)BeE25UI>=bu%l`CY~x9OK71$!M` z_f#3&k1nKv(psWTzWr=FE1X_NP=Pqz<1FiLeL|c%7^tU-b*HXzmU=Hw&9n5^a8cPn zgx9Yullv=W*SYK3)=}4~LUk_e0oo9J9R+MGzKs;ll z>eMrPS+y9oJ@B^Qphyv6*>tivbau!2>&RXnG)@uZ-Fs37Jm4unPbd78tB$^2_ zt(xF?N>DKC4RA1exEfJ=37PYO}g?sJ2fpm$W# zeNA^j-V;~VH1P%A6?3CwXjnY1T0G-{o|aSrzZJII*HHB&TAty4I?R@OX{d6m}6OSIKgaY@Sr?#2EfA51Q+C)XItCOlQA} zrup}p``FqQ{rVL9eug;EL!=(MN@RQ5Guc+W)*(|z99tXHR9Q^4URry9Sol>j=5>g^VO`$z+2qc>qQiZlM_BsK-IFyWXD3)W;&AXq_&~<0w0- z6V%x&lUcbn?I?9RBi3h^4$)kr^K9p%z4<_w!XC~dtk3)CR+(qGW~uM9KC-=BTKX|m z3H&E};hwq?7;#@Ev`@Cim3A@}4R6x-{u{5xvCU<6ngAN|^D%Gnx$}MORV%qKmc1|4 zrP8ADV6wkTa_m>?Y~qCq%!|61^24gNs7O)2x}9=YS%~kC{i@gMo_(b#^E~$JeJRA^ zNRJI}_0Nu2;7rf@4FKoSQ#km9W|&=>7ArJzo@rNii<&s*0ju1Tis4!NVs}qg@L}E0 zkMFb6P>U0Mm4A+{b;ea(kiR-6swVXo#xLq*p|A4O$7LIp)BWXHIMBtx)R+h6>)Uk# zm?$q|7q7(UuvvM6I&DOJiQ1QbmXkI6-l3BW1(&vFe>z9D%MMz2KEKgO^#8}aE$Y(wPzS@ZPLG;1cWSE| zuntGhtB!5$x@%hp0iy$9K(%NWp#tt<<*82=FKtc3@XW`by_^fhDo#CXrvvdLT*SEb zsK2)P%2>M+krPSI+r6W>c~7=o8YWHS-nVtRCTA}UI1TeqNia~~Xg+n%=CPGkaF{~v zuNI2LbpM<<)`vCo49;+tv7Y(Cuy@Vf=X{P8SKWO3T$!e)uvGB;eW&TaSv5@M*`6O( zr?8{vV-zr3hPCXTEsMuQ6~V?S&XG4DW0;_7#ye-K8#XbJI~ST_Ke}>{ zSXX}h7`Q(sNb98w!@zp(RYeOIYBCuH4|Tp`PkgV+tNV-%2Ao+}VT)rPsI#c{+A|8p zW9Esid&4WPs(KP3!&&lxY{@_U&V*g&$>Dx};A`iSr{#3|Z+Y5j7>kdN{W?)wMD96@ zUHfOB*@^$ym955Dz*@G#b#-((BFk9e3QA$3-u>p9{e+sS$B%6dIaL{p2hzfNCh>r- zHeCQ4sm^S*8U7MMwzHbbKo#ZQvL0L6Xk_Irn81x`w9XC#i_#Q8_V;-q7M(?x_vEPkOmb9NZ?Y`U z-V+Msa9&NTd1O!Sx>$~n6aXZtuY`(kCsl4iLZq;IFWf53ep?=;i@xh`3P&oJmv88CGXrTW-)1J zxqK@oF4-W4;=A!JuR?-2=+ynIs&{zTNfe1r>CCetU*0U9^K3I2Tb{iq%*sJx3(jN& z-8snQZ@!(3fGaTzJm*F6<<2-M=HeldnI?|8_+DN+$1GeH0ZSLSqxJSY+gak!Wo;P+ z;)@;m%PCPLm@aGkWOSbm7!){j|IIbA3jHsW9HYRF%S^6m*O19GYzPH05{n>_U3vDB zx#%ruOzrYEpSgooM#t7+vdM86r4u^O2z*c^bdDi5b-|K_*v?X3OBX-^yC8v&1_e%= zb?F-O@vy7*QNc%0g{iXN8M&&u;>@!!hV$so@vNEg>BLuA)Rp!5$Foj+pA&c%KJ8x? z%noz2bYF$=EcE-{Rrcr_@0{U)1&|-BENj`%BMS#Ij`bdA1$gIe*c*N5PP5J#SGz(& zSMhfhetIKo`HYXs`^UabU&vwmtWdNrB=9Xy^B85yxAn5}N9b6;0SxcuB9`$QJ9vD~ z&%2nmx--1M6Lof;aqUq}2tzXykS5hUn`j;gB3hRD%o-pbYm+ zW^+pLvbvqvI3_>GY}HU09TdnXG5$OWhl2az16(MA;Wb`8_H3M-I+D-xY>|`xY6QlM zR=jFuWQft88aE?<5ynQVfRrh#9RDbA5?VFEtiV+W9Z7U0e4av zse6&Vw>6H%1fm>L;4>_WT|9yv8li`<`l{0?J?~QoXLwCz%hOBIVvom600XH!+N*qU zWUK2^-y(3uji?b}qh6hgnHG}y-^2?P1{e)=)@f`NPDtoy+L z?STjA4GOgkN4=zV@ov>nbpusW?N+@jhtlg5%bsuKY_T1)6xY~{_N-Dn&b2y4b%_^u zVL;4iWy+h}sww`BVy6w;Fn_VpryjS+f}54db3O7|Z0Q z{A9&61|{F~nv}NMf$e1me|J*8plx`IvSD+hF|M5qzgD&2M!U$qysYEbz1D73em>WV zW-TAAxyoBr&eb>Oa;Dk6Z0mJCY%~<`Twh~f^-Q~)F}u$TYiD!cah`zCb;ZIRG|kso z+|2ww-t0V#tKd5CQIU4X`|ITRO;%G8jm2fL&^BYdQbl-dvsKfYFt}>o`s!&HHamU& z1o?szDE??2xD`Vx%>7~rkhyrWRStn`~3X)zT2bk(#y9q1~p-4^$OOxy_+w> z@$=YXswpaoho2IARqCtKAOB*vw?$s|)=7M7+_^s0H_sjJE$(nOw5Q~7hA46JsyFN{ z%8Do5LeUJF7-%V7yj3kWF;-6;Q>|EpCd}jBGe*WwqPU*PFgY)a;ZPw~s{TaeM7#5+ z$=Q}Jw-2ZLIC_jwx>&krX|sx5^TWzC>&`QK*A**9E~D-#J}x`bb-aK(!soj@?5gMb zxBM!yLopxl5gY0oJJl@fba+oKCu>7T9GI;#8o&E*&`=LkMmE-toSpo9js@JvCR{u- zVcI$<{R%L>m=;Mh)Qg|rk~C&yuOXKJr!IMByy#iG9K?@eKySz@9iOg7~t1z8C#fsM!+iBj!BP$qNuQ_({ac)v@5UwMYKF91FoLlgoYa)VY6)PUlP$FI&p7U?uCbXP|LqzyuQL}=IqKkMn>ff?!}XsoJ=v97z$*86hSA*GOUGf2MvAt!Ysy)xvZY6Xxn2R()vp4 zKx#?{PB6`}y}T>xDMtBxED=A&)>=i5ktwPx+Xau?7o~V+vG}Aw(_G!>WcC&xWjA}Q zMx1q7SA9{9pdT_7Iu0}^Th=ak+?lO0|8|1%(3!>f$?kFC%*F3At*rn%NOp4C2Dus%U0-Kev0|*gMc>&jAAt#|P>hJZq-v`=V&sI0|i;Vm|Beyid* zvbTtE=9gHtgSsZm=QIlhm+`MT;w)o`R1qgD#Syfx>?2}Q*GG7`_HXv4bVbV23b3Ib z=IQaeD1sflafIJ9doS?-iPi3W?_C`|7GHXphp-w1isNOAU8ee$&6o*FoaERHTkTAy zzVMI=b3oI|=qtVtxmIyH;RGJ0&K@4F269G?K&rX+JqUOyx47yU!8pWR7-sMw@7EofPx0|3 zmZpeuH+T$Vh7b{Mywmg7Y?gB#NoNU>=YUMeO}vJ|A`kD56gUm26x!) zHLtM^JMh3>OxMX&J*AC?=iv*_g$T365akWl9b0_u;bs&=d{+i*|4x;M7b4D3i+YF!+1EPza7K688Rmv%zc*@ zA90$zx-e{Qch9I9@WsR&8;sF5*(*!)#2&-^K@GgEQg#J@x_0cPpC*@365?Av)HlYgEZ8hI`37Q)_=Cd;fzC#ux)IQYA)U_P zxd_}x8}B+bed{yyTFo^uKIei3M2q;iM|O~v!UN{QIA@(Hal7~Lr~9{^!yCH*(<9V=iTg00kSgeXKyOZ zm~~l4HBb-MnKR^bV`<`6wx{lXo5eDZC|~hbcL7f4H{0-;tBmyYB#T)HgViuR?8-V} zPGYiK8EK#Iyo)FC^6a5}XAf*S%Wn4WY!-fb)=VcpXF_3w51Fv*tb znAl6t;};$%KBK!kb zTRMr)-KA=-dwJ$x93pCP$S|7OG1C6`%f%MIi_Njuj@Z%|exTOP=-%aD*K}s1AF4kw z^0L<~n3_Fj{)Hna9hZ;2EW^$FzcXM@_$s!wURCpBeqe8%g+WR94Gr;pzT{gg>^mP- z11gqtd!48}yQ(+Xjk|}>C{L)W%CSQBiY%U!-?KnFqgeLqZxw; zby&MNMnsXyqw8d#y8Jj9Ba6$2EMYO*%zupteq!4~1aI?+S=)nuRW$IdnkS1I!ywD2Au$lxi9#bPimD)u?nJ+5=Q=a|3>PH@cyyUqvV7ACC9>&|3F z-H{d+M{IG&SZueLcp(-hL~#3>EL&v>ac36Crcl6h!)&mXUzWwieL8G%2kYHwmgVE3 zqD+&;WxsGdtFYCTd+w0e`Kp*Yjythje%|BQ>5IIKsED7! zOBSc6#Q0LbW|O1#`I#l<=W|8Df~u0ek2^n^XZctxLRk4}EWYfo9#=>h#%?<8PO@yx zFN=%q%ooNxM}^aK4r}*tZ-q;4GiE-B&tl*GH>+0Z@sk;7&p|~Iw$H}SDi&QUV|sJt z_cK&Dy@{v6f1YDoK2{4COK>5VXYsWvcBLpwFG5;u+)1|E@o{?Gxed0RBCHgR#}-$s z(SS<G9??H}h zoCl11jRB3twr29LW)8W%uHF_yN$DJu4#Nf z!w=s0ZDwknuIj$5G~Q@eG-{;WC0ebLPuSUb8LD@2P_y)}8D+6(@jdHPy7*+h(^_5I zIDgJH`#JXey&R``+|@bdhiq>B#v8Gtp3>EQ#UJ83o{uGps+gs@`*-7WB`ap!iOEO4 zH*RHFdd6p-u4%k0v%TH-E*o(NyJR|NV5D)cWvoWm9gShKdA~b)?UcI09d!~gREU)~ zXS5Z2Z^nBrHm}@;pM3A%JnTO?Z;i57&YSTn$GOIM_m{#)N~|idaa_g^GsY%k zY?$}_WR0KZ_meGt&UG_x<^B7t@_NSSx>;x5=N&qxb=(mKQ$)sFab3~M!{lpxu4^Ug z>+#I3xW?zYv0&aGOJ}|r@4E3o%FgP&KO8fl4hS>%=PVNz2CVEldoMZPUwpD4)mCL?u2Bo8;|+d`!T!IocrdwyfW{v z``b~yEBECeJZ_!g@p6LK?QA%DUDr4s4_U+Y^sbrK>wFsHo3WLyubca_D9$xc$XWB{ zV>-BX+R=JF?{{BZYo0tA)5B|?8s7H)>?8~0`2CexIC)^rFypggJBa_?KksL0yl=c6 ztn23WT-Q$4b@O`co1g7$T{k-!oR>>rtUZ@KSkRsGdcB{;%JLpXY2j(SUWG1S#QRxb+3IjSCj$WF*A&hX2luLSLH-nF;tfK+@B}bcpez^l@k{l z%Zuij9ktF}w|@4%ycD`r({NiJ^)rjhnO^sP`4k_HrR`w7pM~>!&C|}y&F=4P=DPB+ z@hqFy>;2{}&$@2b89PU{uPf%Axid>=<<%3M_w!X*+6r_1%+u?#_1eLDJ=f={a=7be z=k0i2m(ji7j@Ro!*UXRtaOIrlSk&wEfcG0;ujl<%9xaeckh5mxxo>vpKHTh#{VYCH z5AJil@jRE_nCrdI177!(e}4yG%$;*bS2n)4$oN$-M6ug&1P@yPs~@f6T{f4v^h^>dBqp?RG~a)0CVbH=Ho zIg`0_uFO~Xvz^S(%kg$;#uAu1hbi@%4UZF*WoWpZW5XJF{oT^QimUNtGK9 z^iDd-j^|9;;k=%jdU^$`_8;G7`RJ)4-|Vv^KiSJeevV}`KCfqoe(taH{(4Qn%}(ad zex~eTYR;ld7VeoYp&~T(|!Cm?{`MV+sV43 zmDZK{I0bnMUn|uY*k3pE&d+wduFG@lbvsOHnrB|;NqVrIq%mF5-qV=- zI~rf_=aUrW{=O`mZbQlwrrPNm&+?Sz{{6WwOH+v6Z)fZEyg&BNnbeVRM^~f}z3$4C z-2QcEH`k>gMa!J_9Ztp{({zu5lu%iVk4{e0WqZ?|hc+kXCd``MoU>fwJp{L}Vtw*B*)yMFuo zcYd?^;g{P?KYjDwekHU0%|>PnrAAH@kna&HJ0}yQd)6{-FH!Ur(9+FW>n1C!6KJ+m-CoBuqu`OU%no`5}f{{QyIW|;ZbS2pvvpE)zU|8DchZ#S=g ze&LtDdi36r?O)%#@{Nc8x*_(zZ$E#tof5qF49vV=-^TxGi~pmuzJ2ARy}fM4?;LpR zWi$TqjWc3Pyzn^c|9bNq|Nm_J9=EXOF`xWwd*_#%kBhC#m_MHPKW=L|*&lD;fBFFD zKi+=E)7L9}xm}69jy!QZ|9{@*`uR4iC!VYKR@4|;o>HI|Gxb27u(tW{2d;64krG~ zHt!c37eUi69{%TM`+nqz`<}DPpKf#KjnB80zIgbHH?N)P7l$nPwzE9O-rH6@Q@)tgv)%1J!uwBNqU(P_N@RgO;N{jYL#D$iNvPd1*Qmwvsm)EC=# zne!*_jFPWrrT29{@7~kOXE*|Lu0y z=i5(A_~l`CeahNLr}bKEAD!Q8t$lQ&&s|%UdtUAR=<0J^pKa$>ou`id&GzcYTm1fX z`~JoDJteVJ@8##YzPDXb9qluhK5?n%ph{Jj_lZWm+dcv6^BGmco<8(kO7)?S;Hgqi zMf&`m?t4#$RMLG)Pk&9PRwaB{(REGFG4u>o#?7QRpu6fl9Rk05@AG$_yy?;ONe|t6 zpUE>nd)R+nSCwjs$|3^bU z)U(y!8q0JYtf-&j6R-B8r@)r1V5w&*Jw0TXZmGL^@?*qvIkVSAIkr@n$QM)&jH!%Uq+)kWHp2ULW8HUb zFKhL!>Q0ZnEQW^hZ_$4bsJ%BN+z-><3kD`HK|)VM%LhJT0PTJHETm7iTD*mAJX4B? ziz`p!%{AGpY#~C=vzMG_tv+edYO#Rl`2DU_zsH5M@G(|ouXwkjxGa-ozx*;^#W$8Q zSI^AYI&AG{*UTM$o^gQv${@`%o+*FgUz`>HVHaLB7pAhJpS**w%5UcJtg`1k?)1Lg zxx9+^jP$7n*G#XtXPL)rWxu@AQ@<>AR?bhBV(I;y|E)evA;?zz*z>%+TJ{WMM)-yT zD2om1cy#W&-LFna9$Hz;91COTiapgX*oE7a!F7y@q_X4a0=|WL*Y0D?lQOyZ*uz$Z+dfM( zG4@y;+Pj?n@yFP$mVP|Qy(b*pm-bc_iCOtpl!+%%Wo-X!6D#z)oYX8?yb4vW2heC!`}IW zKOwj}BHd!V&n%2KgQ0U@EAn31nujTJwXJvdSvUkAF@#D>1`KMrGsj|FlKK@9?o9ufKyg{Tx0mwh?6r`MHG|IxxFju^3`+WE)~7++}#>? zJ`@pz?X>IPx?k-KHp9`7vbZ@UK{J6 zS&kb94(~W_mQ>cCE=`PxH6O7@x8lw%W0V*tHlr8$}BUl5o2|uvN509$zCgX6-LhNwx+qT z@yu_o$DN5Pq?9yIyA~$x0E+5@9kWIDrDNQ=5bbWK%Cl>2ryP>bY^HPB2t{+>5o5pt zn_bVxuAN-hUr!oO+shFzvkVjMv!Wf~rv2)-)O${=NLcZET|3<`LSUF*pj#~Pw)2kP zoVD0$R6O&>e9b9314?dUz_~ysggJ*$*Ij&WzGK#tabUaORSbh=sK+X)72X|>*Ogy$ z;^QoN96!d|uNAPWU6pIjEWVCJ*p0U)uh`YCs6Osryc^RjelDV~I~Y%~*vcPE9Nr_I zr{hg0VDO^NDAgivR?dMVk%b+r^E>zA#?=#*y3dmp{r-=*iw&*ZZD6J#+orpH97;uvk@wJW^zFfSj>95phGcQtX=+>-!lysIX-i zd3bPksmLa~R^{XS?4qbXuFp^1ld`!dwBCvUy{751^$EF?2V082YZYwt}+(G`^ zH6#7g6VcVzfs&NLmrwY~{a-~V+nRJ;o!Bx~l}$R+s?Id+cwPVUZ#sR@VCSmQsYa|ot;&w6 z-(&5VYQk`<7P+i`Z~cV*bc3&Z*z%xU{94a7Zr5UCv&drMhwWhBR{xC6*M6S<$7?++ zxIdn_HxIwBzb#G8KJ9NyV<452ZWj*r7fk&HRj<@ajp3KxX%rvzFIShXM3$^F_qhXm z`HppPkngQ%yjhx|(bhFmJty<{cb0UeS>|2ixOA>*yl!Lvu2;=3uG!z~F00Nci~4t? z?3YPqbk@nb#@RdfH{LA$yVYEYsn%@$Mw6O#-szcDt2M4u=iPR==Ac21=Q}Gj_l&c; zcV|sk&NcnJ8M=3!j7r@3)#X$xyRU0ozq$MOevT|{++8r}-p2XD+-uxCb4_=-5;w2$ z?y`I1?8+l^U%tztuCnILVW0Ew-nHAF+Q?Do>vv7#+1q&kHjf^RdmFDu6bttb zC9$qrbEp*7xV_bdopJWg46K`Z`nNUbN;b~D-DQ=!OFARH%U`Fz z+G1VVOx|r=7Mg$4o^xfNrl>}*yHa#V zS=YZCZ#Mt#Id1b%&*tnJclB=Lc!|GyHTN}#`8sV{%zZ4?AvB+v=3V32*flfG*Jl4v ze~}3nQlXST7UwNWPZf>PL@Di@4)r`zf1AFi_WYFWcXk`1SU?>f-X# z-(;Gux`Mi6j_jN|^Ug_!Q z^pwAgbaXb){rf;~`+KiPe-G;Dv|elNqw{;MwU18pxof}X-(>Q9nC-E(o{=h41*}_B z4cwEMo?-R>bSDFu_vv|1Gx~g(803jiGN>ui@;E#D#mJepW_wv4d0jlbJc~GKC*Kn^ z`{!-Xyy|x6-}!wKXK;*$$NqKK!fyZf3@p&6Hasn=C+$SyHR$L`#QL3W9cmdzAHEZV z$ocK-(15L75mLL#{Nl0aCCB#et()1!#(aslEQURC)Nk9>1@~HH^~8zAc5F@8cIDt# z?(WmqgJ1rJvbys5N>s`!=lt;4!?V+|w`Y!a%*TBSre_p=S_T7WM+(CEmL28m$&PH1 z!>~zDmRd)&@^f50YdZ_fb8hpIm-Aik_OvE5}0HthFx z`P43)8Xg%;8B4eE0z@6-;>gRF7CXB%gm>l{czTm3A%F__+MAW&+fI6Cu;%okHjJ{a z91%~>RYj)#;>lx+k9-^lFCMlQpYSq|h+{joYWir9%x^JvC`xHGM&H1Zy%{l+Tq3KC z#qqUw&UMg{k1s8j3F2b2Peu?S;>-#1SGceT<50t+Jq-;R`G7raWVPL6i=J|J6>QI^ z&!6Jw@@X*$%a{{`;!xPgFQJ(xfPp@@kmk&4Hj1{vF0VSNvLl@@o9?qCD5czU06;Lm^Oe!h%B=ei#Y8?i>50e@mfY&&15 zby}$th!&mK8d=7KH|Wo1x<(961j7p~$&6;b6&pu3!yTqe;aZo?A9tNfWvpk^@o>8+ z)5X`~&w1cqC(B>MVXs@KieYHJx5^rVhe@A<)I}ouaFvt|K~GN?uV3P(w7dpTlm{em$;PgXOwMsVvr4JGqMWx7b=n#jSl+ z|I0tDy|)Ug-y0Kel=A4el~wpsJjx%wTsJ50ydIB;T5JgoooZN^+TnKpu4=D(@7~am z0)kQs3v1=ukG0aPp1v0};QYENSVqk^{F%{2Ro|$H%BNEi#S?fFW+8VJ4}ZC;4&AUYOq*%(avgI_-M#MP z;d)GR;q89DtfB7@7x!0-z8@tV(QUXmR`2(RtbcG@6&b3>Yo1LUAfWzUfb$>s_>{Jy33~%UM3-y)kJnNq&hMDt*7MR8*O&F(%ecZmb&Ar9-!sLUR?#FG|SYX)M6ch!2vC3BnIb^;coNg>vXJWrmQL0p9I-4Q05L1=RAc zxo-FFS)IhoA3qk-!o12iVa<27PfsO!nyE&D@t$$;+NwEufPx=S(rXa6o``vZ=LE3W zQ+#__A>9`e?y)w?W+$kBwz8L)>C+uz%}IZ4`(96tZkQ+ht`nzf+Uj8=@*UPnwHqPM*P~e4EUiPso%bXzwb@ba`7&+x zA?mm+j^}0CI6-%fhcL)wWlt)~xH4j%`Y;yX-?Q8IgJb$f1g4VkZ$0A2PttKXKCU7> z=H#W)W%9G9pp?S>)yh-1@l6_=Ugs_O4R_BI-Kp>?eTepcO7rz=We9n0|Hs~5ucmt$ zW3UxA>s_rXm+w8pa}E&cI?SWP?|I0X-t4&vtdDNpW4k9Fn7YoQEMTrau}RyQUG=86 zha6h9Dt)lv{dllgVHvxMveD0-9n76;O7IgbG$oG zZdDU;%Btyf9r9Z~k&V=O&Z4V4Yk-U*_n6a;yt^vqp50b6!~Hc-aey zWjiaY>9Yh=xCY7wr!h)TKjtd&=)UtR^vK@JD)heUI-U|iJXzi8NgdVT%;l~*Wi^TH z1syy;-sOMFV$TA_tX|8+nsxZRPiEeZhU+?1EZ+|rsyq1XUaGqL!b6`V)b(!Ra z(Y^I_amG~5X=M1FY~f#_IvxpOIK!;dCln7o>5{c>M=%7;SI?UDcn+fgCHE)~!H;rL~ma;e413*%!R z6?w8ynYldgEXDD0$T;`f8( z*RG7RI>ktH#~8(*KE%iR#I{;O4(Y$pAseKRM!i5+Pi!%Sf74E3^|gKdvM98-PnBK$ zGrqX4?2J~Yt2}64Dp*b8nU!~-1VibpLpJ^z%@Bj=!Miigt3U54+NwtAXBeyNf6QB$MC(}&Ir8u*H$StO8j|tpnGnG@JXftUpTw&g zb=o)rHpX{$Yd`YPjImWeB(`j?)vfh9Zt-yVx~@m>OVNvix}h{DxWa%)m8oXr;agWoB(0d|A%PU#<6-U zWdOYw*+cA8xuH7_XmsCOaVK2MK-0N$SD)>D3XZQU(|fF&UaHz+O}>{m)QiK(@&T4! z)gHb`9p0Wrjw_M+6IPH5Rwa@;z-+0KDiJDLy&{W^b+22A-0N>&_KCUs(ew9QJJGQ9 z&*QZ!KDn7L#x}4krg~Nl{g6Jrl-IAF=(gwf1Mu_fs%0ENd%lDzT>1`i!|$0F#L>^}SQ?lbCqb+C9f}o!&~_)p^z%$ED_n< z_woN(-hS-kY?h_w>r)l=I#raXTr`@KhBC;j?sI;$mm1k=<2#)M$WS4#I18g{*QM~F z-Hhf+&51iJc#8fMR9x15_g6=Wh4`2cs(X7D*|S>_G?kyz;3bjf-H9{#(@E@g92OFf zt{)#e9h`Em6LF2=G&1%?aR_Z~+l=Mp3VeQ$94tKL6q1*$I2&k;QU$ z<>^DHx}D|he7<@Hb+6UQOEgC82`_2*&SmN>cqp#Bj^cG{24%cg;1dH-D@0<#^VG z!+*t_`C_%Ad#yZdXSdf8cx|zn#O!>fj{4k6+KoqLZn{*K5o^P`qv-ks8@)G{@LGy> zvNY7x>t9#VhIV9cx7mB9=k8I1-kUy3(TNFKi$;J8u?Gh@5MMxm$my9+&wiJpQxT|R z_DbJe)w}CDxkYu-r>1T}a>%&UblFS=-A{FLf2!^tk&&0HH{vxiyr&8P{4Lr&$e4Jx3Q!ma6B%uBoD62?H*4U^r^3 zdiFM}FY`Eb*f|Xfi;y}hD6Irb)%`pL_3Rj}lt+2kf2#*WBRRD?j-&E**sBGP&^)Iz zilVcaVQ+Zg#cGUYZ#@+jFMDAm4Dk8u+lzOcvIvJ?nwzSpzMP$N zgx<1Ur(RE~$d}XbhO@~2Iylwj_HIw26q~vK3=Q+SoL20<%f52fvc@W_&chbCuAB=g zVchfF{pVN8Ezq%4C05i&TA#9qF8_7aHT&ApFqxmT%WG?2#tpHt2pHdrMC!V(COe9X z`d(+AeQfKc_2mhy@DkpI_j-sBWQ{sRWsC7pIml^=&STF$#=()bRT5<&_!CXl9KJ(Y z`T;^9IShooa1~;mFLb-gdAA41Fai~DCi9%x`q;C3tcUn2XLS!Ntrlyt(V9+E{KF9L zED}>03!(0T{PG;z{Hxepc^OKmlcMt$-=5h^=@d;Y!|2%??pnwHg_|yh8FA;-=9HmR zG{I)R6ko2Ql^bb4BIZ^kWbJh=S6{*kJwF&MSOLl*wn8`TvXw1aA*U4stS`dErfX)TnBe_$jqsQaI$Kt&-Vzs( zSoDWXHJmlrX9pBmbz8QG{G3*1-pLvWr&MvW(Y4 zhx5%^Hi&=kOoXN9@x&n1?(G8N1_#xgEIzaM2nUz;ikJJqfe7Z==V`C76(fi6{1{ev zdbBOP$qIG0j*)QbS(fd`?hy&%^<}k#nBvc{j1@#&tTx_N4a+yx*vHjpQsaYAsBD^sy3Z!GA%;m$R8Ni zX~=6;N3p@D>X+vr?l|UN$`G&X-L0wjmAH?EUicv(!O{tO@{BOHT;%NuLJ5nUZCUX+KIdTLHiBg$;fdfpWWiu z&O@a4wg3MH)WhIqEL+8+&!y6$z-A0)s=cO`p=xEZrN%HYd+Ud_YIO%Se_lg8MnU(D zcJvbts(#bX>{yn4swd;{Gb~)HhV;jZv%Fi4)AJi>m~(e`h~x3}dZ(V252qBkvss-` z*HGehRR@99DYDC%wMSUEtS9kB+8hq>PTf2Bqq0QDswd&2&U&`G#%n7zQe;j?HHLEq zHp6hY$Jj)e9LulwR-?sLQ~v{i7*WFS{2XuS5)Ipu|4&J=&t`-??(N=Huly%WAW?i+w7HnuoX44 z>=pCnFFB5;$)8l%hkJTP&fA8cWWj)swLAjX3`y#XRYArxvri3*5?=8i+y^E zvNGz2sUK1VzQ>Sq1noy@U{m%@*7I}JRD6s1u=U!7or?z7<#Sw{PLf5AbxrZpcV0X4 z@B6^RYufvKJn$_|$@}T6QQzuQ>Uw<3&vJ2@{n)qsZ?1JBdvDiggi62k&m8jHhfz4gGvlS$fL#~^1B}9P_E^8_*7=t!URU9~1QD-m zZyiUvLd^8(#B_t+g7Nxdu!IX;A1;e6?62pw(5r&dFY8WM$uDMBXP3 zFtukfm@3QP>fMlFp7~-iEBll)FVzKFxdUghBbMMbHuL$i7jF4xuW{@-jL&tr5WjTq z?H;~V4cG@0@ezNNop_wzt>M2|Or+uZp0BL9G7`7#`(WbA=*oAP-P!WjZ3xcC$GPpf z%-ftI!2b5V#y*?lL>E?^6qc~(TWvnhZaivc7%0a2TjJ2_wahx%P2^J#iw|BuyV(VF zh_lhK;no?d96MX53M-H}85sw>ZnogXm-rXM*(*+5F=h;g;lZA~>inSpIO?iJu#lPJ z%wdT6eA{!Cj@e!}TUc?hSX^MUx;N9okxN{aw!jeML3d6ax5mo1RoCXn3Oy;p<+phC zI19^-?7(LJEuL5-&riKwwyLyi6t@_RvvrtSZC^9cgAC~h!eiu-s|kfUa^IX zdfJ%1uw#s$WjA$3d^bIVVaA?Qj#_4&oFn$|dG^M15Pn`^K1OY`U+1E*a{x-TFOVwau*Rh|qu8DJQ_wI3KV+}t}|0rK#F1{_xVlFw`3CMhV zi(#8D7ZaN;9X1x1o6Bua!NYZ4dkN=uWzZ0IlQ;Em*uoer&Yt&d-%^u3UbJnk$)tsb=7zGkjWiRw#U`QT& z*$S)0rjveMdvSoXPn)V&VhHh;633x%VpsSR`!4>)D^Tj%VGYPq4T;Yf!v6i&RoCdf zMC#0RUA5hlW_Veo@fIG#uEVo*ryl3zwNx$!IaW8X^W8GD^Lwq7xXz3`5c z9D7}1r*L&UdmXCV~) zH!QQz6f)W1lV%U^IMy1n25m2L=PKt>7Q#E%nd8#7xlbJR)o&=Nuj|;=x5e}Ma z!70+m)<5&^V|y?CU6$jsc5VgUI8wj!f1hR%547sAm8i_Vd|7V|y2gI|=3Y#6X6+uQ zgM~}|8z!APgp}pj10T)?2IFAfg7T2tIcKjq@QWF;*M5BA_1S@|pcm8Jj)rS{VHaZZ z5!;URI{%7F*4jh1Wp5g<+?;jwoLsqbcm5AC$Mzoi_foNse|a|T!e0KZ^0M;y*UsPo zYVut6+FzV8noOjb8DiJTQbGOq6c1lpOntF8b`T#Tkixd^#43wq;5cfZfnB8s+gZnE z@_GEY?6oV1u)^&gj>&wF&73Z8=A*PBdq>ySf%@9!E!R1F?6rUH!;`V{LaSYdu(7w! zN^1Vh-pBmV=^fkagdw0@GWKQQbh+C|e zKCaTpzcS#_UrUi$Aef%f4f0>}RilW2u?yp>pO)H?P2_2|oN>fsOJg8W)7M^E>JJzPLAn0jW7$hu}$%=c^KRgU+yvuf8Nwd+IvV*GEXqwHgi>2X# z@C&hn2|1=Ju#RZR=ci_T3MP&f+w(KVM8@kXiI-=LVyw(QJco@2x9!WWcuWM|>g8kY zb8onKd4_v!Q)t}=4W z#Vh~Liq{=X3|#L)9*WuL|FZe9s-A52oi3?XoL+ocjc?Ji`OS$FNZ;y%@SJ?vC4{Y&X$SM>tFLC|!vJ=fqx z*t2^)imiKs8`3BpbJ8}0S$W#b=Y7i~%r3RwZ)nx&!Rb!3UQ+hrbWByZe|551CJrgK zu@?@~&YhpViiXkj=3)KYGQ^R!*J`~Cp%aNiMR55{-l~4#+q%N>h4JxPnT&N4`*o8k z&Q68>sz5{7y*GfZU6 zHDd267GEphmuKMDR+0DVKfoF=c*HBw7e@%3@aFm-{$3sHy)u|}S(nW$*>@9U41E^1^Yld7Yuo&CT*!g?e0_>0UMQc`(;Te8 zPC1)jj&t7hRO{-M>6cbZsZr}P5f7&(`cw+fS-0x1eK~nPUaH0^uq#!QwU|<^nmTXH z{mo{+TdeKAYsJpqKKG)>n4aiUUd~B=X!d)R&RRX-S0 z@T7XTPBjMOPiS!dtiW^e8uY{o`PaYI5X--PCS-q=xt&#?Q@Y*SKLo{A7p)#Dwa%N+ zA^+JQ{TbK6BhQN`nPQljJ`jb)>qLsE@D9I+2s4S!ry=-SV`iIpz9&`uvdqETA-)sh zQRgBfR$=918qR6B>NXtzVJJ5BEnZVa)<=M23?{De|1bsIr0pP99{4Z{XxR0B)C9EY zrNLXOG9P0QUd7HL( l)K9rL%wmz(Q*A88S$(dLul?pjp8%8hLFU2w2{Kpn2!D4!vI_vPWKJUvyRSSgh1WUuM*yau7_IpN3T1;HcKh~w%QV$fFy@d(8vb()*n_4NHWOKDG#s3tWk9FJgv&XU-1DI#_ zQAL6oc$Lk00EgVlZO6Yo6)v3m{rFk*!YF*k82kho{DzIIj`V^sGSs@x_sMy$-wO(N z>agO6r7{DI$}VNhRE4ZiO@|4c_v`mnUgG1BTu*|h_l$ubaL7^!*nc$BS^V)xyeztT z&aig-xM43*7`<=;*u?^nfXU3q*=^4Mx-u!W`gi>xS z@r8lqE4#45Ld7Tx@8a9#yXt=GZ}~XpPKk}paw_aq4IJma$3D(xdz`P-5TABloxs?f z;;9C-YTXr?fbQ9=OLzAqYWcn@k5`A`$}FkSr+E1?Q`bqW`(b7Ci@Yi+tQRiouUH>K z<-hS=y;{3n+A@~GFJo^g?z3-CvG)%n^NC2>fC__FzJr_m>~#6cs56)fBW4~yI}w=( zPG^jt;iuee75_5QDz_u~I9orTm5UE}Vi7!#&0-l_86Eb3`x7mE$wYXPRBs%z{ zF6%s1z-HK*-sC;(gs~~gvd8!jYB1XB7vpJ|+Gm#(YEP!l{JhT_);#hvyrvs4m9>xl zJ_>}xva_dA_xw=D+|DLnt?t%Bcj^V(Tj3fPm$nVUt}_Wnllk)T#9x)COd@x-Tm5|Z z%O(5lC(hVGFX#1gpZ&vjIoDP0I>zy}y~mllyeC8OnZ3)>O}qKCeywfMoHxPyi?L z(o!2D*g46Kw|e>#-Ald6pH8^^#M5yu4DcUMxw~9E9G1O2iifGa@u;~lN7i+ntIBuB z*tq0{S#!_MSq!<&R9>Act%gCIrm+}1)c2I@Ls<;B(~YXn)MtvJShkX%SnN7X3i149 zEWf<2k6D0ac})fh0p&Ifkj+M6vMcf6;@+4=_Fi!Y6QVC(u`fAM-09*Rq4-uzWG}qQ zVLZ)q>3r{r?0h`-rW4dkG3|%27c%7l(Z1}Jo5Wo4KlZBTrdH#X*R{7NP1dB>ut0xz z!g-egcwBso%qnS|GWdlT*M@!eo5TJ`=NTJbc3x*_sD@2B&g|FPCx&PZC!e+1Z!b6# zr;5sI{yjfHEtIl3bih#6>>kasr5)Jkb=Ek-ZYMX{ZvLjnOW8qBTWppQ^Q5S?!*vEQ z1wm)p=i1)Ok@v&Ce3>qF%GO{PUuM~4i*j2#IQH&iEF4=)8}JL2V2#mfxG1DLV@ln1 za+d6|6pi?UWZ$#aT=L{zRlxO(KLrcZNAZ()>qMm#&B(TNB|T}}E{xfi*nuU8Ua?T! zQS{|q9Q?TF2J@nze1D5~JC#d&W7vG_T(PO26fZm2ZmceS^{;*H?Zw3QF-$BHdzL4^ z*g-MszVk?XjD@VVzxfKgEKBE!TUIR9F5Zh}yX0M8JhfupPH~{|Y@;@0G1sj#@Jc2! zcI@4;%g?#*+TM7~x$~zrV=Z`7Y4DxD@u33;scE=nNf8epgI;sVzx5sRF22Qe{C&H% z`N#L+G3;N4XBY2gE#_oFJFxnA*U2u1Vg;{d3ESL-+tQ#$_!W;ga%}Ap7A~y~rLZOr z>VZ-WRIUtH6~=3>V2NtI7@zZk7ceq2alDEVhxq_`5D7?>Zg6 z!ZC}<^4|N zl1t;%xJ+cq3o(X_fN+?<{DaTrhWMy_yedquv5LGBcgZN?ZRI=j ze5x>Moe=!ohYDSh7R&dq1989W-`U*PUmI$Cehym$fi`MK!TA-M2Ka_oxA} zS3J@)>@stfla)_mpJdbzA>{~vQbk#FN5ytA(-oayN9 zsvmnw1&l;TEd)TV-LPh1l$}Q8 z5fN9Wb?RfQh@+srbC!LNP>@Bw-(w|lUnp>L&KswR+OlpO;nb;EICdH`u@QW>aNuqu z!?W@-bUNALjJi>ENN!=-Smd&Xc)3Pkmz~xjv3D6l6s(wY4Q8ySzs=fn&G_7mn+HVB zYiV4bxhE`8hWAtPI7#-F1Dt7*hFhnPkZ#rerG7*lo#47orpyp8Hx}E%YHHqfuEO?J znaB9uD;V=1w+`H=a6nP$Q&EmJ;a!BjQO4tpX zRf*eCPX>97op!l8A9gs|X`R7z#&F`XZ`Giq80WrA74{M|WUZczRp7%&PZOyOmJMQ@ zkC9ugHPap&_or?}4}RBijnjF+`PS=#+EKUV7qLUJk6&RY#hw>=)@xd4dA6RIYoCIH z(YAi_Ev(e3RjY_&wy{^nRIBKSPQTnWl$od>dt(4`Hn!1Qvb6orm^0O@#x+l|_fj?9 zm$oTG)Uof}A%ef_jn||1of778jJC&u>z&K;qigtb^pBpZ4rvU0J0m#BzDDE1pVh=G zJFE#OGK3RlCw#a|ywfQZ^1=eEQfJFv`rP=aGqzdkzvh!`6aHPP*w`>;U566GppT&xEX_NZ1 zm}bXd%IUcyT$OI0pk$skjWzqTrW zE+X)XOo+27-NA_bS2h~$E1E@z&g5B6n+`7jg}-B+t6wF$t=j)B146A|cZAnd+w@s0 zW~p54To#&J6JrclO#Uefj+x=HrJ?Myen^L<>1Y{iQi^$uW&WGbvG5NB6lqy&6_{AM z(QDYLf9)!(@^sbe?beP?@bi9EF80okRSbAngmpfm$^NR}VS|^4*{CA=Y@wESRS-R! z>{QD_{O!8i{d=j(Q#Wi#;X703T~$l*zza01ETGi6;(_dSzTzTXlx^W1X6j17L+Hii z=T*cJdPnI_KQ|5wrTkW1#aq*V5=YjRRqcZ1zQZ|7L{y*1+grykm|*F3o~ajLueW>n zQtiH+by*xsEsH6JK9jM=rrLZ8CXTd27Qdu>^SVkWWX@+)@<-36d1!u<(oW%7-tN=rhU#EG!}qQ&pO%UF2FIow>aJq|J%##4lLfr)8O&%L9VlMNlh&n6WFza` zX6?+rvhlLldThfsltZ}<5_(5&s}G%zAZKi|leEO%yX?ovi+f{ZUO3NgkNrED=hDMs zja~PV-HJ8&ihAt?>pSrTKFCW>y?r^^)I%OftMT885!I5@@qJE0guuz$bnlUeuk&$i zhE??!JHz$?zfj_ICm&P8@~YLx7FZHXsfzX?;>=R5+!%YXM4Wj$NBkjV-}bmUMD3He)GE-lwf@^YW33hy`RV`3rWf0Jr!9ZdXQg%22TX90+^kyVX1YYM)v0 zG0d^9*qdio_8?n%ck*(tSR}7~h`e0?|GEB^)u?f?H)kJ%W0~n>JDJqIcs)jgn2sx^ zv%Oe&{>qhehXX6b>U}04T_M_O2qz%Z#%hbfe+-hqxU2BM< zO|Gid-~}-!Tz`D^~b)=-j$WBkwvV!#yN4Nkgv&1S@D2ut^hnL}Cu9Njr*-yj7b)Ms6e&P>V)(WXjDB;cYl{;}~{v(W8a}N7d?cJk22jQT4(m_>~T+d`K8#U*zj5Pa`_M|I*rBFm|2dG zH?LL1wQtQd8N<(2f0i|;hvNiYiCbi^m6wgNPDYrsqC#al-_vX|FxHYe<|;8f<4-}t zbzZ(V9l>51xZVc+m4DT1;-}cKPweKazV3KV4?`Ro&%bn$JmI>zN+!30h<=KHuT{h+ z-4h#sb-IVP>9f0V;T(r)MG0J_dtpOYlj0Sx>$Hn}mD9wWj7XQIRELkPBM)h&-|U}fp=^m+e8&j+m+f}Ox<;yB&lK7E9K4`H!*W-&Hrof8`+6idK~{on{JA~M5{bD%%$DdlFw6*MF@VfV)Hd->;B zMYsm~;*ph)F7>)=bWfnwI%1Blz+|f);Cqp&djcV=Hzjw3{@A5;&11%;J)NC<d8E#&xr>)~+e$NWt6({1)4p!&Y zPCFAGz{ZVu)hRSmq`{%nJGS)*3zxR0!kle+BK{A%{AGUeCDXA)^uV*xIW6zFvN&~B znGP04!SO{k%G0u1YNmMO+w5gSDk_GOQ(Kh{^*mTvHZ3amTqYvQW3vao77tK8VxPn8=lLc&*3x$!Rka_V)B!h+hss$n@j ztPWC(u0E=o9lBGX)4ct{Hm0gRhQ8@d*qmoXd{+=3dP;Ec^nnHIS?w9pq)|K-4abA0D z>v(Uk8Pf*UQhZqa$bYwWZeF*Bysx^9UcgnP7v0 z*d7*+59>jushp+P-nk70Q`J{N`d$^uTFA%#Q}eP`onl0-!pI)_hHUf3v&S~YhB_AAByQ{Z} zo#qo9kX&706}(=@fgN_VcGAmsr`*vUXR}Ys4 zllS5w44C?pxsUm4)Rmv^JM!+-H?jcMOdqmQzLi6Jx{7V711Cxm&XunFRNv(3clr2v z@iylT6V%Sa0E|=iMObm!Q}rs6=cD3f81C~zwA#WjEKv_o7ShvgG5i^V`*ciwf$rL4 zx=yow-$Q+a3F#VVW=GDkPu#_7ouc<#<+SOo;RV@&uiUvf0DJhf#q{r?!(I6KHlKzr zG2K@h?0)K7Cy$l-{0_X#=h=7xcVVX)i_tuhm`Z?}6f@Xu{7NO#!0TzG9HhE=o3?$7 z)%@!E`C7G&v;9owKl{nZe%yZTYoIBm>Ths^6bTRsD1EN$ePrMyzIMpow?SHjU^vz`TrW_KR516Fi? zd;M{(#-5AcsU6Hn(-b4|1@^Yn;WCITLR@u=wK3pQ~(5HA|h$@~lc)M$*IWDt9=M&g2$b&-9o+0@fAvVuoc-oz1>xtWSug806>dunV?S z)wD*RNf?be>)H>EfmLp|w;Ys*dH23lL#RzV^OT6HTZ(nlU*gUg&GQI0=_ig9v`}CdJ28k3A6`97V(*&2!U2LcpWL$U_y;ITRX!QmL8H?$n z;%vnpBwM53Qn}sYKMa-g+{}h;`aEOa8xLd9{Jy*%CgSp2F>$OMV4}{f-ix>|+r{?Y z37zhaMPPg|4E0`lXY7TUueO_q&!|$^&R)I~XU3t3cEED@9zOfzU@?}xuh(gMzK4es zAWGb={LH_0U~i+;@iL^~q2rhfSNn)wxvjs}GTjD#(|v{qoa{R6P61#!%!db34bU*Q zy35Jzu^PVOv{0@ll6#!rEw(m0T=f;BO+|^XXbcQgF4i@|TiM$fBy{TbF!q{{7uOiO zFySCS6(D<-r=Mc+)NFo!QV%@&RjLP3j-{&0Lsx1C_F^gVQui0z;Z|52JosFTuVF$K zQ`|E;)^qLR0rs+iHTyl(Nnc~GpoQzM z-fnNv*8KGys0CbLg<<{rB)A~%XWwXu){T?%UGXJ%E&KdC-!D~c)#_L0bGyyQD&l21 zgEqoz`LBI=t>(ZC<9mBcUD?NNHXr5X{zgZ63m(hC_*PD{Lu>PMPpxRf5V};@>*l#~ z0@f58bq}k6=v$~==oXn(BTMBDdfhO8%Qq`Cmp2wuu)&J4nA%L7@cGJq zhlRCL-$ zxR}m~e1t<=p(h(MYLSvHW4G&YZq;k{jByIJ*?H& zbXUYxyp6t%<>gjWe7&K00MLhAcW5wQUuZSnR5AU`rUa=87 z)$tH5&0C9|L)B0wVzC>Tw~9y`-WPA@gVnvZ)(N9;%YO?e=L-<9vQAc6*QqKMs>TX> zJ9e#x-rB3?mOb)?=kz>AX9nNZ^WHF9eP(Z?iGey# z#VEhNK7;6Y6>)DZ{#ZUd)F`jVC%j+(w7=(!$Do6? z8u(Y5ds-6vh@C8MO_HvyCMf`85dWj8JsGnAIpgGViv*y-`y%t z_`};g&m(mTWK+hTx^Nb4t}L0_qzjF{8!W$JtTe~DOM@3qNJT;st`rAkw<0rG)nhgP z8rQ7FTl;fPA7YC&y@Sg$I!Slh5K)+cC3JMB_AGHab*k%5oVDKN+e<$ei(1%Kt-l6c ztK1*e+1Y%)F@Xo*Q~dXi)PBP8cqq(dgYJJ=OVv9?LuJ-tX}k2f+srF;@0A3v<^gX-==#fh^zVYvq;<7#huS$&kRL{c%G)G+|761mbo#`4=|U# z&oh3k{t?6RD^{1O_}(x1ZobT6zdn-g$(QZ98^^r|O|S6`tC>F@y~amz#L?+LUau8H z<zjd7Rt$sKv~Zix=hITO$n*mFDw5uBy|QS?D4?Q}9G1#qh?jPSnb zgSJ)KgH~WIxI@01z0?Opk-zh&AGhvUF;X?}$>jYwlpXlQ$y0 z!$bNel$tTjQA%c1`rNty3fn0lpT}AV^IjIwY^ET@$G#1 zvK7!8^5|m~bY<_o3ZkjIfeu@{w=A6prjcjw&#l_{0(B;a%2lm^e=Dbr+z*OBHEy>% zO~b7gwB0m@7~`Y6tJ8|V*r}A<^;zQz-NhM|$QwG-rySj3rwfZeGunA*iVZax^u|eNiCa+-i-ZA7qG@bfxHLi2XYisLwuiCl^ z7JFD<51G36O8JBxX9-K^E8WISWxCm*G>%d>7LM*-V;(Q_LmcMMTde*5d`vAwUD#6! zqy6vX=LFKXUyCm)in?%n)UC`A<{|2iYA;&*re3Ym75veDJ&*6bcH^zQgmOs-(gnR0 zWg9-=4?Go17creh*dLQ?bz-Y?2X!^|iPgKsQS-dD*IKA7(Ty0}_%mN+Ew9Tn_wG@h z2wpz6CtLA}IjxLvFo&%jv=?7vGb{GzW9v64eQW;6H}W>v4rxrm8+Ko#9pA}2p680I z8zDZH_O)v%uri@&GRIDqsf%LBv-#b z(zt$F9IM&g&QuWXBvf3gEeC0Ja$MP1&ADNaJ?zhI40iL;yR=6!D4Jn%n~|Cmdvu0+ zpJyzi88!bM@?yQS-_cC=v+RvauDR~D&Begc7Uey@Y(~u6?MHcpw{+SMyJc!Ig@<<^ zl(jhcV2rJy64SRXee6#A^NhXgH2 zIOMNG?~nQJux{RXh4VCo_Xa6@n0A`R73%p@NXu<_uzR`PeA@RPou_4lZ}*Qe8r~F# zCwq%${xaAgv+q~H7<)PI#Pa27XLxKjn<2(8WN7)|*vGDug~tCF z4Pxi+!K%yPUt{sf(#z9)T&9{W%hT+T<7k>Z9BZT&IZe?o33ib*Dz`wKqf1T#PMKn^EiIvD+1%+ytUPb?b^goZ_i&udF8=J-kWNv} zgSNJm!Q-s`nk}yHzu(7jEcvk+5M%M>v0D*UUD|QVyqh`?K_*@Si(9r z!5W^-huGFm?}SR5#{y;4P!FH0Xr=AHI$H}{wgcA;i&{vL8lLqP7a`-gq8Hru;zGjFFb zEPu@sZ>*x%v>>A{=xjlfv*ZIWXk9_yN_!vXyU-R5< zmFx%(+YO=i#wGe#m3^i)c?HWd~;I41Md}+R38z zWG^l@hySj;S(_7O`Q2lCF_t`0^kpxMlrb%PWfaVhb7Q>h_|f)Sg_8${D-&fK#gZzZT?`#%01UU;kmtA^f%-3-ZUHk zGFq9ecOdLmlMh-0)=~4CtkmQP9VmY zd3;ir{FWkX-(?%zR0d*&aTjAWIi2Iru;rr=KEBXMGN#e4tvxuF-`c06hoKunDOVg| zPVm3BPH+4Wf5g%ufa$DZImD_(0nK+-rH%0)-%PwlH_MK--B(ePY*U~9WgFg= z+n~`sr0lPq$ky&4pbcM$wObXIGoD>&P0h=LAEA3??fqRY> zy7Q;P7Dto@e(08U5h5N_7DWdxWWRpb%*zf@f2$a-ti@XpW3T+fj+_Ptt>?WcfNCN^_5p#S5*0p|(V#01PEO{<>CnfD z=N{pymenur-hYOZ4aG~G!f&may(#@gV>QpKh%1Znk4(y2sTUsBZ3=HK#vr#k-g?Uc z%Ca@4n7`6Wf4qh0Z)2VlGCz?i(khsMzTlg?iLl@5XBWDlHaeJEMC3K-Y{3v^rIXnL!mb_&)-YUlBHtdx8$$w=)8MYgU zvUMk)#xia;O#5{IAcuDM636v@ia72%%e}UWKTd5bzo&17wC3|W|UQerKI1I_7~&N`h; zSu2lG94B|!dHdFx|9M>Bo`{?cVGEry!|rxMCnd|i6q+@`avs(BlZDmDHuTUfgRz#U zTH*7y+Wr0<{rmA0C5vfk@hpnu)4YKXS|24i4Sc+k2DbOSg;pwytD)eji4?jT5un85 zz6RkdElKIvy>H2D*_*A_IFAr%ZcA3v$syJ8ti9Jd=cB!C!MN=vHPAVyTVL_bOS*aL zJcKoPir|9Z24d!|&90-dlmd7}Jq>NC`+IOEZ z^Xs!^8m*IAzFVI4Q{?h*Yfn=@&b;<9A3vv&`;7LHbV9a%yWfVg{_|uUwzo^e6~>tC z@!97!uCdMZ%>GYL_FBF#KgzOhN_j5E+#O}{B}a81k_}XssO0a}#Dg-mlTiC_EFS%s zYhT;>NF`*yw)B7)I<|_V6yQ{X8`b=Jwo*b^dMbx%puS)@TN}k_k9hXV){m|d$`$D& zOyEw8dJ(%JOXI-bKGIh5Q~wyz&+^r;UP_%R<+yx9)TlE%KbV3kdUkU&EyBWEo#UNrr#_ZnpV432 zxgA?hE2BZdIDH#I470f0>-@lz)zM!vRv6CKz84_c52i9NPdCmOK`DE`#@24W``PW{ ztQBLslj%*hy?|pYpdhtj@6iRlr|vYcTk>x1s4jXgjBr=?!H*g23fn6cmY3N*|FMp} zd`t}$K)?;&0aoZx4zC7<_WjzhUXfI8uw`q{$ck;MRQX( zIGaMFwxB$l^X1roK8IhrQ>YakZ>6p5dGCFsZ=4*zg~hBZH3JbgX?~>(7xTXdHWt1KQ`k{eyZj*L{Lq=hW6YQRdkG z|H%7=XE()`?Ti|h3b)o^6K%jjPlilDwjyQ95rZ|!M_D)!T<~V;l5Rp6d8_dgAPYY#rv0 z@55euL-<~03lU#lz?f+O8KIe>#p`4X)})vqx|6TC!WXyx8{^5q$7Y$*9+st_$M`B= zyob-iIi+!HA51a(Et8}y;PSj5UuTT%WKot*S;pXX-UNv;T+*#mx#j2086s(CL)LY& zu#;|VWCVUu&fq25Ln?3M?cE3-WyybHpJhl9VKg!Eh%0V+%;?`6Wb{uDH4fczL za?0vhlM=M9Yfs)ywDq@#w`;&{c3NE1f!M73vhGnSS2mlBO0Wa)oZgpcnZOXO7mTw&Ou_(m%R(sZ9t@~cgGuSr% z$s4!d=@rvZYWKu(TnAmsVwuB!n)UV!l&*;3XPtGjZ|@X~Y8hs^`gx15a)(TjO6iTq z?ojPEUlCj74*Ad@+&k;^6knZbhYJtuEVp)QQttXbZ}EJ>`j?$?nDILi7yD(8wD3G* z*`qA0$E@*0X3%SO_6#?V72#|zjalF4t$vh0-p6gM&hoPo8IXtHo+qSq zJP5DIfScC}Is;v2khk`hcTTn&Q;1+Iw*otigPldhIwZ>}8xO;p_t*ge_VMzv2ft$T zLAQ}Ggwftc+eV*t8~tte=>E*cN!9UY4e> zo<+C4yUHCb#xl5|XzLxUj9^yr$98M*TqnG%A&ya>e z?~D(dbWg`Sp67{s?-qIZG);k@=Al=4gAY@r_Lt97NBkDPJpA@d+8K5HS1Y##_UQ3# z%A(GvJ-oJ;*V@+NJg5_d{rb&iDQas>V=%lXX; ze-3-$mS&@Wx^ZUlRbKw}OG}=TLVwL%MoHV9IO}X@myRE|H{FI@#hx8|#xG{KY=r&9 z^sU`aY0&0nMKkJjttOiCu+V1!9#&Zh8y1t|@ z-ulOV4VEig<0w(c``#)yKCZ8wkR$o&(EXBj)9*{l?cT19ZQuKoa>D{LGTw>>;su&b3y+ZtgyLwG#4GpL-*UeO{~ zrGDZ!cJaIEw{Gm+^g;c21Qv#}e3%DAg-*@G@7QQp{Ev|#rWB^)yHSgDeLOoky?m1cT+ZR?yPJiUVshCtJWw_%s2Qq zCXiFYI^XHed#yxm9%ApVt-i_~S5|)yrTL}v5~TS?O8fe>RGWjfwO*Y*rZRcod(@iz zE3bCy&KKf7BM)hw&OdtV_8ihzR*MvQ4>Q~0{4@m=Guh$REMEC_ERHu=r`L}@5pfo=b{kb$z}2i70N?8Gj$G?U&`K{QTY*HFVB}Xel*_i zk3%B;S40u+LHBi#}c}^hoX1U+^S!-8e=xmX-@Rp79QXbA)XmxU%wKAKGTrQa& z!XtL+alX58n%g2VW9L5@Im=D|kyh1BI4wvzE**Rr4P0VlH*LNeHpV)h&-m21WX`ADDo3E7H z$JLwf&C)+syHT9)%XRs5zQL>F5wYP8!RY)=D{O-eeLm~c*Lu@wPOdeBv!5AKYM4sY zl(Ab|p32k3Dofb#=Ibq7f5Z<@2_;xBM#KnOd8CZsR5v6arexA+eJM|BL`(=hy-8C|qt!KYH-pt-quJ~}D8$csXsbHv zQa_CFwFo~_m*1Y%;5?f<5vqYDo?o=8bGN*`d^YB;6^}fOBQfX{k2=4*c_^wW4gP~= z?E%ltFMhn@VI5BDgi)mQmY;8S%hp-68x$*W>bbo!w%Ab(Oa;*W`+|8q-7mYplJ_9Nqk+ zpsxO&sB;o-##Zp@yO7YOBk{)V&f^uz5%0GqYOUMAuk(dRnS+{fYhV{)#3ua3vSwBb z$ykkN7Dw5vm3y?~!DXS&hC`j-i^0}*ot>{d;!*DSc3#VBu?dlMow_piYxWay@Q1^* zo^hQ$_@}6`o>VnVi#%ocz^d#KPH}O&{_|vyPCKkFPq0howcBE^n}xE6c-LOG*{=WS z>_G|P5HZE7v2nJJ-C|=rkeZA0_<(5R6Y*A@6bJ5vw>m538;||MoGG|lJQjsJ&%MVl z#_{n`-v+9Vbz)RxZZB}M2*mP_eEGG_5V_BHMG8gB2dsXKTo&kLOv{S{IT63qGTUIw zGPuq*X9K%ZoSk+M{+!x;ZSVS>ERvpQvl)%vStFavP@UdcVlIkazTpLM($`L7u~SufO5gyO{BV`T~ghZQAi;n>;AP899-#&0<0Hs-`vN@57hF`X7L z(ensD%6Z?;#%vZx_KXiM?)X6dE*7;CCt^g_d)DUbjHi|t!c**+a~Tgy;0ASeVA{>f z?MMEvXDmB=^J)<>jM+*ZLI07xw;a}tZ+UGu#A!`PcW+b1vy+gMky{7d&vLB7>RI@s zGoBOgx8uBQ(L3kc`-z=EWW@FZig32VM@aMbIBuujTkNqh9;0?*Q_Ld+QVrd`}O%jIw-!t)8m3xIU_%&9PI?%oQ|J; z^fLbF4tiONFL$Ff);2fKeiq-2bf52FXXJDYoMti92W3z)OeB-mDkFAu2 zI5CUiWXDq(*ZlU{BeM7^>MJ^eCYhm|!|Fc+MWs)(oOvQ6Vl3j-`pP}?SBde7&y7iLn_|81! zM>F&6mYsNFI2^mh7mv?#vRgYg^MIerZrp~e>@OeLcPl#CrHXe;fUVLzF$zzx=c3V{ zWsW?ixSqG9o~-k&N8kIw!D5lP^Ap}Mn^~!EEsIQ9M%3gj@;Set+0A_H#nw2xEWtra)~zGXqRD(iEFxrv#zYg7Ho!P zZHxpDqdkxA$s_w06rgJ?sFjzpSDp$nc>2mhmDh)3U5K55pS%>&63`DFWUE3W?&W`;%}>gjt?YTP`1_Sb-pj_clHKwduAv;ZtMQyq zKhJLW3_>gCrQ(c7*mZu8;^*DgQdGt)?lZJ}ZQEFAwyivGKILn+h-323-Jq$PUboV$ zwFX?#DFOS7GAx!K$GPHBUV+%{T_L_TKIWRo#v8ZilJt{ykFAvl?(b`yejzE&vNmoL zdytgpL>-jHPFD1tCUdG;2Dkd}X{~+Cy0H+pvYUAF7F(?AgoVXYKX4G``3Cljf$5~U z`FmT-$E-fCGCEI>(f{Y)TWjCH)o=6V{M$@t70x8_u=O{yT!^80+gnc4h7XB~&-*Uq zpje*6nPFMJ-OZo6H2ldW;j1UlIXXUn;rmB}cJtZY(Ib2H5cz41(4Y&Q7oB+W2P!Qu z#S9`wjXmeVR#7IQLikMCWd0?yxHoa8SX~)7%@n%)%sv-?kI=Ph$ce{U%Q6}2wfBB2 zGhhjEYacg(6#|-h13}k9pQc@7BPq`!|)}!wq6Bt&1PG^E_P65ecE| zH##Sse~s>QywE+L_``9=7iTGO`&XRt7`_L22xJ9Id0e`T?YIiw{9%^z2`D|zXWh<; z!&p96YbT9;@|pFD+OP8i<5?TV>5icpAhbN9W(;KJM?U+U4}7fLTW+w|cHHjT*(n=& zF7Bgj=!S9YV&MBl7(bDV{M_g~%q@%jlPB~(h9~+@q<5z0pZ2-vvT!%N8BqlK&gDuF0kLeSlc6Owduriv|P8Na^v*kxBCNM6;*tue5rI#?nFCihZ-BCA!!T2!HR9d9#EcM?ZUb=ss}Kj*p5e4^##UOpuIisN%G z`!;mhn})Qea^M!bDG4%a> zL8OV%wDR}_?_js_!h3m_kMB?1wvx}QnrmLjs&eG8czYlA9&1B@7Kn+@-kY2MdbYXk zld_n2qhsF@m3DO(SN9Tdq2kI+LYq> z>koOe`@RhK;~C<8G54eIO7jO9TK1;n*e`=nQ*rn7Wx9@^&XTeO zt7HmimG0lzB!}#b*;%p^1Akn;6G7HBAEij?NOwTlPYtFf&%90(twO6unW7VlI6b4A zs~g4am18@%ELJ)b!>>EOlrP-uI`qSKx%m6p>#R+azP1<3u;kbaR|+5<(!Oico0W8P z>Yc^bbMo%@#g{heCShn~**RCd$8(*MjCZTStQ}6bXH2VvhW{RU!|sSb@4ZfA#&R-h zmwW%$sdoPC?Ca@bA>YV?v{q>F?M^%A#EGtvC9yR%18HpP3+d2Za`j4j^F3b3UM+u>V3 z<`tc#w+8FvFXnyZ2cBv5WmfpMD2rd+;n=-feEA1diqF<%_nf>i+arA4Bz->0oQyvf zi=`HLDQ+sCLBxp$9=l19<(#+d8uYf)-;>4iEVG``^CEuFe=$Dx|N8uUSP_HB9-Bkt zI{VzRr{D7ih+O-_b3DdgIn&zY&$xll%hWLL#Ob!7JbiLbUMhMI-l2~-PF;DsJ$z(s z`y?-&NYDeaSTJ^YuQyoX{av*=@CHPOdF!{2pF0nK*&i?uR{ALZYe)Gn%-#H8AUi34 z$Q;w89<8yQb1aRe&d$lw=BLDpxcO&Tr2JWGPOWag!Jr3(9&=Z#73YVg z)roPto5#M-2jncu2)~A*)%MPEHT+pj@}S55`ehG*6vWc1XA8{(aZc?u%;ph&C&s>B@@j_ik#jt{Su1{XDZ8O2}?L z_JEk22Od6A7cRY5{dQEdl!o9>BKOwP!&fq6XZFuo`V68UYyUr*3U{{U)Ap(iv}}ME zd1&4)AIN+=d7lXQo_8Oeln-;s2kdd4dtW}_rDCECGnT?)n2NV+=ai-6X;Bw^yBVozx_=E&rK0^nj8CLMT~iSTk*Z_ z6hjyP;|*EItUHBcAai%pWP`UmJV#qMQ{Ok*oVQtW)GYPJPfxa$_48cTu@~ZhOD-*nan=G~m~iB4vGh<9!MZd)i!C%)D3m3H>DGn(D9 zi;uj4F5-jTUQB(-*w7ok&bWy49SZqKzDpNteS0gcUp6lu#j~^C zV|%rSok-f+t$|P4>kwwgw{ydMA~y4LGwl|wTZ4HcYeec}tHtSa3_(GCs~7WVUUusj z-3{{gvkIP-_t=d`Eb)vdzn9ZkXTR;~Fm_5WI*-My=cUkjY;ke@WnSYiyo0~&=C*SM zOValCvzrC2^q76$i!1o6(~C&n*ePnevu}#M7vb+^?Q>b8H$6}mA6_gRMv*^I6<}hbmjOpxJv(DO1uiB~MM=`8XmN%3|_VhyYWTg#+Dg@BulT^x*Y@&laq)R{ zVQDn@xDDeCz4@b+#oO>z3m<5*XBd1xZ{U&6B1fa}hBD(+#K+RW@8{mmQrO`(8>a-t zKt6(3;UptG@`vZR*ZqDhOUYwU9?ggB4vvT$+*9B!=PPlM9k`Mj6^HW=X9Bx=_$?2@ zJ)ct!ohHn>k$7lxP6NNkd&Lnyrclz3YWOy}&qbP3g%kS8!sP;4bblM^+kJtxX*XXvc5tlv)Tr@(AoA$E1Zqga7g??0)Xf-s2HGGmbwyDNsu=^UmD-SO(bf1RLrY+>()&=crd)X>m8UHrkLVRxnAHQQ^1Dn%Y zohewmo6R%k_p(>k#ERBEENBqc0DV@b)?N^5d_>4dKE^fwBJnj*;{0!Tr)X0F$) z$jjJoCHVty6}fq()zcAjDZk7EDPAX0k?HKg6AzYR8n+#-%2ukQ_oI2D=iQS(*67`L z$%sV_)}|afWqs~@@kN&`{tUwMmN~i`%RbgZArGj|bF1sD{KzYwK^b~H#|pcp>x^b6 z^v9+UP48H98TfF*_w$M`e>?g;3_LXXyPe!E1H9?Tsb+i2qxolf`x@V8GKOg5Dcz4j zYTuEk5n0mxsXf+?H;arSktNh{=cC1(KAkd;uWMo7y6JgjuT^7!b~GO@9xzc+_kMrq z29G6T)-2WygRE;G_&6pK&yRWS%N_x(P7UzvbkVsdUV?1#AFnB~<~FN+KM%GuU;4)U zM>}oG22fn?*sX6_zf;0^7_YY5y8#hvJg!~f4G>Cg91iK!#}|3|wg0wrPF5#6)EQ6z zlQnvu_x0XTM07@_d#28__m+R<>@wfyvhp+D;6!xweRLk$`M4;T1?@vx?hlidu?oIF z{6JgVJG=URe2e@a8Ex;$7rcSD`4e-g=@t>|9EC=E*sss&2TwnLZ-yV+VVszf=`O;Y z-C~uADLHJHDwv9A|pq>yuv~U?%vs0YW zAiP{OPs3%sUHII|_!+-_kGe)@|~ zfBN#<-+cOCe)5xl@aZ3X`o}MI|MAnG{nsbI`hEGgpZ?3I|Mk;ffBL(Zr+@qDpM3g< zKe3z0`iH;oEkEEQdyn&ZI-isy@Gd`b7N|zX@g)B8yi%hWM^yP~j9T%(Q@=JmoQ61U z>(_kMH?~>UvZvLvr907dCci#4=BZv@^*f84wfxjFey9EX-pW|j`J);cs5N%(6Fn;% zuUhs{QGSM>R;yw2>a)BWHedih8=;zhZ*{#1#O8K}ExgX}W=~(O#>~}M)4I##tv>bL zyE%E&jyGnb89C)zeJ8kn&&%;gy<(_JFzwqvovCWe%TE1i(`wezYN=GVTV*Fndi>O! z`r9^fCmph0P5|uM6Qjn$sr}Agm_fanyHRO{z2B*(Ta?w?*}kW<8tbOj!s7hin0BJ4 z@vL(QySfi5cc{~fE!9^efAKK;Qp?p?XZ3Ww-_6roPKw3v)w7ObQ)3qANs7|QI7^Lr zr#PI%l+4iGyC;auvOc7_H-ldlNDNJ<@j@K z*1fUk*%jj{uV1S<&sV>7Z1%0E`f=vajv1kl9i17ivs0_zAmMYkH*?%FJU!nCTVcq? zx3_p~yp1!xsliN)VGrJe3mvt?5+RW z_59SY{Z_PoYnNq1Hg>a~wQB{bUiI0D_ghI^?nzk1_R7t0%FT4zZR9ME>G@zYpMJHA z(LHbPPy5R2ciLs?+IQEge|vRX-%83BT4d4bv2rUaGicX}*4|AL?<{|uamoeix96>> zyr91Ed%K}Lq*nhL$+Cxbuj^%xR&s9m8e!%2EYFDVEZXx^4!isMvZQ`tc-pT#%(EurfP-5Y6z644u&h2#njKDym8Nm zNcqh8ThZFhj`mRd_M|+BBVV^127A78xzY@cG=?w#8K;$<`jxY&yr*4=o%Snl-1-g4 zGT{)#y?Hf6twhaM&`4pRej~9!nK#_m4*~VttF>2NzuR{A&sR48#__p&D^uo$xAiNh zX+2p>yLQ{7avAx)o@MpJ{PkP=%FE$C__aY9a`s~7(=YEjnq=e5yHX<%%`a0IM$8XWAD-WrUt=`{*8Y@3 z?e=_#P&Mtz{gYwPIrd<p2q~`dgHb?sUzjJ zYbAT0`r#2FwffYO`mL<-sG|0yTz-0{hm^Bq&xdKc>0p~)Qr^f}SPs8MDlAuDEx^jDb>Onn<;}eM{PsLw{XS<={ko;VFd>q@;)P+K{_=d~ES+`;VZ743LnjiQk6d zEadOEEj?Gx;xNUv+oRe~3xuiXA&{QZe~9SkdGnp;tA~L0kUjm@uH1i~%lWM&C3gD+ z24>od8u658K`UH+Io>!uFV`y%yY*`?&hz{BL#}=@8hcVv#tZo&Dzj}RVZnpxt%K=C z*vi6cSYoASXvSeC!b0M8KfGT1J#W0ze)Su-ve<9Dl|y34ojqC0vj5qOm7&l`!?I5; z)$e(F=wNs1*DhqHiWd3hdi`42)YA|RVZFA(AyS!&YEMp!Jz0-oP|vmVR`3?v-Rd7i zdcJn&`Rc=XNUh)6rJk%T#P&X5$gO_uJZ~j?a(WEAuv~q53pPC;mV2v^zJh2L&yUkt zaAmCZ_3crrN!)KG zr>5OYFTuE(_xzMw;p)3PG2+_il?Ov*ywM&Uq*$ze2&~M~`+A6Noa_ui?TQn>wZ_wO zBkJM#%GkM{r``(I&I)hauN(sAY&R0K-Tk)Q!FwGlM_w^}9&tD_B^7?6KC0d5vX|eKF&`4`H?7EY= z?H@+zFe_O9Fg@)nr@QoDKgfyqylse1i5B^u55a>>D@i37u@mPW!bBsr&jNkPb8c+J{KGP5lrG0qwUZtJ&v$%VG5z+q8iduU}r5s*w5D4?@dN z>O)LsX%G5Lk9mGy-ip?~@@c=7n8S#-Pbz0Q)~MVHPkH@n$De9f`<0=1RX+q^;rVI5 za{bnB$gTY;kGu9Hon*w;oUZb7md?Ufl$z1H8PiY7S#rvG>1h|X=lROb`?h}bg;*7^GG_sbx15dcMXu^`d@Qu6^axFAKZ@m6-~o2lFl(=1%39j2)d{j(qyVxGnu0?VAsxTk#IE_*$XySl{@ z4PkhCZe?NKZH{&up%tv(uv#8C?OWM0aP@Yc*ZJJ|R(M;V<@H-TpW@D^=asF*Z!Fsr zn3-9br9Q3D=Vr2p%C%eW4*_w_GM~*@p1P`U-15(D`|LUW)-HQa`;}v1Bdq5z&eC$P z=j*ZhTa2wJY}WpiTlsx`IUK{a;sJoPNSi-IRxa}z|I}|KtI5LCW99sLSd~G|wC8zI zx%t!&OQ%iVb}(&a!?etNkQxHc74-{|GP3bs*UPA_gwB55V=HU-%DwVYD_Z-N%dBRo z-|B}Q^gnRZZ`ccn(uG*YTUxfxOux6fC<_8U11&p2V3D$zfTQzOdjw{|^GjhyzW z6y;X5amuLHS7!8E7L{Xr0-Muv&%^Yz&yv*3?KoMM%79@Oq$QMlUM6K>UXuFI`ZZE% zj#Ho3&@a1ajp8JAar-1}QzN(a+k;^{i#B3jG0eJ~If$J4+U@zNA2J(n<5!=$If$ix ztZ;EMjMs84R^PiQKDa#z<5bJRG@Yc~EFB_YJe6{uuYT>fg8Hpp>W9TWpL$8>Ro|Yh zBTTvtVyTtziM%3gm0Rf$IrZAzJ~!UVK3h@!ZtJb+JP%Q2EBDDxpHnM-uVyn0 z^RNm_t+s-^E6gxRD>{g5ChcyYS6_Set-O9~=hMpe+~-!5o%OqI*ZJhChZ$JDo{f|m zQQ!0QnDU;_(y-d|ZWiq2Eadep^7uDo`s8sqgmg{T}N-Py7PA6n5HDvhuxIi zFii={O0DD|QhD{M8RLX)>V(DH^VL`0^SABKzvTJ4WeU-VVV5$z#botibe^w%SPqfb z?NUL;>v;-NIYdwW{d47mXle&yMZDjveQavPut+(2zLkb)N>E;UjqxdOMfF>KD#&;} zPZ26_rK{iPef`QIwSLAaPEw3UtOac;@`l~1zkmL^oRU2KHcraX%ELUpraZ*rM4HmP z=`Eij0psekD}Cnq>dWzJ@^?C-9veAJ<(}%B`HWOOPxpLrVlA)BVSL&(PijNIm9y+^ z{pQKe(|+Z0ypd{|a#OCw$|<9O1P zA)1b3*CKuxtjEeJyff13(@EC9y~v`K*YC8;qVs&^5V@}(a;X#Zto`PBjU+8moTOh4 zhQqWw79+jJV5(yEE2r0tGmPuE=R+#}X59OBF~~CLY2QjtzqM;c+P9LF9|T+TMmqI* z&D6=M&%dWOrfR0kYR^YEb1U08=`zpT+aWpxL)7!Fq;Wz({q}T!pDiW!`U(FG1NB*a zMo?D2m1ju^oc5;-iTirviwpI|$7#R%A-Lz8_r82qa{I&#urtFghAaEz6+W$iR}ZVr z6o$hz#iupB>wqxXY8(tj9j*1;aS(PWzR6eqY}$s_}>U+V6AYhV_)^5S@BI zh^}2o4FQU@JsE~+RQD3ETMmOgKjkpLuOD{lqJ!be=`QslH3atjlzV<(pVDOK5Kq;g zn)H9_iER|?M_ zZl-o|^{J8D=Z(1bDLod{@6@-FJx`q&Cks#g+O-F#e&sAa{Z=2M^kUwXLNvoL58D)< zTdP*+WB}9j&@Fb2xcU_2d7jEqZrtt3+MVZFyz&rPztyK853*FnRuU$(Se9Ef{mapIHQ;@9M^Q|a5&YrAgx0G*t9PH}3c4<{B5Bp&{ z79FWbHiPN_sL()5Ln_bbG`j zXyb+X^xr{l_3Jlp?aT=AwHRi@Qa!I-*>mM#=u>(1+U@ym{o3DRdE0LFw}^V)9)zs& z;(6_r)laP)OkmfOK5wy9KP>hMWA*EIU%&E@QrmZ@YT z)*=O{JZx6qjOY34_c^SF8D+LlBU$N5mSiDVRt^m zDuw5H7YrNiTNb7{l{fQx?DMtdDM(y7 z1ZGL?_WXXlgUrTlkGoYhUS6FdRo-~DU;pzw7S=K>)3moet53tKf4#zuxX-k&b|I4n zmIY?<_N?;i)3(QsbeVp6)$CilJzu@~=UuPYng%w~EDEEPocb`DC1)jD`7B+z2tEB) zA2PFSASou1*k_Brb?7I(|TlaD*HT7GrMoguh(zw_I&kcWv?wuiyJ3IQ;5o2 zSzdkYn_b(JJvlwLqV?QJVRI~dZOJT@f$Yt(D6fzKs(+2p>aphSa~x24^VV$$4J=DQDT~w{h~eS$1#7$|+0pZbczPVdh<%X+6@O`n|R! zb*=uj#Z!2DzVXt~+Gp|koCRCK;$Zb5c3Q|J=T_#q zmHT9&Pb=`rvfKKVH}2Z8?6&>NR&rave&^GkKz=o|2u6CYzM0cUXT+4F{#(H;Z07DP zZ`-%>^*iHlo_%iq>`8f^dDcH=S^ZWrOd9F5+{`_nWoc9+yzX~z*|A_N8^)Vw<7WBB zOF0_E56}F{tzJ=x4_ zamw?CMoRPIfiOLv#YbA&^Sq#wmU1(ujg=eslsDemW$}5waw|La>o@N@7R`daIzSD$uPzkX}K^5$v$&2v86!y%NSy`5+M=UvBwusS2H(4*r^#if&9{}TCQbY~i?Sf?YosjOOzWTa^*l^hp5>=q zmhAblqm{3I{q8^0&gSVm5`G)j_ao2p_8^U{{pW6)7_NQg^}DxZ<+Mc>$zz=n z&phkDc-#Cd?_QV%VK+-oi!AAEw#da2{te^T|4#A#1!GVC{KLlSh_CJ5I`!8O`{hODc{%!2Hc*wxFf4*k)fB6%}fBItiU%p`c zyNl7;{-x3X-AnJke(C?WcbNanPyhbK>i_uDfBr4+zquH{e@*_(aAp0Y@&E6iZ00ln z?H_F9|Lz+{=I{UI1(CmdLG`zHxcsYE&#r9$Z(d^RAAS12UOe_cynOQ6KmR?7u&`6V z{VDGL!^{5t`A-(!`|9)aU#;+J7oH#SzrVojeIx!4PmYK&vBT@w|JN_rLG0hX{ET5( z^O{xu-OH1|eDTmC>>kbQasT(1x$N(6UVi@BC*J;>pZ*9H9{>M% zvHQDeP_60l&_!R zU;PwIU$Yb6vfH1ZFf9Dk;=bSNix%KUiRur5xrI)|Mq1!>7c)QY5i|sdj0n06BGXJ zWp@3VxvzHXN6me;e?MyOs~!E;xt(+$pZWgroBzkpuU_`8)1I^J-@KH5^Af**_VV+0 zzdz;e{|fZ>|Mla3Z~vbk=lK4=aBk?jiSb>6)j6fQ(|CJkJ^!Dm?gzV>b2f2z&}h!o z{U4{Ca@`TAxj)-Ecl-Zixw-PD$jwFn-zV?0+_vt!zt?AW*1DPTW~Vm`{-1dMe_q}? zd8cO9{hy?qR^8N^C2O6`o%Y>ZsA-(tP`tIa6^;O z+@P}Du4gUu?Obmovlfb0-<`Lf_0!YcT4VW6hkMTXf&FD|_i&Gpg^Ctu*Lpi<_xCq( zc#K;%b-mA;t$Lc(ZvOhkmMr5%z1z$(D8kH*W;MocwD|?p-LPwOZEN1?R!EyX%uSDV zyYo4?y5Dn4*bRNQ-rowb)oqlgc}BSMjNQqr5hLx}khU8}Xa8ecA>i#zw%*6wNA%c_ z}pF-52KtJi?nGfB29aNUR75-_Lb)^~E7R}Qv%m_K4LIS4j= z(_-tiU}45T zU*r4Qd)Zs$SxJfrkMViy5;gbUdsH4D*RoicKk#3E5A$n#DGo@oaroLznVhE_Zn$T% zY=iF*8Sl2I#yGJhbH}^G5*k{vjn~jn*rD8dZ7tpr@qK$>t1NcSaIC#&GU(!YD~+S# zU4E+nTPDMJLnIAs?&BfGO1t2$}ueGbk-Xev+9dy}X&YjJid&~OPo9D_V;x@czNBv&w87qjhPp+nW?CCY<8ryuh ze>_xNSaD|y)|!X^<&)T93a2^|-Yy$a33sq&>$eB?EKJM+eI71S^96BYoZ|DXFJvtw z*mlOAZ&>HCRy+2JzbOWMK0VE{u+0iSeXNBCzqHbPAq7cYjTh{iSc``r*=tSkJHC*Q zLE|I(f;D4KJAlFMdy!^W=BH2-X}=6!_&A<>^$nI^>TOtON_);5lB1HT7UN>2xQkBtC_HVOuMslwBS(tw@iN+ec^{S6=cgWLc|3CGy}Y zMP+U013v+h)2wwZKJVA`z-y~q#qLU&>%ltBK^RKY|rLq@Wq1X+| zIXmKAx=U11iDInN8CDq6QkFQiJL004|94K_=}cUHpWE?|5We3-TV8xPC2RSz3DKM6T6Jj zt-$!dHv{ep=xAAjUZ(Y^wzca14_~Ugw%D`XRjyyR@ZGg{!^k=_n2&ng%}02cwVU-U zwl-SQt?0(=KDb-*soLK1r9;!cogem2>)K)(RCethz;3S11*hBl@vD0<2t%qH7I&gB z?v}g18#Rl+bcfr_=N8wk&RdH`QupVdzr}rgo^+Fx0_b)&i`_0^=Ki)b5BSoZP4;$1 zc>k?U_TJx%@)O!5gwr`ZfpvVObH?`n^WO`~UOKdI20e~CXRL1TovXU%zQz2UD(~~f z_TKGTH+p(!FCXULVh6r^AH`QzBYK>Ao3~xCTeP0KxBgJ9I#p40r(Y**y0Q1ZACD#A z_4Z5w;l4wGjpo5}33NqcxQ8(0upiF}DO{32RpVTYMLvfw7Dz##TLy88FTLqGXW=WI z&QHA!VM*TP3`C);mjh3v(QDf~| zbsh4b&H{ye%&C~jJ z{`f<0k3}YXVsf_U1a~%2D09uU|P9*X_GaX6P*{CgNeStvtX}jiUD~rtd`j?$Y@*KER-x z1v_9)?N%pF@^(ERS!|rL;rew#OfBUTEWX$4Fve$4=FM3wQ|H$*-7qef%0`EUaSx>Q z-^{c$+)5XCyTu{Ge<%%*q}%r-kKl`!POdbI~YrMH=hsIprJoT7~E{*Jkef z8}09vU+_<{T5dW~VPq>|6^lc;EMWb-EQ_%dwI^cC8p?D{R^M{G8gX^zNx_TXlULxu zn`P3+Hd`yJ4$AFc=Z0+ln0G!O3uXSwL-{s7EdGi#brj-l9+5M!P70w&)05tqck5FG z6$M(E$DViV^@!o(?B#*_iLtz~*t_Cn_KIz7Tf_1mZ~ZxMQPRe&5K}l@vaI-K^SBKM@}^kv+9T|p6_pnotCO9&eW&1~dGJR(J(r*9LyVmV|8j5DK2E&( zTkHFK=Ki$^|6!!`uVq%S z5gYvKWu@7oKK+h?Ru75&u0FeJYt(wz&+Uhr>dn8W)i+YVvn%FwM)rI4W~S-=go}2v z->Ef9&sN_(PfBV}j3$fvX^h4((`wm={nV(JJNz{M>h-4~{bYkttVH)Fq3lGB2xmFL*sPh(Kx zezL9%v)|3xIk=mT*DdQ+8+epu%AjeG{ocMBzi-oNnHtF!*7u}-^pu)*z}WlUZ1SF; z{cg>B+V9oZtKUPX8oxWmY@GeRmh5Wmo`kjxtsm4$*N)3RQjwl|KM zSFaZx=4ZcKtKZorf1Kz2UMqM}1AbPoUuto?*%&PzZ diff --git a/test/models/IRRMesh/spider_UTF16LE.irrmesh b/test/models/IRRMesh/spider_UTF16LE.irrmesh new file mode 100644 index 0000000000000000000000000000000000000000..c6ad9291fb02b6b146175de86cd123e4fbc509f1 GIT binary patch literal 293192 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 literal 0 HcmV?d00001 diff --git a/test/models/IRRMesh/testFormatDetection.xml b/test/models/IRRMesh/testFormatDetection.xml index aa73560d4cf064032536838245ab23fa27cdf2f0..0986eaf61b274476bab5dafa5c0eff42e30a7675 100644 GIT binary patch literal 26504 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 literal 53842 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 Date: Fri, 17 Mar 2023 22:42:17 -0700 Subject: [PATCH 47/61] Revert to commit 13 May 2014 (08bacc7) Changes were introduced to the binary portion of this file at some point --- test/models/PLY/pond.0.ply | Bin 2171788 -> 2171857 bytes 1 file changed, 0 insertions(+), 0 deletions(-) diff --git a/test/models/PLY/pond.0.ply b/test/models/PLY/pond.0.ply index 02b7683cee063655c5b93ade29bc14b3f04e15dd..a45e0322d856bbef01c46b7a5a45a0570fae69be 100644 GIT binary patch delta 600 zcmWmBU1(Ba7zc2U?x^S3d#1~DXFKY!hJv+nyC_;s`h?oDY|NmWE{cL$Y~8hrsLZ-) z6h`e-td%qwG2F(2S7N2mQqWAI#`m{s zsX|*Q!~Vtf!FzT z?p?5ARV8oW`_Zt9M#Jj-Zam8+HI+-6<9ks5w~1RXLi>JhsuO;`$6cs_haYn7n2QdE zxYmO(R^e_}>z?g=mVstBzwCr{XZXrFs9fL|v@l=bH_pS_xVF9x+J9>^X}I)y)#5Su z%|glpm?0$-nvw-Ak8Ca^d>3GJN}zVw_eD6bgNsE$(Tm<=sNn5*%LZjb*206 z>K~clkLUWQO7sLGdYn2Mh^+2=f_%wiV7zd7#2_c&;K?;R-=Z(;G}5fov|>Y+_L!0i zWI?Zq2EFyZpU4UwV&W9`9tn%p-}5dk(zR&ur$p*cHEj5ZY;w5q#b$V7u90)Wvnq-1 zh3gJT1`clVNiVm;Uw5QetqMYhCf-O#apz{GiPJFJVorBM|21=Sb@Z`-nT`c4v!lp* Yoz_d$wHMl~>O-iN{Z?A`Hw};c2fN+ZF8}}l delta 471 zcmV;|0Vw{_$Akfl$Akf}+)T6GOuWsvni>Hpl83{r0k^}f0{nZIz$gPAx8EoOJP3yz zF$0GjF$A|9F$F=Ew_e8uO9q#!%?0V zhsve~x5}mm;6#V3>j$^1>j+~-w+}H1EE%^vN(r$`x9*h*dIYy=nh84yx22*9GEcYI z@d=Mhw`e^I&jGhMKMM6Lw=Qc6@o~2x-3r|cxBln~FW0v&zzY~Nw@32}&C9nHzYOPJ zxBVUs?|Fyqm<_k>m<|gHxA~$D;|{mou@1KJ9>IhY?l}w-HtlK5(~C z#tx~925z+b5 zI=3#79KAA^?ZX^ew@AbsuWGmWE*;BLx5R=SB?E`*g&nu*g&xGEx34Q7d|0 NhctvAw={$xou8R9&XoWF From 92409a821d2582f6735fe875dd6e3b51294edde3 Mon Sep 17 00:00:00 2001 From: Steve M Date: Sat, 18 Mar 2023 22:44:20 -0700 Subject: [PATCH 48/61] Provide dwarf textures for COB model Duped from B3D and X dwarf folders --- test/models/COB/axe.jpg | Bin 0 -> 65191 bytes test/models/COB/dwarf.jpg | Bin 0 -> 84158 bytes test/models/COB/dwarf2.jpg | Bin 0 -> 83046 bytes 3 files changed, 0 insertions(+), 0 deletions(-) create mode 100644 test/models/COB/axe.jpg create mode 100644 test/models/COB/dwarf.jpg create mode 100644 test/models/COB/dwarf2.jpg diff --git a/test/models/COB/axe.jpg b/test/models/COB/axe.jpg new file mode 100644 index 0000000000000000000000000000000000000000..ba14ae0eaaa746f1a4ad49a1e13cbde0c27bbddf GIT binary patch literal 65191 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𝔧}1BLvP4$ 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 literal 0 HcmV?d00001 diff --git a/test/models/COB/dwarf.jpg b/test/models/COB/dwarf.jpg new file mode 100644 index 0000000000000000000000000000000000000000..9c07e003892d360d3fcc3dcb157cd30d38710d2f GIT binary patch literal 84158 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

XI7%{?`>pG`+%O+1>HmVt@w15}xFmC)N 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�kzP*&$>v$bJ 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 literal 0 HcmV?d00001 diff --git a/test/models/COB/dwarf2.jpg b/test/models/COB/dwarf2.jpg new file mode 100644 index 0000000000000000000000000000000000000000..cf54b06573e22d1374561885b6d39458c55f7997 GIT binary patch literal 83046 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%0A1U_T8*G#DVd8hiEfg- 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 ZA}bP7;RDQ-@*>k3_v+IW>34 zf{Rfygy-e)mGyPU{OQBTtb5zA@+0nTB|@lNjN}9~ixW+fnB%|l`Y$cjlUQIRBV!)V ze}H;X+{lQl9ve!?jvUj_u48o3z9cQplDz#friHC5hFkZ~kYM-mCyZpjBfj*^Mx!&q zaYNP{yOa%^?SWC2Z23>C0-lpO)<|Nw=r&8&4?!)vDSUvx_?tu0o%52P<|Qa12Zu_T z2rx-O@M>B0XI?(13a*SNJ03*}Z)TFi_g=otcOIE=iV~W0E=iRmTz3)1o!HMA&H!x%)nQ zQ6@G`s3nrzI8u~i6eO+nHK~G4rO3P6NDI8R1Q?s$(SSc@Krl*L=^+aWs4}7i;4C7Q z^RaVNGVK+2quICW1;H3q6~iAwizY{vNs`X@B+W?)jg8)x9?7Zt3(?&j0ILYZHQQqg z908+YU?BmasxY=p%Sv6Tdo^_?;A#gi9pMQsx4Cl`YCoCUBM#79ut|PF934GO6tG84 zJ!#Jpm+@iUZkAGt*pNTf$+-4||4{3wJ-13JfUi<%k6++jjKB?{P<&)g&=0!r(9xwr zv(Ku(m_=VWoqhDg(>N>Erd-wUjAtN3VQ#VOX;3=O1O$(#Z&)_*F)P;d6c6`kV6udJ zD_%Uje#gIvV@wQCbq*R;D_nxRV#8?tcr)3tdnyvRqNl5;jp1Nk-{(l4kYlcP0S3gF8$mQdBA*Tqgk+kE=#F2i_>F&= z)-nvRr7gK>)fJJdNFk0$QVCb^FWV6n!eI55kybV-eqV;=JUYaS<)rsos^OScaLe}F zG+^zFj7`Un*(jvO>;v_z>9nRKFI-;t+4Zo(OArr3|F=Kkip|Y$WN0G|F)EF((WpzL zIqHvmY{fc{KEUG@6G;{DoyS~K=;vx#cf?0zxqXugXbab;rEScLI3jK%nb~Mrdo)9+ z`Ngg@nJ4}@>Cs-ZwaCxC!kzw5zKy!wtj)mVgy>^Sj-W(dZ4zceZ9x!eh2Pcj?_0C8 zpH+o5dks6i8+8)hV4X(0QBmeKT|OS6-8G&|aI8OLXM`O0FsqL#j2Bczbw}s8p&*}1 zlWT^cf94>s^<-;f()K?9opWcYwfc~_*%g}E!}Qgn2$K8zweyEr8xySOja`43gB33- z@4}OF4*bR(lZz9c<+@Ns_8FWDX;DhQvp5aqlE+su-@!4^y*_CTZ!mC@_&RsC=w zYK883Bqh8j#LiqO-MF`1eEV6Rmu+mBl2J>7yI8v=$AXp|zu9fqf+gN6ytCzIp-8`t zCfn;gbO%7|j4SZ&G4&;3Ley6g@^CXJUFi+1xmC)ow(_863KQ2e1(m^~1*`XQ-XYjO znO_*0mP*nN?iPD--d2@mSvo99xd|^`k~ac%m26M-SGci`Fey^6zpn9h#LTnXVesPn z2zZkEMYzebHL&-c0T`1I?1O9*UfzaG9g1D45xJ-FVYu!6yZEO*AIp>*RgV=>IFv+7 z?Qi6wRf}RoKTbS-M6DsJq{P!n;+lw-y`{czXXSI_|2oUqN?1!g;?uRL8>9XObg1C7 zn7a;)wkvfPzA_-H^6$D?D9wj;ZfkxKbx2v+de#@7vsTr6tB;|&V670@r$zZJ`p<+B z-J4}H2i-EV9U@n|OR!>-{y@X}*R8+v#DLS|%sTWG^JVkLbzqj;ce|}ETV0GCs??lF zoKY9+50Z2MLDuf?RvO9cFYp|+r1dhYCc-P$Q>jN+W;3aRBI0yq7@S{g{~2jQV44QD zG*caP_n$W3#WyU85+}ulXnBM6eA*@;!zlz=R}s?6)W(3Gm_`5W9YH?0l(AeI@)8&` z3)zP$O9@|@r(!2qh<}N_0C;ur=&7A9&1x8@)JJh%&dj zjmU5Ce{bI|y=I5+BjT%Oi zMOIV`Y#&6rrmB8ObIVT3?gpzSH<*10QEd}(p0cd+Kx7g=$UWjbs+H z*;}^OUPrroXra&S-`msT_wv>p@+H+VnZK zGanQPvjTfir>Yk1CT{`w{PE zg2r;LRpRYPXq5a!({NSQ5{{|ADhOp?)fV@@AxvCRnR2AbbSWrdG+GZufcVB=D|I0L z_Rrz63hyNhVPt~!%>IOe8O#|3`w&Yw^AZm()Ew1D`r8-W<+K&H>rs?6iIvRp9px=t z(2$&?LN_pR?18(oJ;?$)-(QTWvY4~6RPiq-WI5ySObn)@j-`%VBL+TxYhv)e9C%ql zr8;P@5Gf+ z4f0Z(i}1AA@aNWWlIeN=$-5h(V7*{xhhBaDte@g}&v^{;L(;@wF1_Ib!&}JoHz9+eq$!?OZ!djLmV%1bPOfYmM zt>UbT-A9v~?awgfBY085341IiPt!tA0%xk+D-nmP2>q;?`LZIxosRU-GKb;Bb?JT7 zOCK7;&$1fe0CYzo4qs6z>E`Y$__J11d1&>qWwjHE6ykF7Ul{wkTC=cy)Z_ z)}`$ZvnC9I@^wbWZ+argALeC9 zA8DaJx@uF7xrl!Binw|ZBUB~vyg;?qZS^UwR@V51gciO$cTKkS5~<>FgK=JZ@`1c3 zYBoMe;FSkA!LZpL$EqP9<*dZa5`}GAofr$Qm?F1|N@vC=ld$$~AmkgK6;%qjfqzL$ zcVG4TmPb~c3pAMZBYVBJ6ri{)l_)i<4`%ldb$grXK51p0e=Gy@Yc!47SaMNhp|EVkF^;u^0_TUF-En> zGy8lLJW%IEro5#ev|?;abnR5~vEi>ne6iitVg&vS0Bn#LrL|<12&B|EBCR6oPRtZ7 zd93^+0$YBnmfAb4PA3P@xh|$1lhv8mtX}wvIhl=ZXU`8WAtK(_ zd*ebw`qUpHp3|jt^i{R$5t~(|$hXohI2qyq<`?})1)6aZ1c@`?mM4_BP*596p+KNb z;Gt2x4+q{6C>$%@iX+1QR@n4Srlp^KmT+Gn_BP$ZXG0sD&W^ag+miSX3sM9v{evhh zSvdxT^u8nkv+j9EAm5-+f2jP6kq`xdLtn#pyGw^R$K*5mLm=>0-XL%fV6^C_YZ?@# z;y8ju_KAJBUjcHS7JUK|KzPm60L|ERh3KV6%HKDp^<*b1ld1u z!Rg`KnA)RW%{?Bn*=gE5{Qx~+bYo<~Bqi?y?;3xQB-11{Fa4g9IMar5=rcqov8i*b z7lBv(G~+)(Wc(G@Gw7!+`5vN;X&DujZ%?{PBJGHbz$F8l)qHvdi;)XJR9PnoZ0q^KtzQit(1 zoEn3b$l^z2q+Sz>e-rgGoNM+X9NNMwe6FbKT`^Z~ zFzUpmpJ!Zu=t>h#`_ru5Rb3GLtpvhWKo$Gl^6YOZVBcovh;~TBhNG#x&k-NaQ`nOO z&sU6x=E2wZU}BL;0N;!Y+^FxEh0*3j?h!Q64J~)VD)J~{1Nnn5)=uv*(-@_3=&zn) zIIa^%iIf=>IDOD}^`BtnM(LNP%m@!5iLNRtdM2r7%>K?W(^9aq8!p=$>8c3M5TlZ7 z;3?4rhW&M2Mm1I-McuNl)_$#FNxnk?F{53DP&=0)=lQp02$W$J{XA@7MI*i9u5iU^ zfiDpq=V;i_nyz`Tb!d^kq`^m%v}d?Y_&Z1S!W*ns_N%-Vz9_<%c9a@Tx7x}mSvhNJ zb3|oG8?aI5fnb*khSpM-EFMQ1l1DgH0oHOfrq?Q{36K|dYxw;8k8ohDMW@1A=2fW!f_-YaeFgJgX>~WNIGmfZoATipd7Y~XEo`Y5p^a^z61`+RAoVo z&rQDq0(-@?`NX)vKo`hF%YP) z5$uuyO1A1~|GL$1neA@>Ds(|U$6>;Ed(6{T>1iFo>nv>4G|>YrsOL!YpA71CJCTsSpjFh0Y`H!QAMa%4tL%XtBrsWMpDxa77x|_mF#Sp#w z#06%+U*lPWgi{fuS>0RNg7gBC;fF@bv+!}jm`0Chgp^)pSpxTPA;r(FsG}vM|-Bv;48c(W&rY>$jk=PqTX`qa!!4sU+(8Ehj>o)*+~)j4{7F3z8S5Kf7a0 zk$@9s_pO`XpmW!57q8#-a7T^vN+Qh;c7#CBYR!EZ_RiMl=XulmH{GrGz1gvsi=6{? zw|q2|gV*O;yB}rfJ_~%A*J52jrWO!Q_oC&J; zL<`76A50js5Rh@P6}*egZT0^xFh|%*4620aVVhem{~gY;Y!S>KaVHQd+%|VH;{!N# zJe#mDD5<~FjW9H-RQOuj^3!AW;`t5P(Ju&U8$$ttS3Hs_pd#Ru8NO)gS<{|;0fFD) zx5OLjd>s$%2yxHeSrfb_F_fHS-m6RsAa=R3v;b z6+M9KyBC=NoTU@62}3x({NAzgl#9a_U?eqh6ltbn_F;OL=qp#0@K^ zlKB=K6)oA04&h+T<)|@4$`x5+PQ1~`{?n%;@VjJ23ru=BLDJE}#`=c|kqF=UMB>yfvvUG|%<%0pCPvvindgwy9~uC130IK0}bEMDM{L#!v9 zOJ5G9M1l$$4+&k}DynKE(VlD~dJW5&#qdktIENI;@Khj=ky|Lr6eoG-X`29?sa1 zoo|3xQGJTHtzTDxiCIggBu3Z`)^qBy$y?aFI&|cRPVQRZDz19C5}1zNlY)B=Up&cY zN9dFfn5aKM#p)cyV01LQ0#ZcDjfbp}QQe4#2>C&!kE2>j9aLx`q}M1D0);2KW9Whb zjM6ID3OqLBdyJmB%B)QR^p)#610wuMXPa+~IbO7_e}wEslYCV%)1K)QUrgq)6!f`aNNV&t$PUaR zvR%cATcdI7vLP}*PZ=k^`(265+_~bZUgtn3uA-G_ZoEU-3enNqkd(Lzz#&zZnz{wU zHLJQlbc~k?ZRRQXS6765qDaguVg(cXM`2NS<3*F0ZGVH7p1QNFx*UYZUv?ly$?~FU ziVPL(-~*Lc_TFU2YmbW|s24Ww0o7m^`4Szl2jj&=@d&RyMMT{Lw9n_#(y5J#5mLmT z?MLOmeVpNKPR9HN5?i=YZEFHCpv3mW-s}a{>GF@=%azz^_&Xz;-8x+i7BH>3p5}+7 zmw|i(eTQL$rb@AYWMWmD7tN2yD}%j^Dp6DWr!tpSmpzSb_v1nJdTBOzZn6-{1QbmQ z&}4~%bzE)P0(S|fVO8uJh?|l&?h#J(8bvon<=-oFNPvME{(SX!B<=&q<@`GcZkd8b z(xoFGM)Hfs$T>ehT;K%%du>dgrS7@)8FqLV&Ss-XS!*5nyred%oPdmxz2m1r0rSQ1 zLTt)q9~;P4Ur3KF(yN2Ts6EL*0eS*lAae&^=5{gm|p*j+m0=QkiNel^(+Ks&w9P&UxR(55%GaP5^!ktI`RipnFgMiuYW z0w{mK5Kz<)UYn{SW5bLw4*)*y=U^K?wP;ESO6QXQqH)n@*g@uWcj@w$u_U3b5^mCa z`5)l_(=;SQi+rxuC3-(xt{B*c!c-VU?H#%=Me%=1IRJq+}_hcOh*6GDNyPTgWNGcIy z!q66E+EpuiZd@koTvBSK*3;iO-H5dEyFq~v%Mch#WO#D|ks-A}Ll4C*V1XtfsCh3wZQ0B{)TGa;!nJ*iTL=7FtWwVsJ z3p)Wb9mbkFop!6X$dX^Rjy)0RB6Wv^uI0y(4KtAf)&&x_M?qvcDED*n{b3ra*Zs`) zL&J^a{P!L${dS+*hRc_LL20bY@#Kb~E{5f`qqh%|@`+)Q{kP^{w!Hrkn$w?D z9+oT1pEc59U;WnS4gqQ8pDycCb6dUk1Ko=nu0v=dIR@J}y(8lWqWjuuZI$}6qZ_!| zC>A0>S=y?GcvhQX&s$ecXSY#7v?-yWf`DH!hQ{U>CIwW-ZUfTqD#aDe&Pi11-Yb{Q zQVx`>SvxQHq%-y;nGjAEAy?%->&0!x2d6BK*g>xi48kH&@t{A?uaoFB6HoZu?CMEW9SkqB`jNtD z#2Cb|%dq6Ih*E0kvTx?E4Tl{Tmb)^4C|t#a@DM z5O%2`kOg0x0W<6CqR5bfzYU*brO@lT_C(F}E@nsWaHQ^pW|fj$=0M|;Ttc~{!#A?> zCefo{66dpx<$`0Y5$n3p=ytC}1>lUy)gkA|rxy>HS!H0rjiL610O&n=tw>Q>UlfEa z3C~X|O2GTPUQq7grq*E)P2>xbn_obv)OU!SOZ7eO=R%`&N&M48DW1k5XlCg2^AEYj z+%gR-vPGG;%OU)VXE)`(R&yprsq$Hp{fh_+yvE`eme5}?P9oo#acQdMKbnV+Ijp9* zM-{C7nSIG)HcBK)w6A8Pfn9HXPy-_22tl$vS<)NUA*nX>e`l|2jURuE@8reqpwlwi zIk&%NV!5>)eU|qzxx|)S_*!67$z~fF3w=$G1crS3fm?J*K^CGZd@nr&=WP-YbXMYj z!?_5_gQCg2WklF9oV4u;7DyTGpMux0zZv#_`zV7*ZI1+Wukd0#VjUlA z-5$-^$LLO5PoIIGX@5?RT*a6$#u2s~oynor-j%yjcoD}bb>lM`nk26F>dzw)SR@B2 z+IApV)d2cIQ(Te#gSV-3PuJrF*R(z;{M2VC%R?+KfE&(p4Gzvk@@&GkdQoAt4$bnk z0RK$+2#IU@6c<-=wmVI^pGCQQ1<1dt$z03VL>b+5`Wc2LxJ6b~qXmcNmYQZ-CFTUh z<^sID^BY0~OeQBo9kS4EZIoX4wPupoMEdgeaQv5h?|Z@Ozwhsjr?&GH&enm&C;*;Ofjd{C9$!n zveZ1Nz=_^~l~Wr%jfHMJg>tV$i-2TF)KX7FSWX|uZkY!W4QY=7n{`LMXBuivXez8w zB%`Uw!Ej{%1!%aCu+sDUtu^Z2qyRbo*j`#GxZJUaLf<6(jFT694{K}8-L#^Wj&5ta zW!|GrJbNBEhUR*LAKX; zXQg?)W?>DRp;%ha>p`52lpdZ(?D@HmG1g@xjoR=EBbjh91Zq^Hm8&@fGD z=q3LA$*Oi*Fz^a#NXedAx#&?JHg(}Z|q1qky)w?f-W z8Bgs@xfT54t+Ic@KUi+B(}IDo!Z}Hu2VN5>EGmOevqaWW^U-9Z8JP+G_EF<&(kU~# zX#|%Jh7qEoGDCe=XNIyue0USR3#M?2+u&yk;EXRX8({6e%r}S=eKQ_wm7vUfrva0K z``{pK!Bw{(ps|0PSTxp=^u}6Clf!@l*4L|zLhU{soa;3}_P3t3zPXkKniQg-*Z+fU zd#?MwKyk7M5rk6j9+{k|yr{o1M+Bzi5C0uk#n6)liR=v{1lMRz8Z4 z(V-E}S`+PIQC9K3%5w}>qw9f>Otj{QV4EiFxO#_m56w%)7F3h41J&da>-mYHvt zdEbtG2y0g^t<+F%D;2)|RMuanf~GE_puaxomw-9=I$0{@qQv_0?^xe=)5&6)^Gvt& zT57LjE-`2RQY)uJ4K+OicJreyDW(FUevuakZK5qBU4)Q%89wR@|LxWX8PD~{JW=!( z6i0s1mZ@<hiF2Yi@0>yL z(^0w=E~gLWIvKsHMYO#of_j6H{#(M9nnJ;5d(`l?{ZM zK9J0{>xL!*t;_CNEYP&$Uh`=48$9puP-tpdJ)iBh<_BhEL7SMJ1E{uo6g6et_DGN@ zI9G6E{OCEW(rY(<8&50ph@*$lwcA%0dw^UsO>l5~xKmSE@Oyi2&+2)5ZUukQyXokb zwJco=Hv7i}Mk8ds(E#^2S*CZb)%E0c!`Szt8hPR$Sn&y!UuUTV^DcGQmJ0~hlmwLe z&aek9pq(fdwAGenF;6@?3x;@BnZ;~GWWN+H6e%w~T^xFZw(EDlP=-^?prLygPpnrs#9~IMlaQA*NnD zsHN+l^Q?Edq5Da#dyw3>B~(ySoBVaHJR<9V2b%tUe1vAT(vI-;Y*!0gj+>EX7E2J% zU-e>@>#|{xIQ=VV=Si&tG=fD@Q0OuOo*7nQ#lcC-)9^&2bM$zwT)8M-jXeLK0JVPT z^OJJ@Gm5y^dp>^;q(FJXRC!?o8Qo|eyDVj9=11SDz-gWXo@0MjlE1kBpQlZF)1FE4 zBD&lv8h&5kQy2`wA&B(HTVtDJo8?$T_>dh@w5a^%a?5K{Dp4!eabfi(Db~sG|FSCg zz6tsi51}?^(SM!grB)KkuFayc2HsG!xrZLfWo*n|CkH5#$%~#zjO}40@eBol@-1VpW;_h%iu!A|#H8;tkS{j>PrVtKT&DZ3UZAU-FP%BD5mVz0iiA$zE#%VenOccC1tadk~ zlzo8VL762B#&H%cLtX*dAnZI#W=Be!_`U%7RSXj^Qeh?s=`pK4;04BE0Q*WiLYSa4 zHuaMuk^oO<_9?kPrw$-krDh1y{iDdiD%p!et_iv~;oi8j97j|380rWjqvRUx!(%IA^ z5{I$qUd!!~)K^<-4#MC2Ir5-7oScQlcKbe;4MeozUub8dGK_49E|j(|z_`{*W8U<> zJ$Cs^`$oop-sgvEyd^0oPCSvPdQr8(zabd`mC;$y+!E zS-5bfBot5Q;1C$fRRBOxVU3dx@~Qb=kp#DU*OxDD`I5SAv)t;{d2q=;Oy&<8^5-@F zknDT=Ou>nz_D)iOH=VQZ&tIE5+;dzJj^}5huy>JexYMYSCuJj8?dSoLL>pZN8&@&W zcJ6CWzA=Jhc2n!Onyt(xl#;~Jc3X76w~=9K;2=5|qsow`L&4veS0wjXy^nYX&R_on z2uLVh#yM;D{7tQY*L*|g6?NMAd-jBe_6jF0kBn~}zY!#BELCIg6*JD3!7#ywbAaWJ zo;>tAAcU%AzFiIH0Sc>QwB~e{ zZ#^z2xo?nMq{NPiLzBdP^!3B(?9B^#g!nyS+5Liso~#R&Y`|N3wl--;t&zdIA5uVT zS8SeZv^{Gm!G~2W_$UcGZ43%8J13M7bFnkn&##BUkM%f?t)flk<~NkD%hJQ)cvXC) zE${qG$$ty}hPJhLp_gvl-$aUO=1l{VP1ykK#zj8adQsjgNDo3s0wnu`C96w;GYMD8 zH1p`jeM9%V(*>8v-|#cst37&^zr8;>u*h6BPvg#U&4N~g0YRk4=Er>@vO%~i<3~O66Sk~1Jy?X`1R@iw%P49UXLevg;7Ki3(PWF%1g)l4$ zSv10Il${OPg4KA~Em#yuuN@af%~%>G{R2~`5eqpqixa{fTW_~##H{x|XRxu~+-p`3 ze~hX(q>N{T}$FTaWLF%jYbQcroYa1MNhL8<7Ha zRT^Oqd)J%{S?QSi(N$F%uDbk@*|WcdExR#~)JO~K=}dU9`7AJm?s>fyc(76LeF4{x z;x;>Sfl2Ldp(L8uy$)zE!n*D)w0-*rvRZaKj5pqAH=|U!jVxK&LRWcDs46DGVfS7w z*dl~3sWM9_lx0iE(=QbKaBE@LABA(UpaNxc3*xC~@1JO`KQ{|Q95J`PoBF%`NhLaz z#P;m1{^NfDq1qa7^sxZ*T3k;g-$`cB_z|o>c5pF~MG>ZqvqHJp8fKM5mjnu;w0-c? zPG9r0R>W<*QjWl!fmj{jvuD*gG} zja!%avW&c2lSh}_j72`ib$yNF$N?Eq^m{n!s41lzkLR86kZjUh$D$yR-$O-q=73RO zv}jku=Pd1eiYoHd5cMY4TGAk{YUUBTcrWygdXHh&Lz>~sZv^o4adaU@qabSYB5=SZ zsK9ll=liecRbkz~x2xE4HzEaTjwCHHxvukhla8fXlEzLG$`}2>=Mgchpx); z<&uq#{V`e6b79Z7wOiH&N6=`)vhiMr(Un@81%^j>-*scpu*{=^G?(p%^0ikkg2m-l z&Bsl$5J$#)ew9a=sJAGegZu3>IV^l`#F@jm_{I7x+tI=GTT{T$2F|o2OUa1cc`4OMUR#~kN^DHTLYf#>|D;R zG0=a2A4JTdXeSr#vU&>(3tw&?u`A8$-E;g({#@OE9oh^rK|5&({;YB9*&n#Ge+#=0 z(c^GEHR|C?R8*7)&f;*Nuux`a!GFt>Ip!dj0Ke#6r|>~7prdni_`5-XIM#X+foSMe zk##;Xz&SPGj%sxI3+!vfnpx6yifwnc9Exgc=Z zo4nUntEs6~!y|2nmdgaar1a&_;PbS2&mYXiYjS@=v5Rf=8xAHWvXrp&w%BhYUhc7$ z^<&C4q%$tAPMw=ZT6fHWHj%KO6d3A#u${}~u`P2yydmbl);TU|Cp91FQhv#Tp^ zjJh@Q|Damf!-ftL*@rdL+FrW?6+!5>Qupo+I+jkF3F{t?XxgB^ea!4q%SlO$BlIxh z5hc!OP>{z96N@e{HgZ<-u*bxmk%;o?rotRzCP&94y>D99FRN?n9R^tPgH7*Ebb99B z#VH|a-R#h?(g#+?5iv29b6yIw;?DaZSPSOFg}pzz*X?eVfuiFPhw)pJW{2@!J1Bx? zekocZ$#8U`@)`^xpqqd8GIA!h0P`9lmt;GChV2Bez^c_uZ9xU$LnCOR(JvGY%MJR2 zo<6~NSw`wD9;p{^`avVln{ar&ch7R4R%!89LlK0lX{D-+ImwnB9laJ|&UG8zTNj{p z2XTCA%czjxN;e_OXa@?+(UjZP(j+%IU8rXse1C3xUT!s>1Xf0X_80i?%bx(vh$gkF zkFtk`A*<1EbXLC2Me*Kzu|nXM7o1u}Vh00FnpuZ#)a?vuh52e7MqjqM$nef^#{=V* zVN+GUNBm_}_Y-YFvtd1j5$o5f=I~Q1IG%nt#f*ab<*C+0B086uD#({fxowTFd4k1E zYx}ezKj=bZ?L)2F+W3uZYD3XcaEzeCW}M~=r?yOS`u6bm-^059Hjm$gB946?Y0z(I zhW5>^kuVIyuX}(=nP@=t$EWR{M*-`96I65m0W_{<|G7~J0m5Ftpk>tHyzlxgRv)vM zR-7uAY14+a?c;;-|Fi&YU>eX`ePODSc!t)Bd-TOspH(;X$H}qi{c{$mSCOPpF^<_B z?OkpN3*v_6D6Ar=2XPeTO^lwM;PTxx#GAlGi=#;T4!8AKnN~@QE(!-b^(@THXKx%m z1pU*re;rB%E!VntM5C16c~aIP&!g_s2&JlMF~W9VwNHNIH|;LFTTxd6hpJc93E;O#!+O8Su`^TWgLN% DIc1Ox literal 0 HcmV?d00001 From 3a69e353f3ca5cc831797b61cd54bb50d5018114 Mon Sep 17 00:00:00 2001 From: Turo Lamminen Date: Mon, 13 Mar 2023 13:40:16 +0200 Subject: [PATCH 49/61] Make Blender MVert no field optional --- code/AssetLib/Blender/BlenderScene.cpp | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/code/AssetLib/Blender/BlenderScene.cpp b/code/AssetLib/Blender/BlenderScene.cpp index 3a9a02fd0..ac10d7302 100644 --- a/code/AssetLib/Blender/BlenderScene.cpp +++ b/code/AssetLib/Blender/BlenderScene.cpp @@ -569,7 +569,7 @@ void Structure ::Convert( const FileDatabase &db) const { ReadFieldArray(dest.co, "co", db); - ReadFieldArray(dest.no, "no", db); + ReadFieldArray(dest.no, "no", db); ReadField(dest.flag, "flag", db); //ReadField(dest.mat_nr,"mat_nr",db); ReadField(dest.bweight, "bweight", db); From 48d89622ee436bf30e7bf9e799802e51674c9e2e Mon Sep 17 00:00:00 2001 From: Turo Lamminen Date: Thu, 9 Mar 2023 13:38:06 +0200 Subject: [PATCH 50/61] Use ASSERT_NE to check that scene has loaded EXPECT_NE tries to continue so it ended up dereferencing null pointers and crashed. --- .../MDL/utMDLImporter_HL1_ImportSettings.cpp | 2 +- .../MDL/utMDLImporter_HL1_Materials.cpp | 16 +++++++-------- .../MDL/utMDLImporter_HL1_Nodes.cpp | 20 +++++++++---------- 3 files changed, 19 insertions(+), 19 deletions(-) diff --git a/test/unit/ImportExport/MDL/utMDLImporter_HL1_ImportSettings.cpp b/test/unit/ImportExport/MDL/utMDLImporter_HL1_ImportSettings.cpp index 4614066e6..d50c2b35a 100644 --- a/test/unit/ImportExport/MDL/utMDLImporter_HL1_ImportSettings.cpp +++ b/test/unit/ImportExport/MDL/utMDLImporter_HL1_ImportSettings.cpp @@ -190,7 +190,7 @@ private: Assimp::Importer importer; importer.SetPropertyBool(setting_key, setting_value); const aiScene *scene = importer.ReadFile(file_path, aiProcess_ValidateDataStructure); - EXPECT_NE(nullptr, scene); + ASSERT_NE(nullptr, scene); func(scene); } diff --git a/test/unit/ImportExport/MDL/utMDLImporter_HL1_Materials.cpp b/test/unit/ImportExport/MDL/utMDLImporter_HL1_Materials.cpp index 2389c0ffc..f733893ca 100644 --- a/test/unit/ImportExport/MDL/utMDLImporter_HL1_Materials.cpp +++ b/test/unit/ImportExport/MDL/utMDLImporter_HL1_Materials.cpp @@ -61,8 +61,8 @@ public: void flatShadeTexture() { Assimp::Importer importer; const aiScene *scene = importer.ReadFile(ASSIMP_TEST_MDL_HL1_MODELS_DIR "chrome_sphere.mdl", aiProcess_ValidateDataStructure); - EXPECT_NE(nullptr, scene); - EXPECT_NE(nullptr, scene->mMaterials); + ASSERT_NE(nullptr, scene); + ASSERT_NE(nullptr, scene->mMaterials); aiShadingMode shading_mode = aiShadingMode_Flat; scene->mMaterials[0]->Get(AI_MATKEY_SHADING_MODEL, shading_mode); @@ -74,8 +74,8 @@ public: void chromeTexture() { Assimp::Importer importer; const aiScene *scene = importer.ReadFile(ASSIMP_TEST_MDL_HL1_MODELS_DIR "chrome_sphere.mdl", aiProcess_ValidateDataStructure); - EXPECT_NE(nullptr, scene); - EXPECT_NE(nullptr, scene->mMaterials); + ASSERT_NE(nullptr, scene); + ASSERT_NE(nullptr, scene->mMaterials); int chrome; scene->mMaterials[0]->Get(AI_MDL_HL1_MATKEY_CHROME(aiTextureType_DIFFUSE, 0), chrome); @@ -87,8 +87,8 @@ public: void additiveBlendTexture() { Assimp::Importer importer; const aiScene *scene = importer.ReadFile(ASSIMP_TEST_MDL_HL1_MODELS_DIR "blend_additive.mdl", aiProcess_ValidateDataStructure); - EXPECT_NE(nullptr, scene); - EXPECT_NE(nullptr, scene->mMaterials); + ASSERT_NE(nullptr, scene); + ASSERT_NE(nullptr, scene->mMaterials); aiBlendMode blend_mode = aiBlendMode_Default; scene->mMaterials[0]->Get(AI_MATKEY_BLEND_FUNC, blend_mode); @@ -101,8 +101,8 @@ public: void textureWithColorMask() { Assimp::Importer importer; const aiScene *scene = importer.ReadFile(ASSIMP_TEST_MDL_HL1_MODELS_DIR "alpha_test.mdl", aiProcess_ValidateDataStructure); - EXPECT_NE(nullptr, scene); - EXPECT_NE(nullptr, scene->mMaterials); + ASSERT_NE(nullptr, scene); + ASSERT_NE(nullptr, scene->mMaterials); int texture_flags = 0; scene->mMaterials[0]->Get(AI_MATKEY_TEXFLAGS_DIFFUSE(0), texture_flags); diff --git a/test/unit/ImportExport/MDL/utMDLImporter_HL1_Nodes.cpp b/test/unit/ImportExport/MDL/utMDLImporter_HL1_Nodes.cpp index 712f4da11..49ae8a16c 100644 --- a/test/unit/ImportExport/MDL/utMDLImporter_HL1_Nodes.cpp +++ b/test/unit/ImportExport/MDL/utMDLImporter_HL1_Nodes.cpp @@ -136,7 +136,7 @@ public: void emptyBonesNames() { Assimp::Importer importer; const aiScene *scene = importer.ReadFile(ASSIMP_TEST_MDL_HL1_MODELS_DIR "unnamed_bones.mdl", aiProcess_ValidateDataStructure); - EXPECT_NE(nullptr, scene); + ASSERT_NE(nullptr, scene); const StringVector expected_bones_names = { "Bone", @@ -172,7 +172,7 @@ public: void emptyBodypartsNames() { Assimp::Importer importer; const aiScene *scene = importer.ReadFile(ASSIMP_TEST_MDL_HL1_MODELS_DIR "unnamed_bodyparts.mdl", aiProcess_ValidateDataStructure); - EXPECT_NE(nullptr, scene); + ASSERT_NE(nullptr, scene); const StringVector expected_bodyparts_names = { "Bodypart", @@ -209,7 +209,7 @@ public: void duplicateBodypartsNames() { Assimp::Importer importer; const aiScene *scene = importer.ReadFile(ASSIMP_TEST_MDL_HL1_MODELS_DIR "duplicate_bodyparts.mdl", aiProcess_ValidateDataStructure); - EXPECT_NE(nullptr, scene); + ASSERT_NE(nullptr, scene); const StringVector expected_bodyparts_names = { "Bodypart", @@ -254,7 +254,7 @@ public: void duplicateSubModelsNames() { Assimp::Importer importer; const aiScene *scene = importer.ReadFile(ASSIMP_TEST_MDL_HL1_MODELS_DIR "duplicate_submodels.mdl", aiProcess_ValidateDataStructure); - EXPECT_NE(nullptr, scene); + ASSERT_NE(nullptr, scene); const std::vector expected_bodypart_sub_models_names = { { @@ -272,7 +272,7 @@ public: }; const aiNode *bodyparts_node = scene->mRootNode->FindNode(AI_MDL_HL1_NODE_BODYPARTS); - EXPECT_NE(nullptr, bodyparts_node); + ASSERT_NE(nullptr, bodyparts_node); EXPECT_EQ(3u, bodyparts_node->mNumChildren); StringVector actual_submodels_names; @@ -301,7 +301,7 @@ public: void duplicateSequenceNames() { Assimp::Importer importer; const aiScene *scene = importer.ReadFile(ASSIMP_TEST_MDL_HL1_MODELS_DIR "duplicate_sequences.mdl", aiProcess_ValidateDataStructure); - EXPECT_NE(nullptr, scene); + ASSERT_NE(nullptr, scene); const StringVector expected_sequence_names = { "idle_1", @@ -337,7 +337,7 @@ public: void emptySequenceNames() { Assimp::Importer importer; const aiScene *scene = importer.ReadFile(ASSIMP_TEST_MDL_HL1_MODELS_DIR "unnamed_sequences.mdl", aiProcess_ValidateDataStructure); - EXPECT_NE(nullptr, scene); + ASSERT_NE(nullptr, scene); const StringVector expected_sequence_names = { "Sequence", @@ -374,7 +374,7 @@ public: void duplicateSequenceGroupNames() { Assimp::Importer importer; const aiScene *scene = importer.ReadFile(ASSIMP_TEST_MDL_HL1_MODELS_DIR "duplicate_sequence_groups/duplicate_sequence_groups.mdl", aiProcess_ValidateDataStructure); - EXPECT_NE(nullptr, scene); + ASSERT_NE(nullptr, scene); const StringVector expected_sequence_names = { "default", @@ -412,7 +412,7 @@ public: void emptySequenceGroupNames() { Assimp::Importer importer; const aiScene *scene = importer.ReadFile(ASSIMP_TEST_MDL_HL1_MODELS_DIR "unnamed_sequence_groups/unnamed_sequence_groups.mdl", aiProcess_ValidateDataStructure); - EXPECT_NE(nullptr, scene); + ASSERT_NE(nullptr, scene); const StringVector expected_sequence_names = { "default", @@ -440,7 +440,7 @@ public: Assimp::Importer importer; const aiScene *scene = importer.ReadFile(MDL_HL1_FILE_MAN, aiProcess_ValidateDataStructure); - EXPECT_NE(nullptr, scene); + ASSERT_NE(nullptr, scene); aiNode *scene_bones_node = scene->mRootNode->FindNode(AI_MDL_HL1_NODE_BONES); From ea3cc378903f698f81a93612f646100e0477c014 Mon Sep 17 00:00:00 2001 From: Turo Lamminen Date: Thu, 9 Mar 2023 14:31:29 +0200 Subject: [PATCH 51/61] Check node parents in ValidateDataStructure --- code/PostProcessing/ValidateDataStructure.cpp | 7 ++++++- 1 file changed, 6 insertions(+), 1 deletion(-) diff --git a/code/PostProcessing/ValidateDataStructure.cpp b/code/PostProcessing/ValidateDataStructure.cpp index cae35b895..e31054972 100644 --- a/code/PostProcessing/ValidateDataStructure.cpp +++ b/code/PostProcessing/ValidateDataStructure.cpp @@ -911,7 +911,12 @@ void ValidateDSProcess::Validate(const aiNode *pNode) { nodeName, pNode->mNumChildren); } for (unsigned int i = 0; i < pNode->mNumChildren; ++i) { - Validate(pNode->mChildren[i]); + const aiNode *pChild = pNode->mChildren[i]; + Validate(pChild); + if (pChild->mParent != pNode) { + const char *parentName = (pChild->mParent != nullptr) ? pChild->mParent->mName.C_Str() : "null"; + ReportError("aiNode \"%s\" child %i \"%s\" parent is someone else: \"%s\"", pNode->mName.C_Str(), i, pChild->mName.C_Str(), parentName); + } } } } From 65440f17a1d25a098d1f754a0b8f6fa7fc48303f Mon Sep 17 00:00:00 2001 From: Turo Lamminen Date: Mon, 20 Mar 2023 15:22:05 +0200 Subject: [PATCH 52/61] Add more ASE model unit tests --- test/unit/utASEImportExport.cpp | 110 ++++++++++++++++++++++++++++++++ 1 file changed, 110 insertions(+) diff --git a/test/unit/utASEImportExport.cpp b/test/unit/utASEImportExport.cpp index 8014cbbc7..af05a2fe5 100644 --- a/test/unit/utASEImportExport.cpp +++ b/test/unit/utASEImportExport.cpp @@ -44,6 +44,7 @@ OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. #include #include +#include using namespace Assimp; @@ -63,3 +64,112 @@ public: TEST_F(utASEImportExport, importACFromFileTest) { EXPECT_TRUE(importerTest()); } + + +TEST_F(utASEImportExport, importAnim1) { + ::Assimp::Importer importer; + const aiScene *scene = importer.ReadFile(ASSIMP_TEST_MODELS_DIR "/ASE/anim.ASE", aiProcess_ValidateDataStructure); + + ASSERT_NE(nullptr, scene); +} + + +TEST_F(utASEImportExport, importAnim2) { + ::Assimp::Importer importer; + const aiScene *scene = importer.ReadFile(ASSIMP_TEST_MODELS_DIR "/ASE/anim2.ASE", aiProcess_ValidateDataStructure); + + ASSERT_NE(nullptr, scene); +} + + +TEST_F(utASEImportExport, importCameraRollAnim) { + ::Assimp::Importer importer; + const aiScene *scene = importer.ReadFile(ASSIMP_TEST_MODELS_DIR "/ASE/CameraRollAnim.ase", aiProcess_ValidateDataStructure); + + ASSERT_NE(nullptr, scene); +} + + +TEST_F(utASEImportExport, importMotionCaptureROM) { + ::Assimp::Importer importer; + const aiScene *scene = importer.ReadFile(ASSIMP_TEST_MODELS_DIR "/ASE/MotionCaptureROM.ase", aiProcess_ValidateDataStructure); + + ASSERT_NE(nullptr, scene); +} + + +TEST_F(utASEImportExport, importRotatingCube) { + ::Assimp::Importer importer; + const aiScene *scene = importer.ReadFile(ASSIMP_TEST_MODELS_DIR "/ASE/RotatingCube.ASE", aiProcess_ValidateDataStructure); + + ASSERT_NE(nullptr, scene); +} + + +TEST_F(utASEImportExport, importTargetCameraAnim) { + ::Assimp::Importer importer; + const aiScene *scene = importer.ReadFile(ASSIMP_TEST_MODELS_DIR "/ASE/TargetCameraAnim.ase", aiProcess_ValidateDataStructure); + + ASSERT_NE(nullptr, scene); +} + + +TEST_F(utASEImportExport, importTestFormatDetection) { + ::Assimp::Importer importer; + const aiScene *scene = importer.ReadFile(ASSIMP_TEST_MODELS_DIR "/ASE/TestFormatDetection", aiProcess_ValidateDataStructure); + + ASSERT_NE(nullptr, scene); +} + + +TEST_F(utASEImportExport, importThreeCubesGreen) { + ::Assimp::Importer importer; + const aiScene *scene = importer.ReadFile(ASSIMP_TEST_MODELS_DIR "/ASE/ThreeCubesGreen.ASE", aiProcess_ValidateDataStructure); + + ASSERT_NE(nullptr, scene); + + ::Assimp::Importer importerLE; + const aiScene *sceneLE = importerLE.ReadFile(ASSIMP_TEST_MODELS_DIR "/ASE/ThreeCubesGreen_UTF16LE.ASE", aiProcess_ValidateDataStructure); + + ASSERT_NE(nullptr, sceneLE); + + ::Assimp::Importer importerBE; + const aiScene *sceneBE = importerBE.ReadFile(ASSIMP_TEST_MODELS_DIR "/ASE/ThreeCubesGreen_UTF16BE.ASE", aiProcess_ValidateDataStructure); + + ASSERT_NE(nullptr, sceneBE); + + // TODO: these scenes should probably be identical + // verify that is the case and then add tests to check it +} + + +TEST_F(utASEImportExport, importUVTransform_Normal) { + ::Assimp::Importer importer; + const aiScene *scene = importer.ReadFile(ASSIMP_TEST_MODELS_DIR "/ASE/TestUVTransform/UVTransform_Normal.ASE", aiProcess_ValidateDataStructure); + + ASSERT_NE(nullptr, scene); +} + + +TEST_F(utASEImportExport, importUVTransform_ScaleUV1_2_OffsetUV0_0_9_Rotate_72_mirrorU) { + ::Assimp::Importer importer; + const aiScene *scene = importer.ReadFile(ASSIMP_TEST_MODELS_DIR "/ASE/TestUVTransform/UVTransform_ScaleUV1-2_OffsetUV0-0.9_Rotate-72_mirrorU.ase", aiProcess_ValidateDataStructure); + + ASSERT_NE(nullptr, scene); +} + + +TEST_F(utASEImportExport, importUVTransform_ScaleUV2x) { + ::Assimp::Importer importer; + const aiScene *scene = importer.ReadFile(ASSIMP_TEST_MODELS_DIR "/ASE/TestUVTransform/UVTransform_ScaleUV2x.ASE", aiProcess_ValidateDataStructure); + + ASSERT_NE(nullptr, scene); +} + + +TEST_F(utASEImportExport, importUVTransform_ScaleUV2x_Rotate45) { + ::Assimp::Importer importer; + const aiScene *scene = importer.ReadFile(ASSIMP_TEST_MODELS_DIR "/ASE/TestUVTransform/UVTransform_ScaleUV2x_Rotate45.ASE", aiProcess_ValidateDataStructure); + + ASSERT_NE(nullptr, scene); +} From 5ddd18d1c7707c1dd7e93e4d7b443c9f9fe91501 Mon Sep 17 00:00:00 2001 From: Turo Lamminen Date: Wed, 22 Mar 2023 12:00:55 +0200 Subject: [PATCH 53/61] Add more AMF unit tests --- code/AssetLib/AMF/AMFImporter_Postprocess.cpp | 1 + test/unit/utAMFImportExport.cpp | 75 +++++++++++++++++++ 2 files changed, 76 insertions(+) diff --git a/code/AssetLib/AMF/AMFImporter_Postprocess.cpp b/code/AssetLib/AMF/AMFImporter_Postprocess.cpp index a65f9260e..d5160870a 100644 --- a/code/AssetLib/AMF/AMFImporter_Postprocess.cpp +++ b/code/AssetLib/AMF/AMFImporter_Postprocess.cpp @@ -815,6 +815,7 @@ nl_clean_loop: for (; next_it != nodeArray.end(); ++next_it) { if ((*next_it)->FindNode((*nl_it)->mName) != nullptr) { // if current top node(nl_it) found in another top node then erase it from node_list and restart search loop. + // FIXME: this leaks memory on test models test8.amf and test9.amf nodeArray.erase(nl_it); goto nl_clean_loop; diff --git a/test/unit/utAMFImportExport.cpp b/test/unit/utAMFImportExport.cpp index 78309a105..7319320cf 100644 --- a/test/unit/utAMFImportExport.cpp +++ b/test/unit/utAMFImportExport.cpp @@ -60,6 +60,81 @@ TEST_F(utAMFImportExport, importAMFFromFileTest) { EXPECT_TRUE(importerTest()); } + +// TODO: test models-nonbsd/AMF/3_bananas.amf.7z +// requires uncompressing it in memory and we don't currently have 7z decompressor + + +TEST_F(utAMFImportExport, importTest2) { + Assimp::Importer importer; + const aiScene *scene = importer.ReadFile(ASSIMP_TEST_MODELS_DIR "/AMF/test2.amf", aiProcess_ValidateDataStructure); + ASSERT_NE(nullptr, scene); +} + + +TEST_F(utAMFImportExport, importTest3) { + Assimp::Importer importer; + const aiScene *scene = importer.ReadFile(ASSIMP_TEST_MODELS_DIR "/AMF/test3.amf", aiProcess_ValidateDataStructure); + ASSERT_NE(nullptr, scene); +} + + +TEST_F(utAMFImportExport, importTest4) { + Assimp::Importer importer; + const aiScene *scene = importer.ReadFile(ASSIMP_TEST_MODELS_DIR "/AMF/test4.amf", aiProcess_ValidateDataStructure); + ASSERT_NE(nullptr, scene); +} + + +TEST_F(utAMFImportExport, importTest5) { + Assimp::Importer importer; + const aiScene *scene = importer.ReadFile(ASSIMP_TEST_MODELS_DIR "/AMF/test5.amf", aiProcess_ValidateDataStructure); + ASSERT_NE(nullptr, scene); +} + + +TEST_F(utAMFImportExport, importTest5a) { + Assimp::Importer importer; + const aiScene *scene = importer.ReadFile(ASSIMP_TEST_MODELS_DIR "/AMF/test5a.amf", aiProcess_ValidateDataStructure); + ASSERT_NE(nullptr, scene); +} + + +TEST_F(utAMFImportExport, importTest6) { + Assimp::Importer importer; + const aiScene *scene = importer.ReadFile(ASSIMP_TEST_MODELS_DIR "/AMF/test6.amf", aiProcess_ValidateDataStructure); + ASSERT_NE(nullptr, scene); +} + + +TEST_F(utAMFImportExport, importTest7) { + Assimp::Importer importer; + const aiScene *scene = importer.ReadFile(ASSIMP_TEST_MODELS_DIR "/AMF/test7.amf", aiProcess_ValidateDataStructure); + ASSERT_NE(nullptr, scene); +} + + +#if 0 +// FIXME: these tests are disabled because they leak memory in AMFImporter_Postprocess.cpp + + +TEST_F(utAMFImportExport, importTest8) { + Assimp::Importer importer; + const aiScene *scene = importer.ReadFile(ASSIMP_TEST_MODELS_DIR "/AMF/test8.amf", aiProcess_ValidateDataStructure); + ASSERT_NE(nullptr, scene); +} + + +TEST_F(utAMFImportExport, importTest9) { + Assimp::Importer importer; + const aiScene *scene = importer.ReadFile(ASSIMP_TEST_MODELS_DIR "/AMF/test9.amf", aiProcess_ValidateDataStructure); + ASSERT_NE(nullptr, scene); +} + + +#endif // 0 + + TEST_F(utAMFImportExport, importAMFWithMatFromFileTest) { Assimp::Importer importer; const aiScene *scene = importer.ReadFile(ASSIMP_TEST_MODELS_DIR "/AMF/test_with_mat.amf", aiProcess_ValidateDataStructure); From c32f4b71b7013a80947e8b8a047d8f225da1c9fe Mon Sep 17 00:00:00 2001 From: Kim Kulling Date: Wed, 22 Mar 2023 20:00:09 +0100 Subject: [PATCH 54/61] Create CODE_OF_CONDUCT.md --- CODE_OF_CONDUCT.md | 128 +++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 128 insertions(+) create mode 100644 CODE_OF_CONDUCT.md diff --git a/CODE_OF_CONDUCT.md b/CODE_OF_CONDUCT.md new file mode 100644 index 000000000..18c914718 --- /dev/null +++ b/CODE_OF_CONDUCT.md @@ -0,0 +1,128 @@ +# Contributor Covenant Code of Conduct + +## Our Pledge + +We as members, contributors, and leaders pledge to make participation in our +community a harassment-free experience for everyone, regardless of age, body +size, visible or invisible disability, ethnicity, sex characteristics, gender +identity and expression, level of experience, education, socio-economic status, +nationality, personal appearance, race, religion, or sexual identity +and orientation. + +We pledge to act and interact in ways that contribute to an open, welcoming, +diverse, inclusive, and healthy community. + +## Our Standards + +Examples of behavior that contributes to a positive environment for our +community include: + +* Demonstrating empathy and kindness toward other people +* Being respectful of differing opinions, viewpoints, and experiences +* Giving and gracefully accepting constructive feedback +* Accepting responsibility and apologizing to those affected by our mistakes, + and learning from the experience +* Focusing on what is best not just for us as individuals, but for the + overall community + +Examples of unacceptable behavior include: + +* The use of sexualized language or imagery, and sexual attention or + advances of any kind +* Trolling, insulting or derogatory comments, and personal or political attacks +* Public or private harassment +* Publishing others' private information, such as a physical or email + address, without their explicit permission +* Other conduct which could reasonably be considered inappropriate in a + professional setting + +## Enforcement Responsibilities + +Community leaders are responsible for clarifying and enforcing our standards of +acceptable behavior and will take appropriate and fair corrective action in +response to any behavior that they deem inappropriate, threatening, offensive, +or harmful. + +Community leaders have the right and responsibility to remove, edit, or reject +comments, commits, code, wiki edits, issues, and other contributions that are +not aligned to this Code of Conduct, and will communicate reasons for moderation +decisions when appropriate. + +## Scope + +This Code of Conduct applies within all community spaces, and also applies when +an individual is officially representing the community in public spaces. +Examples of representing our community include using an official e-mail address, +posting via an official social media account, or acting as an appointed +representative at an online or offline event. + +## Enforcement + +Instances of abusive, harassing, or otherwise unacceptable behavior may be +reported to the community leaders responsible for enforcement at +. +All complaints will be reviewed and investigated promptly and fairly. + +All community leaders are obligated to respect the privacy and security of the +reporter of any incident. + +## Enforcement Guidelines + +Community leaders will follow these Community Impact Guidelines in determining +the consequences for any action they deem in violation of this Code of Conduct: + +### 1. Correction + +**Community Impact**: Use of inappropriate language or other behavior deemed +unprofessional or unwelcome in the community. + +**Consequence**: A private, written warning from community leaders, providing +clarity around the nature of the violation and an explanation of why the +behavior was inappropriate. A public apology may be requested. + +### 2. Warning + +**Community Impact**: A violation through a single incident or series +of actions. + +**Consequence**: A warning with consequences for continued behavior. No +interaction with the people involved, including unsolicited interaction with +those enforcing the Code of Conduct, for a specified period of time. This +includes avoiding interactions in community spaces as well as external channels +like social media. Violating these terms may lead to a temporary or +permanent ban. + +### 3. Temporary Ban + +**Community Impact**: A serious violation of community standards, including +sustained inappropriate behavior. + +**Consequence**: A temporary ban from any sort of interaction or public +communication with the community for a specified period of time. No public or +private interaction with the people involved, including unsolicited interaction +with those enforcing the Code of Conduct, is allowed during this period. +Violating these terms may lead to a permanent ban. + +### 4. Permanent Ban + +**Community Impact**: Demonstrating a pattern of violation of community +standards, including sustained inappropriate behavior, harassment of an +individual, or aggression toward or disparagement of classes of individuals. + +**Consequence**: A permanent ban from any sort of public interaction within +the community. + +## Attribution + +This Code of Conduct is adapted from the [Contributor Covenant][homepage], +version 2.0, available at +https://www.contributor-covenant.org/version/2/0/code_of_conduct.html. + +Community Impact Guidelines were inspired by [Mozilla's code of conduct +enforcement ladder](https://github.com/mozilla/diversity). + +[homepage]: https://www.contributor-covenant.org + +For answers to common questions about this code of conduct, see the FAQ at +https://www.contributor-covenant.org/faq. Translations are available at +https://www.contributor-covenant.org/translations. From 0e657b575b266df8bc696dea08f277f702fbaaff Mon Sep 17 00:00:00 2001 From: Turo Lamminen Date: Thu, 23 Mar 2023 14:56:31 +0200 Subject: [PATCH 55/61] Add more 3D files to unit tests --- test/unit/ut3DImportExport.cpp | 21 +++++++++++++++++++++ 1 file changed, 21 insertions(+) diff --git a/test/unit/ut3DImportExport.cpp b/test/unit/ut3DImportExport.cpp index 5ff1d7940..32b77ddf8 100644 --- a/test/unit/ut3DImportExport.cpp +++ b/test/unit/ut3DImportExport.cpp @@ -65,3 +65,24 @@ TEST(ut3DImportExport, importBoxUC) { const aiScene *scene = importer.ReadFile(ASSIMP_TEST_MODELS_DIR "/3D/box.uc", aiProcess_ValidateDataStructure); ASSERT_NE(nullptr, scene); } + + +TEST(ut3DImportExport, importMarRifle) { + Assimp::Importer importer; + const aiScene *scene = importer.ReadFile(ASSIMP_TEST_MODELS_NONBSD_DIR "/3D/mar_rifle.uc", aiProcess_ValidateDataStructure); + ASSERT_NE(nullptr, scene); +} + + +TEST(ut3DImportExport, importMarRifleA) { + Assimp::Importer importer; + const aiScene *scene = importer.ReadFile(ASSIMP_TEST_MODELS_NONBSD_DIR "/3D/mar_rifle_a.3d", aiProcess_ValidateDataStructure); + ASSERT_NE(nullptr, scene); +} + + +TEST(ut3DImportExport, importMarRifleD) { + Assimp::Importer importer; + const aiScene *scene = importer.ReadFile(ASSIMP_TEST_MODELS_NONBSD_DIR "/3D/mar_rifle_d.3d", aiProcess_ValidateDataStructure); + ASSERT_NE(nullptr, scene); +} From e8d4a11af539f454b05eeaf4ed48ed515c5d1f4a Mon Sep 17 00:00:00 2001 From: Turo Lamminen Date: Thu, 23 Mar 2023 15:06:19 +0200 Subject: [PATCH 56/61] Add more 3DS files to unit tests --- test/unit/ut3DSImportExport.cpp | 112 ++++++++++++++++++++++++++++++++ 1 file changed, 112 insertions(+) diff --git a/test/unit/ut3DSImportExport.cpp b/test/unit/ut3DSImportExport.cpp index 01406362d..7279227fc 100644 --- a/test/unit/ut3DSImportExport.cpp +++ b/test/unit/ut3DSImportExport.cpp @@ -70,3 +70,115 @@ TEST_F(ut3DSImportExport, import3DSformatdetection) { EXPECT_NE(nullptr, scene); } + + +TEST_F(ut3DSImportExport, importCameraRollAnim) { + ::Assimp::Importer importer; + const aiScene *scene = importer.ReadFile(ASSIMP_TEST_MODELS_DIR "/3DS/CameraRollAnim.3ds", aiProcess_ValidateDataStructure); + + EXPECT_NE(nullptr, scene); +} + + +TEST_F(ut3DSImportExport, importCameraRollAnimWithChildObject) { + ::Assimp::Importer importer; + const aiScene *scene = importer.ReadFile(ASSIMP_TEST_MODELS_DIR "/3DS/CameraRollAnimWithChildObject.3ds", aiProcess_ValidateDataStructure); + + EXPECT_NE(nullptr, scene); +} + + +TEST_F(ut3DSImportExport, importCubesWithAlpha) { + ::Assimp::Importer importer; + const aiScene *scene = importer.ReadFile(ASSIMP_TEST_MODELS_DIR "/3DS/cubes_with_alpha.3DS", aiProcess_ValidateDataStructure); + + EXPECT_NE(nullptr, scene); +} + + +TEST_F(ut3DSImportExport, importCubeWithDiffuseTexture) { + ::Assimp::Importer importer; + const aiScene *scene = importer.ReadFile(ASSIMP_TEST_MODELS_DIR "/3DS/cube_with_diffuse_texture.3DS", aiProcess_ValidateDataStructure); + + EXPECT_NE(nullptr, scene); +} + + +TEST_F(ut3DSImportExport, importCubeWithSpecularTexture) { + ::Assimp::Importer importer; + const aiScene *scene = importer.ReadFile(ASSIMP_TEST_MODELS_DIR "/3DS/cube_with_specular_texture.3DS", aiProcess_ValidateDataStructure); + + EXPECT_NE(nullptr, scene); +} + + +TEST_F(ut3DSImportExport, importRotatingCube) { + ::Assimp::Importer importer; + const aiScene *scene = importer.ReadFile(ASSIMP_TEST_MODELS_DIR "/3DS/RotatingCube.3DS", aiProcess_ValidateDataStructure); + + EXPECT_NE(nullptr, scene); +} + + +TEST_F(ut3DSImportExport, importTargetCameraAnim) { + ::Assimp::Importer importer; + const aiScene *scene = importer.ReadFile(ASSIMP_TEST_MODELS_DIR "/3DS/TargetCameraAnim.3ds", aiProcess_ValidateDataStructure); + + EXPECT_NE(nullptr, scene); +} + + +TEST_F(ut3DSImportExport, importTest1) { + ::Assimp::Importer importer; + const aiScene *scene = importer.ReadFile(ASSIMP_TEST_MODELS_DIR "/3DS/test1.3ds", aiProcess_ValidateDataStructure); + + EXPECT_NE(nullptr, scene); +} + + +TEST_F(ut3DSImportExport, importCartWheel) { + ::Assimp::Importer importer; + const aiScene *scene = importer.ReadFile(ASSIMP_TEST_MODELS_NONBSD_DIR "/3DS/cart_wheel.3DS", aiProcess_ValidateDataStructure); + + EXPECT_NE(nullptr, scene); +} + + +TEST_F(ut3DSImportExport, importGranate) { + ::Assimp::Importer importer; + const aiScene *scene = importer.ReadFile(ASSIMP_TEST_MODELS_NONBSD_DIR "/3DS/Granate.3DS", aiProcess_ValidateDataStructure); + + EXPECT_NE(nullptr, scene); +} + + +TEST_F(ut3DSImportExport, importJeep1) { + ::Assimp::Importer importer; + const aiScene *scene = importer.ReadFile(ASSIMP_TEST_MODELS_NONBSD_DIR "/3DS/jeep1.3ds", aiProcess_ValidateDataStructure); + + EXPECT_NE(nullptr, scene); +} + + +TEST_F(ut3DSImportExport, importMarRifle) { + ::Assimp::Importer importer; + const aiScene *scene = importer.ReadFile(ASSIMP_TEST_MODELS_NONBSD_DIR "/3DS/mar_rifle.3ds", aiProcess_ValidateDataStructure); + + EXPECT_NE(nullptr, scene); +} + + +TEST_F(ut3DSImportExport, importMp5Sil) { + ::Assimp::Importer importer; + const aiScene *scene = importer.ReadFile(ASSIMP_TEST_MODELS_NONBSD_DIR "/3DS/mp5_sil.3ds", aiProcess_ValidateDataStructure); + + EXPECT_NE(nullptr, scene); +} + + +TEST_F(ut3DSImportExport, importPyramob) { + ::Assimp::Importer importer; + const aiScene *scene = importer.ReadFile(ASSIMP_TEST_MODELS_NONBSD_DIR "/3DS/pyramob.3DS", aiProcess_ValidateDataStructure); + + EXPECT_NE(nullptr, scene); +} From bed2cf1a23d485c4c92940899058a00a7dafbe3e Mon Sep 17 00:00:00 2001 From: Turo Lamminen Date: Thu, 23 Mar 2023 15:18:17 +0200 Subject: [PATCH 57/61] Add more BVH files to unit tests --- test/unit/utBVHImportExport.cpp | 16 +++++++++++++++- 1 file changed, 15 insertions(+), 1 deletion(-) diff --git a/test/unit/utBVHImportExport.cpp b/test/unit/utBVHImportExport.cpp index d69ac7987..5a0ff1e10 100644 --- a/test/unit/utBVHImportExport.cpp +++ b/test/unit/utBVHImportExport.cpp @@ -55,6 +55,20 @@ public: } }; -TEST_F(utBVHImportExport, importBlenFromFileTest) { +TEST_F(utBVHImportExport, import01_01) { EXPECT_TRUE(importerTest()); } + + +TEST_F(utBVHImportExport, import01_03) { + Assimp::Importer importer; + const aiScene *scene = importer.ReadFile(ASSIMP_TEST_MODELS_DIR "/BVH/01_03.bvh", aiProcess_ValidateDataStructure); + ASSERT_NE(nullptr, scene); +} + + +TEST_F(utBVHImportExport, importBoxingToes) { + Assimp::Importer importer; + const aiScene *scene = importer.ReadFile(ASSIMP_TEST_MODELS_DIR "/BVH/Boxing_Toes.bvh", aiProcess_ValidateDataStructure); + ASSERT_NE(nullptr, scene); +} From 6832aa227ab5d22f3ae4703097f12a814e9fad3e Mon Sep 17 00:00:00 2001 From: Turo Lamminen Date: Thu, 23 Mar 2023 15:23:30 +0200 Subject: [PATCH 58/61] Add more DXF files to unit tests --- test/unit/utDXFImporterExporter.cpp | 14 ++++++++++++++ 1 file changed, 14 insertions(+) diff --git a/test/unit/utDXFImporterExporter.cpp b/test/unit/utDXFImporterExporter.cpp index 9193946b5..53c5328e4 100644 --- a/test/unit/utDXFImporterExporter.cpp +++ b/test/unit/utDXFImporterExporter.cpp @@ -71,3 +71,17 @@ TEST_F(utDXFImporterExporter, issue2229) { const aiScene *scene = importer.ReadFile(ASSIMP_TEST_MODELS_DIR "/DXF/issue_2229.dxf", aiProcess_ValidateDataStructure); EXPECT_NE(nullptr, scene); } + + +TEST_F(utDXFImporterExporter, importWuson) { + Assimp::Importer importer; + const aiScene *scene = importer.ReadFile(ASSIMP_TEST_MODELS_DIR "/DXF/wuson.dxf", aiProcess_ValidateDataStructure); + EXPECT_NE(nullptr, scene); +} + + +TEST_F(utDXFImporterExporter, importRifle) { + Assimp::Importer importer; + const aiScene *scene = importer.ReadFile(ASSIMP_TEST_MODELS_NONBSD_DIR "/DXF/rifle.dxf", aiProcess_ValidateDataStructure); + EXPECT_NE(nullptr, scene); +} From d8201bdb6f43ca396b5cdcacfbda67870397554b Mon Sep 17 00:00:00 2001 From: Kim Kulling Date: Sat, 25 Mar 2023 16:00:29 +0100 Subject: [PATCH 59/61] Update Readme.md --- Readme.md | 3 +++ 1 file changed, 3 insertions(+) diff --git a/Readme.md b/Readme.md index 1af71fad8..c8fe3f43f 100644 --- a/Readme.md +++ b/Readme.md @@ -22,6 +22,9 @@ Additionally, assimp features various __mesh post processing tools__: normals an ### Latest Doc's ### Please check the latest documents at [Asset-Importer-Lib-Doc](https://assimp-docs.readthedocs.io/en/latest/). +### Prebuild binaries ### +Please check our [Itchi Projectspace](https://kimkulling.itch.io/the-asset-importer-lib) + ### Get involved ### This is the development repo containing the latest features and bugfixes. For productive use though, we recommend one of the stable releases available from [Github Assimp Releases](https://github.com/assimp/assimp/releases).
From f4e9930e509ca92718cb65f980d38cefdd0a8065 Mon Sep 17 00:00:00 2001 From: Kim Kulling Date: Tue, 28 Mar 2023 13:45:09 +0200 Subject: [PATCH 60/61] Update Readme.md --- Readme.md | 19 +++++++++++-------- 1 file changed, 11 insertions(+), 8 deletions(-) diff --git a/Readme.md b/Readme.md index 1af71fad8..5cfcbee8c 100644 --- a/Readme.md +++ b/Readme.md @@ -1,6 +1,8 @@ Open Asset Import Library (assimp) ================================== -A library to import and export various 3d-model-formats including scene-post-processing to generate missing render data. + +Open Asset Import Library is a library to load various 3d file formats into a shared, in-memory format. It supports more than __40 file formats__ for import and a growing selection of file formats for export. + ### Current project status ### [![Financial Contributors on Open Collective](https://opencollective.com/assimp/all/badge.svg?label=financial+contributors)](https://opencollective.com/assimp) ![C/C++ CI](https://github.com/assimp/assimp/workflows/C/C++%20CI/badge.svg) @@ -65,26 +67,27 @@ Open Asset Import Library is implemented in C++. The directory structure looks l /port Ports to other languages and scripts to maintain those. /test Unit- and regression tests, test suite of models /tools Tools (old assimp viewer, command line `assimp`) - /samples A small number of samples to illustrate possible - use cases for Assimp + /samples A small number of samples to illustrate possible use-cases for Assimp The source code is organized in the following way: code/Common The base implementation for importers and the infrastructure + code/CApi Special implementations which are only used for the C-API + code/Geometry A collection of geometry tools + code/Material The material system + code/PBR An exporter for physical based models code/PostProcessing The post-processing steps code/AssetLib/ Implementation for import and export for the format ### Where to get help ### To find our documentation, visit [our website](https://assimp.org/) or check out [Wiki](https://github.com/assimp/assimp/wiki) -If the docs don't solve your problem, you can: -- Ask on [StackOverflow with the assimp-tag](http://stackoverflow.com/questions/tagged/assimp?sort=newest). -- Ask on [Assimp-Community on Reddit](https://www.reddit.com/r/Assimp/) +### Communities ### - Ask a question at [The Assimp-Discussion Board](https://github.com/assimp/assimp/discussions) +- Ask on [Assimp-Community on Reddit](https://www.reddit.com/r/Assimp/) +- Ask on [StackOverflow with the assimp-tag](http://stackoverflow.com/questions/tagged/assimp?sort=newest). - Nothing has worked? File a question or an issue-report at [The Assimp-Issue Tracker](https://github.com/assimp/assimp/issues) -Open Asset Import Library is a library to load various 3d file formats into a shared, in-memory format. It supports more than __40 file formats__ for import and a growing selection of file formats for export. - And we also have a Gitter-channel:Gitter [![Join the chat at https://gitter.im/assimp/assimp](https://badges.gitter.im/assimp/assimp.svg)](https://gitter.im/assimp/assimp?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)
### Contributing ### From 55fa3d4251438806d11865d84b06ec638f42fc27 Mon Sep 17 00:00:00 2001 From: Kim Kulling Date: Tue, 28 Mar 2023 15:19:33 +0200 Subject: [PATCH 61/61] Update Readme.md --- Readme.md | 26 ++++++++------------------ 1 file changed, 8 insertions(+), 18 deletions(-) diff --git a/Readme.md b/Readme.md index 5cfcbee8c..c680cd834 100644 --- a/Readme.md +++ b/Readme.md @@ -24,15 +24,16 @@ Additionally, assimp features various __mesh post processing tools__: normals an ### Latest Doc's ### Please check the latest documents at [Asset-Importer-Lib-Doc](https://assimp-docs.readthedocs.io/en/latest/). -### Get involved ### -This is the development repo containing the latest features and bugfixes. For productive use though, we recommend one of the stable releases available from [Github Assimp Releases](https://github.com/assimp/assimp/releases). -
-You find a bug in the docs? Use [Doc-Repo](https://github.com/assimp/assimp-docs). -
-Please check our Wiki as well: https://github.com/assimp/assimp/wiki - If you want to check our Model-Database, use the following repo: https://github.com/assimp/assimp-mdb +### Communities ### +- Ask a question at [The Assimp-Discussion Board](https://github.com/assimp/assimp/discussions) +- Ask on [Assimp-Community on Reddit](https://www.reddit.com/r/Assimp/) +- Ask on [StackOverflow with the assimp-tag](http://stackoverflow.com/questions/tagged/assimp?sort=newest). +- Nothing has worked? File a question or an issue-report at [The Assimp-Issue Tracker](https://github.com/assimp/assimp/issues) + +And we also have a Gitter-channel:Gitter [![Join the chat at https://gitter.im/assimp/assimp](https://badges.gitter.im/assimp/assimp.svg)](https://gitter.im/assimp/assimp?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)
+ #### Supported file formats #### You can find the complete list of supported file-formats [here](https://github.com/assimp/assimp/blob/master/doc/Fileformats.md) @@ -79,17 +80,6 @@ The source code is organized in the following way: code/PostProcessing The post-processing steps code/AssetLib/ Implementation for import and export for the format -### Where to get help ### -To find our documentation, visit [our website](https://assimp.org/) or check out [Wiki](https://github.com/assimp/assimp/wiki) - -### Communities ### -- Ask a question at [The Assimp-Discussion Board](https://github.com/assimp/assimp/discussions) -- Ask on [Assimp-Community on Reddit](https://www.reddit.com/r/Assimp/) -- Ask on [StackOverflow with the assimp-tag](http://stackoverflow.com/questions/tagged/assimp?sort=newest). -- Nothing has worked? File a question or an issue-report at [The Assimp-Issue Tracker](https://github.com/assimp/assimp/issues) - -And we also have a Gitter-channel:Gitter [![Join the chat at https://gitter.im/assimp/assimp](https://badges.gitter.im/assimp/assimp.svg)](https://gitter.im/assimp/assimp?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)
- ### Contributing ### Contributions to assimp are highly appreciated. The easiest way to get involved is to submit a pull request with your changes against the main repository's `master` branch.