Struct RenderOptions 

pub struct RenderOptions {
    pub width: f32,
    pub padding: Insets,
    pub scale: f32,
    pub theme: Theme,
    pub fonts: FontHandle,
    pub format: OutputFormat,
    pub images: HashMap<String, Vec<u8>>,
    pub header: Option<PageChrome>,
    pub footer: Option<PageChrome>,
}

渲染入参。链式覆写;default() = 960 逻辑宽、亮色、scale 2、PNG、默认字体句柄。

Fields

width: f32

逻辑内容宽(含左右内边距),默认 960。

padding: Insets

页边距(逻辑像素)。

scale: f32

超采样系数(输出 = 逻辑尺寸 × scale),默认 2.0。越大越清晰也越慢 / 越大。

theme: Theme

视觉主题。

fonts: FontHandle

字体栈句柄。

format: OutputFormat

输出格式,默认 PNG。

images: HashMap<String, Vec<u8>>

标记文本里 @名字 图片 → 字节。

header: Option<PageChrome>

页眉条(可选):一行小字排在内容上方,与文档无关的固定标识(品牌 / 出处)。

footer: Option<PageChrome>

页脚条(可选):一行小字排在内容下方,常放项目水印(如「abot · github.com/…」)。

Implementations

impl RenderOptions

pub fn with_width(self, w: f32) -> Self

设逻辑内容宽。

pub fn with_padding(self, p: Insets) -> Self

设页边距(逻辑像素)。

pub fn with_theme(self, t: Theme) -> Self

设主题。

pub fn with_fonts(self, f: FontHandle) -> Self

设字体句柄。

pub fn with_scale(self, s: f32) -> Self

设超采样系数(清晰度档位,见 fast/sharp/ultra 预设)。

pub fn fast(self) -> Self

清晰度预设:快(scale 1)——最省、体积小,清晰度一般。

pub fn standard(self) -> Self

清晰度预设:标准(scale 1.5)。

pub fn sharp(self) -> Self

清晰度预设:清晰(scale 2,默认)。

pub fn ultra(self) -> Self

清晰度预设:超清(scale 3)——最清晰也最慢 / 最大。

pub fn with_header(self, text: impl Into<String>) -> Self

设页眉(默认形态:左对齐次要色小字 + 细线);要微调用 with_header_chrome。

pub fn with_header_chrome(self, c: PageChrome) -> Self

设页眉(完整形态)。

pub fn with_footer(self, text: impl Into<String>) -> Self

设页脚(默认形态:居中次要色小字 + 细线,适合项目水印);微调用 with_footer_chrome。

pub fn with_footer_chrome(self, c: PageChrome) -> Self

设页脚(完整形态)。

pub fn with_format(self, f: OutputFormat) -> Self

设输出格式。

pub fn png(self) -> Self

输出 PNG(无损,平衡压缩)。

pub fn png_fast(self) -> Self

输出 PNG(无损,快压缩——更快但更大)。

pub fn webp(self) -> Self

输出 WebP(无损,文字图首选)。画布单边 > 16383px 时编码报错。

pub fn webp_or_png(self) -> Self

输出 WebP,但画布单边 > 16383px(WebP 上限)时自动落 PNG。

Trait Implementations

impl Clone for RenderOptions

fn clone(&self) -> RenderOptions

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Default for RenderOptions

fn default() -> Self

Returns the “default value” for a type.