// SPDX-License-Identifier: MIT // // EmulationStation Desktop Edition // FileData.h // // Provides game file data structures and functions to access and sort this information. // Also provides functions to look up paths to media files and for launching games // (launching initiated in ViewController). // #ifndef ES_APP_FILE_DATA_H #define ES_APP_FILE_DATA_H #include "MetaData.h" #include "SystemData.h" #include "Window.h" #include "utils/FileSystemUtil.h" #include "utils/StringUtil.h" #include #include enum FileType { GAME = 1, // Cannot have children. FOLDER = 2, PLACEHOLDER = 3 }; // A tree node that holds information for a file. class FileData { public: FileData(FileType type, const std::string& path, SystemEnvironmentData* envData, SystemData* system); virtual ~FileData(); const std::string& getName() { return metadata.get("name"); } const std::string& getSortName(); // Returns our best guess at the "real" name for this file. std::string getDisplayName() const { const std::string& stem {Utils::FileSystem::getStem(mPath)}; return stem; } std::string getCleanName() const { return Utils::String::removeParenthesis(this->getDisplayName()); } const bool getFavorite(); const bool getKidgame(); const bool getHidden(); const bool getCountAsGame(); const std::pair& getGameCount() const { return mGameCount; } const bool getExcludeFromScraper(); const std::vector getChildrenRecursive() const; FileType getType() const { return mType; } const std::string& getPath() const { return mPath; } FileData* getParent() const { return mParent; } const std::unordered_map& getChildrenByFilename() const { return mChildrenByFilename; } const std::vector& getChildren() const { return mChildren; } const std::vector& getFilteredChildren() const { return mFilteredChildren; } SystemData* getSystem() const { return mSystem; } SystemData* getSourceSystem() { return (mSourceFileData != nullptr ? mSourceFileData->mSystem : mSystem); } SystemEnvironmentData* getSystemEnvData() const { return mEnvData; } // These functions are used by GameSelectorComponent. const std::vector& getChildrenLastPlayed() const { return mChildrenLastPlayed; } const std::vector& getChildrenMostPlayed() const { return mChildrenMostPlayed; } void setUpdateChildrenLastPlayed(bool state) { mUpdateChildrenLastPlayed = state; } void setUpdateChildrenMostPlayed(bool state) { mUpdateChildrenMostPlayed = state; } void setUpdateListCallback(const std::function& func) { mUpdateListCallback = func; } const bool getOnlyFoldersFlag() const { return mOnlyFolders; } const bool getHasFoldersFlag() const { return mHasFolders; } static const std::string getROMDirectory(); static const std::string getMediaDirectory(); const std::string getMediafilePath(const std::string& subdirectory) const; const std::string getImagePath() const; const std::string get3DBoxPath() const; const std::string getBackCoverPath() const; const std::string getCoverPath() const; const std::string getFanArtPath() const; const std::string getMarqueePath() const; const std::string getPhysicalMediaPath() const; const std::string getMiximagePath() const; const std::string getScreenshotPath() const; const std::string getTitleScreenPath() const; const std::string getVideoPath() const; const std::string getManualPath() const; const bool getDeletionFlag() const { return mDeletionFlag; } void setDeletionFlag(bool setting) { mDeletionFlag = setting; } const bool isPlaceHolder() const { return mType == PLACEHOLDER; } void refreshMetadata() { metadata = mSourceFileData->metadata; } const std::vector& getChildrenListToDisplay(); std::vector getFilesRecursive(unsigned int typeMask, bool displayedOnly = false, bool countAllGames = true) const; std::vector getScrapeFilesRecursive(bool includeFolders, bool excludeRecursively, bool respectExclusions) const; void addChild(FileData* file); // Error if mType != FOLDER void removeChild(FileData* file); // Error if mType != FOLDER virtual std::string getKey() { return getFileName(); } const bool isArcadeAsset() const; const bool isArcadeGame() const; const std::string& getFullPath() const { return getPath(); } std::string getFileName() { return Utils::FileSystem::getFileName(getPath()); } virtual FileData* getSourceFileData() { return this; } const std::string& getSystemName() const { return mSystemName; } void launchGame(); const std::string findEmulatorPath(std::string& command); using ComparisonFunction = bool(const FileData* a, const FileData* b); struct SortType { ComparisonFunction* comparisonFunction; std::string description; SortType(ComparisonFunction* sortFunction, const std::string& sortDescription) : comparisonFunction(sortFunction) , description(sortDescription) { } }; void sort(ComparisonFunction& comparator, std::pair& gameCount); void sortFavoritesOnTop(ComparisonFunction& comparator, std::pair& gameCount); void sort(const SortType& type, bool mFavoritesOnTop = false); MetaDataList metadata; // Only count the games, a cheaper alternative to a full sort when that is not required. void countGames(std::pair& gameCount); void updateLastPlayedList(); void updateMostPlayedList(); void setSortTypeString(std::string typestring) { mSortTypeString = typestring; } const std::string& getSortTypeString() const { return mSortTypeString; } const FileData::SortType& getSortTypeFromString(const std::string& desc) const; protected: FileData* mSourceFileData; FileData* mParent; std::string mSystemName; std::string mSortTypeString = ""; private: FileType mType; std::string mPath; SystemEnvironmentData* mEnvData; SystemData* mSystem; std::unordered_map mChildrenByFilename; std::vector mChildren; std::vector mFilteredChildren; std::vector mChildrenLastPlayed; std::vector mChildrenMostPlayed; std::function mUpdateListCallback; // The pair includes all games, and favorite games. std::pair mGameCount; bool mOnlyFolders; bool mHasFolders; bool mUpdateChildrenLastPlayed; bool mUpdateChildrenMostPlayed; // Used for flagging a game for deletion from its gamelist.xml file. bool mDeletionFlag; }; class CollectionFileData : public FileData { public: CollectionFileData(FileData* file, SystemData* system); ~CollectionFileData(); FileData* getSourceFileData() { return mSourceFileData; } std::string getKey() { return getFullPath(); } }; #endif // ES_APP_FILE_DATA_H