From 575581ca1f63ecbe052c8ffbd6655b9a9bc6fd49 Mon Sep 17 00:00:00 2001
From: watts <benjamin.watts@psi.ch>
Date: Mon, 17 Oct 2022 22:57:26 +0200
Subject: [PATCH] Update PixelatorControllerSettings

---
 PixelatorControllerSettings.md | 52 ++++++++++++++++++++++++++++++----
 1 file changed, 47 insertions(+), 5 deletions(-)

diff --git a/PixelatorControllerSettings.md b/PixelatorControllerSettings.md
index aa96944..0abdb4d 100644
--- a/PixelatorControllerSettings.md
+++ b/PixelatorControllerSettings.md
@@ -127,7 +127,7 @@ They are read until no more data is missing.
  **nexusBookmark**::<BR>
 &emsp;A JSON structure that presents a set of "label" and "target" values that is passed to the user interface to simplify user navigation between different parts of the available file system. For example:
 
-```
+```json
    "NeXusBookmarks" : [
       {
          "label" : "today e-mnt",
@@ -145,7 +145,7 @@ They are read until no more data is missing.
          "label" : "PLV",
          "target" : "/home/control/PLV"
       }
-   ],
+   ]
 ```
 
 
@@ -232,7 +232,49 @@ log4cpp.appender.stdout.layout=org.apache.log4cpp.PatternLayout
 log4cpp.appender.stdout.layout.ConversionPattern=%d [%t] %-5p %c - %m%n
 log4cpp.category.ch_semafor_stxm.test=INFO
 ```
-## Microscope Control
-This file contains a JSON structure that provides named positions and is passed to the user interface. This can be used to configure buttons that move positioners to predefined positions (e.g. "OSA out").
 
-&#x1F534;Where is the code that handles this? Maybe there is more flexibility?
\ No newline at end of file
+## Microscope Control
+This file contains a JSON structure that provides _named positions_ and is passed to the user interface. This can be used to configure buttons that move a positioner (or set of positioners) to a predefined value (e.g. "OSA out" could move OSAX to -3000 and OSAY to 4000). The JSON structure contains one field called "InOut", whose value is another structure with the name of each field corresponding to a separate _named position_. Each of these _named position_ fields contains a list (one entry per involved positioner) of structure with 3 fields:
+
+ **positioner**::<BR>
+&emsp;String value defining the positioner to be moved.
+
+ **positionIn**::<BR>
+&emsp;Double value defining the "in" value of the positioner.
+
+ **positionOut**::<BR>
+&emsp;Double value defining the "out" value of the positioner.
+
+Example:
+```json
+{
+   "InOut" : {
+      "OSA" : [
+         {
+            "positionIn" : 0.0,
+            "positionOut" : -3000.0,
+            "positioner" : "OSAX"
+         },
+         {
+            "positionIn" : 0.0,
+            "positionOut" : 4000.0,
+            "positioner" : "OSAY"
+         }
+      ],
+      "Sample" : [
+         {
+            "positionIn" : 5000.0,
+            "positionOut" : 10000.0,
+            "positioner" : "CoarseZ"
+         }
+      ],
+      "ZonePlate" : [
+         {
+            "positionIn" : -5000,
+            "positionOut" : -18000.0,
+            "positioner" : "Zoneplate"
+         }
+      ]
+   }
+}
+```
\ No newline at end of file