@@ -41,59 +41,98 @@ git submodule update
4141
4242```
4343Usage:
44- ./reproject [OPTION...]
44+ ./bin/ reproject [OPTION...]
4545
4646 Color processing options:
47- --exposure EV Exposure compensation in stops (EV) to brigthen or
47+ --exposure EV Exposure compensation in stops (EV) to brigthen or
4848 darken the pictures. (default: 0.0)
49- --reinhard max Use reinhard tonemapping with given maximum value
50- (after exposure processing) on the output images.
49+ --reinhard max Use reinhard tonemapping with given maximum value
50+ (after exposure processing) on the output images.
5151 (default: 1.0)
5252
53+ Filter files options:
54+ --filter-prefix prefix Only include files starting with (default:
55+ "")
56+ --filter-suffix suffix Only include files ending with (default: "")
57+
58+ Input optics.
59+ These are usually inferred by the config JSONs. When specifying
60+ --no-configs, lens information needs to be passed through these
61+ command line options options:
62+ --i-rectilinear focal_length,sensor_width
63+ Input rectilinear images with given
64+ focal_length,sensor_width tuple.
65+ --i-equisolid focal_length,sensor_width,fov
66+ Input equisolid images with given
67+ focal_length,sensor_width,fov tuple.
68+ --i-equidistant fov Input equidistant images with given fov
69+ value.
70+ --i-equirectangular long_min,long_max,lat_min,lat_max (radians)
71+ Input equirectangular images with given
72+ longitude min,max and latitude min,max
73+ value or 'full'.
74+
5375 Input/output options:
54- --input-cfg json-file Input JSON file containing lens and camera
55- settings of the input images.
56- --output-cfg json-file Output JSON file containing lens and camera
57- settings of the input images.
58- -i, --input-dir file Input directory containing images to
59- reproject.
60- --single file A single input file to convert.
61- -o, --output-dir file Output directory to put the reprojected
62- images.
63- --exr Output EXR files. Color and depth.
64- --png Output PNG files. Color only.
76+ --input-cfg json-file Input JSON file containing lens and camera
77+ settings of the input images.
78+ --output-cfg json-file Output JSON file containing lens and camera
79+ settings of the output images.
80+ --no-configs width,height
81+ Work without reading and writing config
82+ files. Requires you to specify the input
83+ lens through the input-optics flags
84+ (staring with -i-...) and the expected
85+ resolution of the input images here.
86+ -i, --input-dir file Input directory containing images to
87+ reproject.
88+ --single file A single input file to convert.
89+ -o, --output-dir file Output directory to put the reprojected
90+ images.
91+ --exr Output EXR files. Color and depth.
92+ --png Output PNG files. Color only.
6593
6694 Output optics options:
6795 --no-reproject Do not reproject at all.
6896 --rectilinear focal_length,sensor_width
69- Output rectilinear images with given
97+ Output rectilinear images with given
7098 focal_length,sensor_width tuple.
7199 --equisolid focal_length,sensor_width,fov
72- Output equisolid images with given
100+ Output equisolid images with given
73101 focal_length,sensor_width,fov tuple.
74- --equidistant fov Output equidistant images with given fov
102+ --equidistant fov Output equidistant images with given fov
75103 value.
104+ --equirectangular longitude_min,longitude_max,latitude_min,latitude_max
105+ Output equirectangular images with given
106+ longitude min,max and latitude min,max
107+ value or 'full'.
108+ --rotation pan, pitch, roll (degrees)
109+ Specify a rotation (default: 0.0)
76110
77111 Runtime options:
78- -j, --parallel threads Number of parallel images to process. (default:
112+ --skip-if-exists Skip if the output file already exists.
113+ -j, --parallel threads Number of parallel images to process. (default:
79114 1)
80- --dry-run Do not actually reproject images. Only produce
115+ --dry-run Do not actually reproject images. Only produce
81116 config.
82117 -h, --help Show help
83118
84119 Sampling options:
85- -s, --samples number Number of samples per dimension for interpolating
86- (default: 1)
87- --nn Nearest neighbor interpolation
88- --bl Bilinear interpolation
89- --bc Bicubic interpolation (default)
90- --scale percentage Output scale, as a fraction of the input size. It
91- is recommended to increase --samples to prevent
92- aliassing in case you are downscaling. Eg:
93- --scale 0.5 --samples 2 or --scale 0.33334
94- --samples 3 or --scale 0.25 --samples 4. Final
95- dimensions are rounded towards zero. (default:
96- 1.0)
120+ -s, --samples number Number of samples per dimension for
121+ interpolating (default: 1)
122+ --nn Nearest neighbor interpolation
123+ --bl Bilinear interpolation
124+ --bc Bicubic interpolation (default)
125+ --scale percentage Output scale, as a fraction of the input
126+ size. It is recommended to increase
127+ --samples to prevent aliassing in case you
128+ are downscaling. Eg: --scale 0.5 --samples
129+ 2 or --scale 0.33334 --samples 3 or --scale
130+ 0.25 --samples 4. Final dimensions are
131+ rounded towards zero. (default: 1.0)
132+ --output-resolution width,height
133+ A fixed output resolution. Overwrites the
134+ behavior of the 'scale' parameter.
135+
97136```
98137
99138### Configuration JSON
0 commit comments