このページでは

C

Qul::SharedImage Struct

struct Qul::SharedImage

画像データへの共有参照。もっと見る...

Header: #include <qul/image.h>
Since: Qt Quick Ultralite 1.5

パブリック関数

SharedImage()
SharedImage(const Qul::SharedImage &other)
~SharedImage()
Qul::Image *image() const
(since Qt Quick Ultralite 2.12) bool maybeTexture(Qul::PlatformInterface::Texture &texture, int textureIndex = 0) const
(since Qt Quick Ultralite 2.2) Qul::PlatformInterface::Texture texture(int textureIndex = 0) const
(since Qt Quick Ultralite 2.2) int textureCount() const
bool operator bool() const
Qul::SharedImage &operator=(const Qul::SharedImage &other)

詳細説明

この構造体は、描画のために画像データを含むメモリバッファをQUL要素に渡すために使用されます。Image.source のようなプロパティはProperty<SharedImage> 型を持ちます。

最も一般的に使用される SharedImage 値は、コンパイラがコンパイル時に利用可能な画像リソース用に構築したもので、静的メモリ領域を指します。

Image を使えば、ヒープ上に新しい画像データを割り当てることも、別途用意した画像データをインポートすることもできます。Image は暗黙のうちにSharedImageに変換されます。

注意: image() 関数は、コンパイラが生成した SharedImage 値に対してNULLを返すことがあります。SharedImageが画像データを参照しているかどうかを調べるには、operator bool() を使用してください。

Imageも参照

メンバ関数ドキュメント

SharedImage::SharedImage()

ヌル画像参照を構築する。

SharedImage::SharedImage(const Qul::SharedImage &other)

コピーコンストラクタ

[noexcept] SharedImage::~SharedImage()

デストラクタ

Qul::Image *SharedImage::image() const

関連するImage があれば、それを取得する。

このSharedImageImage から作成された場合、その画像へのポインタを返します。

注意: 内部的には、Qt Quick Ultralite は、関連するImage を持たないSharedImage インスタンスを作成することがあります。このような場合、この関数はNULLを返します。

[since Qt Quick Ultralite 2.12] bool SharedImage::maybeTexture(Qul::PlatformInterface::Texture &texture, int textureIndex = 0) const

textureIndex にあるテクスチャを返します。

有効なインデックス範囲は 0 からtextureCount() - 1 です。

この関数は、リソースキャッシュに十分なメモリがなく、リソースキャッシュタイプOnDemand のテクスチャをロードできない場合にfalse を返します。

テクスチャのロードに成功すると、この関数はtrue を返し、テクスチャデータはtexture に格納されます。

この関数はQt Quick Ultralite 2.12 で導入されました。

SharedImage::textureCountも参照してください

[since Qt Quick Ultralite 2.2] Qul::PlatformInterface::Texture SharedImage::texture(int textureIndex = 0) const

textureIndex にあるテクスチャを返します。

有効なインデックス範囲は 0 からtextureCount() - 1 です。

注意: テクスチャの数が0の場合、この関数はエラーを引き起こします。

また、この関数は、リソースキャッシュにリソースキャッシュタイプOnDemand のテクスチャをロードするのに十分なメモリがない場合にもエラーをトリガします。

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

SharedImage::textureCountも参照してください

[since Qt Quick Ultralite 2.2] int SharedImage::textureCount() const

SharedImage に関連付けられたテクスチャの数を返します。

分割画像の最適化が有効な場合、テクスチャ数は 1 より大きくなることがあります。分割イメージ最適化を無効にするには、MCU.Config.Experimental.resourceSplitImageOptimizationfalse に設定します。

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

SharedImage::textureも参照してください

bool SharedImage::operator bool() const

SharedImage が画像データを参照している場合に true を返します。

Qul::SharedImage &SharedImage::operator=(const Qul::SharedImage &other)

コピー元other


詳細はこちら