Struct conrod_core::widget::primitive::shape::polygon::Polygon

[+] Show declaration

pub struct Polygon<I> {
    pub common: CommonBuilder,
    pub points: I,
    pub style: Style,
    pub maybe_shift_to_centre_from: Option<Point>,
}

[−] Expand description

A basic, non-interactive, arbitrary Polygon widget.

The Polygon is described by specifying its corners in order.

Polygon will automatically close all shapes, so the given list of points does not need to start and end with the same position.

Fields

common: CommonBuilder

[−] Expand description

Data necessary and common for all widget builder types.

points: I

[−] Expand description

The points describing the corners of the Polygon.

style: Style

[−] Expand description

Unique styling for the Polygon.

maybe_shift_to_centre_from: Option<Point>

[−] Expand description

Whether or not the points should be automatically centred to the widget position.

Implementations

impl<I> Polygon<I>[−]

pub fn styled(points: I, style: Style) -> Self[−]

Build a polygon with the given points and style.

pub fn fill(points: I) -> Self[−]

Build a Polygon with the default Fill style.

pub fn fill_with(points: I, color: Color) -> Self[−]

Build a Polygon Filled with the given Color.

pub fn outline(points: I) -> Self[−]

Build a Polygon with the default Outline style.

pub fn outline_styled(points: I, style: Style) -> Self[−]

Build a Polygon Outlineed with the given line style.

pub fn abs_styled(points: I, style: Style) -> Self where
    I: IntoIterator<Item = Point> + Clone, [−]

Build a new filled Polygon whose bounding box is fit to the absolute co-ordinates of the points.

This requires that the points iterator is Clone so that we may iterate through and determine the bounding box of the points.

If you would rather centre the points to the middle of the bounding box, use the Polygon::centred methods instead.

pub fn abs_fill(points: I) -> Self where
    I: IntoIterator<Item = Point> + Clone, [−]

The same as Polygon::abs_styled but builds the Polygon with the default Fill style.

pub fn abs_fill_with(points: I, color: Color) -> Self where
    I: IntoIterator<Item = Point> + Clone, [−]

The same as Polygon::abs_styled but builds the Polygon Filled with the given Color.

pub fn abs_outline(points: I) -> Self where
    I: IntoIterator<Item = Point> + Clone, [−]

The same as Polygon::abs_styled but builds the Polygon with the default Outline style.

pub fn abs_outline_styled(points: I, style: Style) -> Self where
    I: IntoIterator<Item = Point> + Clone, [−]

The same as Polygon::abs_styled but builds the Polygon with the given Outline styling.

pub fn centred_styled(points: I, style: Style) -> Self where
    I: IntoIterator<Item = Point> + Clone, [−]

Build a new Polygon and shift the location of the points so that the centre of their bounding rectangle lies at the position determined for the Polygon widget.

This is useful if your points simply describe a shape and you want to position them using conrod's auto-layout and/or Positionable methods.

If you would rather centre the bounding box to the points, use the Polygon::abs constructor method instead.

pub fn centred_fill(points: I) -> Self where
    I: IntoIterator<Item = Point> + Clone, [−]

The same as Polygon::centred_styled but constructs the Polygon with the default Fill style.

pub fn centred_fill_with(points: I, color: Color) -> Self where
    I: IntoIterator<Item = Point> + Clone, [−]

The same as Polygon::centred_styled but constructs the Polygon Filled with the given color.

pub fn centred_outline(points: I) -> Self where
    I: IntoIterator<Item = Point> + Clone, [−]

The same as Polygon::centred_styled but constructs the Polygon with the default Outline style.

pub fn centred_outline_styled(points: I, style: Style) -> Self where
    I: IntoIterator<Item = Point> + Clone, [−]

The same as Polygon::centred_styled but constructs the Polygon Outlined with the given styling.

Trait Implementations

impl<I: Clone> Clone for Polygon<I>[+]

[+] Show hidden undocumented items

fn clone(&self) -> Polygon<I>[−]

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)[−]

Performs copy-assignment from source.

impl<I> Colorable for Polygon<I>[+]

[+] Show hidden undocumented items

fn color(self, color: Color) -> Self[−]

Set the color of the widget.

fn rgba(self, r: f32, g: f32, b: f32, a: f32) -> Self[−]

Set the color of the widget from rgba values.

