babalae/better-genshin-impact · warning · Exception

ReadImageMatWithResizeSync: 不支持的插值算法

Error message

ReadImageMatWithResizeSync: 不支持的插值算法 {interpolation}

What it means

This error is thrown by ReadImageMatWithResizeSync when the interpolation argument falls outside the valid range of 0–5 (OpenCV InterpolationFlags: Nearest=0, Linear=1, Cubic=2, Area=3, Lanczos=4, ExactLinear=5). It is a pre-condition guard before calling Cv2.Resize. Note: the throw is wrapped in a try/catch in the same method — the exception is logged and an empty Mat is returned, so the caller never actually sees the exception propagate.

Solutions

1. Ensure the interpolation argument is an integer in the range 0–5 inclusive.
2. If passing from JavaScript, validate the value before calling: if (interp < 0 || interp > 5) interp = 1;
3. Check the XML doc comments above the method (lines 240–247) for the allowed values mapping.

Example fix

// before
dispatcher.readImageMatWithResizeSync('img.png', 1920, 1080, 7);
// after
dispatcher.readImageMatWithResizeSync('img.png', 1920, 1080, 1); // bilinear (default)

// Validate interpolation before calling
if (interpolation < 0 || interpolation > 5) {
    interpolation = 1; // fallback to bilinear default
}
var mat = limitedFile.ReadImageMatWithResizeSync(path, width, height, interpolation);

// Note: the method already catches internally and returns empty Mat.
// Check the result for emptiness:
var mat = limitedFile.ReadImageMatWithResizeSync(path, width, height, interpolation);
if (mat.Empty()) {
    // handle failure - image was not loaded/resized
}

When it happens

Trigger: Calling ReadImageMatWithResizeSync(path, width, height, interpolation) with interpolation < 0 or > 5, e.g. passing 6, -1, or any value that does not map to a valid InterpolationFlags enum member. The default is 1 (bilinear).

Common situations: A JS script author passes a wrong interpolation constant (e.g. copies an OpenCV constant from documentation that is 0-based vs 1-based, or uses a value like 7). Mismatch between the script-side enum documentation and the actual 0–5 range.

Related errors

• 图像通道数必须为3,当前为
• AutoSkip的配置参数需要为AutoSkipConfig类型
• ReadImageMatWithResizeSync: 宽度和高度必须为正数
• 键盘编码必须是VirtualKeyCodes枚举中的值，当前传入的
• 切换角色：连续 3 次未检测到合法角色卡片

AI-assisted analysis of babalae/better-genshin-impact@a7cb36712d (2026-08-13). Data as JSON: /api/errors/62f169b873c815d6. Report an issue: GitHub.

Appendix: source

Thrown at BetterGenshinImpact/Core/Script/Dependence/LimitedFile.cs:260

    /// <item><description>双线性插值 (1) - 默认</description></item>
    /// <item><description>双三次插值 (2)</description></item>
    /// <item><description>像素区域关系重采样 (3)</description></item>
    /// <item><description>Lanczos插值 (4)</description></item>
    /// <item><description>精确双线性插值 (5)</description></item>
    /// </list>
    /// </remarks>
    public Mat ReadImageMatWithResizeSync(string path, double width, double height, int interpolation = 1)
    {
        try
        {
            if (width <= 0 || height <= 0)
            {
                throw new Exception("ReadImageMatWithResizeSync: 宽度和高度必须为正数");
            }

            if (interpolation is < 0 or > 5)
            {
                throw new Exception($"ReadImageMatWithResizeSync: 不支持的插值算法 {interpolation}");
            }

            path = NormalizePath(path);
            using var stream = File.OpenRead(path);
            using var mat = Mat.FromStream(stream, ImreadModes.Color);
            var rsz = new Mat();
            Cv2.Resize(mat, rsz, new Size(width, height), 0, 0, (InterpolationFlags)interpolation);
            return rsz;
        }
        catch (Exception ex)
        {
            // 记录异常并返回空的Mat
            TaskControl.Logger.LogError("ReadImageMatWithResizeSync 异常: {Message}", ex.Message);
            return new Mat();
        }
    }

    

View on GitHub (pinned to a7cb36712d)