Qt3DRender.QAbstractTexture ¶

概要 ¶

详细描述 ¶

QAbstractTexture class shouldn’t be used directly but rather through one of its subclasses. Each subclass implements a given texture target (2D, 2DArray, 3D, CubeMap …) Each subclass provides a set of functors for each layer, cube map face and mipmap level. In turn the backend uses those functor to properly fill a corresponding OpenGL texture with data. It is expected the functor does as minimal processing as possible so as not to slow down textures generation and upload. If the content of a texture is the result of a slow procedural generation process, it is recommended not to implement this directly in a functor.

All textures are unique. If you instantiate twice the same texture this will create 2 identical textures on the GPU, no sharing will take place.

class PySide2.Qt3DRender.Qt3DRender. QAbstractTexture ( [ parent=None ] ) ¶

PySide2.Qt3DRender.Qt3DRender.QAbstractTexture(target[, parent=None])

param parent

QNode

param target

Target

The constructor creates a new QAbstractTexture instance with the specified parent .

The constructor creates a new QAbstractTexture instance with the specified target and parent .

PySide2.Qt3DRender.Qt3DRender.QAbstractTexture. Status ¶

Contains the status of the texture provider.

常量	描述
Qt3DRender.QAbstractTexture.None
Qt3DRender.QAbstractTexture.Loading
Qt3DRender.QAbstractTexture.Ready
Qt3DRender.QAbstractTexture.Error

PySide2.Qt3DRender.Qt3DRender.QAbstractTexture. Target ¶

常量	描述
Qt3DRender.QAbstractTexture.TargetAutomatic	Target will be determined by the Qt3D engine
Qt3DRender.QAbstractTexture.Target1D	GL_TEXTURE_1D
Qt3DRender.QAbstractTexture.Target1DArray	GL_TEXTURE_1D_ARRAY
Qt3DRender.QAbstractTexture.Target2D	GL_TEXTURE_2D
Qt3DRender.QAbstractTexture.Target2DArray	GL_TEXTURE_2D_ARRAY
Qt3DRender.QAbstractTexture.Target3D	GL_TEXTURE_3D
Qt3DRender.QAbstractTexture.TargetCubeMap	GL_TEXTURE_CUBE_MAP
Qt3DRender.QAbstractTexture.TargetCubeMapArray	GL_TEXTURE_CUBE_MAP_ARRAY
Qt3DRender.QAbstractTexture.Target2DMultisample	GL_TEXTURE_2D_MULTISAMPLE
Qt3DRender.QAbstractTexture.Target2DMultisampleArray	GL_TEXTURE_2D_MULTISAMPLE_ARRAY
Qt3DRender.QAbstractTexture.TargetRectangle	GL_TEXTURE_RECTANGLE
Qt3DRender.QAbstractTexture.TargetBuffer	GL_TEXTURE_BUFFER

PySide2.Qt3DRender.Qt3DRender.QAbstractTexture. TextureFormat ¶

This list describes all possible texture formats

