aboutsummaryrefslogtreecommitdiffstats
path: root/src/sdl.erl
blob: 4d49d192e549404248304f031cf3efaf3a6612d6 (plain) (blame)
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
%% Copyright (c) 2014-2018, Loïc Hoguin <[email protected]>
%%
%% Permission to use, copy, modify, and/or distribute this software for any
%% purpose with or without fee is hereby granted, provided that the above
%% copyright notice and this permission notice appear in all copies.
%%
%% THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
%% WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
%% MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
%% ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
%% WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
%% ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
%% OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.

-module(sdl).

-export([start/0]).
-export([start/1]).
-export([stop/0]).
-export([stop_on_exit/0]).
-export([start_subsystems/1]).
-export([stop_subsystems/1]).
-export([is_started/1]).
-export([which_subsystems/0]).

-type error() :: {error, string()}.
-export_type([error/0]).

-type subsystem() :: timer | audio | video | joystick | haptic
	| game_controller | events | everything.

-spec start() -> ok | error().
start() ->
	start([]).

-spec start([subsystem()]) -> ok | {application_start_error, term()} | error().
start(Subsystems) ->
	case ensure_started() of
		ok ->
			esdl2:init(Subsystems),
			receive {'_nif_thread_ret_', Ret} -> Ret end;
		Error ->
			Error
	end.

ensure_started() ->
	case application:start(esdl2) of
		ok ->
			ok;
		{error, {already_started, esdl2}} ->
			ok;
		{error, Reason} ->
			{application_start_error, Reason}
	end.

-spec stop() -> ok.
stop() ->
	esdl2:quit().

-spec stop_on_exit() -> ok.
stop_on_exit() ->
	Self = self(),
	spawn_link(fun() ->
		process_flag(trap_exit, true),
		receive {'EXIT', Self, _} ->
			stop()
		end
	end),
	ok.

-spec start_subsystems([subsystem()]) -> ok | error().
start_subsystems(Subsystems) ->
	esdl2:init_subsystem(Subsystems),
	receive {'_nif_thread_ret_', Ret} -> Ret end.

-spec stop_subsystems([subsystem()]) -> ok.
stop_subsystems(Subsystems) ->
	esdl2:quit_subsystem(Subsystems).

-spec is_started(subsystem()) -> boolean().
is_started(Subsystem) ->
	esdl2:was_init([Subsystem]),
	receive {'_nif_thread_ret_', Ret} -> Ret =:= [Subsystem] end.

-spec which_subsystems() -> [subsystem()].
which_subsystems() ->
	esdl2:was_init([]),
	receive {'_nif_thread_ret_', Ret} -> Ret end.