Go image.Point.In 怎样判断坐标是否落在图像矩形内

用Go处理图像坐标相关的开发逻辑时，直接调用标准库image包下Point类型提供的In方法，就能快速完成当前坐标是否落在指定图像矩形内的判断，不需要额外手写复杂的边界校验代码。

判断规则严格遵循图像领域通用的左闭右开约定，只有当点的X值大于等于矩形的Min.X、小于矩形的Max.X，同时点的Y值大于等于矩形的Min.Y、小于矩形的Max.Y时，才会返回true，完全适配像素级坐标的校验场景。

在 Go 的图像处理代码里，鼠标点击、裁剪请求或合成区域通常先得到一个 image.Point，再判断它是否落在图片的 image.Rectangle 内。最直接的做法是调用 point.In(rect)，它按矩形的半开区间判断：左边和上边包含，右边和下边不包含。

官方资料：https://pkg.go.dev/image#Point.In

把坐标命中判断放在像素访问、裁剪和业务处理之前：if point.In(bounds) { ... }。注意 Max 只是范围终点，不是最后一个有效像素；非零起点和空矩形也会影响结果。

先读懂 image.Rectangle 的坐标范围

image.Point 是一个 X、Y 坐标对，标准图像坐标轴通常向右、向下增加。image.Rectangle 用 Min 和 Max 描述范围，包含满足 Min.X 、Min.Y 的点。

用 Point.In 判断普通矩形

In 接收一个 image.Rectangle，返回布尔值，不会修改点或矩形。把判断封装成小函数后，点击事件、裁剪请求和绘制前检查都可以复用同一条边界规则。

package main

import (
    "fmt"
    "image"
)

// hitImageBounds 判断一个坐标是否位于图像边界内。
func hitImageBounds(point image.Point, bounds image.Rectangle) bool {
    // Point.In 遵守 Min 包含、Max 不包含的半开区间。
    return point.In(bounds)
}

func main() {
    bounds := image.Rect(10, 20, 110, 100)
    points := []image.Point{
        {X: 10, Y: 20},  // 左上角属于矩形。
        {X: 109, Y: 99}, // 右下方向最后一个有效坐标。
        {X: 110, Y: 99}, // X 等于 Max.X，不属于矩形。
    }

    for _, point := range points {
        // 先判断范围，再决定是否读取或处理像素。
        fmt.Println(point, hitImageBounds(point, bounds))
    }
}

这里的矩形范围是横向 10 到 109、纵向 20 到 99。因此 (10,20) 命中，(109,99) 也命中，而 (110,99) 因为触及右侧终点而不命中。

非零起点时不要把坐标当成从零开始

很多内存图像的边界不是从 (0,0) 开始。比如一张子图可能来自大画布的 (80,40) 区域，此时 Point.In 比较的是完整坐标，而不是把点自动平移成局部坐标。判断点击位置时，必须确认点击事件和 Bounds() 使用的是同一坐标系。

package main

import (
    "fmt"
    "image"
)

func main() {
    // 这是位于大画布偏移位置的子区域，不是从零开始的矩形。
    subBounds := image.Rect(80, 40, 180, 120)
    canvasPoint := image.Pt(85, 45)
    localPoint := image.Pt(5, 5)

    // 画布坐标可以直接与 subBounds 比较。
    fmt.Println("canvas:", canvasPoint.In(subBounds))
    // 局部坐标需要先映射到同一坐标系，否则会被判定为不在范围内。
    fmt.Println("local:", localPoint.In(subBounds))
}

上例中 (85,45) 是子区域里的画布坐标，能够命中；(5,5) 虽然表示局部区域中的偏移，却不属于 (80,40)-(180,120) 这个全局矩形。若业务拿到的是局部坐标，就要先加上子图的起点，再调用 In。

空矩形和边界相接都应视为未命中

当 Min 与 Max 在某个维度相等，矩形没有有效像素范围。点落在这种区域的边界线上，也不应继续做像素访问。可以先用 Empty() 处理矩形本身，再用 Point.In 判断具体坐标。

package main

import (
    "fmt"
    "image"
)

// containsPixel 统一处理空矩形和坐标命中。
func containsPixel(point image.Point, bounds image.Rectangle) bool {
    // Empty 表示至少一个方向没有有效范围，避免无意义的后续操作。
    if bounds.Empty() {
        return false
    }
    // 只有在矩形有面积时，才检查点是否处于半开区间内。
    return point.In(bounds)
}

func main() {
    empty := image.Rect(20, 20, 20, 40)
    touchingPoint := image.Pt(20, 25)

    // X 方向宽度为零，所以即使点落在边界线上也不会命中。
    fmt.Println(containsPixel(touchingPoint, empty))
}

这一步的意义不是替换 In，而是让“没有面积”和“有面积但点在外部”都能被明确处理。对于只需要布尔结果的调用，直接调用 point.In(bounds) 也足够；当空区域会触发额外分支时，再提前写出 Empty() 能让意图更清楚。

接入点击与裁剪前的安全边界

坐标命中检查应该位于像素读取、设置像素或子图裁剪之前。它只负责几何范围，不负责验证颜色、缩放比例或图像格式。对于实现了 SubImage 的图像类型，裁剪矩形还必须与原图使用同一坐标系。

package main

import (
    "image"
)

// shouldReadPixel 只负责判断坐标，调用方可据此决定是否访问图像。
func shouldReadPixel(img image.Image, point image.Point) bool {
    // Bounds 返回的矩形与 Image.At 使用同一套坐标约定。
    return point.In(img.Bounds())
}

// cropBounds 返回可继续处理的裁剪区域；没有交集时返回 false。
func cropBounds(img image.Image, requested image.Rectangle) (image.Rectangle, bool) {
    // 先把外部请求限制在图像边界内，避免把越界区域交给后续实现。
    clipped := img.Bounds().Intersect(requested)
    // 空交集表示请求完全落在图像范围之外。
    if clipped.Empty() {
        return image.Rectangle{}, false
    }
    return clipped, true
}

在真实处理链路里，Point.In 适合做单点命中，Intersect 适合做矩形裁剪范围收敛。两者都依赖坐标系一致；如果请求来自局部组件而图像来自父画布，应先完成坐标映射，再做判断。

常见问题

Point.In 会把 Max 点算进去吗？

不会。矩形右边界和下边界是排他的，X == Max.X 或 Y == Max.Y 都不属于矩形。

为什么坐标看起来在图片上，却返回 false？

优先检查坐标系是否一致。图片可能有非零起点，或者调用方传入的是局部坐标而 Bounds() 返回的是画布坐标。

需要手写四个比较表达式吗？

不需要。直接使用 point.In(bounds) 能复用标准库的半开区间语义，减少边界条件分散在多处的问题。