ShowFrameNumber - Revision history

Reel.Deal: add link to avs+ documentation

2022-09-17T08:07:59Z

add link to avs+ documentation

Raffriff42: Undo previous after rereading source code

2016-03-20T00:10:44Z

Undo previous after rereading source code

Raffriff42: correction, size = float

2016-03-19T23:12:37Z

correction, size = float

Raffriff42: formatting

2016-02-28T10:21:47Z

formatting

Raffriff42: bounds excluded, touch up

2016-01-22T13:51:38Z

bounds excluded, touch up

Raffriff42: use :Template:BlueBox2 and :Template:BoldColor

2016-01-22T04:55:59Z

use Template:BlueBox2 and Template:BoldColor

Admin: /* Drop-Frame versus Non-Drop-Frame Time Code */

2016-01-21T21:18:20Z

‎Drop-Frame versus Non-Drop-Frame Time Code

Admin: /* Drop-Frame versus Non-Drop-Frame Time Code */

2016-01-21T21:14:23Z

‎Drop-Frame versus Non-Drop-Frame Time Code

Admin: /* ShowSMPTE */

2016-01-21T19:01:28Z

‎ShowSMPTE

Raffriff42: /* Drop-Frame versus Non-Drop-Frame Time Code */ one more touch up

2016-01-21T02:52:47Z

‎Drop-Frame versus Non-Drop-Frame Time Code: one more touch up

← Older revision		Revision as of 08:07, 17 September 2022
Line 1:		Line 1:
		+	<div {{BlueBox2\|40\|0\|3px solid purple}} >
		+	{{AvsPlusFullname}}<br>
		+	Up-to-date documentation: [https://avisynthplus.readthedocs.io/en/latest/avisynthdoc/corefilters/showframes.html https://avisynthplus.readthedocs.io]
		+	</div>
		+
	Show frame number or time on the screen.		Show frame number or time on the screen.
	__TOC__		__TOC__

@@ Line 7: / Line 7: @@
 |ShowFrameNumber(clip ''clip'' [, bool ''scroll'', int ''offset'', float ''x'', float ''y'', <br>
 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
-string ''font'', float ''size'', int ''text_color'', int ''halo_color'', float ''font_width'', float ''font_angle'' ] )
+string ''font'', int ''size'', int ''text_color'', int ''halo_color'', float ''font_width'', float ''font_angle'' ] )
 }}
@@ Line 34: / Line 34: @@
 ::Font name. All installed fonts on the current machine are available. Default "Arial"
-:{{Par2|size|float|24.0}}
+:{{Par2|size|int|24}}
 ::Height of the text in pixels. Default 24.
@@ Line 72: / Line 72: @@
 |ShowSMPTE(clip ''clip'' [, float ''fps'', string ''offset'', int ''offset_f'', float ''x'', float ''y'', <br>
 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
-string ''font'', float ''size'', int ''text_color'', int ''halo_color'', float ''font_width'', float ''font_angle'' ] )
+string ''font'', int ''size'', int ''text_color'', int ''halo_color'', float ''font_width'', float ''font_angle'' ] )
 }}
@@ Line 112: / Line 112: @@
 ::Font name. All installed fonts on the current machine are available. Default "Arial"
-:{{Par2|size|float|24.0}}
+:{{Par2|size|int|24}}
 ::Height of the text in pixels. Default 24.
@@ Line 226: / Line 226: @@
 |ShowTime(clip ''clip'' [int ''offset_f'', float ''x'', float ''y'', <br>
 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
-string ''font'', float ''size'', int ''text_color'', int ''halo_color'', float ''font_width'', float ''font_angle'' ] )
+string ''font'', int ''size'', int ''text_color'', int ''halo_color'', float ''font_width'', float ''font_angle'' ] )
 }}
@@ Line 246: / Line 246: @@
 ::Font name. All installed fonts on the current machine are available. Default "Arial"
-:{{Par2|size|float|24.0}}
+:{{Par2|size|int|24}}
 ::Height of the text in pixels. Default 24.

@@ Line 7: / Line 7: @@
 |ShowFrameNumber(clip ''clip'' [, bool ''scroll'', int ''offset'', float ''x'', float ''y'', <br>
 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
-string ''font'', int ''size'', int ''text_color'', int ''halo_color'', float ''font_width'', float ''font_angle'' ] )
+string ''font'', float ''size'', int ''text_color'', int ''halo_color'', float ''font_width'', float ''font_angle'' ] )
 }}
@@ Line 34: / Line 34: @@
 ::Font name. All installed fonts on the current machine are available. Default "Arial"
-:{{Par2|size|int|24}}
+:{{Par2|size|float|24.0}}
 ::Height of the text in pixels. Default 24.
@@ Line 72: / Line 72: @@
 |ShowSMPTE(clip ''clip'' [, float ''fps'', string ''offset'', int ''offset_f'', float ''x'', float ''y'', <br>
 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
-string ''font'', int ''size'', int ''text_color'', int ''halo_color'', float ''font_width'', float ''font_angle'' ] )
+string ''font'', float ''size'', int ''text_color'', int ''halo_color'', float ''font_width'', float ''font_angle'' ] )
 }}
