implementation.H

/*
 * This file is part of the "Archon" framework.
 * (http://files3d.sourceforge.net)
 *
 * Copyright © 2006 by Kristian Spangsege and Brian Kristiansen.
 *
 * Permission to use, copy, modify, and distribute this software and
 * its documentation under the terms of the GNU General Public License is
 * hereby granted. No representations are made about the suitability of
 * this software for any purpose. It is provided "as is" without express
 * or implied warranty. See the GNU General Public License
 * (http://www.gnu.org/copyleft/gpl.html) for more details.
 *
 * The characters in this file are ISO8859-1 encoded.
 *
 * The documentation in this file is in "Doxygen" style
 * (http://www.doxygen.org).
 */

#ifndef ARCHON_DISPLAY_IMPLEMENTATION_H
#define ARCHON_DISPLAY_IMPLEMENTATION_H

#include <stdexcept>
#include <string>

#include <archon/util/exception.H>
#include <archon/util/ref.H>
#include <archon/display/connection.H>

namespace Archon
{
  namespace Display
  {
    using namespace std;
    using namespace Utilities;

    // Fallback declarations. A fallback declaration for class Foo is
    // needed when the header that defines Foo includes this
    // header. In this case this header will not include "foo.H" due
    // to include guards, and Foo would be unknown.
    struct Connection;


    struct NoImplementationException: virtual Exception
    {
      NoImplementationException(string l): Exception(l) {}
    };

    struct NoDisplayException: virtual Exception
    {
      NoDisplayException(string l): Exception(l) {}
      NoDisplayException(string l, string m): Exception(l, m) {}
    };


    struct Implementation: virtual RefObjectBase
    {
      virtual string getMnemonic() = 0;

      virtual Ref<Connection> newConnection() throw(NoDisplayException) = 0;
    };


    Ref<Implementation> getDefaultImplementation() throw(NoImplementationException);

    int getNumberOfImplementations();

    Ref<Implementation> getImplementation(int index) throw(out_of_range);
  }
}

#endif // ARCHON_DISPLAY_IMPLEMENTATION_H

---