glh_glut2.h

Go to the documentation of this file.

/*
    glh - is a platform-indepenedent C++ OpenGL helper library 


    Copyright (c) 2000 Cass Everitt
        Copyright (c) 2000 NVIDIA Corporation
    All rights reserved.

    Redistribution and use in source and binary forms, with or
        without modification, are permitted provided that the following
        conditions are met:

     * Redistributions of source code must retain the above
           copyright notice, this list of conditions and the following
           disclaimer.

     * Redistributions in binary form must reproduce the above
           copyright notice, this list of conditions and the following
           disclaimer in the documentation and/or other materials
           provided with the distribution.

     * The names of contributors to this software may not be used
           to endorse or promote products derived from this software
           without specific prior written permission. 

       THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
           ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
           LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
           FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE
           REGENTS OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,
           INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING,
           BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
           LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
           CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
           LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN
           ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE 
           POSSIBILITY OF SUCH DAMAGE. 


    Cass Everitt - cass@r3.nu
*/

#ifndef GLH_GLUT_H
#define GLH_GLUT_H

// some helper functions and objects to
// make writing simple glut programs even easier! :-)
#ifndef _WIN32
#include <string.h>
#endif
#include <algorithm>
#include <list>

#ifdef MACOS
#include <GLUT/glut.h>
#else
#include <GL/glut.h>
#endif

#include <glh/glh_interactors.h>
#include <glh/glh_convenience.h>

namespace glh
{

  class glut_interactor
  {
  public:
        glut_interactor() { enabled = true; }

        virtual void display() {}
        virtual void idle() {}
        virtual void keyboard(unsigned char key, int x, int y) {}
        virtual void menu_status(int status, int x, int y) {}
        virtual void motion(int x, int y) {}
        virtual void mouse(int button, int state, int x, int y) {}
        virtual void passive_motion(int x, int y) {}
        virtual void reshape(int w, int h) {}
        virtual void special(int  key, int x, int y) {}
        virtual void timer(int value) {}
        virtual void visibility(int v) {}

        virtual void enable()  { enabled = true; }
        virtual void disable() { enabled = false; }

        bool enabled;
  };

  std::list<glut_interactor *> interactors;
  bool propagate;

  void glut_display_function()
  {
        propagate = true;
        for(std::list<glut_interactor *>::iterator it=interactors.begin(); it != interactors.end() && propagate; it++)
                (*it)->display();
  }

  void glut_idle_function()
  {
        propagate = true;
        for(std::list<glut_interactor *>::iterator it=interactors.begin(); it != interactors.end() && propagate; it++)
                (*it)->idle();
  }

  void glut_keyboard_function(unsigned char k, int x, int y)
  {
        propagate = true;
        for(std::list<glut_interactor *>::iterator it=interactors.begin(); it != interactors.end() && propagate; it++)
          (*it)->keyboard(k, x, y);
  }

  void glut_menu_status_function(int status, int x, int y)
  {
        propagate = true;
        for(std::list<glut_interactor *>::iterator it=interactors.begin(); it != interactors.end() && propagate; it++)
                (*it)->menu_status(status, x, y);
  }

  void glut_motion_function(int x, int y)
  {
        propagate = true;
        for(std::list<glut_interactor *>::iterator it=interactors.begin(); it != interactors.end() && propagate; it++)
                (*it)->motion(x, y);
  }

  void glut_mouse_function(int button, int state, int x, int y)
  {
        propagate = true;
        for(std::list<glut_interactor *>::iterator it=interactors.begin(); it != interactors.end() && propagate; it++)
          (*it)->mouse(button, state, x, y);
  }
  
  void glut_passive_motion_function(int x, int y)
  {
        propagate = true;
        for(std::list<glut_interactor *>::iterator it=interactors.begin(); it != interactors.end() && propagate; it++)
                (*it)->passive_motion(x, y);
  }

  void glut_reshape_function(int w, int h)
  {
        propagate = true;
        for(std::list<glut_interactor *>::iterator it=interactors.begin(); it != interactors.end() && propagate; it++)
          (*it)->reshape(w,h);
  }

  void glut_special_function(int k, int x, int y)
  {
        propagate = true;
        for(std::list<glut_interactor *>::iterator it=interactors.begin(); it != interactors.end() && propagate; it++)
          (*it)->special(k, x, y);
  }

  void glut_timer_function(int v)
  {
        propagate = true;
        for(std::list<glut_interactor *>::iterator it=interactors.begin(); it != interactors.end() && propagate; it++)
          (*it)->timer(v);
  }

