【Iced】core库下angle.rs文件分析

rust 复制代码
use crate::{Point, Rectangle, Vector};

use std::f32::consts::{FRAC_PI_2, PI};
use std::fmt::Display;
use std::ops::{Add, AddAssign, Div, Mul, RangeInclusive, Rem, Sub, SubAssign};

这段代码定义了两个用于表示角度的新类型包装结构体 :Degrees(度)和 Radians(弧度)。下面详细解释每个部分:

📦 导入部分

  • Point、Rectangle、Vector - 可能来自其他模块的几何图元
  • FRAC_PI_2(π/2)和 PI - 来自 std::f32::consts 的数学常数
  • 各种运算符 trait(Add、Mul 等)- 用于重载运算符
  • RangeInclusive - 用于定义范围
  • Display - 用于字符串格式化

📐 Degrees 结构体

一个元组结构体 ,包装了一个 f32 来表示以度为单位的角度。

✨ 主要特性:

  • 常量 :RANGE 定义了有效的度数值范围(0 到 360)
  • 转换 :可以从/转换为 f32、u8、f64 和 num_traits::FromPrimitive
  • 比较 :实现了与 Degrees 和原始 f32 的部分相等和排序比较
  • 运算 :实现了与 f32 的乘法(角度缩放)

📐 Radians 结构体

一个元组结构体 ,包装了一个 f32 来表示以弧度为单位的角度。

✨ 主要特性:

  • 常量 :
    • RANGE:0 到 2π(整个圆)
    • PI:π 弧度(180 度)

🔍 几何方法:

rust 复制代码
fn to_distance(&self, bounds: &Rectangle) -> (Point, Point)
  • 计算从矩形中心出发、按此角度延伸到矩形边界的直线
  • 用于绘制从中心到边缘、特定角度的射线/直线
  • 使用带有正弦/余弦的向量数学来找到交点

🔄 转换:

  • 从 Degrees 到 Radians(乘以 π/180)
  • 从/到 f32、u8、f64 和 num_traits::FromPrimitive 的转换

➕ 运算符重载(针对 Radians):

  • Add、AddAssign、Sub、SubAssign - 基本算术运算
  • Mul - 可以乘以两个弧度,或者弧度乘以 f32
  • Div - 除法运算
  • Rem - 余数/取模运算
  • 与 Degrees 的混合运算(可以将度加到弧度上)

⚖️ 类型比较:

  • 实现了与 Radians 和原始 f32 的部分相等和排序比较

📝 显示:

  • 格式化为 "X rad" 的字符串输出

🎯 设计模式

这使用了新类型模式,目的是:

  1. 类型安全 - 防止意外混淆度和弧度
  2. 领域特定方法 - 添加角度相关的实用方法
  3. 控制运算 - 只允许有意义的数学运算
  4. 定制行为 - 实现与基础类型不同的行为

这段代码很可能是图形或几何库的一部分,在这些库中,精确的角度处理对于旋转、射线投射或形状操作等计算非常重要。

相关推荐
xjz18423 小时前
Rust 用 `&&`、`||`、`!` 把条件组合起来
rust
不积跬步无以至千里mmbb268 小时前
Rust三大核心:Trait Crate Mod详解
linux·rust
SomeOtherTime12 小时前
第 2 讲:借用检查器(Borrow Checker)的数学本质——读写锁的编译期化、非词法生命周期(NLL)与重借用(Reborrowing)
rust
xjz18421 天前
Rust 的else:把「做不做」升级成「二选一」
rust
喵个咪1 天前
RushWind Admin — update_mask 写面:字段级白名单、显式清除与点路径合并
后端·rust
喵个咪1 天前
RushWind Admin — 多租户行级隔离与租户回收站:Viewer 三态、repo_shell! 与全域级联清除
后端·rust
喵个咪1 天前
RushWind CMS — 三服务拓扑:core 领域层、双 BFF 薄代理与一份契约的双面输出
后端·rust
不积跬步无以至千里mmbb261 天前
Rust内核开发核心入口解析
linux·rust
wflynn3 天前
GitHub 今日推荐|rust-anything:录制真实输入输出,渐进式重写热点函数到 Rust
rust·开源·github·cli·claude-code·agent-skills
风笙9783 天前
[Rust] String 与 &str 详解
rust