DragDetector

Définit l'icône du curseur à afficher lorsque la souris est activée sur le parent de cette DragDetector .Si cette propriété est laissée vide, le détecteur utilisera l'icône par défaut.

Pour changer l'icône de curseur activée, définissez cette propriété sur l'ID de la ressource de l'image que vous souhaitez utiliser.

Lorsque false (par défaut), la force de contrainte est appliquée au point où l'utilisateur clique.Lorsque cela est vrai, la force est appliquée au centre de masse de l'objet.Seulement pertinent si ResponseStyle est Enum.DragDetectorResponseStyle.Physical et que l'objet parent n'est pas ancré.

L'axe principal de mouvement, exprimé par rapport au cadre de référence.Pour un DragStyle de Enum.DragDetectorDragStyle.TranslateLine , la direction de traduction ; pour Enum.DragDetectorDragStyle.TranslatePlane , la normale vers le plan de mouvement ; pour Enum.DragDetectorDragStyle.RotateAxis , l'axe de la rotation 1D.Changer cette valeur met automatiquement à jour Orientation et vice versa.

Si ReferenceInstance est configurer, le CFrame du pivot par rapport au cadre de référence ; sinon, le CFrame du pivot par rapport à son cadre au début du glissement.

Le paradigme utilisé pour générer une motion proposée, donné un flux de rayons curseurs. Voir Enum.DragDetectorDragStyle pour les options.

Si c'est vrai, le DragDetector répond à l'entrée de l'utilisateur ; s'il est faux, il ne le fait pas.

Pendant l'entrée du gamepad, le Enum.KeyCode pour activer le mode de mouvement secondaire.S'applique uniquement si le détecteur de glissement a DragStyle les deux modes de mouvement primaire et secondaire.

Pendant l'entrée au clavier, le Enum.KeyCode pour activer le mode de mouvement secondaire.S'applique uniquement si le détecteur de glissement a DragStyle les deux modes de mouvement primaire et secondaire.

Si cela est supérieur à MinDragAngle, la traduction sera clampée dans cette plage.

Ce n'est pas une contrainte ; il n'empêche simplement pas les tentatives du détecteur de mouvement de générer des mouvements afin de rester dans les limites.Voir AddConstraintFunction() pour ajouter une contrainte personnalisée à un glisser.

Seulement pertinent si DragStyle est Enum.DragDetectorDragStyle.RotateAxis.

Dans n'importe quelle dimension, si cela est supérieur à MinDragTranslation, la traduction sera clampée dans cette plage.

Ce n'est pas une contrainte ; il n'empêche simplement pas les tentatives du détecteur de mouvement de générer des mouvements afin de rester dans les limites.Voir AddConstraintFunction() pour ajouter une contrainte personnalisée à un glisser.

Force maximale appliquée à l'objet pour atteindre son objectif. Seulement pertinent si ResponseStyle est Enum.DragDetectorResponseStyle.Physical et que l'objet parent n'est pas ancré.

Couple maximum appliqué à l'objet pour atteindre son objectif. Seulement pertinent si ResponseStyle est Enum.DragDetectorResponseStyle.Physical et que l'objet parent n'est pas ancré.

Si c'est moins de MaxDragAngle, la traduction sera clampée dans cette plage.

Ce n'est pas une contrainte ; il n'empêche simplement pas les tentatives du détecteur de mouvement de générer des mouvements afin de rester dans les limites.Voir AddConstraintFunction() pour ajouter une contrainte personnalisée à un glisser.

Seulement pertinent si DragStyle est Enum.DragDetectorDragStyle.RotateAxis.

Dans n'importe quelle dimension, si c'est moins de MaxDragTranslation, la traduction sera clampée dans cette plage.

Ce n'est pas une contrainte ; il n'empêche simplement pas les tentatives du détecteur de mouvement de générer des mouvements afin de rester dans les limites.Voir AddConstraintFunction() pour ajouter une contrainte personnalisée à un glisser.

