gluBuild1DMipmaps - create 1-D mipmaps
int gluBuild1DMipmaps( GLenum target, GLint components, GLint width, GLenum format, GLenum type, const void *data )
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.
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.
glTexImage1D, gluBuild2DMipmaps, gluErrorString, gluScaleImage
Introduction | Alphabetic | Specification
Last Edited: Mon, May 22, 1995