Консольная версия Elecard StreamEye

Консольная версия Elecard StreamEye позволяет выполнять комплексный анализ быстро и легко, используя несколько командных строк.

Возможности консольной версии: 

• Автоматизация и ускоренное выполнение повседневных задач;
• Анализ большого количества видео файлов из списка;
• Выполнение специфичных и сложных задач с помощью нескольких командных строк;
• Сохранение результатов анализа в текстовом формате CSV для более удобного просмотра в Excel;
• Возможность доступа к функциям и ресурсам StreamEye с помощью консоли.

Содержание

• Как использовать StreamEye Command line tool
• Примечания
• Пример конфигурационного файла Config.xml
• Список команд
• Примеры

Как использовать StreamEye Command line tool:

Для автоматического анализа нескольких файлов используются следующие синтаксичские правила. С их помощью настраиваются входные и выходные параметры конфигурационного файла.

Перейдите в командную строку, нажав Start->Run и введите 'cmd'. Для запуска приложения необходимо ввести соответствующую команду и далее продолжать работу с опциями командной строки. В целом, синтаксическая конструкция должна выглядеть следующим образом:

SEyeConsole.exe <config path> <options>

Примечание. Не перемещайте консоль <product> без остальных приложений продукта, которые содержатся в установочном пакете, иначе консольное приложение не запустится.

Примечания

1. Параметры с дефолтным значением не являются обязательными и могут быть опущены;

2. Правила наименования входных и выходных файлов:

• параметр /in:<file path> в командной строке перезаписывает значение тэга <input/> в конфигурационном файле;
• параметр /out:<file prefix> в командной строке перезаписывает значение тэга <output/> в конфигурационном файле;
• если тэг <output/> отсутствует (или не задан), имена выходных файлов формируются на основе имен входных файлов с добавлением суффикса (если последний указан);
• если выходной файл не указан для тэга/секции, имя выходного файла для тэга/секции формируется на основе имени, указанного в тэге <output/> с добавлением суффикса, в зависимости от имени тэга/секции. Например, ".message.csv", ".picture.csv" и т.д.

Назад к содержанию

Пример конфигурационного файла Config.xml:

<?xml version="1.0"?>
<stream version="1">
    <input HEVCDecoder="Elecard(default)/Reference" SkipIncomplete="true(default)/false" file="…"/>
    <output separator=".(default)/," delimiter=";(default)/," file="…"/>
    <reference type="IYUV(default)/[*Upsampler Type]" filter="None(default)/FieldGen/Median/Sobel" offset="0(default)" increment="1(default)" file="…"/>
    <range span="all(default)/start - stop" order="display(default)" indexmode="base/extended(default)"/>
    <userdefs framerate="25(default)" timeperiod="1(default)"/>
    <info>
        <stream distribution="on(default)/off" file="…"/>
        <picture distribution="on(default)/off" file="…">
            <condition … />
        </picture>
        <data type="decoded(default)/predicted/unfiltered/residual/reference/difference" file="…"/>
        <coefficients type="transform/dequantized" file="…"/>
        <message level="all(default)/message/warning/error" file="…"/>
        <header level="struct(default)/parameter" file="…">
            <condition parameter="name" comparison="full/substring(default)">
                <range value="min-max"/>
                <equal value="value"/>
                <less value="min"/>
                <more value="max"/>
                <not value="value"/>
            </condition>
        </header>
        <index distribution="on(default)/off" order="display(default)/stream" file="…"/>
        <metrics type="psnr(default)/[*Metric Type]" source="decoded(default)/predicted/unfiltered/residual/reference/difference" file="…"/>
        <difference type="compare/psnr/psnr clip/subtraction/temperature" source0="decoded(default)/predicted/unfiltered/residual/reference" source1="reference(default)/decoded/predicted/unfiltered/residual" format="IYUV(default)/YV12" file="…"/> 
        <buffer file="…"/>
        <block compact="false(default)/true" disable="block|subblock|prediction|transform" file="…"/>
        <dpb description="on(default)/off" file="…"/>
        <statistics mode="all(default)/stream/picture" type="all(default)/[*Statistic Type]" prediction="all(default)/sizes/mpe" component="all(default)/luma/chroma" by="all(default)/count/area" file="…"/> 
    </info>
