1 #ifndef DALI_SCENE_LOADER_MESH_DEFINITION_H
2 #define DALI_SCENE_LOADER_MESH_DEFINITION_H
4 * Copyright (c) 2021 Samsung Electronics Co., Ltd.
6 * Licensed under the Apache License, Version 2.0 (the "License");
7 * you may not use this file except in compliance with the License.
8 * You may obtain a copy of the License at
10 * http://www.apache.org/licenses/LICENSE-2.0
12 * Unless required by applicable law or agreed to in writing, software
13 * distributed under the License is distributed on an "AS IS" BASIS,
14 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
15 * See the License for the specific language governing permissions and
16 * limitations under the License.
21 #include "dali-scene-loader/public-api/api.h"
22 #include "dali-scene-loader/public-api/blend-shape-details.h"
23 #include "dali-scene-loader/public-api/index.h"
24 #include "dali-scene-loader/public-api/mesh-geometry.h"
25 #include "dali-scene-loader/public-api/utils.h"
29 #include "dali/public-api/common/vector-wrapper.h"
36 * @brief Defines a mesh with its attributes, the primitive type to render it as,
37 * and the file to load it from with the offset and length information for the
38 * individual attribute buffers.
40 struct DALI_SCENE_LOADER_API MeshDefinition
42 using Vector = std::vector<std::pair<MeshDefinition, MeshGeometry>>;
46 INVALID = std::numeric_limits<uint32_t>::max()
51 FLIP_UVS_VERTICAL = NthBit(0),
52 U32_INDICES = NthBit(1), // default is unsigned short
53 U16_JOINT_IDS = NthBit(2), // default is floats
59 POSITIONS = NthBit(1),
61 TEX_COORDS = NthBit(3),
63 LEGACY_BITANGENTS = NthBit(5), // these are ignored; we're calculating them in the (PBR) shader.
65 WEIGHTS_0 = NthBit(7),
69 * @brief Describes raw data in terms of its position and size in a buffer.
74 uint32_t mOffset = INVALID; // the default means that the blob is undefined.
75 uint32_t mLength = 0; // if the blob is undefined, its data may still be generated. This is enabled by setting length to some non-0 value. Refer to MeshDefinition for details.
76 uint16_t mStride = 0; // ignore if 0
77 uint16_t mElementSizeHint = 0; // ignore if 0 or stride == 0
78 std::vector<float> mMin;
79 std::vector<float> mMax;
81 static void ApplyMinMax(const std::vector<float>& min, const std::vector<float>& max, uint32_t count, float* values);
85 Blob(uint32_t offset, uint32_t length, uint16_t stride = 0, uint16_t elementSizeHint = 0, const std::vector<float>& min = {}, const std::vector<float>& max = {});
88 * @brief Calculates the size of a tightly-packed buffer for the elements from the blob.
90 uint32_t GetBufferSize() const;
93 * @brief Convenience method to tell whether a Blob has meaningful data.
95 bool IsDefined() const
97 return mOffset != INVALID;
101 * @brief Convenience method to tell whether the elements stored in the blob follow each
102 * other tightly. The opposite would be interleaving.
104 bool IsConsecutive() const
106 return mStride == 0 || mStride == mElementSizeHint;
110 * @brief Applies the min / max values, if they're defined.
112 void ApplyMinMax(uint32_t count, float* values) const;
116 * @brief A sparse blob describes a change in a reference Blob.
117 * @p indices describe what positions of the reference Blob change and
118 * @p values describe the new values.
122 SparseBlob() = default;
124 SparseBlob(const Blob& indices, const Blob& values, uint32_t count);
128 uint32_t mCount = 0u;
134 std::unique_ptr<SparseBlob> mSparse;
136 Accessor() = default;
138 Accessor(const Accessor&) = delete;
139 Accessor& operator=(const Accessor&) = delete;
141 Accessor(Accessor&&) = default;
142 Accessor& operator=(Accessor&&) = default;
144 Accessor(const MeshDefinition::Blob& blob,
145 const MeshDefinition::SparseBlob& sparse);
147 bool IsDefined() const
149 return mBlob.IsDefined() || (mSparse && (mSparse->mIndices.IsDefined() && mSparse->mValues.IsDefined()));
154 * @brief Stores a blend shape.
170 Property::Type mType;
171 uint32_t mNumElements;
172 std::vector<uint8_t> mData;
174 void AttachBuffer(Geometry& g) const;
177 std::vector<uint16_t> mIndices;
178 std::vector<Attrib> mAttribs;
180 unsigned int mBlendShapeBufferOffset{0};
181 Dali::Vector<float> mBlendShapeUnnormalizeFactor;
182 PixelData mBlendShapeData;
185 MeshDefinition() = default;
187 MeshDefinition(const MeshDefinition&) = delete;
188 MeshDefinition& operator=(const MeshDefinition&) = delete;
190 MeshDefinition(MeshDefinition&&) = default;
191 MeshDefinition& operator=(MeshDefinition&&) = default;
194 * @brief Determines whether the mesh definition is that of a quad.
199 * @brief Determines whether the mesh is used for skeletal animation.
201 bool IsSkinned() const;
204 * @brief Whether the mesh has blend shapes.
206 bool HasBlendShapes() const;
209 * @brief Requests normals to be generated.
210 * @note Generation happens in LoadRaw().
211 * @note Must have Vector3 positions defined.
213 void RequestNormals();
216 * @brief Requests tangents to be generated.
217 * @note Generation happens in LoadRaw().
218 * @note Must have Vector3 normals defined.
220 void RequestTangents();
223 * @brief Loads raw geometry data, which includes index (optional) and
224 * attribute buffers, as well as blend shape data. This is then returned.
225 * @note This can be done on any thread.
227 RawData LoadRaw(const std::string& modelsPath) const;
230 * @brief Creates a MeshGeometry based firstly on the value of the uri member:
231 * if it is "quad", a textured quad is created; otherwise it uses the
232 * attribute (and index) buffers and blend shape information (if available)
234 * If mFlipVertical was set, the UVs are flipped in Y, i.e. v = 1.0 - v.
236 MeshGeometry Load(RawData&& raw) const;
239 uint32_t mFlags = 0x0;
240 Geometry::Type mPrimitiveType = Geometry::TRIANGLES;
244 Accessor mNormals; // data can be generated based on positions
246 Accessor mTangents; // data can be generated based on normals and texCoords (the latter isn't mandatory; the results will be better if available)
250 Blob mBlendShapeHeader;
251 std::vector<BlendShape> mBlendShapes;
252 BlendShapes::Version mBlendShapeVersion = BlendShapes::Version::INVALID;
254 Index mSkeletonIdx = INVALID_INDEX;
257 } // namespace SceneLoader
260 #endif //DALI_SCENE_LOADER_MESH_DEFINITION_H