Класс RenderState
(QSGMaterialShader::RenderState)Класс QSGMaterialShader::RenderState инкапсулирует текущее состояние отрисовки во время вызова QSGMaterialShader::updateState(). Подробнее...
| Заголовок: | #include <RenderState> |
| qmake: | QT += quick |
Открытые типы
| Перечисление | DirtyState { DirtyMatrix, DirtyOpacity, DirtyCachedMaterialData, DirtyAll } |
| Флаги | DirtyStates |
Открытые функции
| QMatrix4x4 | combinedMatrix() const |
| QOpenGLContext * | context() const |
| float | determinant() const |
| float | devicePixelRatio() const |
| QRect | deviceRect() const |
| DirtyStates | dirtyStates() const |
| bool | isCachedMaterialDataDirty() const |
| bool | isMatrixDirty() const |
| bool | isOpacityDirty() const |
| QMatrix4x4 | modelViewMatrix() const |
| float | opacity() const |
| QMatrix4x4 | projectionMatrix() const |
| QRect | viewportRect() const |
Подробное описание
Класс QSGMaterialShader::RenderState инкапсулирует текущее состояние отрисовки во время вызова QSGMaterialShader::updateState().
Состояние отрисовки содержит ряд методов доступа, которые шейдер должен соблюдать для соответствия текущему состоянию графа сцены.
Экземпляр действителен только внутри вызова QSGMaterialShader::updateState() и не должен использоваться вне этой функции.
Документация по типам членов
Перечисление RenderState::DirtyStateФлаги RenderState::DirtyStates
| Константа | Значение | Описание |
|---|---|---|
QSGMaterialShader::RenderState::DirtyMatrix |
0x0001 |
Используется для указания того, что матрица изменилась и должна быть обновлена. |
QSGMaterialShader::RenderState::DirtyOpacity |
0x0002 |
Используется для указания того, что непрозрачность изменилась и должна быть обновлена. |
QSGMaterialShader::RenderState::DirtyCachedMaterialData |
0x0004 |
Используется для указания того, что данные кэшированного материала изменились и должны быть обновлены. |
QSGMaterialShader::RenderState::DirtyAll |
0xFFFF |
Используется для указания того, что всё нужно обновить. |
Тип DirtyStates является псевдонимом для QFlags<DirtyState>. Он хранит логическое ИЛИ сочетание значений DirtyState.
Документация по функциям членов
QMatrix4x4 RenderState::combinedMatrix() const
Возвращает матрицу, объединенную из матриц модели-представления и проекции.
QOpenGLContext *RenderState::context() const
Возвращает QOpenGLContext, используемый для отрисовки.
float RenderState::determinant() const
Возвращает определитель матрицы модели-представления для использования при отрисовке.
float RenderState::devicePixelRatio() const
Возвращает отношение между физическими пикселями и пикселями независимыми от устройства для использования при отрисовке.
QRect RenderState::deviceRect() const
Возвращает прямоугольник устройства, на который производится отрисовка.
DirtyStates RenderState::dirtyStates() const
Возвращает состояния отрисовки, которые изменились и должны быть обновлены для геометрии, отрисованной с этим материалом, чтобы соответствовать текущему состоянию отрисовки.
bool RenderState::isCachedMaterialDataDirty() const
bool RenderState::isMatrixDirty() const
Возвращает true если dirtyStates() содержат состояние грязной матрицы, в противном случае возвращает false.
bool RenderState::isOpacityDirty() const
Возвращает true если dirtyStates() содержит состояние грязной непрозрачности, в противном случае возвращает false.
QMatrix4x4 RenderState::modelViewMatrix() const
Возвращает матрицу модели-представления.
Если материал имеет установленный флаг RequiresFullMatrix, это гарантирует, что это полная матрица преобразования, рассчитанная из графа сцены.
Однако, если этот флаг не установлен, рендерер может изменить эту матрицу. Например, он может предварительно преобразовывать вершины на ЦП и устанавливать эту матрицу в единичную.
В такой ситуации, как выше, всё ещё возможно получить фактический определитель матрицы, установив флаг RequiresDeterminant в материале и вызвав метод determinant().
float RenderState::opacity() const
Возвращает накопленную непрозрачность для использования при отрисовке.
QMatrix4x4 RenderState::projectionMatrix() const
Возвращает матрицу проекции.
QRect RenderState::viewportRect() const
Возвращает прямоугольник области просмотра поверхности, на которую производится отрисовка.
© The Qt Company Ltd
Licensed under the GNU Free Documentation License, Version 1.3.
https://doc.qt.io/qt-5.9/qsgmaterialshader-renderstate.html