osg::TextureManager Class Reference

#include <OSGTextureManager.h>

List of all members.

Public Types
enum	TextureMode { TM_3D = 0, TM_2D, TM_2D_Multi, NUM_TEXTURE_MODES }
	Texture mode. More...
enum	BrickingMode { BRICK_SUBDIVIDE_ON_TEXTURE_MEMORY = 0, BRICK_SUBDIVIDE_STATIC, BRICK_SUBDIVIDE_ON_BRICK_SIZE, NUM_BRICKING_MODES }
	Bricking mode. More...
Public Member Functions
	TextureManager (DVRVolume *volume)
	Constructor/ destructor.
	~TextureManager (void)
Int32	registerTexture (ImagePtr image, UInt32 internalFormat, UInt32 externalFormat, bool doBricking=1, Int32 textureStage0=0, Int32 textureStage1=-1)
	Register texture.
void	unregisterTexture (Int32 id)
	Remove texture.
void	reloadTexture (Int32 id, DrawActionBase *action)
	Reload texture.
void	clearTextures (ChunkMaterialPtr material=NullFC)
	Clear all registered textures.
void	buildTextures (ChunkMaterialPtr material, DVRVolume *volume, TextureMode mode=TM_3D)
	Create texture chunks for registered textures.
Brick *	sortBricks (DrawActionBase *da, Matrix modelMat, Vec3f eyePoint, DVRVolume *volume, TextureMode mode)
	Return sorted brick list.
void	dump (UInt32 uiIndent=0, const BitVector bvFlags=0) const
	Output the instance for debug purposes.
Static Private Member Functions
static Vec3f	calcBrickSubdivision (Int32 resX, Int32 resY, Int32 resZ, Int32 dataSize, DVRVolume *volume)
	Calculate bricking.
Private Attributes
TextureSet	_registeredTextures
DVRVolume *	_parent
BrickSet *	_brickSets
Friends
struct	BrickSet

---

Detailed Description

Definition at line 61 of file OSGTextureManager.h.

---

Member Enumeration Documentation

enum osg::TextureManager::TextureMode

Enumerator:

TM_3D
TM_2D
TM_2D_Multi
NUM_TEXTURE_MODES

Definition at line 66 of file OSGTextureManager.h.

    {
        TM_3D = 0,
        TM_2D,
        TM_2D_Multi,
        NUM_TEXTURE_MODES
    };

enum osg::TextureManager::BrickingMode

Enumerator:

BRICK_SUBDIVIDE_ON_TEXTURE_MEMORY
BRICK_SUBDIVIDE_STATIC
BRICK_SUBDIVIDE_ON_BRICK_SIZE
NUM_BRICKING_MODES

Definition at line 75 of file OSGTextureManager.h.

    {
        BRICK_SUBDIVIDE_ON_TEXTURE_MEMORY = 0,
        BRICK_SUBDIVIDE_STATIC,
        BRICK_SUBDIVIDE_ON_BRICK_SIZE,
        NUM_BRICKING_MODES
    };

---

Constructor & Destructor Documentation

osg::TextureManager::TextureManager

(

DVRVolume *

volume

)

! --- CLASS TextureManager ------------------------------------------------

Definition at line 54 of file OSGTextureManager.cpp.

References _brickSets, and _parent.

                                                :
    _registeredTextures(    ),
    _parent            (NULL),
    _brickSets         (NULL)
{
    _parent   = volume;
    _brickSets = new BrickSet[3];
}

osg::TextureManager::~TextureManager

(

void

)

Definition at line 63 of file OSGTextureManager.cpp.

References _brickSets, and clearTextures().

{
    clearTextures();

    delete [] _brickSets;
}

---

Member Function Documentation

Int32 osg::TextureManager::registerTexture	(	ImagePtr	image,
		UInt32	internalFormat,
		UInt32	externalFormat,
		bool	doBricking = 1,
		Int32	textureStage0 = 0,
		Int32	textureStage1 = -1
	)

