diff options
| -rw-r--r-- | engines/xeen/scripts.cpp | 12 | ||||
| -rw-r--r-- | engines/xeen/scripts.h | 116 |
2 files changed, 118 insertions, 10 deletions
diff --git a/engines/xeen/scripts.cpp b/engines/xeen/scripts.cpp index a2c5bca239..a78bc23301 100644 --- a/engines/xeen/scripts.cpp +++ b/engines/xeen/scripts.cpp @@ -335,14 +335,14 @@ bool Scripts::doOpcode(MazeEvent &event) { &Scripts::cmdTeleport, &Scripts::cmdWhoWill, &Scripts::cmdRndDamage, &Scripts::cmdMoveWallObj, &Scripts::cmdAlterCellFlag, &Scripts::cmdAlterHed, &Scripts::cmdDisplayStat, &Scripts::cmdTakeOrGive, - &Scripts::cmdSeatTextSml, &Scripts::cmdPlayEventVoc, &Scripts::cmdDisplayBottom, - &Scripts::cmdIfMapFlag, &Scripts::cmdSelRndChar, &Scripts::cmdGiveEnchanted, + &Scripts::cmdSignTextSml, &Scripts::cmdPlayEventVoc, &Scripts::cmdDisplayBottom, + &Scripts::cmdIfMapFlag, &Scripts::cmdSelectRandomChar, &Scripts::cmdGiveEnchanted, &Scripts::cmdItemType, &Scripts::cmdMakeNothingHere, &Scripts::cmdCheckProtection, &Scripts::cmdChooseNumeric, &Scripts::cmdDisplayBottomTwoLines, &Scripts::cmdDisplayLarge, &Scripts::cmdExchObj, &Scripts::cmdFallToMap, &Scripts::cmdDisplayMain, &Scripts::cmdGoto, &Scripts::cmdConfirmEnding, &Scripts::cmdGotoRandom, &Scripts::cmdCutsceneEndDarkside, - &Scripts::cmdCutsceneEdWorld, &Scripts::cmdFlipWorld, &Scripts::cmdPlayCD + &Scripts::cmdCutsceneEndWorld, &Scripts::cmdFlipWorld, &Scripts::cmdPlayCD }; _event = &event; @@ -1085,7 +1085,7 @@ bool Scripts::cmdDisplayStat(Common::Array<byte> ¶ms) { return true; } -bool Scripts::cmdSeatTextSml(Common::Array<byte> ¶ms) { +bool Scripts::cmdSignTextSml(Common::Array<byte> ¶ms) { Interface &intf = *_vm->_interface; intf._screenText = Common::String::format("\x2\f08\x3""c\t116\v090%s\x3l\fd\x1", @@ -1122,7 +1122,7 @@ bool Scripts::cmdIfMapFlag(Common::Array<byte> ¶ms) { return true; } -bool Scripts::cmdSelRndChar(Common::Array<byte> ¶ms) { +bool Scripts::cmdSelectRandomChar(Common::Array<byte> ¶ms) { _charIndex = _vm->getRandomNumber(1, _vm->_party->_activeParty.size()); return true; } @@ -1306,7 +1306,7 @@ bool Scripts::cmdCutsceneEndDarkside(Common::Array<byte> ¶ms) { return false; } -bool Scripts::cmdCutsceneEdWorld(Common::Array<byte> ¶ms) { +bool Scripts::cmdCutsceneEndWorld(Common::Array<byte> ¶ms) { _vm->_saves->_wonWorld = true; _vm->_party->_worldEnd = true; diff --git a/engines/xeen/scripts.h b/engines/xeen/scripts.h index cd548f8516..e1c4fa8014 100644 --- a/engines/xeen/scripts.h +++ b/engines/xeen/scripts.h @@ -77,7 +77,7 @@ enum Opcode { OP_PlayEventVoc = 0x28, OP_DisplayBottom = 0x29, OP_IfMapFlag = 0x2A, - OP_SelRndChar = 0x2B, + OP_SelectRandomChar = 0x2B, OP_GiveEnchanted= 0x2C, OP_ItemType = 0x2D, OP_MakeNothingHere = 0x2E, @@ -282,26 +282,96 @@ private: * called the script */ bool cmdReturn(Common::Array<byte> ¶ms); + + /** + * Sets variables on characters like race, sex, and class + */ bool cmdSetVar(Common::Array<byte> ¶ms); + + /** + * Play the Clouds endgame + */ bool cmdCutsceneEndClouds(Common::Array<byte> ¶ms); + + /** + * Prompts the user for which character will do an action + */ bool cmdWhoWill(Common::Array<byte> ¶ms); + + /** + * Deals a random amount of damage to a character + */ bool cmdRndDamage(Common::Array<byte> ¶ms); + + /** + * Moves the wall object to the given coordinates. Doesn't change it's orientation. + * Wall objects are only visible when viewed straight on, and were never intended + * to be anywhere but on squares directly facing walls + */ bool cmdMoveWallObj(Common::Array<byte> ¶ms); + + /** + * Sets the cell flag at the specified X/Y coordinate on the current map + */ bool cmdAlterCellFlag(Common::Array<byte> ¶ms); + + /** + * Sets the word value at the current X/Y location in the HED file + * in memory to the given two bytes + */ bool cmdAlterHed(Common::Array<byte> ¶ms); + + /** + * Displays a text string which includes some stat of the currently selected character + */ bool cmdDisplayStat(Common::Array<byte> ¶ms); - bool cmdSeatTextSml(Common::Array<byte> ¶ms); + + /** + * Displays text in the scene window for various objects + * the user interacts with + */ + bool cmdSignTextSml(Common::Array<byte> ¶ms); + + /** + * An array of six VOC filenames are hard-coded into the game executable file. + * This function plays the VOC file at the specified index in this array + */ bool cmdPlayEventVoc(Common::Array<byte> ¶ms); + + /** + * Displays a large text message across the bottom of the screen + */ bool cmdDisplayBottom(Common::Array<byte> ¶ms); + + /** + * Checks if a given map flag/monster has been set, and if so + * jumps to a given line + */ bool cmdIfMapFlag(Common::Array<byte> ¶ms); - bool cmdSelRndChar(Common::Array<byte> ¶ms); + + /** + * Selects a random character for further other actions + */ + bool cmdSelectRandomChar(Common::Array<byte> ¶ms); + + /** + * Gives an enchanted item to a character + */ bool cmdGiveEnchanted(Common::Array<byte> ¶ms); + + /** + * Sets the item category for used in character operations + */ bool cmdItemType(Common::Array<byte> ¶ms); /** * Disable all the scripts at the party's current position */ bool cmdMakeNothingHere(Common::Array<byte> ¶ms); + + /** + * Does a copy protection check + */ bool cmdCheckProtection(Common::Array<byte> ¶ms); /** @@ -309,14 +379,30 @@ private: * those options, jumps to whichever line for the option the user selects */ bool cmdChooseNumeric(Common::Array<byte> ¶ms); + + /** + * Displays a two line message at the bottom of the screen + */ bool cmdDisplayBottomTwoLines(Common::Array<byte> ¶ms); + + /** + * Displays a message + */ bool cmdDisplayLarge(Common::Array<byte> ¶ms); /** * Exchange the positions of two objects in the maze */ bool cmdExchObj(Common::Array<byte> ¶ms); + + /** + * Handles making the player fall down to the ground + */ bool cmdFallToMap(Common::Array<byte> ¶ms); + + /** + * Displays a message + */ bool cmdDisplayMain(Common::Array<byte> ¶ms); /** @@ -330,9 +416,25 @@ private: * Pick a random value from the parameter list and jump to that line number */ bool cmdGotoRandom(Common::Array<byte> ¶ms); + + /** + * Plays the Dark Side of Xeen ending + */ bool cmdCutsceneEndDarkside(Common::Array<byte> ¶ms); - bool cmdCutsceneEdWorld(Common::Array<byte> ¶ms); + + /** + * Plays the World of Xeen ending + */ + bool cmdCutsceneEndWorld(Common::Array<byte> ¶ms); + + /** + * Switches the player between the Clouds and Dark Side + */ bool cmdFlipWorld(Common::Array<byte> ¶ms); + + /** + * Plays a CD track + */ bool cmdPlayCD(Common::Array<byte> ¶ms); int whoWill(int v1, int v2, int v3); @@ -350,8 +452,14 @@ private: */ bool ifProc(int action, uint32 mask, int mode, int charIndex); + /** + * Prompts the user for a copy protection check + */ bool copyProtectionCheck(); + /** + * Displays a message + */ void display(bool justifyFlag, int var46); public: int _animCounter; |