Bump prettier to v3 and format all files
This commit is contained in:
@@ -4,24 +4,23 @@ Configures a `timeline` view used to show the timing sequence of events and
|
||||
recordings across multiple cameras.
|
||||
|
||||
```yaml
|
||||
timeline:
|
||||
[...]
|
||||
timeline: [...]
|
||||
```
|
||||
|
||||
You can interact with the timeline in a number of ways:
|
||||
|
||||
* Clicking on an event will take you to the media viewer for that event.
|
||||
* Clicking on the "background", or a camera title, will take you to the recordings for that camera (seeking to the clicked time).
|
||||
* Clicking on the time axis will take you to recordings for all cameras (seeking to the clicked time).
|
||||
- Clicking on an event will take you to the media viewer for that event.
|
||||
- Clicking on the "background", or a camera title, will take you to the recordings for that camera (seeking to the clicked time).
|
||||
- Clicking on the time axis will take you to recordings for all cameras (seeking to the clicked time).
|
||||
|
||||
| Option | Default | Description |
|
||||
| - | - | - |
|
||||
| `clustering_threshold` | `3` | The minimum number of overlapping events to allow prior to clustering/grouping them. Higher numbers cause clustering to happen less frequently. Depending on the timescale/zoom of the timeline, the underlying timeline library may still allow overlaps for low values of this parameter -- for a fully "flat" timeline use the `ribbon` style. `0` disables clustering entirely. Only used in the `stack` style of timeline. |
|
||||
| `controls` | | Configuration for the timeline controls. See below. |
|
||||
| `events_media_type` | `all` | Whether to show only events with `clips`, events with `snapshots` or `all` events. When `all` is used, `clips` are favored for events that have both a clip and a snapshot.|
|
||||
| `show_recordings` | `true` | Whether to show recordings on the timeline (specifically: which hours have any recorded content).|
|
||||
| `style` | `stack` | Whether the timeline should show events as a single flat `ribbon` or a `stack` of events that are clustered using the `clustering_threshold`. |
|
||||
| `window_seconds` | `3600` | The length of the default timeline in seconds. By default, 1 hour (`3600` seconds) is shown in the timeline. |
|
||||
| Option | Default | Description |
|
||||
| ---------------------- | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
||||
| `clustering_threshold` | `3` | The minimum number of overlapping events to allow prior to clustering/grouping them. Higher numbers cause clustering to happen less frequently. Depending on the timescale/zoom of the timeline, the underlying timeline library may still allow overlaps for low values of this parameter -- for a fully "flat" timeline use the `ribbon` style. `0` disables clustering entirely. Only used in the `stack` style of timeline. |
|
||||
| `controls` | | Configuration for the timeline controls. See below. |
|
||||
| `events_media_type` | `all` | Whether to show only events with `clips`, events with `snapshots` or `all` events. When `all` is used, `clips` are favored for events that have both a clip and a snapshot. |
|
||||
| `show_recordings` | `true` | Whether to show recordings on the timeline (specifically: which hours have any recorded content). |
|
||||
| `style` | `stack` | Whether the timeline should show events as a single flat `ribbon` or a `stack` of events that are clustered using the `clustering_threshold`. |
|
||||
| `window_seconds` | `3600` | The length of the default timeline in seconds. By default, 1 hour (`3600` seconds) is shown in the timeline. |
|
||||
|
||||
## `controls`
|
||||
|
||||
@@ -29,13 +28,12 @@ Configure the controls for the `timeline` view.
|
||||
|
||||
```yaml
|
||||
timeline:
|
||||
controls:
|
||||
[...]
|
||||
controls: [...]
|
||||
```
|
||||
|
||||
| Option | Default | Description |
|
||||
| - | - | - |
|
||||
| `thumbnails` | | Configures how thumbnails are shown on the `timeline` view. See below. |
|
||||
| Option | Default | Description |
|
||||
| ------------ | ------- | ---------------------------------------------------------------------- |
|
||||
| `thumbnails` | | Configures how thumbnails are shown on the `timeline` view. See below. |
|
||||
|
||||
### `thumbnails`
|
||||
|
||||
@@ -44,18 +42,17 @@ Configures how thumbnails are shown on the timeline.
|
||||
```yaml
|
||||
timeline:
|
||||
controls:
|
||||
thumbnails:
|
||||
[...]
|
||||
thumbnails: [...]
|
||||
```
|
||||
|
||||
| Option | Default | Description |
|
||||
| - | - | - |
|
||||
| `mode` | `none` | Whether to show the thumbnail carousel `below` the media, `above` the media, in a drawer to the `left` or `right` of the media or to hide it entirely (`none`).|
|
||||
| `show_details` | `false` | Whether to show event details (e.g. duration, start time, object detected, etc) alongside the thumbnail.|
|
||||
| `show_download_control` | `true` | Whether to show the download control on each thumbnail.|
|
||||
| `show_favorite_control` | `true` | Whether to show the favorite ('star') control on each thumbnail.|
|
||||
| `show_timeline_control` | `true` | Whether to show the timeline ('target') control on each thumbnail.|
|
||||
| `size` | `100` | The size of the thumbnails in the thumbnail carousel in pixels. Must be >= `75` and <= `175`.|
|
||||
| Option | Default | Description |
|
||||
| ----------------------- | ------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
||||
| `mode` | `none` | Whether to show the thumbnail carousel `below` the media, `above` the media, in a drawer to the `left` or `right` of the media or to hide it entirely (`none`). |
|
||||
| `show_details` | `false` | Whether to show event details (e.g. duration, start time, object detected, etc) alongside the thumbnail. |
|
||||
| `show_download_control` | `true` | Whether to show the download control on each thumbnail. |
|
||||
| `show_favorite_control` | `true` | Whether to show the favorite ('star') control on each thumbnail. |
|
||||
| `show_timeline_control` | `true` | Whether to show the timeline ('target') control on each thumbnail. |
|
||||
| `size` | `100` | The size of the thumbnails in the thumbnail carousel in pixels. Must be >= `75` and <= `175`. |
|
||||
|
||||
## Fully expanded reference
|
||||
|
||||
@@ -76,4 +73,4 @@ timeline:
|
||||
show_download_control: true
|
||||
show_favorite_control: true
|
||||
show_timeline_control: true
|
||||
```
|
||||
```
|
||||
|
||||
Reference in New Issue
Block a user