Home Page Toolkit Overview Using GML   User Input Services     Finger Tracker     Calibrator     Frame Grabber     Service protocol Obtaining GML   Installing GML   Licence Developer Documentation   Tcl/Tk API     The GML Canvas     Image processing   Tcl Scripts Library     List of Classes     List of Files   C/C++ API     List of Classes     List of Files

gml_GL_Base.h Go to the documentation of this file. /** @file gml_GL_Base.h * * Wrapper for platform dependent creation of OpenGL rendering context, and * conversions from gml_TBitmap to OpenGL buffers. * * Copyright (c) 2003 CLIPS-IMAG * * See the file "gml_LicenseTerms.txt" for information on usage and redistribution * of this file, and for a DISCLAIMER OF ALL WARRANTIES. * * Created on March 9, 2003 (FB). */ #ifndef __GML_OPENGL__ #define __GML_OPENGL__ //#include "gml/math/gml_Math.h" #include "gml/base/gml_Errors.h" #include "gml/image/gml_Drawable.h" #include "gml/image/gml_RGBColor.h" #include "gml/image/gml_Geometry.h" #if defined(__APPLE__) #include <OpenGL/gl.h> #include <OpenGL/glu.h> #include <OpenGL/glext.h> #define GL_TESSCALLBACKPARAMS ... #elif defined(_WIN32) #include <gl.h> #include <glu.h> #include <glext.h> #ifndef GL_TEXTURE_RECTANGLE_EXT #define GL_TEXTURE_RECTANGLE_EXT GL_TEXTURE_RECTANGLE_NV #endif #define GL_TESSCALLBACKPARAMS #else #define GL_GLEXT_PROTOTYPES #include <GL/gl.h> #include <GL/glu.h> #include <GL/glext.h> #ifndef GL_TEXTURE_RECTANGLE_EXT #define GL_TEXTURE_RECTANGLE_EXT GL_TEXTURE_RECTANGLE_NV #endif #define GL_TESSCALLBACKPARAMS #endif #define GMLGL_CHECK_ERROR do { GLenum err = glGetError (); if (err == GL_NO_ERROR) break; fprintf (stderr, "[gmlGL] %s:%d %s\n", __FILE__, __LINE__, gluErrorString (err)); } while (0) // Error numbers -- extern gml_TError gmlGL_gErrCantChoosePixelFormat; extern gml_TError gmlGL_gErrCantCreateContext; extern gml_TError gmlGL_gErrCantAttachDrawable; extern gml_TError gmlGL_gErrCantSetCurrentContext; extern gml_TError gmlGL_gErrCantSwapBuffers; extern gml_TError gmlGL_gErrCantUpdateContextDrawable; extern gml_TError gmlGL_gErrWrongBMsize; extern gml_TError gmlGL_gErrUnsupportedBMencoding; extern gml_TError gmlGL_gErrUnknownContext; extern gml_TError gmlGL_gUnsupportedExtension; /** gmlGL_TContext -- * * A identifier for an OpenGL context. * NULL has a special meaning, the sharing context; * it is created automatically and cannot be deleted. */ struct gmlGL_TContext_; typedef struct gmlGL_TContext_* gmlGL_TContext; // PLATFORM INDEPENDANT CODE -- // // Defined in "gml_GL_Base.cc". /// gmlGL_Initialize -- /// /// Initialized gml_GL_Base error numbers. Users of gml_GL_Base function need not call /// this function as it will be called automatically. GML_EXTERN_C gml_TError gmlGL_Initialize (); /// gmlGL_ColorRGBAtoGL4usv -- /// /// Converts a gml_TRGBColor <color> and its transparency value <alpha> into a GL color /// encoded on an array of 4 unsigned short <glColor> (for use with glColor4usv). GML_EXTERN_C void gmlGL_ColorRGBAtoGL4usv (gml_TRGBColor* color, float alpha, GLushort* glColor); /// gmlGL_ColorRGBAtoGL4fv -- /// /// Converts a gml_TRGBColor <color> and its transparency value <alpha> into a GL color /// encoded on an array of 4 floats <glColor> (for use with glColor4fv). GML_EXTERN_C void gmlGL_ColorRGBAtoGL4fv (gml_TRGBColor* color, float alpha, GLfloat* glColor); /// gmlGL_HasExtension -- /// /// Check whether the current OpenGL context supports the argument <extension>, /// e.g. "GL_EXT_texture_rectangle". GML_EXTERN_C gml_TBoolean gmlGL_HasExtension (char *extension); //// gmlGL_GetTextureParamsFromEncoding -- //// //// Checks that the encoding <enc> is suitable for a GL texture. //// Select the correct <internal> <format> <type> for use with OpenGL. GML_EXTERN_C gml_TError gmlGL_GetTextureParamsFromEncoding (gml_TPixelEncoding enc, GLint* internal, GLenum* format, GLenum* type); /// gmlGL_SaveToBitmap -- /// /// Copy the current OpenGL context draw buffer to the bitmap <bm> with "glReadPixels". /// <bm> must have compatible specifications. GML_EXTERN_C gml_TError gmlGL_SaveToBitmap (gml_TBitmap* bm); // PLATFORM DEPENDANT CODE -- // // Defined in "gml_OpenGL_<platform>.cc". /// gmlGL_PlatformInitialize -- /// /// Perform platform-specific setup. This is called automatically by gmlGL_Initialize. /// In particular, create the sharing context (context 0). GML_EXTERN_C void gmlGL_PlatformInitialize (); /// gmlGL_FindVisual -- /// /// Find a visual appropriate for an OpenGL context GML_EXTERN_C gml_TError gmlGL_FindVisual (gml_TDisplay display, gml_TVisual *visual); /// gmlGL_CreateContext -- /// /// Creates an OpenGL rendering context and attach it to the drawable <drawable>. /// Return the context handle in <context>. /// If <drawable> is NULL, the context may still be used for off-screen rendering. /// Note that all context share data (textures, display lists, etc.) GML_EXTERN_C gml_TError gmlGL_CreateContext (gml_TDisplay display, gml_TVisual visual, gml_TDrawable drawable, gmlGL_TContext* context); /// gmlGL_DeleteContext -- /// /// Deletes an OpenGL rendering context. /// After the call, the sharing context is active. GML_EXTERN_C void gmlGL_DeleteContext (gmlGL_TContext context); /// gmlGL_GetCurrentContext -- /// /// Return the current OpenGL rendering context. GML_EXTERN_C gmlGL_TContext gmlGL_GetCurrentContext (); /// gmlGL_SetCurrentContext -- /// /// Sets <context> as the current OpenGL rendering context. /// If <context> is NULL, the sharing context is used. GML_EXTERN_C gml_TError gmlGL_SetCurrentContext (gmlGL_TContext context); /// gmlGL_SwapBuffers -- /// /// Swaps front and back buffer (double buffering). /// Note: <gmlGL_SwapBuffer> performs an implicit glFlush before it returns. GML_EXTERN_C gml_TError gmlGL_SwapBuffers (gmlGL_TContext context); /// gmlGL_DrawableChanged -- /// /// Update an Open GL rendering context after its drawable changed (resizing, /// window exposure...). GML_EXTERN_C gml_TError gmlGL_DrawableChanged (gmlGL_TContext context); /// gmlGL_SetDrawableRect -- /// /// Restricts OpenGL rendering in the context's drawable to a rectangle specified by its /// bottomleft corner and size. GML_EXTERN_C gml_TError gmlGL_SetDrawableRect (gmlGL_TContext context, GLint top, GLint bottom, GLint width, GLint height); #endif Generated on Tue Jun 12 14:03:27 2007 for gml by Doxygen 1.5.2.

Contact: julien (dot) letessier (at) gmail (dot) com. Copyright (c) 2000-2007 CLIPS-IMAG Laboratory, Grenoble, France. All rights reserved. W3CXHTML 1.0 W3CCSS 2.0