Класс QTextureImage
класс Qt3DRender::QTextureImageСодержит необходимую информацию для создания текстуры OpenGL из источника изображения. Подробнее...
| Заголовок: | #include <QTextureImage> |
| CMake: | find_package(Qt6 COMPONENTS 3drender REQUIRED) target_link_libraries(mytarget PRIVATE Qt6::3drender) |
| qmake: | QT += 3drender |
| С момента: | Qt 5.5 |
| Инициализируется: | TextureImage |
| Наследует: | Qt3DRender::QAbstractTextureImage |
Открытые типы
| Перечисление | Status { None, Loading, Ready, Error } |
Свойства
Открытые функции
| QTextureImage(Qt3DCore::QNode *parent = nullptr) | |
| bool | isMirrored() const |
| QUrl | source() const |
| Qt3DRender::QTextureImage::Status | status() const |
Открытые слоты
| void | setMirrored(bool mirrored) |
| void | setSource(const QUrl &source) |
Сигналы
| void | mirroredChanged(bool mirrored) |
| void | sourceChanged(const QUrl &source) |
| void | statusChanged(Qt3DRender::QTextureImage::Status status) |
Защищённые функции
| void | setStatus(Qt3DRender::QTextureImage::Status status) |
Подробное описание
Содержит необходимую информацию о уровне mipmap, слое, грани куба и URL-адресе источника для загрузки данных в текстуру OpenGL в нужном месте.
Документация по типам членов
Перечисление QTextureImage::Status
Это перечисление определяет значения состояния для загрузки изображения текстуры.
| Константа | Значение | Описание |
|---|---|---|
Qt3DRender::QTextureImage::None |
0 |
Загрузка изображения текстуры ещё не началась. |
Qt3DRender::QTextureImage::Loading |
1 |
Загрузка изображения текстуры началась, но не завершена. |
Qt3DRender::QTextureImage::Ready |
2 |
Загрузка изображения текстуры завершена. |
Qt3DRender::QTextureImage::Error |
3 |
При загрузке изображения текстуры возникла ошибка. |
Документация по свойствам
mirrored : bool
Это свойство указывает, следует ли отображать изображение в зеркальном отображении при загрузке. Это удобно, чтобы избежать необходимости манипулирования изображениями для соответствия началу координат текстуры, используемых API рендеринга. По умолчанию это свойство установлено в true. Это не влияет при использовании сжатых форматов текстур GPU.
Предупреждение: Это свойство приводит к потери производительности во время выполнения при загрузке несжатых или сжатых изображениями CPU, таких как PNG. Чтобы избежать этой потери производительности, лучше установить это свойство в false и загружать активы текстуры, которые были предварительно отображены в зеркальном отображении.
Примечание: OpenGL указывает начало координат текстуры с нижнего левого угла, а DirectX - с верхнего левого угла.
Примечание: При использовании текстуры куба, вероятно, вам понадобится отключить зеркальное отображение, так как образец куба принимает направление, а не обычные координаты текстуры.
Функции доступа:
| bool | isMirrored() const |
| void | setMirrored(bool mirrored) |
Сигнал уведомления:
| void | mirroredChanged(bool mirrored) |
source : QUrl
Это свойство содержит URL-адрес источника, из которого будут загружены данные для изображения текстуры.
Функции доступа:
| QUrl | source() const |
| void | setSource(const QUrl &source) |
Сигнал уведомления:
| void | sourceChanged(const QUrl &source) |
[read-only] status : const Status
Это свойство содержит состояние загрузки изображения текстуры.
- TextureImage.None
- TextureImage.Loading
- TextureImage.Ready
- TextureImage.Error
Функции доступа:
| Qt3DRender::QTextureImage::Status | status() const |
Сигнал уведомления:
| void | statusChanged(Qt3DRender::QTextureImage::Status status) |
Документация по функциям членов
QTextureImage::QTextureImage(Qt3DCore::QNode *parent = nullptr)
Создаёт новый экземпляр Qt3DRender::QTextureImage с parent в качестве родительского узла.
[slot] void QTextureImage::setMirrored(bool mirrored)
Устанавливает зеркальное отображение в mirrored.
Примечание: Внутренне вызывает обновление генератора данных.
Примечание: Функция-установщик для свойства mirrored.
См. также isMirrored().
[slot] void QTextureImage::setSource(const QUrl &source)
Устанавливает URL-адрес источника изображения текстуры в source.
Примечание: Внутренне вызывает обновление генератора данных.
Примечание: Функция-установщик для свойства source.
См. также source().
bool QTextureImage::isMirrored() const
Возвращает, включено ли зеркальное отображение.
Примечание: Функция-получатель для свойства mirrored.
[protected] void QTextureImage::setStatus(Qt3DRender::QTextureImage::Status status)
Устанавливает состояние в status. status
См. также status().
QUrl QTextureImage::source() const
Возвращает URL источника, из которого будет загружена информация для текстурного изображения.
Примечание: Функция-геттер для свойства source.
См. также setSource().
Qt3DRender::QTextureImage::Status QTextureImage::status() const
Возвращает текущее состояние.
Примечание: Функция-геттер для свойства status.
См. также setStatus().
© The Qt Company Ltd
Licensed under the GNU Free Documentation License, Version 1.3.
https://doc.qt.io/qt-6.2/qt3drender-qtextureimage.html