Класс QWaitFence

класс Qt3DRender::QWaitFence

FrameGraphNode используется для ожидания сигнализации заграждения в потоке графических команд. Подробнее...

Заголовок:	#include <QWaitFence>
CMake:	find_package(Qt6 COMPONENTS 3drender REQUIRED) target_link_libraries(mytarget PRIVATE Qt6::3drender)
qmake:	QT += 3drender
С тех пор:	Qt 5.13
Наследует:	Qt3DRender::QFrameGraphNode

Список всех членов, включая унаследованные

Свойства

handle : QVariant
handleType : HandleType
timeout : quint64
waitOnCPU : bool

Публичные функции

QVariant	handle() const
Qt3DRender::QWaitFence::HandleType	handleType() const
void	setHandle(QVariant handle)
void	setHandleType(Qt3DRender::QWaitFence::HandleType type)
void	setTimeout(quint64 timeout)
void	setWaitOnCPU(bool waitOnCPU)
quint64	timeout() const
bool	waitOnCPU() const

Сигналы

void	handleChanged(QVariant handle)
void	handleTypeChanged(Qt3DRender::QWaitFence::HandleType handleType)
void	timeoutChanged(quint64 timeoutChanged)
void	waitOnCPUChanged(bool waitOnCPU)

Подробное описание

Заграждения позволяют синхронизировать рабочие нагрузки GPU и CPU. Команды GPU обычно неблокирующие. При выполнении команды добавляются в буферы команд, которые будут позже считаны GPU. В некоторых случаях вам нужно продолжить обработку или выполнить определённую команду только тогда, когда вы уверены, что команда была выполнена оборудованием. Заграждения — способ сделать это. Это особенно важно при использовании сторонних движков с Qt3D, Qt3D должен получать доступ к общим ресурсам только тогда, когда нам известно, что другие команды движка закончили модификацию ресурса.

QWaitFence — узел FrameGraph, который заставит подождать, пока он не станет сигнализированным, прежде чем последующие команды будут добавлены в поток команд. Затем его можно использовать в сочетании с QSetFence и содержит свойства для настройки того, как долго он должен ждать и следует ли блокировать сторону CPU.

Примечание: Qt 3D загружает ресурсы GPU (текстуры, шейдеры, буферы) перед вызовом рисования.

Документация по свойствам

handle : QVariant

Содержит базовое заграждение, обернутое в QVariant.

Функции доступа:

QVariant	handle() const
void	setHandle(QVariant handle)

Сигнал оповещения:

void	handleChanged(QVariant handle)

handleType : HandleType

Указывает тип используемого заграждения. В настоящее время поддерживаются только идентификаторы заграждения OpenGL.

Функции доступа:

Qt3DRender::QWaitFence::HandleType	handleType() const
void	setHandleType(Qt3DRender::QWaitFence::HandleType type)

Сигнал оповещения:

void	handleTypeChanged(Qt3DRender::QWaitFence::HandleType handleType)

timeout : quint64

Указывает максимальное время в наносекундах ожидания, пока заграждение не станет сигнализированным.

Функции доступа:

quint64	timeout() const
void	setTimeout(quint64 timeout)

Сигнал оповещения:

void	timeoutChanged(quint64 timeoutChanged)

waitOnCPU : bool

Указывает, следует ли процессору блокироваться во время ожидания, пока заграждение не станет сигнализированным. По умолчанию это false.

Функции доступа:

bool	waitOnCPU() const
void	setWaitOnCPU(bool waitOnCPU)

Сигнал оповещения:

void	waitOnCPUChanged(bool waitOnCPU)

© The Qt Company Ltd
Licensed under the GNU Free Documentation License, Version 1.3.
https://doc.qt.io/qt-6.0/qt3drender-qwaitfence.html