papermario/include/evt.h
HailSanta 7b24d78503
area KZN and others (#795)
* kzn_01

* cleanup

* kzn_05

* sound name

* missed evt_ptr

* splat change

* broken :(

* pan params for other maps

* works, but not great

* some kzn funcs

* documentin

* minor

* kzn_07 funcs

* more matches

* kzn_08

* kzn_06 fixup

* kzn_01_fix

* kzn 5

* kzn_07

* surprisingly OK

* some matches

* letter choice

* refactor

* more maps

* check

* first area done!

* now with extra bonus map

* kzn23

* some camera stuff

* entrances adjustment

* kzn_22 OK

* kzn_22 cleanup

* kzn_20 ok

* kzn_20 cleanup

* kzn_18 ok

* kzn_18 cleanup

* kgr_01

* area kgr done

* kgr_02 renames

* kzn_11

* kzn_17 ok

* kzn_17 cleanup

* kzn_04 done

* kzn_03 ok

* kzn_19

* bad kzn_19

* funcs idk

* figured a thing out

* kzn_19 ok

* some matches

* kzn_19 cleanup

* all kzn funcs

* merg'd

* some kzn btl matches

* vine field renames

* kzn cleanup 1

* kzn cleanup 2

* tab patrol

* trailing space patrol

* piranha anims split

* actor type sounds

* example

* requests + remove hardcoded dma entries

* split vine image

Co-authored-by: HailSanta <Hail2Santa@gmail.com>
Co-authored-by: Ethan Roseman <ethteck@gmail.com>
2022-09-30 21:44:48 -04:00

150 lines
6.0 KiB
C

#ifndef _EVT_H_
#define _EVT_H_
#include "ultra64.h"
// Should be at least the width of a pointer i.e. intptr_t
typedef s32 Bytecode;
enum {
EVT_OP_INTERNAL_FETCH,
EVT_OP_END,
EVT_OP_RETURN,
EVT_OP_LABEL, ///< Args: index
EVT_OP_GOTO, ///< Args: index
EVT_OP_LOOP, ///< Args: number of repeats (0 = infinite)
EVT_OP_END_LOOP,
EVT_OP_BREAK_LOOP,
EVT_OP_WAIT_FRAMES,
EVT_OP_WAIT_SECS,
EVT_OP_IF_EQ, ///< Args: a, b
EVT_OP_IF_NE, ///< Args: a, b
EVT_OP_IF_LT, ///< Args: a, b
EVT_OP_IF_GT, ///< Args: a, b
EVT_OP_IF_LE, ///< Args: a, b
EVT_OP_IF_GE, ///< Args: a, b
EVT_OP_IF_FLAG, ///< Args: a, b
EVT_OP_IF_NOT_FLAG, ///< Args: a, b
EVT_OP_ELSE,
EVT_OP_END_IF,
EVT_OP_SWITCH, ///< Args: expression to test against
EVT_OP_SWITCH_CONST, ///< Args: value to test against
EVT_OP_CASE_EQ, ///< Args: expression to test for
EVT_OP_CASE_NE, ///< Args: expression to test for
EVT_OP_CASE_LT, ///< Args: expression to test for
EVT_OP_CASE_GT, ///< Args: expression to test for
EVT_OP_CASE_LE, ///< Args: expression to test for
EVT_OP_CASE_GE, ///< Args: expression to test for
EVT_OP_CASE_DEFAULT,
EVT_OP_CASE_OR_EQ, ///< Args: expression to test for
EVT_OP_CASE_AND_EQ, ///< Args: expression to test for
EVT_OP_CASE_FLAG, ///< Args: expression to test for
EVT_OP_END_CASE_GROUP, ///< Ends the case block of EVT_OP_CASE_OR_EQ condition(s).
EVT_OP_CASE_RANGE, ///< Args: from, to
EVT_OP_BREAK_SWITCH,
EVT_OP_END_SWITCH,
EVT_OP_SET, ///< Args: container, expression
EVT_OP_SET_CONST, ///< Args: container, value
EVT_OP_SETF, ///< Args: container, expression
EVT_OP_ADD, ///< Args: container, expression to increment by
EVT_OP_SUB, ///< Args: container, expression to decrement by
EVT_OP_MUL, ///< Args: container, expression to multiply by
EVT_OP_DIV, ///< Integer division. Args: container, expression to divide by
EVT_OP_MOD, ///< Args: container, expression to divide by
EVT_OP_ADDF, ///< Args: container, expression to increment by
EVT_OP_SUBF, ///< Args: container, expression to decrement by
EVT_OP_MULF, ///< Args: container, expression to multiply by
EVT_OP_DIVF, ///< Args: container, expression to divide by
EVT_OP_USE_BUF, ///< Args: s32*
EVT_OP_BUF_READ1, /// Args: container
EVT_OP_BUF_READ2, /// Args: container, container
EVT_OP_BUF_READ3, /// Args: container, container, container
EVT_OP_BUF_READ4, /// Args: container, container, container, container
EVT_OP_BUF_PEEK, ///< Args: index, container
EVT_OP_USE_FBUF, ///< Identical to USE_BUFFER. Args: f32*
EVT_OP_FBUF_READ1, /// Args: container
EVT_OP_FBUF_READ2, /// Args: container, container
EVT_OP_FBUF_READ3, /// Args: container, container, container
EVT_OP_FBUF_READ4, /// Args: container, container, container, container
EVT_OP_FBUF_PEEK, ///< Args: index, container
EVT_OP_USE_ARRAY, ///< Args: *s32
EVT_OP_USE_FLAGS, ///< Args: *s32
EVT_OP_MALLOC_ARRAY, ///< Allocates a new array. Args: length, s32*
EVT_OP_BITWISE_AND, ///< Args: container, expression to bitwise AND with
EVT_OP_BITWISE_AND_CONST, ///< Args: container, value to bitwise AND with
EVT_OP_BITWISE_OR, ///< Args: container, expression to bitwise OR with
EVT_OP_BITWISE_OR_CONST, ///< Args: container, value to bitwise OR with
EVT_OP_CALL, ///< Args: *function, ...
EVT_OP_EXEC, ///< Args: EvtScript*
EVT_OP_EXEC_GET_TID, ///< Args: EvtScript*, container
EVT_OP_EXEC_WAIT, ///< Spawns a script and waits for it to return before continuing. Args: EvtScript*
EVT_OP_BIND_TRIGGER, ///< Args: EvtScript*, trigger flags, s32 target, 1, Trigger*
EVT_OP_UNBIND, ///< Unbinds any triggers bound to this script.
EVT_OP_KILL_THREAD, ///< Args: ScriptID
EVT_OP_JUMP, ///< Args: EvtScript*
EVT_OP_SET_PRIORITY, ///< Args: priority
EVT_OP_SET_TIMESCALE, ///< Args: timescale
EVT_OP_SET_GROUP, ///< Args: group
EVT_OP_BIND_PADLOCK, ///< Args: EvtScript*, trigger flags, s32 target, ItemList*, 0, 1
EVT_OP_SUSPEND_GROUP, ///< Args: group
EVT_OP_RESUME_GROUP, ///< Args: group
EVT_OP_SUSPEND_OTHERS, ///< Args: group
EVT_OP_RESUME_OTHERS, ///< Args: group
EVT_OP_SUSPEND_THREAD, ///< Args: ScriptID
EVT_OP_RESUME_THREAD, ///< Args: ScriptID
EVT_OP_IS_THREAD_RUNNING, ///< Args: ScriptID, container
EVT_OP_THREAD,
EVT_OP_END_THREAD,
EVT_OP_CHILD_THREAD, ///< Parallel threads are killed as soon as the parent script returns.
EVT_OP_END_CHILD_THREAD,
EVT_OP_90,
EVT_OP_DEBUG_PRINT, ///< Args: expression
EVT_OP_92,
EVT_OP_93,
EVT_OP_94,
};
#define MAKE_ENTITY_END 0x80000000
/* Return type of evt_execute_next_command */
#define EVT_CONTINUE 0 /* Continue to next command */
#define EVT_ABORT 1 /* Quit execution */
#define EVT_FINISH 255 /* Return from script */
/* Return type of script API functions */
typedef s32 ApiStatus;
#define ApiStatus_BLOCK 0 /* Call again next frame */
#define ApiStatus_DONE1 1 /* Unconditional. Probably only exists to return a bool from functions */
#define ApiStatus_DONE2 2 /* Conditional on Evt->disableScripts */
#define ApiStatus_REPEAT 3 /* Call again immediately */
#define ApiStatus_FINISH 255 /* Corresponds to EVT_FINISH */
enum EventGroupFlags {
EVT_GROUP_00 = 0x00,
EVT_GROUP_0A = 0x0A, // 8 | 2
EVT_GROUP_0B = 0x0B, // 8 | 4 | 1
EVT_GROUP_1B = 0x1B, // 10 | 8 | 4 | 1
EVT_GROUP_EF = 0xEF, // ~10
EVT_GROUP_01 = 0x01,
EVT_GROUP_02 = 0x02,
EVT_GROUP_04 = 0x04,
EVT_GROUP_08 = 0x08,
EVT_GROUP_10 = 0x10,
};
enum EventPriority {
EVT_PRIORITY_0 = 0x00, // map main script
EVT_PRIORITY_1 = 0x01,
EVT_PRIORITY_A = 0x0A,
EVT_PRIORITY_14 = 0x14,
};
enum EventStateFlags {
EVT_FLAG_01 = 0x01,
EVT_FLAG_10 = 0x10, // has child?
EVT_FLAG_20 = 0x20, // add to global script list
EVT_FLAG_40 = 0x40, // thread?
};
#endif