機能説明

[since Qt Quick Ultralite (Platform) 1.5] void handleKeyEvent(uint64_t timestamp, Qul::PlatformInterface::KeyEventType type, int key, uint32_t nativeScanCode = 0, unsigned int modifiers = NoKeyboardModifier, const char *textUtf8 = NULL, bool autoRepeat = false, uint32_t ucs4 = 0)

キーイベントの処理

プラットフォームレイヤーから受け取ったキーイベントは、この関数を通してコアエンジンに渡されなければならない。timestamp はイベントが発生した時刻である。これは通常、プラットフォームのネイティブタイムスタンプ関数から読み取られた時刻です。type は、これがキーの押下イベントなのか、離鍵イベントなのかを指定します。key は、Qul::PlatformInterface::Key enumの値に従った、実際のキー識別子です。 nativeScanCode Qul::Key_unknown modifiers は、Qul::PlatformInterface::KeyModifier の値の OR の組み合わせによって、キーイベントの時にどのキー修飾子が押されているかを指定します。

textUtf8 は未使用で、次のメジャーリリースで削除される予定です。

autoRepeat は、このキーが自動繰り返しキーであるかどうかを指定します。

ucs4 はキーが生成するテキストのucs4表現で、さまざまな国際キーボードサポートや文字ケーシングに役立ちます。コアエンジンはキーボードの状態を保持しないことに注意してください。プラットフォーム統合は、現在アクティブな修飾子の状態を追跡し、それに基づいて関連するucs4値を選択する責任を負います。コントロールキーや、完全なテキスト入力をサポートしたくない場合は、NULLのままにしておく必要があります（その場合、QMLに配信されるキーイベントは空のテキストプロパティを持ちますが、key とnativeScanCode の値に基づいてアクションを選択することは可能です）。

この関数はQt Quick Ultralite (Platform) 1.5 で導入されました。

Qul::Platform::PlatformContext::currentTimestampも参照して ください。

[since Qt Quick Ultralite (Platform) 1.5] void handleTouchCancelEvent(Qul::PlatformInterface::Screen *screen, uint64_t timestamp)

タッチイベントをキャンセル

screen のタッチイベントをキャンセルします。timestamp はイベントが発生した時刻です。これは通常、プラットフォームのネイティブタイムスタンプ機能から読み取られた時刻です。screen がNULL の場合、プラットフォームのプライマリ画面が使用されます。

この関数はQt Quick Ultralite (Platform) 1.5で導入されました。

Qul::Platform::PlatformContext::currentTimestamp およびQul::Platform::PlatformContext::availableScreensも参照してください 。

[since Qt Quick Ultralite (Platform) 1.5] void handleTouchEvent(Qul::PlatformInterface::Screen *screen, uint64_t timestamp, const Qul::PlatformInterface::TouchPoint *touchPoints, unsigned int numTouchPoints)

タッチイベントを処理する

プラットフォームレイヤーから受信したタッチイベントは、この関数を通してコアエンジンに渡す必要がある。screen はタッチイベントが発行されたスクリーンである。timestamp はイベントが発生した時間である。これは通常、プラットフォームのネイティブタイムスタンプ機能から読み取られた時刻である。touchPoints とnumTouchPoints には、現在アクティブなタッチポイントのリストが含まれる。タッチポイントの所有権は呼び出し関数にある。screen がNULL の場合、プラットフォームのプライマリー・スクリーンが使用される。

この関数はQt Quick Ultralite (Platform) 1.5で導入されました。

Qul::Platform::PlatformContext::currentTimestamp およびQul::Platform::PlatformContext::availableScreensも参照してください 。

[since Qt Quick Ultralite (Platform) 2.9] void initializeArgb32CpuFallbackDrawingEngine()

ARGB32 フォーマットの 32 BPP レンダリング用にQt Quick Ultralite を初期化します。

デフォルトでは、Qt Quick Ultralite はフォールバック レンダラーを参照しないため、フォールバック レンダラーが使用されない場合は破棄されます。

この関数は、ARGB32フォーマットの32 BPP描画デバイス用のフォールバックレンダラを設定します。ARGB32 CPU フォールバック描画エンジンは、RGB32 CPU フォールバック描画エンジンと同じ描画エンジンとブレンド関数を使用します。

この関数はQt Quick Ultralite (Platform) 2.9 で導入されました。

