Класс QOpenGLTexture

Класс QOpenGLTexture инкапсулирует объект текстуры OpenGL. Подробнее...

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

Общедоступные типы

Общедоступные функции

Статические открытые члены

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

QOpenGLTexture упрощает работу с текстурами OpenGL и многочисленными их функциями и типами, доступными в зависимости от возможностей вашей реализации OpenGL.

Типичный шаблон использования QOpenGLTexture:

• Создание объекта, указав тип целевой текстуры
• Указание свойств, влияющих на требования к хранению, например, формат хранения и размеры
• Выделение памяти на стороне сервера
• Необязательная загрузка пиксельных данных
• Необязательное указание дополнительных свойств, например, фильтрации и параметров границы
• Вывод с текстурой или вывод на текстуру

В общем случае, при использовании QImage в качестве источника пиксельных данных для текстуры, большинство из вышеперечисленных шагов выполняются автоматически.

// Prepare texture
QOpenGLTexture *texture = new QOpenGLTexture(QImage(fileName).mirrored());
texture->setMinificationFilter(QOpenGLTexture::LinearMipMapLinear);
texture->setMagnificationFilter(QOpenGLTexture::Linear);
...
// Render with texture
texture->bind();
glDrawArrays(...);

Обратите внимание, что QImage зеркально отображается по вертикали, чтобы учесть тот факт, что OpenGL и QImage используют противоположные направления для оси y. Другой вариант — преобразовать ваши координаты текстуры.

Документация по типам членов

перечисление QOpenGLTexture::BindingTarget

Это перечисление определяет возможные целевые точки привязки единиц текстур.

[since 5.5] перечисление QOpenGLTexture::ComparisonFunction

Это перечисление задает оператор сравнения, используемый при включенном сравнении текстур в этой текстуре.

Это перечисление было добавлено или изменено в Qt 5.5.

[since 5.5] перечисление QOpenGLTexture::ComparisonMode

Это перечисление задает режим сравнения при выборке из этой текстуры.

Это перечисление было добавлено или изменено в Qt 5.5.

перечисление QOpenGLTexture::CoordinateDirection

Это перечисление определяет возможные направления координат текстуры

перечисление QOpenGLTexture::CubeMapFace

Это перечисление определяет возможные грани куба.

[since 5.4] перечисление QOpenGLTexture::DepthStencilMode

Это перечисление задаёт, какой компонент глубины/штампа текстуры используется при выборке из текстуры.

Это перечисление было добавлено или изменено в Qt 5.4.

перечисление QOpenGLTexture::Featureфлаги QOpenGLTexture::Features

Это перечисление определяет функции OpenGL, связанные с текстурами, которые можно проверить.

Тип Features — это псевдоним для QFlags<Feature>. Он хранит логическое ИЛИ комбинацию значений Feature.

перечисление QOpenGLTexture::Filter

Это перечисление определяет параметры фильтрации для объекта QOpenGLTexture.

перечисление QOpenGLTexture::MipMapGeneration

Это перечисление определяет параметры управления генерацией mipmap.

перечисление QOpenGLTexture::PixelFormat

Это перечисление определяет возможные форматы пикселей на стороне клиента для операции передачи пикселей.

перечисление QOpenGLTexture::PixelType

Это перечисление определяет возможные типы данных пикселей для операции передачи пикселей

Перечисление QOpenGLTexture::SwizzleComponent

Это перечисление определяет компоненты цвета текстуры, которым можно назначить маску перестановки.

Перечисление QOpenGLTexture::SwizzleValue

Это перечисление определяет возможные значения маски для перестановки текстуры.

Перечисление QOpenGLTexture::Target

Это перечисление определяет целевой тип текстуры объекта QOpenGLTexture. Для получения дополнительной информации о создании массивов текстур, см. Массив текстур.

Перечисление QOpenGLTexture::TextureFormat

Это перечисление определяет возможные форматы текстур. В зависимости от вашей реализации OpenGL может быть поддержана только часть из них.

enum QOpenGLTexture::TextureUnitReset

Этот перечисление определяет опции для управления активацией блока текстур.

enum QOpenGLTexture::WrapMode

Это перечисление определяет возможные режимы обертывания текстурных координат.

Документация по функциям-членам

QOpenGLTexture::QOpenGLTexture(const QImage &image, QOpenGLTexture::MipMapGeneration genMipMaps = GenerateMipMaps)

Создает объект QOpenGLTexture, который впоследствии может быть привязан к целевому 2D текстуре и содержит данные пикселей, содержащиеся в image. Если вы хотите сгенерировать цепочку mipmap, установите genMipMaps в true (это значение по умолчанию).

Это создает базовый объект OpenGL текстуры. Следовательно, создание с помощью этого конструктора требует наличия действительного текущего контекста OpenGL.

QOpenGLTexture::QOpenGLTexture(QOpenGLTexture::Target target)

