164 lines
5.2 KiB
C++
164 lines
5.2 KiB
C++
/**
|
|
* PANDA 3D SOFTWARE
|
|
* Copyright (c) Carnegie Mellon University. All rights reserved.
|
|
*
|
|
* All use of this software is subject to the terms of the revised BSD
|
|
* license. You should have received a copy of this license along
|
|
* with this source code in a file named "LICENSE."
|
|
*
|
|
* @file graphicsPipe.h
|
|
* @author mike
|
|
* @date 1997-01-09
|
|
*/
|
|
|
|
#ifndef GRAPHICSPIPE_H
|
|
#define GRAPHICSPIPE_H
|
|
|
|
#include "pandabase.h"
|
|
|
|
#include "graphicsDevice.h"
|
|
#include "typedReferenceCount.h"
|
|
#include "pointerTo.h"
|
|
#include "lightMutex.h"
|
|
|
|
class GraphicsEngine;
|
|
class GraphicsOutput;
|
|
class GraphicsWindow;
|
|
class GraphicsBuffer;
|
|
class GraphicsStateGuardian;
|
|
class FrameBufferProperties;
|
|
class WindowProperties;
|
|
class Texture;
|
|
class WindowHandle;
|
|
class DisplayInformation;
|
|
|
|
/**
|
|
* 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_DISPLAY GraphicsPipe : public TypedReferenceCount {
|
|
protected:
|
|
GraphicsPipe();
|
|
GraphicsPipe(const GraphicsPipe ©) = delete;
|
|
GraphicsPipe &operator = (const GraphicsPipe ©) = delete;
|
|
|
|
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,
|
|
BF_require_callback_window = 0x0010,
|
|
|
|
// 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_resizeable = 0x0100, // Buffer should allow set_size.
|
|
BF_size_track_host = 0x0200, // Buffer should track the host size.
|
|
BF_rtt_cumulative = 0x0400, // Buffer supports cumulative render-to-texture.
|
|
BF_fb_props_optional = 0x0800, // FrameBufferProperties can be ignored.
|
|
BF_size_square = 0x1000, // x_size must equal y_size (e.g. for cube maps)
|
|
BF_size_power_2 = 0x2000, // x_size and y_size must each be a power of two
|
|
BF_can_bind_layered = 0x4000, // Need capability: support RTM_bind_layered.
|
|
};
|
|
|
|
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;
|
|
MAKE_PROPERTY(display_width, get_display_width);
|
|
MAKE_PROPERTY(display_height, get_display_height);
|
|
|
|
DisplayInformation *get_display_information();
|
|
MAKE_PROPERTY(display_information, get_display_information);
|
|
|
|
virtual void lookup_cpu_data();
|
|
|
|
virtual std::string get_interface_name() const=0;
|
|
MAKE_PROPERTY(interface_name, get_interface_name);
|
|
|
|
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 = nullptr);
|
|
|
|
virtual PT(GraphicsStateGuardian) make_callback_gsg(GraphicsEngine *engine);
|
|
|
|
protected:
|
|
virtual void close_gsg(GraphicsStateGuardian *gsg);
|
|
|
|
virtual PT(GraphicsOutput) make_output(const std::string &name,
|
|
const FrameBufferProperties &fb_prop,
|
|
const WindowProperties &win_prop,
|
|
int flags,
|
|
GraphicsEngine *engine,
|
|
GraphicsStateGuardian *gsg,
|
|
GraphicsOutput *host,
|
|
int retry,
|
|
bool &precertify);
|
|
|
|
LightMutex _lock;
|
|
|
|
bool _is_valid;
|
|
int _supported_types;
|
|
int _display_width;
|
|
int _display_height;
|
|
PT(GraphicsDevice) _device;
|
|
|
|
DisplayInformation *_display_information;
|
|
|
|
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 */
|