asdf-overlay-event 2.0.6

Asdf Overlay event
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
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112

/// Describe a event.
#[derive(Debug, Clone)]
#[cfg_attr(feature = "serde", derive(serde::Serialize, serde::Deserialize))]
pub enum Event {
    /// Events related to a specific surface.
    Surface {
        /// Unique identifier for the surface.
        id: u64,
        event: SurfaceEvent,
    },
}

/// Describes a surface event.
#[derive(Debug, Clone)]
#[cfg_attr(feature = "serde", derive(serde::Serialize, serde::Deserialize))]
pub enum SurfaceEvent {
    Added {
        /// Width of the surface
        width: u32,

        /// Height of the surface
        height: u32,

        /// Surface information
        info: SurfaceInfo,
    },
    Resized {
        // New width of the surface
        width: u32,

        // New height of the surface
        height: u32,
    },
    Destroyed,
}

/// Hint for a surface.
#[derive(Debug, Clone, Copy, PartialEq, Eq, Hash)]
#[cfg_attr(feature = "serde", derive(serde::Serialize, serde::Deserialize))]
pub struct SurfaceInfo {
    /// Surface type and type specific informations.
    pub api: SurfaceType,

    /// The LUID of the GPU adapter which the window used to present to surface.
    ///
    /// Client must choose correct GPU adapter using this luid,
    /// otherwise overlay rendering may fail.
    pub gpu_id: GpuLuid,
}

/// Locally unique identifier for a GPU adapter.
///
/// This identifier is not persistent across reboots.
#[derive(Debug, Clone, Copy, PartialEq, Eq, Hash)]
#[cfg_attr(feature = "serde", derive(serde::Serialize, serde::Deserialize))]
pub struct GpuLuid {
    /// The low part of the LUID.
    pub low: u32,
    /// The high part of the LUID.
    pub high: i32,
}

/// Describes the render api used by a surface.
#[derive(Debug, Clone, Copy, PartialEq, Eq, Hash)]
#[cfg_attr(feature = "serde", derive(serde::Serialize, serde::Deserialize))]
pub enum SurfaceType {
    /// Surface is OpenGL default framebuffer.
    Opengl {
        /// Window id of the OpenGL surface
        window_id: u32,
    },

    /// Surface is Direct3D9 swapchain.
    Direct3D9 {
        /// Window id of the Direct3D9 surface
        window_id: u32,
    },

    /// Surface is Direct3D11 swapchain.
    Direct3D11 {
        /// Window id of the Direct3D11 surface
        ///
        /// If the surface is directcomposition swapchain, the window id will be None.
        window_id: Option<u32>,
    },

    /// Surface is Direct3D12 swapchain.
    Direct3D12 {
        /// Window id of the Direct3D12 surface
        ///
        /// If the surface is directcomposition swapchain, the window id will be None.
        window_id: Option<u32>,
    },

    /// Surface is Vulkan win32 surface.
    Vulkan {
        /// Window id of the Vulkan surface.
        window_id: u32,
    },
}

impl SurfaceType {
    pub fn window_id(self) -> Option<u32> {
        match self {
            SurfaceType::Opengl { window_id } => Some(window_id),
            SurfaceType::Direct3D9 { window_id } => Some(window_id),
            SurfaceType::Direct3D11 { window_id } => window_id,
            SurfaceType::Direct3D12 { window_id } => window_id,
            SurfaceType::Vulkan { window_id } => Some(window_id),
        }
    }
}