Error Code Tutorial - Unacknowledged Errors - Revision history

Andrew Branscom: Collector moved page AGI Error Code Tutorial - Unacknowledged Errors to Error Code Tutorial - Unacknowledged Errors

2013-12-28T16:54:26Z

Collector moved page AGI Error Code Tutorial - Unacknowledged Errors to Error Code Tutorial - Unacknowledged Errors

Andrew Branscom at 16:54, 28 December 2013

2013-12-28T16:54:14Z

Andrew Branscom at 20:05, 26 December 2013

2013-12-26T20:05:44Z

Andrew Branscom at 16:49, 25 December 2013

2013-12-25T16:49:20Z

Andrew Branscom at 16:48, 25 December 2013

2013-12-25T16:48:59Z

Andrew Branscom at 16:48, 25 December 2013

2013-12-25T16:48:23Z

Andrew Branscom at 16:35, 25 December 2013

2013-12-25T16:35:20Z

Andrew Branscom: Created page with "Tutorials Table of Contents
AGI Error Code Index
Page: 1 ..."

2013-12-25T15:34:18Z

Created page with "Tutorials Table of Contents<br /> AGI Error Code Index <div align="center"> Page: 1 ..."

New page

[[AGI Tutorials|Tutorials Table of Contents]]<br />
[[AGI Error Code Tutorial|AGI Error Code Index]]

<div align="center">
Page:
[[AGI Error Code Tutorial - Introduction|1]] |
[[AGI Error Code Tutorial - Logic Errors|2]] |
[[AGI Error Code Tutorial - Interpreter Errors|3]] |
[[AGI Error Code Tutorial - Unacknowledged Errors|4]] |
[[AGI Error Code Tutorial - Debugging Techniques|5]] |
[[AGI Error Code Tutorial - Revision History|6]] |
</div><br />

<div align="center"><span style="font-size: 22pt"></span><br />
''by [[Nick Sonneveld]]''<br />
''Last updated 9th March, 2002''</div>

 

 

<div align="center">
Page:
[[AGI Error Code Tutorial - Introduction|1]] |
[[AGI Error Code Tutorial - Logic Errors|2]] |
[[AGI Error Code Tutorial - Interpreter Errors|3]] |
[[AGI Error Code Tutorial - Unacknowledged Errors|4]] |
[[AGI Error Code Tutorial - Debugging Techniques|5]] |
[[AGI Error Code Tutorial - Revision History|6]] |
</div><br />

 

[[AGI Tutorials|Tutorials Table of Contents]]<br />
[[AGI Error Code Tutorial|AGI Error Code Index]]

<span style="float: left">[[AGI Error Code Tutorial - Interpreter Errors|< Previous: Interpreter Errors]]</span><span style="float: right">[[AGI Error Code Tutorial - Debugging Techniques|Next: Debugging Techniques >]]</span>

 

[[Category:Debugging]]
[[Category:References]]
[[Category:Tutorials]]

@@ Line 1: / Line 1: @@
 [[Tutorials and Guides|Tutorials and Guides Table of Contents]]<br />
-[[AGI Error Code Tutorial|AGI Error Code Index]]
+[[Error Code Tutorial|Error Code Index]]
 <div align="center">
 Page:
-[[AGI Error Code Tutorial - Introduction|1]] |
+[[Error Code Tutorial - Introduction|1]] |
-[[AGI Error Code Tutorial - Logic Errors|2]] |
+[[Error Code Tutorial - Logic Errors|2]] |
-[[AGI Error Code Tutorial - Interpreter Errors|3]] |
+[[Error Code Tutorial - Interpreter Errors|3]] |
-[[AGI Error Code Tutorial - Unacknowledged Errors|4]] |
+[[Error Code Tutorial - Unacknowledged Errors|4]] |
-[[AGI Error Code Tutorial - Debugging Techniques|5]]
+[[Error Code Tutorial - Debugging Techniques|5]]
 </div><br />
@@ Line 69: / Line 69: @@
 <div align="center">
 Page:
