Source/System/State/Base/OSGTextureObjChunk.h

   1 /*---------------------------------------------------------------------------*\
   2  *                                OpenSG                                     *
   3  *                                                                           *
   4  *                                                                           *
   5  *             Copyright (C) 2000-2002 by the OpenSG Forum                   *
   6  *                                                                           *
   7  *                            www.opensg.org                                 *
   8  *                                                                           *
   9  *   contact: dirk@opensg.org, gerrit.voss@vossg.org, jbehr@zghdv.de          *
  10  *                                                                           *
  11 \*---------------------------------------------------------------------------*/
  12 /*---------------------------------------------------------------------------*\
  13  *                                License                                    *
  14  *                                                                           *
  15  * This library is free software; you can redistribute it and/or modify it   *
  16  * under the terms of the GNU Library General Public License as published    *
  17  * by the Free Software Foundation, version 2.                               *
  18  *                                                                           *
  19  * This library is distributed in the hope that it will be useful, but       *
  20  * WITHOUT ANY WARRANTY; without even the implied warranty of                *
  21  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU         *
  22  * Library General Public License for more details.                          *
  23  *                                                                           *
  24  * You should have received a copy of the GNU Library General Public         *
  25  * License along with this library; if not, write to the Free Software       *
  26  * Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.                 *
  27  *                                                                           *
  28 \*---------------------------------------------------------------------------*/
  29 /*---------------------------------------------------------------------------*\
  30  *                                Changes                                    *
  31  *                                                                           *
  32  *                                                                           *
  33  *                                                                           *
  34  *                                                                           *
  35  *                                                                           *
  36  *                                                                           *
  37 \*---------------------------------------------------------------------------*/
  38
  39 #ifndef _OSGTEXTUREOBJCHUNK_H_
  40 #define _OSGTEXTUREOBJCHUNK_H_
  41 #ifdef __sgi
  42 #pragma once
  43 #endif
  44
  45 #include "OSGTextureObjChunkBase.h"
  46
  47 OSG_BEGIN_NAMESPACE
  48
  49 /*! \brief State chunk for textures. See \ref PageSystemTextureObjChunk
  50            for a description.
  51     \ingroup GrpSystemStateBaseChunks
  52     \ingroup GrpLibOSGSystem
  53     \includebasedoc
  54  */
  55
  56 class OSG_SYSTEM_DLLMAPPING TextureObjChunk : public TextureObjChunkBase
  57 {
  58     /*==========================  PUBLIC  =================================*/
  59
  60   public:
  61
  62      static StatElemDesc<StatIntOnceElem> statNTextures;
  63      static StatElemDesc<StatIntOnceElem> statNTexBytes;
  64
  65     // Flags can be OR-ed, e.g. NPotTexScale for old gpu and YFlip for videos.
  66
  67     enum NPOTMatrixScaleE
  68     {
  69         None_TT         = 0,
  70         NPotTexScale_TT = 1,
  71         XFlip_TT        = 2,
  72         YFlip_TT        = 4,
  73         ZFlip_TT        = 8
  74     };
  75
  76     /*---------------------------------------------------------------------*/
  77     /*! \name                 Chunk Class Access                           */
  78     /*! \{                                                                 */
  79
  80     /*! \}                                                                 */
  81     /*---------------------------------------------------------------------*/
  82     /*! \name              Static Chunk Class Access                       */
  83     /*! \{                                                                 */
  84
  85     /*! \}                                                                 */
  86     /*---------------------------------------------------------------------*/
  87     /*! \name                    Chunk Id                                  */
  88     /*! \{                                                                 */
  89
  90     virtual bool isCubeTexture(void);
  91
  92     /*! \}                                                                 */
  93     /*---------------------------------------------------------------------*/
  94     /*! \name                      Sync                                    */
  95     /*! \{                                                                 */
  96
  97     virtual void changed(ConstFieldMaskArg whichField,
  98                          UInt32            origin,
  99                          BitVector         details);
 100
 101     /*! \}                                                                 */
 102     /*---------------------------------------------------------------------*/
 103     /*! \name                      Output                                  */
 104     /*! \{                                                                 */
 105
 106     virtual void dump(      UInt32    uiIndent = 0,
 107                       const BitVector bvFlags  = 0) const;
 108
 109     /*! \}                                                                 */
 110     /*---------------------------------------------------------------------*/
 111     /*! \name                       State                                  */
 112     /*! \{                                                                 */
 113
 114     virtual void activate   (DrawEnv    *pEnv,
 115                              UInt32      index = 0);
 116
 117     virtual void changeFrom (DrawEnv    *pEnv,
 118                              StateChunk *pOld,
 119                              UInt32      index = 0);
 120
 121     virtual void deactivate (DrawEnv    *pEnv,
 122                              UInt32      index = 0);
 123
 124     virtual bool isTransparent (void) const;
 125
 126     /*! \}                                                                 */
 127     /*---------------------------------------------------------------------*/
 128     /*! \name                       query                                  */
 129     /*! \{                                                                 */
 130
 131     GLenum determineTextureTarget (Window *pWindow        ) const;
 132     void   determineFormats       (GLenum &internalFormat,
 133                                    GLenum &externalFormat ) const;
 134
 135     /*! \}                                                                 */
 136     /*---------------------------------------------------------------------*/
 137     /*! \name                   Comparison                                 */
 138     /*! \{                                                                 */
 139
 140     virtual Real32 switchCost(StateChunk * chunk);
 141
 142     virtual bool   operator <  (const StateChunk &other) const;
 143
 144     virtual bool   operator == (const StateChunk &other) const;
 145     virtual bool   operator != (const StateChunk &other) const;
 146
 147     /*! \}                                                                 */
 148     /*---------------------------------------------------------------------*/
 149     /*! \name                Texture specific                              */
 150     /*! \{                                                                 */
 151
 152     void imageContentChanged  (Int32 minx = -1, Int32 maxx = -1,
 153                                Int32 miny = -1, Int32 maxy = -1,
 154                                Int32 minz = -1, Int32 maxz = -1);
 155
 156     /*! \}                                                                 */
 157     /*---------------------------------------------------------------------*/
 158     /*! \name             Multitexture handling                            */
 159     /*! \{                                                                 */
 160
 161     virtual void   validate               (DrawEnv *pEnv);
 162     virtual Int32  getOpenGLId            (DrawEnv *pEnv);
 163     virtual GLenum determineInternalFormat(void         );
 164
 165     /*! \}                                                                 */
 166     /*=========================  PROTECTED  ===============================*/
 167
 168   protected:
 169
 170     /*---------------------------------------------------------------------*/
 171     /*! \name                       Init                                   */
 172     /*! \{                                                                 */
 173
 174     void onCreate      (const TextureObjChunk *source      = NULL);
 175     void onCreateAspect(const TextureObjChunk *createAspect,
 176                         const TextureObjChunk *source      = NULL);
 177     void onDestroy     (      UInt32           uiContainerId     );
 178
 179     /*! \}                                                                 */
 180     /*---------------------------------------------------------------------*/
 181     /*! \name                   Constructors                               */
 182     /*! \{                                                                 */
 183
 184     TextureObjChunk(void);
 185     TextureObjChunk(const TextureObjChunk &source);
 186
 187     /*! \}                                                                 */
 188     /*---------------------------------------------------------------------*/
 189     /*! \name                   Destructors                                */
 190     /*! \{                                                                 */
 191
 192     virtual ~TextureObjChunk(void);
 193
 194     /*! \}                                                                 */
 195     /*---------------------------------------------------------------------*/
 196     /*! \name                       Init                                   */
 197     /*! \{                                                                 */
 198
 199     static void initMethod(InitPhase ePhase);
 200
 201     /*! \}                                                                 */
 202     /*---------------------------------------------------------------------*/
 203     /*! \name                         GL                                   */
 204     /*! \{                                                                 */
 205
 206     void handleTexture(Window                  *win,
 207                        UInt32                   id,
 208                        GLenum                   bindtarget,
 209                        GLenum                   paramtarget,
 210                        GLenum                   imgtarget,
 211                        Window::GLObjectStatusE  mode,
 212                        Image                   *img,
 213                        Int32                    side = 0);
 214
 215     /*! \}                                                                 */
 216     /*---------------------------------------------------------------------*/
 217
 218     // extension indices for used extensions;
 219     static UInt32 _extTex3D;
 220     static UInt32 _extTextureArray;
 221     static UInt32 _sgisGenerateMipmap;
 222     static UInt32 _arbTextureCompression;
 223     static UInt32 _arbTextureRectangle;
 224     static UInt32 _arbTextureNonPowerOfTwo;
 225     static UInt32 _extTextureFilterAnisotropic;
 226     static UInt32 _extShadow;
 227     static UInt32 _extDepthTexture;
 228
 229     // extension indices for used fucntions;
 230     static UInt32 _funcTexImage3D;
 231     static UInt32 _funcTexImage3DExt;
 232     static UInt32 _funcTexSubImage3D;
 233     static UInt32 _funcTexSubImage3DExt;
 234     static UInt32 _arbCubeTex;
 235     static UInt32 _funcCompressedTexImage1D;
 236     static UInt32 _funcCompressedTexSubImage1D;
 237     static UInt32 _funcCompressedTexImage2D;
 238     static UInt32 _funcCompressedTexSubImage2D;
 239     static UInt32 _funcCompressedTexImage3D;
 240     static UInt32 _funcCompressedTexSubImage3D;
 241
 242     // class. Used for indexing in State
 243     // protected to give CubeTextureChunk access
 244
 245     /*==========================  PRIVATE  ================================*/
 246
 247   private:
 248
 249     typedef TextureObjChunkBase Inherited;
 250
 251     friend class FieldContainer;
 252     friend class TextureObjChunkBase;
 253
 254     /*---------------------------------------------------------------------*/
 255     /*! \name                         GL                                   */
 256     /*! \{                                                                 */
 257
 258            UInt32 handleGL       (DrawEnv                 *pEnv,
 259                                   UInt32                   id,
 260                                   Window::GLObjectStatusE  mode,
 261                                   UInt64                   uiOptions);
 262
 263     static void   handleDestroyGL(DrawEnv                 *pEnv,
 264                                   UInt32                   id,
 265                                   Window::GLObjectStatusE  mode     );
 266
 267     /*! \}                                                                 */
 268     /*---------------------------------------------------------------------*/
 269
 270     // prohibit default functions (move to 'public' if you need one)
 271     void operator =(const TextureObjChunk &source);
 272 };
 273
 274 typedef TextureObjChunk *TextureObjChunkP;
 275
 276 OSG_END_NAMESPACE
 277
 278 #include "OSGTextureObjChunkBase.inl"
 279 #include "OSGTextureObjChunk.inl"
 280
 281 #endif /* _OSGTEXTUREOBJCHUNK_H_ */