GTK+OpenGL Toolkit (OGLTK) (C)2003 SandorLabs

Created by	: John Kiss 
		(kissj@sandorapplications.com)

Sections:
	1 Purpose
	2 About	OGLTK
	3 Build Targets
	4 License
	5 Requirements
	6 SandorLabs and the LGPL

==============================================================================

1) Purpose:

	The purpose of GTK+OGLTK is to simplify creating 3D and 2D 
applications using OpenGL under the Gtk+2.x Application framework.

	Using the GObject and signal framework from glib 2.x with
Gtk+-2.x and Gtkglext this toolkit provides programmer with an easy to 
use API to create and manage 3D objects and scenes within a GTK
Application.

	This library is written in C because SandorLabs wants as
many people to benifit using this library as possible. The abstarct
GObject framework provides C programmers with an object oriented
system.  A C++ version of OGTLK can be undertaken by anyone who wishes since
SandorLabs has no plans on taking on that project. However anyone doing so,
SandorLabs requests it fall under the LGPL  to keep license compatability.

==============================================================================

2) About

* What Gtk+-OGLTK stand for?
	* OGLTK stands for OpenGL Toolkit.

* What is ogltk_view?
	 
	 Every application using the OGLTK requires this object. It is the
only class which returns a GtkWidget . This widgets is then attached to a 
GtkWindow or inside a window container.

* What is ogltk_globject (GLobject)?
	
	Don't be fooled, it looks like GObject but it's GLobject which stands
for Graphic Library Object.  This is an abstract class which is used to create
3D objects within a scene.


* What is a ogltk_scene?

	It is not nescessary to use this class, but why wouldn't you, It
provides a mechanism to place GLobjects within a scene. A gltk_scene
maybe attached to a ogltk_view and called when the method ogltk_view_render
is called.  The ogltk_scene also has a signal which can be used by your
appliation to give the frames per second at timed intervals you specify.


* I don't understand some of the source file prefixes.
	* ogltk = OpenGL ToolKit Class (eg. ogltk_view.c ogltk_scene.c)
	* glo	= GLObject (eg. glo_cube.c glo_box.c)
	* glt	= GL Type (eg. glt_matrix.c , glt_color.c)

==============================================================================

3) License: 

	Gtk+-OGLTK is licensed under the LGPL


==============================================================================

4) Build Target
	* Linux
	
	Once time permits, there are plans to move 
to Win32.

==============================================================================

5) Requirements
	* glib-2.x
		- gobject 2.x
		- gthreads 2.x
	* Gdk-2.x
	* Gtk+-2.x
	* Gtkglext 1.x

==============================================================================

6) SandorLabs and the LGPL
	
	SandorLabs supports the opensource community and especially the LGPL. 
The action of sharing source and libraries without the restriction of publishing
all intellectual property from a project  but any changes to the library (bugfixes, new features)
are published back for all to use is more then acceptable. 
		  
