Класс 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. Другой вариант — преобразовать координаты вашей текстуры.

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

enum 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 — это typedef для 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.

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

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

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

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

Возвращает textureId текстуры, привязанной к 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-уровни для этого объекта текстуры, начиная с уровня 0. Если вы используете целевой объект текстуры и параметр фильтрации, требующий mip-уровни, и отключили автоматическую генерацию mip-уровней, необходимо вызвать эту функцию или её перегрузку для создания цепочки mip-уровней.

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

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

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

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

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

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

Если вы не используете сжатый формат(), то вместо этой функции используйте 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(int xOffset, int yOffset, int zOffset, int width, int height, int depth, QOpenGLTexture::PixelFormat sourceFormat, QOpenGLTexture::PixelType sourceType, const void *data, const QOpenGLPixelTransferOptions *const options = nullptr)

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Данный метод был введён в Qt 5.14.

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

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

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

void QOpenGLTexture::setDepthStencilMode(QOpenGLTexture::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(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. Смещение уровня детализации влияет на момент изменения уровней мип-карт. Увеличение значений смещения уровня детализации делает общие изображения размытыми или более гладкими. Уменьшение значений делает общие изображения более чёткими.

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

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

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

void QOpenGLTexture::setMipBaseLevel(int baseLevel)

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

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

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

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

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

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

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

void QOpenGLTexture::setMipLevels(int levels)

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

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

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

void QOpenGLTexture::setMipMaxLevel(int maxLevel)

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

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