13

在 2018 年的 WWDC 上,Apple宣布引入新的 USDZ 文件格式。

关于创建 USDZ 文件,有人说:

为了创建您自己的 usdz 文件,一个 usdz_converter 已捆绑为 Xcode 10 beta 的一部分。它是一个命令行工具,用于从 OBJ 文件、单帧 Alembic (ABC) 文件、USD 文件(.usda 或 usd.c)创建 usdz 文件

基本命令行是

xcrun usdz_converter myFile.obj myFile.usdz

我已经安装了 Xcode 10 beta,但无法运行,甚至无法在 2018 年 6 月 4 日提供的 Xcode 10 beta 包(build 10L176w)中找到 usdz_converter。

注意:我仍在 macOS highSierra 上运行,我还没有安装 macOS Mojave 10.14 beta ......但我认为这不应该是原因。

有没有其他人能够让这个 xcrun usdz_converter 工作?

如果是,请分享步骤。

4

3 回答 3

26

更新日期:2021 年 12 月 20 日

usdzconvertXcode 13、12、11 中的命令

macOS Monterey中,Big SurCatalina USDZ converter拥有丰富的命令集,并且支持比之前版本更多的输入格式进行转换。但在使用之前,您需要下载USDZ Tools。并且不要忘记为 Python usdz 工具设置一个全局变量以下是终端中新命令的外观:

usdzconvert ~/Desktop/file.gltf -diffuseColor albedo.png -metallic brass.jpg
  • 在 macOS Monterey、Big Sur 和 Catalina 中,默认的命令 shell 是 ZSH


创建外壳资源文件

如果您想使用USDPython工具,您需要创建一个 Shell 资源文件.zshrc

change directory为此,使用终端中的命令转到主页区域:

cd /Users/<UserName>

使用命令检查您是否在那里parent working directory

pwd

然后键入目录内容的ls命令,listing包括隐藏文件:

ls -a

现在您已准备好创建一个隐藏.zshrc文件:

touch ~/.zshrc

使用以下命令打开此文件:

open ~/.zshrc

现在您可以将这些行添加到 zsh 资源文件中:

export PATH="/Users/yourUserName/usdpython/USD:$PATH"
export PATH="/Users/yourUserName/usdpython/usdzconvert:$PATH"
export PYTHONPATH="/Users/yourUserName/usdpython/USD/lib/python:$PYTHONPATH"

echo "Now I can use USDPython commands here."

保存并重新启动终端。

usdzconvert是一个 Python 脚本,可将以下资产转换为usdz

  • 对象
  • gltf
  • FBX
  • 美国广播公司
  • 美国农业部
  • 美元兑美元
  • 美元

如果您需要使用FBX格式转换,您必须下载并安装FBX Python SDK

然后在文件中再添加.zshrc一行:

export PYTHONPATH="/Applications/Autodesk/FBXPythonSDK/2020.0.1/lib/Python27_ub:$PYTHONPATH"

保存.zshrc文件并重新启动终端。

这是您可以在终端中看到的完整选项列表,键入usdzconvert -h

# DON'T USE usdzconvert 0.63 BECAUSE IT CAUSES ERRORS.

# USE usdzconvert 0.64
# or
# USE usdzconvert 0.62

outputFile                           Output .usd/usda/usdc/usdz files.
-h, --help                           Show this help message and exit.
-f <file>                            Read arguments from <file>
-v                                   Verbose output.
-url <url>                           Add URL metadata
-copyright "copyright message"       Add copyright metadata
-copytextures                        Copy texture files (for .usd/usda/usdc) workflows
-metersPerUnit value                 Set metersPerUnit attribute with float value
-loop                                Set animation loop flag to 1
-no-loop                             Set animation loop flag to 0
-m materialName                      Subsequent material arguments apply to this material.
-iOS12                               Make output file compatible with iOS 12 frameworks
-texCoordSet name                    The name of the texture coordinates to use for current material.
                        
-diffuseColor r,g,b                  Set diffuseColor to constant color r,g,b with values in the range [0 .. 1]
-diffuseColor <file> fr,fg,fb        Use <file> as texture for diffuseColor.
                                     fr,fg,fb: (optional) constant fallback color, with values in the range [0..1].
                        
-normal x,y,z                        Set normal to constant value x,y,z in tangent space [(-1, -1, -1), (1, 1, 1)].
-normal <file> fx,fy,fz              Use <file> as texture for normal.
                                     fx,fy,fz: (optional) constant fallback value, with values in the range [-1..1].
                        
-emissiveColor r,g,b                 Set emissiveColor to constant color r,g,b with values in the range [0..1]
-emissiveColor <file> fr,fg,fb       Use <file> as texture for emissiveColor.
                                     fr,fg,fb: (optional) constant fallback color, with values in the range [0..1].
                        
-metallic c                          Set metallic to constant c, in the range [0..1]
-metallic ch <file> fc               Use <file> as texture for metallic.
                                     ch: (optional) texture color channel (r, g, b or a).
                                     fc: (optional) fallback constant in the range [0..1]
                        
