Function bevy_ui::widget::measure_text_system
source · pub fn measure_text_system(
last_scale_factors: Local<'_, EntityHashMap<f32>>,
fonts: Res<'_, Assets<Font>>,
camera_query: Query<'_, '_, (Entity, &Camera)>,
default_ui_camera: DefaultUiCamera<'_, '_>,
ui_scale: Res<'_, UiScale>,
text_query: Query<'_, '_, (Ref<'_, Text>, &mut ContentSize, &mut TextFlags, Option<&TargetCamera>), With<Node>>
)Expand description
Generates a new Measure for a text node on changes to its Text component.
A Measure is used by the UI’s layout algorithm to determine the appropriate amount of space
to provide for the text given the fonts, the text itself and the constraints of the layout.
- Measures are regenerated if the target camera’s scale factor (or primary window if no specific target) or
UiScaleis changed. - Changes that only modify the colors of a
Textdo not require a newMeasure. This system is only able to detect that aTextcomponent has changed and will regenerate theMeasureon color changes. This can be expensive, particularly for large blocks of text, and thebypass_change_detectionmethod should be called when only changing theText’s colors.