Kanzi 3.9.11 版本说明

渲染 (Rendering)

  • 引入了可用于创建经纬度（等距柱状投影）环境纹理的材质：

    • LatLongSkybox 使您可以将经纬度（等距柱状投影）环境纹理渲染为天空盒。

    • LatLongCubemapBlit 使您可以将经纬度（等距柱状投影）环境纹理 blit 到 cubemaps。

    请参阅 使用经纬度环境纹理。

    ../../_images/environment-map-rotation.gif

  • 为 HDR 环境纹理引入了基于 GPU 的立方体贴图处理。这提高了将 HDR 环境纹理导入为环境立方体贴图纹理或基于图像的照明立方体贴图纹理时的性能。

    默认情况下，Kanzi 使用基于 GPU 的立方体贴图处理。要使用速度较慢的基于 CPU 的立方体贴图处理，请在 User Preferences 中禁用 Use GPU-based cubemap filtering 选项。

    ../../_images/user-preferences-gpu-based-cubemap-filtering.png

  • 在 Properties 中，您现在可以通过拖放对材质规则重新排序，并重新排列材质规则的条件和操作。

活动

您现在可以设置 Kanzi 在停用某个 Activity 时保留该 Activity 实例。当您再次激活此类 Activity 时，Kanzi 会恢复该 Activity，并以停用前的相同状态显示它。请参阅 Activity 持久性。

../../_images/properties-keep-alive.png

Kanzi Studio 可用性

  • 代码编辑器现在支持 GLSL 编程语言的代码补全。要显示代码补全选项，请在代码编辑器中按 Ctrl Space。请参阅 编辑着色器。

    ../../_images/code-editor-code-completion.gif

  • 为代码编辑器引入了深色主题。您可以在 User Preferences 的 General 选项卡中切换编辑器主题。

    ../../_images/user-preferences-dark-theme.png

  • 在 Library > Project References 中，您现在可以修改现有 kzb 参考文件的文件路径。该文件路径现在相对于工程根目录。

    ../../_images/existing-kzb.png

  • 现在，您可以通过 Node Tree 中的上下文菜单放置：

    • 将节点放置到 Preview 中 Camera 当前视图的位置

    • 将 Preview 视图放置到任意节点的位置

    请参阅 设置摄像机节点的位置。

    ../../_images/node-tree-align-view-align-to-selected.png

  • 您现在可以使用 Focus To Selected 上下文菜单命令，或在 Node Tree 中双击所选节点（适用于非预设件节点），将 Camera 的当前视图聚焦到所选节点上。

    ../../_images/node-tree-camera-focus.png

  • 您现在可以创建 Linked Material Type，Kanzi Studio 会自动将其与所引用工程中的材质类型同步。当您不再希望将 Linked Material Type 与所引用工程中的材质类型同步时，可以将其转换为常规材质类型。

    ../../_images/create-linked-material-type.png

  • 当您在多工程解决方案中重新启动 Preview 时，Kanzi Studio 现在会为当前选定的工程启动 Preview。

Kanzi USD Importer

引入了 Kanzi USD Importer 插件，使您可以将 Universal Scene Description 文件导入到 Kanzi Studio 工程中。请参阅 https://docs.kanzi.com/usd-importer/1.0.0。

../../_images/kanzi-usd-importer.png

群集模板

在 Kanzi Project Templates 中添加了分步指南，展示如何根据 Figma 设计创建汽车仪表群集。请参阅 https://docs.kanzi.com/project-templates/3.9.10。

../../_images/cluster-overview.gif

预览 (Preview)

关闭时，Preview 现在会销毁应用程序和已创建的 Kanzi Engine 对象，并正常关闭。例如，这使您可以在 Kanzi Engine 插件中通过 onDetach 方法处理 Preview 的关闭，并且 KanziPreview 现在总是会随 Kanzi Studio 的关闭而停止。

Kanzi Studio 插件 API

