Module: TinyGLTF

Defined in:
lib/tiny_gltf.rb,
lib/tiny_gltf/version.rb,
ext/tiny_gltf/rb_tiny_gltf_init.c

Defined Under Namespace

Modules: Base Classes: Accessor, Animation, AnimationChannel, AnimationSampler, Asset, Buffer, BufferView, Camera, Error, Image, Light, Material, Mesh, Model, Node, Primitive, Sampler, Scene, Skin, Texture

Constant Summary collapse

IMAGE_URI_1PX_WHITE_OPAQUE_PNG =

If a sampler exists but does not reference an image, the GLTF spec indicates we should use a default image. You can specify your own default image by calling Model#default_image=. The default default image is constructed using this data, which represents a PNG-encoded, 1-pixel, opaque white image.

('data:image/png;base64,iVBORw0KGgoAAAANS'+
'UhEUgAAAAEAAAABCAAAAAA6fptVAAAACklEQVR4'+
'nGP6DwABBQECz6AuzQAAAABJRU5ErkJggg==').freeze
VERSION = 
"2.5.0.5"

Class Method Summary collapse

Class Method Details

.load(filename_or_data[, base_dir]) ⇒ new Model

Loads a model from the given file or data string. The data string can be ASCII or binary GLTF. base_dir is used to look up external dependencies such as images. If base_dir is omitted, it defaults to either the directory containing the file (if loading a file), or '.' (if loading a data string).

Returns the new model, or raises an error if the model could not be loaded.

Returns:



16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
 
# File 'ext/tiny_gltf/rb_tiny_gltf.cpp', line 16

VALUE rb_tgltf_load(int argc, VALUE *argv, VALUE self) {
  TinyGLTF gltf;
  VALUE rstr, rbase_dir;
  rb_scan_args(argc, argv, "11", &rstr, &rbase_dir);
  VALUE is_file = rb_funcall(rb_cFile, rb_intern("exist?"), 1, rstr);

  if (NIL_P(rbase_dir)) {
    if (is_file == Qtrue) {
      rbase_dir = rb_funcall(rb_cFile, rb_intern("dirname"), 1, rstr);
    } else {
      rbase_dir = rb_str_new2(".");
    }
  }

  if (is_file) {
    VALUE rfile = rb_funcall(rb_cFile, rb_intern("open"), 2, rstr, rb_str_new2("rb"));
    rstr = rb_funcall(rfile, rb_intern("read"), 0);
    rb_funcall(rfile, rb_intern("close"), 0);
  }

  try {
    Model model;
    std::string err, warn, base_dir(StringValueCStr(rbase_dir));
    bool res;
    if (RSTRING_LEN(rstr) > 0 && *RSTRING_PTR(rstr) == 'g') { // 'glTF'
      res = gltf.LoadBinaryFromMemory(&model, &err, &warn,
                                      (unsigned char *) RSTRING_PTR(rstr), (unsigned int) RSTRING_LEN(rstr), base_dir);
    } else {
      res = gltf.LoadASCIIFromString( &model, &err, &warn,
                                      RSTRING_PTR(rstr), (unsigned int) RSTRING_LEN(rstr), base_dir);
    }
    if (err.size()  > 0) rb_raise(rb_eTinyGLTFError, "%s", err.c_str());
    if (warn.size() > 0) rb_raise(rb_eTinyGLTFError, "%s", warn.c_str());
    if (!res) rb_raise(rb_eTinyGLTFError, "unknown failure to load model");
    return rModel_new(&model);
  } catch(const std::exception &ex) {
    rb_raise(rb_eTinyGLTFError, "%s", ex.what());
  }
  return Qnil;
}