vjoy 0.7.1

Idiomatic and safe wrapper for vjoy-sys
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
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55

use thiserror::Error;
use vjoy_sys::VjdStat;

#[derive(Error, Debug)]
pub enum Error {
    #[error("app error: {0}.")]
    App(AppError),

    #[error("ffi error: {0}.")]
    Ffi(FFIError),
}

#[derive(Error, Debug)]
/// Errors that arise from incorrect usage of the wrapper API - e.g. requesting buttons outside reported limits.
pub enum AppError {
    #[error("multiple devices with configuration buttons: {0} axes: {0} hats: {0} found.")]
    DeviceConfigMultipleFound(u32, u32, u32),

    #[error("device with configuration buttons: {0} axes: {0} hats: {0} was not found.")]
    DeviceConfigNotFound(u32, u32, u32),

    #[error("device with ID {0} was not found.")]
    DeviceNotFound(u32),

    #[error("axis {1} of Device {0} could not be found.")]
    AxisNotFound(u32, u32),

    #[error("button {1} of Device {0} could not be found.")]
    ButtonNotFound(u32, u8),

    #[error("hat {1} of Device {0} could not be found.")]
    HatNotFound(u32, u8),
}

#[derive(Error, Debug)]
/// Errors that arise from incorrect usage of the C API - e.g. updating devices before acquisition.
pub enum FFIError {
    #[error("vJoyInterface.dll was not found at {0}")]
    DynamicLybraryNotFound(String),

    #[error("device with ID {0} could not be acquired. Device Status: {1}")]
    DeviceCouldNotBeAcquired(u32, VjdStat),

    #[error("device with ID {0} could not be updated from pointer data. Device Status: {1}")]
    DeviceDataCouldNotBeUpdated(u32, VjdStat),

    #[error("button {1} of Device {0} could not be set. Device Status: {2}")]
    ButtonCouldNotBeSet(u32, u8, VjdStat),

    #[error("hat {1} of Device {0} could not be set. Device Status: {2}")]
    HatCouldNotBeSet(u32, u8, VjdStat),

    #[error("axis {1} of Device {0} could not be set. Device Status: {2}")]
    AxisCouldNotBeSet(u32, u32, VjdStat),
}