Sets the position of the Node3D relative to the parent Node. If the Node3D has no parent or if the parent node is NOT a Node3D, then it is the same a globalPosition

postRender

open fun postRender(camera: Camera)

Invoked after render. Calculations or logic that needs to be done after rendering such as flushing the batch or ending a frame buffer. The Camera can be used for culling.

preRender

open fun preRender(camera: Camera)

Invoked before render. Calculations or logic that needs to be done before rendering such as flushing the batch or starting a frame buffer. The Camera can be used for culling.

propagateDebugRender

fun propagateDebugRender(batch: Batch, camera: Camera, camera3d: Camera, shapeRenderer: ShapeRenderer, renderCallback: (Node, Batch, Camera, Camera, ShapeRenderer) -> Unit?)

Internal debug rendering that needs to be done on the node that shouldn't be overridden. Calls propagateInternalDebugRender method.

propagateFixedUpdate

fun propagateFixedUpdate()

propagateHit

open fun propagateHit(hx: Float, hy: Float): Control?

propagateInput

open fun propagateInput(event: InputEvent<*>): Boolean

propagateInternalDebugRender

open override fun propagateInternalDebugRender(batch: Batch, camera: Camera, camera3d: Camera, shapeRenderer: ShapeRenderer, renderCallback: (Node, Batch, Camera, Camera, ShapeRenderer) -> Unit?)

propagateInternalRender

open override fun propagateInternalRender(batch: Batch, camera: Camera, camera3d: Camera, shapeRenderer: ShapeRenderer, renderCallback: (Node, Batch, Camera, Camera, ShapeRenderer) -> Unit?)

propagatePostRender

fun propagatePostRender(camera: Camera)

Internal post rendering that needs to be done on the node that shouldn't be overridden. Calls propagatePostRender method.

propagatePostUpdate

fun propagatePostUpdate()

propagatePreRender

fun propagatePreRender(camera: Camera)

Internal pre rendering that needs to be done on the node that shouldn't be overridden. Calls propagatePreRender method.

propagatePreUpdate

fun propagatePreUpdate()

propagateRender

fun propagateRender(batch: Batch, camera: Camera, camera3d: Camera, shapeRenderer: ShapeRenderer, renderCallback: (Node, Batch, Camera, Camera, ShapeRenderer) -> Unit?)

Internal rendering that needs to be done on the node that shouldn't be overridden. Calls propagateInternalRender method.

propagateResize

fun propagateResize(width: Int, height: Int, center: Boolean)

propagateUnhandledInput

open fun propagateUnhandledInput(event: InputEvent<*>): Boolean

propagateUpdate

fun propagateUpdate()

removeChild

fun removeChild(child: Node): Node

Removes the node if this node is its parent.

removeChildAt

fun removeChildAt(idx: Int): Node

Removes the child at the specified index.

render

open fun render(camera: Camera)

The main render method. The Camera can be used for culling.

rotate

fun rotate(quaternion: Vec4f): Node3D

fun rotate(x: Angle = Angle.ZERO, y: Angle = Angle.ZERO, z: Angle = Angle.ZERO): Node3D

Rotates in 'local' coordinates

rotation

fun rotation(quaternion: Vec4f): Node3D

Sets the rotation of the Node3D relative to the parent Node3D as a Quaternion. If the Node3D has no parent or if the parent node is NOT Node3D, then it is the same a globalRotation

scale

fun scale(s: Float): Node3D

fun scale(sx: Float, sy: Float, sz: Float): Node3D

Scales up or down by a factor in 'local' coordinates.

scaling

fun scaling(value: Vec3f): Node3D

fun scaling(value: Float): Node3D

Sets the local scale of the Node3D.

fun scaling(x: Float, y: Float, z: Float): Node3D

Sets the local of the Node3D.

sendChildAtToBottom

fun sendChildAtToBottom(idx: Int): Node

Sends the child node at the specified index to the bottom of this list which will be rendered on top.

sendChildAtToTop

fun sendChildAtToTop(idx: Int): Node

Sends the child node at the specified index to the top of this list which will be rendered behind.

