gluBuild1DMipmaps 函式

gluBuild1DMipmaps 函式會建立 1D mipmaps。

語法

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

參數

目標

目標紋理。 必須是GL_TEXTURE_1D。

元件

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

寬度

紋理影像的寬度。

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

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

傳回值

此函式不會傳回值。

備註

gluBuild1DMipmaps 函式會取得輸入影像，並使用gluScaleImage) 產生所有 mipmap (影像，以便將輸入影像當做誤用的紋理影像使用。 接著會呼叫 glTexImage1D 函式來載入每個影像。 如果輸入影像的寬度不是兩個的乘冪，則會在產生 mipmap 之前，將影像調整為最接近的兩個乘冪。

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

如需 格式 參數可接受的值描述，請參閱 glTexImage1D。 如需 類型 參數可接受的值描述，請參閱 glDrawPixels。

規格需求

需求	值
最低支援的用戶端	Windows 2000 專業版 [僅限傳統型應用程式]
最低支援的伺服器	Windows 2000 Server [僅限傳統型應用程式]
標頭	Glu.h
程式庫	Glu32.lib
DLL	Glu32.dll

另請參閱

glDrawPixels

glTexImage1D

gluBuild2DMipmaps

gluScaleImage