tinygltfloader

by syoyo

Header only C++ Tiny glTF loader.

213 Stars 29 Forks Last release: Not found 120 Commits 2 Releases

Available items

No Items, yet!

The developer of this repository has not created any items for sale yet. Need a bug fixed? Help with integration? A different license? Create a request here:

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

Build Status

Build status

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/KHRbinaryglTF)
  • 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 : Simple glTF geometry viewer.
  • writer : Simple glTF writer(serialize
    tinygltf::Scene
    class)
  • alembictogltf : Simple Alembic to glTF converter.
  • cyhairtogltf : 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
  • stbimage.h : v2.08 - public domain image loader - http://nothings.org/stbimage.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

We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.