Elecard YUV Viewer Command line tool
Elecard YUV Viewer functionality is available in console version, so you can run the tool from the command line.
YUV Viewer Command Line tool allows automatic analysis of video arrays. You can customize a sequence of commands to perform your specific tasks and automate your routine tasks.
Using this tool you'll be able to:
- Analyze the whole array of video files automatically;
- Address specific and complex challenges with a few lines of commands;
- Retrieve submitted results as a text file in CSV format for easy viewing in Excel;
- Customize a sequence of commands to perform your specific tasks;
- Accelerate and automate your regular tasks;
How to use YUV Viewer Command line tool
Get to the command prompt by clicking Start->Run and type 'cmd'. Then enter the command to start the application first and proceed with the command line options. In general, the syntax is as follows:
YUVConsole.exe config.xml /inA:inputA.yuv /inB:inputB.yuv /out:outputNote: you should not relocate the <product> console without all the other applications of the product contained in the installation pack, otherwise the console application will not start.
The command line arguments allow re-defining parameters used in a default configuration file. See examples of the arguments below:
| /inA:<path> | first input file path (inputA file) |
| /inB:<path> | second input file path (inputB file) |
| /out:<path> | output files prefix (output file) |
| /sfx:<string> | suffix of all output files in a configuration file (adds a suffix to an output file before file extension) |
| /dc | use current run directory as default path for files |
| /? | advanced help |
<YUV version="1">
<inputA file="..." type="IYUV(default)/[*Upsampler Type]" filter="None(default)/FieldGen/Median/Sobel" width="auto(default)/..." height="auto(default)/..." bitdepth="8(default)/..." offset="0(default)" step="1(default)"/>
<inputB file="..." type="IYUV(default)/[*Upsampler Type]" offset="0(default)" step="1(default)"/>
<output separator=".(default)/," delimiter=";(default)/," file="..."/>
<range span="all(default)/start - stop"/>
<info>
<metrics type="PSNR(default)|APSNR|SSIM|DELTA|MSAD|MSE|NQI|VIF|VQM|VMAF|VMAF phone" fileType="CSV(default)/JSON" file="..."/>
<difference type="Compare/Subtraction/Temperature/PSNR/PSNR Clip" format="IYUV(default)/YV12" rect_size="16(default/..)" file="..."/>
<data source="A|B" format="IYUV(default)/YV12" file="..."/>
</info>
</YUV>
* Upsampler types that can be used in a configuration file: I444 / I422 / IYUV / NV12 / NV21 / P444 / RGB24 / RGB32 / UYVY (Y422 / UYNV / HDYC) / V210 / V400 / V444 / Y42B / YUY2 (YUNV / V422 / YUYV) / YV12 / YV16 / YVYU.
| <inputA file> | The tag is used to configure the input A file |
| type | Specifies the type of the YUV data to be analyzed. IYUV is set by default/*Upsampler type |
| filter | Selects the preprocessing filter |
| width | Specifies the width of the frame for the file to be analyzed |
| height | Specifies the height of the frame for the file to be analyzed |
| bitdepth | Allows a user to specify values for some metric Types. For several Types, the value is not editable. Available bitdepth types: 8, 9, 10, 11, 12, 13, 14, 15, 16 |
| offset | Shifts the position from the first analyzed frame to the specified one in a stream |
| step | Coefficient used for calculation of a successive frame number for further analysis. “1” is set by default |
| <inputB file> | The tag is used to configure the input B file |
| type | Defines the format of the raw data (IYUV (by default) /* Upsampler type |
| offset | Shifts the position from the first analyzed frame to the specified one in a reference stream |
| step | Coefficient used for calculation of a successive frame number for further analysis. “1” is set by default |
| Note: if the VMAF and VMAF phone metrics are enabled, and if input raw file is missing, encoded reference file should be placed in the input 2(B) field. |
| <output/> | The tag is used to configure the output file |
| separator | Allows selecting a decimal separator, the “.” sign is set by default |
| delimiter | Allows selecting data delimiter “;” sign is set by default |
| file | Sets the output file path |
| <range/> | The tag is used to define the range of analyzed frames |
| span | Defines the range of frames (all (by default) /start - stop), 'start' - number of the first analyzed frame, 'stop' - number of the last analyzed frame |
| <metrics/> | The tag is used to output information on quality metrics |
| type | Specifies the metric type: PSNR (by default) | APSNR | MSE | MSAD | DELTA | SSIM | NQI | VIF | VQM | VMAF | VMAF phone |
| file | Sets the output file path where information on metrics will be saved |
| <difference/> | The tag is used to output information on metrics difference |
| type | Defines the type of difference (compare/subtraction/temperature/psnr/psnr clip). This is the required parameter for this tag. Its default value should be set. If the value is not set, this tag will be skipped |
| format | Defines the format for saving data (IYUV (by default)) |
| rect size | A block size used to calculate metrics PSNR/PSNR Clip |
| file | Sets the output file path where information on difference will be saved |
| <data/> | The tag is used to save output decoder information on any decoding step |
| source | Defines the type of the source for metrics calculation: A | B |
| format | Defines the format for saving data (IYUV (by default)) |
| file | Sets the output file path where the data will be saved |