  void glut_visibility_function(int v)
  {
        propagate = true;
        for(std::list<glut_interactor *>::iterator it=interactors.begin(); it != interactors.end() && propagate; it++)
          (*it)->visibility(v);
  }

  // stop processing the current event 
  inline void glut_event_processed()
  {
          propagate = false;
  }

  inline void glut_helpers_initialize()
  {
        glutDisplayFunc(glut_display_function);
        glutIdleFunc(0);
        glutKeyboardFunc(glut_keyboard_function);
        glutMenuStatusFunc(glut_menu_status_function);
        glutMotionFunc(glut_motion_function);
        glutMouseFunc(glut_mouse_function);
        glutPassiveMotionFunc(glut_passive_motion_function);
        glutReshapeFunc(glut_reshape_function);
        glutSpecialFunc(glut_special_function);
        glutVisibilityFunc(glut_visibility_function);
  }

  inline void glut_remove_interactor(glut_interactor *gi)
  {
      if (interactors.empty())
          return;
          std::list<glut_interactor *>::iterator it = 
                  std::find(interactors.begin(), interactors.end(), gi);
        if(it != interactors.end())
          interactors.erase(it);
  }

  inline void glut_add_interactor(glut_interactor *gi, bool append=true)
  {
        glut_remove_interactor(gi);
        if(append)
                interactors.push_back(gi);
        else
                interactors.push_front(gi);
  }

  inline void glut_timer(int msec, int value)
  {
        glutTimerFunc(msec, glut_timer_function, value);
  }

  inline void glut_idle(bool do_idle)
  {
        glutIdleFunc(do_idle ? glut_idle_function : 0);
  }

  class glut_callbacks : public glut_interactor
  {
  public:
        glut_callbacks() :
                display_function(0),
                idle_function(0),
                keyboard_function(0),
                menu_status_function(0),
                motion_function(0),
                mouse_function(0),
                passive_motion_function(0),
                reshape_function(0),
                special_function(0),
                timer_function(0),
                visibility_function()
        {}

        virtual void display()
        { if(display_function) display_function(); }

        virtual void idle()
        { if(idle_function) idle_function(); }

        virtual void keyboard(unsigned char k, int x, int y)
        { if(keyboard_function) keyboard_function(k, x, y); }

        virtual void menu_status(int status, int x, int y)
        { if(menu_status_function) menu_status_function(status, x, y); }

        virtual void motion(int x, int y)
        { if(motion_function) motion_function(x,y); }

        virtual void mouse(int button, int state, int x, int y)
        { if(mouse_function) mouse_function(button, state, x, y); }

        virtual void passive_motion(int x, int y)
        { if(passive_motion_function) passive_motion_function(x, y); }

        virtual void reshape(int w, int h)
        { if(reshape_function) reshape_function(w, h); }

        virtual void special(int key, int x, int y)
        { if(special_function) special_function(key, x, y); }

        virtual void timer(int value)
        { if(timer_function) timer_function(value); }

        virtual void visibility(int v)
        { if(visibility_function) visibility_function(v); }

        void (* display_function) ();
        void (* idle_function) ();
        void (* keyboard_function) (unsigned char, int, int);
        void (* menu_status_function) (int, int, int);
        void (* motion_function) (int, int);
        void (* mouse_function) (int, int, int, int);
        void (* passive_motion_function) (int, int);
        void (* reshape_function) (int, int);
        void (* special_function) (int, int, int);
        void (* timer_function) (int);
        void (* visibility_function) (int);

  };



  class glut_perspective_reshaper : public glut_interactor
  {
  public:
          glut_perspective_reshaper(float infovy = 60.f, float inzNear = .1f, float inzFar = 10.f)
                  : fovy(infovy), zNear(inzNear), zFar(inzFar), aspect_factor(1) {}
          
          void reshape(int w, int h)
          {
                  width = w; height = h;

                  if(enabled) apply();
          }

          void apply()
          {
                  glViewport(0,0,width,height);
                  glMatrixMode(GL_PROJECTION);
                  glLoadIdentity();
                  apply_projection();
                  glMatrixMode(GL_MODELVIEW);
          }

          matrix4f get_projection()
          {
                  aspect = aspect_factor * float(width)/float(height);
          if ( aspect < 1 )
                  {
                          // fovy is a misnomer.. we really mean the fov applies to the
                          // smaller dimension
                          float fovx = fovy; 
                          float real_fov = to_degrees(2 * atan(tan(to_radians(fovx/2))/aspect));
              return perspective(real_fov, aspect, zNear, zFar);
                  }
          else
                    return perspective(fovy, aspect, zNear, zFar);
          }