Создает объект QOpenGLTexture, который впоследствии может быть привязан к target.

Это не создает базовый объект OpenGL текстуры. Следовательно, создание с помощью этого конструктора не требует наличия действительного текущего контекста OpenGL.

void QOpenGLTexture::allocateStorage()

Выделяет хранилище на стороне сервера для этого объекта текстуры с учётом формата, размеров, уровней mipmap, массивов слоёв и граней кубовой карты.

После выделения хранилища изменить эти свойства больше нельзя.

Если поддерживается, QOpenGLTexture использует неизменяемое хранилище текстур.

После выделения хранилища для текстуры данные пикселей можно загрузить с помощью одного из перегруженных методов setData().

См. также isStorageAllocated() и setData().

[since 5.5] void QOpenGLTexture::allocateStorage(QOpenGLTexture::PixelFormat pixelFormat, QOpenGLTexture::PixelType pixelType)

Выделяет хранилище на стороне сервера для этого объекта текстуры с учётом формата, размеров, уровней mipmap, массивов слоёв и граней кубовой карты.

После выделения хранилища изменить эти свойства больше нельзя.

Если поддерживается, QOpenGLTexture использует неизменяемое хранилище текстур. Однако, если неизменяемое хранилище текстур недоступно, то указанные pixelFormat и pixelType будут использованы для выделения изменяемого хранилища; обратите внимание, что в определённых реализациях OpenGL (в частности, OpenGL ES 2) они должны точно соответствовать формату и типу, переданным в последующий вызов setData().

После выделения хранилища для текстуры данные пикселей можно загрузить с помощью одного из перегруженных методов setData().

Эта функция была добавлена в Qt 5.5.

См. также isStorageAllocated() и setData().

void QOpenGLTexture::bind()

Привязывает эту текстуру к текущему активному блоку текстур, готовую для рендеринга. Обратите внимание, что вам не нужно привязывать объекты QOpenGLTexture для их изменения, так как реализация использует расширение EXT_direct_state_access, где оно доступно, и эмулирует его там, где нет.

См. также release().

void QOpenGLTexture::bind(uint unit, QOpenGLTexture::TextureUnitReset reset = DontResetTextureUnit)

Привязывает эту текстуру к блоку текстур unit, готовую для рендеринга. Обратите внимание, что вам не нужно привязывать объекты QOpenGLTexture для их изменения, так как реализация использует расширение EXT_direct_state_access, где оно доступно, и эмулирует его там, где нет.

Если параметр reset равен true, то эта функция восстановит активный блок до блока текстур, который был активен при входе.

См. также release().

QColor QOpenGLTexture::borderColor() const

Возвращает цвет границы этой текстуры.

См. также setBorderColor().

void QOpenGLTexture::borderColor(float *border) const

Записывает цвет границы текстуры в первые четыре элемента массива, указанного по адресу border.

См. также setBorderColor().

void QOpenGLTexture::borderColor(int *border) const

Записывает цвет границы текстуры в первые четыре элемента массива, указанного по адресу border.

Это перегруженная функция.

void QOpenGLTexture::borderColor(unsigned int *border) const

Записывает цвет границы текстуры в первые четыре элемента массива, указанного по адресу border.

Это перегруженная функция.

[static] GLuint QOpenGLTexture::boundTextureId(QOpenGLTexture::BindingTarget target)

Возвращает textureId текстуры, привязанной к target текущего активного блока текстур.

[static] GLuint QOpenGLTexture::boundTextureId(uint unit, QOpenGLTexture::BindingTarget target)

Возвращает textureId текстуры, привязанной к target блока текстур unit.

[since 5.5] QOpenGLTexture::ComparisonFunction QOpenGLTexture::comparisonFunction() const

Возвращает оператор сравнения текстуры, установленный для этой текстуры. По умолчанию, текстура имеет оператор сравнения CompareLessEqual.

Эта функция была добавлена в Qt 5.5.

См. также setComparisonFunction().

[since 5.5] QOpenGLTexture::ComparisonMode QOpenGLTexture::comparisonMode() const

Возвращает режим сравнения текстуры, установленный для этой текстуры. По умолчанию, текстура имеет режим сравнения CompareNone (т. е. сравнения отключены).

Эта функция была добавлена в Qt 5.5.

См. также setComparisonMode().

bool QOpenGLTexture::create()

Создаёт базовый объект OpenGL текстуры. Это требует наличия текущего действительного контекста OpenGL. Если объект текстуры уже существует, эта функция ничего не делает.

После создания объекта текстуры вы можете получить имя объекта из функции textureId(). Это может быть полезно, если вы хотите выполнить некоторые прямые вызовы OpenGL, связанные с этой текстурой.

Обычно не нужно вызывать эту функцию напрямую, так как все функции, которые устанавливают свойства объекта текстуры, неявно вызывают create() от вашего имени.

Возвращает true если создание прошло успешно, в противном случае возвращает false.

