3a799c0a65
- Modified recv_raw_rolling.py to handle 2456x1 BGR line format - Fixed display dimensions (2456 tall x 800 wide) - Updated 200fps-2456x4pix-cw.ini to start at Y=500 - Added detailed single line transmission docs to network_guide.md - Updated README.md with quick start example using videocrop
78 lines
2.2 KiB
Markdown
78 lines
2.2 KiB
Markdown
# How to Send a Single Line (2456x1)
|
||
|
||
## Real Data - Single Line Transmission
|
||
|
||
The camera captures 2456x4 pixels, but we extract and transmit only **one line (2456x1)** using `videocrop`.
|
||
|
||
### Daytime Configuration (200fps)
|
||
```powershell
|
||
gst-launch-1.0 idsueyesrc config-file=ini/200fps-2456x4pix-cw.ini exposure=5 framerate=200 `
|
||
! videocrop bottom=3 `
|
||
! queue `
|
||
! udpsink host=127.0.0.1 port=5000
|
||
```
|
||
|
||
### Nighttime Configuration (100fps, extra gain)
|
||
```powershell
|
||
gst-launch-1.0 idsueyesrc config-file=ini/100fps-10exp-2456x4pix-500top-cw-extragain.ini exposure=10 framerate=100 `
|
||
! videocrop bottom=3 `
|
||
! queue `
|
||
! udpsink host=127.0.0.1 port=5000
|
||
```
|
||
|
||
**Key Parameters:**
|
||
- `videocrop bottom=3` - Extracts only the top line (removes bottom 3 rows from 2456x4 image)
|
||
- Input: 2456x4 BGR from camera
|
||
- Output: 2456x1 BGR line transmitted via UDP
|
||
- Frame size: 7368 bytes (2456 × 1 × 3 channels)
|
||
|
||
**Alternative:** To extract the bottom line instead, use `videocrop top=3`
|
||
|
||
### Python/OpenCV Receiver
|
||
```pwsh
|
||
# Basic rolling display
|
||
uv run .\scripts\recv_raw_rolling.py
|
||
```
|
||
|
||
```pwsh
|
||
# With display throttling and recording
|
||
uv run .\scripts\recv_raw_rolling.py --display-fps 60 --save-mjpeg .\results\output_60fps.avi
|
||
```
|
||
|
||
```pwsh
|
||
# Max performance (no display, stats only)
|
||
uv run .\scripts\recv_raw_rolling.py --no-display
|
||
```
|
||
|
||
See [`scripts/recv_raw_rolling.py`](scripts/recv_raw_rolling.py) for the Python implementation with debug options.
|
||
|
||
|
||
## Configuration Notes
|
||
|
||
Both INI files are configured with:
|
||
- Start Y = 500 (captures from row 500 of the sensor)
|
||
- Height = 4 pixels
|
||
- Width = 2456 pixels
|
||
- This optimizes for the center region of the sensor
|
||
|
||
**Note:** `exposure=5` (5ms) may be too fast for some applications. Adjust based on your requirements.
|
||
|
||
---
|
||
|
||
# Demo Data (Testing)
|
||
## Sender (crop to first column, send raw over UDP)
|
||
```pwsh
|
||
gst-launch-1.0 -v `
|
||
videotestsrc pattern=smpte ! `
|
||
videocrop left=0 right=639 top=0 bottom=0 ! `
|
||
video/x-raw,format=RGB,width=1,height=640,framerate=30/1 ! `
|
||
udpsink host=127.0.0.1 port=5000
|
||
```
|
||
|
||
### GStreamer Receiver (raw UDP → display)
|
||
```pwsh
|
||
gst-launch-1.0 -v `
|
||
udpsrc port=5000 caps="video/x-raw,format=RGB,width=1,height=640,framerate=30/1" ! `
|
||
videoconvert ! `
|
||
autovideosink
|
||
``` |