Skip to main content

Python package for Obj to Gltf conversion

Project description

Obj2gltf

Small wrapper library over pygtlflib that helps you convert your obj files into gtlf format, for something like 3.js which prefer gltf format.

Installation

pip install obj2gltf

Usuage Guide

This script converts OBJ files to GLTF format. It can process a single file or an entire folder of OBJ files. You can use it as command line tool, or import it to your own code.

Basic Usage

python -m obj2gltf <obj_path> [options]

Arguments

  1. obj_path (required): Path to the OBJ file or folder containing OBJ files.

Options

  1. --output: Path to the output GLTF file or folder. If not specified, the output will be saved in the same location as the input with a .gltf extension.

  2. --exclude_list: List of files to be excluded from processing. Useful when converting a folder of OBJ files.

  3. --colors: List of RGB color values to be applied to the converted models.

Examples

  1. Convert a single OBJ file:

    python -m obj2gltf path/to/model.obj
    
  2. Convert a single OBJ file with a specific output path:

    python -m obj2gltf path/to/model.obj --output path/to/output.gltf
    
  3. Convert all OBJ files in a folder:

    python -m obj2gltf path/to/obj_folder
    
  4. Convert all OBJ files in a folder, excluding specific files:

    python -m obj2gltf path/to/obj_folder --exclude_list "[file1.obj,file2.obj]"
    
  5. Convert an OBJ file and apply a specific color:

    python -m obj2gltf path/to/model.obj --colors "[255,0,0]"
    

Notes

  • When using --exclude_list or --colors, enclose the list in square brackets and separate items with commas, without spaces.
  • Color values should be integers between 0 and 255 for each RGB component.
  • If processing a folder, the script will maintain the folder structure in the output.

Alternative Usuage

Import the Obj2Gltf class to your own code.

from obj2gltf import Obj2Gltf

For any issues or further questions, please refer to the documentation or contact the developer.

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

obj2gltf-0.1.3.tar.gz (3.9 kB view details)

Uploaded Source

Built Distribution

obj2gltf-0.1.3-py3-none-any.whl (4.2 kB view details)

Uploaded Python 3

File details

Details for the file obj2gltf-0.1.3.tar.gz.

File metadata

  • Download URL: obj2gltf-0.1.3.tar.gz
  • Upload date:
  • Size: 3.9 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: poetry/1.6.1 CPython/3.11.5 Darwin/24.0.0

File hashes

Hashes for obj2gltf-0.1.3.tar.gz
Algorithm Hash digest
SHA256 a6f754a2acde45b67462f3d9108333b67cad14a0ddd26be8c14a4ffbafcbf6b2
MD5 d376f816219a39484b09a788b00aefdd
BLAKE2b-256 b553f59266ae882867858d37d31a81426f3835bb1d823b67e79174fa6f8f4abb

See more details on using hashes here.

File details

Details for the file obj2gltf-0.1.3-py3-none-any.whl.

File metadata

  • Download URL: obj2gltf-0.1.3-py3-none-any.whl
  • Upload date:
  • Size: 4.2 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: poetry/1.6.1 CPython/3.11.5 Darwin/24.0.0

File hashes

Hashes for obj2gltf-0.1.3-py3-none-any.whl
Algorithm Hash digest
SHA256 7febafa9111bccb370e0c35ea6f43741b4778b51b7c0e62678925b78a2822d3d
MD5 6d4dbf01c564b5bd933c18122c57430d
BLAKE2b-256 c53637f83ec5e7b0da4c86e975d8dd9fce42d6e31f29c891716f2c508e41598d

See more details on using hashes here.

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