См. также destroy(), isCreated(), и textureId().

QOpenGLTexture *QOpenGLTexture::createTextureView(QOpenGLTexture::Target target, QOpenGLTexture::TextureFormat viewFormat, int minimumMipmapLevel, int maximumMipmapLevel, int minimumLayer, int maximumLayer) const

Попытка создать представление текстуры на этой текстуре. Представление текстуры в некотором роде аналогично представлению в SQL, поскольку оно предоставляет ограниченное или переинтерпретированное представление исходных данных. Представления текстур не выделяют дополнительного хранилища на стороне сервера, вместо этого полагаясь на буфер хранения исходной текстуры.

Представления текстур доступны только при использовании неизменяемого хранения. Для получения дополнительной информации о представлениях текстур см. http://www.opengl.org/wiki/Texture_Storage#Texture_views.

Аргумент target указывает целевой объект для представления. В зависимости от целевого объекта исходной цели можно использовать только некоторые целевые объекты. Например, представление текстуры Target1DArray может указывать либо Target1DArray, либо Target1D, но для последнего количество слоёв массива, указанных с помощью minimumLayer и maximumLayer, должно составлять ровно 1.

Аналогичные ограничения применяются к viewFormat. Более подробную информацию см. по указанной выше ссылке и в спецификации.

Аргументы minimumMipmapLevel, maximumMipmapLevel, minimumLayer и maximumLayer служат для ограничения частей текстуры, доступных представлению текстуры.

Если создание представления текстуры завершилось неудачно, эта функция вернёт 0. Если функция выполнена успешно, она вернёт указатель на новый объект QOpenGLTexture, который вернёт true из своей функции isTextureView().

См. также isTextureView().

int QOpenGLTexture::depth() const

Возвращает глубину 3D текстуры.

См. также width(), height() и setSize().

[since 5.4] QOpenGLTexture::DepthStencilMode QOpenGLTexture::depthStencilMode() const

Возвращает режим глубины/шаблона для текстур, использующих комбинированный формат глубины/шаблона.

Эта функция была добавлена в Qt 5.4.

См. также setDepthStencilMode().

void QOpenGLTexture::destroy()

Уничтожает базовый объект OpenGL текстуры. Для этого требуется текущий действительный контекст OpenGL.

См. также create(), isCreated() и textureId().

int QOpenGLTexture::faces() const

Возвращает количество граней для этой текстуры. Для текстур типа куба и массива кубов это будет 6.

Для целевых объектов, не являющихся кубами, эта функция вернёт 1.

QOpenGLTexture::TextureFormat QOpenGLTexture::format() const

Возвращает формат этого объекта текстуры.

См. также setFormat().

void QOpenGLTexture::generateMipMaps()

Генерирует mip-уровни для этого объекта текстуры начиная с mip-уровня 0. Если вы используете целевой объект текстуры и опцию фильтрации, требующую mip-уровней, и отключили автоматическую генерацию mip-уровней, вам нужно вызвать эту функцию или её перегрузку для создания цепочки mip-уровней.

См. также setAutoMipMapGenerationEnabled(), setMipLevels() и mipLevels().

void QOpenGLTexture::generateMipMaps(int baseLevel, bool resetBaseLevel = true)

Генерирует mip-уровни для этого объекта текстуры начиная с mip-уровня baseLevel. Если вы используете целевой объект текстуры и опцию фильтрации, требующую mip-уровней, и отключили автоматическую генерацию mip-уровней, вам нужно вызвать эту функцию или её перегрузку для создания цепочки mip-уровней.

Генерация mip-уровней выше baseLevel достигается путем установки базового mip-уровня на baseLevel и последующей генерации цепочки mip-уровней. Если resetBaseLevel равно true, базовый mip-уровень текстуры будет сброшен до предыдущего значения.

См. также setAutoMipMapGenerationEnabled(), setMipLevels() и mipLevels().

[static] bool QOpenGLTexture::hasFeature(QOpenGLTexture::Feature feature)

Возвращает true , если ваша реализация и версия OpenGL поддерживают функцию текстуры feature.

int QOpenGLTexture::height() const

Возвращает высоту 2D или 3D текстуры.

См. также width(), depth() и setSize().

bool QOpenGLTexture::isAutoMipMapGenerationEnabled() const

Возвращает, включена ли автоматическая генерация mip-уровней для этого объекта текстуры.

См. также setAutoMipMapGenerationEnabled() и generateMipMaps().

bool QOpenGLTexture::isBound() const

Возвращает true , если эта текстура привязана к соответствующей цели текущего активного блока текстур.

См. также bind() и release().

bool QOpenGLTexture::isBound(uint unit)

Возвращает true , если эта текстура привязана к соответствующей цели блока текстур unit.

См. также bind() и release().

bool QOpenGLTexture::isCreated() const

Возвращает true , если базовый объект OpenGL текстуры был создан.

