ColorBars

From Avisynth wiki
(Difference between revisions)
Jump to: navigation, search
m (added category:Debugging/Diagnostic_filters)
(formatting, links, phrasing)
Line 1: Line 1:
−
{{Template:Func2Def|ColorBars([int ''width''] [, int ''height''] [, string ''pixel_type''])|ColorBarsHD([int ''width''] [, int ''height''] [, string ''pixel_type''])}}
+
<div style="max-width:62em" >
 +
__TOC__
  
−
'''ColorBars''' produces a video clip containing SMPTE color bars (Rec. ITU-R BT.801-1) scaled to any image size.
 
  
−
[[File:SMPTE_Color_Bars-320x240.png]]
+
:[[File:SMPTE_Color_Bars-320x240.png]]
  
−
:By default, a clip is produced of 640x480, RGB32 (alpha channel opaque), 29.97 fps, 1 hour long.
+
{{FuncDefH4|ColorBars}}
−
+
{{FuncDef
−
:''pixel_type'' may be any of the following: "YUY2" (v2.56), "YV12" (v2.56), "YV24" (v2.60), or (default) "RGB32".
+
|ColorBars ( [ int ''width'', int ''height'', string ''pixel_type'' ] )
 +
}}
  
 +
Produces a video clip containing SMPTE color bars (Rec. ITU-R BT.801-1) scaled to any image size.
  
−
'''ColorBarsHD''' (added in v2.60) produces a video clip containing SMPTE (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]) color bars, 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.  
  
−
[[File:SMPTE_Color_Bars16x9-320x180.png]]
+
:{{Par2|width|int|640}}
 +
:{{Par2|height|int|480}}
 +
::Set size of the returned clip.
  
