156 lines
5.0 KiB
C++
156 lines
5.0 KiB
C++
// Filename: graphicsPipe.h
|
|
// Created by: mike (09Jan97)
|
|
//
|
|
////////////////////////////////////////////////////////////////////
|
|
//
|
|
// PANDA 3D SOFTWARE
|
|
// Copyright (c) 2001 - 2004, Disney Enterprises, Inc. All rights reserved
|
|
//
|
|
// All use of this software is subject to the terms of the Panda 3d
|
|
// Software license. You should have received a copy of this license
|
|
// along with this source code; you will also find a current copy of
|
|
// the license at http://etc.cmu.edu/panda3d/docs/license/ .
|
|
//
|
|
// To contact the maintainers of this program write to
|
|
// panda3d-general@lists.sourceforge.net .
|
|
//
|
|
////////////////////////////////////////////////////////////////////
|
|
|
|
#ifndef GRAPHICSPIPE_H
|
|
#define GRAPHICSPIPE_H
|
|
|
|
#include "pandabase.h"
|
|
|
|
#include "graphicsDevice.h"
|
|
#include "typedReferenceCount.h"
|
|
#include "pointerTo.h"
|
|
#include "pmutex.h"
|
|
|
|
class GraphicsOutput;
|
|
class GraphicsWindow;
|
|
class GraphicsBuffer;
|
|
class GraphicsStateGuardian;
|
|
class FrameBufferProperties;
|
|
class WindowProperties;
|
|
class Texture;
|
|
|
|
////////////////////////////////////////////////////////////////////
|
|
// Class : GraphicsPipe
|
|
// Description : An object to create GraphicsOutputs that share a
|
|
// particular 3-D API. Normally, there will only be one
|
|
// GraphicsPipe in an application, although it is
|
|
// possible to have multiple of these at once if there
|
|
// are multiple different API's available in the same
|
|
// machine.
|
|
//
|
|
// Often, the GraphicsPipe corresponds to a physical
|
|
// output device, hence the term "pipe", but this is not
|
|
// necessarily the case.
|
|
//
|
|
// The GraphicsPipe is used by the GraphicsEngine object
|
|
// to create and destroy windows; it keeps ownership of
|
|
// the windows it creates.
|
|
//
|
|
// M. Asad added new/interim functionality where GraphicsPipe
|
|
// now contains a device interface to directx/opengl which
|
|
// will be used to handle multiple windows from same device.
|
|
//
|
|
////////////////////////////////////////////////////////////////////
|
|
class EXPCL_PANDA GraphicsPipe : public TypedReferenceCount {
|
|
protected:
|
|
GraphicsPipe();
|
|
private:
|
|
GraphicsPipe(const GraphicsPipe ©);
|
|
void operator = (const GraphicsPipe ©);
|
|
|
|
PUBLISHED:
|
|
virtual ~GraphicsPipe();
|
|
|
|
enum OutputTypes {
|
|
OT_window = 0x0001,
|
|
OT_fullscreen_window = 0x0002,
|
|
OT_buffer = 0x0004,
|
|
OT_texture_buffer = 0x0008,
|
|
};
|
|
|
|
enum BufferCreationFlags {
|
|
// Flags that control what type of output is returned.
|
|
BF_refuse_parasite = 0x0001,
|
|
BF_require_parasite = 0x0002,
|
|
BF_refuse_window = 0x0004,
|
|
BF_require_window = 0x0008,
|
|
|
|
// Miscellaneous control flags.
|
|
BF_can_bind_color = 0x0040, // Need capability: bind the color bitplane to a tex.
|
|
BF_can_bind_every = 0x0080, // Need capability: bind all bitplanes to a tex.
|
|
BF_size_track_host = 0x0100, // Buffer should track the host size.
|
|
BF_rtt_cumulative = 0x0200, // Buffer supports cumulative render-to-texture.
|
|
BF_fb_props_optional = 0x0400, // FrameBufferProperties can be ignored.
|
|
BF_size_square = 0x0800, // x_size must equal y_size (e.g. for cube maps)
|
|
};
|
|
|
|
INLINE bool is_valid() const;
|
|
INLINE int get_supported_types() const;
|
|
INLINE bool supports_type(int flags) const;
|
|
|
|
INLINE int get_display_width() const;
|
|
INLINE int get_display_height() const;
|
|
|
|
virtual string get_interface_name() const=0;
|
|
|
|
public:
|
|
enum PreferredWindowThread {
|
|
PWT_app,
|
|
PWT_draw
|
|
};
|
|
virtual PreferredWindowThread get_preferred_window_thread() const;
|
|
|
|
INLINE GraphicsDevice *get_device() const;
|
|
virtual PT(GraphicsDevice) make_device(void *scrn = NULL);
|
|
|
|
protected:
|
|
virtual void close_gsg(GraphicsStateGuardian *gsg);
|
|
|
|
virtual PT(GraphicsOutput) make_output(const string &name,
|
|
const FrameBufferProperties &fb_prop,
|
|
const WindowProperties &win_prop,
|
|
int flags,
|
|
GraphicsStateGuardian *gsg,
|
|
GraphicsOutput *host,
|
|
int retry,
|
|
bool &precertify);
|
|
|
|
Mutex _lock;
|
|
|
|
bool _is_valid;
|
|
int _supported_types;
|
|
int _display_width;
|
|
int _display_height;
|
|
PT(GraphicsDevice) _device;
|
|
|
|
static const int strip_properties[];
|
|
|
|
public:
|
|
|
|
static TypeHandle get_class_type() {
|
|
return _type_handle;
|
|
}
|
|
static void init_type() {
|
|
TypedReferenceCount::init_type();
|
|
register_type(_type_handle, "GraphicsPipe",
|
|
TypedReferenceCount::get_class_type());
|
|
}
|
|
virtual TypeHandle get_type() const {
|
|
return get_class_type();
|
|
}
|
|
virtual TypeHandle force_init_type() {init_type(); return get_class_type();}
|
|
|
|
private:
|
|
static TypeHandle _type_handle;
|
|
friend class GraphicsEngine;
|
|
};
|
|
|
|
#include "graphicsPipe.I"
|
|
|
|
#endif /* GRAPHICSPIPE_H */
|