Tiny but powerful Wavefront OBJ loader

Navigation

Verified details

These details have been verified by PyPI
Maintainers
Avatar for paulmelnikow from gravatar.com paulmelnikow Avatar for syoyo from gravatar.com syoyo

Unverified details

These details have not been verified by PyPI
Project links
Meta
  • License: ISC License (ISCL), MIT License
  • Author: Syoyo Fujita
Classifiers

Project description

tinyobjloader, Wavefront .obj loader

tinyobjloader is a python wrapper for C++ wavefront .obj loader. tinyobjloader is rather fast and feature rich than other pure python version of .obj loader.

Requirements

  • python 3.x(3.6+ recommended)
    • python 2.7 may work, but not officially supported.

Install

You can install tinyobjloader with pip.

$ pip install tinyobjloader

Quick tutorial

import sys
import tinyobjloader

# Create reader.
reader = tinyobjloader.ObjReader()

filename = "cornellbox.obj"

# Load .obj(and .mtl) using default configuration
ret = reader.ParseFromFile(filename)

if ret == False:
    print("Warn:", reader.Warning())
    pint("Err:", reader.Error())
    print("Failed to load : ", filename)

    sys.exit(-1)

if reader.Warning():
    print("Warn:", reader.Warning())

attrib = reader.GetAttrib()
print("attrib.vertices = ", len(attrib.vertices))
print("attrib.normals = ", len(attrib.normals))
print("attrib.texcoords = ", len(attrib.texcoords))

materials = reader.GetMaterials()
print("Num materials: ", len(materials))
for m in materials:
    print(m.name)
    print(m.diffuse)

shapes = reader.GetShapes()
print("Num shapes: ", len(shapes))
for shape in shapes:
    print(shape.name)
    print("num_indices = {}".format(len(shape.mesh.indices)))

More detailed usage

Please take a look at python/sample.py file in tinyobjloader git repo.

https://github.com/syoyo/tinyobjloader/blob/master/python/sample.py

How to build

Using cibuildwheel is an recommended way to build a python module. See $tinyobjloader/azure-pipelines.yml for details.

Developer build

Edit setup.py and uncomment Developer option lines

Assume pip is installed.

$ pip install pybind11
$ python setup.py build

License

MIT(tinyobjloader) and ISC(mapbox earcut) license.

TODO

  • Writer saver

Project details

Verified details

These details have been verified by PyPI
Maintainers
Avatar for paulmelnikow from gravatar.com paulmelnikow Avatar for syoyo from gravatar.com syoyo

Unverified details

These details have not been verified by PyPI
Project links
Meta
  • License: ISC License (ISCL), MIT License
  • Author: Syoyo Fujita
Classifiers

Release history Release notifications | RSS feed

2.0.0rc13 pre-release

2.0.0rc12 pre-release

2.0.0rc11 pre-release

This version

2.0.0rc9 pre-release

2.0.0rc8 pre-release

2.0.0rc7 pre-release

2.0.0rc6 pre-release

2.0.0rc5 pre-release

0.1

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

tinyobjloader-2.0.0rc9.tar.gz (29.4 kB view hashes)

Uploaded Source

Built Distributions

tinyobjloader-2.0.0rc9-pp37-pypy37_pp73-win_amd64.whl (135.3 kB view hashes)

Uploaded PyPy Windows x86-64

tinyobjloader-2.0.0rc9-pp37-pypy37_pp73-manylinux_2_12_x86_64.manylinux2010_x86_64.whl (184.6 kB view hashes)

Uploaded PyPy manylinux: glibc 2.12+ x86-64

tinyobjloader-2.0.0rc9-pp37-pypy37_pp73-manylinux_2_12_i686.manylinux2010_i686.whl (197.9 kB view hashes)

Uploaded PyPy manylinux: glibc 2.12+ i686

tinyobjloader-2.0.0rc9-pp37-pypy37_pp73-macosx_10_9_x86_64.whl (156.9 kB view hashes)

Uploaded PyPy macOS 10.9+ x86-64

tinyobjloader-2.0.0rc9-cp310-cp310-win_amd64.whl (136.3 kB view hashes)

Uploaded CPython 3.10 Windows x86-64

tinyobjloader-2.0.0rc9-cp310-cp310-win32.whl (118.3 kB view hashes)

Uploaded CPython 3.10 Windows x86

tinyobjloader-2.0.0rc9-cp310-cp310-manylinux_2_12_x86_64.manylinux2010_x86_64.whl (2.2 MB view hashes)

