polyui/org.polyfrost.polyui.utils

Package-level declarations

Types

Clock

object Clock

A simple class for timing of animations and things. Literally a delta function.

Debugger

class Debugger(polyUI: PolyUI)

the debug utilities for PolyUI.

Line

typealias Line = Pair<String, Vec2>

Locking

@Target(allowedTargets = [AnnotationTarget.FUNCTION, AnnotationTarget.PROPERTY])

@Blocking

@ApiStatus.Experimental

annotation class Locking(val when: String = "")

Marker class for future use, which will be used to indicate that the given function or property will block until the lock is freed (when it finishes the frame)

Quad

data class Quad<out A, out B, out C, out D>(val first: A, val second: B, val third: C, val fourth: D)

A quad of values.

SideEffects

@Target(allowedTargets = [AnnotationTarget.FUNCTION, AnnotationTarget.PROPERTY])

@ApiStatus.Experimental

annotation class SideEffects(val values: String, val when: String = "")

An annotation to mark a function or property as having side effects.

Properties

val Int.alpha: Int

val Int.blue: Int

val Int.green: Int

val Int.red: Int

Functions

addIfAbsent

fun <E> MutableList<E>.addIfAbsent(element: E)

Add the given element to this list if it is not in it already.

addOrReplace

@ApiStatus.Internal

fun <E> MutableList<E>.addOrReplace(element: E): E?

Replace this given element if it already exists in this list using Any.equals, or append it to the end if it does not. This method is very strange and has one specific use case, which is for cases where referential equality is needed as well as structural equality. See more here.

append

fun StringBuilder.append(c: Char, repeats: Int): StringBuilder

append the given Char to this StringBuilder, repeated repeats times.

areValuesEqual

fun FloatArray.areValuesEqual(): Boolean

both

inline fun <T> Pair<T, T>.both(func: (T) -> Unit)

Perform the given function on both elements of this pair. The highest common type of both elements is used as the type of the parameter.

cl0

inline fun cl0(a: Float, b: Float): Float

Returns the value closer to zero.

cl1

inline fun cl1(a: Float, b: Float): Float

Returns the value closer to one.

closestToPoint

fun CharSequence.closestToPoint(renderer: Renderer, font: Font, fontSize: Float, x: Float): Int

Returns the closest character index from the given string to the given point x.

cut

fun <L : MutableList<E>, RandomAccess, E> L.cut(from: Int, to: Int): L

Returns this list, with all elements not in the range from..to removed.

deref

fun <T> Ref.ObjectRef<T>.deref(): T

Return the value of this Ref.ObjectRef.

dont

inline fun Translator.Text.dont(): Translator.Text.Dont

dropAt

fun String.dropAt(index: Int = lastIndex, amount: Int = 1): String

ensureSize

fun <T> MutableList<T>.ensureSize(size: Int, initializer: (Int) -> T): MutableList<T>

Ensure that this list is at least size elements long, and if it is not, add elements to it using the given initializer.

fastAll

inline fun <L : List<E>, RandomAccess, E> L.fastAll(predicate: (E) -> Boolean): Boolean

Returns true if all elements match the given predicate.

fastAny

inline fun <L : List<E>, RandomAccess, E> L.fastAny(predicate: (E) -> Boolean): Boolean

Returns true if all elements match the given predicate.

fastEach

inline fun <L : List<E>, RandomAccess, E> L.fastEach(func: (E) -> Unit)

no-alloc Iterable.forEach which utilizes RandomAccess to get the elements.

fastEachIndexed

inline fun <L : List<E>, RandomAccess, E> L.fastEachIndexed(func: (Int, E) -> Unit)

no-alloc Iterable.forEachIndexed which utilizes RandomAccess to get the elements.

fastEachReversed

inline fun <L : List<E>, RandomAccess, E> L.fastEachReversed(func: (E) -> Unit)

no-alloc List.forEach which utilizes RandomAccess to get the elements, backwards.

fastRemoveIf

inline fun <L : MutableList<E>, RandomAccess, E> L.~~fastRemoveIf~~(predicate: (E) -> Boolean)

no-alloc MutableList.removeIf which utilizes RandomAccess to get the elements.

fastRemoveIfReversed

inline fun <L : MutableList<E>, RandomAccess, E> L.fastRemoveIfReversed(predicate: (E) -> Boolean)

no-alloc MutableList.removeIf which utilizes RandomAccess to get the elements.

gcd

fun Int.gcd(b: Int): Int

Calculate the greatest common denominator of two integers.

getByName

fun <E : Enum<E>> EnumEntries<E>.getByName(name: String?, ignoreCase: Boolean = false): E?

Get an enum constant by its name, or null if name is null; or does not match any of this enum's constants.

getResourceStream

fun getResourceStream(resourcePath: String, caller: Class<*> = PolyUI::class.java): InputStream

return a stream of the given resource or throws an exception.

getResourceStreamNullable

fun getResourceStreamNullable(resourcePath: String, caller: Class<*> = PolyUI::class.java): InputStream?

return a stream of the given resource, or null.

hsba

fun hsba(h: Float, s: Float, b: Float, a: Float = 1.0f): PolyColor.Static

HSBtoRGB