См. также create(), destroy() и textureId().

bool QOpenGLTexture::isFixedSamplePositions() const

Возвращает, использует ли эта текстура фиксированный набор образцов мультисэмплирования. Если для этой текстуры ещё не было выделено хранилище, эта функция возвращает запрошенное значение фиксированных позиций образцов.

Для целевых объектов текстур, не поддерживающих мультисэмплирование, эта функция вернёт true.

См. также setFixedSamplePositions() и isStorageAllocated().

bool QOpenGLTexture::isStorageAllocated() const

Возвращает true , если хранилище на стороне сервера для этой текстуры было выделено.

Формат, размеры, уровни mip-уровней и слои массива не могут быть изменены после выделения хранилища.

См. также allocateStorage(), setSize(), setMipLevels(), setLayers() и setFormat().

bool QOpenGLTexture::isTextureView() const

Возвращает true , если этот объект текстуры на самом деле представляет собой представление другой текстуры.

См. также createTextureView().

int QOpenGLTexture::layers() const

Возвращает количество слоёв массива для этой текстуры. Если для этой текстуры ещё не было выделено хранилище, эта функция возвращает запрошенное количество слоёв массива.

Для целевых объектов текстур, не поддерживающих слои массива, эта функция вернёт 1.

См. также setLayers() и isStorageAllocated().

QPair<float, float> QOpenGLTexture::levelOfDetailRange() const

Возвращает минимальное и максимальное значения параметров уровня детализации.

См. также setLevelOfDetailRange(), minimumLevelOfDetail() и maximumLevelOfDetail().

float QOpenGLTexture::levelofDetailBias() const

Возвращает параметр смещения уровня детализации.

См. также setLevelofDetailBias().

QOpenGLTexture::Filter QOpenGLTexture::magnificationFilter() const

Возвращает фильтр увеличения.

См. также setMagnificationFilter().

float QOpenGLTexture::maximumAnisotropy() const

Возвращает максимальный уровень анизотропии, который следует учитывать при выполнении поисков текстуры. Для этого требуется расширение GL_EXT_texture_filter_anisotropic.

См. также setMaximumAnisotropy().

float QOpenGLTexture::maximumLevelOfDetail() const

Возвращает максимальный параметр уровня детализации.

См. также setMaximumLevelOfDetail(), minimumLevelOfDetail() и levelOfDetailRange().

int QOpenGLTexture::maximumMipLevels() const

Возвращает максимальное количество уровней mipmap, которые может иметь эта текстура при текущих размерах.

См. также setMipLevels(), mipLevels() и setSize().

QPair<QOpenGLTexture::Filter, QOpenGLTexture::Filter> QOpenGLTexture::minMagFilters() const

Возвращает текущие фильтры минимизации и увеличения.

См. также setMinMagFilters().

QOpenGLTexture::Filter QOpenGLTexture::minificationFilter() const

Возвращает фильтр минимизации.

См. также setMinificationFilter().

float QOpenGLTexture::minimumLevelOfDetail() const

Возвращает минимальный параметр уровня детализации.

См. также setMinimumLevelOfDetail(), maximumLevelOfDetail() и levelOfDetailRange().

int QOpenGLTexture::mipBaseLevel() const

Возвращает базовый уровень mipmap, используемый для всех запросов текстур с этой текстурой. По умолчанию 0.

См. также setMipBaseLevel(), mipMaxLevel() и mipLevelRange().

QPair<int, int> QOpenGLTexture::mipLevelRange() const

Возвращает диапазон уровней mipmap, которые могут быть использованы для запросов текстур с этой текстурой.

См. также setMipLevelRange(), mipBaseLevel() и mipMaxLevel().

int QOpenGLTexture::mipLevels() const

Возвращает количество уровней mipmap для этой текстуры. Если для этой текстуры еще не выделена память, возвращает запрошенное количество уровней mipmap.

См. также setMipLevels(), maximumMipLevels() и isStorageAllocated().

int QOpenGLTexture::mipMaxLevel() const

Возвращает максимальный уровень mipmap, используемый для всех запросов текстур с этой текстурой.

См. также setMipMaxLevel(), mipBaseLevel() и mipLevelRange().

void QOpenGLTexture::release()

Отвязывает эту текстуру от активного блока текстуры.

См. также bind().

void QOpenGLTexture::release(uint unit, QOpenGLTexture::TextureUnitReset reset = DontResetTextureUnit)

Отвязывает эту текстуру от блока текстуры unit.

Если параметр reset равен true, эта функция восстановит активный блок до блока, который был активен при входе.

int QOpenGLTexture::samples() const

Возвращает количество точек выборки многообразной выборки для этой текстуры. Если для этой текстуры еще не выделена память, эта функция возвращает запрошенное количество выборок.

Для целей текстуры, которые не поддерживают многообразную выборку, будет возвращено 0.

См. также setSamples() и isStorageAllocated().

