DragDetector

Setzt das Cursor-Symbol so ein, dass es angezeigt wird, wenn die Maus über dem Elternteil dieser DragDetector aktiviert ist.Wenn diese Eigenschaft leer gelassen wird, verwendet der Detektor das Standard-Symbol.

Um das aktivierte Symbolzu ändern, legen Sie diese Eigenschaft auf die Asset-ID des Bildes fest, das Sie verwenden möchten.

Wenn falsch (Standard), wird die Einschränkungskraft am Punkt angewendet, auf den der Benutzer klickt.Wenn wahr, wird Kraft am Zentrum der Masse des Objekts angewendet.Nur relevant, wenn ResponseStyle ist Enum.DragDetectorResponseStyle.Physical und das zugeordnete Objekt unverankert ist.

Die primäre Bewegungsachse, ausgedrückt in Bezug auf den Referenzrahmen.Für ein DragStyle von Enum.DragDetectorDragStyle.TranslateLine , die Richtung der Übersetzung; für Enum.DragDetectorDragStyle.TranslatePlane , die normale zur Bewegungsfläche; für Enum.DragDetectorDragStyle.RotateAxis , die Achse der 1D-Rotation.Das Ändern dieses Werts aktualisiert automatisch Orientation und umgekehrt.

Wenn ReferenceInstance festlegenist, das CFrame des Pivots im Verhältnis zum Referenzrahmen; ansonsten das CFrame des Pivots im Verhältnis zu seinem Rahmen zu Beginn des Ziehens.

Das Paradigma, das verwendet wird, um einen vorgeschlagenen Vorschlag zu generieren, gegeben einen Strom von Cursorstrahlen. Siehe Enum.DragDetectorDragStyle für Optionen.

Wenn true, reagiert der DragDetector auf die Eingabe des Benutzers; wenn false, tut er es nicht.

Während der Gamepad-Eingabe, das Enum.KeyCode zum Umschalten des sekundären Bewegungsmodus.Gilt nur, wenn der Ziehdetektor DragStyle sowohl primäre als auch sekundäre Bewegungsmodi hat.

Während der Tastatureingabe wird die Enum.KeyCode zum Umschalten des sekundären Bewegungsmodus.Gilt nur, wenn der Ziehdetektor DragStyle sowohl primäre als auch sekundäre Bewegungsmodi hat.

Wenn dies größer als MinDragAngle ist, wird die Übersetzung innerhalb dieses Bereichs gekappt.

Dies ist keine Beschränkung; es hindert nur die Versuche des Ziehdetektors, Bewegung zu generieren, um innerhalb der Grenzen zu bleiben.Siehe AddConstraintFunction(), um eine benutzerdefinierte Einschränkung zu einem Ziehen hinzuzufügen.

Nur relevant, wenn DragStyle relevant ist Enum.DragDetectorDragStyle.RotateAxis.

In jeder Dimension, wenn dies größer als MinDragTranslation ist, wird die Übersetzung innerhalb dieses Bereichs gekappt.

Dies ist keine Beschränkung; es hindert nur die Versuche des Ziehdetektors, Bewegung zu generieren, um innerhalb der Grenzen zu bleiben.Siehe AddConstraintFunction(), um eine benutzerdefinierte Einschränkung zu einem Ziehen hinzuzufügen.

Maximale Kraft, die für das Objekt angewendet wird, um sein Ziel zu erreichen. Nur relevant, wenn ResponseStyle ist Enum.DragDetectorResponseStyle.Physical und das zugeordnete Objekt unverankert ist.

Maximales Drehmoment für das Objekt, um sein Ziel zu erreichen. Nur relevant, wenn ResponseStyle ist Enum.DragDetectorResponseStyle.Physical und das zugeordnete Objekt unverankert ist.

Wenn dies weniger als MaxDragAngle ist, wird die Übersetzung innerhalb dieses Bereichs gekappt.

Dies ist keine Beschränkung; es hindert nur die Versuche des Ziehdetektors, Bewegung zu generieren, um innerhalb der Grenzen zu bleiben.Siehe AddConstraintFunction(), um eine benutzerdefinierte Einschränkung zu einem Ziehen hinzuzufügen.

Nur relevant, wenn DragStyle relevant ist Enum.DragDetectorDragStyle.RotateAxis.

In jeder Dimension, wenn dies weniger als MaxDragTranslation ist, wird die Übersetzung innerhalb dieses Bereichs gekappt.

Dies ist keine Beschränkung; es hindert nur die Versuche des Ziehdetektors, Bewegung zu generieren, um innerhalb der Grenzen zu bleiben.Siehe AddConstraintFunction(), um eine benutzerdefinierte Einschränkung zu einem Ziehen hinzuzufügen.

Gibt die YXZ -Drehung der Bewegungsachsen im Vergleich zum Referenzrahmen an (ändert nicht die Orientierung des Referenzrahmens selbst).Lineare Translation und axiale Rotation werden auf dieser umorientierten Y -Achse und planare Translation in der XZ -Ebene sein.Das Ändern dieses Werts aktualisiert automatisch Axis und umgekehrt.

Steuert das Berechtigungslevel, mit dem Spieler mit dem DragDetector interagieren können. Standard ist Enum.DragDetectorPermissionPolicy.Everybody .

Eine Instanz, deren CFrame der Referenzrahmen für den Drag-Detektor istDie DragFrame wird relativ zu dieser CFrame zum Ausdruck gebracht, die über die GetReferenceFrame()-Methode abgerufen werden kann.

Wenn diese Instanz ein PVInstance ist, ist der Referenzrahmen ihr Punkt; wenn ein Attachment , dann ist seine Welt CFrame .Wenn es nil oder keines der beiden früheren ist, wird der Referenzrahmen auf den Pivot des Drag-Detektors-Parents basieren BasePart oder Model.

