Texture Class Reference

#include <aux_texture.h>

Inheritance diagram for Texture:

Public Member Functions
void	FileNotFound (const std::string &)
GFXBOOL	checkold (const std::string &s, bool shared, std::string &hashname)
	Returns if this texture is actually already loaded. More...
void	modold (const std::string &s, bool shared, std::string &hashname)
void	setold ()
	Loads the old texture. More...
bool	checkbad (const string &s)
void	setbad (const string &s)
void	InitTexture ()
	Inits the class with default values. More...
int	Bind (Texture *other, int maxdimension=65536, GFXBOOL detailtexture=GFXFALSE)
	Binds this texture to the same name as the given texture - for multipart textures. More...
	Texture (int stage=0, enum FILTER mipmap=MIPMAP, enum TEXTURE_TARGET target=TEXTURE2D, enum TEXTURE_IMAGE_TARGET imagetarget=TEXTURE_2D, enum ADDRESSMODE address_mode=DEFAULT_ADDRESS_MODE)
	Creates an unbounded texture. Set data and dimensions before binding. Or explicitly load a file. More...
	Texture (const char *, const char *, int stage=0, enum FILTER mipmap=MIPMAP, enum TEXTURE_TARGET target=TEXTURE2D, enum TEXTURE_IMAGE_TARGET imagetarget=TEXTURE_2D, float alpha=1, int zeroval=0, GFXBOOL force=GFXFALSE, int max_dimension_size=65536, GFXBOOL detail_texture=GFXFALSE, GFXBOOL nocache=false, enum ADDRESSMODE address_mode=DEFAULT_ADDRESS_MODE, Texture *main=0)
	Creates a texture with a single bitmap as color data and another grayscale .bmp as alpha data. More...
	Texture (const char *FileName, int stage=0, enum FILTER mipmap=MIPMAP, enum TEXTURE_TARGET target=TEXTURE2D, enum TEXTURE_IMAGE_TARGET imagetarget=TEXTURE_2D, GFXBOOL force=GFXFALSE, int max_dimension_size=65536, GFXBOOL detail_texture=GFXFALSE, GFXBOOL nocache=false, enum ADDRESSMODE address_mode=DEFAULT_ADDRESS_MODE, Texture *main=0)
	Creates a texture with only color data as a single bitmap. More...
	Texture (VSFileSystem::VSFile *f, int stage=0, enum FILTER mipmap=MIPMAP, enum TEXTURE_TARGET target=TEXTURE2D, enum TEXTURE_IMAGE_TARGET imagetarget=TEXTURE_2D, GFXBOOL force=GFXFALSE, int max_dimension_size=65536, GFXBOOL detail_texture=GFXFALSE, GFXBOOL nocache=false, enum ADDRESSMODE address_mode=DEFAULT_ADDRESS_MODE, Texture *main=0)
void	Load (const char *, const char *, int stage=0, enum FILTER mipmap=MIPMAP, enum TEXTURE_TARGET target=TEXTURE2D, enum TEXTURE_IMAGE_TARGET imagetarget=TEXTURE_2D, float alpha=1, int zeroval=0, GFXBOOL force=GFXFALSE, int max_dimension_size=65536, GFXBOOL detail_texture=GFXFALSE, GFXBOOL nocache=false, enum ADDRESSMODE address_mode=DEFAULT_ADDRESS_MODE, Texture *main=0)
void	Load (const char *FileName, int stage=0, enum FILTER mipmap=MIPMAP, enum TEXTURE_TARGET target=TEXTURE2D, enum TEXTURE_IMAGE_TARGET imagetarget=TEXTURE_2D, GFXBOOL force=GFXFALSE, int max_dimension_size=65536, GFXBOOL detail_texture=GFXFALSE, GFXBOOL nocache=false, enum ADDRESSMODE address_mode=DEFAULT_ADDRESS_MODE, Texture *main=0)
virtual const Texture *	Original () const
virtual Texture *	Original ()
virtual Texture *	Clone ()
virtual	~Texture ()
	Texture copy constructor that increases appropriate refcounts. More...
