PhysicsBox/dev.zinchenko.physicsbox.units/PhysicsUnits

PhysicsUnits

class PhysicsUnits(val pxPerMeter: PxPerMeter)

Converts values between UI space (px/degrees) and physics space (meters/radians).

Coordinate system contract (same for UI and physics):

+X points right.
+Y points down.

This keeps conversion logic straightforward and allows using gravity as (+0, +9.8).

Scale contract:

meters = px / pxPerMeter
px = meters * pxPerMeter

Constructors

PhysicsUnits

constructor(pxPerMeter: PxPerMeter)

Properties

pxPerMeter

val pxPerMeter: PxPerMeter

Functions

degreesToRadians

fun degreesToRadians(deg: Float): Float

impulsePhysicsToPx

fun impulsePhysicsToPx(impulse: Float): Float

Converts impulse from physics-scaled length domain to UI-scaled length domain.

impulsePxToPhysics

fun impulsePxToPhysics(impulse: Float): Float

Converts impulse from UI-scaled length domain to physics-scaled length domain.

impulseVecPhysicsToPx

fun impulseVecPhysicsToPx(v: PhysicsVector2): PhysicsVector2

impulseVecPxToPhysics

fun impulseVecPxToPhysics(v: PhysicsVector2): PhysicsVector2

metersToIntPx

fun metersToIntPx(meters: Float): Int

metersToPx

fun metersToPx(meters: Float): Float

metersVecToPx

fun metersVecToPx(v: PhysicsVector2): PhysicsVector2

pxToMeters

fun pxToMeters(px: Float): Float

fun pxToMeters(px: Int): Float

pxVecToMeters

fun pxVecToMeters(v: PhysicsVector2): PhysicsVector2

radiansToDegrees

fun radiansToDegrees(rad: Float): Float

transformMetersToPx

fun transformMetersToPx(t: PhysicsTransform): PhysicsTransform

Converts transform fields from meters + radians into px + degrees.

transformPxToMeters

fun transformPxToMeters(t: PhysicsTransform): PhysicsTransform

Converts transform fields from px + degrees into meters + radians.

velocityMetersToPxPerSecond

fun velocityMetersToPxPerSecond(metersPerSecond: Float): Float

velocityPxToMetersPerSecond

fun velocityPxToMetersPerSecond(pxPerSecond: Float): Float

velocityVecMetersToPxPerSecond

fun velocityVecMetersToPxPerSecond(v: PhysicsVector2): PhysicsVector2

velocityVecPxToMetersPerSecond

fun velocityVecPxToMetersPerSecond(v: PhysicsVector2): PhysicsVector2