JOGL基本模板

本章介紹了編寫JOGL基本模板的概念。

重要的接口和類

爲了使程序能夠使用JOGL圖形API，需要實現GLEventListener接口。

GLEventListener接口

可以在javax.media.opengl包找到GLEventListener接口。

Interface: GLEventListener

Package: javax.media.opengl

下表給出了各種方法和GLEventListener接口的詳細描述：

Sr. No.

方法和說明

1

Void display(GLAutoDrawable drawable)

這就是所謂GLAutoDrawable接口的對象，由客戶機發起OpenGL渲染。也就是說，該方法包含用於繪製使用OpenGL API的圖形元素的邏輯。

2

Void dispose(GLAutoDrawable drawable)

這種方法的信號監聽執行每各GLContext，所有的OpenGL釋放資源，如內存緩衝區和GLSL程序。

3

Void init(GLAutoDrawble drawble)

這就是所謂GLAutoDrawable接口OpenGL上下文被初始化之後的對象。

4

Void reshape(GLAutoDrawble drawble,in tx,int y,int width ,int height)

第一重畫過程中它被稱爲GLAutoDrawable接口的對象的組件大小後。它也被稱爲每當窗口上的部件的位置變化。

GLEventListener所有的方法都需要GLAutoDrawable接口作爲參數的對象。

GLAutoDrawable 接口

這個接口提供一個基於事件機制（GLEventListener），用於執行OpenGL渲染。 GLAutoDrawable自動創建一個與GLAutoDrawable爲對象的生命週期相關聯的一個主要呈現上下文。

Interface: GLAutoDrawble

Package: javax.media.opengl

Sr. No.

方法和說明

1

GL getGL()

此方法返回所使用的GLAutoDrawable接口的當前對象的GL管道對象。

2

Void addGLEventListener(GLEventListener Listener)

這種方法增加了給定偵聽器到當前繪製隊列的末尾。

3

Void addGLEventListener(int index,GLEventListener listener)

這種方法增加了給定偵聽器這個隊列中繪製的給定索引處。

4

Void destroy()

這種方法會破壞GLAutoDrawable接口名爲此對象，包括GLContext相關聯的所有資源。

注：有在這個包的其他方法。只有很少的關於模板的重要方法是在此界面中進行討論。

GLCanvas 類

GLCanvas 和 GLJpanel 是JOGL GUI兩大類實現 GLAutoDrawable 接口，這讓他們可以用作拉絲表面的OpenGL命令。

GLCanvas是一個重量級AWT組件，它提供了OpenGL的渲染支持。這是一AWTAutoGLDrawable接口的主執行。它還是java.awt.Canvas繼承類。因爲它是一個重量級的組成部分，在某些情況下，GLJCanvas可能無法與Swing組件正確地結合起來。因此，必須謹慎使用，同時它與Swing共用。每當面臨GLJCanvas問題，那麼必須使用GLJPanel類。

GLCanvas類的分層圖可以如下所示：

• GLEventistener接口工作以及GLCanvas類，它響應變化GLCanvas類並由它們製成要求的圖紙。

• 每當GLCanvas的類被實例化，調用GLEventListener的init()方法。可以覆蓋此方法來初始化OpenGL的狀態。

• 每當GLCanvas的初始繪製（實例化），或調整大小，則執行GLEventListener的reshape()方法。它用來初始化OpenGL的視口和投影矩陣。它也被調用被改變來組件的位置。

• GLEventListener()方法顯示包含渲染3D場景的代碼。它被調用時調用GLCanvas的display()方法。

class: GLCanvas

package: javax.media.opengl.awt

Contructor

GLCanvas()

它與OpenGL功能的默認設置創建一個新的GLCanvas組成部分，使用默認的OpenGL功能選擇機制，在默認的屏幕設備上。

GLCanvas(GLCapabilitiesImmutable)

它創建了一個新的GLCanvas成分與所請求的一套OpenGL的功能，使用默認的OpenGL功能選擇機制，在默認的屏幕設備上。

Sr. No.

方法及描述

1

Void addGLEventListener(GLEventListener listener)

它增加了給定偵聽器來繪製這個隊列的末尾

