medius 2.0.0

Host control library for the medius transparent mouse passthrough box
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35

use crate::error::Result;
use crate::protocol::FrameType;
use crate::protocol::command::inject_payload;
use crate::protocol::opcode::INJ_MEDIA;
use crate::types::{Action, MediaKey};

use super::Device;

impl Device {
    /// `INJECT` (media) — set an injection override for one media key by 16-bit Consumer usage, merged
    /// with the user's real media keys. Present-gated: a media key on a board with no Consumer collection
    /// is a silent no-op (check [`KbdCaps::has_consumer`](crate::KbdCaps::has_consumer)).
    pub fn media(&self, key: MediaKey, action: Action) -> Result<()> {
        self.link.desired().lock().apply_media(key, action);
        self.link.send(
            FrameType::Inject,
            &inject_payload(INJ_MEDIA, key.usage(), action.as_u8()),
        )
    }

    /// Press (hold down) a media key.
    pub fn media_down(&self, key: MediaKey) -> Result<()> {
        self.media(key, Action::Press)
    }

    /// Soft-release a media key — clears our injected press; a physical hold is left intact.
    pub fn media_up(&self, key: MediaKey) -> Result<()> {
        self.media(key, Action::SoftRelease)
    }

    /// Force-release a media key — masks a physical hold too.
    pub fn media_force_release(&self, key: MediaKey) -> Result<()> {
        self.media(key, Action::ForceRelease)
    }
}