Custom Controls

Search…

Welcome

FAQ

Introduction

Getting Started

Rendering Meshes

Rendering Volumetric Data

Slice and Crop Volume Renderings

Controls & Input Handling

Custom Controls

Gamepads

Advanced Topics

Custom Rendering Pipelines

Instancing

Rendering on Distributed Machines

Profiling

Volume Shaders and Uniforms

Custom Controls

User inputs are handled by the InputHandler which is part of SceneryBase and Hubable. Adding inputs can be done in an overwrite of the inputSetup method of SceneryBase. First a Behavior needs to be added before a key can be assigned.
Adding a Behavior
A behavior defines an action which is executed when the corresponding keys are pressed. There are currently the following base behaviors from which can be inherited: ClickBehavior, DragBehavior, ScrollBehavior.
In most cases a ClickBehavior is used. Example:
1
val helloClick = object : ClickBehaviour {
2
    val output = "Hello World"
3
​
4
    override fun click(x: Int, y: Int) {
5
        logger.info(output + "at $x and $y")
6
    }
7
}
Copied!
For cases where the x and y screen positions of the cursor are not needed they are just ignored. Adding a behavior to the InputHandler is straightforward:
1
inputHandler?.addBehaviour("hello_click", helloClick)
Copied!
inputHandler should be available from an overwrite of the inputSetup method.
Assigning Keys to Behaviors
Assigning keys to a behavior works in a similiar fashion:
1
inputHandler?.addKeyBinding("hello_click", "button1")
Copied!
This code assigned the earlied added behavior to the first mouse button.
1
inputHandler?.addKeyBinding("hello_click", "M")
Copied!
Does the same but for the "M" key.
For more on the available keys and combinations thereof see InputTrigger syntax​

Introduction - Previous

Slice and Crop Volume Renderings

Next - Controls & Input Handling

Gamepads

Last modified 10mo ago

Export as PDF

Copy link

Contents

Adding a Behavior

Assigning Keys to Behaviors