RFR: 8357176: java.awt javadoc code examples still use Applet API

[Phil Race]

On Fri, 16 May 2025 23:04:28 GMT, Phil Race <prr at openjdk.org> wrote:

> Update the some code examples and accompanying images to no longer mention or display as applets.

> > It seems the new screenshots could be improved by capturing them on a HiDPI (Retina) display, as the current images appear blurry. And to eliminate background elements in the corners, it might be better to capture screenshots of undecorated windows as was done in the old images.
> 
> To make the screenshots look good on High DPI displays, we need several images (preferably at 100%, 150% and 200% as the most common scales) and use the [**`srcset` attribute**](https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Elements/img#srcset) of the `<img>` element to provide different resolutions.
> 
> If you just create a screenshot on (Retina at 200% scale), the screenshots will be _too large_ and still blurry as browsers will still scale up the screenshots to the scale of the display because the [`src` attribute](https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Elements/img#src) is treated as 100%-scale candidate only.
> 
> If we agree to go this way, I can create screenshots on Windows 10 (which still uses square window borders) in different resolutions.

Re-doing the images was necessary because they were obviously applets and extremely dated, so they are better (IMO) and good enough. I just figured out how to do the screen capture without the corners.  macOS screen capture included a massive shadow that doubled the size. There's a trick (or two)
(1) Cmd-Shift-4 to enable screen capture
(2) Space to say you want to capture a specific window
(3) Option-Enter or Option-Left-Click will capture WITHOUT the shadow  (phew)

I'll upload new images

If you want to do more in a follow-up fix, that's fine, although I am not sure about Windows 10 .. as its already on the way out.
I'm also not sure about any scaling of Windows 10 rendering as it will have LCD text which is notoriously bad when scaled.

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

PR Comment: https://git.openjdk.org/jdk/pull/25278#issuecomment-2895747242