Manually editing VideoStich Studio *.ptv project files

VideoStitch Studio *.ptv project files contain a description of the input images, output panorama, and other project settings saved in JSON format.


If you do not know JSON, http://www.json.org/ and http://en.wikipedia.org/wiki/JavaScript_Object_Notation should get you started quickly.
Watch out for punctuation and syntax errors when editing *.ptv files. If you need to check whether your edited *.ptv files are valid JSON documents, jsonlint.com can help you find out instantly.

*.ptv file format is quiet self-explanatory. It contains the stitching project description. Values will be extracted from the *.pts/*.pto calibration files or filled in with defaults.

 

Video rendering range and buffer:

"first_frame": 0,
"last_frame": 9800,
"buffer_frames": 1

first_frame:
The frame at which rendering will start (included, 0 based index).

last_frame:
The frame at which rendering will end (included).

 

Panorama definition:

"pano" : {
 "width" : 4800,
 "height" : 2400,
 "pad_top" : 0,
 "pad_bottom" : 0,
 "hfov" : 360,
 "blend_zenith" : true,
 "blend_nadir" : true,
 "proj" : "equirectangular",
 "inputs" : [
  { ... },
  { ... },
  ...,
 ]
}

proj:
Supported output projections are equirectangular, ff_fisheye, rectilinear, stereographic.

pad_top & pad_bottom:
This adds extra padding at the top or bottom of the output video.

inputs:
An array of input definitions (there could be 1 to 32 inputs described), these are converted from PTGui/Hugin calibration by the import calibration tool.

 

Input definition:

 "filename": "path/to/camera_1.mp4",
 "proj": "ff_fisheye",

proj:
Supported output projections are equirectangular, ff_fisheye, rectilinear, stereographic.

filename:
Full absolute or relative path to the file, including extension. If you would like to work with image sequences, the file name must include a pattern that described the sequence. See : working with image sequences.

 

Output video definition:

"output": {
 "type": "mp4",
 "filename: "output"

type:

  • mp4: mp4 video container with mpeg2 (8000k)
  • jpg: 1 image per frame
  • tif: 1 image per frame

filename:
output by default.

 

Merger definition:

"merger" : {
 "type" : "laplacian",
 "levels" : 5,
 "gaussian_radius" : 5,
 "blend_radius" : 2,
 "hf_blend_radius" : 1,
 "filter_passes" : 3
}
Have more questions? Submit a request

0 Comments

Article is closed for comments.