must

[fanfix.git] / docs / images.md

diff --git a/docs/images.md b/docs/images.md
index e92d50917dc2a6a4392965ecb34c63d641838a8b..4c0e36628c2cd25a50076010ab83d78c88f0f074 100644 (file)
--- a/docs/images.md
+++ b/docs/images.md
@@ -27,7 +27,7 @@ This proposal has been informed from the following prior work:
   https://iterm2.com/documentation-images.html
 
 * Kitty image protocol:
-
+  https://sw.kovidgoyal.net/kitty/graphics-protocol.html
 
 * Jexer Terminal User Interface:
   https://gitlab.com/klamonte/jexer
@@ -55,12 +55,11 @@ The core ("must-have") design goals are:
   on the screen, then an error exists in this document that must be
   fixed.
 
-  - Every feature should be straightforward to validate via automated
+  - Every feature must be straightforward to validate via automated
     unit testing.
 
-  - Every conformant terminal should produce the same output (pixels
-    on screen) given the same input (terminal font, terminal
-    sequences).
+  - Every conformant terminal must produce the same output (pixels on
+    screen) given the same input (terminal font, terminal sequences).
 
   - Every option must have a defined default value.
 
@@ -127,7 +126,8 @@ The core ("must-have") design goals are:
 Design Goals - Secondary
 ------------------------
 
-The secondary ("nice-to-have") design goals are:
+The secondary ("nice-to-have") design goals are listed below.  These
+might not all be possible, but will kept in mind:
 
 * Minimal redundant network traffic for on-screen data that is
   repeated: either on screen in multiple places, or in the same place
@@ -137,6 +137,11 @@ The secondary ("nice-to-have") design goals are:
   screen has been changed by outside or user action.  Examples: font
   change, session detach/attach, user changed image preferences.
 
+* The ability for a multiplexer to "pass-thru" the image drawing
+  sequence to its "outer" terminal, with some support for limited
+  clipping.
+
+
 
 Out Of Scope
 ------------
@@ -172,14 +177,14 @@ Multiplexer - A special case of an application that simulates one or
               obtain input/output from the user.  Multiplexers are
               thus both applications and terminals.
 
-X - The column coordinate of a cell.  This standard is 0-based: the
-    left-most column of the screen is numbered 0.
+X - The column coordinate of a cell.  This standard is 1-based (like
+    ECMA-48): the left-most column of the screen is numbered 1.
 
-Y - The row coordinate of a cell.  This standard is 0-based: the
-    top-most row of the screen is numbered 0.
+Y - The row coordinate of a cell.  This standard is 1-based (like
+    ECMA-48): the top-most row of the screen is numbered 1.
 
 Z - The layer that text or multimedia is placed on.  This proposal
-    uses a right-hand coordinate system with (X, Y, Z) = (0, 0, 0)
+    uses a right-hand coordinate system with (X, Y, Z) = (1, 1, 1)
     defined as the top-left corner on the default layer: positive Z
     projects "away" from the user and "into" or "behind" the screen.
     Rendering the Cells on the screen must produce the same result as