Black Trigram (흑괘) - Korean Martial Arts Combat Simulator API - v0.7.11
    Preparing search index...

    Function pixelsToMeters

    • Convert screen position (pixels) to physics position (meters).

      IMPORTANT: This function only handles scaling conversion between pixels and meters. If you're converting from screen coordinates, you must first subtract arena position offsets (bounds.x and bounds.y).

      Example:

      const arenaRelativeX = screenX - bounds.x;  // Remove arena offset
      const arenaRelativeY = screenY - bounds.y; // Remove arena offset
      const physicsPos = pixelsToMeters({ x: arenaRelativeX, y: arenaRelativeY }, bounds);

      Use this when converting user input or initial positions. After conversion, work entirely in meters.

      Korean: 픽셀을미터로 (Pixels To Meters)

      Parameters

      • pixelPosition: { x: number; y: number }

        Position in pixels RELATIVE to arena origin (subtract bounds.x/y first)

      • bounds: PhysicsArenaBounds

        Arena bounds for conversion

      Returns Position3D

      Position in meters

      Error if pixel coordinates are not finite numbers