aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorSven Gothel <[email protected]>2023-06-10 21:43:05 +0200
committerSven Gothel <[email protected]>2023-06-10 21:43:05 +0200
commit54549337ab4fceb9e95ef3e01956113570682623 (patch)
tree1852d632ab3dfbd2a6a431ddf3be9755ff21fe3b
parent95c0c67618e7b7415f78a20f79a3722cf344c16f (diff)
Bump README.txt -> README.md + Referencing GL4Java being source of concepts and predecessor of JOGL today
-rw-r--r--LICENSE.txt10
-rw-r--r--README.md98
-rw-r--r--README.txt88
3 files changed, 103 insertions, 93 deletions
diff --git a/LICENSE.txt b/LICENSE.txt
index 6405275..bd9d97a 100644
--- a/LICENSE.txt
+++ b/LICENSE.txt
@@ -2,7 +2,7 @@
GL4Java - A OpenGL language mapping to Java
-Copyright (C) 1999 Sven Goethel
+Copyright (C) 1997 - 2023 Sven Gothel, Göthel Software e.K.
This library is free software; you can redistribute it and/or
modify it under the terms of the GNU Library General Public
@@ -24,10 +24,10 @@ in the internet at http://www.gnu.org/copyleft/lgpl.html !
If you like to contact the author use:
-Sven Goethel
-web : http://www.jausoft.com
+Sven Gothel
+mail: sgothel [@] jausoft.com
+web : http://www.jausoft.com
-Sven Goethel, 15 January 1999, 27.06.2003, ..
+Sven Goethel, 15 January 1999, 27.06.2003, 10.06.2023, ..
\end{verbatim}
diff --git a/README.md b/README.md
new file mode 100644
index 0000000..803fe28
--- /dev/null
+++ b/README.md
@@ -0,0 +1,98 @@
+# GL4Java, a native OpenGL mapping to Java™
+
+[Original document location](https://jogamp.org/cgit/gl4java.git/about/)
+
+## Git Repository
+This project's canonical repositories is hosted on [JogAmp](https://jogamp.org/cgit/gl4java.git/).
+
+## Overview
+The [*OpenGL™ for Java™ (GL4Java)*](https://jausoft.com/gl4java/docs/) is an OpenGL™ binding for the Java™ programming language.
+
+*GL4Java* was developed [from March 1997](https://jausoft.com/gl4java/docs/overview/history.html)
+until [March 2003](https://jogamp.org/cgit/gl4java.git/log/).
+
+Its many concepts were reused in the subsequently launched [JOGL project](https://jogamp.org/jogl/www/),
+initially lead by Sun Microsystems and later run by [myself and the JogAmp community](https://jogamp.org/),
+rendering *GL4Java* effectively *JOGL's* predecessor.
+A few of the concepts reused were:
+- C-Header Compiler to JNI glue code: C2J -> GlueGen
+- AWT integration: GLCanvas, GLJPanel (swing)
+- WinHandleAccess -> NativeWindow
+- GLDrawableFactory
+- GLDrawable
+- GLContext
+- GLEvenListener
+- etc
+
+## Index of text files
+- [CHANGES.txt](./CHANGES.txt)
+
+ A list of the changes are made through the versions.
+
+- [INSTALLER.txt](./INSTALLER.txt)
+
+ The description howto install GL4Java with
+ the installer via web or as an downloaded application!
+
+- [INSTALL.txt](./INSTALL.txt)
+
+ The root description howto install GL4Java manually.
+ The following files are linked here:
+
+- [Java2.txt](./Java2.txt)
+- [MS-JVM.txt](./MS-JVM.txt)
+- [Netscape.txt](./Netscape.txt)
+
+- [COMPILATION.txt](./COMPILATION.txt)
+
+ The description howto install GL4Java
+ from scratch (obtain + compiling) !
+
+- Some license informations:
+ - [LICENSE.txt](./LICENSE.txt)
+ - [PNG-LICENSE.txt](./PNG-LICENSE.txt)
+
+- Some historical, further readings:
+ - [PNG-README.txt](./PNG-README.txt)
+ - [README.AdamKing.txt](./README.AdamKing.txt)
+ - [README.RonCemer.txt](./README.RonCemer.txt)
+ - [THANXS.txt](./THANXS.txt)
+
+- Some technical short-hand infos:
+ - [Tesselation.txt](./Tesselation.txt)
+ - [VERSIONS.txt](./VERSIONS.txt)
+
+## Supported Platforms
+- Unix Platforms
+ - Linux (x86) 2.X
+ - SunOS (Sparc) 5.X
+ - AIX 4.2 (RS/6000)
+ - SGI Irix
+- Misc Platforms
+ - Macintosh
+ - Windows NT 95/98 (x86) 4.0 (sun/netscape)
+ - Windows NT 95/98 (x86) 4.0 (msjvm/ie40)
+
+## Concluding
+May be - WE can find a way for a standard OpenGL for Java API !
+
+As you can see, OpenGL-Rendering can be integrated in Java-Programs
+very well. You can use the normal java paint and event - functions
+as you used display and reshape in glut !
+
+See also [LICENSE.txt](./LICENSE.txt) for the license of GL4Java !
+
+Sven Gothel
+- January 1999
+- April 1999
+- September 1999
+- April 2000
+- June 2023
+
+## Contact
+- Jausoft [http://jausoft.com/](http://jausoft.com/)
+- JogAmp [http://jogamp.org/](http://jogamp.org/)
+- JOGL Web [http://jogamp.org/](http://jogamp.org/jogl/)
+- Sven's Blog [https://jausoft.com/blog/tag/jogamp/](https://jausoft.com/blog/tag/jogamp/)
+- Email sgothel _at_ jausoft _dot_ com
+
diff --git a/README.txt b/README.txt
deleted file mode 100644
index 846957e..0000000
--- a/README.txt
+++ /dev/null
@@ -1,88 +0,0 @@
-\begin{verbatim}
-
-GL4Java,
-a native OpenGL mapping to Java !
-
-Homepage:
-http://www.jausoft.com/gl4java !
-
-1st of all, a little index of all little text-files:
-
- CHANGES.txt
- A list of the changes are made through the versions.
-
- INSTALLER.txt
- The description howto install GL4Java with
- the installer via web or as an downloaded application!
-
- INSTALL.txt
- The root description howto install GL4Java manually.
- The following files are linked here:
- Java2.txt
- MS-JVM.txt
- Netscape.txt
-
- COMPILATION.txt
- The description howto install GL4Java
- from scratch (obtain + compiling) !
-
- Some license informations:
- LICENSE.txt
- PNG-LICENSE.txt
-
- Some historical, further readings:
- PNG-README.txt
- README.AdamKing.txt
- README.RonCemer.txt
- THANXS.txt
-
- Some technical short-hand infos:
- Tesselation.txt
- VERSIONS.txt
-
-I encourage you te read these files carefully
-and also to read the html/pdf documentation as well,
-befor asking !
-
-You may want to add yourself to the GL4Java mailinglist !
-
-I would be very lucky, if i get some response, critic, inspirations,
-bugfixes and participation.
-
-I changed (see CHANGES) the naming convention for a better
-transparence and porting-ability (sorry for my english)
-- so i changed the lib-name to GL4Java !
-
-<Please forgive me for so many I's :>
-
-The following Unices were succesfully testes:
-
- o Linux (x86) 2.X
- o SunOS (Sparc) 5.X
- o AIX 4.2 (RS/6000)
- o SGI Irix
-
- o Macintosh (check http://www.jausoft.com/gl4java.html)
- o Windows NT 95/98 (x86) 4.0 (sun/netscape)
- o Windows NT 95/98 (x86) 4.0 (msjvm/ie40)
-
-May be - WE can find a way for a standard OpenGL for Java API !
-
-As you can see, OpenGL-Rendering can be integrated in Java-Programs
-very well. You can use the normal java paint and event - functions
-as you used display and reshape in glut !
-
-See also LICENSE.txt for the license of GL4Java !
-
-Sven Goethel
-January 1999
-April 1999
-September 1999
-April 2000
-
-www : http://www.jausoft.com
-voice : +49-0521-2399440
-fax : +49-0521-2399442
-
-\end{verbatim}