Класс QOpenGLTexture

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

Этот класс был представлен в Qt 5.2.

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

Открытые типы

Открытые функции

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

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

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

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

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

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.

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

GLuint QOpenGLTexture::boundTextureId(QOpenGLTexture::BindingTarget target)

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

GLuint QOpenGLTexture::boundTextureId(uint unit, QOpenGLTexture::BindingTarget target)

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

QOpenGLTexture::ComparisonFunction QOpenGLTexture::comparisonFunction() const

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

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

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

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

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-уровней.

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

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

Примечание: Создание 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(QOpenGLTexture::ComparisonFunction function)

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

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

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

void QOpenGLTexture::setComparisonMode(QOpenGLTexture::ComparisonMode mode)

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

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

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

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.

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)

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

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

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.

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

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

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

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

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

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

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

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

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

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

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

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

void QOpenGLTexture::setDepthStencilMode(QOpenGLTexture::DepthStencilMode mode)

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

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

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

Функция была введена в 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.

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

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

void QOpenGLTexture::setLevelofDetailBias(float bias)

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

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

См. также 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. Это ограничивает выбор mipmap с наименьшим разрешением (наивысший уровень mipmap). Значение по умолчанию — 1000.

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

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

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

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

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

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

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

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

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

Устанавливает режим обёртки (или повторения) для всех размерностей текстуры на 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

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

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