/* ----------------------------------------------------------------------------- This source file is part of OGRE (Object-oriented Graphics Rendering Engine) For the latest info, see http://www.ogre3d.org/ Copyright (c) 2000-2006 Torus Knot Software Ltd Also see acknowledgements in Readme.html This program is free software; you can redistribute it and/or modify it under the terms of the GNU Lesser General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version. This program 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 Lesser General Public License for more details. You should have received a copy of the GNU Lesser General Public License along with this program; if not, write to the Free Software Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA, or go to http://www.gnu.org/copyleft/lesser.txt. You may alternatively use this source under the terms of a specific version of the OGRE Unrestricted License provided you have obtained such a license from Torus Knot Software Ltd. ----------------------------------------------------------------------------- */ #ifndef __BorderPanelOverlayElement_H__ #define __BorderPanelOverlayElement_H__ #include "OgrePanelOverlayElement.h" namespace Ogre { class BorderRenderable; /** A specialisation of the PanelOverlayElement to provide a panel with a border. @remarks Whilst the standard panel can use a single tiled material, this class allows panels with a tileable backdrop plus a border texture. This is handy for large panels that are too big to use a single large texture with a border, or for multiple different size panels where you want the border a constant width but the center to repeat. @par In addition to the usual PanelOverlayElement properties, this class has a 'border material', which specifies the material used for the edges of the panel, a border width (which can either be constant all the way around, or specified per edge), and the texture coordinates for each of the border sections. */ class _OgreExport BorderPanelOverlayElement : public PanelOverlayElement { friend class BorderRenderable; public: /** Constructor */ BorderPanelOverlayElement(const String& name); virtual ~BorderPanelOverlayElement(); virtual void initialise(void); const String& getTypeName(void) const; /** Sets the size of the border. @remarks This method sets a constant size for all borders. There are also alternative methods which allow you to set border widths for individual edges separately. Remember that the dimensions specified here are in relation to the size of the screen, so 0.1 is 1/10th of the screen width or height. Also note that because most screen resolutions are 1.333:1 width:height ratio that using the same border size will look slightly bigger across than up. @param size The size of the border as a factor of the screen dimensions ie 0.2 is one-fifth of the screen size. */ void setBorderSize(Real size); /** Sets the size of the border, with different sizes for vertical and horizontal borders. @remarks This method sets a size for the side and top / bottom borders separately. Remember that the dimensions specified here are in relation to the size of the screen, so 0.1 is 1/10th of the screen width or height. Also note that because most screen resolutions are 1.333:1 width:height ratio that using the same border size will look slightly bigger across than up. @param sides The size of the side borders as a factor of the screen dimensions ie 0.2 is one-fifth of the screen size. @param topAndBottom The size of the top and bottom borders as a factor of the screen dimensions. */ void setBorderSize(Real sides, Real topAndBottom); /** Sets the size of the border separately for all borders. @remarks This method sets a size all borders separately. Remember that the dimensions specified here are in relation to the size of the screen, so 0.1 is 1/10th of the screen width or height. Also note that because most screen resolutions are 1.333:1 width:height ratio that using the same border size will look slightly bigger across than up. @param left The size of the left border as a factor of the screen dimensions ie 0.2 is one-fifth of the screen size. @param right The size of the left border as a factor of the screen dimensions. @param top The size of the top border as a factor of the screen dimensions. @param bottom The size of the bottom border as a factor of the screen dimensions. */ void setBorderSize(Real left, Real right, Real top, Real bottom); /** Gets the size of the left border. */ Real getLeftBorderSize(void) const; /** Gets the size of the right border. */ Real getRightBorderSize(void) const; /** Gets the size of the top border. */ Real getTopBorderSize(void) const; /** Gets the size of the bottom border. */ Real getBottomBorderSize(void) const; /** Sets the texture coordinates for the left edge of the border. @remarks The border panel uses 8 panels for the border (9 including the center). Imagine a table with 3 rows and 3 columns. The corners are always the same size, but the edges stretch depending on how big the panel is. Those who have done resizable HTML tables will be familiar with this approach. @par We only require 2 sets of uv coordinates, one for the top-left and one for the bottom-right of the panel, since it is assumed the sections are aligned on the texture. */ void setLeftBorderUV(Real u1, Real v1, Real u2, Real v2); /** Sets the texture coordinates for the right edge of the border. @remarks See setLeftBorderUV. */ void setRightBorderUV(Real u1, Real v1, Real u2, Real v2); /** Sets the texture coordinates for the top edge of the border. @remarks See setLeftBorderUV. */ void setTopBorderUV(Real u1, Real v1, Real u2, Real v2); /** Sets the texture coordinates for the bottom edge of the border. @remarks See setLeftBorderUV. */ void setBottomBorderUV(Real u1, Real v1, Real u2, Real v2); /** Sets the texture coordinates for the top-left corner of the border. @remarks See setLeftBorderUV. */ void setTopLeftBorderUV(Real u1, Real v1, Real u2, Real v2); /** Sets the texture coordinates for the top-right corner of the border. @remarks See setLeftBorderUV. */ void setTopRightBorderUV(Real u1, Real v1, Real u2, Real v2); /** Sets the texture coordinates for the bottom-left corner of the border. @remarks See setLeftBorderUV. */ void setBottomLeftBorderUV(Real u1, Real v1, Real u2, Real v2); /** Sets the texture coordinates for the bottom-right corner of the border. @remarks See setLeftBorderUV. */ void setBottomRightBorderUV(Real u1, Real v1, Real u2, Real v2); String getLeftBorderUVString() const; String getRightBorderUVString() const; String getTopBorderUVString() const; String getBottomBorderUVString() const; String getTopLeftBorderUVString() const; String getTopRightBorderUVString() const; String getBottomLeftBorderUVString() const; String getBottomRightBorderUVString() const; /** Sets the name of the material to use for the borders. */ void setBorderMaterialName(const String& name); /** Gets the name of the material to use for the borders. */ const String& getBorderMaterialName(void) const; /** Overridden from OverlayContainer */ void _updateRenderQueue(RenderQueue* queue); /** Overridden from OverlayElement */ void setMetricsMode(GuiMetricsMode gmm); /** Overridden from OverlayElement */ void _update(void); /** Command object for specifying border sizes (see ParamCommand).*/ class _OgrePrivate CmdBorderSize : public ParamCommand { public: String doGet(const void* target) const; void doSet(void* target, const String& val); }; /** Command object for specifying the Material for the border (see ParamCommand).*/ class _OgrePrivate CmdBorderMaterial : public ParamCommand { public: String doGet(const void* target) const; void doSet(void* target, const String& val); }; /** Command object for specifying texture coordinates for the border (see ParamCommand).*/ class _OgrePrivate CmdBorderLeftUV : public ParamCommand { public: String doGet(const void* target) const; void doSet(void* target, const String& val); }; /** Command object for specifying texture coordinates for the border (see ParamCommand).*/ class _OgrePrivate CmdBorderTopUV : public ParamCommand { public: String doGet(const void* target) const; void doSet(void* target, const String& val); }; /** Command object for specifying texture coordinates for the border (see ParamCommand).*/ class _OgrePrivate CmdBorderRightUV : public ParamCommand { public: String doGet(const void* target) const; void doSet(void* target, const String& val); }; /** Command object for specifying texture coordinates for the border (see ParamCommand).*/ class _OgrePrivate CmdBorderBottomUV : public ParamCommand { public: String doGet(const void* target) const; void doSet(void* target, const String& val); }; /** Command object for specifying texture coordinates for the border (see ParamCommand).*/ class _OgrePrivate CmdBorderTopLeftUV : public ParamCommand { public: String doGet(const void* target) const; void doSet(void* target, const String& val); }; /** Command object for specifying texture coordinates for the border (see ParamCommand).*/ class _OgrePrivate CmdBorderBottomLeftUV : public ParamCommand { public: String doGet(const void* target) const; void doSet(void* target, const String& val); }; /** Command object for specifying texture coordinates for the border (see ParamCommand).*/ class _OgrePrivate CmdBorderBottomRightUV : public ParamCommand { public: String doGet(const void* target) const; void doSet(void* target, const String& val); }; /** Command object for specifying texture coordinates for the border (see ParamCommand).*/ class _OgrePrivate CmdBorderTopRightUV : public ParamCommand { public: String doGet(const void* target) const; void doSet(void* target, const String& val); }; protected: Real mLeftBorderSize; Real mRightBorderSize; Real mTopBorderSize; Real mBottomBorderSize; struct CellUV { Real u1, v1, u2, v2; }; CellUV mBorderUV[8]; ushort mPixelLeftBorderSize; ushort mPixelRightBorderSize; ushort mPixelTopBorderSize; ushort mPixelBottomBorderSize; String mBorderMaterialName; MaterialPtr mpBorderMaterial; // Render operation for the border area RenderOperation mRenderOp2; static String msTypeName; /// internal method for setting up geometry, called by OverlayElement::update void updatePositionGeometry(void); /// internal method for setting up geometry, called by OverlayElement::update void updateTextureGeometry(void); /// Internal method for setting up parameters void addBaseParameters(void); enum BorderCellIndex { BCELL_TOP_LEFT = 0, BCELL_TOP = 1, BCELL_TOP_RIGHT = 2, BCELL_LEFT = 3, BCELL_RIGHT = 4, BCELL_BOTTOM_LEFT = 5, BCELL_BOTTOM = 6, BCELL_BOTTOM_RIGHT = 7 }; String getCellUVString(BorderCellIndex idx) const; // Command objects static CmdBorderSize msCmdBorderSize; static CmdBorderMaterial msCmdBorderMaterial; static CmdBorderLeftUV msCmdBorderLeftUV; static CmdBorderTopUV msCmdBorderTopUV; static CmdBorderBottomUV msCmdBorderBottomUV; static CmdBorderRightUV msCmdBorderRightUV; static CmdBorderTopLeftUV msCmdBorderTopLeftUV; static CmdBorderBottomLeftUV msCmdBorderBottomLeftUV; static CmdBorderTopRightUV msCmdBorderTopRightUV; static CmdBorderBottomRightUV msCmdBorderBottomRightUV; BorderRenderable* mBorderRenderable; }; /** Class for rendering the border of a BorderPanelOverlayElement. @remarks We need this because we have to render twice, once with the inner panel's repeating material (handled by superclass) and once for the border's separate meterial. */ class _OgreExport BorderRenderable : public Renderable { protected: BorderPanelOverlayElement* mParent; public: /** Constructed with pointers to parent. */ BorderRenderable(BorderPanelOverlayElement* parent) : mParent(parent) { mUseIdentityProjection = true; mUseIdentityView = true; } const MaterialPtr& getMaterial(void) const { return mParent->mpBorderMaterial; } void getRenderOperation(RenderOperation& op) { op = mParent->mRenderOp2; } void getWorldTransforms(Matrix4* xform) const { mParent->getWorldTransforms(xform); } const Quaternion& getWorldOrientation(void) const { return Quaternion::IDENTITY; } const Vector3& getWorldPosition(void) const { return Vector3::ZERO; } unsigned short getNumWorldTransforms(void) const { return 1; } Real getSquaredViewDepth(const Camera* cam) const { return mParent->getSquaredViewDepth(cam); } const LightList& getLights(void) const { // N/A, panels are not lit static LightList ll; return ll; } bool getPolygonModeOverrideable(void) const { return mParent->getPolygonModeOverrideable(); } }; } #endif