note
	description: "Joystick manager. Not tested. It is most probable that it does not work correctly"
	author: "Louis Marchand"
	date: "May 24, 2012"
	revision: "1.0.0.0"

class 
	GAME_JOYSTICK

create {GAME_LIBRARY_CONTROLLER}
	make

feature {NONE} -- Initialization

	default_create
			-- Process instances of classes with no creation clause.
			-- (Default: do nothing.)
			-- (from ANY)
		do
		end

	make (a_open_index: INTEGER_32)
			-- Initialization for Current using a_open_index when open.
		do
			events_controller := Game_library.events_controller
			open_index := a_open_index
			is_removed := False
			make_events
		end
	
feature -- Access

	axes_count: INTEGER_32
			-- Get the number of axes on the joystick.
		require
			get_axes_number_opened: is_open
			not_removed: not is_removed
		do
			clear_error
			Result := {GAME_SDL_EXTERNAL}.sdl_joysticknumaxes (item)
			manage_error_code (Result, "Error while querying the number of joystick axes.")
		end

	axes_number: INTEGER_32
		obsolete "Use `axes_count' instead"
			-- Get the number of axes on the joystick.
		require
			get_axes_number_opened: is_open
			not_removed: not is_removed
		do
			clear_error
			Result := {GAME_SDL_EXTERNAL}.sdl_joysticknumaxes (item)
			manage_error_code (Result, "Error while querying the number of joystick axes.")
		end

	axis_motion_actions: ACTION_SEQUENCE [NATURAL_32, NATURAL_8, INTEGER_16]
			-- When an axis of Current has been moved at a certain value.
			-- (from GAME_JOYSTICK_EVENTS)
		require -- from GAME_JOYSTICK_EVENTS
			joy_axis_motion_event_enable: events_controller.is_joy_axis_motion_event_enable
		do
			if attached axis_motion_actions_internal as la_axis_motion_actions_internal then
				Result := la_axis_motion_actions_internal
			else
				create Result
				if is_events_running and not events_controller.joy_axis_motion_actions.has (axis_motion_events_callback) then
					events_controller.joy_axis_motion_actions.extend (axis_motion_events_callback)
				end
				axis_motion_actions_internal := Result
			end
		end

	axis_value (a_axis_id: INTEGER_32): INTEGER_16
			-- Get the value of the axis identified by a_axis_id.
			-- Note that a_axis_id index start at 0
		require
			get_axis_value_opened: is_open
			not_removed: not is_removed
			get_axis_value_axis_id_valid: a_axis_id < axes_count
		do
			Result := {GAME_SDL_EXTERNAL}.sdl_joystickgetaxis (item, a_axis_id)
		end

	ball_change (a_ball_id: INTEGER_32): TUPLE [x_relative: INTEGER_32; y_relative: INTEGER_32]
			-- Return the state of the ball identified by a_ball_id (relative to the last read).
			-- Note that a_ball_id index start at 0
		require
			get_ball_value_opened: is_open
			get_ball_value_ball_id_valid: a_ball_id < axes_count
			not_removed: not is_removed
		local
			l_dx, l_dy, l_error: INTEGER_32
		do
			clear_error
			{GAME_SDL_EXTERNAL}.sdl_joystickupdate
			l_error := {GAME_SDL_EXTERNAL}.sdl_joystickgetball (item, a_ball_id, $l_dx.to_pointer, $l_dy.to_pointer)
			Result := [l_dx, l_dy]
			manage_error_code (l_error, "Error while querying the state change of joystick ball.")
		end

	ball_motion_actions: ACTION_SEQUENCE [NATURAL_32, NATURAL_8, INTEGER_16, INTEGER_16]
			-- When a ball of Current has been moved to a certain relative value (x_relative,y_relative)
			-- (from GAME_JOYSTICK_EVENTS)
		require -- from GAME_JOYSTICK_EVENTS
			joy_ball_motion_event_enable: events_controller.is_joy_ball_motion_event_enable
		do
			if attached ball_motion_actions_internal as la_ball_motion_actions_internal then
				Result := la_ball_motion_actions_internal
			else
				create Result
				if is_events_running and not events_controller.joy_ball_motion_actions.has (ball_motion_events_callback) then
					events_controller.joy_ball_motion_actions.extend (ball_motion_events_callback)
				end
				ball_motion_actions_internal := Result
			end
		end

	balls_count: INTEGER_32
			-- Return the number of balls on the joystick.
		require
			get_balls_number_opened: is_open
			not_removed: not is_removed
		do
			clear_error
			Result := {GAME_SDL_EXTERNAL}.sdl_joysticknumballs (item)
			manage_error_code (Result, "Error while querying the number of joystick balls.")
		end

	balls_number: INTEGER_32
		obsolete "Use `balls_count' instead"
			-- Return the number of balls on the joystick.
		require
			get_balls_number_opened: is_open
			not_removed: not is_removed
		do
			clear_error
			Result := {GAME_SDL_EXTERNAL}.sdl_joysticknumballs (item)
			manage_error_code (Result, "Error while querying the number of joystick balls.")
		end

	button_pressed_actions: ACTION_SEQUENCE [NATURAL_32, NATURAL_8]
			-- When a button (identified by button_id) of Current has been pressed.
			-- (from GAME_JOYSTICK_EVENTS)
		require -- from GAME_JOYSTICK_EVENTS
			joy_button_pressed_event_enable: events_controller.is_joy_button_pressed_event_enable
		do
			if attached button_pressed_actions_internal as la_button_pressed_actions_internal then
				Result := la_button_pressed_actions_internal
			else
				create Result
				if is_events_running and not events_controller.joy_button_pressed_actions.has (button_pressed_events_callback) then
					events_controller.joy_button_pressed_actions.extend (button_pressed_events_callback)
				end
				button_pressed_actions_internal := Result
			end
		end

	button_released_actions: ACTION_SEQUENCE [NATURAL_32, NATURAL_8]
			-- When a button (identified by button_id) of Current has been released.
			-- (from GAME_JOYSTICK_EVENTS)
		require -- from GAME_JOYSTICK_EVENTS
			joy_button_pressed_event_enable: events_controller.is_joy_button_released_event_enable
		do
			if attached button_released_actions_internal as la_button_released_actions_internal then
				Result := la_button_released_actions_internal
			else
				create Result
				if is_events_running and not events_controller.joy_button_released_actions.has (button_released_events_callback) then
					events_controller.joy_button_released_actions.extend (button_released_events_callback)
				end
				button_released_actions_internal := Result
			end
		end

	buttons_count: INTEGER_32
			-- Return the number of buttons on the joystick.
		require
			get_buttons_number_opened: is_open
			not_removed: not is_removed
		do
			clear_error
			Result := {GAME_SDL_EXTERNAL}.sdl_joysticknumbuttons (item)
			manage_error_code (Result, "Error while querying the number of joystick buttons.")
		end

	buttons_number: INTEGER_32
		obsolete "Use `buttons_count' instead"
			-- Return the number of buttons on the joystick.
		require
			get_buttons_number_opened: is_open
			not_removed: not is_removed
		do
			clear_error
			Result := {GAME_SDL_EXTERNAL}.sdl_joysticknumbuttons (item)
			manage_error_code (Result, "Error while querying the number of joystick buttons.")
		end

	clear_events
			-- <Precuror>
			-- (from GAME_JOYSTICK_EVENTS)
		local
			l_was_running: BOOLEAN
		do
			l_was_running := is_events_running
			if is_events_running then
				stop_events
			end
			axis_motion_actions_internal := Void
			ball_motion_actions_internal := Void
			hat_motion_actions_internal := Void
			button_pressed_actions_internal := Void
			button_released_actions_internal := Void
			removed_actions_internal := Void
			if l_was_running then
				run_events
			end
		ensure -- from GAME_EVENTS
			running_unchanged: is_events_running = old is_events_running
		end

	close
			-- Close Current (Free internal structure).
		require
			close_is_open: is_open
		do
			internal_close
		end

	events_controller: GAME_EVENTS_CONTROLLER
			-- Used main event manager

	Game_library: GAME_LIBRARY_CONTROLLER
			-- The main controller of the game library
			-- (from GAME_LIBRARY_SHARED)
		once ("PROCESS")
			if attached internal_game_library as la_game_library then
				Result := la_game_library
			else
				create Result
			end
		end

	generating_type: TYPE [detachable GAME_JOYSTICK]
			-- Type of current object
			-- (type of which it is a direct instance)
			-- (from ANY)
		external
			"built_in"
		ensure -- from ANY
			generating_type_not_void: Result /= Void
		end

	generator: STRING_8
			-- Name of current object's generating class
			-- (base class of the type of which it is a direct instance)
			-- (from ANY)
		external
			"built_in"
		ensure -- from ANY
			generator_not_void: Result /= Void
			generator_not_empty: not Result.is_empty
		end

	guid: READABLE_STRING_GENERAL
			-- A unique hardware identifier of Current
		require
			not_removed: not is_removed
		local
			l_string_buffer: POINTER
		do
			l_string_buffer := l_string_buffer.memory_alloc (50)
			if is_open then
				{GAME_SDL_EXTERNAL}.c_sdl_joystickgetguidstring (item, l_string_buffer, 50)
			else
				{GAME_SDL_EXTERNAL}.c_sdl_joystickgetdeviceguidstring (open_index, l_string_buffer, 50)
			end
			Result := (create {C_STRING}.own_from_pointer (l_string_buffer)).string
		end

	haptic_controller: GAME_HAPTIC_JOYSTICK
			-- Used to manage the haptic (force feedback) of Current
		require
			is_buttons_pressed_opened: is_open
			not_removed: not is_removed
			is_haptic_capable: is_haptic_capable
			is_haptic_enable: Game_library.is_haptic_enable
		do
			if attached internal_haptic_controller as la_internal_haptic_controller then
				Result := la_internal_haptic_controller
			else
				create Result.make (Current)
				internal_haptic_controller := Result
			end
		end

	has_error: BOOLEAN
			-- Is the library has generate an error
			-- (from GAME_ERROR_MANAGER)

	hat_motion_actions: ACTION_SEQUENCE [NATURAL_32, NATURAL_8, GAME_JOYSTICK_HAT_STATE]
			-- When a hat of Current has been moved at a certain value.
			-- (from GAME_JOYSTICK_EVENTS)
		require -- from GAME_JOYSTICK_EVENTS
			joy_hat_motion_event_enable: events_controller.is_joy_hat_motion_event_enable
		do
			if attached hat_motion_actions_internal as la_hat_motion_actions_internal then
				Result := la_hat_motion_actions_internal
			else
				create Result
				if is_events_running and not events_controller.joy_hat_motion_actions.has (hat_motion_events_callback) then
					events_controller.joy_hat_motion_actions.extend (hat_motion_events_callback)
				end
				hat_motion_actions_internal := Result
			end
		end

	hat_state (a_hat_id: INTEGER_32): GAME_JOYSTICK_HAT_STATE
			-- The state of the hat identified by a_hat_id
			-- Note that a_hat_id index start at 0
		require
			get_hat_state_opened: is_open
			not_removed: not is_removed
			get_hat_state_hat_id_valid: a_hat_id < hats_count
		do
			create Result.make ({GAME_SDL_EXTERNAL}.sdl_joystickgethat (item, a_hat_id))
		end

	hats_count: INTEGER_32
			-- Return the number of hats on the joystick.
		require
			get_hats_number_opened: is_open
			not_removed: not is_removed
		do
			clear_error
			Result := {GAME_SDL_EXTERNAL}.sdl_joysticknumhats (item)
			manage_error_code (Result, "Error while querying the number of joystick hats.")
		end

	hats_number: INTEGER_32
		obsolete "Use `hats_count' instead"
			-- Return the number of hats on the joystick.
		require
			get_hats_number_opened: is_open
			not_removed: not is_removed
		do
			clear_error
			Result := {GAME_SDL_EXTERNAL}.sdl_joysticknumhats (item)
			manage_error_code (Result, "Error while querying the number of joystick hats.")
		end

	index: INTEGER_32
			-- Internal unique identifier of Current
		do
			if is_open then
				Result := instance_id
			else
				Result := -1
			end
		end

	instance_id: INTEGER_32
			-- Identifier of Current used in event handeling
		require
			is_buttons_pressed_opened: is_open
			not_removed: not is_removed
		do
			clear_error
			Result := {GAME_SDL_EXTERNAL}.sdl_joystickinstanceid (item)
			manage_error_code (Result, "Error while querying the joystick's instance ID.")
		end

	is_button_pressed (a_button_id: INTEGER_32): BOOLEAN
			-- True if the button identified by a_button_id is pressed, False otherwise
			-- Note that a_button_id index start at 0
		require
			is_buttons_pressed_opened: is_open
			is_button_pressed_button_id_valid: a_button_id < buttons_count
			not_removed: not is_removed
		do
			Result := {GAME_SDL_EXTERNAL}.sdl_joystickgetbutton (item, a_button_id)
		end

	is_haptic_capable: BOOLEAN
			-- Is Current has haptic features
		require
			is_buttons_pressed_opened: is_open
			not_removed: not is_removed
			is_haptic_enable: Game_library.is_haptic_enable
		local
			l_error: INTEGER_32
		do
			clear_error
			l_error := {GAME_SDL_EXTERNAL}.sdl_joystickishaptic (item)
			manage_error_code (l_error, "Error while querying if the joystick has haptic functionnalities.")
			Result := l_error = 1
		end

	is_open: BOOLEAN
			-- True if the joystick has been opened.
		do
			Result := (not item.is_default_pointer) and then {GAME_SDL_EXTERNAL}.sdl_joystickgetattached (item)
		end

	is_removed: BOOLEAN
			-- Current has been removed

	is_events_running: BOOLEAN assign set_is_running
			-- Is Current active
			-- (from GAME_EVENTS)

	last_error: READABLE_STRING_GENERAL
			-- The last error generate by the library
			-- (from GAME_SDL_ANY)
		local
			l_string: C_STRING
		do
			if is_manual_error then
				Result := Precursor {GAME_ERROR_MANAGER}
			else
				create l_string.make_by_pointer ({GAME_SDL_EXTERNAL}.sdl_geterror)
				Result := l_string.string
			end
		end

	name: STRING_8
			-- Return the Joystick Name.
		require
			not_removed: not is_removed
		local
			l_text_return: C_STRING
		do
			if is_open then
				create l_text_return.make_by_pointer ({GAME_SDL_EXTERNAL}.sdl_joystickname (item))
			else
				create l_text_return.make_by_pointer ({GAME_SDL_EXTERNAL}.sdl_joysticknameforindex (open_index))
			end
			Result := l_text_return.string
		end

	open
			-- Open Current (Allocate internal structure).
		require
			open_joystick_not_open: not is_open
		do
			clear_error
			item := {GAME_SDL_EXTERNAL}.sdl_joystickopen (open_index)
			manage_error_pointer (item, "Error while opening the Joystick.")
		ensure
			is_open_or_error: not has_error implies is_open
		end

	removed_actions: ACTION_SEQUENCE [NATURAL_32]
			-- When Current is removed (probably disconected)
			-- (from GAME_JOYSTICK_EVENTS)
		require -- from GAME_JOYSTICK_EVENTS
			joy_button_pressed_event_enable: events_controller.is_joy_device_removed_event_enable
		do
			if attached removed_actions_internal as la_removed_actions_internal then
				Result := la_removed_actions_internal
			else
				create Result
				removed_actions_internal := Result
			end
		end

	run_events
			-- <Precuror>
			-- (from GAME_JOYSTICK_EVENTS)
		require -- from GAME_EVENTS
			run_not_already_running: not is_events_running
		do
			is_events_running := True
			if attached axis_motion_actions_internal then
				events_controller.joy_axis_motion_actions.extend (axis_motion_events_callback)
			end
			if attached ball_motion_actions_internal then
				events_controller.joy_ball_motion_actions.extend (ball_motion_events_callback)
			end
			if attached hat_motion_actions_internal then
				events_controller.joy_hat_motion_actions.extend (hat_motion_events_callback)
			end
			if attached button_pressed_actions_internal then
				events_controller.joy_button_pressed_actions.extend (button_pressed_events_callback)
			end
			if attached button_released_actions_internal then
				events_controller.joy_button_released_actions.extend (button_released_events_callback)
			end
		ensure -- from GAME_EVENTS
			is_running: is_events_running
		end

	set_is_running (a_value: BOOLEAN)
			-- Assign to is_running the value of a_value
			-- (from GAME_EVENTS)
		do
			if a_value then
				run_events
			else
				stop_events
			end
		ensure -- from GAME_EVENTS
			is_assign: is_events_running ~ a_value
		end

	stop_events
			-- <Precuror>
			-- (from GAME_JOYSTICK_EVENTS)
		require -- from GAME_EVENTS
			stop_is_running: is_events_running
		do
			is_events_running := False;
			events_controller.joy_axis_motion_actions.prune_all (axis_motion_events_callback);
			events_controller.joy_ball_motion_actions.prune_all (ball_motion_events_callback);
			events_controller.joy_hat_motion_actions.prune_all (hat_motion_events_callback);
			events_controller.joy_button_pressed_actions.prune_all (button_pressed_events_callback);
			events_controller.joy_button_released_actions.prune_all (button_released_events_callback)
		ensure -- from GAME_EVENTS
			is_stopped: not is_events_running
		end
	
