AGI Error Code Tutorial - Unacknowledged Errors - Revision history

Andrew Branscom at 15:09, 8 April 2025

2025-04-08T15:09:44Z

← Older revision		Revision as of 10:09, 8 April 2025
Line 2:		Line 2:
	[[Category:Temp AGI Tutorials]]		[[Category:Temp AGI Tutorials]]
	[[AGI Tutorials and Guides\|AGI Tutorials and Guides Table of Contents]]<br />		[[AGI Tutorials and Guides\|AGI Tutorials and Guides Table of Contents]]<br />
	[[Error Code Tutorial\|Error Code Index]]		[[AGI Error Code Tutorial\|Error Code Index]]

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

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

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

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

Andrew Branscom: Andrew Branscom moved page Error Code Tutorial - Unacknowledged Errors to AGI Error Code Tutorial - Unacknowledged Errors without leaving a redirect

2025-04-08T15:05:38Z

Andrew Branscom moved page Error Code Tutorial - Unacknowledged Errors to AGI Error Code Tutorial - Unacknowledged Errors without leaving a redirect

← Older revision	Revision as of 10:05, 8 April 2025
(No difference)

Andrew Branscom: /* Related Links */

2025-04-05T22:47:12Z

Andrew Branscom at 22:46, 5 April 2025

2025-04-05T22:46:35Z

← Older revision		Revision as of 17:46, 5 April 2025
Line 1:		Line 1:
			[[Category:AGI Pages]]
	[[Category:Temp AGI Tutorials]]		[[Category:Temp AGI Tutorials]]
	~~[[Category:AGI Pages]]~~
	[[AGI Tutorials and Guides\|AGI Tutorials and Guides Table of Contents]]<br />		[[AGI Tutorials and Guides\|AGI Tutorials and Guides Table of Contents]]<br />
	[[Error Code Tutorial\|Error Code Index]]		[[Error Code Tutorial\|Error Code Index]]
Line 13:		Line 13:
	</div><br />		</div><br />

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

	~~ ~~		<br />
			==<br /> Introduction ==

	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.		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.

Andrew Branscom at 22:11, 23 March 2025

2025-03-23T22:11:44Z

← Older revision		Revision as of 17:11, 23 March 2025
Line 1:		Line 1:
	[[Category:Temp AGI Tutorials]][[Tutorials and Guides\|Tutorials and Guides Table of Contents]]<br />		[[Category:Temp AGI Tutorials]]
			[[Category:AGI Pages]]
			[[AGI Tutorials and Guides\|AGI Tutorials and Guides Table of Contents]]<br />
	[[Error Code Tutorial\|Error Code Index]]		[[Error Code Tutorial\|Error Code Index]]

Line 64:		Line 66:
	</blockquote>		</blockquote>

			==<br /> References ==

			<references />

			==<br /> Related Links ==

			*

	<div align="center">		<div align="center">
Line 76:		Line 83:
	</div><br />		</div><br />

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

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



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

Andrew Branscom at 23:38, 22 March 2025

2025-03-22T23:38:30Z

← Older revision		Revision as of 18:38, 22 March 2025
Line 1:		Line 1:
	[[Temp AGI Tutorials]][[Tutorials and Guides\|Tutorials and Guides Table of Contents]]<br />		[[Category:Temp AGI Tutorials]][[Tutorials and Guides\|Tutorials and Guides Table of Contents]]<br />
	[[Error Code Tutorial\|Error Code Index]]		[[Error Code Tutorial\|Error Code Index]]

Andrew Branscom: 1 revision imported

2025-03-22T23:19:53Z

1 revision imported

← Older revision	Revision as of 18:19, 22 March 2025
(No difference)

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

New page

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

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

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

 

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.<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.<br />
<br />
''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<br />
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>

 

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

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

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

 

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

← Older revision		Revision as of 17:47, 5 April 2025
Line 90:		Line 90:

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