marlon360/gltf-to-usdz-service

GLTF转USDZ服务

镜像概述

本镜像旨在简化gltf文件到usdz文件的转换过程，避免复杂的本地环境搭建。它基于Google的usd_from_gltf库和PixarAnimationStudios的USD库构建，提供CLI和Web服务两种转换方式。

核心功能

• CLI转换：直接通过命令行快速转换本地文件
• Web服务：通过POST请求实现文件转换，支持与其他服务集成
• 共享卷支持：可通过卷共享文件，方便多服务协作转换

使用场景

• 3D模型开发者需要将gltf格式转换为usdz格式用于AR应用
• Web平台集成在线模型转换功能
• 批量处理gltf文件转换需求

配置说明

CLI方式

运行以下命令转换文件：

bash
docker run -it --rm -v $(PWD):/usr/app docker.xuanyuan.run/marlon360/usd-from-gltf:latest inputfile.glb outputfile.usdz

Web服务方式

启动服务：

bash
docker run -it --rm -v $(PWD):/usr/app -p 8080:3000 docker.xuanyuan.run/marlon360/gltf-to-usdz-service:latest

发送POST请求到/local-convert端点转换本地文件： 请求体：

json
{
    "filename": "inputfile.glb"
}

成功响应：

json
{
    "success": true,
    "outputPath": "inputfile.usdz"
}

失败响应：

json
{
    "success": false,
    "error": "错误信息"
}

### Docker Compose集成示例
```yaml
version: "3.8"
volumes:
  uploaded_files:
services:
  webserver:
    build: webserver/
    ports:
      - "8080:8080"
    volumes:
      - uploaded_files:/usr/src/app/uploads
  gltf-to-usdz-service:
    image: marlon360/gltf-to-usdz-service:latest
    volumes:
      - uploaded_files:/usr/app

该示例通过共享卷实现NodeJS服务器与转换服务的文件交互，NodeJS服务器可通过[***]请求转换上传的文件。