Home>RuServices>RuServicesFilters
Copyright (C) 2004-2005 Ushodaya Enterprises Limited
Authors: Charles Yates <charles.yates@pandora.be>
         Dan Dennedy <dan@dennedy.org>
Last Revision: 2005-04-22
Translator: Ruslan Popov <radz@yandex.ru>
Last Revision: 2006-01-11

Службы

Фильтры

Фильтр brightness

Описание

Фильтр предназначен для выполнения сдвига luma компоненты на постоянную величину.

Свойства

Тип Параметр Описание
CI double start Начальное значение параметра фильтра, по умолчанию 0.
I int in in point
I int out out point
I double end Конечное значение параметра фильтра, фильтр интерполирует значение между начальним и конечным величинами во время расчёта фильтра.

где

  • C обозначает аргументы конструктора;
  • I обозначает свойства инициализации;
  • R обозначает свойства только для чтения;
  • M обозначает изменяемые свойства.

Зависимости

Нет.

Известные проблемы

Не уходит полностью в черное или белое.

Фильтр channelcopy

Описание

Фильтр предназначен для копирования звука из одного канала в другой.

Свойства

Тип Параметр Описание
CI int to Номер канала, в который будет производиться копирование, по умолчанию 1.
M int from Номер канала из которого будет производиться копирование звука, по умолчанию 0.

где

  • C обозначает аргументы конструктора;
  • I обозначает свойства инициализации;
  • R обозначает свойства только для чтения;
  • M обозначает изменяемые свойства.

Зависимости

Нет.

Известные проблемы

Нет

Фильтр deinterlace

Описание

Фильтр производит удаление черезстрочности кадра состоящего из двух полей с помощью методов bob, weave, greedy, one-field и linear blend. Код был создан на основе плагина Xine XV video.

Свойства

Тип Параметр Описание
CM string method Метод удаления черезстрочности.
I int in in point
I int out out point

где

  • C обозначает аргументы конструктора;
  • I обозначает свойства инициализации;
  • R обозначает свойства только для чтения;
  • M обозначает изменяемые свойства.

Метод удаления черезстрочности может быть: bob, weave, greedy, onefield или linearblend, по умолчанию используется linearblend.

Подробности

Если свойства кадра progressive или consumer_progressive не равны нулю, то фильтр не применяется. После применения фильтра значение свойства progressive устанавливается в 1.

Зависимости

Нет.

Известные проблемы

Это не ошибка, но фильтр предоставляет посредственный результат.

Фильтр gamma

Описание

Фильтр предназначен для изменения luma компоненты изображения с помощью нелинейной квадратичной кривой.

Свойства

Тип Параметр Описание
CM double gamma The exponential factor of the power-law curve. По умолчанию 1.0 или вообще не определено.
I int in in point
I int out out point

где

  • C обозначает аргументы конструктора;
  • I обозначает свойства инициализации;
  • R обозначает свойства только для чтения;
  • M обозначает изменяемые свойства.

Зависимости

Нет.

Известные проблемы

Нет.

Фильтр greyscale

Описание

Фильтр осуществляет преобразование цветов изображения в оттенки серого.

Свойства

Тип Параметр Описание
I int in in point
I int out out point

где

  • C обозначает аргументы конструктора;
  • I обозначает свойства инициализации;
  • R обозначает свойства только для чтения;
  • M обозначает изменяемые свойства.

Зависимости

Нет.

Известные проблемы

Нет.

Фильтр gtkrescale

Описание

Фильтр производит масштабирование кадра, полученного от производителя, в соответствии с требованиями, полученными от потребителя. Этот фидьтр был разработан для использования в качестве нормализатора для производителя fezzik.

Свойства

Тип Параметр Описание
CM string interpolation Метод масштабирования. См. далее.
I int in in point
I int out out point

где

  • C обозначает аргументы конструктора;
  • I обозначает свойства инициализации;
  • R обозначает свойства только для чтения;
  • M обозначает изменяемые свойства.

Метод масштабирования, может быть одним из:

  • nearest - самый быстрый, худшее качество;
  • tiles - среднее качество;
  • bilinear - хорошее качество, нормальная скорость, этот метод используется по умолчанию;
  • hyper - лучшее качество, самый медленный.