void QOpenGLTexture::setAutoMipMapGenerationEnabled(bool enabled)

Если enabled равно true, включает автоматическое создание mipmap для этого объекта текстуры всякий раз, когда данные mipmap уровня 0 устанавливаются с помощью setData().

Автоматическое создание mipmap включено по умолчанию.

См. также isAutoMipMapGenerationEnabled() и generateMipMaps().

void QOpenGLTexture::setBorderColor(const QColor &color)

Устанавливает цвет границы текстуры в color.

См. также borderColor().

void QOpenGLTexture::setBorderColor(float r, float g, float b, float a)

Устанавливает красный цвет в r, зеленый в g, синий в b, и a как значение альфа-канала.

Это перегруженная функция.

void QOpenGLTexture::setBorderColor(int r, int g, int b, int a)

Устанавливает красный цвет в r, зеленый в g, синий в b, и значение альфа-канала в a.

Это перегруженная функция.

void QOpenGLTexture::setBorderColor(uint r, uint g, uint b, uint a)

Устанавливает красный цвет в r, зеленый в g, синий в b, и значение альфа-канала в a.

Это перегруженная функция.

[since 5.5] void QOpenGLTexture::setComparisonFunction(QOpenGLTexture::ComparisonFunction function)

Устанавливает функцию сравнения текстуры для этой текстуры в function. Функция сравнения текстуры используется тенями-самплерами при выборке глубины текстуры.

Эта функция была добавлена в Qt 5.5.

См. также comparisonFunction().

[since 5.5] void QOpenGLTexture::setComparisonMode(QOpenGLTexture::ComparisonMode mode)

Устанавливает режим сравнения текстуры для этой текстуры в mode. Режим сравнения текстуры используется тенями-самплерами при выборке глубины текстуры.

Эта функция была добавлена в Qt 5.5.

См. также comparisonMode().

[since 5.3] void QOpenGLTexture::setCompressedData(int mipLevel, int layer, QOpenGLTexture::CubeMapFace cubeFace, int dataSize, const void *data, const QOpenGLPixelTransferOptions *const options = nullptr)

Загружает сжатые пиксельные данные data в mipLevel, массив layer и cubeFace. Передача пикселей может быть дополнительно контролирована параметром options. Аргумент dataSize должен указывать размер данных, на которые указывает data.

Если не используется сжатый формат format(), используйте setData() вместо этой функции.

Эта функция была добавлена в Qt 5.3.

[since 5.9] void QOpenGLTexture::setCompressedData(int mipLevel, int layer, int layerCount, QOpenGLTexture::CubeMapFace cubeFace, int dataSize, const void *data, const QOpenGLPixelTransferOptions *const options = nullptr)

Это перегруженная функция.

Параметр layerCount — количество слоёв в массиве текстур, загружаемых/заполняемых этим вызовом.

Эта функция была добавлена в Qt 5.9.

void QOpenGLTexture::setCompressedData(int mipLevel, int layer, int dataSize, const void *data, const QOpenGLPixelTransferOptions *const options = nullptr)

Это перегруженная функция.

void QOpenGLTexture::setCompressedData(int mipLevel, int dataSize, const void *data, const QOpenGLPixelTransferOptions *const options = nullptr)

Это перегруженный метод.

void QOpenGLTexture::setCompressedData(int dataSize, const void *data, const QOpenGLPixelTransferOptions *const options = nullptr)

Это перегруженный метод.

[since 5.3] void QOpenGLTexture::setData(int mipLevel, int layer, QOpenGLTexture::CubeMapFace cubeFace, QOpenGLTexture::PixelFormat sourceFormat, QOpenGLTexture::PixelType sourceType, const void *data, const QOpenGLPixelTransferOptions *const options = nullptr)

Загружает пиксельные данные для этого объекта текстуры mipLevel, массива layer и cubeFace. Хранилище должно быть выделено перед загрузкой пиксельных данных. Некоторые перегрузки setData() установят соответствующие размеры, уровни mipmap и слои массива, а затем выделять память для вас, если у них достаточно информации для этого. Это будет отмечено в документации функции.

Структура пиксельных данных, на которые указывает data, задаётся sourceFormat и sourceType. Загрузка пиксельных данных может быть дополнительно контролируема параметром options.

Если используется сжатый формат(), то необходимо использовать setCompressedData() вместо этой функции.

Функция была добавлена в Qt 5.3.

См. также setCompressedData().

[since 5.9] void QOpenGLTexture::setData(int mipLevel, int layer, int layerCount, QOpenGLTexture::CubeMapFace cubeFace, QOpenGLTexture::PixelFormat sourceFormat, QOpenGLTexture::PixelType sourceType, const void *data, const QOpenGLPixelTransferOptions *const options = nullptr)

Это перегруженный метод.

Параметр layerCount — количество слоёв в массиве текстур, которые загружаются/заполняются этим вызовом.

