visual.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_VISUAL_H
#define ARCHON_DISPLAY_VISUAL_H

#include <stdexcept>
#include <string>

#include <archon/util/exception.H>
#include <archon/util/ref.H>
#include <archon/display/screen.H>
#include <archon/display/window.H>
#include <archon/display/context.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 Screen;
    struct Window;
    struct Context;


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


    struct Visual: virtual RefObjectBase
    {
      virtual Ref<Screen> getScreen() = 0;

      virtual Ref<Window> newWindow(int left, int top,
                                    int width, int height,
                                    string title = "")
        throw(NoWindowsException) = 0;

      virtual Ref<Context> newContext(bool direct = true,
                                      Ref<Context> shareWith = 0)
        throw(invalid_argument) = 0;


      virtual int getRedBufferSize() = 0;

      virtual int getGreenBufferSize() = 0;

      virtual int getBlueBufferSize() = 0;

      virtual int getAlphaBufferSize() = 0;

      virtual int getDepthBufferSize() = 0;

      virtual int getStencilBufferSize() = 0;

      virtual int getAccumRedBufferSize() = 0;

      virtual int getAccumGreenBufferSize() = 0;

      virtual int getAccumBlueBufferSize() = 0;

      virtual int getAccumAlphaBufferSize() = 0;
    };
  }
}

#endif // ARCHON_DISPLAY_VISUAL_H

---