AGI Command Reference - Program Control Commands - Revision history

Andrew Korson: Blanked the page

2019-03-23T00:56:22Z

Blanked the page

Andrew Branscom at 00:09, 29 December 2013

2013-12-29T00:09:49Z

Andrew Branscom at 19:54, 28 December 2013

2013-12-28T19:54:45Z

Andrew Branscom: /* set.scan.start reset.scan.start */

2013-12-26T19:29:55Z

set.scan.start reset.scan.start

Andrew Branscom at 19:11, 26 December 2013

2013-12-26T19:11:13Z

Andrew Branscom at 02:03, 26 December 2013

2013-12-26T02:03:13Z

Andrew Branscom: /* set.scan.start reset.scan.start */

2013-12-23T04:25:09Z

set.scan.start reset.scan.start

Andrew Branscom at 01:17, 22 December 2013

2013-12-22T01:17:07Z

Andrew Branscom at 00:08, 22 December 2013

2013-12-22T00:08:21Z

Andrew Branscom at 00:00, 22 December 2013

2013-12-22T00:00:19Z

← Older revision		Revision as of 00:56, 23 March 2019
Line 1:		Line 1:
−	~~[[Tutorials and Guides\|Tutorials and Guides Table of Contents]]<br />~~
−	~~[[AGI Command Reference\|AGI Command Reference Index]]<br />~~

