Camera API needs rotation

[Green-Sky]

We currently only make Position (back/front) available, but eg. on Android, cameras are rotated, usually multiples of 90°.
Without this, it would be up to the user to first rotate the camera by eye before it is usable.

[expikr]

Could express in terms of bitflags:

• FlipX = 1
• FlipY = 2
• SwapXY = 4

Then an enum for the eight possible camera orientations:

typedef enum SDL_CameraRotation
{
    SDL_CAMERA_ROTATION_UP = 0,           // normal
    SDL_CAMERA_ROTATION_UP_MIRROR = 1,    // flipX
    SDL_CAMERA_ROTATION_DOWN_MIRROR = 2,  // flipY
    SDL_CAMERA_ROTATION_DOWN = 3,         // flipX and flipY
    SDL_CAMERA_ROTATION_RIGHT_MIRROR = 4, // swapXY
    SDL_CAMERA_ROTATION_RIGHT = 5,        // flipX then swapXY
    SDL_CAMERA_ROTATION_LEFT = 6,         // flipY then swapXY
    SDL_CAMERA_ROTATION_LEFT_MIRROR = 7,  // flipX and flipY, then swapXY
} SDL_CameraRotation;

[icculus]

Just to be clear, are we talking about the phone being rotated (I'm holding it in landscape so I except the camera to provide landscape footage), or are we talking about some weird camera that is rotated separately from the phone?

Because we can already report the rotation state of the phone itself (...I think...?), so I'm not sure the camera API should manage this separately.

[Green-Sky]

I was talking about the camera rotation relative to the phone origin.

But yea, we would have to report this relative to something, either a fixed origin or current screen rotation.

[pipiwoaini]

Can this issue be resolved in milestone 3.2.6? This is a very important feature; without it, the camera functionality of SDL on mobile devices is almost unusable