openmw/apps/opencs/model/world/universalid.hpp

#ifndef CSM_WOLRD_UNIVERSALID_H
#define CSM_WOLRD_UNIVERSALID_H

#include <string>
#include <variant>
#include <vector>

#include <QMetaType>
#include <components/esm/refid.hpp>

namespace CSMWorld
{
    class UniversalId
    {
    public:
        enum Class
        {
            Class_None = 0,
            Class_Record = 1,
            Class_RefRecord = 2, // referenceable record
            Class_SubRecord = 4,
            Class_RecordList = 8,
            Class_Collection = 16, // multiple types of records combined
            Class_Transient = 32, // not part of the world data or the project data
            Class_NonRecord = 64, // record like data that is not part of the world
            Class_Resource = 128, ///< \attention Resource IDs are unique only within the
                                  /// respective collection
            Class_ResourceList = 256
        };

        enum ArgumentType
        {
            ArgumentType_None,
            ArgumentType_Id,
            ArgumentType_Index,
            ArgumentType_RefId,
        };

        /// \note A record list type must always be immediately followed by the matching
        /// record type, if this type is of class SubRecord or Record.
        enum Type
        {
            Type_None = 0,
            Type_Globals,
            Type_Global,
            Type_VerificationResults,
            Type_Gmsts,
            Type_Gmst,
            Type_Skills,
            Type_Skill,
            Type_Classes,
            Type_Class,
            Type_Factions,
            Type_Faction,
            Type_Races,
            Type_Race,
            Type_Sounds,
            Type_Sound,
            Type_Scripts,
            Type_Script,
            Type_Regions,
            Type_Region,
            Type_Birthsigns,
            Type_Birthsign,
            Type_Spells,
            Type_Spell,
            Type_Cells,
            Type_Cell,
            Type_Cell_Missing, // For cells that does not exist yet.
            Type_Referenceables,
            Type_Referenceable,
            Type_Activator,
            Type_Potion,
            Type_Apparatus,
            Type_Armor,
            Type_Book,
            Type_Clothing,
            Type_Container,
            Type_Creature,
            Type_Door,
            Type_Ingredient,
            Type_CreatureLevelledList,
            Type_ItemLevelledList,
            Type_Light,
            Type_Lockpick,
            Type_Miscellaneous,
            Type_Npc,
            Type_Probe,
            Type_Repair,
            Type_Static,
            Type_Weapon,
            Type_References,
            Type_Reference,
            Type_RegionMap,
            Type_Filters,
            Type_Filter,
            Type_Topics,
            Type_Topic,
            Type_Journals,
            Type_Journal,
            Type_TopicInfos,
            Type_TopicInfo,
            Type_JournalInfos,
            Type_JournalInfo,
            Type_Scene,
            Type_Preview,
            Type_LoadErrorLog,
            Type_Enchantments,
            Type_Enchantment,
            Type_BodyParts,
            Type_BodyPart,
            Type_Meshes,
            Type_Mesh,
            Type_Icons,
            Type_Icon,
            Type_Musics,
            Type_Music,
            Type_SoundsRes,
            Type_SoundRes,
            Type_Textures,
            Type_Texture,
            Type_Videos,
            Type_Video,
            Type_DebugProfiles,
            Type_DebugProfile,
            Type_SoundGens,
            Type_SoundGen,
            Type_MagicEffects,
            Type_MagicEffect,
            Type_Lands,
            Type_Land,
            Type_LandTextures,
            Type_LandTexture,
            Type_Pathgrids,
            Type_Pathgrid,
            Type_SelectionGroup,
            Type_StartScripts,
            Type_StartScript,
            Type_Search,
            Type_MetaDatas,
            Type_MetaData,
            Type_RunLog
        };

        enum
        {
            NumberOfTypes = Type_RunLog + 1
        };

        UniversalId(const std::string& universalId);

        UniversalId(Type type = Type_None);

        UniversalId(Type type, const std::string& id);
        ///< Using a type for a non-ID-argument UniversalId will throw an exception.

        UniversalId(Type type, ESM::RefId id);

        UniversalId(Type type, int index);
        ///< Using a type for a non-index-argument UniversalId will throw an exception.

        UniversalId(Type type, const UniversalId& id);

        Class getClass() const;

        ArgumentType getArgumentType() const;

        Type getType() const;

        const std::string& getId() const;
        ///< Calling this function for a non-ID type will throw an exception.

        int getIndex() const;
        ///< Calling this function for a non-index type will throw an exception.

        ESM::RefId getRefId() const;

        std::string getTypeName() const;

        std::string toString() const;

        std::string getIcon() const;
        ///< Will return an empty string, if no icon is available.

        static std::vector<Type> listReferenceableTypes();

        static std::vector<Type> listTypes(int classes);

        /// If \a type is a SubRecord, RefRecord or Record type return the type of the table
        /// that contains records of type \a type.
        /// Otherwise return Type_None.
        static Type getParentType(Type type);

    private:
        Class mClass;
        Type mType;
        std::variant<std::monostate, std::string, int, ESM::RefId> mValue;

        friend bool operator==(const UniversalId& left, const UniversalId& right);

        friend bool operator<(const UniversalId& left, const UniversalId& right);
    };

    bool operator==(const UniversalId& left, const UniversalId& right);

    bool operator<(const UniversalId& left, const UniversalId& right);
}

Q_DECLARE_METATYPE(CSMWorld::UniversalId)

#endif