2

Void addGLEventListener(int indexGLEventListener listener)

它增加了給定偵聽器這個隊列中繪製的給定索引處。

要實例化GLCanvas類，需要GLCapabilitiesImmutable接口，它指定一個不可變的集合的OpenGL性能的目的。

來獲得 CapabilitiesImmutable 接口的對象的一個方式是實例 GLCapabilities 類，它實現接口。 GLCapabilities 類的實例可以用來服務。

GLCapabilities 類

此類指定一組的OpenGL性能。它需要GLCapabilities對象作爲參數。該GLCapabilities類描述渲染上下文必須支持所期望的功能，例如OpenGL的輪廓。

class: GLCapabilities

package: javax.media.opengl

Constructor

GLCapabilities(GLProfile glprofile)

創建一個GLCapabilities對象。

要實例化GLCanvas類，需要GLCapabilitiesImmutable接口，它指定一個不可變的集合的OpenGL性能的目的。

獲得CapabilitiesImmutable接口的對象的一種方式是實例化GLCapabilities類並實現接口。 GLCapabilities類的實例，可以用來以服務爲目的。

GLCapabilities 類

此類指定一組OpenGL性能。它需要GLCapabilities對象作爲參數。GLCapabilities類描述渲染上下文必須支持所期望的功能，例如OpenGL的輪廓。

class: GLCapabilities

package: javax.media.opengl

Constructor

GLCapabilities(GLProfile glprofile)

GLCapabilities類又需要GLProfile對象。

GLProfile 類

由於幾個版本的OpenGL API發佈，需要指定OpenGL的API確切版本被用在你的程序到Java虛擬機（JVM）。這是通過使用GLProfile類。這個類的get()方法接受不同的預定義的String對象作爲參數。每一個String對象是一個接口的名稱，每個接口支持OpenGL的某些版本。如果初始化這個類的靜態和單例，這個類提供了每個可用JOGL單例GLProfile對象。

class: GLProfile

package: javax.media.opengl

Method and 描述

Static GLProfile get(String profile)

使用默認設備。

因爲這是一個靜態方法，需要使用類名來調用它，它需要一個預定義的靜態字符串變量作爲參數。有在這12級這樣的變量，分別代表GL接口的獨立實現。

GLProfile.get(GLProfile.GL2);

下表顯示GLProfile類的get()方法的字符串參數：

Sr. No.

預定義的字符串值（接口名稱）和描述

1

GL2

這種接口包含所有的OpenGL[1.0 ...3.0]的方法，以及它的大多數擴展中定義在本說明書中的時間。

2

GLES1

這種接口包含所有的OpenGL ES[1.0 ...1.1]的方法，以及它的大多數擴展中定義在本說明書中的時間

3

GLES2

這種接口包含所有的OpenGL ES 2.0的方法，以及它的大部分在本說明書中的時間定義的擴展。

4

GLES3

這種接口包含所有的OpenGL ES3.0的方法，以及它的大部分在本說明書中的時間定義的擴展。

5

GL2ES1

此接口包含GL2和GLES1的公共子集。

6

GL2ES2

此接口包含GL3，GL2和GLES2的公共子集。

7

GL2GL3

此接口包含核心GL3（OpenGL的3.1+）和GL2的公共子集。

8

GL3

這種接口包含所有的OpenGL[3.1...3.3]核心方法，以及它的大部分在本說明書中的時間定義的擴展。

9

GL3bc

這種接口包含所有的OpenGL[3.1...3.3]的相容性的方法，以及它的大部分在本說明書中的時間定義的擴展。

10

GL3ES3

接口含有核心GL3（OpenGL的3.1+）和GLES3（OpenGL ES3.0）的公共子集。

11

GL4

這種接口包含所有的OpenGL[4.0...4.3]核心方法，以及它的大部分在本說明書中的時間定義的擴展。

12

GL4bc

這種接口包含所有的OpenGL[4.0...4.3]相容性分佈，以及它的大部分在本說明書中的時間定義的擴展。

13

GL4ES3

接口含有核心GL4（OpenGL的4.0+）和GLES3（OpenGL ES3.0）的公共子集。

