Better description of the zoomLevel in the documentation

[Ost-Frost]

I worked with the zoomLevel attribute of the zoomableEventObject yesterday and I think it should be documented more clearly how the zoom relates to the scale of the view. The initial assumption would be that the zoomLevel is the factor the view is scaled by, but it is actually the square root of it.

It might have some advantages in the usability to scale it twice by the zoomLevel factor, but it should be written somewhere in the documentation to avoid confusion.

[nbarshain]

Extremely helpful. I could not figure out how zoomLevel was calculated.
Thank you @Ost-Frost for spelling it out.

[nbarshain]

Just curious, why would the author write it as the square root?

[Ost-Frost]

My interpretation would be that the zoom feels more natural when you zoom out if it is not linear.

[nbarshain]

Oh that makes sense. They are zooming based on log.
I guess for computing the rate of zoom, log makes more sense, but for calculating things based on scaling after the zoom happens, it's easier to work with the linear ratio.