MVTools

Общая информация

Авторы:Manao, Fizick(Александр Балахнин), Tsp, TSchniede, SEt
Версия: 2
Загрузка: http://avisynth.org.ru/
Категория: плагины разного назначения (Misc Plugins)
Требования: YV12, YUY2 цветовые форматы


Содержание:

I) О MVTools

MVTools плагин для AviSynth 2.5 - это коллекция функций для оценки и компенсации движения объектов в видео клипах. Компенсация движения может быть использована для сильного временного понижения шума, продвинутых преобразований частоты кадров, реставрации изображений и других задач.

Плагин содержит серверную функцию оценки движения MAnalyse (сервер) для нахождения векторов движения и несколько клиентских функций компенсации движения (MCompensate, MMask и других), которые используют эти векторы.

Плагин использует метод сличения блоков (block-matching) для оценки движения (подобные методы используются в MPEG2, MPEG4 и т.д). На стадии анализа плагин разделяет кадры на малые блоки и пробует найти для каждого блока в текущем кадре наиболее подобный (соответствующий) блок во втором кадре (предыдущем или последующем). Относительное смещение этих блоков и есть вектор движения. Основной мерой подобия блоков является сумма абсолютных разностей (SAD) всех пикселов этих двух сравниваемых блоков. SAD это величина, показывающая, насколько хороша оценка движения.

Выходом функции MAnalyse является специальный клип с информацией о векторах движения в некотором формате.

На стадии компенсации клиентские функции плагина читают вектора движения и используют их, чтобы передвинуть блоки и сформировать кадр с компенсированным движением (или реализуют какую-либо другую функцию полной или частичной компенсации или интерполяции). Каждый объект (блок) в этом (полностью) скомпенсированном кадре помещен в ту же позицию, как этот объект в текущем кадре. Таким образом, мы можем (например) использовать сильное временное понижение шума даже для достаточно быстро движущихся объектов без производства раздражающих артефактов и призраков (особенности и края объектов совпадают, если компенсация совершенна). Плагин может создать компенсированные соседние кадры для каждого текущего кадра и снизить его шум с помощью внутренней функции. Альтернативно, вы можете использовать использовать компенсированные кадры, чтобы создать клип с их чередованием, понизить его шум с использованием любого внешнего фильтра, и выбрать для выхода центральные очищенные кадры (смотри примеры).

Конечно, оценка компенсация движения не идеальна и не точна. В некоторых сложных случаях (видео с затуханием, сверх-быстрым движением, периодическими структурами) оценка движения может быть полностью неверна, и компенсированный (особенно интерполированный) кадр будет блочным и (или) уродливым. Трудности также представляют заслонение одного объекта другим или наоборот, открытие. Сложные AviSynth скрипты со многими функциями компенсации движения могут съесть огромное количество памяти и привести к очень медленной обработке. Это не простой, а достаточно сложный плагин. Используйте его только для подходящих случаев, и попытайтесь настроить его параметры. Есть много обсуждений по поводу использования компенсации движения на (англоязычном) форуме doom9 по AviSynth. В частности смотрите старую ветку по MVTools, ветку по true motion, новую ветку по MVTools и несколько других. Попробуйте почитать сообщения как дополнения к данной документации и спрашивайте там поддержку. Если вы действительно заинтересовались вопросами оценки и компенсации движения, вы легко найдете многочисленные научные публикации (используйте WWW поиск).

Замечания. Данный плагин еще в стадии разработки. Текущая версия имеет некоторые ограничения. Поддерживается только прогрессивное видео цветового формата YV12, YUY2. Используйте преобразование цветовых форматов и попробуйте использовать (разумный) BOB-деинтерлейс для чересстрочного видео (может также работать разделение на поля SeparateFields с или без SelectEven/SelectOdd). Некоторые сложные скрипты (MVBOB, MCBOB, TempGaussMC) используют MVTools для деинтерлейса с компенсацией движения.
Альтернативно вы можете попробовать использовать плагин Motion от mg262.

Ia) О MVTools версии 2

MVTools версии 2 является значительным внутренним и внешним обновлением. Главными целями MVTools v2.x являются ясность и стабильность (в частности для многопоточного окружения с многоядерными процессорами), и конечно улучшение производительности и использования памяти.

Основное средство достижения целей - удаление внутреннего буфера MVTools с мистическим (для многих людей) индексом (idx) и некоторых других внутренних трюков (смотри ветку MVTools without idx). Чтобы реализовать это без ухудшения производительности, мы используем нормальный эффективный кадровый кэш Avisynth и вводим новую обязательную подготовительную стадию (перед оценкой движения MAnalyse). На этой стадии новая функция MSuperбудет получать клип-источник и готовить специальный супер клип "super" с многоуровневыми (иерархически масштабированными) данными по кадрам (в предыдущих версиях MVTools 0.X-1.X эти многоуровневые данные готовились, хранились и кэшировались внутренне с idx как индексом псевдоклипа этих "суперкадров"). Суперклип затем используется как функцией MAnalyse, так и клиентскими функциями компенсации движения.

Соответствующие изменения синтаксиса: некоторые параметры (pel, sharp) функции MAnalyseперемещены в функцию MSuper.

Другое существенное внешнее изменение - замена всех именованных клиповых параметров на неименованные (обязательные, без двойных кавычек в описании) для нормальной работы подразумеваемого клипа "last" в Avisynth.

Также в v2.0 введена более быстрая планарная обработка для YUY2.

С версии 2.2 MVTools.dll переименована в MVTools2.dll, и с версии 2.3 все функции переименованы из MVxxx в Mxxx (например из MVAnalyse в MAnalyse), так вы можете продолжать использовать старый MVTools 1.x с вашими старыми скриптами, и Вы способны создавать и использовать новые скрипты с MvTools 2.x без изменения загружаемых dll.

Я также имею намерение удалить (не переносить) некоторые устаревшие функции типа MVDenoise, MVFlowFps2 (пожалуйста, голосуйте).

Полный список изменений смотри в разделе Ревизии.

Вообще говоря, новая MVTools 2.0 должна давать результаты, подобные версии 1.11.4. Улучшения алгоритмов планируется в версии v2.1 и позже.

Примечание: Версия 2 пока имеет альфа (бета?) статус (она должна быть вполне стабильна для обработки, но некоторый синтаксис может поменяться). Приветствуются сообщения о возможных ошибках и предложения (запросы).

Последнее замечание: версии MVTools ветви 1.x больше не разрабатываются и не поддерживаются (Fizick).

II)Описания функций

Общие параметры

Фильтры, использующие вектора движения (MV), имеют ряд общих параметров. Это пороги детектирования сцен и флаги использования mmx/isse. Кроме того, фильтры используют один или несколько потоков векторов.

thSCD1 (int): порог определения, изменился ли блок в текущем кадре относительно предыдущего. Если блок изменился, это значит, что предварительный прогноз движения для него в целом некорректен. Это происходит, например, при смене сцен. То есть это один из порогов, используемых для отладки механизма детектирования смены сцен. Его увеличение уменьшит количество блоков, определяемых как измененные. Это может быть полезно для шумного или мерцающего видео. Порог сравнивается со значением SAD (Sum of Absolute Differences - суммой абсолютных различий, значение погрешности, говорящее о степени несоответствия рассчитанного прогноза движения). Для строго идентичных блоков мы имеем SAD=0. Но реальные блоки всегда отличаются из-за сложного движения объектов (приближение, вращение, деформация), дискретности отсчета пикселов, и шума. Предположим мы имеем два сравниваемых блока 8х8 с каждым из пикселов отличающихся на 5. В этом случае SAD будет 8x8x5 = 320 (блок будет зарегистрирован как неизменившийся при thSCD1=400). Если используются блоки 4x4, величина SAD будет 320/4. Если используются блоки 16x16, величина SAD будет 320/4. На самом деле этот параметр масштабируется внутренне, и Вы должны всегда использовать величину, приведенную к размерам блока 8x8. По умолчанию задано 400 (с версии 1.4.1).

thSCD2 (int): порог, задающий количество блоков, которые должны измениться, чтобы принять решение о смене сцен. Его диапазон 0...255, 0 соответствует 0 %, 255 - 100 %. По умолчанию задано 130 (что соответствует 51 %).

isse (bool): флаг использования ISSE, MMX и других оптимизирующих иннструкций процессора. Установка в false позволяет отключить оптимизацию для отладки. По умолчанию: true (включенв). Если Ваш процессор не поддерживает оптимизацию, она все равно будет отключена (и активировать ее не удастся)

