Export (0) Print
Expand All

gluBuild2DMipmaps function

Applies to: desktop apps only

The gluBuild2DMipmaps function creates 2-D mipmaps.

Syntax

void WINAPI gluBuild2DMipmaps(
  GLenum target,
  GLint components,
  GLint width,
  GLInt height,
  GLenum format,
  GLenum type,
  const void *data
);

Parameters

target

The target texture. Must be GL_TEXTURE_2D.

components

The number of color components in the texture. Must be 1, 2, 3, or 4.

width

The width of the texture image.

height

The height of the texture image.

format

The format of the pixel data. Must be one of the following: GL_COLOR_INDEX, GL_RED, GL_GREEN, GL_BLUE, GL_ALPHA, GL_RGB, GL_RGBA, GL_BGR_EXT, GL_BGRA_EXT, GL_LUMINANCE, or GL_LUMINANCE_ALPHA.

type

The data type for data. Must be one of the following: GL_UNSIGNED_BYTE, GL_BYTE, GL_BITMAP, GL_UNSIGNED_SHORT, GL_SHORT, GL_UNSIGNED_INT, GL_INT, or GL_FLOAT.

data

A pointer to the image data in memory.

Return value

This function does not return a value.

Remarks

The gluBuild2DMipmaps function obtains the input image and generates all mipmap images (using gluScaleImage) so the input image can be used as a mipmapped texture image. To load each of the images, call glTexImage2D. If the dimensions of the input image are not powers of two, then the image is scaled so that both the width and height are powers of two before the mipmaps are generated.

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

For a description of the acceptable values for the format parameter, see glTexImage2D. For a description of the acceptable values for type, see glDrawPixels.

Requirements

Minimum supported client

Windows 2000 Professional

Minimum supported server

Windows 2000 Server

Header

Glu.h

Library

Glu32.lib

DLL

Glu32.dll

See also

glDrawPixels
glTexImage2D
gluBuild1DMipmaps
gluScaleImage

 

 

Send comments about this topic to Microsoft

Build date: 3/6/2012

Community Additions

ADD
Show:
© 2015 Microsoft