| /* | |
| * Copyright (c) 2007, 2008, Oracle and/or its affiliates. All rights reserved. | |
| * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. | |
| * | |
| * This code is free software; you can redistribute it and/or modify it | |
| * under the terms of the GNU General Public License version 2 only, as | |
| * published by the Free Software Foundation. Oracle designates this | |
| * particular file as subject to the "Classpath" exception as provided | |
| * by Oracle in the LICENSE file that accompanied this code. | |
| * | |
| * This code is distributed in the hope that it will be useful, but WITHOUT | |
| * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or | |
| * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License | |
| * version 2 for more details (a copy is included in the LICENSE file that | |
| * accompanied this code). | |
| * | |
| * You should have received a copy of the GNU General Public License version | |
| * 2 along with this work; if not, write to the Free Software Foundation, | |
| * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA. | |
| * | |
| * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA | |
| * or visit www.oracle.com if you need additional information or have any | |
| * questions. | |
| */ | |
| #ifndef _D3DRESOURCEMANAGER_H_ | |
| #define _D3DRESOURCEMANAGER_H_ | |
| #include "D3DContext.h" | |
| #include "D3DSurfaceData.h" | |
| class D3DResourceManager; | |
| class D3DContext; | |
| /** | |
| * This interface represents a Direct3D resource which is managed by the | |
| * D3DResourceManager. | |
| * | |
| * Subclasses will need to override Release() and the destructor to release | |
| * the resources held by the object. | |
| * | |
| * The subclasses then can be used like this: | |
| * class D3DShaderResource : public IManagedResource { | |
| * D3DShaderResource(IDirect3DPixelShader9 *pShader) { // ... } | |
| * virtual ~D3DShaderResource() { Release(); } | |
| * virtual Release() { SAFE_RELEASE(pShader); } | |
| * virtual IsDefaultPool() { return FALSE; } | |
| * private: | |
| * IDirect3DPixelShader9 *pShader; | |
| * } | |
| * | |
| * pD3DDevice->CreatePixelShader(..., &pShader); | |
| * IManagedResource *pShaderRes = new D3DShaderResource(pShader); | |
| * pCtx->GetResourceManager()->AddResource(pShaderRes); | |
| * | |
| * D3DResourceManager::ReleaseResource() must be used to dispose of the | |
| * resource: | |
| * pCtx->GetResourceManager()->ReleaseResource(pShaderRes); | |
| * // pShaderRes is now invalid, it was deleted | |
| * shaderRes = NULL; | |
| * | |
| * In certain cases the D3DResourceManager may need to release all its | |
| * resources (like when resetting the device), so the subclasses must be | |
| * ready to be released at any time, and be able to notify their users. | |
| * For an example of how this can be achieved see how D3DSDO's | |
| * pResource field and D3DResource subclass. d3dsdo->pResource is reset when | |
| * the D3DResource it was pointing to is disposed. | |
| */ | |
| class IManagedResource { | |
| friend class D3DResourceManager; | |
| public: | |
| // determines whether the resource should be released by the manager | |
| // when default pool resources are to be released | |
| virtual BOOL IsDefaultPool() = 0; | |
| protected: | |
| IManagedResource() { pPrev = pNext = NULL; }; | |
| virtual ~IManagedResource() { pPrev = pNext = NULL; }; | |
| virtual void Release() = 0; | |
| private: | |
| // prevents accidental bad things like copying the object | |
| IManagedResource& operator=(const IManagedResource&); | |
| IManagedResource* pPrev; | |
| IManagedResource* pNext; | |
| }; | |
| /** | |
| * This class handles either IDirect3DResource9 or IDirect3DSwapChain9 | |
| * type of resources and provides access to Texture, Surface or SwapChain, | |
| * as well as the surface description. | |
| */ | |
| class D3DResource : public IManagedResource { | |
| public: | |
| D3DResource(IDirect3DResource9 *pRes) | |
| { Init(pRes, NULL); } | |
| D3DResource(IDirect3DSwapChain9 *pSC) | |
| { Init(NULL, pSC); } | |
| IDirect3DResource9* GetResource() { return pResource; } | |
| IDirect3DTexture9* GetTexture() { return pTexture; } | |
| IDirect3DSurface9* GetSurface() { return pSurface; } | |
| IDirect3DSwapChain9* GetSwapChain() { return pSwapChain; } | |
| D3DSDOps* GetSDOps() { return pOps; } | |
| void SetSDOps(D3DSDOps *pOps); | |
| D3DSURFACE_DESC* GetDesc() { return &desc; } | |
| virtual BOOL IsDefaultPool(); | |
| protected: | |
| // these are protected because we want D3DResource to be only released via | |
| // ResourceManager | |
| virtual ~D3DResource(); | |
| virtual void Release(); | |
| void Init(IDirect3DResource9*, IDirect3DSwapChain9*); | |
| private: | |
| // prevents accidental bad things like copying the object | |
| D3DResource() {} | |
| D3DResource& operator=(const D3DResource&); | |
| IDirect3DResource9* pResource; | |
| IDirect3DSwapChain9* pSwapChain; | |
| IDirect3DSurface9* pSurface; | |
| IDirect3DTexture9* pTexture; | |
| D3DSDOps* pOps; | |
| D3DSURFACE_DESC desc; | |
| }; | |
| /** | |
| * This class maintains a list of d3d resources created by the pipeline or | |
| * other clients. It is needed because in some cases all resources have to be | |
| * released in order to reset the device so we must keep track of them. | |
| * | |
| * There is one instance of this class per D3DContext. Clients can either | |
| * use factory methods for creating resources or create their own encapsulated | |
| * in an IManagedResource interface subclass and add them to the list | |
| * using the AddResource() method. Resources added to the list must be released | |
| * via the ReleaseResource() method so that they can be stopped being managed. | |
| */ | |
| class D3DResourceManager { | |
| public: | |
| ~D3DResourceManager(); | |
| HRESULT Init(D3DContext *pCtx); | |
| // Releases and deletes all resources managed by this manager. | |
| void ReleaseAll(); | |
| // Releases (and deletes) all resources belonging to the default pool. | |
| // Note: this method may release other resources as well. | |
| void ReleaseDefPoolResources(); | |
| // Adds the resource to the list managed by this class. | |
| HRESULT AddResource(IManagedResource* pResource); | |
| // Removes the resource from the list of managed resources, and deletes | |
| // it. The argument pointer is invalid after this method returns. | |
| HRESULT ReleaseResource(IManagedResource* pResource); | |
| HRESULT CreateTexture(UINT width, UINT height, | |
| BOOL isRTT, BOOL isOpaque, | |
| D3DFORMAT *pFormat/*in/out*/, | |
| DWORD dwUsage, | |
| D3DResource **ppTextureResource/*out*/); | |
| HRESULT CreateRTSurface(UINT width, UINT height, | |
| BOOL isOpaque, BOOL isLockable, | |
| D3DFORMAT *pFormat/*in/out*/, | |
| D3DResource ** ppSurfaceResource/*out*/); | |
| HRESULT CreateSwapChain(HWND hWnd, UINT numBuffers, UINT width, UINT height, | |
| D3DSWAPEFFECT swapEffect, UINT presentationInterval, | |
| D3DResource ** ppSwapChainResource/*out*/); | |
| HRESULT GetCachedDestTexture(D3DFORMAT format, | |
| D3DResource **ppTextureResource); | |
| HRESULT GetBlitTexture(D3DResource **ppTextureResource); | |
| HRESULT GetBlitRTTexture(UINT width, UINT height, D3DFORMAT format, | |
| D3DResource **ppTextureResource); | |
| HRESULT GetBlitOSPSurface(UINT width, UINT height, D3DFORMAT fmt, | |
| D3DResource **ppSurfaceResource); | |
| HRESULT GetMaskTexture(D3DResource **ppTextureResource); | |
| HRESULT GetGradientTexture(D3DResource **ppTextureResource); | |
| HRESULT GetMultiGradientTexture(D3DResource **ppTextureResource); | |
| HRESULT GetLookupOpLutTexture(D3DResource **ppTextureResource); | |
| HRESULT GetLockableRTSurface(UINT width, UINT height, D3DFORMAT format, | |
| D3DResource **ppSurfaceResource); | |
| static | |
| HRESULT CreateInstance(D3DContext *pCtx, D3DResourceManager **ppResMgr); | |
| private: | |
| D3DResourceManager(); | |
| HRESULT GetStockTextureResource(UINT width, UINT height, | |
| BOOL isRTT, BOOL isOpaque, | |
| D3DFORMAT *pFormat/*in/out*/, | |
| DWORD dwUsage, | |
| D3DResource **ppTextureResource/*out*/); | |
| HRESULT CreateOSPSurface(UINT width, UINT height, | |
| D3DFORMAT fmt, | |
| D3DResource ** ppSurfaceResource/*out*/); | |
| D3DResource* pCachedDestTexture; | |
| D3DResource* pBlitTexture; | |
| D3DResource* pBlitRTTexture; | |
| D3DResource* pBlitOSPSurface; | |
| D3DResource* pGradientTexture; | |
| D3DResource* pLookupOpLutTexture; | |
| D3DResource* pMaskTexture; | |
| D3DResource* pMultiGradientTexture; | |
| D3DResource* pLockableRTSurface; | |
| D3DContext* pCtx; | |
| IManagedResource* pHead; | |
| }; | |
| #endif // _D3DRESOURCEMANAGER_H_ |