Skip to main content

# Request a Picked Point (LCC.assist.pick_point)

## Declaration​

    result, err, task = LCC.assist.pick_point(options)

## Parameters​

- options
  Table. Assist request configuration. See Common Options and Return Objects. This function sets `type = "point"` automatically.

## Return Values​

- result
  Table or `nil`. On success, includes physical device coordinates `x` and `y`.
- err
  String or `nil`. Failure reason.
- task
  Table or `nil`. The latest task state.

## Notes​

> Use this when the operator can decide where to tap from the screenshot and the script can directly tap the returned coordinate.
> `result.x` and `result.y` are physical device coordinates and can be used directly with `touch.tap(result.x, result.y)`.
> If you pass a cropped screenshot, also pass `imageRect`; the control center maps the picked image coordinate back to physical device coordinates.

## Example​

    local result, err = LCC.assist.pick_point({
        title = "Pick confirm button",
        text = "Pick the center of the confirm button",
        screenshotLocalPath = XXT_SCRIPTS_PATH .. "/screen.png",
        timeout = 180,
    })

    if result then
        touch.tap(result.x, result.y)
    end

Cropped-image example:

    local result, err = LCC.assist.pick_point({
        title = "Pick button",
        text = "Pick the confirm button in this cropped image",
        screenshotLocalPath = XXT_SCRIPTS_PATH .. "/button-crop.png",
        imageRect = { left = 120, top = 360, width = 300, height = 160 },
    })