---

sglScene.hpp

/*****************************************************************************
 * SGL: A Scene Graph Library
 *
 * Copyright (C) 1997-2001  Scott McMillan   All Rights Reserved.
 *
 * This library is free software; you can redistribute it and/or
 * modify it under the terms of the GNU Library General Public
 * License as published by the Free Software Foundation; either
 * version 2 of the License, or (at your option) any later version.
 *
 * This library is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
 * Library General Public License for more details.
 *
 * You should have received a copy of the GNU Library General Public
 * License along with this library; if not, write to the Free
 * Software Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
 *****************************************************************************
 *     File: sglScene.hpp
 *  Created: 2 January 1999
 *  Summary: Root node in a scene graph initializes and begins the traversal
 *****************************************************************************/

#ifndef __SGL_SCENE_HPP
#define __SGL_SCENE_HPP

#include <sgl.h>
#include <sglGroup.hpp>
#include <sglPolytope.hpp>
#include <sglCull.hpp>

class sglViewPlatform;

//----------------------------------------------------------------------------

class SGL_DLL_API sglScene : public sglGroup
{
public:
   sglScene();
   virtual ~sglScene();

   static float computeLODScale(float fov_x, float fov_y,
                                unsigned int viewport_x,
                                unsigned int viewport_y);

   static void createDefaultStatelets(vector<const sglStatelet*> &def);

   void preDraw();

   void preDraw(const sglTimespec &frame_time, unsigned int frame_count);

   virtual void preDraw(const PreDrawStruct &trav) { sglGroup::preDraw(trav); }

   unsigned int getFrameCount() const { return m_frame_count; }

   const sglTimespec &getFrameTime() const { return m_frame_time; }

   // ----------------- single precision cull functions --------------------

   void cull(sglCullf &trav_state,
             float fov_x, float fov_y,
             unsigned int viewport_x, unsigned int viewport_y,
             const sglFrustumf &orig_frustum,
             const sglMat4f &view_matrix,
             const deque<const sglStatelet*> &override_statelets,
             unsigned int discriminator_mask = 0,
             unsigned int state_mask = 0) const;

   void cull(sglCullf &trav_state,
             unsigned int viewport_x, unsigned int viewport_y,
             const sglViewPlatform &view_platform,
             const deque<const sglStatelet*> &override_statelets,
             unsigned int discriminator_mask = 0,
             unsigned int state_mask = 0) const;

   void drawCulled(float fov_x, float fov_y,
                   unsigned int viewport_x, unsigned int viewport_y,
                   const sglFrustumf &orig_frustum,
                   const sglMat4f &view_matrix,
                   const deque<const sglStatelet*> &override_statelets,
                   unsigned int discriminator_mask = 0,
                   unsigned int state_mask = 0) const;

   // ----------------- double precision cull functions --------------------

   void cull(sglCulld &trav_state,
             float fov_x, float fov_y,
             unsigned int viewport_x, unsigned int viewport_y,
             const sglFrustumd &orig_frustum,
             const sglMat4d &view_matrix,
             const deque<const sglStatelet*> &override_statelets,
             unsigned int discriminator_mask = 0,
             unsigned int state_mask = 0) const;

   void cull(sglCulld &trav_state,
             unsigned int viewport_x, unsigned int viewport_y,
             const sglViewPlatform &view_platform,
             const deque<const sglStatelet*> &override_statelets,
             unsigned int discriminator_mask = 0,
             unsigned int state_mask = 0) const;

   void drawCulled(float fov_x, float fov_y,
                   unsigned int viewport_x, unsigned int viewport_y,
                   const sglFrustumd &orig_frustum,
                   const sglMat4d &view_matrix,
                   const deque<const sglStatelet*> &override_statelets,
                   unsigned int discriminator_mask = 0,
                   unsigned int state_mask = 0) const;

   // See sglNode::clone() for details.
   virtual sglNode *clone(unsigned int mode) const;

   // See sglObject::printInfo() for details.
   virtual void printInfo(ostream &ostrm, const char *indent_string) const;

protected:
   // uses sglGroup's versions of these - these are here to avoid MIPSPro
   // compiler warnings:

   // see sglNode::cull(f) for details
   virtual void cull(sglCull<float> &trav_state,
                     unsigned int cull_flags) const
      {
         sglGroup::cull(trav_state, cull_flags);
      }

   // see sglNode::cull(d) for details
   virtual void cull(sglCull<double> &trav_state,
                     unsigned int cull_flags) const
      {
         sglGroup::cull(trav_state, cull_flags);
      }

   void copyTo(sglScene *dst, unsigned int mode) const;

private:
   sglScene(const sglScene &);            // not implemented
   sglScene &operator=(const sglScene&);  // not implemented

private:
   vector<const sglStatelet*>  m_default_statelets;

   unsigned int m_frame_count;
   sglTimespec  m_frame_time;
};

#endif

---