Функция была добавлена в Qt 5.9.

[since 5.3] void QOpenGLTexture::setData(int mipLevel, int layer, QOpenGLTexture::PixelFormat sourceFormat, QOpenGLTexture::PixelType sourceType, const void *data, const QOpenGLPixelTransferOptions *const options = nullptr)

Это перегруженный метод.

Функция была добавлена в Qt 5.3.

[since 5.3] void QOpenGLTexture::setData(int mipLevel, QOpenGLTexture::PixelFormat sourceFormat, QOpenGLTexture::PixelType sourceType, const void *data, const QOpenGLPixelTransferOptions *const options = nullptr)

Это перегруженный метод.

Функция была добавлена в Qt 5.3.

[since 5.3] void QOpenGLTexture::setData(QOpenGLTexture::PixelFormat sourceFormat, QOpenGLTexture::PixelType sourceType, const void *data, const QOpenGLPixelTransferOptions *const options = nullptr)

Это перегруженный метод.

Функция была добавлена в Qt 5.3.

[since 5.14] void QOpenGLTexture::setData(int xOffset, int yOffset, int zOffset, int width, int height, int depth, QOpenGLTexture::PixelFormat sourceFormat, QOpenGLTexture::PixelType sourceType, const void *data, const QOpenGLPixelTransferOptions *const options = nullptr)

Это перегруженный метод.

Эта перегрузка используется для обновления части текстуры. Параметры xOffset, yOffset, zOffset задают смещения текселей в текстуре. Параметры width, height и depth задают размеры подизображения.

Структура пиксельных данных, на которые указывает data, задаётся sourceFormat и sourceType. Загрузка пиксельных данных может быть дополнительно контролируема параметром options.

Функция была добавлена в Qt 5.14.

[since 5.14] void QOpenGLTexture::setData(int xOffset, int yOffset, int zOffset, int width, int height, int depth, int mipLevel, QOpenGLTexture::PixelFormat sourceFormat, QOpenGLTexture::PixelType sourceType, const void *data, const QOpenGLPixelTransferOptions *const options = nullptr)

Это перегруженный метод.

Эта перегрузка используется для обновления части текстуры. Параметры xOffset, yOffset, zOffset задают смещения текселей в текстуре. Параметры width, height и depth задают размеры подизображения. Уровень mipmap подизображения, которое мы хотим обновить, задаётся параметром mipLevel.

Структура пиксельных данных, на которые указывает data, задаётся sourceFormat и sourceType. Загрузка пиксельных данных может быть дополнительно контролируема параметром options.

Функция была добавлена в Qt 5.14.

[since 5.14] void QOpenGLTexture::setData(int xOffset, int yOffset, int zOffset, int width, int height, int depth, int mipLevel, int layer, QOpenGLTexture::PixelFormat sourceFormat, QOpenGLTexture::PixelType sourceType, const void *data, const QOpenGLPixelTransferOptions *const options = nullptr)

Это перегруженный метод.

Эта перегрузка используется для обновления части текстуры. Параметры xOffset, yOffset, zOffset задают смещения текселей в текстуре. Параметры width, height и depth задают размеры подизображения. Уровень mipmap и слой подизображения, которое мы хотим обновить, задаются параметрами mipLevel и layer.

Структура пиксельных данных, на которые указывает data, задаётся sourceFormat и sourceType. Загрузка пиксельных данных может быть дополнительно контролируема параметром options.

Функция была добавлена в Qt 5.14.

[since 5.14] void QOpenGLTexture::setData(int xOffset, int yOffset, int zOffset, int width, int height, int depth, int mipLevel, int layer, QOpenGLTexture::CubeMapFace face, QOpenGLTexture::PixelFormat sourceFormat, QOpenGLTexture::PixelType sourceType, const void *data, const QOpenGLPixelTransferOptions *const options = nullptr)

Это перегруженный метод.

Эта перегрузка используется для обновления части текстуры. Параметры xOffset, yOffset, zOffset задают смещения текселей в текстуре. Параметры width, height и depth задают размеры подизображения. Уровень mipmap, слой и грань куба подизображения, которое мы хотим обновить, задаются параметрами mipLevel, layer и face.

Структура пиксельных данных, на которые указывает data, задаётся sourceFormat и sourceType. Загрузка пиксельных данных может быть дополнительно контролируема параметром options.

Функция была добавлена в Qt 5.14.

[since 5.14] void QOpenGLTexture::setData(int xOffset, int yOffset, int zOffset, int width, int height, int depth, int mipLevel, int layer, QOpenGLTexture::CubeMapFace face, int layerCount, QOpenGLTexture::PixelFormat sourceFormat, QOpenGLTexture::PixelType sourceType, const void *data, const QOpenGLPixelTransferOptions *const options = nullptr)

Это перегруженный метод.