Qul::PlatformInterface::initializeRgb332CpuFallbackDrawingEngine,Qul::PlatformInterface::initializeRgb16CpuFallbackDrawingEngine,Qul::PlatformInterface::initializeArgb4444CpuFallbackDrawingEngine,Qul::PlatformInterface::initializeRgb888CpuFallbackDrawingEngine,Qul::PlatformInterface::initializeBgr888CpuFallbackDrawingEngine,Qul::PlatformInterface::initializeRgb32CpuFallbackDrawingEngineも参照してください 。

[since Qt Quick Ultralite (Platform) 2.9] void initializeArgb4444CpuFallbackDrawingEngine()

ARGB4444 フォーマットの 16 BPP レンダリング用にQt Quick Ultralite を初期化します。

デフォルトでは、Qt Quick Ultralite はフォールバック レンダラーを参照しないため、フォールバック レンダラーが使用されない場合は破棄されます。

この関数は、ARGB4444フォーマットの16 BPP描画デバイス用のフォールバックレンダラを設定します。

この関数はQt Quick Ultralite (Platform) 2.9 で導入されました。

Qul::PlatformInterface::initializeRgb332CpuFallbackDrawingEngine,Qul::PlatformInterface::initializeRgb16CpuFallbackDrawingEngine,Qul::PlatformInterface::initializeRgb888CpuFallbackDrawingEngine,Qul::PlatformInterface::initializeBgr888CpuFallbackDrawingEngine,Qul::PlatformInterface::initializeArgb32CpuFallbackDrawingEngine,Qul::PlatformInterface::initializeRgb32CpuFallbackDrawingEngineも参照してください 。

[since Qt Quick Ultralite (Platform) 2.9] void initializeBgr888CpuFallbackDrawingEngine()

BGR888 フォーマットの 24 BPP レンダリング用にQt Quick Ultralite を初期化します。

デフォルトでは、Qt Quick Ultralite はフォールバック レンダラーを参照しないため、フォールバック レンダラーが使用されない場合は破棄されます。

この関数は、BGR888フォーマットの24 BPP描画デバイス用のフォールバックレンダラを設定します。RGB888フォーマットにはQul::PlatformInterface::initializeRgb888CpuFallbackDrawingEngine 。

この関数はQt Quick Ultralite (Platform) 2.9 で導入されました。

Qul::PlatformInterface::initializeRgb332CpuFallbackDrawingEngine,Qul::PlatformInterface::initializeRgb16CpuFallbackDrawingEngine,Qul::PlatformInterface::initializeArgb4444CpuFallbackDrawingEngine,Qul::PlatformInterface::initializeRgb888CpuFallbackDrawingEngine,Qul::PlatformInterface::initializeArgb32CpuFallbackDrawingEngine,Qul::PlatformInterface::initializeRgb32CpuFallbackDrawingEngineも参照してください 。

[since Qt Quick Ultralite (Platform) 2.9] void initializeRgb16CpuFallbackDrawingEngine()

RGB565 フォーマットの 16 BPP レンダリング用にQt Quick Ultralite を初期化します。

デフォルトでは、Qt Quick Ultralite はフォールバック レンダラーを参照しないため、フォールバック レンダラーが使用されない場合は破棄されます。

この関数は、RGB565フォーマットの16 BPP描画デバイス用のフォールバックレンダラを設定します。

この関数はQt Quick Ultralite (Platform) 2.9 で導入されました。

Qul::PlatformInterface::initializeRgb332CpuFallbackDrawingEngine,Qul::PlatformInterface::initializeArgb4444CpuFallbackDrawingEngine,Qul::PlatformInterface::initializeRgb888CpuFallbackDrawingEngine,Qul::PlatformInterface::initializeBgr888CpuFallbackDrawingEngine,Qul::PlatformInterface::initializeArgb32CpuFallbackDrawingEngine,Qul::PlatformInterface::initializeRgb32CpuFallbackDrawingEngineも参照してください 。

[since Qt Quick Ultralite (Platform) 2.9] void initializeRgb32CpuFallbackDrawingEngine()

RGB32 フォーマットの 32 BPP レンダリング用にQt Quick Ultralite を初期化します。

デフォルトでは、Qt Quick Ultralite はフォールバック レンダラーを参照しないため、フォールバック レンダラーが使用されない場合は破棄されます。

この関数は、RGB32フォーマットの32 BPP描画デバイス用のフォールバックレンダラを設定します。RGB32 CPU フォールバック描画エンジンは、ARGB32 CPU フォールバック描画エンジンと同じ描画エンジンとブレンド関数を使用します。

