Kanzi 3.9.5 发行说明

新增功能

  • 引入了 continueIf 绑定函数，使您能够有条件地停止绑定的执行。请参阅 continueIf。

    ../../_images/continue-if.png

  • 引入了 Outline Effect 2D 效果，使您可以将轮廓应用于 2D 节点的内容。请参阅 使用 Outline Effect 2D 效果。

    ../../_images/outline-effect-2d-large.png

功能改进

  • Kanzi Java API 改进：

    • 现在支持自定义派生的 ListBoxItemGenerator2D 和 ListBoxItemGenerator3D 类。使用这些派生类来配置列表框节点中的项目。

    • 在 KanziObject 类中添加了 addClassPropertyDefaultValue() 函数，使您能够为类的属性设置默认值。

      例如：在扩展 Node 的类中，重写 initialize() 并调用 addClassPropertyDefaultValue(VisibleProperty, false)。

    • 在 Node 类中添加了将输入操控器附加（addInputManipulator(InputManipulator inputManipulator)）和分离（removeInputManipulator(InputManipulator inputManipulator)）到节点的函数。

  • Activities improvements:

    • Activity Browser 现在将活动属性添加到项目命名空间中。

    • 如果 ActivityElement 节点不包含某个活动的历史记录，ActivityHistoryManager::hasHistory() 函数现在通过活动相对路径在父 ActivityElement 节点中递归执行查找。

  • 在输入操控器中引入了 Hit Test Ray Distance 消息参数，该参数报告摄像机与3D命中测试节点的边界框之间沿命中测试射线的距离。

    ../../_images/hit-test-ray-distance.png

  • 引入了 CompositionManager::setReuseParameters() 函数，使您能够控制 Composition Manager 何时释放未使用的临时合成目标。

  • Kanzi 现在使用球面映射为球体生成纹理坐标，而不是在 z 轴上镜像 UV。

  • Kanzi Studio 现在支持 Java 插件的 Debug 和 Release 构建类型。请参阅 使用 Kanzi Engine 插件、使用 Java 扩展 Kanzi Engine 的功能。 和 教程：Android 的数据源。

  • 为了优化 OpenGL 渲染性能和内存消耗，Kanzi 现在对大多数 2D 渲染使用共享几何体。请参阅 对 2D 节点几何体的更改。

  • 在 Kanzi Studio 插件接口中引入了 Project.IsSDKProject，使您能够检查 Kanzi Studio 项目是否遵循使用应用程序代码的项目的文件夹结构。

  • 您现在可以使用 ANDROID_STUDIO 环境变量设置 Android Studio 安装的位置。

    Kanzi Studio 使用此环境变量在 Android Studio 中打开 Android 的 Kanzi 应用程序。例如，当您从 Activity Browser 打开 Code Behind 源代码时。请参阅 为 Kanzi Studio 设置 Android 环境。

    ../../_images/android-java-home-paths.png

  • 当您使用 Set Property 操作从消息参数转发属性值时，您现在可以选择属性值的字段。

    ../../_images/set-property-action-message-argument-field.png

  • 在 Kanzi Studio 中，Node Components 为 Message Triggers 和 Message Actions 创建的菜单现在按消息类别组织。

    ../../_images/add-toggled-on-trigger.png ../../_images/node-components-value-accumulator-start.png

  • 当删除 Kanzi Studio 项目中未使用的项目时，您现在可以选择全部或不选择任何未使用的项目。请参阅 清理您的项目。

    ../../_images/delete-unreferenced-items-window.png

更改

  • Kanzi 现在在 Text Block 和 Text Box 节点中布局文本时应用字体中设置的字体提示。请参阅 文本布局中的更改。

  • Kanzi 现在使用 Node > Visible 属性来控制灯是否打开。请参阅 对光源节点 (Light nodes) 的更改。

  • 当您在不支持半浮点网格顶点属性的目标设备上加载 Kanzi 应用程序时，Kanzi 不再自动将顶点数据从半浮点转换为浮点。请参阅 对网格顶点数据处理的更改。

  • 在 KanziViewAdapter 中添加了 handleVisibilityChanged() 方法，您可以在无视图上下文中与 Kanzi Android framework (droidfw) 一起使用。每当无视图表面的可见性发生变化时调用此方法，例如当另一个应用程序覆盖包含 Kanzi 内容的 Android 壁纸时。

  • 更新了 Android 模板、教程和示例，以使用 Kanzi Gradle 插件版本 0.7.1。更改为 Kanzi Gradle 插件版本。。

  • 将 Fast performance vertex shaders Kanzi Studio 项目模板重命名为 High performance vertex shaders。

  • 将 linux_imx8_wayland_aarch64_gcc102 平台包重命名为 linux_wayland_aarch64_gcc102。

  • 添加了 linux_drm_gbm_aarch64_gcc74 平台包。

  • 将 kzb 文件格式版本更改为 21.0。