planar (bool): логический флаг использования специального планарного цветового формата для YUY2 клипов как на входе, так и на выходе функций. Это использует специальный трюк для хранения кадров с планарной цветовой организацией данных (отдельные плоскости Y, U, V в памяти) в нормальном чередующемся формате YUY2 кадров как контейнере. Таким способом мы можем избежать многочисленных внутренних преобразований из чередующегося в планарный формат и увеличить скорость. Вы можете преобразовать нормальный чередующийся YUY2 исходный клип в планарный формат функцией Interleaved2planarиз плагина RemoveGrain от kassandro, и преобразовать конечный результат функцией Planar2interleaved. Этот специальный планарный YUY2 также поддерживается плагином Removegrain от Kassandro, плагином MaskTools2 от Manao и некоторыми другими. Данный трюк не будет нужен в Avisynth v2.6 с внутренней поддержкой планарного формата YV16. Данный параметр игнорируется для клипов в формате YV12. Примечание: суперклип всегда планарный. По умолчанию planar=false.

MSuper

MSuper (clip, int "hpad", int "vpad", int "pel", int "levels", bool "chroma", int "sharp", int "rfilter", clip "pelclip", bool "isse", bool "planar")

Получает исходный клип и готовит специальный "super" клип с многоуровневыми (иерархически масштабированными) данными по кадрам. Суперклип используется как функцией MAnalyse, так и клиентскими функциями компенсации движения.
Для хранения и передачи его параметров мы используем аудио свойства суперклипа (а именно, num_audio_samples) в качестве трюка. Аудио в суперклипе убито. Это является одной из причин, почему мы дополнительно используем исходный клип в клиентских функциях. Вы можете посмотреть суперклип сами (он использует обычный формат).

hpad : горизонтальное дополнение (бордюр), добавляемый к исходному кадру (слева и справа). Небольшое дополнение добавляется для более корректной оценки движения вблизи границ кадра. (В MVTools до версии v2.0, всегда внутренне использовалась величина дополнения, равная размеру блока. Теперь это не строго, а рекомендация). По умолчанию 8.

vpad : вертикальное дополнение (бордюр), добавляемый к исходному кадру. По умолчанию 8.

pel : точность прогнозирования движения. 1 означает точность до целого пиксела, 2 - до полу-пиксела, 4 - до четверти пиксела (более точное, но медленнее и не всегда лучше из-за большого шага масштаба между уровнями). По умолчанию: 2 с версии 1.4.10.

levels : число иерархических уровней в кадрах супер клипа. MAnalyse нуждается во всех уровнях, но для других клиентских функций достаточно одного самого тонкого уровня (более грубые не используются). По умолчанию : 0 (авто, создаются все возможные уровни).

chroma : установка в true позволяет готовить и цветовую информацию в суперклипе (false - только яркостную). По умолчанию true.

sharp: метод субпиксельной интерполяции для pel=2,4.
Используйте 0 для мягкой (билинейной) интерполяции, 1 для бикубической (по 4 точкам, Catmull-Rom), 2 для резкой типа Wiener (по 6 точкам, подобно Lanczos).
По умолчанию 2.

rfilter: фильтр сглаживания и сокращения (пополам) иерархических уровней.
0 - простое усреднение 4 пикселов подобно нефильтрованной SimpleResize (старый метод);
1 - треугольный (смещенный) фильтр подобно ReduceBy2 для большего сглаживания;
2 - треугольный фильтр подобно BilinearResize для еще большего сглаживания;
3 - квадратичный фильтр для еще большего сглаживания;
4 - кубический фильтр подобно BicubicResize(b=1,c=0) для еще большего сглаживания.
По умолчанию 2 (с версии 2.3.1). Вы можете также попытаться применить некоторый внешний фильтр к суперклипу или его грубой нижней части (соответствующей вырезкой и наложением).

pelclip: опциональный увеличенный исходный клип для использования вместо внутренней субпиксельной интерполяции (для pel>1).
Пикселы в строках и столбцах кратных pel (0,2,4,... для pel=2) должны быть оригинальными пикселами источника, другие пикселы должны быть интерполированы.
Пример для pel=2: LanczosResize(width*2,height*2,src_left=0.25, src_top=0.25)
(Недавнее замечание: это справедливо для яркостного канала, но не строго соответствует позициям пикселов цветности внутренней интерполяции в MVTools. Тем не менее, вектора и компенсация движения вполне подобны для обычных клипов, Строго та же цветность была бы при src_left=0.5 для YUY2 и дополнительно src_top=0.5 для YV12).
Другой полезный пример - интерполятор EEDI2 с направленностью вдоль краев.
По умолчанию не определен.

MAnalyse

MAnalyse (clip super, int "blksize", int "blksizeV", int "level", int "search", int "searchparam", int "pelsearch", bool "isb", int "lambda", bool "chroma", int "delta", bool "truemotion", int "lsad", int "plevel", bool "global", int "pnew", int "pzero", int "pglobal", int "overlap", int "overlapV", string "outfile", int "dct", int "divide", int "sadx264", int "badSAD", int "badrange", bool "isse", bool "meander", bool "temporal", bool "trymany")

Получает подготовленный многоуровневый суперклип, оценивает движение методом сличения блоков и производит специальный выходной клип с данными по векторам движения (используемый другими функциями).
Реализованы некоторые иерархические многоуровневые методы поиска (от грубого масштаба изображения к тонкому). Функция использует нулевой вектор и векторы соседних блоков как предикторы (начальные приближения) для текущего блока. Сначала оценивается разница (SAD) для предикторов, затем пробный вектор изменяется на некоторую величину в некотором направлении, оценивается SAD, и так далее. Принятый новый вектор для блока - это вектор с минимальной разностью (SAD) (с некоторой поправкой-штрафом для согласованности движения)

super : (неименованный) многоуровневый суперклип, подготовленный функцией MSuper.

blksize: Размер блока (горизонтальный). Возможны только значения 4, 8, 16, 32 (по умолчанию 8). БОльшие блоки менее чувствительны к шумам, и обрабатываются быстрее, но более грубы.

blksizeV : вертикальный размер блока. По умолчанию равен горизонтальному. Дополнительные варианты: 4 для blksize=8, 2 и 8 для blksize=16, 16 для blksize=32.

levels: Положительная величина - это количество уровней, используемых при иерархическом анализе во время нахождения векторов движения.
Отрицательная или нулевая величина - это количество грубых уровней, НЕ используемых при иерархическом анализе во время нахождения векторов движения. Чем оно меньше, тем обычно лучше (находятся вектора любой длины). Переменная оставлена главным образом для учебных (тестовых) целей. Иногда levels полезна для предотвращения очень длинных (ложных) векторов (компьютерной графики и т.п.). По умолчанию = 0 с версии 2.5 (используются все уровни).

search, searchparam, pelsearch : search определяет тип поиска, а searchparam - дополнительный параметр (шаг, радиус) поиска, а pelsearch - этот параметр радиуса для самого тонкого (pel) уровня:

По умолчанию: search=4, searchparam=2, pelsearch=pel.

isb : позволяет выбрать прямое направление поиска (от предыдущего к текущему кадру) для isb=false либо обратное (от последующего к текущему кадру) для isb=true (это реализовано и названо именно таким образом, не переспрашивайте :-). По умолчанию isb =false.

chroma : установка в true позволяет учитывать и цветовую информацию при оценке движения (false - только яркостную). По умолчанию true.

delta : устанавливает кадровый интервал между указанным и текущим кадром. По умолчанию он равен 1, что означает, что вектора движения ищутся между текущим и предыдущим (или следующим) кадром. Установка в 2 позволит искать mvs между кадром n и n-2 или n+2 (в зависимости от значения isb). Если delta отрицательна или ноль, то -delta это абсолютный номер зафикированного опорного кадра. В этом случае, the isb игнорируется. Только некоторые функции совместимы с фиксированным опорным кадром (MCompensate, MFlow, MMask, MShow).

Существуют дополнительные параметры, которые устанавливают согласованность векторов движения для оценки так называемого истинного движения (true motion). Некоторые найденные поиском блоки другого кадра могут быть наиболее подобны образцовым блокам текущего блока по критерию интенсивности (SAD), но не отвечать истинному движению объекта. Например, они могут принадлежать другому подобному объекту в другом углу кадра, или относиться к некоторой периодической структуре. Параметры "истинного движения" (true motion) пытаются поддерживать поле движения согласованным, слаженным, вместо некоторого случайного распределения векторов. Это особенно важно для частичной компенсации и интерполяции движения. Некоторые параметры являются экспериментальными и могут быль удалены (заменены) из последующих версий после тестирования. Пожалуйста, сообщайте ваши заключения.

truemotion это предварительно созданный набор значений этих параметров. Он позволяет легко переключать значения по умолчанию сразу всех параметров "истинного движения". Установите его равным true для поиска истинного движения (высокой согласованности векторов), Установите его равным false для поиска векторов движения с наилучшей SAD. По умолчанию - true c версии v1.4.10. В любом случае вы можете настроить каждый параметр индивидуально.