−	~~<div align="center">~~
−	~~Page:~~
−	~~[[AGI Command Reference - Arithmetic Commands\|1]] \|~~
−	~~[[AGI Command Reference - Commands to Load and unLoad Resources\|2]] \|~~
−	~~[[AGI Command Reference - Program Control Commands\|3]] \|~~
−	~~[[AGI Command Reference - Object Control Commands\|4]] \|~~
−	~~[[AGI Command Reference - Object Description Commands\|5]] \|~~
−	~~[[AGI Command Reference - Object Motion Control Commands\|6]] \|~~
−	~~[[AGI Command Reference - Inventory Item Management Commands\|7]] \|~~
−	~~[[AGI Command Reference - Picture Resource Management Commands\|8]] \|~~
−	~~[[AGI Command Reference - Sound Resource Management Commands\|9]] \|~~
−	~~[[AGI Command Reference - Text Management Commands\|10]] \|~~
−	~~[[AGI Command Reference - String Management Commands\|11]] \|~~
−	~~[[AGI Command Reference - Initialization Commands\|12]] \|~~
−	~~[[AGI Command Reference - Menu Management Commands\|13]] \|~~
−	~~[[AGI Command Reference - Test Commands\|14]] \|~~
−	~~[[AGI Command Reference - Other Commands\|15]] \|~~
−	~~[[AGI Command Reference - Unknown Commands\|16]]~~
−	~~</div><br />~~
−
−	~~<div align="center"><span style="font-size: 22pt">Program Control Commands</span><br />~~
−	~~''By [[Chris Cromer]]''</div>~~
−
−	~~ ~~
−
−	<code>new.room</code> command is one of the most powerful commands of the interpreter. It is used to change algorithms of the object behavior, props, etc. Automatic change of EGO coordinates imitates moving into a room adjacent to the edge of the initial one.
−
−	~~Sounds awkward but that's what it says.~~
−
−	~~The format of the command:~~
−
−	~~== <br />new.room(n); new.room.v(n); ==~~
−
−	~~<blockquote>~~
−	* These commands do the following:
−	* Commands stop_update and unanimate are issued to all objects;
−	* All resources except Logic(0) are discarded;
−	* Command player_control is issued;
−	* unblock command is issued;
−	* set_horizon 36' command is issued;
−	* Var(1) is assigned the value of Var(0);
−	* Var(0) is assigned n (or the value of Var(n)
−	* when the command is new_room_v);
−	* Var(4) is assigned 0;
−	* Var(5) is assigned 0;
−	* Var(16) is assigned the ID number of the View resource that was
−	* associated with EGO (the player character).
−	* Logic(i) resource is loaded where i is the value of Var(0)!
−	* Set EGO coordinates according to Var(2):
−	** if EGO touched the bottom edge, put it on the horizon;
−	** if EGO touched the top edge, put it on the bottom edge of the screen;
−	** if EGO touched the right edge, put it at the left and vice versa.
−	* Var(2) is assigned 0 (meaning EGO has not touched any edges).
−	* Flag(5) is set to 1 (meaning in the first interpreter cycle after the new_room command all initialization parts of all logics loaded and called from the initialization part of the new room's logic will be called. In the subsequent cycle Flag(5) is reset to 0.
−	* Clear keyboard input buffer and return to the main AGI loop.
−	~~</blockquote>~~
−
−	~~== call(n); call.v(n); ==~~
−
−	~~<blockquote>Subroutine call commands~~
−
−	<blockquote>LOGIC resource number n (or number i where i the value of Var(n)) is executed as a subroutine. If the logic with the given ID is not loaded in memory, it is temporarily loaded and discarded after returning from the call (this takes extra time). call command does not change any variables or flags.</blockquote></blockquote>
−
−	~~== return(); ==~~
−
−	~~<blockquote>This command returns control to the interpreter if it is executed in Logic(0), or to the command following the call command which called the current logic.</blockquote>~~
−
−	~~== jump [label] ==~~
−
−	~~ This command unconditionally transfers control to a command starting with a symbol combination within the same logic.~~
−
−	~~== set.scan.start reset.scan.start ==~~
−
−	<blockquote>Normally, when a logic is called using call command, execution begins at the first instruction. set_scan_start command sets the entry point at the command following it, while reset_scan_start returns entry point to the beginning.</blockquote>
−
−	~~ ~~
−
−	~~<div align="center">~~
−	~~Page:~~
−	~~[[AGI Command Reference - Arithmetic Commands\|1]] \|~~
−	~~[[AGI Command Reference - Commands to Load and unLoad Resources\|2]] \|~~
−	~~[[AGI Command Reference - Program Control Commands\|3]] \|~~
−	~~[[AGI Command Reference - Object Control Commands\|4]] \|~~
−	~~[[AGI Command Reference - Object Description Commands\|5]] \|~~
−	~~[[AGI Command Reference - Object Motion Control Commands\|6]] \|~~
−	~~[[AGI Command Reference - Inventory Item Management Commands\|7]] \|~~
−	~~[[AGI Command Reference - Picture Resource Management Commands\|8]] \|~~
−	~~[[AGI Command Reference - Sound Resource Management Commands\|9]] \|~~
−	~~[[AGI Command Reference - Text Management Commands\|10]] \|~~
−	~~[[AGI Command Reference - String Management Commands\|11]] \|~~
−	~~[[AGI Command Reference - Initialization Commands\|12]] \|~~
−	~~[[AGI Command Reference - Menu Management Commands\|13]] \|~~
−	~~[[AGI Command Reference - Test Commands\|14]] \|~~
−	~~[[AGI Command Reference - Other Commands\|15]] \|~~
−	~~[[AGI Command Reference - Unknown Commands\|16]]~~
−	~~</div><br />~~
−
−	~~[[Tutorials and Guides\|Tutorials and Guides Table of Contents]]<br />~~
−	~~[[AGI Command Reference\|AGI Command Reference Index]]~~
−
−	<span style="float: left">[[AGI Command Reference - Commands to Load and unLoad Resources\|< Previous: Commands to Load and unLoad Resources]]</span><span style="float: right">[[AGI Command Reference - Object Control Commands\|Next: Object Control Commands >]]</span>
−
−	~~ ~~
−
−	~~[[Category:Logic]]~~
−	~~[[Category:Commands]]~~
−	~~[[Category:References]]~~
−	~~[[Category:Tutorials]]~~

@@ Line 47: / Line 47: @@
 * Var(4) is assigned 0;
 * Var(5) is assigned 0;
-* Var(16) is assigned the ID number of the VIEW resource that was
+* Var(16) is assigned the ID number of the View resource that was
 * associated with EGO (the player character).
 * Logic(i) resource is loaded where i is the value of Var(0)!

@@ Line 11: / Line 11: @@
 [[AGI Command Reference - Object Motion Control Commands|6]] |
 [[AGI Command Reference - Inventory Item Management Commands|7]] |
-[[AGI Command Reference - PIC Resource Management Commands|8]] |
+[[AGI Command Reference - Picture Resource Management Commands|8]] |
 [[AGI Command Reference - Sound Resource Management Commands|9]] |
 [[AGI Command Reference - Text Management Commands|10]] |
@@ Line 88: / Line 88: @@
 [[AGI Command Reference - Object Motion Control Commands|6]] |
 [[AGI Command Reference - Inventory Item Management Commands|7]] |
-[[AGI Command Reference - PIC Resource Management Commands|8]] |
+[[AGI Command Reference - Picture Resource Management Commands|8]] |
 [[AGI Command Reference - Sound Resource Management Commands|9]] |
 [[AGI Command Reference - Text Management Commands|10]] |

@@ Line 99: / Line 99: @@
 </div><br />
-[[AGI Tutorials|Tutorials Table of Contents]]<br />
+[[Tutorials and Guides|Tutorials and Guides Table of Contents]]<br />
-[[Tutorials and Guides|Tutorials and Guides Table of Contents]]
+[[AGI Command Reference|AGI Command Reference Index]]
 <span style="float: left">[[AGI Command Reference - Commands to Load and unLoad Resources|&lt; Previous: Commands to Load and unLoad Resources]]</span><span style="float: right">[[AGI Command Reference - Object Control Commands|Next: Object Control Commands &gt;]]</span>

@@ Line 1: / Line 1: @@
-[[AGI Tutorials|Tutorials Table of Contents]]<br />
+[[Tutorials and Guides|Tutorials and Guides Table of Contents]]<br />
 [[AGI Command Reference|AGI Command Reference Index]]<br />
@@ Line 100: / Line 100: @@
 [[AGI Tutorials|Tutorials Table of Contents]]<br />
-[[AGI Command Reference|AGI Command Reference Index]]
+[[Tutorials and Guides|Tutorials and Guides Table of Contents]]
 <span style="float: left">[[AGI Command Reference - Commands to Load and unLoad Resources|&lt; Previous: Commands to Load and unLoad Resources]]</span><span style="float: right">[[AGI Command Reference - Object Control Commands|Next: Object Control Commands &gt;]]</span>

@@ Line 106: / Line 106: @@
 &nbsp;
 [[Category:Commands]]
 [[Category:References]]
 [[Category:Tutorials]]

← Older revision	Revision as of 01:17, 22 December 2013
Line 27:	Line 27:


	+	<code>new.room</code> command is one of the most powerful commands of the interpreter. It is used to change algorithms of the object behavior, props, etc. Automatic change of EGO coordinates imitates moving into a room adjacent to the edge of the initial one.

	+	Sounds awkward but that's what it says.
	+
	+	The format of the command:
	+
	+	== <br />new.room(n); new.room.v(n); ==
	+
	+	<blockquote>
	+	* These commands do the following:
	+	* Commands stop_update and unanimate are issued to all objects;
	+	* All resources except Logic(0) are discarded;
	+	* Command player_control is issued;
	+	* unblock command is issued;
	+	* set_horizon 36' command is issued;
	+	* Var(1) is assigned the value of Var(0);
	+	* Var(0) is assigned n (or the value of Var(n)
	+	* when the command is new_room_v);
	+	* Var(4) is assigned 0;
	+	* Var(5) is assigned 0;
	+	* Var(16) is assigned the ID number of the VIEW resource that was
	+	* associated with EGO (the player character).
	+	* Logic(i) resource is loaded where i is the value of Var(0)!
	+	* Set EGO coordinates according to Var(2):
	+	** if EGO touched the bottom edge, put it on the horizon;
	+	** if EGO touched the top edge, put it on the bottom edge of the screen;
	+	** if EGO touched the right edge, put it at the left and vice versa.
	+	* Var(2) is assigned 0 (meaning EGO has not touched any edges).
	+	* Flag(5) is set to 1 (meaning in the first interpreter cycle after the new_room command all initialization parts of all logics loaded and called from the initialization part of the new room's logic will be called. In the subsequent cycle Flag(5) is reset to 0.
	+	* Clear keyboard input buffer and return to the main AGI loop.
	+	</blockquote>
	+
	+	== call(n); call.v(n); ==
	+
	+	<blockquote>Subroutine call commands
	+
	+	<blockquote>LOGIC resource number n (or number i where i the value of Var(n)) is executed as a subroutine. If the logic with the given ID is not loaded in memory, it is temporarily loaded and discarded after returning from the call (this takes extra time). call command does not change any variables or flags.</blockquote></blockquote>
	+
	+	== return(); ==
	+
	+	<blockquote>This command returns control to the interpreter if it is executed in Logic(0), or to the command following the call command which called the current logic.</blockquote>
	+
	+	== jump [label] ==
	+
	+	This command unconditionally transfers control to a command starting with a symbol combination within the same logic.
	+
	+	== set.scan.start reset.scan.start ==
	+
	+	<blockquote>Normally, when a logic is called using call command, execution begins at the first instruction. set_scan_start command sets the entry point at the command following it, while reset_scan_start returns entry point to the beginning.</blockquote>

← Older revision	Revision as of 00:00, 22 December 2013
Line 57:	Line 57:


	+
	+	[[Category:References]]
	+	[[Category:Tutorials]]