文档 (Documentation)

显著修复

ID

描述 (Description)

区域

106464

修复了一个问题，该问题导致 Preview 在重新排序其预设占位符的子节点后，以错误的顺序渲染预设模板子节点。

Kanzi Engine

176477

修复了在 2D 节点中设置 Brush Horizontal Tiling 和 Brush Vertical Tiling 属性时无效的问题。

Kanzi Engine

410944

修复了一个问题，该问题导致当您将 Font Size 属性绑定到 Screen 节点的大小时，kzb Player 错误地显示 Text Block 2D 节点。

Kanzi Engine

415452

修复了沿 y 轴滚动的非循环 Trajectory List Box 3D 节点的捕捉行为。当用户将列表滚动到超出第一个或最后一个项目时，列表框现在会捕捉回该项目。

Kanzi Engine

416388

修复了在 Parallel Activity Host 中导致初始活动的 Activities 焦点处理不正确的问题。

Kanzi Engine

418086

修复了当着色器在重用的渲染目标的活动区域之外采样时导致 Kanzi 渲染不正确纹理数据的问题。

Kanzi Engine

423605

Kanzi 现在会自动禁用对渲染结果没有视觉效果的2D效果。例如，当您在 Blur Effect 2D 效果中将 Blur Radius 设置为0时，Kanzi 会禁用该效果。

Kanzi Engine

423718

修复了一个问题，该问题导致如果格式参数索引超出范围，则调用 kzLog 会崩溃。

Kanzi Engine

424220

修复了在合成模式更改时导致裁剪错误的问题。

Kanzi Engine

424939

修复了在 Text Block 和 Text Box 节点中将 Font Size 属性设置为 0 时导致 Preview 终止的问题。

Kanzi Engine

426330

修复了导致 Performance HUD 错误显示 Timeline Clock 毫秒的问题。

Kanzi Engine

427041

修复了当您尝试将 Activate Activity 消息分派到根 Activity 节点时导致 Preview 终止的问题。

Kanzi Engine

431751

修复了当字形缓存已满时导致文本闪烁的问题。

Kanzi Engine

412482

修复了绑定解析器无法检测属性路径中无效字符的问题。

Kanzi Studio

416672

修复了在导入或合并 Kanzi Studio 项目时阻止 Kanzi Studio 从 Generic 目录导入资源的问题。

Kanzi Studio

423599

当您导入使用不支持的扩展的 glTF 文件时，Kanzi Studio 现在会记录列出这些扩展的警告。

Kanzi Studio

427982

修复了导致 Kanzi Studio 在 KanziStudio.log 中报告有关 FloatValueAccumulator.TargetPropertyField 的警告的问题。

Kanzi Studio

428322

修复了使用 Kanzi Studio project 模板的项目在重命名项目或添加引用项目时在 Kanzi Studio Log 窗口中生成虚假 Code Behind Service 警告的问题。同时修复了使用 Application 模板的项目在使用 Save Project As… 选项时在 Kanzi Studio Log 窗口中生成虚假 Could not find Template.metadata 错误的问题。

Kanzi Studio

430536

修复了使用 Kanzi Studio project 模板的项目在将 Code Behind 添加到项目时，在 Kanzi Studio Log 窗口中生成虚假 Code Behind Service 警告的问题。

Kanzi Studio

417701

Kanzi Android framework (droidfw) 应用程序现在在没有工作要做时暂停主循环。计时器、属性更改和添加到 TaskDispatcher 的任务会唤醒应用程序退出暂停状态。

Kanzi Android framework (droidfw)

422703

修复了字符串类型的值源 BindingBuilder.createOneWay(Object value) 丢失值并返回布尔值 true 的问题。

Kanzi Java API

426863

包含 KanziTextureView 的 Kanzi Android framework (droidfw) 应用程序在活动对用户不再可见时现在会暂停。例如，当不同的活动覆盖整个屏幕时。

Kanzi Android framework (droidfw)

429059

修复了导致 Kanzi Gradle 插件总是将 Kanzi Engine 依赖项添加到 Android 库项目中的问题。

Android

429117

修复了导致 Kanzi Gradle 插件在您向 Android 应用程序项目添加自定义构建类型时抛出异常的问题。

Android

422349

修复了导致使用 Kanzi Studio 项目模板创建的 Kanzi Engine 应用程序总是静态注册插件组件的问题。请参阅 对 Kanzi Engine 插件静态注册代码的更改。

Kanzi framework SDK

另请参阅

Kanzi 3.9.5 迁移指南

已知问题