Fast Reader for 'Wavefront' OBJ 3D Scene Files

Wraps 'tiny_obj_loader' C++ library for reading the 'Wavefront' OBJ 3D file format including both mesh objects and materials files. The resultant R objects are either structured to match the 'tiny_obj_loader' internal data representation or in a form directly compatible with the 'rgl' package.

Travis-CI Build Status CRAN_Status_Badge

Quick Start

For the impatient ...

# install CRAN version
# use
# run examples
# get overview help for package
# help for functions
# run tests


A released version is now available on CRAN.


Development version

You can use the devtools package to install the development version:

if (!require("devtools")) install.packages("devtools")

Note: MacOS X users will need a development environment (Xcode) to compile code. Windows users need Rtools to install this way.


This package wraps the tinyobjloader C++ library available at Kudos to its author, Syoyo Fujita!

tinyobjloader is released under a liberal 2 clause BSD license, which this package therefore inherits.


readobj 0.3.2

  • fixes a test error introduced by a change in object structure for latest version of rgl (thanks to Duncan Murdoch for the fix, #3)

readobj 0.3.1

  • Rename .obj sample files to .wavefront at request of CRAN maintainers to avoid false positive object file R CMD check NOTE.

readobj 0.3

  • fix bug in .Call since RCpp update
  • documentation improvements
  • URL fixes preparing for CRAN

readobj 0.2

  • fix bug in reading of normals (#1)
  • expand paths before reading (#2)

Reference manual

It appears you don't have a PDF plugin for this browser. You can click here to download the reference manual.


0.3.2 by Gregory Jefferis, a year ago

Report a bug at

Browse source code at

Authors: Gregory Jefferis [aut, cph, cre] , Syoyo Fujita [aut, cph] (tiny_obj_loader.* are copyright Syoyo Fujita)

Documentation:   PDF Manual  

BSD_2_clause + file LICENSE license

Imports Rcpp, grDevices

Suggests testthat, rgl

Linking to Rcpp

See at CRAN