Home

nevrax.com

Nevrax.org News Mailing-list Documentation CVS Bugs License

Documentation                       Search   texture.h Go to the documentation of this file. /* Copyright, 2000 Nevrax Ltd. * * This file is part of NEVRAX NEL. * NEVRAX NEL is free software; you can redistribute it and/or modify * it under the terms of the GNU General Public License as published by * the Free Software Foundation; either version 2, or (at your option) * any later version. * NEVRAX NEL 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 for more details. * You should have received a copy of the GNU General Public License * along with NEVRAX NEL; see the file COPYING. If not, write to the * Free Software Foundation, Inc., 59 Temple Place - Suite 330, Boston, * MA 02111-1307, USA. */ #ifndef NL_TEXTURE_H #define NL_TEXTURE_H #include "nel/misc/types_nl.h" #include "nel/misc/smart_ptr.h" #include "nel/misc/stream.h" #include "nel/misc/rect.h" #include "nel/misc/bitmap.h" #include <string> #include <list> #include <map> namespace NL3D { using NLMISC::CBitmap; class IDriver; //**************************************************************************** // List typedef. class ITextureDrvInfos; class CTextureDrvShare; class TTexDrvInfoPtrMap : public std::map< std::string, ITextureDrvInfos*> {}; typedef std::list<CTextureDrvShare*> TTexDrvSharePtrList; typedef TTexDrvInfoPtrMap::iterator ItTexDrvInfoPtrMap; typedef TTexDrvSharePtrList::iterator ItTexDrvSharePtrList; // Class for interaction of textures with Driver. // ITextureDrvInfos represent the real data of the texture, stored into the driver (eg: just a GLint for opengl). class ITextureDrvInfos : public NLMISC::CRefCount { private: IDriver *_Driver; ItTexDrvInfoPtrMap _DriverIterator; public: ITextureDrvInfos(IDriver *drv, ItTexDrvInfoPtrMap it) {_Driver= drv; _DriverIterator= it;} ITextureDrvInfos(class IDriver& driver); virtual ~ITextureDrvInfos(void); }; // Many ITexture may point to the same ITextureDrvInfos, through CTextureDrvShare. class CTextureDrvShare : public NLMISC::CRefCount { private: IDriver *_Driver; ItTexDrvSharePtrList _DriverIterator; public: NLMISC::CSmartPtr<ITextureDrvInfos> DrvTexture; public: CTextureDrvShare(IDriver *drv, ItTexDrvSharePtrList it) {_Driver= drv; _DriverIterator= it;} ~CTextureDrvShare(); }; //**************************************************************************** /* *** IMPORTANT ******************** * *** IF YOU MODIFY THE STRUCTURE OF THIS CLASS, PLEASE INCREMENT IDriver::InterfaceVersion TO INVALIDATE OLD DRIVER DLL * ********************************** */ class ITexture : public CBitmap, public NLMISC::CRefCount, public NLMISC::IStreamable { public: // Those enums MUST be the same than in UTexture!! enum TWrapMode { Repeat= 0, Clamp, WrapModeCount }; enum TUploadFormat { Auto= 0, RGBA8888, RGBA4444, RGBA5551, RGB888, RGB565, DXTC1, DXTC1Alpha, DXTC3, DXTC5, Luminance, Alpha, AlphaLuminance, DsDt, UploadFormatCount }; enum TMagFilter { Nearest=0, Linear, MagFilterCount }; enum TMinFilter { NearestMipMapOff=0, NearestMipMapNearest, NearestMipMapLinear, LinearMipMapOff, LinearMipMapNearest, LinearMipMapLinear, MinFilterCount }; public: // @{ ITexture(); ITexture(const ITexture &tex) {operator=(tex);} virtual ~ITexture(); ITexture &operator=(const ITexture &tex); // @} // @{ void setWrapS(TWrapMode mode) {_WrapS= mode;} void setWrapT(TWrapMode mode) {_WrapT= mode;} TWrapMode getWrapS() const {return _WrapS;} TWrapMode getWrapT() const {return _WrapT;} void setUploadFormat(TUploadFormat pf); TUploadFormat getUploadFormat() const {return _UploadFormat;} virtual void setFilterMode(TMagFilter magf, TMinFilter minf); TMagFilter getMagFilter() const {return _MagFilter;} TMinFilter getMinFilter() const {return _MinFilter;} bool mipMapOff() const {return _MinFilter==NearestMipMapOff || _MinFilter==LinearMipMapOff;} bool mipMapOn() const {return !mipMapOff();} // @} void touch() { _ListInvalidRect.clear (); _Touched=true; _GoodGenerate= false; } void touchRect(const NLMISC::CRect& rect) { // The texture must not support sharing.... nlassert(!supportSharing()); // Don't invalidate the rectangle if the full texture is already invalidated. if (!isAllInvalidated ()) { // Add the region to invalidate list _ListInvalidRect.push_back (rect); // Touch flag _Touched=true; } _GoodGenerate= false; } bool getReleasable() const { return _Releasable; } void setReleasable(bool r) { _Releasable = r; } void generate() { if(!_GoodGenerate) { doGenerate(); _GoodGenerate=true; } } void validateGenerateFlag() {_GoodGenerate=true;} virtual void release() { reset(); _GoodGenerate= false; } virtual bool supportSharing() const {return false;} virtual std::string getShareName() const {return std::string();} bool setupedIntoDriver() const { return TextureDrvShare!=NULL; } void releaseDriverSetup(); virtual bool allowDegradation() const { return false; } virtual void serial(NLMISC::IStream &f) throw(NLMISC::EStream); virtual void selectTexture(uint index) {} virtual bool isSelectable() const { return false; } virtual ITexture *buildNonSelectableVersion(uint index) { return this; } // @{ virtual bool isTextureCube() const { return false; } // @} //**************************** // Private part. protected: // Derived texture should set it to true when they are updated. bool _Touched; virtual void doGenerate() = 0; private: bool _GoodGenerate; bool _Releasable; TUploadFormat _UploadFormat; TWrapMode _WrapS; TWrapMode _WrapT; TMinFilter _MinFilter; TMagFilter _MagFilter; public: // Private Part!!!. For Driver Only. //================================== NLMISC::CRefPtr<CTextureDrvShare> TextureDrvShare; std::list<NLMISC::CRect> _ListInvalidRect; bool isAllInvalidated () const { return _Touched&&(_ListInvalidRect.begin()==_ListInvalidRect.end()); } bool touched (void) { return _Touched; } /* * Clear the touched flag and the invalid rectangle list * * \see isAllInvalidated(), generate(), touch(), touched(), touchRect(), _ListInvalidRect */ void clearTouched(void) { _Touched=false; _ListInvalidRect.clear(); } }; } // NL3D #endif // NL_TEXTURE_H /* End of texture.h */