常量	描述
Qt3DRender.QAbstractTexture.NoFormat	GL_NONE
Qt3DRender.QAbstractTexture.Automatic	automatically_determines_format
Qt3DRender.QAbstractTexture.R8_UNorm	GL_R8
Qt3DRender.QAbstractTexture.RG8_UNorm	GL_RG8
Qt3DRender.QAbstractTexture.RGB8_UNorm	GL_RGB8
Qt3DRender.QAbstractTexture.RGBA8_UNorm	GL_RGBA8
Qt3DRender.QAbstractTexture.R16_UNorm	GL_R16
Qt3DRender.QAbstractTexture.RG16_UNorm	GL_RG16
Qt3DRender.QAbstractTexture.RGB16_UNorm	GL_RGB16
Qt3DRender.QAbstractTexture.RGBA16_UNorm	GL_RGBA16
Qt3DRender.QAbstractTexture.R8_SNorm	GL_R8_SNORM
Qt3DRender.QAbstractTexture.RG8_SNorm	GL_RG8_SNORM
Qt3DRender.QAbstractTexture.RGB8_SNorm	GL_RGB8_SNORM
Qt3DRender.QAbstractTexture.RGBA8_SNorm	GL_RGBA8_SNORM
Qt3DRender.QAbstractTexture.R16_SNorm	GL_R16_SNORM
Qt3DRender.QAbstractTexture.RG16_SNorm	GL_RG16_SNORM
Qt3DRender.QAbstractTexture.RGB16_SNorm	GL_RGB16_SNORM
Qt3DRender.QAbstractTexture.RGBA16_SNorm	GL_RGBA16_SNORM
Qt3DRender.QAbstractTexture.R8U	GL_R8UI
Qt3DRender.QAbstractTexture.RG8U	GL_RG8UI
Qt3DRender.QAbstractTexture.RGB8U	GL_RGB8UI
Qt3DRender.QAbstractTexture.RGBA8U	GL_RGBA8UI
Qt3DRender.QAbstractTexture.R16U	GL_R16UI
Qt3DRender.QAbstractTexture.RG16U	GL_RG16UI
Qt3DRender.QAbstractTexture.RGB16U	GL_RGB16UI
Qt3DRender.QAbstractTexture.RGBA16U	GL_RGBA16UI
Qt3DRender.QAbstractTexture.R32U	GL_R32UI
Qt3DRender.QAbstractTexture.RG32U	GL_RG32UI
Qt3DRender.QAbstractTexture.RGB32U	GL_RGB32UI
Qt3DRender.QAbstractTexture.RGBA32U	GL_RGBA32UI
Qt3DRender.QAbstractTexture.R8I	GL_R8I
Qt3DRender.QAbstractTexture.RG8I	GL_RG8I
Qt3DRender.QAbstractTexture.RGB8I	GL_RGB8I
Qt3DRender.QAbstractTexture.RGBA8I	GL_RGBA8I
Qt3DRender.QAbstractTexture.R16I	GL_R16I
Qt3DRender.QAbstractTexture.RG16I	GL_RG16I
Qt3DRender.QAbstractTexture.RGB16I	GL_RGB16I
Qt3DRender.QAbstractTexture.RGBA16I	GL_RGBA16I
Qt3DRender.QAbstractTexture.R32I	GL_R32I
Qt3DRender.QAbstractTexture.RG32I	GL_RG32I
Qt3DRender.QAbstractTexture.RGB32I	GL_RGB32I
Qt3DRender.QAbstractTexture.RGBA32I	GL_RGBA32I
Qt3DRender.QAbstractTexture.R16F	GL_R16F
Qt3DRender.QAbstractTexture.RG16F	GL_RG16F
Qt3DRender.QAbstractTexture.RGB16F	GL_RGB16F
Qt3DRender.QAbstractTexture.RGBA16F	GL_RGBA16F
Qt3DRender.QAbstractTexture.R32F	GL_R32F
Qt3DRender.QAbstractTexture.RG32F	GL_RG32F
Qt3DRender.QAbstractTexture.RGB32F	GL_RGB32F
Qt3DRender.QAbstractTexture.RGBA32F	GL_RGBA32F
Qt3DRender.QAbstractTexture.RGB9E5	GL_RGB9_E5
Qt3DRender.QAbstractTexture.RG11B10F	GL_R11F_G11F_B10F
Qt3DRender.QAbstractTexture.RG3B2	GL_R3_G3_B2
Qt3DRender.QAbstractTexture.R5G6B5	GL_RGB565
Qt3DRender.QAbstractTexture.RGB5A1	GL_RGB5_A1
Qt3DRender.QAbstractTexture.RGBA4	GL_RGBA4
Qt3DRender.QAbstractTexture.RGB10A2	GL_RGB10_A2
Qt3DRender.QAbstractTexture.RGB10A2U	GL_RGB10_A2UI
Qt3DRender.QAbstractTexture.D16	GL_DEPTH_COMPONENT16
Qt3DRender.QAbstractTexture.D24	GL_DEPTH_COMPONENT24
Qt3DRender.QAbstractTexture.D24S8	GL_DEPTH24_STENCIL8
Qt3DRender.QAbstractTexture.D32	GL_DEPTH_COMPONENT32
Qt3DRender.QAbstractTexture.D32F	GL_DEPTH_COMPONENT32F
Qt3DRender.QAbstractTexture.D32FS8X24	GL_DEPTH32F_STENCIL8
Qt3DRender.QAbstractTexture.RGB_DXT1	GL_COMPRESSED_RGB_S3TC_DXT1_EXT
Qt3DRender.QAbstractTexture.RGBA_DXT1	GL_COMPRESSED_RGBA_S3TC_DXT1_EXT
Qt3DRender.QAbstractTexture.RGBA_DXT3	GL_COMPRESSED_RGBA_S3TC_DXT3_EXT
Qt3DRender.QAbstractTexture.RGBA_DXT5	GL_COMPRESSED_RGBA_S3TC_DXT5_EXT
Qt3DRender.QAbstractTexture.R_ATI1N_UNorm	GL_COMPRESSED_RED_RGTC1
Qt3DRender.QAbstractTexture.R_ATI1N_SNorm	GL_COMPRESSED_SIGNED_RED_RGTC1
Qt3DRender.QAbstractTexture.RG_ATI2N_UNorm	GL_COMPRESSED_RG_RGTC2
Qt3DRender.QAbstractTexture.RG_ATI2N_SNorm	GL_COMPRESSED_SIGNED_RG_RGTC2
Qt3DRender.QAbstractTexture.RGB_BP_UNSIGNED_FLOAT	GL_COMPRESSED_RGB_BPTC_UNSIGNED_FLOAT_ARB
Qt3DRender.QAbstractTexture.RGB_BP_SIGNED_FLOAT	GL_COMPRESSED_RGB_BPTC_SIGNED_FLOAT_ARB
Qt3DRender.QAbstractTexture.RGB_BP_UNorm	GL_COMPRESSED_RGBA_BPTC_UNORM_ARB
Qt3DRender.QAbstractTexture.R11_EAC_UNorm	GL_COMPRESSED_R11_EAC
Qt3DRender.QAbstractTexture.R11_EAC_SNorm	GL_COMPRESSED_SIGNED_R11_EAC
Qt3DRender.QAbstractTexture.RG11_EAC_UNorm	GL_COMPRESSED_RG11_EAC
Qt3DRender.QAbstractTexture.RG11_EAC_SNorm	GL_COMPRESSED_SIGNED_RG11_EAC
Qt3DRender.QAbstractTexture.RGB8_ETC2	GL_COMPRESSED_RGB8_ETC2
Qt3DRender.QAbstractTexture.SRGB8_ETC2	GL_COMPRESSED_SRGB8_ETC2
Qt3DRender.QAbstractTexture.RGB8_PunchThrough_Alpha1_ETC2	GL_COMPRESSED_RGB8_PUNCHTHROUGH_ALPHA1_ETC2
Qt3DRender.QAbstractTexture.SRGB8_PunchThrough_Alpha1_ETC2	GL_COMPRESSED_SRGB8_PUNCHTHROUGH_ALPHA1_ETC2
Qt3DRender.QAbstractTexture.RGBA8_ETC2_EAC	GL_COMPRESSED_RGBA8_ETC2_EAC
Qt3DRender.QAbstractTexture.SRGB8_Alpha8_ETC2_EAC	GL_COMPRESSED_SRGB8_ALPHA8_ETC2_EAC
Qt3DRender.QAbstractTexture.RGB8_ETC1	GL_ETC1_RGB8_OES
Qt3DRender.QAbstractTexture.SRGB8	GL_SRGB8
Qt3DRender.QAbstractTexture.SRGB8_Alpha8	GL_SRGB8_ALPHA8
Qt3DRender.QAbstractTexture.SRGB_DXT1	GL_COMPRESSED_SRGB_S3TC_DXT1_EXT
Qt3DRender.QAbstractTexture.SRGB_Alpha_DXT1	GL_COMPRESSED_SRGB_ALPHA_S3TC_DXT1_EXT
Qt3DRender.QAbstractTexture.SRGB_Alpha_DXT3	GL_COMPRESSED_SRGB_ALPHA_S3TC_DXT3_EXT
Qt3DRender.QAbstractTexture.SRGB_Alpha_DXT5	GL_COMPRESSED_SRGB_ALPHA_S3TC_DXT5_EXT
Qt3DRender.QAbstractTexture.SRGB_BP_UNorm	GL_COMPRESSED_SRGB_ALPHA_BPTC_UNORM_ARB
Qt3DRender.QAbstractTexture.DepthFormat	GL_DEPTH_COMPONENT
Qt3DRender.QAbstractTexture.AlphaFormat	GL_ALPHA
Qt3DRender.QAbstractTexture.RGBFormat	GL_RGB
Qt3DRender.QAbstractTexture.RGBAFormat	GL_RGBA
Qt3DRender.QAbstractTexture.LuminanceFormat	GL_LUMINANCE
Qt3DRender.QAbstractTexture.LuminanceAlphaFormat	0x190A

