OgreShadowCaster.h
Go to the documentation of this file.

    00001 /*
    00002 -----------------------------------------------------------------------------
    00003 This source file is part of OGRE
    00004     (Object-oriented Graphics Rendering Engine)
    00005 For the latest info, see http://www.ogre3d.org/
    00006
    00007 Copyright (c) 2000-2012 Torus Knot Software Ltd
    00008
    00009 Permission is hereby granted, free of charge, to any person obtaining a copy
    00010 of this software and associated documentation files (the "Software"), to deal
    00011 in the Software without restriction, including without limitation the rights
    00012 to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
    00013 copies of the Software, and to permit persons to whom the Software is
    00014 furnished to do so, subject to the following conditions:
    00015
    00016 The above copyright notice and this permission notice shall be included in
    00017 all copies or substantial portions of the Software.
    00018
    00019 THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
    00020 IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
    00021 FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
    00022 AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
    00023 LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
    00024 OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
    00025 THE SOFTWARE.
    00026 -----------------------------------------------------------------------------
    00027 */
    00028 #ifndef __ShadowCaster_H__
    00029 #define __ShadowCaster_H__
    00030
    00031 #include "OgrePrerequisites.h"
    00032 #include "OgreRenderable.h"
    00033
    00034
    00035 namespace Ogre {
    00036
    00037
    00052     class _OgreExport ShadowRenderable : public Renderable, public ShadowDataAlloc
    00053     {
    00054     protected:
    00055         MaterialPtr mMaterial;
    00056         RenderOperation mRenderOp;
    00057         ShadowRenderable* mLightCap; // used only if isLightCapSeparate == true
    00058     public:
    00059         ShadowRenderable() : mMaterial(), mLightCap(0) {}
    00060         virtual ~ShadowRenderable() { delete mLightCap; }
    00064         void setMaterial(const MaterialPtr& mat) { mMaterial = mat; }
    00066         const MaterialPtr& getMaterial(void) const { return mMaterial; }
    00068         void getRenderOperation(RenderOperation& op) { op = mRenderOp; }
    00070         RenderOperation* getRenderOperationForUpdate(void) {return &mRenderOp;}
    00072         void getWorldTransforms(Matrix4* xform) const = 0;
    00074         Real getSquaredViewDepth(const Camera*) const{ return 0; /* not used */}
    00076         const LightList& getLights(void) const;
    00087         bool isLightCapSeparate(void) const { return mLightCap != 0; }
    00088
    00090         ShadowRenderable* getLightCapRenderable(void) { return mLightCap; }
    00092         virtual bool isVisible(void) const { return true; }
    00093
    00099         virtual void rebindIndexBuffer(const HardwareIndexBufferSharedPtr& indexBuffer) = 0;
    00100
    00101     };
    00102
    00104     enum ShadowRenderableFlags
    00105     {
    00107         SRF_INCLUDE_LIGHT_CAP = 0x00000001,
    00109         SRF_INCLUDE_DARK_CAP  = 0x00000002,
    00111         SRF_EXTRUDE_TO_INFINITY  = 0x00000004
    00112     };
    00113
    00116     class _OgreExport ShadowCaster
    00117     {
    00118     public:
    00119         virtual ~ShadowCaster() { }
    00121         virtual bool getCastShadows(void) const = 0;
    00122
    00124         virtual EdgeData* getEdgeList(void) = 0;
    00126         virtual bool hasEdgeList(void) = 0;
    00127
    00129         virtual const AxisAlignedBox& getWorldBoundingBox(bool derive = false) const = 0;
    00131         virtual const AxisAlignedBox& getLightCapBounds(void) const = 0;
    00133         virtual const AxisAlignedBox& getDarkCapBounds(const Light& light, Real dirLightExtrusionDist) const = 0;
    00134
    00135         typedef vector<ShadowRenderable*>::type ShadowRenderableList;
    00136         typedef VectorIterator<ShadowRenderableList> ShadowRenderableListIterator;
    00137
    00153         virtual ShadowRenderableListIterator getShadowVolumeRenderableIterator(
    00154             ShadowTechnique shadowTechnique, const Light* light,
    00155             HardwareIndexBufferSharedPtr* indexBuffer,
    00156             bool extrudeVertices, Real extrusionDistance, unsigned long flags = 0 ) = 0;
    00157
    00177         static void extrudeVertices(const HardwareVertexBufferSharedPtr& vertexBuffer,
    00178             size_t originalVertexCount, const Vector4& lightPos, Real extrudeDist);
    00180         virtual Real getPointExtrusionDistance(const Light* l) const = 0;
    00181     protected:
    00183         Real getExtrusionDistance(const Vector3& objectPos, const Light* light) const;
    00191         virtual void updateEdgeListLightFacing(EdgeData* edgeData,
    00192             const Vector4& lightPos);
    00193
    00207         virtual void generateShadowVolume(EdgeData* edgeData,
    00208             const HardwareIndexBufferSharedPtr& indexBuffer, const Light* light,
    00209             ShadowRenderableList& shadowRenderables, unsigned long flags);
    00216         virtual void extrudeBounds(AxisAlignedBox& box, const Vector4& lightPos,
    00217             Real extrudeDist) const;
    00218
    00219
    00220     };
    00223 }
    00224
    00225 #endif

Copyright © 2012 Torus Knot Software Ltd
This work is licensed under a Creative Commons Attribution-ShareAlike 3.0 Unported License.
Last modified Sun Sep 2 2012 07:27:24