basic lttvwindow works
[lttv.git] / ltt / branches / poly / doc / developer / lttvwindow_events_delivery.txt
index 9016eff0a612af291898d28f18d653281aca4dcc..a3a785f5f5a563bd561fb51ec47c0a476a5f94cd 100644 (file)
@@ -131,7 +131,7 @@ removing hooks for the different time intervals requested. That means that hooks
 insertion and removal will be done between each traceset processing based on
 the time intervals and event positions related to each hook. We must therefore
 provide a simple interface for hooks passing between the viewers and the main
-window, make them easier to manage from the main window. A modification to the
+window, making them easier to manage from the main window. A modification to the
 LttvHooks type solves this problem.
 
 
@@ -170,10 +170,10 @@ destroyed.
 
 Permitted GTK Events Between Chunks
 
-All GTK Events will be enabled between chunks. This is due to the fact that the
-background processing and a high priority request are seen as the same case.
-While a background processing is in progress, the whole graphical interface must
-be enabled.
+All GTK Events will be enabled between chunks. A viewer could ask for a
+long computation that has no impact on the display : in that case, it is
+necessary to keep the graphical interface active. While a processing is in
+progress, the whole graphical interface must be enabled.
 
 We needed to deal with the coherence of background processing and diverse GTK
 events anyway. This algorithm provides a generalized way to deal with any type
@@ -182,18 +182,9 @@ of request and any GTK events.
 
 Background Computation Request
 
-The types of background computation that can be requested by a viewer : state
-computation (main window scope) or viewer specific background computation.
-
-A background computation request is asked via lttvwindow_events_request, with a
-priority field set with a low priority.
-
-In the case of a background computation with viewer pointer field set to NULL,
-if a lttvwindow_events_request_remove_all is done on the viewer pointer, it will
-not affect the state computation as no viewer pointer will have been passed in
-the initial request. This is the expected result. For the background processings
-that call viewer's hooks, they will be removed.
-
+A background computation has a trace scope, and is therefore not linked to a
+main window. It is not detailed in this document. 
+see requests_servicing_schedulers.txt
 
 A New "Redraw" Button
 
@@ -254,31 +245,29 @@ registered. The viewer can access this structure during the read as its
 hook_data. Only the stop_flag can be changed by the viewer through the
 event hooks.
 
-typedef LttvEventsRequestPrio guint;
-
 typedef struct _EventsRequest {
   gpointer                     owner;           /* Owner of the request     */
   gpointer                     viewer_data;     /* Unset : NULL             */
   gboolean                     servicing;       /* service in progress: TRUE */ 
-  LttvEventsRequestPrio        prio;            /* Ev. Req. priority        */
   LttTime                      start_time;/* Unset : { G_MAXUINT, G_MAXUINT }*/
   LttvTracesetContextPosition *start_position;  /* Unset : NULL             */
   gboolean                     stop_flag;       /* Continue:TRUE Stop:FALSE */
   LttTime                      end_time;/* Unset : { G_MAXUINT, G_MAXUINT } */
   guint                        num_events;      /* Unset : G_MAXUINT        */
   LttvTracesetContextPosition *end_position;    /* Unset : NULL             */
-  LttvHooks                   *before_traceset; /* Unset : NULL             */
-  LttvHooks                   *before_trace;    /* Unset : NULL             */
-  LttvHooks                   *before_tracefile;/* Unset : NULL             */
+  LttvHooks                   *before_chunk_traceset; /* Unset : NULL       */
+  LttvHooks                   *before_chunk_trace;    /* Unset : NULL       */
+  LttvHooks                   *before_chunk_tracefile;/* Unset : NULL       */
   LttvHooks                   *event;           /* Unset : NULL             */
   LttvHooksById               *event_by_id;     /* Unset : NULL             */
-  LttvHooks                   *after_tracefile; /* Unset : NULL             */
-  LttvHooks                   *after_trace;     /* Unset : NULL             */
-  LttvHooks                   *after_traceset;  /* Unset : NULL             */
+  LttvHooks                   *after_chunk_tracefile; /* Unset : NULL       */
+  LttvHooks                   *after_chunk_trace;     /* Unset : NULL       */
+  LttvHooks                   *after_chunk_traceset;  /* Unset : NULL       */
   LttvHooks                   *before_request;  /* Unset : NULL             */
-  LttvHooks                   *after_request    /* Unset : NULL             */
+  LttvHooks                   *after_request;   /* Unset : NULL             */
 } EventsRequest;
 