PySide2.Qt3DRender.Qt3DRender.QAbstractTexture. Filter ¶

Holds the filter type of the texture provider.

常量	描述
Qt3DRender.QAbstractTexture.Nearest	GL_NEAREST
Qt3DRender.QAbstractTexture.Linear	GL_LINEAR
Qt3DRender.QAbstractTexture.NearestMipMapNearest	GL_NEAREST_MIPMAP_NEAREST
Qt3DRender.QAbstractTexture.NearestMipMapLinear	GL_NEAREST_MIPMAP_LINEAR
Qt3DRender.QAbstractTexture.LinearMipMapNearest	GL_LINEAR_MIPMAP_NEAREST
Qt3DRender.QAbstractTexture.LinearMipMapLinear	GL_LINEAR_MIPMAP_LINEAR

PySide2.Qt3DRender.Qt3DRender.QAbstractTexture. CubeMapFace ¶

This enum identifies the faces of a cube map texture

常量	描述
Qt3DRender.QAbstractTexture.CubeMapPositiveX	Specify the positive X face of a cube map
Qt3DRender.QAbstractTexture.CubeMapNegativeX	Specify the negative X face of a cube map
Qt3DRender.QAbstractTexture.CubeMapPositiveY	Specify the positive Y face of a cube map
Qt3DRender.QAbstractTexture.CubeMapNegativeY	Specify the negative Y face of a cube map
Qt3DRender.QAbstractTexture.CubeMapPositiveZ	Specify the positive Z face of a cube map
Qt3DRender.QAbstractTexture.CubeMapNegativeZ	Specify the negative Z face of a cube map
Qt3DRender.QAbstractTexture.AllFaces	Specify all the faces of a cube map

