Merge "Clarify documentation for the dimming stage." into tm-dev am: 581b7b11bd

Original change: https://googleplex-android-review.googlesource.com/c/platform/hardware/interfaces/+/17263930

Change-Id: I34da9aa5c2b30d6dcbfdcf77cb15bedc78e8c74e
Signed-off-by: Automerger Merge Worker
diff --git a/graphics/composer/aidl/android/hardware/graphics/composer3/DimmingStage.aidl b/graphics/composer/aidl/android/hardware/graphics/composer3/DimmingStage.aidl
index f732d41..23d5f4a 100644
--- a/graphics/composer/aidl/android/hardware/graphics/composer3/DimmingStage.aidl
+++ b/graphics/composer/aidl/android/hardware/graphics/composer3/DimmingStage.aidl
@@ -29,7 +29,12 @@
      */
     LINEAR = 1,
     /**
-     * Dimming operations must be applied in gamma space, after OETF has been applied
+     * Dimming operations must be applied in gamma space, after OETF has been applied.
+     * Note that for this dimming operation to be perceptually correct it must also be gamma
+     * corrected. The framework will assume that it is able to use the gamma 2.2
+     * power function for gamma correcting the dimming matrix, for simplicity of
+     * implementation and the fact that gamma 2.2 is close enough to typical SDR
+     * transfer functions that would be used for the client target.
      */
     GAMMA_OETF = 2,
 }