rISurfaceTexture Class Reference

abstract texture class working with SDL surfaces More...

#include <rTexture.h>

Inheritance diagram for rISurfaceTexture:

[legend]

Collaboration diagram for rISurfaceTexture:

[legend]

List of all members.

Public Member Functions
	rISurfaceTexture (int group, bool repx=0, bool repy=0, bool storeAlpha=false)
	constructor setting flags
virtual	~rISurfaceTexture ()
	destructor
bool	Loaded ()
	returns whether the texture is currently loaded
Static Public Attributes
static bool	storageHack_ = false
	when set, this flag inhibits storage of the alpha channel (for compatibility with some cards)
Protected Member Functions
virtual void	ProcessImage (SDL_Surface *)
	process the surface before uploading it to GL
void	Upload (rSurface &surface)
	Uploads the passed surface to OpenGL (for use in OnSelect).
virtual void	OnSelect (bool enforce)
	Selects the texture for rendering.
virtual void	OnSelect ()=0
	Selects the texture for rendering (core part).
virtual void	OnUnload ()
	Unloads the texture from OpenGL and memory.
void	StoreAlpha ()
	sets the alpha store flag
Static Protected Attributes
static bool	s_reportErrors_ = false
	flag indicating whether errors should be reported
Private Attributes
int	group_
	the texture group (determines rendering options)
int	textureModeLast_
	the last texture storage mode this texture was used with
rGLuintObjectTexture	tint_
	the OpenGL id of this texture
bool	repx_
bool	repy_
	flags indicating whether the texture repeats in x and y direction
bool	storeAlpha_
	flag indicating whether the alpha value should be stored

---

Detailed Description

abstract texture class working with SDL surfaces

Definition at line 124 of file rTexture.h.

---

Constructor & Destructor Documentation

rISurfaceTexture::rISurfaceTexture	(	int	group,
		bool	repx = 0,
		bool	repy = 0,
		bool	storeAlpha = false
	)

constructor setting flags

Parameters:

	group	texture group ( floor/wall)
	repx	flag indicating the x repeat mode
	repy	flag indicating the y repeat mode
	storeAlpha	flag indicating whether the alpha channel should be stored

Definition at line 438 of file rTexture.cpp.

        : group_( group ), textureModeLast_( -1), repx_( repx ), repy_( repy ), storeAlpha_( storeAlpha )
{
}

rISurfaceTexture::~rISurfaceTexture

(

void

)

[virtual]

destructor

Definition at line 452 of file rTexture.cpp.

References rDisplayList::ClearAll(), and tint_.

{
    if (tint_.IsValid() )
    {
        rDisplayList::ClearAll();
    }
}

Here is the call graph for this function:

---

Member Function Documentation

bool rISurfaceTexture::Loaded

(

)

[inline]

returns whether the texture is currently loaded

Definition at line 131 of file rTexture.h.

References textureModeLast_.

Referenced by gLogo::Display(), and rFont::OnSelect().

Here is the caller graph for this function:

void rISurfaceTexture::ProcessImage

(

SDL_Surface *

surface

)

[protected, virtual]

process the surface before uploading it to GL

Parameters:

surface

the surface to process

Reimplemented in rFont, and gTextureCycle.

Definition at line 470 of file rTexture.cpp.

Referenced by Upload().

{
}

Here is the caller graph for this function:

void rISurfaceTexture::Upload

(

rSurface &

surface

)

[protected]

Uploads the passed surface to OpenGL (for use in OnSelect).

Parameters:

surface

Definition at line 484 of file rTexture.cpp.

References rSurface::GetFormat(), rSurface::GetSurface(), GL_CLAMP_TO_EDGE, ProcessImage(), repx_, repy_, sr_LockSDL(), sr_texturesTruecolor, sr_UnlockSDL(), storageHack_, storeAlpha_, and tASSERT.

Referenced by rSurfaceTexture::OnSelect(), and rFileTexture::OnSelect().

{
#ifndef DEDICATED
    sr_LockSDL();
    GLenum texformat = surface.GetFormat();
    SDL_Surface * tex = surface.GetSurface();
    tASSERT( tex );

    bool texalpha=tex->format->Amask;

    ProcessImage(tex);

    if(repx_)
        glTexParameteri(GL_TEXTURE_2D,GL_TEXTURE_WRAP_S,GL_REPEAT);
    else
        glTexParameteri(GL_TEXTURE_2D,GL_TEXTURE_WRAP_S,GL_CLAMP_TO_EDGE);
    if(repy_)
        glTexParameteri(GL_TEXTURE_2D,GL_TEXTURE_WRAP_T,GL_REPEAT);
    else
        glTexParameteri(GL_TEXTURE_2D,GL_TEXTURE_WRAP_T,GL_CLAMP_TO_EDGE);

    int format;
    if (sr_texturesTruecolor)
        if (storageHack_ || ( storeAlpha_ && texalpha ) )
            format=GL_RGBA8;
        else
            format=GL_RGB8;
    else
        if (storageHack_ || ( storeAlpha_ && texalpha ) )
            format=GL_RGBA4;
        else
            format=GL_RGB5;

    gluBuild2DMipmaps(GL_TEXTURE_2D,format,tex->w,tex->h,
                      texformat,GL_UNSIGNED_BYTE,tex->pixels);

    sr_UnlockSDL();
 #endif
}

Here is the call graph for this function:

Here is the caller graph for this function:

void rISurfaceTexture::OnSelect