lambda : устанавливает согласованность (слаженность, coherence) поля векторов. Чем выше, тем больше согласованность. Однако, если задать его слишком высоким, некоторые 'правильные' вектора движения могут быть пропущены. Величины около 400 - 2000 (для размера блока 8х8) настоятельно рекомендуются. Внутренне это коэффициент для штрафа к SAD от квадратичной разности вектора от предиктора (соседей), масштабированный на 256.
По умолчанию 0 для truemotion=false и 1000*blksize*blksizeV/64 для truemotion=true.

lsad: порог SAD для использования lambda. Локальная lambda уменьшается (плавно с версии 1.10.2) если величина SAD предиктора вектора (сформированного из соседей) больше чем порог. Это предотвращает использование плохих предикторов, но снижает согласованность движения. Величины выше 1000 рекомендуются для истинного движения. Величина приводится к блоку 8x8 (с версии 2.0.11).
По умолчанию 400 для truemotion=false и 1200 для truemotion=true.

pnew: относительный штраф (в масштабе 256) к погрешности (SAD) для нового вектора-кандидата. Пробный вектор будет принят как новый вектор, только если его SAD со штрафом (SAD + SAD*pnew/256) будет лучше, чем погрешность (SAD) предиктора. Величины около 50-100 (для размера блока 8х8) рекомендуются для истинного движения. Это предотвращает замену вполне хороших предикторов на новый вектор с немного лучшей SAD, но другой длиной и направлением.
По умолчанию 0 для truemotion=false и 50 для truemotion=true.

plevel: режим масштабирования штрафного коэффициента lambda от уровня. Величина =0 - без масштабирования, 1 - линейная, 2 - квадратичная зависимость от размера иерархического уровня. Заметьте, что длина вектора меньше на более низком уровне.
По умолчанию 0 для truemotion=false и 1 для truemotion=true.

global: оценить глобальное движение (на каждом уровне) и использовать его как дополнительный предиктор. Оценивается только панорамное смещение (ни зум, ни вращение). Величина = false означает отменить, true - разрешить. По умолчанию false для truemotion=false и true для truemotion=true.

pzero: относительный штраф (в масштабе 256) к погрешности (SAD) для нулевого вектора. Это предотвращает замену вполне хороших предикторов на нулевой вектор с немного лучшей SAD (lambda не используется для нулевого вектора). По умолчанию равен pnew с версии 1.11.

pglobal: относительный штраф (в масштабе 256) к погрешности (SAD) для глобального предиктора. (lambda не используется для глобального вектора). По умолчанию равен 0.

overlap: величина перекрытия блоков (горизонтальная). Должна быть четной и меньше размера блока (до blksize/2 для MCompensate). Шаг между блоками для оценки движения равен (blksize-overlap). N блоков покрывают размер ((blksize-overlap)*N + overlap) на кадре. Попробуйте значения перекрытия от blksize/4 до blksize/2. Чем больше перекрытие, тем больше число блоков, и меньше скорость обработки. Величина по умолчанию 0.
Функции, поддерживающие режим перекрытия: MFlow, MFlowInter, MFlowFps, MShow, MMask, MCompensate, MDeGrain1, MDeGrain2, MDeGrain3.

overlapV: вертикальная величина перекрытия блоков. По умолчанию равна горизонтальной. Должна быть четной для YV12 и меньше размера блока.

outfile: имя файла для вывода данных по векторам движения. Эти данные могут быть использованы некоторыми внешними программами или может быть следующими версиями MVTools для кодирования второго прохода и т.п.
Производимый двоичный файл имеет заголовок (структура MVAnalysisData, смотри исходный код MVInterface.h), и последовательность данных:
номер кадра, данные вектора (Vx, Vy, SAD) каждого блока, номер следующего пригодного кадра, данные векторов этого кадра, и т.д.
По умолчанию - пустая строка, не записывать файл.

dct: использование DCT (частотный спектр) блоков для расчета отличия блоков (SAD). Это может в том числе улучшить оценку векторов движения при мерцаниях и затуханиях яркости.
0 - обычные пространственные блоки, не использовать DCT;
1 - использовать DCT блоков вместо пространственной информации (медленно для 8x8, и очень медленно для других размеров);
2 - смешанный режим с весами пространственной и DCT информации, зависящими от разности средней яркости кадров;
3 - адаптивное поблочное переключение от пространственного к равно смешанному (экспериментальный, чуть быстрее).
4 - адаптивное поблочное переключение от пространственного к смешанному с большим весом DCT (экспериментальный, чуть быстрее).
добавленные в 1.9.5.3 режимы: (требуют sadx264 0-7, используют быструю SATD функцию, только яркость!)
5 - SATD вместо SAD для яркости
6 - аналогично 2, но используя SATD
7 - аналогично 3, но используя SATD
8 - аналогично 4, но используя SATD
9 - подобно 2, используя SATD и вес диапазон от только SAD до равных SAD и SATD
10 - подобно 3/4, использовать SATD вес на SAD, только на сильных изменения яркости
По умолчанию = 0.

divide: пост-обработка векторов движения путем деления каждого блока на 4 одинаковых меньших подблока.
0 - не делить;
1 - делить блоки и присвоить оригинальный вектор всем 4 подблокам;
2 - делить блоки и присвоить подблокам медианные (с 2 соседними) вектора;
По умолчанию = 0. Размеры блоков и перекрытия должны быть выбраны подходящими после внутреннего деления.

sadx264: использовать SAD функции из кодека x264 если они доступны для данного размера блока
0 - (по умолчанию) автоматически детектировать процессор и выбрать оптимальный алгоритм SAD.
1 - использовать MMX 16x16, 16x8, 8x8, 8x4, 4x4 (8x16, 4x8 используются только для цветности)
2 - использовать MMX 16x16, 16x8, 8x8, 8x4 (8x16, используются только для цветности) с выравниванием блоков до 32 байт
3 - использовать MMX 16x16, 16x8, 8x8, 8x4 (8x16, только цветность) с выравниванием блоков до 64 байт, лучший для Pentium M
4 - использовать SSE2 16x16, 16x8 (без специального выравнивания)
5 - использовать SSE2 16x16, 16x8, выравнивание блоков до 64 байт (хорошо для Core)
6 - использовать SSE3 16x16, 16x8 (кажется работает быстрее только на Pentium 4E или Core1)
7 - использовать SSSES3 16x16, 16x8, выровненные до 64 байта блоки (хорошо на Core2)
Режимы 8-12 предназначены для отладки - используйте dct >4 вместо них.
Использование sadx264 > 7 означает: использовать выбранный вместо SAD для любой яркостной/цветностной SAD, где возможно!
for SAD / SATD mix and luma only use dct
8 - использовать SSD mmx, работает аналогично 1
9 - использовать SATD mmx, работает аналогично 1
10 - использовать SATD SSE2, работает аналогично 2
11 - использовать SATD SSSE3, работает аналогично 2
12 - использовать SATD SSSE3 с PHADD для 8xY, работает аналогично 2
По умолчанию 0, используйте -1 или >=13, чтобы использовать старый v1.9.4 код вместо функций SAD из x264

badSAD: порог SAD для более широкого повторного поиска для плохих блоков. Величина приводится к блоку 8х8. По умолчанию 10000 (отключающая величина), рекомендованные значения около 1000-2000.

badrange: диапазон (радиус) широкого поиска для плохих блоков. По умолчанию 24 (в единицах пикселов изображения). Используйте положительные величины для поиска UMH и негативные величины для Исчерпывающего поиска.

meander: Менять ли направление просмотра рядов блоков попеременно слева направо и справа налево. По умолчанию True с версии 2.5.1.

temporal: использовать ли временной предиктор из векторов движения предыдущего кадра. По умолчанию False. (несовместим с SetMTmode)

trymany: попробовать начать поиски вокруг нескольких предикторов (кроме самого токого уровня). По умолчанию false.

Попробуйте использовать функцию MShowдля контроля оцененного поля движения и настройки параметров.

Замечание: MAnalyse (если Pel=2) учитывает признак разделенного на поля видео (после SeparateFields) и автоматически производит коррекцию векторов с учетом вертикального смещения полей разной четности. Попробуйте использовать AssumeFrameBased, если вам это не нужно.

MCompensate

MCompensate (clip source, clip super, clip vectors, bool "scbehavior", float "recursion", int "thSAD", bool "fields", float "time", int "thSCD1", int "thSCD2", bool "isse", bool "planar")

Выполняет полную компенсацию движения кадра. Это означает, что блоки указываемые векторами движения в предыдущем кадре (или последующем, в зависимости от установок MAnalyse) будут двигаться вдоль векторов с целью достичь своих мест в текущем кадре.

source : (неименованный) исходный клип, обычно last.

super : (неименованный) многоуровневый суперклип, подготовленный функцией MSuper.

vectors (неименованный) клип с векторами движения, произведенный функцией MAnalyse.

scbehavior (по умолчанию true), определяет, какой кадр будет сохранен при смене сцен. Если true, кадр оставляется неизменным. Иначе указанный кадр копируется в текущий. Аналогично для дополнения на правом и нижнем краях.