          void apply_projection()
          {
                glMultMatrixf(get_projection().m);
          }

          matrix4f get_projection_inverse()
          {
                  aspect = aspect_factor * float(width)/float(height);
          if ( aspect < 1 )
                  {
                          // fovy is a misnomer.. we really mean the fov applies to the
                          // smaller dimension
                          float fovx = fovy; 
                          float real_fov = to_degrees(2 * atan(tan(to_radians(fovx/2))/aspect));
              return perspective_inverse(real_fov, aspect, zNear, zFar);
                  }
          else
                    return perspective_inverse(fovy, aspect, zNear, zFar);
          }

          void apply_projection_inverse()
          {
                  glMultMatrixf(get_projection_inverse().m);
          }

          int width, height;
          float fovy, aspect, zNear, zFar;
          float aspect_factor;
  };


  // activates/deactivates on particular mouse button/modifier combinations
  // and calculates deltas while active
  class glut_simple_interactor : public glut_interactor
  {
  public:
        glut_simple_interactor()
        {
          num_modes = 0;
          active = false;
          width = height = 0;
          x0 = y0 = x = y = dx = dy = 0;
        }

        virtual void mouse(int button, int state, int X, int Y)
        {
                for(int i=0; i < num_modes; i++)
                {
                        if(enabled && button == cond[i].activate_on && state == GLUT_DOWN &&
                                (! cond[i].use_modifiers || (cond[i].modifiers == glutGetModifiers())) )
                        {
                                mode = i;
                                active = true;
                                x = x0 = X;
                                y = y0 = height - Y;
                                dx = dy = 0;
                                break;
                        }
                        else if (enabled && button == cond[i].activate_on && state == GLUT_UP)
                        {
                                if(dx == 0 && dy == 0)
                                        update();
                                active = false;
                                dx = dy = 0;
                                mode = -1;
                                break;
                        }
                }
        }

        virtual void motion(int X, int Y)
        {
          if(enabled && active)
          {
                dx = X - x;   dy = (height - Y) - y;
                x = X;   y = height - Y;
                update();
          }
        }

        void reshape(int w, int h)
        {
                  width = w; height = h;
        }

        virtual void apply_transform() = 0; 
        virtual void apply_inverse_transform() = 0;
        virtual matrix4f get_transform() = 0;
        virtual matrix4f get_inverse_transform() = 0;

        virtual void update() {}

        struct activate_condition
        {
                activate_condition()
                {
                        activate_on = GLUT_LEFT_BUTTON;
                        use_modifiers = true;
                        modifiers = 0;
                }
                int activate_on;
                bool use_modifiers;
                int modifiers;
        };

        activate_condition cond[2];
        bool active;
        int x0, y0;
        int x, y;
        int dx, dy;
        int width, height;
        int num_modes;
        int mode;
  };


  class glut_translator : public translator, public glut_simple_interactor
  {
  public:

        void update()
        {
          if(mode == 0)
                  pan(dx, dy);
          else if(mode == 1)
                  dolly(-dy);
          glutPostRedisplay();
        }

        void apply_transform()
        {
          //cerr << "Applying transform: " << (x - x0) << ", " << (y - y0) << endl;
          glTranslatef(t[0], t[1], t[2]);
        }

        void apply_inverse_transform()
        {
          //cerr << "Applying transform: " << (x - x0) << ", " << (y - y0) << endl;
          glTranslatef(-t[0], -t[1], -t[2]);
        }

        matrix4f get_transform()
        {
                return translator::get_transform();
        }

        matrix4f get_inverse_transform()
        {
                return translator::get_inverse_transform();
        }

  };


  class glut_trackball : public glut_simple_interactor, public trackball
  {
  public:

        void update()
        {
                radius = width < height ? width : height;
                radius /= 2.f;
                offset = vec3f(width/2.f, height/2.f, 0);
                rotate(x-dx, y-dy, x, y);
                glutPostRedisplay();
        }

        void apply_transform()
        {
                glTranslatef(centroid[0], centroid[1], centroid[2]);
                glh_rotate(r);
                glTranslatef(-centroid[0], -centroid[1], -centroid[2]);
        }