register an image for use as texture with direct volume rendering image points to the image internal/externalFormat defines the texture format doBricking specifies, whether the texture is uses as utility texture or as volume texture (volume textures are divided into bricks - utility textures are loaded as they are) textureState0 textureState1 (optional) specifies which (multi-)texture stages the texture shall be bound

! TODO: ! make shure the user specifies two texture stages for mt-slab mode ! (e.g. accept only textures with two stages set once two stages have ! been specified).

Definition at line 71 of file OSGTextureManager.cpp.

References _registeredTextures, FDEBUG, and SWARNING.

Referenced by osg::DVRSimpleShader::initialize(), osg::DVRSimpleLUTShader::initialize(), osg::DVRMtexLUTShader::initialize(), and osg::DVRIsoShader::initialize().

{ 
    FDEBUG(("TextureManager::registerTexture stage0: %d - stage1: %d\n",
            textureStage0, textureStage1));
    
    
    // check for unique texture stages
    bool unique = true;

    for(UInt32 i = 0; i < _registeredTextures.size(); i++)
    {
        if(textureStage0 == _registeredTextures[i]->_textureStage0 ||
           textureStage0 == _registeredTextures[i]->_textureStage1  )
        {
            unique = false;
        }

        if((textureStage1 != -1                                    ) &&
           (textureStage1 == _registeredTextures[i]->_textureStage0 ||
            textureStage1 == _registeredTextures[i]->_textureStage1  )  )
        {
            unique = false;
        }
    }

    if(unique == false)
    {
        SWARNING << "TextureManager::registerTexture - "
                 << "ID already in use -> ignoring texture" 
                 << std::endl;
        return -1;
    }

    // store record
    TextureRecord * record = new TextureRecord(image,
                                               internalFormat,
                                               externalFormat,
                                               textureStage0,
                                               textureStage1);
    _registeredTextures.push_back(record);
    
    return _registeredTextures.size() - 1; 
}

void osg::TextureManager::unregisterTexture

(

Int32

id

)

Definition at line 126 of file OSGTextureManager.cpp.

References _registeredTextures, FDEBUG, and SWARNING.

Referenced by osg::DVRSimpleShader::cleanup(), osg::DVRSimpleLUTShader::cleanup(), osg::DVRMtexLUTShader::cleanup(), and osg::DVRIsoShader::cleanup().

{
    FDEBUG(("TextureManager::unregisterTexture\n"));

    if((id < 0) || (UInt32(id) > _registeredTextures.size()))
    {
        SWARNING << "TextureManager::unregisterTexture - invalid id " 
                 << id 
                 << std::endl;
        return;
    }

    TextureSet::iterator iter = _registeredTextures.begin();

    delete _registeredTextures[id];

    _registeredTextures.erase(iter + id);
}

void osg::TextureManager::reloadTexture	(	Int32	id,
		DrawActionBase *	action
	)

Definition at line 147 of file OSGTextureManager.cpp.

References _brickSets, _registeredTextures, osg::BrickSet::reloadBrickTextures(), and SWARNING.

Referenced by osg::DVRSimpleLUTShader::activate(), and osg::DVRSimpleLUTShader::initialize().

{
    if((id < 0) || (UInt32(id) > _registeredTextures.size()))
    {
        SWARNING << "TextureManager::reloadTexture - invalid id " 
                 << id 
                 << std::endl;
        return;
    }
    
    for(UInt32 k = 0; k < 3; k++)
    {
        _brickSets[k].reloadBrickTextures(
            action, 
            _registeredTextures[id]->_textureStage0);

        _brickSets[k].reloadBrickTextures(
            action, 
            _registeredTextures[id]->_textureStage1);
    }
}

void osg::TextureManager::clearTextures

(

ChunkMaterialPtr

material = NullFC

)

! TODO: destroy created texture chunks - even if material is not known

Definition at line 171 of file OSGTextureManager.cpp.

References _brickSets, _registeredTextures, osg::BrickSet::clearBrickTextures(), FDEBUG, osg::BrickSet::m_nNumBricks, osg::BrickSet::m_pBricks, and osg::NullFC.

