Generate touch and key events.

Required Header

#include <efl_util.h>

Overview

The EFL UTIL API provides functions to initialize/deinitialize input devices and to generation touch / key events.

Functions
efl_util_inputgen_h	efl_util_input_initialize_generator (unsigned int dev_type)
	Initializes system and check input generate functions are supported, open devices generated events.
efl_util_inputgen_h	efl_util_input_initialize_generator_with_name (unsigned int dev_type, const char *name)
	Initializes system, check input generate functions are supported and then open events generator devices with given name.
efl_util_inputgen_h	efl_util_input_initialize_generator_with_sync (unsigned int dev_type, const char *name)
	Initializes the system, checks if input generated functions are supported and then open events generator devices synchronously.
int	efl_util_input_deinitialize_generator (efl_util_inputgen_h inputgen_h)
	Deinitializes system and close opened devices.
int	efl_util_input_generate_key (efl_util_inputgen_h inputgen_h, const char *key_name, int pressed)
	Generates all of key events using a opened device.
int	efl_util_input_generate_touch (efl_util_inputgen_h inputgen_h, int idx, efl_util_input_touch_type_e touch_type, int x, int y)
	Generates a touch event using a opened device.
int	efl_util_input_generate_pointer (efl_util_inputgen_h inputgen_h, int buttons, efl_util_input_pointer_type_e pointer_type, int x, int y)
	Generate a pointer event using a opened device.
Typedefs
typedef struct _efl_util_inputgen_h *	efl_util_inputgen_h
	Definition for the input generator handle.

Typedef Documentation

typedef struct _efl_util_inputgen_h* efl_util_inputgen_h

Definition for the input generator handle.

Warning:: This is not for use by third-party applications.

Since :: 2.4

Enumeration Type Documentation

enum efl_util_input_device_type_e

Enumeration of device type generated events.

Warning:: This is not for use by third-party applications.

Since :: 2.4

Enumerator:

EFL_UTIL_INPUT_DEVTYPE_NONE	(Deprecated since 3.0.)
EFL_UTIL_INPUT_DEVTYPE_TOUCHSCREEN	Touch Screen device
EFL_UTIL_INPUT_DEVTYPE_KEYBOARD	Keyboard device
EFL_UTIL_INPUT_DEVTYPE_POINTER	Mouse device (Since 3.0)
EFL_UTIL_INPUT_DEVTYPE_ALL	Both of touch screen and keyboard device (Deprecated since 3.0. Check all enumerations using OR operand instead)
EFL_UTIL_INPUT_DEVTYPE_MAX	(Deprecated since 3.0.)

enum efl_util_input_pointer_type_e

Enumeration of pointer event types.

Warning:: This is not for use by third-party applications.

Since :: 3.0

Enumerator:

EFL_UTIL_INPUT_POINTER_BUTTON_DOWN	Mouse button press.
EFL_UTIL_INPUT_POINTER_BUTTON_UP	Mouse move.
EFL_UTIL_INPUT_POINTER_MOVE	Mouse button release.

enum efl_util_input_touch_type_e

Enumeration of touch event types.

Warning:: This is not for use by third-party applications.

Since :: 2.4

Enumerator:

EFL_UTIL_INPUT_TOUCH_NONE	(Deprecated since 3.0.)
EFL_UTIL_INPUT_TOUCH_BEGIN	Finger press. It is same a behavior put your finger on touch screen
EFL_UTIL_INPUT_TOUCH_UPDATE	Finger move. It is same a behavior move your finger on touch screen
EFL_UTIL_INPUT_TOUCH_END	Finger release. It is same a behavior release your finger on touch screen
EFL_UTIL_INPUT_TOUCH_MAX	(Deprecated since 3.0.)

Function Documentation

int efl_util_input_deinitialize_generator ( efl_util_inputgen_h inputgen_h )

Deinitializes system and close opened devices.

Warning:: This is not for use by third-party applications.

Since :: 2.4

Privilege Level:: platform

Privilege:: http://tizen.org/privilege/inputgenerator

Parameters:

