cranpose 0.1.162

Cranpose runtime and UI facade
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
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165

use cranpose_app_shell::FramePacingMode;
use wgpu::{PresentMode, SurfaceCapabilities, TextureFormat};

use super::{
    parse_present_mode, select_android_present_mode_for_request,
    select_present_mode_for_frame_pacing, select_present_mode_for_request,
};

#[test]
fn automatic_presentation_reports_the_backend_fallback() {
    for (requested, supported, resolved) in [
        (PresentMode::AutoNoVsync, vec![PresentMode::Fifo], PresentMode::Fifo),
        (PresentMode::AutoNoVsync, vec![PresentMode::Fifo, PresentMode::Mailbox], PresentMode::Mailbox),
        (PresentMode::AutoNoVsync, vec![PresentMode::Mailbox, PresentMode::Immediate], PresentMode::Immediate),
        (PresentMode::AutoVsync, vec![PresentMode::Fifo, PresentMode::FifoRelaxed], PresentMode::FifoRelaxed),
        (PresentMode::Immediate, vec![PresentMode::Fifo, PresentMode::Immediate], PresentMode::Immediate),
    ] {
        assert_eq!(super::resolved_present_mode(requested, &caps(&supported)), resolved);
    }
}

fn caps(present_modes: &[PresentMode]) -> SurfaceCapabilities {
    SurfaceCapabilities {
        formats: vec![TextureFormat::Bgra8UnormSrgb],
        present_modes: present_modes.to_vec(),
        ..Default::default()
    }
}

#[test]
fn default_prefers_no_vsync_even_when_fifo_is_available() {
    let caps = caps(&[PresentMode::Fifo]);

    assert_eq!(
        select_present_mode_for_request(&caps, None),
        PresentMode::AutoNoVsync
    );
}

#[test]
fn explicit_supported_present_mode_is_honored() {
    let caps = caps(&[PresentMode::Fifo, PresentMode::Immediate]);

    assert_eq!(
        select_present_mode_for_request(&caps, Some(PresentMode::Fifo)),
        PresentMode::Fifo
    );
    assert_eq!(
        select_present_mode_for_request(&caps, Some(PresentMode::Immediate)),
        PresentMode::Immediate
    );
}

#[test]
fn explicit_auto_modes_do_not_need_surface_capability_entries() {
    let caps = caps(&[PresentMode::Fifo]);

    assert_eq!(
        select_present_mode_for_request(&caps, Some(PresentMode::AutoNoVsync)),
        PresentMode::AutoNoVsync
    );
    assert_eq!(
        select_present_mode_for_request(&caps, Some(PresentMode::AutoVsync)),
        PresentMode::AutoVsync
    );
}

#[test]
fn unsupported_explicit_mode_falls_back_to_no_vsync() {
    let caps = caps(&[PresentMode::Fifo]);

    assert_eq!(
        select_present_mode_for_request(&caps, Some(PresentMode::Immediate)),
        PresentMode::AutoNoVsync
    );
}

#[test]
fn android_defaults_to_fifo_rather_than_the_free_running_auto_no_vsync() {
    let caps = caps(&[PresentMode::Mailbox, PresentMode::Fifo]);

    assert_eq!(
        select_android_present_mode_for_request(&caps, None),
        PresentMode::Fifo
    );
}

#[test]
fn android_falls_back_to_auto_vsync_when_fifo_is_unavailable() {
    let caps = caps(&[PresentMode::Mailbox]);

    assert_eq!(
        select_android_present_mode_for_request(&caps, None),
        PresentMode::AutoVsync
    );
}

#[test]
fn android_honors_an_explicit_present_mode_request() {
    let caps = caps(&[PresentMode::Mailbox, PresentMode::Fifo]);

    assert_eq!(
        select_android_present_mode_for_request(&caps, Some(PresentMode::Mailbox)),
        PresentMode::Mailbox
    );
    assert_eq!(
        select_android_present_mode_for_request(&caps, Some(PresentMode::AutoNoVsync)),
        PresentMode::AutoNoVsync
    );
}

#[test]
fn parses_present_mode_aliases() {
    assert_eq!(
        parse_present_mode("no_vsync"),
        Some(PresentMode::AutoNoVsync)
    );
    assert_eq!(
        parse_present_mode("auto_vsync"),
        Some(PresentMode::AutoVsync)
    );
    assert_eq!(parse_present_mode("vsync"), Some(PresentMode::Fifo));
    assert_eq!(parse_present_mode("mailbox"), Some(PresentMode::Mailbox));
    assert_eq!(
        parse_present_mode("immediate"),
        Some(PresentMode::Immediate)
    );
    assert_eq!(parse_present_mode("unknown"), None);
}

#[test]
fn frame_pacing_maps_vsync_and_no_vsync_to_surface_modes() {
    let caps = caps(&[PresentMode::Fifo, PresentMode::Immediate]);

    assert_eq!(
        select_present_mode_for_frame_pacing(&caps, FramePacingMode::Vsync),
        PresentMode::Fifo
    );
    assert_eq!(
        select_present_mode_for_frame_pacing(&caps, FramePacingMode::NoVsync),
        PresentMode::Immediate
    );
    assert_eq!(
        select_present_mode_for_frame_pacing(&caps, FramePacingMode::Hard60),
        PresentMode::Immediate
    );
    assert_eq!(
        select_present_mode_for_frame_pacing(&caps, FramePacingMode::Hard120),
        PresentMode::Immediate
    );
}

#[test]
fn frame_pacing_falls_back_to_auto_modes_when_explicit_modes_are_unavailable() {
    let caps = caps(&[]);

    assert_eq!(
        select_present_mode_for_frame_pacing(&caps, FramePacingMode::Vsync),
        PresentMode::AutoVsync
    );
    assert_eq!(
        select_present_mode_for_frame_pacing(&caps, FramePacingMode::NoVsync),
        PresentMode::AutoNoVsync
    );
}