sendChildToBottom

fun sendChildToBottom(child: Node): Node

Sends the child node to the bottom of this list which will be rendered on top.

sendChildToTop

fun sendChildToTop(child: Node): Node

Sends the child node to the top of this list which will be rendered behind.

setAnimationWeight

fun setAnimationWeight(iAnimation: Int, weight: Float)

setIdentity

fun setIdentity(): Node3D

swapChildren

fun swapChildren(child: Node, child2: Node): Node

Swaps the two children positions within the parents list

swapChildrenAt

fun swapChildrenAt(idx: Int, idx2: Int): Node

Swaps children positions at the specified indices.

toGlobal

fun toGlobal(vec: MutableVec3f, w: Float = 1.0f): MutableVec3f

Transforms vec in-place from local to global coordinates.

toLocal

fun toLocal(vec: MutableVec3f, w: Float = 1.0f): MutableVec3f

Transforms vec in-place from global to local coordinates.

toString

open override fun toString(): String

translate

fun translate(offset: Vec3f): Node3D

fun translate(tx: Float, ty: Float, tz: Float): Node3D

Translates the position by the offset vector in local coordinates.

treeString

fun treeString(): String

treeStringWithProperties

fun treeStringWithProperties(): String

updateTransform

open fun updateTransform()

visible

fun visible(value: Boolean): Node

Shows/hides the Node. When disabled propagateInternalRender is no longer called.

Properties

animations

val animations: MutableList<Animation>

canvas

var canvas: CanvasLayer? = null

The CanvasLayer that this Node belongs to. The closest parent CanvasLayer will be selected. If none are found, the scene root viewport will be used.

childCount

val childCount: Int

The current child count for this Node. Alias for NodeList.size.

children

val children: NodeList

The children of this Node. Alias for nodes.

context

val context: Context

contextOrNull

val contextOrNull: Context?

val dt: Duration

enabled

var enabled: Boolean

Enables/disables the node.

fixedProgressionRatio

val fixedProgressionRatio: Float

Attempts to grab the SceneGraph.fixedProgressionRatio. Defaults to 1 if not.

globalInverseTransform

val globalInverseTransform: Mat4

globalPosition

var globalPosition: Vec3f

The position of the Node3D in global space. If you want to set the x,y properties of this Vec3f then use the globalX, globalY, and globalZ properties of this Node3D

globalRotation

var globalRotation: Vec4f

The rotation of the Node3D in global space as a Quaternion.

globalScale

var globalScale: Vec3f

The global scale of the Node3D. If you want to set the x,y properties of this Vec3f then use the globalScaleX, globalScaleY, globalScaleZ properties of this Node3D.

globalScaleX

var globalScaleX: Float

The global x-scale of the Node3D.

globalScaleY

var globalScaleY: Float

The global y-scale of the Node3D.

globalScaleZ

var globalScaleZ: Float

The global z-scale of the Node3D.

globalToLocalTransform

val globalToLocalTransform: Mat4

globalTransform

val globalTransform: Mat4

Global transform. Product of _transform and the _transform of the parent Node3D.

globalX

var globalX: Float

globalY

var globalY: Float

globalZ

var globalZ: Float

val id: Int

Unique identifier for this node.

index

val index: Int

The index of this Node as a child in it's parent.

insideTree

val insideTree: Boolean

Check if this Node is in a SceneGraph

isDestroyed

val isDestroyed: Boolean

If destroy was called, this will be true until the next time node's are processed.

material

var material: ModelMaterial? = null

membersAndPropertiesString

open val membersAndPropertiesString: String

meshes

val meshes: MutableMap<String, MeshNode>

name

var name: String

Node name. useful for doing scene-wide searches for an node

nodes

val nodes: NodeList

The list of Nodes in this scene.

nodes3d

val nodes3d: MutableMap<String, Node3D>

onAddedToScene

val onAddedToScene: Signal

List of 'addedToScene' callbacks called when onAddedToScene is called. Add any additional callbacks directly to this list. The main use is to add callbacks directly to nodes inline when building a SceneGraph vs having to extend a class directly.

