関数ドキュメント

[since Qt Quick Ultralite (Platform) 1.5] void blendRectTiled(Qul::PlatformInterface::DrawingDevice *buffer, const Qul::PlatformInterface::Rect &rect, Qul::PlatformInterface::Rgba32 color, void (*)() finish, void (*)(void *, int) invalidateCache)

色を直接ブレンドする方法を持たない2Dアクセラレータのための回避策。

color 、適切な大きさのバッファをソースカラーで満たし、そのバッファをソースとして使用することで、rect 。

buffer finish はブレンド操作の最後に呼び出される。非同期ブレンディング操作を待つために使用されるかもしれません。 は、割り当てられたタイル・メモリのキャッシュを無効にするために呼び出されます。不要な場合は を指定する。NULL invalidateCache NULL

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

[since Qt Quick Ultralite (Platform) 1.5] void blendRectTiledAlphaMap(Qul::PlatformInterface::DrawingDevice *buffer, const Qul::PlatformInterface::Rect &rect, Qul::PlatformInterface::Rgba32 color, void (*)() finish, void (*)(void *, int) invalidateCache)

色を直接ブレンドする方法を持たない2Dアクセラレータのための回避策。

blendRectTiled と同じですが、DrawingEngine::blendAlphaMap を使います。

ARGB32をブレンドする必要がないため、帯域幅が節約されます。

適切な大きさのバッファをソースカラーで満たし、そのバッファをソースとして使用し、出力矩形全体をタイル化するために複数の呼び出しを行う可能性があることによって、rect にcolor をブレンドします。

buffer finish はブレンド操作の最後に呼び出される。非同期ブレンディング操作を待つために使用されるかもしれません。 は、割り当てられたタイル・メモリのキャッシュを無効にするために呼び出されます。不要な場合は を指定する。NULL invalidateCache NULL

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

void PlatformInterface::deviceLinkBytesReceived(const uint8_t *data, int size)

シリアル・ポートで受信したデータをさらにデコードして送信する。

この関数は、ホストから文字が受信されたときに、シリアル・ポート受信関数によって呼び出されなければならない。data は受信データで、size はその長さである。この関数はデータをQul::Platform::DeviceLink::charsReceived に転送します。

デバイスリンク通信の移植」も参照してください 。

[since Qt Quick Ultralite (Platform) 2.2] void error(unsigned int lineNumber, QulError code, int param1 = 0, int param2 = 0, int param3 = 0)

エラーメッセージをデフォルトまたはカスタムハンドラに報告します。

デフォルトのエラー・ハンドラは、エラーcode 、lineNumber 、および追加のparam1 、param2 、param3 をQul::Platform::PlatformContext::consoleWrite に出力する。

デフォルト・ハンドラは、エラー・メッセージを表示した後にプログラムを停止し、デバッグ用にバックトレースを保存するために無限ループに入ります。

カスタム・エラー・ハンドラがQul::setErrorHandler を使用して設定されている場合、そのハンドラを呼び出します。

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

エラー処理も参照してください 、 Qt Quick Ultralite error codesおよびQUL_ASSERT も参照してください。

[since Qt Quick Ultralite (Platform) 2.7] void generateGradientColorTable(const Qul::PlatformInterface::GradientStops &gradientStops, float opacity, Qul::PlatformInterface::Rgba32 *colorTable, int size, bool premultipliedAlpha)

グラデーションストップからグラデーションカラーテーブルを生成します。

与えられたgradientStops と不透明値opacity に基づいてグラデーションカラーテーブルを生成します。

colorTable パラ メ タは色テーブルを指 し 示 し 、size は色テーブルが持つべき項目の数を指定します。

premultipliedAlpha パラメータは、出力データにアルファ値を事前乗算するかどうかを指定します。

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

[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.9] int log(const char *format, ...)

format の文字列に従って ... で定義された引数を出力する。出力をQul::Platform::PlatformContext::consoleWrite に書き込む。

format はヌル終端マルチバイト文字列へのポインタで、データの解釈方法を指定します。

... には、印刷するデータを指定する引数が含まれる。

正常に書き込まれた文字数を返すか、エラーが発生した場合は負の値を返す。

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

Qul::Platform::PlatformContext::consoleWrite()も参照して ください。

[since Qt Quick Ultralite (Platform) 1.8] void pathArcToBeziers(Qul::PlatformInterface::cubicToPath func, void *data, float radiusX, float radiusY, float xAxisRotation, bool useLargeArc, bool clockwise, const Qul::PlatformInterface::PointF &source, const Qul::PlatformInterface::PointF &target)

円弧セグメントを一連のベジエ曲線に変換します。