現在一切都被設置在使用JOGL的第一個程序中。

使用畫布與AWT的基本模板

使用JOGL的編程，可以繪製各種圖形形狀，例如直線，三角形，三維形狀，包括特殊效果，如旋轉，照明，色彩等。

JOGL編程的基本模板如下：

步驟1：創建一個類

最初創建一個實現 GlEventListener 接口的類，並導入包 javax.media.opengl。實現所有四種方法 display(), dispose(), reshape(), init()。由於這是基本框架，基本任務，如創建Canvas類，將其添加到框架進行了討論。所有GLEVentListener接口的方法留下未實現。

第二步：準備畫布

(a)構建GLCanvas類和對象

final GLCanvas glcanvas = new GLCanvas( xxxxxxx ); //here capabilities obj should be passed as parameter

(b) 實例化GLCapabilities類

GLCapabilities capabilities = new GLCapabilities( xxxxx ); //here profile obj should be passed as parameter

生成GLProfile對象

因爲這是靜態方法，它是使用類名調用。由於本教程是關於JOGL2，產生GL2接口對象。

final GLProfile profile = GLProfile.get( GLProfile.GL2 ); // both, variable and method are static hence both are called using class name.

讓我們看到了代碼片段畫布

//getting the capabilities object of GL2 profile final GLProfile profile = GLProfile.get(GLProfile.GL2); GLCapabilities capabilities = new GLCapabilities(profile); // The canvas final GLCanvas glcanvas = new GLCanvas(capabilities);

現在，使用方法addGLEventListener()添加GLEventListener到畫布。此方法需要GLEventListener接口參數的對象。因此，通過實現GLEventListener類的對象。

BasicFrame basicframe=newBasic Frame( );// class which implements GLEventListener interface glcanvas.addGLEventListener( basicframe );

使用setSize()方法繼承自javax.media.opengl.awt.AWTGLAutoDrawable GLCanvas框架設置大小。

glcanvas.setSize( 400, 400 );

現在，還可以用GLCanvas。

第三步：創建框架

通過實例JSE AWT框架組件的Frame類對象創建的框架。

添加畫布，使框架可見。

//creating frame final Frame frame = new frame( " Basic Frame" ); //adding canvas to frame
frame.add( glcanvas ); frame.setVisible( true );

第4步：在全屏觀看幀

對於幀的全屏視圖，使用java.awt.Toolkit中的類得到默認的屏幕大小。現在，使用這些默認的屏幕大小尺寸，使用setSize()方法設置幀的大小。

Dimension screenSize = Toolkit.getDefaultToolkit().getScreenSize(); frame.setSize(screenSize.width, screenSize.height);

讓我們通過在程序使用AWT來生成基本的框架：

