1.安装

1.1 应用下载

v1.2.0版本:

下载地址请关注弥知科技公众号后,回复”Kivicube AR模型编辑器“获取。

image.png

Google 云端硬盘:https://drive.google.com/file/d/1qleIohpAwvg3dRcoDCa6XhD3JL2dpPJ-/view?usp=sharing

更新日志:

1.2 应用安装

1.2.1 解压下载的zip文件

image.png


1.2.2 双击解压后的文件

image.png


1.2.3 将“kivicube Model Editor.app”拖拽到“应用程序”上

你可以在启动台找到刚刚安装的程序

image.png


1.2.4 安装中出现的问题

1.2.4.1 ”Kivicube Model Editor“已损坏,打不开

注意:如果出现以下提示,请参阅此链接:http://www.pc6.com/edu/168719.html


image.png


1.2.4.2 打不开”Kivicube Model Editor“,因为它不是从App Store下载

image.png


如果出现上图的提示,请点击桌面左上角的"Apple"按钮,依次点击”系统偏好设置“- ”安全性与隐私“ - ”通用“,最后点击”仍要打开

image.png


1.2.4.3 是否要把程序移动到”应用程序“文件夹中

image.png


如上图,如果出现此弹窗提示,请点击移动到”应用程序“文件夹中

1.2.4.4 无法打开"Kivicube Model Editor.app",因为Apple无法检查其是否包含恶意软件。

image.png


如果出现上图的提示,请点击桌面左上角的"Apple"按钮,依次点击”系统偏好设置“- ”安全性与隐私“ - ”通用“,最后点击”仍要打开

image.png


2.功能概述

随着AR/VR/3D行业的发展,传统的3D模型格式已经不能使用最新的潮流,glTF与USDZ模型便在这个阶段推出,其中glTF已经运用在Google Scene Viewer,USDZ运用在Apple AR Quick Look。


Kivicube平台为了达到更好的3D渲染效果,也采用了glTF格式。用户可以先通过本工具调整好模型,导出gltf或glb,然后到Kivicube上传。


至此,便诞生了AR模型编辑器,用于将传统的模型转换为AR模型,并且支持:


3.界面说明

3.1模型导入界面

当拖入FBX模型时,可以进行一些导入设置。通常情况请使用默认设置。


设置项

描述

自动计算顶点法线

1.从不:不会自动计算顶点法线;

2.总是:会自动计算顶点法线。

动画帧率

如果模型带动画,则可以转换为设置的帧率

FBX灯光

勾选后会将FBX文件中带的灯光信息转换到glTF文件中;

请注意:Kivicube不支持glTF灯光扩展,请勿勾选此项;如果用在其它地方可以勾选。

Blend Shape Normals

勾选后便保留Blend Shape Normals

Blend Shape Tangents

勾选后便保留Blend Shape Tangents


3.2 网格名称

image.png

当选中了模型的某一个网格后,右边实时预览被选中的网格(红色部分),并且下方材质名称会显示此网格对应的一个或多个材质。

3.3 材质名称


3.4 导出格式


3.5 材质编辑

材质类型

设置项

说明

金属/粗糙度

Metal/Roughness

基本颜色

Base Color

1、导出gltf/glb模型:设置贴图与设置的颜色会同时生效;设置的透明度只有当下方的“透明度”设置项设置为“透明BLEND”时生效;

2、导出usdz模型:设置贴图与设置的颜色时,只有贴图会生效;不支持设置透明度,请注意如果需要模型透明则需要设置“不透明度

不透明度

Opacity

1、导出gltf/glb模型:不支持此项

2、导出usdz模型:请注意如果需要模型透明则需要设置此项,您可以设置贴图或者直接设置不透明度值

粗糙度

Roughness

usdz模型模拟无光照材质时,此项设置为0%

金属光泽

Metallic

usdz模型模拟无光照材质时,此项设置为0%

透明涂层

Clear Coat

导出gltf/glb模型:不支持此项

透明涂层粗糙度

Clear Coat Roughness

导出gltf/glb模型:不支持此项

自发光

Emission

1、导出gltf/glb模型:设置贴图与设置的颜色会同时生效;

2、导出usdz模型:设置贴图与设置的颜色时,只有贴图会生效;

环境光遮蔽

Occlusion

usdz模型模拟无光照材质时,此项设置为空

法线

Normal


镜面/光泽度

Specular/Glossiness

漫反射

Diffuse

1、导出gltf/glb模型:设置贴图与设置的颜色会同时生效;设置的透明度只有当下方的“透明度”设置项设置为“透明BLEND”时生效;

2、导出usdz模型:不支持

镜面

Specular

导出usdz模型:不支持

光泽度

Glossiness

导出usdz模型:不支持

自发光

Emission

1、导出gltf/glb模型:设置贴图与设置的颜色会同时生效;

2、导出usdz模型:不支持

环境光遮蔽

Occlusion

导出usdz模型:不支持

法线

Normal

导出usdz模型:不支持

无光照

Unlit

基本颜色

Base Color

1、导出gltf/glb模型:设置贴图与设置的颜色会同时生效;设置的透明度只有当下方的“透明度”设置项设置为“透明BLEND”时生效;

2、导出usdz模型:不支持

通用项

透明度

导出usdz模型:此项不可用,如需要透明请单独设置“不透明度”项

显示

1、导出gltf/glb模型:需要透明的材质请设置为“透明BLEND”,否则请设置为“不透明OPAQUE”

2、导出usdz模型:此项不可用

注意:为材质设置贴图时,只支持jpg、jpeg与png格式的图片


