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 hashes)

Uploaded Source

Built Distribution

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

Uploaded Python 3

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