注意

should only be used when a behavior needs to be applied to all the faces of a cubemap. This is the case for example when using a cube map as a texture attachment. Using in the attachment specfication would result in all faces being bound to the attachment point. On the other hand, if a specific face is specified, the attachment would only be using the specified face.

PySide2.Qt3DRender.Qt3DRender.QAbstractTexture. ComparisonFunction ¶

PySide2.Qt3DRender.Qt3DRender.QAbstractTexture. ComparisonMode ¶

PySide2.Qt3DRender.Qt3DRender.QAbstractTexture. HandleType ¶

PySide2.Qt3DRender.Qt3DRender.QAbstractTexture. addTextureImage ( textureImage ) ¶

参数

textureImage – QAbstractTextureImage

Adds a new Qt3DCore::QAbstractTextureImage textureImage to the texture provider.

注意

QAbstractTextureImage should never be shared between multiple QAbstractTexture 实例。

PySide2.Qt3DRender.Qt3DRender.QAbstractTexture. comparisonFunction ( ) ¶

返回类型

ComparisonFunction

Returns the current comparison function.

另请参阅

setComparisonFunction()

PySide2.Qt3DRender.Qt3DRender.QAbstractTexture. comparisonFunctionChanged ( comparisonFunction ) ¶

参数

comparisonFunction – ComparisonFunction

PySide2.Qt3DRender.Qt3DRender.QAbstractTexture. comparisonMode ( ) ¶

返回类型

ComparisonMode

Returns the current comparison mode.

另请参阅

setComparisonMode()

PySide2.Qt3DRender.Qt3DRender.QAbstractTexture. comparisonModeChanged ( comparisonMode ) ¶

参数

comparisonMode – ComparisonMode

PySide2.Qt3DRender.Qt3DRender.QAbstractTexture. dataGenerator ( ) ¶

返回类型

QSharedPointer

注意

此函数被弃用。

Returns the current data generator.

PySide2.Qt3DRender.Qt3DRender.QAbstractTexture. depth ( ) ¶

返回类型

int

Returns the depth of the texture

另请参阅

setDepth()

PySide2.Qt3DRender.Qt3DRender.QAbstractTexture. depthChanged ( depth ) ¶

