添加启动逻辑

你可以用以下逻辑去在应用中定义你的启动逻辑

• Kanzi在启动应用程序后立即调用Application::onStartup() 函数一次,再它加载初始化UI内容之前，可以添加需要修改已初始化的Kanzi对象的应用程序启动逻辑。

• Kanzi初始化UI内容后立即调用Application::onProjectLoaded() 函数一次。通常可以在此处插入依赖已加载内容的初始化代码，例如你可以附加初始消息处理程序或监听器，用数据填充UI。

下面的代码示例是在Kanzi加载节点树后添加了一个消息相应到Button上：

void onProjectLoaded() override
{// Get reference to the Screen node.ScreenSharedPtr screen = getScreen();kzAssert(screen);// Look up reference to a button by alias.Button2DSharedPtr button = screen->lookupNode<Button2D>("#Button");kzAssert(button);// Attach a handler to the button.button->addMessageHandler(Button2D::ClickedMessage, [this](auto& arguments) { this->buttonHandler(arguments); });
}

下图是启动和关闭逻辑的回调过程。

观察应用程序状态

可以观察应用程序状态，以确定应用程序是否正在运行、最小化或挂起。

kanzi应用程序总在以下状态内：

• 运行状态。这是Kanzi应用程序的正常操作模式。这是应用程序的初始状态。

• 暂停状态。当应用程序不聚焦或最小化时，平台可以对应用程序行为施加规则。要标记这种状态，平台后端可以将应用程序设置为“暂停”状态。

在这种状态下，Kanzi停止正常的输入处理和渲染，并等待返回到运行状态。此外，在这种状态下，应用程序通常会停止繁重的工作。

• 正在退出状态。此状态表示应用程序或平台通过调用quit（）请求应用程序退出。在这种状态下，应用程序必须避免启动工作。

void doSomethingRepeatedly()
{doSomething();// If a condition is met...if (someCondition() &&// ...and the application is not quitting...getState() != MainLoopState::Quitting){// ...add another task to the task dispatcher.getDomain()->getTaskDispatcher()->submit([this]() { this->doSomethingRepeatedly(); });}
}

修改主循环逻辑

主循环由一系列阶段组成，其中每个阶段由一系列任务组成。 任务是任何可调用项，包括函数、函数对象和 lambda。

// c++ code
using Task = function<void(chrono::nanoseconds)>;// java code
public interface Task {void handle(Duration lastFrameDuration);
}

当 Kanzi 执行任务时，它会将最后一帧持续时间作为参数传递给任务。

以下是kanzi里的一些默认状态：

• 在输入阶段，Kanzi 处理输入事件。

• 在用户阶段，Kanzi 处理更新逻辑：部署资源、加载 kzb 文件和预制件，并执行您的任务调度程序和计时器任务。

• 在动画阶段，Kanzi 勾选活动动画。在布局阶段，Kanzi 对节点树进行布局。

• 在渲染阶段，Kanzi 渲染节点树。

• 在现阶段，Kanzi 展示了节点树。

下图展现了在kanzi 主循环中的控制流。

在应用中你能移除，替换，插入任务在主循环的调度阶段。

添加周期性任务

当你想kanzi在每一帧执行一个任务，您可以使用 appendTask() 和 prependTask() 将其添加到主循环的任何阶段，并带有选项 Recurring。

例如，您可以使用循环任务调用外部库的更新函数：

void onStartup() override
{// From the main loop Animate stage, tick an external physics engine.getMainLoopScheduler().appendTask(AnimateStage,kzMakeFixedString("TickPhysics"),MainLoopScheduler::TaskRecurrence::Recurring,[this](auto deltaTime) { this->getPhysicsEngine()->tick(deltaTime); });
}

添加一次性任务

当你想kanzi执行一次任务，您可以使用 appendTask() 和 prependTask() 将其添加到主循环的任何阶段，并带有选项 Recurring。

例如，要在用户按下 Enter 键时捕获输出的屏幕截图：

void onKeyInputEvent(const KeyEvent& keyEvent) override
{// First invoke the base class implementation.Application::onKeyInputEvent(keyEvent);// If the user presses the Enter key:if (keyEvent.getKeyUp() == LogicalKey::Enter){// Force re-rendering.getScreen()->invalidateDraw();// Add a post-rendering task to capture the screen output.getMainLoopScheduler().appendTask(RenderStage,kzMakeFixedString("CaptureScreenshot"),MainLoopScheduler::TaskRecurrence::OneTime,[this](auto) { this->captureScreen(); });}
}

重写任务

当您想要修改 Kanzi 用于处理输入、执行布局和呈现内容、更新屏幕以及执行其他重复任务的默认方法时，您可以使用 replaceTask() 替换现有任务。例如，重写默认渲染的典型用例是变形。 变形会扭曲输出，以便应用程序将其正确投影到曲面屏幕上。 您可以通过首先使用默认渲染实现将内容渲染到屏幕外纹理，然后将该纹理复制到屏幕并应用失真效果来实现此目的：

void onStartup() override
{// Create a texture for rendering.auto texture = createOffscreen();// Get the token of the default rendering task from the render stage.auto& scheduler = getMainLoopScheduler();auto tasks = scheduler.getTaskInfo(RenderStage);auto itTask = find_if(cbegin(tasks), cend(tasks), [](const auto& taskInfo) { return taskInfo.name == "Render"; });kzAssert(itTask != cend(tasks));auto token = itTask->token;// Replace the texture with the wrapped implementation.scheduler.replaceTask(RenderStage,token,[this, texture = move(texture)](auto) {auto renderer = this->getRenderer3D();auto& compositionStack = renderer->getCompositionStack();// Set the off-screen texture as the target.compositionStack.pushComposition(*texture);// Render to the off-screen texture using the default rendering logic.this->render();// Revert to the screen as the target.compositionStack.popComposition();// Render to the screen the texture with the wrapping effect applied.this->renderWarped(renderer, texture);// Mark the current frame as rendered.this->getMainLoopScheduler().setCurrentFrameRendered();});
}

作为单独替换任务的替代方法，可以通过充血 initializeMainLoopTasks() 来重新定义整个主循环。 Kanzi 在这个函数中附加了默认的主循环任务。 为了允许复制，它的实现有意暴露在头文件中。

添加定时器

当您希望 Kanzi 以固定的时间间隔执行任务时，您可以使用 prependTimer() 在主循环的某个阶段之前添加任务，并使用 appendTimer() 在主循环的某个阶段之后添加任务。使用定时器重复选项仅执行一次 (OneTime) 或重复 (Recurring) 定时器。 当循环计时器在 Kanzi 主循环的单次迭代中多次运行时，Kanzi 只执行该计时器一次。

void activateClock()
{// Add a recurring timer task that updates the clock once every second.m_clockTimer = getMainLoopScheduler().appendTimer(UserStage,kzMakeFixedString("Clock"),MainLoopScheduler::TimerRecurrence::Recurring,chrono::seconds(1),[this](auto elapsedDuration, auto repeatCount) {this->updateClock(elapsedDuration * repeatCount);});
}void deactivateClock()
{// Remove the clock timer.getMainLoopScheduler().removeTimer(m_clockTimer);
}

资源推荐

如果大家想了解更过关于Kanzi Engine plugin的更多学习信息，可以B站订阅“中科创达-智能座舱”官方号，https://space.bilibili.com/301867101/channel/series。目前内含Kanzi插件教程/Kanzi仪表教程/Kanzi零基础教程，后续会有课程陆续上新。