a02f378a4b
* Add docs for Lifecycle * Update CAPTURING.mdx * move * Update DEVICES.mdx * Update FRAME_PROCESSOR_PLUGIN_LIST.mdx * f * move FP * separate focusing * fix links
26 lines
1.2 KiB
Plaintext
26 lines
1.2 KiB
Plaintext
---
|
|
id: focusing
|
|
title: Focusing
|
|
sidebar_label: Focusing
|
|
---
|
|
|
|
To focus the camera to a specific point, simply use the Camera's [`focus(...)`](../api/classes/camera.camera-1#focus) function:
|
|
|
|
```ts
|
|
await camera.current.focus({ x: tapEvent.x, y: tapEvent.y })
|
|
```
|
|
|
|
The focus function expects a [`Point`](../api/interfaces/point.point-1) parameter which represents the location relative to the Camera view where you want to focus the Camera to (in _points_). If you use [react-native-gesture-handler](https://docs.swmansion.com/react-native-gesture-handler/), this will consist of the [`x`](https://docs.swmansion.com/react-native-gesture-handler/docs/api/gesture-handlers/tap-gh#x) and [`y`](https://docs.swmansion.com/react-native-gesture-handler/docs/api/gesture-handlers/tap-gh#y) properties of the tap event payload.
|
|
|
|
So for example, `{ x: 0, y: 0 }` will focus to the upper left corner, while `{ x: CAM_WIDTH, y: CAM_HEIGHT }` will focus to the bottom right corner.
|
|
|
|
Focussing adjusts auto-focus (AF) and auto-exposure (AE).
|
|
|
|
:::note
|
|
`focus(...)` will fail if the selected Camera device does not support focusing (see [`CameraDevice.supportsFocus`](/docs/api/interfaces/cameradevice.cameradevice-1#supportsfocus))
|
|
:::
|
|
|
|
<br />
|
|
|
|
#### 🚀 Next section: [Camera Errors](errors)
|