# MSharpen

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

автор: Donald A. Graft
версия: 1.10 beta 2
закачка: http://neuron2.net/mine.html
категория: Плагины для усиления / смягчения резкости
требования: YV12 & YUY2 & RGB цветовые форматы

## Описание

Этот плагин для Avisynth реализует необычную концепцию в пространственном увеличении резкости. Хотя разработан специально для мультфильмов анимэ, он также работает вполне хорошо на обычном видео. Этот фильтр очень эффективен в повышении резкости важных краев без усиления шума.

Эта версия MSharpen требует Avisynth версии 2.5 или выше. Фильтр работает с источниками RGB32, YUY2, или YV12. В формате YUY2 он повышает резкость только канала яркости. В RGB и YV12 форматах, он повышает резкость всех трех цветовых каналов. Если вы хотите повысить резкость только яркости для RGB или YV12 источника, используйте `ConvertToYUY2()`, обработайте, и затем преобразуйте обратно если хотите. Во всех цветовых форматах, цвет включен в обнаружение деталей.

Оправдание (существования) фильтра является простым. Наибольшей неудовлетворенностью маской нерезкости (Unsharp Mask) (например) является то, что установки силы достаточно высоко, чтобы обострить важные края, также усиливает шум и малые детали. MSharpen решает эту проблему эффективно путем обнаружения важных краевых областей, и затем применения повышения резкости только к этим областям. Вы сначала устанавливаете параметр порога 'threshold' так чтобы выбирались желаемые края. Затем вы устанавливаете силу повышения резкости strength. Вы можете установить очень высокую силу повышения резкости без усиления шума или мелких деталей (так как используется карта краев как маска для повышения резкости).

### Синтаксис функции MSharpen

MSharpen использует именованные параметры. Это означает, что вы не должны заботиться об упорядочивании параметров и можете просто ссылаться на них по имени и поместить их в любом порядке в списке параметров. Если вы опустите параметр, он примет его величину по умолчанию. Например, если вы хотите выполнить MSharpen с силой (strength) 100 и разрешенной отладкой (debug), вы можете сказать просто:

    MSharpen(strength=100, debug=true)

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

Вы также можете использовать обычный позиционный синтаксис без имен, если вы предпочитаете. Корректный порядок параметров следующий:

`MSharpen` (clip, int "threshold", int "strength", bool "highq", bool "mask", bool "debug")

Так что вы можете просто использовать:

    MSharpen(15, 100, true, false, false)

### Изменение величин параметров по умолчанию

Если вы не любите значения по умолчанию, документированные ниже, вы можете установить свои собственные стандартные значения по умолчанию. Чтобы заменить умолчания, сначала создайте папку плагинов Avisynth и зарегистрируйте ее. Вы зарегистрируете ее путем помещения следующих строк в текстовый файл названный 'plugin.reg', замены пути как следует, и затем щелчком правой кнопкой мыши на иконке файла и выбором пункта Слияние (Merge).

    REGEDIT4

    [HKEY_LOCAL_MACHINE\SOFTWARE\Avisynth]
    "PluginDir2_5"="d:\\avisynthplugins"

(От перев. : при установке Avisynth 2.5 автоматически создается папка и регистрируется путь типа "C:\Program Files\AviSynth 2.5\plugins", смотри Автозагрузка плагинов)

Затем, создайте файл с требуемыми умолчаниями (def) в папке плагинов. Например, чтобы установить по умолчанию highq=false для `MSharpen()`, сделайте файл, названный MSharpen.def и поместите в него эту строчку:

highq = false

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

Ниже приведен синтаксис для MSharpen (замените список_параметров на разделенный запятыми ваш список именованных параметров):

MSharpen(список_параметров)

threshold (0-255, по умолчанию 10) (порог): Этот параметр определяет, что обнаруживается (детектируется) как деталь края и, таким образом, делается резче. Чтобы увидеть, какие области деталей краев будут сделаны резче, используйте параметр 'mask'.

strength (0-255, по умолчанию 100) (сила): Это есть сила повышения резкости, которая будет приложена к областям деталей краев. Она прилагается только к областям деталей краев, определенным параметром 'threshold'. Сила 255 является наибольшим повышением резкости.

mask (true/false, по умолчанию false) (маска): Если установлена в true (правда), то области, которые должны быть сделаны резче, показаны белыми на черном фоне. Используйте это, чтобы установить уровень деталей, которые должны быть сделаны резче. Эта функция также является базовым (простым) фильтром детектирования краев.

highq (true/false, по умолчанию true) (высокое качество): Этот параметр позволяет вам пожертвовать скоростью для качества детектирования деталей. Установите его в true (правда) для наилучшего детектирования деталей. Установите его в false (ложь) для максимальной скорости.

debug (true/false, по умолчанию false) (отладка): Этот параметр разрешает отладочный вывод для утилиты DebugView. В настоящее время, выводится только версия фильтра.

### Авторские права

Copyright (C) 2003, Donald A. Graft, All Rights Reserved.
Отклик/вопросы - на neuron2@attbi.com.

Для обновлений и других фильтров/инструментов, посетите мой веб сайт:
http://neuron2.net/

`$English Date: 2004/08/13 21:57:25 $
Русский перевод 04.07.2005 Fizick http://bag.hotmail.ru`