Struct StyleBuilder 

pub struct StyleBuilder { /* private fields */ }

文字样式构建器(给 ParaBuilder::styled)。

Implementations

impl StyleBuilder

pub fn bold(&mut self) -> &mut Self

加粗(字重 700)。

pub fn light(&mut self) -> &mut Self

细体(字重 300)。

pub fn weight(&mut self, w: u16) -> &mut Self

任意字重(CSS 习惯值 1–1000,常用 100–900;越界忽略)。

pub fn italic(&mut self) -> &mut Self

斜体。

pub fn underline(&mut self) -> &mut Self

下划线。

pub fn strike(&mut self) -> &mut Self

删除线。

pub fn color(&mut self, hex: &str) -> &mut Self

文字色(十六进制;非法忽略)。

pub fn bg(&mut self, hex: &str) -> &mut Self

高亮底色(十六进制;非法忽略)。

pub fn size(&mut self, mult: f32) -> &mut Self

字号倍率(相对基准)。非有限或 ≤ 0 忽略(保持默认),与标记前端一致—— 避免 0 字号把 cosmic-text 整形拖进死循环。

pub fn font(&mut self, role: FontRole) -> &mut Self

字族角色。

pub fn link(&mut self) -> &mut Self

链接样式:无显式色时按主题强调色渲(与标记文本 [文字](URL) 同款;引擎不存 URL)。

pub fn ring(&mut self) -> &mut Self

圈注:以这段文字为中心画一圈椭圆描边(缺省按文字宽窄自适应、颜色跟随墨色; 不占布局尺寸,圈溢出到行距)。尺寸经 ring_radius / ring_radii 给定后与文字宽窄无关。

pub fn ring_color(&mut self, hex: &str) -> &mut Self

圈注描边色(十六进制;非法忽略,跟随墨色)。

pub fn ring_radius(&mut self, r: f32) -> &mut Self

圈注定径:正圆,半径 r(逻辑像素)——多字与单字圈出同样大的圈。

pub fn ring_radii(&mut self, rx: f32, ry: f32) -> &mut Self

圈注定径:椭圆,横/纵半径(逻辑像素)。非有限或 ≤ 0 的分量忽略(保持自适应)。

pub fn ring_stroke(&mut self, w: f32) -> &mut Self

圈注线宽(逻辑像素;非有限或 ≤ 0 忽略,保持 0.07 倍字号缺省)。

pub fn ring_each(&mut self) -> &mut Self

逐字圈:整段一字一圈(空白跳过),未定径时按字取正圆。缺省是整段一个圈 (范围圈,自适应为扁椭圆)。

pub fn dot(&mut self) -> &mut Self

着重点:这段文字正下方一枚实心小点(颜色跟随墨色;画进行距,不占高度)。

pub fn dot_color(&mut self, hex: &str) -> &mut Self

着重点颜色(十六进制;非法忽略,跟随墨色)。

pub fn dot_radius(&mut self, r: f32) -> &mut Self

着重点半径(逻辑像素;非有限或 ≤ 0 忽略,保持 0.09 倍字号缺省)。

pub fn dot_each(&mut self) -> &mut Self

逐字点:一字一点(中文着重号的正字法;空白跳过)。缺省是整段中线下一点。

pub fn aside_right(&mut self) -> &mut Self

边注挂右:这段挂到本行内容的右外侧,参与绘制不参与布局——居中 / 对齐按其余 内容算,边注不挤不偏(「当前」「✓」这类行尾标记用)。

pub fn aside_left(&mut self) -> &mut Self

边注挂左:同 aside_right,停靠行首左外侧。

pub fn shadow(&mut self) -> &mut Self

文字阴影(默认形态:下坠 2 逻辑像素、软化 6、黑 25%)。

pub fn shadow_with( &mut self, dx: f32, dy: f32, blur: f32, hex: &str, ) -> &mut Self

文字阴影(自定形态:偏移/软化为逻辑像素,色为十六进制,非法色忽略整条)。