ScummVM API documentation
interpreter.h
1/* ScummVM - Graphic Adventure Engine
2 *
3 * ScummVM is the legal property of its developers, whose names
4 * are too numerous to list here. Please refer to the COPYRIGHT
5 * file distributed with this source distribution.
6 *
7 * Additional copyright for this file:
8 * Copyright (C) 1994-1998 Revolution Software Ltd.
9 *
10 * This program is free software: you can redistribute it and/or modify
11 * it under the terms of the GNU General Public License as published by
12 * the Free Software Foundation, either version 3 of the License, or
13 * (at your option) any later version.
14 *
15 * This program is distributed in the hope that it will be useful,
16 * but WITHOUT ANY WARRANTY; without even the implied warranty of
17 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
18 * GNU General Public License for more details.
19 *
20 * You should have received a copy of the GNU General Public License
21 * along with this program. If not, see <http://www.gnu.org/licenses/>.
22 */
23
24#ifndef SWORD2_INTERPRETER_H
25#define SWORD2_INTERPRETER_H
26
27#include "common/endian.h"
28
29namespace Sword2 {
30
31// Interpreter return codes
32
33enum {
34 IR_STOP = 0, // Quit for a cycle
35 IR_CONT = 1, // Continue as normal
36 IR_TERMINATE = 2, // Return without updating the offset
37 IR_REPEAT = 3, // Return; offset at start of function call
38 IR_GOSUB = 4 // Return with updated offset
39};
40
41// Get parameter fix so that the playstation version can handle words not on
42// word boundaries
43
44#define Read8ip(var) { var = code[ip]; ip++; }
45#define Read16ip(var) { var = (int16)READ_LE_UINT16(code + ip); ip += 2; }
46#define Read32ip(var) { var = (int32)READ_LE_UINT32(code + ip); ip += 4; }
47#define Read32ipLeaveip(var) { var = (int32)READ_LE_UINT32(code + ip); }
48
49enum {
50 // Compiled tokens
51
52 CP_END_SCRIPT = 0,
53 CP_PUSH_LOCAL_VAR32 = 1, // Push a local variable on to the stack
54 CP_PUSH_GLOBAL_VAR32 = 2, // Push a global variable
55 CP_POP_LOCAL_VAR32 = 3, // Pop a local variable from the stack
56 CP_CALL_MCODE = 4, // Call a machine code function
57 CP_PUSH_LOCAL_ADDR = 5, // Push the address of a local variable
58 CP_PUSH_INT32 = 6, // Adjust the stack after calling an fn function
59 CP_SKIPONFALSE = 7, // Skip if the bottom value on the stack is false
60 CP_SKIPALWAYS = 8, // Skip a block of code
61 CP_SWITCH = 9, // Switch on last stack value
62 CP_ADDNPOP_LOCAL_VAR32 = 10, // Add to a local varible
63 CP_SUBNPOP_LOCAL_VAR32 = 11, // Subtract from a local variable
64 CP_SKIPONTRUE = 12, // Skip if the bottom value on the stack is true
65 CP_POP_GLOBAL_VAR32 = 13, // Pop a global variable
66 CP_ADDNPOP_GLOBAL_VAR32 = 14, // Add to a global variable
67 CP_SUBNPOP_GLOBAL_VAR32 = 15, // Subtract from a global variable
68 CP_DEBUGON = 16, // Turn debugging on
69 CP_DEBUGOFF = 17, // Turn debugging off
70 CP_QUIT = 18, // Quit for a cycle
71 CP_TERMINATE = 19, // Quit script completely
72
73 // Operators
74
75 OP_ISEQUAL = 20, // '=='
76 OP_PLUS = 21, // '+'
77 OP_MINUS = 22, // '-'
78 OP_TIMES = 23, // '*'
79 OP_DIVIDE = 24, // '/'
80 OP_NOTEQUAL = 25, // '=='
81 OP_ANDAND = 26, // '&&'
82 OP_GTTHAN = 27, // '>'
83 OP_LSTHAN = 28, // '<'
84
85 // More tokens, mixed types
86
87 CP_JUMP_ON_RETURNED = 29, // Use table of jumps with value returned from fn_mcode
88 CP_TEMP_TEXT_PROCESS = 30, // A dummy text process command for me
89 CP_SAVE_MCODE_START = 31, // Save the mcode code start for restarting when necessary
90 CP_RESTART_SCRIPT = 32, // Start the script from the beginning
91 CP_PUSH_STRING = 33, // Push a pointer to a string on the stack
92 CP_PUSH_DEREFERENCED_STRUCTURE = 34, // Push the address of a structure thing
93 OP_GTTHANE = 35, // >=
94 OP_LSTHANE = 36, // <=
95 OP_OROR = 37 // || or OR
96};
97
98} // End of namespace Sword2
99
100#endif
Definition: animation.h:37