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

Metadata

Release files for panda3d-gltf 0.2

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for panda3d-gltf 0.2
File	Size	Uploaded
panda3d-gltf-0.2.tar.gz	20.5 kB	Sep 13, 2019	Details

Built distribution (wheel)

Table of built distributions (wheels) for panda3d-gltf 0.2
File	Interpreter	ABI	Platform	Reset
panda3d_gltf-0.2-py3-none-any.whl 21.2 kB Sep 13, 2019	Python 3	none	any	Details

Total release size: 41.8 kB

Release files / panda3d-gltf-0.2.tar.gz

Download URL	panda3d-gltf-0.2.tar.gz
Size	20.5 kB
Tags	Source
SHA-256 checksum How to use checksums	`9bae059df7f3f62839f2487380a3009861feaa974228d4da810f3f944f098d56`
BLAKE2b-256 checksum How to use checksums	`c0db7ecccdc88440306c08214a3285f97379c79a7be6648d3e455a9b3c47e266`
Upload date	Sep 13, 2019
Uploaded using Trusted Publishing? What is 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`

Release files / panda3d_gltf-0.2-py3-none-any.whl

Download URL	panda3d_gltf-0.2-py3-none-any.whl
Size	21.2 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`273577a3ab63eb0bbde84d1aaaafbeb325000e050413eb3cbdceb1bdaffe9ad3`
BLAKE2b-256 checksum How to use checksums	`a1adf5e5b6e02fbec42befc8d47316563f655ce5a6a4f7a8c469501350c1adb7`
Upload date	Sep 13, 2019
Uploaded using Trusted Publishing? What is 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`