recursion - это процентный вес ранее компенсированных кадров в новую компенсацию в специальном рекурсивном режиме. Остальной вес берется (однородно) из заданного опорного кадра (используемого в обычном режиме). Recursion=100 - это полная рекурсия, подобно кольцевому режиму mode=2 старых версий MVTools v0.9.x. Не используйте рекурсивный режим, если вы не знаете, что вы делаете. По умолчанию recursion=0.

thSAD - это порог SAD для безопасной (фиктивной) компенсации. Если SAD блока выше чем thSAD, то плок плохой, и мы используем блок из источника source вместо компенсированного блока. По умолчанию 10000 (практически отменена).

fields: если true и pel=2 или 4, добавляет соответствующий вертикальный сдвиг (на полпиксела) полей основанного на полях видео. Попробуйте использовать это для деинтерлейса (не для понижения шума)
По умолчанию false.

time: процент компенсации движения (по умолчанию =100.0, полная компенсация), определяет момент времени между опорным и текущим кадром.

Обработка перекрывающихся блоков реализована как оконное суммирование блоков (аналогично FFT3DFilter, величина overlap до blksize/2) для снижения артефактов блочности.

MMask

MMask (clip source, clip vectors, int "ml", float "gamma", int "kind", int "Ysc", float "time", int "thSCD1", int "thSCD2", bool "isse", bool "planar")

Создает клип масок из исходного клипа на основе данных векторов движения vectors. Маска определяется данными по блокам, но интерполируется до полного размера кадра. Маска создается как в яркостном канале, так и в плоскостях цветности. Величины в маске могут быть от 0 (мин) до 255 (макс).

Параметр kind определяет разновидность маски.

Режим kind=0 создает маску движения исходя из длины векторов движения. Функция строит маску лучше, чем функция MotionMaskплагина MaskTools, так как вектора движения намного более достоверны, чем алгоритм в MotionMask. Значение маски 0 означает отсутствие движения вообще (длина вектора нулевая). Чем больше длина вектора, тем больше величина маски (насыщается до 255), масштаб определяется параметром ml.

kind=1 позволяет построить маску из величин SAD (суммы абсолютных разностей) вместо длин векторов. Это может быть полезно, чтобы выявить проблемные области с плохой оценкой движения. (Используется внутренний коэффициент blocksize*blocksize/4 для нормализации масштаба ml.)

kind=2 позволяет построить маску окклюзий (разрывности, заграждения, occlusion) (плохих блоков из-за разрыва, растяжения). В настоящей версии используется некоторая нормализованная сумма положительных разностей движения блоков. Она может масштабироваться ml.

kind=3 позволяет построить маску из величин горизонтальной составляющей векторов движения в единицах pel плюс 128. Может быть использован масштабный коэффициент ml.

kind=4 позволяет построить маску из величин вертикальной составляющей векторов движения в единицах pel плюс 128. Может быть использован масштабный коэффициент ml.

kind=5 - цветная карта движения как x,y компоненты векторов, показанные на цветовых плоскостях U, V (в единицах pel, плюс 128. Может быть использован масштабный коэффициент ml).

gamma используется для определения показателя степени зависимости выхода от входа. gamma = 1.0 подразумевает линейную зависимость, а gamma = 2.0 дает квадратичную.

Ysc есть величина, принимаемая маской при смене сцены.

time: процент компенсации движения (по умолчанию =100.0, полная компенсация), определяет момент времени между опорным и текущим кадром.

По умолчанию: kind=0, ml = 100, gamma = 1.0, и Ysc = 0.

MSCDetection

MSCDetection (clip source, clip vectors, int "Ysc", int "thSCD1", int "thSCD2", bool "isse")

Создает клип маски смены сцены на основе данных векторов движения vectors. Маска создается для каналов яркости и цветоразности. Выход без смены сцены равен 0.

Ysc - это величина, принимаемая маской при смене сцены, по умолчанию 255.

MShow

MShow (clip super, clip vectors, int "scale", int "sil", int "tol", bool "showsad", int "number", int "thSCD1", int "thSCD2", bool "isse", bool "planar")

Показывает вектора движения vectors на дополненном бордюрами клипе, загружая суперклип (с версии 2.0.11).
Параметр scale позволяет увеличить вектора движения, например для увеличения точности (когда pel > 1 и scale = 1, невозможно увидеть изменения менее чем на 1 пиксель).
sil позволяет увидеть различные уровни анализа (когда для поиска векторов движения задан иерархический анализ и интересно увидеть что произойдет при более высоких уровнях).
tol - порог допуска (толерантности). Если искажения, вызванные вектором движения больше tol, то вектор не показывается.
Наконец, showsad позволяет показать среднее (приведенное к блоку 8х8) значение SAD картинки после компенсации и количество (ThSCD2) плохих (ThSCD1) блоков.

number позволяет пометить заданный блок (с данным номером) как белый. По умолчанию =-1.

По умолчанию: scale = 1, sil = 0, tol = 20000 и showsad = false (что обеспечивает показ всех векторов).

MDepan

MDepan (clip, clip vectors, clip "mask", bool "zoom", bool "rot", float "pixaspect", float "error", bool "info", string "log", float "wrong", float "zerow", int "range", int "thSCD1", int "thSCD2", bool "isse", bool planar)

Получает вектора движения vectors, оценивает глобальное движение и помещает данные в выходной кадр в специальном формате для плагина DePan (от Fizick).

Меж-кадровое глобальное движение (панорамирование, зум, вращение) оценивается итерационной процедурой, с использованием только хороших блоков.

Отвергаемые блоки: 1) вблизи границ кадра или по маске; 2) с большим SAD (по параметру thSCD1); 3) с движением, отличающимся от соседей и глобального.

mask клип (если задан) используется для задания весов векторов блоков равными соответствующим значениям пикселов кадра маски в центре блока (используйте полностью черный, чтобы отвергнуть блок). Если клип маски не задан, то отвергаются 4 блока у каждой границы (старый до v2.4.3 алгоритм.)

Параметры zoom и rot включают оценку зума и вращения, pixaspect это аспект пиксела (1.094 для стандартного PAL, 0.911 для стандартного NTSC), error это максимум отличия от среднего движения.

Оцениваемое глобальное движение кадра выключается в нулевое для больших ошибок движения error или на смене сцены (по параметрам thSCD1, thSCD2).

Параметр info позволяет вывести информацию по глобальному движению для отладки.

Параметр log позволяет задать имя лог-файла для вывода значений в формате DeShaker, DePan.

wrong определяет предел для отброса блоков очень отличных от соседей.

zerow определяет вес нулевых векторов движения (для уменьшения их влияния).

range - число предыдущих (и также последующих) кадров (полей) соседних с запрошенным кадром, для которых оценивается движение.

Значения по умолчанию: zoom = true, rot = true, pixaspect = 1.0, error = 15.0, info = false, wrong=10, zerow=0.05, range=0.

Для оценки глобального движения чересстрочного видео, вы должны разделить поля (как для MAnalyse, так и MDepan).

MFlow

MFlow (clip source, clip super, clip vectors, float "time", int "mode", bool "fields", int "thSCD1", int "thSCD2", bool "isse", bool "planar")

Делает компенсацию движения кадра не по блокам (как MCompensate), а по пикселам. (Flow - течение). Вектор движения каждого пиксела вычисляется путем билинейной интерполяции векторов движения текущего и соседних блоков (в соответствии с положением пиксела). Это означает, что пикселы, указываемые вектором в опорном кадре будут двигаться (течь) вдоль вектора, чтобы достичь их мест в текущем кадре. Данный метод компенсации движения течением не производит блочных артефактов, и хорош для понижения шума, но иногда может создать очень странные деформированные картины :). Оценка истинного движения настоятельно рекомендуется для этой функции. Компенсация движения может быть полной или частичной (в промежуточное время).

source : (неименованный) исходный клип, обычно last.

super : (неименованный) многоуровневый суперклип, подготовленный функцией MSuper.

vectors (неименованный) клип с векторами движения, произведенный функцией MAnalyse.

time: процент компенсации движения (по умолчанию=100.0, полная компенсация), определяет временной момент между опорным и текущим кадром.

mode: режим может быть или 0 (по умолчанию), или 1.
mode=0 - поднести пикселы к каждому месту целевого кадра. Это основной рабочий режим.
mode=1 - сдвинуть пикселы от каждого места источника (опорного). Это отладочный (учебный) режим с некоторыми пустыми местами (с нулевой интенсивностью). Он может быть использован для генерации маски окклюзий.

fields: если true и pel =2 или 4, добавляет соответствующий вертикальный сдвиг (на полпиксела) полей основанного на полях видео. Попробуйте использовать это для деинтерлейса (не для понижения шума)
По умолчанию false.

MFlowInter

MFlowInter (clip source, clip super, clip mvbw, clip mvfw, float "time", float "mL", bool "blend", int "thSCD1", int "thSCD2", bool "isse", bool "planar")

