Класс QOpenGLTexture

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

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

Типы публичного доступа

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

Статические публичные члены

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

Класс 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

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

enum QOpenGLTexture::ComparisonFunction

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

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

enum QOpenGLTexture::ComparisonMode

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

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

enum QOpenGLTexture::CoordinateDirection

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

enum QOpenGLTexture::CubeMapFace

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

enum QOpenGLTexture::DepthStencilMode

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

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

enum QOpenGLTexture::Featureflags QOpenGLTexture::Features

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

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

enum QOpenGLTexture::Filter

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

enum QOpenGLTexture::MipMapGeneration

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

enum QOpenGLTexture::PixelFormat

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

enum QOpenGLTexture::PixelType

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

enum QOpenGLTexture::SwizzleComponent

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

enum QOpenGLTexture::SwizzleValue

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

enum QOpenGLTexture::Target

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

enum QOpenGLTexture::TextureFormat

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

enum QOpenGLTexture::TextureUnitReset

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

enum QOpenGLTexture::WrapMode

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

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

QOpenGLTexture::QOpenGLTexture(Target target)

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

Это не создаёт подлежащий OpenGL-объект текстуры. Поэтому создание с помощью этого конструктора не требует валидного текущего OpenGL-контекста.

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

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

Это создаёт подлежащий OpenGL-объект текстуры. Поэтому создание с помощью этого конструктора требует валидного текущего OpenGL-контекста.

QOpenGLTexture::~QOpenGLTexture()

Уничтожает экземпляр QOpenGLTexture.

void QOpenGLTexture::allocateStorage()

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

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

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

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

Примечание: Если неизменяемое хранилище текстур недоступно, то будет использован стандартный формат и тип пикселей для создания изменяемого хранилища. Вы можете использовать другую перегрузку allocateStorage(), чтобы указать точный формат и тип пикселей при выделении изменяемого хранилища; это особенно полезно в некоторых реализациях OpenGL ES (в частности, OpenGL ES 2), где формат и тип пикселей, используемые при выделении, должны точно соответствовать формату и типу, передаваемым в последующий вызов setData().

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

void QOpenGLTexture::allocateStorage(PixelFormat pixelFormat, PixelType pixelType)

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

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

Если поддерживается, 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, 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(BindingTarget target)

Возвращает идентификатор текстуры, привязанной к target текущей активной текстурной единицы.

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

Возвращает идентификатор текстуры, привязанной к target текстурной единицы unit.

