GUIGlObject.h

Go to the documentation of this file.

/****************************************************************************/
// Base class for all objects that may be displayed within the openGL-gui
/****************************************************************************/
// SUMO, Simulation of Urban MObility; see http://sumo.sourceforge.net/
// Copyright (C) 2001-2011 DLR (http://www.dlr.de/) and contributors
/****************************************************************************/
//
//   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.
//
/****************************************************************************/
#ifndef GUIGlObject_h
#define GUIGlObject_h


// ===========================================================================
// included modules
// ===========================================================================
#ifdef _MSC_VER
#include <windows_config.h>
#else
#include <config.h>
#endif

#include <string>
#include <set>
#include "GUIGlObjectTypes.h"
#include <utils/geom/Boundary.h>
#include <utils/common/StdDefs.h>
#include <utils/common/StringBijection.h>
#include <utils/common/RGBColor.h>


// ===========================================================================
// definitions
// ===========================================================================
typedef unsigned int GUIGlID;


// ===========================================================================
// class declarations
// ===========================================================================
class GUIGlObjectStorage;
class GUIParameterTableWindow;
class GUIMainWindow;
class GUIGLObjectPopupMenu;
class GUISUMOAbstractView;
class GUIVisualizationSettings;
struct GUIVisualizationTextSettings;


// ===========================================================================
// class definitions
// ===========================================================================
class GUIGlObject {
public:
    GUIGlObject(GUIGlObjectType type, const std::string& microsimID);


    GUIGlObject(const std::string& prefix, GUIGlObjectType type, const std::string& microsimID);


    virtual ~GUIGlObject() throw();

    static StringBijection<GUIGlObjectType> TypeNames;


    const std::string& getFullName() const {
        return myFullName;
    }


    GUIGlID getGlID() const throw() {
        return myGlID;
    }




    virtual GUIGLObjectPopupMenu* getPopUpMenu(GUIMainWindow& app, GUISUMOAbstractView& parent) throw() = 0;


    virtual GUIParameterTableWindow* getParameterWindow(GUIMainWindow& app, GUISUMOAbstractView& parent) throw() = 0;


    const std::string& getMicrosimID() const {
        return myMicrosimID;
    };


    void setMicrosimID(const std::string& newID);


    GUIGlObjectType getType() const {
        return myGLObjectType;
    };


    virtual Boundary getCenteringBoundary() const throw() = 0;


    virtual void drawGL(const GUIVisualizationSettings& s) const throw() = 0;


    virtual void drawGLAdditional(GUISUMOAbstractView* const parent, const GUIVisualizationSettings& s) const throw() {
        UNUSED_PARAMETER(&s);
        UNUSED_PARAMETER(parent);
    };




    void addParameterTable(GUIParameterTableWindow* w) throw();


    void removeParameterTable(GUIParameterTableWindow* w) throw();


    void drawName(const Position& pos, const SUMOReal scale,
                  const GUIVisualizationTextSettings& settings, const SUMOReal angle=0) const;


protected:


    void buildPopupHeader(GUIGLObjectPopupMenu* ret, GUIMainWindow& app, bool addSeparator=true) throw();


    void buildCenterPopupEntry(GUIGLObjectPopupMenu* ret, bool addSeparator=true) throw();


    void buildNameCopyPopupEntry(GUIGLObjectPopupMenu* ret, bool addSeparator=true) throw();


    void buildSelectionPopupEntry(GUIGLObjectPopupMenu* ret, bool addSeparator=true) throw();


    void buildShowParamsPopupEntry(GUIGLObjectPopupMenu* ret, bool addSeparator=true) throw();


    void buildPositionCopyEntry(GUIGLObjectPopupMenu* ret, bool addSeparator=true) throw();


    void buildShowManipulatorPopupEntry(GUIGLObjectPopupMenu* ret, bool addSeparator=true) throw();

protected:
    /* usually names are prefixed by a type-specific string. this method can be
     * used to change the default */
    void setPrefix(const std::string& prefix);

private:
    GUIGlID myGlID;

    const GUIGlObjectType myGLObjectType;

    std::string myMicrosimID;

    std::string myPrefix;

    std::string myFullName;

    std::set<GUIParameterTableWindow*> myParamWindows;

    std::string createFullName() const;


    // static StringBijection<SumoXMLLinkStateValue> LinkStates;

    static StringBijection<GUIGlObjectType>::Entry GUIGlObjectTypeNamesInitializer[];

};
#endif

/****************************************************************************/