-[[AGI Error Code Tutorial - Introduction|1]] |
+[[Error Code Tutorial - Introduction|1]] |
-[[AGI Error Code Tutorial - Logic Errors|2]] |
+[[Error Code Tutorial - Logic Errors|2]] |
-[[AGI Error Code Tutorial - Interpreter Errors|3]] |
+[[Error Code Tutorial - Interpreter Errors|3]] |
-[[AGI Error Code Tutorial - Unacknowledged Errors|4]] |
+[[Error Code Tutorial - Unacknowledged Errors|4]] |
-[[AGI Error Code Tutorial - Debugging Techniques|5]]
+[[Error Code Tutorial - Debugging Techniques|5]]
 </div><br />
 [[Tutorials and Guides|Tutorials and Guides Table of Contents]]<br />
-[[AGI Error Code Tutorial|AGI Error Code Index]]
+[[Error Code Tutorial|Error Code Index]]
-<span style="float: left">[[AGI Error Code Tutorial - Interpreter Errors|&lt; Previous: Interpreter Errors]]</span><span style="float: right">[[AGI Error Code Tutorial - Debugging Techniques|Next: Debugging Techniques &gt;]]</span>
+<span style="float: left">[[Error Code Tutorial - Interpreter Errors|&lt; Previous: Interpreter Errors]]</span><span style="float: right">[[Error Code Tutorial - Debugging Techniques|Next: Debugging Techniques &gt;]]</span>
 &nbsp;

@@ Line 33: / Line 33: @@
 Unfortunately, some modern video cards don't support EGA properly.  The only thing I can suggest is running the interpreter in CGA mode and seeing if that works:
-<blockquote><code>sierra -c</code><br />
+<blockquote><code>sierra -c<br />
-<code>sierra -r</code></blockquote>
+sierra -r</code></blockquote>
 The alternative is to try the range of free fanmade interpreters available: AGIL, NAGI and Sarien.  The quality of the new interpreters is that most games work.  They also don't use EGA, so they should work on modern systems.  You could always try replacing the graphics card or see if a bios update will fix the problem.  This is a common problem, and unfortunately it could kill the whole AGI gaming community.

@@ Line 24: / Line 24: @@
 <blockquote>
-The problem with Hitler's Quest was that it used a lot of resources, so the programmer decided to increase the script size.  This is fine, you're allowed to do that.  The problem was that he put the "script.size" command in a room logic, so it was called on every game loop.  The first thing "script.size" does, after it allocates a new script, is clear it.  So the list of all the resources was erased on every game loop.
+The problem with Hitler's Quest was that it used a lot of resources, so the programmer decided to increase the script size.  This is fine, you're allowed to do that.  The problem was that he put the "script.size" command in a room logic, so it was called on every game loop.  The first thing "script.size" does, after it allocates a new script, is clear it.  So the list of all the resources was erased on every game loop.<br />
+<br />
-So when a game was saved and later restored, the script of all the resources that were to be loaded was empty.  The moral of the story?  Make sure you only change the script size ONCE during the entire game, and make sure you do it before you load anything too.
+So when a game was saved and later restored, the script of all the resources that were to be loaded was empty.  The moral of the story?  Make sure you only change the script size ONCE during the entire game, and make sure you do it before you load anything too.<br />
+<br />
 ''No games work.  The display is half black, characters go missing, it's upside down.  Game worked on another system however.''
 </blockquote>