onChildEnteredTree

val onChildEnteredTree: SingleSignal<Node>

onChildExitedTree

val onChildExitedTree: SingleSignal<Node>

onDebugRender

val onDebugRender: SingleSignal<Camera>

List of 'debugRender' callbacks called when debugRender is called. Add any additional callbacks directly to this list. The main use is to add callbacks directly to nodes inline when building a SceneGraph vs having to extend a class directly.

onDestroy

val onDestroy: Signal

List of 'destroy' callbacks called when destroy is called. Add any additional callbacks directly to this list. The main use is to add callbacks directly to nodes inline when building a SceneGraph vs having to extend a class directly.

onDisabled

val onDisabled: Signal

List of 'onDisabled' callbacks called when onDisabled is called. Add any additional callbacks directly to this list. The main use is to add callbacks directly to nodes inline when building a SceneGraph vs having to extend a class directly.

onEnabled

val onEnabled: Signal

List of 'onEnabled' callbacks called when onEnabled is called. Add any additional callbacks directly to this list. The main use is to add callbacks directly to nodes inline when building a SceneGraph vs having to extend a class directly.

onFixedUpdate

val onFixedUpdate: Signal

List of 'fixed-update' callbacks called when fixedUpdate is called. Add any additional callbacks directly to this list. The main use is to add callbacks directly to nodes inline when building a SceneGraph vs having to extend a class directly.

onInput

val onInput: SingleSignal<InputEvent<*>>

List of 'input' callbacks called when input is called. Add any additional callbacks directly to this list. The main use is to add callbacks directly to nodes inline when building a SceneGraph vs having to extend a class directly.

onInvisible

val onInvisible: Signal

List of 'onInvisible' callbacks called when onInvisible is called. Add any additional callbacks directly to this list. The main use is to add callbacks directly to nodes inline when building a SceneGraph vs having to extend a class directly.

onPostRender

val onPostRender: SingleSignal<Camera>

List of 'postRender' callbacks called after postRender is called. Add any additional callbacks directly to this list. The main use is to add callbacks directly to nodes inline when building a SceneGraph vs having to extend a class directly.

onPostUpdate

val onPostUpdate: SingleSignal<Duration>

List of 'post-update' callbacks called when postUpdate is called. Add any additional callbacks directly to this list. The main use is to add callbacks directly to nodes inline when building a SceneGraph vs having to extend a class directly.

onPreRender

val onPreRender: SingleSignal<Camera>

List of 'preRender' callbacks called when onPreRender is called. Add any additional callbacks directly to this list. The main use is to add callbacks directly to nodes inline when building a SceneGraph vs having to extend a class directly.

onPreUpdate

val onPreUpdate: SingleSignal<Duration>

List of 'pre-update' callbacks called when preUpdate is called. Add any additional callbacks directly to this list. The main use is to add callbacks directly to nodes inline when building a SceneGraph vs having to extend a class directly.

onReady

val onReady: Signal

List of 'ready' callbacks called when ready is called. Add any additional callbacks directly to this list. The main use is to add callbacks directly to nodes inline when building a SceneGraph vs having to extend a class directly.

onRemovedFromScene

val onRemovedFromScene: Signal

List of 'removedFromScene' callbacks called when onRemovedFromScene is called. Add any additional callbacks directly to this list. The main use is to add callbacks directly to nodes inline when building a SceneGraph vs having to extend a class directly.

onRemovingFromScene

val onRemovingFromScene: Signal

onRender

val onRender: SingleSignal<Camera>

List of 'render' callbacks called when propagateInternalRender is called. Add any additional callbacks directly to this list. The main use is to add callbacks directly to nodes inline when building a SceneGraph vs having to extend a class directly.

onResize

val onResize: DoubleSignal<Int, Int>

List of 'resize' callbacks called when resize is called. Add any additional callbacks directly to this list. The main use is to add callbacks directly to nodes inline when building a SceneGraph vs having to extend a class directly.

onUnhandledInput

val onUnhandledInput: SingleSignal<InputEvent<*>>