feature -- Comparison

	frozen deep_equal (a: detachable ANY; b: like arg #1): BOOLEAN
			-- Are a and b either both void
			-- or attached to isomorphic object structures?
			-- (from ANY)
		do
			if a = Void then
				Result := b = Void
			else
				Result := b /= Void and then a.is_deep_equal (b)
			end
		ensure -- from ANY
			instance_free: class
			shallow_implies_deep: standard_equal (a, b) implies Result
			both_or_none_void: (a = Void) implies (Result = (b = Void))
			same_type: (Result and (a /= Void)) implies (b /= Void and then a.same_type (b))
			symmetric: Result implies deep_equal (b, a)
		end

	frozen equal (a: detachable ANY; b: like arg #1): BOOLEAN
			-- Are a and b either both void or attached
			-- to objects considered equal?
			-- (from ANY)
		do
			if a = Void then
				Result := b = Void
			else
				Result := b /= Void and then a.is_equal (b)
			end
		ensure -- from ANY
			instance_free: class
			definition: Result = (a = Void and b = Void) or else ((a /= Void and b /= Void) and then a.is_equal (b))
		end

	frozen is_deep_equal alias "≡≡≡" (other: GAME_JOYSTICK): BOOLEAN
			-- Are Current and other attached to isomorphic object structures?
			-- (from ANY)
		require -- from ANY
			other_not_void: other /= Void
		external
			"built_in"
		ensure -- from ANY
			shallow_implies_deep: standard_is_equal (other) implies Result
			same_type: Result implies same_type (other)
			symmetric: Result implies other.is_deep_equal (Current)
		end

	is_equal (other: GAME_JOYSTICK): BOOLEAN
			-- Is other attached to an object considered
			-- equal to current object?
			-- (from ANY)
		require -- from ANY
			other_not_void: other /= Void
		external
			"built_in"
		ensure -- from ANY
			symmetric: Result implies other ~ Current
			consistent: standard_is_equal (other) implies Result
		end

	frozen standard_equal (a: detachable ANY; b: like arg #1): BOOLEAN
			-- Are a and b either both void or attached to
			-- field-by-field identical objects of the same type?
			-- Always uses default object comparison criterion.
			-- (from ANY)
		do
			if a = Void then
				Result := b = Void
			else
				Result := b /= Void and then a.standard_is_equal (b)
			end
		ensure -- from ANY
			instance_free: class
			definition: Result = (a = Void and b = Void) or else ((a /= Void and b /= Void) and then a.standard_is_equal (b))
		end

	frozen standard_is_equal alias "≜" (other: GAME_JOYSTICK): BOOLEAN
			-- Is other attached to an object of the same type
			-- as current object, and field-by-field identical to it?
			-- (from ANY)
		require -- from ANY
			other_not_void: other /= Void
		external
			"built_in"
		ensure -- from ANY
			same_type: Result implies same_type (other)
			symmetric: Result implies other.standard_is_equal (Current)
		end
	
feature {NONE} -- Status report

	is_in_final_collect: BOOLEAN
			-- Is GC currently performing final collection
			-- after execution of current program?
			-- Safe to use in dispose.
			-- (from DISPOSABLE)
		external
			"C inline use %"eif_memory.h%""
		alias
			"return eif_is_in_final_collect;"
		end
	
feature -- Status report

	conforms_to (other: ANY): BOOLEAN
			-- Does type of current object conform to type
			-- of other (as per Eiffel: The Language, chapter 13)?
			-- (from ANY)
		require -- from ANY
			other_not_void: other /= Void
		external
			"built_in"
		end

	same_type (other: ANY): BOOLEAN
			-- Is type of current object identical to type of other?
			-- (from ANY)
		require -- from ANY
			other_not_void: other /= Void
		external
			"built_in"
		ensure -- from ANY
			definition: Result = (conforms_to (other) and other.conforms_to (Current))
		end
	
feature -- Duplication

	frozen clone (other: detachable ANY): like other
		obsolete "Use `twin' instead. [2017-05-31]"
			-- Void if other is void; otherwise new object
			-- equal to other
			--
			-- For non-void other, clone calls copy;
			-- to change copying/cloning semantics, redefine copy.
			-- (from ANY)
		do
			if other /= Void then
				Result := other.twin
			end
		ensure -- from ANY
			instance_free: class
			equal: Result ~ other
		end

	copy (other: GAME_JOYSTICK)
			-- Update current object using fields of object attached
			-- to other, so as to yield equal objects.
			-- (from ANY)
		require -- from ANY
			other_not_void: other /= Void
			type_identity: same_type (other)
		external
			"built_in"
		ensure -- from ANY
			is_equal: Current ~ other
		end

	frozen deep_clone (other: detachable ANY): like other
		obsolete "Use `deep_twin' instead. [2017-05-31]"
			-- Void if other is void: otherwise, new object structure
			-- recursively duplicated from the one attached to other
			-- (from ANY)
		do
			if other /= Void then
				Result := other.deep_twin
			end
		ensure -- from ANY
			instance_free: class
			deep_equal: deep_equal (other, Result)
		end

	frozen deep_copy (other: GAME_JOYSTICK)
			-- Effect equivalent to that of:
			--		copy (other . deep_twin)
			-- (from ANY)
		require -- from ANY
			other_not_void: other /= Void
		do
			copy (other.deep_twin)
		ensure -- from ANY
			deep_equal: deep_equal (Current, other)
		end

	frozen deep_twin: GAME_JOYSTICK
			-- New object structure recursively duplicated from Current.
			-- (from ANY)
		external
			"built_in"
		ensure -- from ANY
			deep_twin_not_void: Result /= Void
			deep_equal: deep_equal (Current, Result)
		end

	frozen standard_clone (other: detachable ANY): like other
		obsolete "Use `standard_twin' instead. [2017-05-31]"
			-- Void if other is void; otherwise new object
			-- field-by-field identical to other.
			-- Always uses default copying semantics.
			-- (from ANY)
		do
			if other /= Void then
				Result := other.standard_twin
			end
		ensure -- from ANY
			instance_free: class
			equal: standard_equal (Result, other)
		end

	frozen standard_copy (other: GAME_JOYSTICK)
			-- Copy every field of other onto corresponding field
			-- of current object.
			-- (from ANY)
		require -- from ANY
			other_not_void: other /= Void
			type_identity: same_type (other)
		external
			"built_in"
		ensure -- from ANY
			is_standard_equal: standard_is_equal (other)
		end

	frozen standard_twin: GAME_JOYSTICK
			-- New object field-by-field identical to other.
			-- Always uses default copying semantics.
			-- (from ANY)
		external
			"built_in"
		ensure -- from ANY
			standard_twin_not_void: Result /= Void
			equal: standard_equal (Result, Current)
		end

	frozen twin: GAME_JOYSTICK
			-- New object equal to Current
			-- twin calls copy; to change copying/twinning semantics, redefine copy.
			-- (from ANY)
		external
			"built_in"
		ensure -- from ANY
			twin_not_void: Result /= Void
			is_equal: Result ~ Current
		end
	
feature -- Basic operations

	frozen as_attached: attached GAME_JOYSTICK
		obsolete "Remove calls to this feature. [2017-05-31]"
			-- Attached version of Current.
			-- (Can be used during transitional period to convert
			-- non-void-safe classes to void-safe ones.)
			-- (from ANY)
		do
			Result := Current
		end

	frozen default: detachable GAME_JOYSTICK
			-- Default value of object's type
			-- (from ANY)
		do
		end

	frozen default_pointer: POINTER
			-- Default value of type POINTER
			-- (Avoid the need to write p.default for
			-- some p of type POINTER.)
			-- (from ANY)
		do
		ensure -- from ANY
			instance_free: class
		end

	default_rescue
			-- Process exception for routines with no Rescue clause.
			-- (Default: do nothing.)
			-- (from ANY)
		do
		end

	frozen do_nothing
			-- Execute a null action.
			-- (from ANY)
		do
		ensure -- from ANY
			instance_free: class
		end
	
feature {GAME_SDL_ANY} -- Implementation

	item: POINTER
			-- Point to the internal C structure of Current
	
feature {NONE} -- Implementation

	axis_motion_actions_internal: detachable ACTION_SEQUENCE [NATURAL_32, NATURAL_8, INTEGER_16]
			-- Internal value of the axis_motion_actions lazy evaluated attribute
			-- (from GAME_JOYSTICK_EVENTS)

	axis_motion_events_callback: PROCEDURE [NATURAL_32, INTEGER_32, NATURAL_8, INTEGER_16]
			-- Callback used to register Current in the events_controller for the
			-- axis_motion_actions ACTION_SEQUENCE
			-- (from GAME_JOYSTICK_EVENTS)

	axis_motion_events_dispatcher (a_timestamp: NATURAL_32; a_joystick_id: INTEGER_32; a_axis_id: NATURAL_8; a_value: INTEGER_16)
			-- The dispatcher receiving event from the axis_motion_events_callback and dispatch them to
			-- the axis_motion_actions ACTION_SEQUENCE
			-- (from GAME_JOYSTICK_EVENTS)
		do
			if a_joystick_id = index and then attached axis_motion_actions_internal as la_actions then
				la_actions.call (a_timestamp, a_axis_id, a_value)
			end
		end

	ball_motion_actions_internal: detachable ACTION_SEQUENCE [NATURAL_32, NATURAL_8, INTEGER_16, INTEGER_16]
			-- Internal value of the ball_motion_actions lazy evaluated attribute
			-- (from GAME_JOYSTICK_EVENTS)

	ball_motion_events_callback: PROCEDURE [NATURAL_32, INTEGER_32, NATURAL_8, INTEGER_16, INTEGER_16]
			-- Callback used to register Current in the events_controller for the
			-- ball_motion_actions ACTION_SEQUENCE
			-- (from GAME_JOYSTICK_EVENTS)

	ball_motion_events_dispatcher (a_timestamp: NATURAL_32; a_joystick_id: INTEGER_32; a_ball_id: NATURAL_8; a_x_relative, a_y_relative: INTEGER_16)
			-- The dispatcher receiving event from the ball_motion_events_callback and dispatch them to
			-- the ball_motion_actions ACTION_SEQUENCE
			-- (from GAME_JOYSTICK_EVENTS)
		do
			if a_joystick_id = index and then attached ball_motion_actions_internal as la_actions then
				la_actions.call (a_timestamp, a_ball_id, a_x_relative, a_y_relative)
			end
		end

	button_pressed_actions_internal: detachable ACTION_SEQUENCE [NATURAL_32, NATURAL_8]
			-- Internal value of the button_pressed_actions lazy evaluated attribute
			-- (from GAME_JOYSTICK_EVENTS)

	button_pressed_events_callback: PROCEDURE [NATURAL_32, INTEGER_32, NATURAL_8]
			-- Callback used to register Current in the events_controller for the
			-- button_pressed_actions ACTION_SEQUENCE
			-- (from GAME_JOYSTICK_EVENTS)

	button_pressed_events_dispatcher (a_timestamp: NATURAL_32; a_joystick_id: INTEGER_32; a_button_id: NATURAL_8)
			-- The dispatcher receiving event from the button_pressed_events_callback and dispatch them to
			-- the button_pressed_actions ACTION_SEQUENCE
			-- (from GAME_JOYSTICK_EVENTS)
		do
			if a_joystick_id = index and then attached button_pressed_actions_internal as la_actions then
				la_actions.call (a_timestamp, a_button_id)
			end
		end

	button_released_actions_internal: detachable ACTION_SEQUENCE [NATURAL_32, NATURAL_8]
			-- Internal value of the button_released_actions lazy evaluated attribute
			-- (from GAME_JOYSTICK_EVENTS)

	button_released_events_callback: PROCEDURE [NATURAL_32, INTEGER_32, NATURAL_8]
			-- Callback used to register Current in the events_controller for the
			-- button_released_actions ACTION_SEQUENCE
			-- (from GAME_JOYSTICK_EVENTS)

	button_released_events_dispatcher (a_timestamp: NATURAL_32; a_joystick_id: INTEGER_32; a_button_id: NATURAL_8)
			-- The dispatcher receiving event from the button_released_events_callback and dispatch them to
			-- the button_released_actions ACTION_SEQUENCE
			-- (from GAME_JOYSTICK_EVENTS)
		do
			if a_joystick_id = index and then attached button_released_actions_internal as la_actions then
				la_actions.call (a_timestamp, a_button_id)
			end
		end

	clear_error
			-- Remove error pending in Current
			-- (from GAME_SDL_ANY)
		require -- from  GAME_ERROR_MANAGER
			True
		do
			{GAME_SDL_EXTERNAL}.sdl_clearerror
			Precursor {GAME_ERROR_MANAGER}
			is_manual_error := False
		ensure -- from GAME_ERROR_MANAGER
			no_error: not has_error
		ensure then -- from GAME_SDL_ANY
			no_error: not is_manual_error
		end

	disable_print_on_error
			-- Desactive the print_on_error functionnality.
			-- (from GAME_ERROR_MANAGER)
		do
			Print_on_error_internal.put (False)
		end

	enable_print_on_error
			-- Active the print_on_error functionnality.
			-- (from GAME_ERROR_MANAGER)
		do
			Print_on_error_internal.put (True)
		end

	hat_motion_actions_internal: detachable ACTION_SEQUENCE [NATURAL_32, NATURAL_8, GAME_JOYSTICK_HAT_STATE]
			-- Internal value of the hat_motion_actions lazy evaluated attribute
			-- (from GAME_JOYSTICK_EVENTS)

	hat_motion_events_callback: PROCEDURE [NATURAL_32, INTEGER_32, NATURAL_8, NATURAL_8]
			-- Callback used to register Current in the events_controller for the
			-- hat_motion_actions ACTION_SEQUENCE
			-- (from GAME_JOYSTICK_EVENTS)

	hat_motion_events_dispatcher (a_timestamp: NATURAL_32; a_joystick_id: INTEGER_32; a_hat_id, a_value: NATURAL_8)
			-- The dispatcher receiving event from the hat_motion_events_callback and dispatch them to
			-- the hat_motion_actions ACTION_SEQUENCE
			-- (from GAME_JOYSTICK_EVENTS)
		do
			if a_joystick_id = index and then attached hat_motion_actions_internal as la_actions then
				la_actions.call (a_timestamp, a_hat_id, create {GAME_JOYSTICK_HAT_STATE}.make (a_value))
			end
		end

	internal_game_library: detachable GAME_LIBRARY_CONTROLLER
			-- Assign to this attribute prior to use Game_library to inject a specific GAME_LIBRARY_CONTROLLER singleton.
			-- (from GAME_LIBRARY_SHARED)

	internal_haptic_controller: detachable GAME_HAPTIC_JOYSTICK
			-- Value of the lazy evaluated attribute haptic_controller

	is_manual_error: BOOLEAN
			-- Is the current pending error is a manual error (using manual_error as message)
			-- (from GAME_SDL_ANY)

	manage_error_boolean (a_boolean: BOOLEAN; a_message: READABLE_STRING_GENERAL)
			-- Create an error if a_boolean is false.
			-- If there is an error, append a_message to the error message
			-- on the SDL2 library
			-- (from GAME_SDL_ANY)
		do
			if not a_boolean then
				if Print_on_error_internal.item then
					Io.Error.put_string (a_message.to_string_8 + "%N");
					Io.Error.put_string (last_error.to_string_8 + "%N")
				end
				has_error := True
			end
		ensure -- from GAME_SDL_ANY
				not a_boolean implies has_error
		end

	manage_error_code (a_error_code: INTEGER_32; a_message: READABLE_STRING_GENERAL)
			-- If needed create an error depending of the error code a_code.
			-- If there is an error, append a_message to the error message
			-- on the SDL2 library
			-- (from GAME_SDL_ANY)
		do
			if a_error_code < 0 then
				if Print_on_error_internal.item then
					Io.Error.put_string (a_message.to_string_8 + "%N");
					Io.Error.put_string (last_error.to_string_8 + "%N")
				end
				has_error := True
			end
		end

	manage_error_pointer (a_pointer: POINTER; a_message: READABLE_STRING_GENERAL)
			-- Create an error if a_pointer is not valid.
			-- If there is an error, append a_message to the error message
			-- on the SDL2 library
			-- (from GAME_SDL_ANY)
		do
			if a_pointer.is_default_pointer then
				if Print_on_error_internal.item then
					Io.Error.put_string (a_message.to_string_8 + "%N");
					Io.Error.put_string (last_error.to_string_8 + "%N")
				end
				has_error := True
			end
		ensure -- from GAME_SDL_ANY
				a_pointer.is_default_pointer implies has_error
		end

	manual_error: detachable READABLE_STRING_GENERAL
			-- The specific message for the last error
			-- (from GAME_ERROR_MANAGER)

	print_on_error: BOOLEAN
			-- When an error occured, the library will print
			-- informations about the error on the error console
			-- output (default is True).
			-- (from GAME_ERROR_MANAGER)
		do
			Result := Print_on_error_internal.item
		end

	Print_on_error_internal: CELL [BOOLEAN]
			-- True when an error occured,
			-- The library will print it right away.
			-- (from GAME_ERROR_MANAGER)
		once ("PROCESS")
			create Result.put (True)
		end

	put_manual_error (a_general_message, a_specific_error: READABLE_STRING_GENERAL)
			-- Create an error using a_general_error for the debug information
			-- and a_specific_error for the lasting information
			-- (from GAME_SDL_ANY)
		do
			is_manual_error := True
			Precursor {GAME_ERROR_MANAGER} (a_general_message, a_specific_error)
		ensure -- from GAME_ERROR_MANAGER
				has_error
		end

	removed_events_dispatcher (a_timestamp: NATURAL_32; a_joystick_id: INTEGER_32)
			-- The dispatcher receiving event from the removed_events_callback and dispatch them to
			-- the removed_actions ACTION_SEQUENCE
			-- (from GAME_JOYSTICK_EVENTS)
		do
			if a_joystick_id = index and then attached removed_actions_internal as la_actions then
				la_actions.call (a_timestamp)
			end
		end

	set_print_on_error (a_value: BOOLEAN)
			-- Assign to print_on_error the value of a_value
			-- (from GAME_ERROR_MANAGER)
		do
			if a_value then
				enable_print_on_error
			else
				disable_print_on_error
			end
		ensure -- from GAME_ERROR_MANAGER
			is_assign: print_on_error ~ a_value
		end
	
feature -- Implementation

	dispose
			-- <Pecursor>
		do
			if not item.is_default_pointer then
				{GAME_SDL_EXTERNAL}.sdl_joystickclose (item)
			end
		end
	
feature {GAME_LIBRARY_CONTROLLER} -- Implementation

	internal_close
			-- Close Current (Free internal structure).
		do
			if attached internal_haptic_controller as la_internal_haptic_controller and then la_internal_haptic_controller.is_open then
				la_internal_haptic_controller.close
			end
			{GAME_SDL_EXTERNAL}.sdl_joystickclose (item)
			create item
		end

	open_index: INTEGER_32 assign set_open_index
			-- The internal index usedby open

	remove
			-- set is_removed to True
		do
			is_removed := True
		ensure
			is_removed_set: is_removed
		end

	set_open_index (a_index: INTEGER_32)
			-- Assign a_index to open_index
		do
			open_index := a_index
		ensure
			is_assign: open_index = a_index
		end
	
feature {GAME_LIBRARY_CONTROLLER} -- Implementation

	removed_actions_internal: detachable ACTION_SEQUENCE [NATURAL_32]
			-- Internal value of the removed_actions lazy evaluated attribute
			-- (from GAME_JOYSTICK_EVENTS)
	
feature {NONE} -- Initialisation

	make_events
			-- Initialization of Current
			-- (from GAME_JOYSTICK_EVENTS)
		do
			axis_motion_events_callback := agent (a_timestamp: NATURAL_32; a_joystick_id: INTEGER_32; a_axis_id: NATURAL_8; a_value: INTEGER_16)
				do
					axis_motion_events_dispatcher (a_timestamp, a_joystick_id, a_axis_id, a_value)
				end
			ball_motion_events_callback := agent (a_timestamp: NATURAL_32; a_joystick_id: INTEGER_32; a_ball_id: NATURAL_8; a_x_relative, a_y_relative: INTEGER_16)
				do
					ball_motion_events_dispatcher (a_timestamp, a_joystick_id, a_ball_id, a_x_relative, a_y_relative)
				end
			hat_motion_events_callback := agent (a_timestamp: NATURAL_32; a_joystick_id: INTEGER_32; a_hat_id, a_value: NATURAL_8)
				do
					hat_motion_events_dispatcher (a_timestamp, a_joystick_id, a_hat_id, a_value)
				end
			button_pressed_events_callback := agent (a_timestamp: NATURAL_32; a_joystick_id: INTEGER_32; a_button_id: NATURAL_8)
				do
					button_pressed_events_dispatcher (a_timestamp, a_joystick_id, a_button_id)
				end
			button_released_events_callback := agent (a_timestamp: NATURAL_32; a_joystick_id: INTEGER_32; a_button_id: NATURAL_8)
				do
					button_released_events_dispatcher (a_timestamp, a_joystick_id, a_button_id)
				end
			Precursor {GAME_EVENTS}
		ensure -- from GAME_EVENTS
			make_event_is_running: is_events_running
		end
	
feature -- Output

	Io: STD_FILES
			-- Handle to standard file setup
			-- (from ANY)
		once
			create Result;
			Result.set_output_default
		ensure -- from ANY
			instance_free: class
			io_not_void: Result /= Void
		end

	out: STRING_8
			-- New string containing terse printable representation
			-- of current object
			-- (from ANY)
		do
			Result := tagged_out
		ensure -- from ANY
			out_not_void: Result /= Void
		end

	print (o: detachable ANY)
			-- Write terse external representation of o
			-- on standard output.
			-- (from ANY)
		local
			s: READABLE_STRING_8
		do
			if attached o then
				s := o.out
				if attached {READABLE_STRING_32} s as s32 then
					Io.put_string_32 (s32)
				elseif attached {READABLE_STRING_8} s as s8 then
					Io.put_string (s8)
				else
					Io.put_string_32 (s.as_string_32)
				end
			end
		ensure -- from ANY
			instance_free: class
		end

	frozen tagged_out: STRING_8
			-- New string containing terse printable representation
			-- of current object
			-- (from ANY)
		external
			"built_in"
		ensure -- from ANY
			tagged_out_not_void: Result /= Void
		end
	
feature -- Platform

	Operating_environment: OPERATING_ENVIRONMENT
			-- Objects available from the operating system
			-- (from ANY)
		once
			create Result
		ensure -- from ANY
			instance_free: class
			operating_environment_not_void: Result /= Void
		end
	
feature {NONE} -- Retrieval

	frozen internal_correct_mismatch
			-- Called from runtime to perform a proper dynamic dispatch on correct_mismatch
			-- from MISMATCH_CORRECTOR.
			-- (from ANY)
		local
			l_msg: STRING_32
			l_exc: EXCEPTIONS
		do
			if attached {MISMATCH_CORRECTOR} Current as l_corrector then
				l_corrector.correct_mismatch
			else
				create l_msg.make_from_string ("Mismatch: ".as_string_32)
				create l_exc;
				l_msg.append (generating_type.name_32);
				l_exc.raise_retrieval_exception (l_msg)
			end
		end
	
invariant
		-- from ANY
	reflexive_equality: standard_is_equal (Current)
	reflexive_conformance: conforms_to (Current)

end -- class GAME_JOYSTICK

Generated by ISE EiffelStudio