rc-js-util/src/number/impl/_f32.ts

A collection of TS and C++ utilities to help writing performant and correct applications, achieved through strict typing and (removable) invariant checking.

import { Range2d } from "../../array/typed-array/2d/range2d/range2d.js";

/**
 * @public
 * Utilities relating to single precision floats.
 *
 * @remarks
 * See {@link _F64}.
 */
export class _F32
{
    public static MAX_VALUE = (2 - Math.pow(2, -23)) * Math.pow(2, 127);
    public static MIN_POSITIVE_VALUE = Math.pow(2, -126);
    public static bounds = Range2d.f32.factory.createOne(
        -_F32.MAX_VALUE,
        -_F32.MAX_VALUE,
        _F32.MAX_VALUE,
        _F32.MAX_VALUE,
    );

    public static getPrecision(value: number): number
    {
        return value * _F32.mantissaPrecision;
    }

    public static isEqual
    (
        a: number,
        b: number,
        delta: number = _F32.mantissaPrecision,
    )
        : boolean
    {
        return Math.abs(a - b) < delta;
    }

    public static readonly mantissaBits = 23;
    public static readonly mantissaPrecision = 1 / Math.pow(2, 23);
}