summaryrefslogtreecommitdiffstats
path: root/src/net/java/joglutils/msg/overview.html
diff options
context:
space:
mode:
Diffstat (limited to 'src/net/java/joglutils/msg/overview.html')
-rw-r--r--src/net/java/joglutils/msg/overview.html50
1 files changed, 50 insertions, 0 deletions
diff --git a/src/net/java/joglutils/msg/overview.html b/src/net/java/joglutils/msg/overview.html
new file mode 100644
index 0000000..828dc12
--- /dev/null
+++ b/src/net/java/joglutils/msg/overview.html
@@ -0,0 +1,50 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
+<html>
+<head>
+ <title>The Minimal Scene Graph (MSG)</title>
+</head>
+<body>
+<h2>Overview</h2>
+
+<P>
+
+The Minimal Scene Graph (MSG) is a small, lightweight 3D scene graph
+library layered on top of the <a href="http://jogl.dev.java.net">Java(tm)
+Binding to the OpenGL(r) API</a> (JOGL). MSG is heavily inspired by
+the Open Inventor(tm) library developed by Silicon Graphics, Inc. and
+derives most of its concepts and internal structure from this library,
+which was released in open-source form in 2000. Many implementation
+decisions were informed by studying the Open Inventor source code.
+
+</P>
+<P>
+
+MSG is more free-form in style than many contemporary scene graphs.
+The traversal order of the scene graph is significant, and occurs in
+top-down, left-to-right order. Nodes placed in the scene graph affect
+the global state when they are traversed. When geometry is rendered,
+it acquires its visual characteristics from the current settings in
+the global state. Actions are applied to nodes to cause operations
+such as rendering.
+
+</P>
+<P>
+
+Group nodes collect children nodes underneath them, but have no effect
+on the global state, which propagates both upward and downward through
+them. Separator nodes, which are a subclass of Group, prevent state
+changes underneath them from propagating out and affecting nodes which
+follow them in the graph. This allows them to be used as an effective
+means of collecting reusable pieces of scene graph structure. Global
+state propagates downward through Separators.
+
+</P>
+<P>
+
+The current set of nodes is minimal (as indicated by the name of the
+library) and the current set of actions is incomplete.
+
+</P>
+
+</body>
+</html>