#include <RendererCreatorHelper.h>
Inheritance diagram for TRendererCreatorHelper:
Public Member Functions | |
BOOL | FindRenderersHW (const TString &library, EnumGraphicFormat displayFormat, EnumGraphicFormat backBufferFormat, BOOL windowMode, BOOL fullscreenMode, EnumGraphicFormat depthStencilFormat, EnumGraphicVertexShaderVersion minimumVsVersion, EnumGraphicPixelShaderVersion minimumPsVersion, const TArray< EnumGraphicCaps > *reqCaps) |
This method enumerates renderers from specified library and select indices for such renderers, which meet given requirements. | |
BOOL | FindRenderersSW (const TString &library, EnumGraphicFormat displayFormat, EnumGraphicFormat backBufferFormat, BOOL windowMode, BOOL fullscreenMode, EnumGraphicFormat depthStencilFormat, EnumGraphicVertexShaderVersion minimumVsVersion, EnumGraphicPixelShaderVersion minimumPsVersion, const TArray< EnumGraphicCaps > *reqCaps) |
This method enumerates renderers from specified library and select indices for such renderers, which meet given requirements. | |
TRenderer * | CreateRenderer (void *wnd, DWORD index, DWORD width, DWORD height, DWORD freqs, EnumGraphicFormat backBufferFormat, EnumGraphicFormat depthStencilFormat, BOOL window, BOOL vsync, EnumGraphicVertexShaderVersion vsVersion, EnumGraphicPixelShaderVersion psVersion, BOOL vsDebug, BOOL psDebug) |
This method creates renderer. | |
const TArray< DWORD > & | GetSelectedDevices (void) const |
Return array with indices for devices that meet given requirements. | |
const TRendererCaps * | GetRendererCapabilities (DWORD index) const |
Returns capabilities for devices identified by given index or NULL if index is out of range or no device has been enumerated. | |
BOOL | GetClosestResolution (const DWORD index, DWORD &width, DWORD &height, DWORD &freqs) |
This method find closest available resolution for specified device and resolution. | |
BOOL | FreeEnumerateRenderers (void) |
Destroy previously enumerate renderers. | |
Static Public Member Functions | |
static TRendererCreatorHelper * | Create (void) |
Create TRendererCreatorHelper object or return previously created object. | |
static BOOL | Destroy (void) |
Destroy actually created TRendererCreatorHelper object. |
Only one instance of this class can be created in time. You create it via TRendererCreatorHelper::Create() and destroy via TRendererCreatorHelper::Destroy(). Next calling of TRendererCreatorHelper::Create() returns previously created instance of this object.
When you enumerate renderers via TRendererCreatorHelper::FindRenderers*() you cannot call this method again until you call TRendererCreatorHelper::FreeEnumerateRenderers().
When a renderer exists you cannot call TRendererCreatorHelper::FreeEnumerateRenderers() or destroy this object - you must destroy renderer before do this.
USING: Create object via TRendererCreatorHelper::Create() Enumerate renderers via TRendererCreatorHelper::FindRenderers*() //HW,SW,... Select renderer via TRendererCreatorHelper::GetSelectedDevices() You can get optimal display mode via TRendererCreatorHelper::GetClosestResolution() Create renderer via TRendererCreatorHelper::CreateRenderer() ...here is your application code... End of application Properly destroy renderer an all its resources. Destroy this objects via TRendererCreatorHelper::Destroy()
Definition at line 49 of file RendererCreatorHelper.h.
|
Create TRendererCreatorHelper object or return previously created object.
Definition at line 23 of file RendererCreatorHelper.cpp. References DBGTEXTF. |
|
This method creates renderer. If renderer is already created method returns pointer to this one. You must call method FindRenderers* to enumerate renderers before you create a rendererer. After successfully calling this function you cannot destroy TRendererCreatorHelper until you destroy created renderer!!!
Definition at line 183 of file RendererCreatorHelper.cpp. References TRendererCreator::CreateRenderer(), and DBGTEXTF. Here is the call graph for this function: ![]() |
|
Destroy actually created TRendererCreatorHelper object. Cannot destroy object if an renderer from created from this object already exists. Returns TRUE if object was destroyed, FALSE otherwise. Definition at line 42 of file RendererCreatorHelper.cpp. References DBGTEXTF, FALSE, and FreeEnumerateRenderers(). Referenced by TGlobalsGraphic::Destroy(). Here is the call graph for this function: ![]() |
|
This method enumerates renderers from specified library and select indices for such renderers, which meet given requirements. This method selects HW device only. If previous method FindRenderers* was called this method method returns TRUE and does nothing.
Definition at line 226 of file RendererCreatorHelper.cpp. References TArray< T, align, size, step >::Clear(), DBGTEXTF, FALSE, TArray< T, align, size, step >::GetItem(), TRendererCreator::GetRendererCapabilities(), TRendererCreator::GetRenderersCount(), TArray< T, align, size, step >::GetSize(), GRAPH_CAPS_HARDWARE, GRAPH_FMT_UNKNOWN, and TRUE. Here is the call graph for this function: ![]() |
|
This method enumerates renderers from specified library and select indices for such renderers, which meet given requirements. This method selects SW device only. If previous method FindRenderers* was called this method method returns TRUE and does nothing.
Definition at line 317 of file RendererCreatorHelper.cpp. References TArray< T, align, size, step >::Clear(), DBGTEXTF, FALSE, TArray< T, align, size, step >::GetItem(), TRendererCreator::GetRendererCapabilities(), TRendererCreator::GetRenderersCount(), TArray< T, align, size, step >::GetSize(), GRAPH_CAPS_HARDWARE, GRAPH_FMT_UNKNOWN, and TRUE. Here is the call graph for this function: ![]() |
|
Destroy previously enumerate renderers. This method can be called only when no renderer exists. Definition at line 129 of file RendererCreatorHelper.cpp. References TArray< T, align, size, step >::Clear(), DBGTEXTF, TRendererCreator::Destroy(), FALSE, TRendererCreator::FreeEnumerateRenderers(), and TRUE. Referenced by Destroy(). Here is the call graph for this function: ![]() |
|
This method find closest available resolution for specified device and resolution. At first search for closest resolution. After this search for best frequency. Return FALSE if resolution cannot be created or when index of device is out of range.
Definition at line 402 of file RendererCreatorHelper.cpp. References NSMath::NSStdMath::abs(), DBGTEXTF, FALSE, TRendererCaps::GetDisplayMode(), TRendererCaps::GetDisplayModesCount(), TRendererDisplayMode::GetRefreshRate(), TRendererDisplayMode::GetRefreshRatesCount(), TRendererCreator::GetRendererCapabilities(), NSMath::NSStdMath::sqrt(), and TRUE. Here is the call graph for this function: ![]() |
|
Returns capabilities for devices identified by given index or NULL if index is out of range or no device has been enumerated.
Definition at line 114 of file RendererCreatorHelper.cpp. References TRendererCreator::GetRendererCapabilities(). Here is the call graph for this function: ![]() |
|
Return array with indices for devices that meet given requirements. This method should be called after successful call of FindRenderers* method. Definition at line 111 of file RendererCreatorHelper.h. |