| Next revision | Previous revision |
| vcs:usage [2010/03/01 13:40] – created Toni Corvera | vcs:docs:usage [2016/04/17 23:28] (current) – ↷ Links adapted because of a move operation Toni Corvera |
|---|
| * Output will be PNG format and named like the input file (extension included) plus ''.png'' (e.g. ''$ vcs "some file.avi"'' will produce //''some file.avi.png''//) | * Output will be PNG format and named like the input file (extension included) plus ''.png'' (e.g. ''$ vcs "some file.avi"'' will produce //''some file.avi.png''//) |
| * ''vcs'' won't //ever// overwrite files (unless a bug slips). If the output file exists it will add a numbered suffix before the extension, so if ''output.png'' exists it will create ''output.avi-1.png'' (or ''output.avi-2.png'', ''output.avi-3.png'' and so on) | * ''vcs'' won't //ever// overwrite files (unless a bug slips). If the output file exists it will add a numbered suffix before the extension, so if ''output.png'' exists it will create ''output.avi-1.png'' (or ''output.avi-2.png'', ''output.avi-3.png'' and so on) |
| * The default colourscheme uses a [[http://www.w3schools.com/tags/ref_color_tryit.asp?color=YellowGreen|YellowGreen]] (<html><span style="background:YellowGreen"> </span></html>) heading and a [[http://www.w3schools.com/tags/ref_color_tryit.asp?color=SlateGray|SlateGray]] (<html><span style="background:SlateGray"> </span></html>) footer | * The default colourscheme uses a RGB(175,205,122) (<html><span style="background:#afcd7a;"> </span></html>) and a [[http://www.w3schools.com/tags/ref_color_tryit.asp?color=SlateGray|SlateGray]] (<html><span style="background:SlateGray"> </span></html>) footer |
| * ''vcs'' 1.11 changes the default heading colour to RGB(175,205,122) (<html><span style="background:#afcd7a;"> </span></html>) | * ''vcs'' below 1.11 used a [[http://www.w3schools.com/tags/ref_color_tryit.asp?color=YellowGreen|YellowGreen]] (<html><span style="background:YellowGreen"> </span></html>) heading |
| * ''vcs'' below 1.0.3a used a [[http://www.w3schools.com/tags/ref_color_tryit.asp?color=SandyBrown|SandyBrown]] (<html><span style="background:SandyBrown"> </span></html>) footer | * ''vcs'' below 1.0.3a used a [[http://www.w3schools.com/tags/ref_color_tryit.asp?color=SandyBrown|SandyBrown]] (<html><span style="background:SandyBrown"> </span></html>) footer |
| |
| The fixed number mode is aesthetically preferable because it can always fill the contact sheets, while the interval mode might leave some empty spaces. | The fixed number mode is aesthetically preferable because it can always fill the contact sheets, while the interval mode might leave some empty spaces. |
| |
| Intervals can be specified in number of ways, see [[vcs:time_syntax|Time/Interval syntax]] for details. To take a capture every minute you could use ''$ vcs -i 1m file.avi''. ''vcs'' will show how many captures will make in total while working, e.g.: | Intervals can be specified in number of ways, see [[vcs:docs:time_syntax|Time/Interval syntax]] for details. To take a capture every minute you could use ''$ vcs -i 1m file.avi''. ''vcs'' will show how many captures will make in total while working, e.g.: |
| |
| <code> | <code> |
| The size of the full contact sheet can't be directly controlled. | The size of the full contact sheet can't be directly controlled. |
| |
| To set the capture height use the ''-H'' (''%%--%%height'') option followed by the height in pixels. | To set the capture height use the ''-H'' (''%%--%%height'') option followed by the height in pixels or a percentage (with a percentage, height will be computed from the source height). |
| |
| To set the aspect ratio use the ''-a'' (''%%--%%aspect'') option followed by the aspect ratio either as a (floating point) number or a fraction (both 1.33 and 4/3 are valid formats). | To set the aspect ratio use the ''-a'' (''%%--%%aspect'') option followed by the aspect ratio either as a (floating point) number or a fraction (both 1.33 and 4/3 are valid formats). |
| Save output of ''file1.avi'' to ''output1.jpg'', output of ''file2.avi'' to ''output2.png'' and output of ''file3.avi'' to ''file3.avi.png'': | Save output of ''file1.avi'' to ''output1.jpg'', output of ''file2.avi'' to ''output2.png'' and output of ''file3.avi'' to ''file3.avi.png'': |
| $ vcs file1.avi file2.avi file3.avi -o output1.jpg -o output2 | $ vcs file1.avi file2.avi file3.avi -o output1.jpg -o output2 |
| | |
| | ===== Adding a title ===== |
| | |
| | A title like can be added through the ''-T'' (''%%--%%title'') option. The title will be displayed in a big font below the meta-information heading. |
| | |
| | ==== Example ==== |
| | |
| | $ vcs -T "Some title" file.avi |
| | |
| | Example contact sheet with title: |
| | \\ |
| | {{:vcs:coral_reef_adventure_1080.wmv-fullsheet.jpg?400|Full contact sheet, including a title}} |
| | |
| | |
| | See also [[vcs:docs:sections]]. |
| |
| ===== Changing colourscheme ===== | ===== Changing colourscheme ===== |
| |
| See [[vcs:colours]] for details. | See [[vcs:docs:colours]] for details. |