Event Binders | Visual Effect Graph | 10.2.2
docs.unity3d.com
    Show / Hide Table of Contents
    Experimental: This feature is currently experimental and is subject to change in later major versions. To use this feature, enable Experimental Operators/Blocks in the Visual Effects tab of your Project's Preferences.

    Event Binders

    Event Binders refer to a set of MonoBehaviour Scripts that help you trigger Events in Visual Effects when a particular event happens in the Scene. For example, when a Renderer becomes visible. Event Binders can also attach Event Attribute Payloads to the Events that they send.

    Mouse Event Binder

    The Mouse Event Binder triggers an event in the target Visual Effect based on actions that you perform with the mouse (for example, clicking, hovering, or dragging).

    Requires: A Collider on the same GameObject as this component.

    Properties:

    Property Description
    Target The Visual Effect instance to trigger the Event on.
    Event Name The name of the Event to trigger.
    Activation Specifies when this component triggers the Event:
    • OnMouseDown: When you click down on the Collider.
    • OnMouseUp: When you release a click on the Collider.
    • OnMouseEnter: When the cursor enters the Collider's on-screen area.
    • OnMouseExit: When the cursor exits the Collider's on-screen area.
    • OnMouseOver: When the cursor hovers over the Collider's on-screen area.
    • OnMouseDrag: When you drag the mouse over the Collider's on-screen area.
    Raycast Mouse Position Specifies whether to use a position EventAttribute as the result of a raycast towards the Collider.

    Rigid Body Collision Event Binder

    The Rigid Body Collision Event Binder triggers an Event in the target Visual Effect every time something collides with the Rigidbody attached to the same GameObject as this component. This binder also attaches the collision world position to the position EventAttribute, and the contact Normal to the velocity EventAttribute.

    Requires: A Rigidbody and a Collider on the same GameObject as this component.

    Properties:

    Properties Description
    Target The Visual Effect instance to trigger the Event on.
    Event Name The name of the event to trigger.

    Trigger Event Binder

    The Trigger Event Binder triggers an Event in the target Visual Effect every time a Collider from a list interacts with the attached trigger Collider. This binder also attaches the world position of the Collider instigator to the position EventAttribute.

    Requires: A Collider with Is Trigger set to true on the same GameObject as this component.

    Properties:

    Property Description
    Target The Visual Effect instance to trigger the Event on.
    Event Name The name of the Event to trigger.
    Colliders A list of Colliders that trigger the Event when something interacts with them.
    Activation Specifies which action triggers the Event:
    • OnEnter: Triggers the Event when any Collider enters the trigger.
    • OnExit: Triggers the Event when any Collider exits the trigger.
    • OnStay: Triggers the Event when any Collider stays in the trigger.

    Visibility Event Binder

    The Visibility Event Binder triggers an Event in the target Visual Effect every time the Renderer attached to this GameObject becomes visible or invisible.

    Requires: A Renderer on the same GameObject as this component.

    Properties:

    Property Description
    Target The Visual Effect instance to trigger the Event on.
    Event Name The name of the Event to trigger.
    Activation Specifies when to trigger the Event:
    • OnBecameVisible: Triggers the Event on the frame that the Renderer goes from invisible to visible.
    • OnBecameInvisible: Triggers the Event on the frame that the Renderer goes from visible to invisible.
    In This Article
    • Mouse Event Binder
    • Rigid Body Collision Event Binder
    • Trigger Event Binder
    • Visibility Event Binder
    Back to top
    Copyright © 2023 Unity Technologies — Terms of use
    • Legal
    • Privacy Policy
    • Cookies
    • Do Not Sell or Share My Personal Information
    • Your Privacy Choices (Cookie Settings)
    "Unity", Unity logos, and other Unity trademarks are trademarks or registered trademarks of Unity Technologies or its affiliates in the U.S. and elsewhere (more info here). Other names or brands are trademarks of their respective owners.
    Generated by DocFX on 18 October 2023