Update bindings to SDL 2.0.20

[moralrecordings]

Notes:

• Bindings were generated using SDL2_INCLUDE_PATH=path/to/SDL-2.0.20/include cargo build --features use-bindgen
• I'm still fairly new to Rust development, so apologies for any amateur mistakes. Any feedback is welcome
• New renderer features moved to WIP: Add new SDL_Renderer APIs #1216

[Cobrand]

SDL_RenderGeometryRaw uses a buffer of SDL_Color; a type which is not wrapped (the pixels::Color code is from 2016 so I think it predates bindgen?). Would it be okay to refactor pixels::Color to use a wrapped type?

it's fine to refactor, but please keep the old type and mark it a "deprecated", and use a new type for a few versions. We don't want to break everything in one update.

The validation logic for InternalTexture::update_nv I nicked verbatim from InternalTexture::update_yuv, and I'm not sure if it works. My understanding from this page is that the UV plane in NV doesn't have half the stride like the individual U and V planes in YUV?

I'm extremely familiar with NV, so we will have to find people to test it for us. If we can't, label this part of the docs with UNTESTED UNSTABLE so that people that know what they are doing can guide us on the best way to implement this part.

There is a lot of code to cover here, so it might take some time to review everything.

[moralrecordings]

Ack. Now I thnk about it, the wrapper for SDL_RenderGeometryRaw isn't going to work. The C version does everything with pointers and strides, so it supports the pattern of having one array per data type, and the pattern of having one array with different data types interleaved. My wrapper goes for option 1, but loads of things go for option 2. Maybe the solution is to make a second wrapper, which takes vertex: &[T] and a byte offset for each data type, then finangle Rust to somehow do the right thing...

[Cobrand]

Would you mind splitting this into 2 different pull requests? One for simply updating to 2.0.20 with the very simple new calls added (rumble, audio, joystick, window, etc); and then another entirely different PR for the video and renderer-related stuff (with Color as well)? This PR is very large, I'm thankful for all the work but it's really hard to follow what is intereconnected to each other and what is not here.

[kellerkindt]

This is great @moralrecordings! I am using your branch locally with SDL 2.0.20 and the geometry-function (Canvas::geometry/SDL_RenderGeometry) works really well for me. It would be awesome if you could find the time for the PRs @Cobrand mentioned.

EDIT: ToColor impl is missing on RColor

[moralrecordings]

Ack sorry, got distracted by other things! That sounds reasonable, I'll pare this back to just the basics and split the new geometry/render/colour features into a new PR.

[Cobrand]

Very minor changes requested, otherwise very nice work!

[Cobrand]

@moralrecordings please cargo fmt, push and then once the CI checks there are no regressions we should be good to go.

[Cobrand]

Thanks!