semvec/pypi-packages huggingface dataset:
obj2gltf 0.1.3
Python package for Obj to Gltf conversion
License: MIT
Requires Python: <3.13,>=3.9

# 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

2. `--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.

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

4. `--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.