# MSharpen

## Přehled

autor: Donald A. Graft
verze: 1.10 beta 2
stáhnout: http://neuron2.net/mine.html, http://www.avisynth.org/warpenterprises/
kategorie: Pluginy pro zostření/změkčení
požadavky: YV12 & YUY2 & RGB Barevné prostředí

## Popis

Tento plugin pro Avisynth implementuje neobvyklý koncept v prostorovém (spatial) zostřování. Ačkoliv je navržen především pro animované filmy, pracuje také docela dobře s normálním videem. Filtr je velmi efektivní při zostřování důležitých hran bez zesilování šumu.

Tato verze MSharpen vyžaduje Avisynth verze 2.5 nebo novější. Filtr pracuje s RGB32, YUY2, nebo YV12 vstupem. V YUY2 prostředí zostřuje pouze jasový kanál. V RGB a YV12 prostředí zostřuje všechny barevné kanály. Pokud chcete zostřit pouze jas u RGB nebo YV12 zdrojového materiálu, použijte ConvertToYUY2(), zpracujte ho, a pak převeďte zpět pokud je to vyžadováno. Ve všech barevných prostředích, je barva začleněna do detekce detailů.

Odůvodnění vzniku filtru je jednoduché. Největší stížnosti u Unsharp Mask (například) je, že nastavení dost vysoké intezity zostření důležitých hran také zesiluje šum a malý detail. MSharpen řeší tento problém efektivně detekcí důležitých oblastí hran a následným aplikováním zostření jen na tyto oblasti. Nejdříve nastavíte parametr 'threshold' tak, že jsou vybrány žádané hrany. Pak nastavíte sílu zostření. Můžete nastavit velmi vysoké zostřovací síly bez zesilování šumu nebo pěkných detailů (protože pro masku zostřování je použito mapování hran).

### MSharpen - Funkční syntaxe

MSharpen používá jmenné parametry. To znamená, že nemusíte mít obavy o pořadí parametrů a můžete jednoduše na ně poukazovat pomocí názvů a vkládat je v jakémkoliv pořadí do seznamu parametrů. Když vynecháte parametr tak bere své výchozí hodnoty. Například, pokud chcete použít MSharpen se sílou strenght 100 se zapnutým laděním (debug), můžete jednoduše říci:

    MSharpen(strength=100, debug=true)

Je povolena jakákoliv kombinace a pořadí parametrů. Nicméně pamatujte, že by jste měli vždy vkládat prázdné závorky, pokud nespecifikujete žádné parametry.

Můžete také použít normální pozicovou syntaxi bez názvů, pokud ji upřednostňujete. Správné pořadí parametrů je:

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

Takže by jste mohli prostě použít:

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

### Změna výchozích hodnot parametrů

Pokud se vám nelíbí výchozí hodnoty parametrů uvedené níže, můžete nastavit své vlastní výchozí hodnoty. Pro přepsání výchozích hodnot nejdříve vytvořte složku s pluginy AviSynhu a zaregistrujte ji. Zaregistrujete ji vložením následujících řádků do textového souboru nazvaného 'plugin.reg', změnte vhodně cesty, a pak klikněte pravým tlačítkem myši na ikonu souboru a vyberte Merge.

    REGEDIT4

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

Dále, vytvořte výchozí soubory jak je potřeba ve složce pluginů. Například, k nastavení výchozí hodnoty highq=false pro MSharpen(), vytvořte soubor zvaný MSharpen.def a vložte do něj tento řádek:

highq = false

Můžete sepsat tolik přiřazení parametrů kolik chcete, na každý řádek jeden. Nespecifikovaným zůstanou hodnoty uvedené níže. Samozřejmě můžete vždy přepsat tyto výchozí jinými hodnotami uvedenými ve vašem skriptu, když vyvoláváte funkci. Poznámka: Řádky ve výchozím souboru nesmí obsahovat žádné mezery nebo tabulátory.

Následující je syntaxe pro MSharpen (nahraďte parameter_list vaším čárkou oddělovaným seznamem jmenných parametrů):

MSharpen(parameter_list)

threshold (0-255, výchozí 10): Tento parametr určuje co je detekováno jako detail hrany a tak zostřen. Aby jste viděli které oblasti detailů hran budou zostřovány, použijte parametr 'mask'.

strength (0-255, výchozí 100): Toto je síla zostřování, která bude použita na oblasti detailů hran. Je použita jen na detaily hran podle zadaného parametru 'threshold'. Strenght 255 je nejsilnější zostření.

mask (true/false, výchozí false): Když je nastaven na true, oblasti pro zostření jsou zobrazeny bíle na černém pozadí. Použijte ho pro nastavení úrovně detailu pro zostření. Tato funkce také dělá základní detekci hran filtru.

highq (true/false, výchozí true): Tento parametr vás nechá upravit rychlost a kvalitu detekce detailů. Nastavte ho na true pro nejlepší detekci detailů. Nastavte ho na false pro maximální rychlost.

debug (true/false, výchozí false): Tento parametr zapíná ladění výstupu do utility DebugView. V současnosti je výstupem jen verze filtru.

### Autorská práva

Copyright (C) 2003, Donald A. Graft, All Rights Reserved.
Feedback/inquiries to neuron2@attbi.com.

Pro aktualizace a další filtry/nástroje, navštivte mou webovou stránku:
http://neuron2.net/

`$English Date: 2005/07/27 17:51:02 $`

`Český překlad:19.2.2009`