-roughness c                         Set roughness to constant c, in the range [0..1]
-roughness ch <file> fc              Use <file> as texture for roughness.
                                     ch: (optional) texture color channel (r, g, b or a).
                                     fc: (optional) fallback constant in the range [0..1]
                        
-occlusion c                         Set occlusion to constant c, in the range [0..1]
-occlusion ch <file> fc              Use <file> as texture for occlusion.
                                     ch: (optional) texture color channel (r, g, b or a).
                                     fc: (optional) fallback constant in the range [0..1]
                        
-opacity c                           Set opacity to constant c, in the range [0..1]
-opacity ch <file> fc                Use <file> as texture for opacity.
                                     ch: (optional) texture color channel (r, g, b or a).
                                     fc: (optional) fallback constant in the range [0..1]

-clearcoat c                         Set clearcoat to constant c, in the range [0..1]
-clearcoat ch <file> fc              Use <file> as texture for clearcoat.
                                     ch: (optional) texture color channel (r, g, b or a).
                                     fc: (optional) fallback constant in the range [0..1]

-clearcoatRoughness c                Set clearcoat roughness to constant c, in the range [0..1]
-clearcoatRoughness ch <file> fc     Use <file> as texture for clearcoat roughness.
                                     ch: (optional) texture color channel (r, g, b or a).
                                     fc: (optional) fallback constant in the range [0..1]


或者,您可以使用Reality Converter应用程序 (GUI),而不是使用命令行转换工具 (CLI)。新的应用程序可以轻松地.usdz在 Mac 上转换、查看和自定义对象。只需拖放常见的 3D 文件格式,例如.obj.gltf.usd,即可查看转换.usdz结果,使用您自己的纹理自定义材质属性,并编辑文件元数据。您甚至可以.usdz使用内置 IBL 选项在各种照明和环境条件下预览对象。


USDZ ExportReality Composer 中的命令

Xcode 13/12的Reality Composer中,您可以直接从 Reality Composer 的 UI导出模型。为此,您只需在 RealityComposer –首选项菜单中激活 USDZ 导出。usdz

在此处输入图像描述


您还可以使用AR USD Schemas,当然还有Autodesk Maya 2022工作流程。


从 SceneKit 的场景创建 USDZ 文件

获取 USDZ 文件的另一个好方法是使用write(to:options:delegate:progressHandler:)实例方法从 SCNScene 创建它。

让我们看一下代码:

import ARKit

class ViewController: UIViewController {

    @IBOutlet var sceneView: ARSCNView!
    let scene = SCNScene(named: "art.scnassets/ship.scn")!
    
    override func viewDidLoad() {
        super.viewDidLoad()
        
        sceneView.scene = scene
        
        let path = FileManager.default.urls(for: .documentDirectory,
                                             in: .userDomainMask)[0]
                                   .appendingPathComponent("model.usdz")
        
        scene.write(to: path, options: nil, 
              delegate: nil, progressHandler: nil)
        
        print(path)
    }
}

在此处输入图像描述


xcrun usdz_converterXcode 10 中的命令

macOS Mojave 10.14Xcode 10 USDZ converter中,参数和标志集略有不同。下面是旧命令在终端中的样子:

xcrun usdz_converter file.obj file.usdz -color_map color.jpg -ao_map ao.png
  • 在 macOS Mojave 中,默认的命令 shell 是 BASH

这是您可以在终端中看到的完整选项列表,键入xcrun usdz_converter -h

-g groupName [groupNames ...]        Apply subsequent material properties to the named group(s).
-m materialName [materialNames ...]  Apply subsequent material properties to the named material(s).
-h                                   Display help.
-a                                   Generate a .usda intermediate file.  Default is .usdc.
-l                                   Leave the intermediate .usd file in the source folder.
-v                                   Verbose output.
-f                    filePath       Read commands from a file.
-texCoordSet          set            The name of the texturemap coordinate set to use if multiple exist (no quotes).
-opacity              o              Floating point value 0.0...1.0

-color_default        r g b a        Floating point values 0.0...1.0
-normal_default       r g b a        Floating point values 0.0...1.0
-emissive_default     r g b a        Floating point values 0.0...1.0
-metallic_default     r g b a        Floating point values 0.0...1.0
-roughness_default    r g b a        Floating point values 0.0...1.0
-ao_default           r g b a        Floating point values 0.0...1.0

-color_map            filePath
-normal_map           filePath
-emissive_map         filePath
-metallic_map         filePath
-roughness_map        filePath
-ao_map               filePath
于 2018-06-14T22:56:57.103 回答
7

您必须启用 Xcode 10 命令行工具Xcode > Preferences > Locations

例子

于 2018-06-15T14:51:49.167 回答
0

您必须在 Xcode 首选项中激活命令行工具,以防它们尚未激活(这是我的情况)。请参阅此主题:

如何创建 USDZ 文件?

于 2018-06-14T14:29:01.067 回答