@@ Line 112: / Line 112: @@
 ::Font name. All installed fonts on the current machine are available. Default "Arial"
-:{{Par2|size|int|24}}
+:{{Par2|size|float|24.0}}
 ::Height of the text in pixels. Default 24.
@@ Line 226: / Line 226: @@
 |ShowTime(clip ''clip'' [int ''offset_f'', float ''x'', float ''y'', <br>
 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
-string ''font'', int ''size'', int ''text_color'', int ''halo_color'', float ''font_width'', float ''font_angle'' ] )
+string ''font'', float ''size'', int ''text_color'', int ''halo_color'', float ''font_width'', float ''font_angle'' ] )
 }}
@@ Line 246: / Line 246: @@
 ::Font name. All installed fonts on the current machine are available. Default "Arial"
-:{{Par2|size|int|24}}
+:{{Par2|size|float|24.0}}
 ::Height of the text in pixels. Default 24.

@@ Line 3: / Line 3: @@
 == ShowFrameNumber ==
+<div style="max-width:62em" >
-{{Template:FuncDef
+{{FuncDef
 |ShowFrameNumber(clip ''clip'' [, bool ''scroll'', int ''offset'', float ''x'', float ''y'', <br>
 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
-string ''font'', int ''size'', int ''text_color'', int ''halo_color'', float ''font_width'', float ''font_angle''])}}
+string ''font'', int ''size'', int ''text_color'', int ''halo_color'', float ''font_width'', float ''font_angle'' ] )
 Draws text on every frame indicating what frame number AviSynth sees at that point in the script. This is sometimes useful when writing scripts. If you apply additional filters to the clip, 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. Sometimes this is what you want, as it shows frame blending etc.
@@ Line 62: / Line 63: @@
   [[DGDecode/MPEG2Source|Mpeg2Source]]("clip.d2v")
   ShowFrameNumber(scroll=true, offset=9, text_color=$ff0000)
 </div>
 == ShowSMPTE ==
+<div style="max-width:62em" >
-{{Template:FuncDef|ShowSMPTE(clip ''clip'' [, float ''fps'', string ''offset'', int ''offset_f'', float ''x'', float ''y'', <br>
+{{FuncDef
 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
-string ''font'', int ''size'', int ''text_color'', int ''halo_color'', float ''font_width'', float ''font_angle''])}}
+string ''font'', int ''size'', int ''text_color'', int ''halo_color'', float ''font_width'', float ''font_angle'' ] )
 Displays [http://en.wikipedia.org/wiki/SMPTE_timecode SMPTE]-style timecode labels for the current frame. Format is ''HH:MM:SS:FF'' (for example "03:52:39:24" = 3 hours, 52 minutes, 39 seconds and 24 frames).
@@ Line 213: / Line 217: @@
 <div id="SMPTE_Example4" {{BoxWidthIndent|60|2}} >
   ShowSMPTE(offset="00:00:59:29", x=360, y=576, font="georgia", size=24, text_color=$ff0000)
 </div>
-{{Template:FuncDef|ShowTime(clip ''clip'' [int ''offset_f'', float ''x'', float ''y'', <br>
+== ShowTime ==
 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
-string ''font'', int ''size'', int ''text_color'', int ''halo_color'', float ''font_width'', float ''font_angle''])}}
+string ''font'', int ''size'', int ''text_color'', int ''halo_color'', float ''font_width'', float ''font_angle'' ] )
 Displays time for the current frame. Format is ''HH:MM:SS.DDD'' (for example "03:52:39.800" = 3 hours, 52 minutes, 39 seconds and 800 milliseconds).
@@ Line 261: / Line 269: @@
   ShowTime
 |}
 == Changes ==
 {| border="1"
 |-
 | 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).
+| All functions: position (x,y) can be float (previously int) (with 0.125 pixel granularity).<br>ShowSMPTE: added drop-frame for other framerates (other than 30).
 |-
 | v2.58
@@ Line 278: / Line 288: @@
 | ShowSMPTE: fps argument is made optional (and taken from the clip by default).
 |}
 [[Category:Internal filters]]
 [[Category:Debugging/Diagnostic filters]]

@@ Line 159: / Line 159: @@
 |style="text-align:center"|59.94
 |-
-|style="text-align:center;letter-spacing:-0.03em;"|119.8791 – 119.8809
+|style="text-align:center;letter-spacing:-0.03em;"|119.879 - 119.881
 |style="text-align:center;letter-spacing:-0.03em;"|120×1000/1001
 |style="text-align:center;letter-spacing:-0.03em;"|119.88

@@ Line 77: / Line 77: @@
 Due to antialiased text rendering, this filter can be a little slow.