        void apply_inverse_transform()
        {
                glTranslatef(centroid[0], centroid[1], centroid[2]);
                glh_rotate(r.inverse());
                glTranslatef(-centroid[0], -centroid[1], -centroid[2]);
        }

        matrix4f get_transform()
        {
                return trackball::get_transform();
        }

        matrix4f get_inverse_transform()
        {
                return trackball::get_inverse_transform();
        }

  }; 

  inline void glut_exit_on_escape(unsigned char k, int x = 0, int y = 0)
  { if(k==27) exit(0); }

  struct glut_simple_mouse_interactor : public glut_interactor
  {

  public:
        glut_simple_mouse_interactor(int num_buttons_to_use=3)
        {
          configure_buttons(num_buttons_to_use);
          camera_mode = false;
        }

        void enable()
        {
                trackball.enable();
                translator.enable();
        }

        void disable()
        {
                trackball.disable();
                translator.disable();
        }

        void set_camera_mode(bool cam)
        {
                camera_mode = cam;
                if(camera_mode)
                {
                        trackball.invert_increment = true;
                        translator.invert_increment = true;
                        translator.parent_rotation = & trackball.r;
                }
                else
                {
                        trackball.invert_increment = false;
                        translator.invert_increment = false;
                        if(translator.parent_rotation == &trackball.r) translator.parent_rotation = 0;
                }
        }
        void configure_buttons(int num_buttons_to_use = 3)
        {
          switch(num_buttons_to_use)
          {
          case 1:

                trackball.num_modes = 1;
                trackball.cond[0].activate_on = GLUT_LEFT_BUTTON;
                trackball.cond[0].modifiers = 0;
                trackball.cond[0].use_modifiers = true;

                translator.num_modes = 2;
                translator.cond[0].activate_on = GLUT_LEFT_BUTTON;
                translator.cond[0].modifiers = GLUT_ACTIVE_SHIFT;
                translator.cond[0].use_modifiers = true;
                translator.cond[1].activate_on = GLUT_LEFT_BUTTON;
                translator.cond[1].modifiers = GLUT_ACTIVE_CTRL;
                translator.cond[1].use_modifiers = true;
                break;

          case 2:

                trackball.num_modes = 1;
                trackball.cond[0].activate_on = GLUT_LEFT_BUTTON;
                trackball.cond[0].modifiers = 0;
                trackball.cond[0].use_modifiers = true;

                translator.num_modes = 2;
                translator.cond[0].activate_on = GLUT_MIDDLE_BUTTON;
                translator.cond[0].modifiers = 0;
                translator.cond[0].use_modifiers = true;
                translator.cond[1].activate_on = GLUT_LEFT_BUTTON;
                translator.cond[1].modifiers = GLUT_ACTIVE_CTRL;
                translator.cond[1].use_modifiers = true;

                break;

          case 3:
          default:

                trackball.num_modes = 1;
                trackball.cond[0].activate_on = GLUT_LEFT_BUTTON;
                trackball.cond[0].modifiers = 0;
                trackball.cond[0].use_modifiers = true;

                translator.num_modes = 2;
                translator.cond[0].activate_on = GLUT_MIDDLE_BUTTON;
                translator.cond[0].modifiers = 0;
                translator.cond[0].use_modifiers = true;
                translator.cond[1].activate_on = GLUT_RIGHT_BUTTON;
                translator.cond[1].modifiers = 0;
                translator.cond[1].use_modifiers = true;

                break;
          }
        }

        virtual void motion(int x, int y)
        { 
                trackball.motion(x,y);
                translator.motion(x,y);
        }

        virtual void mouse(int button, int state, int x, int y)
        {
          trackball.mouse(button, state, x, y);
          translator.mouse(button, state, x, y);
        }

        virtual void reshape(int x, int y)
        {
                trackball.reshape(x,y);
                translator.reshape(x,y);
        }

        void apply_transform()
        {
          translator.apply_transform();
          trackball.apply_transform();
        }

        void apply_inverse_transform()
        {
          trackball.apply_inverse_transform();
          translator.apply_inverse_transform();
        }

        matrix4f get_transform()
        {
          return ( translator.get_transform()       *
                           trackball.get_transform() );
        }

        matrix4f get_inverse_transform()
        {
          return ( trackball.get_inverse_transform() *
                           translator.get_inverse_transform()       );
        }

        void set_parent_rotation(rotationf *rp)
        {
                trackball.parent_rotation = rp;
                translator.parent_rotation = rp;
        }

        bool camera_mode;
        glut_trackball trackball;
        glut_translator  translator;
  };

}

#endif