Referenced by osg::DVRVolume::draw(), osg::DVRVolume::reload(), and ~TextureManager().

{
    FDEBUG(("TextureManager::clearTexture\n"));


    if (material != NullFC) 
    {
        for(UInt32 k = 0; k < 3; k++) 
        {
            _brickSets[k].clearBrickTextures(material);

            delete [] _brickSets[k].m_pBricks;
            
            _brickSets[k].m_pBricks    = 0;
            _brickSets[k].m_nNumBricks = 0;
        }
    }
    
    for(UInt32 i = 0; i < _registeredTextures.size(); i++)
    {
        delete _registeredTextures[i];
    } 

    _registeredTextures.clear();
}

void osg::TextureManager::buildTextures	(	ChunkMaterialPtr	material,
		DVRVolume *	volume,
		TextureMode	mode = TM_3D
	)

Definition at line 200 of file OSGTextureManager.cpp.

References _brickSets, _registeredTextures, osg::BrickSet::buildBricks2D(), osg::BrickSet::buildBricks3D(), osg::BrickSet::buildBrickTextures(), calcBrickSubdivision(), DVRVOLUME_PARAMETER, FDEBUG, osg::DVRVolumeBase::getBrickOverlap(), osg::NullFC, SWARNING, TM_2D, TM_2D_Multi, TM_3D, osg::BrickSet::XY, osg::BrickSet::XZ, and osg::BrickSet::YZ.

Referenced by osg::DVRVolume::draw().

{
    FDEBUG(("TextureManager::buildTextures\n"));

    DVRVolumeTexturePtr vT = DVRVOLUME_PARAMETER(volume, DVRVolumeTexture);

    if(vT == NullFC) 
    {
        SWARNING << "TextureManager::buildTextures - No Volume" << std::endl;
        return;
    }

    if(_registeredTextures.size() < 1) 
    {
        SWARNING << "TextureManager::buildTextures - No registerd textures" 
                 << std::endl;
        return;
    }
    
    switch(textureMode)
    {
        case TM_2D_Multi:
        {
            // Multi-Texture Slabs
            Vec3f res = vT->getResolution();

            Vec3f brickSizeX(2,      res[1], res[2]);
            Vec3f brickSizeY(res[0], 2,      res[2]);
            Vec3f brickSizeZ(res[0], res[1], 2     );
            
            _brickSets[BrickSet::XY].buildBricks3D(volume, 
                                                   brickSizeZ, 
                                                   1, 
                                                   BrickSet::XY);
            _brickSets[BrickSet::XZ].buildBricks3D(volume, 
                                                   brickSizeY, 
                                                   1, 
                                                   BrickSet::XZ);
            _brickSets[BrickSet::YZ].buildBricks3D(volume, 
                                                   brickSizeX, 
                                                   1, 
                                                   BrickSet::YZ);
            
            _brickSets[BrickSet::XY].buildBrickTextures( material, 
                                                        _registeredTextures, 
                                                         textureMode); 
            _brickSets[BrickSet::XZ].buildBrickTextures( material, 
                                                        _registeredTextures, 
                                                         textureMode); 
            _brickSets[BrickSet::YZ].buildBrickTextures( material, 
                                                        _registeredTextures, 
                                                         textureMode); 
            
            break;
        }
        case TM_2D:
        {
            // Ordinary 2D-Slices
            _brickSets[BrickSet::XY].buildBricks2D(volume, BrickSet::XY);
            _brickSets[BrickSet::XZ].buildBricks2D(volume, BrickSet::XZ);
            _brickSets[BrickSet::YZ].buildBricks2D(volume, BrickSet::YZ);
            
            _brickSets[BrickSet::XY].buildBrickTextures( material, 
                                                        _registeredTextures, 
                                                         textureMode); 
            _brickSets[BrickSet::XZ].buildBrickTextures( material, 
                                                        _registeredTextures, 
                                                         textureMode); 
            _brickSets[BrickSet::YZ].buildBrickTextures( material, 
                                                        _registeredTextures, 
                                                         textureMode); 
            
            break;
        }

        default:
        case TM_3D:
        {
            // Ordinary 3D-Bricks
            Vec3f res              = vT->getResolution();
            Vec3f brickSubdivision = 
                calcBrickSubdivision(int(res[0]), 
                                     int(res[1]), 
                                     int(res[2]),
                                     vT->getImage()->getBpp(), volume);

            Vec3f brickSize(Real32((int)(res[0] / brickSubdivision[0])),
                            Real32((int)(res[1] / brickSubdivision[1])),
                            Real32((int)(res[2] / brickSubdivision[2])));
            

            FDEBUG(
                ("TextureManager::buildTextures - BrickSubdivision %d %d %d\n",
                 brickSubdivision[0], 
                 brickSubdivision[1], 
                 brickSubdivision[2]));
            
            _brickSets[BrickSet::XY].buildBricks3D(volume, 
                                                   brickSize, 
                                                   volume->getBrickOverlap());
            
            _brickSets[BrickSet::XY].buildBrickTextures( material, 
                                                        _registeredTextures, 
                                                         textureMode);
            
            break;
        }
    }
}