Функция интерполяции движения. Это не то же самое (но подобное) функции MVInterpolate более старых версий MVTools. Она использует обратные "mvbw" и прямые "mvfw" вектора движения, чтобы создать изображение в некоторый промежуточный момент времени между текущим и следующим (на delta) кадром. Она использует по-пиксельную компенсацию движения (методом MFlow) из обоих кадров. Используются внутренние прямая и обратная маски окклюзий - разрывности (методом MMask kind=2) и временные взвешивающие факторы, чтобы произвести выходное изображение с минимальными артефактами. Оценка истинного движения настоятельно рекомендуется для этой функции.

source : (неименованный) исходный клип, обычно last.

super : (неименованный) многоуровневый суперклип, подготовленный функцией MSuper.

mvbw, mvfw (неименованные) клипы с обратными и прямыми векторами движения, произведенный функцией MAnalyse.

time: положение интерполяционного момента времени между кадрами (в процентах, по умолчанию=50.0, посредине)

ml: масштабный параметр маски. Меньшие величины соответствуют более сильной маске окклюзий (как в функции MMask, используйте ее для настройки и отладки). По умолчанию=100.

pelclip: увеличенный исходный клип для использования вместо внутренней субпиксельной интерполяции (для pel=2) (как в MAnalyse).
По умолчанию не определен.

blend: если True, то смешивать кадры на сменах сцен подобно ConvertFps, а если False, то повторять последний кадр подобно ChangeFps. По умолчанию = True.

MFlowFps

MFlowFps (clip source, clip super, clip mvbw, clip mvfw, int "num", int "den", int "mask", float "ml", bool "blend", int "thSCD1", int "thSCD2", bool "isse", bool "planar")

Будет изменять частоту кадров (fps) клипа (и число кадров). Функция может быть использована для преобразования частоты, эффектов замедления движения и т.п. Она использует обратные "mvbw" и прямые "mvfw" вектора движения чтобы создать интерполированные изображения в некоторые промежуточные моменты времени между кадрами. Функция использует по-пиксельный метод компенсации движения (как MFlow, MFlowInter). Используются внутренние прямая и обратная маски окклюзий - разрывности (методом MMask kind=2) и временные взвешивающие факторы, чтобы произвести выходное изображение с минимальными артефактами. Оценка истинного движения настоятельно рекомендуется для этой функции.

source : (неименованный) исходный клип, обычно last.

super : (неименованный) многоуровневый суперклип, подготовленный функцией MSuper.

mvbw, mvfw (неименованные) клипы с обратными и прямыми векторами движения, произведенный функцией MAnalyse.

num: fps числитель выходной частоты кадров. По умолчанию = 25.

den: fps знаменатель (по умолчанию = 1). Результирующая частота кадров fps = num/den. В частности для удвоенной NTSC fps=2*29.97 используйте num=60000, den=1001, а для удвоенной NTSC FILM fps=2*23.976 используйте num=48000, den=1001. Причем если num или den равны нулю, подразумевается удвоенная частота входного клипа (с версии 1.8).

mask: режим обработки:
mask=0 для простых прямой и обратной масок разрывности (использовался в версиях до 1.4.x, самый быстрый);
mask=1 для подобных масок с дополнительным переходом к статическим нулевым векторам в областях разрывности (подобный v1.5.x);
mask=2 для использования дополнительных векторов из смежных кадров для снижения ореолов движущихся объектов в областях разрывности (v1.8, медленный). По умолчанию =2.

ml: масштабный параметр маски. Большие величины соответствуют более слабой маске разрывности (как в функции MMask, используйте ее для настройки и отладки). По умолчанию=100.

blend: если True, то смешивать кадры на сменах сцен подобно ConvertFps, а если False, то или повторять последний кадр подобно ChangeFps. По умолчанию = True.

MBlockFps

MBlockFps (clip, clip super, clip mvbw, clip mvfw, int "num", int "den", int "mode", float "ml", bool "blend", int "thSCD1", int "thSCD2", bool "isse", bool "planar")

Данная функция использует основанную на блоках частичную компенсацию блоков для изменения частоты кадров (fps) клипа (и число кадров). Она использует обратные "mvbw" и прямые "mvfw" вектора движения чтобы создать интерполированные изображения в некоторые промежуточные моменты времени между кадрами. Некоторые внутренние прямые и обратные маски и временные взвешивающие факторы используются для производства выходного изображения. (алгоритм основан на функции MVInter старой версии MVTools 1.9.12.) Это обычно быстрее, чем MFlowFps, но может дать блочность и другие артефакты. Оценка истинного движения настоятельно рекомендуется для этой функции. Некоторые пикселы справа и внизу, не полностью покрытые блоками, будут произведены путем смешения кадров.

source : (неименованный) исходный клип, обычно last.

super : (неименованный) многоуровневый суперклип, подготовленный функцией MSuper.

mvbw, mvfw (неименованные) клипы с обратными и прямыми векторами движения, произведенный функцией MAnalyse.

num: fps числитель выходной частоты кадров. По умолчанию = 25.

den: fps знаменатель (по умолчанию = 1). Результирующая частота кадров fps = num/den. В частности для удвоенной NTSC fps=2*29.97 используйте num=60000, den=1001, а для удвоенной NTSC FILM fps=2*23.976 используйте num=48000, den=1001. Причем если num или den равны нулю, подразумевается удвоенная частота входного клипа.

mode: режим обработки:
0 - среднее от приведенных прямой и обратной частичных компенсаций движения (быстрый, по умолчанию).
1 - статическая медиана.
2 - динамическая медиана.
3 - взвешенная по времени комбинация принесенных прямых блоков, маскированных смещенными обратными, и принесенных обратных, маскированных смещенными прямыми.
4 - режим 3, смешанный с простым статическим усреднением по маске разрывности смещенных блоков.
5 - маска разрывности (для отладки).
6-8 - режимы подобные 3-5 но вместо маски пазрывности испольуется маска абсолютных разностей SAD.

ml: масштабный параметр маски. Большие величины соответствуют более слабой маске разрывности (как в функции MMask, используйте ее для настройки и отладки). По умолчанию=100.

blend: если True, то смешивать кадры на сменах сцен подобно ConvertFps, а если False, то повторять последний кадр подобно ChangeFps. По умолчанию = True.

MFlowBlur

MFlowBlur (clip, clip super, clip mvbw, clip mvfw, float "blur", int "prec", int "thSCD1", int "thSCD2", bool "isse", bool "planar")

Экспериментальная простая функция размытия движения (motion blur). Она может быть использована для создания эффекта Фильма (чтобы имитировать конечное время открытия затвора кинокамеры). Она использует обратные "mvbw" и прямые "mvfw" вектора движения для создания и наложения многих копий частично компенсированных пикселов в промежуточные моменты времени в некотором интервале размытия вокруг текущего кадра. Используется по-пиксельная компенсация (метод MFlow). Оценка истинного движения настоятельно рекомендуется для этой функции.

source : (неименованный) исходный клип, обычно last.

super : (неименованный) многоуровневый суперклип, подготовленный функцией MSuper.

mvbw, mvfw (неименованные) клипы с обратными и прямыми векторами движения, произведенный функцией MAnalyse.

blur: временной интервал размытия между кадрами, время открытия затвора (в процентах, по умолчанию=50.0)

prec: точность размытия в единицах пикселов. Максимальный шаг между компенсированными размытыми пикселами. По умолчанию =1 (наиболее точно).

pelclip: увеличенный исходный клип для использования вместо внутренней субпиксельной интерполяции (для pel=2) (как в MAnalyse).
По умолчанию не определен.

MDeGrain1, MDeGrain2 и MDeGrain3

MDeGrain1 (clip, clip super, clip mvbw, clip mvfw, int "thSAD", int "thSADC", int "plane", int "limit", int "thSCD1", int "thSCD2", bool "isse", bool "planar")

MDeGrain2 (clip, clip super, clip mvbw, clip mvfw, clip mvbw2, clip mvfw2, int "thSAD", int "thSADC", int "plane", int "limit", int "thSCD1", int "thSCD2", bool "isse", bool "planar")

MDeGrain3 (clip, clip super, clip mvbw, clip mvfw, clip mvbw2, clip mvfw2, clip mvbw3, clip mvfw3,int "thSAD", int "thSADC", int "plane", int "limit", int "limitC", int "thSCD1", int "thSCD2", bool "isse", bool "planar")

Производит динамическое понижение шума с компенсацией движения. Блоки опорных предыдущих и последующих кадров компенсируются и затем усредняются с текущим кадром с весовыми факторами зависящими от разницы блоков от текущего (SAD). Функции поддерживают режим перекрытия блоков (overlap). Обработка перекрывающихся блоков реализована как оконное суммирование блоков (аналогично FFT3DFilter, величина overlap до blksize/2) для снижения артефактов блочности.

