AudioGraph - Revision history

Reel.Deal: v0.0.2 update

2023-05-16T17:04:51Z

v0.0.2 update

Reel.Deal: typo

2020-08-06T23:24:56Z

typo

Reel.Deal: update to v0.0.1

2020-08-06T19:36:04Z

update to v0.0.1

Reel.Deal: v0.0.0 update

2020-06-20T21:47:23Z

v0.0.0 update

Reel.Deal: /* External Links */

2020-03-17T01:29:59Z

‎External Links

Reel.Deal: AudioGraph

2015-03-22T20:50:11Z

AudioGraph

New page

{{FilterCat|External_filters|Plugins|Audio_filters}}
{{Filter3
| Richard Ling, {{Author/Sh0dan}}
| 20040318
| 3=[http://web.archive.org/web/20060517015407/http://beta.zenaria.com/kpo/avisynth/AudGraph_25.zip AudGraph_25.zip]
| 4=Audio filters
| 5=[http://www.gnu.org/licenses/gpl-2.0.txt GPLv2]
| 6=[http://forum.doom9.org/showthread.php?t=59412 Doom9 Thread]}}
 
== Description ==
This filter displays the audio waveform for a video, superimposed on the video. It is mainly intended to help during editing rather than for final output. It can be useful for finding and isolating specific sequences of dialogue or sound, and for checking that overdubbed audio (especially speech) is in sync with video.

The audio is displayed as a green waveform stretching from left to right across the frame. The filter can graph the audio for the currently visible frame only; or it can include the audio for several successive frames on either side of the current frame. Graphing several frames makes it easier to find a sound of interest. It is also really cool to watch the waveform scrolling across the video as the video plays :-).
 
 
== Requirements ==
* AviSynth 2.5.8 or later
* Supported color formats: [[RGB24]], [[RGB32]], [[YUY2]]
 
== [[Script variables|Syntax and Parameters]] ==

:{{Template:FuncDef|AudioGraph (clip, int)}}
 
::{{Par2| |clip| }}
:::The source clip. YUY2, RGB24 or RGB32 video, with 8-bit or 16-bit mono or stereo audio.
 
::{{Par2| |int| }}
:::<tt>'''frames_either_side'''</tt>: The number of frames, either side of the current frame, which should be graphed.
:::The effect of the frames_either_side parameter is perhaps better explained by this table:
:::value effect:
:::*0 : only audio for the currently visible frame is graphed.
:::*1 : audio for the preceding, current, and following frames are graphed.
:::*2 : audio for the preceding 2 frames, current frame, and following 2 frames are graphed.
:::*...and so on.
:::The current frame's audio is displayed in the centre of the video frame in bright green, while audio for preceding and following frames is displayed in darker green.
 
===How this filter works:===
An "audioframe" is the audio data corresponding to a video frame, converted into an internal form that can be quickly drawn. A total of (1 + 2 * <tt>'''frames_either_side'''</tt>) audioframes are drawn onto each video frame. Each audioframe is thus (video frame width) / (1 + 2 * <tt>'''frames_either_side'''</tt>) pixels wide. An audioframe simply consists of a Y pixel coordinate for each X pixel coordinate, so drawing an audioframe is very fast.

When <tt>'''frames_either_side'''</tt> is nonzero, the same audioframe will be drawn several times on several successive video frames. So it makes sense to cache audioframes. The filter uses a cache of "audioframe buffers" to store recently used audioframes. Audioframes are generated from raw audio data on demand, and stored in the cache. The caching system is such that a specific audioframe is only ever cached in a specific audioframe buffer, so that cache lookup is very fast. This caching also improves performance when seeking back and forth in a video.

*The included source code is very well documented, check it out for full details!
 
== Examples ==
The following script creates a video from just an audio file. The video length is automatically adjusted based on the duration of the audio and the desired frame rate. The output clip will be RGB32, 512x256, 59.94 FPS, and <tt>'''frames_either_side'''</tt>=5, of course this is all adjustable.
[[WavSource]]("sample.wav") # for other types of files you can use [[FFmpegSource|FFAudioSource]] or [[LSMASHSource|LWLibavAudioSource]] or any other suitable audio source filter
audio = last 
fps = 60000
den = 1001
length = Round((AudioDuration(audio)*fps)/den)
[[BlankClip]](length, width=512, height=256, fps=fps, fps_denominator=den, pixel_type="RGB32", color=$000000)
[[AudioDub]](last, audio) 
AudioGraph(5) # <tt>'''frames_either_side'''</tt> - change to desired value
 
== Changelog ==
Version Date Changes 
20040318 03/18/2004 - AviSynth 2.5 version by Sh0dan
- No YV12 support.
- Should support multiple channels.
- YUY2 mode made a bit more eyepleasing, IMO.
- - It makes the graph a bit more blocky.
- - YUY2 mode is converted to greyscale. 
20030808 08/08/2003 - initial release; AviSynth 2.0 plugin by Richard Ling

 
== Archived Downloads ==
{| class="wikitable" border="1"; width="800px"
|-
!!width="100px"| Version
!!width="150px"| Download
!!width="150px"| Mirror
!!width="150px"| Mirror 2
|-
!20040318
|[http://web.archive.org/web/20060517015407/http://beta.zenaria.com/kpo/avisynth/AudGraph_25.zip AudGraph_25.zip]
|[http://www.avisynth.nl/users/warpenterprises/files/audgraph_5F25_dll_20040318.zip audgraph_25_20040318.zip]
|[http://web.archive.org/web/20140724142044/http://www.avisynth.nl/users/warpenterprises/files/audgraph_5F25_dll_20040318.zip audgraph_25_20040318.zip]
|-
!20030808
|[http://www.avisynth.nl/users/warpenterprises/files/audgraph_20_dll_20030808.zip audgraph_20_dll_20030808.zip]
|[http://web.archive.org/web/20150322175320/http://www.avisynth.nl/users/warpenterprises/files/audgraph_20_dll_20030808.zip audgraph_20_dll_20030808.zip]
|}
 
==TO DO==
* Allow the colour of the graph to be passed as a parameter.
* Allow separate graphing of left or right channels of stereo audio (using different colours).
* Allow a vertical scale factor to be passed as a parameter, so that quiet waveforms can be seen in more detail.
* Fix the "feature" that the current frame's audio is not always centered on the display. It can be offset quite far to the right, depending on the relationship between video frame width and <tt>'''frames_either_side'''</tt>.
 
==External Links ==
*[http://avisynth.org.ru/docs/english/externalfilters/audiograph.htm avisynth.org.ru] - Original documentation, [http://avisynth.org.ru/docs/russian/externalfilters/audiograph.htm Russian documentation]
*[http://sourceforge.net/projects/audiograph/ SourceForge] - AudioGraph update by Ihor Bobalo; only source code provided.
 
 
-----------------------------------------------
'''Back to [[External_filters#Audio_Filters|External Filters]] ←'''

@@ Line 2: / Line 2: @@
 {{Filter3
 | 1=Richard Ling, {{Author/Sh0dan}}, [https://sourceforge.net/u/ibobalo/profile/ ibobalo]
-| 2=v0.0.1
+| 2=v0.0.2
-| 3=[https://web.archive.org/web/20200806192214if_/https://files.videohelp.com/u/223002/AudioGraph001.7z AudioGraph001.7z]
+| 3=[https://github.com/Asd-g/AviSynth-AudioGraph/releases AudioGraph-v0.0.2.7z ]
 | 4=Audio filters
 | 5=[http://www.gnu.org/licenses/gpl-2.0.txt GPLv2]
@@ Line 17: / Line 17: @@
 * [x86]: [[AviSynth+]] or [https://sourceforge.net/projects/avisynth2/ AviSynth 2.6]
 * [x64]: [[AviSynth+]]
-* Supported color formats: [[RGB24]], [[RGB32]], [[YUY2]]
+* Supported color formats: [[RGB24]], [[RGB32]], [[YUY2]], [[YV24]], 8-bit [[Planar]] RGB
 <br>
 == [[Script variables|Syntax and Parameters]] ==
@@ Line 24: / Line 24: @@
 <br>
 ::{{Par2| |clip| }}
-:::The source clip. YUY2, RGB24 or RGB32 video, with 8-bit or 16-bit mono or stereo audio.
+:::The source clip. YUY2, YV24, RGB24, RGB32 or planar RGB video, with 8-bit or 16-bit mono or stereo audio. Float audio will be internally converted to 16-bit and back to float.
 <br>
 ::{{Par2|frames_either_side|int|25}}
@@ Line 65: / Line 65: @@
 == Changelog ==
   Version       Date            Changes<br>
   v0.0.1        2020/06/21      - Update by [https://forum.doom9.org/showthread.php?t=173259 Groucho2004]
                                 - Added version resource

@@ Line 42: / Line 42: @@
 :::<code>'''middle_colour'''</code>: The graph colour for the current frame.  Colors are expressed as hex values: [[Color_presets]]
 <br>
-::{{Par2|side_colour|int|$00FF00 }}
+::{{Par2|side_colour|int|$7F7F7F}}
 :::<code>'''side_colour'''</code>: The graph colour for the frames on either side of the current. Colors are expressed as hex values: [[Color_presets]]
 <br>
@@ Line 61: / Line 61: @@
   [[BlankClip]](length, width=512, height=256, fps=fps, fps_denominator=den, pixel_type="RGB32", color=$000000)
   [[AudioDub]](last, audio)<br>
-  AudioGraph(frames_either_side=20, graph_scale=0, middle_colour=$00FF00, side_colour=$00FF00) # change to desired values
+  AudioGraph(frames_either_side=20, graph_scale=0, middle_colour=$00FF00, side_colour=$7F7F7F) # change to desired values
 <br>
 == Changelog ==

@@ Line 1: / Line 1: @@
 {{FilterCat4|External_filters|Plugins|Plugins_x64|Audio_filters}}
 {{Filter3
-| Richard Ling, {{Author/Sh0dan}}, [https://sourceforge.net/u/ibobalo/profile/ ibobalo]
+| 1=Richard Ling, {{Author/Sh0dan}}, [https://sourceforge.net/u/ibobalo/profile/ ibobalo]
-| v0.0.0
+| 2=v0.0.1
-| 3=[https://web.archive.org/web/20200620205259if_/https://files.videohelp.com/u/223002/AudioGraph000.7z AudioGraph000.7z]
+| 3=[https://web.archive.org/web/20200806192214if_/https://files.videohelp.com/u/223002/AudioGraph001.7z AudioGraph001.7z]
 | 4=Audio filters
 | 5=[http://www.gnu.org/licenses/gpl-2.0.txt GPLv2]
@@ Line 21: / Line 21: @@
 == [[Script variables|Syntax and Parameters]] ==
-:{{Template:FuncDef|AudioGraph (clip, int, int, int, int)}}
+:{{Template:FuncDef|AudioGraph (clip, int "frames_either_side", int "graph_scale", int "middle_colour", int "side_colour")}}
 <br>
 ::{{Par2| |clip| }}
 :::The source clip. YUY2, RGB24 or RGB32 video, with 8-bit or 16-bit mono or stereo audio.
 <br>
-::{{Par2| |int| }}
+::{{Par2|frames_either_side|int|25}}
 :::<code>'''frames_either_side'''</code>: The number of frames, either side of the current frame, which should be graphed.
 :::The effect of the frames_either_side parameter is perhaps better explained by this table:
@@ Line 36: / Line 36: @@
 :::The current frame's audio is displayed in the centre of the video frame in bright green, while audio for preceding and following frames is displayed in darker green.
 <br>
-::{{Par2| |int| }}
+::{{Par2|graph_scale|int|0}}
-:::<code>'''_graph_scale'''</code>: The vertical scale factor. Set to 0 to enable auto-scale
+:::<code>'''graph_scale'''</code>: The vertical scale factor. Set to 0 to enable auto-scale
 <br>
-::{{Par2| |int| }}
+::{{Par2|middle_colour|int|$00FF00}}
-:::<code>'''_middle_colour'''</code>: The graph colour for the current frame.  Colors are expressed as hex values: [[Color_presets]]
+:::<code>'''middle_colour'''</code>: The graph colour for the current frame.  Colors are expressed as hex values: [[Color_presets]]
 <br>
-::{{Par2| |int| }}
+::{{Par2|side_colour|int|$00FF00 }}
-:::<code>'''_side_colour'''</code>: The graph colour for the frames on either side of the current. Colors are expressed as hex values: [[Color_presets]]
+:::<code>'''side_colour'''</code>: The graph colour for the frames on either side of the current. Colors are expressed as hex values: [[Color_presets]]
-<br>
-::<span style="color:red">'''Note:'''</span> all of the parameters are unnamed and do not have a default so they must be specified.
 <br>
 ===How this filter works:===
@@ Line 56: / Line 54: @@
 == Examples ==
 The following script creates a video from just an audio file. The video length is automatically adjusted based on the duration of the audio and the desired frame rate. The output clip will be RGB32, 512x256, 59.94 FPS, and <tt>'''frames_either_side'''</tt>=5, of course this is all adjustable.
-  [[WavSource]]("sample.wav") # for other types of files you can use [[FFmpegSource|FFAudioSource]] or [[LSMASHSource|LWLibavAudioSource]] or any other suitable audio source filter
+  [[WavSource]]("sample.wav") # for other types of files use [[FFmpegSource|FFAudioSource]] or [[LSMASHSource|LWLibavAudioSource]] or another suitable audio source filter
   audio = last<br>
   fps = 60000
@@ Line 63: / Line 61: @@
   [[BlankClip]](length, width=512, height=256, fps=fps, fps_denominator=den, pixel_type="RGB32", color=$000000)
   [[AudioDub]](last, audio)<br>
-  AudioGraph(20, 0, $8a9dff, $fcb5db) # change to desired values
+  AudioGraph(frames_either_side=20, graph_scale=0, middle_colour=$00FF00, side_colour=$00FF00) # change to desired values
 <br>
 == Changelog ==
   Version       Date            Changes<br>
   v0.0.0        2020/06/20      - Update by [https://forum.doom9.org/showthread.php?t=173259 Groucho2004]
                                 - Update to AviSynth 2.6 api
@@ Line 83: / Line 89: @@
 <br>
 == Archived Downloads ==
-{| class="wikitable" border="1"; width="800px"
+{| class="wikitable" border="1"; width="600px"
 |-
 !!width="100px"| Version
 !!width="150px"| Download
 !!width="150px"| Mirror
-!!width="150px"| Mirror 2
+|-
 |-
 !v0.0.0
 |[https://web.archive.org/web/20200620205259if_/https://files.videohelp.com/u/223002/AudioGraph000.7z AudioGraph000.7z]
+|
@@ Line 97: / Line 105: @@
 !20040318
 |[http://web.archive.org/web/20060517015407/http://beta.zenaria.com/kpo/avisynth/AudGraph_25.zip AudGraph_25.zip]
-|[http://www.avisynth.nl/users/warpenterprises/files/audgraph_5F25_dll_20040318.zip audgraph_25_20040318.zip]
+|[http://www.avisynth.nl/users/warpenterprises/files/audgraph_5F25_dll_20040318.zip audgraph_25_20040318.zip]<br>[http://web.archive.org/web/20140724142044/http://www.avisynth.nl/users/warpenterprises/files/audgraph_5F25_dll_20040318.zip audgraph_25_20040318.zip]
-|[http://web.archive.org/web/20140724142044/http://www.avisynth.nl/users/warpenterprises/files/audgraph_5F25_dll_20040318.zip audgraph_25_20040318.zip]
 |-
 !20030808

@@ Line 90: / Line 90: @@
 ==External Links ==
 *[http://avisynth.org.ru/docs/english/externalfilters/audiograph.htm avisynth.org.ru] - Original documentation, [http://avisynth.org.ru/docs/russian/externalfilters/audiograph.htm Russian documentation]
-*[http://sourceforge.net/projects/audiograph/ SourceForge] - AudioGraph update by Ihor Bobalo; only source code provided.
+*[http://sourceforge.net/projects/audiograph/ SourceForge] - AudioGraph update by Ihor Bobalo; only source code provided. Includes new parameters "<code>_graph_scale</code>", "<code>_middle_colour</code>", and "<code>_side_colour</code>"
 <br>
 <br>
 -----------------------------------------------
 '''Back to [[External_filters#Audio_Filters|External Filters]] &larr;'''