Add setVerticalFieldOfView() to public API

[NathanMOlson]

Launch Checklist

This PR adds setVerticalFieldOfView() to the public API. This allows different camera focal length to be used, like this:

set_fov.mp4

This is useful for applications that control the camera position: #4717

• Confirm your changes do not include backports from Mapbox projects (unless with compliant license) - if you are not sure about this, please ask!
• Briefly describe the changes in this PR.
• Link to related issues.
• Include before/after visuals or gifs if this PR includes visual changes.
• Write tests for all new functionality.
• Document any changes to public APIs.
• Add an entry to CHANGELOG.md under the ## main section.

[NathanMOlson]

@wipfli I think you were asking about this at the last MapLibre-GL-JS meeting?

[codecov-commenter]

Codecov Report

All modified and coverable lines are covered by tests ✅

Project coverage is 90.66%. Comparing base (09758d9) to head (a6ef17e).
Report is 1 commits behind head on main.

Additional details and impacted files

@@            Coverage Diff             @@
##             main    #4914      +/-   ##
==========================================
+ Coverage   90.49%   90.66%   +0.17%     
==========================================
  Files         265      265              
  Lines       38103    38113      +10     
  Branches     3181     3150      -31     
==========================================
+ Hits        34482    34557      +75     
+ Misses       2674     2599      -75     
- Partials      947      957      +10     

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

[HarelM]

I'm not sure how comfortable I am with exposing this. Can we gather more feedback on this?
Found this article from a few years back, which is somewhat similar to what is requested here I guess...
https://mikevanriel.com/2019/01/04/setting-the-field-of-view-fov-in-mapbox-gl-js/

[HarelM]

@louwers can this be changed in the Android or native code? I've seen some mapbox old docs that reference this I think.

[louwers]

@HarelM MapLibre Native has a hardcoded fov.

[wipfli]

Thanks for sharing! Does this work as well for terrain3d and globe?

[NathanMOlson]

Thanks for sharing! Does this work as well for terrain3d and globe?

Yes.

[HarelM]

I hope this won't bite is in the future...