Skip to main content

glTF utilities for Panda3D

Project description

Build Status Panda3D Versions

panda3d-gltf

This project adds glTF loading capabilities to Panda3D. One long-term goal for this project is to be used as a reference for adding a builtin, C++ glTF loader to Panda3D. If and when Panda3D gets builtin support for glTF, this module will go into maintenance mode and be used to backport glTF support to older versions of Panda3D.

Features

  • Adds support for native loading of glTF files
  • Supports glTF 2.0 excluding morph targets
  • Supports binary glTF
  • Includes support for the following extensions:
    • KHR_lights (deprecated in favor of KHR_lights_punctual)
    • KHR_lights_punctual
    • BLENDER_physics
  • Ships with a gltf2bam cli-tool for converting glTF files to BAM
  • Ships with gltf-viewer for viewing files (including glTF) with a simple PBR renderer

Installation

Use pip to install the panda3d-gltf package:

pip install panda3d-gltf

To grab the latest development build, use:

pip install git+https://github.com/Moguri/panda3d-gltf.git

Usage

Native loading

panda3d-gltf ships with a Python file loader (requires Panda3D 1.10.4+), which seamlessly adds glTF support to Panda3D's Loader classes. This does not add support to pview, which is a C++ application that does not support loading Python file loaders. Instead of pview, use the gltf-viewer that ships with panda3d-gltf. For those that need to support Panda3D 1.10.3 or lower, panda3d-gltf also supplies a patch_loader() function to monkey-patch glTF support to ShowBase.loader:

import gltf

class App(ShowBase):
    def __init__(self):
        ...
        gltf.patch_loader(self.loader)
        ...

On Panda3D 1.10.4+, this function will leave self.loader alone in favor of relying on the Python file loader.

Command Line

To convert glTF files to BAM via the command line, use the supplied gltf2bam tool:

gltf2bam source.gltf output.bam

Viewer

panda3d-gltf ships with gltf-viewer. This is a simple viewer (like pview) to view glTF (or any other file format support by Panda3D) with a simple, PBR renderer.

API Stability

Since panda3d-gltf has not reached a 1.0 release, its API should not be considered "stable." However, this mostly applies to internals, and effort will be put into keeping the gltf2bam API from breaking. patch_loader() will also be kept stable, but will eventually be phased out in favor of the Python file loader.

Running tests

python setup.py test

License

B3D 3-Clause

Project details


Download files

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

Source Distribution

panda3d-gltf-0.2.tar.gz (20.5 kB view details)

Uploaded Source

Built Distribution

panda3d_gltf-0.2-py3-none-any.whl (21.2 kB view details)

Uploaded Python 3

File details

Details for the file panda3d-gltf-0.2.tar.gz.

File metadata

  • Download URL: panda3d-gltf-0.2.tar.gz
  • Upload date:
  • Size: 20.5 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/1.14.0 pkginfo/1.5.0.1 requests/2.22.0 setuptools/41.2.0 requests-toolbelt/0.9.1 tqdm/4.35.0 CPython/3.7.1

File hashes

Hashes for panda3d-gltf-0.2.tar.gz
Algorithm Hash digest
SHA256 9bae059df7f3f62839f2487380a3009861feaa974228d4da810f3f944f098d56
MD5 5d5e422a736659ae887ded084d48e4b8
BLAKE2b-256 c0db7ecccdc88440306c08214a3285f97379c79a7be6648d3e455a9b3c47e266

See more details on using hashes here.

File details

Details for the file panda3d_gltf-0.2-py3-none-any.whl.

File metadata

  • Download URL: panda3d_gltf-0.2-py3-none-any.whl
  • Upload date:
  • Size: 21.2 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/1.14.0 pkginfo/1.5.0.1 requests/2.22.0 setuptools/41.2.0 requests-toolbelt/0.9.1 tqdm/4.35.0 CPython/3.7.1

File hashes

Hashes for panda3d_gltf-0.2-py3-none-any.whl
Algorithm Hash digest
SHA256 273577a3ab63eb0bbde84d1aaaafbeb325000e050413eb3cbdceb1bdaffe9ad3
MD5 0adeda5b6e47dac709f29c63e1488bac
BLAKE2b-256 a1adf5e5b6e02fbec42befc8d47316563f655ce5a6a4f7a8c469501350c1adb7

See more details on using hashes here.

Supported by

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