help file - tdeint.txt

来自「the De-interlace video processing develo」· 文本 代码 · 共 575 行 · 第 1/2 页

      If you do not specify a value for hints explicitly, then TDeint will check to see if hints
      are present in the stream on load and set hints to true if they are, or set it to false
      if not (i.e. it is automatically set).

          *NOTE:  for IVTC post-processing by reading hints it is recommended to use TDeint in 
                  the following fashion making use of the clip2 parameter.

                  orig = last
                  fieldmatcher()
                  TDeint(clip2 = last)


         true - read hints if present
         false - don't read hints

      default - automatically detected on load  (bool)
     

   clip2:

      If using tdeint as a postprocessor for telecide or tfm via the hints parameter (or any field
      matcher), incorrect deinterlacing can occur due to the fact that telecide changes the 
      order of the fields in the original stream (it is a field matcher after all).  This can 
      cause problems in some cases since TDeint really needs to have the original stream.  To 
      work around this you can specify a second clip "clip2" for TDeint to do the actual 
      deinterlacing from.

      In a script this is how it would work:

           mpeg2source("c:\mysource.d2v")
           orig = last
           telecide(guide=1,order=1,hints=true,post=1)
           tdeint(order=1,clip2=orig)

      So TDeint reads the output clip from telecide as usual.  When hints indicate an interlaced
      frame, it does the deinterlacing of the frame using clip2.  This method also perserves the
      hints in the output stream so any other filters that need them later on will still
      work.

      With the addition of full=false, another way to use TDeint as a post-processor is to
      have it use its own combed frame detection as follows (this also allows it to work with
      any field matcher, not just telecide or tfm):

           mpeg2source("c:\mysource.d2v")
           orig = last
           fieldmatcherofchoice()
           tdeint(order=1,full=false,clip2=orig)


      default - NULL  (PClip)


   full:

      If full is set to true, then all frames are processed as usual.  If full=false, all frames
      are first checked to see if they are combed.  If a frame isn't combed then it is returned 
      as is.  If a frame is combed then it is processed as usual.  The parameters that effect 
      combed frame detection are cthresh, chroma, blockx, blocky, and MI.  Full=false allows 
      TDeint to be an ivtc post-processor without the need for hints.

         true - normal processing
         false - check all input frames for combing first
  
      default - true  (bool)

 
   cthresh:

      Area combing threshold used for combed frame detection.  It is like dthresh or dthreshold
      in telecide() and fielddeinterlace().  This essentially controls how "strong" or "visible"
      combing must be to be detected.  Good values are from 6 to 12, if you know your source has 
      a lot of combed frames set this towards the low end (6-7), if you know your source has
      very few combed frames set this higher (10-12).  Going much lower then 5 to 6 or much 
      higher then 12 is not recommended.

      default - 6  (int)


   blockx -

      Sets the x-axis size of the window used during combed frame detection.  This has to do with 
      the size of the area in which MI number of pixels are required to be detected as combed for 
      a frame to be declared combed.  See the MI parameter description for more info.  Possible 
      values are any number that is a power of 2 starting at 4 and going to 2048 (i.e. 4, 8, 16, 
      32, ... 2048).

      Default:  16  (int)


   blocky -

      Sets the y-axis size of the window used during combed frame detection.  This has to do with 
      the size of the area in which MI number of pixels are required to be detected as combed for 
      a frame to be declared combed.  See the MI parameter description for more info.  Possible 
      values are any number that is a power of 2 starting at 4 and going to 2048 (i.e. 4, 8, 16, 
      32, ... 2048).

      Default:  16  (int)

  
   chroma:

      Includes chroma combing in the decision about whether a frame is combed.  Only use this if
      you have one of those weird sources where the chroma can be temporally separated from the luma
      (i.e. the chroma moves but the luma doesn't in a field).  Otherwise it will just end up 
      screwing up the decision most of the time.

         true - include chroma combing
         false - don't
 
      default - false  (bool)

    
   MI:

      # of combed pixels inside any of the blockx by blocky sized blocks on the frame for the 
      frame to be considered combed.  While cthresh controls how "visible" or "strong" the combing 
      must be, this setting controls how much combing there must be in any localized area (a 
      blockx by blocky sized window) on the frame.  Min setting = 0, max setting = blockx x blocky
      (at which point no frames will ever be detected as combed).

      default - 64  (int)


   tryWeave:

      If set to true, when TDeint deinterlaces a frame it will first calculate which field
      (PREV or NEXT) is most similar to the current field.  It will then weave this field
      to create a new frame and check this new frame for combing.  If the new frame is not
      combed, then it returns it. If it is, then it deinterlaces using the usual per-pixel
      motion adaptation.  Basically, this setting allows TDeint to try to use per-field
      motion adaptation instead of per-pixel motion adaptation where possible.

      default - false  (bool)

   
   link:

      Controls how the three planes (YUV) are linked during comb map creation. Possible
      settings:

        0 - no linking
        1 - Full linking (each plane to every other)
        2 - Y to UV (luma to chroma)
        3 - UV to Y (chroma to luma)

      default - 2  (int)


   denoise:

      Controls whether the comb map is denoised or not.  True enables denoising, false disables.

      default - true  (bool)


   AP:

      Artifact protection threshold.  If AP is set to a value greater than or equal to 0, then
      before outputting a deinterlaced frame TDeint will scan all weaved pixels to see if any
      create a value greater then AP.  Any pixels that do will be interpolated.  Use this to
      help prevent very obvious motion adaptive related artifacts, a large value is recommended
      (25+, or as large as removes the artifacts that can be seen during full-speed playback) as 
      smaller values will destroy the benefits of motion adaptivity in static, detailed areas.
      The AP metric is the same as the cthresh metric so the scale is 0-255... at zero everything
      but completely flat areas will be detected as combing, at 255 nothing will be detected.
      Using AP will slow down processing. Set AP to a value less then 0 or greater than
      254 to disable.

      default - -1 (disabled)  (int)


   APType

      When AP post-processing is being used (AP is set >= 0 and < 255), APType controls whether
      the motion of surrounding pixels should be taken into account.  There are 3 possible 
      settings:

        0 = Don't take surrounding motion into account.  If a weaved pixel creates a value that
            exceeds the AP threshold then it will be interpolated.

        1 = If a weaved pixel creates a value that exceeds the AP threshold and at least half of
            pixels in a 5x5 window centered on that pixel were detected as moving, then that
            pixel will be interpolated.

        2 = Exactly like 1, except instead of 1/2 only 1/3 of the pixels in the surrounding 5x5 
            window must have been detected as moving.

      Modes 1 and 2 provide a way to catch more artifacts (low AP values) without completely 
      sacrificing static areas.


      default -  1  (int)
            


CHANGE LIST:


   08/14/2005  v1.0 beta 4
       - SetCacheHints call to diameter instead of radius
       - Fixed type=1 YUY2 interpolation routine giving messed up chroma output (bug was
            introduced in v1.0 beta 3)

   05/14/2005  v1.0 beta 3
       + Added APType parameter, adds 2 new AP post-processing modes that take surrounding motion
             into account
       + Small changes (hopefully improvements) to type 3 (ELA-2) interpolation

   04/26/2005  v1.0 beta 2
       + Added modes -2 and -1... will upsize vertically by a factor of 2 using ELA or ELA2
       + Call SetCacheHints in filter constructor
       + Some small optimizations, should give a very small speed up
 
   04/23/2005  v1.0 beta 1
       + Added AP threshold and post-processing
       + Added blockx and blocky for variable window size during combed frame detection
       - Changed default MI value to 64 (default window size is now 16x16 = 256 pixels)
       - changed default cthresh value to 6
       - Small change to denoising routine

   04/20/2005  v0.9.7.2
       - Fixed not correctly using the field information from tfm's hints when acting as
             a post-processor for it.  Also fixed not correctly altering the match info
             of tfm's hints when acting as a post-processor for it (PP=1 in tfm).
       + Improvements to type 3 interpolation, renamed to modified ELA-2

   03/10/2005  v0.9.7.1
       + Fixed not correctly reading hints from newer versions of tivtc and if colorimetry
             hints were present from dgdecode.

   01/20/2005  v0.9.7
       + Added link and denoise parameters, link defaults to 2 and denoise to true
       + Added ELA interpolation (tomsmocomp version) as type = 3
       + Hints option can now read hints from tfm as well as telecide
       + map = 2 now sets the chroma pixels that are to be interpolated to 255
            and not just the luma
       - Changed default type value to 2 (kernel interpolation)
       - Changed default tryWeave value to false

   10/03/2004  v0.9.6
       + Added full parameter, allows for ivtc post-processing.  full defaults to true.
       + Added cthresh, chroma, and MI parameters... these are used when full=false
       + Added tryWeave option, allows TDeint to adaptively switch between per-field
            and per-pixel motion adaptation.  tryWeave defaults to true.
       + Improved field differencing
       + changed mtnmode default to 1
         
   09/26/2004  v0.9.5
       + Sped up mtnmodes 2 and 3, was doing it the hard way and not the easy way...

   09/25/2004  v0.9.4
       + Added auto hints detection
       + Added mtnmodes 2 and 3
       + Added ability to deinterlace from the original stream when using hints via
            clip2 parameter
       - Fixed field differencing using the wrong fields doh!
       
   09/18/2004  v0.9.3
       + Added order = -1 option, will detect parity from avisynth
       + Added hints option for reading telecide hints for interlaced/progressive
       + 5 field motion check now includes checks over 4 field distances
       - Fixed a bug in YUY2 type = 1 deinterlacing method
       
   09/14/2004  v0.9.2
       + Added kernel interpolation and sharp parameter
       + Added 5 field motion check and mtnmode parameter
       + Changed default motion thresholds to 6

   09/12/2004  v0.9.1
       - Fixed some really stupid bugs, one motion check was incorrect for the first
           and last frame of a clip, and mode = 1 would only work for the first half
           of the video

   09/12/2004  v0.9
       - Initial Release



TODO List:


    - Release a final v1.0 (if no bugs are found)


contact:    doom9.org forum (nick = tritical) or  email:  [e-mail]