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 があれば、それを取得する。
このSharedImage がImage から作成された場合、その画像へのポインタを返します。
注意: 内部的には、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.resourceSplitImageOptimization をfalse に設定します。
この関数はQt Quick Ultralite 2.2 で導入されました。
SharedImage::textureも参照してください 。
bool SharedImage::operator bool() const
SharedImage が画像データを参照している場合に true を返します。
Qul::SharedImage &SharedImage::operator=(const Qul::SharedImage &other)
コピー元other