ShBackend.hpp

// Sh: A GPU metaprogramming language.
//
// Copyright 2003-2005 Serious Hack Inc.
// 
// This software is provided 'as-is', without any express or implied
// warranty. In no event will the authors be held liable for any damages
// arising from the use of this software.
// 
// Permission is granted to anyone to use this software for any purpose,
// including commercial applications, and to alter it and redistribute it
// freely, subject to the following restrictions:
// 
// 1. The origin of this software must not be misrepresented; you must
// not claim that you wrote the original software. If you use this
// software in a product, an acknowledgment in the product documentation
// would be appreciated but is not required.
// 
// 2. Altered source versions must be plainly marked as such, and must
// not be misrepresented as being the original software.
// 
// 3. This notice may not be removed or altered from any source
// distribution.
#ifndef SHBACKEND_HPP
#define SHBACKEND_HPP

#include <vector>
#include <iosfwd>
#include <string>
#include "ShDllExport.hpp"
#include "ShRefCount.hpp"
#include "ShProgram.hpp"
#include "ShProgramSet.hpp"
#include "ShVariableNode.hpp"

namespace SH  {

class ShStream;

class
SH_DLLEXPORT ShBackendCode : public ShRefCountable {
public:
  virtual ~ShBackendCode();

  virtual bool allocateRegister(const ShVariableNodePtr& var) = 0;

  virtual void freeRegister(const ShVariableNodePtr& var) = 0;
  
  virtual void upload() = 0;

  virtual void bind() = 0;

  virtual void unbind() = 0;

  virtual void update() = 0;

  virtual void updateUniform(const ShVariableNodePtr& uniform) = 0;

  virtual std::ostream& print(std::ostream& out) = 0;

  // (Useful for how to format long tuple input on targets 
  // that only support limited tuple lengths) 
  virtual std::ostream& describe_interface(std::ostream& out) = 0;
};

typedef ShPointer<ShBackendCode> ShBackendCodePtr;
typedef ShPointer<const ShBackendCode> ShBackendCodeCPtr;

// A backend-specific set of programs, to be linked together/bound at once
class
SH_DLLEXPORT ShBackendSet : public ShRefCountable {
public:
  virtual ~ShBackendSet();

  virtual void link() = 0;

  virtual void bind() = 0;
  virtual void unbind() = 0;
};

typedef ShPointer<ShBackendSet> ShBackendSetPtr;
typedef ShPointer<const ShBackendSet> ShBackendSetCPtr;

class ShTransformer;
class
SH_DLLEXPORT ShBackend : public ShRefCountable {
public:
  virtual ~ShBackend();
  virtual std::string name() const = 0;

  virtual ShBackendCodePtr generate_code(const std::string& target,
                                         const ShProgramNodeCPtr& shader) = 0;

  virtual ShBackendSetPtr generate_set(const ShProgramSet& s);
  
  // execute a stream program, if supported
  virtual void execute(const ShProgramNodeCPtr& program, ShStream& dest) = 0;

  // Unbind all programs bound under this backend
  virtual void unbind_all();
  
  typedef std::vector< ShPointer<ShBackend> > ShBackendList;

  static ShBackendList::iterator begin();
  static ShBackendList::iterator end();

  static ShPointer<ShBackend> lookup(const std::string& name);

protected:
  ShBackend();
  
private:
  static void init();

  static ShBackendList* m_backends;
  static bool m_doneInit;
};

typedef ShPointer<ShBackend> ShBackendPtr;
typedef ShPointer<const ShBackend> ShBackendCPtr;

}

#endif

---