Sobald die vorgeschlagene Bewegung berechnet und möglicherweise eingeschränkt wurde, ist dies das Paradigma, mit dem die von der DragDetector betroffenen Objekte Verschiebungswerkzeugoder nicht Verschiebungswerkzeugwerden.Siehe Enum.DragDetectorResponseStyle für Optionen.

Höhere Werte veranlassen, dass das Objekt sein Ziel schneller erreicht. Nur relevant, wenn ResponseStyle ist Enum.DragDetectorResponseStyle.Physical und das übergeordnete Objekt unverankert ist.

Wenn falsch (Standard), sendet der Client replizierte Signale ( DragStart , DragContinue , DragEnd ) an den Server, der den Cursorstrahl verarbeitet, das Modelländert und ihn an Clients weiterreicht.

Wenn es wahr ist, verarbeitet der Client diese Signale selbst und repliziert sie nicht auf den Server.Client LocalScripts kann verwendet werden, um auf diese Ereignisse zu reagieren, und RemoteEvents kann verwendet werden, um alle daraus resultierenden Änderungen an den Server zu senden, die repliziert werden sollen.

Die sekundäre Achse der Bewegung. Bezieht sich auf Orientierung mit demselben Paradigma wie Attachments.

Wenn der Cursor außerhalb des Trackballs ist, kann die DragDetector eine radiale Ziehrotierung anwenden, die den Ball so dreht, als ob er sich auf den Cursor ausrollen würde.Diese Eigenschaft ist ein Multiplikator von 0 bis 1 für das Hinzufügen dieser Rotation als Beitrag zum Gesamtbetrag.Nur relevant, wenn DragStyle relevant ist Enum.DragDetectorDragStyle.RotateTrackball.

Wenn der Cursor außerhalb des Trackballs ist, kann die DragDetector eine Roll rotation anwenden, die den Ball so dreht, als wäre er auf einem Vinyl-Record montiert, der auf den Betrachter ausgerichtet ist.Diese Eigenschaft ist ein Multiplikator von 0 bis 1 für das Hinzufügen dieser Roll rotation zum Gesamtbetrag.Nur relevant, wenn DragStyle relevant ist Enum.DragDetectorDragStyle.RotateTrackball.

Während der VR-Eingabe wird der Enum.KeyCode zum Umschalten des sekundären Bewegungsmodus.Gilt nur, wenn der Ziehdetektor DragStyle sowohl primäre als auch sekundäre Bewegungsmodi hat.

Die Axis im Platzausgedrückte. Bezieht sich auf Orientierung mit demselben Paradigma wie Attachments.

Die SecondaryAxis im Platzausgedrückte. Bezieht sich auf Orientierung mit demselben Paradigma wie Attachments.

Fügt eine Funktion hinzu, um vorgeschlagene Bewegung zu modifizieren oder einzuschränken.Die Funktion nimmt eine Eingabe CFrame von vorgeschlagenem Antrag und gibt eine CFrame von modifiziertem oder unmodifiziertem Antrag zurück.Sowohl die Eingabe als auch die Ausgabe werden in Bezug auf den Referenzrahmen ausgedrückt.Du kannst mehrere Funktionen hinzufügen, die nach priority aufgerufen werden, und die Ergebnisse in einer Kette weitergeben.

Um eine hinzugefügte Einschränkungsfunktion zu entfernen, rufe Disconnect() auf das zurückgegebene Objektauf.

Parameter

Rückgaben

Gibt die Referenz zurück CFrame, in der die Bewegung zum Ausdruck kommt; siehe die Eigenschaft ReferenceInstance für weitere Details.

Rückgaben

Kann von einem Skript aus aufgerufen werden, um das Ziehen mit neuen Parametern neu zu starten, wenn sich Parameter wie DragStyle, Axis oder SecondaryAxis ändern.

Rückgaben

Überlässt eine Funktion, die verwendet wird, wenn und nur wenn DragStyle auf Enum.DragDetectorDragStyle.Scriptable gesetzt ist.Die angegebene Funktion wird aufgerufen, wenn auf ein DragContinue Signal reagiert wird, es erhält den Welt空间-Cursor des Signals mit Typ Ray und gibt einen CFrame zurück, der die gewünschte Position und Ausrichtung des Pivots im Platzenthält.

Wenn die Funktion nil zurückgibt, wird das Objekt nicht verschoben.Dies ist nützlich, wenn das Skript noch nicht alle Informationen gesammelt hat, die es benötigt, um die richtige Antwort zu geben, oder in vorübergehenden Fällen, in denen Sie möchten, dass das Objekt dort bleibt, wo es ist.

Parameter

Rückgaben

Überlässt eine Funktion, die verwendet wird, wenn und nur wenn PermissionPolicy auf Enum.DragDetectorPermissionPolicy.Scriptable gesetzt ist.Die angegebene Funktion akzeptiert einen Player -Parameter für die Aktivierung/Deaktivierung des Detektors für einen bestimmten Spieler:in.Es erhält auch einen part -Parameter, der anzeigt, welcher spezifische BasePart angeklickt wurde, wie zum Beispiel ein Teil innerhalb eines ziehbares Model ; dies ist nützlich, um den Detektor basierend auf dem Wert von Name , Color , HasTag() zu aktivieren/deaktivieren oder andere Details.

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)

Parameter

Rückgaben

Feuert, wenn ein Benutzer das Objekt weiter zieht, nachdem DragStart initiiert wurde.

Parameter

Feuert, wenn ein Benutzer aufhört, das Objekt zu ziehen.

Parameter

Feuert, wenn ein Benutzer beginnt, das Objekt zu ziehen.

Parameter