rustyfit 0.8.1

The #![no_std] Rust implementation of The Flexible and Interoperable Data Transfer (FIT) Protocol for decoding and encoding Garmin FIT files, supporting FIT Protocol V2.
Documentation
// Code generated by fitgen/main.go. DO NOT EDIT.

// Copyright 2025 The RustyFIT Authors. All rights reserved.
// Use of this source code is governed by a BSD-style
// license that can be found in the LICENSE file.

#![allow(unused, clippy::manual_range_patterns)]

use crate::profile::{ProfileType, typedef};
use crate::proto::*;
use crate::semconv;
use alloc::vec::Vec;

fn is_expanded(state: &[u8], num: u8) -> bool {
    match num {
        8 => (state[num as usize >> 3] >> (num & 7)) & 1 == 1,
        _ => false,
    }
}

#[derive(Debug, Clone)]
/// Jump is a Jump message.
pub struct Jump {
    /// Units: s
    pub timestamp: typedef::DateTime,
    /// Units: m
    pub distance: f32,
    /// Units: m
    pub height: f32,
    pub rotations: u8,
    /// Units: s
    pub hang_time: f32,
    /// A score for a jump calculated based on hang time, rotations, and distance.
    pub score: f32,
    /// Units: semicircles
    pub position_lat: i32,
    /// Units: semicircles
    pub position_long: i32,
    /// Scale: 1000; Units: m/s
    pub speed: u16,
    /// Scale: 1000; Units: m/s
    pub enhanced_speed: u32,
    state: [u8; 2], // Used for tracking expanded fields.
    /// unknown_fields are fields that are exist but they are not defined in Profile.xlsx
    pub unknown_fields: Vec<Field>,
    /// developer_fields are custom data fields (Added since protocol version 2.0)
    pub developer_fields: Vec<DeveloperField>,
}

impl Jump {
    /// Value's type: `u32`; Units: `s`
    pub const TIMESTAMP: u8 = 253;
    /// Value's type: `f32`; Units: `m`
    pub const DISTANCE: u8 = 0;
    /// Value's type: `f32`; Units: `m`
    pub const HEIGHT: u8 = 1;
    /// Value's type: `u8`
    pub const ROTATIONS: u8 = 2;
    /// Value's type: `f32`; Units: `s`
    pub const HANG_TIME: u8 = 3;
    /// Value's type: `f32`
    pub const SCORE: u8 = 4;
    /// Value's type: `i32`; Units: `semicircles`
    pub const POSITION_LAT: u8 = 5;
    /// Value's type: `i32`; Units: `semicircles`
    pub const POSITION_LONG: u8 = 6;
    /// Value's type: `u16`; Scale: `1000`; Units: `m/s`
    pub const SPEED: u8 = 7;
    /// Value's type: `u32`; Scale: `1000`; Units: `m/s`
    pub const ENHANCED_SPEED: u8 = 8;

    /// Create new Jump with all fields being set to its corresponding invalid value.
    pub const fn new() -> Self {
        Self {
            timestamp: typedef::DateTime(u32::MAX),
            distance: f32::MAX,
            height: f32::MAX,
            rotations: u8::MAX,
            hang_time: f32::MAX,
            score: f32::MAX,
            position_lat: i32::MAX,
            position_long: i32::MAX,
            speed: u16::MAX,
            enhanced_speed: u32::MAX,
            state: [0u8; 2],
            unknown_fields: Vec::new(),
            developer_fields: Vec::new(),
        }
    }

    /// Returns `position_lat` in degrees instead of semicircles. It returns invalid f64 when value is valid.
    pub fn position_lat_degrees(&self) -> f64 {
        semconv::to_degrees(self.position_lat)
    }

    /// Returns `position_long` in degrees instead of semicircles. It returns invalid f64 when value is valid.
    pub fn position_long_degrees(&self) -> f64 {
        semconv::to_degrees(self.position_long)
    }

    /// Returns `speed` in its scaled value. It returns invalid f64 when value is valid.
    pub fn speed_scaled(&self) -> f64 {
        if self.speed == u16::MAX {
            return f64::from_bits(u64::MAX);
        }
        self.speed as f64 / 1000.0 - 0.0
    }

    /// Set `speed` with scaled value, it will automatically be converted to its corresponding integer value.
    pub fn set_speed_scaled(&mut self, v: f64) -> &mut Jump {
        let unscaled = (v + 0.0) * 1000.0;
        if unscaled.is_nan() || unscaled.is_infinite() || unscaled > u16::MAX as f64 {
            self.speed = u16::MAX;
            return self;
        }
        self.speed = unscaled as u16;
        self
    }

    /// Returns `enhanced_speed` in its scaled value. It returns invalid f64 when value is valid.
    pub fn enhanced_speed_scaled(&self) -> f64 {
        if self.enhanced_speed == u32::MAX {
            return f64::from_bits(u64::MAX);
        }
        self.enhanced_speed as f64 / 1000.0 - 0.0
    }

    /// Set `enhanced_speed` with scaled value, it will automatically be converted to its corresponding integer value.
    pub fn set_enhanced_speed_scaled(&mut self, v: f64) -> &mut Jump {
        let unscaled = (v + 0.0) * 1000.0;
        if unscaled.is_nan() || unscaled.is_infinite() || unscaled > u32::MAX as f64 {
            self.enhanced_speed = u32::MAX;
            return self;
        }
        self.enhanced_speed = unscaled as u32;
        self
    }

