QRhiTextureCopyDescription 类
描述的是纹理到纹理的复制操作。 更多信息...
| 头文件 | #include <QRhiTextureCopyDescription> |
| CMake | find_package(Qt6 REQUIRED COMPONENTS Gui) target_link_libraries(mytarget PRIVATE Qt6::Gui) |
| qmake | QT += gui |
| 自 | 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 中的整个子资源。
注意：源纹理必须使用 QRhiTexture::UsedAsTransferSource 创建。
注意：由 pixelSize()、sourceTopLeft() 和 destinationTopLeft() 定义的源和目标矩形必须分别适合源和目标纹理。否则行为是未定义的。
对于立方体贴图、3D 纹理和纹理数组，可以一次复制一个面或切片。通过源和目标层索引指定面或切片。对于米柏纹理，可以一次复制一个米柏级别。源和目标层以及米柏级别索引可以不同，但大小和位置必须仔细控制，以避免超出范围的复制，否则行为是未定义的。
注意：这是一个 RHI API，具有有限的兼容性保证，请参阅QRhi以获取详细信息。
成员函数文档
[constexpr noexcept] QRhiTextureCopyDescription::QRhiTextureCopyDescription()
构造一个空的纹理复制描述。
int QRhiTextureCopyDescription::destinationLayer() const
返回目标数组层（立方体贴图面或数组层索引）。默认为0。
另请参阅setDestinationLayer。
int QRhiTextureCopyDescription::destinationLevel() const
返回目标MIP级别。默认为0。
另请参阅setDestinationLevel。
QPoint QRhiTextureCopyDescription::destinationTopLeft() const
返回目标左上角在像素中的位置。默认为(0, 0)。
QSize QRhiTextureCopyDescription::pixelSize() const
返回要复制的区域的尺寸。
注意： pixelSize()为空表示要复制整个子资源。因此，默认构造的复制描述会导致在0层级别0处复制整个子资源。
另请参阅setPixelSize。
void QRhiTextureCopyDescription::setDestinationLayer(int layer)
设置目标数组层layer。
另请参阅destinationLayer。
void QRhiTextureCopyDescription::setDestinationLevel(int level)
设置目标MIP级别level。
另请参阅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)
设置源MIP级别level。
另请参阅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。
© 2024 Qt公司有限公司。本文档中包含的贡献是各自的版权所有者。本提供的文档受自由软件基金会发布的GNU自由文档许可证第1.3版条款的许可。Qt及其相应标志是芬兰及其它国家和地区Qt公司有限公司的商标。所有其他商标均为其各自所有者的财产。
