View source for AGI Interpreter Upgrader

<div align="center"><span style="font-size: 22pt">AGI Interpreter Upgrader</span><br />''Version 1.1''<br />''Author: [[Cold Turkey]]''<br />''2017-09-01''</div></div>
{{TechToolStub}}

{{FanAGISoftwareInfobox
| Software = AGI Interpreter Upgrader
| Image = 
| Version = 1.1
| ReleaseDate = {{2017S}}-09-01<ref>From the included README file</ref>
| Company = {{NAToolCo}}
| DevStatus = {{UnmaintainedDev}}
| Published = {{Published}}
| Developers = {{ColdTurkeyToolDev}}
| Interface = {{NAInterface}}
| ProgLanguage = {{C}}
| OpenSource = {{OpenSRC}}
| Source = {{SourceSW}}[[#DL|Yes]] (included in download)
| License = {{NoLicense}}
| Type = {{FanAGIInterpUpgrader}}, {{FanAGIMiscUtil}}
| Engine = {{AGI2Tool}}
| Platform = {{WinTool}}
| Localization = {{EnglishTool}}
| Website = {{NAURL}}
}}

<br />
==<br /> Description ==

<blockquote>
Cold Turkey's AGI Interpreter Upgrader upgrades AGI interpreters 2.411 - 2.915 to version 2.917. Interpreters 2.917 and later are needed to properly play games with Tandy sound on EGA/VGA based systems.

<blockquote>
=== <br />Why? ===

There have been some recent remakes of Covox compatible sound devices that plug into the printer port. Many moons ago a program named "temu" was written that can emulate Tandy sound using the Covox. Temu works great with AGI games when using the "-t" command line argument to start them, but graphical anomalies can occur on EGA/VGA systems when using an interpreter older than 2.917. The Nerdly Pleasures blog has a great article on how to update Sierra interpreters, but this requires users to manually copy files and then use a hex editor to change some values. This program simply takes care of all of those steps.<ref>http://nerdlypleasures.blogspot.ca/2015/03/cajoling-sierra-and-lucasarts-games-to.html</ref>

Executables for both DOS and Windows are provided.
</blockquote>
</blockquote>

==<br /> Features ==

<blockquote>
<!-- Add feature list here -->
</blockquote>

==<br /> Requirements ==

<blockquote>
<!-- Add requirements here -->
</blockquote>

==<br /> Version History ==

<blockquote>
* 1.1 - Fixed bug where 2.43x interpreters are detected as newer than 2.917
</blockquote>

==<br /> Development Status ==

<blockquote>
The AGI Interpreter Upgrader is no longer actively maintained.
</blockquote>

==<br /> Usage ==

<blockquote>
Copy the .exe matching your operating system to the folder of the AGI game that you'd like to update. Then from the command line run the exe. It will tell you what interpreter you are currently using. If you are already at 2.917, it will confirm that you want to do the upgrade. If you are at a version later than 2.917 or earlier than 2.411 it will not perform the upgrade. After validation of the current interpreter, the program asks you to pick the name of the game you are upgrading. You can also enter your own game id if you've got some weird homebrew AGI game.

Old interpreter files are backed up to the "backup" folder insIDE the game directory.
</blockquote>

==<br /> Options ==

<blockquote>
<!-- Add options here -->
</blockquote>

<div id="DL">
==<br /> Download ==

<blockquote>
===<br /> DOS / Windows ===
* [[File:ZIP.png|ZIP File]] [[:File:Update_AGI_2971_1.1.zip | Update_AGI_2971_1.1.zip]]<span class="DLInfo"> (ZIP file)</span>
===<br /> Linux / Mac / Unix ===
* [[File:ZIP.png|ZIP File]] [[:File:AGI_Interpreter_Upgrader-Linux-Mac-UNIX_SRC.zip | AGI_Interpreter_Upgrader-Linux-Mac-UNIX_SRC.zip]]<span class="DLInfo"> (ZIP file)</span><ref>Source to compile</ref>
</blockquote>

== <br />Known issues ==

* None known

== <br />Credits ==

* [[Cold Turkey]]

==<br /> Legal ==

AGI Interpreter Upgrader was released with no license.

==<br /> References ==

<references /><!-- Do not edit this section. It is autopopulated by <ref></ref> tags -->

== <br />See Also ==

* [[:Category:AGI Interpreter Upgrade Tools|AGI Interpreter Upgrade Tools]]
&nbsp;
[[Category:Technical Info]]
[[Category:References]]
[[Category:General Tools]]
[[Category:Misc AGI Utilities]]
[[Category:Interpreter Articles]]