Brick * osg::TextureManager::sortBricks	(	DrawActionBase *	da,
		Matrix	modelMat,
		Vec3f	eyePoint,
		DVRVolume *	volume,
		TextureMode	mode
	)

Definition at line 415 of file OSGTextureManager.cpp.

References _brickSets, FDEBUG, osg::Slicer::getSlicingDirection(), osg::Slicer::SD_X_BACK_TO_FRONT, osg::Slicer::SD_X_FRONT_TO_BACK, osg::Slicer::SD_Y_BACK_TO_FRONT, osg::Slicer::SD_Y_FRONT_TO_BACK, osg::Slicer::SD_Z_BACK_TO_FRONT, osg::Slicer::SD_Z_FRONT_TO_BACK, osg::BrickSet::sortBricks2D(), osg::BrickSet::sortBricks3D(), TM_2D, TM_2D_Multi, osg::BrickSet::XY, osg::BrickSet::XZ, and osg::BrickSet::YZ.

Referenced by osg::DVRVolume::draw().

{
    
    FDEBUG(("TextureManager::sortBricks\n"));

    if ((mode == TM_2D) || (mode == TM_2D_Multi)) 
    {
        // select the right bickset
        BrickSet::Orientation ori = BrickSet::XY;
        bool                  btf = true;

        switch(Slicer::getSlicingDirection(da,NULL))
        {
            case Slicer::SD_X_FRONT_TO_BACK:
                ori = BrickSet::YZ;
                btf = false;
                break;
            case Slicer::SD_X_BACK_TO_FRONT:
                ori = BrickSet::YZ;
                btf = true;
                break;
            case Slicer::SD_Y_FRONT_TO_BACK:
                ori = BrickSet::XZ;
                btf = false;
                break;
            case Slicer::SD_Y_BACK_TO_FRONT:
                ori = BrickSet::XZ;
                btf = true;
                break;
            case Slicer::SD_Z_FRONT_TO_BACK:
                ori = BrickSet::XY;
                btf = false;
                break;
            case Slicer::SD_Z_BACK_TO_FRONT:
                ori = BrickSet::XY;
                btf = true;
                break;
            default:
                break;
        }
        
    // btf or ftb? 
        return _brickSets[ori].sortBricks2D(btf);
    } 
    else 
    {
        return _brickSets[BrickSet::XY].sortBricks3D(modelMat, eyePoint);
    }
}

void osg::TextureManager::dump	(	UInt32	uiIndent = 0,
		const BitVector	bvFlags = 0
	)			const

Definition at line 314 of file OSGTextureManager.cpp.

References _registeredTextures, and SLOG.

