DragDetector

Establece el icono del cursor para mostrar cuando el mouse está activado sobre el padre de este DragDetector .Si esta propiedad se deja en blanco, el detector usará el íconopredeterminado.

Para cambiar el íconodel cursor activado, establece esta propiedad en el ID de activo de la imagen que te gustaría usar.

Cuando es falso (por defecto), se aplica la fuerza de restricción en el punto en el que el usuario hace clic.Cuando es verdadero, se aplica la fuerza en el centro de masa del objeto.Solo es relevante si ResponseStyle es Enum.DragDetectorResponseStyle.Physical y el objeto padre no está anclado.

El eje principal de movimiento, expresado en relación con el marco de referencia.Para un DragStyle de Enum.DragDetectorDragStyle.TranslateLine , la dirección de traducción; para Enum.DragDetectorDragStyle.TranslatePlane , la normal al plano de movimiento; para Enum.DragDetectorDragStyle.RotateAxis , el eje de rotación de 1D.Cambiar este valor actualiza automáticamente Orientation y viceversa.

Si ReferenceInstance está establecer, el CFrame del pivote relativo al marco de referencia; de lo contrario, el CFrame del pivote relativo a su marco al comienzo del arrastre.

El paradigma utilizado para generar la propuesta de movimiento, dado un flujo de rayos del cursor. Vea Enum.DragDetectorDragStyle para las opciones.

Si es verdadero, el DragDetector responde a la entrada del usuario; si es falso, no lo hace.

Durante la entrada del gamepad, el Enum.KeyCode para alternar el modo secundario de movimiento.Solo se aplica si el detector de arrastre tiene DragStyle ambos modos de movimiento primario y secundario.

Durante la entrada del teclado, el Enum.KeyCode para alternar el modo secundario de movimiento.Solo se aplica si el detector de arrastre tiene DragStyle ambos modos de movimiento primario y secundario.

Si esto es mayor que MinDragAngle, la traducción se recortará dentro de ese rango.

Esto no es una restricción; simplemente impide que los intentos del detector de arrastre generen movimiento para permanecer dentro de los límites.Vea AddConstraintFunction() para agregar una restricción personalizada a un arrastrado.

Solo es relevante si DragStyle es Enum.DragDetectorDragStyle.RotateAxis.

En cualquier dimensión, si esto es mayor que MinDragTranslation, la traducción se recortará dentro de ese rango.

Esto no es una restricción; simplemente impide que los intentos del detector de arrastre generen movimiento para permanecer dentro de los límites.Vea AddConstraintFunction() para agregar una restricción personalizada a un arrastrado.

Fuerza máxima aplicada al objeto para alcanzar su objetivo. Solo es relevante si ResponseStyle es Enum.DragDetectorResponseStyle.Physical y el objeto padre no está anclado.

Máximo momento de torsión aplicado al objeto para alcanzar su objetivo. Solo es relevante si ResponseStyle es Enum.DragDetectorResponseStyle.Physical y el objeto padre no está anclado.

Si esto es menos de MaxDragAngle, la traducción se recortará dentro de ese rango.

Esto no es una restricción; simplemente impide que los intentos del detector de arrastre generen movimiento para permanecer dentro de los límites.Vea AddConstraintFunction() para agregar una restricción personalizada a un arrastrado.

Solo es relevante si DragStyle es Enum.DragDetectorDragStyle.RotateAxis.

En cualquier dimensión, si esto es menos de MaxDragTranslation , la traducción se recortará dentro de ese rango.

Esto no es una restricción; simplemente impide que los intentos del detector de arrastre generen movimiento para permanecer dentro de los límites.Vea AddConstraintFunction() para agregar una restricción personalizada a un arrastrado.

Specifica la rotación YXZ de los ejes de movimiento relativos al marco de referencia (no cambia la orientación del propio marco de referencia).La traducción lineal y la rotación axial estarán en este eje reorientado Y y la traducción plana en el plano XZ .Cambiar este valor actualiza automáticamente Axis y viceversa.

Controla el nivel de permiso para el cual los jugadores pueden interactuar con el DragDetector . El predeterminado es Enum.DragDetectorPermissionPolicy.Everybody .

Una instancia cuyo CFrame es el marco de referencia para el detector de arrastre.El DragFrame se expresa en relación con este CFrame que se puede recuperar a través del método GetReferenceFrame().

Si esta instancia es un PVInstance , el marco de referencia será su pivote; si es un Attachment , entonces su mundo será CFrame .Si es nil o ninguno de los anteriores, el marco de referencia se basará en el pivote del padre del detector de arrastre BasePart o Model .

