Класс QOpenGLTexture

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

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

enum QOpenGLTexture::BindingTarget

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

[since 5.5] enum QOpenGLTexture::ComparisonFunction

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

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

[since 5.5] enum QOpenGLTexture::ComparisonMode

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

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

enum QOpenGLTexture::CoordinateDirection

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

enum QOpenGLTexture::CubeMapFace

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

[since 5.4] 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

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

перечисление QOpenGLTexture::SwizzleComponent

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

перечисление QOpenGLTexture::SwizzleValue

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

перечисление QOpenGLTexture::Target

Это перечисление определяет целевой тип текстуры объекта QOpenGLTexture. Более подробную информацию о создании массивов текстур можно найти на странице Массивы текстур.

перечисление QOpenGLTexture::TextureFormat

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

enum QOpenGLTexture::TextureUnitReset

This enum defines options to control texture unit activation.

enum QOpenGLTexture::WrapMode

This enum defines the possible texture coordinate wrapping modes.

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

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

Creates a QOpenGLTexture object, which can be later bound to the 2D texture target and contains the pixel data contained in image. If you wish to have a chain of mipmaps generated then set genMipMaps to true (this is the default).

This does create the underlying OpenGL texture object. Therefore, construction using this constructor does require a valid current OpenGL context.

QOpenGLTexture::QOpenGLTexture(QOpenGLTexture::Target target)

Creates a QOpenGLTexture object that can later be bound to target.

This does not create the underlying OpenGL texture object. Therefore, construction using this constructor does not require a valid current OpenGL context.

void QOpenGLTexture::allocateStorage()

Allocates server-side storage for this texture object, taking into account the format, dimensions, mipmap levels, array layers, and cubemap faces.

Once storage has been allocated, it is no longer possible to change these properties.

If supported, QOpenGLTexture uses immutable texture storage.

Once storage has been allocated for the texture, pixel data can be uploaded via one of the setData() overloads.

Note: If immutable texture storage is not available, a default pixel format and pixel type will be used to create the mutable storage. You can use the other allocateStorage() overload to specify exactly the pixel format and the pixel type to use when allocating mutable storage; this is particularly useful under certain OpenGL ES implementations (notably, OpenGL ES 2), where the pixel format and the pixel type used at allocation time must perfectly match the format and the type passed to any subsequent setData() call.

See also isStorageAllocated() and setData().

[since 5.5] void QOpenGLTexture::allocateStorage(QOpenGLTexture::PixelFormat pixelFormat, QOpenGLTexture::PixelType pixelType)

Allocates server-side storage for this texture object, taking into account the format, dimensions, mipmap levels, array layers, and cubemap faces.

Once storage has been allocated, it is no longer possible to change these properties.

If supported, QOpenGLTexture uses immutable texture storage. However, if immutable texture storage is not available, then the specified pixelFormat and pixelType will be used to allocate mutable storage; note that in certain OpenGL implementations (notably, OpenGL ES 2) they must perfectly match the format and the type passed to any subsequent setData() call.

Once storage has been allocated for the texture, pixel data can be uploaded via one of the setData() overloads.

This function was introduced in Qt 5.5.

See also isStorageAllocated() and setData().

void QOpenGLTexture::bind()

Binds this texture to the currently active texture unit, preparing it for rendering. Note that you do not need to bind QOpenGLTexture objects in order to modify them as the implementation makes use of the EXT_direct_state_access extension where available and simulates it where it is not.

See also release().

void QOpenGLTexture::bind(uint unit, QOpenGLTexture::TextureUnitReset reset = DontResetTextureUnit)

Binds this texture to texture unit unit, preparing it for rendering. Note that you do not need to bind QOpenGLTexture objects in order to modify them as the implementation makes use of the EXT_direct_state_access extension where available and simulates it where it is not.

If parameter reset is true then this function will restore the active unit to the texture unit that was active upon entry.

See also release().

QColor QOpenGLTexture::borderColor() const

Returns the borderColor of this texture.

See also setBorderColor().

void QOpenGLTexture::borderColor(float *border) const

Writes the texture border color into the first four elements of the array pointed to by border.

See also setBorderColor().

void QOpenGLTexture::borderColor(int *border) const

Writes the texture border color into the first four elements of the array pointed to by border.

This is an overloaded function.

void QOpenGLTexture::borderColor(unsigned int *border) const

Writes the texture border color into the first four elements of the array pointed to by border.

This is an overloaded function.

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

Returns the textureId of the texture bound to the target of the currently active texture unit.

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

Returns the textureId of the texture bound to the target of the texture unit unit.

[since 5.5] QOpenGLTexture::ComparisonFunction QOpenGLTexture::comparisonFunction() const

Returns the texture comparison operator set on this texture. By default, a texture has a CompareLessEqual comparison function.

This function was introduced in Qt 5.5.

See also setComparisonFunction().

[since 5.5] QOpenGLTexture::ComparisonMode QOpenGLTexture::comparisonMode() const

Returns the texture comparison mode set on this texture. By default, a texture has a CompareNone comparison mode (i.e. comparisons are disabled).

This function was introduced in Qt 5.5.

See also setComparisonMode().

bool QOpenGLTexture::create()

Creates the underlying OpenGL texture object. This requires a current valid OpenGL context. If the texture object already exists, this function does nothing.

Once the texture object is created, you can obtain the object name from the textureId() function. This may be useful if you wish to make some raw OpenGL calls related to this texture.

Normally it should not be necessary to call this function directly as all functions that set properties of the texture object implicitly call create() on your behalf.

Returns true if the creation was successful, otherwise returns false.

See also destroy(), isCreated(), and 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().

[since 5.4] 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()

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

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

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

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

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

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

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

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

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

int QOpenGLTexture::height() const

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

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

bool QOpenGLTexture::isAutoMipMapGenerationEnabled() const

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

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

bool QOpenGLTexture::isBound() const

Возвращает true если эта текстура привязана к соответствующей цели текущего активного блока текстур.

См. также bind() и release().

bool QOpenGLTexture::isBound(uint unit)

Возвращает true если эта текстура привязана к соответствующей цели блока текстур unit.

См. также bind() и release().

bool QOpenGLTexture::isCreated() const

Возвращает true если базовый объект OpenGL текстуры был создан.

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

bool QOpenGLTexture::isFixedSamplePositions() const

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

Для целевых значений текстуры, которые не поддерживают многообразные выборки, это вернёт true.

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

bool QOpenGLTexture::isStorageAllocated() const

Возвращает true если серверное хранилище для этой текстуры выделено.

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

См. также allocateStorage(), setSize(), setMipLevels(), setLayers() и setFormat().

bool QOpenGLTexture::isTextureView() const

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

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

int QOpenGLTexture::layers() const

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

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

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

QPair<float, float> QOpenGLTexture::levelOfDetailRange() const

Возвращает минимальные и максимальные параметры уровня детализации.

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

float QOpenGLTexture::levelofDetailBias() const

Возвращает параметр смещения уровня детализации.

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

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

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

[since 5.5] void QOpenGLTexture::setComparisonFunction(QOpenGLTexture::ComparisonFunction function)

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

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

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

[since 5.5] void QOpenGLTexture::setComparisonMode(QOpenGLTexture::ComparisonMode mode)

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

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

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

[since 5.3] 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.

[since 5.9] 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)

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

[since 5.3] 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().

[since 5.9] 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.

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

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

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

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

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

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

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

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

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

[since 5.14] 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.

[since 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.

[since 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.

[since 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.

[since 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, чтобы отключить генерацию мип-мап.

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

[since 5.4] 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)

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

Если целевая текстура не поддерживает 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().