ProtoFlux:Button Events

Button Events

Pressed

Pressing

Released

HoverEnter

HoverStay

HoverLeave

Source

GlobalPoint

LocalPoint

NormalizedPoint

Button

null

∅

Interactions

The Button Events node takes in a global IButton reference and will listen for events from that global reference. When it detects something happening, it will fire events depending on what happens, along with other data.

You can use this node with UI Buttons, Touch Buttons, Physical Buttons, Context Menu Buttons, or even a custom button you add as a component onto a Slot or object, like a box.

Outputs

Pressed (Call)

Sends an Impulse when the button in Global: IButton is pressed down

Pressing (Call)

Sends an Impulse every game update while the button in Global: IButton is being held down

Released (Call)

Sends an Impulse when the button in Global: IButton is released

HoverEnter (Call)

Sends an Impulse a cursor/laser is brought on top of the button in Global: IButton (TODO: Does this include touching? (Ex: Physical buttons))

HoverStay (Call)

Sends an Impulse every game update while the button in Global: IButton is being currently being hovered over (TODO: Does this include touching? (Ex: Physical buttons))

HoverLeave (Call)

Sends an Impulse a cursor/laser leaves being on top of the button in Global: IButton (TODO: Does this include touching? (Ex: Physical buttons))

Source (Component)

The source of the button press.

When using the laser on the button, this returns with RelayTouchSource.

When physically pressing the button, this returns with TipTouchSource.

GlobalPoint (float3)

The point in global transform in the world the user's cursor is at on the surface of the button during any of this node's Impulses Example: Useful for a splash of particles where the user clicked like a click effect Also see: Coordinate spaces

LocalPoint (float3)

The point in UIX pixels within the button's local RectTransform the user's cursor is at during any of this node's Impulses Also see: Coordinate spaces

NormalizedPoint (float2)

The point from 0 to 1 in both the x and y channels within the button's local RectTransform the user's cursor is at during any of this node's Impulses. Also see: Coordinate spaces

Globals

Button (IButton)

IButton to read events from.

Examples

• Button Events being used to make a sound play.
  Button Events being used to make a sound play.