glRasterPos2dv 函式

指定圖元作業的點陣位置。

語法

void WINAPI glRasterPos2dv(
   const GLdouble *v
);

參數

v

兩個元素陣列的指標，指定目前點陣位置的 x 和 y 座標。

傳回值

此函式不會傳回值。

備註

OpenGL 會在視窗座標中維護 3D 位置。 這個位置稱為點陣位置，會以子圖元精確度維護。 它用來放置圖元和點陣圖寫入作業。 請參閱 glBitmap、 glDrawPixels和 glCopyPixels。

目前的點陣位置包含三個視窗座標， (x、y、z) 、剪輯座標 w 值、眼球座標距離、有效位，以及相關聯的色彩資料和紋理座標。 w座標是裁剪座標，因為w不會投影到視窗座標。 glRasterPos4函式會明確指定物件座標x、y、z和w。 glRasterPos3 函式會明確指定物件座標 x、y 和 z ，而 w 會隱含地設定為一個。 glRasterPos2 函式會使用 x 和 y 的引數值，同時隱含地將 z 和 w 設定為零和一。

glRasterPos所呈現的物件座標會被視為glVertex命令的物件座標。 它們會由目前的模型檢視和投影矩陣轉換，並傳遞至裁剪階段。 如果未擷取頂點，則會投影並縮放至視窗座標，這會成為新的目前點陣位置，並設定GL_CURRENT_RASTER_POSITION_VALID旗標。 如果頂點被擷取，則會清除有效的位，而且目前的點陣位置和相關聯的色彩和紋理座標未定義。

目前的點陣位置也包含一些相關聯的色彩資料和紋理座標。 如果已啟用光源，則以 RGBA 模式或色彩索引模式GL_CURRENT_RASTER_INDEX GL_CURRENT_RASTER_COLOR會設定為光源計算所產生的色彩， (請參閱glLight、glLightModel和glShadeModel) 。 如果停用光源，RGBA 模式中的目前色彩 (、狀態變數GL_CURRENT_COLOR) 或色彩索引 (，則會使用狀態變數GL_CURRENT_INDEX) 來更新目前的點陣色彩。

同樣地，GL_CURRENT_RASTER_TEXTURE_COORDS會根據紋理矩陣和紋理產生函式來更新為GL_CURRENT_TEXTURE_COORDS函式， (請參閱 glTexGen) 。 最後，從眼睛座標系統的原點到頂點的距離，只要由 modelview 矩陣轉換，就會取代GL_CURRENT_RASTER_DISTANCE。

一開始，目前的點陣位置 (0，0，0，1) ，目前的點陣距離為 0，有效的位已設定，相關聯的 RGBA 色彩 (1，1，1，1) ，相關聯的色彩索引為 1，且相關聯的紋理座標 (0、0、0、1) 。 在 RGBA 模式中，GL_CURRENT_RASTER_INDEX一律為 1;在色彩索引模式中，目前的點陣 RGBA 色彩一律會維持其初始值。

注意

點陣位置是由 glRasterPos 和 glBitmap修改。

注意

當點陣位置座標無效時，會忽略以點陣位置為基礎的繪圖命令 (也就是說，它們不會產生 OpenGL 狀態變更) 。

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

glGet 與引數GL_CURRENT_RASTER_POSITION
具有引數的glGet GL_CURRENT_RASTER_POSITION_VALID
glGet with argument GL_CURRENT_RASTER_DISTANCE
glGet 與引數GL_CURRENT_RASTER_COLOR
glGet 與引數GL_CURRENT_RASTER_INDEX
glGet with argument GL_CURRENT_RASTER_TEXTURE_COORDS

規格需求

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

另請參閱

glBegin

glBitmap

glCopyPixels

glDrawPixels

glEnd

glLight

glLightModel

glShadeModel

glTexCoord

glTexGen

glVertex