MDeGrain1 имеет временной радиус 1 (использует вектора предыдущего mvfw и последующего mvbw кадров).
MDeGrain2 имеет временной радиус 2 (использует вектора двух предыдущих mvfw2, mvfw и двух последующих mvbw, mvbw2 кадров).
MDeGrain3 имеет временной радиус 3 (использует вектора трех предыдущих mvfw3, mvfw2, mvfw и трех последующих mvbw, mvbw2, mvbw3 кадров). Он медленнее, но дает чуть лучшие результаты (более сильное подавление шума).

source : (неименованный) исходный клип, обычно last.

super : (неименованный) многоуровневый суперклип, подготовленный функцией MSuper.

mvbw, mvfw (неименованные) клипы с обратными и прямыми векторами движения, произведенный функцией MAnalyse.

Параметр "thSAD" определяет мягкий порог суммы абсолютных разностей блоков (SAD), выше которого блоки не дают вклад при усреднении. Блоки с малым SAD имеют наибольший вес. Вы должны ввести величину thSAD приведенную к блоку 8x8. Малые величины могут привести к шахматному понижению шума, большие величины могу привести к призракам и артефактам.
По умолчанию : thSAD=400.

"thSADC" есть аналогичный порог для каналов цветности.
По умолчанию, если не определен, то одинаковые для яркости и цветности thSADC=thSAD. Если определен, то thSADC используется для цветности, а thSADдля яркости.

Параметр plane устанавливает обрабатываемые цветовые плоскости:
0 - яркость, 1 - цветность U, 2 - цветность V, 3 - обе цветности, 4 - все. По умолчанию 4.

limit: предел изменения яркости пиксела (пост-обработка подобно плагину DeGrainMedian и функции LimitChange плагина SSETools, для предотвращения некоторых артефактов). По умолчанию 255 (нет предела).

limitC: предел изменения цветности пиксела. По умолчанию = limit.

MRecalculate

MRecalculate (clip super, clip vectors, int "thSAD", int "smooth", int "blksize", int "blksizeV", int "search", int "searchparam", int "lambda", bool "chroma", bool "truemotion", int "pnew", int "overlap", int "overlapV", string "outfile", int "dct", int "divide", int "sadx264", bool "isse")

Уточняет ранее оцененные (MAnalyse) вектора движения vectors (и остальные данные) для другого клипа super или для новых параметров (например меньших размеров блоков), после деления divide, и т.п. Этот двух-стадийный метод может также быть полезным для более стабильной (устойчивой) оценки движения. Уточнение производится только на самом тонком уровне. Интерполированные вектора старых блоков используются как начальные приближения для новых векторов, с пересчетом SAD. Новые векторы только плохого качества, с SAD выше порога "thSAD", будут уточняться поиском. Вы должны ввести величину thSAD, приведенную (масштабированную) к размерам блока 8x8. По умолчанию thSAD=200.

smooth - задает метод деления грубых облоков на меньшие. 0 - использовать вектор движения ближайшего блока, 1 - билинейная интерполяция 4 соседних. По умолчанию 1.

Другие параметры - те же, что в MAnalyse (но вы можете изменить значения параметров). Значения по умолчанию - те же, что значения по умолчанию MAnalyse.

III) Примеры

Показать вектора движения (вперед) :

AVISource("c:\test.avi") # или MPEG2Source, DirectShowSource, некоторый предыдущий фильтр
vectors = MSuper().MAnalyse(isb = false)
MShow(vectors)

Показать аналогичное назад:

AVISource("c:\test.avi") # или MPEG2Source, DirectShowSource, некоторый предыдущий фильтр
vectors = MSuper().MAnalyse(isb = true)
MShow(vectors)

Использование MMask :

AVISource("c:\test.avi") # или MPEG2Source, DirectShowSource, некоторый предыдущий фильтр
vectors = MSuper().MAnalyse(isb = false)
MMask(vectors)

Чтобы использовать MDepan с плагином Depan для чересстрочного видео (пример функции DepanStabilize):

AVISource("c:\test.avi") # или MPEG2Source, DirectShowSource, некоторый предыдущий фильтр
AssumeTFF().SeparateFields() # установи корректный порядок полей
vectors = MSuper().MAnalyse(isb = false)
globalmotion = MDepan(vectors, pixaspect=1.094, thSCD1=400)
DepanStabilize(data=globalmotion, cutoff=2.0, mirror=15, pixaspect=1.094)
Weave()

Чтобы сгладить проблемные (блочные) области компенсированного кадра с маской заграждения:

AVISource("c:\test.avi") # или MPEG2Source, DirectShowSource, некоторый предыдущий фильтр
super = MSuper()
vectors = MAnalyse(super, isb = false, lambda = 1000)
compensation = MCompensate(super, vectors) # или используйте MFlow функцию здесь
# приготовим размытый кадр с некоторой сильной функцией блюра или deblock:
blurred = compensation.DeBlock(quant=51) # используем функцию DeBlock
badmask = MMask(vectors, kind = 2, ml=50)
overlay(compensation,blurred,mask=badmask) # или используйте более быструю MaskedMerge

Чтобы восстановить испорченные кадры интерполяцией c MFlowInter:

AVISource("c:\test.avi") # или MPEG2Source, DirectShowSource, некоторый предыдущий фильтр
super = MSuper()
backward_vectors = super.MAnalyse(isb = true, delta=2)
forward_vectors = super.MAnalyse(isb = false, delta=2)
inter = MFlowInter(super, backward_vectors, forward_vectors, time=50, ml=70)
# Предположим плохие кадры 50 и 60
trim(0,49) ++ inter.trim(49,-1) \
 ++ trim(51,59) ++ inter.trim(59,-1) ++ trim(61,0)

Чтобы изменить частоту кадров с MFlowFps:

AVISource("c:\test.avi") # или MPEG2Source, DirectShowSource, некоторый предыдущий фильтр
# предполагаем прогрессивный PAL 25 fps источник
super = MSuper(pel=2)
backward_vec = MAnalyse(super,isb = true)
forward_vec = MAnalyse(super, isb = false)
MFlowFps(super, backward_vec, forward_vec, num=50, den=1, ml=100) # получили 50

Чтобы удвоить частоту видео кадров с MFlowFps для самой быстрого проигрывания (почти) в реальном времени:

AVISource("c:\test.avi") # или MPEG2Source, DirectShowSource, некоторый предыдущий фильтр
# предполагаем прогрессивный PAL 25 fps или NTSC фильм 23.976 источник
super = MSuper(pel=1,hpad=0,vpad=0,chroma=false)
backward_vec = MAnalyse(super, blksize=32, isb = true, chroma=false, searchparam=1,search=0)
forward_vec = MAnalyse(super, blksize=32, isb = false, chroma=false, searchparam=1,search=0)
MFlowFps(super, backward_vec, forward_vec, num=2*FramerateNumerator(last), \
   den=FramerateDenominator(last), mask=0)

Чтобы удвоить частоту видео кадров с MFlowFps для 'наилучших' результатов (но медленной обработки):

AVISource("c:\test.avi") # или MPEG2Source, DirectShowSource, некоторый предыдущий фильтр
# предполагаем прогрессивный PAL 25 fps или NTSC фильм 23.976 источник
super = MSuper(pel=2)
backward_vec = MAnalyse(super, overlap=4, isb = true, search=3)
# используем перекрытие блоков, полупиксельную точность и исчерпывающий поиск
forward_vec = MAnalyse(super, overlap=4, isb = false, search=3)
MFlowFps(super, backward_vec, forward_vec, num=2*FramerateNumerator(), \
   den=FramerateDenominator())

Чтобы генерировать приятное размытие движения с MFlowBlur:

AVISource("c:\test.avi") # или MPEG2Source, DirectShowSource, некоторый предыдущий фильтр
super = MSuper()
backward_vectors = super.MAnalyse(isb = true)
forward_vectors = super.MAnalyse(isb = false)
MFlowBlur(super, backward_vectors, forward_vectors, blur=15)

Понижение шума с некоторым внешним фильтром (который использует три кадра: предыдущий, текущий, следующий):

AVISource("c:\test.avi") # или MPEG2Source, DirectShowSource, некоторый предыдущий фильтр
super = MSuper()
backward_vectors = MAnalyse(super, isb = true)
forward_vectors = MAnalyse(super, isb = false)
forward_compensation = MFlow(super, forward_vectors, thSCD1=500) # или используйте MCompensate
backward_compensation = MFlow(super, backward_vectors, thSCD1=500) # или используйте MCompensate
# создадим чередующиеся трех-кадровые последовательности
interleave(forward_compensation, source, backward_compensation)

DeGrainMedian() # поместите  предпочитаемый Вами временной (пространственно-временной) фильтр здесь

selectevery(3,1) # возвращает фильтрованные только центральные (не компенсированные) кадры

