Skip to content

Commit e117f14

Browse files
author
Julia Schwarz
authored
Pointer documentation improvemetn
- Flesh out pokepointer and mousepointer sections - Fix broken link
1 parent cd679ad commit e117f14

File tree

1 file changed

+13
-3
lines changed

1 file changed

+13
-3
lines changed

Documentation/README_Pointers.md

Lines changed: 13 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
# Pointers
22
![Pointer](../External/ReadMeImages/Pointers/MRTK_Pointer_Main.png)
33

4-
A pointer is something attached to a controller that gives focus and dispatches inputs to the game object it is pointing to <sup>[1](https://github.com/luis-valverde-ms/MixedRealityToolkit-Unity/blob/feature/input_docs/Documentation/Input/InputSystem.md)</sup>.
4+
A pointer is something attached to a controller that gives focus and dispatches inputs to the game object it is pointing to. Learn more about the MRTK input system [here](./Input/Overview.md), and a scripting/engineering overview of pointers [here](./Input/Pointers.md).
55

66
For a game object to be able to receive focus it must have a collider (so it can be hit by physics raycasts) and belong to one of the layers defined in the Pointer Raycast Layer Masks in the Pointer Profile.
77

@@ -56,14 +56,24 @@ Debug Mode - If true, draw the sphere that is used to query for grabbable object
5656

5757
Poke pointer is for near interactions, specifically for touching objects via the hand / controller.
5858

59+
**NOTE:** Only items with _Near Interaction Touchable_ components will respond to the poke pointer.
60+
61+
#### Configuring NearInteractionTouchable
62+
When configuring your _Near Interaction Touchable_, make sure to configure the _localForward_ parameter to point out of the front of the button or other object you wish to make touchable. Also make sure that the touchable's _bounds_ matches the bounds of your touchable object.
63+
64+
Other parameters:
65+
66+
- eventsToReceive - if set to Touch, the object will receive _OnTouchDown_ _OnTouchUpdate_ and _OnTouchUp_ events. If set to pointer, the object will receive _OnPointerDown_ and _OnPointerUp_ events.
67+
- touchableSurface - use this to help compute the bounds of the surface. Bounds will automatically adjust to the attached BoxCollider, UnityUI element, or can be set manually by adjusting _bounds_
68+
5969

6070

6171
### Mouse pointer
6272
![Mouse Pointer](../External/ReadMeImages/Pointers/MRTK_MousePointer.jpg)
6373

64-
Mouse pointer is used for interacting with the mouse.
74+
Mouse pointer is used for interacting with the mouse. This pointer will only be used if the active input is a Mouse. By default, the MRTK Input Profile does not provide a mouse as an input provider, as mouse input is instead used to simulate hand input. You may add a mouse in your MRTK profily by modifying the _Registered Service Providers_ in your MRTK profile.
6575

6676
### Teleport pointer
6777
<img src="/External/ReadMeImages/Pointers/MRTK_Pointers_Parabolic.png" width="600">
6878

69-
Teleport pointer is used for teleportation.
79+
Teleport pointer is used for teleportation. This pointer will only be active when using a controller that supports teleportation (such as a motion controller like in Oculus, Vive, Windows Mixed Reality).

0 commit comments

Comments
 (0)