NRF GuideRéférence
TrackMetric
Convertir les fractions de voie et les distances en mètres.
Contexte d’utilisation
| Module | Package | Source SDK |
|---|---|---|
| Kotlin/JVM | fr.nimby.sdk | kotlin-client/src/main/kotlin/fr/nimby/sdk/TrackMetric.kt |
Signatures extraites de la version 0.8.0-alpha.1. Les paramètres, leurs valeurs par défaut et les propriétés de constructeur sont conservés. Les corps des méthodes ne font pas partie de cette référence.
Unités et validation
| Élément | Type / unité | Validation |
|---|---|---|
| trackId | Long opaque | Non nul. |
| lengthM | Double · mètres | Fini et strictement positif. |
| offsetM(fraction) | Double · mètres | fraction finie dans [0, 1]. |
| fraction(offsetM) | Double · fraction | offsetM fini dans [0, lengthM]. |
| distanceM(fromFraction, toFraction) | Double · mètres | Distance absolue, sans notion d’itinéraire. |
kotlin
val metric = fr.nimby.sdk.TrackMetric(trackId = 1L, lengthM = 800.0)
check(metric.offsetM(0.25) == 200.0)
check(metric.fraction(400.0) == 0.5)
check(metric.distanceM(0.75, 0.25) == 400.0)TrackMetric
fr.nimby.sdk · class
data class TrackMetric(val trackId: Long, val lengthM: Double)Metric used by the native route scanner, in metres per unit fraction. Available only for a qualified game binary and a stable observed header. Does not certify the topology, construction state or permission to edit.
TrackMetric.offsetM
fr.nimby.sdk · fun
fun offsetM(fraction: Double): DoubleTrackMetric.fraction
fr.nimby.sdk · fun
fun fraction(offsetM: Double): DoubleTrackMetric.distanceM
fr.nimby.sdk · fun
fun distanceM(fromFraction: Double, toFraction: Double): Double = abs(offsetM(toFraction) - offsetM(fromFraction))TrackMetric.positionAtMetres
fr.nimby.sdk · fun
fun positionAtMetres(offsetM: Double, direction: TrackDirection): Position =Position depuis l'origine de cette voie, en mètres. Le sens ne change pas cette origine. Une position n'est pas une autorisation de construire.
TrackDirection
fr.nimby.sdk · class
enum class TrackDirection(val nativeValue: Int) {
Forward(1), Backward(-1)
}Sens dans la représentation de la voie : croissant ou décroissant.