AGI Sound Tutorial - Scripting - Revision history

Andrew Branscom at 18:57, 30 January 2024

2024-01-30T18:57:01Z

Andrew Branscom at 02:58, 10 April 2019

2019-04-10T02:58:42Z

Andrew Branscom at 19:33, 26 December 2013

2013-12-26T19:33:24Z

Andrew Branscom at 03:32, 26 December 2013

2013-12-26T03:32:53Z

Andrew Branscom: /* Attenuation */

2013-12-26T03:24:33Z

Attenuation

Andrew Branscom at 03:38, 25 December 2013

2013-12-25T03:38:39Z

Andrew Branscom at 01:56, 25 December 2013

2013-12-25T01:56:28Z

Andrew Branscom at 01:55, 25 December 2013

2013-12-25T01:55:25Z

Andrew Branscom at 01:54, 25 December 2013

2013-12-25T01:54:32Z

Andrew Branscom at 05:47, 23 December 2013

2013-12-23T05:47:11Z

@@ Line 114: / Line 114: @@
 [[Category:References]]
 [[Category:Tutorials]]
-[[Category:Logic]]
+[[Category:AGI Logic]]

@@ Line 111: / Line 111: @@
 &nbsp;
-[[Category:Sound Resources]]
+[[Category:AGI Sound Resources]]
 [[Category:References]]
 [[Category:Tutorials]]
 [[Category:Logic]]

@@ Line 1: / Line 1: @@
-[[AGI Tutorials|Tutorials Table of Contents]]<br />
+[[Tutorials and Guides|Tutorials and Guides Table of Contents]]<br />
 [[AGI Sound Tutorial|AGI Sound Tutorial Index]]
@@ Line 104: / Line 104: @@
 &nbsp;
-[[AGI Tutorials|Tutorials Table of Contents]]<br />
+[[Tutorials and Guides|Tutorials and Guides Table of Contents]]<br />
 [[AGI Sound Tutorial|AGI Sound Tutorial Index]]

@@ Line 15: / Line 15: @@
 [[AGI Sound Tutorial - In the Future|10]] |
 [[AGI Sound Tutorial - Location of Tools|11]] |
-[[AGI Sound Tutorial - References|12]] |
+[[AGI Sound Tutorial - References|12]]
 </div><br />
@@ Line 100: / Line 99: @@
 [[AGI Sound Tutorial - In the Future|10]] |
 [[AGI Sound Tutorial - Location of Tools|11]] |
-[[AGI Sound Tutorial - References|12]] |
+[[AGI Sound Tutorial - References|12]]
 </div>

@@ Line 113: / Line 113: @@
 &nbsp;
-[[Category:Sound]]
+[[Category:Sound Resources]]
 [[Category:References]]
 [[Category:Tutorials]]
 [[Category:Logic]]

@@ Line 20: / Line 20: @@
 <div align="center"><span style="font-size: 22pt">Sound Scripting</span><br />
-''by [[Nick Sonneveld]]''<br /></div>
+''by [[Nick Sonneveld]]''<br />
 &nbsp;

@@ Line 23: / Line 23: @@
 &nbsp;
 Originally with the AGI sound files there was no way to manually edit a particular part of a song or change the length without having to convert to a MIDI file to edit it.  One tool to do this now is the "agi2scr" and "scr2agi" tools by um.. me (Nick Sonneveld).  These two tools are used to decompile AGI sound objects into user-editable scripts and then recompiled again.  Handy to have if you want to edit an AGI sound file, but don't want to fiddle around with hex editors.  You can also increase, decrease the length of songs, add a silence at the end.. whatever you want really.
@@ Line 28: / Line 30: @@
 &nbsp;
-=== <br />compiling a script ===
+=== compiling a script ===
 <blockquote><code>scr2agi -i larry-edited.ass -o larry-edited.aso</code></blockquote>