(

bool

enforce

)

[protected, virtual]

Selects the texture for rendering.

Parameters:

enforce

enforce when set to true, the texture should be loaded even if the configuration says it should not

Implements rITexture.

Reimplemented in rFont, and gTextureCycle.

Definition at line 534 of file rTexture.cpp.

References rDisplayList::Cancel(), group_, rITexture::OnSelect(), OnSelect(), RenderEnd(), sr_glOut, rTextureGroups::TextureMode, textureModeLast_, tint_, and rITexture::Unload().

{
#ifndef DEDICATED
    if(sr_glOut)
    {
        RenderEnd(true);

        int texmod=rTextureGroups::TextureMode[group_];
        if (enforce && texmod<0) texmod=GL_NEAREST_MIPMAP_NEAREST;

        if(textureModeLast_!=texmod)
        {
            // unload texture if the mode changed
            Unload();
            // std::cerr << "loading texture " << fileName << ':' << tint << "\n";

            if (texmod>0){
                // don't generate textures inside display lists
                rDisplayList::Cancel();

                glBindTexture(GL_TEXTURE_2D,tint_);

                if (textureModeLast_<0)
                {
                    // delegate core loading work to derived class
                    OnSelect();
                }

                //glEnable(GL_TEXTURE);
                glEnable(GL_TEXTURE_2D);

                glTexParameteri(GL_TEXTURE_2D,GL_TEXTURE_MIN_FILTER,
                                texmod);

                switch(texmod)
                {
                case GL_NEAREST:
                case GL_NEAREST_MIPMAP_NEAREST:
                    glTexParameteri(GL_TEXTURE_2D,GL_TEXTURE_MAG_FILTER,
                                    GL_NEAREST);
                    break;
                default:
                    glTexParameteri(GL_TEXTURE_2D,GL_TEXTURE_MAG_FILTER,
                                    GL_LINEAR);
                    break;
                }

            }
            else
            {
                glDisable(GL_TEXTURE_2D);
            }
        }
        else
        {
            glBindTexture(GL_TEXTURE_2D,tint_);
            if (texmod>0)
            {
                glEnable(GL_TEXTURE_2D);
            }
            else
            {
                glDisable(GL_TEXTURE_2D);
            }
        }
        textureModeLast_=texmod;
    }
    rITexture::OnSelect(enforce);
#endif
}

Here is the call graph for this function:

void rISurfaceTexture::OnSelect

(

)

[protected, pure virtual]

Selects the texture for rendering (core part).

In derived classes, this routine is supposed to do the work of loading the texture into memory and using the Upload() function to upload it to OpenGL.

Implemented in rFileTexture, and rSurfaceTexture.

Definition at line 616 of file rTexture.cpp.

Referenced by gTextureCycle::OnSelect(), rSurfaceTexture::OnSelect(), rFileTexture::OnSelect(), OnSelect(), and rFont::OnSelect().

{
}

Here is the caller graph for this function:

void rISurfaceTexture::OnUnload

(

void

)

[protected, virtual]

Unloads the texture from OpenGL and memory.

Implements rITexture.

Definition at line 629 of file rTexture.cpp.

References rDisplayList::ClearAll(), rITexture::OnUnload(), textureModeLast_, and tint_.

{
#ifndef DEDICATED
    if ( tint_.IsValid() )
    {
        rDisplayList::ClearAll();
    }

    tint_.Delete();
    textureModeLast_=-100;
    rITexture::OnUnload();
#endif
}

Here is the call graph for this function:

void rISurfaceTexture::StoreAlpha

(

void

)

[protected]

sets the alpha store flag

Definition at line 652 of file rTexture.cpp.

References storeAlpha_.

Referenced by rFont::rFont().

{
    storeAlpha_ = true;
}

Here is the caller graph for this function:

---

Member Data Documentation

bool rISurfaceTexture::storageHack_ = false [static]

when set, this flag inhibits storage of the alpha channel (for compatibility with some cards)

Definition at line 134 of file rTexture.h.

Referenced by lowlevel_sr_InitDisplay(), and Upload().

bool rISurfaceTexture::s_reportErrors_ = false [static, protected]

flag indicating whether errors should be reported

Definition at line 146 of file rTexture.h.

Referenced by rFileTexture::OnSelect().

int rISurfaceTexture::group_ [private]

the texture group (determines rendering options)

Definition at line 149 of file rTexture.h.

Referenced by OnSelect().

int rISurfaceTexture::textureModeLast_ [private]

the last texture storage mode this texture was used with

Definition at line 151 of file rTexture.h.

Referenced by Loaded(), OnSelect(), and OnUnload().

rGLuintObjectTexture rISurfaceTexture::tint_ [private]

the OpenGL id of this texture

Definition at line 153 of file rTexture.h.

Referenced by OnSelect(), OnUnload(), and ~rISurfaceTexture().

bool rISurfaceTexture::repx_ [private]

Definition at line 154 of file rTexture.h.

Referenced by Upload().

bool rISurfaceTexture::repy_ [private]

flags indicating whether the texture repeats in x and y direction

Definition at line 154 of file rTexture.h.

Referenced by Upload().

bool rISurfaceTexture::storeAlpha_ [private]

flag indicating whether the alpha value should be stored

Definition at line 155 of file rTexture.h.

Referenced by StoreAlpha(), and Upload().

---

The documentation for this class was generated from the following files:

• src/render/rTexture.h
• src/render/rTexture.cpp

---