cesium-native 0.44.2
Loading...
Searching...
No Matches
GltfReader.h
1#pragma once
2
3#include <CesiumAsync/AsyncSystem.h>
4#include <CesiumAsync/Future.h>
5#include <CesiumAsync/HttpHeaders.h>
6#include <CesiumAsync/IAssetAccessor.h>
7#include <CesiumGltf/ImageAsset.h>
8#include <CesiumGltf/Ktx2TranscodeTargets.h>
9#include <CesiumGltf/Model.h>
10#include <CesiumGltfReader/GltfSharedAssetSystem.h>
11#include <CesiumGltfReader/ImageDecoder.h>
12#include <CesiumGltfReader/Library.h>
13#include <CesiumJsonReader/IExtensionJsonHandler.h>
14#include <CesiumJsonReader/JsonReaderOptions.h>
15
16#include <functional>
17#include <memory>
18#include <optional>
19#include <span>
20#include <string>
21#include <vector>
22
24
29struct CESIUMGLTFREADER_API GltfReaderResult {
33 std::optional<CesiumGltf::Model> model;
34
38 std::vector<std::string> errors;
39
43 std::vector<std::string> warnings;
44};
45
49struct CESIUMGLTFREADER_API GltfReaderOptions {
54 bool decodeDataUrls = true;
55
62 bool clearDecodedDataUrls = true;
63
72 bool decodeEmbeddedImages = true;
73
77 bool resolveExternalImages = true;
78
83 bool decodeDraco = true;
84
90 bool decodeMeshOptData = true;
91
97 bool dequantizeMeshData = true;
98
103 bool applyTextureTransform = true;
104
110
116 GltfSharedAssetSystem::getDefault();
117
122 bool resolveExternalStructuralMetadata = true;
123};
124
128class CESIUMGLTFREADER_API GltfReader {
129public:
134
139
144
153 const std::span<const std::byte>& data,
154 const GltfReaderOptions& options = GltfReaderOptions()) const;
155
168 const CesiumAsync::AsyncSystem& asyncSystem,
169 const std::string& url,
170 const std::vector<CesiumAsync::IAssetAccessor::THeader>& headers,
171 const std::shared_ptr<CesiumAsync::IAssetAccessor>& pAssetAccessor,
172 const GltfReaderOptions& options = GltfReaderOptions()) const;
173
181 void
183
197 const CesiumAsync::AsyncSystem& asyncSystem,
198 const std::string& baseUrl,
199 const CesiumAsync::HttpHeaders& headers,
200 const std::shared_ptr<CesiumAsync::IAssetAccessor>& pAssetAccessor,
201 const GltfReaderOptions& options,
202 GltfReaderResult&& result);
203
208 [[deprecated(
209 "Use ImageDecoder::readImage instead.")]] static ImageReaderResult
211 const std::span<const std::byte>& data,
212 const CesiumGltf::Ktx2TranscodeTargets& ktx2TranscodeTargets);
213
218 [[deprecated("Use ImageDecoder::generateMipMaps instead.")]] static std::
219 optional<std::string>
221
222private:
224};
225
226} // namespace CesiumGltfReader
A system for managing asynchronous requests and tasks.
Definition AsyncSystem.h:36
A value that will be available in the future, as produced by AsyncSystem.
Definition Promise.h:12
Reads glTF models and images.
Definition GltfReader.h:128
GltfReaderResult readGltf(const std::span< const std::byte > &data, const GltfReaderOptions &options=GltfReaderOptions()) const
Reads a glTF or binary glTF (GLB) from a buffer.
GltfReader()
Constructs a new instance.
const CesiumJsonReader::JsonReaderOptions & getExtensions() const
Gets the options controlling how the JSON is read.
static CesiumAsync::Future< GltfReaderResult > resolveExternalData(const CesiumAsync::AsyncSystem &asyncSystem, const std::string &baseUrl, const CesiumAsync::HttpHeaders &headers, const std::shared_ptr< CesiumAsync::IAssetAccessor > &pAssetAccessor, const GltfReaderOptions &options, GltfReaderResult &&result)
Accepts the result of readGltf and resolves any remaining external buffers and images.
static std::optional< std::string > generateMipMaps(CesiumGltf::ImageAsset &image)
Generate mipmaps for this image.
void postprocessGltf(GltfReaderResult &readGltf, const GltfReaderOptions &options)
Performs post-load processing on a glTF. The specific operations performed are controlled by the prov...
static ImageReaderResult readImage(const std::span< const std::byte > &data, const CesiumGltf::Ktx2TranscodeTargets &ktx2TranscodeTargets)
Reads an Image from a buffer.
CesiumAsync::Future< GltfReaderResult > loadGltf(const CesiumAsync::AsyncSystem &asyncSystem, const std::string &url, const std::vector< CesiumAsync::IAssetAccessor::THeader > &headers, const std::shared_ptr< CesiumAsync::IAssetAccessor > &pAssetAccessor, const GltfReaderOptions &options=GltfReaderOptions()) const
Reads a glTF or binary glTF file from a URL and resolves external buffers and images.
CesiumJsonReader::JsonReaderOptions & getOptions()
Gets the options controlling how the JSON is read.
Holds options for reading statically-typed data structures from JSON.
A smart pointer that calls addReference and releaseReference on the controlled object.
std::map< std::string, std::string, CaseInsensitiveCompare > HttpHeaders
Http Headers that maps case-insensitive header key with header value.
Definition HttpHeaders.h:25
Classes for reading glTF models.
Definition GltfReader.h:23
Options for how to read a glTF.
Definition GltfReader.h:49
CesiumGltf::Ktx2TranscodeTargets ktx2TranscodeTargets
For each possible input transmission format, this struct names the ideal target gpu-compressed pixel ...
Definition GltfReader.h:109
The result of reading a glTF model with GltfReader::readGltf.
Definition GltfReader.h:29
std::optional< CesiumGltf::Model > model
The read model, or std::nullopt if the model could not be read.
Definition GltfReader.h:33
std::vector< std::string > errors
Errors, if any, that occurred during the load process.
Definition GltfReader.h:38
std::vector< std::string > warnings
Warnings, if any, that occurred during the load process.
Definition GltfReader.h:43
The result of reading an image with ImageDecoder::readImage.
A 2D image asset, including its pixel data. The image may have mipmaps, and it may be encoded in a GP...
Definition ImageAsset.h:34
For each possible input transmission format, this struct names the ideal target gpu-compressed pixel ...