Если параметр consumer_aspect_ratio определён для кадра, то фильтр нормализует аспект кадра производителя и увеличивает размер кадра, но есть может не выполнить заданную потребителем задачу. Следовательно, эту опцию лучше использовать совместно с фильтром resize. Такое поведение может быть отключено другим сервисом, который может удалить параметр, установить его в ноль или установить параметр кадра distort в 1.

Зависимости

Библиотеки libgdk_pixbuf-2.0, libglib-2.0, libgobject-2.0, libgmodule-2.0.

Известные проблемы

Нет.

Фильтр jackrack

Описание

Фильтр создает Jack порты и запускает демон JackRack для обработки звука с помощью набора LADSPA фильтров.

Свойства

Тип Параметр Описание
C string src Путь до файла JackRack.
I int in in point
I int out out point
Свойства перечисленные ниже могут быть использованы без файла RackJack, для того чтобы подключить filter_jackrack к работающему экземпляру демона:
I string out_1 Порт (вход) демона для подключения порта (выход) библиотеки MLT.
I string out_2 Порт (вход) демона для подключения порта (выход) библиотеки MLT.
I string in_1 Порт (выход) демона для подключения порта (вход) библиотеки MLT.
I string in_2 Порт (выход) демона для подключения порта (вход) библиотеки MLT.

где

  • C обозначает аргументы конструктора;
  • I обозначает свойства инициализации;
  • R обозначает свойства только для чтения;
  • M обозначает изменяемые свойства.

Подробности

Если вы используете потребителя, который использует ALSA, то следует демон JackRack запускать следующим образом: 

jackd -d dummy
а лучше: 
jackd -d dummy -r 48000 -p 2048

Зависимости

Библиотеки Jack, LADSPA, glib-2.0, libxml2.

Известные проблемы

В настоящее время из-за проблем с синхронизацией звук искажён повторяющимися образцами и щелчками.

Изменение частоты не поддерживается и поэтому демон работает с фиксированной частотой оцифровки звука.

Фильтр ladspa

Описание

Фильтр предназначен для обработки звука с помощью набора LADSPA фильтров без использования демона Jack.

Свойства

Тип Параметр Описание
C string src Путь до файла JackRack.
I int in in point
I int out out point

где

  • C обозначает аргументы конструктора;
  • I обозначает свойства инициализации;
  • R обозначает свойства только для чтения;
  • M обозначает изменяемые свойства.

Подробности

Due to audio integrity issues with the jackrack filter, this filter is better for runtime, while jackrack is more suitable for prototyping a rack file using the Jack Rack GUI.

Зависимости

Библиотеки Jack, LADSPA, glib-2.0, libxml2.

Пакет Jack по прежнему необходим, так как в нём поставляетя JackRack фильтр.

Известные проблемы

Изменение частоты не поддерживается и поэтому демон работает с фиксированной частотой оцифровки звука.

Фильтр luma

Описание

Фильтр предназначен для применения преобразования luma между текущим и следующим кадром. Удобно использовать для изображений созданных с помощью производителя pixbuf.

Свойства

Тип Параметр Описание
C file Поток изображений
I int in in point
I int out out point
M int period Период ожидания между успешными итерациями преобразования. Для наилучшего результата этот параметр следует устанавливать кратным параметру ttl производителя pixbuf. По умолчанию 24.
M luma. Все свойства начинающиеся с luma. передаются преобразованию. Например, luma.out управляет длительностью

где

  • C обозначает аргументы конструктора;
  • I обозначает свойства инициализации;
  • R обозначает свойства только для чтения;
  • M обозначает изменяемые свойства.

Зависимости

Преобразование luma и его зависимости.

Известные проблемы

Нет.

Фильтр mcrescale

Описание

Фильтр предназначен для масштабирования размера кадра к требованиям потребителя. Данный фильтр разработан для использования с производителем fezzik.

Свойства

Тип Параметр Описание
C interpolation Метод масштабирования.
I int in in point
I int out out point
M string interpolation См. аргумент конструктора.