改进了 Kanzi Studio 插件 API 中绑定的创建：

  • 扩展了 BindingHost.CreateBinding 方法，使其包括：

    • 绑定模式。默认模式为单向 (One Way)。

    • 双向 (Two Way) 绑定的推送目标。

  • 添加了 Binding.BindingType 属性，用于存储绑定模式信息。

平台

  • 在 Wayland 平台包中添加了 wayland::WaylandIVIEGLGraphicsOutput，作为一种图形输出选项。

  • 您现在可以在 Wayland 上枚举 EGL 图形配置。请参阅 EGLGraphicsFormatID。

  • 您现在可以在 Kanzi Engine C++ API 中为 Wayland XDG shell 设置应用程序 ID。请参阅 kanzi::wayland::XDGToplevel::setId 和 kanzi::wayland::XDGShell::setAppId。

更改

  • 您现在可以向 Kanzi 系统配置传递十六进制值。例如，这使您可以使用十六进制值设置窗口顺序。请参阅 应用程序窗口位置和大小。

  • 将 HarfBuzz 从 5.3.1 更新到 8.3.0。

显著修复

Kanzi Engine

  • 修复了加载的文件缺失时，Kanzi 文件协议 file:// 显示不当错误消息的问题。(SDK-9468)

  • 修复了导致 Kanzi 文件协议 file:// 无法加载 otf 扩展名字体文件的问题。(SDK-9488)

  • 改进了 Dispatch Message Action 找不到目标节点时记录的警告消息。(SDK-9537)

  • 移除了对渲染结果没有影响的多余模板状态切换。(RENDERING-1201)

  • 修复了为 Stack Layout 中的节点应用较大的负边距值时，导致调试模式下的 Kanzi 应用程序因断言而终止的问题。(SDK-9588)

  • 修复了使用多点触控输入时导致 Scroll View 滚动到无效位置的问题。(SDK-9581)

  • 修复了在启用缩放的情况下使用多点触控输入时，导致 Scroll View 节点向相反方向滚动的问题。(SDK-9589)

  • 修复了反复附加和分离 Button 节点时导致内存消耗增长的问题。(SDK-9616)

Kanzi Studio

  • 修复了 HDR 经纬度环境纹理的环绕模式，使其使用 Repeat 环绕模式而非 Clamp。(RENDERING-1067)

  • 修复了导致 FBX 文件导入失败的问题。(PRODUCT-568)

  • 修复了从引用的工程获取资源时无法更新数据源的问题。(PRODUCT-614)

  • 修复了 Cubemap Texture 作为环境或基于图像的照明立方体贴图纹理创建后格式错误的问题。(RENDERING-973)

  • Kanzi Studio 使用系统代理服务器设置进行许可证激活。如果代理需要身份验证，请将凭据保存在 Windows 凭据管理器中。(PRODUCT-728)

  • 修复了无法在 Kanzi Studio 工程之间共享群集材质 (Cluster Materials) 的问题。(PRODUCT-563)

  • 修复了使用 Android application with Java plugin 新建工程并重新构建数据源 jar 插件后，导致 Kanzi Studio 丢失数据源的问题。(ANDROID-625)

  • 修复了删除 Kanzi Android framework (droidfw) 视图的启动预设件后导致 Target Preview 无法正常工作的问题。(ANDROID-852)

平台

  • Wayland 和 QNX 图形输出现在遵循 SurfaceColorSpace 配置设置。请参阅 SurfaceColorSpace。(INTE-471)

  • 修复了在 Wayland 上由于在睡眠唤醒周期中未正确关闭键盘映射文件描述符而导致的内存泄漏。(INTE-497)

  • 修复了在 Wayland 上使用比编译 Kanzi 二进制文件时所用版本更新的 libwayland 时发生的崩溃。值得注意的是，此修复解决了 Ubuntu 24.04 上的崩溃问题。(INTE-539)

  • 修复了在 QNX 平台上 libkztargetpreview 虽然使用了网络功能却未链接 libsocket 的问题。(INTE-549)

  • 使用 Scons 构建时，Kanzi Engine 插件模板现在会响应 --dynamic 标志。(INTE-200)

另请参阅

已知问题