New 1.12 API: elm_process_state_get

TODO

@@ -44,3 +44,4 @@ Elm
    - video
    - web
    - window ?
+* How are the ecore events managed? for example: ELM_EVENT_PROCESS_FOREGROUND

efl/elementary/enums.pxd

@@ -417,6 +417,10 @@ cdef extern from "Elementary.h":
         ELM_POPUP_ORIENT_BOTTOM_RIGHT
         ELM_POPUP_ORIENT_LAST
 
+    ctypedef enum Elm_Process_State:
+        ELM_PROCESS_STATE_FOREGROUND
+        ELM_PROCESS_STATE_BACKGROUND
+
     ctypedef enum Elm_Scroller_Policy:
         ELM_SCROLLER_POLICY_AUTO
         ELM_SCROLLER_POLICY_ON

efl/elementary/general.pxd

@@ -19,7 +19,8 @@
 from efl.evas cimport Eina_List, Eina_Bool
 from efl.evas cimport Evas_Object, Evas_Font_Size, Evas_Coord
 from efl.evas.enums cimport Evas_Callback_Type
-from enums cimport Elm_Sys_Notify_Closed_Reason, Elm_Sys_Notify_Urgency
+from enums cimport Elm_Sys_Notify_Closed_Reason, Elm_Sys_Notify_Urgency, \
+    Elm_Process_State
 
 cdef extern from "time.h":
     struct tm:
@@ -81,6 +82,7 @@ cdef extern from "Elementary.h":
     int                     elm_shutdown()
     void                    elm_run() nogil
     void                    elm_exit()
+    Elm_Process_State       elm_process_state_get()
 
     # General - Quicklaunch (XXX: Only used by macros?)
     # void                     elm_quicklaunch_init(int argc, char **argv)

efl/elementary/general.pyx

@@ -117,6 +117,25 @@ Possible values for the #ELM_POLICY_THROTTLE policy.
     Never throttle when windows are all hidden, regardless of config settings.
 
 
+.. _Elm_Process_State:
+
+Elm_Process_State
+-----------------
+
+.. data:: ELM_PROCESS_STATE_FOREGROUND
+
+    The process is in a foreground/active/running state - work as normal.
+
+    ..versionadded:: 1.12
+
+.. data:: ELM_PROCESS_STATE_BACKGROUND
+
+    The process is in the bacgkround, so you may want to stop animating,
+    fetching data as often etc.
+
+    ..versionadded:: 1.12
+
+
 .. _Elm_Sys_Notify_Closed_Reason:
 
 Notify close reasons
@@ -270,6 +289,9 @@ ELM_GLOB_MATCH_PATH = enums.ELM_GLOB_MATCH_PATH
 ELM_GLOB_MATCH_PERIOD = enums.ELM_GLOB_MATCH_PERIOD
 ELM_GLOB_MATCH_NOCASE = enums.ELM_GLOB_MATCH_NOCASE
 
+ELM_PROCESS_STATE_FOREGROUND = enums.ELM_PROCESS_STATE_FOREGROUND
+ELM_PROCESS_STATE_BACKGROUND = enums.ELM_PROCESS_STATE_BACKGROUND
+
 import traceback
 
 cdef void py_elm_sys_notify_send_cb(void *data, unsigned int id):
@@ -508,6 +530,22 @@ def policy_get(Elm_Policy policy):
     """
     return elm_policy_get(policy)
 
+def process_state_get():
+    """Get the process state as a while.
+
+    The process may logically be some runnable state. a "foreground" application
+    runs as normal and may be user-visible or "active" in some way. A
+    background application is not user-visible or otherwise important and
+    likely should release resources and not wake up often or process much.
+
+    :return: The current process state
+    :rtype: Elm_Process_State
+
+    .. versionadded: 1.12
+
+    """
+    return elm_process_state_get()
+
 def coords_finger_size_adjust(int times_w, int w, int times_h, int h):
     """Adjust size of an element for finger usage.