Una vez que se haya calculado y potencialmente restringido la moción propuesta, este es el paradigma utilizado para herramienta de movimiento, o no herramienta de movimiento, los objetos afectados por el DragDetector .Vea Enum.DragDetectorResponseStyle para opciones.

Los valores más altos hacen que el objeto alcance su objetivo más rápidamente. Solo es relevante si ResponseStyle es Enum.DragDetectorResponseStyle.Physical y el objeto padre no está anclado.

Si es falso (por defecto), el cliente envía señales replicadas (DragStart, DragContinue, DragEnd) al servidor que procesa los rayos del cursor, realiza cambios en el aplicación de modeladode datos y los replica hacia los clientes.

Si es verdadero, el cliente procesa esas señales por sí mismo y no las replica al servidor.El cliente LocalScripts se puede utilizar para responder a estos eventos y RemoteEvents se puede utilizar para enviar cualquier cambio resultante que deba replicarse al servidor.

El eje secundario del movimiento. Se relaciona con la orientación utilizando el mismo paradigma que Attachments .

Cuando el cursor está fuera del trackball, el DragDetector puede aplicar una rotación de fuerza radial que gira la bola como si estuviera tratando de rodar hacia el cursor.Esta propiedad es un multiplicador de 0 a 1 para agregar esa rotación como una contribución al total.Solo es relevante si DragStyle es Enum.DragDetectorDragStyle.RotateTrackball.

Cuando el cursor está fuera del trackball, el DragDetector puede aplicar una rotación de rodillo que gira la bola como si estuviera montada en un registro de vinilo que se enfrenta al espectador.Esta propiedad es un multiplicador de 0 a 1 para agregar esa rotación de rodillo al total.Solo es relevante si DragStyle es Enum.DragDetectorDragStyle.RotateTrackball.

Durante la entrada VR, el Enum.KeyCode para alternar el modo secundario de movimiento.Solo se aplica si el detector de arrastre tiene DragStyle ambos modos de movimiento primario y secundario.

El Axis expresado en el espacio mundial. Se relaciona con la orientación usando el mismo paradigma que Attachments .

El SecondaryAxis expresado en el espacio mundial. Se relaciona con la orientación usando el mismo paradigma que Attachments .

Añade una función para modificar o limitar el movimiento propuesto.La función toma una entrada CFrame de la moción propuesta **** y devuelve una entrada CFrame de la moción modificada **** o no modificada.Ambas entradas y salidas se expresan en relación con el marco de referencia.Puedes agregar múltiples funciones que se llamarán en orden por priority , pasando los resultados en una cadena.

Para eliminar una función de restricción agregada, llame a Disconnect() en el objeto de conexión devuelto.

Parámetros

Devuelve

Devuelve la referencia CFrame en la que se expresa el movimiento; vea la propiedad ReferenceInstance para más detalles.

Devuelve

Puede invocarse desde un script para reiniciar el arrastre usando nuevos parámetros, si los parámetros como DragStyle, Axis o SecondaryAxis cambian.

Devuelve

Pasa una función para usar si y solo si DragStyle está configurado como Enum.DragDetectorDragStyle.Scriptable.La función dada se llama al responder a una señal DragContinue , recibe el rayo del cursor del mundo de la señal con el tipo Ray , y devuelve un CFrame que contiene la ubicación y orientación deseada del pivote en el espacio mundial.

Si la función devuelve nil, el objeto no se moverá.Esto es útil si el script aún no ha recopilado toda la información que necesita para dar la respuesta correcta, o en casos temporales en los que quieres que el objeto se quede donde está.

Parámetros

Devuelve

Pasa una función para usar si y solo si PermissionPolicy está configurado como Enum.DragDetectorPermissionPolicy.Scriptable.La función dada acepta un parámetro Player para activar/desactivar el detector para un jugador específico.También recibe un parámetro part que indica qué específico BasePart se hizo clic, como una parte dentro de un elemento arrastrable Model ; esto es útil para habilitar/deshabilitar el detector en función del valor Name , Color , HasTag() del elemento, o de otros detalles.

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)

Parámetros

Devuelve

Se enciende cuando un usuario continúa arrastrando el objeto después de que DragStart se haya iniciado.

Parámetros

Se activa cuando un usuario deja de arrastrar el objeto.

Parámetros

Se activa cuando un usuario comienza a arrastrar el objeto.

Parámetros