QNativeInterface::QSGVulkanTexture Struct
提供对 Vulkan 图像对象的访问权限,并支持采用 Vulkan 图像对象。更多
头文件: | #include <QSGTexture> |
CMake: | find_package(Qt6 REQUIRED COMPONENTS Quick) target_link_libraries(mytarget PRIVATE Qt6::Quick) |
qmake: | QT += quick |
自 | Qt 6.0 |
- 所有成员(包括继承成员)的列表
- QSGVulkanTexture 是本地接口的一部分。
公共函数
virtual VkImage | nativeImage() const = 0 |
virtual VkImageLayout | nativeImageLayout() const = 0 |
静态公共成员
(since 6.0) QSGTexture * | fromNative(VkImage image, VkImageLayout layout, QQuickWindow *window, const QSize &size, QQuickWindow::CreateTextureOptions options = {}) |
成员函数文档
[static, since 6.0]
QSGTexture *QSGVulkanTexture::fromNative(VkImage image, VkImageLayout layout, QQuickWindow *window, const QSize &size, QQuickWindow::CreateTextureOptions options = {})
为window 创建一个新的QSGTexture ,封装现有的 Vulkanimage 对象。
生成的QSGTexture 封装了本机对象,但不拥有本机对象。函数的调用者负责删除返回的QSGTexture ,但这不会破坏底层的本地对象。
该函数目前仅适用于 2D RGBA 纹理。
警告: 如果场景图尚未初始化,此函数将返回空值。
layout 必须指定图像的当前布局。
使用options 可自定义纹理属性。此处只考虑 TextureHasAlphaChannel 和 TextureHasMipmaps。
size 指定以像素为单位的大小。
注意: 此函数必须在场景图渲染线程上调用。
此函数在 Qt 6.0 中引入。
另请参阅 QQuickWindow::sceneGraphInitialized(),QSGTexture,Scene Graph - Metal Texture Import(场景图 - 金属纹理导入)和Scene Graph - Vulkan Texture Import(场景图 - Vulkan 纹理导入)。
[pure virtual]
VkImage QSGVulkanTexture::nativeImage() const
返回 VkImage 句柄。
[pure virtual]
VkImageLayout QSGVulkanTexture::nativeImageLayout() const
返回图像布局。
© 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.