ale-sys 0.1.2

Rust bindings to the Arcade Learning Environment
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
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

/* *****************************************************************************
 * A.L.E (Arcade Learning Environment)
 * Copyright (c) 2009-2013 by Yavar Naddaf, Joel Veness, Marc G. Bellemare,
 *   Matthew Hausknecht, and the Reinforcement Learning and Artificial Intelligence
 *   Laboratory
 * Released under the GNU General Public License; see License.txt for details.
 *
 * Based on: Stella  --  "An Atari 2600 VCS Emulator"
 * Copyright (c) 1995-2007 by Bradford W. Mott and the Stella team
 *
 * *****************************************************************************
 *  diplay_screen.cpp
 *
 *  Supports displaying the screen via SDL.
 **************************************************************************** */

#ifndef DISPLAY_SCREEN_H
#define DISPLAY_SCREEN_H

#include <stdio.h>
#include <stdlib.h>

#include "Constants.h"
#include "ColourPalette.hpp"
#include "../emucore/MediaSrc.hxx"

#ifdef __USE_SDL

#include "SDL.h"

namespace ale {

class DisplayScreen {
 public:
  DisplayScreen(MediaSource* mediaSource, Sound* sound, ColourPalette& palette);
  virtual ~DisplayScreen();

  // Displays the current frame buffer from the mediasource.
  void display_screen();

  // Has the user engaged manual control mode?
  bool manual_control_engaged() { return manual_control_active; }

  // Captures the keypress of a user in manual control mode.
  Action getUserAction();

 protected:
  // Checks for SDL events.
  void poll();

  // Handle the SDL_Event.
  void handleSDLEvent(const SDL_Event& event);

 protected:
  // Dimensions of the SDL window (4:3 aspect ratio)
  static const int window_height = 321;
  static const int window_width = 428;
  // Maintains the paused/unpaused state of the game
  bool manual_control_active;
  MediaSource* media_source;
  Sound* my_sound;
  ColourPalette& colour_palette;
  int screen_height, screen_width;
  SDL_Surface *screen, *image;
  float yratio, xratio;
  Uint32 delay_msec;
  // Used to calibrate delay between frames
  Uint32 last_frame_time;
};

}  // namespace ale

#else

namespace ale {

/** A dummy class that simply ignores display events. */
class DisplayScreen {
 public:
  DisplayScreen(MediaSource*, Sound*, ColourPalette&) {}
  void display_screen() {}
  bool manual_control_engaged() { return false; }
  Action getUserAction() { return UNDEFINED; }
};

}  // namespace ale

#endif  // __USE_SDL

#endif  // DISPLAY_SCREEN