[in] inputgen_h The efl_util_inputgen_h handle

Returns:: 0 on success, otherwise a negative error value

Return values:

EFL_UTIL_ERROR_NONE	Successful
EFL_UTIL_ERROR_INVALID_PARAMETER	Invalid parameter

See also:: efl_util_input_initialize_generator()

int efl_util_input_generate_key	(	efl_util_inputgen_h	inputgen_h,
		const char *	key_name,
		int	pressed
	)

Generates all of key events using a opened device.

Warning:: This is not for use by third-party applications.

Since :: 2.4

Privilege Level:: platform

Privilege:: http://tizen.org/privilege/inputgenerator

Parameters:

[in]	inputgen_h	The efl_util_inputgen_h handle
[in]	key_name	The key name want to generate
[in]	pressed	The value that select key press or release (0: release, 1: press)

Returns:: 0 on success, otherwise a negative error value

Return values:

EFL_UTIL_ERROR_NONE	Successful
EFL_UTIL_ERROR_INVALID_PARAMETER	Invalid parameter
EFL_UTIL_ERROR_PERMISSION_DENIED	Has no permission to generate key

int efl_util_input_generate_pointer	(	efl_util_inputgen_h	inputgen_h,
		int	buttons,
		efl_util_input_pointer_type_e	pointer_type,
		int	x,
		int	y
	)

Generate a pointer event using a opened device.

Warning:: This is not for use by third-party applications.

Since :: 3.0

Privilege Level:: platform

Privilege:: http://tizen.org/privilege/inputgenerator

Parameters:

[in]	inputgen_h	The efl_util_inputgen_h handle
[in]	buttons	The number of button
[in]	pointer_type	The pointer type (ex> EFL_UTIL_INPUT_POINTER_BUTTON_PRESS, EFL_UTIL_INPUT_POINTER_BUTTON_UP, EFL_UTIL_INPUT_POINTER_MOVE)
[in]	x	x coordination to move
[in]	y	y coordination to move

Returns:: 0 on success, otherwise a negative error value

Return values:

EFL_UTIL_ERROR_NONE	Successful
EFL_UTIL_ERROR_INVALID_PARAMETER	Invalid parameter
EFL_UTIL_ERROR_PERMISSION_DENIED	Has no permission to generate pointer
EFL_UTIL_ERROR_NO_SUCH_DEVICE	No such device or address
EFL_UTIL_ERROR_OUT_OF_MEMORY	Memory allocation failure

int efl_util_input_generate_touch	(	efl_util_inputgen_h	inputgen_h,
		int	idx,
		efl_util_input_touch_type_e	touch_type,
		int	x,
		int	y
	)

Generates a touch event using a opened device.

Warning:: This is not for use by third-party applications.

Since :: 2.4

Privilege Level:: platform

Privilege:: http://tizen.org/privilege/inputgenerator

Parameters:

[in]	inputgen_h	The efl_util_inputgen_h handle
[in]	idx	The index of touched finger
[in]	touch_type	The touch type (ex> EFL_UTIL_INPUT_TOUCH_BEGIN, EFL_UTIL_INPUT_TOUCH_UPDATE, EFL_UTIL_INPUT_TOUCH_END)
[in]	x	The x axis of touch point
[in]	y	The y axis of touch point

Returns:: 0 on success, otherwise a negative error value

Return values:

EFL_UTIL_ERROR_NONE	Successful
EFL_UTIL_ERROR_INVALID_PARAMETER	Invalid parameter
EFL_UTIL_ERROR_PERMISSION_DENIED	Has no permission to generate touch

efl_util_inputgen_h efl_util_input_initialize_generator ( unsigned int dev_type )

Initializes system and check input generate functions are supported, open devices generated events.

Warning:: This is not for use by third-party applications.

Since :: 2.4

Privilege Level:: platform

Privilege:: http://tizen.org/privilege/inputgenerator

Remarks:: The specific error code can be obtained using the get_last_result() method. Error codes are described in Exception section.; The dev_type is changed into the unsigned int to perform bitwise operations. (Since 3.0)

