QRhiTextureCopyDescription Class

テクスチャからテクスチャへのコピー操作を記述します。詳細...

ヘッダー #include <rhi/qrhi.h>
CMake: find_package(Qt6 REQUIRED COMPONENTS Gui)
target_link_libraries(mytarget PRIVATE Qt6::GuiPrivate)
qmake: QT += gui-private
以来:Qt 6.6

パブリック関数

QRhiTextureCopyDescription()
int destinationLayer() const
int destinationLevel() const
QPoint destinationTopLeft() const
QSize pixelSize() const
void setDestinationLayer(int layer)
void setDestinationLevel(int level)
void setDestinationTopLeft(const QPoint &p)
void setPixelSize(const QSize &sz)
void setSourceLayer(int layer)
void setSourceLevel(int level)
void setSourceTopLeft(const QPoint &p)
int sourceLayer() const
int sourceLevel() const
QPoint sourceTopLeft() const

詳細説明

空のpixelSize() は、サブリソース全体がコピーされることを示します。したがって、デフォルトのコピー記述は、レイヤー 0 のレベル 0 でサブリソース全体をコピーすることになります。

Note: ソーステクスチャはQRhiTexture::UsedAsTransferSource で作成する必要があります。

注: pixelSize(),sourceTopLeft(),destinationTopLeft() で定義されるコピー元およびコピー先の矩形は、それぞれコピー元およびコピー先のテクスチャに適合していなければなりません。そうでない場合の動作は未定義です。

キューブマップ、3Dテクスチャ、およびテクスチャ配列では、一度に1つの面またはスライスをコピーできます。面やスライスはコピー元とコピー先のレイヤーインデックスで指定します。ミップマップ テクスチャでは、一度に 1 つのミップ レベルをコピーできます。コピー元とコピー先のレイヤーとミップレベルのインデックスは異なってもかまいませんが、サイズと位置は境界外のコピーを避けるために注意深く制御されなければなりません。

注意: これは互換性保証に制限のあるRHI APIです。詳細はQRhi を参照してください。

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

[constexpr noexcept] QRhiTextureCopyDescription::QRhiTextureCopyDescription()

空のテクスチャコピー記述を構築します。

int QRhiTextureCopyDescription::destinationLayer() const

出力配列レイヤー(キューブマップ面または配列レイヤーインデックス)を返します。デフォルトは 0。

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

int QRhiTextureCopyDescription::destinationLevel() const

デスティネーション・ミップ・レベルを返す。デフォルトは 0。

setDestinationLevel()も参照

QPoint QRhiTextureCopyDescription::destinationTopLeft() const

デスティネーションの左上の位置をピクセル単位で返します。デフォルトは (0, 0)。

setDestinationTopLeft()も参照

QSize QRhiTextureCopyDescription::pixelSize() const

コピーする領域のサイズを返します。

注意: 空の pixelSize() は、サブリソース全体がコピーされることを示す。したがって、デフォルトのコピー記述は、レイヤ 0 のレベル 0 のサブリソース全体をコピーすることになります。

setPixelSize()も参照

void QRhiTextureCopyDescription::setDestinationLayer(int layer)

出力配列layer を設定する。

destinationLayer()も参照

void QRhiTextureCopyDescription::setDestinationLevel(int level)

デスティネーションの miplevel を設定する。

destinationLevel()も参照のこと

void QRhiTextureCopyDescription::setDestinationTopLeft(const QPoint &p)

デスティネーションの左上位置を設定するp

destinationTopLeft()も参照

void QRhiTextureCopyDescription::setPixelSize(const QSize &sz)

コピーする領域のサイズをsz に設定する。

pixelSize()も参照のこと

void QRhiTextureCopyDescription::setSourceLayer(int layer)

ソース配列layer を設定する。

sourceLayer()も参照

void QRhiTextureCopyDescription::setSourceLevel(int level)

ソース miplevel を設定する。

sourceLevel()も参照のこと

void QRhiTextureCopyDescription::setSourceTopLeft(const QPoint &p)

ソース左上の位置をp に設定します。

sourceTopLeft()も参照

int QRhiTextureCopyDescription::sourceLayer() const

ソース配列レイヤ (キューブマップ面または配列レイヤインデックス) を返します。デフォルトは 0 です。

setSourceLayer()も参照してください

int QRhiTextureCopyDescription::sourceLevel() const

ソース MIP レベルを返す。デフォルトは 0。

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

QPoint QRhiTextureCopyDescription::sourceTopLeft() const

ソースの左上位置を(ピクセル単位で)返します。デフォルトは (0, 0)。

setSourceTopLeft()も参照してください

© 2025 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.