Spécifie la rotation YXZ des axes de mouvement par rapport au cadre de référence (ne change pas l'orientation du cadre de référence lui-même).La traduction linéaire et la rotation axiale seront sur cet axe réorienté Y , et la traduction planaire dans le plan XZ .Changer cette valeur met automatiquement à jour Axis et vice versa.

Contrôle le niveau d'autorisation pour lequel les joueurs peuvent interagir avec le DragDetector. La valeur par défaut est Enum.DragDetectorPermissionPolicy.Everybody.

Une instance dont le CFrame est le cadre de référence pour le détecteur de glissement.Le DragFrame est exprimé par rapport à ce CFrame qui peut être récupéré via la méthode GetReferenceFrame().

Si cette instance est une PVInstance , le cadre de référence sera son pivot ; si une Attachment , alors son monde sera CFrame .Si c'est nil ou aucun des deux précédents, le cadre de référence sera basé sur le pivot du parent du détecteur de glissement BasePart ou Model .

Une fois que la motion proposée a été calculée et potentiellement restreinte, c'est le paradigme utilisé pour mouvement, ou ne pas mouvement, les objets affectés par le DragDetector.Voir Enum.DragDetectorResponseStyle pour les options.

Les valeurs plus élevées font en sorte que l'objet atteigne son objectif plus rapidement. Seulement pertinent si ResponseStyle est Enum.DragDetectorResponseStyle.Physical et que l'objet parent n'est pas ancré.

Si false (par défaut), le client envoie des signaux répliqués (DragStart , DragContinue , DragEnd ) au serveur qui traite les curseurs et modifie le modèlisationde données, puis les réplique vers les clients.

Si c'est vrai, le client traite ces signaux lui-même et ne les réplique pas au serveur.Le client LocalScripts peut être utilisé pour répondre à ces événements et RemoteEvents peut être utilisé pour envoyer toutes les modifications résultantes qui devraient être répliquées sur le serveur.

L'axe secondaire de la motion. Relative à l'orientation en utilisant le même paradigme que Attachments .

Lorsque le curseur est en dehors du trackball, le DragDetector peut appliquer une rotation de traction radiale qui fait tourner la balle comme si elle essayait de rouler vers le curseur.Cette propriété est un multiplicateur de 0 à 1 pour ajouter cette rotation comme contribution au total.Seulement pertinent si DragStyle est Enum.DragDetectorDragStyle.RotateTrackball.

Lorsque le curseur est en dehors du trackball, le DragDetector peut appliquer une rotation en rouleau qui fait tourner la balle comme si elle était montée sur un disque vinyle face au spectateur.Cette propriété est un multiplicateur de 0 à 1 pour ajouter cette rotation de rouleau au total.Seulement pertinent si DragStyle est Enum.DragDetectorDragStyle.RotateTrackball.

Pendant l'entrée VR, le Enum.KeyCode pour activer le mode de mouvement secondaire.S'applique uniquement si le détecteur de glissement a DragStyle les deux modes de mouvement primaire et secondaire.

Le Axis exprimé dans l'espace du monde. Relève de l'orientation en utilisant le même paradigme que Attachments .

Le SecondaryAxis exprimé dans l'espace du monde. Relève de l'orientation en utilisant le même paradigme que Attachments .

Ajoute une fonction pour modifier ou restreindre la motion proposée.La fonction prend une entrée CFrame de la motion proposée et renvoie une CFrame de la motion modifiée ou non modifiée.Les entrées et les sorties sont exprimées par rapport au cadre de référence.Vous pouvez ajouter plusieurs fonctions qui seront appelées dans l'ordre par priority , en passant les résultats dans une chaîne.

Pour supprimer une fonction de contrainte ajoutée, appelez Disconnect() sur l'objet de connexion retourné.

Paramètres

Retours

Renvoie la référence CFrame dans laquelle le mouvement est exprimé ; voir la propriété ReferenceInstance pour plus de détails.

Retours

Peut être invoqué à partir d'un script pour redémarrer le glisser en utilisant de nouveaux paramètres, si les paramètres tels que DragStyle, Axis ou SecondaryAxis changent.

Retours

Passe une fonction à utiliser si et seulement si DragStyle est défini sur Enum.DragDetectorDragStyle.Scriptable.La fonction donnée est appelée lors de la réponse à un signal DragContinue , elle reçoit le rayon de curseur du monde du signal avec le type Ray , et elle renvoie un CFrame contenant la position et l'orientation souhaitées du pivot dans l'espace du monde.

Si la fonction renvoie nil, l'objet ne sera pas déplacé.Cela est utile si le script n'a pas encore collecté toutes les informations dont il a besoin pour donner la bonne réponse, ou dans des cas temporaires où vous voulez que l'objet reste où il est.

Paramètres

Retours

Passe une fonction à utiliser si et seulement si PermissionPolicy est défini sur Enum.DragDetectorPermissionPolicy.Scriptable.La fonction donnée accepte un paramètre Player pour activer/désactiver le détecteur pour un joueur spécifique.Il reçoit également un paramètre part indiquant lequel des spécifiques BasePart a été cliqué, comme une partie dans une partie glissable Model ; cela est utile pour activer/désactiver le détecteur en fonction de la valeur Name , Color , HasTag() du partie, ou d'autres détails.

local dragDetector = script.Parent.DragDetector
dragDetector.PermissionPolicy = Enum.DragDetectorPermissionPolicy.Scriptable

dragDetector:SetPermissionPolicyFunction(function(player, part)
	if player and player:GetAttribute("IsInTurn") then
		return true
	elseif part and not part:GetAttribute("IsDraggable") then
		return false
	else
		return true
	end
end)

Paramètres

Retours

S'enflamme lorsqu'un utilisateur poursuit le glissement de l'objet après que DragStart ait été initié.

Paramètres

S'enflamme lorsqu'un utilisateur arrête de faire glisser l'objet.

Paramètres

S'enflamme lorsqu'un utilisateur commence à faire glisser l'objet.

Paramètres