fun HSBtoRGB(hue: Float, saturation: Float, brightness: Float, alpha: Float = 1.0f): Int

Converts the components of a color, as specified by the HSB model, to an equivalent set of values for the default RGB model.

image

inline fun String.image(): PolyImage

inline fun String.image(size: Vec2): PolyImage

levenshteinDistance

fun String.levenshteinDistance(other: String): Int

calculate the levenshtein distance between this string and the other string.

mapToArray

inline fun <L : List<E>, RandomAccess, E, R> L.mapToArray(transform: (E) -> R): Array<R>

inline fun <T, R> Collection<T>.mapToArray(transform: (T) -> R): Array<R>

Perform the given transform on every element in this list, and return a new array with the results.

inline fun <T, R> Array<T>.mapToArray(transform: (T) -> R): Array<R>

Perform the given transform on every element in this array, and return a new array with the results.

inline fun <K, V, R> Map<K, V>.mapToArray(transform: (Map.Entry<K, V>) -> R): Array<R>

Perform the given transform on every element in this map, and return a new array with the results.

maybeRemove

inline fun <K, V> MutableMap<K, V>.maybeRemove(key: K, shouldRemove: Boolean): V?

Returns the value of the given key in the map, and if shouldRemove is true the value is also removed from the map.

min3

inline fun min3(a: Int, b: Int, c: Int): Int

Returns the minimum value among three given ints.

mods

fun mods(vararg mods: KeyModifiers): Modifiers

moveElement

inline fun <E> Array<E>.moveElement(from: Int, to: Int)

Moves the given element from the from index to the to index.

names

fun EnumEntries<*>.names(): List<String>

Return a list of the names of the entries in this enum.

open

fun PolyUI.open(window: Window)

radii

inline fun radii(topLeft: Float, topRight: Float, bottomLeft: Float, bottomRight: Float): FloatArray

convert the given floats into an array of 4 floats for radii.

radii

inline fun Number.radii(): FloatArray

convert the given float into an array of 4 floats for radii.

ref

fun <T> T.ref(): Ref.ObjectRef<T>

Box the given value into a Ref.ObjectRef.

remove

fun String.remove(char: Char): String

resourceExists

fun ~~resourceExists~~(resourcePath: String, caller: Class<*> = PolyUI::class.java): Boolean

rgba

@JvmOverloads

fun rgba(r: Int, g: Int, b: Int, a: Float = 1.0f): PolyColor

create a color from the given red, green, and blue integer values, and an alpha value 0f..1f

RGBtoHSB

fun RGBtoHSB(r: Int, g: Int, b: Int, out: FloatArray? = null): FloatArray

Converts the components of a color, as specified by the default RGB model, to an equivalent set of values for hue, saturation, and brightness that are the three components of the HSB model.

set

fun FloatArray.set(value: Float): FloatArray

simplifyRatio

fun Pair<Int, Int>.simplifyRatio(): Pair<Int, Int>

Simplify a ratio of two integers.

stdout

inline fun <T> T.~~stdout~~(arg: Any? = null): T

print the object to stdout, then return it.

substringSafe

fun String.substringSafe(fromIndex: Int, toIndex: Int = lastIndex): String

substringToWidth

fun String.substringToWidth(renderer: Renderer, font: Font, fontSize: Float, width: Float): Pair<String, String>

take the given string and cut it to the length, returning a pair of the string cut to the length, and the remainder.

toAnimatable

fun PolyColor.toAnimatable(): PolyColor.Animated

toAnimatableGradient

fun PolyColor.Gradient.toAnimatableGradient(): PolyColor.Gradient.Animated

toByteArray

inline fun InputStream.toByteArray(): ByteArray

Converts the InputStream into a byte array and close it.

toColor

fun Int.toColor(): PolyColor

Takes an ARGB integer color and returns a PolyColor object.

fun String.toColor(): PolyColor

Turn the given hex string into a color.

fun String.toColor(alpha: Float = 1.0f): PolyColor

toDirectByteBuffer

fun ByteArray.toDirectByteBuffer(): ByteBuffer

toDirectByteBufferNT

fun ByteArray.toDirectByteBufferNT(): ByteBuffer

toDirectByteBuffer with a null terminator.

toHex

fun PolyColor.toHex(alpha: Boolean = true, hash: Boolean = true): String

toJavaColor

fun PolyColor.toJavaColor(): Color

Return a static java Color object of this color at the instant this method is called.

toMutable

fun PolyColor.toMutable(): PolyColor.Mutable

toPolyColor

fun Color.toPolyColor(): PolyColor

Return a PolyUI compatible color object representative of this Java color object.

toRadians

inline fun Double.toRadians(): Double

translated

inline fun String.translated(): Translator.Text

inline fun String.translated(vararg args: Any?): Translator.Text.Formatted

truncate

fun String.truncate(renderer: Renderer, font: Font, fontSize: Float, width: Float, limitText: String = "..."): String

Limit the given string to a width. If the string is too long, it will be cut to the width, and limitText will be appended to the end.

wrap

fun String.wrap(maxWidth: Float, renderer: Renderer, font: Font, fontSize: Float, lines: ArrayList<Line>?): ArrayList<Line>

Wrap the given text to the given width, inserting them into lines, or a new list is created if it is null. It also returned.