syoyo/tinygltf
Tinygltf
tinygltf is a C++ library designed as a parser, serializer, and validation tool for 3D models in the glTF 2.0 binary and JSON formats. It functions as a streaming processor that can handle large 3D asset files incrementally through a callback-driven approach to reduce memory overhead.
The library uses a header-only implementation to simplify integration. It employs memory mapping to map binary buffers directly into memory and utilizes a symmetric parse-write pipeline to maintain data consistency between reading and writing files.
The system provides capabilities for 3D asset processing, including the ability to locate attributes within binary blobs via offset-based resolution. It also includes diagnostic utilities for identifying malformed assets by generating error reports with severity levels and exact file locations.
Features
- GLTF Model Importers - Implements a full parser for loading glTF 2.0 assets from binary or text files into usable data structures.
- Incremental Data Streaming - Processes 3D assets that exceed available system memory through incremental data streaming.
- Large Dataset Streaming - Handles massive glTF files through incremental streaming to prevent high memory usage in complex scenes.
- glTF Exporters - Provides tools for serializing 3D scene data into glTF 2.0 binary formats with embedded buffers.
- Incremental Streamers - Provides incremental streaming of large 3D assets via callbacks to minimize memory consumption.
- 3D Model Exporters - Exports internal 3D geometry and scene data into portable glTF files for software exchange.
- glTF Asset Processors - Provides comprehensive utilities for reading and writing glTF 3D models in binary and text formats.
- Streaming Processors - Implements a streaming processor for large 3D assets to maintain constant memory usage regardless of file size.
- Offset-Based Addressing - Uses relative byte offsets within binary blobs to locate specific 3D attributes without full parsing.
- glTF Validators - Generates detailed error logs with severity levels and file locations to identify malformed glTF assets.
- Memory Mappings - Maps binary glTF buffers directly into the process address space to prevent expensive data duplication.
- Contiguous Memory Buffers - Stores 3D geometry and animation data in flat, contiguous memory blocks for high-performance access.
- Parse Error Reporters - Reports syntax and encoding errors in glTF assets with detailed offsets for debugging.
- Symmetric Read-Write Pipelines - Utilizes a symmetric parse-write pipeline to maintain data consistency during 3D asset manipulation.
- Serialization and Formats - Header-only glTF 2.0 library.
- Graphics and Games - Tiny glTF 2.0 library for C++.