参数

depth – int

PySide2.Qt3DRender.Qt3DRender.QAbstractTexture. format ( ) ¶

返回类型

TextureFormat

Returns the texture provider’s format.

另请参阅

setFormat()

PySide2.Qt3DRender.Qt3DRender.QAbstractTexture. formatChanged ( format ) ¶

参数

format – TextureFormat

PySide2.Qt3DRender.Qt3DRender.QAbstractTexture. generateMipMaps ( ) ¶

返回类型

bool

另请参阅

setGenerateMipMaps()

PySide2.Qt3DRender.Qt3DRender.QAbstractTexture. generateMipMapsChanged ( generateMipMaps ) ¶

参数

generateMipMaps – bool

PySide2.Qt3DRender.Qt3DRender.QAbstractTexture. handle ( ) ¶

返回类型

object

Returns the current texture handle, if Qt 3D is using the OpenGL renderer, handle is a texture id integer.

PySide2.Qt3DRender.Qt3DRender.QAbstractTexture. handleChanged ( handle ) ¶

参数

handle – object

PySide2.Qt3DRender.Qt3DRender.QAbstractTexture. handleType ( ) ¶

返回类型

HandleType

Returns the current texture handle type.

PySide2.Qt3DRender.Qt3DRender.QAbstractTexture. handleTypeChanged ( handleType ) ¶

参数

handleType – HandleType

PySide2.Qt3DRender.Qt3DRender.QAbstractTexture. height ( ) ¶

返回类型

int

Returns the height of the texture

另请参阅

setHeight()

PySide2.Qt3DRender.Qt3DRender.QAbstractTexture. heightChanged ( height ) ¶

参数

height – int

PySide2.Qt3DRender.Qt3DRender.QAbstractTexture. layers ( ) ¶

返回类型

int

Returns the maximum number of layers for the texture provider.

注意

this has a meaning only for texture providers that have 3D or array target formats.

另请参阅

setLayers()

PySide2.Qt3DRender.Qt3DRender.QAbstractTexture. layersChanged ( layers ) ¶

参数

layers – int

PySide2.Qt3DRender.Qt3DRender.QAbstractTexture. magnificationFilter ( ) ¶

返回类型

Filter

另请参阅

setMagnificationFilter()

PySide2.Qt3DRender.Qt3DRender.QAbstractTexture. magnificationFilterChanged ( magnificationFilter ) ¶

参数

magnificationFilter – Filter

PySide2.Qt3DRender.Qt3DRender.QAbstractTexture. maximumAnisotropy ( ) ¶

返回类型

float

Returns the current maximum anisotropy

另请参阅

setMaximumAnisotropy()

PySide2.Qt3DRender.Qt3DRender.QAbstractTexture. maximumAnisotropyChanged ( maximumAnisotropy ) ¶

参数

maximumAnisotropy – float

PySide2.Qt3DRender.Qt3DRender.QAbstractTexture. minificationFilter ( ) ¶

返回类型

Filter

另请参阅

setMinificationFilter()

PySide2.Qt3DRender.Qt3DRender.QAbstractTexture. minificationFilterChanged ( minificationFilter ) ¶

参数

minificationFilter – Filter

PySide2.Qt3DRender.Qt3DRender.QAbstractTexture. removeTextureImage ( textureImage ) ¶

参数

textureImage – QAbstractTextureImage

Removes a Qt3DCore::QAbstractTextureImage textureImage from the texture provider.

PySide2.Qt3DRender.Qt3DRender.QAbstractTexture. samples ( ) ¶

返回类型

int

Returns the number of samples per texel for the texture provider.

注意

this has a meaning only for texture providers that have multisample formats.

另请参阅

setSamples()

PySide2.Qt3DRender.Qt3DRender.QAbstractTexture. samplesChanged ( samples ) ¶

参数

samples – int

PySide2.Qt3DRender.Qt3DRender.QAbstractTexture. setComparisonFunction ( function ) ¶

参数

function – ComparisonFunction

Set the comparison function to function .

另请参阅

comparisonFunction()

PySide2.Qt3DRender.Qt3DRender.QAbstractTexture. setComparisonMode ( mode ) ¶

参数

mode – ComparisonMode

Set the comparison mode to mode .

另请参阅