Uploaded CPython 3.10 manylinux: glibc 2.12+ x86-64

tinyobjloader-2.0.0rc9-cp310-cp310-manylinux_2_12_i686.manylinux2010_i686.whl (2.2 MB view hashes)

Uploaded CPython 3.10 manylinux: glibc 2.12+ i686

tinyobjloader-2.0.0rc9-cp310-cp310-macosx_10_9_x86_64.whl (181.8 kB view hashes)

Uploaded CPython 3.10 macOS 10.9+ x86-64

tinyobjloader-2.0.0rc9-cp39-cp39-win_amd64.whl (133.3 kB view hashes)

Uploaded CPython 3.9 Windows x86-64

tinyobjloader-2.0.0rc9-cp39-cp39-win32.whl (118.4 kB view hashes)

Uploaded CPython 3.9 Windows x86

tinyobjloader-2.0.0rc9-cp39-cp39-manylinux_2_12_x86_64.manylinux2010_x86_64.whl (2.2 MB view hashes)

Uploaded CPython 3.9 manylinux: glibc 2.12+ x86-64

tinyobjloader-2.0.0rc9-cp39-cp39-manylinux_2_12_i686.manylinux2010_i686.whl (2.2 MB view hashes)

Uploaded CPython 3.9 manylinux: glibc 2.12+ i686

tinyobjloader-2.0.0rc9-cp39-cp39-macosx_10_9_x86_64.whl (181.9 kB view hashes)

Uploaded CPython 3.9 macOS 10.9+ x86-64

tinyobjloader-2.0.0rc9-cp38-cp38-win_amd64.whl (136.3 kB view hashes)

Uploaded CPython 3.8 Windows x86-64

tinyobjloader-2.0.0rc9-cp38-cp38-win32.whl (118.2 kB view hashes)

Uploaded CPython 3.8 Windows x86

tinyobjloader-2.0.0rc9-cp38-cp38-manylinux_2_12_x86_64.manylinux2010_x86_64.whl (2.2 MB view hashes)

Uploaded CPython 3.8 manylinux: glibc 2.12+ x86-64

tinyobjloader-2.0.0rc9-cp38-cp38-manylinux_2_12_i686.manylinux2010_i686.whl (2.2 MB view hashes)

Uploaded CPython 3.8 manylinux: glibc 2.12+ i686

tinyobjloader-2.0.0rc9-cp38-cp38-macosx_10_9_x86_64.whl (181.8 kB view hashes)

Uploaded CPython 3.8 macOS 10.9+ x86-64

tinyobjloader-2.0.0rc9-cp37-cp37m-win_amd64.whl (136.5 kB view hashes)

Uploaded CPython 3.7m Windows x86-64

tinyobjloader-2.0.0rc9-cp37-cp37m-win32.whl (119.0 kB view hashes)

Uploaded CPython 3.7m Windows x86

tinyobjloader-2.0.0rc9-cp37-cp37m-manylinux_2_12_x86_64.manylinux2010_x86_64.whl (2.3 MB view hashes)

Uploaded CPython 3.7m manylinux: glibc 2.12+ x86-64

tinyobjloader-2.0.0rc9-cp37-cp37m-manylinux_2_12_i686.manylinux2010_i686.whl (2.2 MB view hashes)

Uploaded CPython 3.7m manylinux: glibc 2.12+ i686

tinyobjloader-2.0.0rc9-cp37-cp37m-macosx_10_9_x86_64.whl (180.2 kB view hashes)

Uploaded CPython 3.7m macOS 10.9+ x86-64

tinyobjloader-2.0.0rc9-cp36-cp36m-win_amd64.whl (136.4 kB view hashes)

Uploaded CPython 3.6m Windows x86-64

tinyobjloader-2.0.0rc9-cp36-cp36m-win32.whl (119.0 kB view hashes)

Uploaded CPython 3.6m Windows x86

tinyobjloader-2.0.0rc9-cp36-cp36m-manylinux_2_12_x86_64.manylinux2010_x86_64.whl (2.3 MB view hashes)

Uploaded CPython 3.6m manylinux: glibc 2.12+ x86-64

tinyobjloader-2.0.0rc9-cp36-cp36m-manylinux_2_12_i686.manylinux2010_i686.whl (2.2 MB view hashes)

Uploaded CPython 3.6m manylinux: glibc 2.12+ i686

tinyobjloader-2.0.0rc9-cp36-cp36m-macosx_10_9_x86_64.whl (180.2 kB view hashes)

Uploaded CPython 3.6m macOS 10.9+ x86-64

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page