Этот перегруз используется для обновления части текстуры. Параметры xOffset, yOffset, zOffset задают смещения текселей внутри текстуры. Параметры width, height и depth задают размеры подизображения. Уровень mip-мапа, стартовый слой, грань куба и количество слоёв подизображения, которые мы хотим обновить, задаются параметрами mipLevel, layer, face и layerCount соответственно.

Структура данных пикселей, на которые указывает data, задаётся параметрами sourceFormat и sourceType. Загрузка данных пикселей может быть дополнительно контролирована параметром options.

Этот метод был добавлен в Qt 5.14.

void QOpenGLTexture::setData(const QImage &image, QOpenGLTexture::MipMapGeneration genMipMaps = GenerateMipMaps)

Этот перегруз setData() выделит память для вас. Данные пикселей содержатся в image. Мip-мапы генерируются по умолчанию. Установите genMipMaps в DontGenerateMipMaps, чтобы отключить генерацию mip-мап.

Это перегруженный метод.

[since 5.4] void QOpenGLTexture::setDepthStencilMode(QOpenGLTexture::DepthStencilMode mode)

Если используется текстура с комбинированным форматом глубины/схемы, эта функция устанавливает, какой компонент текстуры доступен по параметру mode.

Когда параметр установлен в DepthMode, доступ к нему из шейдера будет осуществляться к компоненту глубины как к одному числу с плавающей точкой, как обычно. Но когда параметр установлен в StencilMode, шейдер получит доступ к компоненту схемы.

Этот метод был добавлен в Qt 5.4.

См. также depthStencilMode().

void QOpenGLTexture::setFixedSamplePositions(bool fixed)

Устанавливает, будут ли позиции и количество сэмплов, используемые с многосэмпловой текстурой, фиксированными (fixed). Если установлено в true, позиции и количество сэмплов будут одинаковыми для всех текселей в изображении и не будут зависеть от размера или внутреннего формата изображения. Этот метод должен быть вызван перед выделением памяти для текстуры.

Для целей, которые не поддерживают многосэмплирование, этот метод не оказывает влияния.

Значение по умолчанию — true.

См. также isFixedSamplePositions() и isStorageAllocated().

void QOpenGLTexture::setFormat(QOpenGLTexture::TextureFormat format)

Устанавливает формат этого объекта текстуры на format. Этот метод должен быть вызван до выделения памяти для текстуры.

Обратите внимание, что не все форматы могут поддерживаться. Точный набор поддерживаемых форматов зависит от вашей реализации OpenGL и версии.

См. также format() и allocateStorage().

void QOpenGLTexture::setLayers(int layers)

Устанавливает количество слоёв массива layers для выделения памяти. Этот метод должен быть вызван до выделения памяти для текстуры.

Для целей, которые не поддерживают слои массива, этот метод не оказывает влияния.

См. также layers() и isStorageAllocated().

void QOpenGLTexture::setLevelOfDetailRange(float min, float max)

Устанавливает минимальный и максимальный уровень детализации на min и max соответственно.

См. также levelOfDetailRange(), setMinimumLevelOfDetail() и setMaximumLevelOfDetail().

void QOpenGLTexture::setLevelofDetailBias(float bias)

Устанавливает смещение уровня детализации на bias. Смещение уровня детализации влияет на точку, в которой уровни mip-мапирования изменяются. Увеличение значений для смещения уровня детализации делает общие изображения более размытыми или плавными. Уменьшение значений делает общие изображения более резкими.

См. также levelofDetailBias().

void QOpenGLTexture::setMagnificationFilter(QOpenGLTexture::Filter filter)

Устанавливает фильтр увеличения на filter.

См. также magnificationFilter(), setMinificationFilter() и setMinMagFilters().

void QOpenGLTexture::setMaximumAnisotropy(float anisotropy)

Если ваша реализация OpenGL поддерживает расширение GL_EXT_texture_filter_anisotropic, этот метод устанавливает максимальный уровень анизотропии на anisotropy.

См. также maximumAnisotropy().

void QOpenGLTexture::setMaximumLevelOfDetail(float value)

Устанавливает максимальный уровень детализации на value. Это ограничивает выбор mip-мапы с наименьшим разрешением (самый высокий уровень mip-мапа). Значение по умолчанию — 1000.

См. также maximumLevelOfDetail(), setMinimumLevelOfDetail() и setLevelOfDetailRange().

void QOpenGLTexture::setMinMagFilters(QOpenGLTexture::Filter minificationFilter, QOpenGLTexture::Filter magnificationFilter)

Устанавливает фильтр уменьшения на minificationFilter и фильтр увеличения на magnificationFilter.

См. также minMagFilters(), setMinificationFilter() и setMagnificationFilter().

void QOpenGLTexture::setMinificationFilter(QOpenGLTexture::Filter filter)

Устанавливает фильтр, используемый для уменьшения, на filter.

См. также minificationFilter(), setMagnificationFilter() и setMinMagFilters().

