轉自：http://blog.sina.com.cn/s/blog_5f0d72800100iajl.html

GLUT函式說明

一、初始化

void glutInit(int* argc,char** argv)

這個函式用來初始化GLUT庫。對應 main 函式的形式應是： int main(int argc,char* argv[]);

這個函式從 main 函式獲取其兩個引數。

1 void glutInitWindowSize(int width,int height);
2 void glutInitWindowPosition(int x,int y);

設定glut程式要產生的視窗的大小和位置（左上角）。以畫素為單位。

void glutInitDisplayMode(unsigned int mode);
 

設定圖形顯示模式。引數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);

產生一個頂層的視窗。name 作為視窗的名字，也就是視窗標題欄顯示的內容。

返回值是生成視窗的標記符，可用函式glutGetWindow()加以引用。

void glutDestroyWindow(int win);

int glutCreateSubWindow(int win,int x,int y,int width,int height);

建立一個子視窗。win是其父視窗的標記符。x,y是相對父視窗的位移，以畫素表示。

width,height是子視窗的寬和高。

void glutSetWindow(int win);
int  glutGetWindow(void);

功能分別是：設定標記符為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 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);

對當前視窗建立覆蓋圖層。該覆蓋圖的模式由初始化顯示模式函式glutDisplayMode()決定。

glutLayerGet(GLUT_OVERLAY_POSSIBLE);  // 可用以設定對於當前視窗，是否允許產生由初始化顯示模式函式規定其模式的覆蓋圖層。
void glutUserLayer(GLenum layer);

列舉量layer可選值為：GLUT_NORMAL,GLUT_OVERLAY.分別選取正常位平面或覆蓋平面。

void glutRemoveLayer(void);

除去覆蓋圖。當沒有覆蓋圖層時，呼叫這條語句也是安全的，這時系統不做任何事。

void glutPostOverlayRedisplay(void);

標記該覆蓋圖層為需要重新顯示的狀態。

void glutShowOverlay(void);
void glutHideOverlay(void);

顯示當前視窗的覆蓋圖層；隱藏覆蓋圖層。這兩條語句即時執行。注意一下，只有視窗可視時，使用glutShowOverlay才能使其覆蓋圖層可視。當視窗被其他視窗遮擋時，其覆蓋圖層也被遮擋從而不可視。

五、選單管理

int glutCreateMenu(void (*func)(int value))

當點選選單時,呼叫回撥函式func，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);

註冊一個回撥函式,當指定時間值到達後,由GLUT呼叫註冊的函式一次

msecs是等待的時間

Func是註冊的函式

value是指定的一個數值,用來傳遞到回撥函式Func中

這個函式註冊了一個回撥函式,當指定的毫秒數到達後,這個函式就呼叫註冊的函式,value引數用來向這個註冊的函式中傳遞引數。

七、色彩管理(未完成)

glutSetColor

glutGetColor

glutCopyColormap

八、狀態檢索

int glutGet(GLenum state);

檢索指定的GLUT狀態

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);

判定是否支援特定的OpenGL擴充套件。
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); 實心茶壺