glBitmap 函式

glBitmap函式會繪製點陣圖。

語法

void WINAPI glBitmap(
         GLSizei width,
         GLSizei height,
         GLfloat xorig,
         GLfloat yorig,
         GLfloat xmove,
         GLfloat ymove,
   const GLubyte *bitmap
);

參數

寬度

點陣圖影像的圖元寬度。

height (高度)

點陣圖影像的圖元高度。

xorig

點陣圖影像中原點的 x 位置。 原點是從點陣圖左下角測量，向右和向上方向是正軸。

yorig

點陣圖影像中原點的 Y 位置。 原點是從點陣圖左下角測量，向右和向上方向是正軸。

xmove

繪製點陣圖之後要加入目前點陣位置的 x 位移。

ymove

繪製點陣圖之後要新增至目前點陣位置的 y 位移。

點陣圖

點陣圖影像的位址。

傳回值

此函式不會傳回值。

錯誤碼

glGetError函式可以擷取下列錯誤碼。

名稱	意義
GL_INVALID_VALUE	寬度 或 高度 為負數。
GL_INVALID_OPERATION	在 對 glBegin 的呼叫與 glEnd的對應呼叫之間呼叫函式。

備註

點陣圖是二進位影像。 繪製時，點陣圖會相對於目前的點陣位置放置，而對應至點陣圖中 1s 的框架緩衝區圖元則會使用目前的點陣色彩或索引來寫入。 不會修改對應至點陣圖中零的框架緩衝區圖元。

點陣圖影像會解譯為 glDrawPixels 函式的影像資料， 其寬度 和 高度 對應至該函式的寬度和高度引數，並將 類型 設定為GL_BITMAP，並將 格式 設定為 GL_COLOR_INDEX。 您使用 glPixelStore 指定的模式會影響點陣圖影像資料的解譯;您使用 glPixelTransfer 指定的模式不會。

如果目前的點陣位置無效， 則會忽略 glBitmap 。 否則，點陣圖影像的左下角位於下列視窗座標處：

x_x = _rx？

y_w = y_ry？

在這些座標中， (x_r 、 y_r ) 是點陣位置，而 (x？， y？) 是點陣圖原點。 接著會針對點陣圖影像中對應至 1 的每個圖元產生片段。 這些片段是使用目前的點陣 Z座標、色彩或色彩索引，以及目前的點陣紋理座標來產生。 然後，它們會被視為由點、線條或多邊形產生，包括紋理對應、模糊處理，以及 Alpha 和深度測試等所有個別片段作業。

繪製點陣圖之後，目前點陣位置的 x 和 y 座標會依 xmove 和 ymove位移。 對目前點陣位置的 Z座標或目前點陣色彩、索引或紋理座標沒有變更。

下列函式會擷取 glBitmap 函式的相關資訊：

glGet 與引數GL_CURRENT_RASTER_POSITION

glGet 與引數GL_CURRENT_RASTER_COLOR

glGet 與引數GL_CURRENT_RASTER_INDEX

glGet with argument GL_CURRENT_RASTER_TEXTURE_COORDS

具有引數的glGet GL_CURRENT_RASTER_POSITION_VALID

規格需求

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

另請參閱

glBegin

glDrawPixels

glEnd

glPixelStore

glPixelTransfer

glRasterPos