void QOpenGLTexture::setMinimumLevelOfDetail(float value)

Устанавливает минимальный уровень детализации на value. Это ограничивает выбор mip-мапы с наибольшим разрешением (самый низкий уровень mip-мапа). Значение по умолчанию — -1000.

См. также minimumLevelOfDetail(), setMaximumLevelOfDetail() и setLevelOfDetailRange().

void QOpenGLTexture::setMipBaseLevel(int baseLevel)

Устанавливает базовый уровень mip-мапа, используемый для всех поисков текстур с этой текстурой, на baseLevel.

См. также mipBaseLevel(), setMipMaxLevel() и setMipLevelRange().

void QOpenGLTexture::setMipLevelRange(int baseLevel, int maxLevel)

Устанавливает диапазон уровней mip-мапа, которые могут быть использованы для поиска текстур с этой текстурой, от baseLevel до maxLevel.

См. также setMipBaseLevel(), setMipMaxLevel() и mipLevelRange().

void QOpenGLTexture::setMipLevels(int levels)

Для текстур, поддерживающих mip-мапы, эта функция устанавливает требуемое количество уровней mip-мапы для выделения памяти. Эту функцию необходимо вызвать перед выделением памяти для текстуры.

Если целевой тип текстуры не поддерживает mip-мапы, эта функция не оказывает никакого эффекта.

См. также mipLevels(), maximumMipLevels(), и isStorageAllocated().

void QOpenGLTexture::setMipMaxLevel(int maxLevel)

Устанавливает максимальный уровень mip-мапы, используемый для всех обращений к текстуре с помощью этой текстуры, в значение maxLevel.

См. также mipMaxLevel(), setMipBaseLevel(), и setMipLevelRange().

void QOpenGLTexture::setSamples(int samples)

Устанавливает количество samples для выделения памяти при отрисовке в целевой текстуре, поддерживающей многократную выборку. Эту функцию следует вызвать перед выделением памяти для текстуры.

Для целей, которые не поддерживают многократную выборку, эта функция не оказывает никакого эффекта.

См. также samples() и isStorageAllocated().

void QOpenGLTexture::setSize(int width, int height = 1, int depth = 1)

Устанавливает размеры этого объекта текстуры в width, height и depth. Значение по умолчанию для каждой размерности равно 1. Максимальный разрешенный размер текстуры зависит от вашей реализации OpenGL.

Если для width, height или depth предоставлено значение, не являющееся степенью двойки, и ваша реализация OpenGL не поддерживает текстуры с нестепенными значениями, то режим wrap автоматически устанавливается в ClampToEdge.

См. также width(), height() и depth().

void QOpenGLTexture::setSwizzleMask(QOpenGLTexture::SwizzleComponent component, QOpenGLTexture::SwizzleValue value)

GLSL-шейдеры могут переупорядочивать компоненты vec4, возвращаемые функциями текстуры. Желательно иметь возможность управлять этим переупорядочением из кода на стороне процессора. Это становится возможным с помощью масок swizzle с OpenGL 3.3.

Каждый компонент текстуры может быть сопоставлен с одним из вариантов SwizzleValue.

Эта функция сопоставляет component с выходным value.

См. также swizzleMask().

void QOpenGLTexture::setSwizzleMask(QOpenGLTexture::SwizzleValue r, QOpenGLTexture::SwizzleValue g, QOpenGLTexture::SwizzleValue b, QOpenGLTexture::SwizzleValue a)

Параметры r, g, b и a используются для установки цветов красного, зеленого, синего и значения альфа.

Это перегруженная функция.

void QOpenGLTexture::setWrapMode(QOpenGLTexture::WrapMode mode)

Устанавливает режим wrap (или повторения) для всех измерений текстуры в mode.

См. также wrapMode().

void QOpenGLTexture::setWrapMode(QOpenGLTexture::CoordinateDirection direction, QOpenGLTexture::WrapMode mode)

Удерживает измерение текстуры direction.

Это перегруженная функция.

QOpenGLTexture::SwizzleValue QOpenGLTexture::swizzleMask(QOpenGLTexture::SwizzleComponent component) const

Возвращает маску swizzle для компонента component.

См. также setSwizzleMask().

QOpenGLTexture::Target QOpenGLTexture::target() const

Возвращает целевой объект привязки этой текстуры.

Эта функция была добавлена в Qt 5.4.

GLuint QOpenGLTexture::textureId() const

Возвращает имя базового объекта OpenGL-текстуры или 0, если он еще не создан.

См. также create(), destroy() и isCreated().

int QOpenGLTexture::width() const

Возвращает ширину 1D, 2D или 3D текстуры.

См. также height(), depth() и setSize().

QOpenGLTexture::WrapMode QOpenGLTexture::wrapMode(QOpenGLTexture::CoordinateDirection direction) const

Возвращает режим wrap для измерения текстуры direction.

См. также setWrapMode().