Resent-Date: Thu, 04 Nov 2021 22:27:50 +0100
Resent-Message-ID: <ddbec224-927a-460f-b129-f1934a950221@jankundrat.com>
Resent-From: =?iso-8859-1?Q?Jan_Kundr=E1t?= <jkt@jankundrat.com>
Resent-To: openswitcher ML <~martijnbraam/openatem@lists.sr.ht>
Message-Id: <11f6e7b00efaeda1cc120d7c35b5bd43ca95c828.1636061134.git.jkt@jankundrat.com>
In-Reply-To: <cover.1636061134.git.jkt@jankundrat.com>
References: <cover.1636061134.git.jkt@jankundrat.com>
From: =?UTF-8?q?Jan=20Kundr=C3=A1t?= <jkt@jankundrat.com>
Date: Wed, 19 May 2021 19:10:21 +0200
Subject: [PATCH 2/5] docs: more info on multiview configuration
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
To: "openswitcher ML" <~martijnbraam/openatem@lists.sr.ht>

Signed-off-by: Jan Kundrát <jkt@jankundrat.com>
---
 pyatem/field.py | 33 +++++++++++++++++++++++++++++++++
 1 file changed, 33 insertions(+)

diff --git a/pyatem/field.py b/pyatem/field.py
index 2277483..7c60605 100644
--- a/pyatem/field.py
+++ b/pyatem/field.py
@@ -2042,6 +2042,39 @@ class MultiviewerInputField(FieldBase):
     5      1    bool   Supports enabling the safe area overlay
     6      2    ?      unknown
     ====== ==== ====== ===========
+
+    Window numbering differs between switcher families. For example, on Atem
+    Mini Extreme, windows are numbered on a row-by-row basis, starting at upper
+    left. If a quadrant is not split, it gets the number of its upper left
+    mini-window. This is an example of a layout on Atem Mini Extreme:
+
+     +----+----+---------+
+     |  0 |  1 |    2    |
+     |  4 |  5 |         |
+     +----+----+----+----+
+     |    8    | 10 | 11 |
+     |         | 14 | 15 |
+     +---------+----+----+
+
+    On the non-Extreme Mini switchers, the window layout does not appear to be
+    configurable, and therefore the numbers are allocated on a contiguous
+    basis:
+
+     +----+----+---------+
+     |  0      |    1    |
+     +----+----+----+----+
+     |  2 |  3 |  4 |  5 |
+     +----+----+----+----+
+     |  6 | 7? | 8? | 9? |
+     +----+----+----+----+
+
+    Since the windows marked '?' are not configurable on non-Extreme Minis,
+    these numbers are just an educated guess.
+
+    Audio VU meters appear to be supported on small and big windows alike, but
+    only on those which show a video input or the Program output. The safe area
+    overlay appears to only work on full-sized Preview.
+
     """
 
     CODE = "MvIn"
-- 
2.33.0