GLTEXTURETARGETMODESUN(3gl)GLTEXTURETARGETMODESUN(3gl)NAME
glSetTextureTargetModeSUN - set current mode for texture targeting.
C SPECIFICATION
void glSetTextureTargetModeSUN( GLenum mode )
PARAMETERS
mode Specifies which mode to use when assigning textures to each pipe‐
line. This can be one of GL_TEXTURE_TARGET_NUM_PIPES_SUN, GL_TEX‐
TURE_TARGET_PIPE_MASK_SUN, or GL_TEXTURE_TARGET_AUTO_SUN
DESCRIPTION
glSetTextureTargetModeSUN sets the current mode for texture targeting
in multi-pipeline frame buffers. By default a copy of the current tex‐
ture is stored in each of the available pipelines. While this allows
for optimal performance (as geometry can be directed to any pipeline
and be assured that the correct texture is resident), it restricts the
total visible texture memory space to that of a single pipeline (256Mb
in the case of the XVR-4000). When GL_TEXTURE_TARGET_SUN is enabled,
glSetTextureTargetModeSUN allows an application to direct textures to
be stored in a subset of the pipelines, increasing texture capacity at
the potential expense of performance.
The mode argument can take the following values:
GL_TEXTURE_TARGET_NUM_PIPES_SUN:
When the mode is set to this value, texture maps will be downloaded to
as many pipelines as have been specified by the glSetTextureTargetiSUN
function.
GL_TEXTURE_TARGET_PIPE_MASK_SUN:
This mode indicates that the OpenGL pipeline is to only download tex‐
tures to the pipelines specified by the bitmask provided by the glSet‐
TextureTargetiSUN function.
GL_TEXTURE_TARGET_AUTO_SUN:
When the mode is set to this value OpenGL will attempt to download as
many textures into hardware memory as possible, while maximizing the
number of pipes that can be used in parallel.
ERRORS
GL_INVALID_ENUM is generated if mode is not an accepted value.
GL_INVALID_OPERATION is generated if glTextureTargetModeSUN is executed
on any other frame buffer that doesn't support this extension.
GL_INVALID_OPERATION is generated if glTextureTargetModeSUN is executed
between the execution of glBegin and the corresponding execution of
glEnd.
Associated Gets
glGetIntegerv with argument GL_TEXTURE_TARGET_NUM_PIPES_SUN
glGetIntegerv with argument GL_TEXTURE_TARGET_PIPE_MASK_SUN
glGetIntegerv with argument GL_TEXTURE_TARGET_MAX_PIPES_SUN
glGetIntegerv with argument GL_TEXTURE_TARGET_MODE_SUN
SEE ALSO
glSetTextureTargetiSUN
07 Oct 02 GLTEXTURETARGETMODESUN(3gl)