Snap for 9752887 from 28c0e60414056c26a936ed8ea13753b42c1b9d28 to tm-qpr3-release
Change-Id: I3f77657a32c2a91673fac60ffa0cf0b8a98cccd0
diff --git a/audio/include/system/audio_effects/effect_spatializer.h b/audio/include/system/audio_effects/effect_spatializer.h
index 2f853ea..971d0e3 100644
--- a/audio/include/system/audio_effects/effect_spatializer.h
+++ b/audio/include/system/audio_effects/effect_spatializer.h
@@ -47,8 +47,27 @@
SPATIALIZER_PARAM_HEAD_TO_STAGE,
// foldable device hinge angle as a float value in rad
SPATIALIZER_PARAM_HINGE_ANGLE,
- // Display orientation as a float value in rad
+
+ // The default display orientation as reported by DisplayManager.
+ //
+ // The DisplayManager reports 0, 90, 180, 270 degrees,
+ // here it is reported as a float value in radians.
+ // Only 4 values 0, PI/2, PI, 3PI/2 will be sent as of Android 14 (U).
+ // Due to precision, compare with an epsilon range, suggest
+ // rounding to the nearest integer degree for practical use.
+ //
+ // Notes:
+ // 1) A device may have more than one display.
+ // 2) A display may be locked which prevents the application from rotating.
SPATIALIZER_PARAM_DISPLAY_ORIENTATION,
+
+ // The fold state as reported by DeviceStateManager for a foldable.
+ // This is an integer value of either 0 (open) or 1 (folded).
+ //
+ // The device fold state may affect which display is active (if any).
+ // The open/closed logical state differs than the hinge angle,
+ // which may be reported by a hinge sensor.
+ SPATIALIZER_PARAM_FOLD_STATE,
} t_virtualizer_stage_params;
// See SpatializationLevel.aidl