轉自：http://blog.sina.com.cn/s/blog_5f0d72800100iajl.html
GLUT函數說明
一、初始化
void glutInit(int* argc,char** argv)這個函數從 main 函數獲取其兩個參數。
1 void glutInitWindowSize(int width,int height);
2 void glutInitWindowPosition(int x,int y);
void glutInitDisplayMode(unsigned int mode);- 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平臺上，不被支持。
二、事件處理（Event Processing）
void glutMainLoop(void)讓 glut 程序進入事件循環。在一個glut程序中最多隻能調用一次。一旦調用，會直到程序結束才返回。
三、窗口管理（Window Management）
int glutCreateWindow(char* name);返回值是生成窗口的標記符，可用函數glutGetWindow()加以引用。
void glutDestroyWindow(int win);
int glutCreateSubWindow(int win,int x,int y,int width,int height);width,height是子窗口的寬和高。
void glutSetWindow(int win);
int glutGetWindow(void);
void glutDestroyWindow(int win);銷燬以 win 標記的窗口。
void glutPostRedisplay(void);
void glutSwapBuffers(void);而使用雙緩存是爲了把完整圖畫一次性顯示在窗口上，或者是爲了實現動畫。
void glutPositionWindow(int x,int y);
void glutReshapeWindow(int width,int height);width,height是當前窗口新的寬度和高度值，當然只能是正值。
void glutFullscreen(void);
void glutPopWindow(void);
void glutPushWindow(void);
void glutShowWindow(void);
void glutHideWindow(void);
void glutIconifyWindow(void);這三個函數作用是改變當前窗口的顯示狀態。
glutShowWindow讓當前窗口可視（這時它還是可能被其它窗口擋住）。
glutHideWindow讓當前窗口成爲不可視狀態。
glutIconifyWindow讓當前窗口成爲一個圖標，也即是最小化。
void glutSetWindowTitle(char* name);
void glutSetIconTitle(char* name);
void glutSetCursor(int cursor);
cursor可選值有許多：如GLUT_CURSOR_RIGHT_ARROW指向右邊的光標，GLUT_CURSOR_LEFT_ARROW指向左邊的光標，GLUT_CURSOR_INFO成爲手狀。
GLUT_CURSOR_DESTROY呈叉狀，GLUT_CURSOR_HELP呈現問號的形狀。等等。
四、窗口的覆蓋管理
void glutEstablishOverlay(void);
glutLayerGet(GLUT_OVERLAY_POSSIBLE); // 可用以設置對於當前窗口，是否允許產生由初始化顯示模式函數規定其模式的覆蓋圖層。
void glutUserLayer(GLenum layer);
void glutRemoveLayer(void);
void glutPostOverlayRedisplay(void);
void glutShowOverlay(void);
void glutHideOverlay(void);
五、菜單管理
int glutCreateMenu(void (*func)(int value))這個函數創建一個新的彈出式菜單,並返回一個唯一的標識次菜單的整型標識符,並將新建的彈出菜單與func函數關聯在一起,這樣,當選擇此菜單中的一個菜單條目時,調用回調函數func.
void glutSetMenu(int menu);
int glutGetMenu(void);
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 glutDetachMenu(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爲鼠標的按鍵,爲以下定義的常量：
| GLUT_LEFT_BUTTON | 鼠標左鍵 |
| GLUT_MIDDLE_BUTTON | 鼠標中鍵 |
| GLUT_RIGHT_BUTTON | 鼠標右鍵 |
state爲鼠標按鍵的動作,爲以下定義的常量：
| GLUT_UP | 鼠標釋放 |
| GLUT_DOWN | 鼠標按下 |
x,y爲鼠標按下式,光標相對於窗口左上角的位置
void glutMotionFunc(void (*func)(int x, int y));
void glutPassiveMotionFunc(void (*func)(int x, int y));Func爲註冊的鼠標移動函數
x,y爲鼠標按下式,光標相對於窗口左上角的位置
當鼠標在窗口中按下並移動時調用glutMotionFunc註冊的回調函數
當鼠標在窗口中移動時調用glutPassiveMotionFunc註冊的回調函數
void glutVisibilityFunc(void (*func) (int state) );Func爲指定的可視回調函數
state表示窗口的可視性,爲以下常量:
| GLUT_NOT_VISIBLE | 窗口完全不可見 |
| GLUT_VISIBLE | 窗口可見或部分可見 |
這個函數設置當前窗口的可視回調函數,當窗口的可視性改變時,該窗口的可視回調函數被調用.只要窗口中的任何一個像素是可見的,或者他的任意一個子窗口中任意一個像素是可見的,GLUT則認爲窗口是可見的.
void glutEntryFunc(void (*func) (int state));Func爲註冊的鼠標進出回調函數
state爲鼠標的進出狀態,爲以下常量之一:
| GLUT_LEFT | 鼠標離開窗口 |
| GLUT_RIGHT | 鼠標進入窗口 |
當窗口取得焦點或失去焦點時調用這個函數,當鼠標進入窗口區域並點擊時,state爲GLUT_RIGHT,當鼠標離開窗口區域點擊其他窗口時,state爲GLUT_LEFT.
void glutSpecialFunc(void (*func) (int key, int x, int y))Func爲註冊的特定鍵的回調函數
key爲按下的特定鍵,爲以下定義的常量：
| 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鍵 |
x,y爲當按下鍵時鼠標的座標,相對於窗口左上角,以像素爲單位
注意:ESC,回車和delete鍵由ASCII碼產生.
void glutMenuStatusFunc(void (*func) (int status, int x, int y));func是註冊的菜單狀態回調函數
status是當前是否使用菜單,爲以下定義的常量：
| GLUT_MENU_IN_USE | 菜單正在使用 |
| GLUT_MENU_NOT_IN_USE | 菜單未被使用 |
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表示當前是否使用菜單,爲以下定義的常量：
| GLUT_MENU_IN_USE | 菜單正在使用 |
| GLUT_MENU_NOT_IN_USE | 菜單未被使用 |
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);msecs是等待的時間
Func是註冊的函數
value是指定的一個數值,用來傳遞到回調函數Func中
這個函數註冊了一個回調函數,當指定的毫秒數到達後,這個函數就調用註冊的函數,value參數用來向這個註冊的函數中傳遞參數。
七、色彩管理(未完成)
glutSetColor
glutGetColor
glutCopyColormap八、狀態檢索
int glutGet(GLenum state);state爲指定要檢索的狀態類型,爲以下常量：
state常量 描述
GLUT_WINDOW_X 當前窗口的x座標,以像素爲單位
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)的時間間隔,單位爲毫秒
返回值根據查詢的內容返回相應的值,無效的狀態名返回-1.
int glutLayerGet(GLenum info);Info表示查詢的重疊層狀態常量：
| GLUT_OVERLAY_POSSIBLE | 在給定的初始顯示模式下,能否爲當前窗口創建重疊層.如果能,返回1;如果不能,返回0 |
| GLUT_LAYER_IN_USE | 返回當前的使用層,爲GLUT_NORMAL或GLUT_OVERLAY |
| GLUT_HAS_OVERLAY | 判斷當前窗口是否創建了重疊層 |
| GLUT_NORMAL_DAMAGED | 如果當前窗口的圖像層在上一次顯示回調函數調用後已經破壞,則返回TRUE |
| GLUT_OVERLAY_DAMAGED | 如果當前窗口的重疊層在上一次顯示回調函數調用後已經破壞,則返回TRUE |
int glutDeviceGet(GLenum info);info爲要檢索的設備信息的名字,爲以下常量：
| GLUT_HAS_KEYBOARD | 如果鍵盤可用,返回非0值,否則,返回0 |
| GLUT_HAS_MOUSE | 如果鼠標可用,返回非0值,否則,返回0 |
| GLUT_NUM_MOUSE_BUTTONS | 返回鼠標支持的按鍵數,如果鼠標不可用,返回0 |
返回值0表示檢索的設備不存在,非0表示設備可用
int glutGetModifiers(void);返回值爲以下定義的常量：
| GLUT_ACTIVE_SHIFT | 當按下shift鍵時 |
| GLUT_ACTIVE_CTRL | 當按下ctrl鍵時 |
| GLUT_ACTIVE_ALT | 當按下alt鍵時 |
int glutExtensionSupported(char* extension);extension是指定要測試的OpenGL擴展的名稱
如果給定擴展獲得支持,函數返回非0,否則返回0。
九、實體繪製
以下所有函數中，radius表示球體的半徑，slices表示球體圍繞z軸分割的數目（經線），stacks表示球體沿着z軸分割的數目（緯線）。
繪製中心在模型座標原點,半徑爲radius的球體,球體圍繞z軸分割slices次,球體沿着z軸分割stacks次
void glutWireSphere(GLdouble radius, GLint slices, GLint stacks); 線框球
void glutSolidSphere(GLdouble radius, GLint slices, GLint stacks); 實心球
void glutWireCube(GLdouble size); 線框立方體
void glutSolidCube(GLdouble size); 實心立方體
void glutWireTorus(GLdouble innerRadius, GLdouble outerRadius, GLint nsides, GLint rings); 線框圓環
void glutSolidTorus(GLdouble innerRadius, GLdouble outerRadius, GLint nsides, GLint rings); 實心圓環
void glutWireIcosahedron(void); 線框20面體
void glutSolidIcosahedron(void); 實心20面體
void glutWireOctahedron(void); 線框8面體
void glutSolidOctahedron(void); 實心8面體
void glutWireTetrahedron(void); 線框4面體
void glutSolidTetrahedron(void); 實心4面體
void glutWireDodecahedron(GLdouble radius); 線框12面體
void glutSolidDodecahedron(GLdouble radius); 實心12面體
void glutWireCone(GLdouble radius, GLdouble height, GLint slices, GLint stacks); 線框圓錐體
void glutSolidCone(GLdouble radius, GLdouble height, GLint slices, GLint stacks); 實心圓錐體
void glutWireTeapot(GLdouble size); 線框茶壺
void glutSolidTeapot(GLdouble size); 實心茶壺