UnityGame/Library/PackageCache/com.unity.visualscripting/Documentation~/vs-nodes-events-on-mouse-up.md
2024-10-27 10:53:47 +03:00

4.3 KiB

On Mouse Up node

Note

The On Mouse Up [!includenodes-note-manual]

The On Mouse Up node listens for a user to release their mouse button after they click a Collider in your application. [!includenodes-desc-end]

The user can release their mouse button anywhere in your application to trigger the On Mouse Up node. If you want the node to trigger after the user releases the mouse button over the same Collider specified in the node's Target, use the On Mouse Up As Button node instead.

An image of the Graph window. An On Mouse Up node displays with its details in the Graph Inspector.

Fuzzy finder category

The On Mouse Up node is in the Events > Input category in the fuzzy finder.

Inputs

The On Mouse Up [!includenodes-single-input]

Name Type Description
Target GameObject The GameObject the user needs to click with their mouse button to have the On Mouse Up node listen for a mouse button release action. The user can release their mouse button anywhere to trigger the On Mouse Up node, but they must click the GameObject specified as the Target.

Additional node settings

The On Mouse Up [!includenodes-additional-settings]

[!include[nodes-coroutine](./snippets/nodes-coroutine.md)]
Name Type Description

Outputs

The On Mouse Up [!includenodes-single-output]

[!include[nodes-input-output-trigger](./snippets/input-manager/nodes-input-output-trigger.md)]
Name Type Description

Example graph usage

In the following example, the On Mouse Up node adds a force to a GameObject based on the user's mouse position when they release their mouse button. The On Mouse Up node triggers a Camera Screen To World Point node to get the user's mouse position, before it sends the X value of the mouse to a Rigidbody Add Force node to move the GameObject.

An image of the Graph window. An On Mouse Up node has its Target set to This. Its Trigger output node connects to the Invoke input port on a Camera Screen To World Point node. The Screen To World Point node gets its Target input from a Get Variable input node, which outputs the value of the MainCamera variable. The Screen To World Point node gets its Position Input from a Vector 3 Create node. The Vector 3 Create node takes its X input from an Input Get Mouse Position node, with a Vector 3 Get X node to get only the X value. It does the same for its Y input, with a Vector 3 Get Y node. The Screen To World Point node's Exit output trigger triggers the Invoke input port on a Rigidbody Add Force node, with its Target set to This and its Force Mode set to Velocity Change. The Rigidbody Add Force node takes an X input from the Screen To World Point Vector 3 Result output port, with a Vector 3 Get X node.

When the user clicks on the sphere in the middle of the scene and releases their mouse button, the sphere moves towards their mouse location.

An image of the Game view. Three red spheres sit on a plane. The middle sphere moves towards the sphere on the right and the mouse cursor.

[!includenodes-related] On Mouse Up node: