関数のドキュメント

[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 Resource Compilerによって計算されたチェックサムと比較します。

チェックサムの検証に失敗した場合、PlatformInitializationType::InitializePlatformAndResources という初期化オプションを指定してQul::initPlatform()が呼び出されていると、パラメータResourceInitializationError::InvalidChecksum を持つQulError_Qul_ResourceInitializationFailed のアサートがトリガーされます。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::PlatformInitializationType::InitializePlatform を引数として Qul::initPlatform() を呼び出しておく必要があります。

渡されたoptions を使用して、初期化の挙動を制御できます。

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

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

リソースの初期化がすでに正常に実行されている場合、この関数は直ちにtrue を返します。

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

「 appMain 」、「initHardware 」、「initPlatform 」、および「アプリケーションでのQt Quick Ultraliteの実行」も参照してください 。

[since Qt Quick Ultralite 2.12.2] void Qul::initializeCoreFeatures()

Qt Quick Ultraliteのさまざまなコア機能を初期化します。

コアライブラリがQUL_FEATURE_TOGGLING=ON でビルドされている場合、切り替え可能な機能のいずれかを使用するには、この関数を呼び出します。

アプリケーションが利用できない機能を使用している場合、Qt Quick Ultralite はランタイムエラーを記録し、アプリケーションを停止します。

この関数は、PlatformInitializationType::InitializePlatformAndResources を指定してQul::initPlatform を呼び出す前に呼び出す必要があります。PlatformInitializationType::InitializePlatform を指定してQul::initPlatform を呼び出す場合は、Qul::initResources を呼び出す前にこの関数を呼び出してください。

アプリケーションは、Qul::initializeCoreFeatures を呼び出すソースファイル内でさまざまな定義を使用し、機能を無効にして、最終的なアプリケーションバイナリのコードサイズを削減することができます:

使用例：

#define QUL_CORE_DISABLE_CPU_DRAWING_ENGINE_PATHDATA_STROKER
#include <qul/features.h>
int main(int argc, char **argv)
{
    Qul::initHardware();
    Qul::initializeCoreFeatures();
    ...
}

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

QUL_FEATURE_TOGGLINGも参照してください 。

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

resourceStorageSectionName を使用してリソースストレージセクションに関する情報を照会します。これは、QMLプロジェクトファイル内でImageFiles.MCU.resourceStorageSection として記述されています。

この関数を直接、または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 」も参照してください 。