GL4Java

Hva

GL4Java vedlikeholdes ikke. Det er en enkel sak å oversette GL4Java-programmer slik at de benytter JOGL i stedet.

Installasjon og kjøring

Installasjonsrutinene på GL4Javas vevsider er greie, og de gjentas ikke her. Husk å legge til classpath, enten ved å redigere i System/Environment eller ved SET CLASSPATH= - kommandoen.

Dersom du ikke er interessert i å tilpasse installasjonen slik at den skal handtere Applets i diverse nettlesere, så kan du installere enkelt for hånd på MSWindows. Det du må passe på er at:

Følgende filer er pakket ut og plassert på c:\GL4Java\binpkg:
- gl4java.jar
- png.jar.jar (handtering av png-grafikk)
- gl4java-glffonts.jar
- gl4java-glutfonts.jar
Følgende filer er plassert slik at de nås via PATH. Du kan editere PATH i systemet eller du kan gå for en enkel løsning og droppe dem i WINDOWS/system32 - katalogen sammen med alle andre dll'er:
- GL4JavaGljMSJDirect.dll
- GL4JavaJauGljJNI12.dll
- GL4JavaJauGljJNI13.dll
- GL4JavaJauGljJNI14.dll
- GL4JavaJauGljJNI.dll

Anta at vi kjører Windows og har skrevet et program std, og plasserer oss i den katalogen std.java ligger. En bat-fil med følgende innhold vil kompilere og kjøre programmet:

SET CLASSPATH=c:\GL4Java\binpkg\gl4java.jar;.;
javac std.java
java std

Forutsatt at GL4Java er installert som angitt og at vi ikke bruker png-bilder eller fonter.

Alternativt kan du editere CLASSPATH i systemet.

Et enkelt eksempel

Vi tegner ut en gul kule på grå bakgrunn uten noen interaksjon:

package std;
import java.awt.*;
import java.awt.event.*;
import javax.swing.*;
import java.lang.*;
import java.util.*;
import java.io.*;
import gl4java.GLContext;
import gl4java.awt.GLCanvas;
import gl4java.utils.glut.*;
/**
 * Title:        std project
 * Description:  Demonstarting a minimum OpenGL-program
 * Copyright:    Copyright (c) 2002
 * Company:      hiof
 * @author bs
 * @version 1.0
 */
public class std extends JFrame
{
  JPanel contentPane;
  // window events
  WindowHandler wHandler;
  // gl4java canvas
  myGLCanvas canvas = null;
  /**Construct the application*/
  public std()
  {
    contentPane = (JPanel) this.getContentPane();
    contentPane.setLayout(new BorderLayout());
    this.setSize(new Dimension(400, 400));
    this.setTitle("std");
    // gl4 java stuff
    Dimension d = getSize();
    canvas = new myGLCanvas(d.width, d.height);
    contentPane.add("Center", canvas);
    // add windowlistener to frame
    wHandler=new WindowHandler();
    this.addWindowListener(wHandler);
    pack();
    show();
  }
  /**Main method*/
  public static void main(String[] args)
  {
    new std();
  }
// --------------------------------------------
// inner class for window events, interface WindowListener
  class WindowHandler implements WindowListener
  {
  public void windowOpened(WindowEvent parm1) {}
  public void windowClosing(WindowEvent parm1)
  {
       System.exit( 0 );
  }
  public void windowClosed(WindowEvent parm1) {}
  public void windowIconified(WindowEvent parm1) {}
  public void windowDeiconified(WindowEvent parm1) {}
  public void windowActivated(WindowEvent parm1) {}
  public void windowDeactivated(WindowEvent parm1) {}
  }
  //-------------------------------------------------------
  // inner class myGLCanvas
  private class myGLCanvas extends GLCanvas
  {
    GLUTFunc glut = null;
    public myGLCanvas(int w, int h)
    {
      super(w, h);
    }
    public void preInit()
    {
      doubleBuffer = true;
      stereoView = false;
      accumSize = 8;
    }
    public void init()
    {
      glut = new GLUTFuncLightImpl(gl, glu);
      reshape(getSize().width, getSize().height);
      // prepare ligthsource
      float ambient[] = {0.4f,0.4f,0.4f,1.0f };
      float diffuse[] = {1.0f,1.0f,1.0f,1.0f };
      float position[] = {1.0f,1.0f,1.0f,0.0f };
      float lmodel_ambient[] = {0.4f,0.4f,0.4f,1.0f };
      gl.glLightfv(GL_LIGHT0, GL_AMBIENT, ambient);
      gl.glLightfv(GL_LIGHT0, GL_DIFFUSE, diffuse);
      gl.glLightfv(GL_LIGHT0, GL_POSITION, position);
      gl.glEnable(GL_LIGHT0);
      gl.glEnable(GL_LIGHTING);
      // smooth the drawing
      gl.glShadeModel(GL_SMOOTH);
      // depth sorting
      gl.glEnable(GL_DEPTH_TEST);
      gl.glDepthFunc(GL_LESS);
      // set background to light gray
      gl.glClearColor(0.9f, 0.9f, 0.9f, 1.0f);
    }
    public void display()
    {
      if (glj.gljMakeCurrent() == false)
        return;
      gl.glClear(GL_COLOR_BUFFER_BIT | GL_DEPTH_BUFFER_BIT);
      gl.glClear(GL_ACCUM_BUFFER_BIT);
      gl.glLoadIdentity();
      gl.glTranslatef(0.0f,0.0f,-8.0f);
      //Set material, yellowish
      float amb[]={0.3f,0.3f,0.0f,1.0f};
      float diff[]={1.0f,1.0f,0.5f,1.0f};
      float spec[]={0.6f,0.6f,0.5f,1.0f};
      float shine=0.25f;
      gl.glMaterialfv(GL_FRONT,GL_AMBIENT,amb);
      gl.glMaterialfv(GL_FRONT,GL_DIFFUSE,diff);
      gl.glMaterialfv(GL_FRONT,GL_SPECULAR,spec);
      gl.glMaterialf(GL_FRONT,GL_SHININESS,shine*128.0f);
      // Draw sphere, using a predefined glut function
      glut.glutSolidSphere (1.2f,20,20);
      glj.gljSwap();
      glj.gljFree();
    }

    public void reshape(int w, int h)
    {
      gl.glViewport(0, 0, w, h);
      gl.glMatrixMode(GL_PROJECTION);
      gl.glLoadIdentity();
      glu.gluPerspective( 35.0, (float) w/h, 1.0, 500.0 );
      gl.glMatrixMode(GL_MODELVIEW);
    }
  }
}

Programmet er bygd opp med en egen canvas-klasse avledet av GLCanvas

private class myGLCanvas extends GLCanvas

I denne klassen er det fire metoder som må redefineres:

preInit(). Denne kalles før myGLCanvas blir skapt.
init(). Kalles når programmet starter tar seg av engangs initiering, typisk lyssetting, glattemodus, bakgrunnsfarge.
display(). Tar seg av selve uttegningen av scenen.
reshape(...). Kalles når vinduet reskaleres.

Programmet over er et absolutt minimumsprogram. Det kreves flere detaljer for å skrive sikre programmer som tåler å flyttes til ukjente omgivelser. Du finner en rekke eksempler på mer robuste programmer i de demoprogrammene som er distribuert sammen med GL4Java.

Referanser

OpenGL for JavaSourceForgesourceforge.net/projects/gl4java/14-09-2009