Known issues

Compatibility with older Nvidia GPUs

It has been observed that the plugin may not function as expected on systems equipped with certain older Nvidia GPUs. Specifically, issues have been reported with:

  • “Pascal” architecture – used in GPUs such as GeForce GTX 1060, Geforce GTX 1070, Quadro P3200 and similar models.

  • “Maxwell 2.0” architecture – including GPUs such as GeForce GTX 960 and GeForce GTX 950.

These issues may manifest as rendering artifacts or incorrect simulation behavior, where emitted particles are prematurely dying in the next frame after their creation.

Users experiencing problems are advised to:

  • Ensure their GPU drivers are fully updated.

  • Test the plugin on a system with a newer GPU architecture (e.g., “Ampere”, “Turing” or “Blackwell 2.0”) if available.

  • Report specific symptoms and configurations to help improve compatibility in future releases.

Particles plugin fails to load properly when running the Application Player

When launching the Kanzi project with Application Player on Windows, the startup fails with the error message:

Failed to load plugin 'kzparticles.dll'

To resolve the issue, follow the steps below:

  1. Navigate to the directory located at <KanziWorkspace>/Engine/lib/Win64/<ConfigurationName>.

  2. Based on the configuration, copy kzshadercompiler_vs2022_Debug.dll or kzshadercompiler_vs2022_Release.dll file to the <ProjectName>/Application Player/ directory.

    Note

    Ensure that <ConfigurationName> folder matches to Application Player configuration:

    • Debug configuration requires the kzshadercompiler_vs2022_Debug.dll file from the vs2022_Debug_DLL directory.

    • Release configuration requires the kzshadercompiler_vs2022_Release.dll file from the vs2022_Release_DLL directory.

  3. Rerun the target .exe file from the <ProjectName>/Application Player/ directory.

Issue with Android Build in Kanzi projects using Particles plugin

When building the Kanzi project with Particles plugin for Android, you might encounter a build error with the following message:

com.rightware.kanzi.InvalidKzbFileException: Failed to load plugin 'kzparticles'

To resolve the issue, follow the steps below:

  1. Navigate to the directory located at <ProjectName>/Application/configs/platforms/android_gradle/kanzinative.

  2. Identify the build.gradle file and open it in a text editor.

  3. Locate the line that defines argument for using the Particles plugin within the externalNativeBuild section, and set DKANZI_LINK_KZPARTICLES flag to ON. Refer to the example code below:

// Enable to add Particles plugin to the AAR. It has to be available in Engine/plugins/particles/.
arguments "-DKANZI_LINK_KZPARTICLES=ON"

  1. Save the updated build.gradle file and rerun the build process.

    Note

    In some cases, it may be necessary to use the Sync Project with Gradle Files and Clean Build options in Android Studio to ensure that changes in the build.gradle file are properly applied.