What the scene asks the panel to flush, and how well. More...

#include <ez_scene.h>

Collaboration diagram for ez_present_t:

Data Fields
ra8_ui_rect_t	rect
	Panel rectangle to flush.
bool	quality
	True: full 16-level GC16.
bool	present
	False: nothing changed; do not flush.

Detailed Description

What the scene asks the panel to flush, and how well.

The scene's join of its two views: a page change dirties the whole content rectangle, a loupe-only change dirties just the lens box. quality maps to k_display_refresh_quality (GC16) and its negation to k_display_refresh_fast (A2).

Invariant: When present is false the other members are unspecified.

Example:: ez_present_t plan = {};

if ((ez_scene_present(&scene, &plan) == k_ra8_ok) && plan.present) { ez_flush(&plan); }

ez_flush
static void ez_flush(const ez_present_t *plan)
Flush a scene plan through the PAL with the waveform it asked for.
Definition main.c:395

ez_scene_present
ra8_err_t ez_scene_present(ez_scene_t *s, ez_present_t *out)
Take the pending flush plan for whichever view changed.
Definition ez_scene.c:677

k_ra8_ok
@ k_ra8_ok
Success – operation completed with all postconditions satisfied.
Definition ra8_err.h:119

ez_present_t
What the scene asks the panel to flush, and how well.
Definition ez_scene.h:283

ez_present_t::present
bool present
False: nothing changed; do not flush.
Definition ez_scene.h:286

See also: ez_scene_present

Since: 0.1.0

Definition at line 283 of file ez_scene.h.

Field Documentation

◆ present

bool ez_present_t::present

False: nothing changed; do not flush.

Definition at line 286 of file ez_scene.h.

Referenced by ez_choose_plan(), and ez_redraw().

◆ quality

bool ez_present_t::quality

True: full 16-level GC16.

False: fast A2.

Definition at line 285 of file ez_scene.h.

Referenced by ez_choose_plan(), and ez_flush().

◆ rect

ra8_ui_rect_t ez_present_t::rect

Panel rectangle to flush.

Definition at line 284 of file ez_scene.h.