Main Page   Class Hierarchy   Alphabetical List   Compound List   File List   Compound Members   File Members  

WinGraphicsPipe Class Reference

This is an abstract base class for wglGraphicsPipe and wdxGraphicsPipe; that is, those graphics pipes that are specialized for working with Microsoft Windows. More...

#include <winGraphicsPipe.h>

Inheritance diagram for WinGraphicsPipe:

GraphicsPipe TypedReferenceCount TypedObject ReferenceCount wdxGraphicsPipe7 wdxGraphicsPipe8 wglGraphicsPipe List of all members.

Public Member Functions

 WinGraphicsPipe ()
virtual ~WinGraphicsPipe ()
virtual TypeHandle get_type () const
virtual TypeHandle force_init_type ()
bool is_valid () const
 Returns false if this pipe is known to be invalid, meaning that an attempt to create a GraphicsWindow with the pipe will certainly fail.

bool supports_fullscreen () const
 Returns false if this pipe is known to not support any creation of fullscreen windows.

int get_display_width () const
 Returns the width of the entire display, if it is known.

int get_display_height () const
 Returns the height of the entire display, if it is known.

virtual string get_interface_name () const=0
virtual int get_num_hw_channels ()
 Returns the number of hardware channels available for pipes of this type.

virtual HardwareChannel * get_hw_channel (GraphicsWindow *window, int index)
 Creates and returns an accessor to the HardwareChannel at the given index number, which must be in the range 0 <= index < get_num_hw_channels().

int get_type_index () const
 Returns the internal index number associated with this object's TypeHandle, a unique number for each different type.

bool is_of_type (TypeHandle handle) const
 Returns true if the current object is or derives from the indicated type.

bool is_exact_type (TypeHandle handle) const
 Returns true if the current object is the indicated type exactly.

int get_ref_count () const
 Returns the current reference count.

int ref () const
 Explicitly increments the reference count.

int unref () const
 Explicitly decrements the reference count.

void test_ref_count_integrity () const
 Does some easy checks to make sure that the reference count isn't completely bogus.


Static Public Member Functions

TypeHandle get_class_type ()
void init_type ()

Protected Member Functions

virtual PointerTo< GraphicsStateGuardian > make_gsg (const FrameBufferProperties &properties)
 Creates a new GSG to use the pipe (but no windows have been created yet for the GSG).

virtual void close_gsg (GraphicsStateGuardian *gsg)
 This will be called in the draw thread (the same thread in which the GSG was created via make_gsg, above) to close the indicated GSG and free its associated graphics objects just before it is destructed.

virtual PointerTo< GraphicsWindow > make_window (GraphicsStateGuardian *gsg)=0

Protected Attributes

Mutex _lock
bool _is_valid
bool _supports_fullscreen
int _display_width
int _display_height

Private Types

typedef BOOL(WINAPI * PFN_TRACKMOUSEEVENT )(LPTRACKMOUSEEVENT)

Private Attributes

HINSTANCE _hUser32
PFN_TRACKMOUSEEVENT _pfnTrackMouseEvent

Static Private Attributes

TypeHandle _type_handle

Friends

class WinGraphicsWindow

Detailed Description

This is an abstract base class for wglGraphicsPipe and wdxGraphicsPipe; that is, those graphics pipes that are specialized for working with Microsoft Windows.

There isn't much code here, since most of the fancy stuff is handled in WinGraphicsWindow. You could make a case that we don't even need a WinGraphicsPipe class at all, but it is provided mainly for completeness.

Definition at line 54 of file winGraphicsPipe.h.

Member Typedef Documentation

typedef BOOL(WINAPI * WinGraphicsPipe::PFN_TRACKMOUSEEVENT)(LPTRACKMOUSEEVENT) [private]
 

Definition at line 61 of file winGraphicsPipe.h.

Constructor & Destructor Documentation

WinGraphicsPipe::WinGraphicsPipe (   ) 
 

Definition at line 36 of file winGraphicsPipe.cxx.

References _hUser32, _pfnTrackMouseEvent, and NULL.

WinGraphicsPipe::~WinGraphicsPipe (   )  [virtual]
 

Definition at line 57 of file winGraphicsPipe.cxx.

References NULL.

Member Function Documentation

void GraphicsPipe::close_gsg (  GraphicsStateGuardian *  gsg  )  [protected, virtual, inherited]
 

This will be called in the draw thread (the same thread in which the GSG was created via make_gsg, above) to close the indicated GSG and free its associated graphics objects just before it is destructed.

This method exists to provide a hook for the graphics pipe to do any necessary cleanup, if any.

Definition at line 173 of file graphicsPipe.cxx.

virtual TypeHandle WinGraphicsPipe::force_init_type (  void   )  [inline, virtual]
 

Reimplemented from GraphicsPipe.

Reimplemented in wdxGraphicsPipe7, wdxGraphicsPipe8, and wglGraphicsPipe.

Definition at line 76 of file winGraphicsPipe.h.

TypeHandle WinGraphicsPipe::get_class_type (  void   )  [inline, static]
 

