3 dimension keycode preset

[Aceeri]

Adds a preset for 3 dimensional input actions.

Open to better names, SixDOF is just what came to mind for this but it sounds a bit odd.

I did a little builder pattern for wasd/arrow vs up down mappings since people might want to mix and match them. If there are any other up/down presets you think would be common lemme know :)

[Shatur]

Thanks you!

• Could you also add reference in Cardinal docs to SixDOF and edit Axial to point to only Cardinal?
• Ccould you also add an integration test in presets.rs?

[Shatur]

What do you think about Spatial or Tertial?

[Aceeri]

Spatial maybe, but I'm not sure it is better than SixDOF...

I guess it requires a bit less knowledge since you don't need to know DOF = Degrees of Freedom and what that means.

[Shatur]

@alice-i-cecile what do you think?

[Shatur]

If we decide to keep SixDOF, maybe worth to rename it to SixDof instead. The convention is to capitalize only the first letter in abbreviations - like Aabb.

Another option to consider: name these presets <Something>1D, <Something>2D and <Something>3D. Just brainstorming 🙂

[Aceeri]

Ya maybe Axis1D/Axis2D/Axis3D?

[Aceeri]

I guess that might make axial vs axis2d confusing... Directional*D?

[Shatur]

Yeah, I Directional*D is also an option. It's a bit long, but Dir would be confusing and Bevy already have Dir* types.
Let's ask Alice.

[alice-i-cecile]

I think I like "Spatial" best :) SixDoF is really confusing to new gamedevs.

[Shatur]

@Aceeri let's go with Spatial then!

[codecov]

Codecov Report

Attention: Patch coverage is 92.00000% with 2 lines in your changes missing coverage. Please review.

Project coverage is 86.30%. Comparing base (5f0923b) to head (17e2528).
Report is 5 commits behind head on master.

Files with missing lines	Patch %	Lines
src/preset.rs	92.00%	2 Missing ⚠️

Additional details and impacted files

@@            Coverage Diff             @@
##           master      #89      +/-   ##
==========================================
+ Coverage   86.17%   86.30%   +0.13%     
==========================================
  Files          34       34              
  Lines        1034     1059      +25     
==========================================
+ Hits          891      914      +23     
- Misses        143      145       +2     

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.

[Aceeri]

* Ccould you also add an integration test in `presets.rs`?

Do you think I should add a new file for the 3 dimensions or modify the existing stuff to just be Vec3? I see Bidirectional is in there piggy backing off it but just using the X directions.

[Shatur]

I would modify the action output and constants to Vec3.

[Shatur]

Or maybe even remove the constants in the test and use the constants from glam itself.

[Shatur]

Everything looks good! But I'd like to get @alice-i-cecile's opinion on the naming. Here are the options we've considered:

• SixDof (renamed from SixDOF since in abbreviations only the first letter should be capitalized)
• Spatial
• Directional*D for all presets

If you have other suggestions, please let us know!

[alice-i-cecile]

I like this addition (it was in LWIM for a reason!), but we should rename first.

[Shatur]

@Aceeri sorry, could you resolve the conflicts?

[Shatur]

Never mind - resolved myself 🙂