−
:By default, a clip is produced of 1288x720, YV24, TV range (see above), 29.97 fps, 1 hour long.  
+
:{{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".
  
−
:''pixel_type'' must be "YV24".
 
  
 +
:[[File:SMPTE_Color_Bars16x9-320x180.png]]
  
−
For both filters, in all color formats, luminance levels are [[Luminance_levels#What_are_luminance_levels.3F|TV range]], where 0 IRE "black"=16 and 100 IRE "white"=235, within a total possible range of 0-255.
+
{{FuncDefH4|ColorBarsHD}}
−
The [[#pluge|pluge]] (see below) goes to -4 IRE; 'blacker than black'.
+
{{FuncDef
 +
|ColorBarsHD ( [ int ''width'', int ''height'', string ''pixel_type'' ] )
 +
}}
  
−
For both filters, an '''audio tone''' is also generated. Test tone is a 440Hz sine at 48KHz, 16 bit, stereo. The tone pulses in the RIGHT speaker, being turned on and off once every second. Level is [https://en.wikipedia.org/wiki/DBFS 0 dBFS] (wikipedia).
+
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}}
−
Note, that for example
+
:{{Par2|height|int|720}}
 +
::Set size of the returned clip.
  
−
ColorBars(pixel_type="YUY2")
+
:{{Par2|pixel_type|string|"YV24"}}
 +
::Set color format of the returned clip. Must be "YV24".
  
−
is equivalent to
+
==== TV range ====
 +
For both filters, in all color formats, luminance levels are [[Luminance_levels#What_are_luminance_levels.3F|TV range]], where 0 [[Wikipedia:IRE_(unit)|IRE]] "black"=16<br>
 +
and 100 IRE "white"=235, within a total possible range of 0-255.
  
−
ColorBars(pixel_type="RGB32")
+
:{| class="wikitable"
−
ConvertToYUY2(matrix="PC.601")  # "PC.xxx" doesn't scale the luma range
+
! Color bar&nbsp;
 +
! R
 +
! G
 +
! B
 +
!
 +
! Y
 +
! U
 +
! V
 +
|-
 +
| '''75% White'''
 +
| style="text-align:right"| 180
 +
| style="text-align:right"| 180
 +
| style="text-align:right"| 180
 +
| style="text-align:right"|
 +
| style="text-align:right"| 180
 +
| style="text-align:right"| 128
 +
| style="text-align:right"| 128
 +
|-
 +
| '''75% Yellow'''
 +
| style="text-align:right"| 180
 +
| style="text-align:right"| 180
 +
| style="text-align:right"| 16
 +
| style="text-align:right"|
 +
| style="text-align:right"| 162
 +
| style="text-align:right"| 44
 +
| style="text-align:right"| 142
 +
|-
 +
| '''75% Cyan'''
 +
| style="text-align:right"| 16
 +
| style="text-align:right"| 180
 +
| style="text-align:right"| 180
 +
| style="text-align:right"|
 +
| style="text-align:right"| 131
 +
| style="text-align:right"| 156
 +
| style="text-align:right"| 44
 +
|-
 +
| '''75% Green'''
 +
| style="text-align:right"| 16
 +
| style="text-align:right"| 180
 +
| style="text-align:right"| 16
 +
| style="text-align:right"|
 +
| style="text-align:right"| 112
 +
| style="text-align:right"| 72
 +
| style="text-align:right"| 58
 +
|-
 +
| '''75% Magenta'''
 +
| style="text-align:right"| 180
 +
| style="text-align:right"| 16
 +
| style="text-align:right"| 180
 +
| style="text-align:right"|
 +
| style="text-align:right"| 84
 +
| style="text-align:right"| 184
 +
| style="text-align:right"| 198
 +
|-
 +
| '''75% Red'''
 +
| style="text-align:right"| 180
 +
| style="text-align:right"| 16
 +
| style="text-align:right"| 16
 +
| style="text-align:right"|
 +
| style="text-align:right"| 65
 +
| style="text-align:right"| 100
 +
| style="text-align:right"| 212
 +
|-
 +
| '''75% Bue'''
 +
| style="text-align:right"| 16
 +
| style="text-align:right"| 16
 +
| style="text-align:right"| 180
 +
| style="text-align:right"|
 +
| style="text-align:right"| 35
 +
| style="text-align:right"| 212
 +
| style="text-align:right"| 114
 +
|}
 +
These colors are at "75%" of maximum, per common broadcast practice. <br>
 +
You may occasionally see "100%" color bars; they are generated by certain cameras.
  
−
When directly generating YUV format data the color transitions are arranged to occur on a chroma aligned boundary.
+
==== 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]].  
  
 +
<div {{NotaBeneWidthIndent|54|0}} >
 +
This section documents the '''ColorBars''' pluge only; '''ColorBarsHD''''s pluge is similar, but dispenses with -I and +Q
 +
</div>
  
−
----
+
:{| class="wikitable"
−
=====pluge=====
+
! PLUGE Element&nbsp;
−
The lower part of '''ColorBars''' is called the [https://en.wikipedia.org/wiki/Picture_line-up_generation_equipment '''pluge'''] (wikipedia). From left to right it consists of: -I, white, +Q, black, -4/0/+4 IRE levels and black. The -4/0/4 IRE levels can be used to set the brightness correctly. The -4 IRE and 0 IRE should have the same brightness, and the +4 IRE should be a little brighter than -4/0 IRE. The -I/+Q levels are not really interesting, since they are not used anymore for NTSC (analog TV), but they were used to set the chrominance correctly. More information about the colorbars and the pluge can be found on the [[ColorBars_theory]] page.
+
! R
 +
! G
 +
! B
 +
!
 +
! Y
 +
! U
 +
! V
 +
|-
 +
| '''-I'''
 +
| style="text-align:right"|0
 +
| style="text-align:right"|58
 +
| style="text-align:right"|98
 +
|
 +
| style="text-align:right"|16
 +
| style="text-align:right"|158
 +
| style="text-align:right"|95
 +
|-
 +
| '''100% White'''
 +
| style="text-align:right"|235
 +
| style="text-align:right"|235
 +
| style="text-align:right"|235
 +
|
 +
| style="text-align:right"|235
 +
| style="text-align:right"|128
 +
| style="text-align:right"|128
 +
|-
 +
| '''+Q'''
 +
| style="text-align:right"|59
 +
| style="text-align:right"|15
 +
| style="text-align:right"|126
 +
|
 +
| style="text-align:right"|16
 +
| style="text-align:right"|174
 +
| style="text-align:right"|149
 +
|-
 +
| '''0 IRE''' (Black)
 +
| style="text-align:right"|16
 +
| style="text-align:right"|16
 +
| style="text-align:right"|16
 +
|
 +
| style="text-align:right"|16
 +
| style="text-align:right"|128
 +
| style="text-align:right"|128
 +
|-
 +
| '''-4 IRE'''
 +
| style="text-align:right"|7
 +
| style="text-align:right"|7
 +
| style="text-align:right"|7
 +
|
 +
| style="text-align:right"|7
 +
| style="text-align:right"|128
 +
| style="text-align:right"|128
 +
|-
 +
| '''0 IRE''' (Black)
 +
| style="text-align:right"|16
 +
| style="text-align:right"|16
 +
| style="text-align:right"|16
 +
|
 +
| style="text-align:right"|16
 +
| style="text-align:right"|128
 +
| style="text-align:right"|128
 +
|-
 +
| '''+4 IRE'''
 +
| style="text-align:right"|25
 +
| style="text-align:right"|25
 +
| style="text-align:right"|25
 +
|
 +
| style="text-align:right"|25
 +
| style="text-align:right"|128
 +
| style="text-align:right"|128
 +
|-
 +
| '''0 IRE''' (Black)
 +
| style="text-align:right"|16
 +
| style="text-align:right"|16
 +
| style="text-align:right"|16
 +
|
 +
| style="text-align:right"|16
 +
| style="text-align:right"|128
 +
| style="text-align:right"|128
 +
|}
  
 +
"100% White" could also be called "100 IRE White."
  
−
----
+
The -I and +Q bars are vestigial artifacts of NTSC analog TV and are not really used any more.
−
'''Changes:'''
+
 
 +
The -4, 0 and +4 IRE bars can be used to set your monitor brightness. 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>
 +
 
 +
Note, the pluge signal goes out of the 16-235 range in ''two'' places: [[Wikipedia:YIQ|-I]] (where '''R'''=0) and the -4 bar.
 +
 
 +
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''' is also generated. The tone is a 440Hz sine at 48KHz sample rate, 16 bit, 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|0}} >
 +
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"
 
{| border="1"
−
|-
 
−
| v2.56
 
−
| Added pixel_type="YUY2"/"YV12".
 
 
|-
 
|-
 
| v2.60
 
| v2.60
Line 54: Line 257:
 
* Added pixel_type="YV24" to ColorBars.
 
* Added pixel_type="YV24" to ColorBars.
 
* Initial release of ColorBarsHD.
 
* Initial release of ColorBarsHD.
 +
|-
 +
| v2.56
 +
| Added pixel_type="YUY2"/"YV12".
 
|}
 
|}
 +
</div>
  
  

Revision as of 04:10, 24 February 2016

Contents


SMPTE Color Bars-320x240.png

ColorBars

ColorBars ( [ int width, int height, string pixel_type ] )

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, 29.97 fps, 1 hour long clip is produced.

int  width = 640
int  height = 480
Set size of the returned clip.
string  pixel_type = "RGB32"
Set color format of the returned clip.
May be any of the following: "YUY2", "YV12", "YV24" (v2.60), or (default) "RGB32".


SMPTE Color Bars16x9-320x180.png

ColorBarsHD

ColorBarsHD ( [ int width, int height, string pixel_type ] )

Added in v2.60, ColorBarsHD produces a video clip containing SMPTE color bars
(Rec. ITU-R BT.709 / arib std b28 v1.0) scaled to any image size.

By default, a 1288×720, YV24, TV range, 29.97 fps, 1 hour long clip is produced.

int  width = 1288
int  height = 720
Set size of the returned clip.
string  pixel_type = "YV24"
Set color format of the returned clip. Must be "YV24".

TV range

For both filters, in all color formats, luminance levels are TV range, where 0 IRE "black"=16
and 100 IRE "white"=235, within a total possible range of 0-255.

Color bar  R G B Y U V
75% White 180 180 180 180 128 128
75% Yellow 180 180 16 162 44 142
75% Cyan 16 180 180 131 156 44
75% Green 16 180 16 112 72 58
75% Magenta 180 16 180 84 184 198
75% Red 180 16 16 65 100 212
75% Bue 16 16 180 35 212 114

These colors are at "75%" of maximum, per common broadcast practice.
You may occasionally see "100%" color bars; they are generated by certain cameras.

PLUGE

The lower part of the frame is called the PLUGE (also lowercase: "pluge") signal.
From left to right it consists of: -I, white, +Q, then a series of black and near-black bars: 0, -4, 0, +4 and 0 IRE.

This section documents the ColorBars pluge only; ColorBarsHD's pluge is similar, but dispenses with -I and +Q

PLUGE Element  R G B Y U V
-I 0 58 98 16 158 95
100% White 235 235 235 235 128 128
+Q 59 15 126 16 174 149
0 IRE (Black) 16 16 16 16 128 128
-4 IRE 7 7 7 7 128 128
0 IRE (Black) 16 16 16 16 128 128
+4 IRE 25 25 25 25 128 128
0 IRE (Black) 16 16 16 16 128 128

"100% White" could also be called "100 IRE White."

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

The -4, 0 and +4 IRE bars can be used to set your monitor brightness. 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.[1]

Note, the pluge signal goes out of the 16-235 range in two places: -I (where R=0) and the -4 bar.

More information about the colorbars and the PLUGE can be found on the colorbars theory page.

Audio

For both filters, an audio tone is also generated. The tone is a 440Hz sine at 48KHz sample rate, 16 bit, stereo. The tone pulses in the right speaker, being turned on and off once every second. Level is 0 dBFS.

You can use Amplify to set a softer level (0dB can be a little deafening!) 

ColorBarsHD
AmplifyDB(-20)

Broadcasting organizations usually 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.

Miscellaneous

  • Note, that for example 
ColorBars(pixel_type="YUY2")
...is equivalent to 
ColorBars(pixel_type="RGB32")
ConvertToYUY2(matrix="PC.601")  
# "PC.601" / "PC.709" don't scale the luma range
  • When directly generating YUV format data, the color transitions are arranged to occur on a chroma-aligned boundary.

Changes

v2.60
  • Added pixel_type="YV24" to ColorBars.
  • Initial release of ColorBarsHD.
v2.56 Added pixel_type="YUY2"/"YV12".
Retrieved from "http://avisynth.nl/index.php?title=ColorBars&oldid=8701"
Personal tools