-<div style="margin:1em 0 0 2em; padding:0.5em; width:56em; border:2px solid black; background-color:#F8F8FF;" >
+<div {{BlueBox2|56|2|2px solid black}} >
-<span style="color:blue;font-weight:bold;font-style:italic;font-size:110%;">Note: </span><br>
+{{BoldColor|blue|110|''Note:''}}<br>
 With certain exceptions, SMPTE timecode has no concept of fractional frame rates (like 24.5 fps for example).

@@ Line 135: / Line 135: @@
 </div>
 <div id="drop_frame_rates" style="display:inline;font-size:50%;height:0;line-height:0;overflow:hidden;"></div>
-'''ShowSMPTE''' automatically assumes drop-frame timecode given certain input framerate ranges, as listed in the table below. For example, if the input framerate is > 29.969 and < 29.971 fps, the framerate is assumed to be 30×1000/1001 for time calculation, and drop-frame counting is used.
+'''ShowSMPTE''' automatically assumes [https://web.archive.org/web/20090206001750/http://teched.vt.edu/gcc/HTML/VirtualTextbook/PDFs/AdobeTutorialsPDFs/Premiere/PremiereTimecode.pdf drop-frame timecode] given certain input framerate ranges, as listed in the table below. For example, if the input framerate is > 29.969 and < 29.971 fps, the framerate is assumed to be 30×1000/1001 for time calculation, and drop-frame counting is used.
 <div {{BoxWidthIndent|30|1}} >
 {| class="wikitable"

@@ Line 139: / Line 139: @@
 {| class="wikitable"
 |-
-! input fps
+! input fps (bounds excluded)
 ! &nbsp;assumed rate&nbsp;
 ! nominal rate
 |-
-|style="text-align:center"|23.9751 – 23.9769
+|style="text-align:center"|23.975 – 23.977
 |style="text-align:center"|24×1000/1001
 |style="text-align:center"|23.98
 |-
-|style="text-align:center"|29.9691 – 29.9709
+|style="text-align:center"|29.969 – 29.971
 |style="text-align:center"|30×1000/1001
 |style="text-align:center"|29.97
 |-
-|style="text-align:center"|47.9511 – 47.9529
+|style="text-align:center"|47.951 – 47.953
 |style="text-align:center"|48×1000/1001
 |style="text-align:center"|47.95
 |-
-|style="text-align:center"|59.9391 – 59.9409
+|style="text-align:center"|59.939 – 59.941
 |style="text-align:center"|60×1000/1001
 |style="text-align:center"|59.94

@@ Line 81: / Line 81: @@
 With certain exceptions, SMPTE timecode has no concept of fractional frame rates (like 24.5 fps for example).
-'''ShowSMPTE''' source clips should have an ''integer'' framerate (18, 24, 25, 30, 31,...) or a ''drop-frame'' rate ('29.97' being the most common). Supported drop-frame rates are listed in the table [[#drop_frame_rates|below]].
+'''ShowSMPTE''' source clips must have an ''integer'' framerate (18, 24, 25, 30, 31,...) or a ''drop-frame'' rate ('29.97' being the most common). Supported drop-frame rates are listed in the table [[#drop_frame_rates|below]]. If that's not the case an error will be thrown.
-If the framerate is not integral or drop-frame (let's call it "nonstandard" for short), the timecode readout will not quite correspond to ''real'' or clock time. Use '''ShowFrameNumber''' or '''ShowTime''' instead.
+If the framerate is not integral or drop-frame (let's call it "nonstandard" for short), use '''ShowFrameNumber''' or '''ShowTime''' instead.
 You may encounter media sources that are ''almost'' at a standard framerate, but not quite – perhaps due to an error in processing at some point, or perhaps the source was something like a security camera or a video game console. In this case you should force the clip to the nearest standard framerate with [[AssumeFPS]].

@@ Line 73: / Line 73: @@
 Displays [http://en.wikipedia.org/wiki/SMPTE_timecode SMPTE]-style timecode labels for the current frame. Format is ''HH:MM:SS:FF'' (for example "03:52:39:24" = 3 hours, 52 minutes, 39 seconds and 24 frames).
-Frame 0 is marked "00:00:00:00", frame 1 is marked "00:00:00:01" and so on - unless an ''offset'' is applied.
+Frame 0 is marked "00:00:00:00", frame 1 is marked "00:00:00:01" and so on – unless an ''offset'' is applied.
 Due to antialiased text rendering, this filter can be a little slow.
@@ Line 85: / Line 85: @@
 If the framerate is not integral or drop-frame (let's call it "nonstandard" for short), the timecode readout will not quite correspond to ''real'' or clock time. Use '''ShowFrameNumber''' or '''ShowTime''' instead.
-You may encounter media sources that are ''almost'' at a standard framerate, but not quite – perhaps due to an error in processing at some point. In this case you should force the clip to the nearest standard framerate with [[AssumeFPS]].
+You may encounter media sources that are ''almost'' at a standard framerate, but not quite – perhaps due to an error in processing at some point, or perhaps the source was something like a security camera or a video game console. In this case you should force the clip to the nearest standard framerate with [[AssumeFPS]].
 </div>