src/render/rDisplayList.cpp

Go to the documentation of this file.

/*

*************************************************************************

ArmageTron -- Just another Tron Lightcycle Game in 3D.
Copyright (C) 2008  Manuel Moos (manuel@moosnet.de) and the AA Development Team

**************************************************************************

This program 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
of the License, or (at your option) any later version.

This program 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 this program; if not, write to the Free Software
Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA  02111-1307, USA.
  
***************************************************************************

*/

#include "rDisplayList.h"

#include "rScreen.h"

#ifdef DEBUG
#define LIST_STATS
#endif

#ifdef LIST_STATS
class rListCounter
{
public:
    enum Type
    {
        Use,    // display list used
        Create, // created
        Not,    // not used
        COUNT
    };

    rListCounter(){ count_[Use] = count_[Create] = count_[Not] = 0; }
    void Count( Type type )
    {
        count_[type]++;
    }
    ~rListCounter()
    {
        std::cout << "Display Lists Created: " << count_[Create] << ", used: " << count_[Use]
                  << " and passed: " << count_[Not] << ".\n";
    }
private:
    unsigned int count_[COUNT];
};

static rListCounter sr_counter;
#endif

#ifndef DEDICATED
static rDisplayList * se_displayListAnchor = NULL;
#endif

rDisplayList::rDisplayList()
#ifndef DEDICATED
    : tListItem< rDisplayList >( se_displayListAnchor )
    , list_( 0 )
    , inhibit_( 0 )
    , filling_( false )
#endif
{
}

rDisplayList::~rDisplayList()
{
#ifndef DEDICATED
    tASSERT( !filling_ );

    Clear();

    tASSERT( !list_ );
#endif
}

static rDisplayListFiller * sr_currentFiller = NULL;

bool rDisplayList::IsRecording()
{
    return sr_currentFiller;
}

// calls the display list, returns true if there was a list to call
bool rDisplayList::OnCall()
{
#ifndef DEDICATED
    tASSERT( !filling_ );

    // no playback while another list is recorded; this
    // gives us a chance to agglomerate primitives.
    if ( IsRecording() )
    {
        return false;
    }

    if ( inhibit_ > 0 && list_ )
    {
        Clear();
        --inhibit_;
        return false;
    }

    if ( list_ )
    {
#ifdef LIST_STATS
        sr_counter.Count( rListCounter::Use );
#endif
        glCallList( list_ );
        return true;
    }
#endif

    return false;
}

void rDisplayList::Clear( int inhibitGeneration )
{
#ifndef DEDICATED

    // clear the list
    if ( !filling_ && list_ )
    {
        glDeleteLists( list_, 1 );
        list_ = 0;
    }
    else
    {
        // clear it later
        if ( list_ && inhibitGeneration < 1 )
        {
            inhibitGeneration = 1;
        }
    }

    // memorize inhibit counter
    if ( inhibit_ < inhibitGeneration )
    {
        inhibit_ = inhibitGeneration;
    }
#endif
}

// clears all display lists
void rDisplayList::ClearAll()
{
#ifndef DEDICATED
    tASSERT(!IsRecording());

    rDisplayList *run = se_displayListAnchor;
    while (run)
    {
        run->Clear();
        run = run->Next();
    }
#endif
}

// cancels recording of current display list
void rDisplayList::Cancel()
{
#ifndef DEDICATED
    if ( sr_currentFiller )
    {
        sr_currentFiller->list_.Clear(0);
        sr_currentFiller->Stop();
    }
#endif
}

rDisplayListAlphaSensitive::rDisplayListAlphaSensitive()
: lastAlpha_( sr_alphaBlend )
{}

bool rDisplayListAlphaSensitive::OnCall()
{
    // check whether crucial settings changed
    if ( sr_alphaBlend != lastAlpha_ )
    {
        lastAlpha_ = sr_alphaBlend;
        return false;
    }

    return rDisplayList::OnCall();
}

rDisplayListFiller::rDisplayListFiller( rDisplayList & list )
#ifndef DEDICATED
    : list_( list )
#endif
{
    Start();
}

// starts filling the display list
void rDisplayListFiller::Start()
{
#ifndef DEDICATED
    bool useList = sr_useDisplayLists != rDisplayList_Off && list_.inhibit_ == 0 && !sr_currentFiller;
    if ( useList )
    {
#ifdef LIST_STATS
        sr_counter.Count( rListCounter::Create );
#endif
        if ( !list_.list_ )
        {
            list_.list_=glGenLists(1);
            tASSERT( list_.list_ );
        }
        glNewList(list_.list_, sr_useDisplayLists == rDisplayList_CAC ? GL_COMPILE : GL_COMPILE_AND_EXECUTE );
        list_.filling_ = true;
        sr_currentFiller = this;
    }
    else if ( list_.inhibit_ > 0 )
    {
        --list_.inhibit_;
    }

#ifdef LIST_STATS
    if ( !useList && !sr_currentFiller )
    {
        sr_counter.Count( rListCounter::Not );
    }
#endif
#endif
}

rDisplayListFiller::~rDisplayListFiller()
{
    Stop();
}

void rDisplayListFiller::Stop()
{
#ifndef DEDICATED
    if ( list_.filling_ )
    {
        tASSERT( list_.list_ );
        tASSERT( sr_currentFiller == this );

        sr_currentFiller = 0;
        list_.filling_ = false;
        glEndList();

        if ( sr_useDisplayLists == rDisplayList_CAC )
        {
            // call the list, making sure it really gets executed
            int inhibit = list_.inhibit_;
            list_.inhibit_ = 0;
            list_.Call();
            list_.inhibit_ = inhibit;
        }
    }

    // to debug, clearing every display list may be useful:
    // list_.Clear(0);
#endif
}

static rCallbackBeforeScreenModeChange sr_unload( &rDisplayList::ClearAll );

---