CharacterProxy.h

Go to the documentation of this file.

// CharacterProxy.h - rebindable DisplayObject reference, for Gnash
//
//   Copyright (C) 2005, 2006, 2007, 2008, 2009, 2010, 2011, 2012
//   Free Software Foundation, Inc
// 
// 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 3 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., 51 Franklin St, Fifth Floor, Boston, MA  02110-1301  USA

#ifndef GNASH_CHARACTER_PROXY_H
#define GNASH_CHARACTER_PROXY_H

#include <string>
#include "dsodefs.h"

// Forward declarations
namespace gnash {
        class DisplayObject;
    class movie_root;
}

namespace gnash {

DisplayObject* findDisplayObjectByTarget(const std::string& target,
            movie_root& mr);

//
class CharacterProxy
{
public:

        CharacterProxy(DisplayObject* sp, movie_root& mr)
                :
                _ptr(sp),
        _mr(&mr)
        {
                checkDangling();
        }

        //
        CharacterProxy(const CharacterProxy& sp)
        :
        _mr(sp._mr)
        {
                sp.checkDangling();
                _ptr = sp._ptr;
                if (!_ptr) _tgt = sp._tgt;
        }

        //
        CharacterProxy& operator=(const CharacterProxy& sp)
        {
                sp.checkDangling();
                _ptr = sp._ptr;
                if (!_ptr) _tgt = sp._tgt;
        _mr = sp._mr;
                return *this;
        }

        //
        DisplayObject* get(bool skipRebinding = false) const
        {
                if (skipRebinding) return _ptr;

        // set _ptr to NULL and _tgt to original target if destroyed
                checkDangling(); 
                if (_ptr) return _ptr;
                return findDisplayObjectByTarget(_tgt, *_mr);
        }

        std::string getTarget() const;

        //
        bool isDangling() const
        {
                checkDangling();
                return !_ptr;
        }

        bool operator==(const CharacterProxy& sp) const
        {
                return get() == sp.get();
        }

        //
        void setReachable() const;

private:

        DSOEXPORT void checkDangling() const;

        mutable DisplayObject* _ptr;

        mutable std::string _tgt;

    movie_root* _mr;

};

} // end namespace gnash

#endif // GNASH_CHARACTER_PROXY_H