Step 1 - Use the Kanzi Engine API to load a Kanzi binary¶

In this step you learn how to use the Kanzi Engine API load a Kanzi binary.

Assets for the tutorial¶

The starting point of this tutorial is stored in the <KanziWorkspace>/Tutorials/Programmer tutorial/Start directory:

Tool_project directory contains the Kanzi Studio project which contains the application structure and resources you use in this tutorial. Whenever you make changes to this project, to see the result in your application, export the project to a kzb file. See Using kzb files.
Application/bin directory contains the Programmer_tutorial.kzb binary file generated from the Kanzi Studio project, and PNG image files that the application you create in this tutorial uses.

The <KanziWorkspace>/Tutorials/Programmer tutorial/Completed directory contains the completed project of this tutorial.

Use the Kanzi Engine API to load a Kanzi binary¶

To use the Kanzi Engine API to load a Kanzi binary:

In Kanzi Studio open the <KanziWorkspace>/Tutorials/Programmer tutorial/Start/Tool_project/Programmer tutorial.kzproj Kanzi Studio project and select File > Export > Export KZB.

Kanzi Studio creates the kzb file and configuration files from your Kanzi Studio project. Kanzi Studio stores the exported files in the <ProjectName>/Application/bin directory or the location you set in Project > Properties in the Binary Export Directory property. The kzb file contains all nodes and resources from your Kanzi Studio project, except the resources you mark in a localization table as locale packs.

When you run your Kanzi application from Visual Studio, your application loads the kzb file and configuration files.
Open the command line in the <KanziWorkspace>/Tutorials/Programmer tutorial/Start/Application directory and run
```
generate_cmake_vs2017_solution.bat
```
This script generates a Visual Studio solution for the application in the directory <KanziWorkspace>/Tutorials/Programmer tutorial/Start/Application/build_vs2017.

Tip

You can open the project directory from Kanzi Studio by selecting File > Open in Windows Explorer.
In Visual Studio open the <KanziWorkspace>/Tutorials/Programmer tutorial/Start/Application/build_vs2017/Programmer_tutorial_start.sln Visual Studio solution.
In Visual Studio in the Solution Explorer right-click the Programmer_tutorial_start project and select Set as StartUp Project.

Open the programmer_tutorial.cpp file.

The programmer_tutorial.cpp file contains the minimum amount of code required for loading a Kanzi application. In this tutorial you create the logic of your application in this file.

// The kanzi.hpp header includes all Kanzi Engine functionality.
// To fine-tune your application you can include only the relevant headers.
#include <kanzi/kanzi.hpp>

using namespace kanzi;
class ProgrammerTutorialApplication: public ExampleApplication
{
    // In the onConfigure function you can tell your Kanzi application which kzb file
    // to load, enable performance information in your application, and set how many threads
    // you want to use for loading the application resources.
    void onConfigure(ApplicationProperties& configuration) override
    {
        configuration.binaryName = "Programmer_tutorial.kzb.cfg";
    }
};

// To work with the main function in the Application framework you need to
// return your application in the createApplication function. The main
// function then passes the control to the main loop defined in your
// Application class.
Application* createApplication()
{
    return new ProgrammerTutorialApplication;
}

Select the solution configuration that you want to use and run your application.

During development select the Debug configuration. When you are ready to create a version for production, select the Release configuration.

When you build and run the program, Kanzi loads the kzb file and shows the application content.

During an application launch Kanzi:
1. Calls the onConfigure entry point function, where you specify the configuration. For example, which Kanzi Studio project kzb files you want the application to load and the application window size.
2. Loads the kzb file to memory, which makes it available to the application.
3. When Kanzi completes the loading of the project, it calls the onProjectLoaded function. In the next steps of this tutorial you add the application functionality in this function.

< Introduction | Next step >

Step 1 - Use the Kanzi Engine API to load a Kanzi binary¶

Assets for the tutorial¶

Use the Kanzi Engine API to load a Kanzi binary¶

See also¶