Replacing processing word by capture or playback words.

6 files changed, 58 insertions, 61 deletions

diff --git a/docs/user_guide/eye_tracking_context/advanced_topics/context_definition.md b/docs/user_guide/eye_tracking_context/advanced_topics/context_definition.md
index c163696..0702c8e 100644
--- a/docs/user_guide/eye_tracking_context/advanced_topics/context_definition.md
+++ b/docs/user_guide/eye_tracking_context/advanced_topics/context_definition.md
@@ -3,27 +3,27 @@ Define a context class
 
 The [ArContext](../../../argaze.md/#argaze.ArFeatures.ArContext) class defines a generic base class interface to handle incoming eye tracker data before to pass them to a processing pipeline according to [Python context manager feature](https://docs.python.org/3/reference/datamodel.html#context-managers). 
 
-The [ArContext](../../../argaze.md/#argaze.ArFeatures.ArContext) class interface provides playback features to stop or pause processings, performance assement features to measure how many times processings are called and the time spent by the process.
+The [ArContext](../../../argaze.md/#argaze.ArFeatures.ArContext) class interface provides control features to stop or pause working threads, performance assement features to measure how many times processings are called and the time spent by the process.
 
-Besides, there is also a [LiveProcessingContext](../../../argaze.md/#argaze.ArFeatures.LiveProcessingContext) class that inherits from [ArContext](../../../argaze.md/#argaze.ArFeatures.ArContext) and that defines an abstract *calibrate* method to write specific device calibration process.
+Besides, there is also a [DataCaptureContext](../../../argaze.md/#argaze.ArFeatures.DataCaptureContext) class that inherits from [ArContext](../../../argaze.md/#argaze.ArFeatures.ArContext) and that defines an abstract *calibrate* method to write specific device calibration process.
 
-In the same way, there is a [PostProcessingContext](../../../argaze.md/#argaze.ArFeatures.PostProcessingContext) class that inherits from [ArContext](../../../argaze.md/#argaze.ArFeatures.ArContext) and that defines abstract *previous* and *next* playback methods to move into record's frames and also defines *duration* and *progression* properties to get information about a record length and processing advancement.
+In the same way, there is a [DataPlaybackContext](../../../argaze.md/#argaze.ArFeatures.DataPlaybackContext) class that inherits from [ArContext](../../../argaze.md/#argaze.ArFeatures.ArContext) and that defines abstract *previous* and *next* playback methods to move into record's frames and also defines *duration* and *progression* properties to get information about a record length and playback advancement.
 
-Finally, a specific eye tracking context can be defined into a Python file by writing a class that inherits either from [ArContext](../../../argaze.md/#argaze.ArFeatures.ArContext), [LiveProcessingContext](../../../argaze.md/#argaze.ArFeatures.LiveProcessingContext) or [PostProcessingContext](../../../argaze.md/#argaze.ArFeatures.PostProcessingContext) class.
+Finally, a specific eye tracking context can be defined into a Python file by writing a class that inherits either from [ArContext](../../../argaze.md/#argaze.ArFeatures.ArContext), [DataCaptureContext](../../../argaze.md/#argaze.ArFeatures.DataCaptureContext) or [DataPlaybackContext](../../../argaze.md/#argaze.ArFeatures.DataPlaybackContext) class.
 
-## Write live processing context
+## Write data capture context
 
-Here is a live processing context example that processes gaze positions and camera images in two separated threads:
+Here is a data cpature context example that processes gaze positions and camera images in two separated threads:
 
 ```python
 from argaze import ArFeatures, DataFeatures
 
-class LiveProcessingExample(ArFeatures.LiveProcessingContext):
+class DataCaptureExample(ArFeatures.DataCaptureContext):
 
 	@DataFeatures.PipelineStepInit
 	def __init__(self, **kwargs):
 
-		# Init LiveProcessingContext class
+		# Init DataCaptureContext class
 		super().__init__()
 
 		# Init private attribute
@@ -45,23 +45,23 @@ class LiveProcessingExample(ArFeatures.LiveProcessingContext):
 		# Start context according any specific parameter
 		... self.parameter
 
-		# Start a gaze position processing thread
-		self.__gaze_thread = threading.Thread(target = self.__gaze_position_processing)
+		# Start a gaze position capture thread
+		self.__gaze_thread = threading.Thread(target = self.__gaze_position_capture)
 		self.__gaze_thread.start()
 
-		# Start a camera image processing thread if applicable
-		self.__camera_thread = threading.Thread(target = self.__camera_image_processing)
+		# Start a camera image capture thread if applicable
+		self.__camera_thread = threading.Thread(target = self.__camera_image_capture)
 		self.__camera_thread.start()
 
 		return self
 
-	def __gaze_position_processing(self):
-		"""Process gaze position."""
+	def __gaze_position_capture(self):
+		"""Capture gaze position."""
 
-		# Processing loop
+		# Capture loop
 		while self.is_running():
 
-			# Pause processing
+			# Pause capture
 			if not self.is_paused():
 
 				# Assuming that timestamp, x and y values are available
@@ -73,13 +73,13 @@ class LiveProcessingExample(ArFeatures.LiveProcessingContext):
 			# Wait some time eventually
 			...
 
-	def __camera_image_processing(self):
-		"""Process camera image if applicable."""
+	def __camera_image_capture(self):
+		"""Capture camera image if applicable."""
 
-		# Processing loop
+		# Capture loop
 		while self.is_running():
 
-			# Pause processing
+			# Pause capture
 			if not self.is_paused():
 
 				# Assuming that timestamp, camera_image are available
@@ -95,10 +95,10 @@ class LiveProcessingExample(ArFeatures.LiveProcessingContext):
 	def __exit__(self, exception_type, exception_value, exception_traceback):
 		"""End context."""
 		
-		# Stop processing loops
+		# Stop capture loops
 		self.stop()
 
-		# Stop processing threads
+		# Stop capture threads
 		threading.Thread.join(self.__gaze_thread)
 		threading.Thread.join(self.__camera_thread)
 
@@ -108,19 +108,19 @@ class LiveProcessingExample(ArFeatures.LiveProcessingContext):
 		...
 ```
 
-## Write post processing context
+## Write data playback context
 
-Here is a post processing context example that processes gaze positions and camera images in a same thread:
+Here is a data playback context example that reads gaze positions and camera images in a same thread:
 
 ```python
 from argaze import ArFeatures, DataFeatures
 
-class PostProcessingExample(ArFeatures.PostProcessingContext):
+class DataPlaybackExample(ArFeatures.DataPlaybackContext):
 
 	@DataFeatures.PipelineStepInit
 	def __init__(self, **kwargs):
 
-		# Init LiveProcessingContext class
+		# Init DataCaptureContext class
 		super().__init__()
 
 		# Init private attribute
@@ -142,19 +142,19 @@ class PostProcessingExample(ArFeatures.PostProcessingContext):
 		# Start context according any specific parameter
 		... self.parameter
 
-		# Start a reading data thread
-		self.__read_thread = threading.Thread(target = self.__data_reading)
-		self.__read_thread.start()
+		# Start a data playback thread
+		self.__data_thread = threading.Thread(target = self.__data_playback)
+		self.__data_thread.start()
 
 		return self
 
-	def __data_reading(self):
-		"""Process gaze position and camera image if applicable."""
+	def __data_playback(self):
+		"""Playback gaze position and camera image if applicable."""
 
-		# Processing loop
+		# Playback loop
 		while self.is_running():
 
-			# Pause processing
+			# Pause playback
 			if not self.is_paused():
 
 				# Assuming that timestamp, camera_image are available
@@ -176,11 +176,11 @@ class PostProcessingExample(ArFeatures.PostProcessingContext):
 	def __exit__(self, exception_type, exception_value, exception_traceback):
 		"""End context."""
 		
-		# Stop processing loops
+		# Stop playback loop
 		self.stop()
 
-		# Stop processing threads
-		threading.Thread.join(self.__read_thread)
+		# Stop playback threads
+		threading.Thread.join(self.__data_thread)
 
 	def previous(self):
 		"""Go to previous camera image frame."""
diff --git a/docs/user_guide/eye_tracking_context/advanced_topics/scripting.md b/docs/user_guide/eye_tracking_context/advanced_topics/scripting.md
index 8753eb6..d8eb389 100644
--- a/docs/user_guide/eye_tracking_context/advanced_topics/scripting.md
+++ b/docs/user_guide/eye_tracking_context/advanced_topics/scripting.md
@@ -68,12 +68,12 @@ from argaze import ArFeatures
 
     # Check context type
 
-    # Live processing case: calibration method is available
-    if issubclass(type(context), ArFeatures.LiveProcessingContext):
+    # Data capture case: calibration method is available
+    if issubclass(type(context), ArFeatures.DataCaptureContext):
         ...
 
-    # Post processing case: more playback methods are available
-    if issubclass(type(context), ArFeatures.PostProcessingContext):
+    # Data playback case: playback methods are available
+    if issubclass(type(context), ArFeatures.DataPlaybackContext):
         ...
 
     # Check pipeline type
diff --git a/docs/user_guide/eye_tracking_context/configuration_and_execution.md b/docs/user_guide/eye_tracking_context/configuration_and_execution.md
index f13c6a2..e1123fb 100644
--- a/docs/user_guide/eye_tracking_context/configuration_and_execution.md
+++ b/docs/user_guide/eye_tracking_context/configuration_and_execution.md
@@ -3,9 +3,9 @@ Edit and execute context
 
 The [utils.contexts module](../../argaze.md/#argaze.utils.contexts) provides ready-made contexts like:
 
-* [Tobii Pro Glasses 2](context_modules/tobii_pro_glasses_2.md) live stream and post processing contexts,
-* [Pupil Labs](context_modules/pupil_labs.md) live stream context,
-* [OpenCV](context_modules/opencv.md) window cursor position and movie processing,
+* [Tobii Pro Glasses 2](context_modules/tobii_pro_glasses_2.md) data capture and data playback contexts,
+* [Pupil Labs](context_modules/pupil_labs.md) data capture context,
+* [OpenCV](context_modules/opencv.md) window cursor position capture and movie playback,
 * [Random](context_modules/random.md) gaze position generator.
 
 ## Edit JSON configuration
diff --git a/docs/user_guide/eye_tracking_context/context_modules/tobii_pro_glasses_2.md b/docs/user_guide/eye_tracking_context/context_modules/tobii_pro_glasses_2.md
index fba6931..6ff44bd 100644
--- a/docs/user_guide/eye_tracking_context/context_modules/tobii_pro_glasses_2.md
+++ b/docs/user_guide/eye_tracking_context/context_modules/tobii_pro_glasses_2.md
@@ -42,16 +42,16 @@ Read more about [ArContext base class in code reference](../../../argaze.md/#arg
 }
 ```
 
-## Post Processing
+## Segment Playback
 
-::: argaze.utils.contexts.TobiiProGlasses2.PostProcessing
+::: argaze.utils.contexts.TobiiProGlasses2.SegmentPlayback
 
 ### JSON sample
 
 ```json
 {
-    "argaze.utils.contexts.TobiiProGlasses2.PostProcessing" : {
-        "name": "Tobii Pro Glasses 2 post-processing",
+    "argaze.utils.contexts.TobiiProGlasses2.SegmentPlayback" : {
+        "name": "Tobii Pro Glasses 2 segment playback",
         "segment": "./src/argaze/utils/demo/tobii_record/segments/1",
         "pipeline": ...
     }
diff --git a/docs/user_guide/utils/demonstrations_scripts.md b/docs/user_guide/utils/demonstrations_scripts.md
index dd1b8e0..79a9b40 100644
--- a/docs/user_guide/utils/demonstrations_scripts.md
+++ b/docs/user_guide/utils/demonstrations_scripts.md
@@ -11,7 +11,7 @@ Collection of command-line scripts for demonstration purpose.
 
 ## Random context
 
-Load **random_context.json** file to process random gaze positions:
+Load **random_context.json** file to generate random gaze positions:
 
 ```shell
 python -m argaze load ./src/argaze/utils/demo/random_context.json
@@ -19,7 +19,7 @@ python -m argaze load ./src/argaze/utils/demo/random_context.json
 
 ## OpenCV cursor context
 
-Load **opencv_cursor_context.json** file to process cursor pointer positions over OpenCV window:
+Load **opencv_cursor_context.json** file to capture cursor pointer positions over OpenCV window:
 
 ```shell
 python -m argaze load ./src/argaze/utils/demo/opencv_cursor_context.json
@@ -27,7 +27,7 @@ python -m argaze load ./src/argaze/utils/demo/opencv_cursor_context.json
 
 ## OpenCV movie context
 
-Load **opencv_movie_context.json** file to process movie pictures and also cursor pointer positions over OpenCV window:
+Load **opencv_movie_context.json** file to playback movie pictures and also capture cursor pointer positions over OpenCV window:
 
 ```shell
 python -m argaze load ./src/argaze/utils/demo/opencv_movie_context.json
@@ -69,27 +69,24 @@ Then, load **tobii_live_stream_context.json** file to find ArUco marker into cam
 python -m argaze load ./src/argaze/utils/demo/tobii_live_stream_context.json
 ```
 
-### Post-processing context
+### Segment playback context
 
-!!! note
-    This demonstration requires to print **A3_demo.pdf** file located in *./src/argaze/utils/demo/* folder on A3 paper sheet.
-
-Edit **tobii_post_processing_context.json** file to select an existing Tobii *segment* folder:
+Edit **tobii_segment_playback_context.json** file to select an existing Tobii *segment* folder:
 
 ```json
 {
-    "argaze.utils.contexts.TobiiProGlasses2.PostProcessing" : {
-        "name": "Tobii Pro Glasses 2 post-processing",
+    "argaze.utils.contexts.TobiiProGlasses2.SegmentPlayback" : {
+        "name": "Tobii Pro Glasses 2 segment playback",
         "segment": "record/segments/1",
         "pipeline": "aruco_markers_pipeline.json"
     }
 }
 ```
 
-Then, load **tobii_post_processing_context.json** file to find ArUco marker into camera image and, project gaze positions into AOI:
+Then, load **tobii_segment_playback_context.json** file to find ArUco marker into camera image and, project gaze positions into AOI:
 
 ```shell
-python -m argaze load ./src/argaze/utils/demo/tobii_post_processing_context.json
+python -m argaze load ./src/argaze/utils/demo/tobii_segment_playback_context.json
 ```
 
 ## Pupil Invisible
diff --git a/docs/user_guide/utils/main_commands.md b/docs/user_guide/utils/main_commands.md
index 4dd3434..c4887a4 100644
--- a/docs/user_guide/utils/main_commands.md
+++ b/docs/user_guide/utils/main_commands.md
@@ -35,13 +35,13 @@ For example:
 echo "print(context)" > /tmp/argaze
 ```
 
-* Pause context processing:
+* Pause context:
 
 ```shell
 echo "context.pause()" > /tmp/argaze
 ```
 
-* Resume context processing:
+* Resume context:
 
 ```shell
 echo "context.resume()" > /tmp/argaze