この関数はQt Quick Ultralite (Platform) 2.9 で導入されました。

Qul::PlatformInterface::initializeRgb332CpuFallbackDrawingEngine,Qul::PlatformInterface::initializeRgb16CpuFallbackDrawingEngine,Qul::PlatformInterface::initializeArgb4444CpuFallbackDrawingEngine,Qul::PlatformInterface::initializeRgb888CpuFallbackDrawingEngine,Qul::PlatformInterface::initializeBgr888CpuFallbackDrawingEngine,Qul::PlatformInterface::initializeArgb32CpuFallbackDrawingEngineも参照してください 。

[since Qt Quick Ultralite (Platform) 2.9] void initializeRgb332CpuFallbackDrawingEngine()

RGB332 フォーマットの 8 BPP レンダリング用にQt Quick Ultralite を初期化します。

デフォルトでは、Qt Quick Ultralite はフォールバック レンダラーを参照しないため、フォールバック レンダラーが使用されない場合は破棄されます。

この関数は、RGB332フォーマットの8 BPP描画デバイス用のフォールバックレンダラを設定します。

この関数はQt Quick Ultralite (Platform) 2.9 で導入されました。

Qul::PlatformInterface::initializeRgb16CpuFallbackDrawingEngine,Qul::PlatformInterface::initializeArgb4444CpuFallbackDrawingEngine,Qul::PlatformInterface::initializeRgb888CpuFallbackDrawingEngine,Qul::PlatformInterface::initializeBgr888CpuFallbackDrawingEngine,Qul::PlatformInterface::initializeArgb32CpuFallbackDrawingEngine,Qul::PlatformInterface::initializeRgb32CpuFallbackDrawingEngineも参照してください 。

[since Qt Quick Ultralite (Platform) 2.9] void initializeRgb888CpuFallbackDrawingEngine()

RGB888 フォーマットの 24 BPP レンダリング用にQt Quick Ultralite を初期化します。

デフォルトでは、Qt Quick Ultralite はフォールバック レンダラーを参照しないため、フォールバック レンダラーが使用されない場合は破棄されます。

この関数は、RGB888フォーマットの24 BPP描画デバイス用のフォールバックレンダラを設定します。BGR888フォーマットにはQul::PlatformInterface::initializeBgr888CpuFallbackDrawingEngine 。

この関数はQt Quick Ultralite (Platform) 2.9 で導入されました。

Qul::PlatformInterface::initializeRgb332CpuFallbackDrawingEngine,Qul::PlatformInterface::initializeRgb16CpuFallbackDrawingEngine,Qul::PlatformInterface::initializeArgb4444CpuFallbackDrawingEngine,Qul::PlatformInterface::initializeBgr888CpuFallbackDrawingEngine,Qul::PlatformInterface::initializeArgb32CpuFallbackDrawingEngine,Qul::PlatformInterface::initializeRgb32CpuFallbackDrawingEngineも参照してください 。

[since Qt Quick Ultralite (Platform) 1.5] void updateEngine(uint64_t timestamp)

Qt Quick Ultralite エンジンのアップデート

Qt Quick Ultraliteエンジンは、タイマーと表示アニメーションを更新するために定期的に更新する必要があります。

timestamp パラメーターは、Qul::Platform::PlatformContext::currentTimestamp() によって報告された、ミリ秒単位の現在のプラットフォームのタイムスタンプです。

この例では、メイン・ループからエンジンの更新を実行する典型的なセクションを示しています。

static uint64_t nextUpdate = 0;

void scheduleEngineUpdate(uint64_t timeout) {
   nextUpdate = timeout;
}

while_loop {
    const uint64_t timestamp = Qul::Platform::PlatformContext::currentTimestamp();
    if (timestamp >= nextUpdate) {
        Qul::PlatformInterface::updateEngine(timestamp);
    } else {
        // Device could sleep until time in 'nextUpdate'.
        enterSleepMode(nextUpdate);
    }
}

コールバックQul::Platform::PlatformContext::scheduleEngineUpdate は、Qul::PlatformInterface::updateEngineを介して、次にQt Quick Ultraliteエンジンの更新が必要になったことをプラットフォーム実装に通知します。

この関数はQt Quick Ultralite (Platform) 1.5 で導入されました。

Qul::Platform::PlatformContext::scheduleEngineUpdate とQul::Platform::PlatformContext::currentTimestampも参照してください 。