関数ドキュメント

[since 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 を実行するも参照してください 。

[since Qt Quick Ultralite 2.10] void Qul::enableResourceChecksumVerification()

リソースデータのチェックサム検証を有効にする

この関数は、Qul::initPlatform()またはQul::initResources()が呼び出されたときに実行されるリソース初期化時に、リソースバイナリのチェックサム検証を有効にします。この検証は、実行時にCRC32チェックサムを計算し、リソースバイナリが最初に生成されたときに、Qt Quick Ultraliteリソースコンパイラによって計算されたチェックサムと比較します。

チェックサムの検証が失敗した場合、Qul::initPlatform()がPlatformInitializationType::InitializePlatformAndResources 初期化オプションで呼び出されると、パラメータResourceInitializationError::InvalidChecksum を持つQulError_Qul_ResourceInitializationFailed assert がトリガーされます。Qul::initResources() が使用された場合、それはエラーコードをResourceInitializationError::InvalidChecksum に返します。

リソースの初期化に失敗した場合、Qt Quick Ultralite API の使用はサポートされず、未定義の動作が発生する可能性があります。

この関数は、Qul::initPlatform() または Qul::initResources() が呼び出される前に呼び出されなければなりません。

この関数はQt Quick Ultralite 2.10 で導入されました。

initPlatform およびinitResourcesも参照して ください。

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

エラーcode のC-文字列表現へのポインタを返す。

デバッグ・ビルドでは、この関数は、エラー範囲の開始値と、Core およびPlatform の範囲のエラー・コードに対する文字列表現を返します。リリース・ビルドでは、エラー範囲の開始値に対する文字列表現と、それ以外のエラー・コード値に対する空文字列を返します。

この関数はQt Quick Ultralite 2.2で導入された。

Qul::PlatformInterface::error およびエラー処理も参照してください 。

[since 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 を実行するも参照してください 。

[since Qt Quick Ultralite 1.0] void Qul::initPlatform(Qul::PlatformInitializationType initializationType = PlatformInitializationType::InitializePlatformAndResources)

Qt Quick Ultralite プラットフォーム固有のコンポーネントを初期化する。

これには、Qt Quick UltraliteコアのリソースのプリロードとCPUベースのフォールバック描画エンジンの初期化が含まれます。

この関数は、app_target_default_entrypointが使用されている場合、デフォルトのエントリポイント実装の一部として暗黙的に呼び出されます。

この関数はPlatformContext::initializePlatform を呼び出します。

initializationType がPlatformInitializationType::InitializePlatformAndResources に設定 さ れてい る 場合は、 フ ォ ン ト のアルフ ァ マ ッ プ、 バ イ ナ リ リ ソ ース画像 リ ソ ース、 リ ソ ース キ ャ ッ シ ュ も 初期化 さ れます。こ れがデフ ォ ル ト 動作です。

initializationType がPlatformInitializationType::InitializePlatform に設定されている場合、アプリケーションは initPlatform() の呼び出しに続いてinitResources() を明示的に呼び出す必要があります。

この関数はQt Quick Ultralite 1.0 で導入されました。

appMain,initHardware,initResources,アプリケーションでQt Quick Ultralite を実行するも参照してください 。

[since Qt Quick Ultralite 2.10] Qul::Status<Qul::ResourceInitializationError> Qul::initResources(Qul::Flags<Qul::ResourceInitializationOptions> options = Qul::Flags<Qul::ResourceInitializationOptions>())

Qt Quick Ultralite リソースを初期化する。

この関数は、リソース・フォントのアルファ・マップ、バイナリ・リソース、イメージ・リソース、リソース・キャッシュを初期化します。リソースの初期化は、Application::exec （）またはApplication::update （）を呼び出す前に、アプリケーションの起動時に一度だけ行う必要があります。

この関数を使用する前に、Qul::initPlatform() をQul::PlatformInitializationType::InitializePlatform とともに呼び出す必要があります。

提供されるoptions を使用して、初期化の動作を制御できます。

戻り値は、初期化が成功したかどうかを示します。

リソースの初期化に失敗した場合、Qt Quick Ultralite API（この関数自体を含む）の使用はサポートされておらず、未定義の動作が発生する可能性があります。

リソースの初期化が既に成功した場合、この関数は直ちにtrue を返します。

この関数はQt Quick Ultralite 2.10で導入されました。

appMain,initHardware,initPlatform,アプリケーションでQt Quick Ultraliteを実行するも参照してください 。

[since Qt Quick Ultralite 2.12] bool Qul::queryResourceStorageSectionInfo(const char *resourceStorageSectionName, Qul::ResourceStorageSectionInfo *info = NULL)

QMLプロジェクトファイル中のImageFiles.MCU.resourceStorageSectionに記述されている、resourceStorageSectionName 。

この関数を直接呼び出すか、initPlatform()から呼び出す前に、initResources()を呼び出します。

リソース格納セクションが不明な場合はfalse を返します。

リソース格納セクションが既知の場合は、true が返され、info にリソース格納セクションに関する情報が含まれます。

この関数はQt Quick Ultralite 2.12で導入された。

[since 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で導入されました。

エラー処理も参照してください 。

[since Qt Quick Ultralite 2.12] bool Qul::validateMonotypeDataTableChecksums(Qul::MonotypeDataTables tables = MonotypeDataTables(MonotypeDataTable::AllDataTables))

指定したtables の Monotype データテーブルのチェックサムを検証します。

デフォルトでは、利用可能なすべてのテーブルが検証されます。

指定されたtables のチェックサムがすべて一致した場合はtrue を返し、そうでない場合はfalse を返します。

使用されるチェックサムアルゴリズムはCRC-32（IEEE 802.3）であり、0xedb88320（0x04c11db7の反映バージョン）の反映多項式を使用する。

データ・テーブルを外部フラッシュに保持する場合、Qul::initHardware （）または外部フ ラッシュを有効にする他の初期化ルーチンを最初に実行しなければならない。

この関数はQt Quick Ultralite 2.12 で導入された。

外部フラッシュに Monotype データテーブルを配置する」とinitResourcesも参照して ください。