virtual unsigned int	numFrames () const
virtual double	curTime () const
virtual void	setTime (double tim)
virtual float	framesPerSecond () const
virtual unsigned int	numLayers () const
virtual unsigned int	numPasses () const
virtual bool	canMultiPass () const
virtual bool	constFrameRate () const
int	getStage () const
int	getFilter () const
int	getTarget () const
int	getImageTarget () const
bool	operator< (const Texture &b) const
	A way to sort the texture by the original address (to make sure like textures stick togehter. More...
bool	operator== (const Texture &b) const
	A way to test if the texture is equal to another based on original values. More...
void	setReference (Texture *other)
	Make this instance a reference of "other". More...
virtual void	MakeActive ()
	Binds the texture in the GFX library. More...
virtual void	MakeActive (int stage)
virtual void	MakeActive (int stage, int pass)
virtual bool	SetupPass (int pass, const enum BLENDFUNC src, const enum BLENDFUNC dst)
virtual bool	SetupPass (int pass, int stage, const enum BLENDFUNC src, const enum BLENDFUNC dst)
virtual bool	LoadSuccess ()
	If the texture has loaded properly returns true. More...
virtual void	Prioritize (float)
	Changes priority of texture. More...

Static Public Member Functions
static Texture *	Exists (std::string s)
	Whether or not the string exists as a texture. More...
static Texture *	Exists (std::string s, std::string a)
	Whether or not the color and alpha data already exist. More...

Public Attributes
StringPool::Reference	texfilename
	The file name used to load this texture. More...
enum FILTER	ismipmapped
	the filter mode of this texture More...
unsigned char *	data
	The data of this texture (used in between functions, deleted) More...
int	name
	The GFXname of this texture. More...
int	stage
	The multitexture stage of this texture. More...
Vector	mintcoord
	The minimum/maximum texturing coordinates for this texture (have in mind that it is not always enforce, ie. for meshes) (i=s, j=t, k=u) More...
Vector	maxtcoord
Texture *	original
	The original data that would represent this texture. More...
bool	bound
	For re-biding. More...
uint	boundSizeX
uint	boundSizeY
VSImageMode	boundMode
int	refcount
	The number of references on the original data. More...
enum TEXTURE_TARGET	texture_target
	The target this will go to (cubemap or otherwise) More...
enum TEXTURE_IMAGE_TARGET	image_target
enum ADDRESSMODE	address_mode
	The address mode being used with this texture. More...

Protected Member Functions
int	Bind (int maxdimension, GFXBOOL detailtexture)
	Binds this texture to GFX library. More...
void	UnBind ()
	UnBinds from GFX library. More...
void	Transfer (int maxdimension, GFXBOOL detailtexture)
	Transfers this texture to GFX library. More...

Detailed Description

The texture class defines a method of loading bitmap textures It also defines a hash table in which textures are kept and looked up to prevent the loading of duplicate textures

Definition at line 38 of file aux_texture.h.

Constructor & Destructor Documentation

Texture::Texture	(	int	stage = 0,
		enum FILTER	mipmap = MIPMAP,
		enum TEXTURE_TARGET	target = TEXTURE2D,
		enum TEXTURE_IMAGE_TARGET	imagetarget = TEXTURE_2D,
		enum ADDRESSMODE	address_mode = DEFAULT_ADDRESS_MODE
	)

Creates an unbounded texture. Set data and dimensions before binding. Or explicitly load a file.

Definition at line 208 of file aux_texture.cpp.

Referenced by AnimatedTexture::LoadAni().

{
    InitTexture();
    data = NULL;
    ismipmapped    = mipmap;
    palette        = NULL;
    texture_target = target;
    image_target   = imagetarget;
    this->stage    = stage;
}

Texture::Texture	(	const char *	FileNameRGB,
		const char *	FileNameA,
		int	stage = 0,
		enum FILTER	mipmap = MIPMAP,
		enum TEXTURE_TARGET	target = TEXTURE2D,
		enum TEXTURE_IMAGE_TARGET	imagetarget = TEXTURE_2D,
		float	alpha = 1,
		int	zeroval = 0,
		GFXBOOL	force = GFXFALSE,
		int	max_dimension_size = 65536,
		GFXBOOL	detail_texture = GFXFALSE,
		GFXBOOL	nocache = false,
		enum ADDRESSMODE	address_mode = DEFAULT_ADDRESS_MODE,
		Texture *	main = 0
	)

Creates a texture with a single bitmap as color data and another grayscale .bmp as alpha data.

Definition at line 388 of file aux_texture.cpp.

{
    InitTexture();
    Load( FileNameRGB,
          FileNameA,
          stage,
          mipmap,
          target,
          imagetarget,
          alpha,
          zeroval,
          force_load,
          maxdimension,
          detailtexture,
          nocache,
          address_mode,
          main );
}

Texture::Texture	(	const char *	FileName,
		int	stage = 0,
		enum FILTER	mipmap = MIPMAP,
		enum TEXTURE_TARGET	target = TEXTURE2D,
		enum TEXTURE_IMAGE_TARGET	imagetarget = TEXTURE_2D,
		GFXBOOL	force = GFXFALSE,
		int	max_dimension_size = 65536,
		GFXBOOL	detail_texture = GFXFALSE,
		GFXBOOL	nocache = false,
		enum ADDRESSMODE	address_mode = DEFAULT_ADDRESS_MODE,
		Texture *	main = 0
	)

Creates a texture with only color data as a single bitmap.

Definition at line 262 of file aux_texture.cpp.

{
    InitTexture();
    Load( FileName, stage, mipmap, target, imagetarget, force_load, maxdimension, detailtexture, nocache, address_mode, main );
}

Texture::Texture	(	VSFileSystem::VSFile *	f,
		int	stage = 0,
		enum FILTER	mipmap = MIPMAP,
		enum TEXTURE_TARGET	target = TEXTURE2D,
		enum TEXTURE_IMAGE_TARGET	imagetarget = TEXTURE_2D,
		GFXBOOL	force = GFXFALSE,
		int	max_dimension_size = 65536,
		GFXBOOL	detail_texture = GFXFALSE,
		GFXBOOL	nocache = false,
		enum ADDRESSMODE	address_mode = DEFAULT_ADDRESS_MODE,
		Texture *	main = 0
	)

Definition at line 223 of file aux_texture.cpp.

References VSFileSystem::FileNotFound, and NEAREST.

{
    data = NULL;
    ismipmapped    = mipmap;
    InitTexture();
    palette        = NULL;
    texture_target = target;
    image_target   = imagetarget;
    this->stage    = stage;
    data           = this->ReadImage( f, NULL, true, NULL );
    if (data) {
        if (mode >= _DXT1 && mode <= _DXT5) {
            if ( (int) data[0] == 0 ) {
                detailtexture = NEAREST;
                ismipmapped   = NEAREST;
            }
        }
        if (main)
            Bind( main, maxdimension, detailtexture );
        else
            Bind( maxdimension, detailtexture );
        free( data );
        data = NULL;
        if (!nocache) setold();
    } else {
        FileNotFound( texfilename );
    }
}

Texture::~Texture ( )

virtual

Texture copy constructor that increases appropriate refcounts.

Destructor for texture

DEPRECATED if(data != NULL) { delete [] data;

data = NULL; }

Definition at line 519 of file aux_texture.cpp.

{
    if (original == NULL) {
        UnBind();
        if (palette != NULL) {
            free( palette );
            palette = NULL;
        }
    } else {
        original->refcount--;
        if (original->refcount == 0)
            delete original;
    }
}

Member Function Documentation

int Texture::Bind ( int  maxdimension, GFXBOOL  detailtexture  )

protected

Binds this texture to GFX library.

Definition at line 598 of file aux_texture.cpp.

References DXT1, DXT1RGBA, DXT3, DXT5, GFXCreateTexture(), PALETTE8, RGB24, and RGBA32.

Referenced by AnimatedTexture::LoadVideoSource().

{
    if ( !bound || (boundSizeX != sizeX) || (boundSizeY != sizeY) || (boundMode != mode) ) {
        UnBind();
        switch (mode)
        {
        case _DXT1:
            GFXCreateTexture( sizeX, sizeY, DXT1, &name, NULL, stage, ismipmapped, texture_target, address_mode );
            break;
        case _DXT1RGBA:
            GFXCreateTexture( sizeX, sizeY, DXT1RGBA, &name, NULL, stage, ismipmapped, texture_target, address_mode );
            break;

        case _DXT3:
            GFXCreateTexture( sizeX, sizeY, DXT3, &name, NULL, stage, ismipmapped, texture_target, address_mode );
            break;
        case _DXT5:
            GFXCreateTexture( sizeX, sizeY, DXT5, &name, NULL, stage, ismipmapped, texture_target, address_mode );
            break;

        case _24BITRGBA:
            //GFXCreateTexture(sizeX, sizeY, RGBA32, &name, NULL, stage);
            GFXCreateTexture( sizeX, sizeY, RGBA32, &name, NULL, stage, ismipmapped, texture_target, address_mode );
            break;
        case _24BIT:
            //not supported by most cards, so i use rgba32
            //GFXCreateTexture(sizeX, sizeY, RGB24, &name);
            GFXCreateTexture( sizeX, sizeY, RGB24, &name, NULL, stage, ismipmapped, texture_target, address_mode );
            break;
        case _8BIT:
            GFXCreateTexture( sizeX, sizeY, PALETTE8, &name, (char*) palette, stage, ismipmapped, texture_target, address_mode );
            break;
        }
    }
    boundSizeX = sizeX;
    boundSizeY = sizeY;
    boundMode  = mode;
    bound = true;
    Transfer( maxdimension, detailtexture );
    return name;
}

int Texture::Bind	(	Texture *	other,
		int	maxdimension = 65536,
		GFXBOOL	detailtexture = GFXFALSE
	)

Binds this texture to the same name as the given texture - for multipart textures.

Definition at line 640 of file aux_texture.cpp.

References bound, boundMode, boundSizeX, boundSizeY, and name.

{
    UnBind();

    boundSizeX = other->boundSizeX;
    boundSizeY = other->boundSizeY;
    boundMode  = other->boundMode;
    bound = other->bound;
    name  = other->name;
    Transfer( maxdimension, detailtexture );
    return name;
}

virtual bool Texture::canMultiPass ( ) const

inlinevirtual

Reimplemented in AnimatedTexture.

Definition at line 218 of file aux_texture.h.

    {
        return true;
    }                                             //True, if full functionality can be achieved after multipass rendering. If false, fallback rendering must be possible by multipass (or singlepass) rendering. True, also, if texturing units are sufficient for singlepass rendering.

bool Texture::checkbad

(

const string &

s)

Definition at line 185 of file aux_texture.cpp.

References badtexHashTable, VSFileSystem::GetHashName(), and VSFileSystem::GetSharedTextureHashName().

{
    string hashname = VSFileSystem::GetSharedTextureHashName( s );
    bool  *found    = NULL;
    found    = badtexHashTable.Get( hashname );
    if (found != NULL)
        return true;
    hashname = VSFileSystem::GetHashName( s );
    found    = badtexHashTable.Get( hashname );
    if (found != NULL)
        return true;
    return false;
}

GFXBOOL Texture::checkold	(	const std::string &	s,
		bool	shared,
		std::string &	hashname
	)

Returns if this texture is actually already loaded.

Definition at line 86 of file aux_texture.cpp.

References VSFileSystem::GetHashName(), VSFileSystem::GetSharedTextureHashName(), GFXFALSE, GFXTRUE, and texHashTable.

{
    hashname = shared ? VSFileSystem::GetSharedTextureHashName( s ) : VSFileSystem::GetHashName( s );
    Texture *oldtex = texHashTable.Get( hashname );
    if (oldtex != NULL) {
        //*this = *oldtex;//will be obsoleted--unpredictable results with string()
        setReference( oldtex );
        //cerr<<"Found cached texture : "<<s<<" with hashname="<<hashname<<endl;
        return GFXTRUE;
    } else {
        return GFXFALSE;
    }
}

Texture * Texture::Clone ( )

virtual

Reimplemented in AnimatedTexture, PipelinedTexture, and StreamTexture.

Definition at line 152 of file aux_texture.cpp.

References name, original, refcount, and BaseUtil::Texture().

Referenced by Background::Cache(), AnimatedTexture::Clone(), Flightgroup::operator=(), SpriteStarVlist::SpriteStarVlist(), and VSSprite::VSSprite().

{
    Texture *retval = new Texture();
    Texture *target = Original();
    *retval = *target;
    //memcpy (this, target, sizeof (Texture));
    if (retval->name != -1) {
        retval->original = target;
        retval->original->refcount++;
    } else {
        retval->original = NULL;
    }
    retval->refcount = 0;
    return retval;
    //assert (!original->original);
}

virtual bool Texture::constFrameRate ( ) const

inlinevirtual

Reimplemented in AnimatedTexture.

Definition at line 223 of file aux_texture.h.

    {
        return true;
    }                                               //If frames advance at a regular rate - keyframe based animations would return false.

virtual double Texture::curTime ( ) const

inlinevirtual

Reimplemented in AnimatedTexture.

Definition at line 196 of file aux_texture.h.

    {
        return 0;
    }                                       //Current time of an animated texture

static Texture* Texture::Exists ( std::string  s)

static

Whether or not the string exists as a texture.

Referenced by DecalQueue::AddTexture().

static Texture* Texture::Exists ( std::string  s, std::string  a  )

static

Whether or not the color and alpha data already exist.

void Texture::FileNotFound

(

const std::string &

)

Definition at line 169 of file aux_texture.cpp.

References texHashTable.

{
    //We may need to remove from texHashTable if we found the file but it is a bad one
    texHashTable.Delete( texfilename );

    setbad( texfilename );
    name = -1;
    data = NULL;
    if (original != NULL) {
        original->name = -1;
        delete original;
        original = NULL;
    }
    palette = NULL;
}

virtual float Texture::framesPerSecond ( ) const

inlinevirtual

Reimplemented in AnimatedTexture.

Definition at line 203 of file aux_texture.h.

    {
        return 0;
    }                                               //Frames per second, if applicable.

int Texture::getFilter ( ) const

inline

Definition at line 233 of file aux_texture.h.

References ismipmapped.

    {
        return ismipmapped;
    }

int Texture::getImageTarget ( ) const

inline

Definition at line 243 of file aux_texture.h.

References image_target.

    {
        return image_target;
    }

int Texture::getStage ( ) const

inline

Definition at line 228 of file aux_texture.h.

References stage.

    {
        return stage;
    }

int Texture::getTarget ( ) const

inline

Definition at line 238 of file aux_texture.h.

References texture_target.

    {
        return texture_target;
    }

void Texture::InitTexture

(

)

Inits the class with default values.

Definition at line 114 of file aux_texture.cpp.

References DEFAULT_ADDRESS_MODE, f, Mesh::refcount, and Vector.

{
    bound = false;
    original     = 0;
    refcount     = 0;
    name         = -1;
    palette      = NULL;
    data         = NULL;
    mintcoord    = Vector( 0.0f, 0.0f, 0.0f );
    maxtcoord    = Vector( 1.0f, 1.0f, 1.0f );
    address_mode = DEFAULT_ADDRESS_MODE;
}

void Texture::Load	(	const char *	FileNameRGB,
		const char *	FileNameA,
		int	stage = 0,
		enum FILTER	mipmap = MIPMAP,
		enum TEXTURE_TARGET	target = TEXTURE2D,
		enum TEXTURE_IMAGE_TARGET	imagetarget = TEXTURE_2D,
		float	alpha = 1,
		int	zeroval = 0,
		GFXBOOL	force = GFXFALSE,
		int	max_dimension_size = 65536,
		GFXBOOL	detail_texture = GFXFALSE,
		GFXBOOL	nocache = false,
		enum ADDRESSMODE	address_mode = DEFAULT_ADDRESS_MODE,
		Texture *	main = 0
	)

Definition at line 420 of file aux_texture.cpp.

References VSFileSystem::VSFile::Close(), f, VSFileSystem::FileNotFound, g_game, VegaConfig::getVariable(), NEAREST, VSFileSystem::Ok, VSFileSystem::VSFile::OpenReadOnly(), XMLSupport::parse_bool(), VSFileSystem::Shared, VSFileSystem::TextureFile, VSFileSystem::Unspecified, game_data_t::use_textures, and vs_config.

{
    if (data) free( data );
    if (palette) free( palette );
    data = NULL;
    palette = NULL;
    ismipmapped = mipmap;

    this->stage = stage;
    this->address_mode = address_mode;
    texture_target     = target;
    image_target       = imagetarget;
    string texfn = string( FileNameRGB )+string( "|" )+string( FileNameA );
    if (!nocache) {
        string tempstr;
        if ( checkold( texfn, false, tempstr )
            || checkold( texfn, true, tempstr ) ) {
            texfilename = tempstr;
            return;
        }
    }
    //VSFileSystem::vs_fprintf (stderr,"2.Loading bmp file %s alp %s ",FileNameRGB,FileNameA);
    //this->texfilename = texfilename;
    //strcpy (filename,texfilename.c_str());
    VSFile  f;
    VSError err = Unspecified;
    err = f.OpenReadOnly( FileNameRGB, TextureFile );
    if (!nocache) {
        bool   shared = (err == Shared);
        string tempstr;
        modold( texfn, shared, tempstr );
        texfilename = tempstr;
    }
    if (err <= Ok && g_game.use_textures == 0 && !force_load) {
        f.Close();
        err = Unspecified;
    }
    if (err > Ok) {
        FileNotFound( texfilename );
        return;
    }
    VSFile  f1;
    VSError err1 = Unspecified;
    bool    shared1;
    if (FileNameA) {
        static bool use_alphamap =
            parse_bool( vs_config->getVariable( "graphics",
                                                "bitmap_alphamap",
                                                "true" ) );
        if (use_alphamap) {
            std::string tmp;
            f1.OpenReadOnly( FileNameA, TextureFile );

            shared1 = (err1 == Shared);
            if (err1 > Ok) {
                data = NULL;
                FileNameA = NULL;
            }
        } else {FileNameA = 0; }}
    if (err1 > Ok)
        data = this->ReadImage( &f, NULL, true, NULL );
    else
        data = this->ReadImage( &f, NULL, true, &f1 );
    if (data) {
        if (mode >= _DXT1 && mode <= _DXT5) {
            if ( (int) data[0] == 0 ) {
                detailtexture = NEAREST;
                ismipmapped   = NEAREST;
            }
        }
        if (main)
            Bind( main, maxdimension, detailtexture );
        else
            Bind( maxdimension, detailtexture );
        free( data );
        data = NULL;
        if (!nocache) setold();
    } else {
        FileNotFound( texfilename );
    }
    f.Close();
    if (err1 <= Ok)
        f1.Close();
    //VSFileSystem::vs_fprintf (stderr,"Load Success\n");
}

void Texture::Load	(	const char *	FileName,
		int	stage = 0,
		enum FILTER	mipmap = MIPMAP,
		enum TEXTURE_TARGET	target = TEXTURE2D,
		enum TEXTURE_IMAGE_TARGET	imagetarget = TEXTURE_2D,
		GFXBOOL	force = GFXFALSE,
		int	max_dimension_size = 65536,
		GFXBOOL	detail_texture = GFXFALSE,
		GFXBOOL	nocache = false,
		enum ADDRESSMODE	address_mode = DEFAULT_ADDRESS_MODE,
		Texture *	main = 0
	)

Definition at line 278 of file aux_texture.cpp.

References bootstrap_draw(), VSFileSystem::VSFile::Close(), f, VSFileSystem::FileNotFound, g_game, VegaConfig::getVariable(), NEAREST, VSFileSystem::Ok, VSFileSystem::VSFile::OpenReadOnly(), XMLSupport::parse_bool(), VSFileSystem::Shared, VSFileSystem::TextureFile, VSFileSystem::Unspecified, game_data_t::use_textures, VSFileSystem::VSFile::Valid(), and vs_config.

{
    if (data) free( data );
    if (palette) free( palette );
    data = NULL;
    palette = NULL;
    ismipmapped = mipmap;
    texture_target     = target;
    image_target       = imagetarget;
    this->stage        = stage;
    this->address_mode = address_mode;
    string texfn = string( FileName );
    if ( checkbad( texfn ) )
        return;
    if (!nocache) {
        string tempstr;
        if ( checkold( texfn, false, tempstr )
            || checkold( texfn, true, tempstr ) ) {
            texfilename = tempstr;
            return;
        }
    }
    //VSFileSystem::vs_fprintf (stderr,"1.Loading bmp file %s ",FileName);
    char *t   = strdup( FileName );
    int   tmp = strlen( FileName );
    if (tmp > 3) {
        t[tmp-3] = 'a';
        t[tmp-2] = 'l';
        t[tmp-1] = 'p';
    }
    VSFile  f2;
    VSError err2 = VSFileSystem::FileNotFound;
    if (t) {
        if (t[0] != '\0') {
            static bool use_alphamap = parse_bool( vs_config->getVariable( "graphics",
                                                                           "bitmap_alphamap",
                                                                           "true" ) );
            if (use_alphamap)
                err2 = f2.OpenReadOnly( t, TextureFile );
        }
    }
    if (err2 <= Ok) {
        //texfilename += string(t);
    }
    //this->texfilename = texfilename;
    //strcpy (filename,texfilename.c_str());
    VSFile  f;
    VSError err; //FIXME err not always initialized before use
    err = Ok; //FIXME this line added temporarily by chuck_starchaser
    if (FileName)
        if (FileName[0])
            err = f.OpenReadOnly( FileName, TextureFile );
    bool shared = (err == Shared);
    free( t );
    if (err <= Ok && g_game.use_textures == 0 && !force_load) {
        f.Close();
        err = Unspecified;
    }
    if (err > Ok) { //FIXME err not guaranteed to have been initialized!
        FileNotFound( texfn );
//VSFileSystem::vs_fprintf (stderr, "\n%s, not found\n",FileName);
        if (err2 <= Ok)
            f2.Close();
        return;
    }
    if (!nocache) {
        string tempstr;
        modold( texfn, shared, tempstr );
        texfilename = tempstr;
    }
    if (texfn.find( "white" ) == string::npos)
        bootstrap_draw( "Loading "+string( FileName ) );
    //strcpy(filename, FileName);
    if (err2 > Ok)
        data = this->ReadImage( &f, NULL, true, NULL );
    else
        data = this->ReadImage( &f, NULL, true, &f2 );
    if (data) {
        if (mode >= _DXT1 && mode <= _DXT5) {
            if ( (int) data[0] == 0 ) {
                detailtexture = NEAREST;
                ismipmapped   = NEAREST;
            }
        }
        if (main)
            Bind( main, maxdimension, detailtexture );
        else
            Bind( maxdimension, detailtexture );
        free( data );
        data = NULL;
        if (!nocache) setold();
    } else {
        FileNotFound( texfilename );
    }
    f.Close();
    if ( f2.Valid() )
        f2.Close();
    //VSFileSystem::vs_fprintf (stderr," Load Success\n");
}

virtual bool Texture::LoadSuccess ( )

inlinevirtual

If the texture has loaded properly returns true.

Reimplemented in AnimatedTexture.

Definition at line 287 of file aux_texture.h.

References name.

Referenced by ActivateWhite(), DecalQueue::AddTexture(), Background::Background(), VSSprite::LoadSuccess(), GuiTexture::read(), and VSSprite::VSSprite().

    {
        return name >= 0;
    }

virtual void Texture::MakeActive ( )

inlinevirtual

Binds the texture in the GFX library.

Reimplemented in AnimatedTexture, PipelinedTexture, and StreamTexture.

Definition at line 264 of file aux_texture.h.

References stage.

Referenced by GameStarSystem::activateLightMap(), ActivateWhite(), SpriteStarVlist::BeginDrawState(), bootstrap_draw(), Bolt::Draw(), Background::Draw(), VSSprite::Draw(), WindowManager::draw(), ParticleTrail::DrawAndUpdate(), DrawHUDSprite(), EndGUIFrame(), AnimatedTexture::MakeActive(), MakeActive(), Halo::ProcessDrawQueue(), Logo::ProcessDrawQueue(), Beam::ProcessDrawQueue(), SetupDamageMapThirdPass(), SetupEnvmapPass(), SetupGlowMapFourthPass(), SetupSpecMapFirstPass(), SetupSpecMapSecondPass(), and TerrainMakeActive().

    {
        MakeActive( this->stage, 0 );
    }                                                      //Assumes stage=this->stage, pass=0

virtual void Texture::MakeActive ( int  stage)

inlinevirtual

Reimplemented in AnimatedTexture, and StreamTexture.

Definition at line 269 of file aux_texture.h.

References MakeActive().

    {
        MakeActive( stage, 0 );
    }                                                         //Assumes pass=0

void Texture::MakeActive ( int  stage, int  pass  )

virtual

Reimplemented in AnimatedTexture.

Definition at line 665 of file aux_texture.cpp.

References ActivateWhite(), CLAMP, CUBEMAP, DEFAULT_ADDRESS_MODE, GFXActiveTexture(), GFXSelectTexture(), GFXTextureAddressMode(), TEXTURE1D, TEXTURE2D, TEXTURE3D, TEXTURERECT, and WRAP.

{
    static bool missing = false;
    if ( (name == -1) || (pass != 0) ) {
        ActivateWhite( stag );
    } else {
        // Lazy-init default address mode
        // So that texture_target is properly initiated 
        // by the time we do
        if (address_mode == DEFAULT_ADDRESS_MODE) {
            switch (texture_target)
            {
            case TEXTURE1D:
            case TEXTURE2D:
        #ifdef GL_EXT_texture3D
            case TEXTURE3D:
        #endif
            default:
                address_mode = WRAP;
                break;
            case TEXTURERECT:
            case CUBEMAP:
                address_mode = CLAMP;
                break;
            }
        }
    
        GFXActiveTexture( stag );
        GFXSelectTexture( name, stag );
        GFXTextureAddressMode( address_mode, texture_target );         //In case it changed - it's possible
    }
}

void Texture::modold	(	const std::string &	s,
		bool	shared,
		std::string &	hashname
	)

Definition at line 100 of file aux_texture.cpp.

References data, VSFileSystem::GetHashName(), VSFileSystem::GetSharedTextureHashName(), name, original, refcount, texHashTable, and BaseUtil::Texture().

{
    hashname = shared ? VSFileSystem::GetSharedTextureHashName( s ) : VSFileSystem::GetHashName( s );
    Texture *oldtex = new Texture;
    //oldtex->InitTexture();new calls this
    oldtex->name     = -1;
    oldtex->refcount = 1;
    oldtex->original = NULL;
    oldtex->palette  = NULL;
    oldtex->data     = NULL;
    texHashTable.Put( hashname, oldtex );
    original         = oldtex;
}

virtual unsigned int Texture::numFrames ( ) const

inlinevirtual

Reimplemented in AnimatedTexture.

Definition at line 191 of file aux_texture.h.

    {
        return 1;
    }                                               //Number of frames in an animated texture (or, rather, keyframes)

virtual unsigned int Texture::numLayers ( ) const

inlinevirtual

Reimplemented in AnimatedTexture.

Definition at line 208 of file aux_texture.h.

Referenced by Background::Draw(), and VSSprite::Draw().

    {
        return 1;
    }                                               //Number of layers in the texture. If more than 1, makeActive() sets up multitexturing units, and other use of multitexture units, other than [stage..stage+numLayers), should be avoided. If not enough multitexturing units are available, special fall-back mechanisms should be implmemented by MakeActive() so that it still renders as correctly as possible. In that case, canMultiPass(), numPasses() and MakeActive(stage,pass) could be used to process in multipass mode (one stage at a time, or a stage group at a time, depending on fallback implementation), if possible.

virtual unsigned int Texture::numPasses ( ) const

inlinevirtual

Reimplemented in AnimatedTexture.

Definition at line 213 of file aux_texture.h.

Referenced by Background::Draw(), and VSSprite::Draw().

    {
        return 1;
    }                                               //Number of passes when on multipass rendering.

bool Texture::operator<

(

const Texture &

b)

const

A way to sort the texture by the original address (to make sure like textures stick togehter.

Definition at line 59 of file aux_texture.cpp.

References Original().

{
    return Original() < b.Original();
}

bool Texture::operator==

(

const Texture &

b)

const

A way to test if the texture is equal to another based on original values.

Definition at line 64 of file aux_texture.cpp.

References Original().

{
    return Original() == b.Original();
}

const Texture * Texture::Original ( ) const

virtual

Reimplemented in AnimatedTexture.

Definition at line 136 of file aux_texture.cpp.

References Original().

Referenced by operator<(), operator==(), PipelinedTexture::Original(), AnimatedTexture::Original(), and Original().

{
    if (original)
        return original->Original();
    else
        return this;
}

Texture * Texture::Original ( )

virtual

Reimplemented in AnimatedTexture, and PipelinedTexture.

Definition at line 144 of file aux_texture.cpp.

References Original().

{
    if (original)
        return original->Original();
    else
        return this;
}

void Texture::Prioritize ( float  priority)

virtual

Changes priority of texture.

Definition at line 653 of file aux_texture.cpp.

References GFXPrioritizeTexture().

{
    GFXPrioritizeTexture( name, priority );
}

void Texture::setbad

(

const string &

s)

Definition at line 199 of file aux_texture.cpp.

References b, badtexHashTable, bool, VSFileSystem::current_path, VSFileSystem::GetHashName(), and VSFileSystem::GetSharedTextureHashName().

{
    //Put both current path+texfile and shared texfile since they both have been looked for
    bool *b = new bool(true);
    if (VSFileSystem::current_path.back() != "")
        badtexHashTable.Put( VSFileSystem::GetHashName( s ), b );
    badtexHashTable.Put( VSFileSystem::GetSharedTextureHashName( s ), b );
}

void Texture::setold

(

)

Loads the old texture.

Definition at line 127 of file aux_texture.cpp.

{
    //*original = *this;//will be obsoleted in new C++ standard unpredictable results when using string() (and its strangeass copy constructor)
    *original = *this;
    //memcpy (original, this, sizeof (Texture));
    original->original = NULL;
    original->refcount++;
}

void Texture::setReference

(

Texture *

other)

Make this instance a reference of "other".

Definition at line 69 of file aux_texture.cpp.

References bound, boundMode, boundSizeX, boundSizeY, data, image_target, name, refcount, texfilename, and texture_target.

{
    original = other;
    original->refcount++;

    //Copy shared attributes
    texfilename    = other->texfilename;
    data           = other->data;
    name           = other->name;
    bound          = other->bound;
    boundSizeX     = other->boundSizeX;
    boundSizeY     = other->boundSizeY;
    boundMode      = other->boundMode;
    texture_target = other->texture_target;
    image_target   = other->image_target;
}

virtual void Texture::setTime ( double  tim)

inlinevirtual

Reimplemented in AnimatedTexture.

Definition at line 201 of file aux_texture.h.

Referenced by VSSprite::SetTime().

{}

virtual bool Texture::SetupPass ( int  pass, const enum BLENDFUNC  src, const enum BLENDFUNC  dst  )

inlinevirtual

Reimplemented in AnimatedTexture.

Definition at line 276 of file aux_texture.h.

References stage.

Referenced by Background::Draw(), and VSSprite::Draw().

    {
        return SetupPass( pass, stage, src, dst );
    }                                                                                                                            //If one is going to perform multipass rendering of this texture, the Texture() must handle blending - SetupPass() sets up blending. If it returns false, then blending is not compatible with the requested blend mode emulation. One may assume that if numPasses()==1, no SetupPass() is needed. pass==-1 means restore setup. You should call it after multipass rendering.

virtual bool Texture::SetupPass ( int  pass, int  stage, const enum BLENDFUNC  src, const enum BLENDFUNC  dst  )

inlinevirtual

Reimplemented in AnimatedTexture.

Definition at line 281 of file aux_texture.h.

    {
        return true;
    }                                                                                                              //If one is going to perform multipass rendering of this texture, the Texture() must handle blending - SetupPass() sets up blending. If it returns false, then blending is not compatible with the requested blend mode emulation. One may assume that if numPasses()==1, no SetupPass() is needed. pass==-1 means restore setup. You should call it after multipass rendering.

void Texture::Transfer ( int  maxdimension, GFXBOOL  detailtexture  )

protected

Transfers this texture to GFX library.

Definition at line 552 of file aux_texture.cpp.

References CUBEMAP_NEGATIVE_X, CUBEMAP_NEGATIVE_Y, CUBEMAP_NEGATIVE_Z, CUBEMAP_POSITIVE_X, CUBEMAP_POSITIVE_Y, CUBEMAP_POSITIVE_Z, DXT1, DXT1RGBA, DXT3, DXT5, GFXTransferTexture(), PALETTE8, RGB24, and RGBA32.

Referenced by AnimatedTexture::MakeActive().

{
    //Implement this in D3D
    //if(mode == _8BIT)
    //glColorTable(GL_SHARED_TEXTURE_PALETTE_EXT, GL_RGB8, 256, GL_RGB, GL_UNSIGNED_BYTE, palette);

    TEXTUREFORMAT internformat;
    switch (mode)
    {
    //send DXT1,DXT3,DXT5 ...need to have the function call other glcompressedTexImage2D function
    case _DXT1:
        internformat = DXT1;
        break;
    case _DXT1RGBA:
        internformat = DXT1RGBA;
        break;
    case _DXT3:
        internformat = DXT3;
        break;
    case _DXT5:
        internformat = DXT5;
        break;
    case _24BITRGBA:
        internformat = RGBA32;
        break;
    case _24BIT:
        internformat = RGB24;
        break;
    case _8BIT:
        internformat = PALETTE8;
        break;
    default:
        return;
    }
    if (img_sides == SIDE_SINGLE) {
        GFXTransferTexture( data, name, sizeX, sizeY, internformat, image_target, maxdimension, detailtexture );
    } else {
        GFXTransferTexture( data, name, sizeX, sizeY, internformat, CUBEMAP_POSITIVE_X, maxdimension, detailtexture, 0 );
        GFXTransferTexture( data, name, sizeX, sizeY, internformat, CUBEMAP_NEGATIVE_X, maxdimension, detailtexture, 1 );
        GFXTransferTexture( data, name, sizeX, sizeY, internformat, CUBEMAP_POSITIVE_Y, maxdimension, detailtexture, 2 );
        GFXTransferTexture( data, name, sizeX, sizeY, internformat, CUBEMAP_NEGATIVE_Y, maxdimension, detailtexture, 3 );
        GFXTransferTexture( data, name, sizeX, sizeY, internformat, CUBEMAP_POSITIVE_Z, maxdimension, detailtexture, 4 );
        GFXTransferTexture( data, name, sizeX, sizeY, internformat, CUBEMAP_NEGATIVE_Z, maxdimension, detailtexture, 5 );
    }
}

void Texture::UnBind ( )

protected

UnBinds from GFX library.

Definition at line 542 of file aux_texture.cpp.

References GFXDeleteTexture(), and texHashTable.

{
    if (name != -1) {
        texHashTable.Delete( texfilename );
        GFXDeleteTexture( name );
        name = -1;
    }
    //glDeleteTextures(1, &name);
}

Member Data Documentation

enum ADDRESSMODE Texture::address_mode

The address mode being used with this texture.

Definition at line 78 of file aux_texture.h.

bool Texture::bound

For re-biding.

Definition at line 66 of file aux_texture.h.

Referenced by Bind(), AnimatedTexture::Clone(), and setReference().

VSImageMode Texture::boundMode

Definition at line 68 of file aux_texture.h.

Referenced by Bind(), and setReference().

uint Texture::boundSizeX

Definition at line 67 of file aux_texture.h.

Referenced by Bind(), Background::Draw(), and setReference().

uint Texture::boundSizeY

Definition at line 67 of file aux_texture.h.

Referenced by Bind(), Background::Draw(), and setReference().

unsigned char* Texture::data

The data of this texture (used in between functions, deleted)

Definition at line 51 of file aux_texture.h.

Referenced by PipelinedTexture::beginMutate(), PipelinedTexture::Clone(), PipelinedTexture::endMutate(), AnimatedTexture::LoadVideoSource(), modold(), PipelinedTexture::PipelinedTexture(), setReference(), and AnimatedTexture::~AnimatedTexture().

enum TEXTURE_IMAGE_TARGET Texture::image_target

Definition at line 75 of file aux_texture.h.

Referenced by getImageTarget(), AnimatedTexture::LoadVideoSource(), PipelinedTexture::PipelinedTexture(), setReference(), and StreamTexture::StreamTexture().

enum FILTER Texture::ismipmapped

the filter mode of this texture

Definition at line 48 of file aux_texture.h.

Referenced by getFilter(), PipelinedTexture::PipelinedTexture(), and StreamTexture::StreamTexture().

Vector Texture::maxtcoord

Definition at line 60 of file aux_texture.h.

Referenced by Background::Draw(), VSSprite::Draw(), Animation::DrawAsVSSprite(), Animation::DrawNoTransform(), Animation::DrawNow(), AnimatedTexture::LoadAni(), AnimatedTexture::LoadVideoSource(), and AnimatedTexture::MakeActive().

Vector Texture::mintcoord

The minimum/maximum texturing coordinates for this texture (have in mind that it is not always enforce, ie. for meshes) (i=s, j=t, k=u)

Definition at line 60 of file aux_texture.h.

Referenced by Background::Draw(), VSSprite::Draw(), Animation::DrawAsVSSprite(), Animation::DrawNoTransform(), Animation::DrawNow(), AnimatedTexture::LoadAni(), AnimatedTexture::LoadVideoSource(), and AnimatedTexture::MakeActive().

int Texture::name

The GFXname of this texture.

Definition at line 54 of file aux_texture.h.

Referenced by Bind(), PipelinedTexture::Clone(), AnimatedTexture::Clone(), Clone(), PipelinedTexture::endMutate(), LoadSuccess(), StreamTexture::MakeActive(), modold(), PipelinedTexture::PipelinedTexture(), Logo::SetDecal(), setReference(), StreamTexture::StreamTexture(), PipelinedTexture::Swap(), StreamTexture::UnMap(), Logo::~Logo(), PipelinedTexture::~PipelinedTexture(), and StreamTexture::~StreamTexture().

Texture* Texture::original

The original data that would represent this texture.

Definition at line 63 of file aux_texture.h.

Referenced by Clone(), AnimatedTexture::LoadAni(), AnimatedTexture::LoadFrame(), modold(), PipelinedTexture::Original(), PipelinedTexture::PipelinedTexture(), and StreamTexture::StreamTexture().

int Texture::refcount

The number of references on the original data.

Definition at line 71 of file aux_texture.h.

Referenced by Clone(), modold(), PipelinedTexture::PipelinedTexture(), setReference(), and StreamTexture::StreamTexture().

int Texture::stage

The multitexture stage of this texture.

Definition at line 57 of file aux_texture.h.

Referenced by PipelinedTexture::Clone(), getStage(), AnimatedTexture::LoadAni(), PipelinedTexture::MakeActive(), MakeActive(), PipelinedTexture::MakeBothActive(), PipelinedTexture::PipelinedTexture(), SetupPass(), StreamTexture::StreamTexture(), and PipelinedTexture::Swap().

StringPool::Reference Texture::texfilename

The file name used to load this texture.

Definition at line 45 of file aux_texture.h.

Referenced by buildShipDescription(), and setReference().

enum TEXTURE_TARGET Texture::texture_target

The target this will go to (cubemap or otherwise)

Definition at line 74 of file aux_texture.h.

Referenced by VSSprite::Draw(), getTarget(), AnimatedTexture::LoadVideoSource(), PipelinedTexture::PipelinedTexture(), setReference(), and StreamTexture::StreamTexture().

---

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

• src/gfx/aux_texture.h
• src/gfx/aux_texture.cpp