so-rose
/
convmlv
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases 3 Wiki Activity

Little tweaks

modularize
Sofus Albert Høgsbro Rose 2016-04-12 18:20:10 -04:00
parent 784bddd449
commit f560d8f9c6
2 changed files with 62 additions and 51 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

62
README.md
View File

@ -14,10 +14,12 @@ Usage:
./convmlv.sh [OPTIONS] mlv_files ./convmlv.sh [OPTIONS] mlv_files
INFO: INFO:
A script allowing you to convert .MLV, .RAW, or a folder with a DNG sequence into a sequence/movie A script allowing you to convert .MLV, .RAW, or a folder with a DNG sequence into a sequence/movie with optional proxies. Images
with optional proxies. Many useful options are exposed, including formats (EXR by default). are auto compressed. Many useful options are exposed, including formats (EXR by default).
DEPENDENCIES: *If you don't use a feature, you don't need the dependency. Don't use a feature without the dependency. VERSION: 1.8.0
DEPENDENCIES: If you don't use a feature, you don't need the dependency, though it's best to download them all.
-mlv_dump: For DNG extraction from MLV. http://www.magiclantern.fm/forum/index.php?topic=7122.0 -mlv_dump: For DNG extraction from MLV. http://www.magiclantern.fm/forum/index.php?topic=7122.0
-raw2dng: For DNG extraction from RAW. http://www.magiclantern.fm/forum/index.php?topic=5404.0 -raw2dng: For DNG extraction from RAW. http://www.magiclantern.fm/forum/index.php?topic=5404.0
-mlv2badpixels.sh: For bad pixel removal. https://bitbucket.org/daniel_fort/ml-focus-pixels/src -mlv2badpixels.sh: For bad pixel removal. https://bitbucket.org/daniel_fort/ml-focus-pixels/src
@ -25,9 +27,8 @@ DEPENDENCIES: *If you don't use a feature, you don't need the dependency. Don't
-ffmpeg: For video creation. -ffmpeg: For video creation.
-ImageMagick: Used for making proxy sequence. -ImageMagick: Used for making proxy sequence.
-Python 3 + libs: Used for auto white balance. -Python 3 + libs: Used for auto white balance.
-exiftool + xxd: Used in mlv2badpixels.sh. -exiftool: Used in mlv2badpixels.sh.
VERSION: 1.7.1
OPTIONS, BASIC: OPTIONS, BASIC:
-v version - Print out version string. -v version - Print out version string.
@ -36,16 +37,17 @@ OPTIONS, BASIC:
-R<path> RAW_DUMP - The path to raw2dng (no space btwn -M and path). Default is './raw2dng'. -R<path> RAW_DUMP - The path to raw2dng (no space btwn -M and path). Default is './raw2dng'.
-y<path> PYTHON - The path or command used to invoke Python. Defaults to python3. -y<path> PYTHON - The path or command used to invoke Python. Defaults to python3.
-B<path> MLV_BP - The path to mlv2badpixels.sh (by dfort). Default is './mlv2badpixels.sh'. -B<path> MLV_BP - The path to mlv2badpixels.sh (by dfort). Default is './mlv2badpixels.sh'.
-T[int] Max process threads, for multithreaded parts of the program. Defaults to 8. -T[int] Max process threads, for multithreaded parts of the program. Defaults to 8.
OPTIONS, OUTPUT: OPTIONS, OUTPUT:
-i IMAGE - Specify to create an image sequence (EXR by default). -i IMAGE - Specify to create an image sequence (EXR by default).
-f[0:3] IMG_FMT - Create a sequence of <format> format, instead of a TIFF sequence. -f[0:3] IMG_FMT - Create a sequence of <format> format. 0 is default.
--> 0: EXR (default), 1: TIFF, 2: PNG, 3: Cineon (DPX). --> 0: EXR (default), 1: TIFF, 2: PNG, 3: Cineon (DPX)."
-c COMPRESS - Specify to automatically compress the image sequence. -c COMPRESS - Specify to turn ***off*** automatic image compression. Auto compression options otherwise used:
--> TIFF: ZIP (best for 16-bit), PIZ for EXR (best for grainy images), PNG: lvl 9 (zlib deflate), DPX: RLE. --> TIFF: ZIP (best for 16-bit), PIZ for EXR (best for grainy images), PNG: lvl 9 (zlib deflate), DPX: RLE.
--> EXR's piz compression tends to be fastest + best. --> EXR's piz compression tends to be fastest + best.
@ -53,7 +55,7 @@ OPTIONS, OUTPUT:
-p[0:3] PROXY - Specifies the proxy mode. 0 is default. -p[0:3] PROXY - Specifies the proxy mode. 0 is default.
--> 0: No proxies. 1: H.264 proxy. 2: JPG proxy sequence. 3: Both. --> 0: No proxies. 1: H.264 proxy. 2: JPG proxy sequence. 3: Both.
--> Proxies won't be developed without the main output - ex. JPG proxies require -i. --> JPG proxy won't be developed w/o -i. H.264 proxy will be developed no matter what, if specified.
-s[0%:100%] PROXY_SCALE - the size, in %, of the proxy output. -s[0%:100%] PROXY_SCALE - the size, in %, of the proxy output.
--> Use -s<percentage>% (no space). 50% is default. --> Use -s<percentage>% (no space). 50% is default.
@ -63,27 +65,23 @@ OPTIONS, OUTPUT:
OPTIONS, RAW DEVELOPMENT: OPTIONS, RAW DEVELOPMENT:
-u DUAL_ISO - Process file as dual ISO.
-d[0:3] DEMO_MODE - DCraw demosaicing mode. Higher modes are slower. 1 is default. -d[0:3] DEMO_MODE - DCraw demosaicing mode. Higher modes are slower. 1 is default.
--> Use -d<mode> (no space). 0: Bilinear. 1: VNG (default). 2: PPG. 3: AHD. --> Use -d<mode> (no space). 0: Bilinear. 1: VNG (default). 2: PPG. 3: AHD.
-r FOUR_COLOR - Interpolate as four colors. Can often fix weirdness with VNG/AHD. -r FOUR_COLOR - Interpolate as four colors. Can often fix weirdness with VNG/AHD.
-H[0:9] HIGHLIGHT_MODE - 2 looks the best, without major modifications. 0 is also a safe bet. -H[0:9] HIGHLIGHT_MODE - 2 looks the best, but can break. 0 is a safe bet.
--> Use -H<number> (no space). 0 clips. 1 allows colored highlights. 2 adjusts highlights to grey. --> Use -H<number> (no space). 0 clips. 1 allows colored highlights. 2 adjusts highlights to grey.
--> 3 through 9 do highlight reconstruction with a certain tone. See dcraw documentation. --> 3 through 9 do highlight reconstruction with a certain tone. See dcraw documentation.
-b BADPIXELS - Fix focus pixels issue using dfort's script. -C[0:3] CHROMA_SMOOTH - Apply chroma smoothing to the footage, which may help ex. with noise/bad pixels.
--> His file can be found at https://bitbucket.org/daniel_fort/ml-focus-pixels/src. --> 0: None (default). 1: 2x2. 2: 3x3. 3: 5x5.
--> Only applied to .MLV files.
-a<path> BADPIXEL_PATH - Use, appending to the generated one, your own .badpixels file. REQUIRES -b.
--> Use -a<path> (no space). How to: http://www.dl-c.com/board/viewtopic.php?f=4&t=686
-n[int] NOISE_REDUC - This is the threshold of wavelet denoising - specify to use. -n[int] NOISE_REDUC - This is the threshold of wavelet denoising - specify to use.
--> Use -n<number>. Defaults to no denoising. 150 tends to be a good setting; 350 starts to look strange. --> Use -n<number>. 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. -g[0:4] SPACE - This is output color space. 0 is default.
--> Use -g<mode> (no space). 0: Linear. 1: 2.2 (Adobe RGB). 2: 1.8 (ProPhoto RGB). 3: sRGB. 4: BT.709. --> Use -g<mode> (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. -S SHALLOW - Specifying this option will create an 8-bit output instead of a 16-bit output.
@ -91,14 +89,10 @@ OPTIONS, RAW DEVELOPMENT:
OPTIONS, COLOR: OPTIONS, COLOR:
-w[0:3] WHITE - This is a modal white balance setting. Defaults to 0. 1 doesn't always work very well. -w[0:2] WHITE - This is a modal white balance setting. Defaults to 0. 1 doesn't always work very well.
--> Use -w<mode> (no space). --> Use -w<mode> (no space).
--> 0: Auto WB (Requires Python Deps). 1: Camera WB. 2: No Change. --> 0: Auto WB (Requires Python Deps). 1: Camera WB. 2: No Change.
-F<path> DARKFRAME - This is the path to the dark frame MLV.
--> This is a noise reduction technique: Record 5 sec w/lens cap on & same settings as footage.
--> Pass in that MLV file (must be MLV) as <path> to get noise reduction on all passed MLV files.
-A[int] WHITE_SPD - This is the amount of samples from which AWB will be calculated. -A[int] WHITE_SPD - This is the amount of samples from which AWB will be calculated.
-->About this many frames, averaged over the course of the sequence, will be used to do AWB. -->About this many frames, averaged over the course of the sequence, will be used to do AWB.
@ -108,7 +102,24 @@ OPTIONS, COLOR:
--> Path to LUT (no space between -l and path). --> Path to LUT (no space between -l and path).
OPTIONS, DEPENDENCIES: OPTIONS, FEATURES:
-u DUAL_ISO - Process file as dual ISO.
-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.
-a<path> BADPIXEL_PATH - Use, appending to the generated one, your own .badpixels file.
--> Use -a<path> (no space). How to: http://www.dl-c.com/board/viewtopic.php?f=4&t=686
-F<path> DARKFRAME - This is the path to the dark frame MLV, for noise reduction.
--> This is a noise reduction technique: Record 5 sec w/lens cap on & same settings as footage.
--> Pass in that MLV file (not .RAW) as <path> to get noise reduction on all passed MLV files.
--> If the file extension is '.darkframe', the file will be used as the preaveraged dark frame.
OPTIONS, INFO:
-e Output MLV settings.
-K Debian Package Deps - Lists dependecies. Works with apt-get on Debian; should be similar elsewhere. -K Debian Package Deps - Lists dependecies. Works with apt-get on Debian; should be similar elsewhere.
--> No operations will be done. --> No operations will be done.
--> Example: sudo apt-get install $ (./convmlv -K) --> Example: sudo apt-get install $ (./convmlv -K)
@ -117,5 +128,8 @@ OPTIONS, DEPENDENCIES:
--> No operations will be done. --> No operations will be done.
--> Example: sudo pip3 install $ (./convmlv -Y) --> Example: sudo pip3 install $ (./convmlv -Y)
-N Manual Deps - Lists manual dependencies, which must be downloaded by hand.
--> There's no automatic way to install these. See the forum post.
``` ```

5
convmlv.sh
View File

@ -93,11 +93,11 @@ cat << EOF
Usage: Usage:
$(echo -e "\033[1m./convmlv.sh\033[0m [OPTIONS] \033[2mmlv_files\033[0m") $(echo -e "\033[1m./convmlv.sh\033[0m [OPTIONS] \033[2mmlv_files\033[0m")
INFO: INFO:
A script allowing you to convert .MLV, .RAW, or a folder with a DNG sequence into a sequence/movie with optional proxies. Images A script allowing you to convert .MLV, .RAW, or a folder with a DNG sequence into a sequence/movie with optional proxies. Images
are auto compressed. Many useful options are exposed, including formats (EXR by default). are auto compressed. Many useful options are exposed, including formats (EXR by default).
$(echo -e "VERSION: ${VERSION}")
DEPENDENCIES: If you don't use a feature, you don't need the dependency, though it's best to download them all. DEPENDENCIES: If you don't use a feature, you don't need the dependency, though it's best to download them all.
-mlv_dump: For DNG extraction from MLV. http://www.magiclantern.fm/forum/index.php?topic=7122.0 -mlv_dump: For DNG extraction from MLV. http://www.magiclantern.fm/forum/index.php?topic=7122.0
@ -110,9 +110,6 @@ DEPENDENCIES: If you don't use a feature, you don't need the dependency, though
-exiftool: Used in mlv2badpixels.sh. -exiftool: Used in mlv2badpixels.sh.
$(echo -e "VERSION: ${VERSION}")
OPTIONS, BASIC: OPTIONS, BASIC:
-v version - Print out version string. -v version - Print out version string.
-o<path> OUTDIR - The path in which files will be placed (no space btwn -o and path). -o<path> OUTDIR - The path in which files will be placed (no space btwn -o and path).