@@ Line 26: / Line 26: @@
 Originally with the AGI sound files there was no way to manually edit a particular part of a song or change the length without having to convert to a MIDI file to edit it.  One tool to do this now is the "agi2scr" and "scr2agi" tools by um.. me (Nick Sonneveld).  These two tools are used to decompile AGI sound objects into user-editable scripts and then recompiled again.  Handy to have if you want to edit an AGI sound file, but don't want to fiddle around with hex editors.  You can also increase, decrease the length of songs, add a silence at the end.. whatever you want really.
-=== compiling a script ===
+&nbsp;
 <blockquote><code>scr2agi -i larry-edited.ass -o larry-edited.aso</code></blockquote>
 === Decompiling a Sound Object ===
@@ Line 45: / Line 48: @@
 </blockquote>
 == Script format ==
@@ Line 67: / Line 71: @@
 </blockquote>
 == Attenuation ==

← Older revision	Revision as of 01:54, 25 December 2013
Line 24:	Line 24:


	+	Originally with the AGI sound files there was no way to manually edit a particular part of a song or change the length without having to convert to a MIDI file to edit it. One tool to do this now is the "agi2scr" and "scr2agi" tools by um.. me (Nick Sonneveld). These two tools are used to decompile AGI sound objects into user-editable scripts and then recompiled again. Handy to have if you want to edit an AGI sound file, but don't want to fiddle around with hex editors. You can also increase, decrease the length of songs, add a silence at the end.. whatever you want really.

	+	=== compiling a script ===
	+
	+	<blockquote><code>scr2agi -i larry-edited.ass -o larry-edited.aso</code></blockquote>
	+
	+	=== Decompiling a Sound Object ===
	+
	+	<blockquote>
	+	<code>agi2scr -i original_snd.aso -o original_snd.ass</code></blockquote>
	+
	+	<blockquote>
	+	options:
	+
	+	* -i, -input = input object name
	+	* -o, -output = output script name
	+	* -t, -type = type of info to represent notes (not implemented yet.. only with agi2scr)
	+	* -h, -help = print the help message
	+	* -v, -verbose = print interesting messages that correspond with the current activity.
	+	</blockquote>
	+
	+	== Script format ==
	+
	+	The script format used these tools is fairly simple. Comments start with a '#' and are subsequently ignored by the compiler. Each channel starts with either "tone" or "noise, allocation of the actually channel number is automatic at the moment. After the definition of a channel, it will continue reading note information until it reaches another "tone"/"noise".
	+
	+	<blockquote>
	+	Notes are defined in the two following formats:
	+
	+	# Type, frequency_count, attenuation, duration
	+	# Frequency_count, attenuation, duration
	+	</blockquote>
	+
	+	Typically, you should define the type in the first note, so the following notes will be in the same format. If the type isn't defined, it will assume it's AGI's freq count format. Notes are read in as a floating point number. So you could enter notes with several decimal points if you wanted to.
	+
	+	<blockquote>
	+	* The different types are:
	+	* a = AGI freq_count (freq = 111860 / freq_count)
	+	* n = note.. not defined yet
	+	* f = actual frequency
	+	* w = white noise (freq=0,1,2)
	+	* p = periodic noise (freq=0,1,2)
	+	</blockquote>
	+
	+	== Attenuation ==
	+
	+	Attenuation is the volume subtracted from the maximum volume. If you can wrap your head around that, 0 means the max volume and 15 means absolute silence.
	+
	+	<blockquote>
	+	Duration, for AGI sounds is defined as 1 equals 1/60 of a second. So if you set the duration of a note to 60, it will play for 1 second.<br />
	+	<br />
	+	If you want to define a note that is silent, you can either set the attenuation of it to 15 or define the freq_count to 0. Both is good too.
	+	</blockquote>

@@ Line 48: / Line 48: @@
 [[AGI Tutorials|Tutorials Table of Contents]]<br />
-[[AGI Command Reference|AGI Command Reference Index]]
+[[AGI Sound Tutorial|AGI Sound Tutorial Index]]
 <span style="float: left">[[AGI Sound Tutorial - Merging|&lt; Previous: Merging]]</span><span style="float: right">[[AGI Sound Tutorial - Visual Editors|Next: Visual Editors &gt;]]</span>