IDLgrPolygon::GetMultiTextureCoord

The IDLgrPolygon::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. See Advanced Rendering Using Shader Objects (Object Programming) for more information.

Syntax

Obj->[IDLgrPolygon::]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 polygon object using IDLgrPolygon::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

See Multi-texture Shaders (Object Programming)

Version History


6.4	Introduced