(One intermediate revision by one other user not shown)
Line 15:
Line 15:
|OverrideParent|Slot| If not null, the slot that the [[Grabbable_(Component)|Grabbable]] object gets reparented to, if ParentPlaced is true.
|OverrideParent|Slot| If not null, the slot that the [[Grabbable_(Component)|Grabbable]] object gets reparented to, if ParentPlaced is true.
|TweenTime|Float| The amount of time in seconds for the animation effect when the object snaps to the surface.
|TweenTime|Float| The amount of time in seconds for the animation effect when the object snaps to the surface.
|MaxDistance|Float|
|MaxDistance|Float|
|Offset|Float| The distance from the surface that the [[Grabbable_(Component)|Grabbable]] object will stop at.
|Offset|Float| The distance from the surface that the [[Grabbable_(Component)|Grabbable]] object will stop at.
|CheckOffset|Float|
|CheckOffset|Float|
|Directions|Float3|List of directions a [[Grabbable_(Component)|Grabbable]] object can be received from.
|Directions|{{RootFieldType|SyncFieldList`1|[[Type:Float3|Float3]]}}|TypeAdv6=true|List of directions a [[Grabbable_(Component)|Grabbable]] object can be received from.
# After both distance checks a final distance value is provided.
# After both distance checks a final distance value is provided.
# The [[Grabbable_(Component)|Grabbable]] then selects the surface with the smallest distance and tells the Surface to receive it.
# The [[Grabbable_(Component)|Grabbable]] then selects the surface with the smallest distance and tells the Surface to receive it.
# The Surface will then position the [[Grabbable_(Component)|Grabbable]] upon the surface using an Animation if a <code>Tween Time</code> value is set.
# The Surface will then position the [[Grabbable_(Component)|Grabbable]] upon the surface using an Animation of a <code>Tween Time</code> value is set.
# The Surface will then parent the [[Grabbable_(Component)|Grabbable]] to itself or the <code>OverrideParent</code> location if the <code>ParentPlaced</code> checkbox is checked.
# The Surface will then parent the [[Grabbable_(Component)|Grabbable]] to itself or the <code>OverrideParent</code> location if the <code>ParentPlaced</code> checkbox is checked.
This article or section is a Stub. You can help the Resonite Wiki by expanding it.
Component image
GrabbableReceiverSurface component as seen in the Scene Inspector
Intoduction
The GrabbableReceiverSurface component allows you to set up an object so that Grabbable objects snap to its surface when a user releases the Grabbable object within range of it.
When a GrabbableReceiverSurface is setup on an object, it will become visible to Grabbable objects when they are released from a user's grab. When this occurs the Surface will carry out some checks and if these pass the object will snap to the GrabbableReceiverSurface. If the ParentPlaced checkbox is enable the Grabbable will be parented to the surface or the slot specified in OverrideParent
Explanation of the Checks
These are a little complicated but if you want to fully understand what happens it is provided.
When a user is holding a Grabbable object and let's go(releases it):
The Grabbable object will look around it in its vicinity using a sphere collider based on the Object's bounding box plus a radius defined on the User's Hand
If this collider overlaps with any objects which have GrabbableRecieverSurface attached to them then the Grabbable will perform some checks on each surface.
First it asks the Surface to check its distance from the Grabbable object.
The distance check first calculates if a Raycast from the released object towards the surface would hit in the directions specified in the component.
If the Raycast would hit a distance is then calculated.
This distance varies depending on the directions specified in the component's properties.
For example, placing an object on top of a cube from above has a shorter distance to the top of the Cube than the bottom of a cube because the distance from above the cube to the bottom face of the cube is greater.
If this distance is to great as specified in the component's properties a second check using the released object's bounding box corners is also computed
After both distance checks a final distance value is provided.
The Grabbable then selects the surface with the smallest distance and tells the Surface to receive it.
The Surface will then position the Grabbable upon the surface using an Animation of a Tween Time value is set.
The Surface will then parent the Grabbable to itself or the OverrideParent location if the ParentPlaced checkbox is checked.