где

  • C обозначает аргументы конструктора;
  • I обозначает свойства инициализации;
  • R обозначает свойства только для чтения;
  • M обозначает изменяемые свойства.

Метод масштабирования может быть одним из:

  • nearest - самый быстрый, худшее качество;
  • bilinear - хорошее качество, нормальная скорость, этот метод используется по умолчанию;
  • hyper - лучшее качество, самый медленный.

Если параметр consumer_aspect_ratio определён для кадра, то фильтр нормализует аспект кадра производителя и увеличивает размер кадра, но есть может не выполнить заданную потребителем задачу. Следовательно, эту опцию лучше использовать совместно с фильтром resize. Такое поведение может быть отключено другим сервисом, который может удалить параметр, установить его в ноль или установить параметр кадра distort в 1.

Зависимости

MainConcept Rescaling SDK.

Известные проблемы

Нет.

Фильтр mirror

Описание

Фильтр предназначен для создания различных эффектов отражения и обращения изображений.

Свойства

Тип Параметр Описание
C mirror Метод отражения.
I int reverse Обратное отражение или нет, 0 или 1.
I int in in point
I int out out point

где

  • C обозначает аргументы конструктора;
  • I обозначает свойства инициализации;
  • R обозначает свойства только для чтения;
  • M обозначает изменяемые свойства.

Метод отражения может быть одним из:

  • horizontal - горизонтальное;
  • vertical - вертикальное;
  • diagonal - диагональное;
  • flip - надо определиться с этим;
  • flop - и с этим тоже.

Зависимости

Нет.

Известные проблемы

Нет.

Фильтр obscure

Описание

Фильтр предназначен для реализации камеры обскура.

Свойства

Тип Параметр Описание
I string start В формате X,Y:WxH[:PWxPY].
I string end В формате X,Y:WxH[:PWxPY].
I int in in point
I int out out point

где

  • C обозначает аргументы конструктора;
  • I обозначает свойства инициализации;
  • R обозначает свойства только для чтения;
  • M обозначает изменяемые свойства.

Причем PWxPY является размером в пикселах усредняющей области.

Зависимости

Нет.

Известные проблемы

Нет.

Фильтр region

Описание

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

Свойства

Тип Параметр Описание
C resource Файл с изображением содержащим канал прозрачности для определения формы области. The string "circle" is a shortcut but it requires pixbuf with the librsvg loader. The circle is automatically stretched to the region to create an ellipse.
I int in in point
I int out out point
IR Свойства преобразования region.

где

  • C обозначает аргументы конструктора;
  • I обозначает свойства инициализации;
  • R обозначает свойства только для чтения;
  • M обозначает изменяемые свойства.

Зависимости

Преобразование region.

Известные проблемы

"circle" is unpredictable in the absence of the librsvg pixbuf loader.

Фильтр resample

Описание

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

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

Свойства

Тип Параметр Описание
C int frequency Новая частота оцифровки звука.
I int in in point
I int out out point
M int frequency См. аргументы конструктора.

где

  • C обозначает аргументы конструктора;
  • I обозначает свойства инициализации;
  • R обозначает свойства только для чтения;
  • M обозначает изменяемые свойства.

Зависимости

Библиотека libresample.

Известные проблемы

Предполагается, что при инициализации библиотеки libsamplerate будет указано два звуковых канала. На большем количестве тесты не проводились.

Фильтр rescale

Описание

Фильтр предназначен для масштабирования размера кадра генерируемого производителем согласно запросу потребителя. Данный фильтр разработан для использования совместно с производителем fezzik в целях нормализации.

Свойства

Тип Параметр Описание
I int in in point
I int out out point
M int frequency См. аргументы конструктора.

где

  • C обозначает аргументы конструктора;
  • I обозначает свойства инициализации;
  • R обозначает свойства только для чтения;
  • M обозначает изменяемые свойства.

Если параметр consumer_aspect_ratio определён для кадра, то фильтр нормализует аспект кадра производителя и увеличивает размер кадра, но есть может не выполнить заданную потребителем задачу. Следовательно, эту опцию лучше использовать совместно с фильтром resize. Такое поведение может быть отключено другим сервисом, который может удалить параметр, установить его в ноль или установить параметр кадра distort в 1.

