mirror of
https://gitea.wildfiregames.com/0ad/0ad
synced 2026-06-16 13:23:56 -07:00
9150c20818
The first header was used to include the SpiderMonkey JS API at once, with safeguards and preprocessor defines. Nowadays, SpiderMonkey provides modular headers allowing us to include what we use, refs #8086. Some defines have to be moved to compiler options but it is apparently a mistake from the SM developers: https://bugzilla.mozilla.org/show_bug.cgi?id=1987876
127 lines
4 KiB
C++
127 lines
4 KiB
C++
/* Copyright (C) 2025 Wildfire Games.
|
|
* This file is part of 0 A.D.
|
|
*
|
|
* 0 A.D. 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.
|
|
*
|
|
* 0 A.D. 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 0 A.D. If not, see <http://www.gnu.org/licenses/>.
|
|
*/
|
|
|
|
#ifndef INCLUDED_VISUAL_REPLAY
|
|
#define INCLUDED_VISUAL_REPLAY
|
|
|
|
#include "lib/os_path.h"
|
|
|
|
#include <js/TypeDecls.h>
|
|
|
|
class CStrW;
|
|
class ScriptInterface;
|
|
namespace JS { class Value; }
|
|
|
|
/**
|
|
* Contains functions for visually replaying past games.
|
|
*/
|
|
namespace VisualReplay
|
|
{
|
|
|
|
/**
|
|
* Returns the absolute path to the sim-log directory (that contains the directories with the replay files.
|
|
*/
|
|
OsPath GetDirectoryPath();
|
|
|
|
/**
|
|
* Returns the absolute path to the replay cache file.
|
|
*/
|
|
OsPath GetCacheFilePath();
|
|
|
|
/**
|
|
* Returns the absolute path to the temporary replay cache file used to
|
|
* always have a valid cache file in place even if bad things happen.
|
|
*/
|
|
OsPath GetTempCacheFilePath();
|
|
|
|
/**
|
|
* Replays the commands.txt file in the given subdirectory visually.
|
|
*/
|
|
bool StartVisualReplay(const OsPath& directory);
|
|
|
|
/**
|
|
* Reads the replay Cache file and parses it into a jsObject
|
|
*
|
|
* @param scriptInterface - the ScriptInterface in which to create the return data.
|
|
* @param cachedReplaysObject - the cached replays.
|
|
* @return true on succes
|
|
*/
|
|
bool ReadCacheFile(const ScriptInterface& scriptInterface, JS::MutableHandleObject cachedReplaysObject);
|
|
|
|
/**
|
|
* Stores the replay list in the replay cache file
|
|
*
|
|
* @param scriptInterface - the ScriptInterface in which to create the return data.
|
|
* @param replays - the replay list to store.
|
|
*/
|
|
void StoreCacheFile(const ScriptInterface& scriptInterface, JS::HandleObject replays);
|
|
|
|
/**
|
|
* Load the replay cache and check if there are new/deleted replays. If so, update the cache.
|
|
*
|
|
* @param scriptInterface - the ScriptInterface in which to create the return data.
|
|
* @param compareFiles - compare the directory name and the FileSize of the replays and the cache.
|
|
* @return cache entries
|
|
*/
|
|
JS::HandleObject ReloadReplayCache(const ScriptInterface& scriptInterface, bool compareFiles);
|
|
|
|
/**
|
|
* Get a list of replays to display in the GUI.
|
|
*
|
|
* @param scriptInterface - the ScriptInterface in which to create the return data.
|
|
* @param compareFiles - reload the cache, which takes more time,
|
|
* but nearly ensures, that no changed replay is missed.
|
|
* @return array of objects containing replay data
|
|
*/
|
|
JS::Value GetReplays(const ScriptInterface& scriptInterface, bool compareFiles);
|
|
|
|
/**
|
|
* Parses a commands.txt file and extracts metadata.
|
|
* Works similarly to CGame::LoadReplayData().
|
|
*/
|
|
JS::Value LoadReplayData(const ScriptInterface& scriptInterface, const OsPath& directory);
|
|
|
|
/**
|
|
* Permanently deletes the visual replay (including the parent directory)
|
|
*
|
|
* @param replayFile - path to commands.txt, whose parent directory will be deleted.
|
|
* @return true if deletion was successful, false on error
|
|
*/
|
|
bool DeleteReplay(const OsPath& replayFile);
|
|
|
|
/**
|
|
* Returns the parsed header of the replay file (commands.txt).
|
|
*/
|
|
JS::Value GetReplayAttributes(const ScriptInterface& scriptInterface, const OsPath& directoryName);
|
|
|
|
/**
|
|
* Returns whether or not the metadata / summary screen data has been saved properly when the game ended.
|
|
*/
|
|
bool HasReplayMetadata(const OsPath& directoryName);
|
|
|
|
/**
|
|
* Returns the metadata of a replay.
|
|
*/
|
|
JS::Value GetReplayMetadata(const ScriptInterface& scriptInterface, const OsPath& directoryName);
|
|
|
|
/**
|
|
* Adds a replay to the replayCache.
|
|
*/
|
|
void AddReplayToCache(const ScriptInterface& scriptInterface, const CStrW& directoryName);
|
|
}
|
|
|
|
#endif
|