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

wdxGraphicsPipe8 Class Reference

This graphics pipe represents the interface for creating DirectX graphics windows. More...

#include <wdxGraphicsPipe8.h>

Inheritance diagram for wdxGraphicsPipe8:


Public Member Functions
	wdxGraphicsPipe8 ()
virtual	~wdxGraphicsPipe8 ()
virtual string	get_interface_name () const
	Returns the name of the rendering interface associated with this GraphicsPipe.
virtual	PT (GraphicsStateGuardian) make_gsg(const FrameBufferProperties &properties)
bool	find_best_depth_format (DXScreenData &Display, D3DDISPLAYMODE &TestDisplayMode, D3DFORMAT *pBestFmt, bool bWantStencil, bool bForce16bpp, bool bVerboseMode=false) const
void	search_for_valid_displaymode (DXScreenData &scrn, UINT RequestedX_Size, UINT RequestedY_Size, bool bWantZBuffer, bool bWantStencil, UINT pSupportedScreenDepthsMask, bool pCouldntFindAnyValidZBuf, D3DFORMAT *pSuggestedPixFmt, bool bForce16bppZBuffer, bool bVerboseMode=false)
	All ptr args are output parameters.
bool	special_check_fullscreen_resolution (DXScreenData &scrn, UINT x_size, UINT y_size)
	overrides of the general estimator for known working cases
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 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
	PT (GraphicsPipe) pipe_ const ructor()
TypeHandle	get_class_type ()
void	init_type ()
Protected Member Functions
virtual	PT (GraphicsWindow) make_window(GraphicsStateGuardian *gsg)
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 LPDIRECT3D8(WINAPI *	Direct3DCreate8_ProcPtr )(UINT SDKVersion)
typedef HRESULT(WINAPI *	LPDIRECTDRAWCREATEEX )(GUID FAR lpGuid, LPVOID lplpDD, REFIID iid, IUnknown FAR *pUnkOuter)
typedef pvector< CardID >	CardIDs
Private Member Functions
bool	init ()
	Performs some initialization steps to load up function pointers from the relevant DLL's, and determine the number and type of available graphics adapters, etc.
bool	find_all_card_memavails ()
	Uses DX7 calls to determine how much video memory is available for each video adapter in the system.
Static Private Member Functions
BOOL WINAPI	dx7_driver_enum_callback (GUID pGUID, TCHAR strDesc, TCHAR strName, VOID argptr, HMONITOR hm)
Private Attributes
HINSTANCE	_hDDrawDLL
HINSTANCE	_hD3D8_DLL
LPDIRECT3D8	_pD3D8
LPDIRECTDRAWCREATEEX	_DirectDrawCreateEx
LPDIRECTDRAWENUMERATEEX	_DirectDrawEnumerateExA
Direct3DCreate8_ProcPtr	_Direct3DCreate8
CardIDs	_card_ids
bool	_bIsDX81
Static Private Attributes
TypeHandle	_type_handle
Friends
class	wdxGraphicsWindow8

Detailed Description

This graphics pipe represents the interface for creating DirectX graphics windows.

Definition at line 50 of file wdxGraphicsPipe8.h.

Member Typedef Documentation

typedef pvector<CardID> wdxGraphicsPipe8::CardIDs [private]

Definition at line 110 of file wdxGraphicsPipe8.h.

typedef LPDIRECT3D8(WINAPI * wdxGraphicsPipe8::Direct3DCreate8_ProcPtr)(UINT SDKVersion) [private]

Definition at line 92 of file wdxGraphicsPipe8.h.

typedef HRESULT(WINAPI * wdxGraphicsPipe8::LPDIRECTDRAWCREATEEX)(GUID FAR * lpGuid, LPVOID *lplpDD, REFIID iid, IUnknown FAR *pUnkOuter) [private]

Definition at line 93 of file wdxGraphicsPipe8.h.

Constructor & Destructor Documentation

wdxGraphicsPipe8::wdxGraphicsPipe8 ( )

Definition at line 42 of file wdxGraphicsPipe8.cxx.
References _hD3D8_DLL, _hDDrawDLL, _pD3D8, RELEASE, RELEASE_DOWN_TO_ZERO, and SAFE_FREELIB.

wdxGraphicsPipe8::~wdxGraphicsPipe8 ( ) [virtual]

Definition at line 58 of file wdxGraphicsPipe8.cxx.

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.

BOOL WINAPI wdxGraphicsPipe8::dx7_driver_enum_callback ( GUID * pGUID,

TCHAR * strDesc,

TCHAR * strName,

VOID * argptr,

HMONITOR hm

) [static, private]

Definition at line 389 of file wdxGraphicsPipe8.cxx.

bool wdxGraphicsPipe8::find_all_card_memavails ( ) [private]

Uses DX7 calls to determine how much video memory is available for each video adapter in the system.
Returns true on success, false on failure.
Definition at line 223 of file wdxGraphicsPipe8.cxx.
References D3DERRORSTRING, and NULL.

bool wdxGraphicsPipe8::find_best_depth_format ( DXScreenData & Display,

D3DDISPLAYMODE & TestDisplayMode,

D3DFORMAT * pBestFmt,

bool bWantStencil,

bool bForce16bpp,

bool bVerboseMode = false

) const

