[Merged by Bors] - Add convenience methods for checking a set of inputs

[DJMcNab]

Objective

Make it easier to check if some set of inputs matches a key, such as if you want to allow all of space or up or w for jumping.

Currently, this requires:

if keyboard.pressed(KeyCode::Space)
            || keyboard.pressed(KeyCode::Up)
            || keyboard.pressed(KeyCode::W) {
    // ...

Solution

Add an implementation of the helper methods, which very simply iterate through the items, used as:

if keyboard.any_pressed([KeyCode::Space, KeyCode::Up, KeyCode::W]) {

[alice-i-cecile]

Can you add all_pressed as well? This is particularly useful for modifier keys.

[DJMcNab]

Maybe? I feel like that is less useful, because all the modifier keys have at least two versions - e.g. left control and right control.

I definitely would add that if there's consensus that it's useful though.

[cart]

Definitely looks useful! Some "due diligence" questions:

1. Would we need this if/when we add a proper "map-able action system"? Ex: action = Jump, mapped_keys = Keyboard::A, Joystick::X. We should reflexively push back against multiple apis that accomplish the same goal.
2. Should we just build an action system instead? Should we merge this now and then remove it when the action system is built? Should we keep both?

[TheRawMeatball]

I think merge now, think about action system later is the most reasonable choice.

[DJMcNab]

1. If the action system would remove the Input struct to force you to use it, then this would naturally slide off.
   If someone would use this method, the alternative that they're going to do is an or of multiple calls to this, which gets messy.
2. This is solving a pain point now, instead of in (indeterminate time in the future).

[cart]

Cool I agree that merging this now is probably the right choice, just didn't want to bias things when introducing the questions :). I think all_pressed would also be a useful addition.

[cart]

bors r+

[bors]

Pull request successfully merged into main.

Build succeeded:

• build-android
• build (nightly, ubuntu-latest)
• build (stable, macos-latest)
• build (stable, ubuntu-latest)
• build (stable, windows-latest)
• build-wasm (nightly, ubuntu-latest)
• build-wasm (stable, ubuntu-latest)
• check-benches
• check-doc
• check-markdown-links
• check-missing-examples-in-docs
• check-unused-dependencies
• ci
• markdownlint
• run-examples