In PlayN Graphics interface, what's the difference between height and screenHeight methods?

Question

I mean in the case of the main platform interface (i.e. graphics().height()). Looking at the Graphics Interface docs, the height method states:

Gets the height of the drawable surface, in pixels.

screenHeight states:

Gets the height of the available screen real-estate, in pixels.

If there is a meaningful difference, in what cases might I prefer one to the other?

Answer 1

Another useful way to understand the difference is that on the Java backend, screenHeight returns the full height of the screen (i.e. 1024 on a 1600x1024 display), whereas height returns the height of the window that is running the PlayN app.