<html>
<head>
<title>Ogre::D3DDeviceList class Reference - OGRE Documentation</title> <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
<link type="text/css" rel="stylesheet" href="style.css">
</head>
<body>
<!-- Generated by Doxygen 1.2.16 -->
<center>
<a class="qindex" href="index.html">Main Page</a> <a class="qindex" href="namespaces.html">Namespace List</a> <a class="qindex" href="hierarchy.html">Class Hierarchy</a> <a class="qindex" href="classes.html">Alphabetical List</a> <a class="qindex" href="annotated.html">Compound List</a> <a class="qindex" href="files.html">File List</a> <a class="qindex" href="namespacemembers.html">Namespace Members</a> <a class="qindex" href="functions.html">Compound Members</a> <a class="qindex" href="globals.html">File Members</a> <a class="qindex" href="pages.html">Related Pages</a> </center>
<hr><h1>Ogre::D3DDeviceList Class Reference</h1>Encapsulates enumeration of Direct3D devices.
<a href="#_details">More...</a>
<p>
<code>#include <<a class="el" href="OgreD3D7DeviceList_8h-source.html">OgreD3D7DeviceList.h</a>></code>
<p>
<a href="classOgre_1_1D3DDeviceList-members.html">List of all members.</a><table border=0 cellpadding=0 cellspacing=0>
<tr><td colspan=2><br><h2>Public Methods</h2></td></tr>
<tr><td nowrap align=right valign=top> </td><td valign=bottom><a class="el" href="classOgre_1_1D3DDeviceList.html#Ogre_1_1D3DDeviceLista0">D3DDeviceList</a> (LPDIRECT3D7 <a class="el" href="classOgre_1_1D3DDeviceList.html#Ogre_1_1D3DDeviceListm0">lpD3D</a>)</td></tr>
<tr><td nowrap align=right valign=top> </td><td valign=bottom><a class="el" href="classOgre_1_1D3DDeviceList.html#Ogre_1_1D3DDeviceLista1">~D3DDeviceList</a> ()</td></tr>
<tr><td nowrap align=right valign=top>BOOL </td><td valign=bottom><a class="el" href="classOgre_1_1D3DDeviceList.html#Ogre_1_1D3DDeviceLista2">enumerate</a> (void)</td></tr>
<tr><td nowrap align=right valign=top><a class="el" href="classOgre_1_1D3DDevice.html">D3DDevice</a> * </td><td valign=bottom><a class="el" href="classOgre_1_1D3DDeviceList.html#Ogre_1_1D3DDeviceLista3">item</a> (size_t index)</td></tr>
<tr><td nowrap align=right valign=top>size_t </td><td valign=bottom><a class="el" href="classOgre_1_1D3DDeviceList.html#Ogre_1_1D3DDeviceLista4">count</a> (void)</td></tr>
<tr><td nowrap align=right valign=top><a class="el" href="classOgre_1_1D3DDevice.html">D3DDevice</a> * </td><td valign=bottom><a class="el" href="classOgre_1_1D3DDeviceList.html#Ogre_1_1D3DDeviceLista5">getBest</a> (unsigned int minColourDepth)</td></tr>
<tr><td> </td><td><font size=-1><em>Retrieves the 'best' 3D device type.</em> <a href="#Ogre_1_1D3DDeviceLista5"></a><em></em></font><br><br></td></tr>
<tr><td colspan=2><br><h2>Public Attributes</h2></td></tr>
<tr><td nowrap align=right valign=top>LPDIRECT3D7 </td><td valign=bottom><a class="el" href="classOgre_1_1D3DDeviceList.html#Ogre_1_1D3DDeviceListm0">lpD3D</a></td></tr>
<tr><td colspan=2><br><h2>Private Methods</h2></td></tr>
<tr><td nowrap align=right valign=top>void </td><td valign=bottom><a class="el" href="classOgre_1_1D3DDeviceList.html#Ogre_1_1D3DDeviceListc0">AddDevice</a> (LPSTR lpDeviceDesc, LPSTR lpDeviceName, LPD3DDEVICEDESC7 lpD3DDeviceDesc)</td></tr>
<tr><td colspan=2><br><h2>Private Attributes</h2></td></tr>
<tr><td nowrap align=right valign=top>std::vector< <a class="el" href="classOgre_1_1D3DDevice.html">D3DDevice</a> > </td><td valign=bottom><a class="el" href="classOgre_1_1D3DDeviceList.html#Ogre_1_1D3DDeviceListo0">mDeviceList</a></td></tr>
<tr><td colspan=2><br><h2>Friends</h2></td></tr>
<tr><td nowrap align=right valign=top>HRESULT CALLBACK </td><td valign=bottom><a class="el" href="classOgre_1_1D3DDeviceList.html#Ogre_1_1D3DDeviceListl0">D3DEnumDevicesCallback</a> (LPSTR lpDeviceDescription, LPSTR lpDeviceName, LPD3DDEVICEDESC7 lpD3DDeviceDesc, LPVOID lpContext)</td></tr>
</table>
<hr><a name="_details"></a><h2>Detailed Description</h2>
Encapsulates enumeration of Direct3D devices.
<p>
Utility class for <a class="el" href="classOgre_1_1D3DRenderSystem.html">D3DRenderSystem</a>.
<p>
<p>
Definition at line <a class="el" href="OgreD3D7DeviceList_8h-source.html#l00037">37</a> of file <a class="el" href="OgreD3D7DeviceList_8h-source.html">OgreD3D7DeviceList.h</a>.<hr><h2>Constructor & Destructor Documentation</h2>
<a name="Ogre_1_1D3DDeviceLista0" doxytag="Ogre::D3DDeviceList::D3DDeviceList"></a><p>
<table width="100%" cellpadding="2" cellspacing="0" border="0">
<tr>
<td class="md">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> Ogre::D3DDeviceList::D3DDeviceList </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top">LPDIRECT3D7 </td>
<td class="mdname1" valign="top" nowrap> <em>lpD3D</em> </td>
<td class="md" valign="top">) </td>
<td class="md" nowrap></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
</td>
<td>
<p>
<p>
Definition at line <a class="el" href="OgreD3D7DeviceList_8cpp-source.html#l00054">54</a> of file <a class="el" href="OgreD3D7DeviceList_8cpp-source.html">OgreD3D7DeviceList.cpp</a>.
<p>
References <a class="el" href="OgreD3D7DeviceList_8cpp-source.html#l00078">enumerate</a>(), and <a class="el" href="OgreD3D7DeviceList_8h-source.html#l00053">lpD3D</a>. </td>
</tr>
</table>
<a name="Ogre_1_1D3DDeviceLista1" doxytag="Ogre::D3DDeviceList::~D3DDeviceList"></a><p>
<table width="100%" cellpadding="2" cellspacing="0" border="0">
<tr>
<td class="md">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> Ogre::D3DDeviceList::~D3DDeviceList </td>
<td class="md" valign="top">( </td>
<td class="mdname1" valign="top" nowrap> </td>
<td class="md" valign="top">) </td>
<td class="md" nowrap></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
</td>
<td>
<p>
<p>
Definition at line <a class="el" href="OgreD3D7DeviceList_8cpp-source.html#l00067">67</a> of file <a class="el" href="OgreD3D7DeviceList_8cpp-source.html">OgreD3D7DeviceList.cpp</a>.
<p>
References <a class="el" href="OgreD3D7Device_8cpp-source.html#l00198">Ogre::D3DDevice::Cleanup</a>(), <a class="el" href="OgreD3D7DeviceList_8cpp-source.html#l00114">count</a>(), <a class="el" href="OgreD3D7DeviceList_8cpp-source.html#l00119">item</a>(), and <a class="el" href="OgreD3D7DeviceList_8h-source.html#l00044">mDeviceList</a>. </td>
</tr>
</table>
<hr><h2>Member Function Documentation</h2>
<a name="Ogre_1_1D3DDeviceListc0" doxytag="Ogre::D3DDeviceList::AddDevice"></a><p>
<table width="100%" cellpadding="2" cellspacing="0" border="0">
<tr>
<td class="md">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> void Ogre::D3DDeviceList::AddDevice </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top">LPSTR </td>
<td class="mdname" nowrap> <em>lpDeviceDesc</em>, </td>
</tr>
<tr>
<td></td>
<td></td>
<td class="md" nowrap>LPSTR </td>
<td class="mdname" nowrap> <em>lpDeviceName</em>, </td>
</tr>
<tr>
<td></td>
<td></td>
<td class="md" nowrap>LPD3DDEVICEDESC7 </td>
<td class="mdname" nowrap> <em>lpD3DDeviceDesc</em></td>
</tr>
<tr>
<td></td>
<td class="md">) </td>
<td class="md" colspan="2"><code> [private]</code></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
</td>
<td>
<p>
<p>
Definition at line <a class="el" href="OgreD3D7DeviceList_8cpp-source.html#l00093">93</a> of file <a class="el" href="OgreD3D7DeviceList_8cpp-source.html">OgreD3D7DeviceList.cpp</a>.
<p>
References <a class="el" href="OgreD3D7DeviceList_8h-source.html#l00033">Ogre::D3DDevice</a>, <a class="el" href="OgreD3D7DeviceList_8h-source.html#l00053">lpD3D</a>, and <a class="el" href="OgreD3D7DeviceList_8h-source.html#l00044">mDeviceList</a>.
<p>
Referenced by <a class="el" href="OgreD3D7DeviceList_8cpp-source.html#l00036">Ogre::D3DEnumDevicesCallback</a>(). </td>
</tr>
</table>
<a name="Ogre_1_1D3DDeviceLista4" doxytag="Ogre::D3DDeviceList::count"></a><p>
<table width="100%" cellpadding="2" cellspacing="0" border="0">
<tr>
<td class="md">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> size_t Ogre::D3DDeviceList::count </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top">void </td>
<td class="mdname1" valign="top" nowrap> </td>
<td class="md" valign="top">) </td>
<td class="md" nowrap></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
</td>
<td>
<p>
<p>
Definition at line <a class="el" href="OgreD3D7DeviceList_8cpp-source.html#l00114">114</a> of file <a class="el" href="OgreD3D7DeviceList_8cpp-source.html">OgreD3D7DeviceList.cpp</a>.
<p>
References <a class="el" href="OgreD3D7DeviceList_8h-source.html#l00044">mDeviceList</a>.
<p>
Referenced by <a class="el" href="OgreD3D7DeviceList_8cpp-source.html#l00067">~D3DDeviceList</a>(). </td>
</tr>
</table>
<a name="Ogre_1_1D3DDeviceLista2" doxytag="Ogre::D3DDeviceList::enumerate"></a><p>
<table width="100%" cellpadding="2" cellspacing="0" border="0">
<tr>
<td class="md">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> BOOL Ogre::D3DDeviceList::enumerate </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top">void </td>
<td class="mdname1" valign="top" nowrap> </td>
<td class="md" valign="top">) </td>
<td class="md" nowrap></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
</td>
<td>
<p>
<p>
Definition at line <a class="el" href="OgreD3D7DeviceList_8cpp-source.html#l00078">78</a> of file <a class="el" href="OgreD3D7DeviceList_8cpp-source.html">OgreD3D7DeviceList.cpp</a>.
<p>
References <a class="el" href="OgreD3D7DeviceList_8cpp-source.html#l00036">D3DEnumDevicesCallback</a>, and <a class="el" href="OgreD3D7DeviceList_8h-source.html#l00053">lpD3D</a>.
<p>
Referenced by <a class="el" href="OgreD3D7DeviceList_8cpp-source.html#l00054">D3DDeviceList</a>(). </td>
</tr>
</table>
<a name="Ogre_1_1D3DDeviceLista5" doxytag="Ogre::D3DDeviceList::getBest"></a><p>
<table width="100%" cellpadding="2" cellspacing="0" border="0">
<tr>
<td class="md">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> <a class="el" href="classOgre_1_1D3DDevice.html">D3DDevice</a> * Ogre::D3DDeviceList::getBest </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top">unsigned int </td>
<td class="mdname1" valign="top" nowrap> <em>minColourDepth</em> </td>
<td class="md" valign="top">) </td>
<td class="md" nowrap></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
</td>
<td>
<p>
Retrieves the 'best' 3D device type.
<p>
This method returns the device type that is 'best' out of those available. The 3 types that might be present are software emulation, hardware accelerated (HAL), and hardware transform and light. Generally the latter are preferred over the former, however in some cases (mainly very low-end cards) the hardware accelerated device type supports less features than the software mode so may be preferred. In addition some HALs don't support the full range of rendering bit depths (e.g. Matrox Millennium 1/2) so if a 32-bit colour depth is chosen, software mode must be used.
<p>
Definition at line <a class="el" href="OgreD3D7DeviceList_8cpp-source.html#l00124">124</a> of file <a class="el" href="OgreD3D7DeviceList_8cpp-source.html">OgreD3D7DeviceList.cpp</a>.
<p>
References <a class="el" href="OgreD3D7DeviceList_8h-source.html#l00044">mDeviceList</a>.
<p>
Referenced by <a class="el" href="OgreD3D7RenderWindow_8cpp-source.html#l00174">Ogre::D3D7RenderWindow::create</a>(), and <a class="el" href="OgreD3D7RenderWindow_8cpp-source.html#l00462">Ogre::D3D7RenderWindow::createDepthBuffer</a>(). </td>
</tr>
</table>
<a name="Ogre_1_1D3DDeviceLista3" doxytag="Ogre::D3DDeviceList::item"></a><p>
<table width="100%" cellpadding="2" cellspacing="0" border="0">
<tr>
<td class="md">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> <a class="el" href="classOgre_1_1D3DDevice.html">D3DDevice</a> * Ogre::D3DDeviceList::item </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top">size_t </td>
<td class="mdname1" valign="top" nowrap> <em>index</em> </td>
<td class="md" valign="top">) </td>
<td class="md" nowrap></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
</td>
<td>
<p>
<p>
Definition at line <a class="el" href="OgreD3D7DeviceList_8cpp-source.html#l00119">119</a> of file <a class="el" href="OgreD3D7DeviceList_8cpp-source.html">OgreD3D7DeviceList.cpp</a>.
<p>
References <a class="el" href="OgreD3D7DeviceList_8h-source.html#l00044">mDeviceList</a>.
<p>
Referenced by <a class="el" href="OgreD3D7DeviceList_8cpp-source.html#l00067">~D3DDeviceList</a>(). </td>
</tr>
</table>
<hr><h2>Friends And Related Function Documentation</h2>
<a name="Ogre_1_1D3DDeviceListl0" doxytag="Ogre::D3DDeviceList::D3DEnumDevicesCallback"></a><p>
<table width="100%" cellpadding="2" cellspacing="0" border="0">
<tr>
<td class="md">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> HRESULT CALLBACK D3DEnumDevicesCallback </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top">LPSTR </td>
<td class="mdname" nowrap> <em>lpDeviceDescription</em>, </td>
</tr>
<tr>
<td></td>
<td></td>
<td class="md" nowrap>LPSTR </td>
<td class="mdname" nowrap> <em>lpDeviceName</em>, </td>
</tr>
<tr>
<td></td>
<td></td>
<td class="md" nowrap>LPD3DDEVICEDESC7 </td>
<td class="mdname" nowrap> <em>lpD3DDeviceDesc</em>, </td>
</tr>
<tr>
<td></td>
<td></td>
<td class="md" nowrap>LPVOID </td>
<td class="mdname" nowrap> <em>lpContext</em></td>
</tr>
<tr>
<td></td>
<td class="md">) </td>
<td class="md" colspan="2"><code> [friend]</code></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
</td>
<td>
<p>
<p>
Definition at line <a class="el" href="OgreD3D7DeviceList_8cpp-source.html#l00036">36</a> of file <a class="el" href="OgreD3D7DeviceList_8cpp-source.html">OgreD3D7DeviceList.cpp</a>.
<p>
Referenced by <a class="el" href="OgreD3D7DeviceList_8cpp-source.html#l00078">enumerate</a>(). </td>
</tr>
</table>
<hr><h2>Member Data Documentation</h2>
<a name="Ogre_1_1D3DDeviceListm0" doxytag="Ogre::D3DDeviceList::lpD3D"></a><p>
<table width="100%" cellpadding="2" cellspacing="0" border="0">
<tr>
<td class="md">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> LPDIRECT3D7 Ogre::D3DDeviceList::lpD3D
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
</td>
<td>
<p>
<p>
Definition at line <a class="el" href="OgreD3D7DeviceList_8h-source.html#l00053">53</a> of file <a class="el" href="OgreD3D7DeviceList_8h-source.html">OgreD3D7DeviceList.h</a>.
<p>
Referenced by <a class="el" href="OgreD3D7DeviceList_8cpp-source.html#l00093">AddDevice</a>(), <a class="el" href="OgreD3D7DeviceList_8cpp-source.html#l00054">D3DDeviceList</a>(), and <a class="el" href="OgreD3D7DeviceList_8cpp-source.html#l00078">enumerate</a>(). </td>
</tr>
</table>
<a name="Ogre_1_1D3DDeviceListo0" doxytag="Ogre::D3DDeviceList::mDeviceList"></a><p>
<table width="100%" cellpadding="2" cellspacing="0" border="0">
<tr>
<td class="md">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> std::vector<<a class="el" href="classOgre_1_1D3DDevice.html">D3DDevice</a>> Ogre::D3DDeviceList::mDeviceList<code> [private]</code>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
</td>
<td>
<p>
<p>
Definition at line <a class="el" href="OgreD3D7DeviceList_8h-source.html#l00044">44</a> of file <a class="el" href="OgreD3D7DeviceList_8h-source.html">OgreD3D7DeviceList.h</a>.
<p>
Referenced by <a class="el" href="OgreD3D7DeviceList_8cpp-source.html#l00093">AddDevice</a>(), <a class="el" href="OgreD3D7DeviceList_8cpp-source.html#l00114">count</a>(), <a class="el" href="OgreD3D7DeviceList_8cpp-source.html#l00124">getBest</a>(), <a class="el" href="OgreD3D7DeviceList_8cpp-source.html#l00119">item</a>(), and <a class="el" href="OgreD3D7DeviceList_8cpp-source.html#l00067">~D3DDeviceList</a>(). </td>
</tr>
</table>
<hr>The documentation for this class was generated from the following files:<ul>
<li><a class="el" href="OgreD3D7DeviceList_8h-source.html">OgreD3D7DeviceList.h</a><li><a class="el" href="OgreD3D7DeviceList_8cpp-source.html">OgreD3D7DeviceList.cpp</a></ul>
<p>
Copyright © 2002-2003 by The OGRE Team<br />
Last modified Wed Jan 21 00:12:22 2004
</p>
</body>
</html>
