# obj-toolkit

使用 `fbx2gltf`、`obj2gltf`、`gltf-pipeline` 处理模型。

## Install

```bash
npm install -g obj-toolkit
```

## 配置信息 config

- 支持 `fbx` 转化为 `glb` 和 `gltf`
- 支持 `obj` 转化为 `glb` 和 `gltf`
- 支持 `glb` 和 `gltf` 相互转化
- 支持 `gltf` 的压缩

## 使用

### 支持的参数

> 注意，如果别名多于 **2** 个字符时，需要使用 `--alias` 来进行使用

执行方式：

- `-p` obj -> gltf
- `-q` obj -> gltf
- `-x` gltf -> glb
- `-y` glb -> gltf
- `-b` fbx -> glb
- `-f` fbx -> gltf

输出额外配置项：

- `-i` 目标文件或目录，默认当前文件夹
- `-o` 输出文件或目录，默认当前文件夹
- `-m` 压缩模型
- `-s` bin 文件独立 gltf `optimizeGltf` 起效
- `-t` 材质独立 gltf `optimizeGltf` 起效
- `-d` debug 模式 输出相关参数

不设置执行参数时，默认使用 `toGltf`

### 命令行

```bash
# 查看版本
objkit -v
# obj
# 当前目录下的所有 obj
objkit -p # obj -> gltf
objkit -q # obj -> glb
# 指定 obj 文件
objkit -p -i path/ttt.obj -o path/ttt.gltf

# gltf minify
objkit -x # gltf -> glb
objkit -y # glb -> gltf

objkit -y -m # 压缩 gltf
objkit -y -t # 提取材质
objkit -y -s # 提取独立的bin文件

objkit -b # fbx -> glb
objkit -f # fbx -> gltf
objkit -b -m # fbx -> glb, 压缩 glb
# fbx -> gltf 压缩模式，建议采用如下方式（由于fbx方式会自动创建独立的 buffer.bin 文件）：

# 1. fbx -> glb
objkit -b
# 2. glb -> gltf, 再压缩
objkit -y -m

```

## author

ilex.h

## changelog

- 2019-10-23 v1.0.0 init

## Lecense

MIT