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函式可以取出下列錯誤碼。

名稱 意義
GL _ 無效 _ 值
寬度高度 為負數。
GL _ 不正確 _ 操作
呼叫 glBegin 和對應的 glEnd呼叫之間呼叫了函數。

備註

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

點陣圖影像的解讀方式就像是 glDrawPixels 函式的影像資料,其 寬度高度 對應于該函式的寬度和高度引數,以及將 type 設定為 GL _ 點陣圖,並將 格式 設定為 gl _ 色彩 _ 索引。 使用 glPixelStore 指定的模式會影響點陣圖影像資料的解讀;使用 glPixelTransfer 指定的模式則否。

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

xw = xr x

yw = yr y

在這些座標中, (xryr ) 是點陣位置,而 (x? , y? ) 是點陣圖原點。 然後會為點陣圖影像中對應至1的每個圖元產生片段。 這些片段會使用目前的點陣 z 座標、色彩或色彩索引,以及目前的點陣材質座標來產生。 然後,系統會將它們視為由點、線條或多邊形產生,包括紋理對應、fogging,以及 Alpha 和深度測試等所有的每個片段作業。

繪製點陣圖之後,目前點陣位置的 xy 座標會以 xmoveymove 位移。 目前點陣位置的 z 座標或目前的點陣色彩、索引或材質座標都不會進行任何變更。

下列函式會取出與 glBitmap 函數相關的資訊:

具有引數 GL _ 目前 _ 點陣 _ 位置的 glGet

具有引數 GL _ 目前 _ 點陣 _ 色彩的 glGet

具有引數 GL _ 目前 _ 點陣 _ 索引的 glGet

具有引數 GL _ 目前 _ 點陣 _ 材質紋理 _ 的 glGet

具有引數 GL _ 目前 _ 點陣 _ 位置 _ 有效的 glGet

規格需求

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

另請參閱

glBegin

glDrawPixels

glEnd

glPixelStore

glPixelTransfer

glRasterPos