fn rgb(self, r: f32, g: f32, b: f32) -> Self[−]

Set the color of the widget from rgb values.

fn hsla(self, h: f32, s: f32, l: f32, a: f32) -> Self[−]

Set the color of the widget from hsla values.

fn hsl(self, h: f32, s: f32, l: f32) -> Self[−]

Set the color of the widget from hsl values.

impl<I> Common for Polygon<I>[+]

[+] Show hidden undocumented items

fn common(&self) -> &CommonBuilder[−]

Borrows the CommonBuilder field.

fn common_mut(&mut self) -> &mut CommonBuilder[−]

Mutably borrows the CommonBuilder field.

impl<I: Copy> Copy for Polygon<I>

impl<I: Debug> Debug for Polygon<I>[+]

[+] Show hidden undocumented items

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

Formats the value using the given formatter.

impl<I> Widget for Polygon<I> where
    I: IntoIterator<Item = Point>, [+]

[+] Show hidden undocumented items

type State = State

State to be stored within the Uis widget cache.

type Style = Style

Every widget is required to have its own associated Style type. This type is intended to contain high-level styling information for the widget that can be optionally specified by a user of the widget.

type Event = ()

The type of event yielded by the widget, returned via the Widget::set function.

fn init_state(&self, _: Generator<'_>) -> Self::State[−]

Return the initial State of the Widget.

fn style(&self) -> Self::Style[−]

Return the styling of the widget.

fn is_over(&self) -> IsOverFn[−]

Returns either of the following:

fn update(self, args: UpdateArgs<'_, '_, '_, '_, Self>) -> Self::Event[−]

Update the state of the Polygon.

fn default_x_position(&self, ui: &Ui) -> Position[−]

The default Position for the widget along the x axis.

fn default_y_position(&self, ui: &Ui) -> Position[−]

The default Position for the widget along the y axis.

fn default_x_dimension(&self, ui: &Ui) -> Dimension[−]

The default width for the Widget.

fn default_y_dimension(&self, ui: &Ui) -> Dimension[−]

The default height of the widget.

fn drag_area(
    &self,
    _dim: Dimensions,
    _style: &Self::Style,
    _theme: &Theme
) -> Option<Rect>[−]

If the widget is draggable, implement this method and return the position and dimensions of the draggable space. The position should be relative to the center of the widget.

fn kid_area(&self, args: KidAreaArgs<'_, Self>) -> KidArea[−]

The area on which child widgets will be placed when using the Place Position methods.

fn parent(self, parent_id: Id) -> Self[−]

Set the parent widget for this Widget by passing the WidgetId of the parent.

fn no_parent(self) -> Self[−]

Specify that this widget has no parent widgets.

fn place_on_kid_area(self, b: bool) -> Self[−]

Set whether or not the Widget should be placed on the kid_area.

fn graphics_for(self, id: Id) -> Self[−]

Indicates that the Widget is used as a non-interactive graphical element for some other widget.

fn floating(self, is_floating: bool) -> Self[−]

Set whether or not the widget is floating (the default is false). A typical example of a floating widget would be a pop-up or alert window.

fn crop_kids(self) -> Self[−]

Indicates that all widgets who are children of this widget should be cropped to the kid_area of this widget.

fn scroll_kids(self) -> Self[−]

Makes the widget's KidArea scrollable.

fn scroll_kids_vertically(self) -> Self[−]

Makes the widget's KidArea scrollable.

fn scroll_kids_horizontally(self) -> Self[−]

Set whether or not the widget's KidArea is scrollable (the default is false).

fn and<F>(self, build: F) -> Self where
    F: FnOnce(Self) -> Self, [−]

A builder method that "lifts" the Widget through the given build function.

fn and_mut<F>(self, mutate: F) -> Self where
    F: FnOnce(&mut Self), [−]

A builder method that mutates the Widget with the given mutate function.

fn and_if<F>(self, cond: bool, build: F) -> Self where
    F: FnOnce(Self) -> Self, [−]

A method that conditionally builds the Widget with the given build function.

fn and_then<T, F>(self, maybe: Option<T>, build: F) -> Self where
    F: FnOnce(Self, T) -> Self, [−]

A method that optionally builds the Widget with the given build function.

fn set<'a, 'b>(self, id: Id, ui_cell: &'a mut UiCell<'b>) -> Self::Event[−]

Note: There should be no need to override this method.