painting.dart中ImageTilingInfo与createTilingInfo报错求助

问题原因 #

ImageTilingInfo 和 createTilingInfo 是Flutter框架内部的私有API，并未对外公开。直接在业务代码或第三方库代码中引用这些私有成员，会触发编译错误——它们不属于dart:ui或flutter/painting.dart的公开API范畴。

解决方案：替代实现方式 #

既然无法依赖私有API，可通过两种方式实现相同的图片平铺渲染逻辑：

方案1：直接使用公开API实现基础平铺 #

如果仅需实现图片重复/镜像平铺效果，无需额外的矩形映射计算，可直接通过ImageShader的公开参数完成：

// 直接传入TileMode枚举（如TileMode.repeat/TileMode.mirror）
final ImageShader shader = ImageShader(
  image,
  repeat,
  repeat,
  Matrix4.identity().storage,
  filterQuality: filterQuality,
);
canvas.drawRect(rect, paint..shader = shader);

方案2：手动实现自定义平铺映射逻辑 #

如果需要适配sourceRect与destinationRect的坐标映射，可参考Flutter内部私有API的逻辑，自行实现计算代码：

1. 先定义自定义的平铺信息类：

class CustomTilingInfo {
  const CustomTilingInfo({
    required this.tileModeX,
    required this.tileModeY,
    required this.transform,
  });

  final TileMode tileModeX;
  final TileMode tileModeY;
  final Matrix4 transform;
}

2. 实现映射计算方法：

CustomTilingInfo createCustomTilingInfo(
  TileMode repeatMode,
  Rect drawRect,
  Rect destinationRect,
  Rect sourceRect,
) {
  // 计算目标区域与源区域的缩放比例
  final double scaleX = destinationRect.width / sourceRect.width;
  final double scaleY = destinationRect.height / sourceRect.height;
  
  // 构建坐标变换矩阵：先平移对齐起点，再缩放匹配尺寸
  final Matrix4 transform = Matrix4.identity()
    ..translate(
      destinationRect.left - sourceRect.left * scaleX,
      destinationRect.top - sourceRect.top * scaleY,
    )
    ..scale(scaleX, scaleY);

  return CustomTilingInfo(
    tileModeX: repeatMode,
    tileModeY: repeatMode,
    transform: transform,
  );
}

3. 在渲染代码中使用自定义实现：

final CustomTilingInfo info = createCustomTilingInfo(repeat, rect, destinationRect, sourceRect);
final ImageShader shader = ImageShader(
  image,
  info.tileModeX,
  info.tileModeY,
  info.transform.storage,
  filterQuality: filterQuality,
);
canvas.drawRect(rect, paint..shader = shader);

注意事项 #

• 避免直接依赖Flutter私有API，这类API无版本兼容性承诺，框架更新时极易失效。
• 若问题来自第三方库（如extended_image），建议检查库版本与当前Flutter版本的适配性，或向库维护者提交兼容修复请求。

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