ComparisonFunction QOpenGLTexture::comparisonFunction() const

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

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

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

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(Target target, 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().

DepthStencilMode QOpenGLTexture::depthStencilMode() const

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

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

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

void QOpenGLTexture::destroy()

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

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

int QOpenGLTexture::faces() const

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

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

TextureFormat QOpenGLTexture::format() const

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

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

void QOpenGLTexture::generateMipMaps()

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

Примечание: Генерация mipmap не поддерживается для сжатых текстур с OpenGL ES 2.0.

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

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

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

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

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

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

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

int QOpenGLTexture::height() const

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

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

bool QOpenGLTexture::isAutoMipMapGenerationEnabled() const

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

См. также 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, если хранилище на стороне сервера для этой текстуры было выделено.

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

См. также 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().

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<Filter, Filter> QOpenGLTexture::minMagFilters() const

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

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

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, 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 включено по умолчанию.

Примечание: Создание mipmap не поддерживается для сжатых текстур с OpenGL ES 2.0.

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

void QOpenGLTexture::setBorderColor(QColor color)

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

Примечание: Эта функция не имеет эффекта на Mac и Qt, построенных для OpenGL ES 2.

См. также 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.

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

void QOpenGLTexture::setComparisonFunction(ComparisonFunction function)

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

void QOpenGLTexture::setComparisonMode(ComparisonMode mode)

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

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

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

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

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

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

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

void QOpenGLTexture::setCompressedData(int mipLevel, int layer, int layerCount, CubeMapFace cubeFace, int dataSize, const void *data, const QOpenGLPixelTransferOptions * const options = Q_NULLPTR)

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

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

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

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

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

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

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

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

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

void QOpenGLTexture::setData(int mipLevel, int layer, CubeMapFace cubeFace, PixelFormat sourceFormat, PixelType sourceType, const void *data, const QOpenGLPixelTransferOptions * const options = Q_NULLPTR)

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

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

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

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

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

void QOpenGLTexture::setData(int mipLevel, int layer, int layerCount, CubeMapFace cubeFace, PixelFormat sourceFormat, PixelType sourceType, const void *data, const QOpenGLPixelTransferOptions * const options = Q_NULLPTR)

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

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

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

void QOpenGLTexture::setData(int mipLevel, int layer, PixelFormat sourceFormat, PixelType sourceType, const void *data, const QOpenGLPixelTransferOptions * const options = Q_NULLPTR)

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

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

void QOpenGLTexture::setData(int mipLevel, PixelFormat sourceFormat, PixelType sourceType, const void *data, const QOpenGLPixelTransferOptions * const options = Q_NULLPTR)

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

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

void QOpenGLTexture::setData(PixelFormat sourceFormat, PixelType sourceType, const void *data, const QOpenGLPixelTransferOptions * const options = Q_NULLPTR)

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

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

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

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

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

void QOpenGLTexture::setDepthStencilMode(DepthStencilMode mode)

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

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

Примечание: Эта функция не имеет эффекта на Mac и Qt, скомпилированные для OpenGL ES 2.

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

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

void QOpenGLTexture::setFixedSamplePositions(bool fixed)

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

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

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

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

void QOpenGLTexture::setFormat(TextureFormat format)

Устанавливает формат этой текстуры в format. Эту функцию необходимо вызвать до выделения памяти для текстуры.

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

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

void QOpenGLTexture::setLayers(int layers)

Устанавливает количество слоёв массива layers, для которых выделяется память. Эту функцию следует вызывать до выделения памяти для текстуры.

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

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

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

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

Примечание: Эта функция не имеет эффекта в Qt, скомпилированном для OpenGL ES 2.

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

void QOpenGLTexture::setLevelofDetailBias(float bias)

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

Примечание: Эта функция не имеет эффекта в Qt, скомпилированном для OpenGL ES 2.

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

void QOpenGLTexture::setMagnificationFilter(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-уровня наименьшего разрешения (наивысшего уровня mipmap). Значение по умолчанию равно 1000.

Примечание: Эта функция не имеет эффекта в Qt, скомпилированном для OpenGL ES 2.

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

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

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

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

void QOpenGLTexture::setMinificationFilter(Filter filter)

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

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

void QOpenGLTexture::setMinimumLevelOfDetail(float value)

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

Примечание: Эта функция не имеет эффекта в Qt, скомпилированном для OpenGL ES 2.

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

void QOpenGLTexture::setMipBaseLevel(int baseLevel)

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

Примечание: Эта функция не имеет эффекта в Qt, скомпилированном для OpenGL ES 2.

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

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

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

Примечание: Эта функция не имеет эффекта в Qt, скомпилированном для OpenGL ES 2.

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

void QOpenGLTexture::setMipLevels(int levels)

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

Если целевая текстура не поддерживает mipmap, эта функция не имеет эффекта.

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

void QOpenGLTexture::setMipMaxLevel(int maxLevel)

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

Примечание: Эта функция не имеет эффекта в Qt, скомпилированном для OpenGL ES 2.

См. также 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().

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

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

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

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

Примечание: Эта функция не имеет эффекта в Mac и Qt, скомпилированном для OpenGL ES 2.

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

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

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

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

void QOpenGLTexture::setWrapMode(WrapMode mode)

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

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

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

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

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

SwizzleValue QOpenGLTexture::swizzleMask(SwizzleComponent component) const

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

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

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().

WrapMode QOpenGLTexture::wrapMode(CoordinateDirection direction) const

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

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