{
    SLOG << "TextureManager:" << std::endl;

    for (UInt32 i = 0; i < _registeredTextures.size(); i++)
    {
        SLOG << "image:          " << _registeredTextures[i]->_image 
             << std::endl;
        SLOG << "internalFormat: " << _registeredTextures[i]->_internalFormat 
             << std::endl;
        SLOG << "textureStage0:  " << _registeredTextures[i]->_textureStage0 
             << std::endl;
        SLOG << "textureStage1:  " << _registeredTextures[i]->_textureStage1 
             << std::endl;
    } 
}

Vec3f osg::TextureManager::calcBrickSubdivision	(	Int32	resX,
		Int32	resY,
		Int32	resZ,
		Int32	dataSize,
		DVRVolume *	volume
	)			[static, private]

Definition at line 333 of file OSGTextureManager.cpp.

References BRICK_SUBDIVIDE_ON_BRICK_SIZE, BRICK_SUBDIVIDE_ON_TEXTURE_MEMORY, BRICK_SUBDIVIDE_STATIC, osg::DVRVolumeBase::getBrickingMode(), osg::DVRVolumeBase::getBrickMaxSize(), osg::DVRVolumeBase::getBrickStaticMemoryMB(), osg::DVRVolumeBase::getBrickStaticSubdivision(), and osg::osgceil().

Referenced by buildTextures().

{
    Int32 mode = volume->getBrickingMode();

    
    Vec3f subdivision(1,1,1);
    
    switch (mode) 
    {
        case BRICK_SUBDIVIDE_STATIC:
        {
            subdivision = volume->getBrickStaticSubdivision();
            break;
        }
        
        case BRICK_SUBDIVIDE_ON_TEXTURE_MEMORY:
        {
            Real32 fMB_available = 
                1024.0F * 1024.0F * (Real32) volume->getBrickStaticMemoryMB();

            Real32 fMB_required  = (Real32) (resX * resY * resZ * dataSize);

            Int32 nNumBricks     = (Int32) osgceil(fMB_required / 
                                                   fMB_available);
            Int32 nRealNumBricks = 1;

            while(nNumBricks > nRealNumBricks) 
            {
                if ((resX >= resY) && (resX >= resZ)) 
                {
                    resX /= 2;
                    subdivision[0] *= 2;
                } 
                else if (resY >= resZ) 
                {
                    resY /= 2;
                    subdivision[1] *= 2;
                    
                }
                else 
                {
                    resZ /= 2;
                    subdivision[2] *= 2;
                }
                
                nRealNumBricks = 
                    (Int32)(subdivision[0] * subdivision[1] * subdivision[2]);
            }
            break;
        }
        
        case BRICK_SUBDIVIDE_ON_BRICK_SIZE:
        {
            Vec3f maxSize = volume->getBrickMaxSize();
            
            while(resX > (Int32) maxSize[0]) 
            {
                resX /= 2;
                subdivision[0] *= 2;
            }
            while(resY > (Int32) maxSize[1]) 
            {
                resY /= 2;
                subdivision[1] *= 2;
            }
            while(resZ > (Int32) maxSize[2]) 
            {
                resZ /= 2;
                subdivision[2] *= 2;
            }
            break;
        }
        
    }
    return subdivision;
}

---

Friends And Related Function Documentation

friend struct BrickSet [friend]

Definition at line 150 of file OSGTextureManager.h.

---

Member Data Documentation

TextureSet osg::TextureManager::_registeredTextures [private]

Definition at line 138 of file OSGTextureManager.h.

Referenced by buildTextures(), clearTextures(), dump(), registerTexture(), reloadTexture(), and unregisterTexture().

DVRVolume* osg::TextureManager::_parent [private]

Definition at line 139 of file OSGTextureManager.h.

Referenced by TextureManager().

BrickSet* osg::TextureManager::_brickSets [private]

Definition at line 141 of file OSGTextureManager.h.

Referenced by buildTextures(), clearTextures(), reloadTexture(), sortBricks(), TextureManager(), and ~TextureManager().

---

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

• OSGTextureManager.h
• OSGTextureManager.cpp