summaryrefslogtreecommitdiffstats
path: root/xbmc/games/addons/GameClientInGameSaves.h
blob: a75c155d672ae4541fc9f702a771b55e06a71d03 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
/*
 *  Copyright (C) 2016-2018 Team Kodi
 *  This file is part of Kodi - https://kodi.tv
 *
 *  SPDX-License-Identifier: GPL-2.0-or-later
 *  See LICENSES/README.md for more information.
 */

#pragma once

#include "addons/kodi-dev-kit/include/kodi/addon-instance/Game.h"

#include <string>

struct GameClient;

namespace KODI
{
namespace GAME
{
class CGameClient;

/*!
 * \brief This class implements in-game saves.
 *
 * \details Some games do not implement state persistence on their own, but rely on the frontend for
 * saving their current memory state to disk. This is mostly the case for emulators for SRAM
 * (battery backed up ram on cartridges) or memory cards.
 *
 * Differences to save states:
 * - Works only for supported games (e.g. emulated games with SRAM support)
 * - Often works emulator independent (and can be used to start a game with one emulator and
 * continue with another)
 * - Visible in-game (e.g. in-game save game selection menus)
 */
class CGameClientInGameSaves
{
public:
  /*!
   * \brief Constructor.
   * \param addon The game client implementation.
   * \param dllStruct The emulator or game for which the in-game saves are processed.
   */
  CGameClientInGameSaves(CGameClient* addon, const AddonInstance_Game* dllStruct);

  /*!
   * \brief Load in-game data.
   */
  void Load();

  /*!
   * \brief Save in-game data.
   */
  void Save();

private:
  std::string GetPath(GAME_MEMORY memoryType);

  void Load(GAME_MEMORY memoryType);
  void Save(GAME_MEMORY memoryType);

  const CGameClient* const m_gameClient;
  const AddonInstance_Game* const m_dllStruct;
};
} // namespace GAME
} // namespace KODI