Convert 360 videos between various formats. Supported formats (projections) are subset of v360 filter, that are most popular 360-degree video formats.
The filter accepts subset of v360 options:
- input, output
-
Set format of the input/output video.
- e, equirect
-
Equirectangular projection.
- eac
-
Equi-Angular Cubemap. (Output only)
FIXME: current output doesn’t contain padding.
- flat
-
Regular video.
- dfisheye
-
Dual fisheye.
- sg
-
Stereographic format.
- fisheye
-
Fisheye projection.
- gopromax
-
GoPro Max .360 format. (Input only)
A .360 video file contains two video streams (front and rear); with this input projection the filter takes two inputs and combines them into a single stream. See the overlap option.
- w, h
-
Set the output video resolution. See v360 options.
- yaw, pitch, roll, rorder
-
Set rotation for the output video. See v360 options.
- h_fov, v_fov
-
Set output horizontal/vertical field of view. See v360 options.
- ih_fov, iv_fov
-
Set input horizontal/vertical field of view. See v360 options.
- overlap
-
Set number of overlapped pixels on input .360 video. Only used with
input=gopromax.The GoPro Max .360 video contains overlapped area (See https://gopro.com/news/max-tech-specs-stitching-resolution). The filter blends overlapped images in these two areas.
The number of pixels of overlapped areas depends on the video resolution. In most cases, the value is automatically calculated based on input video size, but it may be changed on GoPro Max2 or future models. The option is to adjust for unknown video resolutions.
Examples
Special notes exist to use with input=gopromax.
The GoPro Max .360 video file contains two video streams,
and the stream number must be specified.
The stream number (e.g., [0:5]) depends on the model and shooting mode.
Please check actual stream number with ffprobe command.
-
Convert GoPro Max (8bit color depth) .360 to Equirectangular projection. GoPro Max uses obsolete yuvj420p pixel format, thus convert the format to yuv420p before this filter.
ffmpeg -init_hw_device vulkan -i INPUT.360 -filter_complex "[0:0]format=yuv420p,hwupload[vf],[0:5]format=yuv420p,hwupload[vr], [vf][vr]v360_vulkan=input=gopromax:output=e, hwdownload,format=yuv420p" OUTPUT.mkv
-
Convert GoPro Max2 (10bit color depth) .360 to Dual fisheye projection. GoPro Max2 uses yuv420p10le pixel format.
ffmpeg -init_hw_device vulkan -i INPUT.360 -filter_complex "[0:0]hwupload[vf],[0:4]hwupload[vr], [vf][vr]v360_vulkan=input=gopromax:output=dfisheye, hwdownload,format=yuv420p10le" OUTPUT.mkv