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函式可以擷取下列錯誤碼。
點陣圖是二進位影像。 繪製時,點陣圖會相對於目前的點陣位置放置,而對應至點陣圖中 1s 的框架緩衝區圖元則會使用目前的點陣色彩或索引來寫入。 不會修改對應至點陣圖中零的框架緩衝區圖元。
點陣圖影像會解譯為 glDrawPixels 函式的影像資料, 其寬度 和 高度 對應至該函式的寬度和高度引數,並將 類型 設定為GL_BITMAP,並將 格式 設定為 GL_COLOR_INDEX。 您使用 glPixelStore 指定的模式會影響點陣圖影像資料的解譯;您使用 glPixelTransfer 指定的模式不會。
如果目前的點陣位置無效, 則會忽略 glBitmap 。 否則,點陣圖影像的左下角位於下列視窗座標處:
xx = rx?
yw = yry?
在這些座標中, (xr 、 yr ) 是點陣位置,而 (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 [僅限傳統型應用程式] |
標頭 |
|
程式庫 |
|
DLL |
|