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
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
|
/*
* Copyright (C) 2014-2016 Team Kodi
* http://kodi.tv
*
* This Program 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, or (at your option)
* any later version.
*
* This Program 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 this Program; see the file COPYING. If not, see
* <http://www.gnu.org/licenses/>.
*
*/
#ifndef KODI_GAME_CALLBACKS_H_
#define KODI_GAME_CALLBACKS_H_
#include "kodi_game_types.h"
#ifdef __cplusplus
extern "C" {
#endif
typedef struct CB_GameLib
{
// --- Game callbacks --------------------------------------------------------
/*!
* \brief Requests the frontend to stop the current game
*/
void (*CloseGame)(void* addonData);
/*!
* \brief Create a video stream for pixel data
*
* \param format The type of pixel data accepted by this stream
* \param width The frame width
* \param height The frame height
* \param rotation The rotation (counter-clockwise) of the video frames
*
* \return 0 on success or -1 if a video stream is already created
*/
int (*OpenPixelStream)(void* addonData, GAME_PIXEL_FORMAT format, unsigned int width, unsigned int height, GAME_VIDEO_ROTATION rotation);
/*!
* \brief Create a video stream for encoded video data
*
* \param codec The video format accepted by this stream
*
* \return 0 on success or -1 if a video stream is already created
*/
int (*OpenVideoStream)(void* addonData, GAME_VIDEO_CODEC codec);
/*!
* \brief Create an audio stream for PCM audio data
*
* \param format The type of audio data accepted by this stream
* \param channel_map The channel layout terminated by GAME_CH_NULL
*
* \return 0 on success or -1 if an audio stream is already created
*/
int (*OpenPCMStream)(void* addonData, GAME_PCM_FORMAT format, const GAME_AUDIO_CHANNEL* channel_map);
/*!
* \brief Create an audio stream for encoded audio data
*
* \param codec The audio format accepted by this stream
* \param channel_map The channel layout terminated by GAME_CH_NULL
*
* \return 0 on success or -1 if an audio stream is already created
*/
int(*OpenAudioStream)(void* addonData, GAME_AUDIO_CODEC codec, const GAME_AUDIO_CHANNEL* channel_map);
/*!
* \brief Add a data packet to an audio or video stream
*
* \param stream The target stream
* \param data The data packet
* \param size The size of the data
*/
void (*AddStreamData)(void* addonData, GAME_STREAM_TYPE stream, const uint8_t* data, unsigned int size);
/*!
* \brief Free the specified stream
*
* \param stream The stream to close
*/
void (*CloseStream)(void* addonData, GAME_STREAM_TYPE stream);
// -- Hardware rendering callbacks -------------------------------------------
/*!
* \brief Enable hardware rendering
*
* \param hw_info A struct of properties for the hardware rendering system
*/
void (*EnableHardwareRendering)(void* addonData, const game_hw_info* hw_info);
/*!
* \brief Get the framebuffer for rendering
*
* \return The framebuffer
*/
uintptr_t (*HwGetCurrentFramebuffer)(void* addonData);
/*!
* \brief Get a symbol from the hardware context
*
* \param symbol The symbol's name
*
* \return A function pointer for the specified symbol
*/
game_proc_address_t (*HwGetProcAddress)(void* addonData, const char* symbol);
/*!
* \brief Called when a frame is being rendered
*/
void (*RenderFrame)(void* addonData);
// --- Input callbacks -------------------------------------------------------
/*!
* \brief Begin reporting events for the specified joystick port
*
* \param port The zero-indexed port number
*
* \return true if the port was opened, false otherwise
*/
bool (*OpenPort)(void* addonData, unsigned int port);
/*!
* \brief End reporting events for the specified port
*
* \param port The port number passed to OpenPort()
*/
void (*ClosePort)(void* addonData, unsigned int port);
/*!
* \brief Notify the port of an input event
*
* \param event The input event
*
* Input events can arrive for the following sources:
* - GAME_INPUT_EVENT_MOTOR
*
* \return true if the event was handled, false otherwise
*/
bool (*InputEvent)(void* addonData, const game_input_event* event);
} CB_GameLib;
#ifdef __cplusplus
}
#endif
#endif // KODI_GAME_CALLBACKS_H_
|
