Struct GlRenderOptions 

#[non_exhaustive]
pub struct GlRenderOptions {
    pub block_for_target_time: bool,
    pub advanced_control: bool,
}

Attach-time knobs for the OpenGL backend (Engine::attach_gl_render). The default is mpv’s stock behavior — right for a toolkit paint handler (GTK GLArea); shells whose render loop must not stall override per field. Attach-time on purpose: frame pacing is a property of the shell’s render loop, not of any single frame.

Non-exhaustive so future knobs stay additive — which also forbids struct expressions outside this crate (E0639, functional record update included), so construct through the chainable setters: GlRenderOptions::default().block_for_target_time(false).

Fields (Non-exhaustive)

Non-exhaustive structs could have additional fields added in future. Therefore, non-exhaustive structs cannot be constructed in external crates using the traditional Struct { .. } syntax; cannot be matched against without a wildcard ..; and struct update syntax will not work.

block_for_target_time: bool

Block inside render_gl until the frame’s target display time — mpv’s default, and the right pacing when the toolkit’s frame clock drives drawing. Set false for render loops that must not stall (e.g. preparing inside a compositor-thread pass, where blocking would hold up the whole scene submit): mpv then returns immediately and frame pacing is yours — do your own timing, or set the video-timing-offset property to 0 (mpv’s documented alternative).

advanced_control: bool

mpv’s MPV_RENDER_PARAM_ADVANCED_CONTROL: enables direct rendering and GPU screenshots, but obligates the shell to follow the render API threading rules strictly and to call render_update promptly after every update callback (optional when this is off).

Implementations

impl GlRenderOptions

pub fn block_for_target_time(self, block: bool) -> Self

Set block_for_target_time, chainable from default().

pub fn advanced_control(self, advanced: bool) -> Self

Set advanced_control, chainable from default().

Trait Implementations

impl Clone for GlRenderOptions

fn clone(&self) -> GlRenderOptions

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Copy for GlRenderOptions

impl Debug for GlRenderOptions

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for GlRenderOptions

fn default() -> Self

Returns the “default value” for a type.