Struct KeyGeometry 

pub struct KeyGeometry { /* private fields */ }

宿主注册的一份字母键几何，按键宽、键高的中位数归一。id 是宿主分配的非零代次，布局一变（旋转、分离、单手、键高、微软 ; 显隐）就换一个。

Implementations

impl KeyGeometry

pub fn new( id: u32, keys: &[KeyRect; 26], semicolon: Option<KeyRect>, duplicates: &[(u8, KeyRect)], ) -> Result<Self, KeyGeometryError>

keys 是 a 到 z，semicolon 是微软双拼显示的 ; 键，duplicates 是分离键盘里重复的字母键。数值都要有限、宽高为正，归一后的键心都在 COORDINATE_LIMIT 之内，否则整份拒绝。

pub fn from_json(bytes: &[u8]) -> Result<Option<Self>, String>

宿主下发的 JSON：{"id":u32,"keys":[[cx,cy,w,h] × 26，按 a..z],"semicolon":[cx,cy,w,h]|null,"duplicates":[["g",cx,cy,w,h],…]}，形状沿用滑行请求。空串或 id 为 0 表示清除，返回 Ok(None)；多出的字段、不是 26 个字母键或数值不合格时整份拒绝。

pub fn id(&self) -> u32

pub fn fingerprint(&self) -> u64

几何内容（归一单位和每个键心）的指纹。宿主可能用同一个代次下发内容不同的几何，方案层把它当新几何处理；按触点计价的缓存键要带上它，才不会把旧布局算出的答案交给新布局。内容相同（==）的几何指纹相同。

pub fn has_semicolon(&self) -> bool

有没有 ; 键（宿主只在微软双拼下显示它）。

pub fn touch(&self, key: u8, x: f32, y: f32) -> Option<KeyTouch>

宿主坐标里的按下点 (x, y) 落在 key 上的触点：取 key 离它最近的那个实例，偏移量化到 1/20 键并钳到 ±1.5 键。key 不在几何里（没有 ; 键时的 ;、不是字母）、坐标不是有限数或归一后超出 COORDINATE_LIMIT 时为 None，这一键按没有触点处理。大写字母按小写算。

pub fn penalty( &self, pressed: u8, touch: KeyTouch, candidate: u8, tuning: &TouchTuning, ) -> Option<f64>

按在 pressed 上、落点是 touch 时，把这一键换成 candidate 的罚分。候选键取离落点最近的实例，所以分离键盘上的重复键各自就近。pressed 或 candidate 不在几何里时为 None。

pub fn adjacent(&self, pressed: u8, touch: KeyTouch, candidate: u8) -> bool

平面表的邻键 candidate 在这份几何上是否真的挨着被按的那个实例。分离键盘上 T 和 Y 分在两半，平面表的这条邻接就不成立。

Trait Implementations

impl Clone for KeyGeometry

fn clone(&self) -> Self

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for KeyGeometry

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl PartialEq for KeyGeometry

fn eq(&self, other: &Self) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl StructuralPartialEq for KeyGeometry