Kanzi 3.6.1 release notes

Feature improvements

  • Improved the kzb format:

    • The improved format has smaller footprint, which enables faster loading on target devices.

    • This improved format is the default format for all new projects you create in Kanzi Studio, but the legacy format is still available.

      To set which format you want to use, open a project in Kanzi Studio, in the Project menu select Properties, and in the Properties set the Kzb Version property to the version you want to use.

      If you want to use the improved kzb format in a Kanzi application you created with an earlier version of Kanzi Studio, export the kzb file from that project and if you manually load content from a kzb file, update the application code to use the API of the improved format.

      ../../_images/kzb-version.png

  • You can now include methods in object metadata. See Metaclass, MethodArgument, MethodArguments, MetaObject, MetaMethod.

  • Implemented suspension manager for Linux evdev.

  • Lazy memory mapping is now by default used on QNX.

  • You can configure the input event devices that Kanzi listens to on Linux ports where the native windowing system does not provide input device handling.

    See Input event devices on Linux.

  • You can now bypass the loading of application.cfg file using the command line option -config="". On some embedded platforms this can improve the startup performance. See Running an application without reading the application.cfg.

  • Kanzi Studio now includes the application.cfg file in the apk when you create the apk from Kanzi Studio.

  • When you use more than one Animation Player in a node, you can now pause, resume, start, or stop a specific Animation Player on that node by setting the name of the Animation Player in the message. See Controlling keyframe animations.

  • Node components now filter incoming messages and handle only those whose name in the message matches the name of the component.

  • The default blending mode is now Premultiply Alpha.

  • You can now use custom brushes in Kanzi Studio.

  • Improved the Project Merge dialog. The dialog now:

    • Shows only the differences between projects you are merging. See Merging projects.

    • Shows the URL of both target and source projects.

  • Improved merging of 3D assets:

    • You can now merge splines from fbx files.

    • In Kanzi Studio you can now use the Asset Merge dialog to merge content from 3D assets.

  • Performance HUD now shows triangle count.

  • Several Kanzi Studio usability improvements, such as:

    • You can now export recursively kzb files from all referenced projects in a project which refers to multiple projects.

      ../../_images/export-recursive-kzbs.png

    • You can now copy kzb URL of data objects in a data source. You can readily use these URLs in your application code.

      ../../_images/data-source-copy-kzb-url.png

    • You can now remove at once all invalid animations from a state transition.

      ../../_images/remove-invalid-animations.png

    • You can now copy and paste the items in the Node Components between nodes.

      ../../_images/node-components-copy.png ../../_images/node-components-paste.png

    • Improved the diversity of resource icons in the Library and improved the color contrast for some items listed in the Properties to improve readability.

      ../../_images/new-icons.png

    • When you import a mesh that uses skinning, Kanzi Studio now sets the Material property of the mesh clusters to VertexPhongSkinnedMaterial.

    • When you import a morph object, Kanzi Studio now sets the Morph object to use the VertexPhongMorph material type.

Changes

  • When you export kzb file from your project, Kanzi Studio creates a txt file which contains the names of nodes, resources, and files that the project uses. You can set the exporting of this txt file in the Kanzi Studio User Preferences. See Using kzb files.

  • Kanzi Studio now sets the size of Empty Node 2D nodes it creates from group layers imported from psd files to the size of the imported element boundaries.

  • When you make a change to a Kanzi Studio plugin you must restart Kanzi Studio to take that change into use.

  • If you now add a Click Enabled property to a Button node, Kanzi Studio prints a warning, because the Click Enabled property is not meant for Button nodes.

Documentation

  • Added a tutorial where you can learn how to apply a stencil to 3D content. See Tutorial: Apply a stencil to 3D content.

  • Added a tutorial where you can learn how to apply directional Gaussian blur effect on 3D content. See Tutorial: Create a Gaussian blur effect.

  • Added a tutorial where you can learn how to use List Box controls. See Tutorial: Create a contacts list with a Grid List Box.

    ../../_images/list-box.gif

  • Updated the Keyboard input tutorial to show how to use the Focused property to visualize the focus of UI elements.

  • Added instructions on how to automate Kanzi Studio tasks. See Automating Kanzi Studio tasks.

  • Added instructions on how to implement undo and redo functionality in Kanzi Studio window plugins. See Grouping project changes in your Kanzi Studio window plugin.

  • Kanzi documentation is now hosted at docs.kanzi.com where you can read the latest version. To access Kanzi documentation at docs.kanzi.com you need a Rightware Zendesk account. If you do not have one already, you can create it when you access Kanzi documentation the first time.

    Kanzi Studio takes you to docs.kanzi.com by default, but when you have a slow or no Internet connection, you can still read the documentation that comes with your installation of Kanzi. If you prefer either one, in Kanzi Studio you can select which one you want to use in the Edit > User Preferences > Advanced tab with the Online documentation property.

    ../../_images/user-preferences-online-documentation.png

  • You can now read the Kanzi documentation in Chinese (欢迎我们的中文读者). In Kanzi Studio you can select the default language in the Edit > User Preferences > Advanced tab with the Language property or in the documentation click image0 in the header of each topic and select the language.

    ../../_images/user-preferences-language.png ../../_images/select-documentation-language.png

Fixes

ID

Description

Area

7138

Reduced the Lightness (L) and Blend Intensity of materials in the Materials, textures, and rendering tutorial to get a more realistic rendering result.

Documentation

7559

Interrupted Page and Page Host node transitions no longer leak memory.

Kanzi Engine

7540

Fixed the drag and drop manipulator.

