jordan/camera-streamer
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

docs: update resolution.md

Browse Source
This commit is contained in:
Kamil Trzciński 2023-06-12 12:26:52 +02:00 committed by Kamil Trzcinski
parent a4082fbd20
commit 55b6588734
1 changed files with 14 additions and 8 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

22
docs/configure.md
View File

@ -2,12 +2,18 @@
## Resolution ## Resolution
Camera capture and resolution exposed is controlled by threee parameters: Camera capture and resolution exposed is controlled by three parameters:
- `--camera-width` and `--camera-height` define the camera capture resolution - `--camera-width` and `--camera-height` define the camera capture resolution
- `--camera-snapshot.height` - define height for an aspect ratio scaled resolution for `/snapshot` (JPEG) output - this might require rescaller and might not always work - `--camera-snapshot.height` - define height for an aspect ratio scaled resolution for `/snapshot` (JPEG) output - this might require rescaller and might not always work
- `--camera-stream.height` - define height for an aspect ratio scaled resolution for `/stream` (MJPEG) output - this might require rescaller and might not always work - `--camera-video.height` - define height for an aspect ratio scaled resolution for `/video` and `/webrtc` (H264) output - this might require rescaller and might not always work, this is no larger than `--camera-snapshot.height`
- `--camera-video.height` - define height for an aspect ratio scaled resolution for `/video` and `/webrtc` (H264) output - this might require rescaller and might not always work - `--camera-stream.height` - define height for an aspect ratio scaled resolution for `/stream` (MJPEG) output - this might require rescaller and might not always work, this is no larger than `--camera-video.height`
The resolution scaling is following the `snapshot >= video >= stream`:
- `snapshot` provides a high quality image for the purpose of timelapses (3Mbps-10Mbps)
- `video` is an efficient high-quality H264 video stream (3-10Mbps)
- `stream` is an inefficient MJPEG stream requiring significant amount of bandwidth (10-100Mbps)
### Example: Raspberry PI v3 Camera (best) ### Example: Raspberry PI v3 Camera (best)
@ -26,7 +32,7 @@ needs to be configured with the native resolution of camera sensor, only then th
can be downscaled. can be downscaled.
```text ```text
--camera-width=2304 --camera-height=1296 --camera-snapshot.height=1080 --camera-video.height=720 --camera-snapshot.height=480 --camera-width=2304 --camera-height=1296 --camera-snapshot.height=1080 --camera-video.height=720 --camera-stream.height=480
``` ```
This will result in: This will result in:
@ -34,14 +40,14 @@ This will result in:
- camera will capture `2304x1296` a full sensor - camera will capture `2304x1296` a full sensor
- `snapshot` be ~1920x1080 - `snapshot` be ~1920x1080
- `video` be ~1280x720 - `video` be ~1280x720
- `snapshot` be ~640x480 - `stream` be ~640x480
### Example: Raspberry PI v3 Camera with cropped output (bad) ### Example: Raspberry PI v3 Camera with cropped output (bad)
If the camera capture is not configured properly the result image will be cropped. If the camera capture is not configured properly the result image will be cropped.
```text ```text
--camera-width=1920 --camera-height=1080 --camera-snapshot.height=1080 --camera-video.height=720 --camera-snapshot.height=480 --camera-width=1920 --camera-height=1080 --camera-snapshot.height=1080 --camera-video.height=720 --camera-stream.height=480
``` ```
This will result in: This will result in:
@ -49,7 +55,7 @@ This will result in:
- camera will capture the middle `1920x1080` from the `2304x1296` - camera will capture the middle `1920x1080` from the `2304x1296`
- `snapshot` be ~1920x1080 - `snapshot` be ~1920x1080
- `video` be ~1280x720 - `video` be ~1280x720
- `snapshot` be ~640x480 - `stream` be ~640x480
## List all available controls ## List all available controls
@ -90,7 +96,7 @@ v4l2-ctl -d /dev/video0 --list-formats-ext
Some of them might be specified to streamer: Some of them might be specified to streamer:
```bash ```bash
tools/*_camera.sh --camera-format=RG10 # Bayer 10 packet tools/*_camera.sh --camera-format=RG10 # Bayer 10 packed
tools/*_camera.sh --camera-format=YUYV tools/*_camera.sh --camera-format=YUYV
tools/*_camera.sh --camera-format=MJPEG tools/*_camera.sh --camera-format=MJPEG
tools/*_camera.sh --camera-format=H264 # This is unstable due to h264 key frames support tools/*_camera.sh --camera-format=H264 # This is unstable due to h264 key frames support