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

Возвращает borderColor этой текстуры.

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

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

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

Возвращает textureId текстуры, связанной с 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.

Генерация mip-уровней для значений выше baseLevel достигается установкой mip-базового уровня на baseLevel и последующей генерацией цепочки mip-уровней. Если 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

Возвращает значение, указывающее, включена ли автоматическая генерация 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().

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

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

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

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

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

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

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

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

int QOpenGLTexture::mipLevels() const

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

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

int QOpenGLTexture::mipMaxLevel() const

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

См. также 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, включает автоматическое создание мип-уровней для этого объекта текстуры всякий раз, когда данные мип-уровня 0 устанавливаются через setData().

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

Примечание: Создание мип-уровней не поддерживается для сжатых текстур с 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 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() установят соответствующие размеры, уровни мип-мап и слои массива, а затем выделят хранилище для вас, если у них достаточно информации для этого. Это будет отмечено в документации функции.

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

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

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

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

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. Мип-мапы генерируются по умолчанию. Установите genMipMaps в DontGenerateMipMaps, чтобы отключить генерацию мип-мап.

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

void QOpenGLTexture::setDepthStencilMode(DepthStencilMode mode)

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

Когда параметр установлен в DepthMode, доступ к нему из шейдера будет осуществляться к компоненту глубины как к одиночному значению с плавающей точкой, как обычно. Но когда параметр установлен в 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. Смещение уровня детализации влияет на точку, в которой изменяются уровни детализации MIP-карты. Увеличение значений смещения уровня детализации делает общие изображения более размытыми или плавными. Уменьшение значений делает общие изображения более чёткими.

Примечание: Эта функция не имеет эффекта для 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-карты (самого высокого уровня MIP-карты). Значение по умолчанию равно 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. Это ограничивает выбор самой высокой разрешающей MIP-карты (самого низкого уровня MIP-карты). Значение по умолчанию равно -1000.

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

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

void QOpenGLTexture::setMipBaseLevel(int baseLevel)

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

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

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

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

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

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

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

void QOpenGLTexture::setMipLevels(int levels)

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

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

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

void QOpenGLTexture::setMipMaxLevel(int maxLevel)

Устанавливает максимальный уровень MIP-карты, используемый для всех поисков текстур с этой текстурой, в 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().