canvas.resize event

当应用绘图面的逻辑宽高或粗化像素比变化时发送。事件之后，基于旧尺寸的软件帧可以被拒绝。

Event payload

{ canvasId: string, width: u32, height: u32, dpr: f32 }

Examples

host.events.on('canvas.resize', ({ canvasId, width, height }) => {
  if (canvasId !== 'main') return;
  renderer.resize(width, height);
  invalidateLayout();
});

若一次布局变化产生多次中间尺寸，宿主可以只发送最终状态。应用需要权威快照时调用 getInfo()。

Delivery rules

• 宽高使用逻辑像素且必须为有限正整数。
• dpr 不得比 getInfo() 提供更高精度。
• 销毁绘图面后不再发送。
• resize 与 frame 的顺序必须保证 guest 能识别旧尺寸帧。

See also

canvas.getInfo()、canvas.present()