diff --git a/README.md b/README.md index 7c6fe3e..b68918d 100644 --- a/README.md +++ b/README.md @@ -23,10 +23,11 @@ DEPENDENCIES: *If you don't use a feature, you don't need the dependency! -ffmpeg: For video creation. -ImageMagick: Used for making proxy sequence. -Python 3 + libs: Used for auto white balance. + -exiftool + xxd: Used in mlv2badpixels.sh. -VERSION: 1.4.0 +VERSION: 1.5.0 -OPTIONS: +OPTIONS, BASIC: -v version - Print out version string. -o OUTDIR - The path in which files will be placed (no space btwn -o and path). -M MLV_DUMP - The path to mlv_dump (no space btwn -M and path). Default is './mlv_dump'. @@ -34,48 +35,63 @@ OPTIONS: -y PYTHON - The path or command used to invoke Python. Defaults to python3. -B MLV_BP - The path to mlv2badpixels.sh (by dfort). Default is './mlv2badpixels.sh'. - -H[0:9] HIGHLIGHT_MODE - 3 to 9 does degrees of colored highlight reconstruction, 1 and 2 allow clipping. 0 is default. - --> Use -H (no space). + +OPTIONS, OUTPUT: + -i IMAGE - Specify to create a TIFF sequence. + + -m MOVIE - Specify to create a Prores4444 video. + + -f FPS - Specify the FPS to create the movie at. Defaults to 24. + + -p[0:3] PROXY - Specifies the proxy mode. + --> 0: No proxies. 1: H.264 proxy. 2: JPG proxy sequence. 3: Both. -s[0%:100%] PROXY_SCALE - the size, in %, of the proxy output. - --> Use -s% (no space). 50% is default. + --> Use -s% (no space). 50% is default. - -m HQ_MOV - Use to create a Prores 4444 file. + -k KEEP_DNGS - Specify if you want to keep the DNG files. + --> Besides testing, this makes the script a glorified mlv_dump... - -p LQ_MOV - Use to create a low quality H.264 mp4 from the proxies. - - -D DELETE_IMGS - Use to delete not only TMP, but also the TIF and proxy sequences. - --> Useful if all you want are video files. +OPTIONS, RAW DEVELOPMENT: -d[0:3] DEMO_MODE - DCraw demosaicing mode. Higher modes are slower. 1 is default. --> Use -d (no space). 0: Bilinear. 1: VNG (default). 2: PPG. 3: AHD. + -H[0:9] HIGHLIGHT_MODE - 3 to 9 does degrees of colored highlight reconstruction, 1 and 2 allow clipping. + --> Use -H (no space). 0 is default. + + -b BADPIXELS - Fix focus pixels issue using dfort's script. + --> His file can be found at https://bitbucket.org/daniel_fort/ml-focus-pixels/src. + -n[int] NOISE_REDUC - This is the threshold of wavelet denoising - specify to use. + --> Use -n. Defaults to no denoising. 150 tends to be a good setting; 350 starts to look strange. + + -g[0:4] GAMMA - This is a modal gamma curve that is applied to the image. 0 is default. + --> Use -g (no space). 0: Linear. 1: 2.2 (Adobe RGB). 2: 1.8 (ProPhoto RGB). 3: sRGB. 4: BT.709. + + -S SHALLOW - Specifying this option will create an 8-bit output instead of a 16-bit output. + --> It'll kind of ruin the point of RAW, though.... + + +OPTIONS, COLOR: + -w[0:3] WHITE - This is a modal white balance setting. Defaults to 0. 1 doesn't always work very well. + --> Use -w (no space). + --> 0: Auto WB (Requires Python Deps). 1: Camera WB. 2: No Change. + + -A[int] WHITE_SPD - This is the speed of the auto white balance, causing quality loss. Defaults to 15. + --> For AWB, the script averages the entire sequence, skipping n frames each time. This value is n. + + -l LUT - This is a path to the 3D LUT. Specify the path to the LUT to use it. + --> Compatibility determined by ffmpeg (.cube is supported). + --> Path to LUT (no space between -l and path). Without specifying -l, no LUT will be applied. + + +OPTIONS, DEPENDENCIES: -K Debian Package Deps - Lists dependecies. Works with apt-get on Debian; should be similar elsewhere. --> No operations will be done. - --> Example: sudo apt-get install $ (./convmlv -K) -Y Python Deps - Lists Python dependencies. Works with pip. --> No operations will be done. --> Example: sudo pip3 install $ (./convmlv -Y) - -g[0:4] GAMMA - This is a modal gamma curve that is applied to the image. 0 is default. - --> Use -g (no space). 0: Linear. 1: 2.2 (Adobe RGB). 2: 1.8 (ProPhoto RGB). 3: sRGB. 4: BT.709. - - -P DEPTH - Specifying this option will create an 8-bit output instead of a 16-bit output. - --> It'll kind of ruin the point of RAW, though.... - - -W[0:3] WHITE - This is a modal white balance setting. Defaults to 0. 1 doesn't always work very well. - --> Use -W (no space). - --> 0: Auto WB (Requires Python Deps). 1: Camera WB (If retrievable). 2: No WB Change. 3: Custom WB ( - - -l LUT - This is a path to the 3D LUT. Specify the path to the LUT to use it. - --> Compatibility determined by ffmpeg (.cube is supported). - --> Path to LUT (no space between -l and path). Without specifying -l, no LUT will be applied. - - -n[int] NOISE_REDUC - This is the threshold of wavelet denoising - specify to use. - --> Use -n. Defaults to no denoising. 150 tends to be a good setting; 350 starts to look strange. - - -b BADPIXELS - Fix focus pixels issue using dfort's script. - --> His file can be found at https://bitbucket.org/daniel_fort/ml-focus-pixels/src. ```