https://github.com/syoyo/tinygltfloader

Header only C++ Tiny glTF loader.
https://github.com/syoyo/tinygltfloader

cpp gltf

Last synced: 5 days ago
JSON representation

Header only C++ Tiny glTF loader.

• Host: GitHub
• URL: https://github.com/syoyo/tinygltfloader
• Owner: syoyo
• Created: 2015-12-20T11:26:43.000Z (almost 9 years ago)
• Default Branch: master
• Last Pushed: 2019-11-20T13:26:13.000Z (almost 5 years ago)
• Last Synced: 2024-10-16T13:21:40.742Z (21 days ago)
• Topics: cpp, gltf
• Language: C
• Homepage:
• Size: 1.15 MB
• Stars: 252
• Watchers: 21
• Forks: 34
• Open Issues: 3
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

        
# Tiny glTF loader, header only C++ glTF 1.x parsing library.

`TinyGLTFLoader` is a header only C++ glTF 1.x https://github.com/KhronosGroup/glTF parsing library.

**TinyGLTFLoader is deprecated. Please go https://github.com/syoyo/tinygltf for glTF 2.0 parser/serializer**

![](images/glview_duck.png)

[![Build Status](https://travis-ci.org/syoyo/tinygltfloader.svg?branch=master)](https://travis-ci.org/syoyo/tinygltfloader)

[![Build status](https://ci.appveyor.com/api/projects/status/i5ku97hf0r0quti3?svg=true)](https://ci.appveyor.com/project/syoyo/tinygltfloader)

## Features

* Portable C++. C++-03 with STL dependency only.

* Moderate parsing time and memory consumption.

* glTF specification v1.0.0

  * [x] ASCII glTF

  * [x] Binary glTF(https://github.com/KhronosGroup/glTF/tree/master/extensions/Khronos/KHR_binary_glTF)

* Buffers

  * [x] Parse BASE64 encoded embedded buffer fata(DataURI).

  * [x] Load `.bin` file.

* Image(Using stb_image)

  * [x] Parse BASE64 encoded embedded image fata(DataURI).

  * [x] Load external image file.

  * [x] PNG(8bit only)

  * [x] JPEG(8bit only)

  * [x] BMP

  * [x] GIF

## Examples

* [glview](examples/glview) : Simple glTF geometry viewer.

* [writer](examples/writer) : Simple glTF writer(serialize `tinygltf::Scene` class) 

* [alembic_to_gltf](examples/alembic_to_gltf) : Simple Alembic to glTF converter. 

* [cyhair_to_gltf](examples/cyhair_to_gltf) : Simple CyHair(hair curves) to glTF converter.

## TODOs

* [ ] Write C++ code generator from json schema for robust parsing.

* [ ] Support multiple scenes in `.gltf`

* [ ] Parse `skin`

* [ ] Compression/decompression(Open3DGC, etc)

* [ ] Support `extensions` and `extras` property

* [ ] HDR image?

## License

TinyGLTFLoader is licensed under MIT license.

TinyGLTFLoader uses the following third party libraries.

* picojson.h : Copyright 2009-2010 Cybozu Labs, Inc. Copyright 2011-2014 Kazuho Oku

* base64 : Copyright (C) 2004-2008 René Nyffenegger

* stb_image.h : v2.08 - public domain image loader - http://nothings.org/stb_image.h

## Build and example

Copy `stb_image.h`, `picojson.h` and `tiny_gltf_loader.h` to your project.

```

// Define these only in *one* .cc file.

#define TINYGLTF_LOADER_IMPLEMENTATION

#define STB_IMAGE_IMPLEMENTATION

#include "tiny_gltf_loader.h"

using namespace tinygltf;

Scene scene; 

TinyGLTFLoader loader;

std::string err;

  

bool ret = loader.LoadASCIIFromFile(scene, err, argv[1]);

//bool ret = loader.LoadBinaryFromFile(scene, err, argv[1]); // for binary glTF(.glb) 

if (!err.empty()) {

  printf("Err: %s\n", err.c_str());

}

if (!ret) {

  printf("Failed to parse glTF\n");

  return -1;

}

```

## Running tests.

### Setup

Python 2.6 or 2.7 required.

Git clone https://github.com/KhronosGroup/glTF-Sample-Models to your local dir.

### Run test

After building `loader_example`, edit `test_runner.py`, then,

    $ python test_runner.py