gluBuild1DMipmaps

NAME

gluBuild1DMipmaps -- create 1-D mipmaps

C SPECIFICATION

int gluBuild1DMipmaps(GLenum target,
                            GLint components,
                            GLint width,
                            GLenum format,
                            GLenum type,
                            const void *data)

PARAMETERS

target: Specifies the target texture. Must be GL_TEXTURE_1D.
components: Specifies the number of color components in the texture. Must be 1, 2, 3, or 4.
width: Specifies the width of the texture image.
format: Specifies the format of the pixel data. Must be one of GL_COLOR_INDEX, GL_RED, GL_GREEN, GL_BLUE, GL_ALPHA, GL_RGB, GL_RGBA, GL_LUMINANCE, and GL_LUMINANCE_ALPHA.
type: Specifies the data type for data. Must be one of GL_UNSIGNED_BYTE, GL_BYTE, GL_BITMAP, GL_UNSIGNED_SHORT, GL_SHORT, GL_UNSIGNED_INT, GL_INT, or GL_FLOAT.
data: Specifies a pointer to the image data in memory.

DESCRIPTION

gluBuild1DMipmaps obtains the input image and generates all mipmap images (using gluScaleImage) so that the input image can be used as a mipmapped texture image. glTexImage1D is then called to load each of the images. If the width of the input image is not a power of two, then the image is scaled to the nearest power of two before the mipmaps are generated.

A return value of zero indicates success. Otherwise, a GLU error code is returned (see gluErrorString).

Please refer to the glTexImage1D reference page for a description of the acceptable values for the format parameter. See the glDrawPixels reference page for a description of the acceptable values for the type parameter.

gluBuild1DMipmaps

NAME

C SPECIFICATION

PARAMETERS

DESCRIPTION

SEE ALSO