// Allocate new image data on the heap
Qul::Image image1(drawImgSize, drawImgSize, Qul::PixelFormat_ARGB32_Premultiplied);

// Uses the data at myimagedata without a copy.
// (no cleanup function passed in, so lifetime of myimagedata must exceed any use)
// Application should take care about memory and texture width alignment
Qul::Image image2(getLogoData(),
                  logoImgWidth,
                  logoImgHeight,
                  Qul::PixelFormat_ARGB32_Premultiplied);

bytesPerLine % (bytesPerPixel * requiredPixelWidthAlignment) == 0

メンバ関数ドキュメント

Image::Image()

空の画像を作成する。

Image::Image(int width, int height, Qul::PixelFormat pixelFormat)

ヒープ上に新しいイメージデータを割り当てることによって構築する。

すべてのpixelFormat がすべてのプラットフォームでサポートされているわけではありません。サポートされていないフォーマットの画像は描画されませんが、エラーにはなりません。

Image::Image(uint8_t *bits, int width, int height, Qul::PixelFormat pixelFormat, int bytesPerLine = -1, Qul::Image::CleanupFunction cleanupFunction = nullptr)

外部所有メモリから構築する。

画像はbits の所有権を持つ。cleanupFunction は、データへの最後の参照（SharedImage 参照を含む）が破棄されたときに実行される。

プラットフォームによっては、画像データに対する特定の要件があります。これらを満たさない場合、アプリケーションはエラーを表示して停止します。Image::requiredAlignment とImage::requiredPixelWidthAlignment を参照してください。

pixelFormat 、すべてのプラットフォームでサポートされているわけではありません。サポートされていないフォーマットの画像は描画されませんが、エラーは発生しません。

bits の背後にある画像データは、beginWrite() とendWrite() の呼び出しの間でのみ変更可能である。ImageWriteGuard も参照のこと。

bytesPerLine が -1 の場合、width とpixelFormat に基づいて計算される。

void Image::beginWrite()

参照先のメモリーを書き込み操作用に準備する。

アーティファクトの可能性を避けるため、割り当てられたメモリ領域に書き込む前にこの関数を呼び出す。完了したらendWrite() を呼び出す。

多くのプラットフォームは、非同期で実行されるハードウェアアクセラレーションによる描画操作をサポートしています。この関数は、割り当てられたメモリ領域から読み込むそのような操作がすべて終了するのを待ちます。他のプラットフォームでは、書き込み操作が終了したら、画像を GPU メモリにアップロードする必要があるかもしれません。

endWrite()も参照してください 。

uint8_t *Image::bits()

画像のピクセル・データを読み書きできるように返す。

const uint8_t *Image::bits() const

読み込み用の画像ピクセルデータを返します。

int Image::bitsPerPixel() const

ピクセルあたりの画像ビット数を返します。

int Image::bytesPerLine() const

行あたりの画像バイト数を返します。

void Image::endWrite()

参照メモリへの書き込み操作を終了します。

これは、非同期読み込み操作の準備のためにdcacheフラッシュをトリガすることもあれば、画像データをGPUメモリにアップロードすることもあります。

画像データが現在画面に表示されている場合は、次のフレーム用に再描画されます。

beginWrite()も参照してください 。

int Image::height() const

画像の高さをピクセル単位で返します。

Qul::PixelFormat Image::pixelFormat() const

画像PixelFormat を返します。

void Image::reallocate(int width, int height, Qul::PixelFormat pixelFormat)

画像のサイズとフォーマットを変更し、既存の参照すべてに影響を与える。

これは、既存の画像データに対してクリーンアップ関数を実行し、ヒープ上に指定されたwidth 、height 、pixelFormat の新しい画像データを割り当てて置き換えます。

この画像へのすべての参照は、新しい画像データに更新されます。

int Image::width() const

画像の幅をピクセル単位で返します。

Qul::SharedImage Image::operator Qul::SharedImage() const

SharedImage に暗黙的に変換する。

Image とSharedImage は、基礎となるデータへの同じ参照カウントを使用する。