[5] | 1 | /* |
---|
| 2 | ----------------------------------------------------------------------------- |
---|
| 3 | This source file is part of OGRE |
---|
| 4 | (Object-oriented Graphics Rendering Engine) |
---|
| 5 | For the latest info, see http://www.ogre3d.org/ |
---|
| 6 | |
---|
| 7 | Copyright (c) 2000-2006 Torus Knot Software Ltd |
---|
| 8 | Also see acknowledgements in Readme.html |
---|
| 9 | |
---|
| 10 | This program is free software; you can redistribute it and/or modify it under |
---|
| 11 | the terms of the GNU Lesser General Public License as published by the Free Software |
---|
| 12 | Foundation; either version 2 of the License, or (at your option) any later |
---|
| 13 | version. |
---|
| 14 | |
---|
| 15 | This program is distributed in the hope that it will be useful, but WITHOUT |
---|
| 16 | ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS |
---|
| 17 | FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License for more details. |
---|
| 18 | |
---|
| 19 | You should have received a copy of the GNU Lesser General Public License along with |
---|
| 20 | this program; if not, write to the Free Software Foundation, Inc., 59 Temple |
---|
| 21 | Place - Suite 330, Boston, MA 02111-1307, USA, or go to |
---|
| 22 | http://www.gnu.org/copyleft/lesser.txt. |
---|
| 23 | |
---|
| 24 | You may alternatively use this source under the terms of a specific version of |
---|
| 25 | the OGRE Unrestricted License provided you have obtained such a license from |
---|
| 26 | Torus Knot Software Ltd. |
---|
| 27 | ----------------------------------------------------------------------------- |
---|
| 28 | */ |
---|
| 29 | #ifndef __RenderTexture_H__ |
---|
| 30 | #define __RenderTexture_H__ |
---|
| 31 | |
---|
| 32 | #include "OgrePrerequisites.h" |
---|
| 33 | |
---|
| 34 | #include "OgreRenderTarget.h" |
---|
| 35 | |
---|
| 36 | namespace Ogre |
---|
| 37 | { |
---|
| 38 | /** This class represents a RenderTarget that renders to a Texture. There is no 1 on 1 |
---|
| 39 | relation between Textures and RenderTextures, as there can be multiple |
---|
| 40 | RenderTargets rendering to different mipmaps, faces (for cubemaps) or slices (for 3D textures) |
---|
| 41 | of the same Texture. |
---|
| 42 | */ |
---|
| 43 | class _OgreExport RenderTexture: public RenderTarget |
---|
| 44 | { |
---|
| 45 | public: |
---|
| 46 | RenderTexture(HardwarePixelBuffer *buffer, size_t zoffset); |
---|
| 47 | virtual ~RenderTexture(); |
---|
| 48 | |
---|
| 49 | void writeContentsToFile( const String & filename ); |
---|
| 50 | protected: |
---|
| 51 | HardwarePixelBuffer *mBuffer; |
---|
| 52 | size_t mZOffset; |
---|
| 53 | }; |
---|
| 54 | |
---|
| 55 | /** This class represents a render target that renders to multiple RenderTextures |
---|
| 56 | at once. Surfaces can be bound and unbound at will, as long as the following constraints |
---|
| 57 | are met: |
---|
| 58 | - All bound surfaces have the same size |
---|
| 59 | - All bound surfaces have the same bit depth |
---|
| 60 | - Target 0 is bound |
---|
| 61 | */ |
---|
| 62 | class _OgreExport MultiRenderTarget: public RenderTarget |
---|
| 63 | { |
---|
| 64 | public: |
---|
| 65 | MultiRenderTarget(const String &name); |
---|
| 66 | |
---|
| 67 | /** Bind a surface to a certain attachment point. |
---|
| 68 | |
---|
| 69 | @param attachment 0 .. mCapabilities->numMultiRenderTargets()-1 |
---|
| 70 | |
---|
| 71 | @param target RenderTexture to bind. |
---|
| 72 | |
---|
| 73 | |
---|
| 74 | |
---|
| 75 | It does not bind the surface and fails with an exception (ERR_INVALIDPARAMS) if: |
---|
| 76 | |
---|
| 77 | - Not all bound surfaces have the same size |
---|
| 78 | |
---|
| 79 | - Not all bound surfaces have the same internal format |
---|
| 80 | |
---|
| 81 | */ |
---|
| 82 | |
---|
| 83 | virtual void bindSurface(size_t attachment, RenderTexture *target)=0; |
---|
| 84 | |
---|
| 85 | |
---|
| 86 | |
---|
| 87 | /** Unbind attachment. |
---|
| 88 | |
---|
| 89 | */ |
---|
| 90 | |
---|
| 91 | virtual void unbindSurface(size_t attachment)=0; |
---|
| 92 | |
---|
| 93 | /** Error throwing implementation, it's not possible to write a MultiRenderTarget |
---|
| 94 | to disk. |
---|
| 95 | */ |
---|
| 96 | virtual void writeContentsToFile( const String & filename ); |
---|
| 97 | }; |
---|
| 98 | } |
---|
| 99 | |
---|
| 100 | #endif |
---|