From: Marcus Fritzsch <marcus_fritzsch@mentor.com>
Date: Tue, 1 Aug 2017 14:14:12 +0000 (+0200)
Subject: layer: document intentions of layer structure
X-Git-Tag: 4.99.1~196
X-Git-Url: https://gerrit.automotivelinux.org/gerrit/gitweb?p=staging%2Fwindowmanager.git;a=commitdiff_plain;h=89fd5de8311dace5c8c1ba3fb64115f1955687d4

layer: document intentions of layer structure

Signed-off-by: Marcus Fritzsch <marcus_fritzsch@mentor.com>
---

diff --git a/src/layers.hpp b/src/layers.hpp
index 4291425..a3cb2a9 100644
--- a/src/layers.hpp
+++ b/src/layers.hpp
@@ -15,11 +15,21 @@
 namespace wm {
 
 struct surface_id_to_layer {
+   // Min and max surface ID mapped to this layer
    int id_min = -1;
    int id_max = -1;
+   // A more or less descriptive name?
    std::string name = "";
+   // The actual layer ID
    int layer_id = -1;
+   // The rectangular region surfaces are allowed to draw on
+   // this layer, note however, width and hieght of the rect
+   // can be negative, in which case they specify that
+   // the actual value is computed using MAX + 1 - w
+   // That is; allow us to specify dimensions dependent on
+   // e.g. screen dimension, w/o knowing the actual screen size.
    genivi::rect rect;
+   // XXX perhaps a zorder is needed here?
 
    explicit surface_id_to_layer(nlohmann::json const &j);