Function Documentation

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

This function initializes and also acts as a main loop for Qt Quick Ultralite application. This function never exits. arg is not used.

Hardware and Qt Quick Ultralite platform specific components needs to be initialized before calling this function.

This function is called implicitly as part of default entry point implementation if app_target_default_entrypoint is used.

This function was introduced in Qt Quick Ultralite 1.0.

See also initHardware, initPlatform, and Running Qt Quick Ultralite in applications.

[since Qt Quick Ultralite 2.2] const char *errorCodeToString(QulError code)

Returns a pointer to C-string representation of the error code.

On debug build, the function returns a string representation for error range start values and error codes in the Core and Platform range. On release build, it returns a string representation for error range start values and empty string for the rest of error code values.

This function was introduced in Qt Quick Ultralite 2.2.

See also Qul::PlatformInterface::error and Error handling.

[since Qt Quick Ultralite 2.0] void Qul::initHardware()

Initialize hardware required by Qt Quick Ultralite.

This may include clocks, pins, peripherals, buses and memories.

Typically it's called just before Qul::initPlatform(), but developer may also decide not call it all and perform its own hardware initialization.

This function is called implicitly as part of default entry point implementation if app_target_default_entrypoint is used.

This function calls PlatformContext::initializeHardware.

This function was introduced in Qt Quick Ultralite 2.0.

See also appMain, initPlatform, and Running Qt Quick Ultralite in applications.

[since Qt Quick Ultralite 1.0] void Qul::initPlatform()

Initialize Qt Quick Ultralite platform specific components.

This may include resource preloading and initializing CPU-based fallback drawing engine in Qt Quick Ultralite core.

This function is called implicitly as part of default entry point implementation if app_target_default_entrypoint is used.

This function calls PlatformContext::initializePlatform and initializes font alpha maps and image resources.

This function was introduced in Qt Quick Ultralite 1.0.

See also appMain, initHardware, and Running Qt Quick Ultralite in applications.

[since Qt Quick Ultralite 2.2] QulErrorHandler *Qul::setErrorHandler(QulErrorHandler *handler)

Set error handler to handler. handler is called when error is reported with Qul::PlatformInterface::error.

Passing NULL as argument will restore the default error handling.

Error handler example:

#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!
}

The customErrorHandler function is set to handle the errors in the example below.

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

This function calls Qul::PlatformInterface::setErrorHandler.

Returns a pointer to the previous error handler or NULL when the default handler is in use.

This function was introduced in Qt Quick Ultralite 2.2.

See also Error handling.