# USDZ Tool

## 1. App Download

> Currently the tool only supports macOS system

## 2. App Installation

### 2.1 Environment Presentation

#### 2.1.1 Option 1

* Install Xcode, click Install Xcode; if you have already installed Xcode, please make sure to use Xcode 10 and above;&#x20;
* Open Xcode, select Xcode-Preferences-Locations in turn, and make sure that the Command Line Tools option is your current Xcode version. As follows:

![](https://1498491008-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MEaYmgB-urx5wwuYcCa%2F-MFV01UexRCCjsyee3dj%2F-MFV1JeOGp46v5u_Qtoy%2FUSDZ.png?alt=media\&token=f86ed949-7edf-430d-9b3c-836caa961a26)

#### 2.1.2 Scheme Two&#x20;

**2.1.2.1 Install by downloading Command Line Tools Install Command Line Tools, click install directly after downloading**. \
1\. macOS10.14: [Click to install ](https://developer.apple.com/unauthorized/)\
2\. macOS10.13: [Click to install](https://developer.apple.com/unauthorized/) \
3\. Other versions of macOS: [Click](https://idmsa.apple.com/IDMSWebAuth/signin?appIdKey=891bd3417a7776362562d2197f89480a8547b108fd934911bcbea0110d07f757\&path=%2Fdownload%2Fmore%2F\&rv=1) to get the Command Line Tools that meets your own system&#x20;

> When downloading, you need to log in to your Apple account.

**2.1.2.2 \[Recommended solution] Or install Command Line Tools by entering commands in the terminal** \
1\. Open the terminal; \
2\. Enter xcode-select --install; \
3\. Click "Install"

![](https://1498491008-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MEaYmgB-urx5wwuYcCa%2F-MFV01UexRCCjsyee3dj%2F-MFV29dkjqG0CnGY8PqY%2Fdownload.png?alt=media\&token=c136b5df-daf8-4dda-ba06-1dde67a87360)

### 2.2 Unzip the downloaded zip file

Download Address:&#x20;

{% file src="<https://1498491008-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MEaYmgB-urx5wwuYcCa%2F-MFV01UexRCCjsyee3dj%2F-MFV2N1c28fD83mt5CyM%2FKivicube%20USDZ%20Tools%20Release%20v1.0.6.zip?alt=media&token=b723edfa-467b-417e-837d-c48f0891d2a4>" %}

![](https://1498491008-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MEaYmgB-urx5wwuYcCa%2F-MFV01UexRCCjsyee3dj%2F-MFV2XpeWCdO-yFe-Las%2Fzip5.png?alt=media\&token=5f975be1-bb2c-49b2-a010-519126807e85)

### 2.3 Double-click the decompressed file

![](https://1498491008-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MEaYmgB-urx5wwuYcCa%2F-MFV01UexRCCjsyee3dj%2F-MFV2gjFDt8_XtEPovRT%2Fzip6.png?alt=media\&token=b9eef33f-7b98-464c-bba3-50bb89ca5c06)

### 2.4 Drag "USDZ Tools" to "Applications"

You can find the program you just installed on the launch pad

![](https://1498491008-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MEaYmgB-urx5wwuYcCa%2F-MFV01UexRCCjsyee3dj%2F-MFV2uN8Y5-V4qRI31iX%2Fpad.png?alt=media\&token=d0c35c5c-e37c-411b-8a02-14d2abb9c68d)

## 3. Use Tutorial

### 3.1 Support Model Format

| Format | PBR rendering support situation | Remark                                                                                                                                                                       |
| ------ | ------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| usd    | support                         | Need users to manually assign textures                                                                                                                                       |
| usdc   | support                         | Need users to manually assign textures                                                                                                                                       |
| usda   | support                         | Need users to manually assign textures                                                                                                                                       |
| obj    | support                         | Need users to manually assign textures                                                                                                                                       |
| fbx    | support                         | <p>Need users to manually assign textures</p><p>Experimental conversion support, unstable, if the effect is not correct, please use other tools to convert or export fbx</p> |
| dae    | support                         | <p>Need users to manually assign textures</p><p>Experimental conversion support, unstable, if the effect is not correct, please use other tools to convert or export fbx</p> |
| 3ds    | support                         | <p>Need users to manually assign textures</p><p>Experimental conversion support, unstable, if the effect is not correct, please use other tools to convert or export fbx</p> |
| dxf    | support                         | <p>Need users to manually assign textures</p><p>Experimental conversion support, unstable, if the effect is not correct, please use other tools to convert or export fbx</p> |

Because USDZ mainly supports PBR rendering, the model you make needs to make PBR texture maps

> Here is a model example of PBR material

{% file src="<https://1498491008-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MEaYmgB-urx5wwuYcCa%2F-MFV01UexRCCjsyee3dj%2F-MFV3o4d1FSwD2XbsvGE%2FMeetMat%20(1).zip?alt=media&token=66632bde-c6ca-44d6-9468-5216736c00cf>" %}

The software does not support animation temporarily, if you want to support animation, please contact us: <https://www.kivicube.com/#contactUs>

### 3.2 Specific use of the program

![](https://1498491008-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MEaYmgB-urx5wwuYcCa%2F-MFV01UexRCCjsyee3dj%2F-MFV4Aw05M6zaFBSILAh%2Fprogram.png?alt=media\&token=904cc842-a580-4382-a819-a8037896c4ca)

Operation video tutorial:

{% file src="<https://1498491008-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MEaYmgB-urx5wwuYcCa%2F-MFV01UexRCCjsyee3dj%2F-MFV6126HtUpJFnZmRnV%2Fvideo%201.mp4?alt=media&token=68c1e73b-da24-47a9-825f-d439e49891e0>" %}

The USDZ model is previewed in AR on iOS:

{% file src="<https://1498491008-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MEaYmgB-urx5wwuYcCa%2F-MFV01UexRCCjsyee3dj%2F-MFV67lasqGij2Anhgg8%2Fvideo%202.mp4?alt=media&token=927bfbda-0cf9-4fb9-ad43-ebcde9b8b6c8>" %}

> To view the USDZ model, you can send the file to the file program of the Apple device via "airdrop" (iOS12 or above is required), and then click the USDZ model in the file program to view it.
