関数のドキュメント

[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をブレンドする必要がないため、帯域幅を多少節約できます。

color をrect にブレンドします。これには、ソースカラーで適切に大きなバッファを埋め、そのバッファをソースとして使用します。出力矩形全体をタイル状に描画するために、複数回の呼び出しが行われる場合があります。

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 へ転送します。

「DeviceLink通信の移植」も参照してください 。

[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列挙型の値に基づく、実際のキー識別子です。nativeScanCode はネイティブのスキャンコード識別子であり、プラットフォーム固有のカスタムキーを扱う際に、キー値Qul::Key_unknown と組み合わせて使用すると便利です。modifiers は、Qul::PlatformInterface::KeyModifier の値を論理和（OR）で組み合わせることで、キーイベント発生時にどのキー修飾キーが押されているかを指定します。

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

autoRepeat これは、そのキーが自動リピートキーであるかどうかを指定します。イベントが最初のキー押下によるものである場合は、false にする必要があります。

ucs4 は、キーが生成するテキストの ucs4 表現であり、さまざまな国際キーボードのサポートや文字の大文字・小文字の区別に役立ちます。コアエンジンはキーボードの状態を保持しないことに注意してください。現在アクティブな修飾キーの状態を追跡し、それに基づいて関連する ucs4 値を選択するのは、プラットフォーム統合の役割です。 コントロールキーの場合、または完全なテキスト入力サポートを必要としない場合は、NULLのままにしておく必要があります（その場合、QMLに送信されるキーイベントのtextプロパティは空になりますが、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()

Qt Quick Ultralite を、ARGB4444 形式での 16 BPP レンダリング用に初期化します。

デフォルトでは、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()

Qt Quick Ultralite を、RGB565 形式での 16 BPP レンダリング用に初期化します。

デフォルトでは、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()

Qt Quick Ultralite を、RGB32 形式での 32 BPP レンダリング用に初期化します。

デフォルトでは、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()

Qt Quick Ultralite を、RGB332 形式での 8 BPP レンダリング用に初期化します。

デフォルトでは、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()

Qt Quick Ultralite を、RGB888 形式での 24 BPP レンダリング用に初期化します。

デフォルトでは、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 ハンドルもコールバック関数の最初の引数として渡され、必要なコンテキスト情報を提供するのに使用できます。

radiusX 、radiusY 、xAxisRotation 、useLargeArc 、clockwise 、source 、およびtarget パラメータは、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 ` は、Qt Quick Ultralite エンジンが次に `Qul::PlatformInterface::updateEngine` を通じて更新される必要があるタイミングを、プラットフォームの実装に通知します。

この関数は、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 を返します。