Kanzi Engine

7396

When receiving an invalid UTF-8 character Kanzi Engine now displays a replacement character.

Kanzi Engine

7323

Zero-width characters no longer affect the character spacing.

Kanzi Engine

7226

When you close or shut down the Virtual list box example while it is still loading images, the example no longer terminates.

Kanzi Engine

7025

The suspension manager now works with Instantiator nodes.

Kanzi Engine

6910

Undocking and docking the Preview no longer mangles the layout of Flow Layout 2D nodes.

Kanzi Engine

6736

Kanzi now correctly renders PNG images that have fewer than 24 bits and contain an alpha channel.

Kanzi Engine

6602

When you activate a Page Host node, the node now sends the Message.Page.Activated message only once.

Kanzi Engine

6366

Kanzi no longer drops touch events on applications running on Wayland.

Kanzi Engine

6284

After setting focus to a Button node using scripting, the clearFocus() function now actually removes it.

Kanzi Engine

6045

Kanzi applications no longer terminate when they receive a large amount of touch events.

Kanzi Engine

5025

You can now use the FontDefault material for Text Block 2D nodes.

Kanzi Engine

4431

Calling eglGetCurrentContext() before activating a context now returns a warning.

Kanzi Engine

4367

2D nodes no longer react to stencil settings from the previously executed render pass. Stencil settings for 2D nodes are disabled.

Kanzi Engine

3376

Kanzi now correctly recalculates the size of a Stack Layout 2D node when the size of its child nodes change.

Kanzi Engine

2916

The Hold Interval on Button now works correctly.

Kanzi Engine

7765

Aligned the precision of the BlendIntensity uniform in VertexPhong shaders.

Kanzi Studio

7678, 7390, 7389, 7384, 6913

Improved Kanzi Studio and Preview stability.

Kanzi Studio

7664

The Preview no longer terminates when you export the kzb file from a referenced project while the Preview of the project which refers to it is still running.

Kanzi Studio

7616

Kanzi Studio no longer creates a new texture when you import an image that you already imported and decide to overwrite the already imported image file.

Kanzi Studio

7611

Image nodes no longer flicker in the Kanzi Studio Preview when their Opacity property has values less than 1.

Kanzi Studio

7600

Kanzi now correctly applies the ATC texture compression.

Kanzi Studio

7590

Kanzi Studio now stays responsive when a Kanzi Engine plugin in a project contains a large amount of property types.

Kanzi Studio

7563

Kanzi Engine plugin properties targeting nodes now have < Relative > available in the default editor.

Kanzi Studio

7561

The Project Item custom property types now have < Relative > available when you use them in your project.

Kanzi Studio

7498

Modified the shaders for the Factory ContentChrome Material, Carbon Fiber Material, and Glass Material to correct errors.

Kanzi Studio

7467

In animation action configuration settings you can now set the Target Item to any node in the Node Tree.

Kanzi Studio

7458

Removed the glitches that Node tool had when selecting multiple items under layout nodes.

Kanzi Studio

7454, 7439

The Snap tool in the Preview now stays off when you switch it off and in general works the way it is intended to work.

Kanzi Studio

7452

Three-way merge now correctly resolves some conflicts it did not resolve previously.

Kanzi Studio

7419

Kanzi Studio now takes only positive values for the Start Time property in state transitions.

Kanzi Studio

7380, 6569, 6521

Kanzi now correctly applies the ETC2 texture compression.

Kanzi Studio

7330

If your display resolution is too low to show the entire Create context menu, Kanzi Studio now allows you to scroll the menu.

Kanzi Studio

7239

Kanzi Studio now shows the content of referenced projects even if you open them before opening the project which refers to these projects.

Kanzi Studio

7187

When you create a project with Kanzi Engine plugin template, Kanzi now replaces in the application code files the CUSTOM_COMPONENT_API with the <ProjectName>_API.

Kanzi Studio

7162

You can now delete the folders you create manually in the Library > Property Types library.

Kanzi Studio

6890

The Mesh Attributes Editor no longer independently sorts the Import and Export sections.

Kanzi Studio

6850

You can now create a Prefab Placeholder 3D and a Prefab View 3D node under a Viewport 2D node.

Kanzi Studio

6809, 6808

The Current Time field in the Animation Clip Editor now correctly displays current time even when you stop an animation clip or select the field.

Kanzi Studio

6486

When a project uses a resource from a missing referenced project, Kanzi Studio now starts and prints an error to the Log.

Kanzi Studio

6282

The Preview no longer terminates when you use a script to move focus from a node to the Screen node and back to the same node.

Kanzi Studio

6029

Now when you want to undo creating of a state in State Tools it suffices to press only once.

Kanzi Studio

5228

Kanzi Studio now issues a message when you try to import an image whose name differs only in letter case.

Kanzi Studio

5200

Kanzi Studio now correctly applies the Trajectory Override Offset property only to the child nodes of a Trajectory Layout node.

Kanzi Studio

3882

When an imported scene does not contain a camera, Kanzi Studio now adds one.

Kanzi Studio

3759

The Preview now correctly draws the Allocated layout.

Kanzi Studio

2950

Kanzi no longer removes the first _ (underscore) character from custom trigger names.

Kanzi Studio

2378

Kanzi Studio now correctly builds apk even when you change the Build Debug Version property in an application configuration in the Library > Applications.

Kanzi Studio

1889

After enabling the Double-Click Enabled property you no longer have to restart the Preview to enable the double clicking for that node.

Kanzi Studio

See also

Kanzi 3.6.1 migration guide

Known issues