</stream>

<stream>
    <input file="…"/>
    <output separator=";(default)/," delimiter=".(default)/," file="…"/>
    <info>
        <stream distribution="on(default)/off" file="…"/>
    </info>
</stream>

Назад к содержанию

Список команд StreamEye:

Назад к содержанию

Примеры

Примеры ниже показывают выполнение некоторых типичных задач из командной строки:

1. Сохранение общей информации о потоке и о каждом кадре;
2. Поиск нужного параметра из основных заголовков потока на примере IDR_W_RADL;
3. Поиск по всем слайсам и вывод слайсов со значением slice_type, равным "2";
4. Сохранение в формате YUV предсказанной картинки;
5. Сохранение информации о закодированных блоках по каждому кадру потока;
6. Вывод основной информации о потоке с подсчетом метрики PSNR для выбранного участка.

1. Сохранение общей информации о потоке и о каждом кадре

config.xml:

<?xml version="1.0"?> 
<stream version="1"> 
      <input file="C:\Media\hevc\test_12_0_sei.h265"/> 
      <output file="C:\Media\hevc\out\"/> 
      <info> 
            <stream/> 
            <picture/> 
      </info> 
      </stream>

Выходные файлы:

test_12_0_sei.stream.csv:

 ...
test_12_0_sei.stream.csv:

Назад к списку примеров

2. Поиск нужного параметра из основных заголовков потока на примере IDR_W_RADL

config.xml:

<?xml version="1.0"?>
<stream version="1"> 
      <input file="C:\Media\hevc\test_12_0_sei.h265"/> 
      <output file="C:\Media\hevc\out\"/> 
      <info> 
            <header level="parameter"> 
                  <condition parameter="IDR_W_RADL" comparison="substring"/>
            </header>  
      </info> 
</stream> 

Выходной файл: 

test_12_0_sei.header.csv:

Назад к списку примеров

3. Поиск по всем слайсам и вывод слайсов со значением slice_type, равным "2"

config.xml: 

<?xml version="1.0"?> 
<stream version="1"> 
      <input file="C:\Media\hevc\test_12_0_sei.h265"/> 
      <output file="C:\Media\hevc\test_12_0_sei"/> 
      <info> 
            <header> 
                  <condition parameter="slice_type">  
                        <equal value="2"/> 
                  </condition> 
            </header> 
      </info> 
</stream>

Выходной файл:

test_12_0_sei.header.csv: 

Назад к списку примеров

4. Сохранение в формате YUV предсказанной картинки

config.xml: 

<?xml version="1.0"?> 
<stream version="1"> 
      <input file="C:\Media\hevc\test_12_0_sei.h265"/> 
      <output file="C:\Media\hevc\out\"/> 
      <info> 
            <data type="predicted"/> 
      </info> 
</stream>

Выходной файл:

test_12_0_sei.data.416x240.yuv

Назад к списку примеров

5. Сохранение информации о закодированных блоках по каждому кадру потока

config.xml: 

<?xml version="1.0"?> 
<stream version="1"> 
      <input file="C:\Media\hevc\test_12_0_sei.h265"/> 
      <output file="C:\Media\hevc\out\"/> 
      <info> 
            <block/> 
      </info> 
</stream>

Выходной файл:

test_12_0_sei.block10.csv  

Назад к списку примеров

6. Вывод основной информации о потоке с подсчетом метрики PSNR для выбранного участка

config.xml: 

<?xml version="1.0"?> 
<stream version="1"> 
      <input file="C:\Media\hevc\test_12_0_sei.h265"/> 
      <output file="C:\Media\hevc\out\"/>
      <reference file="C:\Media\raw\BasketballDrill_832x480_50.yuv"/> 
      <range span="0-10"/> 
      <info> 
            <metrics type="psnr"/>
            <index distribution="off" order="display"/>
      </info> 
</stream>

Выходной файл:

test_12_0_sei.index.csv: 

Назад к списку примеров

Назад к содержанию