polyui/org.polyfrost.polyui.component

Package-level declarations

Types

abstract class Drawable(children: Drawable? = arrayOf(), x: Float = 0.0f, y: Float = 0.0f, val alignment: Align = AlignDefault, size: Vec2? = null, visibleSize: Vec2? = null, palette: Colors.Palette? = null, val focusable: Boolean = false) : Cloneable

The most basic thing in the PolyUI rendering system.

Positioner

fun interface Positioner

Positioning strategies are the methods used in PolyUI to place both components across the screen, and components inside a layout.

Properties

MIN_DRAG

const val MIN_DRAG: Float = 3.0f

Functions

addHoverInfo

fun <S : Drawable> S.addHoverInfo(text: String?): S

Add some text that is shown when the mouse is left still over this drawable for 1 second or more.

afterInit

fun <S : Drawable> S.afterInit(function: S.(Event.Lifetime.PostInit) -> Unit): S

afterParentInit

fun <S : Drawable> S.afterParentInit(depth: Int = 1, handler: S.() -> Unit): S

Add an event handler to this drawable's parent, and (optionally) it's parent's parent (depth).

animateBy

fun Drawable.animateBy(at: Vec2? = null, size: Vec2? = null, rotation: Double = 0.0, scaleX: Float = 0.0f, scaleY: Float = 0.0f, skewX: Double = 0.0, skewY: Double = 0.0, color: PolyColor? = null, animation: Animation? = null)

Bulk add method for all the builtin drawable operations in PolyUI.

animateTo

fun Drawable.animateTo(tx: Float = this.x, ty: Float = this.y, size: Vec2 = this.size, rotation: Double = this.rotation, skewX: Double = this.skewX, skewY: Double = this.skewY, scaleX: Float = this.scaleX, scaleY: Float = this.scaleY, color: PolyColor = this.color, animation: Animation? = null)

Bulk add method for all the builtin drawable operations in PolyUI.

countChildren

fun Drawable.countChildren(): Int

Returns a count of this drawable's children, including children of children.

disable

fun <S : Drawable> S.disable(state: Boolean = true): S

draggable

fun <S : Drawable> S.draggable(withX: Boolean = true, withY: Boolean = true, free: Boolean = false, onStart: S.() -> Unit? = null, onDrag: S.() -> Unit? = null, onDrop: S.() -> Unit? = null): S

Make this component draggable.

events

inline fun <S : Drawable> S.events(dsl: EventDSL<S>.() -> Unit): S

fix

fun <S : Drawable> S.fix(): S

hasChildIn

fun Drawable.hasChildIn(x: Float, y: Float, width: Float, height: Float): Boolean

hasOperationOfType

inline fun <T : DrawableOp> Drawable.hasOperationOfType(): Boolean

Returns true if this drawable has a DrawableOp of the type T.

hide

fun <S : Drawable> S.hide(state: Boolean = true): S

isChildOf

fun Drawable.isChildOf(drawable: Drawable?): Boolean

Returns true if this drawable is a child of the specified drawable.

isRelatedTo

fun Drawable.isRelatedTo(drawable: Drawable?): Boolean

Returns true if this drawable is a child of the specified drawable, or if the drawable is a child of this.

locate

fun <S : Drawable> Drawable.locate(id: String): S?

Locate a drawable by its name.

named

fun <S : Drawable> S.named(name: String): S

namedId

fun <S : Drawable> S.namedId(name: String): S

onChange

@JvmName(name = "onChangeState")

fun <S : Drawable> S.onChange(func: S.(Boolean) -> Boolean): S

Add a listener for changes to the given Boolean-type property.

@JvmName(name = "onChangeNumber")

fun <S : Drawable> S.onChange(func: S.(Float) -> Boolean): S

Add a listener for changes to the given Float-type property.

@JvmName(name = "onChangeIndex")

fun <S : Drawable> S.onChange(func: S.(Int) -> Boolean): S

Add a listener for changes to the given Int-type property.

@JvmName(name = "onChangeString")

fun <S : Drawable> S.onChange(func: S.(String) -> Boolean): S

Add a listener for changes to the given String-type property.

onClick

@JvmName(name = "onClickZ")

fun <S : Drawable> S.onClick(func: S.(Event.Mouse.Clicked) -> Boolean): S

fun <S : Drawable> S.onClick(func: S.(Event.Mouse.Clicked) -> Unit): S

onDrag

fun <S : Drawable> S.onDrag(func: S.(Event.Mouse.Dragged) -> Unit): S

onInit

fun <S : Drawable> S.onInit(function: S.(Event.Lifetime.Init) -> Unit): S

onPress

fun <S : Drawable> S.onPress(func: S.(Event.Mouse.Pressed) -> Unit): S

padded

fun <S : Drawable> S.padded(padding: Vec2): S

fun <S : Drawable> S.padded(xPad: Float, yPad: Float): S

prioritize

@ApiStatus.Experimental

fun <S : Drawable> S.prioritize(): S

Prioritize this drawable, meaning it will, in relation to its siblings:

relegate

@ApiStatus.Experimental

fun <S : Drawable> S.relegate(): S

Relegate this drawable, meaning it will, in relation to its siblings:

secondary

fun <S : Text> S.secondary(): S

setAlpha

fun <S : Drawable> S.setAlpha(alpha: Float): S

setDestructivePalette

fun <S : Drawable> S.setDestructivePalette(): S

setFont

fun <S : Text> S.setFont(font: FontFamily.() -> Font): S

Set the font of this text component during initialization, using the PolyUI fonts instance.

setPalette

fun <S : Drawable> S.setPalette(palette: Colors.() -> Colors.Palette): S

Set the color palette of this drawable during initialization, using the PolyUI colors instance.

setState

fun <S : Drawable> S.setState(state: Byte): S

Set the palette of this drawable according to one of the three possible component states in PolyUI.

withBoarder

fun <S : Block> S.withBoarder(width: Float = 1.0f, color: Colors.() -> PolyColor = { page.border5 }): S

fun <S : Block> S.withBoarder(color: PolyColor, width: Float = 1.0f): S

withCursor

fun <S : Drawable> S.withCursor(cursor: Cursor = Cursor.Clicker): S

withStates

fun <S : Drawable> S.withStates(): S

fun <S : Drawable> S.withStates(consume: Boolean = false, showClicker: Boolean = true, animation: () -> Animation? = { Animations.EaseInOutQuad.create(0.08.seconds) }): S