使用Maui.CSharpMath.SkiaSharp绘制LaTeX时过大位图异常的解决方法

核心原因 #

该异常本质是生成的公式位图尺寸超出系统允许的最大限制，常见触发场景：

• 长公式或大字号导致位图分辨率过高
• 重复调用DrawAsStream()未及时释放资源，内存中累积大对象
• 保存时未指定合适输出尺寸，默认生成的位图过大

具体解决方法 #

1. 限制生成位图的最大尺寸 #

通过MathPainter的Measure方法先计算公式实际尺寸，再根据设定的最大宽高缩放，避免生成超大型位图：

MathPainter mathPainter = new() { FontSize = 25 };
// 设定允许的最大宽高（可根据设备屏幕调整）
const double MaxWidth = 1000;
const double MaxHeight = 1000;

private void EditorTextChanged(object sender, EventArgs e)
{
    string formula = e.NewTextValue;
    mathPainter.LaTeX = formula;
    
    // 先测量公式的原始尺寸
    var size = mathPainter.Measure();
    double scale = 1;
    // 如果原始尺寸超过限制，计算缩放比例
    if (size.Width > MaxWidth || size.Height > MaxHeight)
    {
        scale = Math.Min(MaxWidth / size.Width, MaxHeight / size.Height);
    }
    
    // 使用缩放后的尺寸生成流
    LatexImage.Source = ImageSource.FromStream(() => 
        mathPainter.DrawAsStream((float)scale));
}

2. 保存时复用测量结果，避免重复生成大位图 #

点击保存按钮时，复用之前测量的缩放比例，确保生成的位图尺寸在限制内：

private async void SaveButton_Clicked(object sender, EventArgs e)
{
    string formula = Editor.Text;
    mathPainter.LaTeX = formula;
    var size = mathPainter.Measure();
    double scale = 1;
    if (size.Width > MaxWidth || size.Height > MaxHeight)
    {
        scale = Math.Min(MaxWidth / size.Width, MaxHeight / size.Height);
    }
    
    // 生成缩放后的流并保存
    using var stream = mathPainter.DrawAsStream((float)scale);
    var savePath = Path.Combine(FileSystem.AppDataDirectory, "formula.png");
    using var fileStream = File.Open(savePath, FileMode.Create);
    await stream.CopyToAsync(fileStream);
}

3. 及时释放资源，避免内存泄漏 #

• 使用using语句包裹流对象，确保用完即释放
• 避免频繁创建新的MathPainter实例，复用全局实例

4. 动态调整字号（可选） #

如果公式过长，可自动缩小字号控制位图尺寸：

private void AdjustFontSizeForLongFormula(string formula)
{
    mathPainter.LaTeX = formula;
    var size = mathPainter.Measure();
    while (size.Width > MaxWidth && mathPainter.FontSize > 12)
    {
        mathPainter.FontSize -= 1;
        size = mathPainter.Measure();
    }
}

额外注意事项 #

• 不同平台最大位图尺寸限制不同（比如Android默认单张位图不能超过2048x2048或4096x4096），可根据目标平台调整MaxWidth和MaxHeight
• 实时预览时可使用更低缩放比例提升性能，保存时再用合适比例保证清晰度

内容的提问来源于stack exchange，提问作者Death_Dealer