0.4.5-dev.17.uncommitted+81afe70

openrndr-application/org.openrndr/ProgramImplementation

ProgramImplementation

open class ProgramImplementation(val suspend: Boolean = false) : Program(source)

The Program class, this is where most user implementations start.

Constructors

ProgramImplementation

constructor(suspend: Boolean = false)

Types

ApplicationClipboard

inner class ApplicationClipboard : Clipboard

inner class Window : Window

Simplified window interface

Properties

open lateinit override var application: Application

open override var assetMetadata: () -> AssetMetadata

assetProperties

open override var assetProperties: MutableMap<String, String>

backgroundColor

open override var backgroundColor: ColorRGBa?

background color that is used to clear the background every frame

open override val clipboard: ProgramImplementation.ApplicationClipboard

open override var clock: () -> Double

clock function. defaults to returning the application time.

val deltaTime: Double

The elapsed time since the last draw loop

open override val dispatcher: Dispatcher

open lateinit override var drawer: Drawer

open lateinit override var driver: Driver

open override var ended: Event<ProgramEvent>

program ended event

open override val extensions: MutableList<Extension>

list of installed extensions

open override var frameCount: Int

open override var height: Int

open override var isNested: Boolean

This is checked at runtime to disallow nesting extend blocks.

open override val keyboard: Keyboard

open override val mouse: ApplicationMouse

open override var name: String

open override val pointers: Pointers

override val produceAssets: Event<ProduceAssetsEvent>

open override val program: Program

override val requestAssets: Event<RequestAssetsEvent>

open override val seconds: Double

The number of seconds since program start, or the time from a custom clock. value is updated at the beginning of the frame only.

val suspend: Boolean = false

open override var userProperties: MutableMap<String, Any>

A map that can be used to store arbitrary data, including functions

open override var width: Int

open override val window: ProgramImplementation.Window

Functions

fun animate(animationFunction: Animatable.() -> Unit)

open override fun draw()

This is the user facing draw call. It should be overridden by the user.

fun Program.drawImage(width: Int, height: Int, contentScale: Double? = null, format: ColorFormat = ColorFormat.RGBa, type: ColorType = defaultColorType(format), multisample: BufferMultisample? = null, drawFunction: Drawer.() -> Unit): ColorBuffer

Create an image ColorBuffer by drawing it

open override fun drawImpl()

This is the draw call that is called by Application. It takes care of handling extensions.

open override fun <T : Extension> extend(extension: T): T

install an Extension

open override fun <T : Extension> extend(extension: T, configure: T.() -> Unit): T

install an Extension and configure it

open override fun extend(stage: ExtensionStage, userDraw: Program.() -> Unit)

install an extension function for the given ExtensionStage

fun Program.launch(context: CoroutineContext = dispatcher, start: CoroutineStart = CoroutineStart.DEFAULT, block: suspend CoroutineScope.() -> Unit): Job

launch a coroutine in the Program context

fun Program.loadFont(fileOrUrl: String, size: Double, characterSet: Set<Char> = defaultFontmapCharacterSet, contentScale: Double = this.drawer.context.contentScale, fontScaler: (Face) -> Double = ::fontHeightScaler): FontImageMap

Load a FontImageMap

expect fun Program.namedTimestamp(extension: String = "", path: String? = null): String

actual fun Program.namedTimestamp(extension: String, path: String?): String

actual fun Program.namedTimestamp(extension: String, path: String?): String

open suspend override fun setup()

This runs exactly once before the first call to draw()

updateFrameSecondsFromClock

open override fun updateFrameSecondsFromClock()

fun Program.window(configuration: WindowConfiguration = WindowConfiguration(), init: suspend Program.() -> Unit): ApplicationWindow