ShowFrameNumber

ShowFrameNumber draws text on every frame indicating what number AviSynth thinks it is. This is sometimes useful when writing scripts. If you apply additional filters to the clip produced by ShowFrameNumber, they will treat the text on the frame just as they would treat an image, so the numbers may be distorted by the time you see them.

If scroll (default: false) is set to true the frame number will be drawn only once on the video and scroll from top to bottom, else it will be drawn on one side as often as it fits. For top field first material the framenumber will be drawn on the left side of the clip, for bottom field first material on the right side and for field-based material it will be drawn alternating on the left side and right side of the clip (depending whether the field is top or bottom).

Starting from v2.56 other options (offset, x, y, font, size, text_color, halo_color, font_width, font_angle) are present. offset enables the user to add an offset to the shown framenumber. See Subtitle for an explanation of the other options - note that x and y must be used together or not at all; if they are present, the scroll option is ignored. In ShowFrameNumber, their interpretation corresponds to use with align=4 in Subtitle and the special meaning of -1 is not available. Default size is 24 instead of 18 as in Subtitle.

ShowSMPTE

ShowSMPTE(clip clip [, float fps, string offset, int offset_f, float x, float y, string font, int size, int text_color, int halo_color, float font_width, float font_angle])

ShowSMPTE is similar to ShowFrameNumber but displays SMPTE timecode (hours:minutes:seconds:frame). Starting from v2.53 the fps argument is not required, unless the current fps can't be used. Otherwise, the fps argument is required and must be 24, 25, 30, or 29.97. Starting from v2.56 other options (offset, offset_f, x, y, font, size, text_color, halo_color, font_width, font_angle) are present. offset enables the user to add an offset to the timecode, while offset_f enables the user to add an offset to the timecode specifying the number of frames (offset takes precedence over offset_f). See Subtitle for an explanation of the other options. In ShowSMPTE, the interpretation of x and y corresponds to use with align=5 in Subtitle and the special meaning of -1 is not available. Default size is 24 instead of 18 as in Subtitle.

Take care: both filters are due to text-drawing quite slow.

drop-frame versus non-drop-frame timecode

For some framerates the drop-frame timecode is enabled. If for example the framerate of the clip is between 29.969 and 29.971 it is enabled. Originally, when the signal of the TV was black and white, NTSC ran at 60 Hz (30 fps). When they added color, they changed it to 59.94 Hz (29.97 fps) due to technical reasons. They run 1000 frames, but count 1001 (they never actually drop a frame, just a frame number). The first two frames are dropped of every minute except the tenth, ie 00:00:00:00, 00:00:00:01, 00:00:00:02, ..., 00:00:59:29, 00:01:00:02, 00:01:00:03, 00:01:59:29, 00:02:00:02, 00:02:00:03, ..., 00:08:59:29, 00:09:00:02, 00:09:00:03, ..., 00:09:59:29, 00:10:00:00, 00:10:00:01, etc ... Counting the dropped frames implies that 00:10:00:00 in drop-frame matches 00:10:00:00 in real time.

Something similar holds also for the following framerates:

framerate range	base-rate
[29.969, 29.971]	30
[47.951, 47.953]	48
[59.939, 59.941]	60
[119.879, 119.881]	120

Examples

ShowSMPTE(offset="00:00:59:29", x=360, y=576, font="georgia", size=24, text_color=$ff0000)

# will draw the framenumber on the left side of the clip using an offset of 9 frames, scrolling from top to bottom
Mpeg2Source("clip.d2v") # is always top field first
ShowFrameNumber(scroll=true, offset=9, text_color=$ff0000)

ShowTime

ShowTime(clip clip [int offset_f, float x, float y, string font, int size, int text_color, int halo_color, float font_width, float font_angle])

ShowTime is similar to ShowSMPTE, but it displays just the time of the video instead of the SMPTE timecode. See ShowSMPTE for an explanation of the options.

Changes:

v2.60	All functions: position (x,y) can be float (previously int) (with 0.125 pixel granularity). ShowSMPTE: added drop-frame for other framerates (other than 30).
v2.58	Added ShowTime. Added font_width and font_angle.
v2.56	Added offset and other options.

ShowFrameNumber

Contents