3.6 导出动画


导出格式

预期效果

设置项

gltf/glb

静态模型或不想导出动画

无动画

只导出某一段动画

选择这段动画的名称

导出多段动画

选择这些动画的名称

导出全部动画

选择所有的动画名称

usdz

静态模型或不想导出动画

无动画

只导出某一段动画

选择这段动画的名称

导出多段动画

不支持

导出全部动画

不支持


3.7 位置

image.png

程序会自动计算拖入到编辑器的模型位置,并显示出模型的底部中心点与坐标系原点的位置关系。

点击预览窗口的image.png按钮,将模型底部中心归于坐标原点。

3.8 导出方向

在实际的模型展示的时候,有时候会发现模型方向不符合预期,则可以通过这里设置模型的方向。


3.9 导出缩放

在实际的模型展示的时候,有时候会发现模型太大或太小,则可以通过这里设置模型的缩放。

请注意:当导出usdz时,会生成一个文件夹包含两个文件,如xxx-iOS12.usdz与xxx.usdz,在iOS12系统上的AR Quick Look请使用xxx-iOS12.usdz,iOS13及其以上系统请使用xxx.usdz


3.10 贴图质量

此项为贴图压缩的比率,默认为70%,如果导出的模型明显发现贴图清晰度丢失严重,我们建议您调高此参数。


3.11 贴图尺寸


3.12 版权信息

你可以在这里输入你的版权信息


3.13 预览

点击预览后会打开新的页面实时展示当前模型。

3.10.1 预览手势操作


设备/控制

移动(平移)

缩放

旋转(环行)

鼠标

右键长按移动

鼠标滚轮滑动

左键长按移动

触摸板

双指长按移动

双指移动

点击长按移动

键盘

键盘上下左右键点击移动

不支持

不支持


3.10.2 模型属性

image.png


大家都知道3D渲染需要消耗大量性能,尤其是在移动端上,这样就要求用户上传的模型的属性应该合理。


属性类别

属性项

规范

场景

节点数

单个模型≤50;整个场景≤200

网格

网格数

单个模型≤10;整个场景≤50

三角形数

单个模型≤50,000;整个场景≤200,000

顶点数

单个模型≤50,000;整个场景≤200,000

相机

相机数

会被忽略,不考虑

材质

材质数

单个模型≤10;整个场景≤40

纹理

纹理个数

单个模型≤10;整个场景≤40

动画

动画数

单个模型≤10;整个场景≤40

骨骼数

单个模型≤80;整个场景≤300


另一方面,也建议遵循这样的指标:

单个模型gltf整个文件夹或glb文件≤5M;

整个gltf整个文件夹或glb文件≤20M;


3.10.3 模型尺寸

这里的尺寸是:当使用Google Scene Viewer或Apple AR Quick Look时,环境中展示的模型的尺寸,更是gltf或usdz模型的尺寸大小。


3.10.4 预览场景设置

image.png


类别

项目

描述

显示

背景

显示背景图片

模型网格

将模型网格化展示,有助于分析当前模型哪些部位三角形数过高

骨骼

显示骨骼

坐标网格

显示参考网格,每格50cm

自动旋转

围绕模型自身中心点Y轴自动旋转

屏幕空间平移

勾选与不勾选手势操作不同

中央背景色

不显示背景时,场景的背景由中央向四周的纯色渐变构成

四周背景色

不显示背景时,场景的背景由中央向四周的纯色渐变构成

灯光

颜色空间

请保持默认选择

伽马校正

请保持默认选择

环境贴图

切换不同的环境贴图,查看模型不同的反射情况

曝光度

设置场景的曝光颜色,一般请保持1

添加灯光

请保持默认设置

环境光强度

调整模型的整体灯光强度效果

环境光颜色

调整模型的整体灯光颜色效果

平行光强度

调整模型的平行灯光强度效果

平行光颜色

调整模型的平行灯光强度效果

动画

播放速度

一般的,请保持默认1

全部播放

点击后,模型可以同时播放多个动画

性能

FPS

模型在当前设备上的帧率,一般的,macOS的性能远高于移动设备,所以这里应该保持60,如果低于60说明当前模型需要优化

耗时

模型渲染的耗时,1000除以耗时得到帧率

3.10.5 重置按钮

点击后可以将模型还原到初始预览状态

3.10.6 模型归于中心点按钮

点击后可以将模型的底部的中心点归于坐标系的原点,此时你会看到程序内位置参数全被归零:

image.png

3.10.7 截图按钮

点击截图则可以保存当前预览窗口的截图,你可以修改预览场景设置来达到满意的截图。

3.11 上传

将当前模型上传到Kivicube素材库,我们建议设置导出格式为glb后上传,请注意,当您设置导出格式为usdz后将不支持上传


3.12 导出

根据选择的导出格式导出相应的模型文件


4.模型使用

4.1 在Kivicube平台上使用

可以在Kivicube上直接上传gltf/glb模型使用,请参考:https://www.yuque.com/kivicube/manual/create-scene-content


4.2 在Kivicube AR Quick Look上使用

如果仅仅是单个模型的3D/AR体验,可以在Kivicube AR Quick Look中快速上传模型生成体验链接。

上传地址与体验案例:https://www.kivicube.com/ar-quick-look


更多参考:将传统模型转换为USDZ并快速创建AR体验

https://mp.weixin.qq.com/s/UasA_1l4kEnDux2NqS8ohg


4.3 更多使用场景

点击下方链接,了解更多使用场景与使用案例

https://mp.weixin.qq.com/s/t2lQDk-8cocHikZo78ktng