Component:MultiUserAvatarAnchor: Difference between revisions

From Resonite Wiki
add info about this not being an IAvatarAnchor in of itself
add more info again, remove some
Line 2: Line 2:
<translate>
<translate>
<!--T:1-->
<!--T:1-->
{{stub}}
{{Infobox Component
{{Infobox Component
|Image=MultiUserAvatarAnchorComponent.png
|Image=MultiUserAvatarAnchorComponent.png
Line 12: Line 11:
Multi User Avatar anchor allows you to auto generate anchors, but only if you have a [[Component:AvatarAnchorTouchTrigger|Avatar Anchor Touch Trigger Component]] on the same slot as the [[Collider|collider]] and the multi anchor has to be the same slot as well. It uses an [[Type:IAvatarAnchor|IAvatarAnchor type]] component as a template, and generates them in a shape based on a Snapper ([[Component:SnapCircle|Snap Circle Component]] or [[Component:SnapSphere|Snap Sphere Component]] to name a couple).  
Multi User Avatar anchor allows you to auto generate anchors, but only if you have a [[Component:AvatarAnchorTouchTrigger|Avatar Anchor Touch Trigger Component]] on the same slot as the [[Collider|collider]] and the multi anchor has to be the same slot as well. It uses an [[Type:IAvatarAnchor|IAvatarAnchor type]] component as a template, and generates them in a shape based on a Snapper ([[Component:SnapCircle|Snap Circle Component]] or [[Component:SnapSphere|Snap Sphere Component]] to name a couple).  


This component doesn't fall under a [[Type:IAvatarAnchor|IAvatarAnchor type]], and as such cannot be referenced by ProtoFlux. This means you can only anchor users with this component if they explicitly click on the anchor. it also doesn't give confirmation for the action, which may also be a bug.
The snapper component determines how the users will be positioned when clicking on the object. If
5. the anchor then anchors the user, and the user position is further determined by the anchor's positioning settings. If the anchor position in global space is too close to another anchor (determined by field MinDistance), then the user will not be anchored.


Currently, it only accepts out of sight physical touch or remote touch regardless of settings. May be a bug.
This component doesn't fall under a [[Type:IAvatarAnchor|IAvatarAnchor type]], and as such cannot be referenced by ProtoFlux. This means you can only anchor users with this component if they explicitly click on the anchor.  
 
It also doesn't give confirmation for clicking actions, which may be a bug.


<!--T:3-->
<!--T:3-->
Line 21: Line 23:
|AnchorPointSnap|IPointSnappable| A Snappable from [[:Category:Components:Transform:Snapping|snapping category]]
|AnchorPointSnap|IPointSnappable| A Snappable from [[:Category:Components:Transform:Snapping|snapping category]]
|MaxUsers|Int| the maximum users that can be in this multi anchor
|MaxUsers|Int| the maximum users that can be in this multi anchor
|MinDistance|Float|  
|MinDistance|Float| How close a new anchor can be to another when a user clicks on the anchor before it denies it. The location of the anchor before this check is done is determined by the component in AnchorPointSnap.
|Template|IAvatarAnchor| The [[Type:IAvatarAnchor|IAvatarAnchor]] to use as a template for making anchors. will duplicate the slot the anchor is on that this is referencing
|Template|IAvatarAnchor| The [[Type:IAvatarAnchor|IAvatarAnchor]] to use as a template for making anchors. will duplicate the slot the anchor is on that this is referencing
|AnchorsRoot|Slot| where to put the anchor slots when they are generated.
|AnchorsRoot|Slot| what shape to put the anchors when they are generated. The part of the shape the anchor is placed on is determined by the point the user clicked on. If user clicks on left side of a cube, user is positioned on the left face.
|AcceptOutOfSightTouch|Bool|  
|AcceptOutOfSightTouch|Bool| Whether this object allows an interaction to go through if the touch point is off screen.
|AcceptPhysicalTouch|Bool|  
|AcceptPhysicalTouch|Bool| Whether to allow a user to interact with this component via [[Component:TipTouchSource|tip touch sources]].
|AcceptRemoteTouch|Bool|  
|AcceptRemoteTouch|Bool| Whether to allow a user to interact with this component via laser.
}}
}}


Line 38: Line 40:
== Related Components ==
== Related Components ==
</translate>
</translate>
[[:Category:Components:Transform:Snapping|Snapping components]]
[[Category:Components{{#translation:}}|MultiUserAvatarAnchor (Component){{#translation:}}]]
[[Category:Components{{#translation:}}|MultiUserAvatarAnchor (Component){{#translation:}}]]
[[Category:ComponentStubs]]
[[Category:Components:Users:Common Avatar System:Anchors{{#translation:}}|MultiUserAvatarAnchor (Component){{#translation:}}]]
[[Category:Components:Users:Common Avatar System:Anchors{{#translation:}}|MultiUserAvatarAnchor (Component){{#translation:}}]]

Revision as of 19:14, 29 February 2024

Component image 
MultiUserAvatarAnchor component as seen in the Scene Inspector


Introduction

Multi User Avatar anchor allows you to auto generate anchors, but only if you have a Avatar Anchor Touch Trigger Component on the same slot as the collider and the multi anchor has to be the same slot as well. It uses an IAvatarAnchor type component as a template, and generates them in a shape based on a Snapper (Snap Circle Component or Snap Sphere Component to name a couple).

The snapper component determines how the users will be positioned when clicking on the object. If 5. the anchor then anchors the user, and the user position is further determined by the anchor's positioning settings. If the anchor position in global space is too close to another anchor (determined by field MinDistance), then the user will not be anchored.

This component doesn't fall under a IAvatarAnchor type, and as such cannot be referenced by ProtoFlux. This means you can only anchor users with this component if they explicitly click on the anchor.

It also doesn't give confirmation for clicking actions, which may be a bug.

Usage

Fields
Name Type Description
persistent Bool Determines whether or not this item will be saved to the server.
UpdateOrder Int Controls the order in which this component is updated.
Enabled Bool Controls whether or not this component is enabled.
AnchorPointSnap IPointSnappable A Snappable from snapping category
MaxUsers Int the maximum users that can be in this multi anchor
MinDistance Float How close a new anchor can be to another when a user clicks on the anchor before it denies it. The location of the anchor before this check is done is determined by the component in AnchorPointSnap.
Template IAvatarAnchor The IAvatarAnchor to use as a template for making anchors. will duplicate the slot the anchor is on that this is referencing
AnchorsRoot Slot what shape to put the anchors when they are generated. The part of the shape the anchor is placed on is determined by the point the user clicked on. If user clicks on left side of a cube, user is positioned on the left face.
AcceptOutOfSightTouch Bool Whether this object allows an interaction to go through if the touch point is off screen.
AcceptPhysicalTouch Bool Whether to allow a user to interact with this component via tip touch sources.
AcceptRemoteTouch Bool Whether to allow a user to interact with this component via laser.

Behavior

Examples

Related Components

Snapping components