Reimplemented from GraphicsPipe.

Reimplemented in wdxGraphicsPipe7, wdxGraphicsPipe8, and wglGraphicsPipe.

Definition at line 65 of file winGraphicsPipe.h.

Referenced by wglGraphicsPipe::get_class_type(), and wglGraphicsPipe::init_type().

int GraphicsPipe::get_display_height (   )  const [inline, inherited]
 

Returns the height of the entire display, if it is known.

This may return 0. See the caveats for get_display_width().

Definition at line 115 of file graphicsPipe.I.

int GraphicsPipe::get_display_width (   )  const [inline, inherited]
 

Returns the width of the entire display, if it is known.

This may return 0. This is not a guarantee that windows (particularly fullscreen windows) may not be created larger than this width, but it is intended to provide a hint to the application.

Definition at line 98 of file graphicsPipe.I.

HardwareChannel * GraphicsPipe::get_hw_channel (  GraphicsWindow *  window,
int  index
)  [virtual, inherited]
 

Creates and returns an accessor to the HardwareChannel at the given index number, which must be in the range 0 <= index < get_num_hw_channels().

This function will return NULL if the index number is out of range or the hardware channel at that index is unavailable.

Most kinds of GraphicsPipes do not have any special hardware channels available, and this function will always return NULL.

Definition at line 129 of file graphicsPipe.cxx.

References GraphicsStateGuardian::close_gsg(), and NULL.

virtual string GraphicsPipe::get_interface_name (   )  const [pure virtual, inherited]
 

Implemented in wdxGraphicsPipe7, wdxGraphicsPipe8, glxGraphicsPipe, and wglGraphicsPipe.

int GraphicsPipe::get_num_hw_channels (   )  [virtual, inherited]
 

Returns the number of hardware channels available for pipes of this type.

See get_hw_channel().

Definition at line 98 of file graphicsPipe.cxx.

int ReferenceCount::get_ref_count (   )  const [inline, inherited]
 

Returns the current reference count.

Definition at line 183 of file referenceCount.I.

Referenced by RenderState::determine_bin_index(), RenderEffects::determine_show_bounds(), FontPool::ns_garbage_collect(), TexturePool::ns_garbage_collect(), MaterialPool::ns_get_material(), and TexturePool::ns_release_texture().

virtual TypeHandle WinGraphicsPipe::get_type (  void   )  const [inline, virtual]
 

Reimplemented from GraphicsPipe.

Reimplemented in wdxGraphicsPipe7, wdxGraphicsPipe8, and wglGraphicsPipe.

Definition at line 73 of file winGraphicsPipe.h.

int TypedObject::get_type_index (   )  const [inline, inherited]
 

Returns the internal index number associated with this object's TypeHandle, a unique number for each different type.

This is equivalent to get_type().get_index().

Definition at line 71 of file typedObject.I.

References TypeHandle::get_name(), TypedObject::get_type(), and INLINE.

void WinGraphicsPipe::init_type (  void   )  [inline, static]
 

Reimplemented from GraphicsPipe.

Reimplemented in wdxGraphicsPipe7, wdxGraphicsPipe8, and wglGraphicsPipe.

Definition at line 68 of file winGraphicsPipe.h.

References EXPCL_PANDAWIN.

Referenced by wglGraphicsPipe::init_type().

bool TypedObject::is_exact_type (  TypeHandle  handle  )  const [inline, inherited]
 

Returns true if the current object is the indicated type exactly.

Definition at line 101 of file typedObject.I.

Referenced by PT(), and CollisionNode::xform().

bool TypedObject::is_of_type (  TypeHandle  handle  )  const [inline, inherited]
 

Returns true if the current object is or derives from the indicated type.

Definition at line 86 of file typedObject.I.

Referenced by EggMaterialCollection::collapse_equivalent_materials(), EggTextureCollection::collapse_equivalent_textures(), DeferredNodeProperty::compose(), AnimBundleMaker::create_s_channel(), CharacterMaker::create_slider(), ProjectionScreen::cull_callback(), DataNode::define_output(), EggNode::determine_draw_order(), CharacterMaker::egg_to_index(), EggGroupUniquifier::EggGroupUniquifier(), EggPoolUniquifier::EggPoolUniquifier(), EggGroupNode::find_textures(), StaticTextFont::get_glyph(), EggMaterialCollection::insert_materials(), EggTextureCollection::insert_textures(), CharacterJoint::make_copy(), PT(), EggGroupNode::r_flatten_transforms(), EggGroupNode::r_transform_vertices(), EggGroupNode::recompute_polygon_normals(), CollisionLevelState::reserve(), PandaFramework::reset_frame_rate(), PandaFramework::set_texture(), EggGroupNode::steal_children(), and DataGraphTraverser::traverse().

bool GraphicsPipe::is_valid (   )  const [inline, inherited]
 

Returns false if this pipe is known to be invalid, meaning that an attempt to create a GraphicsWindow with the pipe will certainly fail.

Returns true if the pipe is probably valid (is this case, an attempt to create a GraphicsWindow should succeed, but might still fail).

