mirror of
https://github.com/pmret/papermario.git
synced 2024-11-18 00:42:34 +01:00
167 lines
7.9 KiB
C
167 lines
7.9 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_DEBUG_LOG,
|
|
EVT_OP_DEBUG_PRINT_VAR, ///< 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 EventCommandResults {
|
|
EVT_CMD_RESULT_YIELD = -1,
|
|
EVT_CMD_RESULT_CONTINUE = 0,
|
|
EVT_CMD_RESULT_ERROR = 1,
|
|
};
|
|
|
|
// EventGroupFlags determine when scripts are paused and resumed.
|
|
// Each flag corresponds to a set of circumstances which may pause scripts independently of the others.
|
|
// These group flags are inherited when one script launches another.
|
|
enum EventGroupFlags {
|
|
// Each flag represents a distinct condition for suspending or resuming script execution.
|
|
// These flags are named based on the scenarios that trigger suspension.
|
|
EVT_GROUP_FLAG_INTERACT = 0x01, // Suspended during certain scenes, interactions, and NPC dialogue.
|
|
EVT_GROUP_FLAG_MENUS = 0x02, // Suspended when menus are open, during pause, item pickups, or "got item" scenes.
|
|
EVT_GROUP_FLAG_CAM = 0x04, // Never suspended; used exclusively with camera shake (ShakeCam) scripts.
|
|
EVT_GROUP_FLAG_UNUSED = 0x08, // Unused flag; its original purpose is unknown.
|
|
EVT_GROUP_FLAG_BATTLE = 0x10, // Suspended during battle entry and exit transitions.
|
|
|
|
// Combinations of flags used to assign specific behaviors to scripts.
|
|
// These groups are named after their most common script use-cases.
|
|
EVT_GROUP_NEVER_PAUSE = 0x00, // Never paused; default for map scripts derived from the main script, which always uses this group.
|
|
EVT_GROUP_PASSIVE_NPC = EVT_GROUP_FLAG_MENUS | EVT_GROUP_FLAG_UNUSED, // 0xA -- Pauses similar to passive NPC scripts.
|
|
EVT_GROUP_HOSTILE_NPC = EVT_GROUP_FLAG_INTERACT | EVT_GROUP_FLAG_MENUS | EVT_GROUP_FLAG_UNUSED, // 0xB -- Pauses similar to hostile NPC scripts; used for platforms, machinery, etc.
|
|
EVT_GROUP_EXIT_MAP = EVT_GROUP_FLAG_INTERACT | EVT_GROUP_FLAG_MENUS | EVT_GROUP_FLAG_UNUSED | EVT_GROUP_FLAG_BATTLE, // 0x1B -- Used for exit map scripts.
|
|
EVT_GROUP_SHAKE_CAM = EVT_GROUP_FLAG_CAM, // Only used by ShakeCam scripts.
|
|
EVT_GROUP_NOT_BATTLE = 0xFF & ~EVT_GROUP_FLAG_BATTLE, // 0xEF -- Pauses from anything except battles; default for scripts started via start_script, common in many battle scripts.
|
|
};
|
|
|
|
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_ACTIVE = 0x01,
|
|
EVT_FLAG_PAUSED = 0x02, ///< paused through suspend_group_script / resume_group_script
|
|
EVT_FLAG_BLOCKED_BY_CHILD = 0x10,
|
|
EVT_FLAG_RUN_IMMEDIATELY = 0x20, ///< don't wait for next `update_scripts` call
|
|
EVT_FLAG_THREAD = 0x40,
|
|
EVT_FLAG_SUSPENDED = 0x80, ///< doesn't affect child
|
|
};
|
|
|
|
#endif
|