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 |
| 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」も参照してください 。
SharedImage::operator bool() const
SharedImage が何らかの画像データを参照している場合、true を返します。
Qul::SharedImage &SharedImage::operator=(const Qul::SharedImage &other)
割り当てをコピー元からother
特定のQtライセンスの下で利用可能です。
詳細はこちら。