Use the GraphicsEngine class to create a GraphicsWindow on a particular pipe.

Definition at line 48 of file graphicsPipe.I.

References GraphicsPipe::_supports_fullscreen, and INLINE.

PointerTo< GraphicsStateGuardian > GraphicsPipe::make_gsg (  const FrameBufferProperties &  properties  )  [protected, virtual, inherited]
 

Creates a new GSG to use the pipe (but no windows have been created yet for the GSG).

This method will be called in the draw thread for the GSG.

Definition at line 146 of file graphicsPipe.cxx.

Referenced by GraphicsEngine::set_threading_model().

virtual PointerTo< GraphicsWindow > GraphicsPipe::make_window (  GraphicsStateGuardian *  gsg  )  [protected, pure virtual, inherited]
 

int ReferenceCount::ref (   )  const [inline, inherited]
 

Explicitly increments the reference count.

User code should avoid using ref() and unref() directly, which can result in missed reference counts. Instead, let a PointerTo object manage the reference counting automatically.

This function is const, even though it changes the object, because generally fiddling with an object's reference count isn't considered part of fiddling with the object. An object might be const in other ways, but we still need to accurately count the number of references to it.

The return value is the new reference count.

Definition at line 225 of file referenceCount.I.

Referenced by ClientDevice::ClientDevice(), EggGroupNode::find_textures(), EggGroupNode::r_apply_texmats(), EggGroupNode::r_flatten_transforms(), and EggGroupNode::reverse_vertex_ordering().

bool GraphicsPipe::supports_fullscreen (   )  const [inline, inherited]
 

Returns false if this pipe is known to not support any creation of fullscreen windows.

If this returns false, any attempt to create a window with the fullscreen property set will certainly fail.

Returns true when the pipe will probably support fullscreen windows. This is not, however, a guarantee that an attempt to create a fullscreen window will not fail.

Definition at line 77 of file graphicsPipe.I.

References GraphicsPipe::_display_height, and INLINE.

void ReferenceCount::test_ref_count_integrity (   )  const [inline, inherited]
 

Does some easy checks to make sure that the reference count isn't completely bogus.

Definition at line 328 of file referenceCount.I.

References INLINE.

Referenced by EggNode::determine_bin(), and ReferenceCount::~ReferenceCount().

int ReferenceCount::unref (   )  const [inline, inherited]
 

Explicitly decrements the reference count.

Note that the object will not be implicitly deleted by unref() simply because the reference count drops to zero. (Having a member function delete itself is problematic; plus, we don't have a virtual destructor anyway.) However, see the helper function unref_delete().

User code should avoid using ref() and unref() directly, which can result in missed reference counts. Instead, let a PointerTo object manage the reference counting automatically.

This function is const, even though it changes the object, because generally fiddling with an object's reference count isn't considered part of fiddling with the object. An object might be const in other ways, but we still need to accurately count the number of references to it.

The return value is the new reference count.

Definition at line 293 of file referenceCount.I.

References INLINE.

Referenced by RenderState::determine_bin_index(), and RenderEffects::determine_show_bounds().

Friends And Related Function Documentation

friend class WinGraphicsWindow [friend]
 

Definition at line 81 of file winGraphicsPipe.h.

Member Data Documentation

int GraphicsPipe::_display_height [protected, inherited]
 

Definition at line 105 of file graphicsPipe.h.

Referenced by GraphicsPipe::GraphicsPipe(), and GraphicsPipe::supports_fullscreen().

int GraphicsPipe::_display_width [protected, inherited]
 

Definition at line 104 of file graphicsPipe.h.

Referenced by GraphicsPipe::GraphicsPipe().

HINSTANCE WinGraphicsPipe::_hUser32 [private]
 

Definition at line 60 of file winGraphicsPipe.h.

Referenced by WinGraphicsPipe().

bool GraphicsPipe::_is_valid [protected, inherited]
 

Definition at line 102 of file graphicsPipe.h.

Referenced by wglGraphicsPipe::get_interface_name(), glxGraphicsPipe::get_interface_name(), and wdxGraphicsPipe8::get_interface_name().

Mutex GraphicsPipe::_lock [protected, inherited]
 

Definition at line 100 of file graphicsPipe.h.

PFN_TRACKMOUSEEVENT WinGraphicsPipe::_pfnTrackMouseEvent [private]
 

Definition at line 62 of file winGraphicsPipe.h.

Referenced by WinGraphicsPipe().

bool GraphicsPipe::_supports_fullscreen [protected, inherited]
 

Definition at line 103 of file graphicsPipe.h.

Referenced by GraphicsPipe::GraphicsPipe(), and GraphicsPipe::is_valid().

TypeHandle WinGraphicsPipe::_type_handle [static, private]
 

Reimplemented from GraphicsPipe.

Reimplemented in wdxGraphicsPipe7, wdxGraphicsPipe8, and wglGraphicsPipe.

Definition at line 25 of file winGraphicsPipe.cxx.

The documentation for this class was generated from the following files:
Generated on Fri May 2 00:56:29 2003 for Panda by doxygen1.3