pulp::view::AppearanceCoverage Struct Reference

N of M evaluated, K skipped and why. Printed on every run. More...

#include <appearance_defects.hpp>

Public Member Functions
int	total_skipped () const
int	text_runs_total () const
bool	trustworthy () const
	A run that measured nothing, measured a minority of the text it saw, or could not see into a region at all cannot support a claim of absence.
std::string	to_string () const

Public Attributes
int	text_nodes_seen = 0
	text-bearing views encountered
int	text_runs_measured = 0
	runs with real ink extents
int	skipped_invisible = 0
int	skipped_empty = 0
int	skipped_clipped = 0
int	skipped_clipped_in_empty_container = 0
	The part of skipped_clipped that fell inside a container reported as container_paints_no_text.
int	skipped_unmeasurable = 0
int	skipped_degenerate_box = 0
int	canvas_widgets = 0
int	canvas_text_commands = 0
int	canvas_text_measured = 0
int	canvas_text_skipped = 0
int	pairs_compared = 0
int	pairs_skipped_cross_frame = 0
bool	shaping_is_real = false
	False when the text shaper is the character-width estimator rather than a real shaping engine.

Detailed Description

N of M evaluated, K skipped and why. Printed on every run.

Member Function Documentation

text_runs_total()

int pulp::view::AppearanceCoverage::text_runs_total ( ) const

inline

to_string()

std::string pulp::view::AppearanceCoverage::to_string

(

)

const

total_skipped()

int pulp::view::AppearanceCoverage::total_skipped ( ) const

inline

trustworthy()

bool pulp::view::AppearanceCoverage::trustworthy

(

)

const

A run that measured nothing, measured a minority of the text it saw, or could not see into a region at all cannot support a claim of absence.

The region term is a veto rather than a ratio: a caller that reads this boolean and nothing else must not be told a panel is well-measured while an entire container of it was never reachable, however small that container is against the rest of the screen.

Member Data Documentation

canvas_text_commands

int pulp::view::AppearanceCoverage::canvas_text_commands = 0

canvas_text_measured

int pulp::view::AppearanceCoverage::canvas_text_measured = 0

canvas_text_skipped

int pulp::view::AppearanceCoverage::canvas_text_skipped = 0

canvas_widgets

int pulp::view::AppearanceCoverage::canvas_widgets = 0

pairs_compared

int pulp::view::AppearanceCoverage::pairs_compared = 0

pairs_skipped_cross_frame

int pulp::view::AppearanceCoverage::pairs_skipped_cross_frame = 0

shaping_is_real

bool pulp::view::AppearanceCoverage::shaping_is_real = false

False when the text shaper is the character-width estimator rather than a real shaping engine.

Estimated advances are not evidence about truncation to sub-em precision.

skipped_clipped

int pulp::view::AppearanceCoverage::skipped_clipped = 0

skipped_clipped_in_empty_container

int pulp::view::AppearanceCoverage::skipped_clipped_in_empty_container = 0

The part of skipped_clipped that fell inside a container reported as container_paints_no_text.

Clipping means two different things and a single count conflates them: a row scrolled below the fold was correctly not evaluated, while text inside a container that paints nothing is a region the walk could not see into at all. Only the second is blindness, and only the second is counted here.

skipped_degenerate_box

int pulp::view::AppearanceCoverage::skipped_degenerate_box = 0

skipped_empty

int pulp::view::AppearanceCoverage::skipped_empty = 0

skipped_invisible

int pulp::view::AppearanceCoverage::skipped_invisible = 0

skipped_unmeasurable

int pulp::view::AppearanceCoverage::skipped_unmeasurable = 0

text_nodes_seen

int pulp::view::AppearanceCoverage::text_nodes_seen = 0

text-bearing views encountered

text_runs_measured

int pulp::view::AppearanceCoverage::text_runs_measured = 0

runs with real ink extents

---

The documentation for this struct was generated from the following file:

• /home/runner/work/pulp/pulp/core/view/include/pulp/view/appearance_defects.hpp