PowerKeys Scripting API
    Preparing search index...

    Interface ImageSearchOptions

    Optional search tuning for Screen.FindImage / Screen.FindImageBase64. Every field is optional; the defaults are the fast exact-pose, color-verified search. Unknown fields are rejected.

    interface ImageSearchOptions {
        sizeTolerance?: number;
        rotationTolerance?: number;
        matchColor?: boolean;
    }
    Index
    sizeTolerance?: number

    Fractional on-screen size difference tolerated in each direction; 0.1 accepts a target rendered up to 10% larger or smaller than the template. Defaults to 0 (exact size). Tolerance searches cost more time; prefer a region when polling with tolerances.

    rotationTolerance?: number

    Rotation tolerated in each direction, in degrees. Defaults to 0 (unrotated). Small tilts such as an animating button are the intended range; beyond 15 degrees the search would need a rotation-invariant method and the value is rejected.

    matchColor?: boolean

    When true (default), the winning position must also match in color and absolute brightness: mild brightness/contrast grading still passes, while a same-shape element in a different hue or a much darker/brighter lookalike is rejected. Set false to compare purely on grayscale structure, e.g. when the target recolors with game state.