1 初始筹备

1.1 CGKit简介

  CGKit是华为推出的一套高性能渲染框架，提供了渲染所需的原子能力，如材质、模型、灯光以及一些前期特效等。另外提供了高性能渲染组件，如抗锯齿和基于Vulkan的多线程组件等。除此之外还提供了Smart Cache以及Pre-rotation等扩大能力，并整合了前沿计算机图形学、计算机视觉和深度学习等最新研究成果。

1.2 官网领导

  华为开发者的主页如下：
  https://developer.huawei.com/consumer/cn/

  在该页面有CGKit的链接：

  点击该链接即可转到CGKit的主页，其地址如下：
  https://developer.huawei.com/consumer/cn/hms/huawei-computer-graphics/

  这里会有CGKit的根本介绍，如下：

  这里次要关注开发，点击“查看文档”，即可转到如下地址：

  https://developer.huawei.com/consumer/cn/doc/development/HMSCore-Guides/introduction-0000001050197938

  该网页是进行CGKit开发的官网页面，无关介绍这里不再反复。

  重点关注以下两点即可：

  其中示例代码是一套Android Studio工程，含有开发CGKit的框架以及必要的代码；SDK则是CGKit的外围，包含so文件以及对应头文件。

  须要留神的是，示例代码须要做肯定的批改能力开发出可运行的利用，次要是以下两个起因：

  1. SDK是外围模块，须要注册华为账号能力下载，故不蕴含在示例代码中，须要下载后放入示例代码工程中；
  2. 模型等文件有肯定版权限度，故不蕴含在示例代码中，须要自行下载或制作模型后放入示例代码工程中。

1.3 开发筹备

  1. 基于Kirin芯片的华为手机，目前反对Vulkan1.0版本，零碎版本要求Android10以上；
  2. Android Studio，举荐应用最新版本（目前为4.0）；
  3. NDK版本20.1.5948944；
  4. API等级29（Android 10）
  5. Build Tools版本29.0.3

2 开发具体记录

2.1 新建工程

  应用Android Studio新建工程，这里为了不便不间接新建工程，而以官网示例代码为例，间接用Android Studio关上即可。

  关上示例代码后，Android Studio会主动依据gradle进行无关内容的下载，比方该工程所指定的gradle-5.6.4。

  尽管gradle配置了minSdkVersion为27，然而因为CGKit刚刚推出，兼容性问题还有待欠缺，因而能够改为29，仅在Android 10以上版本运行。

2.2 签名

  示例代码中的gradle文件配置了签名，这里能够删除，仅作为本人开发验证应用。当然，参考官网材料进行签名生成，以及华为利用接入等残缺步骤也能够。

2.3 集成SDK

  在后面章节提到的SDK下载局部，将SDK下载下来，如下：

  将include目录拷贝到：
  appsrcmaincpp

  如下：

  libs目录拷贝到app目录，如下：

  接着点击Build下的Refresh Linked C++ Projects：

  则能够关上MainApplication.cpp，查看其中的接口都不再以红色显示，阐明曾经配置好了：

2.4 制作天空盒

  依据官网文档，天空盒应该本人制作，没有随示例代码公布。天空盒有许多参考资料，这里参考：
  https://www.cnblogs.com/alps/p/7112872.html

  该网站也提供了天空盒资源下载，能够作为学习之用。另外提供一个cubemap天空盒示例网站，可在线查看天空盒成果：
https://doc.babylonjs.com/resources/playground_textures#cubetextures

  抉择一个cubemap天空盒下载，而后编辑.cub配置文件内容如下：

width=512
height=512
depth=6
mipmap=1
face=6
channel=4
suffix=.png

  这里width和height要和天空盒第一级mipmap的png图像大小统一。

  并依据领导将图片命名，如下：

  这些文件都放在env目录，而后复制到示例工程的cubemap目录即可。

  这里要留神，目前CGKit仅反对四通道png格局的图片，请勿应用其余格局。如果png不是四通道，能够应用windows画图程序关上，另存为png，则能够转换成四通道。

2.5 筹备模型

  目前CGKit只反对obj格局的模型，且仅从obj中解析点和面，其中的mtl格局材质则被疏忽。另外，解析反对法线、贴图坐标解析及切线计算，然而面仅反对三角形模式，而不会进行多顶点组成的面的主动三角化。

  开源收费的3D模型有许多，这里给一个参考网站：
  https://www.turbosquid.com/Search/3D-Models/free/obj

  对于本教程，这里选了如下的模型：
https://www.turbosquid.com/3d-models/medieval-blacksmith-low-poly-3d-model-1591136

  成果如下：

2.5 开发利用

  示例工程曾经含有MainApplication.cpp无关代码，这里仅须要稍作批改即可。

2.5.1 批改模型

  首先在InitScene办法中，批改模型门路：

  String modelName = "models/black_smith/black_smith.obj";

  接着批改贴图门路（将原来的jpg转为png格局）：

  String texAlbedo = "models/black_smith/texture/black_smith.png";

  这里只有一个贴图，将原来的多余贴图正文掉：

  //String texNormal = "models/Avatar/Normal_01.png";
  //String texPbr = "models/Avatar/Pbr_01.png";

  并将这两个贴图对应的SetTexture和SetSamplerParam正文掉。

2.5.2 批改天空盒

  批改CreateSkybox办法中的无关配置，将天空盒所用的立方体模型批改为：

  String modelName = "models/cube/cube.obj";

  这里cube是最简略的模型，链接如下：

  https://gist.github.com/MaikK...

  并留神将MainApplication.h中的环境贴图设置为：

  String m_envMap = "cubemaps/env/env.cub";

  这里与后面制作天空盒时所用的名称雷同。

2.6 运行验证

  成果如下：

  如果运行呈现问题，能够应用adb logcat进行日志查看以剖析问题。CGKit也会在安卓规范日志中打印无关信息，且只记录ERROR级别日志。如果想要对CGKit日志进行过滤，能够应用如下命令：

  adb logcat | grep CGKit

3 FAQ

3.1 模型反对什么格局

  目前CGKit仅反对obj格局的模型，可解析顶点、法线、贴图坐标及面信息等；但不反对多余3顶点的面主动三角化，也不反对从mtl格局材质文件解析无关配置。

3.2 贴图反对什么格局

  目前CGKit仅反对四通道png格局图片解析。

3.3 签名是什么

  安卓开发可能须要用到签名，能够参考官网材料制作签名文件。在平时开发调试时，能够将示例代码中的签名配置正文掉。

3.4 Failed to get hire

  日志打印中可能会发现“Failed to get hire”，这条是打点所用，无需理睬。“打点”是指CGKit对本人运行状况进行记录和上报，不影响渲染等模块运行。

4 附录

  曾经编译好的apk，以及编译的Android Studio工程曾经放在百度网盘供下载参考，如下：  链接：https://pan.baidu.com/s/1x8wjYLqZ4CZpVUlo-ZDM1w   提取码：3j8j  请留神，CGKit自身须要从官网下载SDK，即so和头文件，所以这里提供的工程中是不含有该SDK的，请先注册华为开发者后下载放入即可。该工程曾经含有模型、贴图以及天空盒等必备资源，仅短少CGKit SDK而已。

原文链接：https://developer.huawei.com/consumer/cn/forum/topicview?tid=0201309841885850221&fid=18

原作者：捉不住的鼬鼠