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:

PropertyType
OutputFormatstringFour character code that specifies the output pixel format.
WidthintegerFrame width in pixels.
HeightintegerFrame height in pixels.
ResizeModeintegerSpecifies the method used to scale the video to the output image dimensions:
0 Fit (letterbox/pillarbox)
1 Stretch
2 Crop
TimeScaleintegerStream timescale in ticks per second (e.g. 30000).
FrameDurationintegerNominal frame duration in timescale ticks (e.g. 1001).
FieldOrderintegerSee field_order.
ColorPrimariesintegerSee color_primaries.
TransferCharacteristicsintegerSee transfer_characteristics.
MatrixCoefficientsintegerSee matrix_coefficients.
VideoRangeintegerSee video_ range.

Motion Compensation

The following properties configure motion compensated frame rate conversion.

PropertyTypeDescription
EnableMotionCompensationbooleanEnables or disables motion compensated frame rate conversion.
MotionAmountintegerAmount of motion compensation to apply:
0 Lowest
1 Low
2 Medium
3 High
4 Highest
5 Auto (default)
ExtremeMotionAmountintegerAmount of motion compensation applied to high motion frames.
FallbackSizeintegerSize of the fallback region:
0 Small
1 Medium
2 Large
3 Extra Large
4 Auto
ExtremeFallbackSizeintegerSize of the fallback region for high motion frames.
MotionBlockSizeintegerSize 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)
ExtremeMotionBlockSIzeintegerSize of the motion estimation block for high motion frames.

Inverse Telecine

The following properties configure telecine pulldown removal.

PropertyTypeDescription
AllowRemovePulldownbooleanEnables pulldown removal (inverse telecine).
EnablePostPulldownFilterbooleanApplies the de-interlacing filter to frames after pulldown removal.
IsCartoonbooleanSet to true of the pre-telecine frames are repeated as is typical in cartoon and anime content.
MoreSensitiveRemovePulldownbooleanLowers the pulldown detection threshold.

Telecine

The following properties configure telecine pulldown insertion:

PropertyTypeDescription
AllowAddStandardPDboolean3:2 pulldown (24p to 30i).
AllowAdd2_2PDboolean2:2 pulldown (25p to 25i, 30p to 30p).
AllowAdd_4_4PDboolean4:4 pulldown (25p to 50p, 30p to 60p).
AllowAdd_4_6PDboolean4:6 pulldown (24p to 60p).
AllowAddEuroPDboolean2:3 pulldown (24p to 25i).
AllowAddAdaptivePDbooleanAdaptive pulldown (23p to 25i, 29p to 25i).

Scene Cut

The following properties configure scene change/cut detection:

PropertyTypeDescription
CutDetectionSensitivitynumberSmaller 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.
EnableProgresiveSceneCutsbooleanFor interlaced output the frames before and after each scene cut will be progressive.