diff --git a/core/java/android/view/WindowManager.java b/core/java/android/view/WindowManager.java index abc19d0e5c7a1..a6b7e0bcf72ef 100644 --- a/core/java/android/view/WindowManager.java +++ b/core/java/android/view/WindowManager.java @@ -2279,6 +2279,35 @@ public interface WindowManager extends ViewManager { * The window must make sure that no important content overlaps with the * {@link DisplayCutout}. * + *

+ * In this mode, the window extends under cutouts on the short edge of the display in both + * portrait and landscape, regardless of whether the window is hiding the system bars:
+ * Screenshot of a fullscreen activity on a display with a cutout at the top edge in + * portrait, no letterbox is applied. + * + * Screenshot of an activity on a display with a cutout at the top edge in landscape, + * no letterbox is applied. + * + *

+ * A cutout in the corner is considered to be on the short edge:
+ * Screenshot of a fullscreen activity on a display with a cutout in the corner in + * portrait, no letterbox is applied. + * + *

+ * On the other hand, should the cutout be on the long edge of the display, a letterbox will + * be applied such that the window does not extend into the cutout on either long edge: + *
+ * Screenshot of an activity on a display with a cutout on the long edge in portrait, + * letterbox is applied. + * * @see DisplayCutout * @see WindowInsets#getDisplayCutout() */ diff --git a/docs/html/reference/images/display_cutout/default_mode/fullscreen_letterbox.png b/docs/html/reference/images/display_cutout/default_mode/fullscreen_letterbox.png new file mode 100644 index 0000000000000..86022909d9300 Binary files /dev/null and b/docs/html/reference/images/display_cutout/default_mode/fullscreen_letterbox.png differ diff --git a/docs/html/reference/images/display_cutout/default_mode/landscape.png b/docs/html/reference/images/display_cutout/default_mode/landscape.png new file mode 100644 index 0000000000000..be112f493b4b2 Binary files /dev/null and b/docs/html/reference/images/display_cutout/default_mode/landscape.png differ diff --git a/docs/html/reference/images/display_cutout/default_mode/landscape_corner.png b/docs/html/reference/images/display_cutout/default_mode/landscape_corner.png new file mode 100644 index 0000000000000..7aa92b4c31bb5 Binary files /dev/null and b/docs/html/reference/images/display_cutout/default_mode/landscape_corner.png differ diff --git a/docs/html/reference/images/display_cutout/default_mode/portrait.png b/docs/html/reference/images/display_cutout/default_mode/portrait.png new file mode 100644 index 0000000000000..6392ad5441bdd Binary files /dev/null and b/docs/html/reference/images/display_cutout/default_mode/portrait.png differ diff --git a/docs/html/reference/images/display_cutout/default_mode/portrait_corner.png b/docs/html/reference/images/display_cutout/default_mode/portrait_corner.png new file mode 100644 index 0000000000000..dc8e6d05e5ac4 Binary files /dev/null and b/docs/html/reference/images/display_cutout/default_mode/portrait_corner.png differ diff --git a/docs/html/reference/images/display_cutout/never_mode/landscape.png b/docs/html/reference/images/display_cutout/never_mode/landscape.png new file mode 100644 index 0000000000000..be112f493b4b2 Binary files /dev/null and b/docs/html/reference/images/display_cutout/never_mode/landscape.png differ diff --git a/docs/html/reference/images/display_cutout/never_mode/portrait_top_letterbox.png b/docs/html/reference/images/display_cutout/never_mode/portrait_top_letterbox.png new file mode 100644 index 0000000000000..fc7dfcfee569e Binary files /dev/null and b/docs/html/reference/images/display_cutout/never_mode/portrait_top_letterbox.png differ diff --git a/docs/html/reference/images/display_cutout/short_edge/fullscreen_corner_no_letterbox.png b/docs/html/reference/images/display_cutout/short_edge/fullscreen_corner_no_letterbox.png new file mode 100644 index 0000000000000..09f942d415ddf Binary files /dev/null and b/docs/html/reference/images/display_cutout/short_edge/fullscreen_corner_no_letterbox.png differ diff --git a/docs/html/reference/images/display_cutout/short_edge/fullscreen_side_letterbox.png b/docs/html/reference/images/display_cutout/short_edge/fullscreen_side_letterbox.png new file mode 100644 index 0000000000000..9aafc587b785c Binary files /dev/null and b/docs/html/reference/images/display_cutout/short_edge/fullscreen_side_letterbox.png differ diff --git a/docs/html/reference/images/display_cutout/short_edge/fullscreen_top_no_letterbox.png b/docs/html/reference/images/display_cutout/short_edge/fullscreen_top_no_letterbox.png new file mode 100644 index 0000000000000..75e913b4a938a Binary files /dev/null and b/docs/html/reference/images/display_cutout/short_edge/fullscreen_top_no_letterbox.png differ diff --git a/docs/html/reference/images/display_cutout/short_edge/landscape_corner.png b/docs/html/reference/images/display_cutout/short_edge/landscape_corner.png new file mode 100644 index 0000000000000..d9e0f993060d1 Binary files /dev/null and b/docs/html/reference/images/display_cutout/short_edge/landscape_corner.png differ diff --git a/docs/html/reference/images/display_cutout/short_edge/landscape_sideboxed.png b/docs/html/reference/images/display_cutout/short_edge/landscape_sideboxed.png new file mode 100644 index 0000000000000..9d444939f9dfc Binary files /dev/null and b/docs/html/reference/images/display_cutout/short_edge/landscape_sideboxed.png differ diff --git a/docs/html/reference/images/display_cutout/short_edge/landscape_top_no_letterbox.png b/docs/html/reference/images/display_cutout/short_edge/landscape_top_no_letterbox.png new file mode 100644 index 0000000000000..ac023c5bf40f2 Binary files /dev/null and b/docs/html/reference/images/display_cutout/short_edge/landscape_top_no_letterbox.png differ diff --git a/docs/html/reference/images/display_cutout/short_edge/portrait_side_letterbox.png b/docs/html/reference/images/display_cutout/short_edge/portrait_side_letterbox.png new file mode 100644 index 0000000000000..50228db7c2c7c Binary files /dev/null and b/docs/html/reference/images/display_cutout/short_edge/portrait_side_letterbox.png differ