Struct Canvas2dContext 

pub struct Canvas2dContext {
    pub surface: Surface,
    pub path: PathBuilder,
    pub state: DrawState,
    stack: Vec<DrawState>,
}

1 つの <canvas> に対する 2D コンテキストの全状態。

JS 側のオブジェクトは軽いハンドルだけを持ち、実体はこれを指す。 パスと面はどちらもここに持たせて、描画の途中経過が JS オブジェクトの寿命に左右されないようにする。

Fields

surface: Surface

path: PathBuilder

state: DrawState

stack: Vec<DrawState>

save() の退避スタック。

Implementations

impl Canvas2dContext

pub fn new(width: u32, height: u32) -> Option<Self>

pub fn save(&mut self)

現在の状態を退避する。上限を超えたら黙って無視する （restore との対応が崩れるが、落ちるよりはよい）。

pub fn restore(&mut self)

直近の退避状態へ戻す。スタックが空なら何もしない （仕様どおり。restore の呼び過ぎはエラーではない）。

pub fn apply_alpha(&self, argb: u32) -> u32

globalAlpha を適用した色を返す。

アルファは掛け算で合成する。globalAlpha=0.5 の半透明色は さらに薄くなる（仕様どおり）。

pub fn fill_rect(&mut self, x: f32, y: f32, w: f32, h: f32)

現在の変換を適用して矩形を塗る。

変換が平行移動と拡大だけなら矩形のまま塗れるが、回転が入ると 軸平行でなくなる。判定を分けず、常にパス経由で塗ることで 回転時も正しくなるようにしている。

pub fn clear_rect(&mut self, x: f32, y: f32, w: f32, h: f32)

矩形を透明で消す。globalAlpha の影響は受けない（仕様どおり）。

回転が入っていると軸平行に消せないため、パスの外接矩形を消す。 厳密ではないが、clearRect に回転を掛ける使い方は稀。

pub fn fill(&mut self, rule: FillRule)

現在のパスを塗る。

pub fn stroke(&mut self)

現在のパスを線描する。

pub fn translate(&mut self, tx: f32, ty: f32)

現在の変換へ平行移動を積む。

pub fn scale(&mut self, sx: f32, sy: f32)

現在の変換へ拡大縮小を積む。

pub fn rotate(&mut self, rad: f32)

現在の変換へ回転を積む。

pub fn set_transform(&mut self, m: Matrix)

変換行列を直接置き換える（setTransform）。

pub fn reset_transform(&mut self)

変換を単位行列へ戻す（resetTransform）。

impl Canvas2dContext

pub fn stroke_with_width(&mut self)

現在のパスを、lineWidth を反映して線描する。

impl Canvas2dContext

pub fn apply_dash(&self, subpaths: &[SubPath]) -> Vec<SubPath>

現在の破線設定をパスへ適用する。実線ならそのまま返す。

impl Canvas2dContext

pub fn clip(&mut self, rule: FillRule)

現在のパスでクリップ領域を狭める（clip()）。

save/restore で元に戻る。状態を複製するだけで復帰できるよう Rc で共有しており、色と違って正しく戻せる。

pub fn sync_clip(&mut self)

描画前に、現在のクリップ領域を Surface へ渡す。

Trait Implementations

impl Debug for Canvas2dContext

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

Formats the value using the given formatter.