diff options
15 files changed, 29 insertions, 0 deletions
diff --git a/core/java/android/view/WindowManager.java b/core/java/android/view/WindowManager.java index 8c568bc9c9a5..abd33f30b1a9 100644 --- a/core/java/android/view/WindowManager.java +++ b/core/java/android/view/WindowManager.java @@ -2283,6 +2283,35 @@ public interface WindowManager extends ViewManager { * The window must make sure that no important content overlaps with the * {@link DisplayCutout}. * + * <p> + * 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:<br/> + * <img src="{@docRoot}reference/android/images/display_cutout/short_edge/fullscreen_top_no_letterbox.png" + * height="720" + * alt="Screenshot of a fullscreen activity on a display with a cutout at the top edge in + * portrait, no letterbox is applied."/> + * + * <img src="{@docRoot}reference/android/images/display_cutout/short_edge/landscape_top_no_letterbox.png" + * width="720" + * alt="Screenshot of an activity on a display with a cutout at the top edge in landscape, + * no letterbox is applied."/> + * + * <p> + * A cutout in the corner is considered to be on the short edge: <br/> + * <img src="{@docRoot}reference/android/images/display_cutout/short_edge/fullscreen_corner_no_letterbox.png" + * height="720" + * alt="Screenshot of a fullscreen activity on a display with a cutout in the corner in + * portrait, no letterbox is applied."/> + * + * <p> + * 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: + * <br/> + * <img src="{@docRoot}reference/android/images/display_cutout/short_edge/portrait_side_letterbox.png" + * height="720" + * alt="Screenshot of an activity on a display with a cutout on the long edge in portrait, + * letterbox is applied."/> + * * @see DisplayCutout * @see WindowInsets#getDisplayCutout() * @see #layoutInDisplayCutoutMode 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 Binary files differnew file mode 100644 index 000000000000..86022909d930 --- /dev/null +++ b/docs/html/reference/images/display_cutout/default_mode/fullscreen_letterbox.png diff --git a/docs/html/reference/images/display_cutout/default_mode/landscape.png b/docs/html/reference/images/display_cutout/default_mode/landscape.png Binary files differnew file mode 100644 index 000000000000..be112f493b4b --- /dev/null +++ b/docs/html/reference/images/display_cutout/default_mode/landscape.png 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 Binary files differnew file mode 100644 index 000000000000..7aa92b4c31bb --- /dev/null +++ b/docs/html/reference/images/display_cutout/default_mode/landscape_corner.png diff --git a/docs/html/reference/images/display_cutout/default_mode/portrait.png b/docs/html/reference/images/display_cutout/default_mode/portrait.png Binary files differnew file mode 100644 index 000000000000..6392ad5441bd --- /dev/null +++ b/docs/html/reference/images/display_cutout/default_mode/portrait.png 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 Binary files differnew file mode 100644 index 000000000000..dc8e6d05e5ac --- /dev/null +++ b/docs/html/reference/images/display_cutout/default_mode/portrait_corner.png diff --git a/docs/html/reference/images/display_cutout/never_mode/landscape.png b/docs/html/reference/images/display_cutout/never_mode/landscape.png Binary files differnew file mode 100644 index 000000000000..be112f493b4b --- /dev/null +++ b/docs/html/reference/images/display_cutout/never_mode/landscape.png 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 Binary files differnew file mode 100644 index 000000000000..fc7dfcfee569 --- /dev/null +++ b/docs/html/reference/images/display_cutout/never_mode/portrait_top_letterbox.png 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 Binary files differnew file mode 100644 index 000000000000..09f942d415dd --- /dev/null +++ b/docs/html/reference/images/display_cutout/short_edge/fullscreen_corner_no_letterbox.png 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 Binary files differnew file mode 100644 index 000000000000..9aafc587b785 --- /dev/null +++ b/docs/html/reference/images/display_cutout/short_edge/fullscreen_side_letterbox.png 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 Binary files differnew file mode 100644 index 000000000000..75e913b4a938 --- /dev/null +++ b/docs/html/reference/images/display_cutout/short_edge/fullscreen_top_no_letterbox.png 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 Binary files differnew file mode 100644 index 000000000000..d9e0f993060d --- /dev/null +++ b/docs/html/reference/images/display_cutout/short_edge/landscape_corner.png 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 Binary files differnew file mode 100644 index 000000000000..9d444939f9df --- /dev/null +++ b/docs/html/reference/images/display_cutout/short_edge/landscape_sideboxed.png 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 Binary files differnew file mode 100644 index 000000000000..ac023c5bf40f --- /dev/null +++ b/docs/html/reference/images/display_cutout/short_edge/landscape_top_no_letterbox.png 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 Binary files differnew file mode 100644 index 000000000000..50228db7c2c7 --- /dev/null +++ b/docs/html/reference/images/display_cutout/short_edge/portrait_side_letterbox.png |