import javax.media.opengl.GLAutoDrawable; import javax.media.opengl.GLCapabilities; import javax.media.opengl.GLEventListener; import javax.media.opengl.GLProfile; import javax.media.opengl.awt.GLCanvas; import javax.swing.JFrame; public class BasicFrame implements GLEventListener{ @Override public void display(GLAutoDrawable arg0) { // method body } @Override public void dispose(GLAutoDrawable arg0) { //method body } @Override public void init(GLAutoDrawable arg0) { // method body } @Override public void reshape(GLAutoDrawable arg0, int arg1, int arg2, int arg3,int arg4) { // method body } public static void main(String[] args) { //getting the capabilities object of GL2 profile final GLProfile profile = GLProfile.get(GLProfile.GL2); GLCapabilities capabilities = new GLCapabilities(profile); // The canvas final GLCanvas glcanvas = new GLCanvas(capabilities); BasicFrame b = new BasicFrame(); glcanvas.addGLEventListener(b); glcanvas.setSize(400, 400); //creating frame final JFrame frame = new JFrame (" Basic Frame"); //adding canvas to frame frame.getContentPane().add(glcanvas); frame.setSize(frame.getContentPane().getPreferredSize()); frame.setVisible(true); } }

如果編譯並執行上述程序，將生成以下輸出。它顯示了當我們用GLCanvas類與AWT形成一個基本的框架：

使用畫布與Swing

使用Canvas與AWT提供了一個圖形化的框架與重量級的功能。對於具有輕量級的圖形框架，同時採用GLCanvas與Swing，可以將GLCanvas會在窗口JFrame直接使用，也可以將其添加到JPanel中。

下面的程序將生成使用GLCanvas與Swing窗口的基本框架：

import javax.media.opengl.GLAutoDrawable; import javax.media.opengl.GLCapabilities; import javax.media.opengl.GLEventListener; import javax.media.opengl.GLProfile; import javax.media.opengl.awt.GLCanvas; import javax.swing.JFrame; public class BasicFrame implements GLEventListener{ @Override public void display(GLAutoDrawable arg0) { // method body } @Override public void dispose(GLAutoDrawable arg0) { //method body } @Override public void init(GLAutoDrawable arg0) { // method body } @Override public void reshape(GLAutoDrawable arg0, int arg1, int arg2, int arg3, int arg4) { // method body } public static void main(String[] args) { //getting the capabilities object of GL2 profile final GLProfile profile = GLProfile.get(GLProfile.GL2); GLCapabilities capabilities = new GLCapabilities(profile); // The canvas final GLCanvas glcanvas = new GLCanvas(capabilities); BasicFrame b = new BasicFrame(); glcanvas.addGLEventListener(b); glcanvas.setSize(400, 400); //creating frame final JFrame frame = new JFrame (" Basic Frame"); //adding canvas to it frame.getContentPane().add(glcanvas); frame.setSize(frame.getContentPane().getPreferredSize()); frame.setVisible(true); }//end of main }//end of classimport

如果編譯並執行上述程序，將生成以下輸出。它顯示了當我們用GLCanvas與Swing窗口形成一個基本的框架。

GLJPanel 類

它是一個輕量級的Swing組件，它提供了OpenGL的渲染支持。它提供了與Swing的兼容性。

GLJPanel類層次結構

class: GLJPanel

package: javax.media.opengl.awt

Contructors

GJPanel()

創建一個用 OpenGL 功能的默認設置一個新的GLJPanel組成部分。

(GLCapabilitiesImmutable)

創建一個具有指定一組OpenGL性能的新 GLJPanel 組件。

GLJPanel(GLCapabilitiesImmutable userCapsRequest, GLCapabilitiesChooser chooser)

創建一個新的GLJPanel組件。

方法及描述

Void addGLEventListener(GLEventListener listener)

此方法將給定的偵聽器，以這種繪製隊列的末尾。

Void addGLEventListener(int indexGLEventListener listener)

這種方法繪製該隊列的特定索引處添加指定的偵聽器。

使用GLJPanel與Swing窗口

讓我們來看看生成使用GLJPanel與Swing窗口基本框架方案：

import javax.media.opengl.GLAutoDrawable; import javax.media.opengl.GLCapabilities; import javax.media.opengl.GLEventListener; import javax.media.opengl.GLProfile; import javax.media.opengl.awt.GLCanvas; import javax.swing.JFrame; public class BasicFrame implements GLEventListener{ @Override public void display(GLAutoDrawable arg0) { // method body } @Override public void dispose(GLAutoDrawable arg0) { //method body } @Override public void init(GLAutoDrawable arg0) { // method body } @Override public void reshape(GLAutoDrawable arg0, int arg1, int arg2, int arg3, int arg4) { // method body } public static void main(String[] args) { //getting the capabilities object of GL2 profile final GLProfile profile = GLProfile.get(GLProfile.GL2); GLCapabilities capabilities = new GLCapabilities(profile); // The canvas final GLCanvas glcanvas = new GLCanvas(capabilities); BasicFrame b = new BasicFrame(); glcanvas.addGLEventListener(b); glcanvas.setSize(400, 400); //creating frame final JFrame frame = new JFrame (" Basic Frame"); //adding canvas to it frame.getContentPane().add(glcanvas); frame.setSize(frame.getContentPane().getPreferredSize()); frame.setVisible(true); }//end of main }//end of classimport

如果編譯並執行上述程序，將生成以下輸出。這表明，當我們使用GLJPanel swing窗口形成一個基本框架：