QRhiTexture 类

QRhiTexture *texture = rhi->newTexture(QRhiTexture::RGBA8, QSize(512, 512));
if (!texture->create()) { error(); }
QRhiResourceUpdateBatch *batch = rhi->nextResourceUpdateBatch();
QImage image(512, 512, QImage::Format_RGBA8888);
image.fill(Qt::green);
batch->uploadTexture(texture, image);
// ...
commandBuffer->resourceUpdate(batch); // or, alternatively, pass 'batch' to a beginPass() call

// determine newSize, e.g. based on the swapchain's output size or other factors
if (texture->pixelSize() != newSize) {
    texture->setPixelSize(newSize);
    if (!texture->create()) { error(); }
}
// continue using texture, fill it with new data

成员函数文档

int QRhiTexture::arrayRangeLength() const

当调用setArrayRange()时，返回公开的数组范围大小。

另请参阅setArrayRange。

int QRhiTexture::arrayRangeStart() const

当调用setArrayRange()时，返回第一个数组层。

另请参阅setArrayRange。

int QRhiTexture::arraySize() const

返回纹理数组大小。

另请参阅setArraySize。

[纯虚函数] bool QRhiTexture::create()

创建相应的本地图形资源。如果没有较早的带有相应destroy()的create()调用而存在资源，则隐式调用destroy()。

当成功时返回true，当图形操作失败时返回false。无论返回值如何，调用destroy()总是安全的。

[虚函数] bool QRhiTexture::createFrom(QRhiTexture::NativeTexture src)

类似于create()，不同之处在于不创建新的本地纹理。相反，使用由src指定的本地纹理资源。

这允许从外部图形引擎导入现有的本地纹理对象（必须属于同一设备或共享上下文，具体取决于图形API）。

如果指定的现有本地纹理对象已成功封装为非拥有QRhiTexture，则返回true。

与此操作相反，将一个 QRhiTexture 创建的原生纹理对象暴露给外部引擎，可以通过 nativeTexture() 来实现。

int QRhiTexture::depth() const

返回3D纹理的深度。

另请参阅 setDepth()。

QRhiTexture::Flags QRhiTexture::flags() const

返回纹理标志。

另请参阅 setFlags()。

QRhiTexture::Format QRhiTexture::format() const

返回纹理格式。

另请参阅 setFormat()。

[虚函数] QRhiTexture::NativeTexture QRhiTexture::nativeTexture()

返回此纹理的下层原生资源。如果后端不支持暴露底层原生资源，则返回的值将为空。

另请参阅 createFrom()。

QSize QRhiTexture::pixelSize() const

返回像素大小。

另请参阅 setPixelSize()。

[重写虚函数] QRhiResource::Type QRhiTexture::resourceType() const

重实： QRhiResource::resourceType() const.

返回资源类型。

int QRhiTexture::sampleCount() const

返回采样数。1表示没有多重样本抗锯齿。

另请参阅 setSampleCount()。

void QRhiTexture::setArrayRange(int startIndex, int count)

通常所有数组层都会被暴露，并且通过传递到 texture() GLSL 函数的第三个坐标来选择层，这是由着色器在采样 sampler2DArray 时完成的。当 QRhi::TextureArrayRange 报告为支持时，在 create() 或 createFrom() 之前调用 setArrayRange()，请求仅选择指定的范围，从 startIndex 开始的 count 个元素。在这种情况下，着色器逻辑应相应地编写。

另请参阅 QRhi::TextureArrayRange.

void QRhiTexture::setArraySize(int arraySize)

设置纹理arraySize。

另请参阅 arraySize().

void QRhiTexture::setDepth(int depth)

为3D纹理设置depth。

另请参阅 depth().

void QRhiTexture::setFlags(QRhiTexture::Flags f)

将纹理标志设置为f。

另请参阅 flags().

void QRhiTexture::setFormat(QRhiTexture::Format fmt)

将请求的纹理格式设置为fmt。

另请参阅 format().

[虚拟] void QRhiTexture::setNativeLayout(int layout)

对于一些图形API，例如Vulkan，如果直接使用图形API进行自定义渲染，则需要在对图像布局的处理上特别小心。此函数允许在执行本地渲染命令后，传达预期图像所处的layout。

例如，考虑在代码块中使用Vulkan直接向QRhiTexture的VkImage渲染，该代码块被QRhiCommandBuffer::beginExternal()和QRhiCommandBuffer::endExternal()包围，然后在该QRhi基于的渲染通道中使用该图像进行纹理采样。为了避免可能不正确的图像布局转换，此函数可用于指示在记录上述代码块中的命令完成后图像将处于何种布局。

只有在使用QRhiCommandBuffer::endExternal()之后，并在后续的QRhiCommandBuffer::beginPass()之前调用此函数才有意义。

对于不公开图像布局概念的底层图形API的QRhi后端，此函数没有效果。

void QRhiTexture::setPixelSize(const QSize &sz)

将纹理大小设置为像素，为sz。

另请参阅 pixelSize().

void QRhiTexture::setSampleCount(int s)

将采样计数设置为s。

另请参阅 sampleCount().