原文出處:OpenGL 中常用的 GLUT 函數庫
GLUT函數說明
一、初始化
void glutInit(int* argc,char** argv)
這個函數用來初始化GLUT庫。對應 main 函數的形式應是: int main(int argc,char* argv[]);
這個函數從 main 函數獲取其兩個參數。
void glutInitWindowSize(int width,int height);
void glutInitWindowPosition(int x,int y);
- GLUT_RGBA:當未指明GLUT-RGBA或GLUT-INDEX時,是默認使用的模式。表明欲建立RGBA模式的窗口。
- GLUT_RGB:與GLUT-RGBA作用相同。
- GLUT_INDEX:指明爲顏色索引模式。
- GLUT_SINGLE:只使用單緩存
- GLUT_DOUBLE:使用雙緩存。以避免把計算機作圖的過程都表現出來,或者爲了平滑地實現動畫。
- GLUT_ACCUM:讓窗口使用累加的緩存。
- GLUT_ALPHA:讓顏色緩衝區使用alpha組件。
- GLUT_DEPTH:使用深度緩存。
- GLUT_STENCIL:使用模板緩存。
- GLUT_MULTISAMPLE:讓窗口支持多例程。
- GLUT_STEREO:使窗口支持立體。
- GLUT_LUMINACE:luminance是亮度的意思。但是很遺憾,在多數OpenGL平臺上,不被支持。
void glutPushWindow(void);
void glutHideWindow(void);
void glutIconifyWindow(void);
glutHideWindow讓當前窗口成爲不可視狀態。
glutIconifyWindow讓當前窗口成爲一個圖標,也即是最小化。
void glutSetWindowTitle(char* name);
void glutSetIconTitle(char* name);
GLUT_CURSOR_DESTROY呈叉狀,GLUT_CURSOR_HELP呈現問號的形狀。等等。
void glutHideOverlay(void);
int glutGetMenu(void);
void glutDetachMenu(int button);
GLUT_LEFT_BUTTON | 鼠標左鍵 |
GLUT_MIDDLE_BUTTON | 鼠標中鍵 |
GLUT_RIGHT_BUTTON | 鼠標右鍵 |
GLUT_UP | 鼠標釋放 |
GLUT_DOWN | 鼠標按下 |
當鼠標在窗口中按下並移動時調用glutMotionFunc註冊的回調函數
當鼠標在窗口中移動時調用glutPassiveMotionFunc註冊的回調函數
GLUT_NOT_VISIBLE | 窗口完全不可見 |
GLUT_VISIBLE | 窗口可見或部分可見 |
GLUT_LEFT | 鼠標離開窗口 |
GLUT_RIGHT | 鼠標進入窗口 |
key常量 | 描述 |
GLUT_KEY_F1 | F1功能鍵 |
GLUT_KEY_F2 | F2功能鍵 |
GLUT_KEY_F3 | F3功能鍵 |
GLUT_KEY_F4 | F4功能鍵 |
GLUT_KEY_F5 | F5功能鍵 |
GLUT_KEY_F6 | F6功能鍵 |
GLUT_KEY_F7 | F7功能鍵 |
GLUT_KEY_F8 | F8功能鍵 |
GLUT_KEY_F9 | F9功能鍵 |
GLUT_KEY_F10 | F10功能鍵 |
GLUT_KEY_F11 | F11功能鍵 |
GLUT_KEY_F12 | F12功能鍵 |
GLUT_KEY_LEFT | 左方向鍵 |
GLUT_KEY_UP | 上方向鍵 |
GLUT_KEY_RIGHT | 右方向鍵 |
GLUT_KEY_DOWN | 下方向鍵 |
GLUT_KEY_PAGE_UP | PageUp鍵 |
GLUT_KEY_PAGE_DOWN | PageDown鍵 |
GLUT_KEY_HOME | Home鍵 |
GLUT_KEY_END | End鍵 |
GLUT_KEY_INSERT | Insert鍵 |
GLUT_MENU_IN_USE | 菜單正在使用 |
GLUT_MENU_NOT_IN_USE | 菜單未被使用 |
GLUT_MENU_IN_USE | 菜單正在使用 |
GLUT_MENU_NOT_IN_USE | 菜單未被使用 |
GLUT_WINDOW_Y 當前窗口的y座標,以像素爲單位
GLUT_WINDOW_WIDTH 當其窗口的寬度,以像素爲單位
GLUT_WINDOW_HEIGHT 當前窗口的高度,以像素爲單位
GLUT_WINDOW_BUFFER_SIZE 當前窗口中,顏色分量佔用的位數,即用多少bit表示顏色分量
GLUT_WINDOW_STENCIL_SIZE 當前窗口中,蒙板分量佔用的位數,即用多少bit表示蒙板分量
GLUT_WINDOW_DEPTH_SIZE 當前窗口中,深度分量佔用的位數,即用多少bit表示深度分量
GLUT_WINDOW_RED_SIZE 當前窗口中,紅色分量佔用的位數,即用多少bit表示紅色分量
GLUT_WINDOW_GREEN_SIZE 當前窗口中,綠色分量佔用的位數,即用多少bit表示綠色分量
GLUT_WINDOW_BLUE_SIZE 當前窗口中,藍色分量佔用的位數,即用多少bit表示藍色分量
GLUT_WINDOW_ALPHA_SIZE 當前窗口中,alpha色分量佔用的位數,即用多少bit表示alpha色分量
GLUT_WINDOW_ACCUM_RED_SIZE 當前窗口累積緩存中,紅色分量佔用的位數,即用多少bit表示紅色分量
GLUT_WINDOW_ACCUM_GREEN_SIZE 當前窗口累積緩存中,綠色分量佔用的位數,即用多少bit表示綠色分量
GLUT_WINDOW_ACCUM_BLUE_SIZE 當前窗口累積緩存中,藍色分量佔用的位數,即用多少bit表示藍色分量
GLUT_WINDOW_ACCUM_ALPHA_SIZE 當前窗口累積緩存中,alpha色分量佔用的位數,即用多少bit表示alpha色分量
GLUT_WINDOW_DOUBLEBUFFER 如果窗口式雙緩存模式,返回1,否則返回0
GLUT_WINDOW_RGBA 如果窗口是RGBA模式,返回1,否則返回0
GLUT_WINDOW_PARENT 查詢當前窗口的父窗口個數,如果爲頂層窗口返回0
GLUT_WINDOW_NUM_CHILDREN 查詢當前窗口的子窗口個數
GLUT_WINDOW_NUM_SAMPLES 查詢多重採樣的採樣點個數
GLUT_WINDOW_STEREO 查詢是否使用立體模式,是則返回1,否則返回0
GLUT_WINDOW_CURSOR 返回光標的整數標示
GLUT_SCREEN_HEIGHT 屏幕的高度,以像素爲單位
GLUT_SCREEN_WIDTH 屏幕的寬度,以像素爲單位
GLUT_SCREEN_WIDTH_MM 屏幕的寬度,以毫米爲單位
GLUT_SCREEN_HEIGHT_MM 屏幕的高度,以毫米爲單位
GLUT_MENU_NUM_ITEMS 查詢當前菜單包含的菜單項的個數
GLUT_DISPLAY_MODE_POSSIBLE 查詢窗口系統是否支持當前的顯示模式,1表示支持,0表示不支持
GLUT_INIT_DISPLAY_MODE 初始窗口的顯示模式
GLUT_INIT_WINDOW_X 初始窗口的x座標
GLUT_INIT_WINDOW_Y 初始窗口的y座標
GLUT_INIT_WINDOW_WIDTH 初始窗口的寬度
GLUT_INIT_WINDOW_HEIGHT 初始窗口的高度
GLUT_ELAPSED_TIME 返回兩次調用glutGet(GLUT_ELAPSED_TIME)的時間間隔,單位爲毫秒
GLUT_OVERLAY_POSSIBLE | 在給定的初始顯示模式下,能否爲當前窗口創建重疊層.如果能,返回1;如果不能,返回0 |
GLUT_LAYER_IN_USE | 返回當前的使用層,爲GLUT_NORMAL或GLUT_OVERLAY |
GLUT_HAS_OVERLAY | 判斷當前窗口是否創建了重疊層 |
GLUT_NORMAL_DAMAGED | 如果當前窗口的圖像層在上一次顯示回調函數調用後已經破壞,則返回TRUE |
GLUT_OVERLAY_DAMAGED | 如果當前窗口的重疊層在上一次顯示回調函數調用後已經破壞,則返回TRUE |
info爲要檢索的設備信息的名字,爲以下常量:
GLUT_HAS_KEYBOARD | 如果鍵盤可用,返回非0值,否則,返回0 |
GLUT_HAS_MOUSE | 如果鼠標可用,返回非0值,否則,返回0 |
GLUT_NUM_MOUSE_BUTTONS | 返回鼠標支持的按鍵數,如果鼠標不可用,返回0 |
返回組合功能鍵的狀態
返回值爲以下定義的常量:
GLUT_ACTIVE_SHIFT | 當按下shift鍵時 |
GLUT_ACTIVE_CTRL | 當按下ctrl鍵時 |
GLUT_ACTIVE_ALT | 當按下alt鍵時 |
extension是指定要測試的OpenGL擴展的名稱
如果給定擴展獲得支持,函數返回非0,否則返回0。
void glutSolidSphere(GLdouble radius, GLint slices, GLint stacks); 實心球
void glutSolidCube(GLdouble size); 實心立方體
void glutSolidTorus(GLdouble innerRadius, GLdouble outerRadius, GLint nsides, GLint rings); 實心圓環
void glutSolidIcosahedron(void); 實心20面體
void glutSolidOctahedron(void); 實心8面體
void glutSolidTetrahedron(void); 實心4面體
void glutSolidDodecahedron(GLdouble radius); 實心12面體
void glutSolidCone(GLdouble radius, GLdouble height, GLint slices, GLint stacks); 實心圓錐體
void glutSolidTeapot(GLdouble size); 實心茶壺
設置glut程序要產生的窗口的大小和位置(左上角)。以像素爲單位。
void glutInitDisplayMode(unsigned int mode);
設置圖形顯示模式。參數mode的可選值爲:
二、事件處理(Event Processing)
void glutMainLoop(void)
讓 glut 程序進入事件循環。在一個glut程序中最多隻能調用一次。一旦調用,會直到程序結束才返回。
三、窗口管理(Window Management)
int glutCreateWindow(char* name);
產生一個頂層的窗口。name 作爲窗口的名字,也就是窗口標題欄顯示的內容。
返回值是生成窗口的標記符,可用函數glutGetWindow()加以引用。
int glutCreateSubWindow(int win,int x,int y,int width,int height);
創建一個子窗口。win是其父窗口的標記符。x,y是相對父窗口的位移,以像素表示。
width,height是子窗口的寬和高。
void glutSetWindow(int win);
功能分別是:設置標記符爲win的窗口爲當前窗口;返回當前窗口的標記符。
void glutDestroyWindow(int win);
銷燬以 win 標記的窗口。
void glutPostRedisplay(void);
將當前窗口打上標記,標記其需要再次顯示。
void glutSwapBuffers(void);
當窗口模式爲雙緩存時,此函數的功能就是把後臺緩存的內容交換到前臺顯示。當然,只有單緩存時,使用它的功能跟用glFlush()一樣。
而使用雙緩存是爲了把完整圖畫一次性顯示在窗口上,或者是爲了實現動畫。
void glutPositionWindow(int x,int y);
改變當前窗口的位置:當前窗口是頂層窗口時,x,y是相對於屏幕的的位移;當前窗口若是子窗口時,x,y是相對其父窗口原點的位移。
void glutReshapeWindow(int width,int height);
改變當前窗口的大小。
width,height是當前窗口新的寬度和高度值,當然只能是正值。
void glutFullscreen(void);
讓當前窗口全屏顯示。當前窗口是頂層窗口時纔有效。
void glutPopWindow(void);
對頂層窗口和子窗口均有效。改變當前窗口在棧中相對於其它窗口的次序。
void glutShowWindow(void);
這三個函數作用是改變當前窗口的顯示狀態。
glutShowWindow讓當前窗口可視(這時它還是可能被其它窗口擋住)。
設置當前窗口(必須是頂層窗口)的標題和圖標化時的標題。
void glutSetCursor(int cursor);
設置當前窗口的光標樣式。
cursor可選值有許多:如GLUT_CURSOR_RIGHT_ARROW指向右邊的光標,GLUT_CURSOR_LEFT_ARROW指向左邊的光標,GLUT_CURSOR_INFO成爲手狀。
四、窗口的覆蓋管理
void glutEstablishOverlay(void);
對當前窗口創建覆蓋圖層。該覆蓋圖的模式由初始化顯示模式函數glutDisplayMode()決定。
glutLayerGet(GLUT_OVERLAY_POSSIBLE)可用以設置對於當前窗口,是否允許產生由初始化顯示模式函數規定其模式的覆蓋圖層。
void glutUserLayer(GLenum layer);
枚舉量layer可選值爲:GLUT_NORMAL,GLUT_OVERLAY.分別選取正常位平面或覆蓋平面。
void glutRemoveLayer(void);
除去覆蓋圖。當沒有覆蓋圖層時,調用這條語句也是安全的,這時系統不做任何事。
void glutPostOverlayRedisplay(void);
標記該覆蓋圖層爲需要重新顯示的狀態。
void glutShowOverlay(void);
顯示當前窗口的覆蓋圖層;隱藏覆蓋圖層。這兩條語句即時執行。注意一下,只有窗口可視時,使用glutShowOverlay才能使其覆蓋圖層可視。當窗口被其他窗口遮擋時,其覆蓋圖層也被遮擋從而不可視。
五、菜單管理
int glutCreateMenu(void (*func)(int value))
當點擊菜單時,調用回調函數func,value爲傳遞給回調函數的數值,它由所選擇的菜單條目對應的整數值所決定。
這個函數創建一個新的彈出式菜單,並返回一個唯一的標識次菜單的整型標識符,並將新建的彈出菜單與func函數關聯在一起,這樣,當選擇此菜單中的一個菜單條目時,調用回調函數func.
void glutSetMenu(int menu);
設置當前菜單;獲取當前菜單的標識符
void glutDestroyMenu(int menu);
刪除指定的菜單
void glutAddMenuEntry(char* name, int value);
添加一個菜單條目
void glutAddSubMenu(char* name, int menu);
在當前菜單的底部增加一個子菜單的觸發條目
void glutChangeToMenuEntry(int entry, char* name, int value);
更改當前菜單中指定菜單項
void glutChangeToSubMenu(int entry, char* name, int menu);
將指定的當前菜單中菜單項變爲子菜單觸發條目
void glutRemoveMenuItem(int entry);
刪除指定的菜單項
void glutAttachMenu(int button);
把當前窗口的一個鼠標按鍵與當前菜單關聯起來;解除鼠標按鍵與彈出式菜單的關聯關係。
六、註冊回調
void glutDisplayFunc(void (*func)(void) );
爲當前窗口設置顯示回調函數
void glutOverlayDisplayFunc(void (*func)(void) );
註冊當前窗口的重疊層的顯示回調函數
void glutReshapeFunc(void (*Func)(int width, int height) );
指定當窗口的大小改變時調用的函數
void glutKeyboardFunc(void (*func) (unsigned char key, int x, int y) );
註冊當前窗口的鍵盤迴調函數
void glutMouseFunc(void (*func) (int button, int state, int x, int y));
註冊當前窗口的鼠標回調函數
func爲註冊的鼠標回調函數,這個函數完成鼠標事件的處理
button爲鼠標的按鍵,爲以下定義的常量:
state爲鼠標按鍵的動作,爲以下定義的常量:
x,y爲鼠標按下式,光標相對於窗口左上角的位置
void glutMotionFunc(void (*func)(int x, int y));
設置移動回調函數;設置當前鼠標移動函數
Func爲註冊的鼠標移動函數
x,y爲鼠標按下式,光標相對於窗口左上角的位置
void glutVisibilityFunc(void (*func) (int state) );
設置當前窗口的可視回調函數
Func爲指定的可視回調函數
state表示窗口的可視性,爲以下常量:
這個函數設置當前窗口的可視回調函數,當窗口的可視性改變時,該窗口的可視回調函數被調用.只要窗口中的任何一個像素是可見的,或者他的任意一個子窗口中任意一個像素是可見的,GLUT則認爲窗口是可見的.
void glutEntryFunc(void (*func) (int state));
設置鼠標的進出窗口的回調函數
Func爲註冊的鼠標進出回調函數
state爲鼠標的進出狀態,爲以下常量之一:
當窗口取得焦點或失去焦點時調用這個函數,當鼠標進入窗口區域並點擊時,state爲GLUT_RIGHT,當鼠標離開窗口區域點擊其他窗口時,state爲GLUT_LEFT.
void glutSpecialFunc(void (*func) (int key, int x, int y))
設置當前窗口的特定鍵的回調函數
Func爲註冊的特定鍵的回調函數
key爲按下的特定鍵,爲以下定義的常量:
x,y爲當按下鍵時鼠標的座標,相對於窗口左上角,以像素爲單位
void glutMenuStatusFunc(void (*func) (int status, int x, int y));
設置菜單狀態回調函數
func是註冊的菜單狀態回調函數
status是當前是否使用菜單,爲以下定義的常量:
x,y是鼠標按下式,光標相對於窗口左上角的位置
這個函數時glut程序判定是否正在使用菜單,當彈出菜單時,調用註冊的菜單狀態回調函數,同時status設置爲常量GLUT_MENU_IN_USE, 當菜單使用完畢時,也調用菜單狀態回調函數,此時status變量變爲GLUT_MENU_NOT_IN_USE.從已彈出的菜單中再彈出的菜單不產生菜單狀態回調過程.每個glut程序只有一個菜單狀態回調函數.
glutSpaceballRotateFunc
glutSpaceballButtonFunc
glutButtonBoxFunc
glutDialsFunc
glutTabletMotionFunc
glutTabletButtonFunc
void glutMenuStatusFunc(void (*func) (int status, int x, int y));
設置菜單狀態回調函數
func爲註冊的菜單狀態回調函數
status表示當前是否使用菜單,爲以下定義的常量:
x,y表示鼠標按下式,光標相對於窗口左上角的位置
這個函數時glut程序判定是否正在使用菜單,當彈出菜單時,調用註冊的菜單狀態回調函數,同時status設置爲常量GLUT_MENU_IN_USE, 當菜單使用完畢時,也調用菜單狀態回調函數,此時status變量變爲GLUT_MENU_NOT_IN_USE.從已彈出的菜單中再彈出的菜單不產生菜單狀態回調過程.每個glut程序只有一個菜單狀態回調函數.
void glutIdleFunc(void (*func) (void));
設置空閒回調函數
func表示當系統空閒時調用的函數,它的形式爲void func(void)
void glutTimerFunc(unsigned int msecs, void (*Func)(int value), int value);
註冊一個回調函數,當指定時間值到達後,由GLUT調用註冊的函數一次
msecs是等待的時間
Func是註冊的函數
value是指定的一個數值,用來傳遞到回調函數Func中
這個函數註冊了一個回調函數,當指定的毫秒數到達後,這個函數就調用註冊的函數,value參數用來向這個註冊的函數中傳遞參數。
七、色彩管理(未完成)
glutSetColor
glutGetColor
glutCopyColormap
八、狀態檢索
int glutGet(GLenum state);
檢索指定的GLUT狀態
state爲指定要檢索的狀態類型,爲以下常量:
state常量 描述
返回值根據查詢的內容返回相應的值,無效的狀態名返回-1.
int glutLayerGet(GLenum info);
查詢屬於當前窗口的重疊層的狀態
Info表示查詢的重疊層狀態常量:
int
glutDeviceGet(GLenum info);
返回值0表示檢索的設備不存在,非0表示設備可用
int
glutExtensionSupported(char* extension);
九、實體繪製
以下所有函數中,radius表示球體的半徑,slices表示球體圍繞z軸分割的數目(經線),stacks表示球體沿着z軸分割的數目(緯線)。
繪製中心在模型座標原點,半徑爲radius的球體,球體圍繞z軸分割slices次,球體沿着z軸分割stacks次
void
glutWireSphere(GLdouble radius, GLint slices, GLint stacks); 線框球
void
glutWireCube(GLdouble size); 線框立方體
void
glutWireTorus(GLdouble innerRadius, GLdouble outerRadius, GLint nsides, GLint rings); 線框圓環
void
glutWireIcosahedron(void); 線框20面體
void
glutWireOctahedron(void); 線框8面體
void
glutWireTetrahedron(void); 線框4面體
void
glutWireDodecahedron(GLdouble radius); 線框12面體
void
glutWireCone(GLdouble radius, GLdouble height, GLint slices, GLint stacks); 線框圓錐體
void
glutWireTeapot(GLdouble size); 線框茶壺