Struct conrod_core::UiBuilder

pub struct UiBuilder {
    pub window_dimensions: Dimensions,
    pub maybe_theme: Option<Theme>,
    pub maybe_widgets_capacity: Option<usize>,
}

A constructor type for building a Ui instance with a set of optional parameters.

Fields

window_dimensions: Dimensions

The initial dimensions of the window in which the Ui exists.

maybe_theme: Option<Theme>

The theme used to set default styling for widgets.

If this field is None when build is called, Theme::default will be used.

maybe_widgets_capacity: Option<usize>

An estimation of the maximum number of widgets that will be used with this Ui instance.

This value is used to determine the size with which various collections should be reserved. This may make the first cycle of widget instantiations more efficient as the collections will not be required to grow dynamically. These collections include:

• the widget graph node and edge Vecs
• the HashSet used to track updated widgets
• the widget DepthOrder (a kind of toposort describing the order of widgets in their rendering order).

If this field is None when build is called, these collections will be initialised with no pre-reserved size and will instead grow organically as needed.

Methods

impl UiBuilder

pub fn new(window_dimensions: Dimensions) -> Self

Begin building a new Ui instance.

Give the initial dimensions of the window within which the Ui will be instantiated as a Scalar (DPI agnostic) value.

pub fn theme(self, value: Theme) -> Self

The theme used to set default styling for widgets.

If this field is None when build is called, Theme::default will be used.

pub fn widgets_capacity(self, value: usize) -> Self

An estimation of the maximum number of widgets that will be used with this Ui instance.

This value is used to determine the size with which various collections should be reserved. This may make the first cycle of widget instantiations more efficient as the collections will not be required to grow dynamically. These collections include:

• the widget graph node and edge Vecs
• the HashSet used to track updated widgets
• the widget DepthOrder (a kind of toposort describing the order of widgets in their rendering order).

If this field is None when build is called, these collections will be initialised with no pre-reserved size and will instead grow organically as required.

pub fn build(self) -> Ui

Build Ui from the given builder