Definition at line 425 of file wdxGraphicsPipe8.cxx.

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

Reimplemented from WinGraphicsPipe.
Definition at line 126 of file wdxGraphicsPipe8.h.

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

Reimplemented from WinGraphicsPipe.
Definition at line 115 of file wdxGraphicsPipe8.h.

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.

string wdxGraphicsPipe8::get_interface_name ( ) const [virtual]

Returns the name of the rendering interface associated with this GraphicsPipe.
This is used to present to the user to allow him/her to choose between several possible GraphicsPipes available on a particular platform, so the name should be meaningful and unique for a given platform.
Implements GraphicsPipe.
Definition at line 84 of file wdxGraphicsPipe8.cxx.
References GraphicsPipe::_is_valid, NULL, and wdxGraphicsWindow8.

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 wdxGraphicsPipe8::get_type ( void ) const [inline, virtual]

Reimplemented from WinGraphicsPipe.
Definition at line 123 of file wdxGraphicsPipe8.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.

bool wdxGraphicsPipe8::init ( ) [private]

Performs some initialization steps to load up function pointers from the relevant DLL's, and determine the number and type of available graphics adapters, etc.
Returns true on success, false on failure.
Definition at line 141 of file wdxGraphicsPipe8.cxx.
References _bIsDX81, _pD3D8, and HANDLE().

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

Reimplemented from WinGraphicsPipe.
Definition at line 118 of file wdxGraphicsPipe8.h.

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]

virtual wdxGraphicsPipe8::PT ( GraphicsWindow ) [protected, virtual]

virtual wdxGraphicsPipe8::PT ( GraphicsStateGuardian ) const [virtual]

wdxGraphicsPipe8::PT ( GraphicsPipe ) const [static]

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().

void wdxGraphicsPipe8::search_for_valid_displaymode ( DXScreenData & scrn,

UINT RequestedX_Size,

UINT RequestedY_Size,

bool bWantZBuffer,

bool bWantStencil,

UINT * pSupportedScreenDepthsMask,

bool * pCouldntFindAnyValidZBuf,

D3DFORMAT * pSuggestedPixFmt,

bool bForce16bppZBuffer,

bool bVerboseMode = false

)

All ptr args are output parameters.
If no valid mode found, returns *pSuggestedPixFmt = D3DFMT_UNKNOWN;
Definition at line 563 of file wdxGraphicsPipe8.cxx.

bool wdxGraphicsPipe8::special_check_fullscreen_resolution ( DXScreenData & scrn,

UINT x_size,

UINT y_size

)

overrides of the general estimator for known working cases

Definition at line 525 of file wdxGraphicsPipe8.cxx.

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 wdxGraphicsWindow8 [friend]

Definition at line 131 of file wdxGraphicsPipe8.h.
Referenced by get_interface_name().

Member Data Documentation

bool wdxGraphicsPipe8::_bIsDX81 [private]

Definition at line 112 of file wdxGraphicsPipe8.h.
Referenced by init().

CardIDs wdxGraphicsPipe8::_card_ids [private]

Definition at line 111 of file wdxGraphicsPipe8.h.

Direct3DCreate8_ProcPtr wdxGraphicsPipe8::_Direct3DCreate8 [private]

Definition at line 97 of file wdxGraphicsPipe8.h.

LPDIRECTDRAWCREATEEX wdxGraphicsPipe8::_DirectDrawCreateEx [private]

Definition at line 95 of file wdxGraphicsPipe8.h.

LPDIRECTDRAWENUMERATEEX wdxGraphicsPipe8::_DirectDrawEnumerateExA [private]

Definition at line 96 of file wdxGraphicsPipe8.h.

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 wdxGraphicsPipe8::_hD3D8_DLL [private]

Definition at line 88 of file wdxGraphicsPipe8.h.
Referenced by wdxGraphicsPipe8().

HINSTANCE wdxGraphicsPipe8::_hDDrawDLL [private]

Definition at line 87 of file wdxGraphicsPipe8.h.
Referenced by wdxGraphicsPipe8().

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 get_interface_name().

Mutex GraphicsPipe::_lock [protected, inherited]

Definition at line 100 of file graphicsPipe.h.

LPDIRECT3D8 wdxGraphicsPipe8::_pD3D8 [private]

Definition at line 89 of file wdxGraphicsPipe8.h.
Referenced by init(), and wdxGraphicsPipe8().

bool GraphicsPipe::_supports_fullscreen [protected, inherited]

Definition at line 103 of file graphicsPipe.h.
Referenced by GraphicsPipe::GraphicsPipe(), and GraphicsPipe::is_valid().

TypeHandle wdxGraphicsPipe8::_type_handle [static, private]

Reimplemented from WinGraphicsPipe.
Definition at line 26 of file wdxGraphicsPipe8.cxx.

The documentation for this class was generated from the following files:

panda/src/dxgsg8/wdxGraphicsPipe8.h
panda/src/dxgsg8/wdxGraphicsPipe8.cxx

Generated on Fri May 2 00:56:17 2003 for Panda by

1.3

wdxGraphicsPipe8 Class Reference

Public Member Functions

Static Public Member Functions

Protected Member Functions

Protected Attributes

Private Types

Private Member Functions

Static Private Member Functions

Private Attributes