RFR: 6453640: BandedSampleModel.createCompatibleSampleModel() API docs are wrong

[Sergey Bylokhov]

On Tue, 14 Oct 2025 19:26:07 GMT, Phil Race <prr at openjdk.org> wrote:

> This corrects some omissions / errors in BandedSampleModel docs and adds a test to verify them.
> 
> CSR here https://bugs.openjdk.org/browse/JDK-8369849

src/java.desktop/share/classes/java/awt/image/BandedSampleModel.java line 146:

> 144:      * @throws IllegalArgumentException if the product of {@code w}
> 145:      *         and {@code h} is greater than {@code Integer.MAX_VALUE}
> 146:      *         or {@code w} or {@code h} is not greater than 0.

Note that it does not mention limitation related to the maximum size of the array, so if we will reuse this in BI we may store a little bit more data than max_int.

-------------

PR Review Comment: https://git.openjdk.org/jdk/pull/27806#discussion_r2437166140