GLTF Helper

glb(web images) -> glb(basis images)

For converting gltf/glb files with embedded jpgs/pngs to glb files with embedded basisu images.

What is gltf?

glTF is a file format for 3D scenes and models using the JSON standard. It is an API-neutral runtime asset delivery format developed by the Khronos Group 3D Formats Working Group.

What is basisu?

Basis Universal is a "supercompressed" GPU texture compression system that outputs a highly compressed intermediate file format (.basis) that can be quickly transcoded to a very wide variety of GPU compressed and uncompressed pixel formats.

Features

• gltf (web images) -> glb (basisu images)
• glb (web images) -> glb (basisu images)
• glb (web images) -> glb (ktx2 images)
• glb (basisu images) -> glb (web images)
• glb (ktx2 images) -> glb (web images)
• multiple files
• custom basisu compression flags
• custom gltf-pipeline flags (support for draco)

Use cases

Unity gltf pipeline:

• GLTFUtility
• KTXUnity

See sample project ✨

Blue Pill Usage

Prerequisites

1. docker

Test

make docker-test

makefile -> check it

Red Pill Usage

Prerequisites

1. build basisu -> check it

2. install gltf-pipeline -> check it

3. Install PyPI package

pip install --user gltf-helper

Test

make cli-test

gltf-helper --help

Usage: main.py [OPTIONS] COMMAND [ARGS]...

  glb/gltf(web images) -> glb(basis images)

  A CLI to convert gltf/glb assets with png/jpg textures into glb assets
  with embedded basis/ktx2 textures.

  Made with typer -> [check it](https://github.com/tiangolo/typer)

Options:
  --install-completion  Install completion for the current shell.
  --show-completion     Show completion for the current shell, to copy it or
                        customize the installation.

  --help                Show this message and exit.

Commands:
  convert     Convert a glb/gltf(web images) -> glb(basis images)
  expand-glb  Expand a glb

CLI readme -> check it