函数文档

[自 Qt Quick Ultralite 1.0 开始] void Qul::appMain(const void *arg = NULL)

此函数初始化并作为 Qt Quick Ultralite 应用程序的主循环。此函数永远不退出。arg 未使用。

在调用此函数之前需要初始化硬件和 Qt Quick Ultralite 平台特定组件。

如果使用 app_target_default_entrypoint，则此函数会隐式地作为默认入口点实现的一部分被调用。

此函数是在 Qt Quick Ultralite 1.0 中引入的。

另请参阅initHardware、initPlatform 和 在应用程序中运行 Qt Quick Ultralite。

[自 Qt Quick Ultralite 2.2 开始] const char *errorCodeToString(QulError code)

返回错误代码的 C 字符串表示的指针。

在调试构建中，该函数返回错误范围起始值和 Core 和 Platform 范围内的错误代码的字符串表示。在发布构建中，它返回错误范围起始值的字符串表示和错误代码值其余部分的空字符串。

此函数是在 Qt Quick Ultralite 2.2 中引入的。

另请参阅Qul::PlatformInterface::error 和 错误处理。

[自 Qt Quick Ultralite 2.0 开始] void Qul::initHardware()

初始化 Qt Quick Ultralite 所需的硬件。

这可能包括时钟、引脚、外设、总线和外存。

通常在 Qul::initPlatform() 调用之前调用它，但开发者也可以决定不调用它，并执行自己的硬件初始化。

如果使用 app_target_default_entrypoint，则此函数会隐式地作为默认入口点实现的一部分被调用。

此函数调用 PlatformContext::initializeHardware。

此函数是在 Qt Quick Ultralite 2.0 中引入的。

另请参阅appMain、initPlatform 和 在应用程序中运行 Qt Quick Ultralite。

[自 Qt Quick Ultralite 1.0 开始] void Qul::initPlatform()

初始化 Qt Quick Ultralite 平台特定组件。

这可能包括资源预加载和在 Qt Quick Ultralite 核心中初始化基于 CPU 的回退绘图引擎。

如果使用 app_target_default_entrypoint，则此函数会隐式地作为默认入口点实现的一部分被调用。

此函数调用 PlatformContext::initializePlatform 并初始化字体 alpha 映射和图像资源。

此函数是在 Qt Quick Ultralite 1.0 中引入的。

另请参阅appMain、initHardware 和 在应用程序中运行 Qt Quick Ultralite。

[自 Qt Quick Ultralite 2.2 开始] QulErrorHandler *Qul::setErrorHandler(QulErrorHandler *handler)

将错误处理程序设置为 handler。当使用 Qul::PlatformInterface::error 报告错误时，会调用 handler。

将NULL作为参数传递将恢复默认错误处理。

错误处理示例

#include <qul/error.h>

void customErrorHandler(enum QulError code, unsigned int lineNumber, int param1, int param2, int param3)
{
    Qul::PlatformInterface::log("Error code: %u, line: %u, params: %i, %i, %i.\r\n",
                                (unsigned int) code,
                                lineNumber,
                                param1,
                                param2,
                                param3);

    while (1) {
    }; // The error handler must not return!
}

以下示例中将customErrorHandler函数设置为处理错误。

Qul::initHardware();
Qul::setErrorHandler(customErrorHandler);
Qul::initPlatform();
Qul::Application app;

此函数调用了Qul::PlatformInterface::setErrorHandler。

返回前一个错误处理器的指针或在默认处理器正在使用时返回NULL。

此函数是在 Qt Quick Ultralite 2.2 中引入的。

另请参阅 错误处理。