View source for ColorBars

<div style="max-width:62em" >
__TOC__


:[[File:SMPTE_Color_Bars-320x240.png]]

{{FuncDefH4|ColorBars}}
{{FuncDef
|ColorBars ( [ int ''width'', int ''height'', string ''pixel_type'' ] )
}}<br>
{{FuncDefH4|ColorBars}}
{{FuncDef
|ColorBars ( [ int ''width'', int ''height'', string ''pixel_type'', bool ''staticframes'' ] ) {{AvsPluscon}}
}}

Produces a video clip containing SMPTE color bars (Rec. ITU-R BT.801-1) scaled to any image size. 

By default, a 640×480, [[RGB32]], [[#TV range|TV range]], [[ShowFrameNumber#Drop-Frame_versus_Non-Drop-Frame_Time_Code|29.97 fps]], 1 hour long clip is produced. 

:{{Par2|width|int|640}}
:{{Par2|height|int|480}}
::Set size of the returned clip.

:{{Par2|pixel_type|string|"RGB32"}}
::Set color format of the returned clip.
::May be any of the following: "YUY2", "YV12", "YV24" (v2.60), or (default) "RGB32".
::{{AvsPluscon}} "RGB32", "RGB64", "YUY2", [[Avisynthplus_color_formats|or any planar RGB, 4:2:0 or 4:4:4 format]].

:{{Par2|staticframes|bool|true}}
::{{AvsPluscon}} If set to false, generate all frames. Default true (one static frame is served)



:[[File:SMPTE_Color_Bars16x9-320x180.png]]

{{FuncDefH4|ColorBarsHD}}
{{FuncDef
|ColorBarsHD ( [ int ''width'', int ''height'', string ''pixel_type'' ] )
}}<br>
{{FuncDef
|ColorBarsHD ( [ int ''width'', int ''height'', string ''pixel_type'', bool ''staticframes'' ] ) {{AvsPluscon}}
}}

Added in v2.60, '''ColorBarsHD''' produces a video clip containing SMPTE color bars <br>
(Rec. ITU-R BT.709 / [http://www.arib.or.jp/english/html/overview/img/arib_std-b28v1.0_e.pdf arib std b28 v1.0]) scaled to any image size. 

By default, a 1288×720, [[YV24]], [[#TV range|TV range]], [[ShowFrameNumber#Drop-Frame_versus_Non-Drop-Frame_Time_Code|29.97 fps]], 1 hour long clip is produced. 

:{{Par2|width|int|1288}}
:{{Par2|height|int|720}}
::Set size of the returned clip.

:{{Par2|pixel_type|string|"YV24"}}
::Set color format of the returned clip. Must be "YV24". 
::{{AvsPluscon}} "YV24" or [[Avisynthplus_color_formats|other 4:4:4 format]].

:{{Par2|staticframes|bool|true}}
::{{AvsPluscon}} If set to false, generate all frames. Default true (one static frame is served)

==== A note on notation ====
This page adopts the ''ITU style'' when discussing video levels which might be represented at different bit depths:
<div {{BoxWidthIndent|52|2}} >
{{BoldColor|blue|100|“}} To avoid confusion between 8-bit and 10-bit representations, the eight most-significant bits are considered to be an ''integer'' part while the two additional bits, if present, are considered to be
''fractional'' part.

For example, the bit pattern <code>10010001</code> would be expressed as 145<sub>d</sub>, <br>
whereas the pattern <code>1001000101</code> would be expressed as 145.25<sub>d</sub>.{{BoldColor|blue|100|”}}<br>

<sup>[https://www.itu.int/rec/R-REC-BT.601-7-201103-I/en ITU-R BT.601-7 (page 4)]</sup>
</div> 

Video levels shown below with the subscript "d" are assumed to be scaled by 2^(''bit depth''-8). <br>
For example, 235<sub>d</sub> at bit depth 10 becomes 235 × 2^(10-8) =  235 × 4 = 940.

:''see {{Deep_color}}''
:''see [[Avisynthplus color formats]] '' {{AvsPluscon}}

==== TV range ====
For both filters, in all color formats, luminance levels are [[Luminance_levels#What_are_luminance_levels.3F|TV range]], where black=16<sub>d</sub><br>
and white=235<sub>d</sub>, within a total possible range of 0-255<sub>d</sub>. 

The table below show the TV-range values '''ColorBarsHD''' generates, and those same values as they should be after converting to full range.
:<tt>Y<sub>full</sub> = (Y<sub>tv</sub>-16<sub>d</sub>)&nbsp; × 255<sub>d</sub>/(235<sub>d</sub>-16<sub>d</sub>) // (for R, G, B, Y)</tt>
:<tt>U<sub>full</sub> = (U<sub>tv</sub>-128<sub>d</sub>) × 255<sub>d</sub>/(240<sub>d</sub>-16<sub>d</sub>) + 128<sub>d</sub> // (for U, V)</tt>

:<tt>Y<sub>tv</sub>&nbsp;&nbsp; = Y<sub>full</sub> ×  (235<sub>d</sub>-16<sub>d</sub>)/255<sub>d</sub> + 16<sub>d</sub>  // (for R, G, B, Y)</tt>
:<tt>U<sub>tv</sub>&nbsp;&nbsp; = (U<sub>full</sub>-128<sub>d</sub>) × (240<sub>d</sub>-16<sub>d</sub>)/255<sub>d</sub> + 128<sub>d</sub> // (for U, V)</tt>

:{| class="wikitable"
!rowspan="2" style="width:10em"| Color bar&nbsp;
!colspan="7"| TV range output
!
!colspan="7"| (expanded to full range)
|-
! R
! G
! B
!
! Y
! U
! V
!
! R
! G
! B
!
! Y
! U
! V
|-
| '''75% White'''
| style="text-align:right"| 180<sub>d</sub>
| style="text-align:right"| 180<sub>d</sub>
| style="text-align:right"| 180<sub>d</sub>
| style="text-align:right"| 
| style="text-align:right"| 180<sub>d</sub>
| style="text-align:right"| 128<sub>d</sub>
| style="text-align:right"| 128<sub>d</sub>
|
| style="text-align:right"| 191<sub>d</sub>
| style="text-align:right"| 191<sub>d</sub>
| style="text-align:right"| 191<sub>d</sub>
| style="text-align:right"| 
| style="text-align:right"|191<sub>d</sub>
| style="text-align:right"|128<sub>d</sub>
| style="text-align:right"|128<sub>d</sub>
|-
| '''75% Yellow'''
| style="text-align:right"| 180<sub>d</sub>
| style="text-align:right"| 180<sub>d</sub>
| style="text-align:right"| 16<sub>d</sub>
| style="text-align:right"| 
| style="text-align:right"|168<sub>d</sub>
| style="text-align:right"|44<sub>d</sub>
| style="text-align:right"|136<sub>d</sub>
|
| style="text-align:right"| 191<sub>d</sub>
| style="text-align:right"| 191<sub>d</sub>
| style="text-align:right"| 0<sub>d</sub>
| style="text-align:right"| 
| style="text-align:right"|177<sub>d</sub>
| style="text-align:right"|32<sub>d</sub>
| style="text-align:right"|137<sub>d</sub>
|-
| '''75% Cyan'''
| style="text-align:right"| 16<sub>d</sub>
| style="text-align:right"| 180<sub>d</sub>
| style="text-align:right"| 180<sub>d</sub>
| style="text-align:right"| 
| style="text-align:right"|145<sub>d</sub>
| style="text-align:right"|147<sub>d</sub>
| style="text-align:right"| 44<sub>d</sub>
|
| style="text-align:right"| 0<sub>d</sub>
| style="text-align:right"| 191<sub>d</sub>
| style="text-align:right"| 191<sub>d</sub>
| style="text-align:right"| 
| style="text-align:right"|150<sub>d</sub>
| style="text-align:right"|149<sub>d</sub>
| style="text-align:right"|32<sub>d</sub>
|-
| '''75% Green'''
| style="text-align:right"| 16<sub>d</sub>
| style="text-align:right"| 180<sub>d</sub>
| style="text-align:right"| 16<sub>d</sub>
| style="text-align:right"| 
| style="text-align:right"|134<sub>d</sub>
| style="text-align:right"|63<sub>d</sub>
| style="text-align:right"|52<sub>d</sub>
|
| style="text-align:right"| 0<sub>d</sub>
| style="text-align:right"| 191<sub>d</sub>
| style="text-align:right"| 0<sub>d</sub>
| style="text-align:right"| 
| style="text-align:right"|137<sub>d</sub>
| style="text-align:right"|54<sub>d</sub>
| style="text-align:right"|41<sub>d</sub>
|-
| '''75% Magenta'''
| style="text-align:right"| 180<sub>d</sub>
| style="text-align:right"| 16<sub>d</sub>
| style="text-align:right"| 180<sub>d</sub>
| style="text-align:right"| 
| style="text-align:right"|63<sub>d</sub>
| style="text-align:right"|193<sub>d</sub>
| style="text-align:right"|204<sub>d</sub>
|
| style="text-align:right"| 191<sub>d</sub>
| style="text-align:right"| 0<sub>d</sub>
| style="text-align:right"| 191<sub>d</sub>
| style="text-align:right"| 
| style="text-align:right"|55<sub>d</sub>
| style="text-align:right"|201<sub>d</sub>
| style="text-align:right"|214<sub>d</sub>
|-
| '''75% Red'''
| style="text-align:right"| 180<sub>d</sub>
| style="text-align:right"| 16<sub>d</sub>
| style="text-align:right"| 16<sub>d</sub>
| style="text-align:right"| 
| style="text-align:right"|51<sub>d</sub>
| style="text-align:right"|109<sub>d</sub>
| style="text-align:right"| 212<sub>d</sub>
|
| style="text-align:right"| 191<sub>d</sub>
| style="text-align:right"| 0<sub>d</sub>
| style="text-align:right"| 0<sub>d</sub>
| style="text-align:right"| 
| style="text-align:right"|41<sub>d</sub>
| style="text-align:right"|106<sub>d</sub>
| style="text-align:right"|223<sub>d</sub>
|-
| '''75% Bue'''
| style="text-align:right"| 16<sub>d</sub>
| style="text-align:right"| 16<sub>d</sub>
| style="text-align:right"| 180<sub>d</sub>
| style="text-align:right"| 
| style="text-align:right"|28<sub>d</sub>
| style="text-align:right"| 212<sub>d</sub>
| style="text-align:right"|120<sub>d</sub>
|
| style="text-align:right"| 0<sub>d</sub>
| style="text-align:right"| 0<sub>d</sub>
| style="text-align:right"| 191<sub>d</sub>
| style="text-align:right"| 
| style="text-align:right"|14<sub>d</sub>
| style="text-align:right"|223<sub>d</sub>
| style="text-align:right"|118<sub>d</sub>
|}
<div {{NotaBeneWidthIndent|58|2}} >
These colors are at "75%" of maximum, per common broadcast practice. You may occasionally see  "100%" color bars.<sup>[http://trac.ffmpeg.org/wiki/FilteringGuide#multipleinputoverlayin2x2grid]</sup> They are rather useless, as you cannot detect gain or saturation that is too high on a signal that is already at maximum.
</div>

==== PLUGE ====
The lower part of the frame is called the [[Wikipedia:Picture_line-up_generation_equipment|PLUGE]] (also lowercase: "pluge") signal. <br>
From left to right it consists of: [[Wikipedia:YIQ|-I]], white, [[Wikipedia:YIQ|+Q]], then a series of black and near-black bars: 0, -4, 0, +4 and 0 [[Wikipedia:IRE_(unit)|IRE]] relative to black. 

<div {{NotaBeneWidthIndent|58|2}} >
'''Note''' 'IRE' is used here to mean 'percent luminance', on a scale from 0 (black) to 100 (white), ignoring the varying broadcast standards where black might be 0 IRE or 7.5 IRE depending on the country.
</div>

<div {{NotaBeneWidthIndent|54|2}} >
This section documents the '''ColorBars''' pluge only; '''ColorBarsHD''''s pluge is similar, but dispenses with -I and +Q
</div>

The table below show the TV-range values '''ColorBars''' generates, and those same values as they should be after converting to full range.

:{| class="wikitable"
!rowspan="2" style="width:10em"| PLUGE Element&nbsp;
!colspan="7"| TV range output
!
!colspan="7"| (expanded to full range)
|-
! R
! G
! B
!
! Y
! U
! V
!
! R
! G
! B
!
! Y
! U
! V
|-
| '''-I'''
| style="text-align:right"|0<sub>d</sub>
| style="text-align:right"|58<sub>d</sub>
| style="text-align:right"|98<sub>d</sub>
|
| style="text-align:right"|16<sub>d</sub>
| style="text-align:right"|158<sub>d</sub>
| style="text-align:right"|95<sub>d</sub>
|
| style="text-align:right"|-19<sub>d</sub>
| style="text-align:right"|49<sub>d</sub>
| style="text-align:right"|95<sub>d</sub>
|
| style="text-align:right"|0<sub>d</sub>
| style="text-align:right"|162<sub>d</sub>
| style="text-align:right"|90<sub>d</sub>
|-
| '''100% White'''
| style="text-align:right"|235<sub>d</sub>
| style="text-align:right"|235<sub>d</sub>
| style="text-align:right"|235<sub>d</sub>
|
| style="text-align:right"|235<sub>d</sub>
| style="text-align:right"|128<sub>d</sub>
| style="text-align:right"|128<sub>d</sub>
|
| style="text-align:right"|255<sub>d</sub>
| style="text-align:right"|255<sub>d</sub>
| style="text-align:right"|255<sub>d</sub>
|
| style="text-align:right"|255<sub>d</sub>
| style="text-align:right"|128<sub>d</sub>
| style="text-align:right"|128<sub>d</sub>
|-
| '''+Q'''
| style="text-align:right"|59<sub>d</sub>
| style="text-align:right"|15<sub>d</sub>
| style="text-align:right"|126<sub>d</sub>
|
| style="text-align:right"|16<sub>d</sub>
| style="text-align:right"|174<sub>d</sub>
| style="text-align:right"|149<sub>d</sub>
|
| style="text-align:right"|50<sub>d</sub>
| style="text-align:right"|-1<sub>d</sub>
| style="text-align:right"|128<sub>d</sub>
|
| style="text-align:right"|0<sub>d</sub>
| style="text-align:right"|180<sub>d</sub>
| style="text-align:right"|151<sub>d</sub>
|-
| Black
| style="text-align:right"|16<sub>d</sub>
| style="text-align:right"|16<sub>d</sub>
| style="text-align:right"|16<sub>d</sub>
|
| style="text-align:right"|16<sub>d</sub>
| style="text-align:right"|128<sub>d</sub>
| style="text-align:right"|128<sub>d</sub>
|
| style="text-align:right"|0<sub>d</sub>
| style="text-align:right"|0<sub>d</sub>
| style="text-align:right"|0<sub>d</sub>
|
| style="text-align:right"|0<sub>d</sub>
| style="text-align:right"|128<sub>d</sub>
| style="text-align:right"|128<sub>d</sub>
|-
| '''-4 IRE'''
| style="text-align:right"|7<sub>d</sub>
| style="text-align:right"|7<sub>d</sub>
| style="text-align:right"|7<sub>d</sub>
|
| style="text-align:right"|7<sub>d</sub>
| style="text-align:right"|128<sub>d</sub>
| style="text-align:right"|128<sub>d</sub>
|
| style="text-align:right"|-10<sub>d</sub>
| style="text-align:right"|-10<sub>d</sub>
| style="text-align:right"|-10<sub>d</sub>
|
| style="text-align:right"|-10<sub>d</sub>
| style="text-align:right"|128<sub>d</sub>
| style="text-align:right"|128<sub>d</sub>
|-
| Black
| style="text-align:right"|16<sub>d</sub>
| style="text-align:right"|16<sub>d</sub>
| style="text-align:right"|16<sub>d</sub>
|
| style="text-align:right"|16<sub>d</sub>
| style="text-align:right"|128<sub>d</sub>
| style="text-align:right"|128<sub>d</sub>
|
| style="text-align:right"|0<sub>d</sub>
| style="text-align:right"|0<sub>d</sub>
| style="text-align:right"|0<sub>d</sub>
|
| style="text-align:right"|0<sub>d</sub>
| style="text-align:right"|128<sub>d</sub>
| style="text-align:right"|128<sub>d</sub>
|-
| '''+4 IRE'''
| style="text-align:right"|25<sub>d</sub>
| style="text-align:right"|25<sub>d</sub>
| style="text-align:right"|25<sub>d</sub>
|
| style="text-align:right"|25<sub>d</sub>
| style="text-align:right"|128<sub>d</sub>
| style="text-align:right"|128<sub>d</sub>
|
| style="text-align:right"|10<sub>d</sub>
| style="text-align:right"|10<sub>d</sub>
| style="text-align:right"|10<sub>d</sub>
|
| style="text-align:right"|10<sub>d</sub>
| style="text-align:right"|128<sub>d</sub>
| style="text-align:right"|128<sub>d</sub>
|-
| Black
| style="text-align:right"|16<sub>d</sub>
| style="text-align:right"|16<sub>d</sub>
| style="text-align:right"|16<sub>d</sub>
|
| style="text-align:right"|16<sub>d</sub>
| style="text-align:right"|128<sub>d</sub>
| style="text-align:right"|128<sub>d</sub>
|
| style="text-align:right"|0<sub>d</sub>
| style="text-align:right"|0<sub>d</sub>
| style="text-align:right"|0<sub>d</sub>
|
| style="text-align:right"|0<sub>d</sub>
| style="text-align:right"|128<sub>d</sub>
| style="text-align:right"|128<sub>d</sub>
|-
|style="text-align:right;line-height=70%" colspan="16"|''(negative values will be clipped to 0)''
|}

The -I and +Q bars are vestigial artifacts of NTSC analog TV and are not really used any more.

<div {{NotaBeneWidthIndent|58|2}} >
The -4, 0 and +4 IRE bars can be used to set your monitor brightness &ndash; ''assuming'' your playback chain expands [[Luminance_levels#What_are_luminance_levels.3F|TV range]] (16<sub>d</sub>-235<sub>d</sub>) to full-range (0-255<sub>d</sub>) as shown in the images above. The -4 IRE and 0 IRE bars should have the same apparent brightness (they should be as dark as the monitor can display), and the +4 should be a little brighter. If you can see the -4 bar, your monitor brightness is set too high; if you ''cannot'' see the +4 bar, your monitor brightness is set too low.<sup>[http://www.spearsandmunsil.com/portfolio/setting-the-brightness-control-2]</sup>
</div>

Note, the pluge signal goes out of 16-235<sub>d</sub> range in the -I and the -4 bars. These cannot be accurately converted to 0-255<sub>d</sub> range.

More information about the colorbars and the PLUGE can be found on the [[ColorBars_theory|colorbars theory]] page.

==== Audio ====
For both filters, an audio [[Tone|'''tone''']] is also generated. The tone is a 440Hz sine at 48KHz sample rate, 32 bit (Float), stereo. The tone pulses in the right speaker, being turned on and off once every second. Level is [[Wikipedia:DBFS|0 dBFS]]. 

You can use [[Amplify]] to set a softer level (0dB can be a little deafening!)
<div {{BoxWidthIndent|34|2}} >
 ColorBarsHD
 [[AmplifydB|AmplifyDB]](-20)
</div>

<div {{NotaBeneWidthIndent|54|2}} >
Broadcasting organizations usually [[Wikipedia:DBFS#Analog_levels|specify]] an "alignment tone" accompanying colorbars at anywhere from -12 to -20 dBFS; if sending materials to another party, be sure to get their preferred alignment tone level. The exact level doesn't matter as long as all parties agree to it.
</div>

==== Miscellaneous ====
*Note, that for example
<div {{BoxWidthIndent|34|2}} >
 ColorBars(pixel_type="YUY2")
</div>
:...is equivalent to
<div {{BoxWidthIndent|34|2}} >
 ColorBars(pixel_type="RGB32")
 [[ConvertToYUY2]](matrix="PC.601")  
 # "PC.601" / "PC.709" don't scale the luma range
</div>

*When directly generating YUV format data, the color transitions are arranged to occur on a chroma-aligned boundary.

==== Changes ====
{| border="1"
|-
| v2.60
| 
* Added pixel_type="YV24" to ColorBars.
* Initial release of ColorBarsHD.
|-
| v2.56
| Added pixel_type="YUY2"/"YV12".
|}
</div>


[[Category:Internal filters]]
[[Category:Source filters]]
[[Category:Debugging/Diagnostic filters]]