PullDown

Function
This does a standard 24 fps film to 30 fps video conversion. For every four input frames, you end up with five output frames. Since video is divided into fields, it blends the fields by pulling from different film images.

For more information on the fileName syntax, see FileIn.

PullDown with an offset of 2:

film in
A
B
C
D
 
video out
A A
B B
B C
C D
D D
 
frame 1
frame 2
frame 3
frame 4
frame 5

PullDown with an offset of 3:

film in
A
B
C
D
E
video out
A A
B B
C C
C D
D E
 
frame 1
frame 2
frame 3
frame 4
frame 5

 

Parameters
Type
Defaults
Function
fileName
string
  The file path of the input image.
dominance
int
0

Tells what field of the incoming image is placed as the even field. Be careful with this, as Shake reads its images from the bottom up. Other devices and software may read images from the top down, thereby possibly inverting the field dominance.

0 = even field
1 = odd field

offset
int
2
Each group of five frames has three non-blended frames. The offset tells how many of these non-blended frames exist before the blending starts. This value is 2 by default.


Synopis

image PullDown ( 
  const char * fileName, 
  int dominance, 
  int offset
);


Script

image = PullDown ( "fileName", dominance, offset);


Command Line

shake -pulldown fileName dominance offset

Supported File Formats

See Also
PullUp, Average