subdivPlanarQuadS.h

Go to the documentation of this file.

//////////////////////////////////////////////////////////////////////
// 8/14/02      Aaron Lefohn    Scientific Computing and Imaging Institute
// School of Computing          University of Utah
//
//  This library is free software; you can redistribute it and/or
//  modify it under the terms of the GNU Lesser General Public
//  License as published by the Free Software Foundation; either
//  version 2.1 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
//  Lesser General Public License for more details.
//
//  You should have received a copy of the GNU Lesser General Public
//  License along with this library; if not, write to the Free Software
//  Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA

#if !defined(AFX_SUBDIVPLANARQUAD_H__3B8C720A_3269_439D_B67D_27B68936C7E8__INCLUDED_)
#define AFX_SUBDIVPLANARQUAD_H__3B8C720A_3269_439D_B67D_27B68936C7E8__INCLUDED_

#if _MSC_VER > 1000
#pragma once
#endif // _MSC_VER > 1000

#include <mathGutz.h>
#include <arrayGutz.h>
#include "planarQuadZ.h"
#include "../texCoordGen/scaleTexGen2D.h"
//#include "pixelTile.h"

namespace glift {

typedef std::vector<gutz::vec3f> Vecvec3f;
typedef std::vector<gutz::vec2i> Vecvec2i;

/////////////////////////////////////////////////////////////////////////
///
/// subdivPlanarQuad.h: interface for the SubdivPlanarQuadS class.
///
/// - A subdivided planar quad. 
/// - Currently 'primType' can ONLY be GL_QUADS. \n
///    (Need different indices generators for GL_TRIANGLES)
/// - Lowerleft and upperRight are assumed to be in the XY plane \n
///    (only the x,y components are read). 
///   The quad is therefore always orthogonal to the Z axis with a normal = <0,0,1>
/// - If 'genTexCoords' is true, but no 'altTexGen' is given, the ScaleTexGen2D texCoord
///   generator is used. The 'altTexGen' parameter is used for alternate tex coord generation.
/// - Generates a SINGLE  primitive using vertex arrays and indices (hence the S in the name)
/// - 'sharedVerts' specifies if the shared-vertex or redundant-vertex subdiv
///    quad is built.
/// - Patch numbering begins at lower-left and reads right and then up \n
///    (OpenGL coord convention)
///////////////////////////////////////////////////////////////////////

class _export_ SubdivPlanarQuadS : public PlanarQuadZ
{
public:
   SubdivPlanarQuadS( GLenum primType, const gutz::vec2i& subDiv,
      const gutz::vec2f& lowerLeft, const gutz::vec2f& upperRight, /// z=0.0
      bool genTexCoords=false, bool genNorms=false, bool sharedVerts=true,
      TexCoordGen* altTexGen=NULL);

   SubdivPlanarQuadS( GLenum primType, const gutz::vec2i& subDiv,
      const gutz::vec2f& lowerLeft, const gutz::vec2f& upperRight, float z=0.0f, 
      bool genTexCoords=false, bool genNorms=false, bool sharedVerts=true,
      TexCoordGen* altTexGen=NULL);

   virtual ~SubdivPlanarQuadS();

   virtual gutz::vec2f lowerLeft()  const {return m_lowerLeft;}
   virtual gutz::vec2f upperRight() const {return m_upperRight;}
   virtual gutz::vec2i subDiv()  const {return m_subDiv;}
   gutz::vec2i lgSubDiv()        const {return m_lgSubDiv;}
   virtual float z()                             const {return m_z;}
   virtual int   numActivePatches() const {return m_numActivePatches;}
   PrimGL* prim()                        const {return m_prim;}

   void bindQuads( const gutz::arrayw1ui& patchIndices );/// Specify which patches are to be drawn by their patch indices
   void bindQuads( const Vecvec2i& patches );                     /// Specify which patches are to be drawn by their subdiv coords
   void releaseQuads() {releaseIndices();}                                /// Draw all quads

   //   gutz::arrayWrap2<PixelTile*> tiles() const {return gutz::arrayWrap2<PixelTile*>(m_tiles);}

private:                
   gutz::vec2f          m_lowerLeft;
   gutz::vec2f          m_upperRight;
   float                        m_z;
   int                          m_numActivePatches;
   gutz::vec2i          m_subDiv;               /// Number of subdivisions in each dimension
   gutz::vec2i          m_lgSubDiv;             /// log (base 2) of subDiv. Only valid if m_subDiv components are powers of two.

   gutz::arrayo1ui m_indices;
   bool                 m_useShared;    /// Shared or redundant vertex version?
   //   gutz::arrayOwn2<PixelTile*> m_tiles;
   PrimGL*                      m_prim;
   //gutz::arrayo1ui m_curIndices;      /// Current indices

   SubdivPlanarQuadS();/// Disallow default construction, copy, and assignment

   /// Create subDivQuad with shared or redundant vertices (m_useShared controls which)
   void init( GLenum primType, const gutz::vec2i& subDiv,
      const gutz::vec2f& lowerLeft, const gutz::vec2f& upperRight, 
      float z, bool genTexCoords, bool genNorms,
      TexCoordGen* texGen );

   // Create the tiles 
   //   void initTiles( const gutz::arrayo2f& vert, const gutz::arrayo2f& texCoord, 
   //                                   gutz::arrayo1ui& indices );

   /// Create subDivQuad with shared vertices (minimum number of possible verts)
   void initShared( const gutz::vec2i& subDiv, const gutz::vec3f& quadScale, float z, const gutz::vec3f& normVec,
      gutz::arrayo2f& vert, gutz::arrayo2f& norm, gutz::arrayo1ui& indices );

   /// Create subDivQuad with redundant vertices. Eeach one gets own texCoords and colors
   void initRedundant( const gutz::vec2i& subDiv, const gutz::vec3f& quadScale, float z, const gutz::vec3f& normVec, 
      gutz::arrayo2f& vert, gutz::arrayo2f& norm, gutz::arrayo1ui& indices );
};

} /// End of namespace glift

#endif /// !defined(AFX_SUBDIVPLANARQUAD_H__3B8C720A_3269_439D_B67D_27B68936C7E8__INCLUDED_)

---

Send questions, comments, and bug reports to: