gcode-mirror / earth-api-samples

Automatically exported from code.google.com/p/earth-api-samples
0 stars 0 forks source link

Documentation error - KmlCamera.setTilt #83

Closed GoogleCodeExporter closed 9 years ago

GoogleCodeExporter commented 9 years ago
The API Reference for KmlCamera.setTilt says:

"Angle between the direction of the camera position and the normal to the
surface of the earth. Values range from 0 to 90 degrees. Values for tilt
cannot be negative. A tilt value of 0 degrees indicates viewing from
directly above. A tilt value of 90 degrees indicates viewing along the
horizon. "

But it will take values > 90 (degrees) to look above the horizon which is
an improvement to the COM API which is restricted to virtically down to
horizontal.
This is a documentation error, not a program bug.

Original issue reported on code.google.com by gpsanima...@gmail.com on 20 Oct 2008 at 7:55

GoogleCodeExporter commented 9 years ago

Original comment by api.roman.public@gmail.com on 21 Oct 2008 at 12:51

GoogleCodeExporter commented 9 years ago
A fix should be coming out in the next API reference release.

Original comment by api.roman.public@gmail.com on 29 Oct 2008 at 6:45

GoogleCodeExporter commented 9 years ago
I've noticed the documentation changes have been put into effect, thanks.
Did you know that the description of the KmlLookAt is also incorrect with 
respect to
the Tilt angle?
It reads:
"void KmlLookAt.setTilt ....
"Angle between the direction of the LookAt position and the normal to the 
surface of
the earth. Values range from 0 to 90 degrees. Values for tilt cannot be 
negative. A
tilt value of 0 degrees indicates viewing from directly above. A tilt value of 
90
degrees indicates viewing along the horizon. "

But it does in fact take values of 0 through 90 to 180 (maybe more - I haven't
tested;), allowing a tilt above the horizon.
Again, just a doco error - the code is fine.

Original comment by gpsanima...@gmail.com on 16 Nov 2008 at 11:51