Parameters:

[in] dev_type The device type want to generate events (ex> EFL_UTIL_INPUT_DEVTYPE_TOUCHSCREEN | EFL_UTIL_INPUT_DEVTYPE_KEYBOARD)

Returns:: efl_util_inputgen_h on success, otherwise NULL

Return values:

efl_util_inputgen_h The input generator handle

Exceptions:

EFL_UTIL_ERROR_NONE	Successful
EFL_UTIL_ERROR_INVALID_PARAMETER	Invalid parameter
EFL_UTIL_ERROR_NO_SUCH_DEVICE	No such device or address
EFL_UTIL_ERROR_INVALID_OPERATION	Function not implemented
EFL_UTIL_ERROR_OUT_OF_MEMORY	Memory allocation failure

See also:: efl_util_input_deinitialize_generator()

efl_util_inputgen_h efl_util_input_initialize_generator_with_name	(	unsigned int	dev_type,
		const char *	name
	)

Initializes system, check input generate functions are supported and then open events generator devices with given name.

Warning:: This is not for use by third-party applications.

Since :: 4.0

Privilege Level:: platform

Privilege:: http://tizen.org/privilege/inputgenerator

Remarks:: The specific error code can be obtained using the get_last_result() method. Error codes are described in Exception section.; The dev_type is changed into the unsigned int to perform bitwise operations.

Parameters:

[in]	dev_type	The device type want to generate events (ex> EFL_UTIL_INPUT_DEVTYPE_TOUCHSCREEN \| EFL_UTIL_INPUT_DEVTYPE_KEYBOARD)
[in]	name	The device name (maximum 31 characters)

Returns:: efl_util_inputgen_h on success, otherwise NULL

Return values:

efl_util_inputgen_h The input generator handle

Exceptions:

EFL_UTIL_ERROR_NONE	Successful
EFL_UTIL_ERROR_INVALID_PARAMETER	Invalid parameter
EFL_UTIL_ERROR_NO_SUCH_DEVICE	No such device or address
EFL_UTIL_ERROR_INVALID_OPERATION	Function not implemented
EFL_UTIL_ERROR_OUT_OF_MEMORY	Memory allocation failure

See also:: efl_util_input_deinitialize_generator()

efl_util_inputgen_h efl_util_input_initialize_generator_with_sync	(	unsigned int	dev_type,
		const char *	name
	)

Initializes the system, checks if input generated functions are supported and then open events generator devices synchronously.

Warning:: This is not for use by third-party applications.

Since :: 5.0

Privilege Level:: platform

Privilege:: http://tizen.org/privilege/inputgenerator

Remarks:: The specific error code can be obtained using the get_last_result() method. Error codes are described in Exception section.; dev_type is changed into the unsigned int to perform bitwise operations.; If the name is NULL, it will be set to "Input Generator"; The returned object should be released with efl_util_input_deinitialize_generator().

Parameters:

[in]	dev_type	The device type to generate events, values of efl_util_input_device_type_e combined with bitwise 'or' Example: EFL_UTIL_INPUT_DEVTYPE_TOUCHSCREEN \| EFL_UTIL_INPUT_DEVTYPE_KEYBOARD
[in]	name	The device name (maximum 31 characters, can be NULL)

Returns:: efl_util_inputgen_h on success, otherwise NULL

Return values:

efl_util_inputgen_h The input generator handle

Exceptions:

EFL_UTIL_ERROR_NONE	Successful
EFL_UTIL_ERROR_INVALID_PARAMETER	Invalid parameter
EFL_UTIL_ERROR_NO_SUCH_DEVICE	No such device or address
EFL_UTIL_ERROR_INVALID_OPERATION	Function not implemented
EFL_UTIL_ERROR_OUT_OF_MEMORY	Memory allocation failure
EFL_UTIL_ERROR_PERMISSION_DENIED	Has no permission to initialize input generator

See also:: efl_util_input_deinitialize_generator()

Required Header

Overview

Functions

Typedefs

Typedef Documentation

Enumeration Type Documentation

Function Documentation