Skip to content

Commit b251c06

Browse files
authored
Update README.md to talk about 5.7K (#7)
Update documentation. Improve join-insv script.
1 parent edee296 commit b251c06

File tree

2 files changed

+24
-3
lines changed

2 files changed

+24
-3
lines changed

README.md

Lines changed: 21 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -77,6 +77,21 @@ editing software).
7777
media player](https://www.videolan.org/) or uploaded to YouTube as a 360
7878
video.
7979

80+
For 5.7K videos, separate video files like
81+
`/path/to/VID_20240528_113402_00_032.insv` and
82+
`/path/to/VID_20240528_113402_10_032.insv` are generated by the camera for
83+
the left-eye and right-eye views. Both files need to be supplied to the
84+
`-input` argument of `MediaSDKTest`, in the aforementioned order. For
85+
example,
86+
87+
```bash
88+
# For 5.7K video
89+
MediaSDKTest \
90+
-inputs VID_20240528_113402_00_032.insv VID_20240528_113402_10_032.insv \
91+
-output "both_eyes.mp4" \
92+
-enable_directionlock -enable_flowstate -enable_denoise
93+
```
94+
8095
## Utility: `join-insv`
8196

8297
The utility `join-insv` is available in the container to automate the above
@@ -86,6 +101,12 @@ workflow. Example
86101
# For 4K and lower resolution
87102
join-insv --output /path/to/merged_360video.mp4 \
88103
/path/to/input-1. insv /path/to/input-2.insv ...
104+
105+
# For 5.7K
106+
join-insv --output /path/to/merged_5.7k_360video.mp4 \
107+
/path/to/VID_20240528_113402_00_001.insv /path/to/VID_20240528_113402_10_001.insv \
108+
/path/to/VID_20240528_120003_00_002.insv /path/to/VID_20240528_120003_10_002.insv \
109+
...
89110
```
90111

91112
The synopsis of `join-insv` is as follows.

scripts/join-insv

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@
33
# Join 360-degree INSV files into a single MP4
44
#
55

6-
set -euxo pipefail
6+
set -euo pipefail
77

88
#######################################################
99
# Self test
@@ -45,6 +45,8 @@ join_insv() {
4545
exit 1
4646
fi
4747

48+
self_test
49+
4850
local is_57k=$1
4951
local outfile="$2"
5052
shift 2
@@ -134,6 +136,4 @@ cli() {
134136

135137
}
136138

137-
138-
self_test
139139
cli "$@"

0 commit comments

Comments
 (0)