Tachyon Filter

The Cinnafilm Tachyon/Dark Energy tdec filter provides advanced de-interlacing, frame rate conversion, noise reduction and upres conversions.

For example the following composition uses Tachyon to convert the output frame rate to 23.976p. The output Width, Height and FieldOrder are specified as properties of the Tachyon filter instead of output.container.video. Likewise the output frame rate is specified by the TimeScale and FrameDuration properties of the filter instead of output.container.video.sample_rate.

---
input:
  container:
  - name: input1
    video:
    - name: v1
    audio:
    - name: a1
output:
  container:
  - name: output1
    video:
    - route:
        name: v1
      filter:
      - type: 'tdec'
        properties:
          Width: 1280
          Height: 720
          TimeScale: 24000
          FrameDuration: 1001
          FieldOrder: 1
          EnableMotionCompensation: true
    audio:
    - route:
        name: a1
{
   "input": {
      "container": [
         {
            "name": "input1",
            "video": [
               {
                  "name": "v1"
               }
            ],
            "audio": [
               {
                  "name": "a1"
               }
            ]
         }
      ]
   },
   "output": {
      "container": [
         {
            "name": "output1",
            "video": [
               {
                  "route": {
                     "name": "v1"
                  },
                  "filter": [
                     {
                        "type": "tdec",
                        "properties": {
                           "Width": 1280,
                           "Height": 720,
                           "TimeScale": 24000,
                           "FrameDuration": 1001,
                           "FieldOrder": 1,
                           "EnableMotionCompensation": true
                        }
                     }
                  ]
               }
            ],
            "audio": [
               {
                  "route": {
                     "name": "a1"
                  }
               }
            ]
         }
      ]
   }
}

Output

The following properties configure the output video format:

Property

Type

OutputFormat

string

Four character code that specifies the output pixel format.

Width

integer

Frame width in pixels.

Height

integer

Frame height in pixels.

ResizeMode

integer

Specifies the method used to scale the video to the output image dimensions:
0 Fit (letterbox/pillarbox)
1 Stretch
2 Crop

TimeScale

integer

Stream timescale in ticks per second (e.g. 30000).

FrameDuration

integer

Nominal frame duration in timescale ticks (e.g. 1001).

FieldOrder

integer

See field_order.

ColorPrimaries

integer

See color_primaries.

TransferCharacteristics

integer

See transfer_characteristics.

MatrixCoefficients

integer

See matrix_coefficients.

VideoRange

integer

See video_ range.

Motion Compensation

The following properties configure motion compensated frame rate conversion.

Property

Type

Description

EnableMotionCompensation

boolean

Enables or disables motion compensated frame rate conversion.

MotionAmount

integer

Amount of motion compensation to apply:
0 Lowest
1 Low
2 Medium
3 High
4 Highest
5 Auto (default)

ExtremeMotionAmount

integer

Amount of motion compensation applied to high motion frames.

FallbackSize

integer

Size of the fallback region:
0 Small
1 Medium
2 Large
3 Extra Large
4 Auto

ExtremeFallbackSize

integer

Size of the fallback region for high motion frames.

MotionBlockSize

integer

Size of the pixel blocks used for motion estimation. Smaller blocks increase performance. Larger blocks improve object detection
0 16 pixels
1 32 pixels
2 64 pixels
3 128 pixels
4 256 pixels
5 Auto (default)

ExtremeMotionBlockSIze

integer

Size of the motion estimation block for high motion frames.

Inverse Telecine

The following properties configure telecine pulldown removal.

Property

Type

Description

AllowRemovePulldown

boolean

Enables pulldown removal (inverse telecine).

EnablePostPulldownFilter

boolean

Applies the de-interlacing filter to frames after pulldown removal.

IsCartoon

boolean

Set to true of the pre-telecine frames are repeated as is typical in cartoon and anime content.

MoreSensitiveRemovePulldown

boolean

Lowers the pulldown detection threshold.

Telecine

The following properties configure telecine pulldown insertion:

Property

Type

Description

AllowAddStandardPD

boolean

3:2 pulldown (24p to 30i).

AllowAdd2_2PD

boolean

2:2 pulldown (25p to 25i, 30p to 30p).

AllowAdd_4_4PD

boolean

4:4 pulldown (25p to 50p, 30p to 60p).

AllowAdd_4_6PD

boolean

4:6 pulldown (24p to 60p).

AllowAddEuroPD

boolean

2:3 pulldown (24p to 25i).

AllowAddAdaptivePD

boolean

Adaptive pulldown (23p to 25i, 29p to 25i).

Scene Cut

The following properties configure scene change/cut detection:

Property

Type

Description

CutDetectionSensitivity

number

Smaller numbers increase the scene cut sensitivity. Typical range is 0.1 to 0.35, default value is 0.2. Set to 0.0 for auto.

EnableProgresiveSceneCuts

boolean

For interlaced output the frames before and after each scene cut will be progressive.


Did this page help you?