Avisynth wiki - User contributions [en]

Добро пожаловать

2011-11-22T15:19:48Z

Fizick: updated links

[http://sourceforge.net/project/showfiles.php?group_id=57023 Загрузить] | [[AviSynth FAQ]] | [[Internal filters|Внутренние фильтры]] | [[External filters|Внешние фильтры]] | [http://forum.doom9.org/forumdisplay.php?s=&forumid=33 Doom9 форум] | [http://sourceforge.net/projects/avisynth2/ Страница проекта] | [[Feedback|Обратная связь]]

Внимание: данная страница и сайт в целом переведены на русский язык далеко не полностью (то есть вообще не переведены). Имеющаяся команда переводчиков сосредоточила имеющиеся силы на переводе офф-лайновой документации, распространяющейся с дистрибутивом AviSynth (смотри сайт [http://avisynth.org.ru www.avisynth.org.ru]).

Однако вы можете переводить и дополнять статьи Wiki данного сайта самостоятельно (используя переведенные части офф-лайновой документации для единства стиля и терминов), добавляя к английским именам страниц окончание /ru (или создать страницы с русским именем - можно и то и другое с перенаправлением).

== Что такое AviSynth? ==

AviSynth - это мощное средство для пост-обработки видео. Он предоставляет методы для редактирования и обработки видео файлов. AviSynth работает как [[фрэймсервер]], обеспечивая мгновенное редактирование без необходимости временных файлов.

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

Заинтересовались? На этом сайте вы можете узнать [[more about AviSynth|больше об AviSynth]], изучить официальное [[Internal filters|руководство по AviSynth]], и просмотреть [[AviSynth FAQ|часто задаваемые вопросы и ответы]]. Или вы можете перейти прямо на [http://sourceforge.net/project/showfiles.php?group_id=57023 страницу загрузки] на [[SourceForge]]. AviSynth - свободно распространяемая программа с открытым кодом.

== Использование ==
=== Что нового в AviSynth - Начните с малого! ===

* [[first script|Ваш первый скрипт]] - Руководство для начинающих.
* [[Getting started|С чего начать]] - Краткая инструкция об использовании AviSynth.
* [[Filter introduction|Обзор фильтров]] - Краткий обзор наиболее часто используемых фильтров AviSynth.
* [[Script examples|Примеры скриптов]] - Несколько примеров, используемых во всем Мире.
* Несколько руководств, разъясняющих использование AviSynth:
** [http://www.doom9.org/capture/postprocessing_avisynth.html Руководство захвата аналогового сигнала]. The AviSynth part of the capture guide is about what filters can be used to enhance the quality of the capture. It discusses things like deinterlacing, denoising, cropping and resizing and color adjustment. Which makes it really useful to learn about some of the capabilities of AviSynth in a schematic way.
** [http://www.animemusicvideos.org/guides/avtech/avisyntha.html Введение в AviSynth от AnimeMusicVideos.org]. Простая инструкция, описывающая деинтерлизинг, изменение размера и некоторые другие базовые действия.
** [http://www.animemusicvideos.org/guides/avtech/avspostqual.html Введение в фильтры AviSynth от AnimeMusicVideos.org]. Простая инструкция, описывающая фильтры сглаживания, удаления муара, повышения резкости, управления цветом и некоторых других.
* [[Troubleshooting|Обнаружение проблем]] в Ваших скриптах и конфигурации.

=== Фильтры, внешние плагины, скриптовые функции и утилиты ===

* [[Internal filters|Внутренние фильтры]] - Официальный список включенных в AviSynth фильтров с описанием, сгруппированный по категориям.
* [[External filters|Внешние фильтры]] - Документация некоторых скриптовых функций и плагинов для AviSynth версии 2.5x.
** [[External plugins old|Внешние плагины (устар.)]] - Документация по плагинам AviSynth версий v1.0x/v2.0x (устаревшие плагины, однако некоторые из них по прежнему могут быть использованы).
* [http://www.avisynth.org/warpenterprises/ Коллекция плагинов AviSynth] собранная WarpEnterprises.
* [[Shared functions|Общие функции]] - Полезные скриптовые функции.
* [[Utilities]] - Список GUIs, командных, групповых и других AviSynth-утилит.

=== Синтаксис AviSynth-скрипта ===

* [[AviSynth Syntax|Синтаксис]] - Официальная документация.
** [[Grammar|Грамматика]] - Грамматика скриптового языка AviSynth. Введение в скриптовый язык AviSynth.
** [[Script variables|Переменные]] - Как объявлять и использовать их в скриптах.
** [[Operators|Операторы]] - Допустимые операторы и их приоритет.
** [[Clip properties|Свойства клипа]] - Функции, возвращающие свойства клипа.
** [[Control structures|Структуры управления]] - Языковые конструкции управления потоком.
** [[Internal functions|Встроенные функции]] - Ready-made non-clip функции для использования в скриптах.
** [[User defined script functions|Определяемые пользователем скриптовые функции]] - Как их объявлять и использовать.
** [[Plugins|Плагины]] - Как подключать плагины AviSynth, VirtualDub, VFAPI и C-плагины, их автозагрузка и именные предпочтения.
** [[Runtime environment|Runtime-окружение]] - Скриптовое описание для использования отдельных кадров клипа.
* [[Scripting reference|Руководство по скриптам]] - Выход за пределы базовых приемов написания скриптов.
** [[The full AviSynth grammar|Полное руководство по грамматике]] - Полное руководство по использованию AviSynth.
** [[The script execution model|Модель выполнения скриптов]] - The steps behind the scenes from the script to the final video clip output. The filter graph. Scope and lifetime of variables. Evaluation of runtime scripts.
** [[User functions|Функции пользователя]] - Как эффективно создавать пользовательские скриптовые функции; как избегать общих ошибок; способы организации ваших функций в коллекции, создание библиотек функций и многое другое.
** [[Block statements|Блоковые конструкции]] - Технические идиомы для создания блоков AviSynth-скриптов.
** [[Arrays|Массивы]] - Использование массивов (и соответствующих операторов) для управления наборами данных в один шаг.
** [[Scripting at runtime|Выполнение скриптов]] - Как раскрыть все возможности runtime фильтров и создавать комплексные скрипты, которые реализуют интересные (и эффективные по быстродействию) эффекты и операции.

=== FAQ, Руководства и дополнительные материалы ===

* [[AviSynth FAQ]] - Ответы на часто задаваемые вопросы.
* [[Aspect ratios|Пропорции клипов]] - Введение в соотношение сторон клипов (DAR, PAR, SAR), как правильно измененять размер исходных клипов.
* [[Guides|Руководства]] - Советы по конкретным типам конвертирования и общие задачи.
* [[Advanced topics|Дополнительные советы]] - Рассказывают о таких вещах как ошибка Chroma Upsampling, преобразование цветов, гибридное видео, компенсация движения и т.д.

== Разработка ==

* Хотите [[get involved|принять участие]]?
* Официальный [http://sourceforge.net/projects/avisynth2/ SourceForge] проект.
* О том, [[compile AviSynth|как откомпилировать AviSynth]] и плагины.
* [[Filter SDK]] - Советы по программированию AviSynth-плагинов.
* [http://forum.doom9.org/forumdisplay.php?s=&forumid=69 Форум разработчиков].
* Список [[changelist|последних изменений]].
* О разработке платформонезависимой [[AviSynth v3]].

== Wiki ==

Добро пожаловать на MediaWiki. Не стесняйтесь в наполнении данного сайта! Нам нужна Ваша помощь в наполнении данного Wiki-сайта. Ознакомьтесь с [http://meta.wikimedia.org/wiki/Помощь:Содержание руководством пользователя] по редактированию данного сайта.

== Авторские права на документацию ==

Права на документацию AviSynth (c) 2002-2007 принадлежат группе разработчиков AviSynth и других людей, сделавших вклад.

С 5 августа 2007 года информация на данном сайте публикуется под лицензией [http://creativecommons.org/licenses/by-sa/3.0/deed.ru CreativeCommons Attribution-ShareAlike 3.0 License] (сокращенно "CC BY-SA 3.0", см. [http://creativecommons.org/licenses/by-sa/3.0/legalcode полные правила лицензирования]). Неофициальный перевод на русский: http://ru.wikisource.org/wiki/Creative_Commons_Attribution-ShareAlike_3.0_Unported .

Дополнительная информация о правах доступна [[Avisynth:Copyrights|здесь]].

Добро пожаловать

2011-11-22T14:48:30Z

Fizick: removed spam-like link

[http://sourceforge.net/project/showfiles.php?group_id=57023 Загрузить] | [[AviSynth FAQ]] | [[Internal filters|Внутренние фильтры]] | [[External filters|Внешние фильтры]] | [http://forum.doom9.org/forumdisplay.php?s=&forumid=33 Doom9 форум] | [http://sourceforge.net/projects/avisynth2/ Страница проекта] | [[Feedback|Обратная связь]]

Внимание: данная страница и сайт в целом переведены на русский язык далеко не полностью (то есть вообще не переведены). Имеющаяся команда переводчиков сосредоточила имеющиеся силы на переводе офф-лайновой документации, распространяющейся с дистрибутивом AviSynth (смотри сайт [http://avisynth.org.ru www.avisynth.org.ru]).

Однако вы можете переводить и дополнять статьи Wiki данного сайта самостоятельно (используя переведенные части офф-лайновой документации для единства стиля и терминов), добавляя к английским именам страниц окончание /ru (или создать страницы с русским именем - можно и то и другое с перенаправлением).

== Что такое AviSynth? ==

AviSynth - это мощное средство для пост-обработки видео. Он предоставляет методы для редактирования и обработки видео файлов. AviSynth работает как [[фрэймсервер]], обеспечивая мгновенное редактирование без необходимости временных файлов.

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

Заинтересовались? На этом сайте вы можете узнать [[more about AviSynth|больше об AviSynth]], изучить официальное [[Internal filters|руководство по AviSynth]], и просмотреть [[AviSynth FAQ|часто задаваемые вопросы и ответы]]. Или вы можете перейти прямо на [http://sourceforge.net/project/showfiles.php?group_id=57023 страницу загрузки] на [[SourceForge]]. AviSynth - свободно распространяемая программа с открытым кодом.

== Использование ==
=== Что нового в AviSynth - Начните с малого! ===

* [[first script|Ваш первый скрипт]] - Руководство для начинающих.
* [[Getting started|С чего начать]] - Краткая инструкция об использовании AviSynth.
* [[Filter introduction|Обзор фильтров]] - Краткий обзор наиболее часто используемых фильтров AviSynth.
* [[Script examples|Примеры скриптов]] - Несколько примеров, используемых во всем Мире.
* Несколько руководств, разъясняющих использование AviSynth:
** [http://www.doom9.org/capture/postprocessing_avisynth.html Руководство захвата аналогового сигнала]. The AviSynth part of the capture guide is about what filters can be used to enhance the quality of the capture. It discusses things like deinterlacing, denoising, cropping and resizing and color adjustment. Which makes it really useful to learn about some of the capabilities of AviSynth in a schematic way.
** [http://www.animemusicvideos.org/guides/avtech/avisyntha.html Введение в AviSynth от AnimeMusicVideos.org]. Простая инструкция, описывающая деинтерлизинг, изменение размера и некоторые другие базовые действия.
** [http://www.animemusicvideos.org/guides/avtech/avspostqual.html Введение в фильтры AviSynth от AnimeMusicVideos.org]. Простая инструкция, описывающая фильтры сглаживания, удаления муара, повышения резкости, управления цветом и некоторых других.
* [[Troubleshooting|Обнаружение проблем]] в Ваших скриптах и конфигурации.

=== Фильтры, внешние плагины, скриптовые функции и утилиты ===

* [[Internal filters|Внутренние фильтры]] - Официальный список включенных в AviSynth фильтров с описанием, сгруппированный по категориям.
* [[External filters|Внешние фильтры]] - Документация некоторых скриптовых функций и плагинов для AviSynth версии 2.5x.
** [[External plugins old|Внешние плагины (устар.)]] - Документация по плагинам AviSynth версий v1.0x/v2.0x (устаревшие плагины, однако некоторые из них по прежнему могут быть использованы).
* [http://www.avisynth.org/warpenterprises/ Коллекция плагинов AviSynth] собранная WarpEnterprises.
* [[Shared functions|Общие функции]] - Полезные скриптовые функции.
* [[Utilities]] - Список GUIs, командных, групповых и других AviSynth-утилит.

=== Синтаксис AviSynth-скрипта ===

* [[AviSynth Syntax|Синтаксис]] - Официальная документация.
** [[Grammar|Грамматика]] - Грамматика скриптового языка AviSynth. Введение в скриптовый язык AviSynth.
** [[Script variables|Переменные]] - Как объявлять и использовать их в скриптах.
** [[Operators|Операторы]] - Допустимые операторы и их приоритет.
** [[Clip properties|Свойства клипа]] - Функции, возвращающие свойства клипа.
** [[Control structures|Структуры управления]] - Языковые конструкции управления потоком.
** [[Internal functions|Встроенные функции]] - Ready-made non-clip функции для использования в скриптах.
** [[User defined script functions|Определяемые пользователем скриптовые функции]] - Как их объявлять и использовать.
** [[Plugins|Плагины]] - Как подключать плагины AviSynth, VirtualDub, VFAPI и C-плагины, их автозагрузка и именные предпочтения.
** [[Runtime environment|Runtime-окружение]] - Скриптовое описание для использования отдельных кадров клипа.
* [[Scripting reference|Руководство по скриптам]] - Выход за пределы базовых приемов написания скриптов.
** [[The full AviSynth grammar|Полное руководство по грамматике]] - Полное руководство по использованию AviSynth.
** [[The script execution model|Модель выполнения скриптов]] - The steps behind the scenes from the script to the final video clip output. The filter graph. Scope and lifetime of variables. Evaluation of runtime scripts.
** [[User functions|Функции пользователя]] - Как эффективно создавать пользовательские скриптовые функции; как избегать общих ошибок; способы организации ваших функций в коллекции, создание библиотек функций и многое другое.
** [[Block statements|Блоковые конструкции]] - Технические идиомы для создания блоков AviSynth-скриптов.
** [[Arrays|Массивы]] - Использование массивов (и соответствующих операторов) для управления наборами данных в один шаг.
** [[Scripting at runtime|Выполнение скриптов]] - Как раскрыть все возможности runtime фильтров и создавать комплексные скрипты, которые реализуют интересные (и эффективные по быстродействию) эффекты и операции.

=== FAQ, Руководства и дополнительные материалы ===

* [[AviSynth FAQ]] - Ответы на часто задаваемые вопросы.
* [[Aspect ratios|Пропорции клипов]] - Введение в соотношение сторон клипов (DAR, PAR, SAR), как правильно измененять размер исходных клипов.
* [[Guides|Руководства]] - Советы по конкретным типам конвертирования и общие задачи.
* [[Advanced topics|Дополнительные советы]] - Рассказывают о таких вещах как ошибка Chroma Upsampling, преобразование цветов, гибридное видео, компенсация движения и т.д.

== Разработка ==

* Хотите [[get involved|принять участие]]?
* Официальный [http://sourceforge.net/projects/avisynth2/ SourceForge] проект.
* О том, [[compile AviSynth|как откомпилировать AviSynth]] и плагины.
* [[Filter SDK]] - Советы по программированию AviSynth-плагинов.
* [http://forum.doom9.org/forumdisplay.php?s=&forumid=69 Форум разработчиков].
* Список [[changelist|последних изменений]].
* О разработке платформонезависимой [[AviSynth v3]].

== Wiki ==

Добро пожаловать на MediaWiki. Не стесняйтесь в наполнении данного сайта! Нам нужна Ваша помощь в наполнении данного Wiki-сайта. Ознакомьтесь с [http://meta.wikimedia.org/wiki/Помощь:Содержание руководством пользователя] по редактированию данного сайта.

== Авторские права на документацию ==

Права на документацию AviSynth (c) 2002-2007 принадлежат группе разработчиков AviSynth и других людей, сделавших вклад.

С 5 августа 2007 года информация на данном сайте публикуется под лицензией [http://creativecommons.org/licenses/by-sa/3.0/ CreativeCommons Attribution-ShareAlike 3.0 License] (сокращенно "CC BY-SA 3.0", см. [http://creativecommons.org/licenses/by-sa/3.0/legalcode полные правила лицензирования]). Перевод на русский: http://wiki.ccrussia.org/index.php?title=Attribution-ShareAlike_3.0_Unported_Commons_Deed . Дополнительная информация о правах доступна [[Avisynth:Copyrights|здесь]].

Template:Author/Fizick

2009-02-10T16:23:11Z

Fizick: nick is more famous name :)

[http://avisynth.org.ru/ Fizick (Alexander Balakhnin)]

ReduceBy2

2008-12-24T19:26:52Z

Fizick: performance related compromise

{{Template:Func3Def|HorizontalReduceBy2(clip ''clip'')|VerticalReduceBy2(clip ''clip'')|ReduceBy2(clip ''clip'')}}

HorizontalReduceBy2 reduces the horizontal size of each frame by half, and VerticalReduceBy2 reduces the vertical size by half. Chain them together (in either order) to reduce the whole image by half. You can also use the shorthand ReduceBy2, which is the same as HorizontalReduceBy2.VerticalReduceBy2.

The filter kernel used is (1/4,1/2,1/4), which is the same as in VirtualDub's "2:1 reduction (high quality)" filter. This avoids the aliasing problems that occur with a (1/2,1/2) kernel. VirtualDub's "resize" filter uses a third, fancier kernel for 2:1 reduction, but I experimented with it and found that it actually produced slightly worse-looking MPEG files--presumably because it sharpens edges slightly, and most codecs don't like sharp edges.

If your source video is interlaced, the VerticalReduceBy2 filter will deinterlace it (by field blending) as a side-effect. If you plan to produce output video in a size like320x240, I recommend that you capture at full interlaced vertical resolution (320x480) and use VerticalReduceBy2. You will get much better-looking output. My Huffyuv utility will compress captured video about 2:1, losslessly, so you can capture 320x480 in about the same space as it used to take to capture 320x240. (If your disk has the capacity and throughput to support it, you can even capture at 640x480 and use both HorizontalReduceBy2 and VerticalReduceBy2. But this won't improve the quality as much, and if you have to go to MotionJPEG to achieve 640x480, you're probably better off with Huffyuv at 320x480.)

Note that, it's a quick and dirty filter (performance related compromise). Unlike the standard [[resize]] filters, the ReduceBy2 filters do not preserve the position of the image center. It shifts color planes by half of pixel. In fact, ReduceBy2() is equivalent to:

BilinearResize(Width()/2, Height()/2, 0.5, -0.5) for RGB,

MergeChroma(BilinearResize(Width/2,Height/2,0.5,0.5),BilinearResize(Width/2,Height/2,1.0,1.0)) for YV12,

MergeChroma(BilinearResize(Width/2,Height/2,0.5,0.5),BilinearResize(Width/2,Height/2,1.0,0.5)) for YUY2.
[[Category:Internal filters]]

Добро пожаловать

2008-11-04T19:02:29Z

Fizick: эта ссылка есть выше

[http://sourceforge.net/project/showfiles.php?group_id=57023 Загрузить] | [[AviSynth FAQ]] | [[Internal filters|Внутренние фильтры]] | [[External filters|Внешние фильтры]] | [http://forum.doom9.org/forumdisplay.php?s=&forumid=33 Doom9 формум] | [http://sourceforge.net/projects/avisynth2/ Страница проекта] | [[Feedback|Обратная связь]]

Внимание: данная страница и сайт в целом переведены на русский язык далеко не полностью (то есть вообще не переведены). Имеющаяся команда переводчиков сосредоточила имеющиеся силы на переводе офф-лайновой документации, распространяющейся с дистрибутивом AviSynth (смотри сайт [http://avisynth.org.ru www.avisynth.org.ru]).

Однако вы можете переводить и дополнять статьи Wiki данного сайта самостоятельно (используя переведенные части офф-лайновой документации для единства стиля и терминов), добавляя к английским именам страниц окончание /ru (или создать страницы с русским именем - можно и то и другое с перенаправлением).

== Что такое AviSynth? ==

AviSynth - это мощное средство для пост-обработки видео. Он предоставляет методы для редактирования и обработки видео файлов. AviSynth работает как [[фрэймсервер]], обеспечивая мгновенное редактирования без необходимости временных файлов.

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

Заинтересовались? На этом сайте, вы можете читать [[more about AviSynth|больше об AviSynth]], исследовать официальное [[Internal filters|руководство по AviSynth]], и просмотреть [[AviSynth FAQ|частые вопросы и ответы]]. Или вы можете перейти прямо на [http://sourceforge.net/project/showfiles.php?group_id=57023 страницу загрузки] на [[SourceForge]]. AviSynth - свободно распространяемая программа с открытым кодом.

== Использование ==
=== Что нового в AviSynth - Начните с малого! ===

* [[first script|Ваш первый скрипт]] - Руководство для начинающих.
* [[Getting started|С чего начать]] - Краткая инструкция об использовании AviSynth.
* [[Filter introduction|Обзор фильтров]] - Краткий обзор наиболее часто используемых фильтров AviSynth.
* [[Script examples|Примеры скриптов]] - Несколько примеров, используемых во всем Мире.
* Несколько руководств, разъясняющих использование AviSynth:
** [http://www.doom9.org/capture/postprocessing_avisynth.html Руководство захвата аналогового сигнала]. The AviSynth part of the capture guide is about what filters can be used to enhance the quality of the capture. It discusses things like deinterlacing, denoising, cropping and resizing and color adjustment. Which makes it really useful to learn about some of the capabilities of AviSynth in a schematic way.
** [http://www.animemusicvideos.org/guides/avtech/avisyntha.html Введение в AviSynth от AnimeMusicVideos.org]. Простая инструкция, описывающая деинтерлизинг, изменение размера и некоторые другие базовые действия.
** [http://www.animemusicvideos.org/guides/avtech/avspostqual.html Введение в фильтры AviSynth от AnimeMusicVideos.org]. Простая инструкция, описывающая фильтры сглаживания, удаления муара, повышения резкости, управления цветом и некоторых других.
* [[Troubleshooting|Обнаружение проблем]] в Ваших скриптах и конфигурации.

=== Фильтры, внешние плагины, скриптовые функции и утилиты ===

* [[Internal filters|Внутренние фильтры]] - Официальный список включенных в AviSynth фильтров с описанием, сгруппированный по категориям.
* [[External filters|Внешние фильтры]] - Документация некоторых скриптовых функций и плагинов для AviSynth версии 2.5x.
** [[External plugins old|Внешние плагины (устар.)]] - Документация по плагинам AviSynth версий v1.0x/v2.0x (устаревшие плагины, однако некоторые из них по прежнему могут быть использованы).
* [http://www.avisynth.org/warpenterprises/ Коллекция плагинов AviSynth] собранная WarpEnterprises.
* [[Shared functions|Общие фукнции]] - Полезные скриптовые функции.
* [[Utilities]] - Список GUIs, командных, групповых и других AviSynth-утилит.

=== Синтаксис AviSynth-скрипта ===

* [[AviSynth Syntax|Синтаксис]] - Официальная документация.
** [[Grammar|Грамматика]] - Грамматика скриптового языка AviSynth. Введение в скриптовый язык AviSynth.
** [[Script variables|Переменные]] - Как объявлять и использовать их в скриптах.
** [[Operators|Операторы]] - Допустимые операторы и их приоритет.
** [[Clip properties|Свойства клипа]] - Функции, возвращающие свойства клипа.
** [[Control structures|Структуры управления]] - Языковые конструкции управления потоком.
** [[Internal functions|Встроенные функции]] - Ready-made non-clip функции для использования в скриптах.
** [[User defined script functions|Определяемые пользователем скриптовые функции]] - Как их объявлять и использовать.
** [[Plugins|Плагины]] - Как подключать плагины AviSynth, VirtualDub, VFAPI и C-плагины, их автозагрузка и именные предпочтения.
** [[Runtime environment|Runtime-окружение]] - Скриптовое описание для использования отдельных кадров клипа.
* [[Scripting reference|Руководство по скриптам]] - Выход за пределы базовых приемов написания скриптов.
** [[The full AviSynth grammar|Полное руководство по грамматике]] - Полное руководство по использованию AviSynth.
** [[The script execution model|Модель выполнения скриптов]] - The steps behind the scenes from the script to the final video clip output. The filter graph. Scope and lifetime of variables. Evaluation of runtime scripts.
** [[User functions|Функции пользователя]] - Как эффективно создавать пользовательские скриптовые функции; как избегать общих ошибок; способы организации ваших функций в коллекции, создание библиотек функций и многое другое.
** [[Block statements|Блоковые конструкции]] - Технические идиомы для создания блоков AviSynth-скриптов.
** [[Arrays|Массивы]] - Использование массивов (и соответствующих операторов) для управления наборами данных в один шаг.
** [[Scripting at runtime|Выполнение скриптов]] - Как раскрыть все возможности runtime фильтров и создавать комплексные скрипты, которые реализуют интересные (и эффективные по быстродействию) эффекты и операции.

=== FAQ, Руководства и дополнительные материалы ===

* [[AviSynth FAQ]] - Ответы на часто задаваемые вопросы.
* [[Aspect ratios|Пропорции клипов]] - Введение в соотношение сторон клипов (DAR, PAR, SAR), как правильно измененять размер исходных клипов.
* [[Guides|Руководства]] - Советы по конкретным типам конвертирования и общие задачи.
* [[Advanced topics|Дополнительные советы]] - Рассказывают о таких вещах как ошибка Chroma Upsampling, преобразование цветов, гибридное видео, компенсация движения и т.д.

== Разработка ==

* Хотите [[get involved|принять участие]]?
* Официальный [http://www.avisynth.org/SourceForge SourceForge] проект.
* О том, [[compile AviSynth|как откомпилировать AviSynth]] и плагины.
* [[Filter SDK]] - Советы по программированию AviSynth-плагинов.
* [http://forum.doom9.org/forumdisplay.php?s=&forumid=69 Форум разработчиков].
* Список [[changelist|последних изменений]].
* О разработке платформонезависимой [[AviSynth v3]].

== Wiki ==

Добро пожаловать на MediaWiki. Не стесняйтесь в наполнении данного сайта! Нам нужна Ваша помощь в наполнении данного Wiki-сайта. Ознакомьтесь с [http://meta.wikimedia.org/wiki/Помощь:Содержание руководством пользователя] по редактированию данного сайта.

== Авторские прова на документацию ==

Права на документацию AviSynth (c) 2002-2007 принадлежат группе разработчиков AviSynth и других людей, сделавших вклад.

С 5 августа 2007 года информация на данном сайте публикуется под лицензией [http://creativecommons.org/licenses/by-sa/3.0/ CreativeCommons Attribution-ShareAlike 3.0 License] (сокращенно "CC BY-SA 3.0", см. [http://creativecommons.org/licenses/by-sa/3.0/legalcode полные правила лицензирования]). Перевод на русский: http://wiki.ccrussia.org/index.php?title=Attribution-ShareAlike_3.0_Unported_Commons_Deed . Дополнительная информация о правах доступна [[Avisynth:Copyrights|здесь]].

Добро пожаловать

2008-11-04T19:00:39Z

Fizick: russian link

[http://sourceforge.net/project/showfiles.php?group_id=57023 Загрузить] | [[AviSynth FAQ]] | [[Internal filters|Внутренние фильтры]] | [[External filters|Внешние фильтры]] | [http://forum.doom9.org/forumdisplay.php?s=&forumid=33 Doom9 формум] | [http://sourceforge.net/projects/avisynth2/ Страница проекта] | [[Feedback|Обратная связь]]

Внимание: данная страница и сайт в целом переведены на русский язык далеко не полностью (то есть вообще не переведены). Имеющаяся команда переводчиков сосредоточила имеющиеся силы на переводе офф-лайновой документации, распространяющейся с дистрибутивом AviSynth (смотри сайт [http://avisynth.org.ru www.avisynth.org.ru]).

Однако вы можете переводить и дополнять статьи Wiki данного сайта самостоятельно (используя переведенные части офф-лайновой документации для единства стиля и терминов), добавляя к английским именам страниц окончание /ru (или создать страницы с русским именем - можно и то и другое с перенаправлением).

== Что такое AviSynth? ==

AviSynth - это мощное средство для пост-обработки видео. Он предоставляет методы для редактирования и обработки видео файлов. AviSynth работает как [[фрэймсервер]], обеспечивая мгновенное редактирования без необходимости временных файлов.

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

Заинтересовались? На этом сайте, вы можете читать [[more about AviSynth|больше об AviSynth]], исследовать официальное [[Internal filters|руководство по AviSynth]], и просмотреть [[AviSynth FAQ|частые вопросы и ответы]]. Или вы можете перейти прямо на [http://sourceforge.net/project/showfiles.php?group_id=57023 страницу загрузки] на [[SourceForge]]. AviSynth - свободно распространяемая программа с открытым кодом.

== Использование ==
=== Что нового в AviSynth - Начните с малого! ===

* [[first script|Ваш первый скрипт]] - Руководство для начинающих.
* [[Getting started|С чего начать]] - Краткая инструкция об использовании AviSynth.
* [[Filter introduction|Обзор фильтров]] - Краткий обзор наиболее часто используемых фильтров AviSynth.
* [[Script examples|Примеры скриптов]] - Несколько примеров, используемых во всем Мире.
* Несколько руководств, разъясняющих использование AviSynth:
** [http://www.doom9.org/capture/postprocessing_avisynth.html Руководство захвата аналогового сигнала]. The AviSynth part of the capture guide is about what filters can be used to enhance the quality of the capture. It discusses things like deinterlacing, denoising, cropping and resizing and color adjustment. Which makes it really useful to learn about some of the capabilities of AviSynth in a schematic way.
** [http://www.animemusicvideos.org/guides/avtech/avisyntha.html Введение в AviSynth от AnimeMusicVideos.org]. Простая инструкция, описывающая деинтерлизинг, изменение размера и некоторые другие базовые действия.
** [http://www.animemusicvideos.org/guides/avtech/avspostqual.html Введение в фильтры AviSynth от AnimeMusicVideos.org]. Простая инструкция, описывающая фильтры сглаживания, удаления муара, повышения резкости, управления цветом и некоторых других.
* [[Troubleshooting|Обнаружение проблем]] в Ваших скриптах и конфигурации.

=== Фильтры, внешние плагины, скриптовые функции и утилиты ===

* [[Internal filters|Внутренние фильтры]] - Официальный список включенных в AviSynth фильтров с описанием, сгруппированный по категориям.
* [[External filters|Внешние фильтры]] - Документация некоторых скриптовых функций и плагинов для AviSynth версии 2.5x.
** [[External plugins old|Внешние плагины (устар.)]] - Документация по плагинам AviSynth версий v1.0x/v2.0x (устаревшие плагины, однако некоторые из них по прежнему могут быть использованы).
* [http://www.avisynth.org/warpenterprises/ Коллекция плагинов AviSynth] собранная WarpEnterprises.
* [[Shared functions|Общие фукнции]] - Полезные скриптовые функции.
* [[Utilities]] - Список GUIs, командных, групповых и других AviSynth-утилит.

=== Синтаксис AviSynth-скрипта ===

* [[AviSynth Syntax|Синтаксис]] - Официальная документация.
** [[Grammar|Грамматика]] - Грамматика скриптового языка AviSynth. Введение в скриптовый язык AviSynth.
** [[Script variables|Переменные]] - Как объявлять и использовать их в скриптах.
** [[Operators|Операторы]] - Допустимые операторы и их приоритет.
** [[Clip properties|Свойства клипа]] - Функции, возвращающие свойства клипа.
** [[Control structures|Структуры управления]] - Языковые конструкции управления потоком.
** [[Internal functions|Встроенные функции]] - Ready-made non-clip функции для использования в скриптах.
** [[User defined script functions|Определяемые пользователем скриптовые функции]] - Как их объявлять и использовать.
** [[Plugins|Плагины]] - Как подключать плагины AviSynth, VirtualDub, VFAPI и C-плагины, их автозагрузка и именные предпочтения.
** [[Runtime environment|Runtime-окружение]] - Скриптовое описание для использования отдельных кадров клипа.
* [[Scripting reference|Руководство по скриптам]] - Выход за пределы базовых приемов написания скриптов.
** [[The full AviSynth grammar|Полное руководство по грамматике]] - Полное руководство по использованию AviSynth.
** [[The script execution model|Модель выполнения скриптов]] - The steps behind the scenes from the script to the final video clip output. The filter graph. Scope and lifetime of variables. Evaluation of runtime scripts.
** [[User functions|Функции пользователя]] - Как эффективно создавать пользовательские скриптовые функции; как избегать общих ошибок; способы организации ваших функций в коллекции, создание библиотек функций и многое другое.
** [[Block statements|Блоковые конструкции]] - Технические идиомы для создания блоков AviSynth-скриптов.
** [[Arrays|Массивы]] - Использование массивов (и соответствующих операторов) для управления наборами данных в один шаг.
** [[Scripting at runtime|Выполнение скриптов]] - Как раскрыть все возможности runtime фильтров и создавать комплексные скрипты, которые реализуют интересные (и эффективные по быстродействию) эффекты и операции.

=== FAQ, Руководства и дополнительные материалы ===

* [[AviSynth FAQ]] - Ответы на часто задаваемые вопросы.
* [[Aspect ratios|Пропорции клипов]] - Введение в соотношение сторон клипов (DAR, PAR, SAR), как правильно измененять размер исходных клипов.
* [[Guides|Руководства]] - Советы по конкретным типам конвертирования и общие задачи.
* [[Advanced topics|Дополнительные советы]] - Рассказывают о таких вещах как ошибка Chroma Upsampling, преобразование цветов, гибридное видео, компенсация движения и т.д.

== Разработка ==

* Хотите [[get involved|принять участие]]?
* Официальный [http://www.avisynth.org/SourceForge SourceForge] проект.
* О том, [[compile AviSynth|как откомпилировать AviSynth]] и плагины.
* [[Filter SDK]] - Советы по программированию AviSynth-плагинов.
* [http://forum.doom9.org/forumdisplay.php?s=&forumid=69 Форум разработчиков].
* Список [[changelist|последних изменений]].
* О разработке платформонезависимой [[AviSynth v3]].

== Wiki ==

Добро пожаловать на MediaWiki. Не стесняйтесь в наполнении данного сайта! Нам нужна Ваша помощь в наполнении данного Wiki-сайта. Ознакомьтесь с [http://meta.wikimedia.org/wiki/Помощь:Содержание руководством пользователя] по редактированию данного сайта.

== Авторские прова на документацию ==

Права на документацию AviSynth (c) 2002-2007 принадлежат группе разработчиков AviSynth и других людей, сделавших вклад.

С 5 августа 2007 года информация на данном сайте публикуется под лицензией [http://creativecommons.org/licenses/by-sa/3.0/ CreativeCommons Attribution-ShareAlike 3.0 License] (сокращенно "CC BY-SA 3.0", см. [http://creativecommons.org/licenses/by-sa/3.0/legalcode полные правила лицензирования]). Перевод на русский: http://wiki.ccrussia.org/index.php?title=Attribution-ShareAlike_3.0_Unported_Commons_Deed . Дополнительная информация о правах доступна [[Avisynth:Copyrights|здесь]].

См. так же: [http://www.avisynth.org/warpenterprises/ Большая коллекция плагинов]

Добро пожаловать

2008-09-22T15:37:53Z

Fizick: you may use offline doc

[http://sourceforge.net/project/showfiles.php?group_id=57023 Download] | [[AviSynth FAQ]] | [[Internal filters]] | [[External filters]] - [http://www.avisynth.org/warpenterprises/ download] | [http://forum.doom9.org/forumdisplay.php?s=&forumid=33 Doom9 forum] | [http://sourceforge.net/projects/avisynth2/ Project page] | [[Feedback]]

Внимание: данная страница и сайт в целом переведены на русский язык далеко не полностью (то есть вообще не переведены). Имеющаяся команда переводчиков сосредоточила имеющиеся силы на переводе офф-лайновой документации, распространяющейся с дистрибутивом AviSynth (смотри сайт [http://avisynth.org.ru www.avisynth.org.ru]).

Однако вы можете переводить и дополнять статьи Wiki данного сайта самостоятельно (используя переведенные части офф-лайновой документации для единства стиля и терминов), добавляя к английским именам страниц окончание /ru (или создать страницы с русским именем - можно и то и другое с перенаправлением).

== Что такое AviSynth? ==

AviSynth - это мощное средство для пост-обработки видео. Он предоставляет методы для редактирования и обработки видео файлов. AviSynth работает как [[frameserver|фреймсервер]], обеспечивая мгновенное редактирования без необходимости временных файлов.

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

Заинтересовались? На этом сайте, вы можете читать [[more about AviSynth|больше об AviSynth]], исследовать официальное [[Internal filters|руководство по AviSynth]], и просмотреть [[AviSynth FAQ|частые вопросы и ответы]]. Или вы можете перейти прямо на [http://sourceforge.net/project/showfiles.php?group_id=57023 страницу загрузки] на [[SourceForge]]. AviSynth - свободно распространяемая программа с открытым кодом.

== Использование ==
=== Что нового в AviSynth - Начните отсюда! ===

* [[first script|Ваш первый скрипт]] - Руководство для начинающих.
* [[Getting started|С чего начать]] - Краткая инструкция об использовании AviSynth.
* [[Filter introduction|Обзор фильтров]] - Краткий обзор наиболее часто используемых фильтров AviSynth.
* [[Script examples|Примеры скриптов]] - Несколько примеров, используемых во всем Мире.
* Несколько руководств, разъясняющих использование AviSynth:
** [http://www.doom9.org/capture/postprocessing_avisynth.html Руководство захвата аналогового сигнала]. The AviSynth part of the capture guide is about what filters can be used to enhance the quality of the capture. It discusses things like deinterlacing, denoising, cropping and resizing and color adjustment. Which makes it really useful to learn about some of the capabilities of AviSynth in a schematic way.
** [http://www.animemusicvideos.org/guides/avtech/avisyntha.html Введение в AviSynth от AnimeMusicVideos.org]. Простая инструкция, описывающая деинтерлизинг, изменение размера и некоторые другие базовые действия.
** [http://www.animemusicvideos.org/guides/avtech/avspostqual.html Введение в фильтры AviSynth от AnimeMusicVideos.org]. Простая инструкция, описывающая фильтры сглаживания, удаления муара, повышения резкости, управления цветом и некоторых других.
* [[Troubleshooting|Обнаружение проблем]] в Ваших скриптах и конфигурации.

=== Фильтры, внешние плагины, скриптовые функции и утилиты ===

* [[Internal filters|Внутренние фильтры]] - Официальный список включенных в AviSynth фильтров с описанием, сгруппированный по категориям.
* [[External filters|Внешние фильтры]] - Документация некоторых скриптовых функций и плагинов для AviSynth версии 2.5x.
** [[External plugins old|Внешние плагины (устар.)]] - Документация по плагинам AviSynth версий v1.0x/v2.0x (устаревшие плагины, однако некоторые из них по прежнему могут быть использованы).
* [http://www.avisynth.org/warpenterprises/ Коллекция плагинов AviSynth] собранная WarpEnterprises.
* [[Shared functions|Общие фукнции]] - Полезные скриптовые функции.
* [[Utilities]] - Список GUIs, командных, групповых и других AviSynth-утилит.

=== AviSynth Синтаксис ===

* [[AviSynth Syntax|Синтаксис]] - The official reference documentation.
** [[Grammar|Грамматика]] - The grammar of AviSynth script language. An introduction to AviSynth scripting.
** [[Script variables|Переменные]] - How to declare and use them in scripts.
** [[Operators|Операторы]] - Available operators and relative precedence.
** [[Clip properties|Свойства клипа]] - Functions that return a property of a clip.
** [[Control structures|Структуры управления]] - Language constructs for script flow control.
** [[Internal functions|Встроенные функции]] - Ready-made non-clip functions to use in scripts.
** [[User defined script functions|Определяемые пользователем скриптовые функции]] - How to define and use them in scripts.
** [[Plugins|Плагины]] - How to load plugins (AviSynth, VirtualDub, VFAPI and C-plugins), autoloading and name-precedence.
** [[Runtime environment|Runtime-окружение]] - Scripting on a per clip frame basis.
* [[Scripting reference|Руководство по скриптам]] - Beyond scripting basics.
** [[The full AviSynth grammar|Полное руководство по грамматике]] - The AviSynth grammar revisited and explained in detail.
** [[The script execution model|Модель выполнения скриптов]] - The steps behind the scenes from the script to the final video clip output. The filter graph. Scope and lifetime of variables. Evaluation of runtime scripts.
** [[User functions|Функции пользователя]] - How to effectively write and invoke user defined script functions; common pitfalls to avoid; ways to organise your function collection and create libraries of functions, and many more.
** [[Block statements|Состояния блоков (?)]] - Techniques and coding idioms for creating blocks of AviSynth script statements.
** [[Arrays|Массивы]] - Using arrays (and array operators) for manipulating collections of data in a single step.
** [[Scripting at runtime|Выполнение скриптов]] - How to unravel the power of runtime filters and create complex runtime scripts that can perform interesting (and memory/speed efficient) editing/processing operations and effects.

Main Page/de

2008-07-22T20:06:17Z

Fizick: framserver/de

Strona główna

2008-07-22T19:57:37Z

Fizick: /* FAQ, przewodniki i zaawansowane zagadnienia */

Najczęściej zadawane pytania

2008-07-22T19:56:48Z

Fizick: cancel redirection

== Informacje ogólne ==

[[FAQ informacje ogólne|Ta strona]] zawiera pewne ogólne informacje dotyczące AviSynth. Opisuje jego historię i różne wersje krążące po internecie. Wyjaśnia, jak rozpocząć z nim pracę, jak tworzyć skrypty i używać pluginów. Omawia także niektóre z tekstowych i graficznych narzędzi obsługujących skrypty AviSynth.

== Wczytywanie klipów (wideo, audio i pojedynczych obrazków) do AviSynth ==

[[FAQ wczytywanie plików|Ta strona]] wyjaśnia, jak zaimportować powszechnie używane formaty multimediów do AviSynth. Mówi o tym, których z wbudowanych filtrów bądź zewnętrznych pluginów możesz do tego użyć, oraz o tym jak ich użyć. Znajdziesz tam omówienie wielu formatów i sposobów na wczytanie ich do AviSynth.

== Odtwarzanie lub kodowanie skryptów ==

[[FAQ serwowanie klatek|Ta strona]] opisuje ''frameserving'' - serwowanie klatek z i do AviSynth. Wyjaśnia, jak wczytywać skrypty AviSynth do wspieranych enkoderów i odtwarzaczy, oraz co zrobić, gdy skrypty nie są wspierane.

== Pospolite komunikaty błędów ==

[[FAQ częste błędy|Ta strona]] opisuje pewne często spotykane komunikaty błędów, oraz wyjaśnia, co zrobić by ich więcej nie spotkać.

== Różne rodzaje materiału źródłowego ==

[[FAQ rodzaje materiału źródłowego|Ta strona]] mówi, co należy zrobić gdy w finalnym pliku ścieżki audio i wideo nie są zsynchronizowane. Omawia wideo o zmiennym FPS (VFR). Wyjaśnia, jak rozpoznawać i pracować z obrazem progresywnym, przeplecionym, hybrydowym, poddanym telecine lub blendingowi.

== Format kolorów YV12 i związane z nim problemy ==

[[FAQ YV12/pl|Ta strona]] zawiera informacje o przestrzeni kolorów YV12 oraz problemach przy obróbce i kodowaniu związanych z jej używaniem.

== Używanie w AviSynth pluginów VirtualDub ==

[[FAQ używanie pluginów VirtualDub|Ta strona]] wyjaśnia, jak podczas pracy z AviSynth możesz użyć pluginów napisanych do programu [http://www.virtualdub.org/ VirtualDub].

Добро пожаловать

2008-07-18T07:41:37Z

Fizick: some Russian text. Wilbert, please change link to this page at mainpage

GreyScale

2008-01-09T23:23:33Z

Fizick: yv12

{{Template:FuncDef|Greyscale(clip ''clip'' [, string ''matrix''])}}

Converts the input clip to greyscale (without changing the color format).

In YCbCr based formats (YUY2, YV12), the chroma channels are set to 128. In RGB based formats, the conversion produces the luma using the coefficients given in the ''matrix'' parameter (rec601 by default, which reflects the behaviour in old AviSynth versions). This option is added in v2.56. When setting ''matrix''="rec709", the clip is converted to greyscale using Rec.709 coefficients. When setting ''matrix''="Average" the luma is calculated as (R+G+B)/3. See [[Color conversions]] for an explanation of these coefficients.

[[Category:Internal filters]]

Filter SDK/Getting started with audio

2007-12-01T19:25:43Z

Fizick: sync with offline IanB's fixes

The best filters to take a look at if you are searching for a way to get started with an audio filter is the [http://avisynth2.cvs.sourceforge.net/avisynth2/avisynth/src/audio/ internal audio filters] of AviSynth. Mainly [http://avisynth2.cvs.sourceforge.net/avisynth2/avisynth/src/audio/audio.cpp?view=markup audio.cpp] is interesting.

Basically you override GetAudio(...) instead of GetFrame, and fill the buffer with data. A simple filter could look like this:

'''Filter creation - skip if no audio:'''

AVSValue __cdecl HalfVolume::Create(AVSValue args, void*, IScriptEnvironment* env) {
if (!args[0].AsClip()->GetVideoInfo().AudioChannels())
return args[0];

return new HalfVolume(args[0].AsClip());
}

'''Constructor:'''

HalfVolume::HalfVolume(PClip _child)
: GenericVideoFilter(ConvertAudio::Create(_child, SAMPLE_INT16 | SAMPLE_FLOAT, SAMPLE_FLOAT)) {
}

This is a bit tricky. It'll require you to include [http://avisynth2.cvs.sourceforge.net/avisynth2/avisynth/src/audio/convertaudio.cpp?view=markup convertaudio.cpp]. What it does is automatic sample type conversion. Basically what it does is that you tell that your filter ''supports'' SAMPLE_INT16 and SAMPLE_FLOAT, and that it ''prefers'' SAMPLE_FLOAT. If the input isn't 16 bit or float, it'll be converted to float.

'''GetAudio override:'''

void __stdcall HalfVolume::GetAudio(void* buf, __int64 start, __int64 count, IScriptEnvironment* env) {
child->GetAudio(buf, start, count, env);
int channels = vi.AudioChannels();

if (vi.SampleType() == SAMPLE_INT16) {
short* samples = (short*)buf;
for (int i=0; i<count; i++) {
for(int j=0;j<channels;j++) {
samples[i*channels+j] /= 2;
}
}
} else if (vi.SampleType() == SAMPLE_FLOAT) {
SFLOAT* samples = (SFLOAT*)buf;
for (int i=0; i<count; i++) {
for(int j=0;j<channels;j++) {
samples[i*channels+j] /= 2.0f;
}
}
}
}

Implementation of a half volume filter. Very explicit, so it isn't going to be the fastest possible, but it should serve the purpose. Furthermore have a look [http://forum.doom9.org/showthread.php?s=&threadid=72760&highlight=ConvertAudio here] and look also at [http://avisynth2.cvs.sourceforge.net/avisynth2/avisynth/src/audio/audio.cpp?view=markup audio.cpp] for a bunch of more advanced stuff. A lot of technical details are also to be found in AviSynth [[Filter_SDK/Two-Five_Audio|Two-Five Audio]].

Back to [[Filter_SDK|Filter SDK]].

[[Category:FilterSDK]]

Filter SDK

2007-11-25T11:11:22Z

Fizick: added non-clip

AviSynth external Filter SDK is a package for developers to create your own filters (plugins) for AviSynth.

The package consists of:

* this documentation text files (in HTML or Wiki format);
* the header file 'avisynth.h' (recent version) with all declarations to include in plugin source code;
* SimpleSample plugin source codes;
* may be some extra files in 'Extra' folder.

You must have some [[Filter_SDK/SDK_necessaries|necessary software]].

[[Filter_SDK/Ben_docs|Ben's AviSynth Docs]] is the documentation written for AviSynth 1.0 by Ben Rudiak-Gould, in its original form.

See more about the modifications for AviSynth 2.5 in the [[Filter_SDK/Two-Five_SDK|AviSynth Two-Five SDK]].

Also, [[Filter_SDK/Simple_sample|Simple sample]] has some very simple examples covering development of a filter that does virtually nothing through to one that draws a variable sized square, in the middle of the screen, in all [[Color_spaces|Color spaces]].

One thing not covered in [[Filter_SDK/Simple_sample|Simple sample]], is how to [[Filter_SDK/Change_frame_size|change frame size]] in a filter. Also have a look at [[Filter_SDK/Getting_started_with_audio|Getting started with Audio]].

See [[Filter_SDK/Non-clip_sample|Non-clip sample]] how to create runtime AviSynth functions.

There are several different Colorspaces in AviSynth. See more information about [[Color_spaces|Color spaces]] and [[Filter_SDK/Working_with_images|Working with Images]].

Read more about the [[Filter_SDK/Internal_functions|Internal Functions]] in AviSynth.

You can also browse various topic on [[Filter_SDK/Assembler_optimizing|Assembler Optimizing]].

Once you've got the basics down on AVS development (Ben's text is quite good), the [http://virtualdub.org/filtersdk SDK] for [[VirtualDub]] is also a good read. Good news is you won't have to worry about writing [http://function-pointer.org function pointers] and [http://www.charlespetzold.com/pw5/index.html raw Win32]; meanwhile, Avery knows his stuff when it comes to video & CPU optimization techniques, so you better pay attention.

Some video related ebooks (PDF) can be downloaded freely from [http://www.snellwilcox.com/reference.html Snell & Wilcox].

Please read AviSynth [[Filter_SDK/SDK_history|SDK History]].

----

Note: Avisynth Filter SDK parts are under specific [[Filter_SDK/SDK_license|SDK license terms]].

[[Category:FilterSDK]]

Filter SDK/Data alignment

2007-09-27T17:21:19Z

Fizick: Undo revision 3771 by Special:Contributions/195.55.130.44 (User talk:195.55.130.44)

(Until something more AviSynth related can be written this is from the [[Filter_SDK/AMD_optimization_guide|AMD Optimization Guide]])

== Memory alignment ==

In general, avoid misaligned data references. All data whose size is a power of two is considered aligned if it is naturally aligned. For example:

* Word accesses are aligned if they access an address divisible by two.
* Doubleword accesses are aligned if they access an address divisible by four.
* Quadword accesses are aligned if they access an address divisible by eight.
* TBYTE accesses are aligned if they access an address divisible by eight.

In AviSynth each frame is most of the time aligned to an address divideable by 16. The exception for this rule is when crop() has been used. Furthermore each line is also most of the time aligned to an address divideable by 16 (or 8 for planar chroma).

== Store to Load Forwarding ==

Whenever some data is written to memory it is put in the cache. It is however possible for the processor to access this data quite fast after it has been written. This is called Store To Load forwarding.

Avoid memory-size mismatches when different instructions operate on the same data. When an instruction stores and another instruction reloads the same data, keep their operands aligned and keep the loads/stores of each operand the same size.

The following code examples result in a store-to-load-forwarding (STLF) stall:

'''Example (avoid):'''

MOV [FOO], EAX
MOV [FOO+4], EDX
...
MOVQ MM0, [FOO]

'''Example (preferred):'''

MOV [FOO], EAX
MOV [FOO+4], EDX
...
MOVD MM0, [FOO]
PUNPCKLDQ MM0, [FOO+4]

'''Example (avoid):'''

MOVQ [foo], MM0
...
MOV EAX, [foo]
MOV EDX, [foo+4]

'''Example (preferred):'''

MOVD [foo], MM0
PSWAPD MM0, MM0
MOVD [foo+4], MM0
PSWAPD MM0, MM0
...
MOV EAX, [foo]
MOV EDX, [foo+4]

----
Back to [[Filter_SDK/Assembler_optimizing|Assembler Optimizing]].

[[Category:FilterSDK]]

SelectOdd

2007-09-27T17:20:51Z

Fizick: Undo revision 3772 by Special:Contributions/222.240.208.14 (User talk:222.240.208.14)

#REDIRECT [[Select]] [[Category:Internal filters]]

ISSE

2007-09-27T17:17:09Z

Fizick: Undo revision 3781 by Special:Contributions/74.231.24.2 (User talk:74.231.24.2)

Integer SSE is a set of instructions found in most modern processors. Integer SSE is an extension of [[MMX]]. Actually, Integer SSE is a ''subset'' of the [[SSE]] command set, mostly used for video processing. These instructions are also present in AMD Athlon (all versions), AMD Duron (all versions).

Integer SSE instructions:

:'''MASKMOVQ''' ''mmreg1, mmreg2''
:'''MOVNTQ''' ''mem64, mmreg''
:'''PAVGB''' ''mmreg1, mmreg2''
:'''PAVGB''' ''mmreg, mem64''
:'''PAVGW''' ''mmreg1, mmreg2''
:'''PAVGW''' ''mmreg, mem64''
:'''PEXTRW''' ''reg32, mmreg, imm8''
:'''PINSRW''' ''mmreg, reg32, imm8''
:'''PINSRW''' ''mmreg, mem16, imm8''
:'''PMAXSW''' ''mmreg1, mmreg2''
:'''PMAXSW''' ''mmreg, mem64''
:'''PMAXUB''' ''mmreg1, mmreg2''
:'''PMAXUB''' ''mmreg, mem64''
:'''PMINSW''' ''mmreg1, mmreg2''
:'''PMINSW''' ''mmreg, mem64''
:'''PMINUB''' ''mmreg1, mmreg2''
:'''PMINUB''' ''mmreg, mem64''
:'''PMOVMSKB''' ''reg32, mmreg''
:'''PMULHUW''' ''mmreg1, mmreg2''
:'''PMULHUW''' ''mmreg, mem64''
:'''PSADBW''' ''mmreg1, mmreg2''
:'''PSADBW''' ''mmreg, mem64''
:'''PSHUFW''' ''mmreg1, mmreg2, imm8''
:'''PSHUFW''' ''mmreg, mem64, imm8''
:'''PREFETCHNTA''' ''mem8''
:'''PREFETCHT0''' ''mem8''
:'''PREFETCHT1''' ''mem8''
:'''PREFETCHT2''' ''mem8''
:'''SFENCE'''

Related links:
* [[Filter_SDK/Assembler_optimizing|Filter SDK: Assembler optimizing]]

[[Category:Glossary]]
[[Category:FilterSDK]]

SelectEvery

2007-09-27T17:16:51Z

Fizick: Undo revision 3782 by Special:Contributions/217.169.44.14 (User talk:217.169.44.14)

#REDIRECT [[Select]] [[Category:Internal filters]]

Filter SDK/Simple sample 1.4

2007-09-27T17:16:32Z

Fizick: Undo revision 3783 by Special:Contributions/195.55.130.44 (User talk:195.55.130.44)

SimpleSample 1.4:

/*
SimpleSample plugin for Avisynth -- a simple sample

Copyright (C) 2002-2003 Simon Walters, All Rights Reserved

This program is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License for more details.

You should have received a copy of the GNU General Public License
along with this program; if not, write to the Free Software
Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.

The author can be contacted at:
Simon Walters
siwalters@hotmail.com

V1.0 - 1st release.
V1.0a - Revised version to put colourspace checking in the right place.
V1.0b - Added detailed comments. // sh0dan
V1.1 - Added sh0dan's planar (YV12) code
V1.2 - Revert to RGB24 colourspace only to show simple pixel manipulation;
V1.3 - add in a parameter to vary the size of the square.
V1.4 - Add in RGB32 colourspace code

*/
//following 2 includes needed
#include "windows.h"
#include "avisynth.h"

/****************************
* The following is the header definitions.
* For larger projects, move this into a .h file
* that can be included.
****************************/

class SimpleSample : public GenericVideoFilter {
// SimpleSample defines the name of your filter class.
// This name is only used internally, and does not affect the name of your filter or similar.
// This filter extends GenericVideoFilter, which incorporates basic functionality.
// All functions present in the filter must also be present here.
int SquareSize;

public:
// This defines that these functions are present in your class.
// These functions must be that same as those actually implemented.
// Since the functions are "public" they are accessible to other classes.
// Otherwise they can only be called from functions within the class itself.

SimpleSample(PClip _child, int _SquareSize, IScriptEnvironment* env);
// This is the constructor. It does not return any value, and is always used,
// when an instance of the class is created.
// Since there is no code in this, this is the definition.

~SimpleSample();
// The is the destructor definition. This is called when the filter is destroyed.

PVideoFrame __stdcall GetFrame(int n, IScriptEnvironment* env);
// This is the function that AviSynth calls to get a given frame.
// So when this functions gets called, the filter is supposed to return frame n.
};

/***************************
* The following is the implementation
* of the defined functions.
***************************/

//Here is the acutal constructor code used
SimpleSample::SimpleSample(PClip _child, int _SquareSize, IScriptEnvironment* env) :
GenericVideoFilter(_child), SquareSize(_SquareSize) {
// This is the implementation of the constructor.
// The child clip (source clip) is inherited by the GenericVideoFilter,
// where the following variables gets defined:
// PClip child; // Contains the source clip.
// VideoInfo vi; // Contains videoinfo on the source clip.
if (!vi.IsRGB()) // is input not RGB (24 or 32)
env->ThrowError("SimpleSample: input to filter must be in an RGB colourspace");
}

// This is where any actual destructor code used goes
SimpleSample::~SimpleSample() {
// This is where you can deallocate any memory you might have used.
}

PVideoFrame __stdcall SimpleSample::GetFrame(int n, IScriptEnvironment* env) {
// This is the implementation of the GetFrame function.
// See the header definition for further info.

PVideoFrame src = child->GetFrame(n, env);
// Request frame 'n' from the child (source) clip.
PVideoFrame dst = env->NewVideoFrame(vi);
// Construct a frame based on the information of the current frame
// contained in the "vi" struct.

const unsigned char* srcp = src->GetReadPtr();
// Request a Read pointer from the source frame.
// This will return the position of the upperleft pixel in YUY2 images,
// and return the lower-left pixel in RGB.
// RGB images are stored upside-down in memory.
// You should still process images from line 0 to height.

unsigned char* dstp = dst->GetWritePtr();
// Request a Write pointer from the newly created destination image.
// You can request a writepointer to images that have just been
// created by NewVideoFrame. If you recieve a frame from PClip->GetFrame(...)
// you must call env->MakeWritable(&frame) be recieve a valid write pointer.

const int dst_pitch = dst->GetPitch();
// Requests pitch (length of a line) of the destination image.
// For more information on pitch see: http://www.avisynth.org/index.php?page=WorkingWithImages
// (short version - pitch is always equal to or greater than width to allow for seriously fast assembly code)

const int dst_width = dst->GetRowSize();
// Requests rowsize (number of used bytes in a line.
// See the link above for more information.

const int dst_height = dst->GetHeight();
// Requests the height of the destination image.

const int src_pitch = src->GetPitch();
const int src_width = src->GetRowSize();
const int src_height = src->GetHeight();

int w, h;

// This version of SimpleSample is intended to show some simple pixel manipulation.
// It is designed purely for clarity and not as good or clever code :-)

if (vi.IsRGB24()) {
// The code just deals with RGB24 colourspace where each pixel is represented by
// 3 bytes, Blue, Green and Red.
// Although this colourspace is the easiest to understand, it is very rarely used because
// a 3 byte sequence (24bits) cannot be processed easily using normal 32 bit registers.

for (h=0; h < src_height;h++) { // Loop from bottom line to top line.
for (w = 0; w < src_width; w+=3) { // Loop from left side of the image to the right side 1 pixel (3 bytes) at a time
// stepping 3 bytes (a pixel width in RGB24 space)

*(dstp + w) = *(srcp + w); // Copy each Blue byte from source to destination.
*(dstp + w + 1) = *(srcp + w + 1); // Copy Green.
*(dstp + w + 2) = *(srcp + w + 2); // Copy Red
}

srcp = srcp + src_pitch; // Add the pitch (note use of pitch and not width) of one line (in bytes) to the source pointer
dstp = dstp + dst_pitch; // Add the pitch to the destination pointer.
}
// end copy src to dst

//Now draw a white square in the middle of the frame
// Normally you'd do this code within the loop above but here it is in a separate loop for clarity;

dstp = dst->GetWritePtr(); // reset the destination pointer to the bottom, left pixel. (RGB colourspaces only)
dstp = dstp + (dst_height/2 - SquareSize/2)*dst_pitch; // move pointer to SquareSize/2 lines from the middle of the frame;
for (h=0; h < SquareSize;h++) { // only scan 100 lines
for (w = dst_width/2 - SquareSize*3/2; w < dst_width/2 + SquareSize*3/2; w+=3) { // only scans the middle SquareSize pixels of a line
*(dstp + w) = 255; // Set Blue to maximum value.
*(dstp + w + 1) = 255; // and Green.
*(dstp + w + 2) = 255; // and Red - therefore the whole pixel is now white.
}
dstp = dstp + dst_pitch;
}
}

if (vi.IsRGB32()) {
// This code deals with RGB32 colourspace where each pixel is represented by
// 4 bytes, Blue, Green and Red and "spare" byte that could/should be used for alpha
// keying but usually isn't.

// Although this colourspace isn't memory efficient, code end ups running much
// quicker than RGB24 as you can deal with whole 32bit variables at a time
// and easily work directly and quickly in assembler (if you know how to that is :-)

for (h=0; h < src_height;h++) { // Loop from bottom line to top line.
for (w = 0; w < src_width/4; w+=1) { // and from leftmost pixel to rightmost one.
*((unsigned int *)dstp + w) = *((unsigned int *)srcp + w); // Copy each whole pixel from source to destination.
} // by temporarily treating the src and dst pointers as
// pixel pointers intead of byte pointers
srcp = srcp + src_pitch; // Add the pitch (note use of pitch and not width) of one line (in bytes) to the source pointer
dstp = dstp + dst_pitch; // Add the pitch to the destination pointer.
}
// end copy src to dst

//Now draw a white square in the middle of the frame
// Normally you'd do this code within the loop above but here it is in a separate loop for clarity;

dstp = dst->GetWritePtr(); // reset the destination pointer to the bottom, left pixel. (RGB colourspaces only)
dstp = dstp + (dst_height/2 - SquareSize/2)*dst_pitch; // move pointer to SquareSize/2 lines from the middle of the frame;

int woffset = dst_width/8 - SquareSize/2; // lets precalulate the width offset like we do for the lines.

for (h=0; h < SquareSize;h++) { // only scan SquareSize number of lines
for (w = 0; w < SquareSize; w+=1) { // only scans the middle SquareSize pixels of a line
*((unsigned int *)dstp + woffset + w) = 0x00FFFFFF; // Set Red,Green and Blue to maximum value in 1 instruction.
}
dstp = dstp + dst_pitch;
}
}

// As we now are finished processing the image, we return the destination image.
return dst;
}

// This is the function that created the filter, when the filter has been called.
// This can be used for simple parameter checking, so it is possible to create different filters,
// based on the arguments recieved.

AVSValue __cdecl Create_SimpleSample(AVSValue args, void* user_data, IScriptEnvironment* env) {
return new SimpleSample(args[0].AsClip(),
args[1].AsInt(0), // Corresponds to our 1st parameter - the size of the square in pixels.
env);
// Calls the constructor with the arguments provied.
}

// The following function is the function that actually registers the filter in AviSynth
// It is called automatically, when the plugin is loaded to see which functions this filter contains.

extern "C" __declspec(dllexport) const char* __stdcall AvisynthPluginInit2(IScriptEnvironment* env) {
env->AddFunction("SimpleSample", "c[SIZE]i", Create_SimpleSample, 0);
// The AddFunction has the following paramters:
// AddFunction(Filtername , Arguments, Function to call,0);

// Arguments is a string that defines the types and optional names of the arguments for you filter.
// c - Video Clip
// i - Integer number
// f - Float number
// s - String
// b - boolean

// The word inside the [ ] lets you used named parameters in your script
// e.g last=SimpleSample(last,size=100).
// but last=SimpleSample(last,100) will also work automagically

return "`SimpleSample' SimpleSample plugin";
// A freeform name of the plugin.
}

Back to [[Filter_SDK/Simple_sample|Simple Sample]]

[[Category:FilterSDK]]

RGB

2007-09-27T17:15:03Z

Fizick: Undo revision 3787 by Special:Contributions/74.231.24.2 (User talk:74.231.24.2)

RGB (from Red, Green, Blue) is a color model - or [[Color_spaces|color space]] - that consists of three primary colors (Red, Green and Blue, of course) which are added together at different proportions to create any other color. Thus RGB is an additive color model.

The number of bits used to provide R,G,B information (ie the color depth) determines the maximum number of color variations that can be represented by a specific RGB model. Typical values for modern video is 8 bits (one byte) for each R,G,B primary. Typical specific RGB formats for video are [[RGB32]] and [[RGB24]].

----
'''Related Links'''
* [http://en.wikipedia.org/wiki/RGB RGB Color Model at Wikipedia]
* [http://en.wikipedia.org/wiki/SRGB_color_space sRGB Colorspace]

[[Category:Glossary]]

Planar

2007-09-27T17:14:13Z

Fizick: Undo revision 3789 by Special:Contributions/74.231.24.2 (User talk:74.231.24.2)

Planar image format is a format for storing images where each color component needed to represent a pixel is placed ''at a separate place'' (block) in memory. This is in contrast with how [[interleaved]] images are stored in memory.

Some examples of planar image formats are [[YV12]], [[I420]].

----
Related links:
* [http://www.fourcc.org/fccyuv.htm#Planar%20YUV%20Formats Planar YUV Formats]
* [http://msdn.microsoft.com/library/default.asp?url=/library/en-us/dnwmt/html/YUVFormats.asp YUV Formats]

[[Category:Glossary]]
[[Category:FilterSDK]]

Spline64Resize

2007-09-27T17:13:51Z

Fizick: Undo revision 3790 by Special:Contributions/141.104.22.222 (User talk:141.104.22.222)

#REDIRECT [[Resize]] [[Category:Internal filters]]

Filter SDK/Simple sample

2007-06-17T17:35:17Z

Fizick: full packages

Here are the sources for the series of examples developed in [http://forum.doom9.org/showthread.php?s=&threadid=48261 this doom9 thread]. You can also get links to full packages with project files included in this thread.

Note: the samples are for version 2.5

* [[Filter_SDK/Simple_sample_1.0b|Simple Sample 1.0b]] - simple documented sample that just copies the source frame to the destination in RGB and YUV colourspaces.
* [[Filter_SDK/Simple_sample_1.1|Simple Sample 1.1]] - additions to handle planar colourspaces (e.g. YV12).
* [[Filter_SDK/Simple_sample_1.2|Simple Sample 1.2]] - Revert to RGB24 colourspace only to show simple pixel manipulation.
* [[Filter_SDK/Simple_sample_1.3a|Simple Sample 1.3a]] - Add in code to handle parameters in filters.
* [[Filter_SDK/Simple_sample_1.4|Simple Sample 1.4]] - Add in RGB32 colourspace code.
* [[Filter_SDK/Simple_sample_1.5a|Simple Sample 1.5a]] - Add in YUY2 code.
* [[Filter_SDK/Simple_sample_1.6|Simple Sample 1.6]] - and finally YV12 as well - yippee.
* [[Filter_SDK/Simple_sample_1.7|Simple Sample 1.7]] - Add in ability to use info from 2 clips only the YUY2 colorspace code altered.
* [[Filter_SDK/Simple_sample_Calls|Classes and function calls in AviSynth plugins]] - about classes and function calls in AviSynth plugins.

Back to [[Filter_SDK|Filter SDK]]

[[Category:FilterSDK]]

Filter SDK/SDK history

2007-05-12T00:07:41Z

Fizick: developer

The "Writing Avisynth plugins" article was written by Ben Rudiak-Gould (Avisynth creator). It was taken from AviSynth 1.0 documentation as it was (year 2000) at http://math.berkeley.edu/~benrg/avisynth-extensions.html (Ben's home page). The current (November 2006) mirror is at http://www.neuron2.net/www.math.berkeley.edu/benrg/avisynth-extensions.html

----

Preliminary version of AviSynth 2.0-2.5 FilterSDK documentation has been created at 2003 as a section of AviSynth online (wiki) documentation at the official AviSynth site www.avisynth.org (maintained by Richard Berg).

{{Underline|Developers:}}

* Klaus Post ('sh0dan'):
: AviSynthTwoFiveAudio, AviSynthTwoFivePixelType, AviSynthTwoFiveSDK, ChangeFrameSize, ColorSpaces, DataAlignment, DataStorageInAviSynth, EnvInvoke, EnvSaveString, SimpleMmxOptimization, TwoFiveInvert, TwoFiveFastInvert and some other wiki pages.
* Wilbert Dijkhof ('Wilbert'):
: CompilingAvisynth and some other wiki pages.

{{Underline|Contributors:}}

* Simon Walters ('SiWalters'):
: SimpleSample 1.0 to 1.7 wiki pages.
* 'trevlac':
: SimpleSampleClass wiki page.
* Avery Lee ('phaeron'):
: Some texts in AssemblerOptimizing wiki pages, "as freely available for any use".

Thanks to other Avisynth community people for wiki pages improving/correction!

----

The package of off-line (HTML) AviSynth external FilterSDK documentation version 2.5.7 was created at 2006 at sourceforge.net CVS for distribution with AviSynth v2.5.7 installation.

Most documents were converted from wiki pages (some modifyed/updated). Some new documents are added too.

{{Underline|Developer:}}

* Alexander Balakhnin ('Fizick'):
: SDKNecessaries, SDKLicense, SDKHistory, wiki pages converting/editing.

----

FilterSDK documentation has been reposted to the new Avisynth mediawiki in 2007.

----
Back to [[Filter SDK]].

[[Category:FilterSDK]]

Filter SDK/Ben docs

2007-05-05T07:33:43Z

Fizick: Restored AvisynthPluginInit, added notes and moved to bottom

== Writing Avisynth plugins ==

=== An example ===

I'll start off with a complete, working Avisynth plugin. It's called "Invert", and it produces a photo-negative of the input clip.

Here's Invert.cpp:

#include "windows.h"
#include "avisynth.h"

class Invert : public GenericVideoFilter {
public:
Invert(PClip _child) : GenericVideoFilter(_child) {}
PVideoFrame __stdcall GetFrame(int n, IScriptEnvironment* env);
};

PVideoFrame __stdcall Invert::GetFrame(int n, IScriptEnvironment* env) {

PVideoFrame src = child->GetFrame(n, env);
PVideoFrame dst = env->NewVideoFrame(vi);

const unsigned char* srcp = src->GetReadPtr();
unsigned char* dstp = dst->GetWritePtr();

const int src_pitch = src->GetPitch();
const int dst_pitch = dst->GetPitch();
const int row_size = dst->GetRowSize();
const int height = dst->GetHeight();

for (int y = 0; y < height; y++) {
for (int x = 0; x < row_size; x++) {
dstp[x] = srcp[x] ^ 255;
}
srcp += src_pitch;
dstp += dst_pitch;
}

return dst;
}

AVSValue __cdecl Create_Invert(AVSValue args, void* user_data, IScriptEnvironment* env) {
return new Invert(args[0].AsClip());
}

extern "C" __declspec(dllexport) const char* __stdcall AvisynthPluginInit(IScriptEnvironment* env) {
env->AddFunction("Invert", "c", Create_Invert, 0);
return "`Invert' sample plugin";
}

Compile this file into a DLL named Invert.dll. Now create an Avisynth script which looks something like this:

LoadPlugin("d:\path\Invert.dll")
clip = AVISource("d:\path2\video.avi")
return clip.Invert()

If all is well, you should see a photo negative of your video clip when you open this script.
How it works

Here's a line-by-line breakdown of Invert.cpp.

#include "avisynth.h"

This header declares all the classes and miscellaneous constants that you might need when writing a plugin. All external plugins should #include it.

External plugins do not link with avisynth.dll, so they can't directly access functions that are defined in the main Avisynth source code. Therefore, every important function in avisynth.h is either defined inline or declared as virtual. The virtual functions act as callbacks for external DLLs.

class Invert : public GenericVideoFilter {

An Avisynth filter is simply a C++ class implementing the IClip interface. IClip has four pure virtual methods: GetVideoInfo, GetFrame, GetParity, and GetAudio.

The class GenericVideoFilter is a simple do-nothing filter defined in avisynth.h. It derives from IClip and implements all four methods. Most filters can inherit from GenericVideoFilter rather than directly from IClip; this saves you from having to implement methods that you don't care about, like GetAudio.

Invert(PClip _child) : GenericVideoFilter(_child) {}

A PClip is a "smart pointer" to an IClip. It maintains a reference count on the IClip object and automagically deletes it when the last PClip referencing it goes away. For obvious reasons, you should always use PClip rather than IClip* to refer to clips.

Like a genuine pointer, a PClip is only four bytes long, so you can pass it around by value. Also like a pointer, a PClip can be assigned a null value (0), which is often useful as a sentinel. Unlike a pointer, PClip is initialized to 0 by default.

You'll need to make sure your class doesn't contain any circular PClip references, or any PClips sitting in dynamically allocated memory that you forget to delete. Other than that, you don't have to worry about the reference-counting machinery.

Avisynth filters have a standardized output channel via IClip, but (unlike [[VirtualDub]] filters) no standardized input channel. Each filter is responsible for obtaining its own source material -- usually (as in this case) from another clip, but sometimes from several different clips, or from a file.

GenericVideoFilter has a single constructor taking a single clip, which it then simply passes through to its output. We will override the GetFrame method to do something more useful, while leaving the other three methods as-is to pass through aspects of the clip that we don't need to change.

PVideoFrame Invert::GetFrame(int n, IScriptEnvironment* env) {

This method is called to make our filter produce frame n of its output. The second argument, env, is for our purposes simply a callback suite. It is actually implemented in Avisynth by a class called ScriptEnvironment. One instance of this class is created for each opened AVS script, so there may sometimes be several instances active at once. It is important that the callback functions be called through the proper instance. A particular instance of your class will only be used in one ScriptEnvironment, but different instances might be used in different ScriptEnvironments.

This method returns a PVideoFrame, which is a smart pointer like PClip.

PVideoFrame src = child->GetFrame(n, env);

"child" is a protected member of GenericVideoFilter, of type PClip. It contains the clip that was passed to the constructor. For our filter to produce frame n we need the corresponding frame of the input. If you need a different frame from the input, all you have to do is pass a different frame number to child->GetFrame.

GetFrame calls are usually intercepted by Avisynth's internal caching code, so the frame request may never actually reach the child filter.

PVideoFrame dst = env->NewVideoFrame(vi);

The NewVideoFrame callback allocates space for a video frame of the supplied size. (In this case it will hold our filter's output.) The frame buffer is uninitialized raw memory (except that in the debug build it gets filled with the repeating byte pattern 0A 11 0C A7 ED, which is easy to recognize because it looks like "ALLOCATED").

"vi" is another protected member of GenericVideoFilter (the only other member, actually). It is a struct of type VideoInfo, which contains information about the clip (like frame size, frame rate, pixel format, audio sample rate, etc.). NewVideoFrame uses the information in this struct to return a frame buffer of the appropriate size.

Frame buffers are reused once all the PVideoFrame references to them go away. So usually NewVideoFrame won't actually need to allocate any memory from the heap.

const unsigned char* srcp = src->GetReadPtr();
unsigned char* dstp = dst->GetWritePtr();

All frame buffers are readable, but not all are writable.

The rule about writability is this: A buffer is writable if and only if there is exactly one PVideoFrame pointing to it. In other words, you can only write to a buffer if no one else might be reading it. This rule guarantees that as long as you hold on to a PVideoFrame and don't write to it yourself, that frame will remain unchanged. The only drawback is that you can't have two PVideoFrames pointing to a writable buffer. This can sometimes be an inconvenience, as I'll explain later.

Any buffer you get from NewVideoFrame is guaranteed to be writable (as long as you only assign it to one PVideoFrame!). Our filter's dst came from NewVideoFrame, so we can safely call dst->GetWritePtr(). However, frames you get from other clips via GetFrame may not be writable, in which case GetWritePtr() will return a null pointer.

There is an IsWritable() method which you can call to find out if a buffer is writable or not, and there's a MakeWritable callback (described below) to ensure that it is.

const int src_pitch = src->GetPitch();
const int dst_pitch = dst->GetPitch();

Just as in VirtualDub, the "pitch" of a frame buffer is the offset (in bytes) from the beginning of one scan line to the beginning of the next. The source and destination buffers won't necessarily have the same pitch.

Buffers created by NewVideoFrame are always quadword (8-byte) aligned and always have a pitch that is a multiple of 8.

const int row_size = dst->GetRowSize();

The row size is the length of each row in bytes (not pixels). It's usually equal to the pitch or slightly less, but it may be significantly less if the frame in question has been through Crop.

Since our source and destination frames have the same width and pixel format, they will always have the same row size. Thus I only need one row_size variable, and I could just as well have called src->GetRowSize().

const int height = dst->GetHeight();

The height is the height. (In pixels.) Again, for our filter this is the same for the source and the destination.

for (int y = 0; y < height; y++) {
for (int x = 0; x < row_size; x++)
dstp[x] = srcp[x] ^ 255;
srcp += src_pitch;
dstp += dst_pitch;
}

This is the code that does the actual work. The "srcp += src_pitch; dstp += dst_pitch;" idiom is a useful way of dealing with potentially differing pitches without too much grief.

return dst;

GetFrame returns the newly-created frame. Our own references to this frame and to the source frame will go away with the src and dst variables. Our caller will become sole owner of the destination frame (which therefore will still be writable), and the source frame will be retained in the cache and eventually recycled. All through the magic of C++ classes.

AVSValue __cdecl Create_Invert(AVSValue args, void* user_data, IScriptEnvironment* env) {

In order to use our new filter, we need a scripting-language function which creates an instance of it. This is that function.

Script functions written in C++ take three arguments. args contains all the arguments passed to the function by the script. user_data contains the void pointer which you passed to AddFunction (see below). Usually you won't need this. env contains the same IScriptEnvironment pointer that will later be passed to GetFrame.

AVSValue is a variant type which can hold any one of the following: a boolean value (true/false); an integer; a floating-point number; a string; a video clip (PClip); an array of AVSValues; or nothing ("undefined"). You can test which one it is with the methods IsBool(), IsInt(), IsFloat(), IsString(), IsClip(), IsArray(), and Defined() (which returns true if the AVSValue is not "undefined"). You can get the value with AsBool(), AsInt(), etc. For arrays, you can use the ArraySize() method to get the number of elements, and [] indexing to get the elements themselves. For convenience, IsFloat() and AsFloat() will work with integers also. But boolean values are not treated as numeric (unlike C).

The name "Create_Invert" is arbitrary. This function will actually be known as "Invert" in scripts, because that's the name we pass to AddFunction below.

return new Invert(args[0].AsClip());

The args argument passed to a script function will always be an array. The return value should be any one of the other types (never an array).

The types of the values in the args array are guaranteed to match one of the function signatures that you pass to AddFunction, just as in VirtualDub. Therefore, there's no need to worry about IsClip here.

Create_Invert simply creates and returns a filter instance; it is automatically converted to an AVSValue via the constructor AVSValue(IClip*).

extern "C" __declspec(dllexport) const char* __stdcall AvisynthPluginInit2(IScriptEnvironment* env) {

This is the only function which gets exported from the DLL. It is called by the script function LoadPlugin the first time this plugin in loaded in a particular script. If several scripts are open at once and more than one of them loads this plugin, AvisynthPluginInit2 may be called more than once with different IScriptEnvironments. Therefore:

* You should not save the env parameter in a global variable.
* If you need to initialize any static data, you should do it in DLLMain, not in this function.

The main purpose of the AvisynthPluginInit2 function is to call env->AddFunction.

env->AddFunction("Invert", "c", Create_Invert, 0);

As promised, we now call AddFunction to let Avisynth know of the existence of our filter. This function takes four arguments: the name of the new script function; the parameter-type string; the C++ function implementing the script function; and the user_data cookie.

The parameter-type string is similar to the corresponding entity in [[VirtualDub]], except that:

* No return type is given. Function return values are not type-checked; you can return anything you like.
* There are more types: along with 'i'nt and 's'tring you can specify 'b'ool, 'f'loat, and 'c'lip.
* You can follow any type with '*' or '+' to indicate "zero or more" or "one or more" respectively. In this case all the matching arguments will be gathered into a sub-array.
:: For example, if your type string is "is+f", then the integer argument will be args[0], the string arguments will be args[1][0], args[1][1], etc. (and there will be args[1].ArraySize() of them), and the float argument will be args[2].
* '.' matches a single argument of any type. To match multiple arguments of any type, use ".*" or ".+".
* You can have named arguments, by specifying the name in [brackets] before the type. Named arguments are also optional arguments; if the user omits them, they will be of the undefined type instead of the type you specify. For convenience, AVSValue offers a set of As...() functions which take default values. See avisynth.h.

return "`Invert' sample plugin";

The return value of AvisynthPluginInit is a string which can contain any message you like, such as a notice identifying the version and author of the plugin. This string becomes the return value of LoadPlugin, and will almost always be ignored. You can also just return 0 if you prefer.

== Variations ==

=== An in-place filter ===

The Invert filter could easily do its work in a single buffer, rather than copying from one buffer to another. Here's a new implementation of GetFrame that does this.

PVideoFrame Invert::GetFrame(int n, IScriptEnvironment* env) {

PVideoFrame frame = child->GetFrame(n, env);

env->MakeWritable(&frame);

unsigned char* p = frame->GetWritePtr();
const int pitch = frame->GetPitch();
const int row_size = frame->GetRowSize();
const int height = frame->GetHeight();

for (int y = 0; y < height; y++) {
for (int x = 0; x < row_size; x++)
p[x] ^= 255;
p += pitch;
}
}
return frame;
}

The key difference between this version of the function and the original version is the presence of the MakeWritable callback. This is necessary because this time "we don't know where that frame's been." Someone else in the filter chain may be holding a reference to it, in which case we won't be allowed to write to it.

MakeWritable is a simple solution to this problem. It is implemented as follows (in avisynth.cpp):

bool ScriptEnvironment::MakeWritable(PVideoFrame* pvf) {
const PVideoFrame& vf = *pvf;

// If the frame is already writable, do nothing.

if (vf->IsWritable()) {
return false;
}

// Otherwise, allocate a new frame (using NewVideoFrame) and
// copy the data into it. Then modify the passed PVideoFrame
// to point to the new buffer.

else {
const int row_size = vf->GetRowSize();
const int height = vf->GetHeight();
PVideoFrame dst = NewVideoFrame(row_size, height);
BitBlt(dst->GetWritePtr(), dst->GetPitch(), vf->GetReadPtr(), vf->GetPitch(), row_size, height);
*pvf = dst;
return true;
}
}

=== A filter that changes the frame size ===

In order to effect a change in frame size, two things must happen:

* your GetVideoInfo method must return a VideoInfo struct with the appropriate size, and
* your GetFrame method must return video frames of the appropriate size.

If you derive your filter class from GenericVideoFilter, then a convenient way to achieve both of these things is to assign the new values to vi.width and vi.height in your class constructor. This way you won't have to override GetVideoInfo, since GenericVideoFilter's implementation just returns vi. And if you allocate your output frames using env->NewVideoFrame(vi), then they will be of the appropriate size as well.

For an example of a simple filter which does this, see [[Crop]] or [[StackVertical]].

=== A filter which processes audio ===

Audio processing is handled through the GetAudio method, which has the following prototype:

void GetAudio(void* buf, int start, int count, IScriptEnvironment* env);

You must fill in the buffer with count samples beginning with sample number start. A sample may vary from one to four bytes, depending on whether the audio is 8- or 16-bit and mono or stereo. The flags vi.stereo and vi.sixteen_bit will tell you this.

If you cannot do your audio processing in-place, you must allocate your own buffer for the source audio using new or malloc.

=== A filter which rearranges frames ===

Many of the built-in filters do nothing more than rearrange video frames (for example [[Trim]], [[Splice]], [[SelectEvery]], [[Interleave]], [[Reverse]], and [[ChangeFPS]]). If you want to do this, you can write a GetFrame method like this:

PVideoFrame GetFrame(int n, IScriptEnvironment* env) {
return child->GetFrame(ConvertFrameNumber(n), env);
}

But you must also do three other things:

* Write a companion GetParity method so that field information is preserved; for example, bool GetParity(int n) { return child->GetParity(ConvertFrameNumber(n)); };
* Set vi.num_frames and/or call vi.SetFPS at instance construction time, if you change the frame count or frame rate;
* Decide what you want to do with the audio track, and write a GetAudio method if necessary.

=== Other useful methods in IScriptEnvironment ===

__declspec(noreturn) virtual void ThrowError(const char* fmt, ...);

This function throws an exception (of type AvisynthError). Usually, your error message will end up being displayed on the user's screen in lieu of the video clip they were expecting.

You can safely call ThrowError from anywhere except inside GetParity and GetVideoInfo.

I declared this function as __declspec(noreturn) to prevent "not all control paths return a value" warnings. But it didn't work -- I still get the warnings. Go figure.

virtual long GetCPUFlags();

This is exactly the same as the corresponding [[VirtualDub]] function (to the point of being implemented with code taken directly from VirtualDub -- sorry Avery ;-) ).

To find out if you're running on a CPU that supports MMX, test env->GetCPUFlags() & CPUF_MMX. There's a complete list of flags in avisynth.h.

virtual char* SaveString(const char* s, int length = -1);

This function copies its argument to a safe "permanent" location and returns a pointer to the new location.

Each ScriptEnvironment instance has a buffer set aside for storing strings, which is expanded as needed. The strings are not deleted until the ScriptEnvironment instance goes away (when the script file is closed, usually). This is usually all the permanence that is needed, since all related filter instances will already be gone by then.

The returned pointer is not const-qualified, and you're welcome to write to it, as long as you don't stray beyond the bounds of the string.

virtual char* Sprintf(const char* fmt, ...);
virtual char* VSprintf(const char* fmt, char* val);

These store strings away in the same way as SaveString, but they treat their arguments like printf and vprintf.

Currently there's a size limit of 4096 characters on strings created this way. (The implementation uses _vsnprintf, so you don't need to worry about buffer overrun.)

virtual AVSValue Invoke(const char* name, const AVSValue args, const char** arg_names=0);

You can use this to call a script function. There are many script functions which can be useful from other filters; for example, the [[Bob]] filter uses [[SeparateFields]], and several source filters use [[Splice|UnalignedSplice]]. Some functions, like [[Weave]], are implemented entirely in terms of other functions.

If you're calling a function taking exactly one argument, you can simply pass it in the args parameter; Invoke will convert it into an array for you. In order to call a function taking multiple arguments, you will need to create the array yourself; it can be done like this:

AVSValue args[5] = { clip, 0, true, 4.7, "my hovercraft is full of eels" };
env->Invoke("Frob", AVSValue(args, 5));

In this case Frob would need to have a parameter-type string like "cibfs" or "cfbfs" or "cf.*".

The arg_names parameter can be used to specify named arguments. Named arguments can also be given positionally, if you prefer.

Invoke throws IScriptEnvironment::NotFound if it can't find a matching function prototype. You should be prepared to catch this unless you know that the function exists and will accept the given arguments.

virtual void BitBlt(unsigned char* dstp, int dst_pitch, const unsigned char* srcp, int src_pitch, int row_size, int height);

This brilliantly-named function does a line-by-line copy from the source to the destination. It's useful for quite a number of things; the built-in filters DoubleWeave, FlipVertical, AddBorders, PeculiarBlend, StackVertical, StackHorizontal, and ShowFiveVersions all use it to do their dirty work.

typedef void (__cdecl *ShutdownFunc)(void* user_data, IScriptEnvironment* env);
virtual void AtExit(ShutdownFunc function, void* user_data);

If you find yourself wanting an AvisynthPluginShutdown export, this is the way to get that effect. Functions added through AtExit are called (in the opposite order that they were added) when the corresponding ScriptEnvironment goes away.

----

== Notes to Ben's docs ==

This is original documentation written for AviSynth 1.0 by [[User:BenRG|Ben Rudiak-Gould]] - copied from http://math.berkeley.edu/~benrg/avisynth-extensions.html

Mirror is available now online at the http://www.neuron2.net/www.math.berkeley.edu/benrg/avisynth-extensions.html

For AviSynth 2.5, see the converted [[Filter_SDK/Two-Five_Invert|Two-Five Invert]] plugin filter source.

Plugin exported function name is replaced from 'AvisynthPluginInit' for AviSynth 1.0-2.0
to 'AvisynthPluginInit2' for AviSynth 2.5.

For other changes see [[Filter_SDK/Two-Five_SDK|Two-Five SDK]].

Please do not edit the Ben's text!

[[Category:FilterSDK]]