androidx.window.core.layout

fun createGridWindowSizeClassSet(
    minWidthDpBreakPoints: Set<Int>,
    minHeightDpBreakPoints: Set<Int>
): Set<WindowSizeClass>

Creates a new set of breakpoints by taking the cross product of minWidthDpBreakPoints and minHeightDpBreakPoints. For example, if the width set is {10, 20} and the height set is { 100, 200 } then the resulting set will be { (10, 100), (10, 200), (20, 100), (20, 200) }.

fun Set<WindowSizeClass>.addHeightDpBreakpoints(
    minHeightDpBreakPoints: Set<Int>
): Set<WindowSizeClass>

Creates a new Set that contains the original WindowSizeClass values in addition to new elements where the width is from the original set and the height is from minHeightDpBreakPoints. Note this method does not fill in any gaps in the original set. For example if the original set was { (10, 10), (20, 20) } and the height set is { 30 } the new set will be { (10, 10), (20, 20), (10, 30), (20, 30) }. To maintain a grid set the source set must also be a grid set.

fun Set<WindowSizeClass>.computeWindowSizeClass(
    widthDp: Float,
    heightDp: Float
): WindowSizeClass

Returns the largest WindowSizeClass that is within the bounds of (widthDp, heightDp). This method prefers width and uses max height to break ties. If there is no match a default of WindowSizeClass(0,0) is returned. Examples: Input: Set: setOf(WindowSizeClass(300, 300), WindowSizeClass(300, 600) widthDp: 300.5f heightDp: 800.5f Output: WindowSizeClass(300, 600) Input: Set: setOf(WindowSizeClass(300, 300), WindowSizeClass(300, 600) widthDp: 300 heightDp: 400 Output: WindowSizeClass(300, 300). This is an overload that truncates the floats to integers.

fun Set<WindowSizeClass>.computeWindowSizeClass(widthDp: Int, heightDp: Int): WindowSizeClass

Returns the largest WindowSizeClass that is within the bounds of (widthDp, heightDp). This method prefers width and uses max height to break ties. If there is no match a default of WindowSizeClass(0,0) is returned. Examples: Input: Set: setOf(WindowSizeClass(300, 300), WindowSizeClass(300, 600) widthDp: 300 heightDp: 800 Output: WindowSizeClass(300, 600) Input: Set: setOf(WindowSizeClass(300, 300), WindowSizeClass(300, 600) widthDp: 300 heightDp: 400 Output: WindowSizeClass(300, 300)

fun Set<WindowSizeClass>.computeWindowSizeClassPreferHeight(
    widthDp: Int,
    heightDp: Int
): WindowSizeClass

Returns the largest WindowSizeClass that is within the bounds of (widthDp, heightDp). This method prefers height and uses max width to break ties. If there is no match a default of WindowSizeClass(0,0) is returned. Examples: Input: Set: setOf(WindowSizeClass(300, 300), WindowSizeClass(600, 300) widthDp: 800 heightDp: 300 Output: WindowSizeClass(600, 300) Input: Set: setOf(WindowSizeClass(300, 300), WindowSizeClass(600, 300) widthDp: 400 heightDp: 300 Output: WindowSizeClass(300, 300)