+ * @brief Possible composition types for a given window
+ * @since 2.0.0
+ */
+typedef enum {
+
+ /** Set by the client for an invisible window. The value by default.
+ *
+ * The device ignores windows of this type.
+ */
+ TDM_COMPOSITION_NONE = 0,
+
+ /** The client will composite this window into the client target window
+ *
+ * User can choose this type for window to avoid a hardware composition for
+ * this window.
+ *
+ * The device must not request any composition type changes for windows of
+ * this type.
+ */
+ TDM_COMPOSITION_CLIENT = 1,
+
+ /** Set by the client before tdm_output_hwc_validate().
+ *
+ * Upon tdm_output_hwc_validate(), the device may request a change from this type to
+ * TDM_COMPOSITION_DEVICE or TDM_COMPOSITION_CLIENT. */
+ TDM_COMPOSITION_DEVICE_CANDIDATE = 2,
+
+ /** Set by the HWC after tdm_output_hwc_validate().
+ *
+ * The device will handle the composition of this window through a hardware
+ * overlay or other similar means.
+ *
+ * Upon tdm_output_hwc_validate(), the device may request a change from this type to
+ * TDM_COMPOSITION_CLIENT or TDM_COMPOSITION_DEVICE_CANDIDATE. */
+ TDM_COMPOSITION_DEVICE = 3,
+
+ /** Similar to DEVICE, but the position of this layer may also be set
+ * asynchronously through layer_set_cursor_position. If this functionality is not
+ * supported on a layer that the client sets to TDM_COMPOSITION_CURSOR, the
+ * device must request that the composition type of that layer is changed to
+ * TDM_COMPOSITION_CLIENT upon the next call to tdm_output_hwc_validate().
+ *
+ * Upon tdm_output_hwc_validate(), the device may request a change from this type to
+ * either TDM_COMPOSITION_DEVICE or TDM_COMPOSITION_CLIENT. Changing to
+ * TDM_COMPOSITION_DEVICE will prevent the use of layer_set_cursor_position but
+ * still permit the device to composite the layer. */
+ TDM_COMPOSITION_CURSOR = 4,
+
+ /** This type is for the VIDEO window which can be set to the reserved hw overlay
+ * which is assigned by the device.
+ *
+ * Normally, this VIDEO window displays under the primary hw overlayer of the output. */
+ TDM_COMPOSITION_VIDEO = 5,
+} tdm_hwc_window_composition;
+
+/**
+ * @brief The hwc window flag enumeration
+ * @since 2.0.0
+ */
+typedef enum {
+ TDM_HWC_WINDOW_FLAG_NONE = 0,
+} tdm_hwc_window_flag;
+
+/**