Histogram - Revision history

Reel.Deal: add link to avs+ documentation

2022-09-16T18:22:08Z

add link to avs+ documentation

Pinterf: /* Syntax and Parameters */ Histogram "levels" Y mode

2020-06-02T15:45:41Z

‎Syntax and Parameters: Histogram "levels" Y mode

Pinterf: /* Syntax and Parameters */ bits 9 and 11 are also valid for display

2018-03-05T10:58:07Z

‎Syntax and Parameters: bits 9 and 11 are also valid for display

Raffriff42: one more touch-up

2018-03-05T00:12:01Z

one more touch-up

Raffriff42: typo

2018-03-05T00:08:51Z

typo

Raffriff42: update for AVS+ r2632

2018-03-05T00:05:14Z

update for AVS+ r2632

Raffriff42: Use Template:Deep_color

2017-04-28T02:48:57Z

Use Template:Deep_color

Raffriff42: tweak appearance

2017-04-23T09:03:04Z

tweak appearance

Raffriff42: note AVS+ differences * incomplete*

2017-04-23T03:55:17Z

note AVS+ differences *** incomplete***

Raffriff42: link to RGB histograms; rephrase color 'modes'->'formats'

2016-03-13T21:03:21Z

link to RGB histograms; rephrase color 'modes'->'formats'

