IDLgrSurface::GetMultiTextureCoord

The IDLgrSurface::GetMultiTextureCoord returns the texture coordinates associated with a given Unit. This method is useful when a shader program defined by an IDLgrShader object applies more than a single texture to an object.

Syntax

Obj->[IDLgrSurface::]GetMultiTextureCoord, Unit, TexCoord

Arguments

Unit

This scalar numeric value specifies the texture unit. Texture units are used primarily with multi-texturing and allow OpenGL to handle multiple textures and multiple sets of texture coordinates and parameters. This value should be greater than or equal to zero and less than the MAX_VERTEX_TEXTURE_IMAGE_UNITS (for vertex shaders) or MAX_TEXTURE_IMAGE_UNITS (for fragment shaders). These values can be returned by IDLgrWindow::GetDeviceInfo.

Note: If the specified Unit value was never defined and stored in the surface object using IDLgrSurface::SetMultiTextureCoord, then the variable specified in the TexCoord parameter will be set to an undefined variable.

TexCoord

Specifies a variable that contains the current texture coordinates associated with the specified Unit. Texture coordinates are stored in this parameter as single precision floating point numbers.

Keywords

None

Examples

Version History

6.4

Introduced

See Also

IDLgrSurface::SetMultiTextureCoord