QSGOpaqueTextureMaterial

The QSGOpaqueTextureMaterial class provides a convenient way of rendering textured geometry in the scene graph. More

Inheritance diagram of PySide6.QtQuick.QSGOpaqueTextureMaterial

Inherited by: QSGTextureMaterial

Synopsis

Functions

Detailed Description

Warning

This utility class is only functional when running with the default backend of the Qt Quick scenegraph.

The opaque textured material will fill every pixel in a geometry with the supplied texture. The material does not respect the opacity of the RenderState , so opacity nodes in the parent chain of nodes using this material, have no effect.

The geometry to be rendered with an opaque texture material requires vertices in attribute location 0 and texture coordinates in attribute location 1. The texture coordinate is a 2-dimensional floating-point tuple. The defaultAttributes_TexturedPoint2D returns an attribute set compatible with this material.

The texture to be rendered can be set using setTexture() . How the texture should be rendered can be specified using setMipmapFiltering() , setFiltering() , setHorizontalWrapMode() and setVerticalWrapMode() . The rendering state is set on the texture instance just before it is bound.

The opaque textured material respects the current matrix and the alpha channel of the texture. It will disregard the accumulated opacity in the scenegraph.

A texture material must have a texture set before it is used as a material in the scene graph.

class PySide6.QtQuick.QSGOpaqueTextureMaterial

Creates a new QSGOpaqueTextureMaterial .

The default mipmap filtering and filtering mode is set to Nearest . The default wrap modes is set to QSGTexture::ClampToEdge.

PySide6.QtQuick.QSGOpaqueTextureMaterial.m_texture
PySide6.QtQuick.QSGOpaqueTextureMaterial.m_filtering
PySide6.QtQuick.QSGOpaqueTextureMaterial.m_mipmap_filtering
PySide6.QtQuick.QSGOpaqueTextureMaterial.m_horizontal_wrap
PySide6.QtQuick.QSGOpaqueTextureMaterial.m_vertical_wrap
PySide6.QtQuick.QSGOpaqueTextureMaterial.m_anisotropy_level
PySide6.QtQuick.QSGOpaqueTextureMaterial.m_reserved
PySide6.QtQuick.QSGOpaqueTextureMaterial.anisotropyLevel()
Return type

AnisotropyLevel

Returns this material’s anistropy level.

PySide6.QtQuick.QSGOpaqueTextureMaterial.filtering()
Return type

Filtering

Returns this material’s filtering mode.

The default filtering is QSGTexture::Nearest.

See also

setFiltering()

PySide6.QtQuick.QSGOpaqueTextureMaterial.horizontalWrapMode()
Return type

WrapMode

Returns this material’s horizontal wrap mode.

The default horizontal wrap mode is QSGTexture::ClampToEdge.

PySide6.QtQuick.QSGOpaqueTextureMaterial.mipmapFiltering()
Return type

Filtering

Returns this material’s mipmap filtering mode.

The default mipmap mode is QSGTexture::Nearest.

PySide6.QtQuick.QSGOpaqueTextureMaterial.setAnisotropyLevel(level)
Parameters

levelAnisotropyLevel

Sets this material’s anistropy level to level.

PySide6.QtQuick.QSGOpaqueTextureMaterial.setFiltering(filteringType)
Parameters

filteringTypeFiltering

Sets the filtering to filtering.

The filtering mode is set on the texture instance just before the texture is bound for rendering.

See also

filtering()

PySide6.QtQuick.QSGOpaqueTextureMaterial.setHorizontalWrapMode(mode)
Parameters

modeWrapMode

Sets the horizontal wrap mode to mode.

The horizontal wrap mode is set on the texture instance just before the texture is bound for rendering.

PySide6.QtQuick.QSGOpaqueTextureMaterial.setMipmapFiltering(filteringType)
Parameters

filteringTypeFiltering

Sets the mipmap mode to filtering.

The mipmap filtering mode is set on the texture instance just before the texture is bound for rendering.

If the texture does not have mipmapping support, enabling mipmapping has no effect.

PySide6.QtQuick.QSGOpaqueTextureMaterial.setTexture(texture)
Parameters

texturePySide6.QtQuick.QSGTexture

Sets the texture of this material to texture.

The material does not take ownership of the texture.

See also

texture()

PySide6.QtQuick.QSGOpaqueTextureMaterial.setVerticalWrapMode(mode)
Parameters

modeWrapMode

Sets the vertical wrap mode to mode.

The vertical wrap mode is set on the texture instance just before the texture is bound for rendering.

PySide6.QtQuick.QSGOpaqueTextureMaterial.texture()
Return type

PySide6.QtQuick.QSGTexture

Returns this texture material’s texture.

See also

setTexture()

PySide6.QtQuick.QSGOpaqueTextureMaterial.verticalWrapMode()
Return type

WrapMode

Returns this material’s vertical wrap mode.

The default vertical wrap mode is QSGTexture::ClampToEdge.