Also note that there is another topic thread on Scene Page documentation quirkiness:
#1 getting a Sketchup::Camera instance.
Cameras are “virtual” objects that describe how the view looks at the model.
Meaning that, manipulating a camera object does not directly change the view.
You must use the Sketchup::View#camera= method assign the properties of a camera object, to the view’s (and therefor a page’s) internal properties. (In the case of a scene page, the page must also be updated.)
Also, because there is a separation between the view properties and a Ruby API camera, weirdly each time you call the camera getter (for the main view or any page) you get a brand spankin’ new instance object.
I agree the doc errs with regard to nil being returned. That phrase should be removed.
We can entertain the idea that getting the page’s current camera might be beneficial regardless of whether the page saves it. So the current implementation is harmless and likely should remain as is.