← Older revision	Revision as of 16:48, 25 December 2013
Line 17:	Line 17:


	+	There are errors that occur that aren't picked up by the interpreter until it's too late. When this happens you're not guaranteed of actually getting an error message at all, the interpreter could just act strange or hang. These errors are from my own experience, debugging NAGI to work with lots of games (Sierra and fan made), but I'm sure there are other ways of crashing. Some of these could be considered questions for a FAQ, but they are more of the horrible bug type nature.
	+
	+	<blockquote>''After you restore a game, the game is corrupted (screen, objects, anything)''</blockquote>
	+
	+	This happened in the ill-fated game Hitler's Quest. The interpreter stores a list of all the resources that are accessed in the current room so it can reload them in the exact same way when a user restores a game.
	+
	+	<blockquote>
	+	The problem with Hitler's Quest was that it used a lot of resources, so the programmer decided to increase the script size. This is fine, you're allowed to do that. The problem was that he put the "script.size" command in a room logic, so it was called on every game loop. The first thing "script.size" does, after it allocates a new script, is clear it. So the list of all the resources was erased on every game loop.
	+
	+	So when a game was saved and later restored, the script of all the resources that were to be loaded was empty. The moral of the story? Make sure you only change the script size ONCE during the entire game, and make sure you do it before you load anything too.
	+
	+	''No games work. The display is half black, characters go missing, it's upside down. Game worked on another system however.''
	+	</blockquote>
	+
	+	Unfortunately, some modern video cards don't support EGA properly. The only thing I can suggest is running the interpreter in CGA mode and seeing if that works:
	+
	+	<blockquote><code>sierra -c</code><br />
	+	<code>sierra -r</code></blockquote>
	+
	+	The alternative is to try the range of free fanmade interpreters available: AGIL, NAGI and Sarien. The quality of the new interpreters is that most games work. They also don't use EGA, so they should work on modern systems. You could always try replacing the graphics card or see if a bios update will fix the problem. This is a common problem, and unfortunately it could kill the whole AGI gaming community.
	+
	+	<blockquote>''In certain places of the game, the screen shakes for ages.''</blockquote>
	+
	+	There's a palette patch floating around for the interpreter. The way it works is that you specify a number over 100 to shake.screen and the number defines the palette to be displayed. The problem occurs when you try and run the game on an interpreter that doesn't have the palette patch. Run the game on a patched interpreter, or removed the shake.screen command.
	+
	+	<blockquote>''The game just hangs, or whenever the game tries to draw an animated object it hangs.''</blockquote>
	+
	+	I'm not suggesting this is the only reason why the interpreter would hang.. but this is the one way I've encountered the interpreter hanging without actually passing it corrupted data.
	+
	+	<blockquote>
	+	It's possible to corrupt the pointers inside an animated object. The code that sets the loop of an animated object doesn't properly check the limits of the available loops. Lets just say there's N loops. So you have loop 0 to loop N-1 (which is N loops). The interpreter doesn't properly check and actually lets you set animated object to use loop N, which is one loop above the maximum. I'm guessing the programmer missed an equals sign.<br />
	+	<br />
	+	Anyway, this bug occurs in Kings Quest 2, early versions of Space Quest: The Lost Chapter, and other fan games. When you set the loop to something that doesn't exist, all kinds of freaky things happen. The interpreter tries to read a pointer from loop graphics data, and what happens then depends on the data. In games like Kings Quest 2, nobody noticed. But in other games, it resulted in the interpreter hanging permanently.<br />
	+	<br />
	+	It's also possible to assign a view resource to an animated object and then discard the view resource. The animated object may still work for a while until you load another resource which will overwrite the discarded one. It's worse if you run a Windows interpreter because protected memory kicks in first and just crashes the program.<br />
	+	<br />
	+	''Restoring the game works unless you try it a few times, then it crashes.''
	+	</blockquote>
	+
	+	I've come across this problem in games that call restore.game within another logic. I think the interpreter was only meant to restore from logic.0. I'll try to explain...
	+
	+	<blockquote>
	+	The way the interpreter plays around with memory is strange.. but one thing that can be sure is that logic.0 is in memory all the time. It would have to be because it's loaded every single time the game loops. The problem with restoring a game is that the interpreter will discard all resources that were in use except logic.0 and then RETURN back to the calling logic. This is obviously not very bloody good at all if the logic that just called "restore.game" got discarded along with everything else. I don't know why, but it doesn't seem to crash the original interpreter, but it does crash NAGI.. occasionally. It was a pain to track down.<br />
	+	<br />
	+	Moral of the story? Only call "restore.game", "restart.game" and anything else that discards the calling logic in logic.0 because logic.0 is the only guaranteed resource to be in the same place after a restore.
	+	</blockquote>

Error Code Tutorial - Unacknowledged Errors - Revision history

Andrew Branscom: Collector moved page AGI Error Code Tutorial - Unacknowledged Errors to Error Code Tutorial - Unacknowledged Errors

Andrew Branscom at 16:54, 28 December 2013

Andrew Branscom at 20:05, 26 December 2013

Andrew Branscom at 16:49, 25 December 2013

Andrew Branscom at 16:48, 25 December 2013

Andrew Branscom at 16:48, 25 December 2013

Andrew Branscom at 16:35, 25 December 2013

Andrew Branscom: Created page with "Tutorials Table of Contents AGI Error Code Index Page: 1 ..."

Andrew Branscom: Created page with "Tutorials Table of Contents
AGI Error Code Index
Page: 1 ..."