GrainFactory3

From Avisynth wiki
(Difference between revisions)
Jump to: navigation, search
m (1 revision)
Line 2: Line 2:
 
{{Filter
 
{{Filter
 
|Didée
 
|Didée
|3.0
+
|3
|[http://avisynth.org/mediawiki/upload/0/08/GrainFactory3.avsi GrainFactory3.avsi]
+
|[http://avisynth.nl/images/GrainFactory3.avsi GrainFactory3.avsi]
 
|Effects
 
|Effects
 
|
 
|
 
* YV12
 
* YV12
 
|}}
 
|}}
 +
<br>
 +
== Description ==
 +
:Noise generator that tries to simulate the behavior of silver grain on film..
 +
<br>
 +
== Requirements: ==
 +
:- AviSynth 2.5.8 or later
 +
:- Supported color formats: [[YV12]]
 +
:- [[FAQ_different_types_content#How_do_I_recognize_progressive.2C_interlaced.2C_telecined.2C_hybrid_and_blended_content.3F|Progressive]] input only
  
{{Template:FuncDef|GrainFactory3 (clip clp,int "g1str",int "g2str",int "g3str",int "g1shrp",int "g2shrp",int "g3shrp", float "g1size", float "g2size", float "g3size", int "g1tex", int "g2tex", int "g3tex", int "temp_avg", int "ontop_grain", int "th1", int "th2", int "th3", int "th4")}}
+
==== Required Filters: ====
 +
:* AddGrainC
 +
:*[[MaskTools2]] 2.0a48+
 +
<br>
  
== Abstract ==
+
== Syntax and Parameters ==
 +
:{{Template:FuncDef|GrainFactory3 (clip clp, int "g1str", int "g2str", int "g3str", int "g1shrp", int "g2shrp", int "g3shrp", float "g1size", float "g2size", float "g3size", int "g1tex", int "g2tex", int "g3tex", int "temp_avg", int "ontop_grain", int "th1", int "th2", int "th3", int "th4")}}
 +
<br>
 +
::'''Strength of grain:'''
  
Noise generator that tries to simulate the behaviour of silver grain on film.
+
:::{{Par|g1str|int|13}}
 +
::::Strength of grain / for dark areas.
 +
:::::Range: 0 - ???
  
=== Requires Filters ===
+
:::{{Par|g2str|int|15}}
*[[AddGrain]]
+
::::Strength of grain / for midtone areas.
*[[MaskTools]]
+
:::::Range: 0 - ???
  
== Description ==
+
:::{{Par|g3str|int|25}}
 +
::::Strength of grain / for bright areas.
 +
:::::Range: 0 - ???
 +
<br>
 +
::'''Sharpness of grain:'''
  
{{Par|g1str|int|13}}  
+
:::{{Par|g1shrp|int|60}}
{{Par|g2str|int|15}}
+
::::Sharpness of grain / for dark areas (NO EFFECT when g1size=1.0 !!)
{{Par|g3str|int|25}}
+
:::::Range: 0 - 100
  
{{Par|g1shrp|int|60}}
+
:::{{Par|g2shrp|int|66}}
{{Par|g2shrp|int|66}}
+
::::Sharpness of grain / for midtone areas (NO EFFECT when g2size=1.0 !!)
{{Par|g3shrp|int|80}}
+
:::::Range: 0 - 100
  
{{Par|g1size|float|1.50}}
+
:::{{Par|g3shrp|int|80}}
{{Par|g2size|float|1.20}}
+
::::Sharpness of grain / for bright areas (NO EFFECT when g3size=1.0 !!)
{{Par|g3size|float|0.90}}
+
:::::Range: 0 - 100
 +
<br>
 +
::'''Size of grain:'''
  
{{Par|g1tex|int|0}}
+
:::{{Par|g1size|float|1.50}}
{{Par|g2tex|int|0}}
+
::::Size of grain / for dark areas.
{{Par|g3tex|int|0}}
+
:::::Range: 0.5 - 4.0
  
{{Par|temp_avg|int|0}}
+
:::{{Par|g2size|float|1.20}}
 +
::::Size of grain / for mid-tone areas.
 +
:::::Range: 0.5 - 4.0
  
{{Par|th1|int|24}}
+
:::{{Par|g3size|float|0.90}}
{{Par|th2|int|56}}
+
::::Size of grain / for bright areas
{{Par|th3|int|128}}
+
:::::Range: 0.5 - 4.0
{{Par|th4|int|160}}
+
<br>
 +
::'''Texture:'''
  
{{Par|ontop_grain|int|0}}
+
:::{{Par|g1tex|int|0}}
 +
::::Strength of "material texture" appearance.
 +
:::::Range: 0 - 100
  
 +
:::{{Par|g2tex|int|0}}
 +
::::(In fact: 'bump' effect)
 +
:::::Range: 0 - 100
 +
 +
:::{{Par|g3tex|int|0}}
 +
::::For dark / midtone / bright grain.
 +
:::::Range: 0 - 100
 +
<br>
 +
::'''Temporal averaging:'''
 +
:::{{Par|temp_avg|int|0}}
 +
::::Percentage of noise's temporal averaging.
 +
:::::Range: 0 - 100
 +
<br>
 +
::'''Mixing zone:'''
 +
 +
:::{{Par|th1|int|24}}
 +
::::Start of dark->midtone  mixing zone.
 +
 +
:::{{Par|th2|int|56}}
 +
::::End  of  dark->midtone  mixing zone.
 +
 +
:::{{Par|th3|int|128}}
 +
::::Start of midtone->bright  mixing zone.
 +
 +
:::{{Par|th4|int|160}}
 +
::::End  of  midtone->bright  mixing zone
 +
<br>
 +
::'''On top grain:'''
 +
 +
:::{{Par|ontop_grain|int|0}}
 +
::::additional grain to put on top of previously generated grain.
 +
:::::Range:0 - ???
 +
<br>
 
== Examples ==
 
== Examples ==
  
Line 52: Line 112:
  
 
== Changelog ==
 
== Changelog ==
 
+
  Changes [http://forum.doom9.org/showthread.php?p=1190302#post1190302 2008-10-03:]
 +
    - GrainFactory3
 +
      - Shorten parameters' names
 +
      - Add "mixing zone" parameters
 +
      - Restructure parameters. Better control for dark, midtone, and bright areas.<br>
 +
  Changes [http://forum.doom9.org/showthread.php?p=1190302#post1190302 2008-10-01:]
 +
    - GrainFactory_MT1/MT2
 +
      - Interdependent version for [[MaskTools]] or [[MaskTools2]]
 +
      - For all changes see [http://forum.doom9.org/showthread.php?p=1190302#post1190302 here]<br>
 +
  Changes [http://forum.doom9.org/showthread.php?p=841483#post841483 circa 2005:]
 +
    - GrainFactory
 +
      - Initial release
  
 
== Links ==
 
== Links ==
 +
*[http://forum.doom9.org/showthread.php?t=141303 Doom9 Forum] - GrainFactory discussion.
 +
<br>
 +
<br>
 +
<br>
 +
-----------------------------------------------
 +
'''Back to [[External_filters#Effects|External Filters]] &larr;'''

Revision as of 15:26, 28 December 2013

Abstract
Author Didée
Version 3
Download GrainFactory3.avsi
Category Effects
Requirements
  • YV12
License
Discussion


Contents

Description

Noise generator that tries to simulate the behavior of silver grain on film..


Requirements:

- AviSynth 2.5.8 or later
- Supported color formats: YV12
- Progressive input only

Required Filters:


Syntax and Parameters

GrainFactory3 (clip clp, int "g1str", int "g2str", int "g3str", int "g1shrp", int "g2shrp", int "g3shrp", float "g1size", float "g2size", float "g3size", int "g1tex", int "g2tex", int "g3tex", int "temp_avg", int "ontop_grain", int "th1", int "th2", int "th3", int "th4")


Strength of grain:
g1str int = 13
Strength of grain / for dark areas.
Range: 0 - ???
g2str int = 15
Strength of grain / for midtone areas.
Range: 0 - ???
g3str int = 25
Strength of grain / for bright areas.
Range: 0 - ???


Sharpness of grain:
g1shrp int = 60
Sharpness of grain / for dark areas (NO EFFECT when g1size=1.0 !!)
Range: 0 - 100
g2shrp int = 66
Sharpness of grain / for midtone areas (NO EFFECT when g2size=1.0 !!)
Range: 0 - 100
g3shrp int = 80
Sharpness of grain / for bright areas (NO EFFECT when g3size=1.0 !!)
Range: 0 - 100


Size of grain:
g1size float = 1.50
Size of grain / for dark areas.
Range: 0.5 - 4.0
g2size float = 1.20
Size of grain / for mid-tone areas.
Range: 0.5 - 4.0
g3size float = 0.90
Size of grain / for bright areas
Range: 0.5 - 4.0


Texture:
g1tex int = 0
Strength of "material texture" appearance.
Range: 0 - 100
g2tex int = 0
(In fact: 'bump' effect)
Range: 0 - 100
g3tex int = 0
For dark / midtone / bright grain.
Range: 0 - 100


Temporal averaging:
temp_avg int = 0
Percentage of noise's temporal averaging.
Range: 0 - 100


Mixing zone:
th1 int = 24
Start of dark->midtone mixing zone.
th2 int = 56
End of dark->midtone mixing zone.
th3 int = 128
Start of midtone->bright mixing zone.
th4 int = 160
End of midtone->bright mixing zone


On top grain:
ontop_grain int = 0
additional grain to put on top of previously generated grain.
Range:0 - ???


Examples

AviSource("Blah.avi")
Grainfactory3(5,7,10)

Changelog

 Changes 2008-10-03:
   - GrainFactory3
     - Shorten parameters' names
     - Add "mixing zone" parameters
     - Restructure parameters. Better control for dark, midtone, and bright areas.
Changes 2008-10-01: - GrainFactory_MT1/MT2 - Interdependent version for MaskTools or MaskTools2 - For all changes see here
Changes circa 2005: - GrainFactory - Initial release

Links





Back to External Filters

Personal tools