Difference between revisions of "AGI Command Reference"

From AGI Wiki
Jump to navigationJump to search
(Created page with "AGI Command Reference Thanks to the Sarien team and to Nick Sonneveld for some info on the unknown commands. '''Table of Contents''' # AGI Command Reference 1 - ARITHMET...")
 
Line 21: Line 21:
 
# [[AGI Command Reference 14 - TEST COMMANDS|TEST COMMANDS]]
 
# [[AGI Command Reference 14 - TEST COMMANDS|TEST COMMANDS]]
 
# [[AGI Command Reference 15 - OTHER COMMANDS|OTHER COMMANDS]]
 
# [[AGI Command Reference 15 - OTHER COMMANDS|OTHER COMMANDS]]
# [[AGI Command Reference 16 - UNKNOWN COMMANDS|UNKNOWN COMMANDS]]
+
# [[AGI Command Reference 16 - UNKNOWN COMMANDS|UNKNOWN COMMANDS]]<br />
 +
&nbsp;
  
 
<h2 align="center">I ARITHMETIC COMMANDS</h2>
 
<h2 align="center">I ARITHMETIC COMMANDS</h2>

Revision as of 19:54, 12 December 2013

AGI Command Reference

Thanks to the Sarien team and to Nick Sonneveld for some info on the unknown commands.


Table of Contents

  1. ARITHMETIC COMMANDS
  2. COMMANDS TO LOAD AND UNLOAD RESOURCES
  3. PROGRAM CONTROL COMMANDS
  4. OBJECT CONTROL COMMANDS
  5. OBJECT DESCRIPTION COMMANDS
  6. OBJECT MOTION CONTROL COMMANDS
  7. INVENTORY ITEM MANAGEMENT COMMANDS
  8. PICTURE RESOURCE MANAGEMENT COMMANDS
  9. SOUND RESOURCE MANAGEMENT COMMANDS
  10. TEXT MANAGEMENT COMMANDS
  11. STRING MANAGEMENT COMMANDS
  12. INITIALIZATION COMMANDS
  13. MENU MANAGEMENT COMMANDS
  14. TEST COMMANDS
  15. OTHER COMMANDS
  16. UNKNOWN COMMANDS

 

I ARITHMETIC COMMANDS

Commands that operate on variables:

increment(n);

The value of the variable Var(n) is incremented by one, i.e.
Var(n) = Var(n)+1. If the value is already 255, it is left unchanged.

decrement(n);

The value of the variable Var(n) is decremented by one, i.e.
Var(n) = Var(n)-1. If the value is 0, it is left unchanged.

assign(n, m);

Variable Var(n) is assigned the value m, i.e. Var(n) = m

assignv(n, m);

Variable Var(n) is assigned the value of Var(m), i.e.
Var(n) = Var(m).

addn(n, m);

The value of variable Var(n) is incremented by m, i.e.
Var(n) = Var(n) + m.

addv(n, m);

The value of variable Var(n) is incremented by the value of Var(m), i.e. Var(n) = Var(n) + m.
[Now what happens in the above two commands on 8-bit overflow: does the result wrap over 0 or stays 255?
I.e. is 250 + 10 == 4 or 250 + 10 == 255?]

subn(n, m);

The value of Var(n) is decremented by m, I.e. Var(n) = Var(n) - m

subv(n, m);

The value of Var(n) is decremented by Var(m), i.e. Var(n) = Var(n) - Var(m).
[Again, what happens when the result must be negative: is
1 - 2 == 255 or 1 - 2 == 0?]

lindirectn(n, m);

Variable Var(i) where i is the value of Var(n) is assigned a value m, i.e. Var(Var(n)) = m.

lindirectv(n, m);

Variable Var(i) where i is the value of Var(n) is assigned the value of Var(m), i.e. Var(Var(n)) = Var(m).

rindirect(n, m);

Variable Var(n) is assigned the value of Var(i) where i is the value of Var(m), i.e. Var(n) = Var(Var(m)).

muln(n, m);

Variable Var(n) is multiplied by m, i.e. Var(n) = Var(n) * m.

mulv(n, m);

Variable Var(n) is multiplied by the value of Var(m), i.e.
Var(n) = Var(n) * Var(m).
[What happens on overflow?]

divn(n, m)

Variable Var(n) is divided by m, i.e. Var(n) = Var(n) / m.

divv(n, m)

Variable Var(n) is divided by the value of Var(m),
i.e. Var(n) = Var(n) / Var(m). [What happens on division by 0?]

random(n, m, k)

Variable Var(k) is assigned a random value in the range between n and m. Now let us consider the commands changing flag values. Remember that a flag can only have a value 0 or 1.

set(n)

flag(n) is set to 1.

set.v(n)

flag(i), where i is the value of var (n), is set to 1. i.e.
flag(var(n)) = 1.

reset(n)

flag(n) is set to 0.

reset.v(n)

flag(i), where i is the value of var (n), is set to 0, i.e.
flag(var(n)) = 0.

toggle(n)

flag(n) toggles its value.

toggle.v(n)

flag(i), where i is the value of var (n), i.e. flag(var(n)), toggles is value.

Page: [ 1 ] | AGI Command Reference 1 | AGI Command Reference 2 | AGI Command Reference 3 | AGI Command Reference 4 | AGI Command Reference 5 | AGI Command Reference 6 | AGI Command Reference 7 | AGI Command Reference 8 | AGI Command Reference 9 | AGI Command Reference 10 | AGI Command Reference 11 | AGI Command Reference 12 | AGI Command Reference 13 | AGI Command Reference 14 | AGI Command Reference 15 | AGI Command Reference 16