docs: explain box sizing, device drawing and image preparation

This commit is contained in:
2026-11-12 18:32:01 +08:00
parent 7a3eea3958
commit 13a8b1b4b5
4 changed files with 129 additions and 0 deletions
+9
View File
@@ -1,9 +1,13 @@
//! 共享的二维点和矩形值。命中判断在调用方完成坐标系转换后使用,矩形本身不隐式处理相机。
//! 调用路径:布局与 viewport 生成点/矩形,文档命中先做坐标逆变换再调用 contains;软件渲染也用它们表达设备区域。
//! 这里只是数值容器,不隐式校验/夹取/做相机变换;有限性和尺寸合法性在各协议入口检查。
//!
#[derive(Clone, Copy, Debug, Default, PartialEq, serde::Serialize, serde::Deserialize)]
/// 二维坐标值;具体处于逻辑、局部还是设备空间由调用上下文决定。
pub struct Point {
// 横坐标原值,单位与空间由构造方约定。
pub x: f32,
// 纵坐标原值,不假定一定是世界向上或屏幕向下。
pub y: f32,
}
@@ -17,9 +21,13 @@ impl Point {
#[derive(Clone, Copy, Debug, Default, PartialEq)]
/// 轴对齐矩形,保存原点和宽高,用于布局、裁剪与命中。
pub struct Rect {
// 左侧原点,在同一坐标系中与 point.x 比较。
pub x: f32,
// 顶部原点,在同一坐标系中与 point.y 比较。
pub y: f32,
// 横向长度,不存储右端点;contains 使用 x+width。
pub width: f32,
// 纵向长度,不存储下端点;调用方负责非负尺寸约定。
pub height: f32,
}
@@ -36,6 +44,7 @@ impl Rect {
/// 用闭区间比较判断点是否命中,左右上下边缘都计入;调用前需将点转换到矩形所在空间。
pub fn contains(self, point: Point) -> bool {
// 闭区间四边比较;自身不处理裁剪叠加、圆角或世界面板遮挡,这些属于更上层命中流程。
point.x >= self.x
&& point.x <= self.x + self.width
&& point.y >= self.y