+
 - lttvwindow_events_request_remove_all
 
 It removes all the events requests from the pool that has their "owner" field
@@ -319,11 +308,7 @@ list_in : empty
 list_out : many events requests
 
 
-// NOT A. While (list_in !empty or list_out !empty) and !GTK Event pending
-
-We do this once, go back to GTK, then get called again...
-We remove the g_idle function when list_in and list_out are empty
-
+A. While (list_in !empty or list_out !empty) and !GTK Event pending
   1. If list_in is empty (need a seek)
     1.1 Add requests to list_in
       1.1.1 Find all time requests with lowest start time in list_out (ltime)
@@ -343,23 +328,17 @@ We remove the g_idle function when list_in and list_out are empty
       1.3.1 If !servicing
           - begin request hooks called
           - servicing = TRUE
-      1.3.2 call before_traceset
+      1.3.2 call before chunk
       1.3.3 events hooks added
   2. Else, list_in is not empty, we continue a read
     2.1 For each req of list_out
     - if req.start time == current context time
+              or req.start position == current position
       - Add to list_in, remove from list_out
       - If !servicing
-        - Call begin request
-        - servicing = TRUE
-      - Call before_traceset
-      - events hooks added
-    - if req.start position == current position
-      - Add to list_in, remove from list_out
-      - If !servicing
-        - Call begin request
+        - Call before request
         - servicing = TRUE
-      - Call before_traceset
+      - Call before chunk
       - events hooks added
 
   3. Find end criterions
@@ -374,7 +353,7 @@ We remove the g_idle function when list_in and list_out are empty
     3.3 End position
       3.3.1 Find lowest end position in list_in
       3.3.2 Find lowest start position in list_out (>= than current
-                                                    position)
+                                                    position *not used)
       3.3.3 Use lowest of both as end position
 
   4. Call process traceset middle
@@ -384,39 +363,28 @@ We remove the g_idle function when list_in and list_out are empty
     - if current context time > traceset.end time
       - For each req in list_in
         - Remove events hooks for req
-        - Call end traceset for req
+        - Call end chunk for req
         - Call end request for req
         - remove req from list_in
     5.1 For each req in list_in
+          - Call end chunk for req
+          - Remove events hooks for req
           - req.num -= count
-          - if req.num == 0
-            - Remove events hooks for req
-            - Call end traceset for req
-            - Call end request for req
-            - remove req from list_in
-          - if current context time > req.end time
-            - Remove events hooks for req
-            - Call end traceset for req
-            - Call end request for req
-            - remove req from list_in
-          - if req.end pos == current pos
-            - Remove events hooks for req
-            - Call end traceset for req
-            - Call end request for req
-            - remove req from list_in
-          - if req.stop_flag == TRUE
-            - Remove events hooks for req
-            - Call end traceset for req
+          - if   req.num == 0
+               or
+                 current context time > req.end time
+               or
+                 req.end pos == current pos
+               or
+                 req.stop_flag == TRUE
             - Call end request for req
             - remove req from list_in
 
-B. When interrupted
+B. When interrupted between chunks
   1. for each request in list_in
     1.1. Use current postition as start position
     1.2. Remove start time
-    1.3. Call after_traceset
-    1.4. Remove event hooks
-    1.5. Put it back in list_out
+    1.3. Move from list_in to list_out
 
 
 
@@ -432,16 +400,6 @@ The >= for position is necessary to make ensure consistency between start time
 requests and positions requests that happens to be at the exact same start time
 and position.
 
-We only keep one saved state in memory. If, for example, a low priority
-servicing is interrupted, a high priority is serviced, then the low priority
-will use the saved state to start back where it was instead of seeking to the
-time. In the very specific case where a low priority servicing is interrupted,
-and then a high priority servicing on top of it is also interrupted, well, the
-low priority will loose its state and will have to seek back. It should not
-occur often. The solution to it would be to save one state per priority.
-
-
-
 
 
 
@@ -458,5 +416,3 @@ Strengths
 - Solves all the weaknesses idenfied in the actual boundaryless traceset
 reading.
 
-- Background processing available.
-
This page took 0.025148 seconds and 4 git commands to generate.