input_generator: add a API to set touch count

[platform/core/api/efl-util.git] / include / efl_util.h

diff --git a/include/efl_util.h b/include/efl_util.h
index 981c4e4..a4d902f 100644 (file)
--- a/include/efl_util.h
+++ b/include/efl_util.h
@@ -341,6 +341,25 @@ API efl_util_inputgen_h efl_util_input_initialize_generator_with_sync(unsigned i
 
 /**
    * @platform
+   * @brief Requests to set the maximum touch count.
+   * @since_tizen 6.5
+   * @privlevel platform
+   * @privilege %http://tizen.org/privilege/inputgenerator
+   * @remarks If you would like to generate more touch count supported than the display server supports,
+              you can use this API to increase the maximum touch count.
+              Note that this API returns success only when there is no configuration enabled
+              about maximum touch count in the display server.
+   * @param[in] max_count The maximum number of touches want to generate.
+   * @return @c 0 on success, otherwise a negative error value
+   * @retval #EFL_UTIL_ERROR_NONE Successful
+   * @retval #EFL_UTIL_ERROR_INVALID_PARAMETER Invalid parameter
+   * @retval #EFL_UTIL_ERROR_PERMISSION_DENIED Has no permission to deinitialize input generator
+   * @retval #EFL_UTIL_ERROR_NO_RESOURCE_AVAILABLE Resource is not available
+   */
+API int efl_util_input_set_touch_count(int max_count);
+
+/**
+   * @platform
    * @brief Deinitializes system and close opened devices.
    * @since_tizen @if WEARABLE 3.0 @else 2.4 @endif
    * @privlevel platform