📜  角度字典 - TypeScript (1)

📅  最后修改于: 2023-12-03 15:41:34.442000             🧑  作者: Mango

角度字典 - TypeScript

简介

角度字典是一个用于定义和描述角度的 TypeScript 库。它提供了一系列的类型和接口,用于方便地进行角度相关的计算和转换。

本库提供了以下特性:

  • 支持度和弧度之间的转换
  • 支持不同角度单位之间的转换,如角度和正弦余弦值之间的转换
  • 支持角度加减运算
  • 支持角度比较和判断
安装
npm
npm install @types/angle-dictionary --save
yarn
yarn add @types/angle-dictionary
使用
import { Angle, AngleUnit } from '@types/angle-dictionary';

const alpha = new Angle(45, AngleUnit.Degree);
const beta = new Angle(0.785398, AngleUnit.Radian);

console.log(alpha.toRadian().value); // 0.7853981633974483
console.log(beta.toDegree().value); // 45
console.log(alpha.add(beta).value); // 135
console.log(alpha.equals(beta)); // false
console.log(alpha.greaterThan(beta)); // true
API
类型

Angle

Angle 类型表示一个角度值,它包含以下两个属性:

  • value: number 表示角度值

  • unit: AngleUnit 表示角度单位,支持以下几种:

    • AngleUnit.Degree 表示角度
    • AngleUnit.Radian 表示弧度
    • AngleUnit.Turn 表示圆周角

Angle 类型提供以下方法:

  • toRadian(): Angle 将角度转换为弧度
  • toDegree(): Angle 将角度转换为角度
  • toTurn(): Angle 将角度转换为圆周角
  • add(angle: Angle): Angle 将当前角度值加上另一个角度值,返回新的 Angle 实例
  • subtract(angle: Angle): Angle 将当前角度值减去另一个角度值,返回新的 Angle 实例
  • multiply(factor: number): Angle 将当前角度值乘以一个因子,返回新的 Angle 实例
  • divide(dividend: number): Angle 将当前角度值除以一个除数,返回新的 Angle 实例
  • equals(angle: Angle): boolean 判断当前角度值是否等于另一个角度值
  • greaterThan(angle: Angle): boolean 判断当前角度值是否大于另一个角度值
  • lessThan(angle: Angle): boolean 判断当前角度值是否小于另一个角度值
  • toString(): string 将角度转换为字符串,格式为 <value><unit>

AngleUnit

AngleUnit 是一个枚举类型,表示角度单位,支持以下几种:

  • AngleUnit.Degree 表示角度
  • AngleUnit.Radian 表示弧度
  • AngleUnit.Turn 表示圆周角
接口

SineCosine

SineCosine 接口表示正弦和余弦函数的值,包含以下两个属性:

  • sin: number 表示正弦函数的值
  • cos: number 表示余弦函数的值

SineCosine 接口提供以下方法:

  • toString(): string 将函数值转换为字符串,格式为 <sin><cos>

Tangent

Tangent 接口表示正切函数的值,包含以下属性:

  • tan: number 表示正切函数的值

Tangent 接口提供以下方法:

  • toString(): string 将函数值转换为字符串,格式为 <tan>
结论

角度字典是一个方便进行角度计算和转换的 TypeScript 库,提供了丰富的类型和接口。它具有易用性、可扩展性和通用性的优点,在需要使用角度相关计算和转换的场景中具有一定的优势。