Anclajes y puntos de ajuste

Dale a un círculo un lugar al que regresar, o deja que una liberación elija su próximo punto de descanso. Los archivos adjuntos y las instantáneas amplían la entrada nativa physicsWorld() en 0.1.0-rc.1. Reconstruya la aplicación nativa.

Simulador iOS: el arrastre real estira la correa de cobre; Los lanzamientos lentos y rápidos mueven el círculo lila entre los muelles. Dibujo de líneas nativo, reorientación de anclaje, pausa/reanudación y reducción de movimiento. Interfaz de usuario en inglés, sincronización de fuente grabada.

Emulador Android: las mismas interacciones con gestos reales de ADB, pasos nativos de resorte/colisión y dibujo de correa nativo. Interfaz de usuario en inglés, sincronización de la fuente grabada; no es una medida del rendimiento del dispositivo físico.

Crea el mundo después del diseño. Los límites de contenedor dedicado, vistas de círculo cuadrado, propiedad, densidad y cuerpo de física del círculo aún se aplican.

import { physicsWorld } from '@rafaelaugusto/jolt/physics'

// board is 320 × 360; copper is 56 × 56 and lilac is 52 × 52.
const world = physicsWorld(board, [
  {
    id: 'copper',
    view: copper,
    radius: 28,
    x: 160,
    y: 130,
    attachment: {
      anchor: { x: 160, y: 50 },
      length: 72,
      stiffness: 180,
      damping: 14,
      line: { color: '#DBB994', width: 1.5 },
    },
  },
  {
    id: 'lilac',
    view: lilac,
    radius: 26,
    x: 160,
    y: 280,
    snap: {
      points: [
        { x: 64, y: 280 },
        { x: 160, y: 280 },
        { x: 256, y: 280 },
      ],
      stiffness: 220,
      damping: 25,
      projection: 0.12,
    },
  },
])
world.snapTo('lilac', 1) // Optional initial dock; release selection is automatic.
// Later, retarget without resetting the current velocity:
world.attach('copper', { anchor: { x: 100, y: 50 }, length: 72 })
world.snapTo('lilac', 2)
// Remove the anchor spring and any selected snap:
world.attach('copper', null)
// On permanent teardown (or use an owning motionScope):
world.dispose()

Muelle de anclaje

Un attachment conecta un centro de carrocería a un punto fijo en el contenedor. anchor usa DIPs local y debe comenzar dentro de la placa. length es la longitud de reposo del resorte, 0–10000 DIPs (0 predeterminado). Es una distancia elástica, no un límite de cuerda dura. El equilibrio de un cuerpo colgante incluye estiramiento gravitacional: en una configuración vertical, la distancia adicional es mass * gravity / stiffness.

stiffness es fuerza por DIP, 1–1000 (predeterminado 180). damping es una amortiguación viscosa, 0–120 (predeterminado 24), distinta de la amortiguación de velocidad exponencial del mundo. La masa corporal existente afecta la respuesta. El integrador nativo de paso fijo aplica la fuerza del resorte y la amortiguación viscosa implícita junto con las colisiones y el límite de velocidad existente.

El line opcional dibuja la conexión desde el anclaje hasta el borde del círculo. Su color es #RRGGBB; el ancho es 0,5–6 DIPs (predeterminado 1,5). iOS utiliza una capa de forma y Android un dibujable. La marca del mundo nativo existente actualiza la línea; no hay reloj de pantalla adicional ni observador JavaScript. La reorientación reemplaza toda la configuración de los archivos adjuntos, incluido el estilo de línea. Omitir line elimina la línea anterior.

Liberar ajuste

snap.points contiene de 1 a 8 centros de círculo válidos y distintos. El círculo comienza sin un muelle seleccionado; use snapTo(id, index) si debe comenzar adjunto a uno. En la versión nativa, Jolt limita la velocidad del puntero entrante, proyecta la posición de liberación del cuerpo mediante velocity * projection y luego selecciona el punto más cercano. projection es de 0 a 0,3 segundos (valor predeterminado: 0,12); cero elige por posición actual. Los lazos de igual distancia eligen el primer punto configurado.

El resorte elástico conserva la velocidad de liberación y se asienta hacia el centro seleccionado. La gravedad se suprime para el movimiento seleccionado de ese cuerpo para que no se asiente debajo del muelle. La resolución de colisiones todavía se aplica: un muelle ocupado puede impedir la llegada. snapshot().bodies[i].snap informa el índice/punto elegido y si el círculo está dentro de 0,25 DIP a baja velocidad; No promete reserva exclusiva. El diagnóstico nativo release registra la posición y la velocidad limitada antes de la selección/integración rápida.

La rigidez/amortiguación rápida utilizan los mismos rangos/valores predeterminados que los resortes de fijación. Un cuerpo puede configurar ambos comportamientos: el complemento seleccionado tiene prioridad; un nuevo arrastre suspende las fuerzas del resorte, y su liberación vuelve a elegir. La línea opcional apunta entonces al objetivo de resorte efectivo.

Comandos, cancelación y diseño

• attach(id, options | null) reemplaza/elimina el anclaje, borra el ajuste seleccionado y conserva la velocidad. Acepta cambios mientras está en pausa, pero los límites no válidos deben ajustarse a los círculos antes de realizar la reorientación.
• snapTo(id, index) selecciona un objetivo configurado, incluso mientras está en pausa. Ignora un cuerpo que está siendo arrastrado actualmente. Proporcione botones accesibles para este comando junto con la manipulación directa.
• El arrastre nativo es cinemático. Cancelación, pausa, descarga, fondo y Reducción de movimiento liberan el cuerpo retenido con velocidad cero y restauran su ajuste seleccionado anterior; no eligen un nuevo muelle a partir de un gesto cancelado.
• reset() restaura posiciones/velocidades iniciales, borra muelles seleccionados y libera diagnósticos, y mantiene las configuraciones actuales de puntos/accesorios. Llame nuevamente a snapTo() para seleccionar una base inicial.
• Los anclajes y puntos se escalan con los límites del contenedor utilizando coordenadas normalizadas almacenadas; los puntos se sujetan a centros de círculo válidos sin acumular cambios de tamaño. El radio del círculo y la longitud del soporte del accesorio permanecen fijos en DIPs. Cambiar tamaño cancela un cuerpo retenido y borra las velocidades como antes.

Pausa/Reducir movimiento detiene el reloj nativo existente. Una resorte tranquila duerme; un impulso, un retarget o un nuevo gesto lo despierta. La eliminación elimina las guías nativas junto con los recursos de entrada/ciclo de vida existentes en el mundo. Los cambios de entrada y los límites del ciclo de vida cruzan JavaScript; Las fuerzas, la selección de objetivos, los contactos, los dibujos y las actualizaciones de vistas por fotograma siguen siendo nativas. El hilo de la interfaz de usuario todavía se comparte con NativeScript JavaScript.

La vista previa de Un lugar para regresar / Equilibrio en cuatro idiomas demuestra ambos comportamientos. Ver validación y reproducción. Este es el tercer hito de #39: muelles de punto fijo y muelles de liberación dentro del mundo circular. Quedan fuera de este contrato las uniones cuerpo a cuerpo, las restricciones rígidas, las formas arbitrarias y un motor de dinámica general.