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
use crate::{Object, Output};
use glib::translate::*;
use std::fmt;
glib_wrapper! {
pub struct FrameInfo(Object<ffi::CoglFrameInfo, FrameInfoClass>) @extends Object;
match fn {
get_type => || ffi::cogl_frame_info_get_gtype(),
}
}
impl FrameInfo {
/// Gets the frame counter for the `Onscreen` that corresponds
/// to this frame.
///
/// # Returns
///
/// The frame counter value
pub fn get_frame_counter(&self) -> i64 {
unsafe { ffi::cogl_frame_info_get_frame_counter(self.to_glib_none().0) }
}
/// Gets the `Output` that the swapped frame was presented to.
///
/// # Returns
///
/// The `Output` that the frame was
/// presented to, or `None` if this could not be determined.
pub fn get_output(&self) -> Option<Output> {
unsafe { from_glib_none(ffi::cogl_frame_info_get_output(self.to_glib_none().0)) }
}
/// Gets the presentation time for the frame. This is the time at which
/// the frame became visible to the user.
///
/// The presentation time measured in nanoseconds is based on a
/// monotonic time source. The time source is not necessarily
/// correlated with system/wall clock time and may represent the time
/// elapsed since some undefined system event such as when the system
/// last booted.
///
/// `<note>`Linux kernel version less that 3.8 can result in
/// non-monotonic timestamps being reported when using a drm based
/// OpenGL driver. Also some buggy Mesa drivers up to 9.0.1 may also
/// incorrectly report non-monotonic timestamps.`</note>`
///
/// # Returns
///
/// the presentation time for the frame
pub fn get_presentation_time(&self) -> i64 {
unsafe { ffi::cogl_frame_info_get_presentation_time(self.to_glib_none().0) }
}
/// Gets the refresh rate in Hertz for the output that the frame was on
/// at the time the frame was presented.
///
/// `<note>`Some platforms can't associate a `Output` with a
/// `FrameInfo` object but are able to report a refresh rate via
/// this api. Therefore if you need this information then this api is
/// more reliable than using `FrameInfo::get_output` followed by
/// `Output::get_refresh_rate`.`</note>`
///
/// # Returns
///
/// the refresh rate in Hertz
pub fn get_refresh_rate(&self) -> f32 {
unsafe { ffi::cogl_frame_info_get_refresh_rate(self.to_glib_none().0) }
}
}
impl fmt::Display for FrameInfo {
fn fmt(&self, f: &mut fmt::Formatter) -> fmt::Result {
write!(f, "FrameInfo")
}
}