gluBuild2DMipmaps 函式

gluBuild2DMipmaps 函式會建立 2D Mipmaps。

語法

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

參數

目標

目標紋理。 必須是GL_TEXTURE_2D。

元件

紋理中的色彩元件數目。 必須是 1、2、3 或 4。

寬度

紋理影像的寬度。

height (高度)

紋理影像的高度。

format

圖元資料的格式。 必須是下列其中一項：GL_COLOR_INDEX、GL_RED、GL_GREEN、GL_BLUE、GL_ALPHA、GL_RGB、GL_RGBA、GL_BGR_EXT、GL_BGRA_EXT、GL_LUMINANCE或GL_LUMINANCE_ALPHA。

type

資料的資料類型。 必須是下列其中一項：GL_UNSIGNED_BYTE、GL_BYTE、GL_BITMAP、GL_UNSIGNED_SHORT、GL_SHORT、GL_UNSIGNED_INT、GL_INT或GL_FLOAT。

data

記憶體中影像資料的指標。

傳回值

此函式不會傳回值。

備註

gluBuild2DMipmaps函式會取得輸入影像，並使用gluScaleImage) 產生所有 mipmap 影像 (，讓輸入影像可作為 mipmapped 紋理影像。 若要載入每個影像，請呼叫 glTexImage2D。 如果輸入影像的維度不是兩個的乘冪，則會縮放影像，以便在產生 mipmap 之前，寬度和高度都是兩個的乘冪。

傳回值為零表示成功。 否則， (請參閱 gluErrorString) 傳回 GLU 錯誤碼。

如需 format 參數可接受的值描述，請參閱 glTexImage2D。 如需 類型可接受的值描述，請參閱 glDrawPixels。

規格需求

另請參閱

glDrawPixels

glTexImage2D

gluBuild1DMipmaps

gluScaleImage