texNd.h

Go to the documentation of this file.

//////////////////////////////////////////////////////////////////////
// 9/6/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

#ifndef GLIFT_TEXTURE_ND_H_
#define GLIFT_TEXTURE_ND_H_

#include "singleTex.h"

// The OpenGL object oriented framework. "Lifting" your OpenGL code to new levels.
namespace glift {

/////////////////////////////////////////////////////////////////////////
///
/// Tex1D, Tex2D, Tex3D, TexCube
///   - These are the publicly constructed texture objects
///   - 'texState' is vector of TexState pointers that initialize the texture object's state
///   - 'pbuff' is NULL or a pbuffer pointer that is bound with this texture unit
///   - Texture memory is initialized by passing 'setTexData(...)' functions a 'TexData' object
///   - 'copyToTex*D(...)' copies data from the framebuffer to the texture object
///   - See 'SingleTex' header for rest of public interface
////////////////////////////
///
///     Tex1D   - 2D texture class
///     Tex2D   - 2D texture class
///     Tex3D   - 3D texture class
///     TexCube - Cube map texture class
///                     
/// Tex1D - 1D Textures
/////////////////////////////////////////
class _export_ Tex1D : public CoreTex
{
public:
   Tex1D( const MultiTexOState&  texState, 
      PBuffGlift            *pbuff=NULL );

   Tex1D( const MultiTexOState&  texState, 
      TexData               *texData, 
      PBuffGlift            *pbuff=NULL );

   /// Copy data from framebuffer to this texture
   virtual void copyToTex( int mipLevel,
      const gutz::vec3i& texOrig, 
      const gutz::vec2i& screenOrig, 
      const gutz::vec2i& copySize   );
private:
   Tex1D();
};

/////////////////////////////////////////
/// Tex2D - 2D Textures
/////////////////////////////////////////
class _export_ Tex2D : public CoreTex
{
public:
   Tex2D( const MultiTexOState&  texState, 
      PBuffGlift            *pbuff=NULL );

   Tex2D( const MultiTexOState&  texState, 
      TexData               *texData, 
      PBuffGlift            *pbuff=NULL );

   /// Copy data from framebuffer to this texture
   void copyToTex2D();          /// Fill entire 2D texture from framebuffer             
   virtual void copyToTex( int mipLevel,
      const gutz::vec3i& texOrig, 
      const gutz::vec2i& screenOrig, 
      const gutz::vec2i& copySize   );

private:
   Tex2D(); /// Dissallow default construction
};

/////////////////////////////////////////
/// TexRect - Rectangular Textures (non-power-of-two)
/////////////////////////////////////////
class _export_ TexRect : public CoreTex
{
public:
   TexRect( const MultiTexOState&  texState, 
      PBuffGlift            *pbuff=NULL );

   TexRect( const MultiTexOState&  texState, 
      TexData               *texData, 
      PBuffGlift            *pbuff=NULL );

   /// Copy data from framebuffer to this texture
   void copyToTex2D();          /// Fill entire 2D texture from framebuffer             
   virtual void copyToTex( int mipLevel,
      const gutz::vec3i& texOrig, 
      const gutz::vec2i& screenOrig, 
      const gutz::vec2i& copySize   );

private:
   TexRect(); /// Dissallow default construction
   GLenum getTarget();
};

/////////////////////////////////////////
/// Tex3D - 3D Textures
/////////////////////////////////////////
class _export_ Tex3D : public CoreTex
{
public:
   Tex3D( const MultiTexOState& texState, 
      TexData*              texData );

   /// Copy data from framebuffer to this texture
   virtual void copyToTex( int mipLevel,
      const gutz::vec3i& texOrig, 
      const gutz::vec2i& screenOrig, 
      const gutz::vec2i& copySize   );

private:
   Tex3D(); /// Dissallow default construction
};

/////////////////////////////////////////
/// TexCube - CubeMap Textures
/////////////////////////////////////////
class _export_ TexCube : public CoreTex
{
public:
   /// Constructors - If 'texData' is given, it must have size 6. The data is mapped in order:
   ///                            PX, NX, PY, NY, PZ, NZ (in positions 0..5)
   TexCube( const MultiTexOState& texState, 
      const VecTexDataP&    texData=VecTexDataP() );

   TexCube( const MultiTexOState&  texState,
      PBuffGlift            *pbPX, 
      PBuffGlift            *pbNX, 
      PBuffGlift            *pbPY, 
      PBuffGlift            *pbNY, 
      PBuffGlift            *pbPZ, 
      PBuffGlift            *pbNZ,
      const VecTexDataP& texData=VecTexDataP() );

   /// CubeMap set function. 
   void setTexData( const VecTexDataP& dataVec ) { initData(dataVec); }
   void setTexData( GLenum cubeFace, TexData* texData, int mipLevel=0, bool setTexSize=true );

   /// Copy data from framebuffer to this texture
   void          setCopyCubeFace( GLenum cubeFace );            /// Set the target for a glCopyTexImage(...)
   void          copyToTex( GLenum cubeFace );                          /// Fill entire cubeFace with entire framebuffer contents
   virtual void copyToTex( int mipLevel,
      const gutz::vec3i& texOrig, 
      const gutz::vec2i& screenOrig, 
      const gutz::vec2i& copySize   );

protected:
   virtual void bindDef();
   virtual void releaseDef();

private:
   VecPbuffP    m_pbuff;         /// Vector of pbuffer pointers. One for each cube face
   GLenum               m_writeFace; /// Current cube face to which copyToTex(..) will write

   TexCube(); /// Dissallow default construction

   void checkCubeFace( GLenum cubeFace ); /// Ensure that cubeFace is valid
   void initPbuffVec( PBuffGlift* pbPX, PBuffGlift* pbNX,  PBuffGlift* pbPY, PBuffGlift* pbNY, PBuffGlift* pbPZ, PBuffGlift* pbNZ );
   void initData(  const VecTexDataP& texData );
};

} /// End of glift namespace
#endif

---

Send questions, comments, and bug reports to: