このページでは

C

Qul::PlatformInterface::ImageDecoder Class

class Qul::PlatformInterface::ImageDecoder

ImageDecoderクラスは、カスタム画像デコーダを実装するための抽象APIを提供します。詳細...

Header: #include <platforminterface/imagedecoder.h>
Since: Qt Quick Ultralite (Platform) 2.7

パブリック型

(since Qt Quick Ultralite (Platform) 2.7) class RequestDataCallback

パブリック関数

virtual ~ImageDecoder()
virtual int decodeImage(Qul::PlatformInterface::ImageDecoder::RequestDataCallback &callback, unsigned char *outbuffer, uint32_t outbufferSize, Qul::PixelFormat pixelFormat, uint32_t requiredBytesPerLine) = 0
virtual bool imageInformation(Qul::PlatformInterface::ImageDecoder::RequestDataCallback &callback, int16_t *width, int16_t *height, Qul::PixelFormat *actualPixelFormat, Qul::PixelFormat optimalOpaquePixelFormat, Qul::PixelFormat optimalAlphaPixelFormat) = 0

詳細説明

カスタム画像デコーダを作成することで、任意の画像フォーマットをQML画像として利用することができます。Qt Quick Ultraliteエンジンは、登録されているすべての画像デコーダをチェックし、画像をデコードできるものを探します。

画像デコーダの統合も参照してください

メンバー関数ドキュメント

[virtual noexcept] ImageDecoder::~ImageDecoder()

画像デコーダのインスタンスを破棄します。

[pure virtual] int ImageDecoder::decodeImage(Qul::PlatformInterface::ImageDecoder::RequestDataCallback &callback, unsigned char *outbuffer, uint32_t outbufferSize, Qul::PixelFormat pixelFormat, uint32_t requiredBytesPerLine)

画像データを要求されたピクセル形式にデコードする。

画像データはcallback から読み込むことができ、与えられたoutbufferoutbufferSize にデコードする必要がある。要求されたpixelFormat は、imageInformation メソッドを呼び出すことによって前もって決定されている。デコーダは、requiredBytesPerLine が満たされていることを確認する必要があります。必要に応じて、適切なアライメントで行をコピーする必要があります。

1成功した場合、関数は0 を返さなければならない。

[pure virtual] bool ImageDecoder::imageInformation(Qul::PlatformInterface::ImageDecoder::RequestDataCallback &callback, int16_t *width, int16_t *height, Qul::PixelFormat *actualPixelFormat, Qul::PixelFormat optimalOpaquePixelFormat, Qul::PixelFormat optimalAlphaPixelFormat)

画像のプロパティを検査する。

画像データを完全にデコードする前に、QMLエンジンは画像に関するプロパティを要求する。callback はこの関数がデータを読み込むためのインタフェースを提供する。データを検査する際には、まず画像タイプを検出する必要がある。データがデコーダでデコードできない場合、この関数は直ちにfalse を返します。

width height optimalOpaquePixelFormat と は、デコードされた画像に最適なピクセルフォーマットを指定する。デコーダの能力と実際の画像データに応じて、 は、デコーダが提供できる結果のピクセル・フォーマットに設定しなければならない。optimalAlphaPixelFormat actualPixelFormat

関数が成功した場合は真が返され、そうでない場合は偽が返されます。

ImageDecoder::RequestDataCallbackも参照してください

特定の Qt ライセンスの下で利用可能です。
詳細はこちら。