← Older revision		Revision as of 18:22, 16 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/histogram.html https://avisynthplus.readthedocs.io]
		+	</div>
		+
	A multipurpose audio/video analysis tool. <!--, which supports the following '''''modes''''':		A multipurpose audio/video analysis tool. <!--, which supports the following '''''modes''''':
	* [[#Classic_mode\|Classic]] (waveform) mode, the default;		* [[#Classic_mode\|Classic]] (waveform) mode, the default;

@@ Line 23: / Line 23: @@
 :{{Par2|mode|string|"classic"}}
 ::* [[#Classic_mode|Classic]] (waveform) mode, the default;
-::* [[#Levels_mode|Levels]] ''YUV'' histogram mode;
+::* [[#Levels_mode|Levels]] ''YUV'' histogram mode {{AvsPluscon}} also ''RGB'' and ''Y''
 ::* [[#Color_mode|Color]] and [[#Color2_mode|Color2]] vectorscope modes;
 ::* [[#Luma_mode|Luma]] special viewing mode;
@@ Line 70: / Line 70: @@
 |256*
 |256
-|YUV(A), RGB(A)
+|YUV(A), Y, RGB(A)
 |Y
 |8, 9, 10, 11, 12
@@ Line 143: / Line 143: @@
 |}
+"Levels" mode supports Y from Avisynth+ 3.6.1
 ----

@@ Line 36: / Line 36: @@
 :{{Par2|bits|int|8}}
-::{{AvsPluscon}} Accepts 8, 10 or 12 as input. Applies only to [[#Classic_mode|Classic]], [[#Levels_mode|Levels]] and [[#Color|Color]] modes.
+::{{AvsPluscon}} Accepts 8, 9, 10, 11 or 12 as input. Applies only to [[#Classic_mode|Classic]], [[#Levels_mode|Levels]] and [[#Color|Color]] modes.
 ::* Classic, Levels: increases the width of the histogram by 2{{Sup2|({{Template:FuncArg|bits}}-8)}}
 ::* Color: increases width and height of the histogram by 2{{Sup2|({{Template:FuncArg|bits}}-8)}}
@@ Line 63: / Line 63: @@
 |style="width:10em"|YUV(A), Y
+|
-|style="width:6em"|8,&nbsp;10,&nbsp;12
+|style="width:6em"|8,&nbsp;9,&nbsp;10,&nbsp;11,&nbsp;12
 |Y
 |Y
@@ Line 72: / Line 72: @@
 |YUV(A), RGB(A)
 |Y
-|8, 10, 12
+|8, 9, 10, 11, 12
 |Y
 |Y
@@ Line 81: / Line 81: @@
 |YUV(A)
+|
-|8, 10, 12
+|8, 9, 10, 11, 12
 |Y
+|
@@ Line 140: / Line 140: @@
 |-
+|
-|colspan="7"|*size = 256 ({{FuncArg|bits}}=8, default), 1024 ({{FuncArg|bits}}=10), 4096 ({{FuncArg|bits}}=12)
+|colspan="7"|*size = 256 ({{FuncArg|bits}}=8, default), 512 ({{FuncArg|bits}}=9), 1024 ({{FuncArg|bits}}=10), 2048 ({{FuncArg|bits}}=11), 4096 ({{FuncArg|bits}}=12)
 |}
 ----
 === Classic mode ===
 <div style="max-width:62em" >

@@ Line 63: / Line 63: @@
 |style="width:10em"|YUV(A), Y
+|
-|style="width:10em"|8,&nbsp;10,&nbsp;12
+|style="width:6em"|8,&nbsp;10,&nbsp;12
 |Y
 |Y

@@ Line 140: / Line 140: @@
 |-
+|
-|colspan="7"|*''if keepsource=true, added to right side of existing video''
+|colspan="7"|*size = 256 ({{FuncArg|bits}}=8, default), 1024 ({{FuncArg|bits}}=10), 4096 ({{FuncArg|bits}}=12)
 |}

@@ Line 11: / Line 11: @@
 === Syntax and Parameters ===
 {{FuncDef
-|Histogram(clip ''clip'' [, string ''mode''] [, float ''factor''])
+|Histogram(clip ''clip'' [, string ''mode'', float ''factor''])
 }} <br>
 {{FuncDef
-|Histogram(clip ''clip'' [, string ''mode''] [, float ''factor'', int ''bits'']) {{AvsPluscon}}
+|Histogram(clip ''clip'' [, string ''mode'', float ''factor'', int ''bits'', bool ''keepsource'', bool ''markers'']) {{AvsPluscon}}
 }}
 :{{Par2|clip|clip|}}
 ::Source clip.
-::{{AvsPluscon}} {{Deep_color}} supported in [[#Classic_mode|Classic]] and [[#Levels_mode|Levels]] modes only.
+::{{AvsPluscon}} {{Deep_color}} (bit depth greater than 8) supported in [[#Classic_mode|Classic]], [[#Levels_mode|Levels]] and [[#Color|Color]] modes only.
-::[[TODO]] Documentation incomplete as of r2455.
 :{{Par2|mode|string|"classic"}}
@@ Line 37: / Line 36: @@
 :{{Par2|bits|int|8}}
-::{{AvsPluscon}} Accepts 8, 10 or 12 as input. Applies only to [[#Classic_mode|Classic]] and [[#Levels_mode|Levels]] modes.
+::{{AvsPluscon}} Accepts 8, 10 or 12 as input. Applies only to [[#Classic_mode|Classic]], [[#Levels_mode|Levels]] and [[#Color|Color]] modes.
-::Seems to increase the width of the histogram by 2{{Sup2|({{Template:FuncArg|bits}}-8)}}
+::* Classic, Levels: increases the width of the histogram by 2{{Sup2|({{Template:FuncArg|bits}}-8)}}
 ::For example, <code>Histogram('''bits='''10)</code> returns a 1024 pixel wide histogram (width is 256 by default)
-::[[TODO]] Documentation incomplete as of r2455.
 ----

@@ Line 1: / Line 1: @@
-{{FuncDef
+A multipurpose audio/video analysis tool. <!--, which supports the following '''''modes''''':
-|Histogram(clip ''clip'' [, string ''mode''] [, float ''factor''])
-}}
-−
 A multipurpose audio/video analysis tool, which supports the following '''''modes''''':
 * [[#Classic_mode|Classic]] (waveform) mode, the default;
 * [[#Levels_mode|Levels]] ''YUV'' histogram mode;
@@ Line 10: / Line 6: @@
 * [[#Audiolevels_mode|Audiolevels]] audio level meter; and
 * [[#Stereo.2C_StereoY8_and_StereoOverlay_mode|Stereo, StereoOverlay, and StereoY8]] audio graphs.
 __NOTOC__
 ----

@@ Line 22: / Line 22: @@
 [[File:histogram_classic.jpg]]
-Available in [[YUV]] mode only. This will add a per-line luminance graph (usually called a [[wikipedia:Waveform_monitor|Waveform Monitor]]) on the right side of the video, increasing clip.[[Clip_properties|Width]] by 256. The left side of the graph represents luma=0 and the right side represents luma=255. Values outside the [[Limiter|valid CCIR-601 range]] are shown with a brown/yellowish color background; a greenish line represents Y=128.
+Available in [[YUV]] color formats only. For [[RGB]] sources, try [[Histograms_in_RGB_%26_CMY#HistogramRGBParade|'''HistogramRGBParade''']].
 If you prefer to see luma=0 on bottom and luma=255 on top, use this:
@@ Line 44: / Line 45: @@
 [[File:Histogram-vortex-levels.jpg]]
-Available in all planar modes, except [[Y8]]. This mode will display three histograms on the right side of the video frame, increasing clip.[[Clip_properties|Width]] by 256. This will show the distribution of the ''Y'', ''U'' and ''V'' components in the current frame.
+Available in all [[YUV]] [[Planar|planar]] color formats, except [[Y8]]. For [[RGB]] sources, try [[Histograms_in_RGB_%26_CMY#HistogramRGBLevels_.2F_HistogramCMYLevels|'''HistogramRGBLevels''']].
 The top graph displays the ''Y'' (luma) distribution of the frame, where the left side represents Y=0 and the right side represents Y=255. Values outside the [[Limiter|valid CCIR601 range]] have been indicated with faded colors; Y=128 has been marked with a dotted line. The vertical axis shows the number of pixels for a given luma (Y) value.
@@ Line 71: / Line 74: @@
 [[File:Histogram-vortex-color.jpg]]
-Available in all planar modes except [[Y8]]. This mode will display the chroma values (U/V color placement) in a two dimensional graph (called a [[wikipedia:Vectorscope|vectorscope]]) on the right side of the video frame, increasing clip.[[Clip_properties|Width]] by 256. It can be used to read of the [[wikipedia:Hue|hue]] and [[wikipedia:Colorfulness#Saturation|saturation]] of a clip. At the same time it is a histogram: the whiter a pixel in the vectorscope, the more pixels of the input clip correspond to that chroma value. The lighter background denotes the [[Limiter|valid CCIR-601 range]].
+Available in all [[YUV]] [[Planar|planar]] color formats, except [[Y8]].
@@ Line 102: / Line 107: @@
 [[File:Histogram-vortex-color2.jpg]]
-Available in all planar modes except [[Y8]]. This mode will display the pixels in a two dimensional graph (called a [[wikipedia:Vectorscope|vectorscope]]) on the right side of the video frame, increasing clip.[[Clip_properties|Width]] by 256. It can be used to read of the [[wikipedia:Hue|hue]] and [[wikipedia:Colorfulness#Saturation|saturation]] of a clip.
+Available in all [[YUV]] [[Planar|planar]] color formats, except [[Y8]].
 The ''U'' component is displayed on the horizontal (X) axis, with the leftmost side being U=0 and the rightmost side being U=255. The ''V'' component is displayed on the vertical (Y) axis, with the top representing V=0 and the bottom representing V=255. The white square denotes the [[Limiter|valid CCIR-601 range]].
@@ Line 129: / Line 136: @@
 [[Image:histogram_modeluma.jpg]]
-Available in planar and [[YUY2]] modes. This mode will amplify luminance, and display very small luminance variations. This is good for detecting blocking and noise, and can be helpful at adjusting filter parameters. In this mode a 1 pixel luminance difference will show as a 16 pixel luminance pixel, thus seriously enhancing small flaws.
+Available in [[YUV]] [[Planar|planar]] and [[YUY2]] color formats.
 </div>
@@ Line 142: / Line 151: @@
 [[Image:histogram_audiolevels.jpg]]
-[[Planar]] video is required. Audio is converted to 16 bit.  Shows the audio levels in [[wikipedia:Decibel|decibels]] for each channel present. For example, if the source has six channels of audio, six vertical bars will be shown.
+[[YUV]] [[Planar|planar]] video is required. Audio is [[ConvertAudio|converted]] to 16 bit.
 * The green bars show the {{Serif|''RMS''}} ([[wikipedia:Root_mean_square|Root Mean Square]]) level of the audio in each video frame (let's say {{Serif|''n''}} samples) using the following formula:
@@ Line 167: / Line 178: @@
 [[Image:histogram_modestereo.gif|256px|]]
-Requires a source clip with stereo audio; '''StereoOverlay''' also requires a source clip with a [[Planar|planar]] color format. These modes show a classic stereo graph (or [[wikipedia:Lissajous_curve|Lissajous]] pattern) from the clip audio, often seen in recording studios. They are used to view the left-right phase distribution of the input signal. In-phase stereo appears predominantly vertical (as shown), but incorrectly phased stereo appears predominantly horizontal. Two-channel Mono appears as a vertical line.
+Requires a source clip with stereo audio; '''StereoOverlay''' also requires a source clip with a [[YUV]] [[Planar|planar]] color format.
 '''StereoOverlay''' will overlay the graph on top of the original. Each frame will contain only information from the current frame to the beginning of the next frame. The signal is linearly upsampled 8x, to provide clearer visuals. '''Stereo''' and '''StereoY8''' won't overlay the graph on the video, but will just return the graph alone as a 512×512 video clip (in [[YV12]] or [[Y8]] format respectively).