summaryrefslogtreecommitdiffstats
path: root/xbmc/games/addons/GameClientTranslator.h
blob: 6b6b448a2f03fca4f251d22ce6fb99c4bba682a2 (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
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
/*
 *  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 "cores/RetroPlayer/streams/RetroPlayerStreamTypes.h"
#include "games/controllers/ControllerTypes.h"
#include "input/keyboard/KeyboardTypes.h"

extern "C"
{
#include <libavutil/pixfmt.h>
}

namespace KODI
{
namespace GAME
{
/*!
 * \ingroup games
 * \brief Translates data types from Game API to the corresponding format in Kodi.
 *
 * This class is stateless.
 */
class CGameClientTranslator
{
  CGameClientTranslator() = delete;

public:
  /*!
   * \brief Translates game errors to string representation (e.g. for logging).
   * \param error The error to translate.
   * \return Translated error.
   */
  static const char* ToString(GAME_ERROR error);

  /*!
   * \brief Translates game memory types to string representation (e.g. for logging).
   * \param memory The memory type to translate.
   * \return Translated memory type.
   */
  static const char* ToString(GAME_MEMORY error);

  /*!
   * \brief Translate stream type (Game API to RetroPlayer).
   * \param gameType The stream type to translate.
   * \param[out] retroType The translated stream type.
   * \return True if the Game API type was translated to a valid RetroPlayer type
   */
  static bool TranslateStreamType(GAME_STREAM_TYPE gameType, RETRO::StreamType& retroType);

  /*!
   * \brief Translate pixel format (Game API to RetroPlayer/FFMPEG).
   * \param format The pixel format to translate.
   * \return Translated pixel format.
   */
  static AVPixelFormat TranslatePixelFormat(GAME_PIXEL_FORMAT format);

  /*!
   * \brief Translate pixel format (RetroPlayer/FFMPEG to Game API).
   * \param format The pixel format to translate.
   * \return Translated pixel format.
   */
  static GAME_PIXEL_FORMAT TranslatePixelFormat(AVPixelFormat format);

  /*!
   * \brief Translate audio PCM format (Game API to RetroPlayer).
   * \param format The audio PCM format to translate.
   * \return Translated audio PCM format.
   */
  static RETRO::PCMFormat TranslatePCMFormat(GAME_PCM_FORMAT format);

  /*!
   * \brief Translate audio channels (Game API to RetroPlayer).
   * \param format The audio channels to translate.
   * \return Translated audio channels.
   */
  static RETRO::AudioChannel TranslateAudioChannel(GAME_AUDIO_CHANNEL channel);

  /*!
   * \brief Translate video rotation (Game API to RetroPlayer).
   * \param rotation The video rotation to translate.
   * \return Translated video rotation.
   */
  static RETRO::VideoRotation TranslateRotation(GAME_VIDEO_ROTATION rotation);

  /*!
   * \brief Translate key modifiers (Kodi to Game API).
   * \param modifiers The key modifiers to translate (e.g. Shift, Ctrl).
   * \return Translated key modifiers.
   */
  static GAME_KEY_MOD GetModifiers(KEYBOARD::Modifier modifier);

  /*!
   * \brief Translate region to string representation (e.g. for logging).
   * \param error The region to translate (e.g. PAL, NTSC).
   * \return Translated region.
   */
  static const char* TranslateRegion(GAME_REGION region);

  /*!
   * \brief Translate port type (Game API to Kodi)
   * \param portType  The port type to translate
   * \return Translated port type
   */
  static PORT_TYPE TranslatePortType(GAME_PORT_TYPE portType);
};
} // namespace GAME
} // namespace KODI