List of 'unhandledInput' callbacks called when unhandledInput is called. Add any additional callbacks directly to this list. The main use is to add callbacks directly to nodes inline when building a SceneGraph vs having to extend a class directly.

onUpdate

val onUpdate: SingleSignal<Duration>

List of 'update' callbacks called when update is called. Add any additional callbacks directly to this list. The main use is to add callbacks directly to nodes inline when building a SceneGraph vs having to extend a class directly.

onVisible

val onVisible: Signal

List of 'onVisible' callbacks called when onVisible is called. Add any additional callbacks directly to this list. The main use is to add callbacks directly to nodes inline when building a SceneGraph vs having to extend a class directly.

parent

var parent: Node?

The parent Node, if any.

position

var position: Vec3f

The position of the Node3D relative to the parent transform. If the Node3D has no parent or if the parent node is NOT a Node3D, then it is the same a globalPosition. If you want to set the x,y properties of this Vec3f then use the x, y, and z properties of this Node3D

ppu

val ppu: Float

Pixels per unit. Mainly used when rendering a Node. This is based off of the SceneGraph.ppu.

ppuInv

val ppuInv: Float

The inverse of ppu. This is based off the SceneGraph.ppuInv.

rotation

var rotation: Vec4f

The rotation of the Node3D relative to the parent transform's rotation as a Quaternion. If the Node3D has no parent or if the parent node is NOT a Node3D, then it is the same a globalRotation

scale

var scale: Vec3f

The scale of the Node3D relative to the parent transform's scales. If the Node3D has no parent or if the parent node is NOT a Node3D, then it is the same a globalScaling. If you want to set the x,y properties of this Vec3f then use the scaleX, scaleY, scaleZ properties of this Node3D.

scaleX

var scaleX: Float

The x-scale of the Node3D relative to the parent transform's scales.

scaleY

var scaleY: Float

The y-scale of the Node3D relative to the parent transform's scales.

scaleZ

var scaleZ: Float

The z-scale of the Node3D relative to the parent transform's scales.

scene

var scene: SceneGraph<*>?

The scene this node belongs to.

skins

val skins: MutableList<Skin>

transform

val transform: Mat4

Local transform based on translation, scale, and rotation.

updateInterval

var updateInterval: Int = 1

Specifies how often this node's update method should be called. 1 means every frame, 2 is every other, etc

visible

var visible: Boolean

Shows/hides the node if it is renderable.

var x: Float

var y: Float

var z: Float

Extensions

button

inline fun Node.button(callback: Button.() -> Unit = {}): Button

Adds a Button to the current Node as a child and then triggers the callback

camera2d

inline fun Node.camera2d(callback: Camera2D.() -> Unit = {}): Camera2D

Adds a Camera2D to the current Node as a child and then triggers the callback

camera3d

inline fun Node.camera3d(callback: Camera3D.() -> Unit = {}): Camera3D

Adds a Camera3D to the current Node as a child and then triggers the callback

canvasLayer

inline fun Node.canvasLayer(callback: CanvasLayer.() -> Unit = {}): CanvasLayer

Adds a CanvasLayer to the current Node as a child and then triggers the callback

centerContainer

inline fun Node.centerContainer(callback: CenterContainer.() -> Unit = {}): CenterContainer

Adds a CenterContainer to the current Node as a child and then triggers the callback

column

inline fun Node.column(callback: VBoxContainer.() -> Unit = {}): VBoxContainer

Adds a VBoxContainer to the current Node as a child and then triggers the callback

container

inline fun Node.container(callback: Container.() -> Unit = {}): Container

Adds a Container to the current Node as a child and then triggers the callback

control

inline fun Node.control(callback: Control.() -> Unit = {}): Control

Adds a Control to the current Node as a child and then triggers the callback

directionalLight

inline fun Node.directionalLight(callback: DirectionalLight.() -> Unit = {}): DirectionalLight

Adds a DirectionalLight to the current Node as a child and then triggers the callback

findFirstNodeOfType

inline fun <T : Node> Node.findFirstNodeOfType(): T?

frameBuffer

