Difference between revisions of "UM:Cli Importing Folders"
m (Text replacement - "|Platform:" to "|UM:") |
m (Text replacement - "Platform:" to "UM:") |
||
Line 135: | Line 135: | ||
<td style="width:36px; border: none" valign="top" width="36"><p class="p_DVTableText">[[File:dv_note.png|alt=dv_note]]</p> | <td style="width:36px; border: none" valign="top" width="36"><p class="p_DVTableText">[[File:dv_note.png|alt=dv_note]]</p> | ||
</td> | </td> | ||
− | <td style="width:760px; border: none" valign="middle" width="760"><p class="p_DVTableText"><span class="f_DVTableText">For a list of supported formats and recognised extensions, see [[ | + | <td style="width:760px; border: none" valign="middle" width="760"><p class="p_DVTableText"><span class="f_DVTableText">For a list of supported formats and recognised extensions, see [[UM:Appendix_Format_Support|File Format Support]].</span></p> |
</td> | </td> | ||
</tr> | </tr> |
Latest revision as of 12:11, 15 October 2014
--import-folder <path> |
Import clips found in named folder (and all sub-folders) |
--filter-format <fmt> |
Filter clips we import by file format |
--filter-res <w> <h> |
Filter clips we import by image resolution |
--splice-order <file|timecode> |
Splice clips found to composition in specified order |
--timecode-header [1|2] |
Take timecodes from file headers |
--timecode-filename |
Take timecodes from file names/paths |
--tapename-header |
Take tapenames from file headers |
--tapename-filename <level> |
Take tapenames from file names/paths |
These options control the import of supported image sequences recursively from a specified folder path.
Importing a Folder
--import-folder <start folder path>
This command imports all supported image files found in the specified folder and any sub-folders (recursively).
Command : |
$ film_master --project code2 \ --import-folder Z:\scans\reel4\ INFO Opening project "code2" from ... INFO Batch ... importing directory 0 of 1 (0) INFO Batch ... importing directory 1 of 5 (20) ... INFO Batch Import (completed) ... 6 of 6 (100) |
The command shown above has imported the given folder into the specified project "code2". This is a total of six folders searched, the specified folder itself and five sub-folders :
• | z:\scans\reel4\ |
• | z:\scans\reel4\0008H\ |
• | z:\scans\reel4\0006\ |
• | z:\scans\reel4\0005\ |
• | z:\scans\reel4\0002\ |
• | z:\scans\reel4\0002\high\ |
Filtering
We can filter the sequences the command selects to import on image resolution (e.g. choose only HD sequences) and image format (e.g. choose only TIFF sequences).
Filter on Resolution
--filter-res <width> <height>
This option will select only images that match the given resolution (width x height) in pixels.
Command : |
$ film_master --project code2 \ --import-folder z:\scans\reel4\ \ --filter-res 2048 1556 INFO Opening project "code2" from ... INFO Batch ... importing directory 0 of 1 (0) INFO Batch ... importing directory 1 of 5 (20) ... ... INFO Batch Import (completed) ... 6 of 6 (100) |
Shots that match the resolution specified will be loaded into the project library.
Filter on Image Format
--filter-format <extension>
This option will select only image sequences that match the specified file format, given as the common format extension.
Command : |
$ film_master --project code2 \ --import-folder z:\scans\reel4\ \ --filter-format dpx |
For a list of supported formats and recognised extensions, see File Format Support. |
Tapename
--tapename-header
--tapename-filename <level>
These options override the source of the tapename field we extract when importing each sequence found.
If you do not specify these options, the default settings will be used as set up in your preferences. |
Command : |
$ film_master --project code2 \ --import-folder z:\scans\reel4\ \ --filter-format tif --tapename-filename 1 INFO Opening project "code2" from ... INFO Batch ... importing directory 0 of 1 (0) INFO Batch ... importing directory 1 of 5 (20) ... ... INFO Batch Import (completed) ... 6 of 6 (100) |
Timecode
--timecode-header [1|2]
--timecode-filename
These options override the source of the timecode we extract when importing each sequence found.
Using --timecode-header will attempt to extract the sequence timecode from the file header. If this does not exist (e.g. the format does not support header timecode), then the filename numerics are used to calculate the timecode.
If you do not specify these options, the default settings will be used as set up in your preferences. |
First and Second Timecode
This is a Red R3D file specific option argument.
The --timecode-header option takes an optional argument 1 or 2. This allows us to specify whether to use the first or second timecode from an R3D file. With no argument, we default to 1.
Command : |
$ film_master --project code2 \ --import-folder z:\scans\episode5\ \ --filter-format r3d --timecode-header 2 INFO Opening project "code2" from ... INFO Batch ... importing directory 0 of 1 (0) INFO Batch ... importing directory 1 of 5 (20) ... ... INFO Batch Import (completed) ... 6 of 6 (100) |
Splicing to a Composition
--splice-order <file|timecode>
This option imports the shots found from the folder import and also splices them to a named composition.
A splice order (file or timecode) is required
file
This splices the found shots to the timeline in the order they are found.
timecode
This splices the shots to the timeline in their timecode order.
Command : |
$ film_master --project code2 --composition comp1 \ --import-folder z:\scans\episode5\ \ --filter-format dpx --splice-order timecode INFO Opening project "code2" from ... INFO Opening composition "comp1". |