Чтобы использовать предварительно отфильтрованный клип для более надежной оценки движения, но компенсировать движение нефильтрованного клипа (на примере подавления шума):

AVISource("c:\test.avi") # или MPEG2Source, DirectShowSource, некоторый предыдущий фильтр
super = MSuper()
# Используем некий шумоподавитель (блюр) или стабилизатор яркости для предварительной фильтрации
prefiltered = blur(1.0)
super = MSuper(levels=1) # одного уровня достаточно для MCompensate
superfilt = MSuper(prefiltered) # все уровни для MAnalyse
backward_vectors = MAnalyse(superfilt, isb = true)
forward_vectors = MAnalyse(superfilt, isb = false)
# используем нефильтрованный оригинальный (super) клип для компенсации движения
forward_compensation = MCompensate(super, forward_vectors)
backward_compensation = MCompensate(super, backward_vectors)
# создадим чередующиеся трех-кадровые последовательности
interleave(forward_compensation, last, backward_compensation)

DeGrainMedian() # поместите предпочитаемый Вами временной (пространственно-временной) фильтр здесь

selectevery(3,1) # возвращает фильтрованные только центральные (не компенсированные) кадры

Чтобы подавить шум функцией MDegrain2 с перекрывающимися блоками и субпиксельной точностью :

AVISource("c:\test.avi") # или MPEG2Source, DirectShowSource, некоторый предыдущий фильтр
super = MSuper(pel=2, sharp=1)
backward_vec2 = MAnalyse(super, isb = true, delta = 2, overlap=4)
backward_vec1 = MAnalyse(super, isb = true, delta = 1, overlap=4)
forward_vec1 = MAnalyse(super, isb = false, delta = 1, overlap=4)
forward_vec2 = MAnalyse(super, isb = false, delta = 2, overlap=4)
MDegrain2(super, backward_vec1,forward_vec1,backward_vec2,forward_vec2,thSAD=400)

Чтобы подавить шум чересстрочного источника функцией MDegrain1 с перекрывающимися блоками и субпиксельной точностью:

AVISource("c:\test.avi") # или MPEG2Source, DirectShowSource, некоторый предыдущий фильтр
fields=AssumeTFF().SeparateFields() # или AssumeBFF
super = MSuper(fields)
backward_vec2 = MAnalyse(super, isb = true, delta = 2, overlap=2)
forward_vec2 = MAnalyse(super, isb = false, delta = 2, overlap=2)
MDegrain1(fields, super, backward_vec2,forward_vec2,thSAD=400)
Weave()

Чтобы подавить шум чересстрочного источника функцией функцией MDegrain2i2 :

function MDegrain2i2(clip source, int "overlap", int "dct")
{
overlap=default(overlap,0) # величина перекрытия (от 0 до 4 для blksize=8)
dct=default(dct,0) # используйте dct=1 для клипов с некоторыми мерцаниями
fields=source.SeparateFields() # разделим на поля
super = fields.MSuper()
backward_vec2 = super.MAnalyse(isb = true, delta = 2, overlap=overlap, dct=dct)
forward_vec2 = super.MAnalyse(isb = false, delta = 2, overlap=overlap, dct=dct)
backward_vec4 = super.MAnalyse(isb = true, delta = 4, overlap=overlap, dct=dct)
forward_vec4 = super.MAnalyse(isb = false, delta = 4, overlap=overlap, dct=dct)
fields.MDegrain2(super, backward_vec2,forward_vec2,backward_vec4,forward_vec4,thSAD=400)
Weave()
}

AVISource("video.avi")
mdegrain2i2(4,0)

Как использовать внешний клип субпиксельной интерполяции:

# Загрузим Eedi2 плагин (от tritical) с функцией интерполяции с учетом направлений краев
LoadPlugin("Eedi2.dll")
AVISource("c:\test.avi") # или MPEG2Source, DirectShowSource, некоторый предыдущий фильтр
# создадим увеличенный клип из источника
ups = LanczosResize(2*width(last), 2*height(last), src_left=0.25, src_top=0.25)
super = MSuper(pel=2, pelclip=ups)
bv = MAnalyse(super, isb = true, overlap=4)
MCompensate(super, bv)

Как использовать с MT фильтром и специальной многопоточной версией AviSynth:

# Загрузим плагин MT от TSP
LoadPlugin("MT.dll")
avisource("some.avi")
MT("""
super = MSuper(pel=2, sharp=1)
backward_vec2 = MAnalyse(isb = true, delta = 2, overlap=4)
backward_vec1 = MAnalyse(isb = true, delta = 1, overlap=4)
forward_vec1 = MAnalyse(isb = false, delta = 1, overlap=4)
forward_vec2 = MAnalyse(isb = false, delta = 2, overlap=4)
MDegrain2(super, backward_vec1,forward_vec1,backward_vec2,forward_vec2,thSAD=400)
""",2) # два потока

Замечание: Режим SetMTMode(2) многопоточного AviSynth также поддерживается MVTools с версии 1.8.4.1 (бета тестирование). MVTools версии 2 должна работать надежнее. Некоторый пример с SetMTMode:

SetMTMode(5)
FFmpegSource("some.avi") # avisource не работает с SetMTMode на моих машинах - TSchniede

SetMTMode(2)
super = MSuper(pel=2)
backward_vec2 = MAnalyse(super, isb = true, delta = 2, overlap=4)
backward_vec1 = MAnalyse(super, isb = true, delta = 1, overlap=4)
forward_vec1 = MAnalyse(super, isb = false, delta = 1, overlap=4)
forward_vec2 = MAnalyse(super, isb = false, delta = 2, overlap=4)
MDegrain2(super, backward_vec1,forward_vec1,backward_vec2,forward_vec2,thSAD=400)

Как использовать предварительно фильтрованный клип и пересчитать данные движения для исходного клипа (пример MFlowFPS)

AVISource("c:\test.avi") # или MPEG2Source, DirectShowSource, некоторый предыдущий фильтр
prefiltered = DeGrainMedian() # некоторое сглаживание
super = MSuper(hpad=16, vpad=16, levels=1) # одного уровня достаточно для MRecalculate
superfilt = MSuper(prefiltered, hpad=16, vpad=16) # все уровни для MAnalyse
backward = MAnalyse(superfilt, isb = true, blksize=16)
forward = MAnalyse(superfilt, isb = false, blksize=16)
# пересчитать для оригинального клипа и другого размера блоков
forward_re = MRecalculate(super, forward, blksize=8, thSAD=100)
backward_re = MRecalculate(super, backward, blksize=8, thSAD=100)
MFlowFps(super, backward_re, forward_re, num=50, den=1)

Как использовать опцию planar для более быстрой обработки YUY2 (MDegrain3 пример):

LoadPlugin("SSEToolsS.dll") # для функций преобразования
AVISource("c:\test.avi") # или MPEG2Source, DirectShowSource, некоторый предыдущий фильтр
Interleaved2Planar() # преобразуем клип в планарный
super = MSuper(planar=true)
bv1 = MAnalyse(super, isb = true, delta = 1, overlap=4)
fv1 = MAnalyse(super, isb = false, delta = 1, overlap=4)
bv2 = MAnalyse(super, isb = true, delta = 2, overlap=4)
fv2 = MAnalyse(super, isb = false, delta = 2, overlap=4)
bv3 = MAnalyse(super, isb = true, delta = 3, overlap=4)
fv3 = MAnalyse(super, isb = false, delta = 3, overlap=4)
MDegrain3(super,bv1,fv1,bv2,fv2,bv3,fv3,thSAD=400,planar=true)
Planar2Interleaved() # преобразуем обратно в обычный чередующийся YUY2

IV) Отказ (от гарантий)

Плагин распространяется на условиях лицензии GNU GPL, без всяких гарантий. Смотрите 'gpl-rus.txt'.
Документация распространяется на условиях лицензии CreativeCommons BY-SA 3.0 license.
Прошу рассмотреть возможность финансовой поддержки.

MVTools использует части кода из следующих проектов:
Увеличение маски (Resizer) (SimpleResize.cpp) из плагина SimpleResize для Avisynth от Tom Barry. http://www.trbarry.com
Быстрое DCT (fdct_mmx.asm) из XVID MPEG-4 VIDEO CODEC. http://www.xvid.org
DCT общее преобразование (смотри fftwlite.h) из библиотеки FFTW (как вызов DLL). http://www.fftw.org
SATD (pixel-32.asm, pixel.asm) и альтернативная SADx264 (sad-a.asm, x86inc.asm, x86inc-32.asm, cpu-32.asm) из проекта x264. http://www.videolan.org/developers/x264.html (Loren Merritt, Laurent Aimar, Alex Izvorski et al).

V) Ревизии

2.5.11.22 (26.04.2016 by Fizick)

2.5.11.21 (22.04.2016 by Fizick)

2.5.11.20 (02.04.2016 by Fizick)

2.5.11.3 (19.09.2011 by Fizick)