Зависимости

Нет.

Известные проблемы

Нет, но пока реализовано только масштабирование методом nearest neighbour. Данный фильтр используется как основа для фильтров gtkrescale и mcrescale.

Фильтр resize

Описание

Фильтр предназначен для масштабирования изображения, а также выравнивания изображения внутри кадра.

Подробности

Normally resize is used to pad the producer's output to what the consumer has requested after an upstream rescale filter first scales the image to maximise usage of the image area. This filter also adjusts the field order to lower field first if the frame property "top_field_first" has been set to 1. Therefore, when done, it sets the top_field_first to 0. This filter is automatically invoked by Fezzik as part of image sample aspect ratio normalisation.

Свойства

Тип Параметр Описание
C scale Метод обработки. Используйте affine для афинного масштабирования. В противном случае производится центрирование и перемещение.
I int in in point
I int out out point
M int frequency См. аргументы конструктора.

где

  • C обозначает аргументы конструктора;
  • I обозначает свойства инициализации;
  • R обозначает свойства только для чтения;
  • M обозначает изменяемые свойства.

Зависимости

Нет.

Известные проблемы

Предполагается, что нижнее поле идёт первым, т.е. поддерживается только DV поток.

Фильтр volume

Описание

Фильтр предназначен для управления уровнем громкости звукового потока. В качестве основы фильтр использует утилиту normalize.

Свойства

Тип Параметр Описание
C string gain Величина изменения громкости звукового потока.
I int in in point
I int out out point
I int window Количество кадров, шаг с которым проводится нормализация, по умолчанию 75.
M string gain См. аргументы конструктора.
M string normalize Нормализация уровня громкости к амплитуде. См. далее.
M string limiter Величина, начиная с которой производится ограничение уровня громкости. См. далее.
M double max_gain Максимальная величина изменения уровня громкости, выражается в виде числа с плавающей точкой или в виде целого числа с суффиксом dB. Если этот параметр не определён, то по умолчанию используется 20dB.
M int window Количество кадров, шаг с которым проводится нормализация, по умолчанию 75.

где

  • C обозначает аргументы конструктора;
  • I обозначает свойства инициализации;
  • R обозначает свойства только для чтения;
  • M обозначает изменяемые свойства.

Величина изменения громкости звукового потока может быть указана как:

  • число с плавающей точкой;
  • целое цисло с суффиксом dB;
  • параметр normalize для нормализации к амплитуде -12dBFS.

Нормализация уровня громкости к амплитуде может быть указана как:

  • число с плавающей точкой;
  • целое цисло с суффиксом dB;
  • если величина не указана, то производится нормализация к амплитуде -12dBFS.

Величина ограничения может быть указана как:

  • число с плавающей точкой ( dB = 20 * log10(x) );
  • целое цисло с суффиксом dB;
  • если величина не указана, то производится нормализация к амплитуде -6dBFS.

Gain can be applied as a factor to the normalise amplitude!

Зависимости

Нет.

Известные проблемы

Нет.

Фильтр watermark

Описание

Фильтр предназначен для добавления метки на изображение.

Свойства

Тип Параметр Описание
CI string resource Ресурс, который будет использоваться в качестве метки (.png изображение.
I int in in point
I int out out point
I string factory Производитель необходимый для работы с ресурсом, fezzik.
I string geometry Геометрия метки.
I string distort Управление масштабированием.

где

  • C обозначает аргументы конструктора;
  • I обозначает свойства инициализации;
  • R обозначает свойства только для чтения;
  • M обозначает изменяемые свойства.

Зависимости

Основные модули библиотеки MLT и, опционально, производитель fezzik.

Известные проблемы

Нет.

-- RaD - 11 Jan 2006
Edit | Attach | Print version | History: r5 < r4 < r3 < r2 < r1 | Backlinks | Raw View | Raw edit | More topic actions
Topic revision: r5 - 2007-04-24 - 05:02:29 - DanDennedy
 
This site is powered by the TWiki collaboration platformCopyright © by the contributing authors. All material on this collaboration platform is the property of the contributing authors.
Ideas, requests, problems regarding MLT Wiki? Send feedback