/home/master/UCL/VisualizationLibrary/src/vlGraphics/Renderable.hpp

Go to the documentation of this file.

/**************************************************************************************/
/*                                                                                    */
/*  Visualization Library                                                             */
/*  http://visualizationlibrary.org                                                   */
/*                                                                                    */
/*  Copyright (c) 2005-2010, Michele Bosi                                             */
/*  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.                                   */
/*                                                                                    */
/*  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 COPYRIGHT HOLDER 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.                      */
/*                                                                                    */
/**************************************************************************************/

#ifndef Renderable_INCLUDE_ONCE
#define Renderable_INCLUDE_ONCE

#include <vlCore/Object.hpp>
#include <vlCore/Transform.hpp>
#include <vlCore/AABB.hpp>
#include <vlCore/Sphere.hpp>
#include <vlCore/Log.hpp>
#include <vlGraphics/OpenGL.hpp>

namespace vl
{
  //------------------------------------------------------------------------------
  // Renderable
  //------------------------------------------------------------------------------
  class Actor;
  class Shader;
  class Transform;
  class Camera;
  class OpenGLContext;
  class VLGRAPHICS_EXPORT Renderable: public Object
  {
    VL_INSTRUMENT_ABSTRACT_CLASS(vl::Renderable, Object)

    Renderable(const Renderable& other): Object(other)
    {
      VL_DEBUG_SET_OBJECT_NAME()
    }

  public:
    Renderable(): mBoundsUpdateTick(0), mDisplayList(0), mBoundsDirty(true), 
                  mDisplayListEnabled(false), mDisplayListDirty(true), mBufferObjectEnabled(true), mBufferObjectDirty(true){}
    
    virtual ~Renderable() { deleteDisplayList(); }

    void render(const Actor* actor, const Shader* shader, const Camera* camera, OpenGLContext* gl_context)
    {
      VL_CHECK_OGL();
      
      // display list have priority over BufferObjects
      if (isDisplayListEnabled())
      {
        if ( displayListDirty() )
        {
          if ( !displayList() )
          {
            setDisplayList( glGenLists(1) ); VL_CHECK_OGL();
          }
          VL_CHECK( displayList() );
          glNewList( displayList(), GL_COMPILE_AND_EXECUTE ); VL_CHECK_OGL();
            render_Implementation( actor, shader, camera, gl_context ); VL_CHECK_OGL();
          glEndList(); VL_CHECK_OGL();
          setDisplayListDirty( false );
        }
        else
        {
          VL_CHECK( displayList() );
          glCallList( displayList() );
        }
      }
      else
      {
        // update BufferObjects
        if (isBufferObjectEnabled() && isBufferObjectDirty())
        {
          updateDirtyBufferObject(BUM_KeepRamBuffer);
          setBufferObjectDirty(false);
        }

        // render
        render_Implementation( actor, shader, camera, gl_context ); VL_CHECK_OGL();
      }
      VL_CHECK_OGL();
    }

    void computeBounds() { computeBounds_Implementation(); setBoundsDirty(false); }

    long long boundsUpdateTick() const { return mBoundsUpdateTick; }
    
    void setBoundsDirty(bool dirty) { mBoundsDirty = dirty; }
    
    bool boundsDirty() const { return mBoundsDirty; }
    
    void setBoundingBox( const AABB& aabb )
    { 
      if (mAABB != aabb) 
      { 
        mAABB = aabb; 
        ++mBoundsUpdateTick; 
      } 
      setBoundsDirty(false); 
    }
    
    void setBoundingSphere( const Sphere& sphere) 
    { 
      if (mSphere != sphere) 
      {
        mSphere = sphere; 
        ++mBoundsUpdateTick; 
      }
      setBoundsDirty(false); 
    }
    
    const AABB& boundingBox() const 
    { 
      if (boundsDirty())
        vl::Log::warning("Renderable::boundingBox() returning dirty bounding box, call computeBounds() first or call boundingBox() from a non-const Renderable!\n");
      return mAABB; 
    }
    
    const Sphere& boundingSphere() const 
    { 
      if (boundsDirty())
        vl::Log::warning("Renderable::boundingSphere() returning dirty bounding sphere, call computeBounds() first or call boundingSphere() from a non-const Renderable!\n");
      return mSphere; 
    }

    const AABB& boundingBox() 
    { 
      if (boundsDirty())
        computeBounds();
      return mAABB; 
    }
    
    const Sphere& boundingSphere() 
    { 
      if (boundsDirty())
        computeBounds();
      return mSphere; 
    }

    unsigned int displayList() const { return mDisplayList; }
    
    void setDisplayList(unsigned int disp_list) { mDisplayList = disp_list; }

    bool isDisplayListEnabled() const { return mDisplayListEnabled; }

    void setDisplayListEnabled(bool enabled) { mDisplayListEnabled = enabled; }

    bool displayListDirty() const { return mDisplayListDirty; }
    
    void setDisplayListDirty(bool dirty) { mDisplayListDirty = dirty; }

    bool isBufferObjectEnabled() const { return mBufferObjectEnabled; }

    void setBufferObjectEnabled(bool enabled) { mBufferObjectEnabled = enabled; }

    bool isBufferObjectDirty() const { return mBufferObjectDirty; }

    void setBufferObjectDirty(bool dirty) { mBufferObjectDirty = dirty; }

    virtual void updateDirtyBufferObject(EBufferObjectUpdateMode) = 0;

    virtual void deleteBufferObject() = 0;

    void deleteDisplayList() 
    {
      if (displayList())
        glDeleteLists(displayList(), 1);
      mDisplayList = 0;
    }

  protected:
    virtual void computeBounds_Implementation() = 0;
    virtual void render_Implementation(const Actor* actor, const Shader* shader, const Camera* camera, OpenGLContext* gl_context) const = 0;

  private:
    long long mBoundsUpdateTick;
    unsigned int mDisplayList;
    bool mBoundsDirty;
    bool mDisplayListEnabled;
    bool mDisplayListDirty;
    bool mBufferObjectEnabled;
    bool mBufferObjectDirty;
    AABB mAABB;
    Sphere mSphere;
  };
}

#endif