play96 0.1.0

Programmable libretro harness for *96 fantasy-console cores
Documentation 
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

#ifndef PLAY96_H
#define PLAY96_H

#include <stddef.h>
#include <stdint.h>

#ifdef _WIN32
#ifdef PLAY96_BUILD
#define PLAY96_API __declspec(dllexport)
#else
#define PLAY96_API __declspec(dllimport)
#endif
#else
#define PLAY96_API
#endif

#ifdef __cplusplus
extern "C" {
#endif

typedef struct play96_session play96_session;

typedef struct play96_color {
    uint8_t red;
    uint8_t green;
    uint8_t blue;
    uint8_t alpha;
} play96_color;

/* Returns NULL on success. The returned error remains valid until the next API call on this session. */
PLAY96_API const char* play96_create(const char* core_path, const char* cartridge_path, play96_session** out_session);
PLAY96_API void play96_destroy(play96_session* session);
PLAY96_API const char* play96_run_frame(play96_session* session);
PLAY96_API const char* play96_run_frames(play96_session* session, size_t frames);
PLAY96_API const char* play96_set_button(play96_session* session, unsigned port, unsigned button, int pressed);
PLAY96_API const char* play96_clear_buttons(play96_session* session, unsigned port);
PLAY96_API unsigned play96_framebuffer_width(const play96_session* session);
PLAY96_API unsigned play96_framebuffer_height(const play96_session* session);
PLAY96_API uint32_t play96_pixel_xrgb(const play96_session* session, unsigned x, unsigned y);
PLAY96_API const char* play96_assert_pixel(const play96_session* session, unsigned x, unsigned y, play96_color expected);
PLAY96_API const char* play96_assert_pixel_xrgb(const play96_session* session, unsigned x, unsigned y, uint32_t expected);
PLAY96_API const char* play96_save_state(play96_session* session, const char* path);
PLAY96_API const char* play96_load_state(play96_session* session, const char* path);
PLAY96_API const char* play96_write_png(const play96_session* session, const char* path);
PLAY96_API const char* play96_last_error(const play96_session* session);

#ifdef __cplusplus
}
#endif

#endif