GNEAttributeProperties.h

Go to the documentation of this file.

/****************************************************************************/
// Eclipse SUMO, Simulation of Urban MObility; see https://eclipse.dev/sumo
// Copyright (C) 2001-2024 German Aerospace Center (DLR) and others.
// This program and the accompanying materials are made available under the
// terms of the Eclipse Public License 2.0 which is available at
// https://www.eclipse.org/legal/epl-2.0/
// This Source Code may also be made available under the following Secondary
// Licenses when the conditions for such availability set forth in the Eclipse
// Public License 2.0 are satisfied: GNU General Public License, version 2
// or later which is available at
// https://www.gnu.org/licenses/old-licenses/gpl-2.0-standalone.html
// SPDX-License-Identifier: EPL-2.0 OR GPL-2.0-or-later
/****************************************************************************/
// Abstract Base class for attribute properties used in GNEAttributeCarrier
/****************************************************************************/
#pragma once
#include <config.h>
 
 
// ===========================================================================
// included modules
// ===========================================================================
#include <config.h>
 
#include <utils/xml/SUMOSAXAttributes.h>
 
 
// ===========================================================================
// class declarations
// ===========================================================================
class GNETagProperties;
 
 
// ===========================================================================
// class definitions
// ===========================================================================
 
class GNEAttributeProperties {
 
public:
 
    enum AttrProperty {
        INT =               1 << 0,     // Attribute is an integer (Including Zero)
        FLOAT =             1 << 1,     // Attribute is a float
        SUMOTIME =          1 << 2,     // Attribute is a SUMOTime
        BOOL =              1 << 3,     // Attribute is boolean (0/1, true/false)
        STRING =            1 << 4,     // Attribute is a string
        POSITION =          1 << 5,     // Attribute is a position defined by doubles (x,y or x,y,z)
        COLOR =             1 << 6,     // Attribute is a color defined by a specifically word (Red, green) or by a special format (XXX,YYY,ZZZ)
        VTYPE =             1 << 7,     // Attribute corresponds to a Vtype or VTypeDistribution
        VCLASS =            1 << 8,     // Attribute is a VClass (passenger, bus, motorcicle...)
        POSITIVE =          1 << 9,     // Attribute is positive (Including Zero)
        UNIQUE =            1 << 10,    // Attribute is unique (cannot be edited in a selection of similar elements (ID, Position...)
        FILENAME =          1 << 11,    // Attribute is a filename (string that cannot contains certain characters)
        DISCRETE =          1 << 12,    // Attribute is discrete (only certain values are allowed)
        PROBABILITY =       1 << 13,    // Attribute is probability (only allowed values between 0 and 1, including both)
        ANGLE =             1 << 14,    // Attribute is an angle (only takes values between 0 and 360, including both, another value will be automatically reduced
        LIST =              1 << 15,    // Attribute is a list of other elements separated by spaces
        SECUENCIAL =        1 << 16,    // Attribute is a special sequence of elements (for example: secuencial lanes in Multi Lane E2 detectors)
        DEFAULTVALUE =      1 << 17,    // Attribute owns a static default value
        SYNONYM =           1 << 18,    // Attribute will be written with a different name in der XML
        RANGE =             1 << 19,    // Attribute only accept a range of elements (example: Probability [0,1])
        EXTENDED =          1 << 20,    // Attribute is extended (in Frame will not be shown, but is editable in a Dialog, see VType attributes)
        UPDATEGEOMETRY =    1 << 21,    // Attribute require update geometry at the end of function setAttribute(...)
        ACTIVATABLE =       1 << 22,    // Attribute can be switch on/off using a checkbox in frame
        FLOWDEFINITION =    1 << 23,    // Attribute is part of a flow definition (Number, vehsPerHour...)
        AUTOMATICID =       1 << 24,    // Attribute id can generate their own ID (used by additionals, vehicles, etc...)
        COPYABLE =          1 << 25,    // Attribute can be copied over other element with the same tagProperty (used for edge/lane templates)
    };
 
    GNEAttributeProperties();
 
    GNEAttributeProperties(const SumoXMLAttr attribute, const int attributeProperty, const std::string& definition, std::string defaultValue = "");
 
    ~GNEAttributeProperties();
 
    void checkAttributeIntegrity() const;
 
    void setDiscreteValues(const std::vector<std::string>& discreteValues);
 
    void setDefaultActivated(const bool value);
 
    void setSynonym(const SumoXMLAttr synonym);
 
    void setRange(const double minimum, const double maximum);
 
    void setTagPropertyParent(GNETagProperties* tagPropertyParent);
 
    SumoXMLAttr getAttr() const;
 
    const std::string& getAttrStr() const;
 
    const GNETagProperties& getTagPropertyParent() const;
 
    int getPositionListed() const;
 
    const std::string& getDefinition() const;
 
    const std::string& getDefaultValue() const;
 
    bool getDefaultActivated() const;
 
    std::string getDescription() const;
 
    const std::vector<std::string>& getDiscreteValues() const;
 
    SumoXMLAttr getAttrSynonym() const;
 
    double getMinimumRange() const;
 
    double getMaximumRange() const;
 
    bool hasDefaultValue() const;
 
    bool hasAttrSynonym() const;
 
    bool hasAttrRange() const;
 
    bool isInt() const;
 
    bool isFloat() const;
 
    bool isSUMOTime() const;
 
    bool isBool() const;
 
    bool isString() const;
 
    bool isPosition() const;
 
    bool isProbability() const;
 
    bool isNumerical() const;
 
    bool isPositive() const;
 
    bool isColor() const;
 
    bool isVType() const;
 
    bool isFilename() const;
 
    bool isVClass() const;
 
    bool isSVCPermission() const;
 
    bool isList() const;
 
    bool isSecuential() const;
 
    bool isUnique() const;
 
    bool isDiscrete() const;
 
    bool isExtended() const;
 
    bool requireUpdateGeometry() const;
 
    bool isActivatable() const;
 
    bool isFlowDefinition() const;
 
    bool hasAutomaticID() const;
 
    bool isCopyable() const;
 
private:
    SumoXMLAttr myAttribute = SUMO_ATTR_NOTHING;
 
    GNETagProperties* myTagPropertyParent = nullptr;
 
    std::string myAttrStr;
 
    int myAttributeProperty = STRING;
 
    std::string myDefinition;
 
    std::string myDefaultValue;
 
    bool myDefaultActivated = false;
 
    std::vector<std::string> myDiscreteValues;
 
    SumoXMLAttr myAttrSynonym = SUMO_ATTR_NOTHING;
 
    double myMinimumRange = 0;
 
    double myMaximumRange = 0;
};
 
/****************************************************************************/