I’ve been struggling to get my head around what I assume to be default controls for the Free Look Camera. With no axis inverted, I see this:
Is this actually how this is supposed to work by default?
Yes.
By default, in our examples or when you instantiate a freelook vcam from GameObject → Cinemachine → Freelook, you will get the following:
This behaves, like this:
@SonicBloomEric It’s unfortunate that “Invert” does not have a consistent meaning across the axes (which I presume is what you’re complaining about). It was a poor choice that sadly we are stuck with now, at least until the next major API overhaul.
@Gregoryl Yes, that is correct. While I do think it’s odd, I noticed in my searches that Cinemachine didn’t initially support the ability to invert the axes internally. My assumption is that this inconsistency is based on the original “default configuration” for axes.
That said, if I’m complaining, then it is about the lack of documentation about how the axes are intended to work. The UI makes them appear identical. So when you try to decode what’s going on, you start having to run tests to figure out if your control input is somehow getting wonky or if there’s perhaps a bug in Cinemachine itself. Would have saved me a lot of time if the inconsistency had been documented somewhere - I definitely scoured the documentation first.
To my mind, this would make the most sense to document in the Properties table for the component. Right now, the property is listed as:
It would be much clearer if this were to read:
Or something. It is surprisingly difficult to communicate what’s going on because the position of the camera itself is itself “inverted” from the effective change in view… I’m sure you have worked out a better way to communicate this sort of thing, though!
Hope the feedback helps!