inline fun Node.frameBuffer(callback: FrameBufferNode.() -> Unit = {}): FrameBufferNode

frameBufferContainer

inline fun Node.frameBufferContainer(callback: FrameBufferContainer.() -> Unit = {}): FrameBufferContainer

Adds a FrameBufferContainer to the current Node as a child and then triggers the callback

hBoxContainer

inline fun Node.hBoxContainer(callback: HBoxContainer.() -> Unit = {}): HBoxContainer

Adds a HBoxContainer to the current Node as a child and then triggers the callback

hScrollBar

inline fun Node.hScrollBar(callback: HScrollBar.() -> Unit = {}): HScrollBar

Adds a HScrollBar to the current Node as a child and then triggers the callback

label

inline fun Node.label(callback: Label.() -> Unit = {}): Label

Adds a Label to the current Node as a child and then triggers the callback

lineEdit

inline fun Node.lineEdit(callback: LineEdit.() -> Unit = {}): LineEdit

Adds a LineEdit to the current Node as a child and then triggers the callback

meshNode

inline fun Node.meshNode(callback: MeshNode.() -> Unit = {}): MeshNode

Adds a MeshNode to the current Node as a child and then triggers the callback

ninePatchRect

inline fun Node.ninePatchRect(callback: NinePatchRect.() -> Unit = {}): NinePatchRect

Adds a NinePatchRect to the current Node as a child and then triggers the callback

node

inline fun Node.node(callback: Node.() -> Unit = {}): Node

Adds a Node to the current Node as a child and then triggers the callback

inline fun <T : Node> Node.node(node: T, callback: T.() -> Unit = {}): T

Adds the specified Node to the current Node as a child and then triggers the callback. This can be used for classes that extend node that perhaps they don't have a DSL method to initialize it.

node2d

inline fun Node.node2d(callback: Node2D.() -> Unit = {}): Node2D

Adds a Node2D to the current Node as a child and then triggers the callback

node3d

inline fun Node.node3d(callback: Node3D.() -> Unit = {}): Node3D

Adds a Node3D to the current Node as a child and then triggers the callback

paddedContainer

inline fun Node.paddedContainer(callback: PaddedContainer.() -> Unit = {}): PaddedContainer

Adds a PaddedContainer to the current Node as a child and then triggers the callback

panel

inline fun Node.panel(callback: Panel.() -> Unit = {}): Panel

Adds a Panel to the current Node as a child and then triggers the callback

panelContainer

inline fun Node.panelContainer(callback: PanelContainer.() -> Unit = {}): PanelContainer

Adds a PanelContainer to the current Node as a child and then triggers the callback

progressBar

inline fun Node.progressBar(callback: ProgressBar.() -> Unit = {}): ProgressBar

Adds a ProgressBar to the current Node as a child and then triggers the callback

row

inline fun Node.row(callback: HBoxContainer.() -> Unit = {}): HBoxContainer

Adds a HBoxContainer to the current Node as a child and then triggers the callback

scrollContainer

inline fun Node.scrollContainer(callback: ScrollContainer.() -> Unit = {}): ScrollContainer

Adds a ScrollContainer to the current Node as a child and then triggers the callback

textureProgress

inline fun Node.textureProgress(callback: TextureProgress.() -> Unit = {}): TextureProgress

Adds a TextureProgress to the current Node as a child and then triggers the callback

textureRect

inline fun Node.textureRect(callback: TextureRect.() -> Unit = {}): TextureRect

Adds a TextureRect to the current Node as a child and then triggers the callback

vBoxContainer

inline fun Node.vBoxContainer(callback: VBoxContainer.() -> Unit = {}): VBoxContainer

Adds a VBoxContainer to the current Node as a child and then triggers the callback

viewport

inline fun Node.viewport(callback: ViewportCanvasLayer.() -> Unit = {}): ViewportCanvasLayer

Adds a ViewportCanvasLayer to the current Node as a child and then triggers the callback

vScrollBar

inline fun Node.vScrollBar(callback: VScrollBar.() -> Unit = {}): VScrollBar

Adds a VScrollBar to the current Node as a child and then triggers the callback