Struct amethyst_ui::UiTransform

pub struct UiTransform {
    pub id: String,
    pub local_x: f32,
    pub local_y: f32,
    pub local_z: f32,
    pub width: f32,
    pub height: f32,
    pub tab_order: i32,
    pub global_x: f32,
    pub global_y: f32,
    pub global_z: f32,
    pub scale_mode: ScaleMode,
    pub opaque: bool,
    // some fields omitted
}

The UiTransform represents the transformation of a ui element. Values are in pixel and the position is calculated from the top left of the screen to the center of the ui element's area.

Fields

id: String

An identifier. Serves no purpose other than to help you distinguish between UI elements.

local_x: f32

X coordinate, 0 is the left edge of the screen, while the width of the screen in pixel is the right edge. Centered in the middle of the ui element.

local_y: f32

Y coordinate, 0 is the top edge of the screen, while the height of the screen in pixel is the bottom edge. Centered in the middle of the ui element.

local_z: f32

Z order, entities with a lower Z order will be rendered on top of entities with a higher Z order.

width: f32

The width of this UI element in pixel.

height: f32

The height of this UI element in pixel.

tab_order: i32

The UI element tab order. When the player presses tab the UI focus will shift to the UI element with the next highest tab order, or if another element with the same tab_order as this one exists they are ordered according to Entity creation order. Shift-tab walks this ordering backwards.

global_x: f32

Global x position set by the UiParentSystem and UiLayoutSystem systems.

global_y: f32

Global y position set by the UiParentSystem and UiLayoutSystem systems.

global_z: f32

Global z position set by the UiParentSystem and UiLayoutSystem systems.

scale_mode: ScaleMode

The scale mode indicates if the position is in pixel or is relative (%) (WIP!) to the parent's size.

opaque: bool

Indicates if actions on the ui can go through this element. If set to false, the element will behaves as if it was transparent and will let events go to the next element (for example, the text on a button).

Methods

impl UiTransform

pub fn new(     id: String,     x: f32,     y: f32,     z: f32,     width: f32,     height: f32,     tab_order: i32 ) -> UiTransform

Creates a new UiTransform. By default, it is considered opaque.

pub fn position_inside_local(&self, x: f32, y: f32) -> bool

Checks if the input position is in the UiTransform rectangle. Uses local coordinates (ignores layouting).

pub fn position_inside(&self, x: f32, y: f32) -> bool

Checks if the input position is in the UiTransform rectangle.

pub fn as_percent(self) -> Self

Currently unused. Will be implemented in a future PR.

pub fn as_transparent(self) -> Self

Sets the opaque variable to false, allowing ui events to go through this ui element.

Trait Implementations

impl Clone for UiTransform

fn clone(&self) -> UiTransform

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for UiTransform

fn fmt(&self, f: &mut Formatter) -> Result

Formats the value using the given formatter.

impl Component for UiTransform

type Storage = FlaggedStorage<Self, DenseVecStorage<Self>>

Associated storage type for this component.