Класс 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(QOpenGLTexture::Target target)

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

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

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

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

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

QOpenGLTexture::~QOpenGLTexture()

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

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-уровни для этого объекта текстуры, начиная с уровня 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)

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