提供されたコールバックfunc は、3次ベジエ曲線パラメータで最大4回呼び出されます。data ハンドルもコールバックの最初の引数として与えられ、必然的なaradiusYコンテキスト情報を提供するために使用することができます。

radiusX,radiusY,xAxisRotation,useLargeArc,clockwise,source andtarget パラメータは SVG 標準に従って弧セグメントを定義する。

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

Qul::PlatformInterface::PathDataArcSegmentも参照 。

template <typename T> void PlatformInterface::qul_delete(T *t)

型のメモリを解放し、デストラクタを呼び出すためのヘルパー関数。

t は、qul_new で以前に割り当てられた型へのポインタです。

template <typename T> T *PlatformInterface::qul_new()

T 型のQul::Platform::qul_malloc 実装を使用してメモリを確保し、そのコンストラクタを呼び出すヘルパー関数。

この関数は C++03 以下でのみ使用できます。

template <typename T, typename Arg1> T *PlatformInterface::qul_new(Arg1 arg1)

T 型のQul::Platform::qul_malloc 実装を使用してメモリを確保し、引数を指定してコンストラクタを呼び出すヘルパー関数。

この関数は C++03 以下でのみ使用できます。

template <typename T, typename... Args> T *PlatformInterface::qul_new(Args &&... args)

T 型のQul::Platform::qul_malloc 実装を使用してメモリを確保し、args でそのコンストラクタを呼び出すヘルパー関数。

この関数は C++11 以上でのみ使用可能です。

template <typename T, typename Arg1, typename Arg2> T *PlatformInterface::qul_new(Arg1 arg1, Arg2 arg2)

T 型のQul::Platform::qul_malloc 実装を使用してメモリを確保し、引数を指定してコンストラクタを呼び出すヘルパー関数。

この関数は C++03 以下でのみ使用できます。

template <typename T, typename Arg1, typename Arg2, typename Arg3> T *PlatformInterface::qul_new(Arg1 arg1, Arg2 arg2, Arg3 arg3)

T 型のQul::Platform::qul_malloc 実装を使用してメモリを確保し、引数を指定してコンストラクタを呼び出すヘルパー関数。

この関数は C++03 以下でのみ使用できます。

template <typename T, typename Arg1, typename Arg2, typename Arg3, typename Arg4> T *PlatformInterface::qul_new(Arg1 arg1, Arg2 arg2, Arg3 arg3, Arg4 arg4)

T 型のQul::Platform::qul_malloc 実装を使用してメモリを確保し、引数を指定してコンストラクタを呼び出すヘルパー関数。

この関数は C++03 以下でのみ使用できます。

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

エラーハンドラをhandler に設定する。

引数としてNULL を渡すと、デフォルトのエラーハンドリングに戻る。

以前のエラーハンドラへのポインタを返します。 デフォルトのエラーハンドラが使用されている場合は、NULL が返されます。

によって呼び出される。Qul::setErrorHandler

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

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

[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も参照してください 。

bool operator!=(const Qul::PlatformInterface::Rect &r1, const Qul::PlatformInterface::Rect &r2)

長方形r1 r2 が異なる場合はtrue を返し、そうでない場合はfalse を返す。

bool operator!=(const Qul::PlatformInterface::RectF &r1, const Qul::PlatformInterface::RectF &r2)

長方形r1 r2 が異なる場合はtrue を返し、そうでない場合はfalse を返す。

template <int M, int N, typename T1, typename T2> Qul::PlatformInterface::GenericMatrix<M, N, T2> operator*(T1 factor, const Qul::PlatformInterface::GenericMatrix<M, N, T2> &matrix)

matrix の全要素にスカラーfactor を掛けた結果を返す。

template <int M, int N1, int N2, typename T> Qul::PlatformInterface::GenericMatrix<M, N2, T> operator*(const Qul::PlatformInterface::GenericMatrix<M, N1, T> &m1, const Qul::PlatformInterface::GenericMatrix<N1, N2, T> &m2)

m1 とm2 の全要素を乗算した結果を返す。

template <int M, int N, typename T> Qul::PlatformInterface::GenericMatrix<M, N, T> operator+(const Qul::PlatformInterface::GenericMatrix<M, N, T> &m1, const Qul::PlatformInterface::GenericMatrix<M, N, T> &m2)

m1 とm2 の和を返す。

bool operator==(const Qul::PlatformInterface::Rect &r1, const Qul::PlatformInterface::Rect &r2)

長方形r1 r2 が等しい場合はtrue を返し、そうでない場合はfalse を返す。

bool operator==(const Qul::PlatformInterface::RectF &r1, const Qul::PlatformInterface::RectF &r2)

長方形r1 とr2 が等しい場合はtrue を返し、そうでない場合はfalse を返します。