NAME

MesaWorkstation - A simple workstation abstraction widget for Mesa/X

DESCRIPTION

WARNING : This document is still under construction. There are bound to be a number of inaccuracies, so tread very carefully for now.

Resources

The following X resources are available in addition to the Mesa resources:

Boolean debug
leave it False.

Utility functions

The following utility functions are available

void mesa_begin_projection (Widget w)
void mesa_end_projection (void)
The following code snippet selects perspective projection for the workstation ws:

            mesa_begin_projection (ws);
              glFrustum (-1.0, 1.0, -1.0, 1.0, 1.0, 10.0);
            mesa_end_projection ();
During redisplay, this will be executed as a display list with the matrix mode set to GL_PROJECTION and an identity matrix on top of the projection matrix stack.

void mesa_post_projection (Widget w, GLuint p)
void mesa_unpost_projection (Widget w)
GLuint mesa_projection (Widget w)
void mesa_begin_view (Widget w)
void mesa_end_view (void)
The following code snippet selects a view from the z-axis for the workstation ws:

            mesa_begin_view (ws);
              gluLookAt (0.0, 0.0, 3.0,
                         0.0, 0.0, 0.0,
                         0.0, 1.0, 0.0);
            mesa_end_view ();
During redisplay, this will be executed as a display list with the matrix mode set to GL_MODELVIEW and an identity matrix on top of the model view matrix stack.

void mesa_post_view (Widget w, GLuint v)
void mesa_unpost_view (Widget w)
GLuint mesa_view (Widget w)
void mesa_post_object (Widget w, GLuint o)
posts object to w.

void mesa_unpost_object (Widget w, GLuint o)
void mesa_unpost_all_objects (Widget w)
void mesa_redraw_objects (Widget w)
force a redraw of all objects posted to w.

SEE ALSO

the MesaDrawingArea manpage

AUTHOR

Thorsten.Ohl @ Physik.TH-Darmstadt.de

DATE

$Id: MesaWorkstation.pod,v 1.1 1995/03/28 22:57:08 ohl Exp $