Struct playdate_controls::peripherals::Buttons

pub struct Buttons {
    pub current: PDButtons,
    pub pushed: PDButtons,
    pub released: PDButtons,
}

Wrapped Buttons API.

Represents buttons state.

• current indicates which buttons are currently down.
• pushed and released reflects which buttons were pushed or released over the previous update cycle.

Note: at the nominal frame rate of 50 ms, fast button presses can be missed if you just poll the instantaneous state.

Fields

current: PDButtons

Indicating which buttons are currently down.

pushed: PDButtons

Reflect which buttons were pushed over the previous update cycle. See struct doc.

released: PDButtons

Reflect which buttons were released over the previous update cycle. See struct doc.

Implementations

impl Buttons

pub fn get() -> Option<Self>

Uses getButtonState.

Examples found in repository

examples/buttons.rs (line 47)

	fn update(&mut self) -> Option<()> {
		// get buttons state
		let buttons = controls::peripherals::Buttons::get()?;

		unsafe {
			let graphics = (*sys::API).graphics;
			(*graphics).clear?(LCDSolidColor::kColorWhite as LCDColor);

			// render buttons state to string
			let text: Cow<str> = if buttons.current.is_empty() {
				"[Press any button]".into()
			} else {
				format!("{:?}", buttons.current.iter().singles().collect::<Vec<_>>()).into()
			};

			let c_text = CString::new(text.as_ref()).ok()?;
			// get width (screen-size) of text
			let text_width = (*graphics).getTextWidth?(
			                                           core::ptr::null_mut(),
			                                           c_text.as_ptr() as *const _,
			                                           text.len(),
			                                           PDStringEncoding::kUTF8Encoding,
			                                           0,
			);
			// render text
			(*graphics).drawText?(
			                      c_text.as_ptr() as *const _,
			                      text.len(),
			                      PDStringEncoding::kUTF8Encoding,
			                      self.pos.x,
			                      self.pos.y,
			);

			// move the label
			const SPEED: i32 = 4;
			if buttons.current.right() {
				self.pos.x += SPEED;
			}
			if buttons.current.left() {
				self.pos.x -= SPEED;
			}
			if buttons.current.up() {
				self.pos.y -= SPEED;
			}
			if buttons.current.down() {
				self.pos.y += SPEED;
			}

			// check screen boundaries
			if self.pos.x < 0 {
				self.pos.x = 0
			} else if self.pos.x > LCD_COLUMNS as i32 - text_width {
				self.pos.x = LCD_COLUMNS as i32 - text_width
			}
			if self.pos.y < 0 {
				self.pos.y = 0
			} else if self.pos.y > LCD_ROWS as i32 - TEXT_HEIGHT as i32 {
				self.pos.y = LCD_ROWS as i32 - TEXT_HEIGHT as i32
			}

			(*(*sys::API).system).drawFPS?(0, 0);
			Some(())
		}
	}

pub fn get_to( current: &mut PDButtons, pushed: &mut PDButtons, released: &mut PDButtons ) -> Option<()>

Uses getButtonState.

pub fn get_current() -> Option<PDButtons>

Uses getButtonState.

Requests & returns only current part of state, see Self::current

pub fn get_pushed() -> Option<PDButtons>

Uses getButtonState.

Requests & returns only current part of state, see Self::pushed

pub fn get_released() -> Option<PDButtons>

Uses getButtonState.

Requests & returns only current part of state, see Self::released

Trait Implementations

impl Debug for Buttons

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.