comparisonMode()

PySide2.Qt3DRender.Qt3DRender.QAbstractTexture. setDepth ( depth ) ¶

参数

depth – int

Set the depth of the texture to depth .

另请参阅

depth()

PySide2.Qt3DRender.Qt3DRender.QAbstractTexture. setFormat ( format ) ¶

参数

format – TextureFormat

Set the texture format to format .

另请参阅

format()

PySide2.Qt3DRender.Qt3DRender.QAbstractTexture. setGenerateMipMaps ( gen ) ¶

参数

gen – bool

Boolean parameter gen sets a flag indicating whether the texture provider should generate mipmaps or not.

另请参阅

generateMipMaps()

PySide2.Qt3DRender.Qt3DRender.QAbstractTexture. setHandle ( handle ) ¶

参数

handle – object

另请参阅

handle()

PySide2.Qt3DRender.Qt3DRender.QAbstractTexture. setHandleType ( type ) ¶

参数

type – HandleType

另请参阅

handleType()

PySide2.Qt3DRender.Qt3DRender.QAbstractTexture. setHeight ( height ) ¶

参数

height – int

Set the height to height .

另请参阅

height()

PySide2.Qt3DRender.Qt3DRender.QAbstractTexture. setLayers ( layers ) ¶

参数

layers – int

Set the maximum layer count to layers .

另请参阅

layers()

PySide2.Qt3DRender.Qt3DRender.QAbstractTexture. setMagnificationFilter ( f ) ¶

参数

f – Filter

Set the magnification filter to f .

另请参阅

magnificationFilter()

PySide2.Qt3DRender.Qt3DRender.QAbstractTexture. setMaximumAnisotropy ( anisotropy ) ¶

参数

anisotropy – float

Sets the maximum anisotropy to anisotropy .

另请参阅

maximumAnisotropy()

PySide2.Qt3DRender.Qt3DRender.QAbstractTexture. setMinificationFilter ( f ) ¶

参数

f – Filter

Set the minification filter to the specified value f .

另请参阅

minificationFilter()

PySide2.Qt3DRender.Qt3DRender.QAbstractTexture. setSamples ( samples ) ¶

参数

samples – int

Set the number of samples per texel to samples .

另请参阅

samples()

PySide2.Qt3DRender.Qt3DRender.QAbstractTexture. setSize ( width [ , height=1 [ , depth=1 ] ] ) ¶

参数

• width – int

• height – int

• depth – int

Sets the size of the texture provider to width w , height h and depth d .

PySide2.Qt3DRender.Qt3DRender.QAbstractTexture. setStatus ( status ) ¶

参数

status – Status

Set the status of the texture provider to the specified status .

另请参阅

status()

PySide2.Qt3DRender.Qt3DRender.QAbstractTexture. setWidth ( width ) ¶

参数

width – int

Set the width of the texture provider to width .

另请参阅

width()

PySide2.Qt3DRender.Qt3DRender.QAbstractTexture. setWrapMode ( wrapMode ) ¶

参数

wrapMode – QTextureWrapMode

Set the wrapmode to the value specified in wrapMode .

另请参阅

wrapMode()

PySide2.Qt3DRender.Qt3DRender.QAbstractTexture. status ( ) ¶

返回类型

Status

Returns the current status of the texture provider.

另请参阅

setStatus()

PySide2.Qt3DRender.Qt3DRender.QAbstractTexture. statusChanged ( status ) ¶

参数

status – Status

PySide2.Qt3DRender.Qt3DRender.QAbstractTexture. target ( ) ¶

返回类型

Target

Returns the target format of the texture provider.

PySide2.Qt3DRender.Qt3DRender.QAbstractTexture. textureImages ( ) ¶

返回类型

Returns a list of pointers to QAbstractTextureImage objects contained in the texture provider.

PySide2.Qt3DRender.Qt3DRender.QAbstractTexture. width ( ) ¶

返回类型

int

Returns the width of the texture

另请参阅

setWidth()

PySide2.Qt3DRender.Qt3DRender.QAbstractTexture. widthChanged ( width ) ¶

参数

width – int

PySide2.Qt3DRender.Qt3DRender.QAbstractTexture. wrapMode ( ) ¶

返回类型

QTextureWrapMode

另请参阅

setWrapMode()