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
obj_path
(required): Path to the OBJ file or folder containing OBJ files.
Options
-
--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. -
--exclude_list
: List of files to be excluded from processing. Useful when converting a folder of OBJ files. -
--colors
: List of RGB color values to be applied to the converted models.
Examples
-
Convert a single OBJ file:
python -m obj2gltf path/to/model.obj
-
Convert a single OBJ file with a specific output path:
python -m obj2gltf path/to/model.obj --output path/to/output.gltf
-
Convert all OBJ files in a folder:
python -m obj2gltf path/to/obj_folder
-
Convert all OBJ files in a folder, excluding specific files:
python -m obj2gltf path/to/obj_folder --exclude_list "[file1.obj,file2.obj]"
-
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.