glBitmap 函式

glBitmap函式會繪製點陣圖。

語法

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

參數

width (寬度)

點陣圖影像的圖元寬度。

height (高度)

點陣圖影像的圖元高度。

xorig

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

yorig

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

xmove

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

ymove

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

點陣圖

點陣圖影像的位址。

傳回值

此函式不會傳回值。

錯誤碼

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

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

備註

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

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

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

xwxrx = ?

ywyry = ?

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

繪製點陣圖之後,目前點陣位置的 xy 座標會依 xmoveymove位移。 對目前點陣位置的 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 Professional [僅限傳統型應用程式]
最低支援的伺服器
Windows 2000 Server [僅限桌面應用程式]
標頭
Gl.h
程式庫
Opengl32.lib
DLL
Opengl32.dll

另請參閱

glBegin

glDrawPixels

glEnd

glPixelStore

glPixelTransfer

glRasterPos