pixelShaderATI8K.h

Go to the documentation of this file.

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


#if !defined(AFX_ATIPIXELSHADER_H__FC907450_D5EC_4CF6_B230_3EEDD8897081__INCLUDED_)
#define AFX_ATIPIXELSHADER_H__FC907450_D5EC_4CF6_B230_3EEDD8897081__INCLUDED_

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

#include "stateGLI.h"
#include "pbuffGlift.h"
#include <GL/glew.h>
#include "../util/command.h"

namespace glift {

/////////////////////////////////////////////////////////////////////////
///
/// pixelShaderATI.h: interface for the PixelShaderATI class.
///
/// - Class for an ATI fragment shader.
///
/// - The constructor takes either a callback to a "void name()" routine
///   or a MemberCommand0 callback object that encapsulates a calling class
///   instance and a "void name()" method. The "void name()" function/method
///   contains the code that actually defines the shader.
///
///   Examples: 1) PixelShaderATI shader0 = new PixelShaderATI( shaderDefFunc );
///
//                            AClass a;
//                         2) PixelShaderATI shader3 = new PixelShaderATI( new MemberCommand0(&a, &a::shaderDefFunc) );
//                                **Note: ~PixelShaderATI() destroys the command (callback) object.
//                                
/// - The class constructor takes care of all state except the actual 
///   shader (eg. the first instruction in the callback should be 
///   'glSampleMapATI(...)' or glPassTexCoordATI. The last instruction 
///   should be a write to R0.
///   
/// - Note that the bind/release methods do NOT ensure that 'm_pbuff'
///   is enabled. If the shader is created inside a pbuffer context,
///   it is up to you to make sure that the context is current before
///   using the shader. This is for efficiency reasons. 
///   
/// - The 'm_pbuff' context IS enabled/disabled for initialization and 
///   destruction of the shader.
///////////////////////////////////////////////////////////////////////
class _export_ PixelShaderATI8K : public PixelShader  
{
public:
   PixelShaderATI8K( VoidFuncPtr defineShader, PBuffGlift* pbuff=NULL );
   PixelShaderATI8K( Command* defineShader, PBuffGlift* pbuff=NULL ); 

   PixelShaderATI8K( const PixelShaderATI8K& rhs );
   PixelShaderATI8K& operator=( const PixelShaderATI8K& rhs );
   virtual ~PixelShaderATI8K();

   virtual void reset(); //Destroy OpenGL shader object and re-initialize shader.
   virtual void setLocalConstf( unsigned int constNum, const gutz::vec4f& val );

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

private:
   Command*      m_defineShader;        /// Callback to function or method that defines shader of type 'void Name()'
   GLuint                m_shaderNum;           /// OpenGL shader object number
   PBuffGlift*   m_pbuff;                       /// The pbuffer context in which this shader exists (optional)

   void init();
   void destroy();
   void initMembers( const PixelShaderATI8K& rhs );
   void initMembers( Command* defineShader, GLuint shaderNum, PBuffGlift* pbuff );
};

} /// End of namespace glift

#endif /// !defined(AFX_ATIPIXELSHADER_H__FC907450_D5EC_4CF6_B230_3EEDD8897081__INCLUDED_)

---

Send questions, comments, and bug reports to: