mirror of
https://github.com/libretro/RetroArch.git
synced 2024-11-27 10:10:57 +00:00
150 lines
4.9 KiB
C
150 lines
4.9 KiB
C
/* RetroArch - A frontend for libretro.
|
|
* Copyright (C) 2010-2014 - Hans-Kristian Arntzen
|
|
* Copyright (C) 2011-2015 - Daniel De Matteis
|
|
*
|
|
* RetroArch 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 Found-
|
|
* ation, either version 3 of the License, or (at your option) any later version.
|
|
*
|
|
* RetroArch 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 RetroArch.
|
|
* If not, see <http://www.gnu.org/licenses/>.
|
|
*/
|
|
|
|
|
|
#ifndef __RARCH_NETPLAY_H
|
|
#define __RARCH_NETPLAY_H
|
|
|
|
#include <stdint.h>
|
|
#include <stddef.h>
|
|
#include <boolean.h>
|
|
#include "libretro.h"
|
|
#include "libretro_version_1.h"
|
|
|
|
typedef struct netplay netplay_t;
|
|
|
|
/* TODO: most of this, actually */
|
|
/* /!\ WARNING: A command identifier cannot exceed 16 bytes in length. */
|
|
enum netplay_cmd
|
|
{
|
|
/* misc. commands */
|
|
NETPLAY_CMD_ACK = 0x0000, /**< Acknowlegement response */
|
|
NETPLAY_CMD_NAK = 0x0001, /**< Failed acknowlegement response */
|
|
NETPLAY_CMD_FLIP_PLAYERS = 0x0002, /**< Swap inputs between p1 and p2. */
|
|
NETPLAY_CMD_SPECTATE = 0x0003, /**< Toggle spectate/join mode */
|
|
NETPLAY_CMD_DISCONNECT = 0x0004, /**< Gracefully disconnects from host. */
|
|
|
|
NETPLAY_CMD_CFG = 0x0005, /**< Sends multiple config requests over, See
|
|
enum netplay_cmd_cfg. */
|
|
|
|
NETPLAY_CMD_CFG_ACK = 0x0006, /**< CMD_CFG streamlines sending multiple
|
|
configurations. This acknowledges
|
|
each one individually. */
|
|
|
|
/* loading and synchronization */
|
|
NETPLAY_CMD_LOAD_SAVESTATE = 0x0012, /** Send a savestate for the client to load */
|
|
NETPLAY_CMD_CHEATS = 0x0013, /** Sends over cheats enabled on client. */
|
|
/* controlling game playback */
|
|
NETPLAY_CMD_PAUSE = 0x0030, /**< Pauses the game, takes no args. */
|
|
NETPLAY_CMD_RESUME = 0x0031 /**< Resumes the game, takes no args. */
|
|
};
|
|
|
|
/* These are the configurations sent by NETPLAY_CMD_CFG. */
|
|
enum netplay_cmd_cfg
|
|
{
|
|
NETPLAY_CFG_NICK = 0x0001, /**< nickname */
|
|
NETPLAY_CFG_SWAP_INPUT = 0x0002, /**< input.netplay_client_swap_input */
|
|
NETPLAY_CFG_DELAY_FRAMES = 0x0004, /**< netplay.sync_frames */
|
|
NETPLAY_CFG_PLAYER_SLOT = 0x0008 /**< For more than 2 players. */
|
|
};
|
|
|
|
void input_poll_net(void);
|
|
|
|
int16_t input_state_net(unsigned port, unsigned device,
|
|
unsigned idx, unsigned id);
|
|
|
|
void video_frame_net(const void *data, unsigned width,
|
|
unsigned height, size_t pitch);
|
|
|
|
void audio_sample_net(int16_t left, int16_t right);
|
|
|
|
size_t audio_sample_batch_net(const int16_t *data, size_t frames);
|
|
|
|
int16_t input_state_spectate(unsigned port, unsigned device,
|
|
unsigned idx, unsigned id);
|
|
|
|
int16_t input_state_spectate_client(unsigned port, unsigned device,
|
|
unsigned idx, unsigned id);
|
|
|
|
/**
|
|
* netplay_new:
|
|
* @server : IP address of server.
|
|
* @port : Port of server.
|
|
* @frames : Amount of lag frames.
|
|
* @cb : Libretro callbacks.
|
|
* @spectate : If true, enable spectator mode.
|
|
* @nick : Nickname of user.
|
|
*
|
|
* Creates a new netplay handle. A NULL host means we're
|
|
* hosting (user 1).
|
|
*
|
|
* Returns: new netplay handle.
|
|
**/
|
|
netplay_t *netplay_new(const char *server,
|
|
uint16_t port, unsigned frames,
|
|
const struct retro_callbacks *cb, bool spectate,
|
|
const char *nick);
|
|
|
|
/**
|
|
* netplay_free:
|
|
* @netplay : pointer to netplay object
|
|
*
|
|
* Frees netplay handle.
|
|
**/
|
|
void netplay_free(netplay_t *handle);
|
|
|
|
/**
|
|
* netplay_flip_users:
|
|
* @netplay : pointer to netplay object
|
|
*
|
|
* On regular netplay, flip who controls user 1 and 2.
|
|
**/
|
|
void netplay_flip_users(netplay_t *handle);
|
|
|
|
/**
|
|
* netplay_pre_frame:
|
|
* @netplay : pointer to netplay object
|
|
*
|
|
* Pre-frame for Netplay.
|
|
* Call this before running retro_run().
|
|
**/
|
|
void netplay_pre_frame(netplay_t *handle);
|
|
|
|
/**
|
|
* netplay_post_frame:
|
|
* @netplay : pointer to netplay object
|
|
*
|
|
* Post-frame for Netplay.
|
|
* We check if we have new input and replay from recorded input.
|
|
* Call this after running retro_run().
|
|
**/
|
|
void netplay_post_frame(netplay_t *handle);
|
|
|
|
/**
|
|
* init_netplay:
|
|
*
|
|
* Initializes netplay.
|
|
*
|
|
* If netplay is already initialized, will return false (0).
|
|
*
|
|
* Returns: true (1) if successful, otherwise false (0).
|
|
**/
|
|
bool init_netplay(void);
|
|
|
|
void deinit_netplay(void);
|
|
|
|
#endif
|