    /// Marks whether given field's num is an expanded field (field that being generated through a component expansion).
    pub fn mark_as_expanded(&mut self, num: u8, flag: bool) -> bool {
        match num {
            8 => {
                if flag {
                    self.state[num as usize >> 3] |= 1 << (num & 7)
                } else {
                    self.state[num as usize >> 3] &= !(1 << (num & 7))
                }
                true
            }
            _ => false,
        }
    }

    /// checks whether given field's num is a field generated through a component expansion.
    pub fn is_expanded(&self, num: u8) -> bool {
        is_expanded(&self.state, num)
    }

    fn count_valid_fields(&self) -> usize {
        (self.timestamp != typedef::DateTime(u32::MAX)) as usize
            + (self.distance != f32::MAX) as usize
            + (self.height != f32::MAX) as usize
            + (self.rotations != u8::MAX) as usize
            + (self.hang_time != f32::MAX) as usize
            + (self.score != f32::MAX) as usize
            + (self.position_lat != i32::MAX) as usize
            + (self.position_long != i32::MAX) as usize
            + (self.speed != u16::MAX) as usize
            + (self.enhanced_speed != u32::MAX) as usize
    }
}

impl Default for Jump {
    fn default() -> Self {
        Self::new()
    }
}

impl From<&Message> for Jump {
    /// from creates new Jump struct based on given mesg.
    fn from(mesg: &Message) -> Self {
        const KNOWN_NUMS: [u64; 4] = [511, 0, 0, 2305843009213693952];
        let mut n = 0u64;
        for field in &mesg.fields {
            n += (KNOWN_NUMS[field.num as usize >> 6] >> (field.num & 63)) & 1 ^ 1
        }

        let mut v = Self::new();
        v.unknown_fields = Vec::<Field>::with_capacity(n as usize);
        v.developer_fields = mesg.developer_fields.clone();

        for field in &mesg.fields {
            match field.num {
                253 => v.timestamp = typedef::DateTime(field.value.as_u32()),
                0 => v.distance = field.value.as_f32(),
                1 => v.height = field.value.as_f32(),
                2 => v.rotations = field.value.as_u8(),
                3 => v.hang_time = field.value.as_f32(),
                4 => v.score = field.value.as_f32(),
                5 => v.position_lat = field.value.as_i32(),
                6 => v.position_long = field.value.as_i32(),
                7 => v.speed = field.value.as_u16(),
                8 => v.enhanced_speed = field.value.as_u32(),
                _ => {
                    v.unknown_fields.push(field.clone());
                    continue;
                }
            };
            if field.is_expanded && field.num < 9 {
                v.state[field.num as usize >> 3] |= 1 << (field.num & 7)
            }
        }

        v
    }
}

impl From<Jump> for Message {
    fn from(m: Jump) -> Self {
        let mut fields =
            Vec::<Field>::with_capacity(m.count_valid_fields() + m.unknown_fields.len());

        if m.timestamp != typedef::DateTime(u32::MAX) {
            fields.push(Field {
                num: 253,
                profile_type: ProfileType::DATE_TIME,
                value: Value::Uint32(m.timestamp.0),
                is_expanded: false,
            });
        };
        if m.distance != f32::MAX {
            fields.push(Field {
                num: 0,
                profile_type: ProfileType::FLOAT32,
                value: Value::Float32(m.distance),
                is_expanded: false,
            });
        };
        if m.height != f32::MAX {
            fields.push(Field {
                num: 1,
                profile_type: ProfileType::FLOAT32,
                value: Value::Float32(m.height),
                is_expanded: false,
            });
        };
        if m.rotations != u8::MAX {
            fields.push(Field {
                num: 2,
                profile_type: ProfileType::UINT8,
                value: Value::Uint8(m.rotations),
                is_expanded: false,
            });
        };
        if m.hang_time != f32::MAX {
            fields.push(Field {
                num: 3,
                profile_type: ProfileType::FLOAT32,
                value: Value::Float32(m.hang_time),
                is_expanded: false,
            });
        };
        if m.score != f32::MAX {
            fields.push(Field {
                num: 4,
                profile_type: ProfileType::FLOAT32,
                value: Value::Float32(m.score),
                is_expanded: false,
            });
        };
        if m.position_lat != i32::MAX {
            fields.push(Field {
                num: 5,
                profile_type: ProfileType::SINT32,
                value: Value::Int32(m.position_lat),
                is_expanded: false,
            });
        };
        if m.position_long != i32::MAX {
            fields.push(Field {
                num: 6,
                profile_type: ProfileType::SINT32,
                value: Value::Int32(m.position_long),
                is_expanded: false,
            });
        };
        if m.speed != u16::MAX {
            fields.push(Field {
                num: 7,
                profile_type: ProfileType::UINT16,
                value: Value::Uint16(m.speed),
                is_expanded: false,
            });
        };
        if m.enhanced_speed != u32::MAX {
            fields.push(Field {
                num: 8,
                profile_type: ProfileType::UINT32,
                value: Value::Uint32(m.enhanced_speed),
                is_expanded: is_expanded(&m.state, 8),
            });
        };

        fields.extend_from_slice(&m.unknown_fields);

        Self {
            header: 0,
            num: typedef::MesgNum::JUMP,
            fields,
            developer_fields: m.developer_fields,
        }
    }
}