mirror of
https://github.com/bevyengine/bevy
synced 2024-12-22 11:03:06 +00:00
1575481429
# Objective
In the
[`Text`](3442a13d2c/crates/bevy_text/src/text.rs (L18)
)
struct the field is named: `linebreak_behaviour`, the British spelling
of _behavior_.
**Update**, also found:
- `FileDragAndDrop::HoveredFileCancelled`
- `TouchPhase::Cancelled`
- `Touches.just_cancelled`
The majority of all spelling is in the US but when you have a lot of
contributors across the world, sometimes
spelling differences can pop up in APIs such as in this case.
For consistency, I think it would be worth a while to ensure that the
API is persistent.
Some examples:
`from_reflect.rs` has `DefaultBehavior`
TextStyle has `color` and uses the `Color` struct.
In `bevy_input/src/Touch.rs` `TouchPhase::Cancelled` and _canceled_ are
used interchangeably in the documentation
I've found that there is also the same type of discrepancies in the
documentation, though this is a low priority but is worth checking.
**Update**: I've now checked the documentation (See #8291)
## Solution
I've only renamed the inconsistencies that have breaking changes and
documentation pertaining to them. The rest of the documentation will be
changed via #8291.
Do note that the winit API is written with UK spelling, thus this may be
a cause for confusion:
`winit::event::TouchPhase::Cancelled => TouchPhase::Canceled`
`winit::event::WindowEvent::HoveredFileCancelled` -> Related to
`FileDragAndDrop::HoveredFileCanceled`
But I'm hoping to maybe outline other spelling inconsistencies in the
API, and maybe an addition to the contribution guide.
---
## Changelog
- `Text` field `linebreak_behaviour` has been renamed to
`linebreak_behavior`.
- Event `FileDragAndDrop::HoveredFileCancelled` has been renamed to
`HoveredFileCanceled`
- Function `Touches.just_cancelled` has been renamed to
`Touches.just_canceled`
- Event `TouchPhase::Cancelled` has been renamed to
`TouchPhase::Canceled`
## Migration Guide
Update where `linebreak_behaviour` is used to `linebreak_behavior`
Updated the event `FileDragAndDrop::HoveredFileCancelled` where used to
`HoveredFileCanceled`
Update `Touches.just_cancelled` where used as `Touches.just_canceled`
The event `TouchPhase::Cancelled` is now called `TouchPhase::Canceled`
276 lines
15 KiB
Rust
276 lines
15 KiB
Rust
use bevy_input::{
|
|
keyboard::{KeyCode, KeyboardInput},
|
|
mouse::MouseButton,
|
|
touch::{ForceTouch, TouchInput, TouchPhase},
|
|
ButtonState,
|
|
};
|
|
use bevy_math::Vec2;
|
|
use bevy_window::{CursorIcon, WindowLevel};
|
|
|
|
pub fn convert_keyboard_input(keyboard_input: &winit::event::KeyboardInput) -> KeyboardInput {
|
|
KeyboardInput {
|
|
scan_code: keyboard_input.scancode,
|
|
state: convert_element_state(keyboard_input.state),
|
|
key_code: keyboard_input.virtual_keycode.map(convert_virtual_key_code),
|
|
}
|
|
}
|
|
|
|
pub fn convert_element_state(element_state: winit::event::ElementState) -> ButtonState {
|
|
match element_state {
|
|
winit::event::ElementState::Pressed => ButtonState::Pressed,
|
|
winit::event::ElementState::Released => ButtonState::Released,
|
|
}
|
|
}
|
|
|
|
pub fn convert_mouse_button(mouse_button: winit::event::MouseButton) -> MouseButton {
|
|
match mouse_button {
|
|
winit::event::MouseButton::Left => MouseButton::Left,
|
|
winit::event::MouseButton::Right => MouseButton::Right,
|
|
winit::event::MouseButton::Middle => MouseButton::Middle,
|
|
winit::event::MouseButton::Other(val) => MouseButton::Other(val),
|
|
}
|
|
}
|
|
|
|
pub fn convert_touch_input(
|
|
touch_input: winit::event::Touch,
|
|
location: winit::dpi::LogicalPosition<f64>,
|
|
) -> TouchInput {
|
|
TouchInput {
|
|
phase: match touch_input.phase {
|
|
winit::event::TouchPhase::Started => TouchPhase::Started,
|
|
winit::event::TouchPhase::Moved => TouchPhase::Moved,
|
|
winit::event::TouchPhase::Ended => TouchPhase::Ended,
|
|
winit::event::TouchPhase::Cancelled => TouchPhase::Canceled,
|
|
},
|
|
position: Vec2::new(location.x as f32, location.y as f32),
|
|
force: touch_input.force.map(|f| match f {
|
|
winit::event::Force::Calibrated {
|
|
force,
|
|
max_possible_force,
|
|
altitude_angle,
|
|
} => ForceTouch::Calibrated {
|
|
force,
|
|
max_possible_force,
|
|
altitude_angle,
|
|
},
|
|
winit::event::Force::Normalized(x) => ForceTouch::Normalized(x),
|
|
}),
|
|
id: touch_input.id,
|
|
}
|
|
}
|
|
|
|
pub fn convert_virtual_key_code(virtual_key_code: winit::event::VirtualKeyCode) -> KeyCode {
|
|
match virtual_key_code {
|
|
winit::event::VirtualKeyCode::Key1 => KeyCode::Key1,
|
|
winit::event::VirtualKeyCode::Key2 => KeyCode::Key2,
|
|
winit::event::VirtualKeyCode::Key3 => KeyCode::Key3,
|
|
winit::event::VirtualKeyCode::Key4 => KeyCode::Key4,
|
|
winit::event::VirtualKeyCode::Key5 => KeyCode::Key5,
|
|
winit::event::VirtualKeyCode::Key6 => KeyCode::Key6,
|
|
winit::event::VirtualKeyCode::Key7 => KeyCode::Key7,
|
|
winit::event::VirtualKeyCode::Key8 => KeyCode::Key8,
|
|
winit::event::VirtualKeyCode::Key9 => KeyCode::Key9,
|
|
winit::event::VirtualKeyCode::Key0 => KeyCode::Key0,
|
|
winit::event::VirtualKeyCode::A => KeyCode::A,
|
|
winit::event::VirtualKeyCode::B => KeyCode::B,
|
|
winit::event::VirtualKeyCode::C => KeyCode::C,
|
|
winit::event::VirtualKeyCode::D => KeyCode::D,
|
|
winit::event::VirtualKeyCode::E => KeyCode::E,
|
|
winit::event::VirtualKeyCode::F => KeyCode::F,
|
|
winit::event::VirtualKeyCode::G => KeyCode::G,
|
|
winit::event::VirtualKeyCode::H => KeyCode::H,
|
|
winit::event::VirtualKeyCode::I => KeyCode::I,
|
|
winit::event::VirtualKeyCode::J => KeyCode::J,
|
|
winit::event::VirtualKeyCode::K => KeyCode::K,
|
|
winit::event::VirtualKeyCode::L => KeyCode::L,
|
|
winit::event::VirtualKeyCode::M => KeyCode::M,
|
|
winit::event::VirtualKeyCode::N => KeyCode::N,
|
|
winit::event::VirtualKeyCode::O => KeyCode::O,
|
|
winit::event::VirtualKeyCode::P => KeyCode::P,
|
|
winit::event::VirtualKeyCode::Q => KeyCode::Q,
|
|
winit::event::VirtualKeyCode::R => KeyCode::R,
|
|
winit::event::VirtualKeyCode::S => KeyCode::S,
|
|
winit::event::VirtualKeyCode::T => KeyCode::T,
|
|
winit::event::VirtualKeyCode::U => KeyCode::U,
|
|
winit::event::VirtualKeyCode::V => KeyCode::V,
|
|
winit::event::VirtualKeyCode::W => KeyCode::W,
|
|
winit::event::VirtualKeyCode::X => KeyCode::X,
|
|
winit::event::VirtualKeyCode::Y => KeyCode::Y,
|
|
winit::event::VirtualKeyCode::Z => KeyCode::Z,
|
|
winit::event::VirtualKeyCode::Escape => KeyCode::Escape,
|
|
winit::event::VirtualKeyCode::F1 => KeyCode::F1,
|
|
winit::event::VirtualKeyCode::F2 => KeyCode::F2,
|
|
winit::event::VirtualKeyCode::F3 => KeyCode::F3,
|
|
winit::event::VirtualKeyCode::F4 => KeyCode::F4,
|
|
winit::event::VirtualKeyCode::F5 => KeyCode::F5,
|
|
winit::event::VirtualKeyCode::F6 => KeyCode::F6,
|
|
winit::event::VirtualKeyCode::F7 => KeyCode::F7,
|
|
winit::event::VirtualKeyCode::F8 => KeyCode::F8,
|
|
winit::event::VirtualKeyCode::F9 => KeyCode::F9,
|
|
winit::event::VirtualKeyCode::F10 => KeyCode::F10,
|
|
winit::event::VirtualKeyCode::F11 => KeyCode::F11,
|
|
winit::event::VirtualKeyCode::F12 => KeyCode::F12,
|
|
winit::event::VirtualKeyCode::F13 => KeyCode::F13,
|
|
winit::event::VirtualKeyCode::F14 => KeyCode::F14,
|
|
winit::event::VirtualKeyCode::F15 => KeyCode::F15,
|
|
winit::event::VirtualKeyCode::F16 => KeyCode::F16,
|
|
winit::event::VirtualKeyCode::F17 => KeyCode::F17,
|
|
winit::event::VirtualKeyCode::F18 => KeyCode::F18,
|
|
winit::event::VirtualKeyCode::F19 => KeyCode::F19,
|
|
winit::event::VirtualKeyCode::F20 => KeyCode::F20,
|
|
winit::event::VirtualKeyCode::F21 => KeyCode::F21,
|
|
winit::event::VirtualKeyCode::F22 => KeyCode::F22,
|
|
winit::event::VirtualKeyCode::F23 => KeyCode::F23,
|
|
winit::event::VirtualKeyCode::F24 => KeyCode::F24,
|
|
winit::event::VirtualKeyCode::Snapshot => KeyCode::Snapshot,
|
|
winit::event::VirtualKeyCode::Scroll => KeyCode::Scroll,
|
|
winit::event::VirtualKeyCode::Pause => KeyCode::Pause,
|
|
winit::event::VirtualKeyCode::Insert => KeyCode::Insert,
|
|
winit::event::VirtualKeyCode::Home => KeyCode::Home,
|
|
winit::event::VirtualKeyCode::Delete => KeyCode::Delete,
|
|
winit::event::VirtualKeyCode::End => KeyCode::End,
|
|
winit::event::VirtualKeyCode::PageDown => KeyCode::PageDown,
|
|
winit::event::VirtualKeyCode::PageUp => KeyCode::PageUp,
|
|
winit::event::VirtualKeyCode::Left => KeyCode::Left,
|
|
winit::event::VirtualKeyCode::Up => KeyCode::Up,
|
|
winit::event::VirtualKeyCode::Right => KeyCode::Right,
|
|
winit::event::VirtualKeyCode::Down => KeyCode::Down,
|
|
winit::event::VirtualKeyCode::Back => KeyCode::Back,
|
|
winit::event::VirtualKeyCode::Return => KeyCode::Return,
|
|
winit::event::VirtualKeyCode::Space => KeyCode::Space,
|
|
winit::event::VirtualKeyCode::Compose => KeyCode::Compose,
|
|
winit::event::VirtualKeyCode::Caret => KeyCode::Caret,
|
|
winit::event::VirtualKeyCode::Numlock => KeyCode::Numlock,
|
|
winit::event::VirtualKeyCode::Numpad0 => KeyCode::Numpad0,
|
|
winit::event::VirtualKeyCode::Numpad1 => KeyCode::Numpad1,
|
|
winit::event::VirtualKeyCode::Numpad2 => KeyCode::Numpad2,
|
|
winit::event::VirtualKeyCode::Numpad3 => KeyCode::Numpad3,
|
|
winit::event::VirtualKeyCode::Numpad4 => KeyCode::Numpad4,
|
|
winit::event::VirtualKeyCode::Numpad5 => KeyCode::Numpad5,
|
|
winit::event::VirtualKeyCode::Numpad6 => KeyCode::Numpad6,
|
|
winit::event::VirtualKeyCode::Numpad7 => KeyCode::Numpad7,
|
|
winit::event::VirtualKeyCode::Numpad8 => KeyCode::Numpad8,
|
|
winit::event::VirtualKeyCode::Numpad9 => KeyCode::Numpad9,
|
|
winit::event::VirtualKeyCode::AbntC1 => KeyCode::AbntC1,
|
|
winit::event::VirtualKeyCode::AbntC2 => KeyCode::AbntC2,
|
|
winit::event::VirtualKeyCode::NumpadAdd => KeyCode::NumpadAdd,
|
|
winit::event::VirtualKeyCode::Apostrophe => KeyCode::Apostrophe,
|
|
winit::event::VirtualKeyCode::Apps => KeyCode::Apps,
|
|
winit::event::VirtualKeyCode::Asterisk => KeyCode::Asterisk,
|
|
winit::event::VirtualKeyCode::Plus => KeyCode::Plus,
|
|
winit::event::VirtualKeyCode::At => KeyCode::At,
|
|
winit::event::VirtualKeyCode::Ax => KeyCode::Ax,
|
|
winit::event::VirtualKeyCode::Backslash => KeyCode::Backslash,
|
|
winit::event::VirtualKeyCode::Calculator => KeyCode::Calculator,
|
|
winit::event::VirtualKeyCode::Capital => KeyCode::Capital,
|
|
winit::event::VirtualKeyCode::Colon => KeyCode::Colon,
|
|
winit::event::VirtualKeyCode::Comma => KeyCode::Comma,
|
|
winit::event::VirtualKeyCode::Convert => KeyCode::Convert,
|
|
winit::event::VirtualKeyCode::NumpadDecimal => KeyCode::NumpadDecimal,
|
|
winit::event::VirtualKeyCode::NumpadDivide => KeyCode::NumpadDivide,
|
|
winit::event::VirtualKeyCode::Equals => KeyCode::Equals,
|
|
winit::event::VirtualKeyCode::Grave => KeyCode::Grave,
|
|
winit::event::VirtualKeyCode::Kana => KeyCode::Kana,
|
|
winit::event::VirtualKeyCode::Kanji => KeyCode::Kanji,
|
|
winit::event::VirtualKeyCode::LAlt => KeyCode::LAlt,
|
|
winit::event::VirtualKeyCode::LBracket => KeyCode::LBracket,
|
|
winit::event::VirtualKeyCode::LControl => KeyCode::LControl,
|
|
winit::event::VirtualKeyCode::LShift => KeyCode::LShift,
|
|
winit::event::VirtualKeyCode::LWin => KeyCode::LWin,
|
|
winit::event::VirtualKeyCode::Mail => KeyCode::Mail,
|
|
winit::event::VirtualKeyCode::MediaSelect => KeyCode::MediaSelect,
|
|
winit::event::VirtualKeyCode::MediaStop => KeyCode::MediaStop,
|
|
winit::event::VirtualKeyCode::Minus => KeyCode::Minus,
|
|
winit::event::VirtualKeyCode::NumpadMultiply => KeyCode::NumpadMultiply,
|
|
winit::event::VirtualKeyCode::Mute => KeyCode::Mute,
|
|
winit::event::VirtualKeyCode::MyComputer => KeyCode::MyComputer,
|
|
winit::event::VirtualKeyCode::NavigateForward => KeyCode::NavigateForward,
|
|
winit::event::VirtualKeyCode::NavigateBackward => KeyCode::NavigateBackward,
|
|
winit::event::VirtualKeyCode::NextTrack => KeyCode::NextTrack,
|
|
winit::event::VirtualKeyCode::NoConvert => KeyCode::NoConvert,
|
|
winit::event::VirtualKeyCode::NumpadComma => KeyCode::NumpadComma,
|
|
winit::event::VirtualKeyCode::NumpadEnter => KeyCode::NumpadEnter,
|
|
winit::event::VirtualKeyCode::NumpadEquals => KeyCode::NumpadEquals,
|
|
winit::event::VirtualKeyCode::OEM102 => KeyCode::Oem102,
|
|
winit::event::VirtualKeyCode::Period => KeyCode::Period,
|
|
winit::event::VirtualKeyCode::PlayPause => KeyCode::PlayPause,
|
|
winit::event::VirtualKeyCode::Power => KeyCode::Power,
|
|
winit::event::VirtualKeyCode::PrevTrack => KeyCode::PrevTrack,
|
|
winit::event::VirtualKeyCode::RAlt => KeyCode::RAlt,
|
|
winit::event::VirtualKeyCode::RBracket => KeyCode::RBracket,
|
|
winit::event::VirtualKeyCode::RControl => KeyCode::RControl,
|
|
winit::event::VirtualKeyCode::RShift => KeyCode::RShift,
|
|
winit::event::VirtualKeyCode::RWin => KeyCode::RWin,
|
|
winit::event::VirtualKeyCode::Semicolon => KeyCode::Semicolon,
|
|
winit::event::VirtualKeyCode::Slash => KeyCode::Slash,
|
|
winit::event::VirtualKeyCode::Sleep => KeyCode::Sleep,
|
|
winit::event::VirtualKeyCode::Stop => KeyCode::Stop,
|
|
winit::event::VirtualKeyCode::NumpadSubtract => KeyCode::NumpadSubtract,
|
|
winit::event::VirtualKeyCode::Sysrq => KeyCode::Sysrq,
|
|
winit::event::VirtualKeyCode::Tab => KeyCode::Tab,
|
|
winit::event::VirtualKeyCode::Underline => KeyCode::Underline,
|
|
winit::event::VirtualKeyCode::Unlabeled => KeyCode::Unlabeled,
|
|
winit::event::VirtualKeyCode::VolumeDown => KeyCode::VolumeDown,
|
|
winit::event::VirtualKeyCode::VolumeUp => KeyCode::VolumeUp,
|
|
winit::event::VirtualKeyCode::Wake => KeyCode::Wake,
|
|
winit::event::VirtualKeyCode::WebBack => KeyCode::WebBack,
|
|
winit::event::VirtualKeyCode::WebFavorites => KeyCode::WebFavorites,
|
|
winit::event::VirtualKeyCode::WebForward => KeyCode::WebForward,
|
|
winit::event::VirtualKeyCode::WebHome => KeyCode::WebHome,
|
|
winit::event::VirtualKeyCode::WebRefresh => KeyCode::WebRefresh,
|
|
winit::event::VirtualKeyCode::WebSearch => KeyCode::WebSearch,
|
|
winit::event::VirtualKeyCode::WebStop => KeyCode::WebStop,
|
|
winit::event::VirtualKeyCode::Yen => KeyCode::Yen,
|
|
winit::event::VirtualKeyCode::Copy => KeyCode::Copy,
|
|
winit::event::VirtualKeyCode::Paste => KeyCode::Paste,
|
|
winit::event::VirtualKeyCode::Cut => KeyCode::Cut,
|
|
}
|
|
}
|
|
|
|
pub fn convert_cursor_icon(cursor_icon: CursorIcon) -> winit::window::CursorIcon {
|
|
match cursor_icon {
|
|
CursorIcon::Default => winit::window::CursorIcon::Default,
|
|
CursorIcon::Crosshair => winit::window::CursorIcon::Crosshair,
|
|
CursorIcon::Hand => winit::window::CursorIcon::Hand,
|
|
CursorIcon::Arrow => winit::window::CursorIcon::Arrow,
|
|
CursorIcon::Move => winit::window::CursorIcon::Move,
|
|
CursorIcon::Text => winit::window::CursorIcon::Text,
|
|
CursorIcon::Wait => winit::window::CursorIcon::Wait,
|
|
CursorIcon::Help => winit::window::CursorIcon::Help,
|
|
CursorIcon::Progress => winit::window::CursorIcon::Progress,
|
|
CursorIcon::NotAllowed => winit::window::CursorIcon::NotAllowed,
|
|
CursorIcon::ContextMenu => winit::window::CursorIcon::ContextMenu,
|
|
CursorIcon::Cell => winit::window::CursorIcon::Cell,
|
|
CursorIcon::VerticalText => winit::window::CursorIcon::VerticalText,
|
|
CursorIcon::Alias => winit::window::CursorIcon::Alias,
|
|
CursorIcon::Copy => winit::window::CursorIcon::Copy,
|
|
CursorIcon::NoDrop => winit::window::CursorIcon::NoDrop,
|
|
CursorIcon::Grab => winit::window::CursorIcon::Grab,
|
|
CursorIcon::Grabbing => winit::window::CursorIcon::Grabbing,
|
|
CursorIcon::AllScroll => winit::window::CursorIcon::AllScroll,
|
|
CursorIcon::ZoomIn => winit::window::CursorIcon::ZoomIn,
|
|
CursorIcon::ZoomOut => winit::window::CursorIcon::ZoomOut,
|
|
CursorIcon::EResize => winit::window::CursorIcon::EResize,
|
|
CursorIcon::NResize => winit::window::CursorIcon::NResize,
|
|
CursorIcon::NeResize => winit::window::CursorIcon::NeResize,
|
|
CursorIcon::NwResize => winit::window::CursorIcon::NwResize,
|
|
CursorIcon::SResize => winit::window::CursorIcon::SResize,
|
|
CursorIcon::SeResize => winit::window::CursorIcon::SeResize,
|
|
CursorIcon::SwResize => winit::window::CursorIcon::SwResize,
|
|
CursorIcon::WResize => winit::window::CursorIcon::WResize,
|
|
CursorIcon::EwResize => winit::window::CursorIcon::EwResize,
|
|
CursorIcon::NsResize => winit::window::CursorIcon::NsResize,
|
|
CursorIcon::NeswResize => winit::window::CursorIcon::NeswResize,
|
|
CursorIcon::NwseResize => winit::window::CursorIcon::NwseResize,
|
|
CursorIcon::ColResize => winit::window::CursorIcon::ColResize,
|
|
CursorIcon::RowResize => winit::window::CursorIcon::RowResize,
|
|
}
|
|
}
|
|
|
|
pub fn convert_window_level(window_level: WindowLevel) -> winit::window::WindowLevel {
|
|
match window_level {
|
|
WindowLevel::AlwaysOnBottom => winit::window::WindowLevel::AlwaysOnBottom,
|
|
WindowLevel::Normal => winit::window::WindowLevel::Normal,
|
|
WindowLevel::AlwaysOnTop => winit::window::WindowLevel::AlwaysOnTop,
|
|
}
|
|
}
|