# getColors

Sample several pixels from a single capture.

```js
getColors(locations)
```

## Arguments

| Argument | Type | Meaning |
| --- | --- | --- |
| `locations` | array | [{x,y}, ...] or [[x,y], ...]. |

## Returns

Array of color objects in input order; same invalid-value convention as getColor.

## Example

```js
console.log(getColors([[100, 100], [120, 100]]));
```

[All JavaScript APIs](https://mcp.applesauceos.com/doc/api.md) · [Automation playbook](https://mcp.applesauceos.com/doc/ai.md)