2.5.11.2 beta (20.03.2011 by Fizick)

2.5.11.1 beta (22.12.2010 by Fizick)

2.5.11 beta (17.10.2010 by Fizick)

2.5.10.1 beta (25.06.2010 by Fizick)

2.5.10 beta (8.11.2009 by Fizick)

2.5.9 (4.11.2009 by Fizick)

2.5.8.1 (26.10.2009 by Fizick)

2.5.8 (18.10.2009 by Fizick)

2.5.7 (09.10.2009 by Fizick)

2.5.6 (08.10.2009 by Fizick)

2.5.5 (28.09.2009 by Fizick)

2.5.4 (27.09.2009 by Fizick)

2.5.3 (08.09.2009 by Fizick)

2.5.2 (11.08.2009 by Fizick)

2.5.1 (07.08.2009 by Fizick)

2.5.0 (01.08.2009 by Fizick)

2.4.7 (28.07.2009 by Fizick)

2.4.6 (26.07.2009 by Fizick)

2.4.5 (11.07.2009 by Fizick)

2.4.4 (08.07.2009 by Fizick)

2.4.2_mod2 (30.06.2009 by Pavel Skakov aka SEt)

2.4.2_mod (22.06.2009 by Pavel Skakov aka SEt)

2.4.3 beta (26.04.2009 by Fizick)

2.4.2 (07.04.2009 by Fizick)

2.4.1 beta (24.01.2009 by Fizick)

2.4.0 beta (09.01.2009 by Fizick)

2.3.1 (14.12.2008 by Fizick)

2.3.0 (06.12.2008 by Fizick)

2.2.2 (30.11.2008 by Fizick)

2.2.1 (27.11.2008 by Fizick)

2.1.2 (23.11.2008 by Fizick)

2.1.1 (18.11.2008 by Fizick)

2.1.0 (8.11.2008 by Fizick)

2.0.11.2 (6.11.2008 by Fizick)

2.0.11.1 (5.11.2008 by Fizick)

2.0.9.2 (3.11.2008 by Fizick)

2.0.9.1 (20.10.2008 by Fizick)

2.0.9.0 альфа (13.10.2008 by Fizick)

2.0.7.0 альфа (02.10.2008 by Fizick)

2.0.0.3 альфа (28.09.2008 by Fizick)

1.11.4.4 (15.10.2008 by Fizick)

1.11.4.3 (08.10.2008 by Fizick)

1.11.4.2 (26.09.2008 by Fizick)

1.11.0.1 beta (08.09.2008 by Fizick)

1.10.2.1 (28.08.2008 jn Fizick)

1.10.2.0 публичная beta (27.08.2008 от Fizick)

1.10.1.0 не публичная (22.08.2008 by Fizick)

1.10.0.0 не публичная (18.08.2008 от Fizick)

1.9.6.x-1.9.7.x ветвь (01.08.2008-26.08.2008 от josey_wells)

1.9.5.7 публичная бета (03.07.2008 от Fizick)

1.9.5.6 (02.07.2008 от TSchniede)

1.9.5.5 (28.06.2008 от TSchniede)

1.9.5.4 (27.06.2008 by TSchniede)

1.9.5.3 (26.06.2008 by TSchniede)

1.9.5.2 (24.06.2008 by TSchniede)

1.9.5.1 public beta (21.06.2008 by Fizick)

1.9.5 (21.06.2008 by TSchniede), основана на v.1.9.3

1.9.4.1 beta (12.06.2008 от Fiziick, выпущена 21.06.2008)

1.9.4 бета (08.06.2008 от Fizick)

1.9.3.1 (05.06.2008 от Fizick)

1.9.3 (20.04.2008 от Fizick)

1.9.2 (29.01.2008 от Fizick, но все ошибки были найдены josey_wells)

1.9.1 бета (15.12.2007 от Fizick)

1.9.0 (04.12.2007 от Fizick)

1.8.6 (02.12.2007 от Fizick)

1.8.5.1 (12.11.2007 от нас:)

1.8.4.3 (05.10.2007 by Tsp)

1.8.5 (05.11.2007 by Fizick)

1.8.4.2 (25.10.2007 by Tsp)

1.8.4.1 (23.10.2007 by Tsp)

1.8.4 (22.08.2007 by Fizick)

1.8.3 (17-20.08.2007 by Fizick)

1.8.2 beta (30.07.2007 by Fizick)

1.8.1 beta (28.06.2007 by Fizick)

1.8.0 beta (22.06.2007 by Fizick)

1.7.0 beta (05.06.2007 by Fizick)

1.6.4 (30.05.2007 by Fizick)

1.6.3 (06.05.2007 by Fizick)

1.6.2 (11.11.2006 by Fizick)

1.6.1 beta (25.10.2006 by Fizick)

1.5.8 beta (14.10.2006 by Fizick)

1.5.3 beta (01.10.2006 by Fizick)

1.5.1 beta (05.09.2006 by Fizick)

1.5.0 beta (23.08.2006 by Fizick)

1.4.13 (28.09.2006 by Fizick)

1.4.12 (25.09.2006 by Fizick)

1.4.11 (06.09.2006 by Fizick)

1.4.10 (18.08.2006 by Fizick)

1.4.9 (14.08.2006 by Fizick)

1.4.8 (31.07.2006 by Fizick)

1.4.7 (25.07.2006 by Fizick)

1.4.6 (24.07.2006 by Fizick)

1.4.5 (22.07.2006 by Fizick)

1.4.4 (19.07.2006 by Fizick)

1.4.3 (17.07.2006 by Fizick)

1.4.2 (16.07.2006 by Fizick)

1.4.1 (23.06.2006 by Fizick)

1.4.0 (19.06.2006 by Fizick)

1.3.1 (11.06.2006 by Fizick)

1.3.0 (05.06.2006 by Fizick)

1.2.6 beta (21.05.2006 by Fizick)

1.2.5 (08.05.2006 by Fizick)

1.2.4 (07.04.2006 by Fizick)

1.2.3 (31.03.2006 by Fizick)

1.2.2 beta (01.03.2006 by Fizick)

1.2.1 beta (20.02.2006 by Fizick)

1.2 beta (17.02.2006 by Fizick)

1.1.1 (16.02.2006 by Fizick)

1.1 (не публичный выпуск 9.01.2006 by Fizick)

1.0.3 (Выпущена 30.12.2005 by Fizick)

1.0.2 (Выпущена 28.12.2005 by Fizick)

1.0.1 (Выпущена 24.12.2005 by Fizick)

1.0 (Выпущена 29.11.2005 by Fizick)

0.9.13.3 (Выпущена 27.11.2005 by Fizick)

0.9.13.2 (Выпущена 22.11.2005 by Fizick)

0.9.13.1 (Выпущена 21.11.2005 by Fizick)

0.9.13 (Выпущена 20.11.2005 by Fizick)

0.9.12.4 (Выпущена 15.11.2005 by Fizick)

0.9.12.3 (Выпущена 14.11.2005 by Fizick)

0.9.12.2 (Выпущена 13.11.2005 by Fizick)

0.9.12.1 (Выпущена 12.11.2005 by Fizick)

0.9.12 (Выпущена 09.11.2005 by Fizick)

0.9.11.1 (Выпущена 06.11.2005 by Fizick)

0.9.11 (Выпущена 04.11.2005 by Fizick)

0.9.10.1 (Выпущена 01.11.2005 by Fizick)

0.9.10 (Выпущена 31.10.2005 by Fizick)

0.9.9.1 (Выпущена 20.01.2005 by Manao)

0.9.9

0.9.8.5

0.9.8.4

0.9.8.3

0.9.8.2

0.9.8

0.9.7

0.9.6.2

0.9.6.1

0.9.5.3

0.9.5.2

0.9.5

0.9.4

0.9.3

0.9.2.1

0.9.2

0.9.1 - 12.05.2004

0.1-0.6 - Выпущена 24.01.2004 - 01.04.2004 by Manao

VI) Скачать (Download)

Последняя версия Fizick: Download MVTools v2.5.11.22

Предыдущая версия: Download MVTools v2.5.11.20

Ранняя версия: Download MVTools v2.5.11.3

MVTools 2 mod16 dither version by Laurent de Soras 'Firesledge': http://ldesoras.free.fr/

На форумах вы можете найти и другие 'неофициальные' билды, в том числе 64 битные.

Документация и ссылки для скачивания версий предыдущей ветви 1.X находятся по адресу http://avisynth.org.ru/mvtools/mvtools-rus.html

Старая версия MVTools v.0.9.9.1 может быть скачена с сайта Manao

$English Date: 2006/09/17 17:47:05 - более свежие версии пока не на CVS $
Русский перевод версии 0.9.9.1 08.07.2005 Turyst04
Редакция и дополнения 14.07.2005 Fizick http://bag.hotmail.ru
Подробное введение, добавленные функции и примеры 2005-2016 Fizick http://avisynth.org.ru