scp-fs2open/fs2open.github.com
1
0 Fork 0
mirror of https://github.com/scp-fs2open/fs2open.github.com.git synced 2026-11-10 04:31:34 -10:00
Code Issues Packages Projects Releases 1 Wiki Activity
Files
16db9601ac7e4fb2ab25eb928d216da9d76de125
fs2open.github.com/code/parse/sexp.cpp
T
Goober5000 7121dd75d5 clarify op_submenu comment (it had been moved from sexp_tree.cpp to sexp.cpp) 
reorder weapon, shield, and engine sexps for consistency
2009-06-03 04:11:42 +00:00

24808 lines
669 KiB
C++
Raw Blame History

/*
* Copyright (C) Volition, Inc. 1999. All rights reserved.
*
* All source code herein is the property of Volition, Inc. You may not sell
* or otherwise commercially exploit the source or things you created based on the
* source.
*
*/
/*
* $Logfile: /Freespace2/code/parse/SEXP.CPP $
* $Revision: 2.259.2.71 $
* $Date: 2008-01-19 01:23:18 $
* $Author: Goober5000 $
*
* main sexpression generator
*
* $Log: not supported by cvs2svn $
* Revision 2.259.2.70 2008/01/19 00:27:08 Goober5000
* we all got led down the garden path there! revert all radar range modifications
*
* Revision 2.259.2.69 2008/01/16 10:12:00 Backslash
* Fixed set-object-speed sexps. Thanks for the inspiration, Keldor!
*
* Revision 2.259.2.68 2008/01/12 08:44:32 karajorma
* Add SEXPs for determining the players score and how many respawns they've used. Add num-assists to this branch too.
*
* Revision 2.259.2.67 2008/01/08 17:24:23 Kazan
* Apply KeldorKatarn's no autopilot mission flag patch (And a sexp to toggle it as it is a flag that can be dynamically toggled safely) "use-autopilot" is the SEXP [Applied KK's patch by hand]
* Had to move things around and resize the mission specs editor - lots of MSVC2005 autogenerated garbage changes in this diff.
*
* Revision 2.259.2.66 2007/12/20 01:57:42 turey
* Bunch of stuff already in HEAD. Shouldn't break anything.
*
* Revision 2.259.2.65 2007/11/22 05:36:06 taylor
* bump node allocation increment (when you are regularly realloc'ing 20-30 times, the increment is too low :))
*
* Revision 2.259.2.64 2007/10/29 11:32:21 karajorma
* This is better than the other way.
*
* Revision 2.259.2.63 2007/10/28 18:10:45 karajorma
* Add the hits-left-singe-subsystem SEXP
*
* Revision 2.259.2.62 2007/10/28 16:44:33 taylor
* cleanup and bug fixes for ship-guardian-threshold and ship-subsys-guardian-threshold (Mantis #1473)
*
* Revision 2.259.2.61 2007/10/04 16:26:17 taylor
* fix bugs in beam-*-all and turret-*-all that made them always trigger an Int3()
*
* Revision 2.259.2.60 2007/09/29 21:51:30 karajorma
* Fix x-builtin-messages so that the Any Wingman option works
*
* Revision 2.259.2.59 2007/09/29 15:21:33 karajorma
* Upgrade the beam-x-all and turret-x-all SEXPs to accept more than one ship.
*
* Revision 2.259.2.58 2007/09/04 00:08:51 Goober5000
* fix the factoring on the shudder parameters (Mantis #1419)
*
* Revision 2.259.2.57 2007/09/02 18:52:52 Goober5000
* fix for #1455 plus a bit of cleanup
*
* Revision 2.259.2.56 2007/08/26 16:00:11 phreak
* destroyed-or-departed-delay needs to check for ships that have self destructed
*
* Revision 2.259.2.55 2007/08/17 03:29:50 Goober5000
* generalize the way radar ranges are handled (inspired by Shade's fix)
*
* Revision 2.259.2.54 2007/08/04 22:29:59 Goober5000
* fix case-sensitive #include (Linux)
*
* Revision 2.259.2.53 2007/07/25 00:32:39 Kazan
* small tweak
*
* Revision 2.259.2.52 2007/07/24 20:08:30 Kazan
* Make asteroid/debris fields interrupt autopilot, add "hazards near" message to autopilot.tbl, add use-nav-cinematics sexp, fix mantis #1441
*
* Revision 2.259.2.51 2007/07/24 13:03:15 Kazan
* Resolve Mantis 1281
*
* Revision 2.259.2.50 2007/07/23 16:08:29 Kazan
* Autopilot updates, minor misc fixes, working MSVC2005 project files
*
* Revision 2.259.2.49 2007/05/14 23:13:41 Goober5000
* --grouped the shake/shudder code together a bit better
* --added a sexp to generate shudder
* --fixed a minor bug in lock-perspective
*
* Revision 2.259.2.48 2007/04/26 18:58:49 karajorma
* Doh! Missed the return type.
*
* Revision 2.259.2.47 2007/04/24 12:07:34 karajorma
* Fix a number of places where the player of a dogfight game could end up in the standard debrief.
*
* Revision 2.259.2.46 2007/04/05 16:43:44 karajorma
* A few minor fixes
*
* Revision 2.259.2.45 2007/03/22 20:35:44 taylor
* be sure to page in textures for change ship class sexp preload
* add a ASF_MENUMUSIC type for things that aren't mission-based event music (since that is handled differently now)
* make event music keep extension if it exists, so that the special data will be accurate
* bits of cleanup from old MS code that we don't need
*
* Revision 2.259.2.44 2007/02/20 04:19:34 Goober5000
* the great big duplicate model removal commit
*
* Revision 2.259.2.42 2007/02/13 01:45:56 Goober5000
* fix a hideous bug with the knossos special warp stuff
* (how did this ever actually work correctly?)
*
* Revision 2.259.2.41 2007/02/12 00:23:39 taylor
* get rid of non-standard itoa(), make use of the proper sprintf() instead
*
* Revision 2.259.2.40 2007/02/10 00:14:40 taylor
* remove NO_SOUND
* fix glow bank sexp bug (Mantis #1250)
*
* Revision 2.259.2.39 2007/02/08 07:39:35 Goober5000
* fix two bugs:
* --default ship flags in the iff_defs table were not correctly translated from parse flags to ship/object flags
* --ships were created with default allowed comm orders regardless of which team they were on
*
* Revision 2.259.2.38 2007/01/27 18:39:09 karajorma
* Fix add-remove-escort to actually use a priority.
*
* Revision 2.259.2.37 2007/01/15 11:57:02 karajorma
* Add the reset-orders SEXP
* Some general houskeeping to keep 3.6.9 and HEAD throwing up lots of annoying diffs that are just spacing issues.
*
* Revision 2.259.2.36 2006/12/28 02:07:43 Goober5000
* assume ships-with-bays which haven't yet entered the mission are valid for syntax checking
*
* Revision 2.259.2.35 2006/12/26 18:14:37 Goober5000
* allow parsing of similar ship copy names properly (Mantis #1178)
*
* Revision 2.259.2.34 2006/11/26 03:22:38 Goober5000
* prevent false positive while error checking
*
* Revision 2.259.2.33 2006/11/25 06:33:22 Goober5000
* this may have been an oversight
*
* Revision 2.259.2.32 2006/11/21 23:07:26 karajorma
* Fix ammo and weapon SEXP changes not being passed on to the clients
*
* Revision 2.259.2.31 2006/11/15 00:33:15 taylor
* add some needed wing leader checks to prevent Assert()'s and out-of-bounds problems when the leader is dead/dying (Mantis bug #1134)
*
* Revision 2.259.2.30 2006/11/05 18:42:25 Goober5000
* fix is-event-x-delay optional argument type
*
* Revision 2.259.2.29 2006/10/28 21:17:04 karajorma
* Adding the network-variable option to SEXP variables. This change will revert variables to the same behaviour they displayed in retail (i.e they don't update for clients) unless a variable is set to be a network-variable.
*
* Revision 2.259.2.28 2006/10/25 01:01:55 Goober5000
* moved some stuff around in the sexp menus
*
* Revision 2.259.2.27 2006/10/24 23:28:56 Goober5000
* make sure to only add the sexp callback once
*
* Revision 2.259.2.26 2006/10/24 13:17:24 taylor
* various bits of cleanup (warning messages, things that Valgrind complained about, etc.)
* fix an out-of-bounds issue on Sexp_nodes[] which was leading to stack corruption
*
* Revision 2.259.2.25 2006/10/21 21:57:07 karajorma
* Fix Int3() with Set primary and Secondary ammo\weapons
*
* Revision 2.259.2.24 2006/10/11 03:10:53 wmcoolmon
* Fix Freecamera forcing HUD draw bug.
*
* Revision 2.259.2.23 2006/10/09 05:25:08 Goober5000
* make sexp nodes dynamic
*
* Revision 2.259.2.22 2006/09/11 01:09:33 taylor
* fix bug where set-object-speed-* could set speed subjectively if left to default
*
* Revision 2.259.2.21 2006/09/08 06:10:34 taylor
* fix for Mantis bug #617 (with a very big assist from Shade who did most of the initial work on this)
*
* Revision 2.259.2.20 2006/08/19 04:38:47 taylor
* maybe optimize the (PI/2), (PI*2) and (RAND_MAX/2) stuff a little bit
*
* Revision 2.259.2.19 2006/08/16 16:43:07 karajorma
* Doh! Minor fix
*
* Revision 2.259.2.18 2006/08/15 19:24:09 karajorma
* Fixed a silly typo which breaks team-score
*
* Revision 2.259.2.17 2006/08/06 19:27:12 Goober5000
* deprecate change-ship-model
*
* Revision 2.259.2.16 2006/08/06 19:06:42 Goober5000
* make these consistent (pitch-bank-heading is the established order)
* --Goober5000
*
* Revision 2.259.2.15 2006/08/06 18:47:12 Goober5000
* add the multiple background feature
* --Goober5000
*
* Revision 2.259.2.14 2006/08/03 16:24:23 karajorma
* Added new packed to deal with a bug in multiplayer where using end-mission would only end the mission for the server and then force the clients to jump out.
*
* Revision 2.259.2.13 2006/07/26 15:01:07 Kazan
* small optimization
*
* Revision 2.259.2.12 2006/07/21 05:38:41 Goober5000
* fix help text
* --Goober5000
*
* Revision 2.259.2.11 2006/07/17 01:09:45 taylor
* make glow point banks dynamic
*
* Revision 2.259.2.10 2006/07/17 00:49:54 Goober5000
* move WMC's preload stuff into main preloader routine
*
* Revision 2.259.2.9 2006/07/06 21:53:59 taylor
* rest of the map/glow changes
* - put glowmap activity back on a per-ship basis (via a SF2_* flag) rather than per-model
* - same for glowpoints, back on a per-ship basis
* - put specmaps and bumpmap back on a LOD0 and LOD1 affect (got changed to LOD0 only recently)
* - fix glowmaps for shockwaves again
* - add support for animated specmaps (mainly for TBP and Starfox mods)
* some minor code cleanup and compiler warning fixes
*
* Revision 2.259.2.8 2006/07/06 05:35:04 Goober5000
* fix for Mantis #856
* --Goober5000
*
* Revision 2.259.2.7 2006/07/04 07:42:10 Goober5000
* --in preparation for fixing an annoying animated texture bug, reorganize the various texture structs and glow point structs and clarify several parts of the texture code :P
* --this breaks animated glow maps, and animated regular maps still aren't fixed, but these will be remedied shortly
* --Goober5000
*
* Revision 2.259.2.6 2006/06/27 03:55:22 Goober5000
* fix comment in preparation for code commit
* --Goober5000
*
* Revision 2.259.2.5 2006/06/24 01:53:53 Goober5000
* make ai-chase-any-except revert to ai-chase-any
* (since it never really worked properly in the first place)
* --Goober5000
*
* Revision 2.259.2.4 2006/06/15 01:36:01 Goober5000
* this is kinda superfluous
*
* Revision 2.259.2.3 2006/06/07 20:50:56 karajorma
* Allow Change-Ship-Class to affect ships which haven't arrived yet (For BHX)
*
* Revision 2.259.2.2 2006/06/04 00:01:44 Goober5000
* add capability for preloading special arguments
* NB: it's disabled for now, and it needs to be moved after sexps are parsed to work
* --Goober5000
*
* Revision 2.259.2.1 2006/06/03 04:46:39 Goober5000
* add karajorma's multi callback
* --Goober5000
*
* Revision 2.259 2006/05/20 02:03:01 Goober5000
* fix for Mantis #755, plus make the missionlog #defines uniform
* --Goober5000
*
* Revision 2.258 2006/04/20 06:32:23 Goober5000
* proper capitalization according to Volition
*
* Revision 2.257 2006/04/07 20:16:30 karajorma
* Added SEXPs to lock and unlock the primary and secondary weapons
*
* Revision 2.256 2006/04/06 20:44:14 karajorma
* Damn spelling mistakes. And in the only place where it would be visible too!
*
* Revision 2.255 2006/04/06 18:53:28 Goober5000
* small fix
*
* Revision 2.254 2006/04/05 16:56:57 karajorma
* Changes to support the new Enable/Disable-Builtin-Messages SEXP
*
* Revision 2.253 2006/04/04 11:38:07 wmcoolmon
* Maneuvering thruster scaling, gun convergence
*
* Revision 2.252 2006/04/03 09:05:37 wmcoolmon
* show-subtitle's got its groove back
*
* Revision 2.251 2006/04/03 07:48:03 wmcoolmon
* Miscellaneous minor changes, mostly related to addition of Current_camera variable
*
* Revision 2.250 2006/03/28 11:41:57 karajorma
* Added the set-primary-weapon and the set-secondary-weapon SEXPs. Updated the corresponding
* set-x-ammo SEXPs to also accept a rearm limit.
*
* Revision 2.249 2006/03/26 06:42:01 Goober5000
* this should fix random-of
* --Goober5000
*
* Revision 2.248 2006/03/24 18:40:13 Goober5000
* hopefully fix this :(
*
* Revision 2.247 2006/03/24 05:08:19 Goober5000
* tweak karajorma's fixes... these should work exactly the same but are closer to my original intent
*
* Revision 2.246 2006/03/22 16:24:20 karajorma
* Fixed Random-Of so that it finally works properly. and doesn't ignore the last items on the list.
* Fixed Rand-Multiple so that when seeded it works the way I originally designed it to. Previously it was
* working exactly the same as rand when seeded.
*
* Revision 2.245 2006/03/22 01:36:21 karajorma
* Bah. More errors fixed. This time in in-sequence
*
* Revision 2.244 2006/03/21 17:19:01 karajorma
* Added the In-Sequence conditional.
*
* Revision 2.243 2006/03/18 22:43:16 Goober5000
* added set-death-message sexp
* --Goober5000
*
* Revision 2.242 2006/03/18 10:26:42 taylor
* make sure errors in rand_sexp() and rand_internal() are properly handled
*
* Revision 2.241 2006/03/18 07:12:07 Goober5000
* add ship-subsys-targetable and ship-subsys-untargetable
* --Goober5000
*
* Revision 2.240 2006/03/04 11:05:47 karajorma
* Bah. Error in secondary and primary ammo SEXPs fixed
*
* Revision 2.239 2006/03/03 06:14:41 Goober5000
* fix the random-of sexps to only choose valid arguments
*
* Revision 2.238 2006/03/02 04:05:27 Goober5000
* took care of (hopefully) the rest of Karajorma's SEXP node handle conflicts, plus merged the random sexps with their multiple variants
*
* Revision 2.237 2006/03/01 23:22:25 karajorma
* Fixed a bunch of bugs with Set-x-ammo and Rand SEXPs.
*
* Revision 2.236 2006/03/01 20:54:35 karajorma
* Added the random-multiple-of SEXP and fixed random-of to work as designed
*
* Revision 2.235 2006/03/01 14:53:15 karajorma
* Changed text FRED displays for Fade-In and Fade-Out SEXPs
*
* Revision 2.234 2006/03/01 03:14:22 Goober5000
* oswpt wing fix
*
* Revision 2.233 2006/02/28 07:52:04 wmcoolmon
* Silly mistake
*
* Revision 2.232 2006/02/26 23:23:30 wmcoolmon
* Targetable as bomb SEXPs and dialog stuff; made invulnerable an object flag in both FRED and FS2.
*
* Revision 2.231 2006/02/26 22:47:11 Goober5000
* wow, over a year later and I'm still finding docking bugs :p
*
* Revision 2.230 2006/02/26 01:32:23 Goober5000
* bah
*
* Revision 2.229 2006/02/26 00:43:09 Goober5000
* fix subsystems for get-object-*
*
* Revision 2.228 2006/02/26 00:22:15 Goober5000
* some paring down of sexps
*
* Revision 2.227 2006/02/25 20:18:14 Goober5000
* added function for retrieving a ship, wing, waypoint, or team from a sexp argument
* --Goober5000
*
* Revision 2.226 2006/02/25 17:34:23 karajorma
* Added Seeding functions to Rand and Rand-Multiple SEXPs
*
* Revision 2.225 2006/02/24 07:30:23 taylor
* compiler warning fixage
*
* Revision 2.224 2006/02/23 01:37:51 karajorma
* Added the String-to-int SEXP.
*
* Revision 2.223 2006/02/22 18:32:18 taylor
* fix subsystem distance check from single ship to subsystem (this has been broken since day 1, over 3 years ago, so there could be other Mantis bugs relating to this)
*
* Revision 2.222 2006/02/22 00:04:04 karajorma
* Changed the set-secondary-ammo and set-primary-ammo SEXPs to use the banks
* capacity rather than starting ammo.
*
* Revision 2.221 2006/02/21 22:20:04 karajorma
* Fixed the problems with set-primary-ammo and set-secondary-ammo SEXPs
*
* Revision 2.220 2006/02/21 21:40:25 karajorma
* Added the get and set-primary-ammo SEXPs. The set-primary-ammo
* and set-secondary-ammo SEXPs appear to be broken at the moment though
*
* Revision 2.219 2006/02/21 09:08:10 Goober5000
* more true/false tweaks and redid the get-object-* and set-object-speed-* sexps to be more flexible and extensible
*
* this will break compatibility with certain uses of these sexps in existing missions; I don't think there are any released campaigns
* with the old versions so hopefully mission designers can simply update unreleased missions... however if it gets to be a problem
* I will code in some reverse compatibility
*
* --Goober5000
*
* Revision 2.218 2006/02/21 07:58:01 Goober5000
* add a bunch of tweaks to hopefully lessen the possibility of misinterpreting special return values (such as nan) as true or false
* --Goober5000
*
* Revision 2.217 2006/02/20 20:53:11 karajorma
* Added the num-ships-in-wing, get-secondary-ammo and set-secondary-ammo SEXPs
*
* Revision 2.216 2006/02/20 07:30:14 taylor
* updated to newest dynamic starfield code
* - this mainly is to just better support SEXP based starfield bitmap changes (preloading, better in-mission stuff loading)
* - also fixes index_buffer related double-free()
* - done waste memory for env index buffer if env is not enabled
* - address a couple of bm load/release issues and comment a little to tell why
*
* Revision 2.215 2006/02/20 02:13:08 Goober5000
* added ai-ignore-new which hopefully should fix the ignore bug
* --Goober5000
*
* Revision 2.214 2006/02/19 22:00:10 Goober5000
* restore original ignore behavior and remove soon-to-be-obsolete ai-chase-any-except
* --Goober5000
*
* Revision 2.213 2006/02/19 02:04:40 wmcoolmon
* Oops
*
* Revision 2.212 2006/02/19 00:32:47 Goober5000
* additional error checking
* --Goober5000
*
* Revision 2.211 2006/02/16 05:40:58 taylor
* please stop modifying the passed node value in sexp functions, it makes it very difficult to debug problems
*
* Revision 2.210 2006/01/30 06:30:03 taylor
* dynamic starfield bitmaps
*
* Revision 2.209 2006/01/29 07:41:57 wmcoolmon
* Minor warning update
*
* Revision 2.208 2006/01/27 06:21:10 Goober5000
* replace quick sort with insertion sort in many places
* --Goober5000
*
* Revision 2.207 2006/01/22 01:35:23 taylor
* oops, didn't notice that was out of the wrong diff
*
* Revision 2.206 2006/01/22 01:33:39 taylor
* warning fixage
* don't Int3() when trying to set ship speed via sexp if ship is not in mission yet, this shouldn't be fatal
*
* Revision 2.205 2006/01/21 09:36:58 wmcoolmon
* Texture replacement stuff
*
* Revision 2.204 2006/01/20 04:33:21 Goober5000
* fixed a sexp help message
* --Goober5000
*
* Revision 2.203 2006/01/19 03:17:12 phreak
* give repair-subsystem and set-subsystem-strength a fourth optional parameter used to possibly regenerate the submodel of a given subsystem
* sabotage-subsystem should make the subsystems explode
*
* Revision 2.202 2006/01/13 03:31:20 Goober5000
* �bercommit of custom IFF stuff :)
*
* Revision 2.201 2006/01/13 02:56:01 Goober5000
* formatting, meh
* --Goober5000
*
* Revision 2.200 2006/01/10 00:12:08 phreak
* Add the argument for alpha color when using set-jumpnode-color. This was defaulting to some junk value and making the jumpnode disappear.
*
* Revision 2.199 2006/01/09 04:52:34 phreak
* fix compile warnings.
*
* Revision 2.198 2006/01/06 04:18:55 wmcoolmon
* turret-target-order SEXPs, ship thrusters
*
* Revision 2.197 2006/01/02 21:28:52 taylor
* can't overwrite node var here, it's original value is needed later and was throwing out NULL chars in the Warning()s
*
* Revision 2.196 2006/01/02 07:12:24 taylor
* those blasted Windows programmers! ;)
*
* Revision 2.195 2005/12/31 01:49:53 wmcoolmon
* Changed num-within-box wing function
*
* Revision 2.194 2005/12/31 01:47:35 wmcoolmon
* num-within-box
*
* Revision 2.193 2005/12/29 08:08:39 wmcoolmon
* Codebase commit, most notably including objecttypes.tbl
*
* Revision 2.192 2005/12/06 03:01:25 taylor
* add a nomusic check to not get an error when eval on the change soundtrack sexp
*
* Revision 2.191 2005/11/23 06:55:47 taylor
* make sure all weapons that will get used later in a mission get preloaded
*
* Revision 2.190 2005/11/08 01:04:00 wmcoolmon
* More warnings instead of Int3s/Asserts, better Lua scripting, weapons_expl.tbl is no longer needed nor read, added "$Disarmed ImpactSnd:", fire-beam fix
*
* Revision 2.189 2005/11/05 11:00:50 wmcoolmon
* Fixed capitalization
*
* Revision 2.188 2005/11/05 07:42:09 phreak
* add/remove-sun-bitmap. Also changed "Ship_arrival_list" to "Ship_arrival_list" since the former technically doesn't exist due to the capital 'S'.
*
* Revision 2.187 2005/11/05 05:06:13 wmcoolmon
* turret-change-weapon
*
* Revision 2.186 2005/10/30 20:03:39 taylor
* add a bunch of Assert()'s and NULL checks to either help debug or avoid errors
* fix Mantis bug #381
* fix a small issue with the starfield bitmap removal sexp since it would read one past the array size
*
* Revision 2.185 2005/10/29 22:09:30 Goober5000
* multiple ship docking implemented for initially docked ships
* --Goober5000
*
* Revision 2.184 2005/10/28 14:49:35 taylor
* some minor cleanup and compiler warning fixes
*
* Revision 2.183 2005/10/28 05:48:55 phreak
* Added extra documentation for add-background-bitmap and add-sun-bitmap
*
* Revision 2.182 2005/10/28 05:25:27 phreak
* added implementation for add-background-bitmap and remove-background-bitmap
*
* Revision 2.181 2005/10/24 23:28:37 phreak
* implementation for nebula-change-storm and nebula-toggle-poof. looks like they're working
*
* Revision 2.180 2005/10/24 02:53:48 phreak
* Get the new nebula argument types working in fred.
*
* Revision 2.179 2005/10/23 04:48:26 phreak
* add-background-bitmap and add-sun-bitmap needed scale values added
* also their sexp functions should not return integers.
*
* Revision 2.178 2005/10/23 04:18:23 phreak
* various background and nebula sexps
*
* add-background-bitmap
* add-sun-bitmap
* remove-background-bitmap
* remove-sun-bitmap
* nebula-change-storm
* nebula-toggle-poofs
*
* All of these sexps are just stubs for now.
* Just want to get in the commit before someone
* else commits and i'll make a mess trying to merge.
* Everything is compiling fine, so it shouldn't mess up anything. But you know that murphy guy....
*
* I've put these sexps in a new fred subcategory called "Backgrounds and Nebula"
* along with the sexps "change-skybox-model" and "mission-set-nebula"
*
* Revision 2.177 2005/10/22 20:17:19 wmcoolmon
* mission-set-nebula fixage; remainder of python code
*
* Revision 2.176 2005/10/16 10:12:14 taylor
* clean up a couple of things
*
* Revision 2.175 2005/10/16 00:32:30 Goober5000
* ship-create now generates a default name if you specify "<none>" for the ship name
* --Goober5000
*
* Revision 2.174 2005/10/14 09:29:56 Goober5000
* add weapon-create sexp
* --Goober5000
*
* Revision 2.173 2005/10/14 07:06:58 Goober5000
* stuff for WMC: fix sexp description and three warnings; plus add some
* bulletproofing to name-specified ship_create
* --Goober5000
*
* Revision 2.172 2005/10/13 23:23:32 wmcoolmon
* Make ship_create not return a value
*
* Revision 2.171 2005/10/10 17:21:08 taylor
* remove NO_NETWORK
*
* Revision 2.170 2005/10/09 08:10:03 wmcoolmon
* Minor update to ship-create description
*
* Revision 2.169 2005/10/09 08:03:21 wmcoolmon
* New SEXP stuff
*
* Revision 2.168 2005/10/09 06:10:59 wmcoolmon
* Added sexps set-object-speed-x, set-object-speed-y, set-object-speed-z,
* and ship-create
*
* Revision 2.167 2005/09/24 01:50:09 Goober5000
* a bunch of support ship bulletproofing
* --Goober5000
*
* Revision 2.166 2005/09/17 01:41:49 Goober5000
* better tweak
*
* Revision 2.164 2005/07/25 03:13:25 Goober5000
* various code cleanups, tweaks, and fixes; most notably the MISSION_FLAG_USE_NEW_AI
* should now be added to all places where it is needed (except the turret code, which I still
* have to to review)
* --Goober5000
*
* Revision 2.163 2005/07/24 00:32:44 wmcoolmon
* Synced 3D shockwaves' glowmaps with the model, tossed in some medals.tbl
* support for the demo/FS1
*
* Revision 2.162 2005/07/23 22:52:44 wmcoolmon
* Fixed formatting FTW
*
* Revision 2.160 2005/07/22 10:18:41 Goober5000
* CVS header tweaks
* --Goober5000
*
* Revision 2.159 2005/07/13 03:35:31 Goober5000
* remove PreProcDefine #includes in FS2
* --Goober5000
*
* Revision 2.158 2005/07/13 02:30:54 Goober5000
* removed autopilot #define
* --Goober5000
*
* Revision 2.157 2005/07/02 19:36:04 taylor
* some supernova fixing
*
* Revision 2.156 2005/06/29 18:54:59 taylor
* set-skybox-model only takes one argument so don't advertise more
* add set-skybox-model help text for FRED2
*
* Revision 2.155 2005/06/16 05:17:32 Goober5000
* fixed a CVS log spelling error, plus fixed a tricky sexp allocation bug
* --Goober5000
*
* Revision 2.154 2005/05/12 03:50:09 Goober5000
* repeating messages with variables should work properly now
* --Goober5000
*
* Revision 2.153 2005/05/11 09:28:32 Goober5000
* fixed a few of karajorma's bugs
* --Goober5000
*
* Revision 2.152 2005/05/11 08:10:20 Goober5000
* variables should now work properly in messages that are sent multiple times
* --Goober5000
*
* Revision 2.151 2005/05/01 06:18:58 wmcoolmon
* Added (up-to-date) SEXP description info.
*
* Revision 2.150 2005/04/24 02:10:53 Goober5000
* subsystem fix
* --Goober5000
*
* Revision 2.149 2005/04/21 15:59:41 taylor
* sexp to swap the skybox in mission, not tested in FRED, hopefully I didn't mess this up too much
*
* Revision 2.148 2005/04/18 08:35:28 Goober5000
* model and class changes should be all set now
* --Goober5000
*
* Revision 2.147 2005/04/18 05:27:26 Goober5000
* removed ship->alt_modelnum as it was essentially duplicates of ship->modelnum; changed the alt modelnum stuff accordingly
* fixes for ship_model_change and change_ship_type
* --Goober5000
*
* Revision 2.146 2005/04/18 03:16:57 Goober5000
* more sexp goodness
* --Goober5000
*
* Revision 2.145 2005/04/11 05:48:33 taylor
* make sure use an insensitive case check for Messages[] names (Jens Granseuer)
* little clarification of if-else block in message_training_que()
*
* Revision 2.144 2005/04/05 05:53:22 taylor
* s/vector/vec3d/g, better support for different compilers (Jens Granseuer)
*
* Revision 2.143 2005/03/27 13:00:40 Goober5000
* two new sexps
* --Goober5000
*
* Revision 2.142 2005/03/27 12:28:34 Goober5000
* clarified max hull/shield strength names and added ship guardian thresholds
* --Goober5000
*
* Revision 2.141 2005/03/25 06:57:37 wmcoolmon
* Big, massive, codebase commit. I have not removed the old ai files as the ones I uploaded aren't up-to-date (But should work with the rest of the codebase)
*
* Revision 2.140 2005/03/15 07:26:52 Goober5000
* *fixed some sexp declaration formatting
* *implemented string comparison sexps
* *simplified numeric comparison sexps
* *fixed numeric comparison (especially equals) sexps to actually work on all their arguments like they were designed to
* --Goober5000
*
* Revision 2.139 2005/03/14 23:34:59 Goober5000
* properly fixed the out-of-bounds error, as well as a few other errors of the same kind
* --Goober5000
*
* Revision 2.138 2005/03/14 23:33:22 Goober5000
* rolled back Phreak's commit
* --Goober5000
*
* Revision 2.136 2005/03/03 06:05:31 wmcoolmon
* Merge of WMC's codebase. "Features and bugs, making Goober say "Grr!", as release would be stalled now for two months for sure"
*
* Revision 2.135 2005/03/02 21:24:42 taylor
* more network/inferno goodness for Windows, takes care of a few warnings too
*
* Revision 2.134 2005/02/04 23:29:32 taylor
* merge with Linux/OSX tree - p0204-3
*
* Revision 2.133 2005/01/26 06:58:37 Goober5000
* hm... added a necessary bugfix for something very badly designed
* --Goober5000
*
* Revision 2.132 2005/01/26 06:49:50 Goober5000
* whoops... need to free variable blocks for special hitpoints
* --Goober5000
*
* Revision 2.131 2005/01/26 01:52:21 Goober5000
* Bah - I am a moron. :) I see the reason why rand shouldn't work
* multiple times. It's been fixed thus.
*
* I also added a rand-multiple sexp for any times when people do
* want multiple random numbers.
*
* --Goober5000
*
* Revision 2.130 2005/01/18 06:15:33 Goober5000
* fixed a crazy error
* --Goober5000
*
* Revision 2.129 2005/01/18 01:20:03 Goober5000
* variables can be specified in training messages too now
* --Goober5000
*
* Revision 2.128 2005/01/18 00:14:37 Goober5000
* clarified a bunch of sexp stuff and fixed a bug
* --Goober5000
*
* Revision 2.127 2005/01/17 22:46:32 Goober5000
* variables can now be displayed in messages
* --Goober5000
*
* Revision 2.126 2005/01/11 21:38:51 Goober5000
* multiple ship docking :)
* don't tell anyone yet... check the SCP internal
* --Goober500
*
* Revision 2.125 2005/01/01 07:18:48 wmcoolmon
* NEW_HUD stuff, turned off this time. :) It's in a state of disrepair at the moment, doesn't show anything.
*
* Revision 2.124 2004/12/23 15:57:42 phreak
* commits for scramble-messages and unscramble-messages
* -phreak
*
* Revision 2.123 2004/11/17 22:23:13 Goober5000
* added two new sexps
* --Goober5000
*
* Revision 2.122 2004/10/31 02:04:34 Goober5000
* added Knossos_warp_ani_used flag for taylor
* --Goober5000
*
* Revision 2.121 2004/10/18 09:27:47 Goober5000
* fixed FRED bug that changed special arguments to (null)
* --Goober5000
*
* Revision 2.120 2004/10/15 10:03:08 Goober5000
* added change-alt-name
* --Goober5000
*
* Revision 2.119 2004/10/15 09:21:55 Goober5000
* cleaned up some sexp stuff and added wing capability to kamikaze sexp
* --Goober5000
*
* Revision 2.118 2004/10/15 08:14:07 Goober5000
* extra coding insurance
* --Goober5000
*
* Revision 2.117 2004/10/14 23:03:37 Goober5000
* tweakage
* --Goober5000
*
* Revision 2.116 2004/10/14 22:28:27 Goober5000
* added ability for variable names to be used as special arguments
* --Goober5000
*
* Revision 2.115 2004/10/14 01:19:17 Goober5000
* more ubersexp bugfixing
* --Goober5000
*
* Revision 2.114 2004/10/13 10:46:49 Goober5000
* fixed a few when-argument bugs
* --Goober5000
*
* Revision 2.113 2004/09/24 02:12:59 Goober5000
* some ubersexp fixes
* --Goober5000
*
* Revision 2.112 2004/09/23 23:52:58 Goober5000
* fixed two bugs... still more bugs to be found :p
* --Goober5000
*
* Revision 2.111 2004/09/23 22:51:07 Goober5000
* ubersexp implementation complete
* --Goober5000
*
* Revision 2.110 2004/09/23 05:53:00 Goober5000
* a bunch of work on the actual implementation of when-argument
* --Goober5000
*
* Revision 2.109 2004/09/22 21:52:22 Goober5000
* further work on ubersexp framework
* --Goober5000
*
* Revision 2.108 2004/09/22 08:32:05 Goober5000
* fixed some small problems in the framework - should be working nicely now;
* next step is the actual sexp implementation :-P
* --Goober5000
*
* Revision 2.107 2004/09/22 06:56:44 Goober5000
* checking in framework for when-argument special ubersexp
* --Goober5000
*
* Revision 2.106 2004/09/17 08:07:52 Goober5000
* a bit of reordering
* --Goober5000
*
* Revision 2.105 2004/09/17 07:12:23 Goober5000
* changed around the logic for the 3D warp effect
* --Goober5000
*
* Revision 2.104 2004/09/17 00:28:31 Goober5000
* removed player-not-use-ai and changed player-use-ai to take an argument
* --Goober5000
*
* Revision 2.103 2004/09/17 00:18:18 Goober5000
* changed toggle-hud to hud-disable; added hud-disable-except-messages
* --Goober5000
*
* Revision 2.102 2004/09/02 04:02:44 Goober5000
* fixed a warning
* --Goober5000
*
* Revision 2.101 2004/08/23 04:32:05 Goober5000
* ship-tag and ship-untag sexps
* --Goober5000
*
* Revision 2.100 2004/08/23 04:00:15 Goober5000
* ship-tag and ship-untag
* --Goober5000
*
* Revision 2.99 2004/07/29 23:41:21 Kazan
* bugfixes
*
* Revision 2.98 2004/07/27 18:52:10 Kazan
* squished another
*
* Revision 2.97 2004/07/26 21:26:45 Goober5000
* outline of ship-tag and ship-untag sexps
* --Goober5000
*
* Revision 2.96 2004/07/26 20:47:47 Kazan
* remove MCD complete
*
* Revision 2.95 2004/07/26 17:54:05 Kazan
* Autopilot system completed -- i am dropping plans for GUI nav map
* Fixed FPS counter during time compression
*
* Revision 2.94 2004/07/12 16:33:01 Kazan
* MCD - define _MCD_CHECK to use memory tracking
*
* Revision 2.93 2004/07/03 08:23:00 wmcoolmon
* Replaced some more Int3s with Warnings and Errors.
*
* Revision 2.92 2004/07/03 07:55:22 wmcoolmon
* Error handling for fire_beam instead of just calling Int3()
*
* Revision 2.91 2004/06/15 20:49:22 wmcoolmon
* Added hud-set-color and get-current-speed
*
* Revision 2.90 2004/06/09 00:18:50 wmcoolmon
* hud-set-color SEXP
*
* Revision 2.89 2004/06/01 07:31:56 wmcoolmon
* Lotsa stuff. Custom gauges w/ ANIs support added, SEXPs to set gauge text, gauge image frames, and gauge coords. These SEXPs and toggle-hud reside in the Hud/change category.
*
* Revision 2.88 2004/05/10 10:51:52 Goober5000
* made primary and secondary banks quite a bit more friendly... added error-checking
* and reorganized a bunch of code
* --Goober5000
*
* Revision 2.87 2004/05/03 21:22:22 Kazan
* Abandon strdup() usage for mod list processing - it was acting odd and causing crashing on free()
* Fix condition where alt_tab_pause() would flipout and trigger failed assert if game minimizes during startup (like it does a lot during debug)
* Nav Point / Auto Pilot code (All disabled via #ifdefs)
*
* Revision 2.86 2004/03/17 04:07:31 bobboau
* new fighter beam code
* fixed old after burner trails
* had to bump a few limits, working on some dynamic solutions
* a few fixed to background POF rendering
* fixing asorted bugs
*
* Revision 2.85 2004/03/05 09:02:08 Goober5000
* Uber pass at reducing #includes
* --Goober5000
*
* Revision 2.84 2004/02/14 04:26:58 Goober5000
* hmph... fixed some bugs
* --Goober5000
*
* Revision 2.83 2004/02/07 00:48:52 Goober5000
* made FS2 able to account for subsystem mismatches between ships.tbl and the
* model file - e.g. communication vs. communications
* --Goober5000
*
* Revision 2.82 2004/02/04 08:41:02 Goober5000
* made code more uniform and simplified some things,
* specifically shield percentage and quadrant stuff
* --Goober5000
*
* Revision 2.81 2004/01/30 07:39:09 Goober5000
* whew - I just went through all the code I ever added (or at least, that I could
* find that I commented with a Goober5000 tag) and added a bunch of Asserts
* and error-checking
* --Goober5000
*
* Revision 2.80 2003/11/24 18:18:00 Goober5000
* fixed bug in tech-reset-to-default
* --Goober5000
*
* Revision 2.79 2003/11/09 04:09:18 Goober5000
* edited for language
* --Goober5000
*
* Revision 2.78 2003/11/08 04:31:02 Goober5000
* fixed a bug in my sexp code
* --Goober5000
*
* Revision 2.77 2003/10/28 23:59:02 Goober5000
* tweakage
* --Goober5000
*
* Revision 2.76 2003/10/20 11:49:18 Goober5000
* added min, max, and avg sexps
* --Goober5000
*
* Revision 2.75 2003/09/13 06:02:07 Goober5000
* clean rollback of all of argv's stuff
* --Goober5000
*
* Revision 2.72 2003/09/05 05:06:32 Goober5000
* merged num-ships-in-battle and num-ships-in-battle-team, making the
* team argument optional
* --Goober5000
*
* Revision 2.71 2003/09/05 04:48:03 Goober5000
* merge of Phreak's and my sexp.cpp
* --Goober5000
*
* Revision 2.70 2003/09/05 02:15:34 phreak
* fixed a small bug in num-ships-in-battle-team
* added an option to loop sounds played by play-sound-from-file
*
* Revision 2.69 2003/08/30 21:59:48 phreak
* added num-ships-in-battle and num-ships-in-battle-team sexp
*
* Revision 2.68 2003/08/28 06:17:29 Goober5000
* trying to commit
* --Goober5000
*
* Revision 2.67 2003/08/27 02:04:54 Goober5000
* added percent-ships-disarmed and percent-ships-disabled
* --Goober5000
*
* Revision 2.66 2003/08/27 01:38:00 Goober5000
* added is-ship-type, is-ship-class, lock-rotating-subsystem, and free-rotating-subsystem;
* also fixed the argument and return values for various sexps so that they work
* properly for negative numbers
* --Goober5000
*
* Revision 2.65 2003/08/21 09:00:19 Goober5000
* fixed set-support-ship sexp
* --Goober5000
*
* Revision 2.64 2003/06/19 18:12:12 phreak
* added turret-tagged-specific and turret-tagged-clear-specific sexps
*
* Revision 2.63 2003/05/24 16:47:58 phreak
* added Sesquipedalian's kamikaze and not-kamikaze sexps
*
* Revision 2.62 2003/04/29 01:03:24 Goober5000
* implemented the custom hitpoints mod
* --Goober5000
*
* Revision 2.61 2003/04/05 20:47:58 Goober5000
* gotta love those compiler errors ;)
* fixed those and cleaned up conflicts with the missile-locked sexp
* --Goober5000
*
* Revision 2.60 2003/04/05 20:17:23 sesquipedalian
* Recommit of is-missile-locked.
* I changed the sexp's category from non-campaign to training, so you may get a conflict with that.
*
* Revision 2.59 2003/03/30 07:27:33 Goober5000
* resolved a nasty bug that caused some missions to crash
* --Goober5000
*
* Revision 2.58 2003/03/30 04:34:38 Goober5000
* preliminary work on ai facing sexp
* --Goober5000
*
* Revision 2.57 2003/03/29 11:23:46 sesquipedalian
* Aaaand nevermind...
*
* Revision 2.56 2003/03/29 08:52:59 sesquipedalian
* Added is-missile-locked sexp
*
* Revision 2.55 2003/03/28 19:56:02 Goober5000
* got rid of an annoying compile warning
* --Goober5000
*
* Revision 2.54 2003/03/22 08:17:34 Goober5000
* argh - lol
* --Goober5000
*
* Revision 2.53 2003/03/22 07:24:53 Goober5000
* bleah
* --Goober5000
*
* Revision 2.52 2003/03/22 06:35:37 Goober5000
* bugs are bad, mmkay?
* --Goober5000
*
* Revision 2.51 2003/03/22 06:11:51 Goober5000
* added play-sound-from-table, play-sound-from-file, and close-sound-from-file
* --Goober5000
*
* Revision 2.50 2003/03/21 08:33:33 Goober5000
* yuck - fixed a nasty error when FRED provides a default value for warp-effect
* and explosion-effect
* --Goober5000
*
* Revision 2.49 2003/03/21 04:51:32 Goober5000
* added get-relative-object-*, where * = x, y, and z; these sexps return the
* world coordinates of a set of relative coordinates to an object; also, fixed many
* places in sexp.cpp so that now sexps can accept other sexps as parameters,
* wherease before they weren't able to
* --Goober5000
*
* Revision 2.48 2003/03/20 09:17:16 Goober5000
* implemented EMP as part of weapon-effect sexp
* --Goober5000
*
* Revision 2.47 2003/03/20 04:27:10 Goober5000
* extended sexps
* --Goober5000
*
* Revision 2.46 2003/03/20 00:08:08 Goober5000
* making sexps better
* --Goober5000
*
* Revision 2.45 2003/03/19 06:23:27 Goober5000
* added warp-effect sexp
* --Goober5000
*
* Revision 2.44 2003/03/18 13:38:07 unknownplayer
* Fixed up a bug in the code which was causing all mission loads to crash.
* As of this update, the DX merge is officially functional and complete within the CVS main branch. Tell Inquisitor we won't need to roll back at all, but Goober5000 needs to go and look at his SEXP code since he messed up a bunch of checking functions with it
*
* Revision 2.43 2003/03/18 08:44:04 Goober5000
* added explosion-effect sexp and did some other minor housekeeping
* --Goober5000
*
* Revision 2.42 2003/03/03 04:28:37 Goober5000
* fixed the tech room bug! yay!
* --Goober5000
*
* Revision 2.41 2003/03/01 01:15:38 Goober5000
* fixed the initial status bug
*
* Revision 2.40 2003/01/26 18:37:19 Goober5000
* changed change-music to change-soundtrack
* --Goober5000
*
* Revision 2.39 2003/01/25 04:54:36 Goober5000
* added preloader to change-ship-model and change-ship-class so that the game
* doesn't hesitate when switching models in the middle of missions
* --Goober5000
*
* Revision 2.38 2003/01/25 04:17:39 Goober5000
* added change-music sexp and bumped MAX_SOUNDTRACKS from 10 to 25
* --Goober5000
*
* Revision 2.37 2003/01/21 17:24:16 Goober5000
* fixed a few bugs in Bobboau's implementation of the glow sexps; also added
* help for the sexps in sexp_tree
* --Goober5000
*
* Revision 2.36 2003/01/20 05:40:50 bobboau
* added several sExps for turning glow points and glow maps on and off
*
* Revision 2.35 2003/01/19 22:20:22 Goober5000
* fixed a bunch of bugs -- the support ship sexp, the "no-subspace-drive" flag,
* and departure into hangars should now all work properly
* --Goober5000
*
* Revision 2.34 2003/01/19 07:45:38 Goober5000
* actually added the set-support-ship sexp; much of the other commit was
* groundwork (data types and stuff)
* --Goober5000
*
* Revision 2.33 2003/01/19 07:02:16 Goober5000
* fixed a bunch of bugs - "no-subspace-drive" should now work properly for
* all ships, and all ships who have their departure anchor set to a capital ship
* should exit to that ship when told to depart
* --Goober5000
*
* Revision 2.32 2003/01/18 09:25:41 Goober5000
* fixed bug I inadvertently introduced by modifying SIF_ flags with sexps rather
* than SF_ flags
* --Goober5000
*
* Revision 2.31 2003/01/15 21:29:05 anonymous
* fixed the demo compilation. Define FS2_DEMO globally to compile as a demo. Make sure warp.pof is in your data/models directory.
*
* Revision 2.30 2003/01/13 23:20:00 Goober5000
* bug hunting; fixed the beam whack effect bug
* --Goober5000
*
* Revision 2.29 2003/01/10 04:14:19 Goober5000
* I found these two beautiful functions in ship.cpp - ship_change_model
* and change_ship_type - so I made them into sexps :)
* --Goober5000
*
* Revision 2.28 2003/01/07 20:06:44 Goober5000
* added ai-chase-any-except sexp
* --Goober5000
*
* Revision 2.27 2003/01/05 01:26:35 Goober5000
* added capability of is-iff and change-iff to have wings as well as ships
* as their arguments; also allowed a bunch of sexps to accept the player
* as an argument where they would previously display a parse error
* --Goober5000
*
* Revision 2.26 2003/01/04 23:15:39 Goober5000
* fixed the order sexp
* --Goober5000
*
* Revision 2.25 2003/01/03 21:58:07 Goober5000
* Fixed some minor bugs, and added a primitive-sensors flag, where if a ship
* has primitive sensors it can't target anything and objects don't appear
* on radar if they're outside a certain range. This range can be modified
* via the sexp primitive-sensors-set-range.
* --Goober5000
*
* Revision 2.24 2003/01/02 03:09:01 Goober5000
* this is the way we squash the bugs, squash the bugs, squash the bugs
* this is the way we squash the bugs, so early in the morning :p
* --Goober5000
*
* Revision 2.23 2003/01/02 00:35:20 Goober5000
* added don't-collide-invisible and collide-invisible sexps
* --Goober5000
*
* Revision 2.22 2003/01/01 23:33:33 Goober5000
* added ship-vaporize and ship-no-vaporize sexps
* --Goober5000
*
* Revision 2.21 2002/12/31 18:59:43 Goober5000
* if it ain't broke, don't fix it
* --Goober5000
*
* Revision 2.20 2002/12/31 07:26:40 Goober5000
* added damaged-escort-priority-all sexp
* --Goober5000
*
* Revision 2.19 2002/12/27 20:16:18 phreak
* added damage-escort-list as a new sexp
*
* Revision 2.18 2002/12/27 02:57:51 Goober5000
* removed the existing stealth sexps and replaced them with the following...
* ship-stealthy
* ship-unstealthy
* is-ship-stealthy
* friendly-stealth-invisible
* friendly-stealth-visible
* is-friendly-stealth-visible
* --Goober5000
*
* Revision 2.17 2002/12/25 01:22:23 Goober5000
* meh - changed is-cargo-x to is-cargo
* --Goober5000
*
* Revision 2.16 2002/12/24 07:42:29 Goober5000
* added change-ai-class and is-ai-class, and I think I may also have nailed the
* is-iff bug; did some other bug hunting as well
* --Goober5000
*
* Revision 2.15 2002/12/23 23:01:27 Goober5000
* added set-cargo and is-cargo-x sexps
* --Goober5000
*
* Revision 2.14 2002/12/23 05:41:08 Goober5000
* Bah - Andsager is a moron. :) I see no reason why rand shouldn't work
* multiple times. It's been fixed thus.
* --Goober5000
*
* Revision 2.13 2002/12/23 05:18:52 Goober5000
* Squashed some Volition bugs! :O Some of the sexps for dealing with more than
* one ship would return after only dealing with the first ship.
*
* Also added the following sexps:
* is-ship-stealthed
* ship-force-stealth
* ship-force-nostealth
* ship-remove-stealth-forcing
*
* They toggle the stealth flag on and off. If a ship is forced stealthy, it won't even
* show up for friendly ships.
* --Goober5000
*
* Revision 2.12 2002/12/22 21:12:22 Goober5000
* added primaries-depleted and primary-ammo-pct sexps -- useful for ships with
* ballistic primaries
* --Goober5000
*
* Revision 2.11 2002/12/22 17:22:47 Goober5000
* Subcategories implemented. :) So far all that's been done is the Change menu, but other
* subcategorizations are possible. Here are the instructions from sexp.h...
* "Adding more subcategories is possible with the new code. All that needs to be done is
* to add a #define here (a number from 0x0000 to 0x00ff ORred with the category that it
* goes under), some appropriate case statements in get_subcategory() (in sexp.cpp) that
* will return the subcategory for each sexp that uses it, and the submenu name in the
* op_submenu[] array in sexp.cpp."
*
* Please note that I rearranged a whole bunch of sexps in the Operators[] array in sexp.cpp
* in order to make the subcategories work better, so if you get a whole bunch of differences
* or even conflicts, just ignore them. :)
* --Goober5000
*
* Revision 2.10 2002/12/21 17:58:11 Goober5000
* rearranged the sexp list and got the preliminary subcategories working - still need to work on the actual submenu
* --Goober5000
*
* Revision 2.9 2002/12/20 07:17:23 Goober5000
* Updated the cargo-known-delay and cap-subsys-cargo-known-delay sexps to work correctly if set-scanned and set-unscanned are used repeatedly with the same ship or ship subsystem. In most cases, this functionality will never be needed, but it's nice to know that it's here. :) However, I should point out that cap-subsys-cargo-known-delay will recognize only the first instance of a subsystem being revealed once the ship is no longer in the mission. Here is the relevant bit I put into the sexp handling routine...
* "Since there is no way to keep track of subsystem status once a ship has departed or has been destroyed, check the mission log. This will work in 99.9999999% of all cases; however, if the mission designer repeatedly sets and resets the scanned status of the subsystem, the mission log will only return the first occurrence of the subsystem cargo being revealed (regardless of whether it was first hidden using set-unscanned). Normally, ships keep track of cargo data in the subsystem struct, but once/ the ship has left the mission, the subsystem linked list is purged, causing the loss of this information. I judged the significant rework of the subsystem code not worth the rare instance that this sexp may be required to work in this way, especially since this problem only occurs after the ship departs. If the mission designer really needs this functionality, he or she can achieve the same result with creative combinations of event chaining and is-event-true."
*
* Please note that this problem only occurs with cap-subsys-cargo-known-delay, only if the subsystem scanned status is revealed more than once, and then only after the ship is no longer in the mission. Sufficiently rare, I figured, that I could afford to not worry about it.
* --Goober5000
*
* Revision 2.8 2002/12/17 03:25:30 Goober5000
* added set-scanned and set-unscanned sexps
*
* PLEASE NOTE: These sexps will cause cargo-known-delay and cap-subsys-cargo-known-delay to not work correctly if set-scanned and set-unscanned are used more than once. I'll fix this later.
*
* --Goober5000
*
* Revision 2.7 2002/12/12 08:01:57 Goober5000
* added distance-ship-subsystem sexp
* ~Goober5000~
*
* Revision 2.6 2002/11/28 00:00:37 sesquipedalian
* end-mission sexp added
*
* Revision 2.5 2002/11/20 21:22:31 DTP
* DTP; fix at line 6785 in parse/SEXP.cpp, a forgotten "{", when the is tagged thing was Fixed
*
* Revision 2.4 2002/11/19 02:15:50 sesquipedalian
* Adding in EdrickV's fix to the is-tagged sexp.
*
* Revision 2.3 2002/10/29 22:41:48 sesquipedalian
* no message
*
* Revision 2.2 2002/08/01 01:41:09 penguin
* The big include file move
*
* Revision 2.1 2002/07/13 09:16:18 wmcoolmon
* Added initial code for "ship-lights-on" and "ship-lights-off" SEXPs
*
* Revision 2.0 2002/06/03 04:02:27 penguin
* Warpcore CVS sync
*
* Revision 1.3 2002/05/10 20:42:44 mharris
* use "ifndef NO_NETWORK" all over the place
*
* Revision 1.2 2002/05/03 22:07:09 mharris
* got some stuff to compile
*
* Revision 1.1 2002/05/02 18:03:12 mharris
* Initial checkin - converted filenames and includes to lower case
*
*
* 66 9/13/99 11:38a Andsager
* Stupid switch for sexp_team_score. Don't forget *break*
*
* 65 9/09/99 11:40p Dave
* Handle an Assert() in beam code. Added supernova sounds. Play the right
* 2 end movies properly, based upon what the player did in the mission.
*
* 64 9/07/99 1:05a Andsager
* Added team-score sexp for multi team vs team missions
*
* 63 9/06/99 9:46p Jefff
* skip mission support
*
* 62 8/29/99 2:33p Andsager
* Fix bug in sexp_is_ship_visible()
*
* 61 8/27/99 9:07p Dave
* LOD explosions. Improved beam weapon accuracy.
*
* 60 8/27/99 4:07p Andsager
* Add is-ship-visible sexp. Make ship-vanish sexp SINGLE player only
*
* 59 8/26/99 4:21p Mikek
* Add new special-check for JimB, zeroing front shield quadrant.
*
* 58 8/24/99 4:25p Andsager
* Add ship-vanish sexp
*
* 57 8/23/99 6:05p Johnson
* Oops. Self destruct log should also go into the is-destroyed
* sexpression.
*
* 56 8/23/99 3:23p Johnson
* Fix bug in sexp_facing2 when Player_obj does not yet existl
*
* 55 8/19/99 3:30p Andsager
* Make sexp_special_warp_dist check if ship if facing knossos device
*
* 54 8/19/99 9:20a Andsager
* Enable flashing for all guages
*
* 53 8/19/99 12:31a Andsager
* Add support guage as one that can flash
*
* 52 8/18/99 12:09p Andsager
* Add debug if message has no anim for message. Make messages come from
* wing leader.
*
* 51 8/16/99 10:04p Andsager
* Add special-warp-dist and special-warpout-name sexp for Knossos device
* warpout.
*
* 50 8/09/99 3:32p Andsager
* Make has_time_elapsed work with arithmatic args.
*
* 49 8/09/99 2:00p Dave
* 2 new sexpressions.
*
* 48 8/02/99 4:26p Dave
* Added 2 new sexpressions.
*
* 47 7/31/99 2:30p Dave
* Added nifty mission message debug viewing keys.
*
* 46 7/28/99 1:36p Andsager
* Modify cargo1 to include flag CARGO_NO_DEPLETE. Add sexp
* cargo-no-deplete (only for BIG / HUGE). Modify ship struct to pack
* better.
*
* 45 7/24/99 4:56p Dave
* Added 3 new sexpressions.
*
* 44 7/21/99 8:10p Dave
* First run of supernova effect.
*
* 43 7/20/99 9:19p Andsager
* Added facing waypoint sexp
*
* 42 7/20/99 9:54a Andsager
* Add subsys-set-random sexp
*
* 41 7/19/99 12:02p Andsager
* Allow AWACS on any ship subsystem. Fix sexp_set_subsystem_strength to
* only blow up subsystem if its strength is > 0
*
* 40 7/15/99 9:22p Andsager
* modify secondaries_depleted sexp to report true only when all
* secondaries gone
*
* 39 7/13/99 3:37p Andsager
* Add secondaries-depleted sexp
*
* 38 7/08/99 12:06p Andsager
* Add turret-tagged-only and turret-tagged-clear sexp.
*
* 37 6/28/99 4:51p Andsager
* Add ship-guardian sexp (does not allow ship to be killed)
*
* 36 6/25/99 2:51p Andsager
* Make event_delay, goal_delay, and subsys strength work with sexp_rand
*
* 35 6/23/99 5:51p Andsager
* Add waypoint-cap-speed. Checkin stealth ai - inactive.
*
* 34 6/16/99 10:21a Dave
* Added send-message-list sexpression.
*
* 33 6/15/99 2:53p Andsager
* Fixed subsystem checking for AWACS type subsystems.
*
* 32 6/01/99 8:35p Dave
* Finished lockarm weapons. Added proper supercap weapons/damage. Added
* awacs-set-radius sexpression.
*
* 31 5/27/99 12:14p Andsager
* Some fixes for live debris when more than one subsys on ship with live
* debris. Set subsys strength (when 0) blows off subsystem.
* sexp_hits_left_subsystem works for SUBSYSTEM_UNKNOWN.
*
* 30 5/24/99 11:28a Dave
* Sexpression for adding/removing ships from the hud escort list.
*
* 29 4/28/99 9:33a Andsager
* Add turret-free and turret-lock (and -all) sexp. Stargger start time
* of beam weapons beam-free and beam-free-all.
*
* 28 4/26/99 2:14p Andsager
* Add beam-protect-ship and beam-unprotect-ship sexp.
*
* 27 4/23/99 12:01p Johnson
* Added SIF_HUGE_SHIP
*
* 26 4/23/99 9:45a Andsager
* Modify rand_sexp to return the same value each time it is called on a
* particular node. This prevents random time delay defaulting to min.
*
* 25 4/21/99 6:15p Dave
* Did some serious housecleaning in the beam code. Made it ready to go
* for anti-fighter "pulse" weapons. Fixed collision pair creation. Added
* a handy macro for recalculating collision pairs for a given object.
*
* 24 4/19/99 2:28p Johnson
* DA: Use ship_info flags, not ship_flags for ship type. DOH!!
*
* 23 4/19/99 11:46a Johnson
* DA: DOH!
*
* 22 4/19/99 11:36a Johnson
* Don't display multiple warning messges when large ship gets more than 1
* cargo transfer.
*
* 21 4/02/99 9:55a Dave
* Added a few more options in the weapons.tbl for beam weapons. Attempt
* at putting "pain" packets into multiplayer.
*
* 20 3/31/99 2:22p Johnson
* Fix sexp_repair_subsystem() to accept sexp increments
*
* 19 3/28/99 5:58p Dave
* Added early demo code. Make objects move. Nice and framerate
* independant, but not much else. Don't use yet unless you're me :)
*
* 18 3/20/99 3:46p Dave
* Added support for model-based background nebulae. Added 3 new
* sexpressions.
*
* 17 3/08/99 7:03p Dave
* First run of new object update system. Looks very promising.
*
* 16 3/04/99 6:09p Dave
* Added in sexpressions for firing beams and checking for if a ship is
* tagged.
*
* 15 3/04/99 9:22a Andsager
* Make escort list work with ship-is-visible. When not visible, dump,
* when becoming visible, maybe add.
*
* 14 2/26/99 6:01p Andsager
* Add sexp has-been-tagged-delay and cap-subsys-cargo-known-delay
*
* 13 2/26/99 4:14p Dave
* Put in the ability to have multiple shockwaves for ships.
*
* 12 2/11/99 5:22p Andsager
* Fixed bugs, generalized block Sexp_variables
*
* 11 2/11/99 2:15p Andsager
* Add ship explosion modification to FRED
*
* 10 1/25/99 4:29p Andsager
* Modify sexp_modify_variable() to handle type string. added quick out
* for multiplayer_client
*
* 9 1/25/99 8:11a Andsager
* Add sexp_modify_variable(). Changed syntax checking to allow, adding
* operator return type ambiguous
*
* 8 1/24/99 11:37p Dave
* First full rev of beam weapons. Very customizable. Removed some bogus
* Int3()'s in low level net code.
*
* 7 1/20/99 9:37a Andsager
*
* 6 1/19/99 3:57p Andsager
* Round 2 of variables
*
* 5 1/07/99 1:52p Andsager
* Initial check in of Sexp_variables
*
* 4 11/05/98 5:55p Dave
* Big pass at reducing #includes
*
* 3 10/13/98 9:29a Dave
* Started neatening up freespace.h. Many variables renamed and
* reorganized. Added AlphaColors.[h,cpp]
*
* 2 10/07/98 10:53a Dave
* Initial checkin.
*
* 1 10/07/98 10:50a Dave
*
* 321 9/20/98 7:20p Dave
* Added CHANGE_IFF packet.
*
* 320 9/16/98 10:42a Hoffoss
* Added sexp node counting to fsm files for end user designers.
*
* 319 7/06/98 4:31p Hoffoss
* Fixed bug in sexp parsing when formula is ( ).
*
* 318 6/09/98 5:15p Lawrance
* French/German localization
*
* 317 5/26/98 11:54a Allender
* fix multiplayer problems and sexpression crash
*
* 316 5/23/98 3:16p Allender
* work on object update packet optimizations (a new updating system).
* Don't allow medals/promotions/badges when playing singple player
* missions through the simulator
*
* 315 5/20/98 1:34a Allender
* fixed observer problems. Removed some code offending BoundsCheccker.
* Fixed medals for multiplayer
*
* 314 5/17/98 12:46p Mike
* Change special-check functions for cueing rearm suggestion.
*
* 313 5/14/98 6:29p Hoffoss
* Fixed some warnings a release rebuild all turned up.
*
* 312 5/14/98 10:15a Allender
* add optional argument to prevous-goal/event operators to specify what
* sexpression should return when being played as a single mission
*
* 311 5/08/98 10:16a Lawrance
* Add new "ship attacking count" gauge
*
* 310 4/29/98 11:39p Allender
* fixed nasty problem with is-event-false always returning true right
* away
*
*
*/
// Parse a symbolic expression.
// These are identical to Lisp functions.
// It uses a very baggy format, allocating 16 characters per token, regardless
// of how many are used.
#include <stdio.h>
#include <stdlib.h>
#include <string.h>
#include <ctype.h>
#include <assert.h>
#include <limits.h>
#include "parse/parselo.h"
#include "parse/sexp.h"
#include "ship/ship.h"
#include "freespace2/freespace.h"
#include "weapon/weapon.h"
#include "mission/missionlog.h"
#include "mission/missionparse.h" // for p_object definition
#include "mission/missionmessage.h"
#include "mission/missiontraining.h"
#include "globalincs/linklist.h"
#include "ai/aigoals.h"
#include "mission/missioncampaign.h"
#include "mission/missiongoals.h"
#include "mission/missionbriefcommon.h"
#include "io/timer.h"
#include "ship/shiphit.h"
#include "gamesequence/gamesequence.h"
#include "stats/medals.h"
#include "playerman/player.h"
#include "hud/hud.h"
#include "hud/hudconfig.h"
#include "missionui/redalert.h"
#include "jumpnode/jumpnode.h"
#include "hud/hudshield.h"
#include "hud/hudescort.h"
#include "weapon/beam.h"
#include "starfield/supernova.h"
#include "hud/hudets.h"
#include "math/fvi.h"
#include "ship/awacs.h"
#include "hud/hudsquadmsg.h" // for the order sexp
#include "gamesnd/eventmusic.h" // for change-soundtrack
#include "menuui/techmenu.h" // for intel stuff
#include "fireball/fireballs.h" // for explosion stuff
#include "gamesnd/gamesnd.h"
#include "render/3d.h"
#include "asteroid/asteroid.h"
#include "weapon/shockwave.h"
#include "weapon/emp.h"
#include "sound/audiostr.h"
#include "cmdline/cmdline.h"
#include "hud/hudparse.h"
#include "starfield/starfield.h"
#include "hud/hudartillery.h"
#include "object/objectdock.h"
#include "globalincs/systemvars.h"
#include "globalincs/version.h"
#include "camera/camera.h"
#include "iff_defs/iff_defs.h"
#include "nebula/neb.h"
#include "nebula/neblightning.h"
#include "network/multi.h"
#include "network/multimsgs.h"
#include "network/multiutil.h"
#include "network/multi_team.h"
#include "network/multi_obj.h"
#include "parse/lua.h"
#include "parse/scripting.h"
#include "object/objcollide.h"
#include "object/waypoint.h"
#include "graphics/2d.h"
#include "object/objectsnd.h"
#ifndef NDEBUG
#include "hud/hudmessage.h"
#endif
#include "autopilot/autopilot.h"
#include "object/objectshield.h"
#include "network/multi_sexp.h"
#define TRUE 1
#define FALSE 0
sexp_oper Operators[] = {
// Operator, Identity, Min / Max arguments
{ "+", OP_PLUS, 2, INT_MAX },
{ "-", OP_MINUS, 2, INT_MAX },
{ "*", OP_MUL, 2, INT_MAX },
{ "/", OP_DIV, 2, INT_MAX },
{ "mod", OP_MOD, 2, INT_MAX },
{ "rand", OP_RAND, 2, 3 },
{ "rand-multiple", OP_RAND_MULTIPLE, 2, 3 }, // Goober5000
{ "abs", OP_ABS, 1, 1 }, // Goober5000
{ "min", OP_MIN, 1, INT_MAX }, // Goober5000
{ "max", OP_MAX, 1, INT_MAX }, // Goober5000
{ "avg", OP_AVG, 1, INT_MAX }, // Goober5000
{ "true", OP_TRUE, 0, 0, },
{ "false", OP_FALSE, 0, 0, },
{ "and", OP_AND, 2, INT_MAX, },
{ "and-in-sequence", OP_AND_IN_SEQUENCE, 2, INT_MAX, },
{ "or", OP_OR, 2, INT_MAX, },
{ "not", OP_NOT, 1, 1, },
{ "=", OP_EQUALS, 2, INT_MAX, },
{ ">", OP_GREATER_THAN, 2, INT_MAX, },
{ "<", OP_LESS_THAN, 2, INT_MAX, },
{ "string-equals", OP_STRING_EQUALS, 2, INT_MAX, },
{ "string-greater-than", OP_STRING_GREATER_THAN, 2, INT_MAX, },
{ "string-less-than", OP_STRING_LESS_THAN, 2, INT_MAX, },
{ "has-time-elapsed", OP_HAS_TIME_ELAPSED, 1, 1, },
{ "is-goal-true-delay", OP_GOAL_TRUE_DELAY, 2, 2, },
{ "is-goal-false-delay", OP_GOAL_FALSE_DELAY, 2, 2, },
{ "is-goal-incomplete", OP_GOAL_INCOMPLETE, 1, 1, },
{ "is-event-true", OP_EVENT_TRUE, 1, 1, },
{ "is-event-true-delay", OP_EVENT_TRUE_DELAY, 2, 3, },
{ "is-event-false", OP_EVENT_FALSE, 1, 1, },
{ "is-event-false-delay", OP_EVENT_FALSE_DELAY, 2, 3, },
{ "is-event-incomplete", OP_EVENT_INCOMPLETE, 1, 1, },
{ "is-previous-goal-true", OP_PREVIOUS_GOAL_TRUE, 2, 3, },
{ "is-previous-goal-false", OP_PREVIOUS_GOAL_FALSE, 2, 3, },
{ "is-previous-goal-incomplete", OP_PREVIOUS_GOAL_INCOMPLETE, 2, 3, },
{ "is-previous-event-true", OP_PREVIOUS_EVENT_TRUE, 2, 3, },
{ "is-previous-event-false", OP_PREVIOUS_EVENT_FALSE, 2, 3, },
{ "is-previous-event-incomplete", OP_PREVIOUS_EVENT_INCOMPLETE, 2, 3, },
{ "is-destroyed", OP_IS_DESTROYED, 1, INT_MAX, },
{ "is-destroyed-delay", OP_IS_DESTROYED_DELAY, 2, INT_MAX, },
{ "is-subsystem-destroyed", OP_IS_SUBSYSTEM_DESTROYED, 2, 2, },
{ "is-subsystem-destroyed-delay", OP_IS_SUBSYSTEM_DESTROYED_DELAY, 3, 3, },
{ "is-disabled", OP_IS_DISABLED, 1, INT_MAX, },
{ "is-disabled-delay", OP_IS_DISABLED_DELAY, 2, INT_MAX, },
{ "is-disarmed", OP_IS_DISARMED, 1, INT_MAX, },
{ "is-disarmed-delay", OP_IS_DISARMED_DELAY, 2, INT_MAX, },
{ "has-docked", OP_HAS_DOCKED, 3, 3, },
{ "has-docked-delay", OP_HAS_DOCKED_DELAY, 4, 4, },
{ "has-undocked", OP_HAS_UNDOCKED, 3, 3, },
{ "has-undocked-delay", OP_HAS_UNDOCKED_DELAY, 4, 4, },
{ "has-arrived", OP_HAS_ARRIVED, 1, INT_MAX, },
{ "has-arrived-delay", OP_HAS_ARRIVED_DELAY, 2, INT_MAX, },
{ "has-departed", OP_HAS_DEPARTED, 1, INT_MAX, },
{ "has-departed-delay", OP_HAS_DEPARTED_DELAY, 2, INT_MAX, },
{ "are-waypoints-done", OP_WAYPOINTS_DONE, 2, 2, },
{ "are-waypoints-done-delay", OP_WAYPOINTS_DONE_DELAY, 3, 3, },
{ "ship-type-destroyed", OP_SHIP_TYPE_DESTROYED, 2, 2, },
{ "percent-ships-destroyed", OP_PERCENT_SHIPS_DESTROYED, 2, INT_MAX, },
{ "percent-ships-disabled", OP_PERCENT_SHIPS_DISABLED, 2, INT_MAX, },
{ "percent-ships-disarmed", OP_PERCENT_SHIPS_DISARMED, 2, INT_MAX, },
{ "percent-ships-departed", OP_PERCENT_SHIPS_DEPARTED, 2, INT_MAX, },
{ "depart-node-delay", OP_DEPART_NODE_DELAY, 3, INT_MAX, },
{ "destroyed-or-departed-delay", OP_DESTROYED_DEPARTED_DELAY, 2, INT_MAX, },
{ "is-cargo-known", OP_IS_CARGO_KNOWN, 1, INT_MAX, },
{ "is-cargo-known-delay", OP_CARGO_KNOWN_DELAY, 2, INT_MAX, },
{ "cap-subsys-cargo-known-delay", OP_CAP_SUBSYS_CARGO_KNOWN_DELAY, 3, INT_MAX, },
{ "is-cargo", OP_IS_CARGO, 2, 3 },
{ "is-ship-visible", OP_IS_SHIP_VISIBLE, 1, 1, },
{ "is-ship-stealthy", OP_IS_SHIP_STEALTHY, 1, 1, },
{ "is-friendly-stealth-visible", OP_IS_FRIENDLY_STEALTH_VISIBLE, 1, 1, },
{ "is_tagged", OP_IS_TAGGED, 1, 1 },
{ "has-been-tagged-delay", OP_HAS_BEEN_TAGGED_DELAY, 2, INT_MAX, },
{ "is-iff", OP_IS_IFF, 2, INT_MAX, },
{ "is-ai-class", OP_IS_AI_CLASS, 2, INT_MAX, },
{ "is-ship-type", OP_IS_SHIP_TYPE, 2, INT_MAX, },
{ "is-ship-class", OP_IS_SHIP_CLASS, 2, INT_MAX, },
{ "shield-recharge-pct", OP_SHIELD_RECHARGE_PCT, 1, 1 },
{ "engine-recharge-pct", OP_ENGINE_RECHARGE_PCT, 1, 1 },
{ "weapon-recharge-pct", OP_WEAPON_RECHARGE_PCT, 1, 1 },
{ "shield-quad-low", OP_SHIELD_QUAD_LOW, 2, 2 },
{ "primary-ammo-pct", OP_PRIMARY_AMMO_PCT, 2, 2 },
{ "secondary-ammo-pct", OP_SECONDARY_AMMO_PCT, 2, 2 },
{ "get-primary-ammo", OP_GET_PRIMARY_AMMO, 2, 2 }, // Karajorma
{ "get-secondary-ammo", OP_GET_SECONDARY_AMMO, 2, 2 }, // Karajorma
{ "is-primary-selected", OP_IS_PRIMARY_SELECTED, 2, 2 },
{ "is-secondary-selected", OP_IS_SECONDARY_SELECTED, 2, 2 },
{ "afterburner-energy-pct", OP_AFTERBURNER_LEFT, 1, 1 },
{ "weapon-energy-pct", OP_WEAPON_ENERGY_LEFT, 1, 1 },
{ "shields-left", OP_SHIELDS_LEFT, 1, 1, },
{ "hits-left", OP_HITS_LEFT, 1, 1, },
{ "hits-left-subsystem", OP_HITS_LEFT_SUBSYSTEM, 2, 3, },
{ "sim-hits-left", OP_SIM_HITS_LEFT, 1, 1, }, // Turey
{ "distance", OP_DISTANCE, 2, 2, },
{ "distance-ship-subsystem", OP_DISTANCE_SUBSYSTEM, 3, 3 }, // Goober5000
{ "num-within-box", OP_NUM_WITHIN_BOX, 7, INT_MAX}, //WMC
{ "special-warp-dist", OP_SPECIAL_WARP_DISTANCE, 1, 1, },
{ "get-damage-caused", OP_GET_DAMAGE_CAUSED, 2, INT_MAX },
{ "set-object-speed-x", OP_SET_OBJECT_SPEED_X, 2, 3 }, // WMC
{ "set-object-speed-y", OP_SET_OBJECT_SPEED_Y, 2, 3 }, // WMC
{ "set-object-speed-z", OP_SET_OBJECT_SPEED_Z, 2, 3 }, // WMC
{ "get-object-x", OP_GET_OBJECT_X, 1, 5 }, // Goober5000
{ "get-object-y", OP_GET_OBJECT_Y, 1, 5 }, // Goober5000
{ "get-object-z", OP_GET_OBJECT_Z, 1, 5 }, // Goober5000
{ "set-object-position", OP_SET_OBJECT_POSITION, 4, 4 }, // WMC
{ "set-object-facing", OP_SET_OBJECT_FACING, 4, 6 }, // Goober5000
{ "set-object-facing-object", OP_SET_OBJECT_FACING_OBJECT, 2, 4 }, // Goober5000
{ "time-elapsed-last-order", OP_LAST_ORDER_TIME, 2, 2, /*INT_MAX*/ },
{ "skill-level-at-least", OP_SKILL_LEVEL_AT_LEAST, 1, 1, },
{ "num-ships-in-battle", OP_NUM_SHIPS_IN_BATTLE, 0, 1}, //phreak
{ "num-ships-in-wing", OP_NUM_SHIPS_IN_WING, 1, INT_MAX}, // Karajorma
{ "is-player", OP_IS_PLAYER, 2, INT_MAX}, // Karajorma
{ "num-players", OP_NUM_PLAYERS, 0, 0, },
{ "num_kills", OP_NUM_KILLS, 1, 1 },
{ "num_assists", OP_NUM_ASSISTS, 1, 1 },
{ "ship_score", OP_SHIP_SCORE, 1, 1 },
{ "ship-deaths", OP_SHIP_DEATHS, 1, 1 },
{ "respawns-left", OP_RESPAWNS_LEFT, 1, 1 },
{ "num_type_kills", OP_NUM_TYPE_KILLS, 2, 2 },
{ "num_class_kills", OP_NUM_CLASS_KILLS, 2, 2 },
{ "team-score", OP_TEAM_SCORE, 1, 1, },
{ "was-promotion-granted", OP_WAS_PROMOTION_GRANTED, 0, 1, },
{ "was-medal-granted", OP_WAS_MEDAL_GRANTED, 0, 1, },
{ "current-speed", OP_CURRENT_SPEED, 1, 1},
{ "primary-fired-since", OP_PRIMARY_FIRED_SINCE, 3, 3}, // Karajorma
{ "secondary-fired-since", OP_SECONDARY_FIRED_SINCE, 3, 3}, // Karajorma
{ "time-ship-destroyed", OP_TIME_SHIP_DESTROYED, 1, 1, },
{ "time-ship-arrived", OP_TIME_SHIP_ARRIVED, 1, 1, },
{ "time-ship-departed", OP_TIME_SHIP_DEPARTED, 1, 1, },
{ "time-wing-destroyed", OP_TIME_WING_DESTROYED, 1, 1, },
{ "time-wing-arrived", OP_TIME_WING_ARRIVED, 1, 1, },
{ "time-wing-departed", OP_TIME_WING_DEPARTED, 1, 1, },
{ "mission-time", OP_MISSION_TIME, 0, 0, },
{ "time-docked", OP_TIME_DOCKED, 3, 3, },
{ "time-undocked", OP_TIME_UNDOCKED, 3, 3, },
{ "cond", OP_COND, 1, INT_MAX, },
{ "when", OP_WHEN, 2, INT_MAX, },
{ "when-argument", OP_WHEN_ARGUMENT, 3, INT_MAX, }, // Goober5000
{ "every-time", OP_EVERY_TIME, 2, INT_MAX, }, // Goober5000
{ "every-time-argument", OP_EVERY_TIME_ARGUMENT, 3, INT_MAX, }, // Goober5000
{ "any-of", OP_ANY_OF, 1, INT_MAX, }, // Goober5000
{ "every-of", OP_EVERY_OF, 1, INT_MAX, }, // Goober5000
{ "random-of", OP_RANDOM_OF, 1, INT_MAX, }, // Goober5000
{ "random-multiple-of", OP_RANDOM_MULTIPLE_OF, 1, INT_MAX, }, // Karajorma
{ "number-of", OP_NUMBER_OF, 2, INT_MAX, }, // Goober5000
{ "in-sequence", OP_IN_SEQUENCE, 1, INT_MAX, }, // Karajorma
{ "invalidate-argument", OP_INVALIDATE_ARGUMENT, 1, INT_MAX, }, // Goober5000
{ "validate-argument", OP_VALIDATE_ARGUMENT, 1, INT_MAX, }, // Karajorma
{ "do-for-valid-arguments", OP_DO_FOR_VALID_ARGUMENTS, 1, INT_MAX, }, // Karajorma
{ "send-message-list", OP_SEND_MESSAGE_LIST, 4, INT_MAX },
{ "send-message", OP_SEND_MESSAGE, 3, 3, },
{ "send-random-message", OP_SEND_RANDOM_MESSAGE, 3, INT_MAX,},
{ "invalidate-goal", OP_INVALIDATE_GOAL, 1, INT_MAX,},
{ "validate-goal", OP_VALIDATE_GOAL, 1, INT_MAX,},
{ "scramble-messages", OP_SCRAMBLE_MESSAGES, 0, 0,},
{ "unscramble-messages", OP_UNSCRAMBLE_MESSAGES, 0, 0,},
{ "disable-builtin-messages", OP_DISABLE_BUILTIN_MESSAGES, 0, INT_MAX,}, // Karajorma
{ "enable-builtin-messages", OP_ENABLE_BUILTIN_MESSAGES, 0, INT_MAX,}, // Karajorma
{ "set-persona", OP_SET_PERSONA, 2, INT_MAX,}, // Karajorma
{ "add-goal", OP_ADD_GOAL, 2, 2, },
{ "remove-goal", OP_REMOVE_GOAL, 2, 2, }, // Goober5000
{ "add-ship-goal", OP_ADD_SHIP_GOAL, 2, 2, },
{ "add-wing-goal", OP_ADD_WING_GOAL, 2, 2, },
{ "clear-goals", OP_CLEAR_GOALS, 1, INT_MAX, },
{ "clear-ship-goals", OP_CLEAR_SHIP_GOALS, 1, 1, },
{ "clear-wing-goals", OP_CLEAR_WING_GOALS, 1, 1, },
{ "good-rearm-time", OP_GOOD_REARM_TIME, 2, 2, },
{ "good-secondary-time", OP_GOOD_SECONDARY_TIME, 4, 4, },
{ "change-iff", OP_CHANGE_IFF, 2, INT_MAX, },
{ "change-iff-color", OP_CHANGE_IFF_COLOR, 6, INT_MAX, },
{ "change-ai-class", OP_CHANGE_AI_CLASS, 2, INT_MAX, },
{ "protect-ship", OP_PROTECT_SHIP, 1, INT_MAX, },
{ "unprotect-ship", OP_UNPROTECT_SHIP, 1, INT_MAX, },
{ "beam-protect-ship", OP_BEAM_PROTECT_SHIP, 1, INT_MAX, },
{ "beam-unprotect-ship", OP_BEAM_UNPROTECT_SHIP, 1, INT_MAX, },
{ "kamikaze", OP_KAMIKAZE, 2, INT_MAX }, //-Sesquipedalian
{ "not-kamikaze", OP_NOT_KAMIKAZE, 1, INT_MAX }, //-Sesquipedalian
{ "player-use-ai", OP_PLAYER_USE_AI, 0, 0 }, // Goober5000
{ "player-not-use-ai", OP_PLAYER_NOT_USE_AI, 0, 0 }, // Goober5000
{ "allow-treason", OP_ALLOW_TREASON, 1, 1 }, // Karajorma
{ "sabotage-subsystem", OP_SABOTAGE_SUBSYSTEM, 3, 3, },
{ "repair-subsystem", OP_REPAIR_SUBSYSTEM, 3, 4, },
{ "set-subsystem-strength", OP_SET_SUBSYSTEM_STRNGTH, 3, 4, },
{ "subsys-set-random", OP_SUBSYS_SET_RANDOM, 3, INT_MAX },
{ "self-destruct", OP_SELF_DESTRUCT, 1, INT_MAX, },
{ "transfer-cargo", OP_TRANSFER_CARGO, 2, 2, },
{ "exchange-cargo", OP_EXCHANGE_CARGO, 2, 2, },
{ "set-cargo", OP_SET_CARGO, 2, 3, },
{ "jettison-cargo-delay", OP_JETTISON_CARGO, 2, INT_MAX, },
{ "cargo-no-deplete", OP_CARGO_NO_DEPLETE, 1, 2 },
{ "set-scanned", OP_SET_SCANNED, 1, 2 },
{ "set-unscanned", OP_SET_UNSCANNED, 1, 2 },
{ "lock-rotating-subsystem", OP_LOCK_ROTATING_SUBSYSTEM, 2, INT_MAX }, // Goober5000
{ "free-rotating-subsystem", OP_FREE_ROTATING_SUBSYSTEM, 2, INT_MAX }, // Goober5000
{ "reverse-rotating-subsystem", OP_REVERSE_ROTATING_SUBSYSTEM, 2, INT_MAX }, // Goober5000
{ "rotating-subsys-set-turn-time", OP_ROTATING_SUBSYS_SET_TURN_TIME, 3, INT_MAX }, // Goober5000
{ "set-primary-ammo", OP_SET_PRIMARY_AMMO, 3, 4 }, // Karajorma
{ "set-secondary-ammo", OP_SET_SECONDARY_AMMO, 3, 4 }, // Karajorma
{ "set-primary-weapon", OP_SET_PRIMARY_WEAPON, 3, 5 }, // Karajorma
{ "set-secondary-weapon", OP_SET_SECONDARY_WEAPON, 3, 5 }, // Karajorma
{ "lock-primary-weapon", OP_LOCK_PRIMARY_WEAPON, 1, INT_MAX }, // Karajorma
{ "unlock-primary-weapon", OP_UNLOCK_PRIMARY_WEAPON, 1, INT_MAX }, // Karajorma
{ "lock-secondary-weapon", OP_LOCK_SECONDARY_WEAPON, 1, INT_MAX }, // Karajorma
{ "unlock-secondary-weapon", OP_UNLOCK_SECONDARY_WEAPON, 1, INT_MAX }, // Karajorma
{ "change-subsystem-name", OP_CHANGE_SUBSYSTEM_NAME, 3, INT_MAX }, // Karajorma
{ "lock-afterburner", OP_LOCK_AFTERBURNER, 1, INT_MAX }, // KeldorKatarn
{ "unlock-afterburner", OP_UNLOCK_AFTERBURNER, 1, INT_MAX }, // KeldorKatarn
{ "set-afterburner-energy", OP_SET_AFTERBURNER_ENERGY, 2, INT_MAX }, // Karajorma
{ "set-weapon-energy", OP_SET_WEAPON_ENERGY, 2, INT_MAX }, // Karajorma
{ "set-shield-energy", OP_SET_SHIELD_ENERGY, 2, INT_MAX }, // Karajorma
{ "set-ambient-light", OP_SET_AMBIENT_LIGHT, 3, 3 }, // Karajorma
{ "ship-invulnerable", OP_SHIP_INVULNERABLE, 1, INT_MAX },
{ "ship-vulnerable", OP_SHIP_VULNERABLE, 1, INT_MAX },
{ "ship-guardian", OP_SHIP_GUARDIAN, 1, INT_MAX },
{ "ship-no-guardian", OP_SHIP_NO_GUARDIAN, 1, INT_MAX },
{ "ship-guardian-threshold", OP_SHIP_GUARDIAN_THRESHOLD, 2, INT_MAX },
{ "ship-subsys-guardian-threshold", OP_SHIP_SUBSYS_GUARDIAN_THRESHOLD, 3, INT_MAX },
{ "ship-invisible", OP_SHIP_INVISIBLE, 1, INT_MAX },
{ "ship-visible", OP_SHIP_VISIBLE, 1, INT_MAX },
{ "ship-stealthy", OP_SHIP_STEALTHY, 1, INT_MAX },
{ "ship-unstealthy", OP_SHIP_UNSTEALTHY, 1, INT_MAX }, // Goober5000
{ "friendly-stealth-invisible", OP_FRIENDLY_STEALTH_INVISIBLE, 1, INT_MAX }, // Goober5000
{ "friendly-stealth-visible", OP_FRIENDLY_STEALTH_VISIBLE, 1, INT_MAX }, // Goober5000
{ "ship-targetable-as-bomb", OP_SHIP_BOMB_TARGETABLE, 1, INT_MAX },
{ "ship-untargetable-as-bomb", OP_SHIP_BOMB_UNTARGETABLE, 1, INT_MAX },
{ "ship-subsys-targetable", OP_SHIP_SUBSYS_TARGETABLE, 2, INT_MAX }, // Goober5000
{ "ship-subsys-untargetable", OP_SHIP_SUBSYS_UNTARGETABLE, 2, INT_MAX }, // Goober5000
{ "ship-vaporize", OP_SHIP_VAPORIZE, 1, INT_MAX }, // Goober5000
{ "ship-no-vaporize", OP_SHIP_NO_VAPORIZE, 1, INT_MAX }, // Goober5000
{ "break-warp", OP_WARP_BROKEN, 1, INT_MAX, },
{ "fix-warp", OP_WARP_NOT_BROKEN, 1, INT_MAX, },
{ "never-warp", OP_WARP_NEVER, 1, INT_MAX, },
{ "allow-warp", OP_WARP_ALLOWED, 1, INT_MAX, },
{ "fire-beam", OP_BEAM_FIRE, 3, 4 },
{ "beam-free", OP_BEAM_FREE, 2, INT_MAX },
{ "beam-free-all", OP_BEAM_FREE_ALL, 1, INT_MAX },
{ "beam-lock", OP_BEAM_LOCK, 2, INT_MAX },
{ "beam-lock-all", OP_BEAM_LOCK_ALL, 1, INT_MAX },
{ "turret-free", OP_TURRET_FREE, 2, INT_MAX },
{ "turret-free-all", OP_TURRET_FREE_ALL, 1, INT_MAX },
{ "turret-lock", OP_TURRET_LOCK, 2, INT_MAX },
{ "turret-lock-all", OP_TURRET_LOCK_ALL, 1, INT_MAX },
{ "turret-tagged-only", OP_TURRET_TAGGED_ONLY_ALL, 1, 1 },
{ "turret-tagged-clear", OP_TURRET_TAGGED_CLEAR_ALL, 1, 1 },
{ "turret-tagged-specific", OP_TURRET_TAGGED_SPECIFIC, 2, INT_MAX }, //phreak
{ "turret-tagged-clear-specific", OP_TURRET_TAGGED_CLEAR_SPECIFIC, 2, INT_MAX}, //phreak
{ "turret-change-weapon", OP_TURRET_CHANGE_WEAPON, 5, 5}, //WMC
{ "turret-set-target-order", OP_TURRET_SET_TARGET_ORDER, 2, 2+NUM_TURRET_ORDER_TYPES}, //WMC
{ "ship-turret-target-order", OP_SHIP_TURRET_TARGET_ORDER, 1, 1+NUM_TURRET_ORDER_TYPES}, //WMC
{ "turret-subsys-target-disable", OP_TURRET_SUBSYS_TARGET_DISABLE, 2, INT_MAX },
{ "turret-subsys-target-enable", OP_TURRET_SUBSYS_TARGET_ENABLE, 2, INT_MAX },
{ "red-alert", OP_RED_ALERT, 0, 0 },
{ "end-mission", OP_END_MISSION, 0, 0 }, //-Sesquipedalian
{ "force-jump", OP_FORCE_JUMP, 0, 0 }, // Goober5000
{ "next-mission", OP_NEXT_MISSION, 1, 1 },
{ "end-campaign", OP_END_CAMPAIGN, 0, 0 },
{ "end-of-campaign", OP_END_OF_CAMPAIGN, 0, 0 },
{ "is-nav-visited", OP_NAV_IS_VISITED, 1, 1 }, // Kazan
{ "distance-to-nav", OP_NAV_DISTANCE, 1, 1 }, // Kazan
{ "add-nav-waypoint", OP_NAV_ADD_WAYPOINT, 3, 3 }, //kazan
{ "add-nav-ship", OP_NAV_ADD_SHIP, 2, 2 }, //kazan
{ "del-nav", OP_NAV_DEL, 1, 1 }, //kazan
{ "hide-nav", OP_NAV_HIDE, 1, 1 }, //kazan
{ "restrict-nav", OP_NAV_RESTRICT, 1, 1 }, //kazan
{ "unhide-nav", OP_NAV_UNHIDE, 1, 1 }, //kazan
{ "unrestrict-nav", OP_NAV_UNRESTRICT, 1, 1 }, //kazan
{ "set-nav-visited", OP_NAV_SET_VISITED, 1, 1 }, //kazan
{ "unset-nav-visited", OP_NAV_UNSET_VISITED, 1, 1 }, //kazan
{ "set-nav-carry", OP_NAV_SET_CARRY, 1, INT_MAX }, //kazan
{ "unset-nav-carry", OP_NAV_UNSET_CARRY, 1, INT_MAX }, //kazan
{ "set-nav-needslink", OP_NAV_SET_NEEDSLINK, 1, INT_MAX }, //kazan
{ "unset-nav-needslink", OP_NAV_UNSET_NEEDSLINK, 1, INT_MAX }, //kazan
{ "is-nav-linked", OP_NAV_ISLINKED, 1, 1 }, //kazan
{ "use-nav-cinematics", OP_NAV_USECINEMATICS, 1, 1 }, //kazan
{ "use-autopilot", OP_NAV_USEAP, 1, 1 }, //kazan
{ "grant-promotion", OP_GRANT_PROMOTION, 0, 0, },
{ "grant-medal", OP_GRANT_MEDAL, 1, 1, },
{ "allow-ship", OP_ALLOW_SHIP, 1, 1, },
{ "allow-weapon", OP_ALLOW_WEAPON, 1, 1, },
{ "tech-add-ships", OP_TECH_ADD_SHIP, 1, INT_MAX },
{ "tech-add-weapons", OP_TECH_ADD_WEAPON, 1, INT_MAX },
{ "tech-add-intel", OP_TECH_ADD_INTEL, 1, INT_MAX }, // Goober5000
{ "tech-reset-to-default", OP_TECH_RESET_TO_DEFAULT, 0, 0 }, // Goober5000
{ "change-player-score", OP_CHANGE_PLAYER_SCORE, 2, INT_MAX }, // Karajorma
{ "change-team-score", OP_CHANGE_TEAM_SCORE, 2, 2 }, // Karajorma
{ "don't-collide-invisible", OP_DONT_COLLIDE_INVISIBLE, 1, INT_MAX }, // Goober5000
{ "collide-invisible", OP_COLLIDE_INVISIBLE, 1, INT_MAX }, // Goober5000
{ "change-ship-class", OP_CHANGE_SHIP_CLASS, 2, INT_MAX }, // Goober5000
{ "deactivate-glow-points", OP_DEACTIVATE_GLOW_POINTS, 1, INT_MAX }, //-Bobboau
{ "activate-glow-points", OP_ACTIVATE_GLOW_POINTS, 1, INT_MAX }, //-Bobboau
{ "deactivate-glow-maps", OP_DEACTIVATE_GLOW_MAPS, 1, INT_MAX }, //-Bobboau
{ "activate-glow-maps", OP_ACTIVATE_GLOW_MAPS, 1, INT_MAX }, //-Bobboau
{ "deactivate-glow-point-bank", OP_DEACTIVATE_GLOW_POINT_BANK, 2, INT_MAX }, //-Bobboau
{ "activate-glow-point-bank", OP_ACTIVATE_GLOW_POINT_BANK, 2, INT_MAX }, //-Bobboau
{ "change-soundtrack", OP_CHANGE_SOUNDTRACK, 1, 1 }, // Goober5000
{ "play-sound-from-table", OP_PLAY_SOUND_FROM_TABLE, 4, 4 }, // Goober5000
{ "play-sound-from-file", OP_PLAY_SOUND_FROM_FILE, 1, 2 }, // Goober5000
{ "close-sound-from-file", OP_CLOSE_SOUND_FROM_FILE, 1, 1 }, // Goober5000
{ "modify-variable", OP_MODIFY_VARIABLE, 2, 2, },
{ "add-remove-escort", OP_ADD_REMOVE_ESCORT, 2, 2 },
{ "damaged-escort-priority", OP_DAMAGED_ESCORT_LIST, 3, INT_MAX }, //phreak
{ "damaged-escort-priority-all", OP_DAMAGED_ESCORT_LIST_ALL, 1, MAX_COMPLETE_ESCORT_LIST }, // Goober5000
{ "awacs-set-radius", OP_AWACS_SET_RADIUS, 3, 3 },
{ "primitive-sensors-set-range",OP_PRIMITIVE_SENSORS_SET_RANGE, 2, 2 }, // Goober5000
{ "set-support-ship", OP_SET_SUPPORT_SHIP, 6, 6 }, // Goober5000
{ "cap-waypoint-speed", OP_CAP_WAYPOINT_SPEED, 2, 2 },
{ "special-warpout-name", OP_SET_SPECIAL_WARPOUT_NAME, 2, 2 },
{ "ship-create", OP_SHIP_CREATE, 5, 8 }, //WMC
{ "weapon-create", OP_WEAPON_CREATE, 5, 10 }, // Goober5000
{ "ship-vanish", OP_SHIP_VANISH, 1, INT_MAX },
{ "supernova-start", OP_SUPERNOVA_START, 1, 1 },
{ "shields-on", OP_SHIELDS_ON, 1, INT_MAX }, //-Sesquipedalian
{ "shields-off", OP_SHIELDS_OFF, 1, INT_MAX }, //-Sesquipedalian
{ "ship-tag", OP_SHIP_TAG, 3, 8 }, // Goober5000
{ "ship-untag", OP_SHIP_UNTAG, 1, 1 }, // Goober5000
{ "explosion-effect", OP_EXPLOSION_EFFECT, 11, 13 }, // Goober5000
{ "warp-effect", OP_WARP_EFFECT, 12, 12 }, // Goober5000
{ "ship-change-alt-name", OP_SHIP_CHANGE_ALT_NAME, 2, INT_MAX }, // Goober5000
{ "ship-copy-damage", OP_SHIP_COPY_DAMAGE, 2, INT_MAX }, // Goober5000
{ "set-death-message", OP_SET_DEATH_MESSAGE, 1, 1 }, // Goober5000
{ "set-respawns", OP_SET_RESPAWNS, 2, INT_MAX }, // Karajorma
//background and nebula sexps
{ "mission-set-nebula", OP_MISSION_SET_NEBULA, 1, 1 }, //-Sesquipedalian
{ "add-background-bitmap", OP_ADD_BACKGROUND_BITMAP, 9, 9 }, // phreak
{ "remove-background-bitmap", OP_REMOVE_BACKGROUND_BITMAP, 1, 1 }, // phreak
{ "add-sun-bitmap", OP_ADD_SUN_BITMAP, 6, 6 }, // phreak
{ "remove-sun-bitmap", OP_REMOVE_SUN_BITMAP, 1, 1 }, // phreak
{ "nebula-change-storm", OP_NEBULA_CHANGE_STORM, 1, 1 }, // phreak
{ "nebula-toggle-poof", OP_NEBULA_TOGGLE_POOF, 2, 2 }, // phreak
{ "set-skybox-model", OP_SET_SKYBOX_MODEL, 1, 1 }, // taylor
//HUD funcs -C
{ "hud-disable", OP_HUD_DISABLE, 1, 1 }, // Goober5000
{ "hud-disable-except-messages", OP_HUD_DISABLE_EXCEPT_MESSAGES, 1, 1 }, // Goober5000
{ "hud-set-text", OP_HUD_SET_TEXT, 2, 2 }, //WMCoolmon
{ "hud-set-text-num", OP_HUD_SET_TEXT_NUM, 2, 2 }, //WMCoolmon
{ "hud-set-coords", OP_HUD_SET_COORDS, 3, 3 }, //WMCoolmon
{ "hud-set-frame", OP_HUD_SET_FRAME, 2, 2 }, //WMCoolmon
{ "hud-set-color", OP_HUD_SET_COLOR, 4, 4 }, //WMCoolmon
{ "hud-set-max-targeting-range", OP_HUD_SET_MAX_TARGETING_RANGE, 1, 1 }, // Goober5000
/* made obsolete by Goober5000
{ "error", OP_INT3, 0, 0 },
*/
{ "ai-chase", OP_AI_CHASE, 2, 2, },
{ "ai-chase-wing", OP_AI_CHASE_WING, 2, 2, },
{ "ai-chase-any", OP_AI_CHASE_ANY, 1, 1, },
{ "ai-guard", OP_AI_GUARD, 2, 2, },
{ "ai-guard-wing", OP_AI_GUARD_WING, 2, 2, },
{ "ai-destroy-subsystem", OP_AI_DESTROY_SUBSYS, 3, 3, },
{ "ai-disable-ship", OP_AI_DISABLE_SHIP, 2, 2, },
{ "ai-disarm-ship", OP_AI_DISARM_SHIP, 2, 2, },
{ "ai-warp", OP_AI_WARP, 2, 2, },
{ "ai-warp-out", OP_AI_WARP_OUT, 1, 1, },
{ "ai-dock", OP_AI_DOCK, 4, 4, },
{ "ai-undock", OP_AI_UNDOCK, 1, 2, },
{ "ai-waypoints", OP_AI_WAYPOINTS, 2, 2, },
{ "ai-waypoints-once", OP_AI_WAYPOINTS_ONCE, 2, 2, },
{ "ai-ignore", OP_AI_IGNORE, 2, 2, },
{ "ai-ignore-new", OP_AI_IGNORE_NEW, 2, 2, },
{ "ai-stay-near-ship", OP_AI_STAY_NEAR_SHIP, 2, 2, },
{ "ai-evade-ship", OP_AI_EVADE_SHIP, 2, 2, },
{ "ai-keep-safe-distance", OP_AI_KEEP_SAFE_DISTANCE, 1, 1, },
{ "ai-stay-still", OP_AI_STAY_STILL, 2, 2, },
{ "ai-play-dead", OP_AI_PLAY_DEAD, 1, 1, },
{ "goals", OP_GOALS_ID, 1, INT_MAX, },
{ "key-pressed", OP_KEY_PRESSED, 1, 2, },
{ "key-reset", OP_KEY_RESET, 1, INT_MAX, },
{ "key-reset-multiple", OP_KEY_RESET_MULTIPLE, 1, INT_MAX, },
{ "targeted", OP_TARGETED, 1, 3, },
{ "missile-locked", OP_MISSILE_LOCKED, 1, 3 }, // Sesquipedalian
{ "speed", OP_SPEED, 1, 1, },
{ "facing", OP_FACING, 2, 2, },
{ "facing-waypoint", OP_FACING2, 2, 2, },
{ "order", OP_ORDER, 2, 3, },
{ "query-orders", OP_QUERY_ORDERS, 3, 6, }, // Karajorma
{ "reset-orders", OP_RESET_ORDERS, 0, 0, }, // Karajorma
{ "waypoint-missed", OP_WAYPOINT_MISSED, 0, 0, },
{ "waypoint-twice", OP_WAYPOINT_TWICE, 0, 0, },
{ "path-flown", OP_PATH_FLOWN, 0, 0, },
{ "training-msg", OP_TRAINING_MSG, 1, 4, },
{ "flash-hud-gauge", OP_FLASH_HUD_GAUGE, 1, 1, },
{ "primaries-depleted", OP_PRIMARIES_DEPLETED, 1, 1, },
{ "secondaries-depleted", OP_SECONDARIES_DEPLETED, 1, 1, },
{ "special-check", OP_SPECIAL_CHECK, 1, 1, },
{ "string-to-int", OP_STRING_TO_INT, 1, 1, }, // Karajorma
{ "set-training-context-fly-path", OP_SET_TRAINING_CONTEXT_FLY_PATH, 2, 2, },
{ "set-training-context-speed", OP_SET_TRAINING_CONTEXT_SPEED, 2, 2, },
//Cutscene stuff
{ "set-cutscene-bars", OP_CUTSCENES_SET_CUTSCENE_BARS, 0, 1, },
{ "unset-cutscene-bars", OP_CUTSCENES_UNSET_CUTSCENE_BARS, 0, 1, },
{ "fade-in", OP_CUTSCENES_FADE_IN, 0, 1, },
{ "fade-out", OP_CUTSCENES_FADE_OUT, 0, 2, },
{ "set-camera", OP_CUTSCENES_SET_CAMERA, 0, 1, },
{ "set-camera-facing", OP_CUTSCENES_SET_CAMERA_FACING, 3, 6, },
{ "set-camera-facing-object", OP_CUTSCENES_SET_CAMERA_FACING_OBJECT, 1, 4, },
{ "set-camera-fov", OP_CUTSCENES_SET_CAMERA_FOV, 1, 5, },
{ "set-camera-host", OP_CUTSCENES_SET_CAMERA_HOST, 1, 2, },
{ "set-camera-position", OP_CUTSCENES_SET_CAMERA_POSITION, 3, 6, },
{ "set-camera-rotation", OP_CUTSCENES_SET_CAMERA_ROTATION, 3, 6, },
{ "set-camera-target", OP_CUTSCENES_SET_CAMERA_TARGET, 1, 2, },
{ "set-fov", OP_CUTSCENES_SET_FOV, 1, 1, },
{ "reset-fov", OP_CUTSCENES_RESET_FOV, 0, 0, },
{ "reset-camera", OP_CUTSCENES_RESET_CAMERA, 0, 1, },
{ "show-subtitle", OP_CUTSCENES_SHOW_SUBTITLE, 4, 12, },
{ "set-time-compression", OP_CUTSCENES_SET_TIME_COMPRESSION, 1, 3, },
{ "reset-time-compression", OP_CUTSCENES_RESET_TIME_COMPRESSION, 0, 0, },
{ "lock-perspective", OP_CUTSCENES_FORCE_PERSPECTIVE, 1, 2, },
{ "set-camera-shudder", OP_SET_CAMERA_SHUDDER, 2, 2, },
{ "set-jumpnode-color", OP_JUMP_NODE_SET_JUMPNODE_COLOR, 5, 5, },
{ "set-jumpnode-model", OP_JUMP_NODE_SET_JUMPNODE_MODEL, 3, 3, },
{ "show-jumpnode", OP_JUMP_NODE_SHOW_JUMPNODE, 1, 1, },
{ "hide-jumpnode", OP_JUMP_NODE_HIDE_JUMPNODE, 1, 1, },
{ "script-eval-num", OP_SCRIPT_EVAL_NUM, 1, 1, },
{ "script-eval-string", OP_SCRIPT_EVAL_STRING, 1, 1, },
{ "script-eval", OP_SCRIPT_EVAL, 1, INT_MAX},
{ "do-nothing", OP_NOP, 0, 0, },
};
sexp_ai_goal_link Sexp_ai_goal_links[] = {
{ AI_GOAL_CHASE, OP_AI_CHASE },
{ AI_GOAL_CHASE_WING, OP_AI_CHASE_WING },
{ AI_GOAL_DOCK, OP_AI_DOCK },
{ AI_GOAL_UNDOCK, OP_AI_UNDOCK },
{ AI_GOAL_WARP, OP_AI_WARP_OUT },
{ AI_GOAL_WARP, OP_AI_WARP },
{ AI_GOAL_WAYPOINTS, OP_AI_WAYPOINTS },
{ AI_GOAL_WAYPOINTS_ONCE, OP_AI_WAYPOINTS_ONCE },
{ AI_GOAL_DESTROY_SUBSYSTEM, OP_AI_DESTROY_SUBSYS },
{ AI_GOAL_DISABLE_SHIP, OP_AI_DISABLE_SHIP },
{ AI_GOAL_DISARM_SHIP, OP_AI_DISARM_SHIP },
{ AI_GOAL_GUARD, OP_AI_GUARD },
{ AI_GOAL_CHASE_ANY, OP_AI_CHASE_ANY },
{ AI_GOAL_GUARD_WING, OP_AI_GUARD_WING },
{ AI_GOAL_EVADE_SHIP, OP_AI_EVADE_SHIP },
{ AI_GOAL_STAY_NEAR_SHIP, OP_AI_STAY_NEAR_SHIP },
{ AI_GOAL_KEEP_SAFE_DISTANCE, OP_AI_KEEP_SAFE_DISTANCE },
{ AI_GOAL_IGNORE, OP_AI_IGNORE },
{ AI_GOAL_IGNORE_NEW, OP_AI_IGNORE_NEW },
{ AI_GOAL_STAY_STILL, OP_AI_STAY_STILL },
{ AI_GOAL_PLAY_DEAD, OP_AI_PLAY_DEAD },
};
char *HUD_gauge_text[NUM_HUD_GAUGES] =
{
"LEAD_INDICATOR",
"ORIENTATION_TEE",
"HOSTILE_TRIANGLE",
"TARGET_TRIANGLE",
"MISSION_TIME",
"RETICLE_CIRCLE",
"THROTTLE_GAUGE",
"RADAR",
"TARGET_MONITOR",
"CENTER_RETICLE",
"TARGET_MONITOR_EXTRA_DATA",
"TARGET_SHIELD_ICON",
"PLAYER_SHIELD_ICON",
"ETS_GAUGE",
"AUTO_TARGET",
"AUTO_SPEED",
"WEAPONS_GAUGE",
"ESCORT_VIEW",
"DIRECTIVES_VIEW",
"THREAT_GAUGE",
"AFTERBURNER_ENERGY",
"WEAPONS_ENERGY",
"WEAPON_LINKING_GAUGE",
"TARGER_MINI_ICON",
"OFFSCREEN_INDICATOR",
"TALKING_HEAD",
"DAMAGE_GAUGE",
"MESSAGE_LINES",
"MISSILE_WARNING_ARROW",
"CMEASURE_GAUGE",
"OBJECTIVES_NOTIFY_GAUGE",
"WINGMEN_STATUS",
"OFFSCREEN RANGE",
"KILLS GAUGE",
"ATTACKING TARGET COUNT",
"TEXT FLASH",
"MESSAGE BOX",
"SUPPORT GUAGE",
"LAG GUAGE"
};
void sexp_set_skybox_model_preload(char *name); // taylor
int Directive_count;
int Sexp_useful_number; // a variable to pass useful info in from external modules
int Locked_sexp_true, Locked_sexp_false;
int Num_operators = sizeof(Operators) / sizeof(sexp_oper);
int Num_sexp_ai_goal_links = sizeof(Sexp_ai_goal_links) / sizeof(sexp_ai_goal_link);
int Sexp_build_flag;
int Sexp_clipboard = -1; // used by Fred
int Training_context = 0;
int Training_context_speed_set;
int Training_context_speed_min;
int Training_context_speed_max;
int Training_context_speed_timestamp;
int Training_context_path;
int Training_context_goal_waypoint;
int Training_context_at_waypoint;
float Training_context_distance;
char Sexp_error_text[MAX_SEXP_TEXT];
char *Sexp_string; //[1024] = {0};
// Goober5000 - it's dynamic now
//sexp_node Sexp_nodes[MAX_SEXP_NODES];
#define SEXP_NODE_INCREMENT 250
int Num_sexp_nodes = 0;
sexp_node *Sexp_nodes = NULL;
sexp_variable Sexp_variables[MAX_SEXP_VARIABLES];
std::vector<int> Current_sexp_operator;
int Players_target = UNINITIALIZED;
int Players_mlocked = UNINITIALIZED; // for is-missile-locked - Sesquipedalian
ship_subsys *Players_targeted_subsys;
int Players_target_timestamp;
int Players_mlocked_timestamp;
// for play-music - Goober5000
int Sexp_music_handle = -1;
void sexp_stop_music(int fade = 1);
int get_sexp(char *token);
void build_extended_sexp_string(int cur_node, int level, int mode, int max_len);
void update_sexp_references(char *old_name, char *new_name, int format, int node);
int sexp_determine_team(char *subj);
int extract_sexp_variable_index(int node);
void init_sexp_vars();
int eval_num(int node);
std::vector<char*> Sexp_replacement_arguments;
int Sexp_current_argument_nesting_level;
std::vector<char*> Applicable_arguments_temp;
// Goober5000
arg_item Sexp_applicable_argument_list;
bool is_blank_argument_op(int op_const);
bool is_blank_of_op(int op_const);
//Karajorma
bool is_generic_subsys(char *subsy_name);
bool ship_class_unchanged(int ship_index);
void multi_sexp_modify_variable();
// Goober5000 - arg_item class stuff, borrowed from sexp_list_item class stuff -------------
void arg_item::add_data(char *str)
{
arg_item *item, *ptr;
// create item
item = new arg_item;
item->text = str;
item->nesting_level = Sexp_current_argument_nesting_level;
// prepend item to existing list
ptr = this->next;
this->next = item;
item->next = ptr;
}
arg_item* arg_item::get_next()
{
if (this->next != NULL) {
if (this->next->nesting_level >= Sexp_current_argument_nesting_level) {
return this->next;
}
}
return NULL;
}
void arg_item::expunge()
{
arg_item *ptr;
// contiually delete first item of list
while (this->next != NULL)
{
ptr = this->next->next;
delete this->next;
this->next = ptr;
}
}
void arg_item::clear_nesting_level()
{
arg_item *ptr;
// contiually delete first item of list
while (this->next != NULL && this->next->nesting_level >= Sexp_current_argument_nesting_level )
{
ptr = this->next->next;
delete this->next;
this->next = ptr;
}
}
int arg_item::empty()
{
return (this->next == NULL);
}
//-------------------------------------------------------------------------------------------------
void sexp_nodes_init()
{
if (Num_sexp_nodes == 0 || Sexp_nodes == NULL)
return;
nprintf(("SEXP", "Reinitializing sexp nodes...\n"));
nprintf(("SEXP", "Entered function with %d nodes.\n", Num_sexp_nodes));
// usually, the persistent nodes are grouped at the beginning of the array;
// so we ought to be able to free all the subsequent nodes
int i, last_persistent_node = -1;
for (i = 0; i < Num_sexp_nodes; i++)
{
if (Sexp_nodes[i].type & SEXP_FLAG_PERSISTENT)
last_persistent_node = i; // keep track of it
else
Sexp_nodes[i].type = SEXP_NOT_USED; // it's not needed
}
nprintf(("SEXP", "Last persistent node index is %d.\n", last_persistent_node));
// if all the persistent nodes are gone, free all the nodes
if (last_persistent_node == -1)
{
vm_free(Sexp_nodes);
Sexp_nodes = NULL;
Num_sexp_nodes = 0;
}
// if there's enough of a difference to make it worthwhile, free some nodes
else if (Num_sexp_nodes - (last_persistent_node + 1) > 2 * SEXP_NODE_INCREMENT)
{
// round it up to the next evenly divisible size
Num_sexp_nodes = (last_persistent_node + 1);
Num_sexp_nodes += SEXP_NODE_INCREMENT - (Num_sexp_nodes % SEXP_NODE_INCREMENT);
Sexp_nodes = (sexp_node *) vm_realloc(Sexp_nodes, sizeof(sexp_node) * Num_sexp_nodes);
Verify(Sexp_nodes != NULL);
}
nprintf(("SEXP", "Exited function with %d nodes.\n", Num_sexp_nodes));
}
static void sexp_nodes_close()
{
// free all sexp nodes... should only be done on game shutdown
if (Sexp_nodes != NULL)
{
vm_free(Sexp_nodes);
Sexp_nodes = NULL;
Num_sexp_nodes = 0;
}
}
void init_sexp()
{
// Goober5000
Sexp_replacement_arguments.clear();
Sexp_applicable_argument_list.expunge();
Sexp_current_argument_nesting_level = 0;
initalise_sexp_packet();
static bool done_sexp_atexit = false;
if (!done_sexp_atexit)
{
atexit(sexp_nodes_close);
done_sexp_atexit = true;
}
sexp_nodes_init();
init_sexp_vars();
Locked_sexp_false = Locked_sexp_true = -1;
Locked_sexp_false = alloc_sexp("false", SEXP_LIST, SEXP_ATOM_OPERATOR, -1, -1);
Assert(Locked_sexp_false != -1);
Sexp_nodes[Locked_sexp_false].type = SEXP_ATOM; // fix bypassing value
Sexp_nodes[Locked_sexp_false].value = SEXP_KNOWN_FALSE;
Locked_sexp_true = alloc_sexp("true", SEXP_LIST, SEXP_ATOM_OPERATOR, -1, -1);
Assert(Locked_sexp_true != -1);
Sexp_nodes[Locked_sexp_true].type = SEXP_ATOM; // fix bypassing value
Sexp_nodes[Locked_sexp_true].value = SEXP_KNOWN_TRUE;
}
// allocates an sexp node.
int alloc_sexp(char *text, int type, int subtype, int first, int rest)
{
int node;
int sexp_const = get_operator_const(text);
if ((sexp_const == OP_TRUE) && (type == SEXP_ATOM) && (subtype == SEXP_ATOM_OPERATOR))
return Locked_sexp_true;
else if ((sexp_const == OP_FALSE) && (type == SEXP_ATOM) && (subtype == SEXP_ATOM_OPERATOR))
return Locked_sexp_false;
node = find_free_sexp();
// need more sexp nodes?
if (node == Num_sexp_nodes || node == -1)
{
int old_size = Num_sexp_nodes;
Assert(SEXP_NODE_INCREMENT > 0);
// allocate in blocks of SEXP_NODE_INCREMENT
Num_sexp_nodes += SEXP_NODE_INCREMENT;
Sexp_nodes = (sexp_node *) vm_realloc(Sexp_nodes, sizeof(sexp_node) * Num_sexp_nodes);
Verify(Sexp_nodes != NULL);
nprintf(("SEXP", "Bumping dynamic sexp node limit from %d to %d...\n", old_size, Num_sexp_nodes));
// clear all the new sexp nodes we just allocated
memset(&Sexp_nodes[old_size], 0, sizeof(sexp_node) * SEXP_NODE_INCREMENT);
// our new sexp is the first out of the ones we just created
node = old_size;
}
Assert(node != Locked_sexp_true);
Assert(node != Locked_sexp_false);
Assert(strlen(text) < TOKEN_LENGTH);
Assert(type >= 0);
strcpy(Sexp_nodes[node].text, text);
Sexp_nodes[node].type = type;
Sexp_nodes[node].subtype = subtype;
Sexp_nodes[node].first = first;
Sexp_nodes[node].rest = rest;
Sexp_nodes[node].value = SEXP_UNKNOWN;
Sexp_nodes[node].flags = SNF_DEFAULT_VALUE; // Goober5000
return node;
}
static int Sexp_hwm = 0;
int count_free_sexp_nodes()
{
int i, f = 0, p = 0;
for (i = 0; i < Num_sexp_nodes; i++)
{
if (Sexp_nodes[i].type == SEXP_NOT_USED)
f++;
else if (Sexp_nodes[i].type & SEXP_FLAG_PERSISTENT)
p++;
}
if (Num_sexp_nodes - f > Sexp_hwm)
{
nprintf(("Sexp", "Sexp nodes: Free=%d, Used=%d, Persistent=%d\n", f, Num_sexp_nodes - f, p));
Sexp_hwm = Num_sexp_nodes - f;
}
return f;
}
// find the next free sexp and return its index.
int find_free_sexp()
{
int i;
// sanity
if (Num_sexp_nodes == 0 || Sexp_nodes == NULL)
return -1;
#ifndef NDEBUG
//count_free_sexp_nodes();
#endif
for (i = 0; i < Num_sexp_nodes; i++)
{
if (Sexp_nodes[i].type == SEXP_NOT_USED)
return i;
}
return -1;
}
// sexp_mark_persistent() marks a whole sexp tree with the persistent flag so that it won't
// get re-used between missions
void sexp_mark_persistent(int n)
{
if (n == -1){
return;
}
// total hack because of the true/false locked sexps -- we should make those persistent as well
if ( (n == Locked_sexp_true) || (n == Locked_sexp_false) ){
return;
}
Assert( !(Sexp_nodes[n].type & SEXP_FLAG_PERSISTENT) );
Sexp_nodes[n].type |= SEXP_FLAG_PERSISTENT;
sexp_mark_persistent(Sexp_nodes[n].first);
sexp_mark_persistent(Sexp_nodes[n].rest);
}
// sexp_unmark_persistent() removes the persistent flag from all nodes in the tree
void sexp_unmark_persistent(int n)
{
if (n == -1){
return;
}
if ( (n == Locked_sexp_true) || (n == Locked_sexp_false) ){
return;
}
Assert( Sexp_nodes[n].type & SEXP_FLAG_PERSISTENT );
Sexp_nodes[n].type &= ~SEXP_FLAG_PERSISTENT;
sexp_unmark_persistent(Sexp_nodes[n].first);
sexp_unmark_persistent(Sexp_nodes[n].rest);
}
// just frees up the specified sexp node, Leaves link chains untouched.
int free_one_sexp(int num)
{
Assert((num >= 0) && (num < Num_sexp_nodes));
Assert(Sexp_nodes[num].type != SEXP_NOT_USED); // make sure it is actually used
Assert(!(Sexp_nodes[num].type & SEXP_FLAG_PERSISTENT));
if ((num == Locked_sexp_true) || (num == Locked_sexp_false))
return 0;
Sexp_nodes[num].type = SEXP_NOT_USED;
return 1;
}
// frees a used sexp node, so it can be reused later. Should only be called on
// an atom or a list, and not an operator. If on a list, the list and everything
// in it will be freed (including the operator).
int free_sexp(int num)
{
int i, rest, count = 0;
Assert((num >= 0) && (num < Num_sexp_nodes));
Assert(Sexp_nodes[num].type != SEXP_NOT_USED); // make sure it is actually used
Assert(!(Sexp_nodes[num].type & SEXP_FLAG_PERSISTENT));
if ((num == Locked_sexp_true) || (num == Locked_sexp_false))
return 0;
Sexp_nodes[num].type = SEXP_NOT_USED;
count++;
i = Sexp_nodes[num].first;
while (i != -1)
{
count += free_sexp(i);
i = Sexp_nodes[i].rest;
}
rest = Sexp_nodes[num].rest;
for (i = 0; i < Num_sexp_nodes; i++)
{
if (Sexp_nodes[i].first == num)
Sexp_nodes[i].first = rest;
if (Sexp_nodes[i].rest == num)
Sexp_nodes[i].rest = rest;
}
return count; // total elements freed up.
}
// used to free up an entire sexp tree. Because the root node is an operator, instead of
// a list, we can't simply call free_sexp(). This function should only be called on the
// root node of an sexp, otherwise the linking will get screwed up.
int free_sexp2(int num)
{
int i, count = 0;
if ((num == -1) || (num == Locked_sexp_true) || (num == Locked_sexp_false)){
return 0;
}
i = Sexp_nodes[num].rest;
while (i != -1) {
count += free_sexp(i);
i = Sexp_nodes[i].rest;
}
count += free_sexp(num);
return count;
}
// This function resets the status of all the nodes in a tree, forcing them to all be
// evaulated again.
void flush_sexp_tree(int node)
{
if (node < 0){
return;
}
Sexp_nodes[node].value = SEXP_UNKNOWN;
flush_sexp_tree(Sexp_nodes[node].first);
flush_sexp_tree(Sexp_nodes[node].rest);
}
int verify_sexp_tree(int node)
{
if (node == -1){
return 0;
}
if ((Sexp_nodes[node].type == SEXP_NOT_USED) ||
(Sexp_nodes[node].first == node) ||
(Sexp_nodes[node].rest == node)) {
Error(LOCATION, "Sexp node is corrupt");
return -1;
}
if (Sexp_nodes[node].first != -1){
verify_sexp_tree(Sexp_nodes[node].first);
}
if (Sexp_nodes[node].rest != -1){
verify_sexp_tree(Sexp_nodes[node].rest);
}
return 0;
}
int dup_sexp_chain(int node)
{
int cur, first, rest;
if (node == -1){
return -1;
}
// TODO - CASE OF SEXP VARIABLES - ONLY 1 COPY OF VARIABLE
first = dup_sexp_chain(Sexp_nodes[node].first);
rest = dup_sexp_chain(Sexp_nodes[node].rest);
cur = alloc_sexp(Sexp_nodes[node].text, Sexp_nodes[node].type, Sexp_nodes[node].subtype, first, rest);
if (cur == -1) {
if (first != -1){
free_sexp(first);
}
if (rest != -1){
free_sexp(rest);
}
}
return cur;
}
// returns 1 if they are the same, 0 if different
int cmp_sexp_chains(int node1, int node2)
{
if ((node1 == -1) && (node2 == -1)){
return 1;
}
if ((node1 == -1) || (node2 == -1)){
return 0;
}
// DA: 1/7/99 Need to check the actual Sexp_node.text, not possible variable, which can be equal
if (stricmp(Sexp_nodes[node1].text, Sexp_nodes[node2].text)){
return 0;
}
if (!cmp_sexp_chains(Sexp_nodes[node1].first, Sexp_nodes[node2].first)){
return 0;
}
if (!cmp_sexp_chains(Sexp_nodes[node1].rest, Sexp_nodes[node2].rest)){
return 0;
}
return 1;
}
// determine if an sexp node is within the given sexp chain.
int query_node_in_sexp(int node, int sexp)
{
if (sexp == -1){
return 0;
}
if (node == sexp){
return 1;
}
if (query_node_in_sexp(node, Sexp_nodes[sexp].first)){
return 1;
}
if (query_node_in_sexp(node, Sexp_nodes[sexp].rest)){
return 1;
}
return 0;
}
// find the index of the list associated with an operator
int find_sexp_list(int num)
{
int i;
for (i = 0; i < Num_sexp_nodes; i++)
{
if (Sexp_nodes[i].first == num)
return i;
}
// assume that it was the first item in the list
return num;
}
// find node of operator that item is an argument of.
int find_parent_operator(int node)
{
int i;
int n = node;
Assert((node >= 0) && (node < Num_sexp_nodes));
if (Sexp_nodes[n].subtype == SEXP_ATOM_OPERATOR)
n = find_sexp_list(n);
Assert( (n >= 0) && (n < Num_sexp_nodes) );
while (Sexp_nodes[n].subtype != SEXP_ATOM_OPERATOR)
{
for (i = 0; i < Num_sexp_nodes; i++)
{
if (Sexp_nodes[i].rest == n)
break;
}
if (i == Num_sexp_nodes)
return -1; // not found, probably at top node already.
n = i;
}
return n;
}
// function to determine if an sexpression node is the top level node of an sexpression tree. Top
// level nodes do not have their node id in anyone elses first or rest index
int is_sexp_top_level( int node )
{
int i;
Assert((node >= 0) && (node < Num_sexp_nodes));
if (Sexp_nodes[node].type == SEXP_NOT_USED)
return 0;
for (i = 0; i < Num_sexp_nodes; i++)
{
if ((Sexp_nodes[i].type == SEXP_NOT_USED) || (i == node )) // don't check myself or unused nodes
continue;
if ((Sexp_nodes[i].first == node) || (Sexp_nodes[i].rest == node))
return 0;
}
return 1;
}
// Goober5000
int find_argnum(int parent, int arg)
{
int n, tally;
n = CDR(parent);
tally = 0;
while (CAR(n) != arg)
{
if (n == -1)
return -1;
tally++;
n = CDR(n);
}
return tally;
}
// from an operator name, return its index in the array Operators
int get_operator_index(char *token)
{
int i;
for (i=0; i<Num_operators; i++){
if (!stricmp(token, Operators[i].text)){
return i;
}
}
return -1;
}
// from an operator name, return its constant (the number it was #define'd with)
int get_operator_const(char *token)
{
int idx = get_operator_index(token);
if (idx == -1)
return 0;
return Operators[idx].value;
}
int query_sexp_args_count(int node, bool only_valid_args = false)
{
int count = 0;
int n = CDR(node);
for ( ; n != -1; n = CDR(n))
{
if (only_valid_args && !(Sexp_nodes[n].flags & SNF_ARGUMENT_VALID))
continue;
count++;
}
return count;
}
// returns 0 if ok, negative if there's an error in expression..
// See the returns types in sexp.h
int check_sexp_syntax(int node, int return_type, int recursive, int *bad_node, int mode)
{
int i = 0, z, t, type, argnum = 0, count, op, type2 = 0, op2;
int op_node;
int var_index = -1;
Assert(node >= 0 && node < Num_sexp_nodes);
Assert(Sexp_nodes[node].type != SEXP_NOT_USED);
if (Sexp_nodes[node].subtype == SEXP_ATOM_NUMBER && return_type == OPR_BOOL) {
// special case Mark seems to want supported
Assert(Sexp_nodes[node].first == -1); // only lists should have a first pointer
if (Sexp_nodes[node].rest != -1) // anything after the number?
return SEXP_CHECK_NONOP_ARGS; // if so, it's a syntax error
return 0;
}
op_node = node; // save the node of the operator since we need to get to other args.
if (bad_node)
*bad_node = op_node;
if (Sexp_nodes[op_node].subtype != SEXP_ATOM_OPERATOR)
return SEXP_CHECK_OP_EXPECTED; // not an operator, which it should always be
op = get_operator_index(CTEXT(op_node));
if (op == -1)
return SEXP_CHECK_UNKNOWN_OP; // unrecognized operator
// check that types match - except that OPR_AMBIGUOUS matches everything
if (return_type != OPR_AMBIGUOUS)
{
// get the return type of the next thing
z = query_operator_return_type(op);
if (z == OPR_POSITIVE && return_type == OPR_NUMBER)
{
// positive data type can map to number data type just fine
}
// Goober5000's number hack
else if (z == OPR_NUMBER && return_type == OPR_POSITIVE)
{
// this isn't kosher, but we hack it to make it work
}
else if (z != return_type)
{
// anything else is a mismatch
return SEXP_CHECK_TYPE_MISMATCH;
}
}
count = query_sexp_args_count(op_node);
if (count < Operators[op].min || count > Operators[op].max)
return SEXP_CHECK_BAD_ARG_COUNT; // incorrect number of arguments
// Goober5000 - if this is a list of stuff that has the special argument as
// an item in the list, assume it's valid
if (special_argument_appears_in_sexp_list(op_node))
return 0;
node = Sexp_nodes[op_node].rest;
while (node != -1) {
type = query_operator_argument_type(op, argnum);
Assert(Sexp_nodes[node].type != SEXP_NOT_USED);
if (bad_node)
*bad_node = node;
if (Sexp_nodes[node].subtype == SEXP_ATOM_LIST) {
i = Sexp_nodes[node].first;
if (bad_node)
*bad_node = i;
// be sure to check to see if this node is a list of stuff and not an actual operator type
// thing. (i.e. in the case of a cond statement, the conditional will fall into this if
// statement. MORE TO DO HERE!!!!
if (Sexp_nodes[i].subtype == SEXP_ATOM_LIST)
return 0;
op2 = get_operator_index(CTEXT(i));
if (op2 == -1)
return SEXP_CHECK_UNKNOWN_OP;
type2 = query_operator_return_type(op2);
if (recursive) {
switch (type) {
case OPF_NUMBER:
t = OPR_NUMBER;
break;
case OPF_POSITIVE:
t = OPR_POSITIVE;
break;
case OPF_BOOL:
t = OPR_BOOL;
break;
case OPF_NULL:
t = OPR_NULL;
break;
// Goober5000
case OPF_FLEXIBLE_ARGUMENT:
t = OPR_FLEXIBLE_ARGUMENT;
break;
case OPF_AI_GOAL:
t = OPR_AI_GOAL;
break;
// special case for modify-variable
case OPF_AMBIGUOUS:
t = OPR_AMBIGUOUS;
break;
default:
return SEXP_CHECK_UNKNOWN_TYPE; // no other return types available
}
if ((z = check_sexp_syntax(i, t, recursive, bad_node)) != 0) {
return z;
}
}
} else if (Sexp_nodes[node].subtype == SEXP_ATOM_NUMBER) {
char *ptr;
type2 = OPR_POSITIVE;
ptr = CTEXT(node);
if (*ptr == '-') {
type2 = OPR_NUMBER;
ptr++;
}
if (type == OPF_BOOL) // allow numbers to be used where boolean is required.
type2 = OPR_BOOL;
while (*ptr) {
if (!isdigit(*ptr))
return SEXP_CHECK_INVALID_NUM; // not a valid number
ptr++;
}
i = atoi(CTEXT(node));
z = get_operator_const(CTEXT(op_node));
if ( (z == OP_HAS_DOCKED_DELAY) || (z == OP_HAS_UNDOCKED_DELAY) )
if ( (argnum == 2) && (i < 1) )
return SEXP_CHECK_NUM_RANGE_INVALID;
z = get_operator_index(CTEXT(op_node));
if ( (query_operator_return_type(z) == OPR_AI_GOAL) && (argnum == Operators[op].min - 1) )
if ( (i < 0) || (i > 200) )
return SEXP_CHECK_NUM_RANGE_INVALID;
} else if (Sexp_nodes[node].subtype == SEXP_ATOM_STRING) {
type2 = SEXP_ATOM_STRING;
} else {
Assert(0);
}
// variables should only be typechecked.
if ((Sexp_nodes[node].type & SEXP_FLAG_VARIABLE) && (type != OPF_VARIABLE_NAME)) {
var_index = get_index_sexp_variable_from_node(node);
Assert(var_index != -1);
switch (type) {
case OPF_NUMBER:
case OPF_POSITIVE:
if (!(Sexp_variables[var_index].type & SEXP_VARIABLE_NUMBER))
return SEXP_CHECK_INVALID_VARIABLE_TYPE;
break;
case OPF_AMBIGUOUS:
break;
default:
if (!(Sexp_variables[var_index].type & SEXP_VARIABLE_STRING))
return SEXP_CHECK_INVALID_VARIABLE_TYPE;
}
node = Sexp_nodes[node].rest;
argnum++;
continue;
}
switch (type) {
case OPF_NAV_POINT:
if (type2 != SEXP_ATOM_STRING){
return SEXP_CHECK_TYPE_MISMATCH;
}
break;
case OPF_NUMBER:
if ((type2 != OPR_NUMBER) && (type2 != OPR_POSITIVE)){
return SEXP_CHECK_TYPE_MISMATCH;
}
break;
case OPF_POSITIVE:
if (type2 == OPR_NUMBER){
// Goober5000's number hack
break;
// return SEXP_CHECK_NEGATIVE_NUM;
}
if (type2 != OPR_POSITIVE){
return SEXP_CHECK_TYPE_MISMATCH;
}
break;
case OPF_SHIP_NOT_PLAYER:
if (type2 != SEXP_ATOM_STRING){
return SEXP_CHECK_TYPE_MISMATCH;
}
if (ship_name_lookup(CTEXT(node), 0) < 0)
{
if (Fred_running || !mission_parse_get_arrival_ship(CTEXT(node)))
{
return SEXP_CHECK_INVALID_SHIP;
}
}
break;
case OPF_SHIP_OR_NONE:
if (type2 != SEXP_ATOM_STRING)
{
return SEXP_CHECK_TYPE_MISMATCH;
}
if (stricmp(CTEXT(node), SEXP_NONE_STRING)) // none is okay
{
if (ship_name_lookup(CTEXT(node), 1) < 0)
{
if (Fred_running || !mission_parse_get_arrival_ship(CTEXT(node)))
{
return SEXP_CHECK_INVALID_SHIP;
}
}
}
break;
case OPF_SHIP:
case OPF_SHIP_POINT:
if (type2 != SEXP_ATOM_STRING){
return SEXP_CHECK_TYPE_MISMATCH;
}
if (ship_name_lookup(CTEXT(node), 1) < 0) {
if (Fred_running || !mission_parse_get_arrival_ship(CTEXT(node)))
{
if (type == OPF_SHIP)
{ // return invalid ship if not also looking for point
return SEXP_CHECK_INVALID_SHIP;
}
if (waypoint_lookup(CTEXT(node)) < 0)
{
if (verify_vector(CTEXT(node))) // verify return non-zero on invalid point
{
return SEXP_CHECK_INVALID_POINT;
}
}
}
}
break;
case OPF_WING:
if (type2 != SEXP_ATOM_STRING){
return SEXP_CHECK_TYPE_MISMATCH;
}
if (wing_name_lookup(CTEXT(node), 1) < 0){
return SEXP_CHECK_INVALID_WING;
}
break;
case OPF_SHIP_WING:
case OPF_SHIP_WING_POINT:
case OPF_SHIP_WING_POINT_OR_NONE:
case OPF_ORDER_RECIPIENT:
if ( type2 != SEXP_ATOM_STRING ){
return SEXP_CHECK_TYPE_MISMATCH;
}
if (type == OPF_ORDER_RECIPIENT) {
if (!strcmp ("<all fighters>", CTEXT(node))) {
break;
}
}
// none is okay for _or_none
if (type == OPF_SHIP_WING_POINT_OR_NONE && !stricmp(CTEXT(node), SEXP_NONE_STRING))
{
break;
}
if ((ship_name_lookup(CTEXT(node), 1) < 0) && (wing_name_lookup(CTEXT(node), 1) < 0)) {
if (Fred_running || !mission_parse_get_arrival_ship(CTEXT(node)))
{
if (type != OPF_SHIP_WING_POINT){ // return invalid if not also looking for point
return SEXP_CHECK_INVALID_SHIP_WING;
}
if (waypoint_lookup(CTEXT(node)) < 0){
if (verify_vector(CTEXT(node))){ // non-zero on verify vector mean invalid!
if (sexp_determine_team(CTEXT(node)) < 0){
return SEXP_CHECK_INVALID_POINT;
}
}
}
}
}
break;
case OPF_AWACS_SUBSYSTEM:
case OPF_ROTATING_SUBSYSTEM:
case OPF_SUBSYSTEM:
case OPF_SUBSYSTEM_OR_NONE:
case OPF_SUBSYS_OR_GENERIC:
{
char *shipname;
int shipnum,ship_class;
int ship_index;
if (type2 != SEXP_ATOM_STRING){
return SEXP_CHECK_TYPE_MISMATCH;
}
// none is okay for subsys_or_none
if (type == OPF_SUBSYSTEM_OR_NONE && !stricmp(CTEXT(node), SEXP_NONE_STRING))
{
break;
}
// subsys_or_generic has a few extra options it accepts
if (type == OPF_SUBSYS_OR_GENERIC && (!(stricmp(CTEXT(node), SEXP_ALL_ENGINES_STRING)) || !(stricmp(CTEXT(node), SEXP_ALL_TURRETS_STRING)) )) {
break;
}
// we must get the model of the ship that is part of this sexpression and find a subsystem
// with that name. This code assumes by default that the ship is *always* the first name
// in the sexpression. If this is ever not the case, the code here must be changed to
// get the correct ship name.
switch(get_operator_const(CTEXT(op_node)))
{
case OP_CAP_SUBSYS_CARGO_KNOWN_DELAY:
case OP_DISTANCE_SUBSYSTEM:
case OP_SET_CARGO:
case OP_IS_CARGO:
case OP_CHANGE_AI_CLASS:
case OP_IS_AI_CLASS:
case OP_MISSILE_LOCKED:
case OP_SHIP_SUBSYS_GUARDIAN_THRESHOLD:
ship_index = CDR(CDR(op_node));
break;
case OP_BEAM_FIRE:
if(argnum == 1){
ship_index = CDR(op_node);
} else {
ship_index = CDR(CDR(CDR(op_node)));
}
break;
case OP_QUERY_ORDERS:
ship_index = CDR(CDR(CDR(CDR(op_node))));
break;
case OP_WEAPON_CREATE:
ship_index = CDDDDDR(CDDDDR(op_node));
break;
default :
ship_index = CDR(op_node);
break;
}
shipname = CTEXT(ship_index);
shipnum = ship_name_lookup(shipname, 1);
if (shipnum >= 0)
{
ship_class = Ships[shipnum].ship_info_index;
}
else
{
// must try to find the ship in the arrival list
p_object *p_objp = mission_parse_get_arrival_ship(shipname);
if (!p_objp)
{
if (type == OPF_SUBSYSTEM_OR_NONE)
break;
else
return SEXP_CHECK_INVALID_SHIP;
}
ship_class = p_objp->ship_class;
}
// check for the special "hull" value
if ( (Operators[op].value == OP_SABOTAGE_SUBSYSTEM) || (Operators[op].value == OP_REPAIR_SUBSYSTEM) || (Operators[op].value == OP_SET_SUBSYSTEM_STRNGTH) ) {
if ( !stricmp( CTEXT(node), SEXP_HULL_STRING) || !stricmp( CTEXT(node), SEXP_SIM_HULL_STRING) ){
break;
}
}
for (i=0; i<Ship_info[ship_class].n_subsystems; i++)
{
if (!subsystem_stricmp(Ship_info[ship_class].subsystems[i].subobj_name, CTEXT(node)))
{
break;
}
}
if (i == Ship_info[ship_class].n_subsystems)
{
return SEXP_CHECK_INVALID_SUBSYS;
}
// if we're checking for an AWACS subsystem and this is not an awacs subsystem
if(Fred_running)
{
if((type == OPF_AWACS_SUBSYSTEM) && !(Ship_info[ship_class].subsystems[i].flags & MSS_FLAG_AWACS))
{
return SEXP_CHECK_INVALID_SUBSYS;
}
}
// rotating subsystem, like above - Goober5000
if (Fred_running)
{
if ((type == OPF_ROTATING_SUBSYSTEM) && !(Ship_info[ship_class].subsystems[i].flags & MSS_FLAG_ROTATES))
{
return SEXP_CHECK_INVALID_SUBSYS;
}
}
break;
}
return SEXP_CHECK_UNKNOWN_ERROR; // just in case of something going wrong - it won't trickle down
case OPF_POINT:
if (type2 != SEXP_ATOM_STRING)
{
return SEXP_CHECK_TYPE_MISMATCH;
}
if (waypoint_lookup(CTEXT(node)) < 0)
{
if (verify_vector(CTEXT(node)))
{
return SEXP_CHECK_INVALID_POINT;
}
}
break;
case OPF_IFF:
if (type2 != SEXP_ATOM_STRING)
{
return SEXP_CHECK_TYPE_MISMATCH;
}
if (iff_lookup(CTEXT(node)) < 0)
{
return SEXP_CHECK_INVALID_IFF;
}
break;
case OPF_AI_CLASS:
if (type2 != SEXP_ATOM_STRING)
{
return SEXP_CHECK_TYPE_MISMATCH;
}
for (i=0; i<Num_ai_classes; i++)
{
if (!stricmp(Ai_class_names[i], CTEXT(node)))
{
break;
}
}
if (i == Num_ai_classes)
{
return SEXP_CHECK_INVALID_AI_CLASS;
}
break;
case OPF_ARRIVAL_LOCATION:
if (type2 != SEXP_ATOM_STRING)
{
return SEXP_CHECK_TYPE_MISMATCH;
}
for (i=0; i<MAX_ARRIVAL_NAMES; i++)
{
if (!stricmp(Arrival_location_names[i], CTEXT(node)))
{
break;
}
}
if (i == MAX_ARRIVAL_NAMES)
{
return SEXP_CHECK_INVALID_ARRIVAL_LOCATION;
}
break;
case OPF_DEPARTURE_LOCATION:
if (type2 != SEXP_ATOM_STRING)
{
return SEXP_CHECK_TYPE_MISMATCH;
}
for (i=0; i<MAX_DEPARTURE_NAMES; i++)
{
if (!stricmp(Departure_location_names[i], CTEXT(node)))
{
break;
}
}
if (i == MAX_DEPARTURE_NAMES)
{
return SEXP_CHECK_INVALID_DEPARTURE_LOCATION;
}
break;
case OPF_ARRIVAL_ANCHOR_ALL:
if (type2 != SEXP_ATOM_STRING)
{
return SEXP_CHECK_TYPE_MISMATCH;
}
else
{
int get_special_anchor(char *name);
int valid = 0;
// <any friendly>, etc.
if (get_special_anchor(CTEXT(node)) >= 0)
{
valid = 1;
}
if (ship_name_lookup(CTEXT(node), 1) >= 0)
{
valid = 1;
}
if (!Fred_running && mission_parse_get_arrival_ship(CTEXT(node)))
{
valid = 1;
}
if (!valid)
{
return SEXP_CHECK_INVALID_ARRIVAL_ANCHOR_ALL;
}
}
break;
case OPF_SOUNDTRACK_NAME:
if (type2 != SEXP_ATOM_STRING){
return SEXP_CHECK_TYPE_MISMATCH;
}
if (!stricmp(CTEXT(node), "<No Music>"))
break;
if (Cmdline_freespace_no_music)
break;
for (i=0; i<Num_soundtracks; i++)
{
if (!stricmp(CTEXT(node), Soundtracks[i].name))
{
break;
}
}
if (i == Num_soundtracks)
return SEXP_CHECK_INVALID_SOUNDTRACK_NAME;
break;
case OPF_SHIP_WITH_BAY:
{
char *name = CTEXT(node);
p_object *p_objp;
int shipnum = -1;
if (type2 != SEXP_ATOM_STRING)
return SEXP_CHECK_TYPE_MISMATCH;
if (!stricmp(name, "<no anchor>"))
break;
shipnum = ship_name_lookup(name, 1);
if (shipnum < 0)
{
if (Fred_running)
return SEXP_CHECK_INVALID_SHIP;
p_objp = mission_parse_get_arrival_ship(name);
if (p_objp == NULL)
return SEXP_CHECK_INVALID_SHIP;
}
// ship exists at this point
// Goober5000 - since we can't check POFs for ships which haven't arrived
// (not without a bit of work anyway), just assume they're okay
if (shipnum < 0)
break;
// now determine if this ship has a docking bay
if (!ship_has_dock_bay(shipnum))
return SEXP_CHECK_INVALID_SHIP_WITH_BAY;
break;
}
case OPF_SUPPORT_SHIP_CLASS:
if (type2 != SEXP_ATOM_STRING){
return SEXP_CHECK_TYPE_MISMATCH;
}
if (!stricmp(CTEXT(node), "<any support ship class>"))
break;
for (i = 0; i < Num_ship_classes; i++ ) {
if ( !stricmp(CTEXT(node), Ship_info[i].name) )
{
if (Ship_info[i].flags & SIF_SUPPORT)
{
break;
}
}
}
if ( i == Num_ship_classes )
return SEXP_CHECK_INVALID_SUPPORT_SHIP_CLASS;
break;
case OPF_BOOL:
if (type2 != OPR_BOOL){
return SEXP_CHECK_TYPE_MISMATCH;
}
break;
case OPF_AI_ORDER:
if ( type2 != SEXP_ATOM_STRING ){
return SEXP_CHECK_TYPE_MISMATCH;
}
break;
case OPF_NULL:
if (type2 != OPR_NULL){
return SEXP_CHECK_TYPE_MISMATCH;
}
break;
// Goober5000
case OPF_FLEXIBLE_ARGUMENT:
if (type2 != OPR_FLEXIBLE_ARGUMENT) {
return SEXP_CHECK_TYPE_MISMATCH;
}
break;
// Goober5000
case OPF_ANYTHING:
break;
case OPF_AI_GOAL:
if (type2 != OPR_AI_GOAL){
return SEXP_CHECK_TYPE_MISMATCH;
}
if (Fred_running) {
int ship_num, ship2, w = 0;
// if it's the "goals" operator, this is part of initial orders, so just assume it's okay
if (get_operator_const(Sexp_nodes[op_node].text) == OP_GOALS_ID) {
break;
}
ship_num = ship_name_lookup(CTEXT(Sexp_nodes[op_node].rest), 1); // Goober5000 - include players
if (ship_num < 0) {
w = wing_name_lookup(CTEXT(Sexp_nodes[op_node].rest));
if (w < 0) {
if (bad_node){
*bad_node = Sexp_nodes[op_node].rest;
}
return SEXP_CHECK_INVALID_SHIP; // should have already been caught earlier, but just in case..
}
}
Assert(Sexp_nodes[node].subtype == SEXP_ATOM_LIST);
z = Sexp_nodes[node].first;
Assert(Sexp_nodes[z].subtype != SEXP_ATOM_LIST);
z = get_operator_const(CTEXT(z));
if (ship_num >= 0) {
if (!query_sexp_ai_goal_valid(z, ship_num)){
return SEXP_CHECK_ORDER_NOT_ALLOWED;
}
} else {
for (i=0; i<Wings[w].wave_count; i++){
if (!query_sexp_ai_goal_valid(z, Wings[w].ship_index[i])){
return SEXP_CHECK_ORDER_NOT_ALLOWED;
}
}
}
if ((z == OP_AI_DOCK) && (Sexp_nodes[node].rest >= 0)) {
ship2 = ship_name_lookup(CTEXT(Sexp_nodes[node].rest), 1); // Goober5000 - include players
if ((ship_num < 0) || !ship_docking_valid(ship_num, ship2)){
return SEXP_CHECK_DOCKING_NOT_ALLOWED;
}
}
}
// we should check the syntax of the actual goal!!!!
z = Sexp_nodes[node].first;
if ((z = check_sexp_syntax(z, OPR_AI_GOAL, recursive, bad_node)) != 0){
return z;
}
break;
case OPF_SHIP_TYPE:
if (type2 != SEXP_ATOM_STRING){
return SEXP_CHECK_TYPE_MISMATCH;
}
i = ship_type_name_lookup(CTEXT(node));
if (i < 0){
return SEXP_CHECK_INVALID_SHIP_TYPE;
}
break;
case OPF_WAYPOINT_PATH:
for (i=0; i<Num_waypoint_lists; i++){
if (!stricmp(Waypoint_lists[i].name, CTEXT(node))){
break;
}
}
if (i == Num_waypoint_lists){
return SEXP_CHECK_TYPE_MISMATCH;
}
break;
case OPF_MESSAGE:
// code commented out because of order reversing of arguments to messaging code. Maybe
// I'll comment it back in someday when older missions get fixed.
if (type2 != SEXP_ATOM_STRING)
return SEXP_CHECK_TYPE_MISMATCH;
if (Fred_running) {
for (i=0; i<Num_messages; i++)
if (!stricmp(Messages[i].name, CTEXT(node)))
break;
if (i == Num_messages)
return SEXP_CHECK_UNKNOWN_MESSAGE;
}
break;
case OPF_PRIORITY: {
// following code must be removed since I changed the order of the operators in the send-message
// function to take priority second. Maybe someday, I'll require that all designers fix the
// old missions.
if (type2 != SEXP_ATOM_STRING)
return SEXP_CHECK_TYPE_MISMATCH;
if (Fred_running) { // should still check in Fred though..
char *name;
name = CTEXT(node);
if (!stricmp(name, "low") || !stricmp(name, "normal") || !stricmp(name, "high"))
break;
return SEXP_CHECK_INVALID_PRIORITY;
}
break;
}
case OPF_MISSION_NAME:
if (type2 != SEXP_ATOM_STRING)
return SEXP_CHECK_TYPE_MISMATCH;
if (Fred_running) {
if (mode == SEXP_MODE_CAMPAIGN) {
for (i=0; i<Campaign.num_missions; i++)
if (!stricmp(CTEXT(node), Campaign.missions[i].name)) {
if ((i != Sexp_useful_number) && (Campaign.missions[i].level >= Campaign.missions[Sexp_useful_number].level))
return SEXP_CHECK_INVALID_LEVEL;
break;
}
if (i == Campaign.num_missions)
return SEXP_CHECK_INVALID_MISSION_NAME;
} else {
// mwa -- put the following if statement to prevent Fred errors for possibly valid
// conditions. We should do something else here!!!
if ( (Operators[op].value == OP_PREVIOUS_EVENT_TRUE) || (Operators[op].value == OP_PREVIOUS_EVENT_FALSE) || (Operators[op].value == OP_PREVIOUS_EVENT_INCOMPLETE)
|| (Operators[op].value == OP_PREVIOUS_GOAL_TRUE) || (Operators[op].value == OP_PREVIOUS_GOAL_FALSE) || (Operators[op].value == OP_PREVIOUS_GOAL_INCOMPLETE) )
break;
if (!(*Mission_filename) || stricmp(Mission_filename, CTEXT(node)))
return SEXP_CHECK_INVALID_MISSION_NAME;
}
}
break;
case OPF_GOAL_NAME:
if (type2 != SEXP_ATOM_STRING)
return SEXP_CHECK_TYPE_MISMATCH;
// we only need to check the campaign list if running in Fred and are in campaign mode.
// otherwise, check the set of current goals
if ( Fred_running && (mode == SEXP_MODE_CAMPAIGN) ) {
z = find_parent_operator(node);
Assert(z >= 0);
z = Sexp_nodes[z].rest; // first argument of operator should be mission name
Assert(z >= 0);
for (i=0; i<Campaign.num_missions; i++)
if (!stricmp(CTEXT(z), Campaign.missions[i].name))
break;
// read the goal/event list from the mission file if both num_goals and num_events
// are < 0
if ((Campaign.missions[i].num_goals <= 0) && (Campaign.missions[i].num_events <= 0) )
read_mission_goal_list(i);
if (i < Campaign.num_missions) {
for (t=0; t<Campaign.missions[i].num_goals; t++)
if (!stricmp(CTEXT(node), Campaign.missions[i].goals[t].name))
break;
if (t == Campaign.missions[i].num_goals)
return SEXP_CHECK_INVALID_GOAL_NAME;
}
} else {
// MWA -- short circuit evaluation of these things for now.
if ( (Operators[op].value == OP_PREVIOUS_GOAL_TRUE) || (Operators[op].value == OP_PREVIOUS_GOAL_FALSE) || (Operators[op].value == OP_PREVIOUS_GOAL_INCOMPLETE) )
break;
for (i=0; i<Num_goals; i++)
if (!stricmp(CTEXT(node), Mission_goals[i].name))
break;
if (i == Num_goals)
return SEXP_CHECK_INVALID_GOAL_NAME;
}
break;
case OPF_EVENT_NAME:
if ( type2 != SEXP_ATOM_STRING )
return SEXP_CHECK_TYPE_MISMATCH;
// like above checking for goals, check events in the campaign only if in Fred
// and only if in campaign mode. Otherwise, check the current set of events
if ( Fred_running && (mode == SEXP_MODE_CAMPAIGN) ) {
z = find_parent_operator(node);
Assert(z >= 0);
z = Sexp_nodes[z].rest; // first argument of operator should be mission name
Assert(z >= 0);
for (i=0; i<Campaign.num_missions; i++)
if (!stricmp(CTEXT(z), Campaign.missions[i].name))
break;
// read the goal/event list from the mission file if both num_goals and num_events
// are < 0
if ((Campaign.missions[i].num_goals <= 0) && (Campaign.missions[i].num_events <= 0) )
read_mission_goal_list(i);
if (i < Campaign.num_missions) {
for (t=0; t<Campaign.missions[i].num_events; t++)
if (!stricmp(CTEXT(node), Campaign.missions[i].events[t].name))
break;
if (t == Campaign.missions[i].num_events)
return SEXP_CHECK_INVALID_EVENT_NAME;
}
} else {
// MWA -- short circuit evaluation of these things for now.
if ( (Operators[op].value == OP_PREVIOUS_EVENT_TRUE) || (Operators[op].value == OP_PREVIOUS_EVENT_FALSE) || (Operators[op].value == OP_PREVIOUS_EVENT_INCOMPLETE) )
break;
for ( i = 0; i < Num_mission_events; i++ ) {
if ( !stricmp(CTEXT(node), Mission_events[i].name) )
break;
}
if ( i == Num_mission_events )
return SEXP_CHECK_INVALID_EVENT_NAME;
}
break;
case OPF_DOCKER_POINT:
if (type2 != SEXP_ATOM_STRING)
return SEXP_CHECK_TYPE_MISMATCH;
if (Fred_running) {
int ship_num, model;
z = find_parent_operator(op_node);
// if it's the "goals" operator, this is part of initial orders, so just assume it's okay
if (get_operator_const(Sexp_nodes[z].text) == OP_GOALS_ID) {
break;
}
// look for the ship this goal is being assigned to
ship_num = ship_name_lookup(CTEXT(Sexp_nodes[z].rest), 1);
if (ship_num < 0) {
if (bad_node)
*bad_node = Sexp_nodes[z].rest;
return SEXP_CHECK_INVALID_SHIP; // should have already been caught earlier, but just in case..
}
model = Ship_info[Ships[ship_num].ship_info_index].model_num;
z = model_get_num_dock_points(model);
for (i=0; i<z; i++)
if (!stricmp(CTEXT(node), model_get_dock_name(model, i)))
break;
if (i == z)
return SEXP_CHECK_INVALID_DOCKER_POINT;
}
break;
case OPF_DOCKEE_POINT:
if (type2 != SEXP_ATOM_STRING)
return SEXP_CHECK_TYPE_MISMATCH;
if (Fred_running) {
int ship_num, model;
ship_num = ship_name_lookup(CTEXT(Sexp_nodes[op_node].rest), 1);
if (ship_num < 0) {
if (bad_node)
*bad_node = Sexp_nodes[op_node].rest;
return SEXP_CHECK_INVALID_SHIP; // should have already been caught earlier, but just in case..
}
model = Ship_info[Ships[ship_num].ship_info_index].model_num;
z = model_get_num_dock_points(model);
for (i=0; i<z; i++)
if (!stricmp(CTEXT(node), model_get_dock_name(model, i)))
break;
if (i == z)
return SEXP_CHECK_INVALID_DOCKEE_POINT;
}
break;
case OPF_WHO_FROM:
if (type2 != SEXP_ATOM_STRING)
return SEXP_CHECK_TYPE_MISMATCH;
if (*CTEXT(node) != '#') { // not a manual source?
//if ( !stricmp(CTEXT(node), "<any allied>") )
// return SEXP_CHECK_INVALID_MSG_SOURCE;
if ( stricmp(CTEXT(node), "<any wingman>")) // not a special token?
if ((ship_name_lookup(CTEXT(node)) < 0) && (wing_name_lookup(CTEXT(node), 1) < 0)) // is it in the mission?
if (Fred_running || !mission_parse_get_arrival_ship(CTEXT(node)))
return SEXP_CHECK_INVALID_MSG_SOURCE;
}
break;
//Karajorma
case OPF_PERSONA:
if (type2 != SEXP_ATOM_STRING){
return SEXP_CHECK_TYPE_MISMATCH;
}
for (i=0; i < Num_personas ; i++) {
if (!strcmp(CTEXT(node), Personas[i].name))
break;
}
if (i == Num_personas)
return SEXP_CHECK_INVALID_PERSONA_NAME;
break;
case OPF_KEYPRESS:
if (type2 != SEXP_ATOM_STRING)
return SEXP_CHECK_TYPE_MISMATCH;
break;
case OPF_CARGO:
case OPF_STRING:
if (type2 != SEXP_ATOM_STRING)
return SEXP_CHECK_TYPE_MISMATCH;
break;
case OPF_SKILL_LEVEL:
if ( type2 != SEXP_ATOM_STRING )
return SEXP_CHECK_TYPE_MISMATCH;
for (i = 0; i < NUM_SKILL_LEVELS; i++) {
if ( !stricmp(CTEXT(node), Skill_level_names(i, 0)) )
break;
}
if ( i == NUM_SKILL_LEVELS )
return SEXP_CHECK_INVALID_SKILL_LEVEL;
break;
case OPF_MEDAL_NAME:
if ( type2 != SEXP_ATOM_STRING)
return SEXP_CHECK_TYPE_MISMATCH;
for (i = 0; i < Num_medals; i++) {
if ( !stricmp(CTEXT(node), Medals[i].name) )
break;
}
if ( i == Num_medals )
return SEXP_CHECK_INVALID_MEDAL_NAME;
break;
case OPF_HUGE_WEAPON:
case OPF_WEAPON_NAME:
if ( type2 != SEXP_ATOM_STRING )
return SEXP_CHECK_TYPE_MISMATCH;
for (i = 0; i < Num_weapon_types; i++ ) {
if ( !stricmp(CTEXT(node), Weapon_info[i].name) )
break;
}
if ( i == Num_weapon_types )
return SEXP_CHECK_INVALID_WEAPON_NAME;
// we need to be sure that for huge weapons, the WIF_HUGE flag is set
if ( type == OPF_HUGE_WEAPON ) {
if ( !(Weapon_info[i].wi_flags & WIF_HUGE) )
return SEXP_CHECK_INVALID_WEAPON_NAME;
}
break;
// Goober5000
case OPF_INTEL_NAME:
if ( type2 != SEXP_ATOM_STRING )
return SEXP_CHECK_TYPE_MISMATCH;
for (i = 0; i < Intel_info_size; i++ ) {
if ( !stricmp(CTEXT(node), Intel_info[i].name) )
break;
}
if ( i == Intel_info_size )
return SEXP_CHECK_INVALID_INTEL_NAME;
break;
case OPF_TURRET_TARGET_ORDER:
if ( type2 != SEXP_ATOM_STRING )
return SEXP_CHECK_TYPE_MISMATCH;
for (i = 0; i < NUM_TURRET_ORDER_TYPES; i++ ) {
if ( !stricmp(CTEXT(node), Turret_target_order_names[i]) )
break;
}
if ( i == NUM_TURRET_ORDER_TYPES )
return SEXP_CHECK_INVALID_INTEL_NAME;
break;
case OPF_SHIP_CLASS_NAME:
if ( type2 != SEXP_ATOM_STRING )
return SEXP_CHECK_TYPE_MISMATCH;
if (ship_info_lookup(CTEXT(node)) < 0)
return SEXP_CHECK_INVALID_SHIP_CLASS_NAME;
break;
case OPF_HUD_GAUGE_NAME:
if ( type2 != SEXP_ATOM_STRING )
return SEXP_CHECK_TYPE_MISMATCH;
for ( i = 0; i < NUM_HUD_GAUGES; i++ ) {
if ( !stricmp(CTEXT(node), HUD_gauge_text[i]) )
break;
}
// if we reached the end of the list, then the name is invalid
if ( i == NUM_HUD_GAUGES )
return SEXP_CHECK_INVALID_GAUGE_NAME;
break;
case OPF_SKYBOX_MODEL_NAME:
if ( type2 != SEXP_ATOM_STRING )
return SEXP_CHECK_TYPE_MISMATCH;
if ( stricmp(CTEXT(node), NOX("default")) && !strstr(CTEXT(node), NOX(".pof")) )
return SEXP_CHECK_INVALID_SKYBOX_NAME;
break;
case OPF_JUMP_NODE_NAME:
if ( type2 != SEXP_ATOM_STRING )
return SEXP_CHECK_TYPE_MISMATCH;
if (jumpnode_get_by_name == NULL)
return SEXP_CHECK_INVALID_JUMP_NODE;
break;
case OPF_VARIABLE_NAME:
var_index = get_index_sexp_variable_from_node(node);
if ( var_index == -1) {
return SEXP_CHECK_INVALID_VARIABLE;
}
// some SEXPs demand a number variable
if ((argnum == 8 && !stricmp(Operators[op].text, "add-background-bitmap")) ||
(argnum == 5 && !stricmp(Operators[op].text, "add-sun-bitmap"))) {
if (!(Sexp_variables[var_index].type & SEXP_VARIABLE_NUMBER))
return SEXP_CHECK_INVALID_VARIABLE_TYPE;
}
// otherwise anything goes
break;
case OPF_AMBIGUOUS:
// type checking for modify-variable
// string or number -- anything goes
break;
case OPF_BACKGROUND_BITMAP:
break;
case OPF_SUN_BITMAP:
break;
case OPF_NEBULA_STORM_TYPE:
break;
case OPF_NEBULA_POOF:
break;
default:
Error(LOCATION, "Unhandled argument format");
//Int3(); // currently unhandled argument format (so add it now)
}
node = Sexp_nodes[node].rest;
argnum++;
}
return 0;
}
// Stuff a string (" chars ") in *str, return length.
// Updates Mp.
int get_string(char *str)
{
int len;
len = strcspn(Mp + 1, "\"");
strncpy(str, Mp + 1, len);
str[len] = 0;
Mp += len + 2;
return len;
}
// Goober5000
void get_unformatted_sexp_variable_name(char *unformatted, char *formatted_pre)
{
int end_index;
char *formatted;
// Goober5000 - trim @ if needed
if (formatted_pre[0] == SEXP_VARIABLE_CHAR)
formatted = formatted_pre+1;
else
formatted = formatted_pre;
// get variable name (up to '['
end_index = strcspn(formatted, "[");
Assert( (end_index != 0) && (end_index < TOKEN_LENGTH-1) );
strncpy(unformatted, formatted, end_index);
unformatted[end_index] = '\0';
}
// get text to stuff into Sexp_node in case of variable
// if Fred_running - stuff Sexp_variables[].variable_name
// otherwise - stuff index into Sexp_variables array.
void get_sexp_text_for_variable(char *text, char *token)
{
int sexp_var_index;
get_unformatted_sexp_variable_name(text, token);
if ( !Fred_running ) {
// freespace - get index into Sexp_variables array
sexp_var_index = get_index_sexp_variable_name(text);
Assert(sexp_var_index != -1);
sprintf(text, "%d", sexp_var_index);
}
}
// Goober5000
void do_preload_for_arguments(void (*preloader)(char *), int arg_node, int arg_handler_node)
{
// we have a special argument
if (!strcmp(Sexp_nodes[arg_node].text, SEXP_ARGUMENT_STRING))
{
int n;
// we might not be handling it, either because this is not a *_of operator
// or because we've disabled preloading for special arguments
if (arg_handler_node < 0)
return;
// preload for each argument
for (n = CDR(arg_handler_node); n != -1; n = CDR(n))
{
preloader(CTEXT(n));
}
}
// we don't
else
{
// preload for just the one argument
preloader(CTEXT(arg_node));
}
}
// Goober5000
void preload_change_ship_class(char *text)
{
int idx;
ship_info *sip;
idx = ship_info_lookup(text);
if (idx < 0)
return;
// preload the model, just in case there is no other ship of this class in the mission
// (this eliminates the slight pause during a mission when changing to a previously unloaded model)
sip = &Ship_info[idx];
sip->model_num = model_load(sip->pof_file, sip->n_subsystems, &sip->subsystems[0]);
if (sip->model_num >= 0)
model_page_in_textures(sip->model_num, idx);
}
// Goober5000
void preload_turret_change_weapon(char *text)
{
int idx;
idx = weapon_info_lookup(text);
if (idx < 0)
return;
weapon_mark_as_used(idx);
}
// returns the first sexp index of data this function allocates. (start of this sexp)
// recursive function - always sets first and then rest
int get_sexp(char *token)
{
int start, node, last, op, count;
char variable_text[TOKEN_LENGTH];
// start - the node allocated in first instance of fuction
// node - the node allocated in current instance of function
// count - number of nodes allocated this instance of function [do we set last.rest or .first]
// variable - whether string or number is a variable referencing Sexp_variables
// initialization
start = last = -1;
count = 0;
ignore_white_space();
while (*Mp != ')') {
Assert(*Mp != EOF_CHAR);
if (*Mp == '(') {
// Sexp list
Mp++;
node = alloc_sexp("", SEXP_LIST, SEXP_ATOM_LIST, get_sexp(token), -1);
} else if (*Mp == '\"') {
// Sexp string
int len = strcspn(Mp + 1, "\"");
Assert(Mp[len + 1] == '\"'); // hit EOF first (unterminated string)
Assert(len < TOKEN_LENGTH); // token is too long.
// check if string variable
if ( *(Mp + 1) == SEXP_VARIABLE_CHAR ) {
// reduce length by 1 for end \"
int length = len - 1;
Assert(length < 2*TOKEN_LENGTH+2);
// start copying after skipping 1st char
strncpy(token, Mp + 2, length);
token[length] = 0;
get_sexp_text_for_variable(variable_text, token);
node = alloc_sexp(variable_text, (SEXP_ATOM | SEXP_FLAG_VARIABLE), SEXP_ATOM_STRING, -1, -1);
} else {
strncpy(token, Mp + 1, len);
token[len] = 0;
node = alloc_sexp(token, SEXP_ATOM, SEXP_ATOM_STRING, -1, -1);
}
// bump past closing \" by 1 char
Mp += len + 2;
} else {
// Sexp operator or number
int len = 0;
bool variable = false;
while (*Mp != ')' && !is_white_space(*Mp)) {
if ( (len == 0) && (*Mp == SEXP_VARIABLE_CHAR) ) {
variable = true;
Mp++;
continue;
}
Assert(*Mp != EOF_CHAR);
Assert(len < TOKEN_LENGTH - 1);
token[len++] = *Mp++;
}
token[len] = 0;
// Goober5000 - maybe replace deprecated names
if (!stricmp(token, "set-ship-position"))
strcpy(token, "set-object-position");
else if (!stricmp(token, "set-ship-facing"))
strcpy(token, "set-object-facing");
else if (!stricmp(token, "set-ship-facing-object"))
strcpy(token, "set-object-facing-object");
else if (!stricmp(token, "ai-chase-any-except"))
strcpy(token, "ai-chase-any");
else if (!stricmp(token, "change-ship-model"))
strcpy(token, "change-ship-class");
else if (!stricmp(token, "radar-set-max-range"))
strcpy(token, "hud-set-max-targeting-range");
op = get_operator_index(token);
if (op != -1) {
node = alloc_sexp(token, SEXP_ATOM, SEXP_ATOM_OPERATOR, -1, -1);
} else {
if ( variable ) {
// convert token text for variable
get_sexp_text_for_variable(variable_text, token);
node = alloc_sexp(variable_text, (SEXP_ATOM | SEXP_FLAG_VARIABLE), SEXP_ATOM_NUMBER, -1, -1);
} else {
node = alloc_sexp(token, SEXP_ATOM, SEXP_ATOM_NUMBER, -1, -1);
}
}
}
// update links
if (count++) {
Assert(last != -1);
Sexp_nodes[last].rest = node;
} else {
start = node;
}
Assert(node != -1); // ran out of nodes. Time to raise the MAX!
last = node;
ignore_white_space();
}
Mp++; // skip past the ')'
// Goober5000 - backwards compatibility for removed ai-chase-any-except
if (get_operator_const(CTEXT(start)) == OP_AI_CHASE_ANY)
{
// if there is more than one argument, free the extras
int n = CDR(CDR(start));
if (n >= 0)
{
// free the entire rest of the argument list
free_sexp2(n);
}
}
// Goober5000 - preload stuff for certain sexps
if (!Fred_running)
{
int n, parent, arg_handler = -1;
// see if we're using special arguments
parent = find_parent_operator(start);
if (parent >= 0 && is_blank_argument_op(get_operator_const(CTEXT(parent))))
{
// get the first op of the parent, which should be a *_of operator
arg_handler = CADR(parent);
if (!is_blank_of_op(get_operator_const(CTEXT(arg_handler))))
arg_handler = -1;
}
// DISABLE ARGUMENT PRELOADING FOR NOW
// see Mantis #925 for discussion
// Also, the preloader will have to be moved to a different function (after the parsing is finished)
// in order to work properly with special arguments. The current node is an orphan until get_sexp
// completes, at which time it will be linked into the sexp node list; this means that it is
// impossible to get the parent node.
arg_handler = -1;
// preload according to sexp
op = get_operator_const(CTEXT(start));
switch (op)
{
case OP_CHANGE_SHIP_CLASS:
// model is argument #1
n = CDR(start);
do_preload_for_arguments(preload_change_ship_class, n, arg_handler);
break;
case OP_SET_SPECIAL_WARPOUT_NAME:
// set flag for taylor
Knossos_warp_ani_used = 1;
break;
case OP_MISSION_SET_NEBULA:
// set flag for WMC
Nebula_sexp_used = true;
Dynamic_environment = true;
break;
case OP_WARP_EFFECT:
// type of warp is argument #11
n = CDDDDDR(start);
n = CDDDDDR(n);
n = CDR(n);
// set flag for taylor
if (CAR(n) != -1 || !strcmp(Sexp_nodes[n].text, SEXP_ARGUMENT_STRING)) // if it's evaluating a sexp or a special argument
Knossos_warp_ani_used = 1; // set flag just in case
else if (atoi(CTEXT(n)) == 1) // if it's the Knossos type
Knossos_warp_ani_used = 1; // set flag for sure
break;
case OP_SET_SKYBOX_MODEL:
// model is argument #1
n = CDR(start);
do_preload_for_arguments(sexp_set_skybox_model_preload, n, arg_handler);
Dynamic_environment = true;
break;
case OP_TURRET_CHANGE_WEAPON:
// weapon to change to is arg #3
n = CDDDR(start);
do_preload_for_arguments(preload_turret_change_weapon, n, arg_handler);
break;
case OP_ADD_SUN_BITMAP:
n = CDR(start);
do_preload_for_arguments(stars_preload_sun_bitmap, n, arg_handler);
Dynamic_environment = true;
break;
case OP_ADD_BACKGROUND_BITMAP:
n = CDR(start);
do_preload_for_arguments(stars_preload_background_bitmap, n, arg_handler);
Dynamic_environment = true;
break;
}
}
return start;
}
// Stuffs a list of sexp variables
int stuff_sexp_variable_list()
{
int count;
char var_name[TOKEN_LENGTH];
char default_value[TOKEN_LENGTH];
char str_type[TOKEN_LENGTH];
char persistent[TOKEN_LENGTH];
char network[TOKEN_LENGTH];
int index;
int type;
count = 0;
required_string("$Variables:");
ignore_white_space();
// check for start of list
if (*Mp != '(') {
error_display(1, "Reading sexp variable list. Found [%c]. Expecting '('.\n", *Mp);
longjmp(parse_abort, 6);
}
Mp++;
ignore_white_space();
while (*Mp != ')') {
Assert(count < MAX_SEXP_VARIABLES);
// get index - for debug
stuff_int(&index);
ignore_gray_space();
// get var_name
get_string(var_name);
ignore_gray_space();
// get default_value;
get_string(default_value);
ignore_gray_space();
// get type
get_string(str_type);
ignore_white_space();
// determine type
if (!stricmp(str_type, "number")) {
type = SEXP_VARIABLE_NUMBER;
} else if (!stricmp(str_type, "string")) {
type = SEXP_VARIABLE_STRING;
} else if (!stricmp(str_type, "block")) {
// Goober5000 - This looks dangerous... these flags are needed for certain things, but it
// looks like BLOCK_*_SIZE is the only thing that keeps a block from running off the end
// of its boundary.
type = SEXP_VARIABLE_BLOCK | SEXP_VARIABLE_BLOCK_EXP | SEXP_VARIABLE_BLOCK_HIT;
} else {
type = SEXP_VARIABLE_UNKNOWN;
Error(LOCATION, "SEXP variable '%s' is an unknown type!", var_name);
}
// possibly get network-variable
if (check_for_string("\"network-variable\"")) {
// eat it
get_string(network);
ignore_white_space();
// set type
type |= SEXP_VARIABLE_NETWORK;
}
// possibly get player-persistent
if (check_for_string("\"player-persistent\"")) {
// eat it
get_string(persistent);
ignore_white_space();
// set type
type |= SEXP_VARIABLE_PLAYER_PERSISTENT;
// possibly get campaign-persistent
} else if (check_for_string("\"campaign-persistent\"")) {
// eat it
get_string(persistent);
ignore_white_space();
// set type
type |= SEXP_VARIABLE_CAMPAIGN_PERSISTENT;
// trap error
} else if (check_for_string("\"")) {
// eat garbage
get_string(persistent);
ignore_white_space();
// notify of error
Error(LOCATION, "Error parsing sexp variables - unknown persistence type encountered. You can continue from here without trouble.");
}
count++;
// check if variable name already exists
if ( (type & SEXP_VARIABLE_NUMBER) || (type & SEXP_VARIABLE_STRING) ) {
Assert(get_index_sexp_variable_name(var_name) == -1);
}
sexp_add_variable(default_value, var_name, type, index);
}
Mp++;
return count;
}
//
void build_sexp_text_string(char *buffer, int node, int mode)
{
Assert( (node >= 0) && (node < Num_sexp_nodes) );
if (Sexp_nodes[node].type & SEXP_FLAG_VARIABLE) {
int sexp_variables_index = get_index_sexp_variable_name(Sexp_nodes[node].text);
Assert(sexp_variables_index != -1);
Assert( (Sexp_variables[sexp_variables_index].type & SEXP_VARIABLE_NUMBER) || (Sexp_variables[sexp_variables_index].type & SEXP_VARIABLE_STRING) );
// number
if (Sexp_nodes[node].subtype == SEXP_ATOM_NUMBER) {
Assert(Sexp_variables[sexp_variables_index].type & SEXP_VARIABLE_NUMBER);
// Error check - can be Fred or FreeSpace
if (mode == SEXP_ERROR_CHECK_MODE) {
if ( Fred_running ) {
sprintf(buffer, "%s[%s] ", Sexp_nodes[node].text, Sexp_variables[sexp_variables_index].text);
} else {
sprintf(buffer, "%s[%s] ", Sexp_variables[sexp_variables_index].variable_name, Sexp_variables[sexp_variables_index].text);
}
} else {
// Save as string - only Fred
Assert(mode == SEXP_SAVE_MODE);
sprintf(buffer, "@%s[%s] ", Sexp_nodes[node].text, Sexp_variables[sexp_variables_index].text);
}
} else {
// string
Assert(Sexp_nodes[node].subtype == SEXP_ATOM_STRING);
Assert(Sexp_variables[sexp_variables_index].type & SEXP_VARIABLE_STRING);
// Error check - can be Fred or FreeSpace
if (mode == SEXP_ERROR_CHECK_MODE) {
if ( Fred_running ) {
sprintf(buffer, "%s[%s] ", Sexp_variables[sexp_variables_index].variable_name, Sexp_variables[sexp_variables_index].text);
} else {
sprintf(buffer, "%s[%s] ", Sexp_nodes[node].text, Sexp_variables[sexp_variables_index].text);
}
} else {
// Save as string - only Fred
Assert(mode == SEXP_SAVE_MODE);
sprintf(buffer, "\"@%s[%s]\" ", Sexp_nodes[node].text, Sexp_variables[sexp_variables_index].text);
}
}
} else {
// not a variable
if (Sexp_nodes[node].subtype == SEXP_ATOM_STRING) {
sprintf(buffer, "\"%s\" ", CTEXT(node));
} else {
sprintf(buffer, "%s ", CTEXT(node));
}
}
}
static int Sexp_text_overflow_warning = 0;
// speed is not critical, since we're using FRED
char *sexp_strcat(char *dest, const char *src, int max_len)
{
int dest_len = strlen(dest);
int src_len = strlen(src);
if (dest_len + src_len < max_len - 1)
{
strcpy(&dest[dest_len], src);
}
else
{
if (!Sexp_text_overflow_warning)
{
char buf[512];
strcpy(buf, "SEXP OVERFLOW: The sexp starting with the following text...\n\n");
strncat(buf, dest, 172);
strcat(buf, "\n\n...is too long! The sexp has been truncated accordingly and is probably no longer correct. Please fix this sexp using a text editor.\n\n(Please note that future sexp overflows will fail silently, and this warning will not be displayed again until you restart FRED.)\n");
mprintf((buf));
Error(LOCATION, buf);
Sexp_text_overflow_warning = 1;
}
}
return dest;
}
int build_sexp_string(int cur_node, int level, int mode, int max_len)
{
char pstr[128];
int len, offset, node;
Sexp_build_flag = 0;
offset = strlen(Sexp_string);
sexp_strcat(Sexp_string, "( ", max_len);
node = cur_node;
while (node != -1) {
Assert(node >= 0 && node < Num_sexp_nodes);
if (Sexp_nodes[node].first == -1) {
// build text to string
build_sexp_text_string(pstr, node, mode);
sexp_strcat(Sexp_string, pstr, max_len);
} else {
build_sexp_string(Sexp_nodes[node].first, level + 1, mode, max_len);
}
node = Sexp_nodes[node].rest;
}
sexp_strcat(Sexp_string, ") ", max_len);
len = strlen(Sexp_string) - offset;
if (len > 40) {
Sexp_string[offset] = 0;
build_extended_sexp_string(cur_node, level, mode, max_len);
return 1;
}
return 0;
}
void build_extended_sexp_string(int cur_node, int level, int mode, int max_len)
{
char pstr[128];
int i, flag = 0, node;
sexp_strcat(Sexp_string, "( ", max_len);
node = cur_node;
while (node != -1) {
if (flag) // not the first line?
for (i=0; i<level + 1; i++)
sexp_strcat(Sexp_string, " ", max_len);
flag = 1;
Assert(node >= 0 && node < Num_sexp_nodes);
if (Sexp_nodes[node].first == -1) {
build_sexp_text_string(pstr,node, mode);
sexp_strcat(Sexp_string, pstr, max_len);
} else {
build_sexp_string(Sexp_nodes[node].first, level + 1, mode, max_len);
}
sexp_strcat(Sexp_string, "\n", max_len);
node = Sexp_nodes[node].rest;
}
for (i=0; i<level; i++)
sexp_strcat(Sexp_string, " ", max_len);
sexp_strcat(Sexp_string, ")", max_len);
}
void convert_sexp_to_string(int cur_node, char *outstr, int mode, int max_len)
{
Sexp_string = outstr;
*outstr = 0;
if (cur_node >= 0)
build_sexp_string(cur_node, 0, mode, max_len);
else
strcpy(Sexp_string, "( )");
}
// given a node, returns a pointer to the ship or NULL if this isn't the name of a ship
ship * sexp_get_ship_from_node(int node)
{
int sindex;
ship *shipp = NULL;
sindex = ship_name_lookup( CTEXT(node) );
if (sindex < 0) {
return shipp;
}
if (Ships[sindex].objnum < 0) {
return shipp;
}
shipp = &Ships[sindex];
return shipp;
}
// determine if the named ship or wing hasn't arrived yet (wing or ship must be on arrival list)
int sexp_query_has_yet_to_arrive(char *name)
{
int i;
if (ship_query_state(name) < 0)
return 1;
i = wing_name_lookup(name, 1);
// has not arrived yet, and never will arrive
if ((i >= 0) && (Wings[i].num_waves >= 0) && (Wings[i].flags & WF_NEVER_EXISTED)){
return 1;
}
// has not arrived yet
if ((i >= 0) && (Wings[i].num_waves >= 0) && !Wings[i].total_arrived_count){
return 1;
}
return 0;
}
// arithmetic functions
int add_sexps(int n)
{
int sum = 0, val;
if (n != -1) {
if ( CAR(n) != -1)
sum = eval_sexp( CAR(n) );
else
sum = atoi( CTEXT(n) );
// be sure to check for the NAN value when doing arithmetic -- this value should
// get propagated to the next highest function.
if ( Sexp_nodes[CAR(n)].value == SEXP_NAN )
return SEXP_NAN;
else if ( Sexp_nodes[CAR(n)].value == SEXP_NAN_FOREVER )
return SEXP_NAN_FOREVER;
while (CDR(n) != -1) {
val = eval_sexp( CDR(n) );
// be sure to check for the NAN value when doing arithmetic -- this value should
// get propagated to the next highest function.
if ( Sexp_nodes[CDR(n)].value == SEXP_NAN )
return SEXP_NAN;
else if ( Sexp_nodes[CAR(n)].value == SEXP_NAN_FOREVER )
return SEXP_NAN_FOREVER;
sum += val;
n = CDR(n);
}
}
return sum;
}
int sub_sexps(int n)
{
int sum = 0;
if (n != -1) {
if (Sexp_nodes[n].first != -1)
sum = eval_sexp(CAR(n));
else
sum = atoi(CTEXT(n));
while (CDR(n) != -1) {
sum -= eval_sexp(CDR(n));
n = CDR(n);
}
}
return sum;
}
int mul_sexps(int n)
{
int sum = 0;
if (n != -1) {
if (Sexp_nodes[n].first != -1)
sum = eval_sexp(Sexp_nodes[n].first);
else
sum = atoi(CTEXT(n));
while (Sexp_nodes[n].rest != -1) {
sum *= eval_sexp(Sexp_nodes[n].rest);
n = Sexp_nodes[n].rest;
}
}
return sum;
}
int div_sexps(int n)
{
int sum = 0;
if (n != -1) {
if (Sexp_nodes[n].first != -1)
sum = eval_sexp(Sexp_nodes[n].first);
else
sum = atoi(CTEXT(n));
while (Sexp_nodes[n].rest != -1) {
sum /= eval_sexp(Sexp_nodes[n].rest);
n = Sexp_nodes[n].rest;
}
}
return sum;
}
int mod_sexps(int n)
{
int sum = 0;
if (n != -1) {
if (Sexp_nodes[n].first != -1)
sum = eval_sexp(Sexp_nodes[n].first);
else
sum = atoi(CTEXT(n));
while (Sexp_nodes[n].rest != -1) {
sum = sum % eval_sexp(Sexp_nodes[n].rest);
n = Sexp_nodes[n].rest;
}
}
return sum;
}
int rand_internal(int low, int high, int seed = 0)
{
int diff;
// maybe seed it
if (seed > 0)
srand(seed);
// get diff - don't allow negative or zero
diff = high - low;
if (diff < 0)
diff = 0;
return (low + rand32() % (diff + 1));
}
// Goober5000
int abs_sexp(int n)
{
return abs(eval_num(n));
}
// Goober5000
int min_sexp(int n)
{
int temp, min_val = INT_MAX;
while (n != -1)
{
temp = eval_num(n);
if (temp < min_val)
min_val = temp;
n = CDR(n);
}
return min_val;
}
// Goober5000
int max_sexp(int n)
{
int temp, max_val = INT_MIN;
while (n != -1)
{
temp = eval_num(n);
if (temp > max_val)
max_val = temp;
n = CDR(n);
}
return max_val;
}
// Goober5000
int avg_sexp(int n)
{
int num = 0, avg_val = 0;
while (n != -1)
{
avg_val += eval_num(n);
num++;
n = CDR(n);
}
return (int) floor(((double) avg_val / num) + 0.5);
}
// seeding added by Karajorma and Goober5000
int rand_sexp(int n, bool multiple)
{
int low, high, rand_num, seed;
if (n < 0)
{
Int3();
return 0;
}
// when getting a saved value
if (Sexp_nodes[n].value == SEXP_NUM_EVAL)
{
// don't regenerate new random number
return atoi(CTEXT(n));
}
// get low
// if (Sexp_nodes[n].first != -1) {
// low = eval_sexp(Sexp_nodes[n].first);
// } else {
// low = atoi(CTEXT(n));
// }
low = eval_num(n);
// get high
high = eval_num(CDR(n));
// is there a seed provided?
if (CDDR(n) != -1)
seed = eval_num(CDDR(n));
else
seed = 0;
// get the random number
rand_num = rand_internal(low, high, seed);
// when saving the value
if (!multiple)
{
// set .value and .text so random number is generated only once.
Sexp_nodes[n].value = SEXP_NUM_EVAL;
sprintf(Sexp_nodes[n].text, "%d", rand_num);
}
// if this is multiple with a nonzero seed provided
else if (seed > 0)
{
// Set the seed to a new seeded random value. This will ensure that the next time the method
// is called it will return a predictable but different number from the previous time.
sprintf(Sexp_nodes[CDDR(n)].text, "%d", rand_internal(1, INT_MAX, seed));
}
return rand_num;
}
// boolean evaluation functions. Evaluate all sexpressions in the 'or' operator. Needed to mark
// entries in the mission log as essential so when pruning the log, we know which entries we might
// need to keep.
int sexp_or(int n)
{
int all_false, result;
all_false = 1;
result = 0;
if (n != -1)
{
if (CAR(n) != -1)
{
result |= is_sexp_true(CAR(n));
if ( Sexp_nodes[CAR(n)].value == SEXP_KNOWN_TRUE )
return SEXP_KNOWN_TRUE; // if one of the OR clauses is TRUE, whole clause is true
if ( Sexp_nodes[CAR(n)].value != SEXP_KNOWN_FALSE ) // if the value is still unknown, they all can't be false
all_false = 0;
}
else
result |= atoi(CTEXT(n));
// don't return on true value -- keep evaluating for mission log purposes
//if ( result )
// return result;
while (CDR(n) != -1)
{
result |= is_sexp_true(CDR(n));
if ( Sexp_nodes[CDR(n)].value == SEXP_KNOWN_TRUE )
return SEXP_KNOWN_TRUE; // if one of the OR clauses is TRUE, whole clause is true
if ( Sexp_nodes[CDR(n)].value != SEXP_KNOWN_FALSE ) // if the value is still unknown, they all can't be false
all_false = 0;
// don't return on true value -- keep evaluating for mission log purposes
//if ( result )
// return result;
n = CDR(n);
}
}
if (all_false)
return SEXP_KNOWN_FALSE;
return result;
}
// this function does the 'and' operator. It will short circuit evaluation *but* it will still
// evaluate other members of the and construct. I do this because I need events in the mission log
// to get marked as essential for goal purposes, and evaluation is pretty much the only way
int sexp_and(int n)
{
int all_true, result;
result = -1;
all_true = 1;
if (n != -1)
{
if (CAR(n) != -1)
{
result &= is_sexp_true(CAR(n));
if ( Sexp_nodes[CAR(n)].value == SEXP_KNOWN_FALSE )
return SEXP_KNOWN_FALSE; // if one of the AND clauses is FALSE, whole clause is false
if ( Sexp_nodes[CAR(n)].value != SEXP_KNOWN_TRUE ) // if the value is still unknown, they all can't be true
all_true = 0;
}
else
result &= atoi(CTEXT(n));
// don't short circuit -- evaluate everything for purposes of marking mission log
//if ( !result )
// return result;
while (CDR(n) != -1)
{
int new_result;
new_result = is_sexp_true(CDR(n));
result &= new_result;
if ( Sexp_nodes[CDR(n)].value == SEXP_KNOWN_FALSE )
return SEXP_KNOWN_FALSE; // if one of the AND clauses is FALSE, whole clause is false
if ( Sexp_nodes[CDR(n)].value != SEXP_KNOWN_TRUE ) // if the value is still unknown, they all can't be true
all_true = 0;
// don't short circuit -- evaluate everything for purposes of marking mission log
//if ( !result )
//return result;
n = CDR(n);
}
}
if (all_true)
return SEXP_KNOWN_TRUE;
return result;
}
// this version of the 'and' operator determines whether or not it's arguments become true
// in the order in which they are specified in the when statement. Should be a simple matter of
// seeing if anything evaluates to true later than something that evalueated to false
int sexp_and_in_sequence(int n)
{
int result = -1;
int all_true;
all_true = 1; // represents whether or not all nodes we have seen so far are true
if (n != -1)
{
if (CAR(n) != -1)
{
result &= is_sexp_true(CAR(n));
if ( Sexp_nodes[CAR(n)].value == SEXP_KNOWN_FALSE )
return SEXP_KNOWN_FALSE; // if one of the AND clauses is FALSE, whole clause is false
if ( Sexp_nodes[CAR(n)].value != SEXP_KNOWN_TRUE ) // if value is true, mark our all_true variable for later checking
all_true = 0;
}
else
result &= atoi(CTEXT(n));
// a little test -- if the previous sexpressions was true, then mark the node itself as always
// true. I did this because of the distance function. It might become true, then when waiting for
// the second evalation, it might become false, rendering this function false. So, when one becomes
// true -- mark it true forever.
if ( result )
Sexp_nodes[CAR(n)].value = SEXP_KNOWN_TRUE;
while (CDR(n) != -1)
{
int next_result;
next_result = is_sexp_true(CDR(n));
if ( next_result && !result ) // if current result is true, and our running result is false, thngs didn't become true in order
return SEXP_KNOWN_FALSE;
result &= next_result;
if ( Sexp_nodes[CDR(n)].value == SEXP_KNOWN_FALSE )
return SEXP_KNOWN_FALSE; // if one of the OR clauses is TRUE, whole clause is true
if ( Sexp_nodes[CDR(n)].value != SEXP_KNOWN_TRUE ) // if the value is still unknown, they all can't be false
all_true = 0;
// see comment above for explanation of next lines
if ( result )
Sexp_nodes[CDR(n)].value = SEXP_KNOWN_TRUE;
n = CDR(n);
}
}
if ( all_true )
return SEXP_KNOWN_TRUE;
return result;
}
// for these four basic boolean operations (not, <, >, and =), we have special cases that we must deal
// with. We have sexpressions operators that might return a NAN type return value (such as the distance
// between two ships when one of the ships is destroyed or departed). These operations need to check for
// this special NAN value and adjust their return types accordingly. NAN values represent false return values
int sexp_not(int n)
{
int result = 0;
if (n != -1)
{
if (CAR(n) != -1)
{
result = is_sexp_true(CAR(n));
if ( Sexp_nodes[CAR(n)].value == SEXP_KNOWN_FALSE )
return SEXP_KNOWN_TRUE; // not KNOWN_FALSE == KNOWN_TRUE;
else if ( Sexp_nodes[CAR(n)].value == SEXP_KNOWN_TRUE ) // not KNOWN_TRUE == KNOWN_FALSE
return SEXP_KNOWN_FALSE;
else if ( Sexp_nodes[CAR(n)].value == SEXP_NAN ) // not NAN == TRUE (I think)
return SEXP_TRUE;
else if ( Sexp_nodes[CAR(n)].value == SEXP_NAN_FOREVER )
return SEXP_TRUE;
}
else
result = atoi(CTEXT(n));
}
return !result;
}
// Goober5000
int sexp_number_compare(int n, int op)
{
int first_node = n;
int current_node;
int first_number = eval_sexp(first_node);
int current_number;
// bail on NANs
if (CAR(first_node) != -1)
{
if (Sexp_nodes[CAR(first_node)].value == SEXP_NAN) return SEXP_FALSE;
if (Sexp_nodes[CAR(first_node)].value == SEXP_NAN_FOREVER) return SEXP_KNOWN_FALSE;
}
if (CDR(first_node) != -1)
{
if (Sexp_nodes[CDR(first_node)].value == SEXP_NAN) return SEXP_FALSE;
if (Sexp_nodes[CDR(first_node)].value == SEXP_NAN_FOREVER) return SEXP_KNOWN_FALSE;
}
// compare first node with each of the others
for (current_node = CDR(first_node); current_node != -1; current_node = CDR(current_node))
{
// bail on NANs
if (CAR(current_node) != -1)
{
if (Sexp_nodes[CAR(current_node)].value == SEXP_NAN) return SEXP_FALSE;
if (Sexp_nodes[CAR(current_node)].value == SEXP_NAN_FOREVER) return SEXP_KNOWN_FALSE;
}
if (CDR(current_node) != -1)
{
if (Sexp_nodes[CDR(current_node)].value == SEXP_NAN) return SEXP_FALSE;
if (Sexp_nodes[CDR(current_node)].value == SEXP_NAN_FOREVER) return SEXP_KNOWN_FALSE;
}
current_number = eval_sexp(current_node);
// must satisfy our particular operator
switch(op)
{
case OP_EQUALS:
if (first_number != current_number) return SEXP_FALSE;
break;
case OP_GREATER_THAN:
if (first_number <= current_number) return SEXP_FALSE;
break;
case OP_LESS_THAN:
if (first_number >= current_number) return SEXP_FALSE;
break;
}
}
// it satisfies the operator for all the arguments
return SEXP_TRUE;
}
// Goober5000
int sexp_string_compare(int n, int op)
{
int first_node = n;
int current_node;
int val;
char *first_string = CTEXT(first_node);
// compare first node with each of the others
for (current_node = CDR(first_node); current_node != -1; current_node = CDR(current_node))
{
val = strcmp(first_string, CTEXT(current_node));
// must satisfy our particular operator
switch(op)
{
case OP_STRING_EQUALS:
if (val != 0) return SEXP_FALSE;
break;
case OP_STRING_GREATER_THAN:
if (val <= 0) return SEXP_FALSE;
break;
case OP_STRING_LESS_THAN:
if (val >= 0) return SEXP_FALSE;
break;
}
}
// it satisfies the operator for all the arguments
return SEXP_TRUE;
}
#define OSWPT_TYPE_NONE 0
#define OSWPT_TYPE_SHIP 1
#define OSWPT_TYPE_WING 2
#define OSWPT_TYPE_WAYPOINT 3
#define OSWPT_TYPE_TEAM 4
#define OSWPT_TYPE_PARSE_OBJECT 5
#define OSWPT_TYPE_EXITED 6
// Goober5000
typedef struct object_ship_wing_point_team
{
char *object_name;
int type;
p_object *p_objp;
object *objp;
ship *shipp;
wing *wingp;
object *waypointp;
int team;
}
object_ship_wing_point_team;
// Goober5000
void sexp_get_object_ship_wing_point_team(object_ship_wing_point_team *oswpt, char *object_name)
{
int team, ship_num, wing_num, object_num;
p_object *p_objp;
Assert(oswpt != NULL);
Assert(object_name != NULL);
oswpt->object_name = object_name;
oswpt->type = OSWPT_TYPE_NONE;
oswpt->p_objp = NULL;
oswpt->objp = NULL;
oswpt->shipp = NULL;
oswpt->waypointp = NULL;
oswpt->wingp = NULL;
oswpt->team = -1;
if(!stricmp(object_name, SEXP_NONE_STRING))
{
oswpt->type = OSWPT_TYPE_NONE;
return;
}
// check to see if ship destroyed or departed. In either case, do nothing.
if (mission_log_get_time(LOG_SHIP_DEPARTED, object_name, NULL, NULL) || mission_log_get_time(LOG_SHIP_DESTROYED, object_name, NULL, NULL))
{
oswpt->type = OSWPT_TYPE_EXITED;
return;
}
// the object might be the name of a wing. Check to see if the wing is destroyed or departed.
if (mission_log_get_time(LOG_WING_DESTROYED, object_name, NULL, NULL) || mission_log_get_time(LOG_WING_DEPARTED, object_name, NULL, NULL))
{
oswpt->type = OSWPT_TYPE_EXITED;
return;
}
// if we have a team type, pick the first ship of that team
team = sexp_determine_team(object_name);
if (team >= 0)
{
for (ship_obj *so = GET_FIRST(&Ship_obj_list); so != END_OF_LIST(&Ship_obj_list); so = GET_NEXT(so))
{
object *objp = &Objects[so->objnum];
ship *shipp = &Ships[objp->instance];
if (shipp->team == team)
{
oswpt->type = OSWPT_TYPE_TEAM;
oswpt->team = team;
oswpt->objp = objp;
oswpt->shipp = shipp;
return;
}
}
// no match
return;
}
// at this point, we must have a ship, wing, or point for a target
ship_num = ship_name_lookup(object_name);
if (ship_num >= 0)
{
oswpt->type = OSWPT_TYPE_SHIP;
oswpt->shipp = &Ships[ship_num];
oswpt->objp = &Objects[oswpt->shipp->objnum];
return;
}
// check to see if we have a parse object instead
p_objp = mission_parse_get_arrival_ship(object_name);
if (p_objp != NULL)
{
oswpt->type = OSWPT_TYPE_PARSE_OBJECT;
oswpt->p_objp = p_objp;
return;
}
// at this point, we must have a wing or point for a target
wing_num = wing_name_lookup(object_name);
if (wing_num >= 0)
{
wing *wingp = &Wings[wing_num];
// make sure that at least one ship exists and that the wing leader is valid
if ( (wingp->current_count >= 0) && (wingp->ship_index[wingp->special_ship] >= 0) )
{
oswpt->type = OSWPT_TYPE_WING;
// point to wing leader
oswpt->wingp = wingp;
oswpt->shipp = &Ships[wingp->ship_index[wingp->special_ship]];
oswpt->objp = &Objects[oswpt->shipp->objnum];
}
return;
}
// at this point, we must have a point for a target
object_num = waypoint_lookup(object_name);
if (object_num >= 0)
{
oswpt->type = OSWPT_TYPE_WAYPOINT;
oswpt->waypointp = oswpt->objp = &Objects[object_num];
return;
}
// we apparently don't have anything legal
return;
}
//return the number of ships of a given team in the area battle
int sexp_num_ships_in_battle(int n)
{
int team=-1;
int count=0;
ship_obj *so;
ship *shipp;
if (n != -1)
{
team = iff_lookup(CTEXT(n));
}
// iterate through all ships
for ( so = GET_FIRST(&Ship_obj_list); so != END_OF_LIST(&Ship_obj_list); so = GET_NEXT(so) )
{
shipp=&Ships[Objects[so->objnum].instance];
// merging of team and non-team sexps
if (team != -1)
{
if (shipp->team == team)
{
count++;
}
}
else
{
count++;
}
}
return count;
}
//Karajorma - return the number of ships of a given wing or wings in the battle area
int sexp_num_ships_in_wing(int n)
{
char *name;
int num_ships = 0 ;
// A wing name must be provided, Assert that there is one.
Assert ( n != -1 );
//Cycle through the list of ships given
while (n != -1)
{
// Get the name of the wing
name = CTEXT(n);
int wingnum;
wingnum = wing_name_lookup( name, 0 );
//If the wing exists add the number of ships in it to the total
if (wingnum > -1)
{
num_ships += Wings[wingnum].current_count ;
}
//get the next node
n = CDR (n) ;
}
return num_ships ;
}
//Gets the 'real' speed of an object, taking into account docking
int sexp_get_real_speed(object *obj)
{
return fl2i(dock_calc_docked_speed(obj));
}
//Gets the current speed of the specified object
//Uses a lot of code shamelessly ripped from get_object_coordinates
int sexp_current_speed(int n)
{
object_ship_wing_point_team oswpt;
sexp_get_object_ship_wing_point_team(&oswpt, CTEXT(n));
switch (oswpt.type)
{
case OSWPT_TYPE_EXITED:
return SEXP_NAN;
case OSWPT_TYPE_SHIP:
case OSWPT_TYPE_WING:
return sexp_get_real_speed(oswpt.objp);
}
return 0;
}
// Evaluate if given ship is destroyed.
// Return true if the ship in the expression has been destroyed.
int sexp_is_destroyed(int n, fix *latest_time)
{
char *name;
int count, num_destroyed, wing_index;
fix time;
Assert ( n != -1 );
count = 0;
num_destroyed = 0;
wing_index = -1;
while (n != -1) {
count++;
name = CTEXT(n);
if (sexp_query_has_yet_to_arrive(name))
return SEXP_CANT_EVAL;
// check to see if this ship/wing has departed. If so, then function is known false
if ( mission_log_get_time (LOG_SHIP_DEPARTED, name, NULL, NULL) || mission_log_get_time (LOG_WING_DEPARTED, name, NULL, NULL) )
return SEXP_KNOWN_FALSE;
// check the mission log. If ship/wing not destroyed, immediately return SEXP_FALSE.
if ( mission_log_get_time(LOG_SHIP_DESTROYED, name, NULL, &time) || mission_log_get_time(LOG_WING_DESTROYED, name, NULL, &time) || mission_log_get_time(LOG_SELF_DESTRUCTED, name, NULL, &time)) {
num_destroyed++;
if ( latest_time && (time > *latest_time) )
*latest_time = time;
} else {
// ship or wing isn't destroyed -- add to directive count
if ( (wing_index = wing_name_lookup( name, 1 )) >= 0 ) {
Directive_count += Wings[wing_index].current_count;
} else
Directive_count++;
}
// move to next ship/wing in list
n = CDR(n);
}
// special case to mark a directive for destroy wing objectives true after a short amount
// of time when there are more waves for this wing.
if ( (count == 1) && (wing_index >= 0) && (Directive_count == 0) ) {
if ( Wings[wing_index].current_wave < Wings[wing_index].num_waves )
Directive_count = DIRECTIVE_WING_ZERO;
}
if ( count == num_destroyed )
return SEXP_KNOWN_TRUE;
else
return SEXP_FALSE;
}
// return true if the subsystem of the given ship has been destroyed or not
int sexp_is_subsystem_destroyed(int n)
{
char *ship_name, *subsys_name;
Assert( n != -1 );
ship_name = CTEXT(n);
subsys_name = CTEXT(CDR(n));
if (sexp_query_has_yet_to_arrive(ship_name))
return SEXP_CANT_EVAL;
// if the ship has departed, no way to destroy it's subsystem.
if ( mission_log_get_time(LOG_SHIP_DEPARTED, ship_name, NULL, NULL ))
return SEXP_KNOWN_FALSE;
if ( mission_log_get_time(LOG_SHIP_SUBSYS_DESTROYED, ship_name, subsys_name, NULL) )
return SEXP_KNOWN_TRUE;
return SEXP_FALSE;
}
// determines if a ship has docked
int sexp_has_docked(int n)
{
char *docker = CTEXT(n);
char *dockee = CTEXT(CDR(n));
int count = eval_num(CDR(CDR(n))); // count of times that we should look for
if (sexp_query_has_yet_to_arrive(docker))
return SEXP_CANT_EVAL;
if (sexp_query_has_yet_to_arrive(dockee))
return SEXP_CANT_EVAL;
Assert ( count > 0 );
if ( mission_log_get_time(LOG_SHIP_DESTROYED, docker, NULL, NULL) || mission_log_get_time(LOG_SHIP_DESTROYED, dockee, NULL, NULL) )
return SEXP_KNOWN_FALSE;
if ( !mission_log_get_time_indexed(LOG_SHIP_DOCKED, docker, dockee, count, NULL) )
return SEXP_FALSE;
return SEXP_KNOWN_TRUE;
}
// determines if a ship has undocked
int sexp_has_undocked(int n)
{
char *docker = CTEXT(n);
char *dockee = CTEXT(CDR(n));
int count = eval_num(CDR(CDR(n)));
if (sexp_query_has_yet_to_arrive(docker))
return SEXP_CANT_EVAL;
if (sexp_query_has_yet_to_arrive(dockee))
return SEXP_CANT_EVAL;
Assert ( count > 0 );
if ( !mission_log_get_time_indexed(LOG_SHIP_UNDOCKED, docker, dockee, count, NULL) ) {
// if either ship destroyed before they dock, then sexp is known false
if ( mission_log_get_time(LOG_SHIP_DESTROYED, docker, NULL, NULL) || mission_log_get_time(LOG_SHIP_DESTROYED, dockee, NULL, NULL) )
return SEXP_KNOWN_FALSE;
else
return SEXP_FALSE;
}
return SEXP_KNOWN_TRUE;
}
// determines if a ship has arrived onto the scene
int sexp_has_arrived(int n, fix *latest_time)
{
char *name;
int count, num_arrived;
fix time;
count = 0;
num_arrived = 0;
while ( n != -1 ) {
count++;
name = CTEXT(n);
// if there is no log entry for this ship/wing for arrival, sexpression is false
if ( mission_log_get_time(LOG_SHIP_ARRIVED, name, NULL, &time) || mission_log_get_time(LOG_WING_ARRIVED, name, NULL, &time) ) {
num_arrived++;
if ( latest_time && (time > *latest_time) )
*latest_time = time;
}
n = CDR(n);
}
if ( count == num_arrived )
return SEXP_KNOWN_TRUE;
else
return SEXP_FALSE;
}
// determines if a ship/wing has departed
int sexp_has_departed(int n, fix *latest_time)
{
char *name;
int count, num_departed;
fix time;
count = 0;
num_departed = 0;
while ( n != -1 ) {
count++;
name = CTEXT(n);
if (sexp_query_has_yet_to_arrive(name))
return SEXP_CANT_EVAL;
// if ship/wing destroyed, sexpression is known false. Also, if there is no departure log entry, then
// the sexpression is not true.
if ( mission_log_get_time(LOG_SHIP_DESTROYED, name, NULL, NULL) || mission_log_get_time(LOG_WING_DESTROYED, name, NULL, NULL))
return SEXP_KNOWN_FALSE;
else if ( mission_log_get_time(LOG_SHIP_DEPARTED, name, NULL, &time) || mission_log_get_time(LOG_WING_DEPARTED, name, NULL, &time) ) {
num_departed++;
if ( latest_time && (time > *latest_time) )
*latest_time = time;
}
n = CDR(n);
}
if ( count == num_departed )
return SEXP_KNOWN_TRUE;
else
return SEXP_FALSE;
}
// determines if ships are disabled
int sexp_is_disabled( int n, fix *latest_time )
{
char *name;
int count, num_disabled;
fix time;
count = 0;
num_disabled = 0;
while ( n != -1 ) {
count++;
name = CTEXT(n);
if (sexp_query_has_yet_to_arrive(name))
return SEXP_CANT_EVAL;
// if ship/wing destroyed, sexpression is known false. Also, if there is no disable log entry, then
// the sexpression is not true.
if ( mission_log_get_time(LOG_SHIP_DEPARTED, name, NULL, &time) || mission_log_get_time(LOG_SHIP_DESTROYED, name, NULL, &time) )
return SEXP_KNOWN_FALSE;
else if ( mission_log_get_time(LOG_SHIP_DISABLED, name, NULL, &time) ) {
num_disabled++;
if ( latest_time && (time > *latest_time) )
*latest_time = time;
}
n = CDR(n);
}
if ( count == num_disabled )
return SEXP_KNOWN_TRUE;
else
return SEXP_FALSE;
}
// function to determine if a ship is done flying waypoints
int sexp_are_waypoints_done(int n)
{
char *ship_name, *waypoint_name;
ship_name = CTEXT(n);
waypoint_name = CTEXT(CDR(n));
if (sexp_query_has_yet_to_arrive(ship_name))
return SEXP_CANT_EVAL;
// a destroyed or departed ship will never reach their goal -- return known false
if ( mission_log_get_time(LOG_SHIP_DESTROYED, ship_name, NULL, NULL) )
return SEXP_KNOWN_FALSE;
else if ( mission_log_get_time(LOG_SHIP_DEPARTED, ship_name, NULL, NULL) )
return SEXP_KNOWN_FALSE;
// now check the log for the waypoints done entry
if ( mission_log_get_time(LOG_WAYPOINTS_DONE, ship_name, waypoint_name, NULL) )
return SEXP_KNOWN_TRUE;
return SEXP_FALSE;
}
// determines if ships are disarmed
int sexp_is_disarmed( int n, fix *latest_time )
{
char *name;
int count, num_disarmed;
fix time;
count = 0;
num_disarmed = 0;
while ( n != -1 ) {
count++;
name = CTEXT(n);
if (sexp_query_has_yet_to_arrive(name))
return SEXP_CANT_EVAL;
// if ship/wing destroyed, sexpression is known false. Also, if there is no disarm log entry, then
// the sexpression is not true.
if ( mission_log_get_time(LOG_SHIP_DEPARTED, name, NULL, &time) || mission_log_get_time(LOG_SHIP_DESTROYED, name, NULL, &time) )
return SEXP_KNOWN_FALSE;
else if ( mission_log_get_time(LOG_SHIP_DISARMED, name, NULL, &time) ) {
num_disarmed++;
if ( latest_time && (time > *latest_time) )
*latest_time = time;
}
n = CDR(n);
}
if ( count == num_disarmed )
return SEXP_KNOWN_TRUE;
else
return SEXP_FALSE;
}
// the following functions are similar to the above objective functions but return true/false
// if N seconds have elasped after the corresponding function is true.
int sexp_is_destroyed_delay(int n)
{
fix delay, time;
int val;
Assert ( n >= 0 );
time = 0;
delay = i2f(eval_num(n));
// check value of is_destroyed function. KNOWN_FALSE should be returned immediately
val = sexp_is_destroyed( CDR(n), &time );
if ( val == SEXP_KNOWN_FALSE )
return val;
if ( val == SEXP_CANT_EVAL )
return SEXP_CANT_EVAL;
if ( val ) {
if ( (Missiontime - time) >= delay )
return SEXP_KNOWN_TRUE;
}
return SEXP_FALSE;
}
int sexp_is_subsystem_destroyed_delay(int n)
{
char *ship_name, *subsys_name;
fix delay, time;
Assert( n != -1 );
ship_name = CTEXT(n);
subsys_name = CTEXT(CDR(n));
delay = i2f(eval_num(CDR(CDR(n))));
if (sexp_query_has_yet_to_arrive(ship_name))
return SEXP_CANT_EVAL;
// if the ship has departed, no way to destroy it's subsystem.
if ( mission_log_get_time(LOG_SHIP_DEPARTED, ship_name, NULL, NULL ))
return SEXP_KNOWN_FALSE;
if ( mission_log_get_time(LOG_SHIP_SUBSYS_DESTROYED, ship_name, subsys_name, &time) ) {
if ( (Missiontime - time) >= delay )
return SEXP_KNOWN_TRUE;
}
return SEXP_FALSE;
}
int sexp_is_disabled_delay(int n)
{
fix delay, time;
int val;
Assert ( n >= 0 );
time = 0;
delay = i2f(eval_num(n));
// check value of is_disable for known false and return immediately if it is.
val = sexp_is_disabled( CDR(n), &time );
if ( val == SEXP_KNOWN_FALSE )
return val;
if ( val == SEXP_CANT_EVAL )
return SEXP_CANT_EVAL;
if ( val ) {
if ( (Missiontime - time) >= delay )
return SEXP_KNOWN_TRUE;
}
return SEXP_FALSE;
}
int sexp_is_disarmed_delay(int n)
{
fix delay, time;
int val;
Assert ( n >= 0 );
time = 0;
delay = i2f(eval_num(n));
// check value of is_disarmed for a known false value and return that immediately if it is
val = sexp_is_disarmed( CDR(n), &time );
if ( val == SEXP_KNOWN_FALSE )
return val;
if ( val == SEXP_CANT_EVAL )
return SEXP_CANT_EVAL;
if ( val ) {
if ( (Missiontime - time) >= delay )
return SEXP_KNOWN_TRUE;
}
return SEXP_FALSE;
}
int sexp_has_docked_delay(int n)
{
char *docker = CTEXT(n);
char *dockee = CTEXT(CDR(n));
int count = eval_num(CDR(CDR(n))); // count of times that we should look for
fix delay = i2f(eval_num(CDR(CDR(CDR(n)))));
fix time;
Assert ( count > 0 );
if ( mission_log_get_time(LOG_SHIP_DESTROYED, docker, NULL, NULL) || mission_log_get_time(LOG_SHIP_DESTROYED, dockee, NULL, NULL) )
return SEXP_KNOWN_FALSE;
if (sexp_query_has_yet_to_arrive(docker))
return SEXP_CANT_EVAL;
if (sexp_query_has_yet_to_arrive(dockee))
return SEXP_CANT_EVAL;
if ( !mission_log_get_time_indexed(LOG_SHIP_DOCKED, docker, dockee, count, &time) )
return SEXP_FALSE;
if ( (Missiontime - time) >= delay )
return SEXP_KNOWN_TRUE;
else
return SEXP_FALSE;
}
int sexp_has_undocked_delay(int n)
{
char *docker = CTEXT(n);
char *dockee = CTEXT(CDR(n));
int count = eval_num(CDR(CDR(n)));
fix delay = i2f(eval_num(CDR(CDR(CDR(n)))));
fix time;
if (sexp_query_has_yet_to_arrive(docker))
return SEXP_CANT_EVAL;
if (sexp_query_has_yet_to_arrive(dockee))
return SEXP_CANT_EVAL;
Assert ( count > 0 );
if ( !mission_log_get_time_indexed(LOG_SHIP_UNDOCKED, docker, dockee, count, &time) ) {
// if either ship destroyed before they dock, then sexp is known false
if ( mission_log_get_time(LOG_SHIP_DESTROYED, docker, NULL, NULL) || mission_log_get_time(LOG_SHIP_DESTROYED, dockee, NULL, NULL) )
return SEXP_KNOWN_FALSE;
else
return SEXP_FALSE;
}
if ( (Missiontime - time) >= delay )
return SEXP_KNOWN_TRUE;
else
return SEXP_FALSE;
}
int sexp_has_arrived_delay(int n)
{
fix delay, time;
int val;
Assert ( n >= 0 );
time = 0;
delay = i2f(eval_num(n));
// check return value from arrived function. if can never arrive, then return that value here as well
val = sexp_has_arrived( CDR(n), &time );
if ( val == SEXP_KNOWN_FALSE )
return val;
if ( val == SEXP_CANT_EVAL )
return SEXP_CANT_EVAL;
if ( val ) {
if ( (Missiontime - time) >= delay )
return SEXP_KNOWN_TRUE;
}
return SEXP_FALSE;
}
int sexp_has_departed_delay(int n)
{
fix delay, time;
int val;
Assert ( n >= 0 );
time = 0;
delay = i2f(eval_num(n));
// must first check to see if the departed function could ever be true/false or is true or false.
// if it can never be true, return that value
val = sexp_has_departed( CDR(n), &time);
if ( val == SEXP_KNOWN_FALSE )
return val;
if ( val == SEXP_CANT_EVAL )
return SEXP_CANT_EVAL;
if ( val ) {
if ( (Missiontime - time) >= delay )
return SEXP_KNOWN_TRUE;
}
return SEXP_FALSE;
}
// function to determine if a ship is done flying waypoints after N seconds
int sexp_are_waypoints_done_delay(int n)
{
char *ship_name, *waypoint_name;
fix time, delay;
ship_name = CTEXT(n);
waypoint_name = CTEXT(CDR(n));
delay = i2f(eval_num(CDR(CDR(n))));
if (sexp_query_has_yet_to_arrive(ship_name))
return SEXP_CANT_EVAL;
// a destroyed or departed ship will never reach their goal -- return known false
//
// Not checking the entries below. Ships which warp out after reaching their goal (or getting
// destroyed after their goal), but after reaching their waypoints, may have this goal incorrectly
// marked false!!!!
// now check the log for the waypoints done entry
if ( mission_log_get_time(LOG_WAYPOINTS_DONE, ship_name, waypoint_name, &time) ) {
if ( (Missiontime - time) >= delay )
return SEXP_KNOWN_TRUE;
} else {
if ( mission_log_get_time(LOG_SHIP_DESTROYED, ship_name, NULL, NULL) )
return SEXP_KNOWN_FALSE;
else if ( mission_log_get_time(LOG_SHIP_DEPARTED, ship_name, NULL, NULL) )
return SEXP_KNOWN_FALSE;
}
return SEXP_FALSE;
}
// function to determine is all of a given ship type are destroyed
int sexp_ship_type_destroyed(int n)
{
int percent;
int type;
char *shiptype;
percent = eval_num(n);
shiptype = CTEXT(CDR(n));
type = ship_type_name_lookup(shiptype);
// bogus if we reach the end of this array!!!!
if ( type < 0 ) {
Warning(LOCATION, "Invalid shiptype passed to ship-type-destroyed");
return SEXP_FALSE;
}
if ( type >= (int)Ship_type_counts.size() || Ship_type_counts[type].total == 0 )
return SEXP_FALSE;
//We are safe from array indexing probs b/c of previous if.
// determine if the percentage of killed/total is >= percentage given in the expression
if ( (Ship_type_counts[type].killed * 100 / Ship_type_counts[type].total) >= percent)
return SEXP_KNOWN_TRUE;
return SEXP_FALSE;
}
// following are time based functions
int sexp_has_time_elapsed(int n)
{
int time = eval_num(n);
if ( f2i(Missiontime) >= time )
return SEXP_KNOWN_TRUE;
return SEXP_FALSE;
}
// next function returns the time into the mission
int sexp_mission_time()
{
return f2i(Missiontime);
}
// returns percent of length of distance to special warpout plane
int sexp_special_warp_dist( int n)
{
char *ship_name;
int shipnum;
// get shipname
ship_name = CTEXT(n);
// check to see if either ship was destroyed or departed. If so, then make this node known
// false
if ( mission_log_get_time(LOG_SHIP_DESTROYED, ship_name, NULL, NULL) || mission_log_get_time( LOG_SHIP_DEPARTED, ship_name, NULL, NULL) ) {
return SEXP_NAN_FOREVER;
}
// get ship name
shipnum = ship_name_lookup(ship_name);
if (shipnum < 0) {
return SEXP_NAN;
}
// check that ship has warpout_objnum
if (Ships[shipnum].special_warp_objnum == -1) {
return SEXP_NAN;
}
Assert( (Ships[shipnum].special_warp_objnum >= 0) && (Ships[shipnum].special_warp_objnum < MAX_OBJECTS));
if ( (Ships[shipnum].special_warp_objnum < 0) && (Ships[shipnum].special_warp_objnum >= MAX_OBJECTS) ) {
return SEXP_NAN;
}
// check the special warpout device is valid
int valid = FALSE;
object *ship_objp = &Objects[Ships[shipnum].objnum];
object *warp_objp = &Objects[Ships[shipnum].special_warp_objnum];
if (warp_objp->type == OBJ_SHIP) {
if (Ship_info[Ships[warp_objp->instance].ship_info_index].flags & SIF_KNOSSOS_DEVICE) {
valid = TRUE;
}
}
if (!valid) {
return SEXP_NAN;
}
// check if within 45 degree half-angle cone of facing
float dot = fl_abs(vm_vec_dotprod(&warp_objp->orient.vec.fvec, &ship_objp->orient.vec.fvec));
if (dot < 0.707f) {
return SEXP_NAN;
}
// get distance
vec3d hit_pt;
float dist = fvi_ray_plane(&hit_pt, &warp_objp->pos, &warp_objp->orient.vec.fvec, &ship_objp->pos, &ship_objp->orient.vec.fvec, 0.0f);
polymodel *pm = model_get(Ship_info[Ships[shipnum].ship_info_index].model_num);
dist += pm->mins.xyz.z;
// return as a percent of length
return (int) (100.0f * dist / ship_class_get_length(&Ship_info[Ships[shipnum].ship_info_index]));
}
int sexp_time_destroyed(int n)
{
fix time;
if ( !mission_log_get_time( LOG_SHIP_DESTROYED, CTEXT(n), NULL, &time) ){ // returns 0 when not found
return SEXP_NAN;
}
return f2i(time);
}
int sexp_time_wing_destroyed(int n)
{
fix time;
if ( !mission_log_get_time( LOG_WING_DESTROYED, CTEXT(n), NULL, &time) ){
return SEXP_NAN;
}
return f2i(time);
}
int sexp_time_docked(int n)
{
fix time;
char *docker = CTEXT(n);
char *dockee = CTEXT(CDR(n));
int count = eval_num(CDR(CDR(n)));
Assert ( count > 0 );
if ( !mission_log_get_time_indexed(LOG_SHIP_DOCKED, docker, dockee, count, &time) ){
return SEXP_NAN;
}
return f2i(time);
}
int sexp_time_undocked(int n)
{
fix time;
char *docker = CTEXT(n);
char *dockee = CTEXT(CDR(n));
int count = eval_num(CDR(CDR(n)));
Assert ( count > 0 );
if ( !mission_log_get_time_indexed(LOG_SHIP_UNDOCKED, docker, dockee, count, &time) ){
return SEXP_NAN;
}
return f2i(time);
}
int sexp_time_ship_arrived(int n)
{
fix time;
Assert( n != -1 );
if ( !mission_log_get_time( LOG_SHIP_ARRIVED, CTEXT(n), NULL, &time ) ){
return SEXP_NAN;
}
return f2i(time);
}
int sexp_time_wing_arrived(int n)
{
fix time;
Assert( n != -1 );
if ( !mission_log_get_time( LOG_WING_ARRIVED, CTEXT(n), NULL, &time ) ){
return SEXP_NAN;
}
return f2i(time);
}
int sexp_time_ship_departed(int n)
{
fix time;
Assert( n != -1 );
if ( !mission_log_get_time( LOG_SHIP_DEPARTED, CTEXT(n), NULL, &time ) ){
return SEXP_NAN;
}
return f2i(time);
}
int sexp_time_wing_departed(int n)
{
fix time;
Assert( n != -1 );
if ( !mission_log_get_time(LOG_WING_DEPARTED, CTEXT(n), NULL, &time ) ){
return SEXP_NAN;
}
return f2i(time);
}
void sexp_set_energy_pct (int node, int op_num)
{
int sindex;
float new_pct;
char *shipname;
ship * shipp;
ship_info * sip;
Assert (node > -1);
new_pct = eval_num(node) / 100.0f;
// deal with ridiculous percentages
if (new_pct > 1.0f) {
new_pct = 1.0f;
}
else if (new_pct < 0.0f) {
new_pct = 0.0f;
}
// only need to send a packet for afterburners because shields and weapon energy are sent from server to clients
if (MULTIPLAYER_MASTER && (op_num == OP_SET_AFTERBURNER_ENERGY)) {
multi_start_packet();
multi_send_float(new_pct);
}
node = CDR(node);
while (node > -1) {
// get the ship
shipname = CTEXT(node);
sindex = ship_name_lookup( shipname );
if ( sindex == -1 ){ // hmm.. if true, must not have arrived yet
continue;
}
shipp = &Ships[sindex];
sip = &Ship_info[Ships[sindex].ship_info_index];
switch (op_num) {
case OP_SET_AFTERBURNER_ENERGY:
shipp->afterburner_fuel = sip->afterburner_fuel_capacity * new_pct;
break;
case OP_SET_WEAPON_ENERGY:
if (!(ship_has_energy_weapons(shipp)) ) {
node = CDR(node);
continue;
}
shipp->weapon_energy = sip->max_weapon_reserve * new_pct;
break;
case OP_SET_SHIELD_ENERGY:
if (shipp->ship_max_shield_strength == 0.0f) {
node = CDR(node);
continue;
}
shield_set_strength(&Objects[shipp->objnum], (shipp->ship_max_shield_strength * new_pct));
break;
}
if (MULTIPLAYER_MASTER && (op_num == OP_SET_AFTERBURNER_ENERGY)) {
multi_send_ship(shipp);
}
node = CDR(node);
}
if (MULTIPLAYER_MASTER && (op_num == OP_SET_AFTERBURNER_ENERGY)) {
multi_end_packet();
}
}
void multi_sexp_set_energy_pct()
{
ship *shipp;
float new_pct;
ship_info * sip;
int op_num = multi_sexp_get_operator();
multi_get_float(new_pct);
while (multi_get_ship(shipp)) {
sip = &Ship_info[shipp->ship_info_index];
switch (op_num) {
case OP_SET_AFTERBURNER_ENERGY:
shipp->afterburner_fuel = sip->afterburner_fuel_capacity * new_pct;
break;
case OP_SET_WEAPON_ENERGY:
shipp->weapon_energy = sip->max_weapon_reserve * new_pct;
break;
case OP_SET_SHIELD_ENERGY:
shield_set_strength(&Objects[shipp->objnum], (shipp->ship_max_shield_strength * new_pct));
break;
}
}
}
int sexp_get_energy_pct (int node, int op_num)
{
int sindex;
float maximum = 0.0f, current = 0.0f;
ship * shipp;
ship_info * sip;
char *shipname;
// get the ship
shipname = CTEXT(node);
sindex = ship_name_lookup( shipname );
if ( sindex == -1 ){ // has either not arrived yet or has departed
return SEXP_NAN;
}
shipp = &Ships[sindex];
sip = &Ship_info[Ships[sindex].ship_info_index];
switch (op_num) {
case OP_AFTERBURNER_LEFT:
maximum = sip->afterburner_fuel_capacity;
current = shipp->afterburner_fuel;
break;
case OP_WEAPON_ENERGY_LEFT:
if (ship_has_energy_weapons(shipp)) {
maximum = sip->max_weapon_reserve;
current = shipp->weapon_energy;
}
break;
}
if (maximum < WEAPON_RESERVE_THRESHOLD || current < WEAPON_RESERVE_THRESHOLD) {
return 0;
}
return (int)(100 * (current/maximum));
}
// function to return the remaining shields as a percentage of the given ship.
int sexp_shields_left(int n)
{
int shipnum, percent;
char *shipname;
shipname = CTEXT(n);
// if ship is gone or departed, cannot ever evaluate properly. Return NAN_FOREVER
if ( mission_log_get_time(LOG_SHIP_DESTROYED, shipname, NULL, NULL) || mission_log_get_time( LOG_SHIP_DEPARTED, shipname, NULL, NULL) ){
return SEXP_NAN_FOREVER;
}
shipnum = ship_name_lookup( shipname );
if ( shipnum == -1 ){ // hmm.. if true, must not have arrived yet
return SEXP_NAN;
}
// Goober5000: in case ship has no shields
if (Ships[shipnum].ship_max_shield_strength == 0.0f)
{
return 0;
}
// now return the amount of shields left as a percentage of the whole.
percent = fl2i((get_shield_pct(&Objects[Ships[shipnum].objnum]) * 100.0f) + 0.5f);
return percent;
}
// function to return the remaining hits left as a percentage of the whole. This hit amount counts for
// all hits on the ship (hull + subsystems). Use hits_left_hull to find hull hits remaining.
int sexp_hits_left(int n)
{
int shipnum, percent;
char *shipname;
shipname = CTEXT(n);
// if ship is gone or departed, cannot ever evaluate properly. Return NAN_FOREVER
if ( mission_log_get_time(LOG_SHIP_DESTROYED, shipname, NULL, NULL) || mission_log_get_time( LOG_SHIP_DEPARTED, shipname, NULL, NULL) ){
return SEXP_NAN_FOREVER;
}
shipnum = ship_name_lookup( shipname );
if ( shipnum == -1 ){ // hmm.. if true, must not have arrived yet
return SEXP_NAN;
}
// now return the amount of hits left as a percentage of the whole. Subtract the percentage from 100
// since we are working with total hit points taken, not total remaining.
ship *shipp = &Ships[shipnum];
object *objp = &Objects[shipp->objnum];
percent = fl2i((100.0f * get_hull_pct(objp)) + 0.5f);
return percent;
}
int sexp_sim_hits_left(int n)
{
int shipnum, percent;
char *shipname;
shipname = CTEXT(n);
// if ship is gone or departed, cannot ever evaluate properly. Return NAN_FOREVER
if ( mission_log_get_time(LOG_SHIP_DESTROYED, shipname, NULL, NULL) || mission_log_get_time( LOG_SHIP_DEPARTED, shipname, NULL, NULL) ){
return SEXP_NAN_FOREVER;
}
shipnum = ship_name_lookup( shipname );
if ( shipnum == -1 ){ // hmm.. if true, must not have arrived yet
return SEXP_NAN;
}
// now return the amount of hits left as a percentage of the whole. Subtract the percentage from 100
// since we are working with total hit points taken, not total remaining.
ship *shipp = &Ships[shipnum];
object *objp = &Objects[shipp->objnum];
percent = fl2i((100.0f * get_sim_hull_pct(objp)) + 0.5f);
return percent;
}
// is ship visible on radar
// returns 0 - not visible
// returns 1 - marginally targetable (jiggly on radar)
// returns 2 - fully targetable
int sexp_is_ship_visible(int n)
{
char *shipname;
int shipnum;
int ship_is_visible = 0;
// if multiplayer, bail
if (Game_mode & GM_MULTIPLAYER) {
return SEXP_NAN_FOREVER;
}
shipname = CTEXT(n);
// if ship is gone or departed, cannot ever evaluate properly. Return NAN_FOREVER
if ( mission_log_get_time(LOG_SHIP_DESTROYED, shipname, NULL, NULL) || mission_log_get_time( LOG_SHIP_DEPARTED, shipname, NULL, NULL) ){
return SEXP_NAN_FOREVER;
}
shipnum = ship_name_lookup( shipname );
if ( shipnum == -1 ){ // hmm.. if true, must not have arrived yet
return SEXP_NAN;
}
// get ship's *radar* visiblity
if (Player_ship != NULL)
{
if (ship_is_visible_by_team(&Objects[Ships[shipnum].objnum], Player_ship))
{
ship_is_visible = 2;
}
}
// only check awacs level if ship is not visible by team
if (Player_ship != NULL && !ship_is_visible) {
float awacs_level = awacs_get_level(&Objects[Ships[shipnum].objnum], Player_ship);
if (awacs_level >= 1.0f) {
ship_is_visible = 2;
} else if (awacs_level > 0) {
ship_is_visible = 1;
}
}
return ship_is_visible;
}
// is the stealth flag set on this ship
int sexp_is_ship_stealthy(int n)
{
char *shipname;
int shipnum;
shipname = CTEXT(n);
// if ship is gone or departed, cannot ever evaluate properly. Return NAN_FOREVER
if ( mission_log_get_time(LOG_SHIP_DESTROYED, shipname, NULL, NULL) || mission_log_get_time( LOG_SHIP_DEPARTED, shipname, NULL, NULL) ){
return SEXP_NAN_FOREVER;
}
shipnum = ship_name_lookup( shipname );
if ( shipnum == -1 ) { // hmm.. if true, must not have arrived yet
return SEXP_NAN;
}
if (Ships[shipnum].flags2 & SF2_STEALTH)
return SEXP_TRUE;
else
return SEXP_FALSE;
}
// is the friendly stealth ship visible
int sexp_is_friendly_stealth_visible(int n)
{
char *shipname;
int shipnum;
shipname = CTEXT(n);
// if ship is gone or departed, cannot ever evaluate properly. Return NAN_FOREVER
if ( mission_log_get_time(LOG_SHIP_DESTROYED, shipname, NULL, NULL) || mission_log_get_time( LOG_SHIP_DEPARTED, shipname, NULL, NULL) ){
return SEXP_NAN_FOREVER;
}
shipnum = ship_name_lookup( shipname );
if ( shipnum == -1 ) { // hmm.. if true, must not have arrived yet
return SEXP_NAN;
}
if (Ships[shipnum].flags2 & SF2_FRIENDLY_STEALTH_INVIS)
return SEXP_FALSE;
else
return SEXP_TRUE;
}
// get multi team v team score
// if not multi team v team return 0
// if invalid team return 0
int sexp_team_score(int node)
{
// if multi t vs t
if (Game_mode & GM_MULTIPLAYER) {
if (Netgame.type_flags & NG_TYPE_TEAM) {
int team = eval_num(node);
// Teams can only be 1 or 2 at the moment but we should use Num_teams in case more become possible in the future
if (team <= 0 || team > Num_teams)
{
// invalid team index
Warning(LOCATION, "sexp-team-score: team %d is not a valid team #", team);
return 0;
}
return Multi_team_score[team - 1];
}
}
return 0;
}
// function to return the remaining hits left on a subsystem as a percentage of thw whole.
int sexp_hits_left_subsystem(int n)
{
int shipnum, percent, type, single_subsystem = 0;
char *shipname;
char *subsys_name;
shipname = CTEXT(n);
// if ship is gone or departed, cannot ever evaluate properly. Return NAN_FOREVER
if ( mission_log_get_time(LOG_SHIP_DESTROYED, shipname, NULL, NULL) || mission_log_get_time( LOG_SHIP_DEPARTED, shipname, NULL, NULL) ){
return SEXP_NAN_FOREVER;
}
shipnum = ship_name_lookup( shipname );
if ( shipnum == -1 ){ // hmm.. if true, must not have arrived yet
return SEXP_NAN;
}
subsys_name = CTEXT(CDR(n));
type = ai_get_subsystem_type( subsys_name );
if ( (type >= 0) && (type < SUBSYSTEM_MAX) ) {
// check for the optional argument
n = CDDR(n);
if (n >= 0) {
single_subsystem = is_sexp_true(n);
}
// if the third option is present or if this is an unknown subsystem type we only want to find the percentage of the
// named subsystem
if (single_subsystem || (type == SUBSYSTEM_UNKNOWN)) {
// find the ship subsystem by searching ship's subsys_list
ship_subsys *ss;
ss = GET_FIRST( &Ships[shipnum].subsys_list );
while ( ss != END_OF_LIST( &Ships[shipnum].subsys_list ) ) {
if ( !subsystem_stricmp(ss->system_info->subobj_name, subsys_name)) {
percent = fl2i((ss->current_hits / ss->max_hits * 100.0f) + 0.5f);
return percent;
}
ss = GET_NEXT( ss );
}
// we reached end of ship subsys list without finding subsys_name
if (ship_class_unchanged(shipnum)) {
Error(LOCATION, "Invalid subsystem '%s' passed to hits-left-subsystem", subsys_name);
}
return SEXP_NAN;
// by default we return as a percentage the hits remaining on the subsystem as a whole (i.e. for 3 engines,
// we are returning the sum of the hits on the 3 engines)
} else {
percent = fl2i((ship_get_subsystem_strength(&Ships[shipnum],type) * 100.0f) + 0.5f);
return percent;
}
}
return SEXP_NAN; // if for some strange reason, the type field of the subsystem is bogus
}
int sexp_determine_team(char *subj)
{
int len;
char team_name[NAME_LENGTH];
// quick check
if (strnicmp(subj, "<any ", 5))
return -1;
// grab IFF (rest of string except for closing angle bracket)
len = strlen(subj + 5) - 1;
strncpy(team_name, subj + 5, len);
team_name[len] = '\0';
// find it
return iff_lookup(team_name);
}
// check distance between two given objects
int sexp_distance3(object *objp1, object *objp2)
{
// if either object isn't present in the mission now
if (objp1 == NULL || objp2 == NULL)
return SEXP_NAN;
if ((objp1->type == OBJ_SHIP) && (objp2->type == OBJ_SHIP))
{
if (Player_obj == objp1)
return (int) hud_find_target_distance(objp2, objp1);
else
return (int) hud_find_target_distance(objp1, objp2);
}
else
{
return (int) vm_vec_dist_quick(&objp1->pos, &objp2->pos);
}
}
// check distance between a given ship and a given subject (ship, wing, any <team>).
int sexp_distance2(object *objp1, object_ship_wing_point_team *oswpt2)
{
int dist, dist_min = 0, inited = 0;
switch (oswpt2->type)
{
// we have a team type, so check all ships of that type
case OSWPT_TYPE_TEAM:
{
for (ship_obj *so = GET_FIRST(&Ship_obj_list); so != END_OF_LIST(&Ship_obj_list); so = GET_NEXT(so))
{
if (Ships[Objects[so->objnum].instance].team == oswpt2->team)
{
dist = sexp_distance3(objp1, &Objects[so->objnum]);
if (dist != SEXP_NAN)
{
if (!inited || (dist < dist_min))
{
dist_min = dist;
inited = 1;
}
}
}
}
// no objects were checked
if (!inited)
return SEXP_NAN;
return dist_min;
}
// check ships and points
case OSWPT_TYPE_SHIP:
case OSWPT_TYPE_WAYPOINT:
{
return sexp_distance3(objp1, oswpt2->objp);
}
// check wings
case OSWPT_TYPE_WING:
{
for (int i = 0; i < oswpt2->wingp->current_count; i++)
{
dist = sexp_distance3(objp1, &Objects[Ships[oswpt2->wingp->ship_index[i]].objnum]);
if (dist != SEXP_NAN)
{
if (!inited || (dist < dist_min))
{
dist_min = dist;
inited = 1;
}
}
}
// no objects were checked
if (!inited)
return SEXP_NAN;
return dist_min;
}
}
return SEXP_NAN;
}
// returns the distance between two objects. If a wing is specified as one (or both) of the arguments
// to this function, we are looking for the closest distance
int sexp_distance(int n)
{
int dist, dist_min = 0, inited = 0;
object_ship_wing_point_team oswpt1, oswpt2;
sexp_get_object_ship_wing_point_team(&oswpt1, CTEXT(n));
sexp_get_object_ship_wing_point_team(&oswpt2, CTEXT(CDR(n)));
// check to see if either object was destroyed or departed
if (oswpt1.type == OSWPT_TYPE_EXITED || oswpt2.type == OSWPT_TYPE_EXITED)
return SEXP_NAN_FOREVER;
switch (oswpt1.type)
{
// we have a team type, so check all ships of that type
case OSWPT_TYPE_TEAM:
{
for (ship_obj *so = GET_FIRST(&Ship_obj_list); so != END_OF_LIST(&Ship_obj_list); so = GET_NEXT(so))
{
if (Ships[Objects[so->objnum].instance].team == oswpt1.team)
{
dist = sexp_distance2(&Objects[so->objnum], &oswpt2);
if (dist != SEXP_NAN)
{
if (!inited || (dist < dist_min))
{
dist_min = dist;
inited = 1;
}
}
}
}
// no objects were checked
if (!inited)
return SEXP_NAN;
return dist_min;
}
// check ships and points
case OSWPT_TYPE_SHIP:
case OSWPT_TYPE_WAYPOINT:
{
return sexp_distance2(oswpt1.objp, &oswpt2);
}
// check wings
case OSWPT_TYPE_WING:
{
for (int i = 0; i < oswpt1.wingp->current_count; i++)
{
dist = sexp_distance2(&Objects[Ships[oswpt1.wingp->ship_index[i]].objnum], &oswpt2);
if (dist != SEXP_NAN)
{
if (!inited || (dist < dist_min))
{
dist_min = dist;
inited = 1;
}
}
}
// no objects were checked
if (!inited)
return SEXP_NAN;
return dist_min;
}
}
return SEXP_NAN;
}
// locate the subsystem on a ship - Goober5000
// Karajorma - switched to a boolean so that it can report failure to do so
bool sexp_get_subsystem_world_pos(vec3d *subsys_world_pos, int shipnum, char *subsys_name)
{
Assert(subsys_name);
Assert(subsys_world_pos);
ship_subsys *ss;
if(shipnum < 0)
{
Error(LOCATION, "Error - nonexistent ship.\n");
}
// find the ship subsystem by searching ship's subsys_list
ss = GET_FIRST( &Ships[shipnum].subsys_list );
while ( ss != END_OF_LIST( &Ships[shipnum].subsys_list ) )
{
// if we found the subsystem
if ( !subsystem_stricmp(ss->system_info->subobj_name, subsys_name))
{
// find world position of subsystem on this object (the ship)
get_subsystem_world_pos(&Objects[Ships[shipnum].objnum], ss, subsys_world_pos);
return true;
}
ss = GET_NEXT( ss );
}
// we reached end of ship subsys list without finding subsys_name
if (ship_class_unchanged(shipnum)) {
// this ship should have had the subsystem named as it shouldn't have changed class
Error(LOCATION, "sexp_get_subsystem_world_pos could not find subsystem '%s'", subsys_name);
}
return false;
}
// Goober5000
// returns the distance between an object and a ship subsystem. If a wing is specified as the object argument
// to this function, we are looking for the closest distance
int sexp_distance_subsystem(int n)
{
int ship_with_subsys_num, dist, dist_min = 0, inited = 0;
char *ship_with_subsys_name, *subsys_name;
vec3d subsys_pos;
object_ship_wing_point_team oswpt;
sexp_get_object_ship_wing_point_team(&oswpt, CTEXT(n));
ship_with_subsys_name = CTEXT(CDR(n));
subsys_name = CTEXT(CDR(CDR(n)));
// for the ship with the subsystem - see if it was destroyed or departed
if (mission_log_get_time(LOG_SHIP_DESTROYED, ship_with_subsys_name, NULL, NULL) || mission_log_get_time(LOG_SHIP_DEPARTED, ship_with_subsys_name, NULL, NULL))
return SEXP_NAN_FOREVER;
// check the other ship too
if (oswpt.type == OSWPT_TYPE_EXITED)
return SEXP_NAN_FOREVER;
// for the ship with the subsystem - get its index
ship_with_subsys_num = ship_name_lookup(ship_with_subsys_name);
if (ship_with_subsys_num < 0)
return SEXP_NAN;
// get the subsystem's coordinates or bail if we can't
if (!sexp_get_subsystem_world_pos(&subsys_pos, ship_with_subsys_num, subsys_name))
return SEXP_NAN;
switch (oswpt.type)
{
// we have a team type, so check all ships of that type
case OSWPT_TYPE_TEAM:
{
for (ship_obj *so = GET_FIRST(&Ship_obj_list); so != END_OF_LIST(&Ship_obj_list); so = GET_NEXT(so))
{
if (Ships[Objects[so->objnum].instance].team == oswpt.team)
{
dist = (int) vm_vec_dist_quick(&Objects[so->objnum].pos, &subsys_pos);
if (!inited || (dist < dist_min))
{
dist_min = dist;
inited = 1;
}
}
}
// no objects were checked
if (!inited)
return SEXP_NAN;
return dist_min;
}
// check ships and points
case OSWPT_TYPE_SHIP:
case OSWPT_TYPE_WAYPOINT:
{
return (int) vm_vec_dist_quick(&oswpt.objp->pos, &subsys_pos);
}
// check wings
case OSWPT_TYPE_WING:
{
for (int i = 0; i < oswpt.wingp->current_count; i++)
{
dist = (int) vm_vec_dist_quick(&Objects[Ships[oswpt.wingp->ship_index[i]].objnum].pos, &subsys_pos);
if (!inited || (dist < dist_min))
{
dist_min = dist;
inited = 1;
}
}
// no objects were checked
if (!inited)
return SEXP_NAN;
return dist_min;
}
}
return SEXP_NAN;
}
bool sexp_helper_is_within_box(float *box_vals, vec3d *pos)
{
int i;
for(i = 0; i < 3; i++)
{
if(pos->a1d[i] < (box_vals[i] - box_vals[i+3])
|| pos->a1d[i] > (box_vals[i] + box_vals[i+3]))
{
return false;
}
}
return true;
}
int sexp_num_within_box(int n)
{
float box_vals[6];//x,y,z,width,height,depth
char *ship_wing;
int i, idx;
int retval = 0;
for(i = 0; i < 6; i++)
{
box_vals[i] = i2fl(eval_num(n));
n = CDR(n);
}
for(;n != -1; n = CDR(n))
{
ship_wing = CTEXT(n);
idx = ship_name_lookup(ship_wing);
if(idx > -1)
{
if(sexp_helper_is_within_box(box_vals, &Objects[Ships[idx].objnum].pos))
retval++;
}
else
{
idx = wing_name_lookup(ship_wing);
if(idx > -1)
{
bool wing_check = true;
for(i = 0; i < Wings[idx].current_count; i++)
{
if(!sexp_helper_is_within_box(box_vals, &Objects[Ships[Wings[idx].ship_index[i]].objnum].pos))
{
wing_check = false;
break;
}
}
if(wing_check)
retval++;
}
}
}
return retval;
}
// Goober5000
void sexp_set_object_speed(object *objp, int speed, int axis, int subjective)
{
Assert(axis >= 0 && axis <= 2);
if (subjective)
{
vec3d subjective_vel;
// translate objective into subjective velocity
vm_vec_rotate(&subjective_vel, &objp->phys_info.vel, &objp->orient);
// set it
subjective_vel.a1d[axis] = i2fl(speed);
// translate it back to objective
vm_vec_unrotate(&objp->phys_info.vel, &subjective_vel, &objp->orient);
}
else
{
objp->phys_info.vel.a1d[axis] = i2fl(speed);
}
}
// Goober5000
void sexp_set_object_speed(int n, int axis)
{
Assert(n >= 0);
int speed, subjective = 0;
object_ship_wing_point_team oswpt;
sexp_get_object_ship_wing_point_team(&oswpt, CTEXT(n));
n = CDR(n);
speed = eval_num(n);
n = CDR(n);
if (n >= 0)
{
subjective = is_sexp_true(n);
n = CDR(n);
}
switch (oswpt.type)
{
case OSWPT_TYPE_SHIP:
case OSWPT_TYPE_WING:
case OSWPT_TYPE_WAYPOINT:
case OSWPT_TYPE_TEAM:
sexp_set_object_speed(oswpt.objp, speed, axis, subjective);
break;
}
}
// Goober5000
int sexp_calculate_coordinate(vec3d *origin, matrix *orient, vec3d *relative_location, int axis)
{
Assert(origin != NULL);
Assert(orient != NULL);
Assert(axis >= 0 && axis <= 2);
if (relative_location == NULL)
{
return fl2i(origin->a1d[axis]);
}
else
{
vec3d new_world_pos;
vm_vec_unrotate(&new_world_pos, relative_location, orient);
vm_vec_add2(&new_world_pos, origin);
return fl2i(new_world_pos.a1d[axis]);
}
}
// Goober5000
int sexp_get_object_coordinate(int n, int axis)
{
Assert(n >= 0);
char *subsystem_name = NULL;
vec3d *pos = NULL, *relative_location = NULL, relative_location_buf, subsys_pos_buf;
object_ship_wing_point_team oswpt;
sexp_get_object_ship_wing_point_team(&oswpt, CTEXT(n));
n = CDR(n);
if (n >= 0)
{
subsystem_name = CTEXT(n);
n = CDR(n);
if (n >= 0)
{
relative_location = &relative_location_buf;
relative_location->xyz.x = (float) eval_num(n);
n = CDR(n);
relative_location->xyz.y = (float) eval_num(n);
n = CDR(n);
relative_location->xyz.z = (float) eval_num(n);
n = CDR(n);
}
}
switch (oswpt.type)
{
case OSWPT_TYPE_EXITED:
return SEXP_NAN_FOREVER;
case OSWPT_TYPE_SHIP:
case OSWPT_TYPE_WING:
case OSWPT_TYPE_WAYPOINT:
case OSWPT_TYPE_TEAM:
pos = &oswpt.objp->pos;
break;
default:
return SEXP_NAN;
}
// see if we have a subsys
if (oswpt.objp->type == OBJ_SHIP)
{
if ((subsystem_name != NULL) && stricmp(subsystem_name, SEXP_NONE_STRING) && stricmp(subsystem_name, SEXP_HULL_STRING))
{
pos = &subsys_pos_buf;
// get the world pos but bail if we can't get one
if (!sexp_get_subsystem_world_pos(pos, oswpt.objp->instance, subsystem_name))
return SEXP_NAN;
}
}
return sexp_calculate_coordinate(pos, &oswpt.objp->orient, relative_location, axis);
}
void sexp_set_object_position(int n)
{
vec3d target_vec, orig_leader_vec;
object_ship_wing_point_team oswpt;
sexp_get_object_ship_wing_point_team(&oswpt, CTEXT(n));
n = CDR(n);
target_vec.xyz.x = i2fl(eval_num(n));
n = CDR(n);
target_vec.xyz.y = i2fl(eval_num(n));
n = CDR(n);
target_vec.xyz.z = i2fl(eval_num(n));
n = CDR(n);
// retime all collision checks so they're performed
obj_all_collisions_retime();
switch (oswpt.type)
{
case OSWPT_TYPE_TEAM:
{
// move the first one first
orig_leader_vec = oswpt.objp->pos;
oswpt.objp->pos = target_vec;
// move everything on the team
for (ship_obj *so = GET_FIRST(&Ship_obj_list); so != END_OF_LIST(&Ship_obj_list); so = GET_NEXT(so))
{
object *objp = &Objects[so->objnum];
if ((Ships[objp->instance].team == oswpt.team) && (objp != oswpt.objp))
{
vm_vec_sub2(&objp->pos, &orig_leader_vec);
vm_vec_add2(&objp->pos, &target_vec);
}
}
return;
}
case OSWPT_TYPE_SHIP:
case OSWPT_TYPE_WAYPOINT:
{
oswpt.objp->pos = target_vec;
// Tell the player that they've moved.
if( Game_mode & GM_MULTIPLAYER ) {
multi_oo_send_changed_object(oswpt.objp);
}
return;
}
case OSWPT_TYPE_WING:
{
// move the wing leader first
orig_leader_vec = oswpt.objp->pos;
oswpt.objp->pos = target_vec;
// move everything in the wing
for (int i = 0; i < oswpt.wingp->current_count; i++)
{
object *objp = &Objects[Ships[oswpt.wingp->ship_index[i]].objnum];
if (objp != oswpt.objp)
{
vm_vec_sub2(&objp->pos, &orig_leader_vec);
vm_vec_add2(&objp->pos, &target_vec);
}
}
return;
}
}
}
// Goober5000
void sexp_set_object_orient(object *objp, vec3d *location, int turn_time, int bank)
{
Assert(objp && location);
vec3d v_orient;
matrix m_orient;
// are we doing this via ai? -------------------
if (turn_time)
{
// set flag
bank = bank ? AITTV_IGNORE_BANK : 0;
// turn
ai_turn_towards_vector(location, objp, flFrametime, float(turn_time)/(1000.0f), NULL, NULL, 0.0f, 0, NULL, (AITTV_VIA_SEXP | bank));
// return
return;
}
// calculate orientation matrix ----------------
memset(&v_orient, 0, sizeof(vec3d));
vm_vec_sub(&v_orient, location, &objp->pos);
if (IS_VEC_NULL(&v_orient))
{
Warning(LOCATION, "error in sexp setting ship orientation: can't point to self; quitting...\n");
return;
}
vm_vector_2_matrix(&m_orient, &v_orient, NULL, NULL);
// set orientation -----------------------------
objp->orient = m_orient;
// Tell the player that they've moved.
if( Game_mode & GM_MULTIPLAYER ) {
multi_oo_send_changed_object(objp);
}
}
// Goober5000
void sexp_set_oswpt_facing(object_ship_wing_point_team *oswpt, vec3d *location, int turn_time = 0, int bank = 0)
{
Assert(oswpt && location);
switch (oswpt->type)
{
case OSWPT_TYPE_TEAM:
{
for (ship_obj *so = GET_FIRST(&Ship_obj_list); so != GET_LAST(&Ship_obj_list); so = GET_NEXT(so))
{
object *objp = &Objects[so->objnum];
if (obj_team(objp) == oswpt->team)
sexp_set_object_orient(objp, location, turn_time, bank);
}
break;
}
case OSWPT_TYPE_SHIP:
case OSWPT_TYPE_WAYPOINT:
sexp_set_object_orient(oswpt->objp, location, turn_time, bank);
break;
case OSWPT_TYPE_WING:
{
for (int i = 0; i < oswpt->wingp->current_count; i++)
{
object *objp = &Objects[Ships[oswpt->wingp->ship_index[i]].objnum];
sexp_set_object_orient(objp, location, turn_time, bank);
}
break;
}
}
}
// Goober5000
void sexp_set_object_facing(int n, bool facing_object)
{
vec3d *location, location_buf;
int turn_time, bank;
object_ship_wing_point_team oswpt1, oswpt2;
sexp_get_object_ship_wing_point_team(&oswpt1, CTEXT(n));
n = CDR(n);
// ensure it's valid
if (oswpt1.objp == NULL)
return;
// get location
if (facing_object)
{
sexp_get_object_ship_wing_point_team(&oswpt2, CTEXT(n));
n = CDR(n);
// ensure it's valid
if (oswpt2.objp == NULL)
return;
location = &oswpt2.objp->pos;
}
else
{
location = &location_buf;
location->xyz.x = (float) eval_num(n);
n = CDR(n);
location->xyz.y = (float) eval_num(n);
n = CDR(n);
location->xyz.z = (float) eval_num(n);
n = CDR(n);
}
// get optional turn time and bank
turn_time = bank = 0;
if (n != -1)
{
turn_time = eval_num(n);
n = CDR(n);
}
if (n != -1)
{
bank = eval_num(n);
}
sexp_set_oswpt_facing(&oswpt1, location, turn_time, bank);
}
// funciton to determine when the last meaningful order was given to one or more ships. Returns
// true or false depending on whether or not a meaningful order was received
int sexp_last_order_time(int n)
{
int instance, i;
fix time;
char *name;
ai_goal *aigp;
time = i2f(eval_num(n));
Assert ( time >= 0 );
n = CDR(n);
while ( n != -1 ) {
name = CTEXT(n);
instance = ship_name_lookup(name);
if ( instance != -1 ) {
aigp = Ai_info[Ships[instance].ai_index].goals;
} else {
instance = wing_name_lookup(name);
if ( instance == -1 ) // if we cannot find ship or wing, return SEXP_FALSE
return SEXP_FALSE;
aigp = Wings[instance].ai_goals;
}
// with the ship, check the ai_goals structure for this ship and determine if there are any
// orders which are < time seconds since current mission time
for ( i = 0; i < MAX_AI_GOALS; i++ ) {
int mode;
mode = aigp->ai_mode;
if ( (mode != AI_GOAL_NONE) && (mode != AI_GOAL_WARP) )
if ( (aigp->time + time) > Missiontime )
break;
aigp++;
}
if ( i == MAX_AI_GOALS )
return SEXP_TRUE;
n = CDR(n);
}
return SEXP_FALSE;
}
// sexpression to return the number of players in the mission
int sexp_num_players()
{
int count;
object *objp;
count = 0;
for ( objp = GET_FIRST(&obj_used_list); objp != END_OF_LIST(&obj_used_list); objp = GET_NEXT(objp) ) {
if ( (objp->type == OBJ_SHIP) && (objp->flags & OF_PLAYER_SHIP) )
count++;
}
return count;
}
// expression to determine if the current skill level of the game is at least
// the skill level given in the sexpression
int sexp_skill_level_at_least(int n)
{
int i;
char *level_name;
level_name = CTEXT(n);
if (level_name == NULL)
return SEXP_FALSE;
for (i = 0; i < NUM_SKILL_LEVELS; i++ ) {
if ( !stricmp(level_name, Skill_level_names(i, 0)) ) {
if ( Game_skill_level >= i ){
return SEXP_TRUE;
} else {
return SEXP_FALSE;
}
}
}
// return SEXP_FALSE if not found!!!
return SEXP_FALSE;
}
int sexp_was_promotion_granted(int n)
{
if (Player->flags & PLAYER_FLAGS_PROMOTED)
return SEXP_TRUE;
return SEXP_FALSE;
}
int sexp_was_medal_granted(int n)
{
int i;
char *medal_name;
if (n < 0) {
if (Player->stats.m_medal_earned >= 0)
return SEXP_TRUE;
return SEXP_FALSE;
}
medal_name = CTEXT(n);
if (medal_name == NULL)
return SEXP_FALSE;
for (i=0; i<Num_medals; i++) {
if (!stricmp(medal_name, Medals[i].name))
break;
}
if ( (i < Num_medals) && (Player->stats.m_medal_earned == i) )
return SEXP_TRUE;
return SEXP_FALSE;
}
float get_damage_caused(int damaged_ship, int attacker )
{
int sindex, idx;
float damage_total = 0.0f;
// is the ship that took damage in the mission still?
sindex = ship_get_by_signature(damaged_ship);
if (sindex >= 0 ) {
for(idx=0; idx<MAX_DAMAGE_SLOTS; idx++){
if (Ships[sindex].damage_ship_id[idx] == attacker) {
damage_total += Ships[sindex].damage_ship[idx];
break;
}
}
}
else {
//TO DO - Add code to check the damage ships which have exited have taken
sindex = ship_find_exited_ship_by_signature(damaged_ship);
for(idx=0; idx<MAX_DAMAGE_SLOTS; idx++){
if (Ships_exited[sindex].damage_ship_id[idx] == attacker) {
damage_total += Ships_exited[sindex].damage_ship[idx];
break;
}
}
}
return damage_total;
}
// Karajorma
int sexp_get_damage_caused(int node)
{
int sindex, damaged_sig, attacker_sig;
float damage_caused = 0.0f;
char *name;
int ship_class;
name = CTEXT(node);
sindex = ship_name_lookup(name);
if (sindex < 0) {
// this ship may have exited already.
sindex = ship_find_exited_ship_by_name(CTEXT(node));
if (sindex < 0) {
// this is probably a ship which hasn't arrived and thus can't have taken any damage yet
return fl2i(damage_caused);
}
else {
damaged_sig = Ships_exited[sindex].obj_signature;
ship_class = Ships_exited[sindex].ship_class;
}
}
else {
damaged_sig = Objects[Ships[sindex].objnum].signature ;
ship_class = Ships[sindex].ship_info_index;
}
node = CDR(node);
Assert (node != -1);
// go through the list of ships who we think may have attacked the ship
for ( ; node != -1; node = CDR(node) ) {
name = CTEXT(node);
sindex = ship_name_lookup(name);
if (sindex < 0) {
sindex = ship_find_exited_ship_by_name(name);
attacker_sig = Ships_exited[sindex].obj_signature;
}
else {
attacker_sig = Objects[Ships[sindex].objnum].signature ;
}
if (attacker_sig < 0) {
continue;
}
damage_caused += get_damage_caused (damaged_sig, attacker_sig);
}
Assert ((ship_class > -1) && (ship_class < MAX_SHIP_CLASSES));
return (int) ((damage_caused/Ship_info[ship_class].max_hull_strength) * 100.0f);
}
// function which returns true if the percentage of ships (and ships in wings) departed is at
// least the percentage given. what determine if we should check destroyed or departed status
// Goober5000 - added disarm and disable
int sexp_percent_ships_depart_destroy_disarm_disable(int n, int what)
{
int percent;
int total, count;
char *name;
percent = eval_num(n);
total = 0;
count = 0;
// iterate through the rest of the ships/wings in the list and tally the departures and the
// total
for ( n = CDR(n); n != -1; n = CDR(n) ) {
int wingnum;
name = CTEXT(n);
wingnum = wing_name_lookup( name, 1 );
if ( wingnum != -1 ) {
// for wings, we can increment the total by the total number of ships that we expect for
// this wing, and the departures by the number of departures stored for this wing
total += (Wings[wingnum].wave_count * Wings[wingnum].num_waves);
if ( what == OP_PERCENT_SHIPS_DEPARTED )
count += Wings[wingnum].total_departed;
else if ( what == OP_PERCENT_SHIPS_DESTROYED )
count += Wings[wingnum].total_destroyed;
else
Error(LOCATION, "Invalid status check '%d' for wing '%s' in sexp_percent_ships_depart_destroy_disarm_disable", what, name);
} else {
// must be a ship, so increment the total by 1, then determine if this ship has departed
total++;
if ( what == OP_PERCENT_SHIPS_DEPARTED ) {
if ( mission_log_get_time(LOG_SHIP_DEPARTED, name, NULL, NULL) )
count++;
} else if ( what == OP_PERCENT_SHIPS_DESTROYED ) {
if ( mission_log_get_time(LOG_SHIP_DESTROYED, name, NULL, NULL) )
count++;
} else if ( what == OP_PERCENT_SHIPS_DISABLED ) {
if ( mission_log_get_time(LOG_SHIP_DISABLED, name, NULL, NULL) )
count++;
} else if ( what == OP_PERCENT_SHIPS_DISARMED ) {
if ( mission_log_get_time(LOG_SHIP_DISARMED, name, NULL, NULL) )
count++;
} else
Error("Invalid status check '%d' for ship '%s' in sexp_percent_ships_depart_destroy_disarm_disable", what, name);
}
}
// now, look at the percentage
if ( ((count * 100) / total) >= percent )
return SEXP_KNOWN_TRUE;
else
return SEXP_FALSE;
}
// function to tell is a list of ships has departed from within a radius of a given jump node.
// returns true N seconds after the list of ships have departed
int sexp_depart_node_delay(int n)
{
int delay, count, num_departed;
char *jump_node_name, *name;
fix latest_time, this_time;
Assert( n >= 0 );
delay = atoi( CTEXT(n) );
n = CDR(n);
jump_node_name = CTEXT(n);
// iterate through the list of ships
n = CDR(n);
latest_time = 0;
count = 0;
num_departed = 0;
while ( n != -1 ) {
count++;
name = CTEXT(n);
if (sexp_query_has_yet_to_arrive(name))
return SEXP_CANT_EVAL;
// if ship/wing destroyed, sexpression is known false. Also, if there is no departure log entry, then
// the sexpression is not true.
if ( mission_log_get_time(LOG_SHIP_DESTROYED, name, NULL, NULL) )
return SEXP_KNOWN_FALSE;
else if ( mission_log_get_time(LOG_SHIP_DEPARTED, name, jump_node_name, &this_time) ) {
num_departed++;
if ( this_time > latest_time )
latest_time = this_time;
}
n = CDR(n);
}
if ( (count == num_departed) && ((Missiontime - latest_time) >= delay) )
return SEXP_KNOWN_TRUE;
else
return SEXP_FALSE;
}
// sexpression which returns true when the listed ships/wings have all been destroyed or
// have departed.
int sexp_destroyed_departed_delay(int n)
{
int count, total;
fix delay, latest_time;
char *name;
Assert( n >= 0 );
// get the delay
delay = i2f(eval_num(n));
n = CDR(n);
count = 0; // number destroyed or departed
total = 0; // total number of ships/wings to check
latest_time = 0;
while ( n != -1 ) {
int wingnum;
fix time_gone = 0;
total++;
name = CTEXT(n);
// for wings, check the WF_GONE flag to see if there are no more ships in this wing to arrive.
wingnum = wing_name_lookup(name, 1);
if ( wingnum != -1 ) {
if ( Wings[wingnum].flags & WF_WING_GONE ) {
// be sure to get the latest time of one of these
if ( Wings[wingnum].time_gone > latest_time ){
time_gone = Wings[wingnum].time_gone;
}
count++;
}
} else if ( mission_log_get_time(LOG_SHIP_DEPARTED, name, NULL, &time_gone) ) {
count++;
} else if ( mission_log_get_time(LOG_SHIP_DESTROYED, name, NULL, &time_gone) ) {
count++;
} else if ( mission_log_get_time(LOG_SELF_DESTRUCTED, name, NULL, &time_gone) ) {
count++;
}
// check our latest time
if ( time_gone > latest_time ){
latest_time = time_gone;
}
n = CDR(n);
}
if ( (count == total) && (Missiontime > (latest_time + delay)) )
return SEXP_KNOWN_TRUE;
else
return SEXP_FALSE;
}
int sexp_special_warpout_name( int node )
{
int shipnum, knossos_shipnum;
char *ship_name, *knossos;
ship_name = CTEXT(node);
knossos = CTEXT(CDR(node));
// check to see if either ship was destroyed or departed. If so, then make this node known
// false
if ( mission_log_get_time(LOG_SHIP_DESTROYED, ship_name, NULL, NULL) || mission_log_get_time( LOG_SHIP_DEPARTED, ship_name, NULL, NULL) ||
mission_log_get_time(LOG_SHIP_DESTROYED, knossos, NULL, NULL) || mission_log_get_time( LOG_SHIP_DEPARTED, knossos, NULL, NULL) )
return SEXP_NAN_FOREVER;
// get ship name
shipnum = ship_name_lookup(ship_name);
if (shipnum < 0) {
return SEXP_NAN;
}
// get knossos ship
knossos_shipnum = ship_name_lookup(knossos);
if (knossos_shipnum < 0) {
return SEXP_NAN;
}
// set special warpout objnum
Ships[shipnum].special_warp_objnum = Ships[knossos_shipnum].objnum;
return SEXP_FALSE;
}
// function which determines if N seconds have elapsed since all discovery of all cargo
// of given ships
// Goober5000 - I reworked this function to allow for the set-scanned and set-unscanned sexps
// to work multiple times in a row and also to fix the potential bug where exited ships are
// checked against their departure time, not against their cargo known time
int sexp_is_cargo_known( int n, int check_delay )
{
int count, ship_num, num_known, delay;
char *name;
Assert ( n >= 0 );
count = 0;
num_known = 0;
// get the delay value (if there is one)
delay = 0;
if ( check_delay )
{
delay = eval_num(n);
n = CDR(n);
}
while ( n != -1 )
{
fix time_known;
int is_known;
is_known = 0;
count++;
// see if we have already checked this entry
if ( Sexp_nodes[n].value == SEXP_KNOWN_TRUE )
{
num_known++;
}
else
{
name = CTEXT(n);
// find the index in the ship array (will be -1 if not in mission)
ship_num = ship_name_lookup(name);
// see if the ship has already exited the mission (either through departure or destruction)
int exited_index = ship_find_exited_ship_by_name(name);
if (exited_index != -1)
{
// if not known, the whole thing is known false
if ( !(Ships_exited[exited_index].flags & SEF_CARGO_KNOWN) )
return SEXP_KNOWN_FALSE;
// check the delay of when we found out
time_known = Missiontime - Ships_exited[exited_index].time_cargo_revealed;
if ( f2i(time_known) >= delay )
{
is_known = 1;
// here is the only place in the new sexp that this can be known true
Sexp_nodes[n].value = SEXP_KNOWN_TRUE;
}
}
// ship either in mission or not arrived yet
else
{
// if ship_name_lookup returns -1, then ship is either exited or yet to arrive,
// and we've already checked exited
if ( ship_num != -1 )
{
if ( Ships[ship_num].flags & SF_CARGO_REVEALED )
{
time_known = Missiontime - Ships[ship_num].time_cargo_revealed;
if ( f2i(time_known) >= delay )
{
is_known = 1;
}
}
}
}
}
// if cargo is known, mark our variable, but not the sexp, because it may change later
if ( is_known )
{
num_known++;
}
n = CDR(n);
}
Directive_count += count - num_known;
if ( count == num_known )
return SEXP_TRUE;
else
return SEXP_FALSE;
}
void get_cap_subsys_cargo_flags(int shipnum, char *subsys_name, int *known, fix *time_revealed)
{
int subsys_set = 0;
ship_subsys *ss;
// find the ship subsystem by searching ship's subsys_list
ss = GET_FIRST( &Ships[shipnum].subsys_list );
while ( ss != END_OF_LIST( &Ships[shipnum].subsys_list ) )
{
// if we found the subsystem
if ( !subsystem_stricmp(ss->system_info->subobj_name, subsys_name))
{
// set the flags
*known = (ss->flags & SSF_CARGO_REVEALED);
*time_revealed = ss->time_subsys_cargo_revealed;
subsys_set = 1;
}
ss = GET_NEXT( ss );
}
// if we didn't find the subsystem, the ship hasn't arrived yet
if (!subsys_set)
{
*known = -1;
*time_revealed = 0;
}
}
// reworked by Goober5000 to allow for set-scanned and set-unscanned to be used more than once
int sexp_cap_subsys_cargo_known_delay(int n)
{
int delay, count, num_known, ship_num;
char *ship_name, *subsys_name;
num_known = 0;
count = 0;
Assert( n >= 0 );
// get delay
delay = eval_num(n);
n = CDR(n);
// get ship name
ship_name = CTEXT(n);
n = CDR(n);
// find the index in the ship array
ship_num = ship_name_lookup(ship_name);
while ( n != -1 )
{
fix time_known;
int is_known;
is_known = 0;
count++;
// see if we have already checked this entry
if ( Sexp_nodes[n].value == SEXP_KNOWN_TRUE )
{
num_known++;
}
else
{
// get subsys name
subsys_name = CTEXT(n);
// see if the ship has already exited the mission (either through departure or destruction)
if (ship_find_exited_ship_by_name(ship_name) != -1)
{
// check the delay of when we found out...
// Since there is no way to keep track of subsystem status once a ship has departed
// or has been destroyed, check the mission log. This will work in 99.9999999% of
// all cases; however, if the mission designer repeatedly sets and resets the scanned
// status of the subsystem, the mission log will only return the first occurrence of the
// subsystem cargo being revealed (regardless of whether it was first hidden using
// set-unscanned). Normally, ships keep track of cargo data in the subsystem struct,
// but once/ the ship has left the mission, the subsystem linked list is purged,
// causing the loss of this information. I judged the significant rework of the
// subsystem code not worth the rare instance that this sexp may be required to work
// in this way, especially since this problem only occurs after the ship departs. If
// the mission designer really needs this functionality, he or she can achieve the
// same result with creative combinations of event chaining and is-event-true.
if (!mission_log_get_time(LOG_CAP_SUBSYS_CARGO_REVEALED, ship_name, subsys_name, &time_known))
{
// if not known, the whole thing is known false
return SEXP_KNOWN_FALSE;
}
if (f2i(Missiontime - time_known) >= delay)
{
is_known = 1;
// here is the only place in the new sexp that this can be known true
Sexp_nodes[n].value = SEXP_KNOWN_TRUE;
}
}
// ship either in mission or not arrived yet
else
{
// if ship_name_lookup returns -1, then ship is either exited or yet to arrive,
// and we've already checked exited
if ( ship_num != -1 )
{
int cargo_revealed(0);
fix time_revealed(0);
// get flags
get_cap_subsys_cargo_flags(ship_num, subsys_name, &cargo_revealed, &time_revealed);
if (cargo_revealed)
{
time_known = Missiontime - time_revealed;
if ( f2i(time_known) >= delay )
{
is_known = 1;
}
}
}
}
}
// if cargo is known, mark our variable, but not the sexp, because it may change later
if (is_known)
{
num_known++;
}
n = CDR(n);
}
Directive_count += count - num_known;
if ( count == num_known )
return SEXP_TRUE;
else
return SEXP_FALSE;
}
// Goober5000
void sexp_set_scanned_unscanned(int n, int flag)
{
char *ship_name, *subsys_name;
int shipnum, subsys_set;
ship_subsys *ss;
// get ship name
ship_name = CTEXT(n);
// check to see the ship was destroyed or departed - if so, do nothing
if ( mission_log_get_time(LOG_SHIP_DESTROYED, ship_name, NULL, NULL) || mission_log_get_time( LOG_SHIP_DEPARTED, ship_name, NULL, NULL) )
{
return;
}
// get ship number
shipnum = ship_name_lookup(ship_name);
// if the ship isn't in the mission, do nothing
if (shipnum == -1)
{
return;
}
// check for possible next optional argument: subsystem
n = CDR(n);
// if no subsystem specified, just do it for the ship and exit
if (n == -1)
{
if (flag)
ship_do_cargo_revealed(&Ships[shipnum]);
else
ship_do_cargo_hidden(&Ships[shipnum]);
return;
}
// iterate through all subsystems
while (n != -1)
{
subsys_name = CTEXT(n);
subsys_set = 0;
// find the ship subsystem by searching ship's subsys_list
ss = GET_FIRST( &Ships[shipnum].subsys_list );
while ( ss != END_OF_LIST( &Ships[shipnum].subsys_list ) )
{
// if we found the subsystem
if ( !subsystem_stricmp(ss->system_info->subobj_name, subsys_name))
{
// do it for the subsystem
if (flag)
ship_do_cap_subsys_cargo_revealed(&Ships[shipnum], ss);
else
ship_do_cap_subsys_cargo_hidden(&Ships[shipnum], ss);
subsys_set = 1;
}
ss = GET_NEXT( ss );
}
// if we didn't find the subsystem -- bad
if (!subsys_set && ship_class_unchanged(shipnum)) {
Error(LOCATION, "Couldn't find subsystem '%s' on ship '%s' in sexp_set_scanned_unscanned", subsys_name, ship_name);
}
// but if it did, loop again
n = CDR(n);
}
}
int sexp_has_been_tagged_delay(int n)
{
int count, shipnum, num_known, delay;
char *name;
Assert ( n >= 0 );
count = 0;
num_known = 0;
// get the delay value
delay = eval_num(n);
n = CDR(n);
while ( n != -1 ) {
fix time_known;
int is_known;
is_known = 0;
count++;
// see if we have already checked this entry
if ( Sexp_nodes[n].value == SEXP_KNOWN_TRUE ) {
num_known++;
} else {
int exited_index;
name = CTEXT(n);
// see if the ship has already exited the mission (either through departure or destruction). If so,
// grab the status of whether the cargo is known from this list
exited_index = ship_find_exited_ship_by_name( name );
if (exited_index != -1 ) {
if ( !(Ships_exited[exited_index].flags & SEF_BEEN_TAGGED) )
return SEXP_KNOWN_FALSE;
// check the delay of when we found out. We use the ship died time which isn't entirely accurate
// but won't cause huge delays.
time_known = Missiontime - Ships_exited[exited_index].time;
if ( f2i(time_known) >= delay )
is_known = 1;
} else {
// otherwise, ship should still be in the mission. If ship_name_lookup returns -1, then ship
// is yet to arrive.
shipnum = ship_name_lookup( name );
if ( shipnum != -1 ) {
if ( Ships[shipnum].time_first_tagged != 0 ) {
time_known = Missiontime - Ships[shipnum].time_first_tagged;
if ( f2i(time_known) >= delay )
is_known = 1;
}
}
}
}
// if cargo is known, mark our variable and this sexpression.
if ( is_known ) {
num_known++;
Sexp_nodes[n].value = SEXP_KNOWN_TRUE;
}
n = CDR(n);
}
Directive_count += count - num_known;
if ( count == num_known )
return SEXP_KNOWN_TRUE;
else
return SEXP_FALSE;
}
// Karajorma
void eval_when_for_each_special_argument( int cur_node )
{
arg_item *ptr;
// loop through all the supplied arguments
ptr = Sexp_applicable_argument_list.get_next();
while (ptr != NULL)
{
// acquire argument to be used
Sexp_replacement_arguments.push_back(ptr->text);
Sexp_current_argument_nesting_level++;
Sexp_applicable_argument_list.add_data(ptr->text);
// execute sexp... CTEXT will insert the argument as necessary
eval_sexp(cur_node);
// clean up any special sexp stuff
Sexp_applicable_argument_list.clear_nesting_level();
Sexp_current_argument_nesting_level--;
// remove the argument
Sexp_replacement_arguments.pop_back();
// continue along argument list
ptr = ptr->get_next();
}
}
// Goober5000
void do_action_for_each_special_argument( int cur_node )
{
arg_item *ptr;
// loop through all the supplied arguments
ptr = Sexp_applicable_argument_list.get_next();
while (ptr != NULL)
{
// acquire argument to be used
Sexp_replacement_arguments.push_back(ptr->text);
// execute sexp... CTEXT will insert the argument as necessary
// (since these are all actions, they don't return any meaningful values)
eval_sexp(cur_node);
// remove the argument
Sexp_replacement_arguments.pop_back();
// continue along argument list
ptr = ptr->get_next();
}
}
// Goober5000
int special_argument_appears_in_sexp_tree(int node)
{
// empty tree
if (node < 0)
return 0;
// special argument?
if (!strcmp(Sexp_nodes[node].text, SEXP_ARGUMENT_STRING))
return 1;
// we don't want to include special arguments if they are nested in a new argument SEXP
if (Sexp_nodes[node].type == SEXP_ATOM && Sexp_nodes[node].subtype == SEXP_ATOM_OPERATOR) {
switch (get_operator_const(CTEXT(node))) {
case OP_WHEN_ARGUMENT:
case OP_EVERY_TIME_ARGUMENT:
return 0;
}
}
return special_argument_appears_in_sexp_tree(CAR(node))
|| special_argument_appears_in_sexp_tree(CDR(node));
}
// Goober5000
int special_argument_appears_in_sexp_list(int node)
{
// look through list
while (node != -1)
{
// special argument?
if (!strcmp(Sexp_nodes[node].text, SEXP_ARGUMENT_STRING))
return 1;
node = CDR(node);
}
return 0;
}
// conditional sexpressions follow
// Goober5000 - added capability for arguments
// eval_when evaluates the when conditional
int eval_when(int n, int use_arguments)
{
int arg_handler, cond, val, actions, exp, op_num, do_node;
arg_item *ptr;
Assert( n >= 0 );
// get the parts of the sexp and evaluate the conditional
if (use_arguments)
{
arg_handler = CAR(n);
cond = CADR(n);
actions = CDDR(n);
Sexp_current_argument_nesting_level++;
// evaluate for custom arguments
val = eval_sexp(arg_handler, cond);
}
else
{
cond = CAR(n);
actions = CDR(n);
// evaluate just as-is
val = eval_sexp(cond);
}
// if value is true, perform the actions in the 'then' part
if (val == SEXP_TRUE || val == SEXP_KNOWN_TRUE)
{
// loop through every action
while (actions != -1)
{
// get the operator
exp = CAR(actions);
if (exp != -1)
{
op_num = get_operator_const(CTEXT(exp));
switch (op_num) {
// if the op is a conditional then we just evaluate it
case OP_WHEN:
case OP_EVERY_TIME:
// need to account for the possibility this call uses <arguments>
if (special_argument_appears_in_sexp_tree(exp)) {
ptr = Sexp_applicable_argument_list.get_next();
if (ptr != NULL) {
eval_when_for_each_special_argument(exp);
}
else {
eval_sexp(exp);
}
}
else {
eval_sexp(exp);
}
break;
case OP_DO_FOR_VALID_ARGUMENTS:
if (special_argument_appears_in_sexp_tree(exp)) {
Warning(LOCATION, "<Argument> used within Do-for-valid-arguments SEXP. Skipping entire SEXP");
break;
}
do_node = CDR(exp);
while (do_node != -1) {
do_action_for_each_special_argument(do_node);
do_node = CDR(do_node);
}
break;
case OP_WHEN_ARGUMENT:
case OP_EVERY_TIME_ARGUMENT:
eval_sexp(exp);
break;
// otherwise we need to check if arguments are used
default:
// if we're using the special argument in this action
if (special_argument_appears_in_sexp_tree(exp))
{
do_action_for_each_special_argument(exp); // these sexps eval'd only for side effects
}
// if not, just evaluate it once as-is
else
{
// Goober5000 - possible bug? (see when val is used below)
/*val = */eval_sexp(exp); // these sexps eval'd only for side effects
}
}
}
actions = CDR(actions);
}
}
if (use_arguments) {
// clean up any special sexp stuff
Sexp_applicable_argument_list.clear_nesting_level();
Sexp_current_argument_nesting_level--;
}
if (Sexp_nodes[cond].value == SEXP_KNOWN_FALSE)
return SEXP_KNOWN_FALSE; // no need to waste time on this anymore
if (val == SEXP_KNOWN_FALSE)
return SEXP_FALSE; // can't return known false, as this would bypass future actions under the when
return val;
}
// eval_cond() evaluates the cond conditional
int eval_cond(int n)
{
int cond = 0, node, val = SEXP_FALSE;
Assert (n >= 0);
while (n >= 0)
{
node = CAR(n);
cond = CAR(node);
val = eval_sexp(cond);
// if the conditional evaluated to true, then we must evaluate the rest of the expression returning
// the value of this evaluation
if (val == SEXP_TRUE || val == SEXP_KNOWN_TRUE)
{
int actions, exp;
val = SEXP_FALSE;
actions = CDR(node);
while (actions >= 0)
{
exp = CAR(actions);
if (exp >= -1)
val = eval_sexp(exp); // these sexp evaled only for side effects
actions = CDR(actions);
}
break;
}
// move onto the next cond clause
n = CDR(n);
}
return val;
}
// Goober5000
int test_argument_list_for_condition(int n, int condition_node, int *num_true, int *num_false, int *num_known_true, int *num_known_false)
{
int val, num_valid_arguments;
Assert(n != -1 && condition_node != -1);
Assert((num_true != NULL) && (num_false != NULL) && (num_known_true != NULL) && (num_known_false != NULL));
// ensure special argument list is empty
Sexp_applicable_argument_list.clear_nesting_level();
Applicable_arguments_temp.clear();
// ditto for counters
num_valid_arguments = 0;
*num_true = 0;
*num_false = 0;
*num_known_true = 0;
*num_known_false = 0;
// loop through all arguments
while (n != -1)
{
// only eval this argument if it's valid
if (Sexp_nodes[n].flags & SNF_ARGUMENT_VALID)
{
// flush conditional to avoid short-circuiting
flush_sexp_tree(condition_node);
// evaluate conditional for current argument
Sexp_replacement_arguments.push_back(Sexp_nodes[n].text);
val = eval_sexp(condition_node);
switch (val)
{
case SEXP_TRUE:
(*num_true)++;
Applicable_arguments_temp.push_back(Sexp_nodes[n].text);
break;
case SEXP_FALSE:
(*num_false)++;
break;
case SEXP_KNOWN_TRUE:
(*num_known_true)++;
Applicable_arguments_temp.push_back(Sexp_nodes[n].text);
break;
case SEXP_KNOWN_FALSE:
(*num_known_false)++;
break;
}
// clear argument, but not list, as we'll need it later
Sexp_replacement_arguments.pop_back();
// increment
num_valid_arguments++;
}
// continue along argument list
n = CDR(n);
}
// now we write from the temporary store into the real one, reversing the order. We do this because
// Sexp_applicable_argument_list is a stack and we want the first argument in the list to be the first one out
while(!Applicable_arguments_temp.empty()) {
Sexp_applicable_argument_list.add_data(Applicable_arguments_temp.back());
Applicable_arguments_temp.pop_back();
}
return num_valid_arguments;
}
// Goober5000
int eval_any_of(int arg_handler_node, int condition_node)
{
int n, num_valid_arguments, num_true, num_false, num_known_true, num_known_false;
Assert(arg_handler_node != -1 && condition_node != -1);
// the arguments should just be data, not operators, so we can skip the CAR
n = CDR(arg_handler_node);
// test the whole argument list
num_valid_arguments = test_argument_list_for_condition(n, condition_node, &num_true, &num_false, &num_known_true, &num_known_false);
// use the sexp_or algorithm
if (num_known_true)
return SEXP_KNOWN_TRUE;
else if (num_known_false == num_valid_arguments)
return SEXP_KNOWN_FALSE;
else if (num_true)
return SEXP_TRUE;
else
return SEXP_FALSE;
}
// Goober5000
int eval_every_of(int arg_handler_node, int condition_node)
{
int n, num_valid_arguments, num_true, num_false, num_known_true, num_known_false;
Assert(arg_handler_node != -1 && condition_node != -1);
// the arguments should just be data, not operators, so we can skip the CAR
n = CDR(arg_handler_node);
// test the whole argument list
num_valid_arguments = test_argument_list_for_condition(n, condition_node, &num_true, &num_false, &num_known_true, &num_known_false);
// use the sexp_and algorithm
if (num_known_false)
return SEXP_KNOWN_FALSE;
else if (num_known_true == num_valid_arguments)
return SEXP_KNOWN_TRUE;
else if (num_false)
return SEXP_FALSE;
else
return SEXP_TRUE;
}
// Goober5000
int eval_number_of(int arg_handler_node, int condition_node)
{
int n, num_valid_arguments, num_true, num_false, num_known_true, num_known_false, threshold;
Assert(arg_handler_node != -1 && condition_node != -1);
// the arguments should just be data, not operators, so we can skip the CAR
n = CDR(arg_handler_node);
// the first argument is the number threshold
threshold = eval_num(n);
n = CDR(n);
// test the whole argument list
num_valid_arguments = test_argument_list_for_condition(n, condition_node, &num_true, &num_false, &num_known_true, &num_known_false);
// use the sexp_or algorithm, modified
// (true if at least threshold arguments are true)
if (num_known_true >= threshold)
return SEXP_KNOWN_TRUE;
else if (num_valid_arguments - num_known_false < threshold)
return SEXP_KNOWN_FALSE;
else if (num_true + num_known_true >= threshold)
return SEXP_TRUE;
else
return SEXP_FALSE;
}
// Goober5000
// this works a little differently... we randomly pick one argument to use
// for our condition, but this argument must be saved among sexp calls...
// so we select an argument and set its flag
// addendum: hook karajorma's random-multiple-of into the same sexp
int eval_random_of(int arg_handler_node, int condition_node, bool multiple)
{
int n = -1, i, val, num_valid_args, random_argument;
Assert(arg_handler_node != -1 && condition_node != -1);
// find which argument we picked, if we picked one
if (!multiple)
{
n = CDR(arg_handler_node);
// iterate to the argument we previously selected
for ( ; n != -1; n = CDR(n))
{
if (Sexp_nodes[n].flags & SNF_ARGUMENT_SELECT)
break;
}
}
// if argument not found (or never specified in the first place), we have to pick one
if (n == -1)
{
n = CDR(arg_handler_node);
// get the number of valid arguments
num_valid_args = query_sexp_args_count(arg_handler_node, true);
if (num_valid_args == 0)
{
return SEXP_FALSE;
}
// pick an argument and iterate to it
random_argument = rand_internal(1, num_valid_args);
i = 0;
while (true)
{
Assert(n >= 0);
// count only valid arguments
if (Sexp_nodes[n].flags & SNF_ARGUMENT_VALID)
i++;
// if we're at the right one, we're done
if (i >= random_argument)
break;
// iterate
n = CDR(n);
}
// save it, if we're saving
if (!multiple)
{
Sexp_nodes[n].flags |= SNF_ARGUMENT_SELECT;
}
}
// only eval this argument if it's valid
val = SEXP_FALSE;
if (Sexp_nodes[n].flags & SNF_ARGUMENT_VALID)
{
// flush stuff
Sexp_applicable_argument_list.clear_nesting_level();
flush_sexp_tree(condition_node);
// evaluate conditional for current argument
Sexp_replacement_arguments.push_back(Sexp_nodes[n].text);
val = eval_sexp(condition_node);
// true?
if (val == SEXP_TRUE || val == SEXP_KNOWN_TRUE)
{
Sexp_applicable_argument_list.add_data(Sexp_nodes[n].text);
}
// clear argument, but not list, as we'll need it later
Sexp_replacement_arguments.pop_back();
}
// true if our selected argument is true
return val;
}
// Karajorma - this conditional returns the first valid option on its list.
int eval_in_sequence(int arg_handler_node, int condition_node)
{
int val = SEXP_FALSE;
int n = -1 ;
Assert(arg_handler_node != -1 && condition_node != -1);
// get the first argument
n = CDR(arg_handler_node);
Assert (n != -1);
// loop through the nodes until we find one that is holds a valid argument or run out of nodes
for (int i=1 ; i<query_sexp_args_count(arg_handler_node) ; i++)
{
if (!(Sexp_nodes[n].flags & SNF_ARGUMENT_VALID)) {
n = CDR(n) ;
}
// if we've found a valid node there is no need to continue
else {
break;
}
}
// Only execute if the argument is valid (if all nodes were invalid we would still reach this point)
if (Sexp_nodes[n].flags & SNF_ARGUMENT_VALID)
{
// flush stuff
Sexp_applicable_argument_list.clear_nesting_level();
flush_sexp_tree(condition_node);
// evaluate conditional for current argument
Sexp_replacement_arguments.push_back(Sexp_nodes[n].text);
val = eval_sexp(condition_node);
// true?
if (val == SEXP_TRUE || val == SEXP_KNOWN_TRUE)
{
Sexp_applicable_argument_list.add_data(Sexp_nodes[n].text);
}
// clear argument, but not list, as we'll need it later
Sexp_replacement_arguments.pop_back();
}
// return the value of the conditional
return val;
}
// Goober5000
void sexp_change_argument_validity(int n, bool invalidate)
{
int conditional, arg_handler, arg_n;
bool toggled;
conditional = n;
do {
// find the conditional sexp
conditional = find_parent_operator(conditional);
if (conditional == -1)
return;
}
while (!is_blank_argument_op(get_operator_const(CTEXT(conditional))));
// get the first op of the parent, which should be a *_of operator
arg_handler = CADR(conditional);
if (!is_blank_of_op(get_operator_const(CTEXT(arg_handler))))
return;
// loop through arguments
while (n != -1)
{
toggled = false;
// first we must check if the arg_handler marks a selection. At the moment random-of is the only one that does this
arg_n = CDR(arg_handler);
while (invalidate && (arg_n != -1)) {
if (Sexp_nodes[arg_n].flags & SNF_ARGUMENT_SELECT) {
// now check if the selected argument matches the one we want to invalidate
if (!strcmp(CTEXT(n), CTEXT(arg_n))) {
// set it as invalid
Sexp_nodes[arg_n].flags &= ~SNF_ARGUMENT_VALID;
toggled = true;
}
}
// iterate
arg_n = CDR(arg_n);
}
if (!toggled) {
// search for argument in arg_handler list
arg_n = CDR(arg_handler);
while (arg_n != -1)
{
// match?
if (!strcmp(CTEXT(n), CTEXT(arg_n)))
{
if (invalidate) {
// we need to check if the argument is already invalid as some argument lists may contain duplicates
if (Sexp_nodes[arg_n].flags & SNF_ARGUMENT_VALID) {
// set it as invalid
Sexp_nodes[arg_n].flags &= ~SNF_ARGUMENT_VALID;
// exit inner loop
break;
}
}
else {
if (!(Sexp_nodes[arg_n].flags & SNF_ARGUMENT_VALID)) {
// set it as valid
Sexp_nodes[arg_n].flags |= SNF_ARGUMENT_VALID;
// exit inner loop
break;
}
}
}
// iterate
arg_n = CDR(arg_n);
}
}
// iterate
n = CDR(n);
}
}
// Goober5000
bool is_blank_argument_op(int op_const)
{
switch (op_const)
{
case OP_WHEN_ARGUMENT:
case OP_EVERY_TIME_ARGUMENT:
return true;
default:
return false;
}
}
// Goober5000
bool is_blank_of_op(int op_const)
{
switch (op_const)
{
case OP_ANY_OF:
case OP_EVERY_OF:
case OP_NUMBER_OF:
case OP_RANDOM_OF:
case OP_RANDOM_MULTIPLE_OF:
case OP_IN_SEQUENCE:
return true;
default:
return false;
}
}
// Goober5000 - added wing capability
int sexp_is_iff(int n)
{
int i, team;
// iff value is the first parameter, second is a list of one or more ships/wings to check to see if the
// iff value matches
team = iff_lookup(CTEXT(n));
n = CDR(n);
for ( ; n != -1; n = CDR(n) )
{
object_ship_wing_point_team oswpt;
sexp_get_object_ship_wing_point_team(&oswpt, CTEXT(n));
switch (oswpt.type)
{
case OSWPT_TYPE_SHIP:
{
// if the team doesn't match the team specified, return false immediately
if (oswpt.shipp->team != team)
return SEXP_FALSE;
break;
}
case OSWPT_TYPE_PARSE_OBJECT:
{
// if the team doesn't match the team specified, return false immediately
if (oswpt.p_objp->team != team)
return SEXP_FALSE;
break;
}
case OSWPT_TYPE_WING:
{
for (i = 0; i < oswpt.wingp->current_count; i++)
{
// if the team doesn't match the team specified, return false immediately
if (Ships[oswpt.wingp->ship_index[i]].team != team)
return SEXP_FALSE;
}
break;
}
}
}
// got this far: we must be okay for all ships/wings
return SEXP_TRUE;
}
// Goober5000
void sexp_ingame_ship_change_iff(ship *shipp, int new_team)
{
Assert(shipp != NULL);
shipp->team = new_team;
// send a network packet if we need to
if((Game_mode & GM_MULTIPLAYER) && (Net_player != NULL) && (Net_player->flags & NETINFO_FLAG_AM_MASTER) && (shipp->objnum >= 0))
send_change_iff_packet(Objects[shipp->objnum].net_signature, new_team);
}
// Goober5000
void sexp_parse_ship_change_iff(p_object *parse_obj, int new_team)
{
Assert(parse_obj);
parse_obj->team = new_team;
}
// Goober5000 - added wing capability
void sexp_change_iff(int n)
{
int new_team;
new_team = iff_lookup(CTEXT(n));
n = CDR(n);
for ( ; n != -1; n = CDR(n) )
{
object_ship_wing_point_team oswpt;
sexp_get_object_ship_wing_point_team(&oswpt, CTEXT(n));
switch (oswpt.type)
{
// change ingame ship
case OSWPT_TYPE_SHIP:
{
sexp_ingame_ship_change_iff(oswpt.shipp, new_team);
break;
}
// change ship yet to arrive
case OSWPT_TYPE_PARSE_OBJECT:
{
sexp_parse_ship_change_iff(oswpt.p_objp, new_team);
break;
}
// change wing (we must set the flags for all ships present as well as all ships yet to arrive)
case OSWPT_TYPE_WING:
{
// current ships
for (int i = 0; i < oswpt.wingp->current_count; i++)
sexp_ingame_ship_change_iff(&Ships[oswpt.wingp->ship_index[i]], new_team);
// ships yet to arrive
for (p_object *p_objp = GET_FIRST(&Ship_arrival_list); p_objp != END_OF_LIST(&Ship_arrival_list); p_objp = GET_NEXT(p_objp))
{
if (p_objp->wingnum == WING_INDEX(oswpt.wingp))
sexp_parse_ship_change_iff(p_objp, new_team);
}
break;
}
}
}
}
void sexp_ingame_ship_change_iff_color(ship *shipp, int observer_team, int observed_team, int alternate_iff_color)
{
Assert(shipp != NULL);
shipp->ship_iff_color[observer_team][observed_team] = alternate_iff_color;
// Like the rest of the change_iff_color functions copied with minor alterations from earlier change_iff functions.
if((Game_mode & GM_MULTIPLAYER) && (Net_player != NULL) && (Net_player->flags & NETINFO_FLAG_AM_MASTER) && (shipp->objnum >= 0))
send_change_iff_color_packet(Objects[shipp->objnum].net_signature, observer_team, observed_team, alternate_iff_color);
}
void sexp_parse_ship_change_iff_color(p_object *parse_obj, int observer_team, int observed_team, int alternate_iff_color)
{
Assert(parse_obj);
parse_obj->alt_iff_color[observer_team][observed_team] = alternate_iff_color;
}
// Wanderer
void sexp_change_iff_color(int n)
{
int observer_team, observed_team, alternate_iff_color;
int i;
int rgb[3];
// First node
if(n == -1){
Warning(LOCATION, "Detected missing observer team parameter in sexp-change_iff_color");
return;
}
observer_team = iff_lookup(CTEXT(n));
// Second node
n = CDR(n);
if(n == -1){
Warning(LOCATION, "Detected missing observed team parameter in sexp-change_iff_color");
return;
}
observed_team = iff_lookup(CTEXT(n));
// Three following nodes
for (i=0;i<3;i++)
{
n = CDR(n);
if(n == -1){
Warning(LOCATION, "Detected incomplete color parameter list in sexp-change_iff_color");
return;
}
rgb[i] = eval_num(n);
}
alternate_iff_color = iff_init_color(rgb[0],rgb[1],rgb[2]);
// Rest of the nodes
n = CDR(n);
for ( ; n != -1; n = CDR(n) )
{
object_ship_wing_point_team oswpt;
sexp_get_object_ship_wing_point_team(&oswpt, CTEXT(n));
switch (oswpt.type)
{
// change ingame ship
case OSWPT_TYPE_SHIP:
{
sexp_ingame_ship_change_iff_color(oswpt.shipp, observer_team, observed_team, alternate_iff_color);
break;
}
// change ship yet to arrive
case OSWPT_TYPE_PARSE_OBJECT:
{
sexp_parse_ship_change_iff_color(oswpt.p_objp, observer_team, observed_team, alternate_iff_color);
break;
}
// change wing (we must set the flags for all ships present as well as all ships yet to arrive)
case OSWPT_TYPE_WING:
{
// current ships
for (i = 0; i < oswpt.wingp->current_count; i++)
sexp_ingame_ship_change_iff_color(&Ships[oswpt.wingp->ship_index[i]], observer_team, observed_team, alternate_iff_color);
// ships yet to arrive
for (p_object *p_objp = GET_FIRST(&Ship_arrival_list); p_objp != END_OF_LIST(&Ship_arrival_list); p_objp = GET_NEXT(p_objp))
{
if (p_objp->wingnum == WING_INDEX(oswpt.wingp))
sexp_parse_ship_change_iff_color(p_objp, observer_team, observed_team, alternate_iff_color);
}
break;
}
}
}
}
// Goober5000
int sexp_is_ship_class(int n)
{
int ship_num, ship_class_num;
Assert( n >= 0 );
// get class
ship_class_num = ship_info_lookup(CTEXT(n));
n = CDR(n);
// eval ships
while (n != -1)
{
// get ship
ship_num = ship_name_lookup(CTEXT(n));
// we can't do anything with ships that aren't present
if (ship_num < 0)
return SEXP_CANT_EVAL;
// if it doesn't match, return false
if (Ships[ship_num].ship_info_index != ship_class_num)
return SEXP_FALSE;
// increment
n = CDR(n);
}
// we're this far; it must be true
return SEXP_TRUE;
}
// Goober5000
int sexp_is_ship_type(int n)
{
int ship_num, ship_type_num;
Assert( n >= 0 );
// get type
ship_type_num = ship_type_name_lookup(CTEXT(n));
n = CDR(n);
// eval ships
while (n != -1)
{
// get ship
ship_num = ship_name_lookup(CTEXT(n));
// we can't do anything with ships that aren't present
if (ship_num < 0)
return SEXP_CANT_EVAL;
// if it doesn't match, return false
if(ship_class_query_general_type(Ships[ship_num].ship_info_index) != ship_type_num)
return SEXP_FALSE;
// increment
n = CDR(n);
}
// we're this far; it must be true
return SEXP_TRUE;
}
// Goober5000
// ai class value is the first parameter, second is a ship, rest are subsystems to check
int sexp_is_ai_class(int n)
{
char *ship_name, *subsystem;
int i, ship_num, ai_class, class_to_test;
Assert ( n >= 0 );
// find ai class
ai_class = -1;
for (i=0; i<Num_ai_classes; i++)
{
if (!stricmp(Ai_class_names[i], CTEXT(n)))
ai_class = i;
}
Assert(ai_class >= 0);
n = CDR(n);
ship_name = CTEXT(n);
n = CDR(n);
// find ship
ship_num = ship_name_lookup(ship_name);
// we can't do anything with ships that aren't present
if (ship_num < 0)
return SEXP_CANT_EVAL;
// subsys?
if (n != -1)
{
ship_subsys *ss;
// loopity-loop
for ( ; n != -1; n = CDR(n) )
{
subsystem = CTEXT(n);
class_to_test = -1;
// find the ship subsystem by searching ship's subsys_list
ss = GET_FIRST( &Ships[ship_num].subsys_list );
while ( ss != END_OF_LIST( &Ships[ship_num].subsys_list ) )
{
// if we found the subsystem
if ( !subsystem_stricmp(ss->system_info->subobj_name, subsystem))
{
// get ai class
class_to_test = ss->weapons.ai_class;
break;
}
ss = GET_NEXT( ss );
}
// if no match (or nothing to match), return false immediately
if ((class_to_test < 0) || (ai_class != class_to_test))
return SEXP_FALSE;
}
// we've come this far; it must all be true
return SEXP_TRUE;
}
// just the ship
else
{
if (Ship_info[Ships[ship_num].ship_info_index].ai_class == ai_class)
return SEXP_TRUE;
else
return SEXP_FALSE;
}
}
// Goober5000
void sexp_change_ai_class(int n)
{
int i, ship_num, new_ai_class;
Assert ( n >= 0 );
// find ai class
new_ai_class = -1;
for (i=0; i<Num_ai_classes; i++)
{
if (!stricmp(Ai_class_names[i], CTEXT(n)))
new_ai_class = i;
}
Assert(new_ai_class >= 0);
// find ship
n = CDR(n);
ship_num = ship_name_lookup(CTEXT(n));
n = CDR(n);
// we can't do anything with ships that aren't present
if (ship_num < 0)
return;
// subsys?
if (n != -1)
{
// loopity-loop
for ( ; n != -1; n = CDR(n) )
{
ship_subsystem_set_new_ai_class(ship_num, CTEXT(n), new_ai_class);
// send a network packet if we need to
if((Game_mode & GM_MULTIPLAYER) && (Net_player != NULL) && (Net_player->flags & NETINFO_FLAG_AM_MASTER) && (Ships[ship_num].objnum >= 0))
{
send_change_ai_class_packet(Objects[Ships[ship_num].objnum].net_signature, CTEXT(n), new_ai_class);
}
}
}
// just the one ship
else
{
ship_set_new_ai_class(ship_num, new_ai_class);
// send a network packet if we need to
if((Game_mode & GM_MULTIPLAYER) && (Net_player != NULL) && (Net_player->flags & NETINFO_FLAG_AM_MASTER) && (Ships[ship_num].objnum >= 0))
{
send_change_ai_class_packet(Objects[Ships[ship_num].objnum].net_signature, NULL, new_ai_class);
}
}
}
// following routine adds an ai goal to a ship structure. The sexpression index
// passed in should be an ai-goal of the proper form. The code in MissionGoal should
// check the syntax.
void sexp_add_ship_goal(int n)
{
int num, sindex;
char *ship_name;
Assert ( n >= 0 );
ship_name = CTEXT(n);
num = ship_name_lookup(ship_name, 1); // Goober5000 - including player
if ( num < 0 ) // ship not around anymore???? then forget it!
return;
sindex = CDR(n);
ai_add_ship_goal_sexp( sindex, AIG_TYPE_EVENT_SHIP, &(Ai_info[Ships[num].ai_index]) );
}
// identical to above, except add a wing
void sexp_add_wing_goal(int n)
{
int num, sindex;
char *wing_name;
Assert ( n >= 0 );
wing_name = CTEXT(n);
num = wing_name_lookup(wing_name);
if ( num < 0 ) // ship not around anymore???? then forget it!
return;
sindex = CDR(n);
ai_add_wing_goal_sexp( sindex, AIG_TYPE_EVENT_WING, num );
}
// sexp_add_goal adds a goal to the specified entiry (ships and wings have unique names between
// the two sets).
void sexp_add_goal(int n)
{
int num, sindex;
char *name;
Assert ( n >= 0 );
name = CTEXT(n);
sindex = CDR(n);
// first, look for ship name -- if found, then add ship goal. else look for wing name -- if
// found, add wing goal
if ( (num = ship_name_lookup(name, 1)) != -1 ) // Goober5000 - include players
ai_add_ship_goal_sexp( sindex, AIG_TYPE_EVENT_SHIP, &(Ai_info[Ships[num].ai_index]) );
else if ( (num = wing_name_lookup(name)) != -1 )
ai_add_wing_goal_sexp( sindex, AIG_TYPE_EVENT_WING, num );
}
// Goober5000
void sexp_remove_goal(int n)
{
}
// clears out all ai goals for a ship
void sexp_clear_ship_goals(int n)
{
int num;
char *ship_name;
Assert ( n >= 0 );
ship_name = CTEXT(n);
num = ship_name_lookup(ship_name, 1); // Goober5000 - include players
ai_clear_ship_goals( &(Ai_info[Ships[num].ai_index]) );
}
// clears out ai goals for a wing
void sexp_clear_wing_goals(int n)
{
int num;
char *wing_name;
Assert ( n >= 0 );
wing_name = CTEXT(n);
num = wing_name_lookup(wing_name);
if ( num < 0 )
return;
ai_clear_wing_goals( num );
}
// this function clears all ai goals for the given ship or wing
void sexp_clear_goals(int n)
{
int num;
char *name;
Assert ( n >= 0 );
while ( n != -1 ) {
name = CTEXT(n);
if ( (num = ship_name_lookup(name, 1)) != -1 ) // Goober5000 - include players
ai_clear_ship_goals( &(Ai_info[Ships[num].ai_index]) );
else if ( (num = wing_name_lookup(name)) != -1 )
ai_clear_wing_goals( num );
n = CDR(n);
}
}
// Goober5000
void sexp_hud_disable(int n)
{
hud_set_draw(!eval_num(n));
}
// Goober5000
void sexp_hud_disable_except_messages(int n)
{
hud_disable_except_messages(eval_num(n));
}
void sexp_hud_set_text_num(int n)
{
#ifndef NEW_HUD
char* gaugename = CTEXT(n);
gauge_info* cg = hud_get_gauge(gaugename);
if(cg)
{
sprintf( HUD_CHAR(current_hud, cg->text_dest), "%d", eval_num(CDR(n)) );
}
#endif
}
void sexp_hud_set_text(int n)
{
#ifndef NEW_HUD
char* gaugename = CTEXT(n);
char* text = CTEXT(CDR(n));
gauge_info* cg = hud_get_gauge(gaugename);
if(cg)
{
strcpy(HUD_CHAR(current_hud, cg->text_dest), text);
}
#endif
}
void sexp_hud_set_coords(int n)
{
#ifndef NEW_HUD
char* gaugename = CTEXT(n);
int coord_x = eval_num(CDR(n));
int coord_y = eval_num(CDR(CDR(n)));
gauge_info * cg = hud_get_gauge(gaugename);
if(cg)
{
HUD_INT(current_hud, cg->coord_dest)[0] = coord_x;
HUD_INT(current_hud, cg->coord_dest)[1] = coord_y;
}
#endif
}
void sexp_hud_set_frame(int n)
{
#ifndef NEW_HUD
char* gaugename = CTEXT(n);
int frame_num = eval_num(CDR(n));
gauge_info * cg = hud_get_gauge(gaugename);
if(cg)
{
*HUD_INT(current_hud, cg->frame_dest) = frame_num;
}
return;
#endif
}
void sexp_hud_set_color(int n)
{
#ifndef NEW_HUD
char* gaugename = CTEXT(n);
ubyte red = (ubyte) eval_num(CDR(n));
ubyte green = (ubyte) eval_num(CDR(CDR(n)));
ubyte blue = (ubyte) eval_num(CDR(CDR(CDR(n))));
gauge_info * cg = hud_get_gauge(gaugename);
if(cg)
{
HUD_COLOR(current_hud, cg->color_dest)->red = red;
HUD_COLOR(current_hud, cg->color_dest)->green = green;
HUD_COLOR(current_hud, cg->color_dest)->blue = blue;
}
#endif
}
// Goober5000
void sexp_hud_set_max_targeting_range(int n)
{
Hud_max_targeting_range = eval_num(n);
if (Hud_max_targeting_range < 0)
Hud_max_targeting_range = 0;
}
// Goober5000
// trigger whether player uses the game AI for stuff
void sexp_player_use_ai(int flag)
{
Player_use_ai = flag ? 1 : 0;
}
// Karajorma
void sexp_allow_treason (int n) {
n = CDR(n);
if (n != -1) {
if ( is_sexp_true(n) ) {
The_mission.flags |= MISSION_FLAG_NO_TRAITOR;
}
else {
The_mission.flags &= ~MISSION_FLAG_NO_TRAITOR;
}
}
}
// Goober5000
void sexp_change_soundtrack(int n)
{
event_sexp_change_soundtrack(CTEXT(n));
if (MULTIPLAYER_MASTER) {
multi_start_packet();
multi_send_string(CTEXT(n));
multi_end_packet();
}
}
void multi_sexp_change_soundtrack()
{
char new_track[NAME_LENGTH];
if (multi_get_string(new_track)) {
event_sexp_change_soundtrack(new_track);
}
}
// Goober5000
void sexp_stop_music(int fade)
{
if ( Sexp_music_handle != -1 ) {
audiostream_close_file(Sexp_music_handle, fade);
Sexp_music_handle = -1;
}
}
// Goober5000
void sexp_music_close()
{
if ( Cmdline_freespace_no_music ) {
return;
}
sexp_stop_music();
}
// Goober5000
void sexp_load_music(char* fname)
{
if ( Cmdline_freespace_no_music ) {
return;
}
if ( Sexp_music_handle != -1 )
{
sexp_stop_music();
}
if ( fname )
{
Sexp_music_handle = audiostream_open( fname, ASF_MENUMUSIC );
}
}
// Goober5000
void sexp_start_music(int loop)
{
if ( Sexp_music_handle != -1 ) {
if ( !audiostream_is_playing(Sexp_music_handle) )
audiostream_play(Sexp_music_handle, Master_event_music_volume, loop);
}
else {
nprintf(("Warning", "Can not play music. sexp_start_music called when no music file is set for Sexp_music_handle!\n"));
}
}
// Goober5000
void sexp_play_sound_from_table(int n)
{
vec3d origin;
int sound_index;
Assert( n >= 0 );
// read in data --------------------------------
origin.xyz.x = (float)eval_num(n);
n = CDR(n);
origin.xyz.y = (float)eval_num(n);
n = CDR(n);
origin.xyz.z = (float)eval_num(n);
n = CDR(n);
sound_index = eval_num(n);
// play sound effect ---------------------------
snd_play_3d( &Snds[sound_index], &origin, &View_position, 0.0f, NULL, 0, 1.0f, SND_PRIORITY_MUST_PLAY );
if (MULTIPLAYER_MASTER) {
multi_start_packet();
multi_send_float(origin.xyz.x);
multi_send_float(origin.xyz.y);
multi_send_float(origin.xyz.z);
multi_send_int(sound_index);
multi_end_packet();
}
}
void multi_sexp_play_sound_from_table()
{
vec3d origin;
int sound_index = -1;
multi_get_float(origin.xyz.x);
multi_get_float(origin.xyz.y);
multi_get_float(origin.xyz.z);
multi_get_int(sound_index);
if (sound_index != -1) {
// play sound effect ---------------------------
snd_play_3d( &Snds[sound_index], &origin, &View_position, 0.0f, NULL, 0, 1.0f, SND_PRIORITY_MUST_PLAY );
}
}
// Goober5000
void sexp_close_sound_from_file(int n)
{
int fade = is_sexp_true(n);
sexp_stop_music(fade);
if (MULTIPLAYER_MASTER) {
multi_start_packet();
multi_send_bool(fade ? true : false);
multi_end_packet();
}
}
void multi_sexp_close_sound_from_file()
{
bool fade;
if (multi_get_bool(fade)) {
sexp_stop_music(fade);
}
}
// Goober5000
void sexp_play_sound_from_file(int n)
{
// load sound file -----------------------------
sexp_load_music(CTEXT(n));
if (MULTIPLAYER_MASTER) {
multi_start_packet();
multi_send_string(CTEXT(n));
}
n = CDR(n);
int loop = is_sexp_true(n);
// play sound file -----------------------------
sexp_start_music(loop);
if (MULTIPLAYER_MASTER) {
multi_send_bool(loop ? true : false);
multi_end_packet();
}
}
void multi_sexp_play_sound_from_file()
{
char filename[NAME_LENGTH];
bool (loop);
if (!multi_get_string(filename)) {
return;
}
sexp_load_music(filename);
multi_get_bool(loop);
sexp_start_music(loop);
}
// Goober5000
void sexp_explosion_effect(int n)
/* From the SEXP help...
{ OP_EXPLOSION_EFFECT, "explosion-effect\r\n"
"\tCauses an explosion at a given origin, with the given parameters. "
"Takes 11 or 13 arguments...\r\n"
"\t1: Origin X\r\n"
"\t2: Origin Y\r\n"
"\t3: Origin Z\r\n"
"\t4: Damage\r\n"
"\t5: Blast force\r\n"
"\t6: Size of explosion (if 0, explosion will not be visible)\r\n"
"\t7: Inner radius to apply damage (if 0, explosion will not be visible)\r\n"
"\t8: Outer radius to apply damage (if 0, explosion will not be visible)\r\n"
"\t9: Shockwave speed (if 0, there will be no shockwave)\r\n"
"\t10: Type (0 = medium, 1 = large1, 2 = large2)\r\n"
"\t11: Sound (index into sounds.tbl)\r\n"
"\t12: EMP intensity (optional)\r\n"
"\t13: EMP duration in seconds (optional)" },
*/
// Basically, this function pretends that there's a ship at the origin that's blowing up, and
// it does stuff accordingly. In some places, it has to tiptoe around a little because the
// code often expects a parent object when in fact there is none. <.< >.>
{
vec3d origin;
int max_damage, max_blast, explosion_size, inner_radius, outer_radius, shockwave_speed, fireball_type, sound_index;
int emp_intensity, emp_duration;
shockwave_create_info sci;
Assert( n >= 0 );
// read in data --------------------------------
origin.xyz.x = (float)eval_num(n);
n = CDR(n);
origin.xyz.y = (float)eval_num(n);
n = CDR(n);
origin.xyz.z = (float)eval_num(n);
n = CDR(n);
max_damage = eval_num(n);
n = CDR(n);
max_blast = eval_num(n);
n = CDR(n);
explosion_size = eval_num(n);
n = CDR(n);
inner_radius = eval_num(n);
n = CDR(n);
outer_radius = eval_num(n);
n = CDR(n);
shockwave_speed = eval_num(n);
n = CDR(n);
// fireball type
if (eval_num(n) == 0)
{
fireball_type = FIREBALL_EXPLOSION_MEDIUM;
}
else if (eval_num(n) == 1)
{
fireball_type = FIREBALL_EXPLOSION_LARGE1;
}
else if (eval_num(n) == 2)
{
fireball_type = FIREBALL_EXPLOSION_LARGE2;
}
else
{
Warning(LOCATION, "explosion-effect type is out of range; quitting the explosion...\n");
return;
}
n = CDR(n);
sound_index = eval_num(n);
n = CDR(n);
// optional EMP
emp_intensity = 0;
emp_duration = 0;
if (n != -1)
{
emp_intensity = eval_num(n);
n = CDR(n);
}
if (n != -1)
{
emp_duration = eval_num(n);
n = CDR(n);
}
// play sound effect ---------------------------
snd_play_3d( &Snds[sound_index], &origin, &View_position, 0.0f, NULL, 0, 1.0f, SND_PRIORITY_MUST_PLAY );
// create the fireball -------------------------
if (explosion_size && inner_radius && outer_radius)
{
if(fireball_type == FIREBALL_EXPLOSION_MEDIUM)
fireball_create( &origin, fireball_type, FIREBALL_MEDIUM_EXPLOSION, -1, (float)explosion_size );
else
fireball_create( &origin, fireball_type, FIREBALL_LARGE_EXPLOSION, -1, (float)explosion_size );
}
// apply area affect damage --------------------
if (max_damage || max_blast)
{
if ( shockwave_speed > 0 )
{
sci.inner_rad = (float)inner_radius;
sci.outer_rad = (float)outer_radius;
sci.blast = (float)max_blast;
sci.damage = (float)max_damage;
sci.speed = (float)shockwave_speed;
sci.rot_angles.p = frand_range(0.0f, 1.99f*PI);
sci.rot_angles.b = frand_range(0.0f, 1.99f*PI);
sci.rot_angles.h = frand_range(0.0f, 1.99f*PI);
shockwave_create(-1, &origin, &sci, SW_SHIP_DEATH);
}
else
{
object *objp;
float t_blast = 0.0f;
float t_damage = 0.0f;
for ( objp = GET_FIRST(&obj_used_list); objp !=END_OF_LIST(&obj_used_list); objp = GET_NEXT(objp) )
{
if ( (objp->type != OBJ_SHIP) && (objp->type != OBJ_ASTEROID) )
{
continue;
}
// don't blast navbuoys
if ( objp->type == OBJ_SHIP )
{
if ( ship_get_SIF(objp->instance) & SIF_NAVBUOY )
{
continue;
}
}
if ( ship_explode_area_calc_damage( &origin, &objp->pos, (float)inner_radius, (float)outer_radius, (float)max_damage, (float)max_blast, &t_damage, &t_blast ) == -1 )
{
continue;
}
switch ( objp->type )
{
case OBJ_SHIP:
ship_apply_global_damage( objp, NULL, &origin, t_damage );
vec3d force, vec_ship_to_impact;
vm_vec_sub( &vec_ship_to_impact, &objp->pos, &origin );
vm_vec_copy_normalize( &force, &vec_ship_to_impact );
vm_vec_scale( &force, (float)max_blast );
ship_apply_whack( &force, &vec_ship_to_impact, objp );
break;
case OBJ_ASTEROID:
asteroid_hit(objp, NULL, NULL, t_damage);
break;
default:
Int3();
break;
}
} // end for
}
}
// apply emp damage if applicable --------------
if (emp_intensity && emp_duration)
{
emp_apply(&origin, (float)inner_radius, (float)outer_radius, (float)emp_intensity, (float)emp_duration);
}
}
// Goober5000
void sexp_warp_effect(int n)
/* From the SEXP help...
{ OP_WARP_EFFECT, "warp-effect\r\n"
"\tCauses a subspace warp effect at a given origin, facing toward a given location, with the given parameters. "
"Takes 12 arguments...\r\n"
"\t1: Origin X\r\n"
"\t2: Origin Y\r\n"
"\t3: Origin Z\r\n"
"\t4: Location X\r\n"
"\t5: Location Y\r\n"
"\t6: Location Z\r\n"
"\t7: Radius\r\n"
"\t8: Duration in seconds\r\n"
"\t9: Warp opening sound (index into sounds.tbl)\r\n"
"\t10: Warp closing sound (index into sounds.tbl)\r\n"
"\t11: Type (0 for standard blue [default], 1 for Knossos green)\r\n"
"\t12: Shape (0 for 2-D [default], 1 for 3-D)" },
*/
{
vec3d origin, location, v_orient;
matrix m_orient;
int radius, duration, warp_open_sound_index, warp_close_sound_index, fireball_type, extra_flags;
extra_flags = FBF_WARP_VIA_SEXP;
// read in data --------------------------------
origin.xyz.x = (float)eval_num(n);
n = CDR(n);
origin.xyz.y = (float)eval_num(n);
n = CDR(n);
origin.xyz.z = (float)eval_num(n);
n = CDR(n);
location.xyz.x = (float)eval_num(n);
n = CDR(n);
location.xyz.y = (float)eval_num(n);
n = CDR(n);
location.xyz.z = (float)eval_num(n);
n = CDR(n);
radius = eval_num(n);
n = CDR(n);
duration = eval_num(n);
if (duration < 4) duration = 4;
n = CDR(n);
warp_open_sound_index = eval_num(n);
n = CDR(n);
warp_close_sound_index = eval_num(n);
n = CDR(n);
// fireball type
if (eval_num(n) == 0)
{
fireball_type = FIREBALL_WARP;
}
else if (eval_num(n) == 1)
{
fireball_type = FIREBALL_KNOSSOS;
}
else
{
Warning(LOCATION, "warp-effect type is out of range; quitting the warp...\n");
return;
}
n = CDR(n);
// shape
if (eval_num(n) == 0)
{
// do nothing; this is standard
}
else if (eval_num(n) == 1)
{
extra_flags |= FBF_WARP_3D;
}
else
{
Warning(LOCATION, "warp-effect shape is out of range; quitting the warp...\n");
return;
}
// calculate orientation matrix ----------------
memset(&v_orient, 0, sizeof(vec3d));
vm_vec_sub(&v_orient, &location, &origin);
if (IS_VEC_NULL(&v_orient))
{
Warning(LOCATION, "error in warp-effect: warp can't point to itself; quitting the warp...\n");
return;
}
vm_vector_2_matrix(&m_orient, &v_orient, NULL, NULL);
// create fireball -----------------------------
fireball_create(&origin, fireball_type, FIREBALL_WARP_EFFECT, -1, (float)radius, 0, NULL, (float)duration, -1, &m_orient, 0, extra_flags, warp_open_sound_index, warp_close_sound_index);
}
// this function get called by send-message or send-message random with the name of the message, sender,
// and priority.
void sexp_send_one_message( char *name, char *who_from, char *priority, int group, int delay )
{
int ipriority, num, ship_index, source;
ship *shipp;
if(physics_paused){
return;
}
Assert( (name != NULL) && (who_from != NULL) && (priority != NULL) );
// determine the priority of the message
if ( !stricmp(priority, "low") )
ipriority = MESSAGE_PRIORITY_LOW;
else if ( !stricmp(priority, "normal") )
ipriority = MESSAGE_PRIORITY_NORMAL;
else if ( !stricmp(priority, "high") )
ipriority = MESSAGE_PRIORITY_HIGH;
else {
Int3();
ipriority = MESSAGE_PRIORITY_NORMAL;
}
// check to see if the 'who_from' string is a ship that had been destroyed or departed. If so,
// then don't send the message. We must look at 'who_from' to determine what to look for. who_from
// may be any allied person, any wingman, a wingman from a specific wing, or a specific ship
ship_index = -1;
shipp = NULL;
source = MESSAGE_SOURCE_COMMAND;
if ( who_from[0] == '#' ) {
message_send_unique_to_player( name, &(who_from[1]), MESSAGE_SOURCE_SPECIAL, ipriority, group, delay );
return;
} else if (!stricmp(who_from, "<any allied>")) {
//Int3(); // no longer supported
return;
} else if ( (num = wing_name_lookup(who_from)) != -1 ) {
// message from a wing
// this will be an invalid case soon
// Int3();
// choose wing leader to speak for wing (hence "1" at end of ship_get_random_ship_in_wing)
ship_index = ship_get_random_ship_in_wing( num, SHIP_GET_UNSILENCED, 1 );
if ( ship_index == -1 ) {
if ( ipriority != MESSAGE_PRIORITY_HIGH )
return;
}
} else if ( mission_log_get_time(LOG_SHIP_DESTROYED, who_from, NULL, NULL) || mission_log_get_time(LOG_SHIP_DEPARTED, who_from, NULL, NULL)
|| mission_log_get_time(LOG_WING_DESTROYED, who_from, NULL, NULL) || mission_log_get_time(LOG_WING_DEPARTED, who_from, NULL, NULL) ) {
// getting into this if statement means that the ship or wing (sender) is no longer in the mission
// if message is high priority, make it come from Terran Command
if ( ipriority != MESSAGE_PRIORITY_HIGH )
return;
source = MESSAGE_SOURCE_COMMAND;
} else if ( !stricmp(who_from, "<any wingman>") || (wing_name_lookup(who_from) != -1) ) {
source = MESSAGE_SOURCE_WINGMAN;
} else {
// Message from a apecific ship
source = MESSAGE_SOURCE_SHIP;
ship_index = ship_name_lookup(who_from);
if ( ship_index == -1 ) {
// bail if not high priority, otherwise reroute to command
if ( ipriority != MESSAGE_PRIORITY_HIGH )
return;
source = MESSAGE_SOURCE_COMMAND;
}
}
if ( ship_index == -1 ){
shipp = NULL;
} else {
shipp = &Ships[ship_index];
}
message_send_unique_to_player( name, shipp, source, ipriority, group, delay );
}
void sexp_send_message(int n)
{
char *name, *who_from, *priority, *tmp;
if(physics_paused){
return;
}
Assert ( n != -1 );
who_from = CTEXT(n);
priority = CTEXT(CDR(n));
name = CTEXT(CDR(CDR(n)));
// a temporary check to see if the name field matched a priority since I am in the process
// of reordering the arguments
if ( !stricmp(name, "low") || !stricmp(name, "normal") || !stricmp(name, "high") ) {
tmp = name;
name = priority;
priority = tmp;
}
sexp_send_one_message( name, who_from, priority, 0, 0 );
}
void sexp_send_message_list(int n)
{
char *name, *who_from, *priority;
int delay;
if(physics_paused){
return;
}
// send a bunch of messages
delay = 0;
while(n != -1){
who_from = CTEXT(n);
// next node
n = CDR(n);
if(n == -1){
Warning(LOCATION, "Detected incomplete parameter list in sexp-send-message-list");
return;
}
priority = CTEXT(n);
// next node
n = CDR(n);
if(n == -1){
Warning(LOCATION, "Detected incomplete parameter list in sexp-send-message-list");
return;
}
name = CTEXT(n);
// next node
n = CDR(n);
if(n == -1){
Warning(LOCATION, "Detected incomplete parameter list in sexp-send-message-list");
return;
}
delay += eval_num(n);
// send the message
sexp_send_one_message(name, who_from, priority, 1, delay);
// next node
n = CDR(n);
}
}
void sexp_send_random_message(int n)
{
char *name, *who_from, *priority;
int temp, num_messages, message_num;
Assert ( n != -1 );
who_from = CTEXT(n);
priority = CTEXT(CDR(n));
if(physics_paused){
return;
}
// count the number of messages that we have
n = CDR(CDR(n));
temp = n;
num_messages = 0;
while ( n != -1 ) {
n = CDR(n);
num_messages++;
}
Assert ( num_messages >= 1 );
// get a random message, and pass the parameters to send_one_message
message_num = myrand() % num_messages;
n = temp;
while ( n != -1 ) {
if ( message_num == 0 )
break;
message_num--;
n = CDR(n);
}
Assert (n != -1); // should have found the message!!!
name = CTEXT(n);
sexp_send_one_message( name, who_from, priority, 0, 0 );
}
void sexp_self_destruct(int node)
{
int n, ship_num;
for (n = node; n != -1; n = CDR(n)) {
// get the ship
ship_num = ship_name_lookup(CTEXT(n));
// if it still exists, destroy it
if (ship_num >= 0) {
ship_self_destruct(&Objects[Ships[ship_num].objnum]);
}
}
}
void sexp_next_mission(int n)
{
char *mission_name;
int i;
mission_name = CTEXT(n);
if (mission_name == NULL) {
Error( LOCATION, "Mission name is NULL in campaign file for next-mission command!");
}
for (i = 0; i < Campaign.num_missions; i++) {
if ( !stricmp(Campaign.missions[i].name, mission_name) ) {
Campaign.next_mission = i;
return;
}
}
Error(LOCATION, "Mission name %s not found in campaign file for next-mission command", mission_name);
}
// function to deal with the end-of-campaign sexpression.
void sexp_end_of_campaign(int n)
{
// this is really a do-nothing sexpression. It is pretty much a placeholder to allow
// campaigns to have repeat-mission branches at the end of the campaign. By not setting
// anything in this function, the higher level campaign code will see this as end-of-campaign
// since next_mission isn't set to anything. (To be safe, we'll set to -1).
Campaign.next_mission = -1;
}
// sexpression to end everything. One parameter is the movie to play when this is over.
// Goober5000 - edited to only to the FS2-specific code when actually ending the FS2 main
// campaign, and otherwise to do the conventional code
void sexp_end_campaign(int n)
{
// in FS2 our ending is a bit wacky. we'll just flag the mission as having ended the campaign
//
// changed this to check for an active supernova rather than a special campaign since the supernova
// code needs special time to execute and will post GS_EVENT_END_CAMPAIGN with Game_mode check
// or show death-popup when it's done - taylor
if ( supernova_active() /*(Game_mode & GM_CAMPAIGN_MODE) && !stricmp(Campaign.filename, "freespace2")*/ ) {
Campaign_ended_in_mission = 1;
} else {
// post and event to move us to the end-of-campaign state. There we will play a movie, then
// go to debriefing.
gameseq_post_event( GS_EVENT_END_CAMPAIGN );
}
}
// sabotage subsystem reduces the strength of a subsystem by the given percentage. If it is reduced to
// below 0%, then the hits of the subsystem are set to 0
void sexp_sabotage_subsystem(int n)
{
char *shipname, *subsystem;
int percentage, shipnum, index, subsys_type;
float sabotage_hits;
ship *shipp;
ship_subsys *ss = NULL, *ss_start;
bool is_generic, do_loop = true;
shipname = CTEXT(n);
subsystem = CTEXT(CDR(n));
percentage = eval_num(CDR(CDR(n)));
shipnum = ship_name_lookup(shipname);
// if no ship, then return immediately.
if ( shipnum == -1 )
return;
shipp = &Ships[shipnum];
// see if we are dealing with the HULL
if ( !stricmp( subsystem, SEXP_HULL_STRING) ) {
float ihs;
object *objp;
ihs = shipp->ship_max_hull_strength;
sabotage_hits = ihs * ((float)percentage / 100.0f);
objp = &Objects[shipp->objnum];
objp->hull_strength -= sabotage_hits;
// self destruct the ship if <= 0.
if ( objp->hull_strength <= 0.0f )
ship_self_destruct( objp );
return;
}
// see if we are dealing with the Simulated HULL
if ( !stricmp( subsystem, SEXP_SIM_HULL_STRING) ) {
float ihs;
object *objp;
ihs = shipp->ship_max_hull_strength;
sabotage_hits = ihs * ((float)percentage / 100.0f);
objp = &Objects[shipp->objnum];
objp->sim_hull_strength -= sabotage_hits;
return;
}
// now find the given subsystem on the ship.This could be a generic type like <All Engines>
is_generic = is_generic_subsys(subsystem);
subsys_type = ai_get_subsystem_type(subsystem);
ss_start = GET_FIRST(&shipp->subsys_list);
while (do_loop) {
if (is_generic) {
// loop until we find a subsystem of that type
for ( ; ss_start != END_OF_LIST(&Ships[shipnum].subsys_list); ss_start = GET_NEXT(ss_start)) {
ss = NULL;
if (subsys_type == ss_start->system_info->type) {
ss = ss_start;
ss_start = GET_NEXT(ss_start);
break;
}
}
// reached the end of the subsystem list
if (ss_start == END_OF_LIST(&Ships[shipnum].subsys_list)) {
// If the last subsystem wasn't of interest we don't need to go any further
if (ss == NULL) {
return;
}
do_loop = false;
}
}
else {
do_loop = false;
index = ship_get_subsys_index(shipp, subsystem, 1); // Bypass any error since we supply one here
if ( index == -1 ) {
nprintf(("Warning", "Couldn't find subsystem %s on ship %s for sabotage subsystem\n", subsystem, shipp->ship_name));
return;
}
// get the pointer to the subsystem. Check it's current hits against it's max hits, and
// set the strength to the given percentage if current strength is > given percentage
ss = ship_get_indexed_subsys( shipp, index );
}
sabotage_hits = ss->max_hits * ((float)percentage / 100.0f);
ss->current_hits -= sabotage_hits;
if ( ss->current_hits < 0.0f )
ss->current_hits = 0.0f;
// maybe blow up subsys
if (ss->current_hits <= 0) {
do_subobj_destroyed_stuff(shipp, ss, NULL);
}
ship_recalc_subsys_strength( shipp );
}
}
// repair_subsystem adds some percentage of hits to a subsystem. Anything repaired about 100% is
// set to max hits
void sexp_repair_subsystem(int n)
{
char *shipname, *subsystem;
int percentage, shipnum, index, do_submodel_repair, subsys_type;
float repair_hits;
ship *shipp;
ship_subsys *ss = NULL, *ss_start;
bool generic, do_loop = true;
shipname = CTEXT(n);
subsystem = CTEXT(CDR(n));
shipnum = ship_name_lookup(shipname);
do_submodel_repair = is_sexp_true(CDDDR(n));
// if no ship, then return immediately.
if ( shipnum == -1 ) {
return;
}
shipp = &Ships[shipnum];
// get percentage
percentage = eval_num(CDR(CDR(n)));
// see if we are dealing with the HULL
if ( !stricmp( subsystem, SEXP_HULL_STRING) ) {
float ihs;
object *objp;
ihs = shipp->ship_max_hull_strength;
repair_hits = ihs * ((float)percentage / 100.0f);
objp = &Objects[shipp->objnum];
objp->hull_strength += repair_hits;
if ( objp->hull_strength > ihs )
objp->hull_strength = ihs;
return;
}
// see if we are dealing with the Simulated HULL
if ( !stricmp( subsystem, SEXP_SIM_HULL_STRING) ) {
float ihs;
object *objp;
ihs = shipp->ship_max_hull_strength;
repair_hits = ihs * ((float)percentage / 100.0f);
objp = &Objects[shipp->objnum];
objp->hull_strength += repair_hits;
if ( objp->sim_hull_strength > ihs )
objp->sim_hull_strength = ihs;
return;
}
// now find the given subsystem on the ship.This could be a generic type like <All Engines>
generic = is_generic_subsys(subsystem);
subsys_type = ai_get_subsystem_type(subsystem);
ss_start = GET_FIRST(&shipp->subsys_list);
while (do_loop) {
if (generic) {
// loop until we find a subsystem of that type
for ( ; ss_start != END_OF_LIST(&Ships[shipnum].subsys_list); ss_start = GET_NEXT(ss_start)) {
ss = NULL;
if (subsys_type == ss_start->system_info->type) {
ss = ss_start;
ss_start = GET_NEXT(ss_start);
break;
}
}
// reached the end of the subsystem list
if (ss_start == END_OF_LIST(&Ships[shipnum].subsys_list)) {
// If the last subsystem wasn't of interest we don't need to go any further
if (ss == NULL) {
return;
}
do_loop = false;
}
}
else {
do_loop = false;
index = ship_get_subsys_index(shipp, subsystem, 1); // Bypass any error since we supply one here
if ( index == -1 ) {
nprintf(("Warning", "Couldn't find subsystem %s on ship %s for repair subsystem\n", subsystem, shipp->ship_name));
return;
}
// get the pointer to the subsystem. Check it's current hits against it's max hits, and
// set the strength to the given percentage if current strength is < given percentage
ss = ship_get_indexed_subsys( shipp, index );
}
repair_hits = ss->max_hits * ((float)percentage / 100.0f);
ss->current_hits += repair_hits;
if ( ss->current_hits > ss->max_hits )
ss->current_hits = ss->max_hits;
if ((ss->current_hits > 0) && (do_submodel_repair))
{
ss->submodel_info_1.blown_off = 0;
ss->submodel_info_2.blown_off = 0;
}
ship_recalc_subsys_strength( shipp );
}
}
// sexpression code to set a subsystem of a ship at a specific percentage
void sexp_set_subsystem_strength(int n)
{
char *shipname, *subsystem;
int percentage, shipnum, index, do_submodel_repair, subsys_type;
ship *shipp;
ship_subsys *ss = NULL, *ss_start;
bool generic_subsys;
bool do_loop = true;
shipname = CTEXT(n);
subsystem = CTEXT(CDR(n));
percentage = eval_num(CDR(CDR(n)));
do_submodel_repair = is_sexp_true(CDDDR(n));
shipnum = ship_name_lookup(shipname);
// if no ship, then return immediately.
if ( shipnum == -1 )
return;
shipp = &Ships[shipnum];
if ( percentage > 100 ) {
mprintf(("Percentage for set_subsystem_strength > 100 on ship %s for subsystem '%s'-- setting to 100\n", shipname, subsystem));
percentage = 100;
} else if ( percentage < 0 ) {
mprintf(("Percantage for set_subsystem_strength < 0 on ship %s for subsystem '%s' -- setting to 0\n", shipname, subsystem));
percentage = 0;
}
// see if we are dealing with the HULL
if ( !stricmp( subsystem, SEXP_HULL_STRING) ) {
float ihs;
object *objp;
objp = &Objects[shipp->objnum];
// destroy the ship if percentage is 0
if ( percentage == 0 ) {
ship_self_destruct( objp );
} else {
ihs = shipp->ship_max_hull_strength;
objp->hull_strength = ihs * ((float)percentage / 100.0f);
}
return;
}
// see if we are dealing with the Simulated HULL
if ( !stricmp( subsystem, SEXP_SIM_HULL_STRING) ) {
float ihs;
object *objp;
objp = &Objects[shipp->objnum];
ihs = shipp->ship_max_hull_strength;
objp->sim_hull_strength = ihs * ((float)percentage / 100.0f);
return;
}
// now find the given subsystem on the ship.This could be a generic type like <All Engines>
generic_subsys = is_generic_subsys(subsystem);
subsys_type = ai_get_subsystem_type(subsystem);
ss_start = GET_FIRST(&shipp->subsys_list);
while (do_loop) {
if (generic_subsys) {
// loop until we find a subsystem of that type
for ( ; ss_start != END_OF_LIST(&Ships[shipnum].subsys_list); ss_start = GET_NEXT(ss_start)) {
ss = NULL;
if (subsys_type == ss_start->system_info->type) {
ss = ss_start;
ss_start = GET_NEXT(ss_start);
break;
}
}
// reached the end of the subsystem list
if (ss_start == END_OF_LIST(&Ships[shipnum].subsys_list)) {
// If the last subsystem wasn't of interest we don't need to go any further
if (ss == NULL) {
return;
}
do_loop = false;
}
}
else {
do_loop = false;
index = ship_get_subsys_index(shipp, subsystem, 1); // Bypass any error since we supply one here
if ( index == -1 ) {
nprintf(("Warning", "Couldn't find subsystem %s on ship %s for set subsystem strength\n", subsystem, shipp->ship_name));
return;
}
// get the pointer to the subsystem. Check it's current hits against it's max hits, and
// set the strength to the given percentage
ss = ship_get_indexed_subsys( shipp, index );
}
// maybe blow up subsys
if (ss->current_hits > 0) {
if (percentage < 1) {
do_subobj_destroyed_stuff(shipp, ss, NULL);
}
}
// set hit points
ss->current_hits = ss->max_hits * ((float)percentage / 100.0f);
if ((ss->current_hits > 0) && (do_submodel_repair))
{
ss->submodel_info_1.blown_off = 0;
ss->submodel_info_2.blown_off = 0;
}
ship_recalc_subsys_strength( shipp );
}
}
// function which changes the validity of a goal. The flag paramater tells us whether to mark the goals
// as valid or invalid
void sexp_change_goal_validity( int n, int flag )
{
char *name;
while ( n != -1 ) {
name = CTEXT(n);
if ( flag )
mission_goal_mark_valid( name );
else
mission_goal_mark_invalid( name );
n = CDR(n);
}
}
// Goober5000
// yeesh - be careful of the cargo-no-deplete flag :p
int sexp_is_cargo(int n)
{
char *cargo, *ship, *subsystem;
int ship_num, cargo_index;
cargo = CTEXT(n);
ship = CTEXT(CDR(n));
if (CDR(CDR(n)) != -1)
subsystem = CTEXT(CDR(CDR(n)));
else
subsystem = NULL;
cargo_index = -1;
// find ship
ship_num = ship_name_lookup(ship);
// in-mission?
if (ship_num != -1)
{
if (subsystem)
{
ship_subsys *ss;
// find the ship subsystem by searching ship's subsys_list
ss = GET_FIRST( &Ships[ship_num].subsys_list );
while ( ss != END_OF_LIST( &Ships[ship_num].subsys_list ) )
{
// if we found the subsystem
if ( !subsystem_stricmp(ss->system_info->subobj_name, subsystem))
{
// set cargo
cargo_index = ss->subsys_cargo_name;
break;
}
ss = GET_NEXT( ss );
}
}
else
{
cargo_index = Ships[ship_num].cargo1;
}
}
else
{
// can't check subsys of ships not in mission
if (subsystem)
{
return SEXP_CANT_EVAL;
}
// departed?
int exited_index = ship_find_exited_ship_by_name(ship);
if (exited_index != -1)
{
cargo_index = Ships_exited[exited_index].cargo1;
}
// not arrived yet
else
{
p_object *p_objp;
// find cargo for the parse object
p_objp = mission_parse_get_arrival_ship(ship);
Assert (p_objp);
cargo_index = (int) p_objp->cargo1;
}
}
// did we get any cargo
if (cargo_index < 0)
return SEXP_FALSE;
// check cargo
if (!stricmp(Cargo_names[cargo_index & CARGO_INDEX_MASK], cargo))
return SEXP_TRUE;
else
return SEXP_FALSE;
}
// Goober5000
// yeesh - be careful of the cargo-no-deplete flag :p
void sexp_set_cargo(int n)
{
char *cargo, *ship, *subsystem;
int ship_num, i, cargo_index;
cargo = CTEXT(n);
ship = CTEXT(CDR(n));
if (CDR(CDR(n)) != -1)
subsystem = CTEXT(CDR(CDR(n)));
else
subsystem = NULL;
// check to see if ship destroyed or departed. In either case, do nothing.
if ( mission_log_get_time(LOG_SHIP_DEPARTED, ship, NULL, NULL) || mission_log_get_time(LOG_SHIP_DESTROYED, ship, NULL, NULL) )
return;
cargo_index = -1;
// find this cargo in the cargo list
for (i = 0; i < Num_cargo; i++)
{
// found it?
if (!stricmp(cargo, Cargo_names[i]))
{
cargo_index = i;
break;
}
}
// not found
if (cargo_index == -1)
{
// make new entry if possible
if (Num_cargo + 1 >= MAX_CARGO)
{
Warning(LOCATION, "set-cargo: Maximum number of cargo names (%d) reached. Ignoring new name.\n", MAX_CARGO);
return;
}
Assert(strlen(cargo) <= NAME_LENGTH - 1);
cargo_index = Num_cargo;
Num_cargo++;
strcpy(Cargo_names[cargo_index], cargo);
}
// get the ship
ship_num = ship_name_lookup(ship);
// we can only set subsystems if the ship is in the mission
if (ship_num != -1)
{
if (subsystem)
{
ship_subsys *ss = ship_get_subsys(&Ships[ship_num], subsystem);
if (ss == NULL) {
Assert (!ship_class_unchanged(ship_num));
return;
}
// set cargo
ss->subsys_cargo_name = cargo_index | (ss->subsys_cargo_name & CARGO_NO_DEPLETE);
}
else
{
// simply set the ship cargo
Ships[ship_num].cargo1 = char(cargo_index | (Ships[ship_num].cargo1 & CARGO_NO_DEPLETE));
}
}
else
{
if (!subsystem)
{
p_object *p_objp;
// set cargo for the parse object
p_objp = mission_parse_get_arrival_ship(ship);
Assert (p_objp);
p_objp->cargo1 = char(cargo_index | (p_objp->cargo1 & CARGO_NO_DEPLETE));
}
}
}
// function to transfer cargo from one ship to another
void sexp_transfer_cargo(int n)
{
char *shipname1, *shipname2;
int shipnum1, shipnum2, i;
shipname1 = CTEXT(n);
shipname2 = CTEXT(CDR(n));
// find the ships -- if neither in the mission, the abort
shipnum1 = ship_name_lookup(shipname1);
shipnum2 = ship_name_lookup(shipname2);
if ( (shipnum1 == -1) || (shipnum2 == -1) )
return;
// we must be sure that these two objects are indeed docked
if (!dock_check_find_direct_docked_object(&Objects[Ships[shipnum1].objnum], &Objects[Ships[shipnum2].objnum]))
{
return;
}
if ( !stricmp(Cargo_names[Ships[shipnum1].cargo1 & CARGO_INDEX_MASK], "nothing") ) {
return;
}
// transfer cargo from ship1 to ship2
#ifndef NDEBUG
// Don't give warning for large ships (cruiser on up)
if (! (Ship_info[Ships[shipnum2].ship_info_index].flags & (SIF_BIG_SHIP | SIF_HUGE_SHIP)) ) {
if ( stricmp(Cargo_names[Ships[shipnum2].cargo1 & CARGO_INDEX_MASK], "nothing") ) {
Warning(LOCATION, "Transfering cargo to %s which already\nhas cargo %s.\nCargo will be replaced", Ships[shipnum2].ship_name, Cargo_names[Ships[shipnum2].cargo1 & CARGO_INDEX_MASK] );
}
}
#endif
Ships[shipnum2].cargo1 = char(Ships[shipnum1].cargo1 & CARGO_INDEX_MASK);
if ( !(Ships[shipnum1].cargo1 & CARGO_NO_DEPLETE) ) {
// need to set ship1's cargo to nothing. scan the cargo_names array looking for the string nothing.
// add it if not found
for (i = 0; i < Num_cargo; i++ ) {
if ( !stricmp(Cargo_names[i], "nothing") ) {
Ships[shipnum1].cargo1 = char(i);
return;
}
}
strcpy(Cargo_names[i], "Nothing");
Num_cargo++;
}
}
// this function exchanges cargo between two ships
void sexp_exchange_cargo(int n)
{
char *shipname1, *shipname2;
int shipnum1, shipnum2, temp;
shipname1 = CTEXT(n);
shipname2 = CTEXT(CDR(n));
// find the ships -- if neither in the mission, abort
shipnum1 = ship_name_lookup(shipname1);
shipnum2 = ship_name_lookup(shipname2);
if ( (shipnum1 == -1) || (shipnum2 == -1) )
return;
// we must be sure that these two objects are indeed docked
if (!dock_check_find_direct_docked_object(&Objects[Ships[shipnum1].objnum], &Objects[Ships[shipnum2].objnum]))
{
Int3(); // you are trying to transfer cargo between two ships not docked
return;
}
temp = (Ships[shipnum1].cargo1 & CARGO_INDEX_MASK);
Ships[shipnum1].cargo1 = char(Ships[shipnum2].cargo1 & CARGO_INDEX_MASK);
Ships[shipnum2].cargo1 = char(temp);
}
void sexp_cap_waypoint_speed(int n)
{
char *shipname;
int shipnum;
int speed;
shipname = CTEXT(n);
speed = eval_num(CDR(n));
shipnum = ship_name_lookup(shipname);
if (shipnum == -1) {
// Int3(); // trying to set waypoint speed of ship not already in game
return;
}
// cap speed to range (-1, 32767) to store within int
if (speed < 0) {
speed = -1;
}
if (speed > 32767) {
speed = 32767;
}
Ai_info[Ships[shipnum].ai_index].waypoint_speed_cap = speed;
}
// this function causes a ship to jettison its cargo
void sexp_jettison_cargo(int n)
{
char *shipname;
int jettison_delay, ship_index;
// get some data
shipname = CTEXT(n);
jettison_delay = eval_num(CDR(n));
// lookup the ship
ship_index = ship_name_lookup(shipname);
if(ship_index < 0)
return;
object *parent_objp = &Objects[Ships[ship_index].objnum];
n = CDDR(n);
// no arguments - jettison all docked objects
if (n == -1)
{
// Goober5000 - as with ai_deathroll_start, we can't simply iterate through the dock list while we're
// undocking things. So just repeatedly jettison the first object.
while (object_is_docked(parent_objp))
{
object_jettison_cargo(parent_objp, dock_get_first_docked_object(parent_objp));
}
}
// arguments - jettison only those objects
else
{
for (; n != -1; n = CDR(n))
{
// make sure ship exists
ship_index = ship_name_lookup(CTEXT(n));
if (ship_index < 0)
continue;
// make sure we are docked to it
if (!dock_check_find_direct_docked_object(parent_objp, &Objects[Ships[ship_index].objnum]))
continue;
object_jettison_cargo(parent_objp, &Objects[Ships[ship_index].objnum]);
}
}
}
void sexp_cargo_no_deplete(int n)
{
char *shipname;
int ship_index, no_deplete = 1;
// get some data
shipname = CTEXT(n);
// lookup the ship
ship_index = ship_name_lookup(shipname);
if(ship_index < 0){
return;
}
if ( !(Ship_info[Ships[ship_index].ship_info_index].flags & (SIF_BIG_SHIP | SIF_HUGE_SHIP)) ) {
Warning(LOCATION, "Trying to make non BIG or HUGE ship %s with non-depletable cargo.\n", Ships[ship_index].ship_name);
return;
}
if (CDR(n) != -1) {
no_deplete = eval_num(CDR(n));
Assert((no_deplete == 0) || (no_deplete == 1));
if ( (no_deplete != 0) && (no_deplete != 1) ) {
no_deplete = 1;
}
}
if (no_deplete) {
Ships[ship_index].cargo1 |= CARGO_NO_DEPLETE;
} else {
Ships[ship_index].cargo1 &= (~CARGO_NO_DEPLETE);
}
}
// Goober5000
void sexp_force_jump()
{
if (Game_mode & GM_MULTIPLAYER) {
multi_handle_end_mission_request();
}
else {
// forced warp, taken from training failure code
gameseq_post_event( GS_EVENT_PLAYER_WARPOUT_START_FORCED ); // Force player to warp out.
}
}
void sexp_mission_set_nebula(int n)
{
stars_set_nebula(eval_num(n) > 0);
}
void sexp_add_background_bitmap(int n)
{
int sexp_var;
int new_number;
char number_as_str[TOKEN_LENGTH];
starfield_list_entry sle;
// filename
strcpy(sle.filename, CTEXT(n));
n = CDR(n);
// sanity checking
if (stars_find_bitmap(sle.filename) < 0)
{
Error(LOCATION, "sexp-add-background-bitmap: Background bitmap %s not found!", sle.filename);
return;
}
// angles
sle.ang.p = fl_radian(eval_num(n) % 360);
n = CDR(n);
sle.ang.b = fl_radian(eval_num(n) % 360);
n = CDR(n);
sle.ang.h = fl_radian(eval_num(n) % 360);
n = CDR(n);
// scale
sle.scale_x = eval_num(n) / 100.0f;
n = CDR(n);
sle.scale_y = eval_num(n) / 100.0f;
n = CDR(n);
// div
sle.div_x = eval_num(n);
n = CDR(n);
sle.div_y = eval_num(n);
n = CDR(n);
// restrict parameters
if (sle.scale_x > 18) sle.scale_x = 18;
if (sle.scale_x < 0.1f) sle.scale_x = 0.1f;
if (sle.scale_y > 18) sle.scale_y = 18;
if (sle.scale_y < 0.1f) sle.scale_y = 0.1f;
if (sle.div_x > 5) sle.div_x = 5;
if (sle.div_x < 1) sle.div_x = 1;
if (sle.div_y > 5) sle.div_y = 5;
if (sle.div_y < 1) sle.div_y = 1;
Assert((n >= 0) && (n < Num_sexp_nodes));
// ripped from sexp_modify_variable()
// get sexp_variable index
Assert(Sexp_nodes[n].first == -1);
sexp_var = atoi(Sexp_nodes[n].text);
// verify variable set
Assert(Sexp_variables[sexp_var].type & SEXP_VARIABLE_SET);
if (Sexp_variables[sexp_var].type & SEXP_VARIABLE_NUMBER)
{
new_number = stars_add_bitmap_entry(&sle);
if (new_number < 0)
{
Warning(LOCATION, "Unable to add starfield bitmap: '%s'!", sle.filename);
new_number = 0;
}
sprintf(number_as_str, "%d", new_number);
// assign to variable
sexp_modify_variable(number_as_str, sexp_var);
}
else
{
Error(LOCATION, "sexp-add-background-bitmap: Variable %s must be a number variable!", Sexp_variables[sexp_var].variable_name);
return;
}
}
void sexp_remove_background_bitmap(int n)
{
int slot = eval_num(n);
if (slot >= 0) {
stars_mark_bitmap_unused( slot );
}
}
void sexp_add_sun_bitmap(int n)
{
int sexp_var;
int new_number;
char number_as_str[TOKEN_LENGTH];
starfield_list_entry sle;
// filename
strcpy(sle.filename, CTEXT(n));
n = CDR(n);
// sanity checking
if (stars_find_sun(sle.filename) < 0)
{
Error(LOCATION, "sexp-add-sun-bitmap: Sun %s not found!", sle.filename);
return;
}
// angles
sle.ang.p = fl_radian(eval_num(n) % 360);
n = CDR(n);
sle.ang.b = fl_radian(eval_num(n) % 360);
n = CDR(n);
sle.ang.h = fl_radian(eval_num(n) % 360);
n = CDR(n);
// scale
sle.scale_x = eval_num(n) / 100.0f;
n = CDR(n);
sle.scale_y = sle.scale_x;
// div
sle.div_x = 1;
sle.div_y = 1;
// restrict parameters
if (sle.scale_x > 50) sle.scale_x = 50;
if (sle.scale_x < 0.1f) sle.scale_x = 0.1f;
if (sle.scale_y > 50) sle.scale_y = 50;
if (sle.scale_y < 0.1f) sle.scale_y = 0.1f;
Assert((n >= 0) && (n < Num_sexp_nodes));
// ripped from sexp_modify_variable()
// get sexp_variable index
Assert(Sexp_nodes[n].first == -1);
sexp_var = atoi(Sexp_nodes[n].text);
// verify variable set
Assert(Sexp_variables[sexp_var].type & SEXP_VARIABLE_SET);
if (Sexp_variables[sexp_var].type & SEXP_VARIABLE_NUMBER)
{
// get new numerical value
new_number = stars_add_sun_entry(&sle);
if (new_number < 0)
{
Warning(LOCATION, "Unable to add sun: '%s'!", sle.filename);
new_number = 0;
}
sprintf(number_as_str, "%d", new_number);
// assign to variable
sexp_modify_variable(number_as_str, sexp_var);
}
else
{
Error(LOCATION, "sexp-add-sun-bitmap: Variable %s must be a number variable!", Sexp_variables[sexp_var].variable_name);
return;
}
}
void sexp_remove_sun_bitmap(int n)
{
int slot = eval_num(n);
if (slot >= 0) {
stars_mark_sun_unused( slot );
}
}
void sexp_nebula_change_storm(int n)
{
if (!(The_mission.flags & MISSION_FLAG_FULLNEB)) return;
nebl_set_storm(CTEXT(n));
}
void sexp_nebula_toggle_poof(int n)
{
char *name = CTEXT(n);
int result = is_sexp_true(CDR(n));
int i;
if (name == NULL) return;
for (i = 0; i < MAX_NEB2_POOFS; i++)
{
if (!stricmp(name,Neb2_poof_filenames[i])) break;
}
//coulnd't find the poof
if (i == MAX_NEB2_POOFS) return;
if (result) Neb2_poof_flags |= (1 << i);
else Neb2_poof_flags &= ~(1 << i);
neb2_eye_changed();
}
// sexpression to end the mission! Fixed by EdrickV, implemented by Sesquipedalian
void sexp_end_mission(int n)
{
send_debrief_event();
// Karajorma - callback all the clients here.
if (MULTIPLAYER_MASTER)
{
multi_handle_sudden_mission_end();
send_force_end_mission_packet();
}
}
// funciton to toggle the status bit for the AI code which tells the AI if it is a good time
// to rearm. The status being set means good time. Status not being set (unset), means bad time.
// designers must implement this.
void sexp_good_time_to_rearm(int n)
{
int team, time;
team = iff_lookup(CTEXT(n));
time = eval_num(CDR(n)); // this is the time for how long a good rearm is active -- in seconds
ai_set_rearm_status(team, time);
}
// function which grants promotion to the player
void sexp_grant_promotion()
{
// short circuit multiplayer for now until we figure out what to do.
if ( Game_mode & GM_MULTIPLAYER )
return;
// set a bit to tell player should get promoted at the end of the mission. I suppose the other
// thing that we could do would be to set the players score to at least the amount of
// points for the next level, but this way is better I think.
if ( Game_mode & GM_CAMPAIGN_MODE ) {
Player->flags |= PLAYER_FLAGS_PROMOTED;
}
}
// function which gives the named medal to the players in the mission
void sexp_grant_medal(int n)
{
int i;
char *medal_name;
// don't give medals in normal gameplay when not in campaign mode
if ( (Game_mode & GM_NORMAL) && !(Game_mode & GM_CAMPAIGN_MODE) )
return;
Assert(Player->stats.m_medal_earned < 0); // Mission has problems. Tried to grant 2 medals in 1 mission.
medal_name = CTEXT(n);
if (medal_name == NULL)
return;
for (i = 0; i < Num_medals; i++ ) {
if ( !stricmp(medal_name, Medals[i].name) )
break;
}
if ( i < Num_medals ) {
Player->stats.m_medal_earned = i;
if ( Game_mode & GM_MULTIPLAYER ) {
for ( int j = 0; j < MAX_PLAYERS; j++ ) {
if ( MULTI_CONNECTED(Net_players[j]) ) {
Net_players[j].m_player->stats.m_medal_earned = i;
}
}
}
}
}
void sexp_change_player_score(int node)
{
int sindex;
int score;
int plr_index;
score = eval_num(node);
node = CDR(node);
if(!(Game_mode & GM_MULTIPLAYER)){
sindex = ship_name_lookup(CTEXT(node));
if (Player_ship != &Ships[sindex]) {
Warning(LOCATION, "Can not award points to '%s'. Ship is not a player!", CTEXT(node));
return;
}
Player->stats.m_score += score;
if (Player->stats.m_score < 0) {
Player->stats.m_score = 0;
}
}
else {
while (node >= 0) {
plr_index = multi_find_player_by_ship_name(CTEXT(node), true);
if (plr_index >= 0) {
Net_player[plr_index].m_player->stats.m_score += score;
if (Net_player[plr_index].m_player->stats.m_score < 0) {
Net_player[plr_index].m_player->stats.m_score = 0;
}
}
node = CDR(node);
}
}
}
void sexp_change_team_score(int node)
{
int i, score, team;
// since we only have a team score in TvT
if ( !(MULTI_TEAM) ) {
return;
}
score = eval_num(node);
team = eval_num(CDR(node));
if (team == 0) {
for (i = 0; i < MAX_TVT_TEAMS; i++) {
Multi_team_score[i] += score;
}
}
else if (team > 0 && team <= MAX_TVT_TEAMS) {
Multi_team_score[team - 1] += score;
}
else {
Warning(LOCATION, "Invalid team number. Team %d does not exist", team);
}
}
void sexp_tech_add_ship(int node)
{
int i;
char *name;
Assert(node >= 0);
// this function doesn't mean anything when not in campaign mode
if ( !(Game_mode & GM_CAMPAIGN_MODE) )
return;
while (node >= 0) {
name = CTEXT(node);
i = ship_info_lookup(name);
if (i >= 0)
Ship_info[i].flags |= SIF_IN_TECH_DATABASE;
else
Error(LOCATION, "Ship class \"%s\" invalid", name);
node = CDR(node);
}
}
void sexp_tech_add_weapon(int node)
{
int i;
char *name;
Assert(node >= 0);
// this function doesn't mean anything when not in campaign mode
if ( !(Game_mode & GM_CAMPAIGN_MODE) )
return;
while (node >= 0) {
name = CTEXT(node);
i = weapon_info_lookup(name);
if (i >= 0)
Weapon_info[i].wi_flags |= WIF_IN_TECH_DATABASE;
else
Error(LOCATION, "Weapon class \"%s\" invalid", name);
node = CDR(node);
}
}
// Goober5000
void sexp_tech_add_intel(int node)
{
int i;
char *name;
Assert(node >= 0);
// this function doesn't mean anything when not in campaign mode
if ( !(Game_mode & GM_CAMPAIGN_MODE) )
return;
while (node >= 0) {
name = CTEXT(node);
i = intel_info_lookup(name);
if (i >= 0)
Intel_info[i].flags |= IIF_IN_TECH_DATABASE;
else
Error(LOCATION, "Intel name \"%s\" invalid", name);
node = CDR(node);
}
}
// Goober5000 - reset all the tech entries to their default states
void sexp_tech_reset_to_default()
{
// this function doesn't mean anything when not in campaign mode
if ( !(Game_mode & GM_CAMPAIGN_MODE) )
return;
tech_reset_to_default();
}
// function to set variables needed to grant a new ship/weapon to the player during the course
// of a mission
void sexp_allow_ship(int n)
{
int idx;
char name[NAME_LENGTH], temp[NAME_LENGTH];
// this function doesn't mean anything when not in campaign mode
if ( !(Game_mode & GM_CAMPAIGN_MODE) )
return;
// get the base name of the ship
strcpy(name, CTEXT(n));
end_string_at_first_hash_symbol(name);
// add that ship, as well as any # equivalents
for (idx = 0; idx < Num_ship_classes; idx++)
{
strcpy(temp, Ship_info[idx].name);
end_string_at_first_hash_symbol(temp);
// we have a match, so allow this ship
if (!strcmp(name, temp))
mission_campaign_save_persistent(CAMPAIGN_PERSISTENT_SHIP, idx);
}
}
void sexp_allow_weapon(int n)
{
int idx;
char name[NAME_LENGTH], temp[NAME_LENGTH];
// this function doesn't mean anything when not in campaign mode
if ( !(Game_mode & GM_CAMPAIGN_MODE) )
return;
// get the base name of the weapon
strcpy(name, CTEXT(n));
end_string_at_first_hash_symbol(name);
// add that weapon, as well as any # equivalents
for (idx = 0; idx < Num_weapon_types; idx++)
{
strcpy(temp, Weapon_info[idx].name);
end_string_at_first_hash_symbol(temp);
// we have a match, so allow this weapon
if (!strcmp(name, temp))
mission_campaign_save_persistent(CAMPAIGN_PERSISTENT_WEAPON, idx);
}
}
// Goober5000
// generic function for all those sexps that set flags
void sexp_deal_with_ship_flag(int node, int object_flag, int object_flag2, int ship_flag, int ship_flag2, int p_object_flag, int p_object_flag2, int set_it, bool send_multiplayer = false, bool include_players_in_ship_lookup = false)
{
char *ship_name;
int ship_index;
if (send_multiplayer && MULTIPLAYER_MASTER) {
multi_start_packet();
multi_send_int(object_flag);
/* Uncommenting this will break compatibility with earlier builds but it is pointless to send it until object_flag2
is actually used by the engine
*/
// multi_send_int(object_flag2);
multi_send_int(ship_flag);
multi_send_int(ship_flag2);
multi_send_int(p_object_flag);
multi_send_int(p_object_flag2);
multi_send_bool(set_it ? true : false);
}
// loop for all ships in the sexp
for (; node >= 0; node = CDR(node))
{
// get ship name
ship_name = CTEXT(node);
// check to see if ship destroyed or departed. In either case, do nothing.
if (mission_log_get_time(LOG_SHIP_DEPARTED, ship_name, NULL, NULL) || mission_log_get_time(LOG_SELF_DESTRUCTED, ship_name, NULL, NULL) || mission_log_get_time(LOG_SHIP_DESTROYED, ship_name, NULL, NULL))
continue;
// see if ship exists in-mission
ship_index = ship_name_lookup(ship_name, include_players_in_ship_lookup ? 1 : 0);
// if ship is in-mission
if (ship_index >= 0)
{
// see if we have an object flag to set
if (object_flag)
{
// set or clear?
if (set_it)
Objects[Ships[ship_index].objnum].flags |= object_flag;
else
Objects[Ships[ship_index].objnum].flags &= ~object_flag;
}
// see if we have an object flag2 to set
if (object_flag2)
{
/*
// set or clear?
if (set_it)
Objects[Ships[ship_index].objnum].flags2 |= object_flag2;
else
Objects[Ships[ship_index].objnum].flags2 &= ~object_flag2;
*/
}
// see if we have a ship flag to set
if (ship_flag)
{
// set or clear?
if (set_it)
Ships[ship_index].flags |= ship_flag;
else
Ships[ship_index].flags &= ~ship_flag;
}
// see if we have a ship flag2 to set
if (ship_flag2)
{
// set or clear?
if (set_it)
Ships[ship_index].flags2 |= ship_flag2;
else
Ships[ship_index].flags2 &= ~ship_flag2;
}
// the lock afterburner SEXP also needs to set a physics flag
if (ship_flag2 == SF2_AFTERBURNER_LOCKED) {
if (set_it) {
Objects[Ships[ship_index].objnum].phys_info.flags &= ~PF_AFTERBURNER_ON;
}
}
if (send_multiplayer && MULTIPLAYER_MASTER) {
multi_send_bool(true);
multi_send_ship(ship_index);
}
}
// if it's not in-mission
else
{
// grab it from the arrival list
p_object *p_objp = mission_parse_get_arrival_ship(ship_name);
if (!p_objp)
{
Int3(); // guess we'll have to track down allender
continue;
}
// see if we have a p_object flag to set
if (p_object_flag)
{
// set or clear?
if (set_it)
p_objp->flags |= p_object_flag;
else
p_objp->flags &= ~p_object_flag;
}
// see if we have a p_object flag2 to set
if (p_object_flag2)
{
// set or clear?
if (set_it)
p_objp->flags2 |= p_object_flag2;
else
p_objp->flags2 &= ~p_object_flag2;
}
if (send_multiplayer && MULTIPLAYER_MASTER) {
multi_send_bool(false);
multi_send_parse_object(p_objp);
}
}
}
if (send_multiplayer && MULTIPLAYER_MASTER) {
multi_end_packet();
}
}
void multi_sexp_deal_with_ship_flag()
{
int object_flag = 0;
// int object_flag2 = 0;
int ship_flag = 0;
int ship_flag2 = 0;
int p_object_flag = 0;
int p_object_flag2 = 0;
bool set_it = false;
bool ship_arrived = true;
ship *shipp = NULL;
p_object *pobjp = NULL;
multi_get_int(object_flag);
// multi_get_int(object_flag2);
multi_get_int(ship_flag);
multi_get_int(ship_flag2);
multi_get_int(p_object_flag);
multi_get_int(p_object_flag2);
multi_get_bool(set_it);
// if any of the above failed so will this one
if (!multi_get_bool(ship_arrived)) {
Int3();
return;
}
if (ship_arrived) {
multi_get_ship(shipp);
if (shipp != NULL) {
if (set_it) {
Objects[shipp->objnum].flags |= object_flag;
// Objects[shipp->objnum].flags2 |= object_flag2;
shipp->flags |= ship_flag;
shipp->flags2 |= ship_flag2;
}
else {
Objects[shipp->objnum].flags &= ~object_flag;
// Objects[shipp->objnum].flags2 &= ~object_flag2;
shipp->flags &= ~ship_flag;
shipp->flags2 &= ~ship_flag2;
}
}
// deal with side effects of these flags
if (ship_flag2 == SF2_AFTERBURNER_LOCKED) {
if (set_it) {
Objects[shipp->objnum].phys_info.flags &= ~PF_AFTERBURNER_ON;
}
}
if (ship_flag2 == SF2_STEALTH && !set_it) {
if (shipp->flags & SF_ESCORT) {
hud_add_ship_to_escort(shipp->objnum, 1);
}
}
if ((ship_flag2 == SF2_FRIENDLY_STEALTH_INVIS) || (ship_flag == SF_HIDDEN_FROM_SENSORS)) {
if (set_it) {
if (Player_ai->target_objnum == shipp->objnum) {
hud_cease_targeting();
}
}
else {
if (shipp->flags & SF_ESCORT) {
hud_add_ship_to_escort(shipp->objnum, 1);
}
}
}
}
else {
multi_get_parse_object(pobjp);
if (pobjp != NULL) {
if (set_it) {
pobjp->flags |= p_object_flag;
pobjp->flags2 |= p_object_flag2;
}
else {
pobjp->flags &= ~p_object_flag;
pobjp->flags2 &= ~p_object_flag2;
}
}
}
}
// modified by Goober5000; now it should work properly
// function to deal with breaking/fixing the warp engines on ships/wings.
// --repairable is true when we are breaking the warp drive (can be repaired)
// --damage_it is true when we are sabotaging it, one way or the other; false when fixing it
void sexp_deal_with_warp( int n, int repairable, int damage_it )
{
int ship_flag, p_object_flag;
if (repairable)
{
ship_flag = SF_WARP_BROKEN;
p_object_flag = P_SF_WARP_BROKEN;
}
else
{
ship_flag = SF_WARP_NEVER;
p_object_flag = P_SF_WARP_NEVER;
}
sexp_deal_with_ship_flag(n, 0, 0, ship_flag, 0, p_object_flag, 0, damage_it);
}
// function which is used to tell the AI when it is okay to fire certain secondary
// weapons at other ships.
void sexp_good_secondary_time(int n)
{
char *team_name, *weapon_name, *ship_name;
int num_weapons, weapon_index, team;
team_name = CTEXT(n);
num_weapons = eval_num(CDR(n));
weapon_name = CTEXT(CDR(CDR(n)));
ship_name = CTEXT(CDR(CDR(CDR(n))));
weapon_index = weapon_info_lookup(weapon_name);
if ( weapon_index == -1 ) {
nprintf(("Warning", "couldn't find weapon %s for good-secondary-time\n", weapon_name));
return;
}
// get the team type from the team_name
team = iff_lookup(team_name);
// see if the ship has departed or has been destroyed. If so, then we don't need to set up the
// AI stuff
if ( mission_log_get_time(LOG_SHIP_DEPARTED, ship_name, NULL, NULL) || mission_log_get_time(LOG_SHIP_DESTROYED, ship_name, NULL, NULL) )
return;
ai_good_secondary_time( team, weapon_index, num_weapons, ship_name );
}
// Karajorma - Turns the built in messages for pilots and command on or off
void sexp_toggle_builtin_messages (int node, bool enable_messages)
{
char *ship_name;
int wingnum, shipnum, ship_index ;
// If no arguments were supplied then turn off all messages then bail
if (node < 0)
{
if (enable_messages)
{
The_mission.flags &= ~MISSION_FLAG_NO_BUILTIN_MSGS;
return;
}
else
{
The_mission.flags |= MISSION_FLAG_NO_BUILTIN_MSGS;
return;
}
}
// iterate through all the nodes supplied
while (node != -1)
{
// check that this isn't a request to silence command.
ship_name = CTEXT(node);
// if (ship_name[0] == '#' )
if (!stricmp(ship_name, "#Command"))
{
// Either disable or enable messages from command
if (enable_messages)
{
The_mission.flags &= ~MISSION_FLAG_NO_BUILTIN_COMMAND;
}
else
{
The_mission.flags |= MISSION_FLAG_NO_BUILTIN_COMMAND;
}
}
else if (!stricmp(ship_name, "<Any Wingman>"))
{
// Since trying to determine whose wingman in a stand alone multiplayer game opens a can of worms
// Any Wingman silences all ships in wings regardless of whose side they're on.
for (wingnum = 0; wingnum < Num_wings; wingnum++ ) {
for ( shipnum = 0; shipnum < Wings[wingnum].current_count; shipnum++ ) {
ship_index = Wings[wingnum].ship_index[shipnum];
Assert( ship_index != -1 );
if (enable_messages) {
Ships[ship_index].flags2 &= ~SF2_NO_BUILTIN_MESSAGES;
}
else {
Ships[ship_index].flags2 |= SF2_NO_BUILTIN_MESSAGES;
}
}
}
}
// If it isn't command then assume that we're dealing with a ship
else
{
if (enable_messages)
{
sexp_deal_with_ship_flag(node, 0, 0, 0, SF2_NO_BUILTIN_MESSAGES, 0, P2_SF2_NO_BUILTIN_MESSAGES, 0);
}
else
{
sexp_deal_with_ship_flag(node, 0, 0, 0, SF2_NO_BUILTIN_MESSAGES, 0, P2_SF2_NO_BUILTIN_MESSAGES, 1);
}
}
node = CDR(node);
}
}
void sexp_set_persona (int node)
{
int persona_index = -1, sindex, i;
char *persona_name;
persona_name = CTEXT(node);
for (i = 0 ; i < Num_personas ; i++) {
if (!strcmp(persona_name, Personas[i].name) && (Personas[i].flags & PERSONA_FLAG_WINGMAN)) {
persona_index = i;
break;
}
}
if (persona_index == -1) {
Warning(LOCATION, "Unable to change to persona type: '%s'. Persona is not a wingman!", persona_name);
return;
}
node = CDR(node);
Assert (node >=0);
if (MULTIPLAYER_MASTER) {
multi_start_packet();
multi_send_int(persona_index);
}
// now loop through the list of ships
while (node >= 0) {
sindex = ship_name_lookup( CTEXT(node) );
if (sindex < 0) {
return;
}
if (Ships[sindex].objnum < 0) {
return;
}
Ships[sindex].persona_index = persona_index;
if (MULTIPLAYER_MASTER) {
multi_send_ship(sindex);
}
node = CDR(node);
}
if (MULTIPLAYER_MASTER) {
multi_end_packet();
}
}
void multi_sexp_set_persona()
{
ship *shipp = NULL;
int persona_index = -1;
if (!multi_get_int(persona_index) ) {
return;
}
while (multi_get_ship(shipp)) {
Assert(persona_index != -1);
if (shipp != NULL) {
shipp->persona_index = persona_index;
}
}
}
int sexp_weapon_fired_delay(int node, int op_num)
{
ship *shipp;
weapon_info * wip;
int requested_bank;
int delay;
int last_fired = -1;
shipp = sexp_get_ship_from_node(node);
if (shipp == NULL) {
return SEXP_FALSE;
}
// Get the bank to check
node = CDR(node);
requested_bank = eval_num(node);
if (requested_bank < 0) {
return SEXP_FALSE;
}
// get the delay
node = CDR(node);
delay = eval_num(node);
if (delay <= 0 ) {
return SEXP_FALSE;
}
switch (op_num) {
case OP_PRIMARY_FIRED_SINCE:
if (requested_bank >= shipp->weapons.num_primary_banks) {
return SEXP_FALSE;
}
wip = &Weapon_info[shipp->weapons.primary_bank_weapons[requested_bank]];
last_fired = shipp->weapons.next_primary_fire_stamp[requested_bank] - (int)(wip->fire_wait * 1000);
break;
case OP_SECONDARY_FIRED_SINCE:
if (requested_bank >= shipp->weapons.num_secondary_banks) {
return SEXP_FALSE;
}
wip = &Weapon_info[shipp->weapons.secondary_bank_weapons[requested_bank]];
last_fired = shipp->weapons.next_secondary_fire_stamp[requested_bank] - (int)(wip->fire_wait * 1000);
break;
}
if (last_fired < 0) {
// weapon was never fired
return SEXP_FALSE;
}
if (timestamp() - delay < last_fired) {
return SEXP_TRUE;
}
return SEXP_FALSE;
}
// function to deal with getting status of goals for previous missions (in the current campaign).
// the status parameter is used to tell this function if we are looking for a goal_satisfied, goal_failed,
// or goal incomplete event
int sexp_previous_goal_status( int n, int status )
{
int rval = 0;
char *goal_name, *mission_name;
int i, mission_num, default_value = 0, use_defaults = 1;
mission_name = CTEXT(n);
goal_name = CTEXT(CDR(n));
// check for possible next optional argument
n = CDR(CDR(n));
if ( n != -1 ) {
default_value = is_sexp_true(n);
}
// try to find the given mission name in the current list of missions in the campaign.
if ( Game_mode & GM_CAMPAIGN_MODE ) {
i = mission_campaign_find_mission( mission_name );
if ( i == -1 ) {
// if mission not found, assume that goal was false (so previous-goal-false returns true)
nprintf(("General", "Couldn't find mission name %s in current campaign's list of missions.\nReturning %s for goal-status function.", mission_name, (status==GOAL_COMPLETE)?"false":"true"));
if ( status == GOAL_COMPLETE )
rval = SEXP_KNOWN_FALSE;
else
rval = SEXP_KNOWN_TRUE;
use_defaults = 0;
} else if (Campaign.missions[i].flags & CMISSION_FLAG_SKIPPED) {
use_defaults = 1;
} else {
// now try and find the goal this mission
mission_num = i;
for (i = 0; i < Campaign.missions[mission_num].num_goals; i++) {
if ( !stricmp(Campaign.missions[mission_num].goals[i].name, goal_name) )
break;
}
if ( i == Campaign.missions[mission_num].num_goals ) {
Warning(LOCATION, "Couldn't find goal name %s in mission %s.\nReturning %s for goal-true function.", goal_name, mission_name, (status==GOAL_COMPLETE)?"false":"true");
if ( status == GOAL_COMPLETE )
rval = SEXP_KNOWN_FALSE;
else
rval = SEXP_KNOWN_TRUE;
} else {
// now return KNOWN_TRUE or KNOWN_FALSE based on the status field in the goal structure
if ( Campaign.missions[mission_num].goals[i].status == status )
rval = SEXP_KNOWN_TRUE;
else
rval = SEXP_KNOWN_FALSE;
}
use_defaults = 0;
}
}
if (use_defaults) {
// when not in campaign mode, always return KNOWN_TRUE when looking for goal complete, and KNOWN_FALSE
// otherwise
if ( n != -1 ) {
if ( default_value )
rval = SEXP_KNOWN_TRUE;
else
rval = SEXP_KNOWN_FALSE;
} else {
if ( status == GOAL_COMPLETE )
rval = SEXP_KNOWN_TRUE;
else
rval = SEXP_KNOWN_FALSE;
}
}
return rval;
}
// sexpression which gets the status of an event from a previous mission. Like the above function but
// dealing with events instead of goals. Again, the status parameter tells the code if we are looking
// for an event_true, event_false, or event_incomplete status
int sexp_previous_event_status( int n, int status )
{
int rval = 0;
char *name, *mission_name;
int i, mission_num, default_value = 0, use_defaults = 1;
mission_name = CTEXT(n);
name = CTEXT(CDR(n));
// check for possible optional parameter
n = CDR(CDR(n));
if ( n != -1 ){
default_value = is_sexp_true(n);
}
if ( Game_mode & GM_CAMPAIGN_MODE ) {
// following function returns -1 when mission isn't found.
i = mission_campaign_find_mission( mission_name );
// if the mission name wasn't found -- make this return FALSE for the event status.
if ( i == -1 ) {
nprintf(("General", "Couldn't find mission name %s in current campaign's list of missions.\nReturning %s for event-status function.", mission_name, (status==EVENT_SATISFIED)?"false":"true"));
if ( status == EVENT_SATISFIED ) {
rval = SEXP_KNOWN_FALSE;
} else {
rval = SEXP_KNOWN_TRUE;
}
use_defaults = 0;
} else if (Campaign.missions[i].flags & CMISSION_FLAG_SKIPPED) {
use_defaults = 1;
} else {
// now try and find the goal this mission
mission_num = i;
for (i = 0; i < Campaign.missions[mission_num].num_events; i++) {
if ( !stricmp(Campaign.missions[mission_num].events[i].name, name) )
break;
}
if ( i == Campaign.missions[mission_num].num_events ) {
Warning(LOCATION, "Couldn't find event name %s in mission %s.\nReturning %s for event_status function.", name, mission_name, (status==EVENT_SATISFIED)?"false":"true");
if ( status == EVENT_SATISFIED )
rval = SEXP_KNOWN_FALSE;
else
rval = SEXP_KNOWN_TRUE;
} else {
// now return KNOWN_TRUE or KNOWN_FALSE based on the status field in the goal structure
if ( Campaign.missions[mission_num].events[i].status == status )
rval = SEXP_KNOWN_TRUE;
else
rval = SEXP_KNOWN_FALSE;
}
use_defaults = 0;
}
}
if (use_defaults) {
if ( n != -1 ) {
if ( default_value )
rval = SEXP_KNOWN_TRUE;
else
rval = SEXP_KNOWN_FALSE;
} else {
if ( status == EVENT_SATISFIED )
rval = SEXP_KNOWN_TRUE;
else
rval = SEXP_KNOWN_FALSE;
}
}
return rval;
}
// function to return the status of an event in the current mission. The passed parameter indicates
// if we are checking whether the event is true or the event is false.
int sexp_event_status( int n, int want_true )
{
char *name;
int i, result;
name = CTEXT(n);
if (name == NULL) {
Int3();
return SEXP_FALSE;
}
for (i = 0; i < Num_mission_events; i++ ) {
// look for the event name, check it's status. If formula is gone, we know the state won't ever change.
if ( !stricmp(Mission_events[i].name, name) ) {
result = Mission_events[i].result;
if (Mission_events[i].formula < 0) {
if ( (want_true && result) || (!want_true && !result) )
return SEXP_KNOWN_TRUE;
else
return SEXP_KNOWN_FALSE;
} else {
if ( (want_true && result) || (!want_true && !result) )
return SEXP_TRUE;
else
return SEXP_FALSE;
}
}
}
return SEXP_FALSE;
}
// function to return the status of an event N seconds after the event is true or false. Similar
// to above function but waits N seconds before returning true
int sexp_event_delay_status( int n, int want_true )
{
char *name;
int i, result;
fix delay;
int rval = SEXP_FALSE;
int use_as_directive = 0;
name = CTEXT(n);
if (name == NULL) {
Int3();
return SEXP_FALSE;
}
delay = i2f(eval_num(CDR(n)));
for (i = 0; i < Num_mission_events; i++ ) {
// look for the event name, check it's status. If formula is gone, we know the state won't ever change.
if ( !stricmp(Mission_events[i].name, name) ) {
if ( (fix) Mission_events[i].timestamp + delay >= Missiontime ) {
rval = SEXP_FALSE;
break;
}
result = Mission_events[i].result;
if (Mission_events[i].formula < 0) {
if ( (want_true && result) || (!want_true && !result) ) {
rval = SEXP_KNOWN_TRUE;
break;
} else {
rval = SEXP_KNOWN_FALSE;
break;
}
} else {
if ( want_true && result ) { //) || (!want_true && !result) )
rval = SEXP_TRUE;
break;
} else {
rval = SEXP_FALSE;
break;
}
}
}
}
// check for possible optional parameter
n = CDDR(n);
if (n != -1)
use_as_directive = is_sexp_true(n);
// zero out Sexp_useful_number if it's not true and we don't want this for specific directive use
if ( !use_as_directive && (rval != SEXP_TRUE) && (rval != SEXP_KNOWN_TRUE) )
Sexp_useful_number = 0; // indicate sexp isn't current yet
return rval;
}
// function which returns true if the given event is still incomplete
int sexp_event_incomplete(int n)
{
char *name;
int i;
name = CTEXT(n);
if (name == NULL) {
Int3();
return SEXP_FALSE;
}
for (i = 0; i < Num_mission_events; i++ ) {
if ( !stricmp(Mission_events[i].name, name ) ) {
// if the formula is still >= 0 (meaning it is still getting eval'ed), then
// the event is incomplete
if ( Mission_events[i].formula != -1 )
return SEXP_TRUE;
else
return SEXP_KNOWN_FALSE;
}
}
return SEXP_FALSE;
}
// function to return the status of an goal N seconds after the goal is true or false. Similar
// to above function but operates on goals instead of events
int sexp_goal_delay_status( int n, int want_true )
{
char *name;
fix delay, time;
name = CTEXT(n);
delay = i2f(eval_num(CDR(n)));
if ( want_true ) {
// if we are looking for a goal true entry and we find a false, then return known false here
if ( mission_log_get_time(LOG_GOAL_FAILED, name, NULL, NULL) )
return SEXP_KNOWN_FALSE;
else if ( mission_log_get_time(LOG_GOAL_SATISFIED, name, NULL, &time) ) {
if ( (Missiontime - time) >= delay )
return SEXP_KNOWN_TRUE;
}
} else {
// if we are looking for a goal false entry and we find a true, then return known false here
if ( mission_log_get_time(LOG_GOAL_SATISFIED, name, NULL, NULL) )
return SEXP_KNOWN_FALSE;
else if ( mission_log_get_time(LOG_GOAL_FAILED, name, NULL, &time) ) {
if ( (Missiontime - time) >= delay )
return SEXP_KNOWN_TRUE;
}
}
return SEXP_FALSE;
}
// function which returns true if the given goal is still incomplete
int sexp_goal_incomplete(int n)
{
char *name;
name = CTEXT(n);
if ( mission_log_get_time( LOG_GOAL_SATISFIED, name, NULL, NULL) || mission_log_get_time( LOG_GOAL_FAILED, name, NULL, NULL) )
return SEXP_KNOWN_FALSE;
else
return SEXP_TRUE;
}
// protects/unprotects a ship. The flag tells us whether or not the protect bit should be set (flag==1)
// or cleared (flag==0)
void sexp_protect_ships(int n, int flag)
{
sexp_deal_with_ship_flag(n, OF_PROTECTED, 0, 0, 0, P_OF_PROTECTED, 0, flag);
}
// protects/unprotects a ship. The flag tells us whether or not the protect bit should be set (flag==1)
// or cleared (flag==0)
void sexp_beam_protect_ships(int n, int flag )
{
sexp_deal_with_ship_flag(n, OF_BEAM_PROTECTED, 0, 0, 0, P_OF_BEAM_PROTECTED, 0, flag);
}
// Goober5000 - sets the "dont collide invisible" flag on a list of ships
void sexp_dont_collide_invisible(int n, int dont_collide)
{
sexp_deal_with_ship_flag(n, 0, 0, 0, SF2_DONT_COLLIDE_INVIS, 0, P_SF2_DONT_COLLIDE_INVIS, dont_collide);
}
// Goober5000 - sets the vaporize flag on a list of ships
void sexp_ships_vaporize(int n, int vaporize)
{
sexp_deal_with_ship_flag(n, 0, 0, SF_VAPORIZE, 0, P_SF_VAPORIZE, 0, vaporize);
}
// sexpression to make ships "visible" and "invisible" to sensors. The visible parameter is true
// when making ships visible, false otherwise
void sexp_ships_visible(int n, int visible)
{
sexp_deal_with_ship_flag(n, 0, 0, SF_HIDDEN_FROM_SENSORS, 0, P_SF_HIDDEN_FROM_SENSORS, 0, !visible, true);
// we also have to add any escort ships that were made visible
for (; n >= 0; n = CDR(n))
{
int shipnum = ship_name_lookup(CTEXT(n));
if (shipnum < 0)
continue;
if (!visible && Player_ai->target_objnum == Ships[shipnum].objnum) {
hud_cease_targeting();
}
else if (visible && (Ships[shipnum].flags & SF_ESCORT)) {
hud_add_ship_to_escort(Ships[shipnum].objnum, 1);
}
}
}
// Goober5000
void sexp_ships_stealthy(int n, int stealthy)
{
sexp_deal_with_ship_flag(n, 0, 0, 0, SF2_STEALTH, 0, P_SF2_STEALTH, stealthy, true);
// we also have to add any escort ships that were made visible
if (!stealthy)
{
for (; n >= 0; n = CDR(n))
{
int shipnum = ship_name_lookup(CTEXT(n));
if (shipnum < 0)
continue;
if (Ships[shipnum].flags & SF_ESCORT)
hud_add_ship_to_escort(Ships[shipnum].objnum, 1);
}
}
}
// Goober5000
void sexp_friendly_stealth_invisible(int n, int invisible)
{
sexp_deal_with_ship_flag(n, 0, 0, 0, SF2_FRIENDLY_STEALTH_INVIS, 0, P_SF2_FRIENDLY_STEALTH_INVIS, invisible, true);
// we also have to add any escort ships that were made visible
if (!invisible)
{
for (; n >= 0; n = CDR(n))
{
int shipnum = ship_name_lookup(CTEXT(n));
if (shipnum < 0)
continue;
if (Ships[shipnum].flags & SF_ESCORT)
hud_add_ship_to_escort(Ships[shipnum].objnum, 1);
}
}
}
// Goober5000
void sexp_ship_subsys_untargetable(int n, int untargetable)
{
char *subsys;
ship_subsys *ss;
// get the ship
int ship_num = ship_name_lookup(CTEXT(n));
if (ship_num < 0)
return;
n = CDR(n);
// get the subsystems
for (; n >= 0; n = CDR(n))
{
subsys = CTEXT(n);
// deal with generic subsystem names
if (is_generic_subsys(subsys)) {
int subsys_type = ai_get_subsystem_type(subsys);
for (ss = GET_FIRST(&Ships[ship_num].subsys_list); ss != END_OF_LIST(&Ships[ship_num].subsys_list); ss = GET_NEXT(ss)) {
if (subsys_type == ss->system_info->type) {
if (untargetable)
ss->flags |= SSF_UNTARGETABLE;
else
ss->flags &= ~SSF_UNTARGETABLE;
}
}
}
else {
ss = ship_get_subsys(&Ships[ship_num], subsys);
if (ss == NULL)
continue;
if (untargetable)
ss->flags |= SSF_UNTARGETABLE;
else
ss->flags &= ~SSF_UNTARGETABLE;
}
}
}
// Goober5000
void sexp_ship_tag( int n, int tag )
{
int ship_num, tag_level, tag_time, ssm_index(0);
int ssm_team = 0;
// check to see if ship destroyed or departed. In either case, do nothing.
if ( mission_log_get_time(LOG_SHIP_DEPARTED, CTEXT(n), NULL, NULL) || mission_log_get_time(LOG_SHIP_DESTROYED, CTEXT(n), NULL, NULL) )
return;
// get the ship num
ship_num = ship_name_lookup(CTEXT(n));
if ( ship_num < 0 )
return;
// if untag, then unset everything and leave
if (!tag)
{
Ships[ship_num].tag_left = -1.0f;
Ships[ship_num].level2_tag_left = -1.0f;
return;
}
// get the tag level and time
n = CDR(n);
tag_level = eval_num(n);
n = CDR(n);
tag_time = eval_num(n);
// get SSM info if needed
vec3d start;
if (tag_level == 3)
{
n = CDR(n);
if (n < 0)
return;
ssm_index = ssm_info_lookup(CTEXT(n));
if (ssm_index < 0)
return;
n = CDR(n);
if (n < 0)
return;
start.xyz.x = (float)eval_num(n);
n = CDR(n);
if (n < 0)
return;
start.xyz.y = (float)eval_num(n);
n = CDR(n);
if (n < 0)
return;
start.xyz.z = (float)eval_num(n);
n = CDR(n);
if (n < 0)
{
ssm_team = 0;
}
else
{
ssm_team = iff_lookup(CTEXT(n));
}
}
ship_apply_tag(ship_num, tag_level, (float)tag_time, &Objects[Ships[ship_num].objnum], &start, ssm_index, ssm_team);
}
// sexpression to toggle invulnerability flag of ships.
void sexp_ships_invulnerable( int n, int invulnerable )
{
sexp_deal_with_ship_flag(n, OF_INVULNERABLE, 0, 0, 0, P_OF_INVULNERABLE, 0, invulnerable);
}
void sexp_ships_bomb_targetable(int n, int targetable)
{
sexp_deal_with_ship_flag(n, OF_TARGETABLE_AS_BOMB, 0, 0, 0, 0, P2_OF_TARGETABLE_AS_BOMB, targetable, true);
}
// Goober5000
void sexp_ship_guardian_threshold(int num)
{
char *ship_name;
int ship_num, threshold;
int n = -1;
threshold = eval_num(num);
n = CDR(num);
// for all ships
for ( ; n != -1; n = CDR(n) ) {
// check to see if ship destroyed or departed. In either case, do nothing.
ship_name = CTEXT(n);
if ( mission_log_get_time(LOG_SHIP_DEPARTED, ship_name, NULL, NULL) || mission_log_get_time(LOG_SHIP_DESTROYED, ship_name, NULL, NULL) ) {
continue;
}
// get the ship num. If we get a -1 for the number here, ship has yet to arrive.
ship_num = ship_name_lookup(ship_name);
if (ship_num != -1) {
Ships[ship_num].ship_guardian_threshold = threshold;
}
}
}
// Goober5000
void sexp_ship_subsys_guardian_threshold(int num)
{
char *ship_name, *hull_name;
int ship_num, threshold, subsys_type = SUBSYSTEM_UNKNOWN;;
ship_subsys *ss;
int n = -1;
threshold = eval_num(num);
n = CDR(num);
// check to see if ship destroyed or departed. In either case, do nothing.
ship_name = CTEXT(n);
if ( mission_log_get_time(LOG_SHIP_DEPARTED, ship_name, NULL, NULL) || mission_log_get_time(LOG_SHIP_DESTROYED, ship_name, NULL, NULL) ) {
return;
}
// get the ship num. If we get a -1 for the number here, ship has yet to arrive.
ship_num = ship_name_lookup(ship_name);
if (ship_num == -1) {
return;
}
n = CDR(n);
// for all subsystems
for ( ; n != -1; n = CDR(n) ) {
// check for HULL
hull_name = CTEXT(n);
if (hull_name != NULL) {
if ( !strcmp(hull_name, SEXP_HULL_STRING) ) {
Ships[ship_num].ship_guardian_threshold = threshold;
}
else if (is_generic_subsys(hull_name)) {
subsys_type = ai_get_subsystem_type(hull_name);
// search through all subsystems
for (ss = GET_FIRST(&Ships[ship_num].subsys_list); ss != END_OF_LIST(&Ships[ship_num].subsys_list); ss = GET_NEXT(ss)) {
if (subsys_type == ss->system_info->type) {
ss->subsys_guardian_threshold = threshold;
}
}
}
else {
ss = ship_get_subsys(&Ships[ship_num], hull_name);
if ( ss == NULL ) {
if (ship_class_unchanged(ship_num)) {
Warning(LOCATION, "Invalid subsystem passed to ship-subsys-guardian-threshold: %s does not have a %s subsystem", ship_name, hull_name);
}
}
else {
ss->subsys_guardian_threshold = threshold;
}
}
}
}
}
// sexpression to toggle KEEP ALIVE flag of ship object
void sexp_ships_guardian( int n, int guardian )
{
char *ship_name;
int num;
for ( ; n != -1; n = CDR(n) )
{
ship_name = CTEXT(n);
// check to see if ship destroyed or departed. In either case, do nothing.
if ( mission_log_get_time(LOG_SHIP_DEPARTED, ship_name, NULL, NULL) || mission_log_get_time(LOG_SHIP_DESTROYED, ship_name, NULL, NULL) )
continue;
// get the ship num. If we get a -1 for the number here, ship has yet to arrive. Store this ship
// in a list until created
num = ship_name_lookup(ship_name);
if ( num != -1 ) {
Ships[num].ship_guardian_threshold = guardian ? SHIP_GUARDIAN_THRESHOLD_DEFAULT : 0;
} else {
p_object *p_objp = mission_parse_get_arrival_ship(ship_name);
if (p_objp)
{
if ( guardian )
p_objp->flags |= P_SF_GUARDIAN;
else
p_objp->flags &= ~P_SF_GUARDIAN;
}
}
}
}
void sexp_ship_create(int n)
{
int new_ship_class = -1;
char *new_ship_name;
vec3d new_ship_pos = vmd_zero_vector;
angles new_ship_ang = {0.0f, 0.0f, 0.0f};
matrix new_ship_ori = vmd_identity_matrix;
bool change_angles = false;
Assert( n >= 0 );
// get ship name - none means don't specify it
// if ship with this name already exists, ship_create will respond appropriately
if (!stricmp(CTEXT(n), SEXP_NONE_STRING))
{
new_ship_name = NULL;
}
else
{
new_ship_name = CTEXT(n);
}
//Get ship class
n = CDR(n);
new_ship_class = ship_info_lookup(CTEXT(n));
if(new_ship_class == -1) {
Warning(LOCATION, "Invalid ship class passed to ship-create; ship type '%s' does not exist", CTEXT(n));
return;
}
n = CDR(n);
new_ship_pos.xyz.x = (float) eval_num(n);
n = CDR(n);
new_ship_pos.xyz.y = (float) eval_num(n);
n = CDR(n);
new_ship_pos.xyz.z = (float) eval_num(n);
n = CDR(n);
if(n != -1) {
new_ship_ang.p = eval_num(n) * (PI/180.0f);
change_angles = true;
}
n = CDR(n);
if(n != -1) {
new_ship_ang.b = eval_num(n) * (PI/180.0f);
change_angles = true;
}
n = CDR(n);
if(n != -1) {
new_ship_ang.h = eval_num(n) * (PI/180.0f);
change_angles = true;
}
//This is a costly function, so only do it if needed
if(change_angles) {
vm_angles_2_matrix(&new_ship_ori, &new_ship_ang);
}
ship_create(&new_ship_ori, &new_ship_pos, new_ship_class, new_ship_name);
}
// Goober5000
void sexp_weapon_create(int n)
{
int weapon_class, parent_objnum, target_objnum, weapon_objnum;
ship_subsys *targeted_ss;
vec3d weapon_pos = vmd_zero_vector;
angles weapon_angles = {0.0f, 0.0f, 0.0f};
matrix weapon_orient = vmd_identity_matrix;
int is_locked;
bool change_angles = false;
Assert( n >= 0 );
parent_objnum = -1;
if (stricmp(CTEXT(n), SEXP_NONE_STRING))
{
int parent_ship = ship_name_lookup(CTEXT(n));
if (parent_ship >= 0)
parent_objnum = Ships[parent_ship].objnum;
}
n = CDR(n);
weapon_class = weapon_info_lookup(CTEXT(n));
n = CDR(n);
if (weapon_class < 0)
{
Warning(LOCATION, "Invalid weapon class passed to weapon-create; weapon type '%s' does not exist", CTEXT(n));
return;
}
weapon_pos.xyz.x = (float) eval_num(n);
n = CDR(n);
weapon_pos.xyz.y = (float) eval_num(n);
n = CDR(n);
weapon_pos.xyz.z = (float) eval_num(n);
n = CDR(n);
if (n >= 0)
{
weapon_angles.p = eval_num(n) * (PI/180.0f);
n = CDR(n);
change_angles = true;
}
if (n >= 0)
{
weapon_angles.b = eval_num(n) * (PI/180.0f);
n = CDR(n);
change_angles = true;
}
if (n >= 0)
{
weapon_angles.h = eval_num(n) * (PI/180.0f);
n = CDR(n);
change_angles = true;
}
// This is a costly function, so only do it if needed
if (change_angles)
{
vm_angles_2_matrix(&weapon_orient, &weapon_angles);
}
target_objnum = -1;
if (n >= 0)
{
int target_ship = ship_name_lookup(CTEXT(n));
if (target_ship >= 0)
target_objnum = Ships[target_ship].objnum;
n = CDR(n);
}
targeted_ss = NULL;
if (n >= 0)
{
if (target_objnum >= 0)
{
targeted_ss = ship_get_subsys(&Ships[Objects[target_objnum].instance], CTEXT(n));
}
n = CDR(n);
}
is_locked = (target_objnum >= 0) ? 1 : 0; // assume full lock; this lets lasers track if people want them to
// create the weapon
weapon_objnum = weapon_create(&weapon_pos, &weapon_orient, weapon_class, parent_objnum, -1, is_locked);
// maybe make the weapon track its target
if (is_locked)
weapon_set_tracking_info(weapon_objnum, parent_objnum, target_objnum, is_locked, targeted_ss);
}
// make ship vanish without a trace (and what its docked to)
void sexp_ship_vanish(int n)
{
char *ship_name;
int num;
// if MULTIPLAYER bail
if (Game_mode & GM_MULTIPLAYER) {
return;
}
for ( ; n != -1; n = CDR(n) ) {
ship_name = CTEXT(n);
// check to see if ship destroyed or departed. In either case, do nothing.
if ( mission_log_get_time(LOG_SHIP_DEPARTED, ship_name, NULL, NULL) || mission_log_get_time(LOG_SHIP_DESTROYED, ship_name, NULL, NULL) )
continue;
// get the ship num. If we get a -1 for the number here, ship has yet to arrive
num = ship_name_lookup(ship_name);
if ( num != -1 )
ship_actually_depart(num, SHIP_VANISHED);
}
}
void sexp_shields_off(int n, int shields_off ) //-Sesquipedalian
{
sexp_deal_with_ship_flag(n, OF_NO_SHIELDS, 0, 0, 0, P_OF_NO_SHIELDS, 0, shields_off);
}
// Goober5000
void sexp_ingame_ship_kamikaze(ship *shipp, int kdamage)
{
Assert(shipp);
ai_info *aip = &Ai_info[shipp->ai_index];
if (kdamage > 0)
{
aip->ai_flags |= AIF_KAMIKAZE;
aip->kamikaze_damage = i2fl(kdamage);
}
else
{
aip->ai_flags &= ~AIF_KAMIKAZE;
aip->kamikaze_damage = 0.0f;
}
}
// Goober5000
void sexp_parse_ship_kamikaze(p_object *parse_obj, int kdamage)
{
Assert(parse_obj);
if (kdamage > 0)
{
parse_obj->flags |= P_AIF_KAMIKAZE;
parse_obj->kamikaze_damage = i2fl(kdamage);
}
else
{
parse_obj->flags &= ~P_AIF_KAMIKAZE;
parse_obj->kamikaze_damage = 0.0f;
}
}
// Goober5000 - redone, added wing stuff
void sexp_kamikaze(int n, int kamikaze)
{
int kdamage;
kdamage = 0;
if (kamikaze)
{
kdamage = eval_num(n);
n = CDR(n);
}
for ( ; n != -1; n = CDR(n) )
{
object_ship_wing_point_team oswpt;
sexp_get_object_ship_wing_point_team(&oswpt, CTEXT(n));
switch (oswpt.type)
{
// change ingame ship
case OSWPT_TYPE_SHIP:
{
sexp_ingame_ship_kamikaze(oswpt.shipp, kdamage);
break;
}
// change ship yet to arrive
case OSWPT_TYPE_PARSE_OBJECT:
{
sexp_parse_ship_kamikaze(oswpt.p_objp, kdamage);
break;
}
// change wing (we must set the flags for all ships present as well as all ships yet to arrive)
case OSWPT_TYPE_WING:
{
// current ships
for (int i = 0; i < oswpt.wingp->current_count; i++)
sexp_ingame_ship_kamikaze(&Ships[oswpt.wingp->ship_index[i]], kdamage);
// ships yet to arrive
for (p_object *p_objp = GET_FIRST(&Ship_arrival_list); p_objp != END_OF_LIST(&Ship_arrival_list); p_objp = GET_NEXT(p_objp))
{
if (p_objp->wingnum == WING_INDEX(oswpt.wingp))
sexp_parse_ship_kamikaze(p_objp, kdamage);
}
}
}
}
}
// Goober5000
void sexp_ingame_ship_alt_name(ship *shipp, char *alt_name)
{
Assert((shipp != NULL) && (alt_name != NULL));
// see if this is actually the ship class
if (!stricmp(Ship_info[shipp->ship_info_index].name, alt_name))
{
shipp->alt_type_index = -1;
return;
}
// see if we can add the new name (it will automatically reset if there's no space on the alt-type list)
shipp->alt_type_index = (char) mission_parse_add_alt(alt_name);
}
// Goober5000
void sexp_parse_ship_alt_name(p_object *parse_obj, char *alt_name)
{
Assert((parse_obj != NULL) && (alt_name != NULL));
// see if this is actually the ship class
if (!stricmp(Ship_class_names[parse_obj->ship_class], alt_name))
{
parse_obj->alt_type_index = -1;
return;
}
// see if we can add the new name (it will automatically reset if there's no space on the alt-type list)
parse_obj->alt_type_index = (char) mission_parse_add_alt(alt_name);
}
// Goober5000
void sexp_ship_change_alt_name(int n)
{
char *new_alt_name;
// get the alt-name
new_alt_name = CTEXT(n);
n = CDR(n);
for ( ; n != -1; n = CDR(n) )
{
object_ship_wing_point_team oswpt;
sexp_get_object_ship_wing_point_team(&oswpt, CTEXT(n));
switch (oswpt.type)
{
// change ingame ship
case OSWPT_TYPE_SHIP:
{
sexp_ingame_ship_alt_name(oswpt.shipp, new_alt_name);
break;
}
// change ship yet to arrive
case OSWPT_TYPE_PARSE_OBJECT:
{
sexp_parse_ship_alt_name(oswpt.p_objp, new_alt_name);
break;
}
// change wing (we must set the flags for all ships present as well as all ships yet to arrive)
case OSWPT_TYPE_WING:
{
// current ships
for (int i = 0; i < oswpt.wingp->current_count; i++)
sexp_ingame_ship_alt_name(&Ships[oswpt.wingp->ship_index[i]], new_alt_name);
// ships yet to arrive
for (p_object *p_objp = GET_FIRST(&Ship_arrival_list); p_objp != END_OF_LIST(&Ship_arrival_list); p_objp = GET_NEXT(p_objp))
{
if (p_objp->wingnum == WING_INDEX(oswpt.wingp))
sexp_parse_ship_alt_name(p_objp, new_alt_name);
}
}
}
}
}
// Goober5000
void sexp_set_death_message(int n)
{
strcpy(Player->death_message, CTEXT(n));
extern void lcl_replace_stuff(char *text, unsigned int max_len);
lcl_replace_stuff(Player->death_message, 256);
sexp_replace_variable_names_with_values(Player->death_message, 256);
}
int sexp_key_pressed(int node)
{
int z, t;
Assert(node != -1);
z = translate_key_to_index(CTEXT(node));
if (z < 0){
return SEXP_FALSE;
}
if (!Control_config[z].used){
return SEXP_FALSE;
}
if (CDR(node) < 0){
return SEXP_TRUE;
}
t = eval_num(CDR(node));
return timestamp_has_time_elapsed(Control_config[z].used, t * 1000);
}
void sexp_key_reset(int node)
{
int n, z;
for (n = node; n != -1; n = CDR(n))
{
z = translate_key_to_index(CTEXT(n));
if (z >= 0)
Control_config[z].used = 0;
}
}
int sexp_targeted(int node)
{
int z;
ship_subsys *ptr;
z = ship_query_state(CTEXT(node));
if (z == 1){
return SEXP_KNOWN_FALSE; // ship isn't around, nor will it ever be
} else if (z == -1) {
return SEXP_CANT_EVAL;
}
z = ship_name_lookup(CTEXT(node), 1);
if ((z < 0) || !Player_ai || (Ships[z].objnum != Player_ai->target_objnum)){
return SEXP_FALSE;
}
if (CDR(node) >= 0) {
z = eval_num(CDR(node)) * 1000;
if (!timestamp_has_time_elapsed(Players_target_timestamp, z)){
return SEXP_FALSE;
}
if (CDR(CDR(node)) >= 0) {
ptr = Player_ai->targeted_subsys;
if (!ptr || subsystem_stricmp(ptr->system_info->subobj_name, CTEXT(CDR(CDR(node))))){
return SEXP_FALSE;
}
}
}
return SEXP_TRUE;
}
int sexp_speed(int node)
{
if (Training_context & TRAINING_CONTEXT_SPEED) {
if (Training_context_speed_set){
if (timestamp_has_time_elapsed(Training_context_speed_timestamp, eval_num(node) * 1000)){
return SEXP_KNOWN_TRUE;
}
}
}
return SEXP_FALSE;
}
// Goober5000
int sexp_primaries_depleted(int node)
{
int sindex, num_banks, num_depleted_banks;
ship *shipp;
// get ship
sindex = ship_name_lookup(CTEXT(node));
if (sindex < 0) {
return SEXP_FALSE;
}
shipp = &Ships[sindex];
if (shipp->objnum < 0) {
return SEXP_FALSE;
}
// see if ship has ballistic primary weapons
if (!(Ship_info[shipp->ship_info_index].flags & SIF_BALLISTIC_PRIMARIES))
return SEXP_FALSE;
// get num primary banks
num_banks = shipp->weapons.num_primary_banks;
num_depleted_banks = 0;
// get number of depleted banks
for (int idx=0; idx<num_banks; idx++)
{
// is this a ballistic bank?
if (Weapon_info[shipp->weapons.primary_bank_weapons[idx]].wi_flags2 & WIF2_BALLISTIC)
{
// is this bank out of ammo?
if (shipp->weapons.primary_bank_ammo[idx] == 0)
{
num_depleted_banks++;
}
}
}
// are they all depleted?
return (num_depleted_banks == num_banks);
}
int sexp_secondaries_depleted(int node)
{
int sindex, num_banks, num_depleted_banks;
ship *shipp;
// get ship
sindex = ship_name_lookup(CTEXT(node));
if (sindex < 0) {
return SEXP_FALSE;
}
shipp = &Ships[sindex];
if (shipp->objnum < 0) {
return SEXP_FALSE;
}
// get num secondary banks
num_banks = shipp->weapons.num_secondary_banks;
num_depleted_banks = 0;
// get number of depleted banks
for (int idx=0; idx<num_banks; idx++) {
if (shipp->weapons.secondary_bank_ammo[idx] == 0) {
num_depleted_banks++;
}
}
// are they all depleted?
return (num_depleted_banks == num_banks);
}
int sexp_facing(int node)
{
int obj, sh;
float a1, a2;
vec3d v1, v2;
if (ship_query_state(CTEXT(node)) < 0){
return SEXP_KNOWN_FALSE;
}
sh = ship_name_lookup(CTEXT(node));
if ((sh < 0) || !Player_obj){
return SEXP_FALSE;
}
obj = Ships[sh].objnum;
v1 = Player_obj->orient.vec.fvec;
vm_vec_normalize(&v1);
vm_vec_sub(&v2, &Objects[obj].pos, &Player_obj->pos);
vm_vec_normalize(&v2);
a1 = vm_vec_dotprod(&v1, &v2);
a2 = (float) cos(ANG_TO_RAD(atof(CTEXT(CDR(node)))));
if (a1 >= a2){
return SEXP_TRUE;
}
return SEXP_FALSE;
}
// is ship facing first waypoint in waypoint path
int sexp_facing2(int node)
{
int i;
float a1, a2;
vec3d v1, v2;
// bail if Player_obj is not good
if (!Player_obj) {
return SEXP_CANT_EVAL;
}
// get player fvec
v1 = Player_obj->orient.vec.fvec;
vm_vec_normalize(&v1);
// get waypoint name
char *waypoint_name = CTEXT(node);
// get position of first waypoint
int wp_index = -1;
for (i=0; i<Num_waypoint_lists; i++) {
if (!stricmp(waypoint_name, Waypoint_lists[i].name)) {
wp_index = i;
break;
}
}
if (wp_index == -1) {
return SEXP_CANT_EVAL;
}
// Waypoint_lists[wp_index].waypoints[0]
vm_vec_sub(&v2, &Waypoint_lists[wp_index].waypoints[0], &Player_obj->pos);
vm_vec_normalize(&v2);
a1 = vm_vec_dotprod(&v1, &v2);
a2 = (float) cos(ANG_TO_RAD(atof(CTEXT(CDR(node)))));
if (a1 >= a2){
return SEXP_TRUE;
}
return SEXP_FALSE;
}
int sexp_order(int n)
{
char *order_to = CTEXT(n);
char *order = CTEXT(CDR(n));
char *target = NULL;
//target
n = CDDR(n);
if (n != -1)
target = CTEXT(n);
return hud_query_order_issued(order_to, order, target);
}
int sexp_query_orders (int n)
{
char *order_to = CTEXT(n);
char *order = CTEXT(CDR(n));
char *target = NULL;
char *order_from = NULL;
char *special = NULL;
int timestamp = 0;
// delay
n = CDDR(n);
if (n != -1) {
timestamp = eval_sexp(n);
n = CDR(n);
}
//target
if (n != -1) {
target = CTEXT(n);
n = CDR(n);
}
// player order comes from
if (n != -1) {
order_from = CTEXT(n);
n = CDR(n);
}
// optional special argument
if (n != -1)
special = CTEXT(n);
return hud_query_order_issued(order_to, order, target, timestamp, order_from, special);
}
// Karajorma
void sexp_reset_orders (int n)
{
Squadmsg_history.clear();
}
int sexp_waypoint_missed()
{
if (Training_context & TRAINING_CONTEXT_FLY_PATH) {
if (Training_context_at_waypoint > Training_context_goal_waypoint){
return SEXP_TRUE;
}
}
return SEXP_FALSE;
}
int sexp_waypoint_twice()
{
if (Training_context & TRAINING_CONTEXT_FLY_PATH) {
if (Training_context_at_waypoint < Training_context_goal_waypoint - 1){
return SEXP_TRUE;
}
}
return SEXP_FALSE;
}
int sexp_path_flown()
{
if (Training_context & TRAINING_CONTEXT_FLY_PATH) {
if (Training_context_goal_waypoint == Waypoint_lists[Training_context_path].count){
return SEXP_TRUE;
}
}
return SEXP_FALSE;
}
void sexp_send_training_message(int node)
{
int t = -1, delay = 0;
if(physics_paused){
return;
}
Assert(node >= 0);
Assert(Event_index >= 0);
if ((CDR(node) >= 0) && (CDR(CDR(node)) >= 0)) {
delay = eval_num(CDR(CDR(node))) * 1000;
t = CDR(CDR(CDR(node)));
if (t >= 0){
t = eval_num(t);
}
}
if ((Mission_events[Event_index].repeat_count > 1) || (CDR(node) < 0)){
message_training_queue(CTEXT(node), timestamp(delay), t);
} else {
message_training_queue(CTEXT(CDR(node)), timestamp(delay), t);
}
// if (Training_msg_method)
// gameseq_post_event(GS_EVENT_TRAINING_PAUSE);
}
int sexp_shield_recharge_pct(int node)
{
int sindex;
// get the firing ship
sindex = ship_name_lookup(CTEXT(node));
if(sindex < 0){
return 0;
}
if(Ships[sindex].objnum < 0){
return 0;
}
// shield recharge pct
return (int)(100.0f * Energy_levels[Ships[sindex].shield_recharge_index]);
}
int sexp_engine_recharge_pct(int node)
{
int sindex;
// get the firing ship
sindex = ship_name_lookup(CTEXT(node));
if(sindex < 0){
return 0;
}
if(Ships[sindex].objnum < 0){
return 0;
}
// shield recharge pct
return (int)(100.0f * Energy_levels[Ships[sindex].engine_recharge_index]);
}
int sexp_weapon_recharge_pct(int node)
{
int sindex;
// get the firing ship
sindex = ship_name_lookup(CTEXT(node));
if(sindex < 0){
return 0;
}
if(Ships[sindex].objnum < 0){
return 0;
}
// shield recharge pct
return (int)(100.0f * Energy_levels[Ships[sindex].weapon_recharge_index]);
}
int sexp_shield_quad_low(int node)
{
int sindex, idx;
float max_quad, check;
ship_info *sip;
object *objp;
// get the ship
sindex = ship_name_lookup(CTEXT(node));
if(sindex < 0){
return SEXP_FALSE;
}
if((Ships[sindex].objnum < 0) || (Ships[sindex].objnum >= MAX_OBJECTS)){
return SEXP_FALSE;
}
if((Ships[sindex].ship_info_index < 0) || (Ships[sindex].ship_info_index >= Num_ship_classes)){
return SEXP_FALSE;
}
objp = &Objects[Ships[sindex].objnum];
sip = &Ship_info[Ships[sindex].ship_info_index];
if(!(sip->flags & SIF_SMALL_SHIP)){
return SEXP_FALSE;
}
max_quad = get_max_shield_quad(objp);
// shield pct
check = (float)eval_num(CDR(node));
// check his quadrants
for(idx=0; idx<MAX_SHIELD_SECTIONS; idx++){
if( ((objp->shield_quadrant[idx] / max_quad) * 100.0f) <= check ){
return SEXP_TRUE;
}
}
// all good
return SEXP_FALSE;
}
// Goober5000
int sexp_primary_ammo_pct(int node)
{
ship *shipp;
int sindex;
int check, idx;
int ret_sum[MAX_SHIP_PRIMARY_BANKS];
int ret = 0;
// get the ship
sindex = ship_name_lookup(CTEXT(node));
if(sindex < 0)
{
return 0;
}
if((Ships[sindex].objnum < 0) || (Ships[sindex].objnum >= MAX_OBJECTS))
{
return 0;
}
shipp = &Ships[sindex];
// bank to check
check = eval_num(CDR(node));
// bogus check?
if(check < 0){
return 0;
}
// cumulative sum?
if(check >= shipp->weapons.num_primary_banks)
{
for(idx=0; idx<shipp->weapons.num_primary_banks; idx++)
{
// ballistic
if (Weapon_info[shipp->weapons.primary_bank_weapons[idx]].wi_flags2 & WIF2_BALLISTIC)
{
ret_sum[idx] = (int)(((float)shipp->weapons.primary_bank_ammo[idx] / (float)shipp->weapons.primary_bank_start_ammo[idx]) * 100.0f);
}
// non-ballistic
else
{
ret_sum[idx] = 100;
}
}
// add it up
ret = 0;
for(idx=0; idx<shipp->weapons.num_primary_banks; idx++)
{
ret += ret_sum[idx];
}
ret = (int)((float)ret / (float)shipp->weapons.num_primary_banks);
}
else
{
// ballistic
if (Weapon_info[shipp->weapons.primary_bank_weapons[check]].wi_flags2 & WIF2_BALLISTIC)
{
ret = (int)(((float)shipp->weapons.primary_bank_ammo[check] / (float)shipp->weapons.primary_bank_start_ammo[check]) * 100.0f);
}
// non-ballistic
else
{
ret = 100;
}
}
// return
return ret;
}
int sexp_secondary_ammo_pct(int node)
{
ship *shipp;
int sindex;
int check, idx;
int ret_sum[MAX_SHIP_SECONDARY_BANKS];
int ret = 0;
// get the ship
sindex = ship_name_lookup(CTEXT(node));
if(sindex < 0){
return 0;
}
if((Ships[sindex].objnum < 0) || (Ships[sindex].objnum >= MAX_OBJECTS)){
return 0;
}
shipp = &Ships[sindex];
// bank to check
check = eval_num(CDR(node));
// bogus check?
if(check < 0){
return 0;
}
// cumulative sum?
if(check >= shipp->weapons.num_secondary_banks){
for(idx=0; idx<shipp->weapons.num_secondary_banks; idx++){
ret_sum[idx] = (int)(((float)shipp->weapons.secondary_bank_ammo[idx] / (float)shipp->weapons.secondary_bank_start_ammo[idx]) * 100.0f);
}
// add it up
ret = 0;
for(idx=0; idx<shipp->weapons.num_secondary_banks; idx++){
ret += ret_sum[idx];
}
ret = (int)((float)ret / (float)shipp->weapons.num_secondary_banks);
} else {
ret = (int)(((float)shipp->weapons.secondary_bank_ammo[check] / (float)shipp->weapons.secondary_bank_start_ammo[check]) * 100.0f);
}
// return
return ret;
}
// Karajorma - returns the number of bullets left in an ballistic ammo bank. Unlike primary_ammo_pct
// it does this as a numerical value rather than as a percentage of the maximum
int sexp_get_primary_ammo(int node)
{
ship *shipp;
int ammo_left = 0;
int sindex;
int check;
// get the ship
sindex = ship_name_lookup(CTEXT(node));
if(sindex < 0)
{
return 0;
}
if((Ships[sindex].objnum < 0) || (Ships[sindex].objnum >= MAX_OBJECTS))
{
return 0;
}
shipp = &Ships[sindex];
// bank to check
check = eval_num(CDR(node));
// bogus check?
if(check < 0){
return 0;
}
// cumulative sum?
if(check >= shipp->weapons.num_primary_banks)
{
for(int bank=0; bank<shipp->weapons.num_primary_banks; bank++)
{
// Only ballistic weapons need to be counted
if (Weapon_info[shipp->weapons.primary_bank_weapons[bank]].wi_flags2 & WIF2_BALLISTIC)
{
ammo_left += shipp->weapons.primary_bank_ammo[bank] ;
}
}
}
else
{
// Again only ballistic weapons need to be counted
if (Weapon_info[shipp->weapons.primary_bank_weapons[check]].wi_flags2 & WIF2_BALLISTIC)
{
ammo_left = shipp->weapons.primary_bank_ammo[check] ;
}
}
// return
return ammo_left;
}
// Karajorma - sets the amount of ammo in a certain ballistic weapon bank to the specified value
void sexp_set_primary_ammo (int node)
{
int sindex;
int requested_bank ;
int requested_weapons ;
int rearm_limit = 0;
// Check that a ship has been supplied
sindex = ship_name_lookup(CTEXT(node));
if (sindex < 0)
{
return ;
}
// Get the bank to set the number on
requested_bank = eval_num(CDR(node));
if (requested_bank < 0)
{
return ;
}
// Get the number of weapons requested
node = CDR(node);
requested_weapons = eval_num(CDR(node));
if (requested_weapons < 0)
{
return ;
}
node = CDDR(node);
// If a rearm limit hasn't been specified simply change the ammo.Otherwise read in the rearm limit
if (node < 0) {
set_primary_ammo (sindex, requested_bank, requested_weapons);
}
else {
rearm_limit = eval_num(node);
set_primary_ammo (sindex, requested_bank, requested_weapons, rearm_limit);
}
}
//Karajorma - Helper function for the set-primary-ammo and weapon functions
void set_primary_ammo (int ship_index, int requested_bank, int requested_ammo, int rearm_limit, bool update)
{
ship *shipp;
int maximum_allowed ;
// Check that it's valid
if((Ships[ship_index].objnum < 0) || (Ships[ship_index].objnum >= MAX_OBJECTS)){
return ;
}
shipp = &Ships[ship_index];
// Can only set one bank at a time. Check that someone hasn't asked for the contents of all
// the banks or a non-existant bank
if ((requested_bank > shipp->weapons.num_primary_banks) || requested_bank < 0)
{
return ;
}
// Check that this isn't a non-ballistic bank as it's pointless to set the amount of ammo for those
if (!(Weapon_info[shipp->weapons.primary_bank_weapons[requested_bank]].wi_flags2 & WIF2_BALLISTIC))
{
return ;
}
//Check that a valid number of weapons have been specified.
if (requested_ammo < 0)
{
return ;
}
// Is the number requested larger than the maximum allowed for that particular bank?
maximum_allowed = fl2i((shipp->weapons.primary_bank_capacity[requested_bank]
/ Weapon_info[shipp->weapons.primary_bank_weapons[requested_bank]].cargo_size)+0.5);
if (maximum_allowed < requested_ammo)
{
requested_ammo = maximum_allowed ;
}
// Set the number of weapons
shipp->weapons.primary_bank_ammo[requested_bank] = requested_ammo ;
// If a rearm limit has been specified set it.
if (rearm_limit >= 0)
{
// Don't allow more weapons than the bank can actually hold.
if (rearm_limit > maximum_allowed)
{
rearm_limit = maximum_allowed;
}
shipp->weapons.primary_bank_start_ammo[requested_bank] = rearm_limit;
}
// The change needs to be passed on if this is a multiplayer game
if (MULTIPLAYER_MASTER & update)
{
send_weapon_or_ammo_changed_packet(ship_index, 0, requested_bank, requested_ammo, rearm_limit, -1);
}
}
// Karajorma - returns the number of missiles left in an ammo bank. Unlike secondary_ammo_pct
// it does this as a numerical value rather than as a percentage of the maximum
int sexp_get_secondary_ammo (int node)
{
int ammo_left = 0 ;
ship *shipp ;
int sindex ;
int check ;
// Get the ship
sindex = ship_name_lookup(CTEXT(node));
if (sindex < 0)
{
return 0;
}
if((Ships[sindex].objnum < 0) || (Ships[sindex].objnum >= MAX_OBJECTS)){
return 0;
}
shipp = &Ships[sindex];
// bank to check
check = eval_num(CDR(node));
// bogus check?
if(check < 0){
return 0;
}
// Are we looking at the number of secondaries in all banks?
if(check > shipp->weapons.num_secondary_banks)
{
for(int bank=0; bank<shipp->weapons.num_secondary_banks; bank++)
{
ammo_left += shipp->weapons.secondary_bank_ammo[bank] ;
}
}
// If not return the value for the bank requested.
else
{
ammo_left = shipp->weapons.secondary_bank_ammo[check] ;
}
return ammo_left ;
}
// Karajorma - sets the amount of ammo in a certain weapon bank to the specified value
void sexp_set_secondary_ammo (int node)
{
int sindex;
int requested_bank;
int requested_weapons;
int rearm_limit;
// Check that a ship has been supplied
sindex = ship_name_lookup(CTEXT(node));
if (sindex < 0)
{
return ;
}
// Get the bank to set the number on
requested_bank = eval_num(CDR(node));
if (requested_bank < 0)
{
return ;
}
// Get the number of weapons requested
node = CDR(node);
requested_weapons = eval_num(CDR(node));
if (requested_weapons < 0)
{
return ;
}
node = CDDR(node);
// If a rearm limit hasn't been specified simply change the ammo.Otherwise read in the rearm limit
if (node < 0) {
set_secondary_ammo(sindex, requested_bank, requested_weapons);
}
else {
rearm_limit = eval_num(node);
set_secondary_ammo(sindex, requested_bank, requested_weapons, rearm_limit);
}
}
//Karajorma - Helper function for the set-secondary-ammo and weapon functions
void set_secondary_ammo (int ship_index, int requested_bank, int requested_ammo, int rearm_limit, bool update)
{
ship *shipp;
int maximum_allowed;
// Check that it's valid
if((Ships[ship_index].objnum < 0) || (Ships[ship_index].objnum >= MAX_OBJECTS)){
return ;
}
shipp = &Ships[ship_index];
// Can only set one bank at a time. Check that someone hasn't asked for the contents of all
// the banks or a non-existant bank
if ((requested_bank > shipp->weapons.num_secondary_banks) || requested_bank < 0)
{
return ;
}
if (requested_ammo < 0)
{
return ;
}
// Is the number requested larger than the maximum allowed for that particular bank?
maximum_allowed = fl2i(shipp->weapons.secondary_bank_capacity[requested_bank]
/ Weapon_info[shipp->weapons.secondary_bank_weapons[requested_bank]].cargo_size);
if (maximum_allowed < requested_ammo)
{
requested_ammo = maximum_allowed ;
}
// Set the number of weapons
shipp->weapons.secondary_bank_ammo[requested_bank] = requested_ammo ;
// If a rearm limit has been specified set it.
if (rearm_limit >= 0)
{
// Don't allow more weapons than the bank can actually hold.
if (rearm_limit > maximum_allowed)
{
rearm_limit = maximum_allowed;
}
shipp->weapons.secondary_bank_start_ammo[requested_bank] = rearm_limit;
}
// The change needs to be passed on if this is a multiplayer game and we're not already updating the weapon
if (MULTIPLAYER_MASTER && update)
{
send_weapon_or_ammo_changed_packet(ship_index, 1, requested_bank, requested_ammo, rearm_limit, -1);
}
}
// Karajorma - Changes the weapon in the requested bank to the one supplied. Optionally sets the ammo and
// rearm limit too.
void sexp_set_weapon (int node, bool primary)
{
ship *shipp;
int sindex, requested_bank, windex, requested_ammo=-1, rearm_limit=-1;
Assert (node != -1);
// Check that a ship has been supplied
sindex = ship_name_lookup(CTEXT(node));
if (sindex < 0)
{
return ;
}
// Check that it's valid
if((Ships[sindex].objnum < 0) || (Ships[sindex].objnum >= MAX_OBJECTS)){
return ;
}
shipp = &Ships[sindex];
// Get the bank to change the weapon of
requested_bank = eval_num(CDR(node));
// Skip to the node holding the weapon name
node = CDDR(node);
windex = weapon_info_lookup(CTEXT(node));
if (windex < 0)
{
return;
}
if (primary)
{
// Change the weapon
shipp->weapons.primary_bank_weapons[requested_bank] = windex ;
}
else
{
// Change the weapon
shipp->weapons.secondary_bank_weapons[requested_bank] = windex ;
}
// Check to see if the optional ammo and rearm_limit settings were supplied
node = CDR(node);
if (node >= 0) {
requested_ammo = eval_num(node);
if (requested_ammo < 0) {
requested_ammo = 0;
}
node = CDR(node);
// If nothing was supplied then set the rearm limit to a negative value so that it is ignored
if (node < 0) {
rearm_limit = -1;
}
else {
rearm_limit = eval_num(node);
}
// Set the ammo but do not send an ammo changed update packet as we'll do that later from here
if (primary) {
set_primary_ammo (sindex, requested_bank, requested_ammo, rearm_limit, false);
}
else {
set_secondary_ammo (sindex, requested_bank, requested_ammo, rearm_limit, false);
}
}
else {
// read the data
if (primary) {
requested_ammo = shipp->weapons.primary_bank_ammo[requested_bank];
rearm_limit = shipp->weapons.primary_bank_start_ammo[requested_bank];
}
else {
requested_ammo = shipp->weapons.secondary_bank_ammo[requested_bank];
rearm_limit = shipp->weapons.secondary_bank_start_ammo[requested_bank];
}
}
// Now pass this info on to clients if need be.
if (MULTIPLAYER_MASTER)
{
if (primary) {
send_weapon_or_ammo_changed_packet(sindex, 0, requested_bank, requested_ammo, rearm_limit, windex);
}
else {
send_weapon_or_ammo_changed_packet(sindex, 1, requested_bank, requested_ammo, rearm_limit, windex);
}
}
}
// KeldorKatarn - Locks or unlocks the afterburner on the requested ship
void sexp_deal_with_afterburner_lock (int node, bool lock)
{
Assert (node != -1);
sexp_deal_with_ship_flag(node, 0, 0, 0, SF2_AFTERBURNER_LOCKED, 0, 0, (lock ? 1:0), true);
}
// Karajorma - locks or unlocks primary weapons on the requested ship
void sexp_deal_with_primary_lock (int node, bool lock)
{
Assert (node != -1);
sexp_deal_with_ship_flag(node, 0, 0, 0, SF2_PRIMARIES_LOCKED, 0, P2_SF2_PRIMARIES_LOCKED, (lock ? 1:0), true);
}
void sexp_deal_with_secondary_lock (int node, bool lock)
{
Assert (node != -1);
sexp_deal_with_ship_flag(node, 0, 0, 0, SF2_SECONDARIES_LOCKED, 0, P2_SF2_SECONDARIES_LOCKED, (lock ? 1:0), true);
}
//Karajorma - Changes the subsystem name displayed on the HUD.
void sexp_change_subsystem_name(int node)
{
ship *shipp;
int ship_index;
char *new_name;
ship_subsys *subsystem_to_rename;
Assert (node != -1);
// Check that a ship has been supplied
ship_index = ship_name_lookup(CTEXT(node));
if (ship_index < 0) {
return;
}
shipp = &Ships[ship_index];
node = CDR(node);
if (node < 0) {
return;
}
new_name = CTEXT(node);
node = CDR(node);
if (MULTIPLAYER_MASTER) {
multi_start_packet();
multi_send_ship(shipp);
multi_send_string(new_name);
}
// loop through all the subsystems the SEXP has provided
while (node >= 0) {
//Get the new subsystem name
subsystem_to_rename = ship_get_subsys(&Ships[ship_index], CTEXT(node));
if (subsystem_to_rename != NULL) {
ship_subsys_set_name(subsystem_to_rename, new_name);
if (MULTIPLAYER_MASTER) {
multi_send_string(CTEXT(node));
}
}
node = CDR(node);
}
if (MULTIPLAYER_MASTER) {
multi_end_packet();
}
}
void multi_sexp_change_subsystem_name()
{
ship *shipp = NULL;
char new_name[TOKEN_LENGTH];
char subsys_name[MAX_NAME_LEN];
ship_subsys *subsystem_to_rename;
multi_get_ship(shipp);
multi_get_string(new_name);
while (multi_get_string(subsys_name)) {
subsystem_to_rename = ship_get_subsys(shipp, subsys_name);
if (subsystem_to_rename != NULL) {
ship_subsys_set_name(subsystem_to_rename, new_name);
}
}
}
// Goober5000
void sexp_change_ship_class(int n)
{
int ship_num, class_num = ship_info_lookup(CTEXT(n));
Assert(class_num != -1);
n = CDR(n);
if (MULTIPLAYER_MASTER) {
multi_start_packet();
multi_send_int(class_num);
}
// all ships in the sexp
for ( ; n != -1; n = CDR(n))
{
ship_num = ship_name_lookup(CTEXT(n), 1);
// If the ship hasn't arrived we still want the ability to change its class.
if (ship_num == -1)
{
// Get the name of the ship that we are interested in
char* ship_name = CTEXT(n);
p_object *pobj ;
bool match_found = false;
// Search the Ship_arrival_list to see if the ship is waiting to arrive
for (pobj = GET_FIRST(&Ship_arrival_list); pobj != END_OF_LIST(&Ship_arrival_list); pobj = GET_NEXT(pobj))
{
if (!(strcmp(pobj->name, ship_name)))
{
match_found = true;
break;
}
}
if (match_found)
{
swap_parse_object(pobj, class_num);
if (MULTIPLAYER_MASTER) {
multi_send_bool(false);
multi_send_parse_object(pobj);
}
}
}
// If the ship is already in the mission
else
{
// don't mess with a ship that's occupied
if (!(Ships[ship_num].flags & (SF_DYING | SF_ARRIVING | SF_DEPARTING)))
{
change_ship_type(ship_num, class_num, 1);
if (MULTIPLAYER_MASTER) {
multi_send_bool(true);
multi_send_ship(ship_num);
}
}
}
}
if (MULTIPLAYER_MASTER) {
multi_end_packet();
}
}
void multi_sexp_change_ship_class()
{
int class_num = -1;
int ship_num = -1;
bool ship_arrived;
p_object *pobjp = NULL;
multi_get_int(class_num);
multi_get_bool(ship_arrived);
if (ship_arrived) {
multi_get_ship(ship_num);
if ((class_num >= 0) && (ship_num >= 0)) {
change_ship_type(ship_num, class_num, 1);
}
}
else {
multi_get_parse_object(pobjp);
if ((class_num >= 0) && (pobjp != NULL)) {
swap_parse_object(pobjp, class_num);
}
}
}
// Goober5000
void ship_copy_damage(ship *target_shipp, ship *source_shipp)
{
int i;
object *target_objp = &Objects[target_shipp->objnum];
object *source_objp = &Objects[source_shipp->objnum];
ship_subsys *source_ss;
ship_subsys *target_ss;
if (target_shipp->ship_info_index != source_shipp->ship_info_index)
{
nprintf(("SEXP", "Copying damage of ship %s to ship %s which has a different ship class. Strange results might occur.\n", source_shipp->ship_name, target_shipp->ship_name));
}
// copy hull...
target_shipp->special_hitpoint_index = source_shipp->special_hitpoint_index;
target_shipp->ship_max_hull_strength = source_shipp->ship_max_hull_strength;
target_objp->hull_strength = source_objp->hull_strength;
// ...and shields
target_shipp->ship_max_shield_strength = source_shipp->ship_max_shield_strength;
for (i = 0; i < MAX_SHIELD_SECTIONS; i++)
target_objp->shield_quadrant[i] = source_objp->shield_quadrant[i];
// search through all subsystems on source ship and map them onto target ship
for (source_ss = GET_FIRST(&source_shipp->subsys_list); source_ss != GET_LAST(&source_shipp->subsys_list); source_ss = GET_NEXT(source_ss))
{
// find subsystem to configure
target_ss = ship_get_subsys(target_shipp, source_ss->system_info->subobj_name);
if (target_ss == NULL)
continue;
// copy
target_ss->max_hits = source_ss->max_hits;
target_ss->current_hits = source_ss->current_hits;
target_ss->submodel_info_1.blown_off = source_ss->submodel_info_1.blown_off;
target_ss->submodel_info_2.blown_off = source_ss->submodel_info_2.blown_off;
}
}
int insert_subsys_status(p_object *pobjp);
// Goober5000
void parse_copy_damage(p_object *target_pobjp, ship *source_shipp)
{
object *source_objp = &Objects[source_shipp->objnum];
ship_subsys *source_ss;
subsys_status *target_sssp;
if (target_pobjp->ship_class != source_shipp->ship_info_index)
{
nprintf(("SEXP", "Copying damage of ship %s to ship %s which has a different ship class. Strange results might occur.\n", source_shipp->ship_name, target_pobjp->name));
}
// copy hull...
target_pobjp->special_hitpoint_index = source_shipp->special_hitpoint_index;
target_pobjp->ship_max_hull_strength = source_shipp->ship_max_hull_strength;
target_pobjp->initial_hull = fl2i(get_hull_pct(source_objp) * 100.0f);
// ...and shields
target_pobjp->ship_max_shield_strength = source_shipp->ship_max_shield_strength;
target_pobjp->initial_shields = fl2i(get_shield_pct(source_objp) * 100.0f);
// search through all subsystems on source ship and map them onto target ship
for (source_ss = GET_FIRST(&source_shipp->subsys_list); source_ss != GET_LAST(&source_shipp->subsys_list); source_ss = GET_NEXT(source_ss))
{
// find subsystem to configure
target_sssp = parse_get_subsys_status(target_pobjp, source_ss->system_info->subobj_name);
// gak... none allocated; we need to allocate one!
if (target_sssp == NULL)
{
// jam in the new subsystem at the end of the existing list
int new_idx = insert_subsys_status(target_pobjp);
target_sssp = &Subsys_status[new_idx];
target_pobjp->subsys_count++;
strcpy(target_sssp->name, source_ss->system_info->subobj_name);
}
// copy
target_sssp->percent = 100.0f - (source_ss->current_hits / source_ss->max_hits) * 100.0f;
}
}
// Goober5000
void sexp_ship_copy_damage(int node)
{
int n, source_shipnum, target_shipnum;
p_object *target_pobjp;
// source ship must be present
source_shipnum = ship_name_lookup(CTEXT(node));
if (source_shipnum < 0)
return;
// loop through all subsequent arguments
for (n = CDR(node); n != -1; n = CDR(n))
{
// maybe it's present in-mission
target_shipnum = ship_name_lookup(CTEXT(n));
if (target_shipnum >= 0)
{
ship_copy_damage(&Ships[target_shipnum], &Ships[source_shipnum]);
continue;
}
// maybe it's on the arrival list
target_pobjp = mission_parse_get_arrival_ship(CTEXT(n));
if (target_pobjp != NULL)
{
parse_copy_damage(target_pobjp, &Ships[source_shipnum]);
continue;
}
// must have departed or not even existed... do nothing
}
}
//-Bobboau
void sexp_activate_deactivate_glow_points(int n, bool activate)
{
int sindex;
uint i;
for ( ; n != -1; n = CDR(n))
{
sindex = ship_name_lookup(CTEXT(n), 1);
if (sindex >= 0)
{
for (i = 0; i < Ships[sindex].glow_point_bank_active.size(); i++)
Ships[sindex].glow_point_bank_active[i] = activate;
}
}
}
//-Bobboau
void sexp_activate_deactivate_glow_point_bank(int n, bool activate)
{
int sindex, num;
sindex = ship_name_lookup(CTEXT(n), 1);
if (sindex >= 0)
{
for ( ; n != -1; n = CDR(n))
{
num = eval_num(n);
if (num >= 0 && num < (int)Ships[sindex].glow_point_bank_active.size())
{
Ships[sindex].glow_point_bank_active[num] = activate;
}
}
}
}
//-Bobboau
void sexp_activate_deactivate_glow_maps(int n, int activate)
{
int sindex;
ship *shipp;
for ( ; n != -1; n = CDR(n))
{
sindex = ship_name_lookup(CTEXT(n), 1);
if (sindex >= 0)
{
shipp = &Ships[sindex];
if (activate)
shipp->flags2 &= ~SF2_GLOWMAPS_DISABLED;
else
shipp->flags2 |= SF2_GLOWMAPS_DISABLED;
}
}
}
void sexp_set_ambient_light(int node)
{
int red, green, blue;
int level = 0;
Assert(node > -1);
red = eval_num(node);
if (red < 0 || red > 255) {
red = 0;
}
node = CDR(node);
Assert(node > -1);
green = eval_num(node);
if (green < 0 || green > 255) {
green = 0;
}
node = CDR(node);
Assert(node > -1);
blue = eval_num(node);
if (blue < 0 || blue > 255) {
blue = 0;
}
level |= red;
level |= green << 8;
level |= blue << 16;
// setting the ambient light level for the mission won't actually do anything as it is parsed at mission
// start but it should be updated in case someone changes that later
The_mission.ambient_light_level = level;
// call the graphics function to actually set the level
gr_set_ambient_light(red, green, blue);
// do the multiplayer callback
if (MULTIPLAYER_MASTER) {
multi_start_packet();
multi_send_int(level);
multi_end_packet();
}
}
void multi_sexp_set_ambient_light()
{
int level = 0;
if (multi_get_int(level)) {
The_mission.ambient_light_level = level;
gr_set_ambient_light((level & 0xff),((level >> 8) & 0xff), ((level >> 16) & 0xff));
}
}
// taylor - load and set a skybox model
void sexp_set_skybox_model(int n)
{
for ( ; n != -1; n = CDR(n)) {
if ( !stricmp("default", CTEXT(n)) ) {
stars_set_background_model( The_mission.skybox_model, NULL );
} else {
// stars_level_init() will set the actual mission skybox after this gets
// evaluated during parse. by setting it now we get everything loaded so
// there is less slowdown when it actually swaps out - taylor
stars_set_background_model( CTEXT(n), NULL );
}
}
}
// taylor - preload a skybox model. this doesn't set anything as viewable, just loads it into memory
void sexp_set_skybox_model_preload(char *name)
{
int i;
if ( !stricmp("default", name) ) {
// if there isn't a mission skybox model then don't load one
if ( strlen(The_mission.skybox_model) ) {
i = model_load( The_mission.skybox_model, 0, NULL );
model_page_in_textures( i );
}
} else {
i = model_load( name, 0, NULL );
model_page_in_textures( i );
}
}
void sexp_beam_fire(int node)
{
int sindex, n;
beam_fire_info fire_info;
int idx;
// zero stuff out
memset(&fire_info, 0, sizeof(beam_fire_info));
fire_info.accuracy = 0.000001f; // this will guarantee a hit
// get the firing ship
sindex = ship_name_lookup(CTEXT(node));
if(sindex < 0){
return;
}
if(Ships[sindex].objnum < 0){
return;
}
fire_info.shooter = &Objects[Ships[sindex].objnum];
// get the subsystem
fire_info.turret = ship_get_subsys(&Ships[sindex], CTEXT(CDR(node)));
if(fire_info.turret == NULL){
return;
}
// get the target
sindex = ship_name_lookup(CTEXT(CDR(CDR(node))));
if(sindex < 0){
return;
}
if(Ships[sindex].objnum < 0){
return;
}
fire_info.target = &Objects[Ships[sindex].objnum];
// see if the optional subsystem can be found
fire_info.target_subsys = NULL;
n = CDDDR(node);
if (n != -1) {
fire_info.target_subsys = ship_get_subsys(&Ships[sindex], CTEXT(n));
}
// if it has no primary weapons
if(fire_info.turret->weapons.num_primary_banks <= 0){
Warning(LOCATION, "Couldn't fire turret on ship %s; subsystem %s has no primary weapons", CTEXT(node), CTEXT(CDR(node)));
return;
}
// if the turret is destroyed
if(fire_info.turret->current_hits <= 0.0f){
return;
}
// hmm, this could be wacky. Let's just simply select the first beam weapon in the turret
fire_info.beam_info_index = -1;
for(idx=0; idx<fire_info.turret->weapons.num_primary_banks; idx++){
// store the weapon info index
if(Weapon_info[fire_info.turret->weapons.primary_bank_weapons[idx]].wi_flags & WIF_BEAM){
fire_info.beam_info_index = fire_info.turret->weapons.primary_bank_weapons[idx];
}
}
// fire the beam
if(fire_info.beam_info_index != -1){
fire_info.fighter_beam = false;
beam_fire(&fire_info);
} else {
// it would appear the turret doesn't have any beam weapons
Warning(LOCATION, "Couldn't fire turret on ship %s; subsystem %s has no beam weapons", CTEXT(node), CTEXT(CDR(node)));
}
}
void sexp_beam_free(int node)
{
int sindex;
ship_subsys *turret = NULL;
// get the firing ship
sindex = ship_name_lookup(CTEXT(node));
if(sindex < 0){
return;
}
if(Ships[sindex].objnum < 0){
return;
}
node = CDR(node);
while(node != -1){
// get the subsystem
turret = ship_get_subsys(&Ships[sindex], CTEXT(node));
if(turret == NULL){
node = CDR(node);
continue;
}
// flag it as beam free :)
turret->weapons.flags |= SW_FLAG_BEAM_FREE;
turret->turret_next_fire_stamp = timestamp((int) frand_range(50.0f, 4000.0f));
// next
node = CDR(node);
}
}
void sexp_beam_free_all(int node)
{
ship_subsys *subsys;
int sindex;
int n = node;
while (n >= 0) {
// get the firing ship
sindex = ship_name_lookup( CTEXT(node) );
if (sindex < 0) {
return;
}
if (Ships[sindex].objnum < 0) {
return;
}
// free all beam weapons
subsys = GET_FIRST(&Ships[sindex].subsys_list);
while ( subsys != END_OF_LIST(&Ships[sindex].subsys_list) ) {
// just mark all turrets as beam free
if (subsys->system_info->type == SUBSYSTEM_TURRET) {
subsys->weapons.flags |= SW_FLAG_BEAM_FREE;
subsys->turret_next_fire_stamp = timestamp((int) frand_range(50.0f, 4000.0f));
}
// next item
subsys = GET_NEXT(subsys);
}
n = CDR(n);
}
}
void sexp_beam_lock(int node)
{
int sindex;
ship_subsys *turret = NULL;
// get the firing ship
sindex = ship_name_lookup(CTEXT(node));
if(sindex < 0){
return;
}
if(Ships[sindex].objnum < 0){
return;
}
node = CDR(node);
while(node != -1){
// get the subsystem
turret = ship_get_subsys(&Ships[sindex], CTEXT(node));
if(turret == NULL){
node = CDR(node);
continue;
}
// flag it as not beam free
turret->weapons.flags &= ~(SW_FLAG_BEAM_FREE);
// next
node = CDR(node);
}
}
void sexp_beam_lock_all(int node)
{
ship_subsys *subsys;
int sindex;
int n = node;
while (n >= 0) {
// get the firing ship
sindex = ship_name_lookup( CTEXT(node) );
if (sindex < 0) {
return;
}
if (Ships[sindex].objnum < 0) {
return;
}
// free all beam weapons
subsys = GET_FIRST(&Ships[sindex].subsys_list);
while ( subsys != END_OF_LIST(&Ships[sindex].subsys_list) ) {
// just mark all turrets as not beam free
if (subsys->system_info->type == SUBSYSTEM_TURRET) {
subsys->weapons.flags &= ~(SW_FLAG_BEAM_FREE);
}
// next item
subsys = GET_NEXT(subsys);
}
n = CDR(n);
}
}
void sexp_turret_free(int node)
{
int sindex;
ship_subsys *turret = NULL;
// get the firing ship
sindex = ship_name_lookup(CTEXT(node));
if(sindex < 0){
return;
}
if(Ships[sindex].objnum < 0){
return;
}
node = CDR(node);
while(node != -1){
// get the subsystem
turret = ship_get_subsys(&Ships[sindex], CTEXT(node));
if(turret == NULL){
node = CDR(node);
continue;
}
// flag turret as no longer locked :)
turret->weapons.flags &= (~SW_FLAG_TURRET_LOCK);
turret->turret_next_fire_stamp = timestamp((int) frand_range(50.0f, 4000.0f));
// next
node = CDR(node);
}
}
void sexp_turret_free_all(int node)
{
ship_subsys *subsys;
int sindex;
int n = node;
while (n >= 0) {
// get the firing ship
sindex = ship_name_lookup( CTEXT(node) );
if (sindex < 0) {
return;
}
if (Ships[sindex].objnum < 0) {
return;
}
// free all turrets
subsys = GET_FIRST(&Ships[sindex].subsys_list);
while ( subsys != END_OF_LIST(&Ships[sindex].subsys_list) ) {
// just mark all turrets as free
if (subsys->system_info->type == SUBSYSTEM_TURRET) {
subsys->weapons.flags &= (~SW_FLAG_TURRET_LOCK);
subsys->turret_next_fire_stamp = timestamp((int) frand_range(50.0f, 4000.0f));
}
// next item
subsys = GET_NEXT(subsys);
}
n = CDR(n);
}
}
void sexp_turret_lock(int node)
{
int sindex;
ship_subsys *turret = NULL;
// get the firing ship
sindex = ship_name_lookup(CTEXT(node));
if(sindex < 0){
return;
}
if(Ships[sindex].objnum < 0){
return;
}
node = CDR(node);
while(node != -1){
// get the subsystem
turret = ship_get_subsys(&Ships[sindex], CTEXT(node));
if(turret == NULL){
node = CDR(node);
continue;
}
// flag turret as locked
turret->weapons.flags |= SW_FLAG_TURRET_LOCK;
// next
node = CDR(node);
}
}
void sexp_turret_lock_all(int node)
{
ship_subsys *subsys;
int sindex;
int n = node;
while (n >= 0) {
// get the firing ship
sindex = ship_name_lookup( CTEXT(node) );
if (sindex < 0) {
return;
}
if (Ships[sindex].objnum < 0) {
return;
}
// lock all turrets
subsys = GET_FIRST(&Ships[sindex].subsys_list);
while ( subsys != END_OF_LIST(&Ships[sindex].subsys_list) ) {
// just mark all turrets as locked
if (subsys->system_info->type == SUBSYSTEM_TURRET) {
subsys->weapons.flags |= SW_FLAG_TURRET_LOCK;
}
// next item
subsys = GET_NEXT(subsys);
}
n = CDR(n);
}
}
void sexp_turret_tagged_only_all(int node)
{
ship_subsys *subsys;
int sindex;
// get the firing ship
sindex = ship_name_lookup(CTEXT(node));
if(sindex < 0){
return;
}
if(Ships[sindex].objnum < 0){
return;
}
// mark all turrets to only target tagged ships
subsys = GET_FIRST(&Ships[sindex].subsys_list);
while(subsys != END_OF_LIST(&Ships[sindex].subsys_list)){
// just mark all turrets as locked
if(subsys->system_info->type == SUBSYSTEM_TURRET){
subsys->weapons.flags |= SW_FLAG_TAGGED_ONLY;
}
// next item
subsys = GET_NEXT(subsys);
}
}
void sexp_turret_tagged_clear_all(int node)
{
ship_subsys *subsys;
int sindex;
// get the firing ship
sindex = ship_name_lookup(CTEXT(node));
if(sindex < 0){
return;
}
if(Ships[sindex].objnum < 0){
return;
}
// mark all turrets so not restricted to only tagged ships
subsys = GET_FIRST(&Ships[sindex].subsys_list);
while(subsys != END_OF_LIST(&Ships[sindex].subsys_list)){
// just mark all turrets as locked
if(subsys->system_info->type == SUBSYSTEM_TURRET){
subsys->weapons.flags &= (~SW_FLAG_TAGGED_ONLY);
}
// next item
subsys = GET_NEXT(subsys);
}
}
void sexp_turret_change_weapon(int node)
{
int sindex;
int windex; //hehe
ship_subsys *turret = NULL;
ship_weapon *swp = NULL;
// get the firing ship
sindex = ship_name_lookup(CTEXT(node));
if(sindex < 0 || Ships[sindex].objnum < 0){
return;
}
//Get subsystem
node = CDR(node);
turret = ship_get_subsys(&Ships[sindex], CTEXT(node));
if(turret == NULL){
return;
}
swp = &turret->weapons;
node = CDR(node);
windex = weapon_info_lookup(CTEXT(node));
if(windex < 0) {
return;
}
//Get the slot
float capacity, size;
int prim_slot = 0;
int sec_slot = 0;
node = CDR(node);
prim_slot = eval_num(node);
node = CDR(node);
sec_slot = eval_num(node);
if(prim_slot)
{
if(prim_slot > MAX_SHIP_PRIMARY_BANKS) {
return;
}
if(prim_slot > swp->num_primary_banks) {
swp->num_primary_banks++;
prim_slot = swp->num_primary_banks;
}
//Get an index
prim_slot--;
//Get the max capacity
capacity = (float) swp->primary_bank_capacity[prim_slot];
size = (float) Weapon_info[windex].cargo_size;
//Set various vars
swp->primary_bank_start_ammo[prim_slot] = (int) (capacity / size);
swp->primary_bank_ammo[prim_slot] = swp->primary_bank_start_ammo[prim_slot];
swp->primary_bank_weapons[prim_slot] = windex;
swp->primary_bank_rearm_time[prim_slot] = timestamp(0);
}
else if(sec_slot)
{
if(sec_slot > MAX_SHIP_PRIMARY_BANKS) {
return;
}
if(sec_slot > swp->num_secondary_banks) {
swp->num_secondary_banks++;
sec_slot = swp->num_secondary_banks;
}
//Get an index
sec_slot--;
//Get the max capacity
capacity = (float) swp->secondary_bank_capacity[sec_slot];
size = (float) Weapon_info[windex].cargo_size;
//Set various vars
swp->secondary_bank_start_ammo[sec_slot] = (int) (capacity / size);
swp->secondary_bank_ammo[sec_slot] = swp->secondary_bank_start_ammo[sec_slot];
swp->secondary_bank_weapons[sec_slot] = windex;
swp->secondary_bank_rearm_time[sec_slot] = timestamp(0);
}
}
void sexp_turret_set_target_order(int node)
{
int sindex;
ship_subsys *turret = NULL;
int oindex;
int i;
// get ship
sindex = ship_name_lookup(CTEXT(node));
if(sindex < 0){
return;
}
if(Ships[sindex].objnum < 0){
return;
}
//Get turret subsys
node = CDR(node);
turret = ship_get_subsys(&Ships[sindex], CTEXT(node));
if(turret == NULL){
return;
}
//Reset order
for(i = 0; i < NUM_TURRET_ORDER_TYPES; i++) {
turret->turret_targeting_order[i] = -1;
}
oindex = 0;
node = CDR(node);
while(node != -1)
{
if(oindex >= NUM_TURRET_ORDER_TYPES) {
break;
}
for(i = 0; i < NUM_TURRET_ORDER_TYPES; i++) {
if(!stricmp(Turret_target_order_names[i], CTEXT(node))) {
turret->turret_targeting_order[oindex] = i;
}
}
oindex++;
}
}
void sexp_ship_turret_target_order(int node)
{
int sindex;
ship_subsys *turret = NULL;
int oindex;
int i;
int new_target_order[NUM_TURRET_ORDER_TYPES];
// get ship
sindex = ship_name_lookup(CTEXT(node));
if(sindex < 0){
return;
}
if(Ships[sindex].objnum < 0){
return;
}
oindex = 0;
node = CDR(node);
while(node != -1)
{
if(oindex >= NUM_TURRET_ORDER_TYPES) {
break;
}
for(i = 0; i < NUM_TURRET_ORDER_TYPES; i++) {
if(!stricmp(Turret_target_order_names[i], CTEXT(node))) {
new_target_order[oindex] = i;
}
}
oindex++;
}
turret = GET_FIRST(&Ships[sindex].subsys_list);
while(turret != END_OF_LIST(&Ships[sindex].subsys_list))
{
//Reset order
for(i = 0; i < NUM_TURRET_ORDER_TYPES; i++) {
turret->turret_targeting_order[i] = -1;
}
memcpy(turret->turret_targeting_order, new_target_order, NUM_TURRET_ORDER_TYPES*sizeof(int));
// next item
turret = GET_NEXT(turret);
}
}
void sexp_turret_subsystem_targeting_disable(int node)
{
int sindex;
ship_subsys *turret = NULL;
// get the ship
sindex = ship_name_lookup(CTEXT(node));
if(sindex < 0){
return;
}
if(Ships[sindex].objnum < 0){
return;
}
node = CDR(node);
while(node != -1){
// get the subsystem
turret = ship_get_subsys(&Ships[sindex], CTEXT(node));
if(turret == NULL){
node = CDR(node);
continue;
}
// flag the turret
turret->flags |= SSF_NO_SS_TARGETING;
// next
node = CDR(node);
}
}
void sexp_turret_subsystem_targeting_enable(int node)
{
int sindex;
ship_subsys *turret = NULL;
// get the ship
sindex = ship_name_lookup(CTEXT(node));
if(sindex < 0){
return;
}
if(Ships[sindex].objnum < 0){
return;
}
node = CDR(node);
while(node != -1){
// get the subsystem
turret = ship_get_subsys(&Ships[sindex], CTEXT(node));
if(turret == NULL){
node = CDR(node);
continue;
}
// remove the flag from the turret
turret->flags &= ~(SSF_NO_SS_TARGETING);
// next
node = CDR(node);
}
}
// Goober5000
void sexp_set_subsys_rotation_lock(int node, int locked)
{
int ship_num;
ship_subsys *rotate;
// get the ship
ship_num = ship_name_lookup(CTEXT(node));
if(ship_num < 0)
return;
if(Ships[ship_num].objnum < 0)
return;
node = CDR(node);
// loop for all specified subsystems
while (node != -1)
{
// get the rotating subsystem
rotate = ship_get_subsys(&Ships[ship_num], CTEXT(node));
if(rotate == NULL)
return;
// set rotate or not, depending on flag
if (locked) {
rotate->system_info->flags &= ~MSS_FLAG_ROTATES;
if (rotate->subsys_snd_flags & SSSF_ROTATE)
{
obj_snd_delete_type(Ships[ship_num].objnum, rotate->system_info->rotation_snd, rotate);
rotate->subsys_snd_flags &= ~SSSF_ROTATE;
}
}
else {
rotate->system_info->flags |= MSS_FLAG_ROTATES;
if (rotate->system_info->rotation_snd != -1) {
obj_snd_assign(Ships[ship_num].objnum, rotate->system_info->rotation_snd, &rotate->system_info->pnt, 0, OS_SUBSYS_ROTATION, rotate);
rotate->subsys_snd_flags |= SSSF_ROTATE;
}
}
// iterate
node = CDR(node);
}
}
// Goober5000
void sexp_reverse_rotating_subsystem(int node)
{
int ship_num;
ship_subsys *rotate;
// get the ship
ship_num = ship_name_lookup(CTEXT(node));
if(ship_num < 0)
return;
if(Ships[ship_num].objnum < 0)
return;
node = CDR(node);
// loop for all specified subsystems
while (node != -1)
{
// get the rotating subsystem
rotate = ship_get_subsys(&Ships[ship_num], CTEXT(node));
if(rotate == NULL)
return;
// switch direction of rotation
rotate->system_info->turn_rate *= -1.0f;
rotate->submodel_info_1.cur_turn_rate *= -1.0f;
rotate->submodel_info_1.desired_turn_rate *= -1.0f;
// iterate
node = CDR(node);
}
}
// Goober5000
void sexp_rotating_subsys_set_turn_time(int node)
{
int ship_num;
float turn_time, turn_accel;
ship_subsys *rotate;
// get the ship
ship_num = ship_name_lookup(CTEXT(node));
if(ship_num < 0)
return;
if(Ships[ship_num].objnum < 0)
return;
// get the rotating subsystem
rotate = ship_get_subsys(&Ships[ship_num], CTEXT(CDR(node)));
if(rotate == NULL)
return;
// get and set the turn time
turn_time = ((float) atoi(CTEXT(CDDR(node)))) / 1000.0f;
rotate->submodel_info_1.desired_turn_rate = PI2 / turn_time;
// maybe get and set the turn accel
if (CDDDR(node) != -1)
turn_accel = ((float) atoi(CTEXT(CDDDR(node)))) / 1000.0f;
else
rotate->submodel_info_1.cur_turn_rate = PI2 / turn_time;
}
void sexp_turret_tagged_specific(int node)
{
ship_subsys *subsys;
int sindex;
// get the firing ship
sindex = ship_name_lookup(CTEXT(node));
if(sindex < 0){
return;
}
if(Ships[sindex].objnum < 0){
return;
}
node = CDR(node);
while(node != -1){
// get the subsystem
subsys = ship_get_subsys(&Ships[sindex], CTEXT(node));
if(subsys == NULL){
node = CDR(node);
continue;
}
// flag turret as slaved to tag
subsys->weapons.flags |= SW_FLAG_TAGGED_ONLY;
// next
node = CDR(node);
}
}
void sexp_turret_tagged_clear_specific(int node)
{
ship_subsys *subsys;
int sindex;
// get the firing ship
sindex = ship_name_lookup(CTEXT(node));
if(sindex < 0){
return;
}
if(Ships[sindex].objnum < 0){
return;
}
node = CDR(node);
while(node != -1){
// get the subsystem
subsys = ship_get_subsys(&Ships[sindex], CTEXT(node));
if(subsys == NULL){
node = CDR(node);
continue;
}
// flag turret as slaved to tag
subsys->weapons.flags &= (~SW_FLAG_TAGGED_ONLY);
// next
node = CDR(node);
}
}
void sexp_add_remove_escort(int node)
{
int sindex;
int flag;
char *whee;
// get the firing ship
sindex = ship_name_lookup(CTEXT(node));
if(sindex < 0){
return;
}
if(Ships[sindex].objnum < 0){
return;
}
// determine whether to add or remove it
whee = CTEXT(CDR(node));
flag = eval_num(CDR(node));
// add/remove
if(flag){
Ships[sindex].escort_priority = flag ;
hud_add_ship_to_escort(Ships[sindex].objnum, 1);
} else {
hud_remove_ship_from_escort(Ships[sindex].objnum);
}
}
//given: two escort priorities and a list of ships
//do: sets the most damaged one to the first priority and the rest to the second.
void sexp_damage_escort_list(int node)
{
int n;
int priority1; //escort priority to set the most damaged ship
int priority2; //"" "" to set the other ships
ship* shipp;
float smallest_hull_pct=1; //smallest hull pct found
int small_shipnum=-1; //index in Ships[] of the above
float current_hull_pct; //hull pct of current ship we are evaluating
int shipnum=-1; //index in Ships[] of the above
priority1=eval_num(node);
priority2=eval_num(CDR(node));
//go to start of ship list
n=CDR(CDR(node));
//loop through the ships
for ( ; n != -1; n = CDR(n) )
{
// check to see if ship destroyed or departed. In either case, do nothing.
if ( mission_log_get_time(LOG_SHIP_DEPARTED, CTEXT(n), NULL, NULL) || mission_log_get_time(LOG_SHIP_DESTROYED, CTEXT(n), NULL, NULL) )
continue;
shipnum=ship_name_lookup(CTEXT(n));
//it may be dead
if (shipnum < 0)
continue;
if (Ships[shipnum].objnum < 0)
continue;
shipp=&Ships[shipnum];
//calc hull integrity and compare
current_hull_pct = get_hull_pct(&Objects[Ships[shipnum].objnum]);
if (current_hull_pct < smallest_hull_pct)
{
Ships[small_shipnum].escort_priority=priority2; //give the previous smallest the lower priority
smallest_hull_pct=current_hull_pct;
small_shipnum=shipnum;
shipp->escort_priority=priority1; //give the new smallest the higher priority
hud_add_ship_to_escort(Ships[shipnum].objnum,1);
}
else //if its bigger to begin with give it lower priority
{
shipp->escort_priority=priority2;
hud_add_ship_to_escort(Ships[shipnum].objnum,1);
}
}
}
// Goober5000 - set stuff for mission support ship
void sexp_set_support_ship(int n)
{
int i, temp_val;
// get arrival location
temp_val = -1;
for (i=0; i<MAX_ARRIVAL_NAMES; i++)
{
if (!stricmp(CTEXT(n), Arrival_location_names[i]))
temp_val = i;
}
if (temp_val < 0)
{
Warning(LOCATION, "Support ship arrival location '%s' not found.\n", CTEXT(n));
return;
}
The_mission.support_ships.arrival_location = temp_val;
// get arrival anchor
n = CDR(n);
if (!stricmp(CTEXT(n), "<no anchor>"))
{
// if no anchor, set arrival location to hyperspace
The_mission.support_ships.arrival_location = 0;
}
else
{
// anchor must exist - look for it
temp_val = -1;
for (i=0; i<Num_parse_names; i++)
{
if (!stricmp(CTEXT(n), Parse_names[i]))
temp_val = i;
}
// if not found, make a new entry
if (temp_val < 0)
{
strcpy(Parse_names[Num_parse_names], CTEXT(n));
temp_val = Num_parse_names;
Num_parse_names++;
}
The_mission.support_ships.arrival_anchor = temp_val;
}
// get departure location
n = CDR(n);
temp_val = -1;
for (i=0; i<MAX_DEPARTURE_NAMES; i++)
{
if (!stricmp(CTEXT(n), Departure_location_names[i]))
temp_val = i;
}
if (temp_val < 0)
{
Warning(LOCATION, "Support ship departure location '%s' not found.\n", CTEXT(n));
return;
}
The_mission.support_ships.departure_location = temp_val;
// get departure anchor
n = CDR(n);
if (!stricmp(CTEXT(n), "<no anchor>"))
{
// if no anchor, set departure location to hyperspace
The_mission.support_ships.departure_location = 0;
}
else
{
// anchor must exist - look for it
temp_val = -1;
for (i=0; i<Num_parse_names; i++)
{
if (!stricmp(CTEXT(n), Parse_names[i]))
temp_val = i;
}
// if not found, make a new entry
if (temp_val < 0)
{
strcpy(Parse_names[Num_parse_names], CTEXT(n));
temp_val = Num_parse_names;
Num_parse_names++;
}
The_mission.support_ships.departure_anchor = temp_val;
}
// get ship class
n = CDR(n);
temp_val = ship_info_lookup(CTEXT(n));
if ((temp_val < 0) && (stricmp(CTEXT(n), "<any support ship class>")))
{
Warning(LOCATION, "Support ship class '%s' not found.\n", CTEXT(n));
return;
}
if (!(Ship_info[temp_val].flags & SIF_SUPPORT))
{
Warning(LOCATION, "Ship %s is not a support ship!", Ship_info[temp_val].name);
return;
}
The_mission.support_ships.ship_class = temp_val;
// get max number of ships allowed
n = CDR(n);
The_mission.support_ships.max_support_ships = eval_num(n);
}
// Goober5000
// set *all* the escort priorities of ships in escort list as follows: most damaged ship gets
// first priority in the argument list, next damaged gets next priority, etc.; if there are more
// ships than priorities, all remaining ships get the final priority on the list
// -- As indicated in the argument specification, there must be at least one argument but no more
// than MAX_COMPLETE_ESCORT_LIST arguments
void sexp_damage_escort_list_all(int n)
{
typedef struct my_escort_ship
{
int index;
float hull;
} my_escort_ship;
int priority[MAX_COMPLETE_ESCORT_LIST];
my_escort_ship escort_ship[MAX_COMPLETE_ESCORT_LIST];
int i, j, num_escort_ships, num_priorities, temp_i;
float temp_f;
ship *shipp;
// build list of priorities
num_priorities = 0;
for ( ; n != -1; n = CDR(n) )
{
priority[num_priorities] = eval_num(n);
num_priorities++;
}
// build custom list of escort ships
num_escort_ships = 0;
for (i = 0; i < MAX_SHIPS; i++)
{
shipp = &Ships[i];
// make sure it exists
if ( shipp->objnum < 0 )
continue;
// make sure it's on the escort list
if ( !(shipp->flags & SF_ESCORT) )
continue;
// set index
escort_ship[num_escort_ships].index = i;
// calc and set hull integrity
escort_ship[num_escort_ships].hull = get_hull_pct(&Objects[shipp->objnum]);
num_escort_ships++;
}
// sort it bubbly, lowest hull to highest hull
for (i = 0; i < num_escort_ships; i++)
{
for (j = 0; j < i; j++)
{
if (escort_ship[i].hull < escort_ship[j].hull)
{
// swap
temp_i = escort_ship[i].index;
temp_f = escort_ship[i].hull;
escort_ship[i].index = escort_ship[j].index;
escort_ship[i].hull = escort_ship[j].hull;
escort_ship[j].index = temp_i;
escort_ship[j].hull = temp_f;
}
}
}
// loop through and assign priorities
for (i = 0; i < num_escort_ships; i++)
{
if (i >= num_priorities)
Ships[escort_ship[i].index].escort_priority = priority[num_priorities - 1];
else
Ships[escort_ship[i].index].escort_priority = priority[i];
}
// redo the escort list
hud_setup_escort_list();
}
void sexp_awacs_set_radius(int node)
{
int sindex;
ship_subsys *awacs;
// get the firing ship
sindex = ship_name_lookup(CTEXT(node));
if(sindex < 0){
return;
}
if(Ships[sindex].objnum < 0){
return;
}
// get the awacs subsystem
awacs = ship_get_subsys(&Ships[sindex], CTEXT(CDR(node)));
if(awacs == NULL){
return;
}
// make sure this _is_ an awacs subsystem
// changed by Goober5000 - it looks like the Volition code was broken
/*Assert(awacs->system_info->flags & MSS_FLAG_AWACS);
if(awacs->system_info->flags & MSS_FLAG_AWACS){
return;
}*/
if (!(awacs->system_info->flags & MSS_FLAG_AWACS))
return;
// set the new awacs radius
awacs->awacs_radius = (float)eval_num(CDR(CDR(node)));
}
// Goober5000
void sexp_primitive_sensors_set_range(int n)
{
char *ship_name = CTEXT(n);
int ship_num, range = eval_num(CDR(n));
// check to see if ship destroyed or departed. In either case, do nothing.
if ( mission_log_get_time(LOG_SHIP_DEPARTED, ship_name, NULL, NULL) || mission_log_get_time(LOG_SHIP_DESTROYED, ship_name, NULL, NULL) )
return;
// get the ship
ship_num = ship_name_lookup(ship_name);
// ship not yet in mission? do nothing
if (ship_num < 0)
return;
// set the new range
Ships[ship_num].primitive_sensor_range = range;
}
//*************************************************************************************************
// Kazan
// AutoNav/AutoPilot system SEXPS
//text: set-nav-carry
//args: 1+, Ship/Wing name
void set_nav_carry_status(int node)
{
int n=node, i;
char *name;
bool skip;
while (n != -1)
{
name = CTEXT(n);
skip = false;
for (i = 0; i < MAX_WINGS; i++)
{
if (!stricmp(Wings[i].name, name))
{
Wings[i].flags |= WF_NAV_CARRY;
skip = true;
break;
}
}
if (!skip)
{
for (i = 0; i < MAX_SHIPS; i++)
{
if (Ships[i].objnum != -1 && !stricmp(Ships[i].ship_name, name))
{
Ships[i].flags2 |= SF2_NAVPOINT_CARRY;
break;
}
}
}
// move to next ship/wing in list
n = CDR(n);
}
}
//text: unset-nav-carry
//args: 1+, Ship/Wing name
void unset_nav_carry_status(int node)
{
int n=node, i;
char *name;
bool skip;
while (n != -1)
{
name = CTEXT(n);
skip = false;
for (i = 0; i < MAX_WINGS; i++)
{
if (!stricmp(Wings[i].name, name))
{
Wings[i].flags &= ~WF_NAV_CARRY;
skip = true;
break;
}
}
if (!skip)
{
for (i = 0; i < MAX_SHIPS; i++)
{
if (Ships[i].objnum != -1 && !stricmp(Ships[i].ship_name, name))
{
Ships[i].flags2 &= ~SF2_NAVPOINT_CARRY;
break;
}
}
}
// move to next ship/wing in list
n = CDR(n);
}
}
//text: set-nav-needslink
//args: 1+, Ship/Wing name
void set_nav_needslink(int node)
{
int n=node, i;
char *name;
bool skip;
while (n != -1)
{
name = CTEXT(n);
skip = false;
for (i = 0; i < MAX_SHIPS; i++)
{
if (Ships[i].objnum != -1 && !stricmp(Ships[i].ship_name, name))
{
Ships[i].flags2 &= ~SF2_NAVPOINT_CARRY;
Ships[i].flags2 |= SF2_NAVPOINT_NEEDSLINK;
break;
}
}
// move to next ship/wing in list
n = CDR(n);
}
}
//text: unset-nav-needslink
//args: 1+, Ship/Wing name
void unset_nav_needslink(int node)
{
int n=node, i;
char *name;
while (n != -1)
{
name = CTEXT(n);
for (i = 0; i < MAX_SHIPS; i++)
{
if (Ships[i].objnum != -1 && !stricmp(Ships[i].ship_name, name))
{
Ships[i].flags2 &= ~SF2_NAVPOINT_NEEDSLINK;
break;
}
}
// move to next ship/wing in list
n = CDR(n);
}
}
//text: add-nav-waypoint
//args: 3, Nav Name, Waypoint Path Name, Waypoint Path point
void add_nav_waypoint(int node)
{
char *nav_name = CTEXT(node);
char *way_name = CTEXT(CDR(node));
int vert = eval_num(CDR(CDR(node)));
AddNav_Waypoint(nav_name, way_name, vert, 0);
}
//text: add-nav-ship
//args: 2, Nav Name, Ship Name
void add_nav_ship(int node)
{
char *nav_name = CTEXT(node);
char *ship_name = CTEXT(CDR(node));
AddNav_Ship(nav_name, ship_name, 0);
}
//text: del-nav
//args: 1, Nav Name
void del_nav(int node)
{
char *nav_name = CTEXT(node);
DelNavPoint(nav_name);
}
//text: use-nav-cinematics
//args: 1, boolean enable/disable
void set_use_ap_cinematics(int node)
{
//bool enable = atoi(CTEXT(node));
int enable = eval_sexp(node);
if (enable)
{
The_mission.flags |= MISSION_FLAG_USE_AP_CINEMATICS;
}
else
{
The_mission.flags &= ~MISSION_FLAG_USE_AP_CINEMATICS;
}
}
//text: use-autopilot
//args: 1, boolean enable/disable
void set_use_ap(int node)
{
//bool enable = atoi(CTEXT(node));
int enable = eval_sexp(node);
if (enable)
{
The_mission.flags &= ~MISSION_FLAG_DEACTIVATE_AP;
}
else
{
The_mission.flags |= MISSION_FLAG_DEACTIVATE_AP;
}
}
//text: hide-nav
//args: 1, Nav Name
void hide_nav(int node)
{
char *nav_name = CTEXT(node);
Nav_Set_Hidden(nav_name);
}
//text: restrict-nav
//args: 1, nav name
void restrict_nav(int node)
{
char *nav_name = CTEXT(node);
Nav_Set_NoAccess(nav_name);
}
//text: unhide-nav
//args: 1, Nav name
void unhide_nav(int node)
{
char *nav_name = CTEXT(node);
Nav_UnSet_Hidden(nav_name);
}
//text: unrestrict-nav
//args: 1, nav name
void unrestrict_nav(int node)
{
char *nav_name = CTEXT(node);
Nav_UnSet_NoAccess(nav_name);
}
//text: set-nav-visited
//args: 1, Nav Name
void set_nav_visited(int node)
{
char *nav_name = CTEXT(node);
Nav_Set_Visited(nav_name);
}
//text: unset-nav-visited
//args: 1, Nav Name
void unset_nav_visited(int node)
{
char *nav_name = CTEXT(node);
Nav_UnSet_Visited(nav_name);
}
//text: is-nav-visited
//args: 1, Nav Name
//rets: true/false
int is_nav_visited(int node)
{
char *nav_name = CTEXT(node);
return IsVisited(nav_name);
}
//text: is-nav_linked
//args: 1, Ship name
//rets: true/false
int is_nav_linked(int node)
{
char *ship_name = CTEXT(node);
for (int i = 0; i < MAX_SHIPS; i++)
{
if (Ships[i].objnum != -1 && !stricmp(Ships[i].ship_name, ship_name))
{
return (Ships[i].flags2 & SF2_NAVPOINT_CARRY) != 0;
}
}
return false;
}
//text: distance-to-nav
//args: 1, Nav Name
//rets: distance to nav
int distance_to_nav(int node)
{
char *nav_name = CTEXT(node);
return DistanceTo(nav_name);
}
//*************************************************************************************************
int sexp_is_tagged(int node)
{
int sindex;
// get the firing ship
sindex = ship_name_lookup(CTEXT(node));
if(sindex < 0){
return SEXP_FALSE;
}
if(Ships[sindex].objnum < 0){
return SEXP_FALSE;
}
object *caller = &Objects[Ships[sindex].objnum];
if(ship_is_tagged(caller)) { // This line and the one above were added.
// if(Ships[sindex].tag_left> 0.0f) The broken code. Changed by EdrickV@HLP
return SEXP_TRUE;
}
// not tagged
return SEXP_FALSE;
}
// Joint effort of Sesquipedalian and Goober5000. Sesq found the code, mucked around making
// sexps with it and learned things, Goober taught Sesq and made the sexp work properly. =D
// Returns true so long as the player has held a missile lock for the specified time.
// If the optional ship and/or ship's subsystem are specified, returns true when that
// has been locked onto, but otherwise returns as long as anything has been locked onto.
int sexp_missile_locked(int node)
{
int z;
// if we aren't targeting anything, it's false
if ((Players_target == -1) || (Players_target == UNINITIALIZED))
return SEXP_FALSE;
// if we aren't locked on to anything, it's false
if (!Players_mlocked)
return SEXP_FALSE;
// do we have a specific ship?
if (CDR(node) != -1)
{
// if we're not targeting the specific ship, it's false
if (stricmp(Ships[Objects[Players_target].instance].ship_name, CTEXT(CDR(node))))
return SEXP_FALSE;
// do we have a specific subsystem?
if (CDR(CDR(node)) != -1)
{
// if we aren't targeting a subsystem at all, it's false
if (!Player_ai->targeted_subsys)
return SEXP_FALSE;
// if we're not targeting the specific subsystem, it's false
if (subsystem_stricmp(Player_ai->targeted_subsys->system_info->subobj_name, CTEXT(CDR(CDR(node)))))
return SEXP_FALSE;
}
}
// if we've gotten this far, we must have satisfied whatever conditions the sexp imposed
// finally, test if we've locked for a certain period of time
z = eval_num(node) * 1000;
if (timestamp_has_time_elapsed(Players_mlocked_timestamp, z))
{
return SEXP_TRUE;
}
return SEXP_FALSE;
}
int sexp_is_player (int node)
{
int sindex, standard_check = 1, np_index;
p_object *p_objp;
standard_check = is_sexp_true(node);
if (!(Game_mode & GM_MULTIPLAYER)){
sindex = ship_name_lookup(CTEXT(CDR(node)));
// There can only be one player ship in singleplayer so if more than one ship is specifed the sexp is false
if (CDDR(node) < 0 ) {
return SEXP_FALSE;
}
if(sindex >= 0){
if(Player_obj == &Objects[Ships[sindex].objnum]){
if (standard_check) {
if (Player_use_ai) {
return SEXP_FALSE;
}
}
return SEXP_TRUE;
}
}
return SEXP_FALSE;
}
// For multiplayer we need to decide what to do about respawning players
else {
node = CDR(node);
while (node >= 0) {
// reset the netplayer index
np_index = -1;
sindex = ship_name_lookup(CTEXT(node));
if(sindex >= 0){
if(Ships[sindex].objnum >= 0) {
// try and find the player
np_index = multi_find_player_by_object(&Objects[Ships[sindex].objnum]);
}
}
if (standard_check && np_index < 0) {
// Respawning ships don't have an objnum so we need to take a different approach
p_objp = mission_parse_get_arrival_ship(CTEXT(node));
if (p_objp != NULL) {
np_index = multi_find_player_by_parse_object(p_objp);
}
}
// if we couldn't find a valid netplayer index then the ship isn't a player
if((np_index < 0) || (np_index >= MAX_PLAYERS)){
return SEXP_FALSE;
}
node = CDR(node);
}
// if we reached this far they all checked out
return SEXP_TRUE;
}
}
void sexp_set_respawns(int node)
{
int num_respawns;
p_object *p_objp;
// we're wasting our time if you can't respawn
if (!(Game_mode & GM_MULTIPLAYER)) {
return;
}
num_respawns = eval_num(node);
node = CDR(node);
// send the information to clients
multi_start_packet();
multi_send_int(num_respawns);
while (node != -1) {
// get the parse object for the ship
p_objp = mission_parse_get_arrival_ship(CTEXT(node));
if (p_objp != NULL) {
p_objp->respawn_count = num_respawns;
}
multi_send_string(CTEXT(node));
node = CDR(node);
}
multi_end_packet();
}
void multi_sexp_set_respawns()
{
p_object *p_objp;
int num_respawns;
char parse_name[NAME_LENGTH];
multi_get_int(num_respawns);
while (multi_get_string(parse_name)) {
// get the parse object for the ship
p_objp = mission_parse_get_arrival_ship(parse_name);
if (p_objp != NULL) {
p_objp->respawn_count = num_respawns;
}
}
}
int sexp_return_player_data(int node, int type)
{
int sindex, np_index = -1;
player *p = NULL;
p_object *p_objp;
sindex = ship_name_lookup(CTEXT(node));
if(Game_mode & GM_MULTIPLAYER){
if(sindex >= 0){
if(Ships[sindex].objnum >= 0) {
// try and find the player
np_index = multi_find_player_by_object(&Objects[Ships[sindex].objnum]);
}
}
if (np_index < 0) {
// Respawning ships don't have an objnum so we need to take a different approach
p_objp = mission_parse_get_arrival_ship(CTEXT(node));
np_index = multi_find_player_by_parse_object(p_objp);
}
if((np_index >= 0) && (np_index < MAX_PLAYERS)){
p = Net_players[np_index].m_player;
}
}
// if we're in single player, we're only concerned with ourself
else {
if(sindex < 0){
return 0;
}
if(Ships[sindex].objnum < 0){
return 0;
}
if(Player_obj == &Objects[Ships[sindex].objnum]){
p = Player;
}
}
// now, if we have a valid player, return his kills
if(p != NULL) {
switch (type) {
case OP_NUM_KILLS:
return p->stats.m_kill_count_ok;
case OP_NUM_ASSISTS:
return p->stats.m_assists;
case OP_SHIP_SCORE:
return p->stats.m_score;
case OP_SHIP_DEATHS:
return p->stats.m_player_deaths;
case OP_RESPAWNS_LEFT:
// Dogfight missions have no respawn limit
if ((Game_mode & GM_MULTIPLAYER) && !(Netgame.type_flags & NG_TYPE_DOGFIGHT)) {
if ( Net_players[np_index].flags & NETINFO_FLAG_RESPAWNING) {
// since the player hasn't actually respawned yet he hasn't used up a number or spawns equal to his deaths
// so add an extra life back.
return Netgame.respawn - p->stats.m_player_deaths + 1;
}
else {
return Netgame.respawn - p->stats.m_player_deaths;
}
}
break;
default:
Int3();
}
}
// AI ships also have a respawn count so we can return valid data for that at least
else if ( (Game_mode & GM_MULTIPLAYER) && (type == OP_SHIP_DEATHS || type == OP_RESPAWNS_LEFT ) ) {
p_objp = mission_parse_get_arrival_ship(CTEXT(node));
if (p_objp == NULL) {
return 0;
}
if (p_objp->flags & P_OF_PLAYER_START) {
switch (type) {
case OP_SHIP_DEATHS:
// when an AI ship is finally killed its respawn count won't be updated so get the number of deaths
// from the log instead
return mission_log_get_count(LOG_SHIP_DESTROYED, CTEXT(node), NULL) + mission_log_get_count(LOG_SELF_DESTRUCTED, CTEXT(node), NULL);
case OP_RESPAWNS_LEFT:
return Netgame.respawn - p_objp->respawn_count;
default:
Int3();
}
}
}
// AI ships
return 0;
}
int sexp_num_type_kills(int node)
{
int sindex, st_index;
int idx, total;
player *p = NULL;
// get the ship we're interested in
sindex = ship_name_lookup(CTEXT(node));
if(sindex < 0){
return 0;
}
if(Ships[sindex].objnum < 0){
return 0;
}
int np_index;
// in multiplayer, search through all players
if(Game_mode & GM_MULTIPLAYER){
// try and find the player
np_index = multi_find_player_by_object(&Objects[Ships[sindex].objnum]);
if((np_index >= 0) && (np_index < MAX_PLAYERS)){
p = Net_players[np_index].m_player;
}
}
// if we're in single player, we're only concerned with ourself
else {
// me
if(Player_obj == &Objects[Ships[sindex].objnum]){
p = Player;
}
}
// bad
if(p == NULL){
return 0;
}
// lookup ship type name
st_index = ship_type_name_lookup(CTEXT(CDR(node)));
if(st_index < 0){
return 0;
}
// look stuff up
total = 0;
for(idx=0; idx<Num_ship_classes; idx++){
if((p->stats.m_okKills[idx] > 0) && ship_class_query_general_type(idx)==st_index){
total += p->stats.m_okKills[idx];
}
}
// total
return total;
}
int sexp_num_class_kills(int node)
{
int sindex, si_index;
player *p = NULL;
// get the ship we're interested in
sindex = ship_name_lookup(CTEXT(node));
if(sindex < 0){
return 0;
}
if(Ships[sindex].objnum < 0){
return 0;
}
int np_index;
// in multiplayer, search through all players
if(Game_mode & GM_MULTIPLAYER){
// try and find the player
np_index = multi_find_player_by_object(&Objects[Ships[sindex].objnum]);
if((np_index >= 0) && (np_index < MAX_PLAYERS)){
p = Net_players[np_index].m_player;
}
}
// if we're in single player, we're only concerned with ourself
else {
// me
if(Player_obj == &Objects[Ships[sindex].objnum]){
p = Player;
}
}
// bad
if(p == NULL){
return 0;
}
// get the ship type we're looking for
si_index = ship_info_lookup(CTEXT(CDR(node)));
if((si_index < 0) || (si_index > Num_ship_classes)){
return 0;
}
// return the count
return p->stats.m_okKills[si_index];
}
void sexp_subsys_set_random(int node)
{
int sindex, low, high, n, idx, rand, exclusion_list[MAX_MODEL_SUBSYSTEMS];
ship_subsys *subsys;
ship *shipp;
// get ship
sindex = ship_name_lookup(CTEXT(node));
if(sindex < 0){
return;
}
if(Ships[sindex].objnum < 0){
return;
}
shipp = &Ships[sindex];
// get low
low = eval_num(CDR(node));
if (low < 0) {
low = 0;
}
// get high
high = eval_num(CDR(CDR(node)));
if (high > 100) {
high = 100;
}
if (low > high) {
Int3();
return;
}
n = CDR(CDR(CDR(node)));
// init exclusion list
memset(exclusion_list, 0, sizeof(int) * Ship_info[shipp->ship_info_index].n_subsystems);
// get exclusion list
while( n != -1) {
int exclude_index = ship_get_subsys_index(shipp, CTEXT(n), 0);
if (exclude_index >= 0) {
exclusion_list[exclude_index] = 1;
}
n = CDR(n);
}
// apply to all others
for (idx=0; idx<Ship_info[shipp->ship_info_index].n_subsystems; idx++) {
if ( exclusion_list[idx] == 0 ) {
// get non excluded subsystem
subsys = ship_get_indexed_subsys(shipp, idx, NULL);
// randomize its hit points
rand = rand_internal(low, high);
subsys->current_hits = 0.01f * rand * subsys->max_hits;
}
}
}
void sexp_supernova_start(int node)
{
supernova_start(eval_num(node));
}
int sexp_is_secondary_selected(int node)
{
int sindex;
int bank;
ship *shipp;
// lookup ship
sindex = ship_name_lookup(CTEXT(node));
if(sindex < 0){
return SEXP_FALSE;
}
if(Ships[sindex].objnum < 0){
return SEXP_FALSE;
}
shipp = &Ships[sindex];
// bogus value?
bank = eval_num(CDR(node));
if(bank >= shipp->weapons.num_secondary_banks){
return SEXP_FALSE;
}
// is this the bank currently selected
if(bank == shipp->weapons.current_secondary_bank){
return SEXP_TRUE;
}
// nope
return SEXP_FALSE;
}
int sexp_is_primary_selected(int node)
{
int sindex;
int bank;
ship *shipp;
// lookup ship
sindex = ship_name_lookup(CTEXT(node));
if(sindex < 0){
return SEXP_FALSE;
}
if(Ships[sindex].objnum < 0){
return SEXP_FALSE;
}
shipp = &Ships[sindex];
// bogus value?
bank = eval_num(CDR(node));
if(bank >= shipp->weapons.num_primary_banks){
return SEXP_FALSE;
}
// is this the bank currently selected
if(bank == shipp->weapons.current_primary_bank){
return SEXP_TRUE;
}
// nope
return SEXP_FALSE;
}
#define RIGHT_QUAD 0
#define FRONT_QUAD 1
#define LEFT_QUAD 3
#define REAR_QUAD 2
// Return SEXP_TRUE if quadrant quadnum is near max.
int shield_quad_near_max(int quadnum)
{
float remaining = 0.0f;
for (int i=0; i<MAX_SHIELD_SECTIONS; i++) {
if (i == quadnum){
continue;
}
remaining += Player_obj->shield_quadrant[i];
}
if ((remaining < 2.0f) || (Player_obj->shield_quadrant[quadnum] > get_max_shield_quad(Player_obj) - 5.0f)) {
return SEXP_TRUE;
} else {
return SEXP_FALSE;
}
}
// Return truth value for special SEXP.
// Used in training#5, perhaps in other missions.
int process_special_sexps(int index)
{
switch (index) {
case 0: // Ship "Freighter 1" is aspect locked by player.
if (Player_ai->target_objnum != -1) {
if (!(stricmp(Ships[Objects[Player_ai->target_objnum].instance].ship_name, "Freighter 1"))) {
if (Player_ai->current_target_is_locked)
return SEXP_TRUE;
}
}
return SEXP_FALSE;
break;
case 1: // Fired Interceptors
object *objp;
for ( objp = GET_FIRST(&obj_used_list); objp !=END_OF_LIST(&obj_used_list); objp = GET_NEXT(objp) ) {
if (objp->type == OBJ_WEAPON) {
if (!stricmp(Weapon_info[Weapons[objp->instance].weapon_info_index].name, "Interceptor#weak")) {
int target = Weapons[objp->instance].target_num;
if (target != -1) {
if (Objects[target].type == OBJ_SHIP) {
if (!(stricmp(Ships[Objects[target].instance].ship_name, "Freighter 1")))
return SEXP_TRUE;
}
}
}
}
}
return SEXP_FALSE;
case 2: // Ship "Freighter 1", subsystem "Weapons" is aspect locked by player.
if (Player_ai->target_objnum != -1) {
if (!(stricmp(Ships[Objects[Player_ai->target_objnum].instance].ship_name, "Freighter 1"))) {
if (!(subsystem_stricmp(Player_ai->targeted_subsys->system_info->name, "Weapons"))) {
if (Player_ai->current_target_is_locked){
return SEXP_TRUE;
}
}
}
}
return SEXP_FALSE;
break;
case 3: // Player ship suffering shield damage on front.
apply_damage_to_shield(Player_obj, FRONT_QUAD, 10.0f);
hud_shield_quadrant_hit(Player_obj, FRONT_QUAD);
return SEXP_TRUE;
break;
case 4: // Player ship suffering much damage.
nprintf(("AI", "Frame %i\n", Framecount));
apply_damage_to_shield(Player_obj, FRONT_QUAD, 10.0f);
hud_shield_quadrant_hit(Player_obj, FRONT_QUAD);
if (Player_obj->shield_quadrant[FRONT_QUAD] < 2.0f)
return SEXP_TRUE;
else
return SEXP_FALSE;
break;
case 5: // Player's shield is quick repaired
nprintf(("AI", "Frame %i, recharged to %7.3f\n", Framecount, Player_obj->shield_quadrant[FRONT_QUAD]));
apply_damage_to_shield(Player_obj, FRONT_QUAD, -flFrametime*200.0f);
if (Player_obj->shield_quadrant[FRONT_QUAD] > get_max_shield_quad(Player_obj))
Player_obj->shield_quadrant[FRONT_QUAD] = get_max_shield_quad(Player_obj);
//hud_shield_quadrant_hit(Player_obj, FRONT_QUAD);
if (Player_obj->shield_quadrant[FRONT_QUAD] > Player_obj->shield_quadrant[(FRONT_QUAD+1)%MAX_SHIELD_SECTIONS] - 2.0f)
return SEXP_TRUE;
else
return SEXP_FALSE;
break;
case 6: // 3 of player's shield quadrants are reduced to 0.
Player_obj->shield_quadrant[1] = 1.0f;
Player_obj->shield_quadrant[2] = 1.0f;
Player_obj->shield_quadrant[3] = 1.0f;
//apply_damage_to_shield(Player_obj, FRONT_QUAD, 1.0f);
hud_shield_quadrant_hit(Player_obj, FRONT_QUAD);
return SEXP_TRUE;
case 7: // Make sure front quadrant has been maximized, or close to it.
if (shield_quad_near_max(FRONT_QUAD)) return SEXP_TRUE; else return SEXP_FALSE;
break;
case 8: // Make sure rear quadrant has been maximized, or close to it.
if (shield_quad_near_max(REAR_QUAD)) return SEXP_TRUE; else return SEXP_FALSE;
break;
case 9: // Zero left and right quadrants in preparation for maximizing rear quadrant.
Player_obj->shield_quadrant[LEFT_QUAD] = 0.0f;
Player_obj->shield_quadrant[RIGHT_QUAD] = 0.0f;
hud_shield_quadrant_hit(Player_obj, LEFT_QUAD);
return SEXP_TRUE;
break;
case 10: // Return true if player is low on Interceptors.
if (Player_ship->weapons.secondary_bank_ammo[0] + Player_ship->weapons.secondary_bank_ammo[1] < 8)
return SEXP_TRUE;
else
return SEXP_FALSE;
break;
case 11: // Return true if player has plenty of Interceptors.
if (Player_ship->weapons.secondary_bank_ammo[0] + Player_ship->weapons.secondary_bank_ammo[1] >= 8)
return SEXP_TRUE;
else
return SEXP_FALSE;
break;
case 12: // Return true if player is low on Interceptors.
if (Player_ship->weapons.secondary_bank_ammo[0] + Player_ship->weapons.secondary_bank_ammo[1] < 4)
return SEXP_TRUE;
else
return SEXP_FALSE;
break;
case 13: // Zero front shield quadrant. Added for Jim Boone on August 26, 1999 by MK.
Player_obj->shield_quadrant[FRONT_QUAD] = 0.0f;
hud_shield_quadrant_hit(Player_obj, FRONT_QUAD);
return SEXP_TRUE;
break;
case 100: // Return true if player is out of countermeasures.
if (Player_ship->cmeasure_count <= 0)
return SEXP_TRUE;
else
return SEXP_FALSE;
default:
Int3(); // Unsupported node type.
}
return SEXP_FALSE;
}
// Karajorma
int sexp_string_to_int (int n)
{
Assert (n != -1);
return atoi(CTEXT(n));
}
// custom sexp operator for handling misc training stuff
int sexp_special_training_check(int node)
{
int num, rtn;
num = eval_num(node);
if (num == SPECIAL_CHECK_TRAINING_FAILURE)
return Training_failure ? SEXP_TRUE : SEXP_FALSE;
// To MK: do whatever you want with this number here.
rtn = process_special_sexps(eval_num(node));
return rtn;
}
// sexpression to flash a hud gauge. gauge name is text valud of node
void sexp_flash_hud_gauge( int node )
{
char *name;
int i;
name = CTEXT(node);
for (i = 0; i < NUM_HUD_GAUGES; i++ ) {
if ( !stricmp(HUD_gauge_text[i], name) ) {
hud_gauge_start_flash(i); // call HUD function to flash gauge
break;
}
}
}
void sexp_set_training_context_fly_path(int node)
{
int i;
for (i=0; i<Num_waypoint_lists; i++)
if (!stricmp(CTEXT(node), Waypoint_lists[i].name))
break;
if (i < Num_waypoint_lists) {
Training_context |= TRAINING_CONTEXT_FLY_PATH;
Training_context_path = i;
Training_context_distance = (float) atof(CTEXT(CDR(node)));
Training_context_goal_waypoint = 0;
Training_context_at_waypoint = -1;
}
}
void sexp_set_training_context_speed(int node)
{
Training_context |= TRAINING_CONTEXT_SPEED;
Training_context_speed_min = eval_num(node);
Training_context_speed_max = eval_num(CDR(node));
Training_context_speed_set = 0;
}
bool Sexp_Messages_Scrambled = false;
void sexp_scramble_messages(bool scramble)
{
Sexp_Messages_Scrambled = scramble;
}
void sexp_set_cutscene_bars(int node)
{
//We know we want the bars
Cutscene_bar_flags |= CUB_CUTSCENE;
float delta_speed = 0.0f;
if(node != -1)
delta_speed = eval_num(node)/1000.0f;
if(delta_speed > 0.0f)
{
Cutscene_bars_progress = 0.0f;
Cutscene_bar_flags |= CUB_GRADUAL;
Cutscene_delta_time = delta_speed;
}
else
{
Cutscene_bar_flags &= ~CUB_GRADUAL;
}
}
void sexp_unset_cutscene_bars(int node)
{
//We know we DON'T want the bars
Cutscene_bar_flags &= ~CUB_CUTSCENE;
float delta_speed = 0.0f;
if(node != -1)
delta_speed = eval_num(node)/1000.0f;
if(delta_speed > 0.0f)
{
Cutscene_bars_progress = 0.0f;
Cutscene_bar_flags |= CUB_GRADUAL;
Cutscene_delta_time = delta_speed;
}
else
{
Cutscene_bar_flags &= ~CUB_GRADUAL;
}
}
void sexp_fade_in(int n)
{
float delta_time = 0.0f;
if(n != -1)
delta_time = eval_num(n)/1000.0f;
if(delta_time > 0.0f)
{
Fade_delta_time = delta_time;
Fade_type = FI_FADEIN;
}
else
{
Fade_type = FI_NONE;
gr_create_shader(&Viewer_shader, 0, 0, 0, 0);
}
}
void sexp_fade_out(int n)
{
float delta_time = 0.0f;
if(n != -1)
{
delta_time = eval_num(n)/1000.0f;
n = CDR(n);
if(n != -1)
{
switch(eval_num(n))
{
//White out
case 1:
gr_create_shader(&Viewer_shader, 255, 255, 255, Viewer_shader.c);
break;
//Red out
case 2:
gr_create_shader(&Viewer_shader, 255, 0, 0, Viewer_shader.c);
break;
//Black out
default:
gr_create_shader(&Viewer_shader, 0, 0, 0, Viewer_shader.c);
}
}
else
{
gr_create_shader(&Viewer_shader, 0, 0, 0, Viewer_shader.c);
}
if(delta_time > 0.0f)
{
Fade_type = FI_FADEOUT;
Fade_delta_time = delta_time;
}
else
{
Fade_type = FI_NONE;
gr_create_shader(&Viewer_shader, Viewer_shader.r, Viewer_shader.g, Viewer_shader.b, 255);
}
}
else
{
gr_create_shader(&Viewer_shader, 0, 0, 0, 255);
Fade_type = FI_NONE;
}
}
camera* sexp_get_set_camera(bool reset = false)
{
static camid sexp_camera;
if(!reset)
{
if(Viewer_mode & VM_FREECAMERA)
{
camera *cam = cam_get_current().getCamera();
if(cam != NULL)
return cam;
}
}
if(!sexp_camera.isValid())
{
sexp_camera = cam_create("SEXP camera");
}
cam_set_camera(sexp_camera);
return sexp_camera.getCamera();
}
void sexp_set_camera(int node)
{
if(node == -1)
{
sexp_get_set_camera(true);
return;
}
char *cam_name = CTEXT(node);
camid cid = cam_lookup(cam_name);
if(!cid.isValid())
{
cid = cam_create(cam_name);
}
cam_set_camera(cid);
}
void sexp_set_camera_position(int n)
{
camera *cam = sexp_get_set_camera();
if(cam == NULL)
return;
vec3d camera_vec;
float camera_time = 0.0f;
float camera_acc_time = 0.0f;
float camera_dec_time = 0.0f;
camera_vec.xyz.x = i2fl(eval_num(n));
n = CDR(n);
camera_vec.xyz.y = i2fl(eval_num(n));
n = CDR(n);
camera_vec.xyz.z = i2fl(eval_num(n));
n = CDR(n);
if(n != -1)
{
camera_time = eval_num(n) / 1000.0f;
n = CDR(n);
if(n != -1)
{
camera_dec_time = camera_acc_time = eval_num(n) / 1000.0f;
n = CDR(n);
if(n != -1)
{
camera_dec_time = eval_num(n) / 1000.0f;
}
}
}
cam->set_position(&camera_vec, camera_time, camera_acc_time, camera_dec_time);
}
void sexp_set_camera_rotation(int n)
{
camera *cam = sexp_get_set_camera();
if(cam == NULL)
return;
angles rot_angles;
float rot_time = 0.0f;
float rot_acc_time = 0.0f;
float rot_dec_time = 0.0f;
//Angles are in degrees
rot_angles.p = eval_num(n) * (PI/180.0f);
n = CDR(n);
rot_angles.b = eval_num(n) * (PI/180.0f);
n = CDR(n);
rot_angles.h = eval_num(n) * (PI/180.0f);
n = CDR(n);
if(n != -1)
{
rot_time = eval_num(n) / 1000.0f;
n = CDR(n);
if(n != -1)
{
rot_dec_time = rot_acc_time = eval_num(n) / 1000.0f;
n = CDR(n);
if(n != -1)
{
rot_dec_time = eval_num(n) / 1000.0f;
}
}
}
cam->set_rotation(&rot_angles, rot_time, rot_acc_time, rot_dec_time);
}
void sexp_set_camera_facing(int n)
{
camera *cam = sexp_get_set_camera();
if(cam == NULL)
return;
vec3d location;
float rot_time = 0.0f;
float rot_acc_time = 0.0f;
float rot_dec_time = 0.0f;
location.xyz.x = i2fl(eval_num(n));
n = CDR(n);
location.xyz.y = i2fl(eval_num(n));
n = CDR(n);
location.xyz.z = i2fl(eval_num(n));
n = CDR(n);
if(n != -1)
{
rot_time = eval_num(n) / 1000.0f;
n = CDR(n);
if(n != -1)
{
rot_dec_time = rot_acc_time = eval_num(n) / 1000.0f;
n = CDR(n);
if(n != -1)
{
rot_dec_time = eval_num(n) / 1000.0f;
}
}
}
cam->set_rotation_facing(&location, rot_time, rot_acc_time, rot_dec_time);
}
void sexp_set_camera_facing_object(int n)
{
char *object_name = CTEXT(n);
float rot_time = 0.0f;
float rot_acc_time = 0.0f;
float rot_dec_time = 0.0f;
//Now get the rotation time values
n = CDR(n);
if(n != -1)
{
rot_time = eval_num(n) / 1000.0f;
n = CDR(n);
if(n != -1)
{
rot_dec_time = rot_acc_time = eval_num(n) / 1000.0f;
n = CDR(n);
if(n != -1)
{
rot_dec_time = eval_num(n) / 1000.0f;
}
}
}
object_ship_wing_point_team oswpt;
sexp_get_object_ship_wing_point_team(&oswpt, object_name);
switch (oswpt.type)
{
case OSWPT_TYPE_EXITED:
{
Warning(LOCATION, "Camera tried to face destroyed/departed object %s", object_name);
return;
}
case OSWPT_TYPE_TEAM:
case OSWPT_TYPE_SHIP:
case OSWPT_TYPE_WING:
case OSWPT_TYPE_WAYPOINT:
{
camera *cam = sexp_get_set_camera();
if(cam == NULL)
return;
cam->set_rotation_facing(&oswpt.objp->pos, rot_time, rot_acc_time, rot_dec_time);
return;
}
}
}
extern float VIEWER_ZOOM_DEFAULT;
void sexp_set_camera_fov(int n)
{
camera *cam = sexp_get_set_camera();
if(cam == NULL)
return;
float camera_fov = VIEWER_ZOOM_DEFAULT;
float camera_time = 0.0f;
float camera_acc_time = 0.0f;
float camera_dec_time = 0.0f;
camera_fov = i2fl(eval_num(n)) * (PI/180.0f);
n = CDR(n);
if(n != -1)
{
camera_time = eval_num(n) / 1000.0f;
n = CDR(n);
if(n != -1)
{
camera_dec_time = camera_acc_time = eval_num(n) / 1000.0f;
n = CDR(n);
if(n != -1)
{
camera_dec_time = eval_num(n) / 1000.0f;
}
}
}
cam->set_fov(camera_fov, camera_time, camera_acc_time, camera_dec_time);
}
//Internal helper function for set-target and set-host
object *sexp_camera_get_objsub(int node, int *o_submodel)
{
//Get arguments
int n = node;
char *obj_name = NULL;
char *sub_name = NULL;
obj_name = CTEXT(n);
n = CDR(n);
if(n != -1)
sub_name = CTEXT(n);
//Important variables
object *objp = NULL;
int submodel = -1;
//*****Process obj_name
object_ship_wing_point_team oswpt;
sexp_get_object_ship_wing_point_team(&oswpt, obj_name);
switch (oswpt.type)
{
case OSWPT_TYPE_SHIP:
case OSWPT_TYPE_WING:
case OSWPT_TYPE_WAYPOINT:
case OSWPT_TYPE_TEAM:
objp = oswpt.objp;
break;
default:
objp = NULL;
}
//*****Process submodel
if(objp != NULL && sub_name != NULL && oswpt.type == OSWPT_TYPE_SHIP)
{
if(stricmp(sub_name, SEXP_NONE_STRING))
{
ship_subsys *ss = ship_get_subsys(&Ships[objp->instance], sub_name);
if (ss != NULL)
{
submodel = ss->system_info->subobj_num;
}
}
}
if(o_submodel != NULL)
*o_submodel = submodel;
return objp;
}
void sexp_set_camera_host(int node)
{
//Try to get current camera
camera *cam = sexp_get_set_camera();
if(cam == NULL)
return;
//*****Get variables
int submodel = -1;
object *objp = sexp_camera_get_objsub(node, &submodel);
//*****Set
cam->set_object_host(objp, submodel);
}
void sexp_set_camera_target(int node)
{
//Try to get current camera
camera *cam = sexp_get_set_camera();
if(cam == NULL)
return;
//*****Get variables
int submodel = -1;
object *objp = sexp_camera_get_objsub(node, &submodel);
//*****Set
cam->set_object_target(objp, submodel);
}
void sexp_set_fov(int n)
{
camera *cam = Main_camera.getCamera();
if(cam == NULL)
return;
//Cap FOV to something reasonable.
float new_fov = (float)eval_num(n);
new_fov = MIN(new_fov, 360.0f);
new_fov = MAX(new_fov, 0.0f);
Sexp_fov = (new_fov * (PI/180.0f));
//cam->set_fov(eval_num(n) * (PI/180.0f));
}
void sexp_reset_fov()
{
camera *cam = Main_camera.getCamera();
if(cam == NULL)
return;
Sexp_fov = 0.0;
//cam->set_fov(VIEWER_ZOOM_DEFAULT);
}
void sexp_reset_camera(int node)
{
camera *cam = cam_get_current().getCamera();
if(cam != NULL)
{
if(is_sexp_true(node))
{
cam->reset();
}
}
cam_reset_camera();
}
void sexp_show_subtitle(int node)
{
//These should be set to the default if not required to be explicitly defined
int x_pos, y_pos, width=200;
char *text, *imageanim=NULL;
float display_time, fade_time=0.0f;
int r=255, g=255, b=255;
bool center_x=false, center_y=false;
int n = -1;
x_pos = eval_num(node);
n = CDR(node);
y_pos = eval_num(n);
n = CDR(n);
text = CTEXT(n);
n = CDR(n);
display_time = eval_num(n)/1000.0f; //is in ms
n = CDR(n);
if(n != -1)
{
imageanim = CTEXT(n);
n = CDR(n);
if(n != -1)
{
fade_time = eval_num(n)/1000.0f; //also in ms
n = CDR(n);
if(n != -1)
{
if(Sexp_nodes[Sexp_nodes[n].first].value==SEXP_KNOWN_TRUE)
center_x = true;
n = CDR(n);
if(n != -1)
{
if(Sexp_nodes[Sexp_nodes[n].first].value==SEXP_KNOWN_TRUE)
center_y = true;
n = CDR(n);
if(n != -1)
{
width = eval_num(n);
n = CDR(n);
if(n != -1)
{
r = eval_num(n);
n = CDR(n);
if(n != -1)
{
g = eval_num(n);
n = CDR(n);
if(n != -1)
{
b = eval_num(n);
}}}}}}}}
if(r > 255)
r = 255;
if(g > 255)
g = 255;
if(b > 255)
b = 255;
//FINALLY !!
color new_color;
gr_init_alphacolor(&new_color, r, g, b, 255);
subtitle new_subtitle(x_pos, y_pos, text, display_time, imageanim, fade_time, &new_color, center_x, center_y, width);
Subtitles.push_back(new_subtitle);
}
void sexp_set_time_compression(int n)
{
float new_change_time = 0.0f;
float new_multiplier = eval_num(n)/100.0f; //percent->decimal
//Time to change
n = CDR(n);
if(n != -1)
new_change_time = eval_num(n)/1000.0f; //ms->seconds
//Override current time compression with this value
n = CDR(n);
if(n != -1)
set_time_compression(eval_num(n)/100.0f);
set_time_compression(new_multiplier, new_change_time);
lock_time_compression(true);
}
void sexp_reset_time_compression()
{
set_time_compression(1);
lock_time_compression(false);
}
extern bool Perspective_locked;
void sexp_force_perspective(int n)
{
int result = eval_sexp(n);
Perspective_locked = (result == SEXP_TRUE || result == SEXP_KNOWN_TRUE);
n=CDR(n);
if(n != -1)
{
n = eval_num(n);
switch(n)
{
case 0:
Viewer_mode = 0;
break;
case 1:
Viewer_mode = VM_CHASE;
break;
case 2:
Viewer_mode = VM_EXTERNAL;
break;
case 3:
Viewer_mode = VM_TOPDOWN;
break;
}
}
}
void sexp_set_camera_shudder(int n)
{
game_shudder_apply(eval_num(n), (float) eval_num(CDR(n)) * 0.01f);
}
void sexp_set_jumpnode_color(int n)
{
jump_node *jnp = jumpnode_get_by_name(CTEXT(n));
if(jnp==NULL)
return;
n=CDR(n);
jnp->set_alphacolor(eval_num(n),eval_num(CDR(n)),eval_num(CDR(CDR(n))),eval_num(CDR(CDR(CDR(n)))));
}
void sexp_set_jumpnode_model(int n)
{
jump_node *jnp = jumpnode_get_by_name(CTEXT(n));
if(jnp==NULL)
return;
n=CDR(n);
jnp->set_model(CTEXT(n),(CDR(n)==SEXP_KNOWN_TRUE));
}
void sexp_show_jumpnode(int n)
{
jump_node *jnp = jumpnode_get_by_name(CTEXT(n));
if(jnp!=NULL)
jnp->show(true);
}
void sexp_hide_jumpnode(int n)
{
jump_node *jnp = jumpnode_get_by_name(CTEXT(n));
if(jnp!=NULL)
jnp->show(false);
}
//WMC - This is a bit of a hack, however, it's easier than
//coding in a whole new SCript_system function.
int sexp_script_eval(int node, int return_type)
{
int n = node;
char *s = CTEXT(n);
bool success = false;
int r = -1;
switch(return_type)
{
case OPR_NUMBER:
success = Script_system.EvalString(s, "|i", &r, s);
break;
case OPR_STRING:
Error(LOCATION, "SEXP system does not support string return type; Goober must fix this before script-eval-string will work");
break;
case OPR_NULL:
while(n != -1)
{
success = Script_system.EvalString(s, NULL, NULL, CTEXT(n));
n = CDR(n);
}
break;
default:
Error(LOCATION, "Bad type passed to sexp_script_eval - get a coder");
break;
}
if(!success)
Warning(LOCATION, "sexp-script-eval failed to evaluate string \"%s\"; check your syntax", s);
return r;
}
//Karajorma - Returns true if the name of a subsystem is actually a generic type (e.g <all engines> or <all turrets>
bool is_generic_subsys(char *subsys_name)
{
if (!strcmp(subsys_name, SEXP_ALL_ENGINES_STRING) || !strcmp(subsys_name, SEXP_ALL_TURRETS_STRING)) {
return true;
}
return false;
}
// Karajorma - returns false if the ship class has changed since the mission was parsed in
// Changes can be from use of the change-ship-class SEXP, loadout or any future method
bool ship_class_unchanged(int ship_index)
{
p_object *p_objp;
ship *shipp = &Ships[ship_index];
p_objp = mission_parse_get_parse_object(shipp->ship_name);
if ((p_objp != NULL) && (p_objp->ship_class == shipp->ship_info_index)) {
return true;
}
return false;
}
// Goober5000 - needed because any nonzero integer value is "true"
int is_sexp_true(int cur_node, int referenced_node)
{
int result = eval_sexp(cur_node, referenced_node);
return ((result == SEXP_TRUE) || (result == SEXP_KNOWN_TRUE));
}
// high-level sexpression evaluator
int eval_sexp(int cur_node, int referenced_node)
{
int node, type, sexp_val = UNINITIALIZED;
if (cur_node == -1) // empty list, i.e. sexp: ( )
return SEXP_FALSE;
Assert(cur_node >= 0); // we have special sexp nodes <= -1!!! MWA
// which should be intercepted before we get here. HOFFOSS
type = SEXP_NODE_TYPE(cur_node);
Assert( (type == SEXP_LIST) || (type == SEXP_ATOM) );
// trap known true and known false sexpressions. We don't trap on SEXP_NAN sexpressions since
// they may yet evaluate to true or false.
if (Sexp_nodes[cur_node].value == SEXP_KNOWN_TRUE)
return SEXP_TRUE;
else if (Sexp_nodes[cur_node].value == SEXP_KNOWN_FALSE)
return SEXP_FALSE;
if (Sexp_nodes[cur_node].first != -1) {
node = CAR(cur_node);
sexp_val = eval_sexp(node);
Sexp_nodes[cur_node].value = Sexp_nodes[node].value; // higher level node gets node value
return sexp_val;
} else {
int op_num;
node = CDR(cur_node); // makes reading the next bit of code a little easier.
op_num = get_operator_const(CTEXT(cur_node));
// add the op_num to the stack if it is an actual operator rather than a number
if (op_num) {
Current_sexp_operator.push_back(op_num);
}
switch ( op_num ) {
// arithmetic operators will always return just their value
case OP_PLUS:
sexp_val = add_sexps(node);
break;
case OP_MINUS:
sexp_val = sub_sexps(node);
break;
case OP_MUL:
sexp_val = mul_sexps(node);
break;
case OP_MOD:
sexp_val = mod_sexps(node);
break;
case OP_DIV:
sexp_val = div_sexps(node);
break;
case OP_RAND:
case OP_RAND_MULTIPLE:
sexp_val = rand_sexp( node, (op_num == OP_RAND_MULTIPLE) );
break;
case OP_ABS:
sexp_val = abs_sexp(node);
break;
case OP_MIN:
sexp_val = min_sexp(node);
break;
case OP_MAX:
sexp_val = max_sexp(node);
break;
case OP_AVG:
sexp_val = avg_sexp(node);
break;
// boolean operators can have one of the special sexp values (known true, known false, unknown)
case OP_TRUE:
sexp_val = SEXP_KNOWN_TRUE;
break;
case OP_FALSE:
sexp_val = SEXP_KNOWN_FALSE;
break;
case OP_OR:
sexp_val = sexp_or(node);
break;
case OP_AND:
sexp_val = sexp_and(node);
break;
case OP_AND_IN_SEQUENCE:
sexp_val = sexp_and_in_sequence(node);
break;
case OP_GREATER_THAN:
case OP_LESS_THAN:
case OP_EQUALS:
sexp_val = sexp_number_compare( node, op_num );
break;
case OP_STRING_GREATER_THAN:
case OP_STRING_LESS_THAN:
case OP_STRING_EQUALS:
sexp_val = sexp_string_compare( node, op_num );
break;
case OP_IS_IFF:
sexp_val = sexp_is_iff(node);
break;
case OP_NOT:
sexp_val = sexp_not(node);
break;
case OP_PREVIOUS_GOAL_TRUE:
sexp_val = sexp_previous_goal_status( node, GOAL_COMPLETE );
break;
case OP_PREVIOUS_GOAL_FALSE:
sexp_val = sexp_previous_goal_status( node, GOAL_FAILED );
break;
case OP_PREVIOUS_GOAL_INCOMPLETE:
sexp_val = sexp_previous_goal_status( node, GOAL_INCOMPLETE );
break;
case OP_PREVIOUS_EVENT_TRUE:
sexp_val = sexp_previous_event_status( node, EVENT_SATISFIED );
break;
case OP_PREVIOUS_EVENT_FALSE:
sexp_val = sexp_previous_event_status( node, EVENT_FAILED );
break;
case OP_PREVIOUS_EVENT_INCOMPLETE:
sexp_val = sexp_previous_event_status( node, EVENT_INCOMPLETE );
break;
case OP_EVENT_TRUE:
case OP_EVENT_FALSE:
sexp_val = sexp_event_status( node, (op_num == OP_EVENT_TRUE?1:0) );
if ((sexp_val != SEXP_TRUE) && (sexp_val != SEXP_KNOWN_TRUE))
Sexp_useful_number = 0; // indicate sexp isn't current yet
break;
case OP_EVENT_TRUE_DELAY:
case OP_EVENT_FALSE_DELAY:
sexp_val = sexp_event_delay_status( node, (op_num == OP_EVENT_TRUE_DELAY?1:0) );
// if ((sexp_val != SEXP_TRUE) && (sexp_val != SEXP_KNOWN_TRUE))
// Sexp_useful_number = 0; // indicate sexp isn't current yet
break;
case OP_GOAL_TRUE_DELAY:
case OP_GOAL_FALSE_DELAY:
sexp_val = sexp_goal_delay_status( node, (op_num == OP_GOAL_TRUE_DELAY?1:0) );
break;
case OP_EVENT_INCOMPLETE:
sexp_val = sexp_event_incomplete(node);
if ((sexp_val != SEXP_TRUE) && (sexp_val != SEXP_KNOWN_TRUE))
Sexp_useful_number = 0; // indicate sexp isn't current yet
break;
case OP_GOAL_INCOMPLETE:
sexp_val = sexp_goal_incomplete(node);
break;
// destroy type sexpressions
case OP_IS_DESTROYED:
sexp_val = sexp_is_destroyed( node, NULL );
break;
case OP_IS_SUBSYSTEM_DESTROYED:
sexp_val = sexp_is_subsystem_destroyed(node);
break;
case OP_HAS_DOCKED:
sexp_val = sexp_has_docked(node);
break;
case OP_HAS_ARRIVED:
sexp_val = sexp_has_arrived( node, NULL );
break;
case OP_HAS_DEPARTED:
sexp_val = sexp_has_departed( node, NULL );
break;
case OP_HAS_UNDOCKED:
sexp_val = sexp_has_undocked(node);
break;
case OP_IS_DISABLED:
sexp_val = sexp_is_disabled( node, NULL );
break;
case OP_IS_DISARMED:
sexp_val = sexp_is_disarmed( node, NULL );
break;
case OP_WAYPOINTS_DONE:
sexp_val = sexp_are_waypoints_done(node);
break;
// objective operators that use a delay
case OP_IS_DESTROYED_DELAY:
sexp_val = sexp_is_destroyed_delay(node);
break;
case OP_IS_SUBSYSTEM_DESTROYED_DELAY:
sexp_val = sexp_is_subsystem_destroyed_delay(node);
break;
case OP_HAS_DOCKED_DELAY:
sexp_val = sexp_has_docked_delay(node);
break;
case OP_HAS_ARRIVED_DELAY:
sexp_val = sexp_has_arrived_delay(node);
break;
case OP_HAS_DEPARTED_DELAY:
sexp_val = sexp_has_departed_delay(node);
break;
case OP_HAS_UNDOCKED_DELAY:
sexp_val = sexp_has_undocked_delay(node);
break;
case OP_IS_DISABLED_DELAY:
sexp_val = sexp_is_disabled_delay(node);
break;
case OP_IS_DISARMED_DELAY:
sexp_val = sexp_is_disarmed_delay(node);
break;
case OP_WAYPOINTS_DONE_DELAY:
sexp_val = sexp_are_waypoints_done_delay(node);
break;
case OP_SHIP_TYPE_DESTROYED:
sexp_val = sexp_ship_type_destroyed(node);
break;
// time based sexpressions
case OP_HAS_TIME_ELAPSED:
sexp_val = sexp_has_time_elapsed(node);
break;
case OP_MODIFY_VARIABLE:
sexp_modify_variable(node);
sexp_val = SEXP_TRUE; // SEXP_TRUE means only do once.
break;
case OP_TIME_SHIP_DESTROYED:
sexp_val = sexp_time_destroyed(node);
break;
case OP_TIME_WING_DESTROYED:
sexp_val = sexp_time_wing_destroyed(node);
break;
case OP_TIME_SHIP_ARRIVED:
sexp_val = sexp_time_ship_arrived(node);
break;
case OP_TIME_WING_ARRIVED:
sexp_val = sexp_time_wing_arrived(node);
break;
case OP_TIME_SHIP_DEPARTED:
sexp_val = sexp_time_ship_departed(node);
break;
case OP_TIME_WING_DEPARTED:
sexp_val = sexp_time_wing_departed(node);
break;
case OP_MISSION_TIME:
sexp_val = sexp_mission_time();
break;
case OP_TIME_DOCKED:
sexp_val = sexp_time_docked(node);
break;
case OP_TIME_UNDOCKED:
sexp_val = sexp_time_undocked(node);
break;
case OP_AFTERBURNER_LEFT:
sexp_val = sexp_get_energy_pct(node, op_num);
break;
case OP_WEAPON_ENERGY_LEFT:
sexp_val = sexp_get_energy_pct(node, op_num);
break;
case OP_SHIELDS_LEFT:
sexp_val = sexp_shields_left(node);
break;
case OP_HITS_LEFT:
sexp_val = sexp_hits_left(node);
break;
case OP_HITS_LEFT_SUBSYSTEM:
sexp_val = sexp_hits_left_subsystem(node);
break;
case OP_SIM_HITS_LEFT:
sexp_val = sexp_sim_hits_left(node);
break;
case OP_SPECIAL_WARP_DISTANCE:
sexp_val = sexp_special_warp_dist(node);
break;
case OP_DISTANCE:
sexp_val = sexp_distance(node);
break;
case OP_DISTANCE_SUBSYSTEM:
sexp_val = sexp_distance_subsystem(node);
break;
case OP_NUM_WITHIN_BOX:
sexp_val = sexp_num_within_box(node);
break;
case OP_IS_SHIP_VISIBLE:
sexp_val = sexp_is_ship_visible(node);
break;
case OP_IS_SHIP_STEALTHY:
sexp_val = sexp_is_ship_stealthy(node);
break;
case OP_IS_FRIENDLY_STEALTH_VISIBLE:
sexp_val = sexp_is_friendly_stealth_visible(node);
break;
case OP_TEAM_SCORE:
sexp_val = sexp_team_score(node);
break;
case OP_LAST_ORDER_TIME:
sexp_val = sexp_last_order_time(node);
break;
case OP_NUM_PLAYERS:
sexp_val = sexp_num_players();
break;
case OP_SKILL_LEVEL_AT_LEAST:
sexp_val = sexp_skill_level_at_least(node);
break;
case OP_IS_CARGO_KNOWN:
case OP_CARGO_KNOWN_DELAY:
sexp_val = sexp_is_cargo_known( node, (op_num==OP_IS_CARGO_KNOWN)?0:1 );
break;
case OP_HAS_BEEN_TAGGED_DELAY:
sexp_val = sexp_has_been_tagged_delay(node);
break;
case OP_CAP_SUBSYS_CARGO_KNOWN_DELAY:
sexp_val = sexp_cap_subsys_cargo_known_delay(node);
break;
case OP_WAS_PROMOTION_GRANTED:
sexp_val = sexp_was_promotion_granted(node);
break;
case OP_WAS_MEDAL_GRANTED:
sexp_val = sexp_was_medal_granted(node);
break;
case OP_GET_DAMAGE_CAUSED:
sexp_val = sexp_get_damage_caused(node);
break;
case OP_PERCENT_SHIPS_DEPARTED:
case OP_PERCENT_SHIPS_DESTROYED:
case OP_PERCENT_SHIPS_DISARMED:
case OP_PERCENT_SHIPS_DISABLED:
sexp_val = sexp_percent_ships_depart_destroy_disarm_disable(node, op_num);
break;
case OP_DEPART_NODE_DELAY:
sexp_val = sexp_depart_node_delay(node);
break;
case OP_DESTROYED_DEPARTED_DELAY:
sexp_val = sexp_destroyed_departed_delay(node);
break;
// conditional sexpressions
case OP_WHEN:
case OP_WHEN_ARGUMENT:
sexp_val = eval_when( node, (op_num == OP_WHEN_ARGUMENT) );
break;
case OP_COND:
sexp_val = eval_cond(node);
break;
// Goober5000: special case; evaluate like when, but flush the sexp tree
// and return SEXP_NAN so this will always be re-evaluated
case OP_EVERY_TIME:
case OP_EVERY_TIME_ARGUMENT:
eval_when( node, (op_num == OP_EVERY_TIME_ARGUMENT) );
flush_sexp_tree(node);
sexp_val = SEXP_NAN;
break;
// Goober5000
case OP_ANY_OF:
sexp_val = eval_any_of( cur_node, referenced_node );
break;
// Goober5000
case OP_EVERY_OF:
sexp_val = eval_every_of( cur_node, referenced_node );
break;
// Goober5000 and Karajorma
case OP_RANDOM_OF:
case OP_RANDOM_MULTIPLE_OF:
sexp_val = eval_random_of( cur_node, referenced_node, (op_num == OP_RANDOM_MULTIPLE_OF) );
break;
// Goober5000
case OP_NUMBER_OF:
sexp_val = eval_number_of( cur_node, referenced_node );
break;
// Karajorma
case OP_IN_SEQUENCE:
sexp_val = eval_in_sequence( cur_node, referenced_node );
break;
// Goober5000
case OP_INVALIDATE_ARGUMENT:
case OP_VALIDATE_ARGUMENT:
sexp_change_argument_validity(node, (op_num == OP_INVALIDATE_ARGUMENT));
sexp_val = SEXP_TRUE;
break;
case OP_DO_FOR_VALID_ARGUMENTS:
// do-for-valid-arguments should only ever be called within eval_when()
Int3();
break;
// sexpressions with side effects
case OP_CHANGE_IFF:
sexp_change_iff(node);
sexp_val = SEXP_TRUE;
break;
case OP_ADD_SHIP_GOAL:
sexp_add_ship_goal(node);
sexp_val = SEXP_TRUE;
break;
case OP_ADD_WING_GOAL:
sexp_add_wing_goal(node);
sexp_val = SEXP_TRUE;
break;
case OP_ADD_GOAL:
sexp_add_goal(node);
sexp_val = SEXP_TRUE;
break;
case OP_REMOVE_GOAL:
sexp_remove_goal(node);
sexp_val = SEXP_TRUE;
break;
case OP_CLEAR_SHIP_GOALS:
sexp_clear_ship_goals(node);
sexp_val = SEXP_TRUE;
break;
case OP_CLEAR_WING_GOALS:
sexp_clear_wing_goals(node);
sexp_val = SEXP_TRUE;
break;
case OP_CLEAR_GOALS:
sexp_clear_goals(node);
sexp_val = SEXP_TRUE;
break;
case OP_PROTECT_SHIP:
case OP_UNPROTECT_SHIP:
sexp_protect_ships(node, (op_num == OP_PROTECT_SHIP));
sexp_val = SEXP_TRUE;
break;
case OP_BEAM_PROTECT_SHIP:
case OP_BEAM_UNPROTECT_SHIP:
sexp_beam_protect_ships(node, (op_num == OP_BEAM_PROTECT_SHIP));
sexp_val = SEXP_TRUE;
break;
case OP_SHIP_STEALTHY:
case OP_SHIP_UNSTEALTHY:
sexp_ships_stealthy(node, (op_num == OP_SHIP_STEALTHY));
sexp_val = SEXP_TRUE;
break;
case OP_FRIENDLY_STEALTH_INVISIBLE:
case OP_FRIENDLY_STEALTH_VISIBLE:
sexp_friendly_stealth_invisible(node, (op_num == OP_FRIENDLY_STEALTH_INVISIBLE));
sexp_val = SEXP_TRUE;
break;
case OP_SHIP_INVISIBLE:
case OP_SHIP_VISIBLE:
sexp_ships_visible(node, (op_num == OP_SHIP_VISIBLE));
sexp_val = SEXP_TRUE;
break;
// Goober5000
case OP_SHIP_TAG:
case OP_SHIP_UNTAG:
sexp_ship_tag(node, (op_num == OP_SHIP_TAG));
sexp_val = SEXP_TRUE;
break;
case OP_SHIP_CHANGE_ALT_NAME:
sexp_ship_change_alt_name(node);
sexp_val = SEXP_TRUE;
break;
case OP_SET_DEATH_MESSAGE:
sexp_set_death_message(node);
sexp_val = SEXP_TRUE;
break;
case OP_SHIP_VULNERABLE:
case OP_SHIP_INVULNERABLE:
sexp_ships_invulnerable(node, (op_num == OP_SHIP_INVULNERABLE));
sexp_val = SEXP_TRUE;
break;
case OP_SHIP_BOMB_TARGETABLE:
case OP_SHIP_BOMB_UNTARGETABLE:
sexp_ships_bomb_targetable(node, (op_num == OP_SHIP_BOMB_TARGETABLE));
sexp_val = SEXP_TRUE;
break;
case OP_SHIP_GUARDIAN:
case OP_SHIP_NO_GUARDIAN:
sexp_ships_guardian(node, (op_num == OP_SHIP_GUARDIAN));
sexp_val = SEXP_TRUE;
break;
case OP_SHIP_GUARDIAN_THRESHOLD:
sexp_ship_guardian_threshold(node);
sexp_val = SEXP_TRUE;
break;
case OP_SHIP_SUBSYS_GUARDIAN_THRESHOLD:
sexp_ship_subsys_guardian_threshold(node);
sexp_val = SEXP_TRUE;
break;
case OP_SHIP_SUBSYS_TARGETABLE:
case OP_SHIP_SUBSYS_UNTARGETABLE:
sexp_ship_subsys_untargetable(node, (op_num == OP_SHIP_SUBSYS_UNTARGETABLE));
sexp_val = SEXP_TRUE;
break;
case OP_SHIP_CREATE:
sexp_ship_create(node);
sexp_val = SEXP_TRUE;
break;
case OP_WEAPON_CREATE:
sexp_weapon_create(node);
sexp_val = SEXP_TRUE;
break;
case OP_SHIP_VANISH:
sexp_ship_vanish(node);
sexp_val = SEXP_TRUE;
break;
//-Sesquipedalian
case OP_SHIELDS_ON:
case OP_SHIELDS_OFF:
sexp_shields_off(node, (op_num == OP_SHIELDS_OFF));
sexp_val = SEXP_TRUE;
break;
//-Sesquipedalian
case OP_KAMIKAZE:
sexp_kamikaze(node, (op_num == OP_KAMIKAZE));
sexp_val = SEXP_TRUE;
break;
case OP_SET_CARGO:
sexp_set_cargo(node);
sexp_val = SEXP_TRUE;
break;
case OP_IS_CARGO:
sexp_val = sexp_is_cargo(node);
break;
case OP_CHANGE_AI_CLASS:
sexp_change_ai_class(node);
sexp_val = SEXP_TRUE;
break;
case OP_IS_AI_CLASS:
sexp_val = sexp_is_ai_class(node);
break;
case OP_IS_SHIP_TYPE:
sexp_val = sexp_is_ship_type(node);
break;
case OP_IS_SHIP_CLASS:
sexp_val = sexp_is_ship_class(node);
break;
case OP_CHANGE_SOUNDTRACK:
sexp_change_soundtrack(node);
sexp_val = SEXP_TRUE;
break;
case OP_PLAY_SOUND_FROM_TABLE:
sexp_play_sound_from_table(node);
sexp_val = SEXP_TRUE;
break;
case OP_PLAY_SOUND_FROM_FILE:
sexp_play_sound_from_file(node);
sexp_val = SEXP_TRUE;
break;
case OP_CLOSE_SOUND_FROM_FILE:
sexp_close_sound_from_file(node);
sexp_val = SEXP_TRUE;
break;
case OP_HUD_DISABLE:
sexp_hud_disable(node);
sexp_val = SEXP_TRUE;
break;
case OP_HUD_DISABLE_EXCEPT_MESSAGES:
sexp_hud_disable_except_messages(node);
sexp_val = SEXP_TRUE;
break;
case OP_HUD_SET_TEXT:
sexp_hud_set_text(node);
sexp_val = SEXP_TRUE;
break;
case OP_HUD_SET_TEXT_NUM:
sexp_hud_set_text_num(node);
sexp_val = SEXP_TRUE;
break;
case OP_HUD_SET_COORDS:
sexp_hud_set_coords(node);
sexp_val = SEXP_TRUE;
break;
case OP_HUD_SET_FRAME:
sexp_hud_set_frame(node);
sexp_val = SEXP_TRUE;
break;
case OP_HUD_SET_COLOR:
sexp_hud_set_color(node);
sexp_val = SEXP_TRUE;
break;
case OP_HUD_SET_MAX_TARGETING_RANGE:
sexp_hud_set_max_targeting_range(node);
sexp_val = SEXP_TRUE;
break;
// Goober5000
case OP_PLAYER_USE_AI:
case OP_PLAYER_NOT_USE_AI:
sexp_player_use_ai(op_num == OP_PLAYER_USE_AI);
sexp_val = SEXP_TRUE;
break;
//Karajorma
case OP_ALLOW_TREASON:
sexp_allow_treason(node);
sexp_val = SEXP_TRUE;
break;
// Goober5000
case OP_EXPLOSION_EFFECT:
sexp_explosion_effect(node);
sexp_val = SEXP_TRUE;
break;
// Goober5000
case OP_WARP_EFFECT:
sexp_warp_effect(node);
sexp_val = SEXP_TRUE;
break;
case OP_SEND_MESSAGE:
sexp_send_message(node);
sexp_val = SEXP_TRUE;
break;
// Karajorma
case OP_ENABLE_BUILTIN_MESSAGES:
case OP_DISABLE_BUILTIN_MESSAGES:
sexp_toggle_builtin_messages (node, op_num == OP_ENABLE_BUILTIN_MESSAGES);
sexp_val = SEXP_TRUE;
break;
case OP_SET_PERSONA:
sexp_set_persona (node);
sexp_val = SEXP_TRUE;
break;
case OP_SEND_MESSAGE_LIST:
sexp_send_message_list(node);
sexp_val = SEXP_TRUE;
break;
case OP_SEND_RANDOM_MESSAGE:
sexp_send_random_message(node);
sexp_val = SEXP_TRUE;
break;
case OP_SELF_DESTRUCT:
sexp_self_destruct(node);
sexp_val = SEXP_TRUE;
break;
case OP_NEXT_MISSION:
sexp_next_mission(node);
sexp_val = SEXP_TRUE;
break;
case OP_END_OF_CAMPAIGN:
sexp_end_of_campaign(node);
sexp_val = SEXP_TRUE;
break;
case OP_END_CAMPAIGN:
sexp_end_campaign(node);
sexp_val = SEXP_TRUE;
break;
case OP_SABOTAGE_SUBSYSTEM:
sexp_sabotage_subsystem(node);
sexp_val = SEXP_TRUE;
break;
case OP_REPAIR_SUBSYSTEM:
sexp_repair_subsystem(node);
sexp_val = SEXP_TRUE;
break;
case OP_SET_SUBSYSTEM_STRNGTH:
sexp_set_subsystem_strength(node);
sexp_val = SEXP_TRUE;
break;
case OP_INVALIDATE_GOAL:
case OP_VALIDATE_GOAL:
sexp_change_goal_validity( node, (op_num==OP_INVALIDATE_GOAL?0:1) );
sexp_val = SEXP_TRUE;
break;
case OP_TRANSFER_CARGO:
sexp_transfer_cargo(node);
sexp_val = SEXP_TRUE;
break;
case OP_EXCHANGE_CARGO:
sexp_exchange_cargo(node);
sexp_val = SEXP_TRUE;
break;
case OP_JETTISON_CARGO:
sexp_jettison_cargo(node);
sexp_val = SEXP_TRUE;
break;
case OP_CARGO_NO_DEPLETE:
sexp_cargo_no_deplete(node);
sexp_val = SEXP_TRUE;
break;
case OP_SET_SCANNED: // Goober5000
case OP_SET_UNSCANNED:
sexp_set_scanned_unscanned(node, op_num == OP_SET_SCANNED);
sexp_val = SEXP_TRUE;
break;
case OP_SET_SPECIAL_WARPOUT_NAME:
sexp_special_warpout_name(node);
sexp_val = SEXP_TRUE;
break;
//-WMC
case OP_MISSION_SET_NEBULA:
sexp_mission_set_nebula(node);
sexp_val = SEXP_TRUE;
break;
case OP_ADD_BACKGROUND_BITMAP:
sexp_add_background_bitmap(node);
sexp_val = SEXP_TRUE;
break;
case OP_REMOVE_BACKGROUND_BITMAP:
sexp_remove_background_bitmap(node);
sexp_val = SEXP_TRUE;
break;
case OP_ADD_SUN_BITMAP:
sexp_add_sun_bitmap(node);
sexp_val = SEXP_TRUE;
break;
case OP_REMOVE_SUN_BITMAP:
sexp_remove_sun_bitmap(node);
sexp_val = SEXP_TRUE;
break;
case OP_NEBULA_CHANGE_STORM:
sexp_nebula_change_storm(node);
sexp_val = SEXP_TRUE;
break;
case OP_NEBULA_TOGGLE_POOF:
sexp_nebula_toggle_poof(node);
sexp_val = SEXP_TRUE;
break;
case OP_END_MISSION:
sexp_end_mission(node);
sexp_val = SEXP_TRUE;
break;
// Goober5000
case OP_FORCE_JUMP:
sexp_force_jump();
sexp_val = SEXP_TRUE;
break;
// sexpressions for setting flag for good/bad time for someone to reasm
case OP_GOOD_REARM_TIME:
sexp_good_time_to_rearm(node);
sexp_val = SEXP_TRUE;
break;
case OP_GRANT_PROMOTION:
sexp_grant_promotion();
sexp_val = SEXP_TRUE;
break;
case OP_GRANT_MEDAL:
sexp_grant_medal(node);
sexp_val = SEXP_TRUE;
break;
case OP_SHIP_VAPORIZE:
case OP_SHIP_NO_VAPORIZE:
sexp_ships_vaporize( node, (op_num == OP_SHIP_VAPORIZE) );
sexp_val = SEXP_TRUE;
break;
case OP_DONT_COLLIDE_INVISIBLE:
case OP_COLLIDE_INVISIBLE:
sexp_dont_collide_invisible( node, (op_num == OP_DONT_COLLIDE_INVISIBLE) );
sexp_val = SEXP_TRUE;
break;
// Goober5000 - sigh, was this messed up all along?
case OP_WARP_BROKEN:
case OP_WARP_NOT_BROKEN:
case OP_WARP_NEVER:
case OP_WARP_ALLOWED:
sexp_deal_with_warp( node, (op_num==OP_WARP_BROKEN) || (op_num==OP_WARP_NOT_BROKEN),
(op_num==OP_WARP_BROKEN) || (op_num==OP_WARP_NEVER) );
sexp_val = SEXP_TRUE;
break;
case OP_GOOD_SECONDARY_TIME:
sexp_good_secondary_time(node);
sexp_val = SEXP_TRUE;
break;
// sexpressions to allow shpis/weapons during the course of a mission
case OP_ALLOW_SHIP:
sexp_allow_ship(node);
sexp_val = SEXP_TRUE;
break;
case OP_ALLOW_WEAPON:
sexp_allow_weapon(node);
sexp_val = SEXP_TRUE;
break;
case OP_TECH_ADD_SHIP:
sexp_tech_add_ship(node);
sexp_val = SEXP_TRUE;
break;
case OP_TECH_ADD_WEAPON:
sexp_tech_add_weapon(node);
sexp_val = SEXP_TRUE;
break;
case OP_TECH_ADD_INTEL:
sexp_tech_add_intel(node);
sexp_val = SEXP_TRUE;
break;
case OP_TECH_RESET_TO_DEFAULT:
sexp_tech_reset_to_default();
sexp_val = SEXP_TRUE;
break;
case OP_CHANGE_PLAYER_SCORE:
sexp_change_player_score(node);
sexp_val = SEXP_TRUE;
break;
case OP_CHANGE_TEAM_SCORE:
sexp_change_team_score(node);
sexp_val = SEXP_TRUE;
break;
// in the case of a red_alert mission, simply call the red alert function to close
// the current campaign's mission and move forward to the next mission
case OP_RED_ALERT:
red_alert_start_mission();
sexp_val = SEXP_TRUE;
break;
case OP_SET_OBJECT_SPEED_X:
case OP_SET_OBJECT_SPEED_Y:
case OP_SET_OBJECT_SPEED_Z:
sexp_set_object_speed(node, op_num - OP_SET_OBJECT_SPEED_X);
sexp_val = SEXP_TRUE;
break;
case OP_GET_OBJECT_X:
case OP_GET_OBJECT_Y:
case OP_GET_OBJECT_Z:
sexp_val = sexp_get_object_coordinate(node, op_num - OP_GET_OBJECT_X);
break;
case OP_SET_OBJECT_POSITION:
sexp_set_object_position(node);
sexp_val = SEXP_TRUE;
break;
case OP_SET_OBJECT_FACING:
case OP_SET_OBJECT_FACING_OBJECT:
sexp_set_object_facing(node, op_num == OP_SET_OBJECT_FACING_OBJECT);
sexp_val = SEXP_TRUE;
break;
// training operators
case OP_KEY_PRESSED:
sexp_val = sexp_key_pressed(node);
break;
case OP_SPECIAL_CHECK:
sexp_val = sexp_special_training_check(node);
break;
case OP_KEY_RESET:
sexp_key_reset(node);
sexp_val = SEXP_KNOWN_TRUE; // only do it first time in repeating events.
break;
case OP_KEY_RESET_MULTIPLE:
sexp_key_reset(node);
sexp_val = SEXP_TRUE;
break;
case OP_MISSILE_LOCKED:
sexp_val = sexp_missile_locked(node);
break;
case OP_TARGETED:
sexp_val = sexp_targeted(node);
break;
case OP_SPEED:
sexp_val = sexp_speed(node);
break;
case OP_PRIMARIES_DEPLETED:
sexp_val = sexp_primaries_depleted(node);
break;
case OP_SECONDARIES_DEPLETED:
sexp_val = sexp_secondaries_depleted(node);
break;
case OP_FACING:
sexp_val = sexp_facing(node);
break;
case OP_FACING2:
sexp_val = sexp_facing2(node);
break;
case OP_ORDER:
sexp_val = sexp_order(node);
break;
case OP_QUERY_ORDERS:
sexp_val = sexp_query_orders(node);
break;
// Karajorma
case OP_RESET_ORDERS:
sexp_reset_orders(node);
sexp_val = SEXP_TRUE;
break;
case OP_WAYPOINT_MISSED:
sexp_val = sexp_waypoint_missed();
break;
case OP_WAYPOINT_TWICE:
sexp_val = sexp_waypoint_twice();
break;
case OP_PATH_FLOWN:
sexp_val = sexp_path_flown();
break;
case OP_TRAINING_MSG:
sexp_send_training_message(node);
sexp_val = SEXP_TRUE;
break;
case OP_FLASH_HUD_GAUGE:
sexp_flash_hud_gauge(node);
sexp_val = SEXP_TRUE;
break;
case OP_SET_TRAINING_CONTEXT_FLY_PATH:
sexp_set_training_context_fly_path(node);
sexp_val = SEXP_TRUE;
break;
case OP_SET_TRAINING_CONTEXT_SPEED:
sexp_set_training_context_speed(node);
sexp_val = SEXP_TRUE;
break;
// Karajorma
case OP_STRING_TO_INT:
sexp_val = sexp_string_to_int(node);
break;
/* // debugging operators
case OP_INT3:
Int3();
sexp_val = SEXP_FALSE;
break;
*/
case 0: // zero represents a non-operator
return eval_num(cur_node);
case OP_NOP:
sexp_val = SEXP_TRUE;
break;
case OP_BEAM_FIRE:
sexp_beam_fire(node);
sexp_val = SEXP_TRUE;
break;
case OP_IS_TAGGED:
sexp_val = sexp_is_tagged(node);
break;
case OP_IS_PLAYER:
sexp_val = sexp_is_player(node);
break;
case OP_NUM_KILLS:
case OP_NUM_ASSISTS:
case OP_SHIP_SCORE:
case OP_SHIP_DEATHS:
case OP_RESPAWNS_LEFT:
sexp_val = sexp_return_player_data(node, op_num);
break;
case OP_SET_RESPAWNS:
sexp_set_respawns(node);
sexp_val = SEXP_TRUE;
break;
case OP_NUM_TYPE_KILLS:
sexp_val = sexp_num_type_kills(node);
break;
case OP_NUM_CLASS_KILLS:
sexp_val = sexp_num_class_kills(node);
break;
case OP_BEAM_FREE:
sexp_val = SEXP_TRUE;
sexp_beam_free(node);
break;
case OP_BEAM_FREE_ALL:
sexp_val = SEXP_TRUE;
sexp_beam_free_all(node);
break;
case OP_BEAM_LOCK:
sexp_val = SEXP_TRUE;
sexp_beam_lock(node);
break;
case OP_BEAM_LOCK_ALL:
sexp_val = SEXP_TRUE;
sexp_beam_lock_all(node);
break;
case OP_TURRET_FREE:
sexp_val = SEXP_TRUE;
sexp_turret_free(node);
break;
case OP_TURRET_FREE_ALL:
sexp_val = SEXP_TRUE;
sexp_turret_free_all(node);
break;
case OP_TURRET_LOCK:
sexp_val = SEXP_TRUE;
sexp_turret_lock(node);
break;
case OP_TURRET_LOCK_ALL:
sexp_val = SEXP_TRUE;
sexp_turret_lock_all(node);
break;
case OP_TURRET_CHANGE_WEAPON:
sexp_val = SEXP_TRUE;
sexp_turret_change_weapon(node);
break;
case OP_TURRET_SET_TARGET_ORDER:
sexp_val = SEXP_TRUE;
sexp_turret_set_target_order(node);
break;
case OP_SHIP_TURRET_TARGET_ORDER:
sexp_val = SEXP_TRUE;
sexp_ship_turret_target_order(node);
break;
case OP_TURRET_SUBSYS_TARGET_DISABLE:
sexp_val = SEXP_TRUE;
sexp_turret_subsystem_targeting_disable(node);
break;
case OP_TURRET_SUBSYS_TARGET_ENABLE:
sexp_val = SEXP_TRUE;
sexp_turret_subsystem_targeting_enable(node);
break;
case OP_ADD_REMOVE_ESCORT:
sexp_val = SEXP_TRUE;
sexp_add_remove_escort(node);
break;
case OP_DAMAGED_ESCORT_LIST:
sexp_val = SEXP_TRUE;
sexp_damage_escort_list(node);
break;
case OP_DAMAGED_ESCORT_LIST_ALL:
sexp_val = SEXP_TRUE;
sexp_damage_escort_list_all(node);
break;
case OP_AWACS_SET_RADIUS:
sexp_val = SEXP_TRUE;
sexp_awacs_set_radius(node);
break;
case OP_PRIMITIVE_SENSORS_SET_RANGE:
sexp_primitive_sensors_set_range(node);
sexp_val = SEXP_TRUE;
break;
case OP_CAP_WAYPOINT_SPEED:
sexp_val = SEXP_TRUE;
sexp_cap_waypoint_speed(node);
break;
case OP_TURRET_TAGGED_ONLY_ALL:
sexp_val = SEXP_TRUE;
sexp_turret_tagged_only_all(node);
break;
case OP_TURRET_TAGGED_CLEAR_ALL:
sexp_val = SEXP_TRUE;
sexp_turret_tagged_clear_all(node);
break;
case OP_SUBSYS_SET_RANDOM:
sexp_val = SEXP_TRUE;
sexp_subsys_set_random(node);
break;
case OP_SUPERNOVA_START:
sexp_val = SEXP_TRUE;
sexp_supernova_start(node);
break;
case OP_SHIELD_RECHARGE_PCT:
sexp_val = sexp_shield_recharge_pct(node);
break;
case OP_ENGINE_RECHARGE_PCT:
sexp_val = sexp_engine_recharge_pct(node);
break;
case OP_WEAPON_RECHARGE_PCT:
sexp_val = sexp_weapon_recharge_pct(node);
break;
case OP_SHIELD_QUAD_LOW:
sexp_val = sexp_shield_quad_low(node);
break;
case OP_PRIMARY_AMMO_PCT:
sexp_val = sexp_primary_ammo_pct(node);
break;
case OP_SECONDARY_AMMO_PCT:
sexp_val = sexp_secondary_ammo_pct(node);
break;
// Karajorma
case OP_GET_PRIMARY_AMMO:
sexp_val = sexp_get_primary_ammo(node);
break;
// Karajorma
case OP_GET_SECONDARY_AMMO:
sexp_val = sexp_get_secondary_ammo(node);
break;
case OP_IS_SECONDARY_SELECTED:
sexp_val = sexp_is_secondary_selected(node);
break;
case OP_IS_PRIMARY_SELECTED:
sexp_val = sexp_is_primary_selected(node);
break;
// Goober5000
case OP_SET_SUPPORT_SHIP:
sexp_set_support_ship(node);
sexp_val = SEXP_TRUE;
break;
// Goober5000
case OP_CHANGE_SHIP_CLASS:
sexp_change_ship_class(node);
sexp_val = SEXP_TRUE;
break;
// Goober5000
case OP_SHIP_COPY_DAMAGE:
sexp_ship_copy_damage(node);
sexp_val = SEXP_TRUE;
break;
//-Bobboau
case OP_ACTIVATE_GLOW_POINTS:
case OP_DEACTIVATE_GLOW_POINTS:
sexp_activate_deactivate_glow_points(node, op_num == OP_ACTIVATE_GLOW_POINTS);
sexp_val = SEXP_TRUE;
break;
//-Bobboau
case OP_ACTIVATE_GLOW_MAPS:
case OP_DEACTIVATE_GLOW_MAPS:
sexp_activate_deactivate_glow_maps(node, op_num == OP_ACTIVATE_GLOW_MAPS);
sexp_val = SEXP_TRUE;
break;
//-Bobboau
case OP_ACTIVATE_GLOW_POINT_BANK:
case OP_DEACTIVATE_GLOW_POINT_BANK:
sexp_activate_deactivate_glow_point_bank(node, op_num == OP_ACTIVATE_GLOW_POINT_BANK);
sexp_val = SEXP_TRUE;
break;
// taylor
case OP_SET_SKYBOX_MODEL:
sexp_set_skybox_model(node);
sexp_val = SEXP_TRUE;
break;
case OP_TURRET_TAGGED_SPECIFIC:
sexp_turret_tagged_specific(node);
sexp_val = SEXP_TRUE;
break;
case OP_TURRET_TAGGED_CLEAR_SPECIFIC:
sexp_turret_tagged_clear_specific(node);
sexp_val = SEXP_TRUE;
break;
case OP_LOCK_ROTATING_SUBSYSTEM:
case OP_FREE_ROTATING_SUBSYSTEM:
sexp_set_subsys_rotation_lock(node, op_num == OP_LOCK_ROTATING_SUBSYSTEM);
sexp_val = SEXP_TRUE;
break;
case OP_REVERSE_ROTATING_SUBSYSTEM:
sexp_reverse_rotating_subsystem(node);
sexp_val = SEXP_TRUE;
break;
case OP_ROTATING_SUBSYS_SET_TURN_TIME:
sexp_rotating_subsys_set_turn_time(node);
sexp_val = SEXP_TRUE;
break;
// Karajorma
case OP_SET_PRIMARY_AMMO:
sexp_set_primary_ammo(node);
sexp_val = SEXP_TRUE;
break;
// Karajorma
case OP_SET_SECONDARY_AMMO:
sexp_set_secondary_ammo(node);
sexp_val = SEXP_TRUE;
break;
// Karajorma
case OP_SET_PRIMARY_WEAPON:
case OP_SET_SECONDARY_WEAPON:
sexp_set_weapon(node, op_num == OP_SET_PRIMARY_WEAPON);
sexp_val = SEXP_TRUE;
break;
// Karajorma
case OP_LOCK_PRIMARY_WEAPON:
case OP_UNLOCK_PRIMARY_WEAPON:
sexp_deal_with_primary_lock(node, op_num == OP_LOCK_PRIMARY_WEAPON);
sexp_val = SEXP_TRUE;
break;
case OP_LOCK_SECONDARY_WEAPON:
case OP_UNLOCK_SECONDARY_WEAPON:
sexp_deal_with_secondary_lock(node, op_num == OP_LOCK_SECONDARY_WEAPON);
sexp_val = SEXP_TRUE;
break;
// KeldorKatarn
case OP_LOCK_AFTERBURNER:
case OP_UNLOCK_AFTERBURNER:
sexp_deal_with_afterburner_lock(node, op_num == OP_LOCK_AFTERBURNER);
sexp_val = SEXP_TRUE;
break;
case OP_SET_AFTERBURNER_ENERGY:
case OP_SET_WEAPON_ENERGY:
case OP_SET_SHIELD_ENERGY:
sexp_set_energy_pct(node, op_num);
sexp_val = SEXP_TRUE;
break;
case OP_SET_AMBIENT_LIGHT:
sexp_set_ambient_light(node);
sexp_val = SEXP_TRUE;
break;
case OP_PRIMARY_FIRED_SINCE:
case OP_SECONDARY_FIRED_SINCE:
sexp_val = sexp_weapon_fired_delay(node, op_num);
break;
case OP_CHANGE_SUBSYSTEM_NAME:
sexp_change_subsystem_name(node);
sexp_val = SEXP_TRUE;
break;
case OP_NUM_SHIPS_IN_BATTLE: // phreak
sexp_val=sexp_num_ships_in_battle(node);
break;
// Karajorma
case OP_NUM_SHIPS_IN_WING:
sexp_val=sexp_num_ships_in_wing(node);
break;
case OP_CURRENT_SPEED:
sexp_val = sexp_current_speed(node);
break;
case OP_NAV_IS_VISITED: //kazan
sexp_val = is_nav_visited(node);
break;
case OP_NAV_DISTANCE: //kazan
sexp_val = distance_to_nav(node);
break;
case OP_NAV_ADD_WAYPOINT: //kazan
sexp_val = SEXP_TRUE;
add_nav_waypoint(node);
break;
case OP_NAV_ADD_SHIP: //kazan
sexp_val = SEXP_TRUE;
add_nav_ship(node);
break;
case OP_NAV_DEL: //kazan
sexp_val = SEXP_TRUE;
del_nav(node);
break;
case OP_NAV_HIDE: //kazan
sexp_val = SEXP_TRUE;
hide_nav(node);
break;
case OP_NAV_RESTRICT: //kazan
sexp_val = SEXP_TRUE;
restrict_nav(node);
break;
case OP_NAV_UNHIDE: //kazan
sexp_val = SEXP_TRUE;
unhide_nav(node);
break;
case OP_NAV_UNRESTRICT: //kazan
sexp_val = SEXP_TRUE;
unrestrict_nav(node);
break;
case OP_NAV_SET_VISITED: //kazan
sexp_val = SEXP_TRUE;
set_nav_visited(node);
break;
case OP_NAV_UNSET_VISITED: //kazan
sexp_val = SEXP_TRUE;
unset_nav_visited(node);
break;
case OP_NAV_SET_CARRY: //kazan
sexp_val = SEXP_TRUE;
set_nav_carry_status(node);
break;
case OP_NAV_UNSET_CARRY: //kazan
sexp_val = SEXP_TRUE;
unset_nav_carry_status(node);
break;
case OP_NAV_SET_NEEDSLINK:
sexp_val = SEXP_TRUE;
set_nav_needslink(node);
break;
case OP_NAV_UNSET_NEEDSLINK:
sexp_val = SEXP_TRUE;
unset_nav_needslink(node);
break;
case OP_NAV_ISLINKED:
sexp_val = is_nav_linked(node);
break;
case OP_NAV_USEAP:
sexp_val = SEXP_TRUE;
set_use_ap(node);
break;
case OP_NAV_USECINEMATICS:
sexp_val = SEXP_TRUE;
set_use_ap_cinematics(node);
break;
case OP_SCRAMBLE_MESSAGES:
case OP_UNSCRAMBLE_MESSAGES:
sexp_scramble_messages(op_num == OP_SCRAMBLE_MESSAGES );
sexp_val = SEXP_TRUE;
break;
case OP_CUTSCENES_SET_CUTSCENE_BARS:
sexp_val = SEXP_TRUE;
sexp_set_cutscene_bars(node);
break;
case OP_CUTSCENES_UNSET_CUTSCENE_BARS:
sexp_val = SEXP_TRUE;
sexp_unset_cutscene_bars(node);
break;
case OP_CUTSCENES_FADE_IN:
sexp_val = SEXP_TRUE;
sexp_fade_in(node);
break;
case OP_CUTSCENES_FADE_OUT:
sexp_val = SEXP_TRUE;
sexp_fade_out(node);
break;
case OP_CUTSCENES_SET_CAMERA:
sexp_val = SEXP_TRUE;
sexp_set_camera(node);
break;
case OP_CUTSCENES_SET_CAMERA_FACING:
sexp_val = SEXP_TRUE;
sexp_set_camera_facing(node);
break;
case OP_CUTSCENES_SET_CAMERA_FACING_OBJECT:
sexp_val = SEXP_TRUE;
sexp_set_camera_facing_object(node);
break;
case OP_CUTSCENES_SET_CAMERA_FOV:
sexp_val = SEXP_TRUE;
sexp_set_camera_fov(node);
break;
case OP_CUTSCENES_SET_CAMERA_HOST:
sexp_val = SEXP_TRUE;
sexp_set_camera_host(node);
break;
case OP_CUTSCENES_SET_CAMERA_POSITION:
sexp_val = SEXP_TRUE;
sexp_set_camera_position(node);
break;
case OP_CUTSCENES_SET_CAMERA_ROTATION:
sexp_val = SEXP_TRUE;
sexp_set_camera_rotation(node);
break;
case OP_CUTSCENES_SET_CAMERA_TARGET:
sexp_val = SEXP_TRUE;
sexp_set_camera_target(node);
break;
case OP_CUTSCENES_SET_FOV:
sexp_val = SEXP_TRUE;
sexp_set_fov(node);
break;
case OP_CUTSCENES_RESET_FOV:
sexp_val = SEXP_TRUE;
sexp_reset_fov();
break;
case OP_CUTSCENES_RESET_CAMERA:
sexp_val = SEXP_TRUE;
sexp_reset_camera(node);
break;
case OP_CUTSCENES_SHOW_SUBTITLE:
sexp_val = SEXP_TRUE;
sexp_show_subtitle(node);
break;
case OP_CUTSCENES_SET_TIME_COMPRESSION:
sexp_val = SEXP_TRUE;
sexp_set_time_compression(node);
break;
case OP_CUTSCENES_RESET_TIME_COMPRESSION:
sexp_val = SEXP_TRUE;
sexp_reset_time_compression();
break;
case OP_CUTSCENES_FORCE_PERSPECTIVE:
sexp_val = SEXP_TRUE;
sexp_force_perspective(node);
break;
case OP_SET_CAMERA_SHUDDER:
sexp_val = SEXP_TRUE;
sexp_set_camera_shudder(node);
break;
case OP_JUMP_NODE_SET_JUMPNODE_COLOR:
sexp_val = SEXP_TRUE;
sexp_set_jumpnode_color(node);
break;
case OP_JUMP_NODE_SET_JUMPNODE_MODEL:
sexp_val = SEXP_TRUE;
sexp_set_jumpnode_model(node);
break;
case OP_JUMP_NODE_SHOW_JUMPNODE:
sexp_val = SEXP_TRUE;
sexp_show_jumpnode(node);
break;
case OP_JUMP_NODE_HIDE_JUMPNODE:
sexp_val = SEXP_TRUE;
sexp_hide_jumpnode(node);
break;
case OP_SCRIPT_EVAL_NUM:
sexp_val = sexp_script_eval(node, OPR_NUMBER);
break;
case OP_SCRIPT_EVAL_STRING:
sexp_val = sexp_script_eval(node, OPR_STRING);
break;
case OP_SCRIPT_EVAL:
sexp_val = sexp_script_eval(node, OPR_NULL);
break;
case OP_CHANGE_IFF_COLOR:
sexp_change_iff_color(node);
sexp_val = SEXP_TRUE;
break;
default:
Error(LOCATION, "Looking for SEXP operator, found '%s'.\n", CTEXT(cur_node));
break;
}
Assert(!Current_sexp_operator.empty());
Current_sexp_operator.pop_back();
Assert(sexp_val != UNINITIALIZED);
// if we haven't returned, check the sexp value of the sexpression evaluation. A special
// value of known true or known false means that we should set the sexp.value field for
// short circuit eval (and return that special value as well).
if (sexp_val == SEXP_KNOWN_TRUE) {
Sexp_nodes[cur_node].value = SEXP_KNOWN_TRUE;
return SEXP_TRUE;
}
if (sexp_val == SEXP_KNOWN_FALSE) {
Sexp_nodes[cur_node].value = SEXP_KNOWN_FALSE;
return SEXP_FALSE;
}
if ( sexp_val == SEXP_NAN ) {
Sexp_nodes[cur_node].value = SEXP_NAN; // not a number values are false I would suspect
return SEXP_FALSE;
}
if ( sexp_val == SEXP_NAN_FOREVER ) {
Sexp_nodes[cur_node].value = SEXP_NAN_FOREVER;
return SEXP_FALSE; // Goober5000 changed from sexp_val to SEXP_FALSE on 2/21/2006 in accordance with above comment
}
if ( sexp_val == SEXP_CANT_EVAL ) {
Sexp_nodes[cur_node].value = SEXP_CANT_EVAL;
Sexp_useful_number = 0; // indicate sexp isn't current yet
return SEXP_FALSE;
}
if ( Sexp_nodes[cur_node].value == SEXP_NAN ) { // if we had a nan, but now don't, reset the value
Sexp_nodes[cur_node].value = SEXP_UNKNOWN;
return sexp_val;
}
// now, reconcile positive and negative - Goober5000
if (sexp_val < 0)
{
int parent_node = find_parent_operator(cur_node);
int arg_num = find_argnum(parent_node, cur_node);
// make sure everything works okay
if (arg_num == -1)
{
char sexp_text[4096];
convert_sexp_to_string(cur_node, sexp_text, SEXP_ERROR_CHECK_MODE, 4096);
Error(LOCATION, "Error finding sexp argument. Received value %d for sexp:\n%s", sexp_val, sexp_text);
}
// if we need a positive value, make it positive
if (query_operator_argument_type(get_operator_index(CTEXT(parent_node)), arg_num) == OPF_POSITIVE)
{
sexp_val *= -1;
}
}
if ( sexp_val ){
Sexp_nodes[cur_node].value = SEXP_TRUE;
} else {
Sexp_nodes[cur_node].value = SEXP_FALSE;
}
return sexp_val;
}
}
void multi_sexp_eval()
{
int op_num;
Assert (MULTIPLAYER_CLIENT);
while (Multi_sexp_bytes_left > 0) {
op_num = multi_sexp_get_next_operator();
Assert (Multi_sexp_bytes_left);
if (op_num < 0) {
Warning(LOCATION, "Received invalid SEXP packet from host. Entire packet may be corrupt. Discarding packet");
Int3();
return;
}
switch(op_num) {
case OP_CHANGE_SOUNDTRACK:
multi_sexp_change_soundtrack();
break;
case OP_SET_PERSONA:
multi_sexp_set_persona();
break;
case OP_CHANGE_SUBSYSTEM_NAME:
multi_sexp_change_subsystem_name();
break;
case OP_SET_RESPAWNS:
multi_sexp_set_respawns();
break;
case OP_CHANGE_SHIP_CLASS:
multi_sexp_change_ship_class();
break;
case OP_PLAY_SOUND_FROM_TABLE:
multi_sexp_play_sound_from_table();
break;
case OP_PLAY_SOUND_FROM_FILE:
multi_sexp_play_sound_from_file();
break;
case OP_CLOSE_SOUND_FROM_FILE:
multi_sexp_close_sound_from_file();
break;
case OP_SHIP_BOMB_TARGETABLE:
case OP_SHIP_BOMB_UNTARGETABLE:
case OP_SHIP_INVISIBLE:
case OP_SHIP_VISIBLE:
case OP_SHIP_STEALTHY:
case OP_SHIP_UNSTEALTHY:
case OP_FRIENDLY_STEALTH_INVISIBLE:
case OP_FRIENDLY_STEALTH_VISIBLE:
case OP_LOCK_AFTERBURNER:
case OP_UNLOCK_AFTERBURNER:
case OP_LOCK_PRIMARY_WEAPON:
case OP_UNLOCK_PRIMARY_WEAPON:
case OP_LOCK_SECONDARY_WEAPON:
case OP_UNLOCK_SECONDARY_WEAPON:
multi_sexp_deal_with_ship_flag();
break;
case OP_SET_AFTERBURNER_ENERGY:
multi_sexp_set_energy_pct();
break;
case OP_SET_AMBIENT_LIGHT:
multi_sexp_set_ambient_light();
break;
case OP_MODIFY_VARIABLE:
multi_sexp_modify_variable();
break;
// bad sexp in the packet
default:
// probably just a version error where the host supports a SEXP but a client does not
if (multi_sexp_discard_operator()) {
Warning(LOCATION, "Received invalid SEXP operator number from host. Operator number %d is not supported by this version.", op_num);
}
// a more major problem
else {
Warning(LOCATION, "Received invalid SEXP packet from host. Function involving operator %d lacks termination. Entire packet may be corrupt. Discarding remaining packet");
Int3();
return;
}
}
}
}
// Still a debug-level system.
// get_sexp_main reads and builds the internal representation for a
// symbolic expression.
// On entry:
// Mp points at first character in expression.
// The symbolic expression is built in Sexp_nodes beginning at node 0.
int get_sexp_main()
{
int start_node, op;
char token[TOKEN_LENGTH];
char *savep, ch;
ignore_white_space();
savep = Mp;
if (!strncmp(Mp, "( )", 3))
savep++;
Assert(*Mp == '(');
Mp++;
start_node = get_sexp(token);
// only need to check syntax if we have a operator
if ( /*Sexp_nodes[start_node].subtype != SEXP_ATOM_OPERATOR ||*/ Fred_running || (start_node == -1))
return start_node;
ch = *Mp;
*Mp = '\0';
op = get_operator_index(CTEXT(start_node));
if (op == -1)
Error (LOCATION, "Can't find operator %s in operator list\n.", CTEXT(start_node) );
*Mp = ch;
return start_node;
}
void test_sexps()
{
Mp = Mission_text;
while (*Mp != '#') {
get_sexp_main();
diag_printf("\n----------------\n");
ignore_white_space();
}
exit(0);
}
// returns the data type returned by an operator
int query_operator_return_type(int op)
{
if (op < FIRST_OP)
{
Assert(op >= 0 && op < Num_operators);
op = Operators[op].value;
}
switch (op)
{
case OP_TRUE:
case OP_FALSE:
case OP_AND:
case OP_AND_IN_SEQUENCE:
case OP_OR:
case OP_NOT:
case OP_EQUALS:
case OP_GREATER_THAN:
case OP_LESS_THAN:
case OP_STRING_EQUALS:
case OP_STRING_GREATER_THAN:
case OP_STRING_LESS_THAN:
case OP_IS_DESTROYED:
case OP_IS_SUBSYSTEM_DESTROYED:
case OP_IS_DISABLED:
case OP_IS_DISARMED:
case OP_HAS_DOCKED:
case OP_HAS_UNDOCKED:
case OP_HAS_ARRIVED:
case OP_HAS_DEPARTED:
case OP_IS_DESTROYED_DELAY:
case OP_IS_SUBSYSTEM_DESTROYED_DELAY:
case OP_IS_DISABLED_DELAY:
case OP_IS_DISARMED_DELAY:
case OP_HAS_DOCKED_DELAY:
case OP_HAS_UNDOCKED_DELAY:
case OP_HAS_ARRIVED_DELAY:
case OP_HAS_DEPARTED_DELAY:
case OP_IS_IFF:
case OP_IS_AI_CLASS:
case OP_IS_SHIP_TYPE:
case OP_IS_SHIP_CLASS:
case OP_HAS_TIME_ELAPSED:
case OP_GOAL_INCOMPLETE:
case OP_GOAL_TRUE_DELAY:
case OP_GOAL_FALSE_DELAY:
case OP_EVENT_INCOMPLETE:
case OP_EVENT_TRUE_DELAY:
case OP_EVENT_FALSE_DELAY:
case OP_PREVIOUS_EVENT_TRUE:
case OP_PREVIOUS_EVENT_FALSE:
case OP_PREVIOUS_EVENT_INCOMPLETE:
case OP_PREVIOUS_GOAL_TRUE:
case OP_PREVIOUS_GOAL_FALSE:
case OP_PREVIOUS_GOAL_INCOMPLETE:
case OP_WAYPOINTS_DONE:
case OP_WAYPOINTS_DONE_DELAY:
case OP_SHIP_TYPE_DESTROYED:
case OP_LAST_ORDER_TIME:
case OP_KEY_PRESSED:
case OP_TARGETED:
case OP_SPEED:
case OP_FACING:
case OP_FACING2:
case OP_ORDER:
case OP_QUERY_ORDERS:
case OP_WAYPOINT_MISSED:
case OP_WAYPOINT_TWICE:
case OP_PATH_FLOWN:
case OP_EVENT_TRUE:
case OP_EVENT_FALSE:
case OP_SKILL_LEVEL_AT_LEAST:
case OP_IS_CARGO_KNOWN:
case OP_HAS_BEEN_TAGGED_DELAY:
case OP_CAP_SUBSYS_CARGO_KNOWN_DELAY:
case OP_CARGO_KNOWN_DELAY:
case OP_WAS_PROMOTION_GRANTED:
case OP_WAS_MEDAL_GRANTED:
case OP_PERCENT_SHIPS_DEPARTED:
case OP_PERCENT_SHIPS_DESTROYED:
case OP_PERCENT_SHIPS_DISARMED:
case OP_PERCENT_SHIPS_DISABLED:
case OP_DEPART_NODE_DELAY:
case OP_DESTROYED_DEPARTED_DELAY:
case OP_SPECIAL_CHECK:
case OP_IS_TAGGED:
case OP_PRIMARIES_DEPLETED:
case OP_SECONDARIES_DEPLETED:
case OP_SHIELD_QUAD_LOW:
case OP_IS_SECONDARY_SELECTED:
case OP_IS_PRIMARY_SELECTED:
case OP_IS_SHIP_STEALTHY:
case OP_IS_FRIENDLY_STEALTH_VISIBLE:
case OP_IS_CARGO:
case OP_MISSILE_LOCKED:
case OP_NAV_IS_VISITED:
case OP_NAV_ISLINKED:
case OP_IS_PLAYER:
case OP_PRIMARY_FIRED_SINCE:
case OP_SECONDARY_FIRED_SINCE:
return OPR_BOOL;
case OP_PLUS:
case OP_MINUS:
case OP_MOD:
case OP_MUL:
case OP_DIV:
case OP_RAND:
case OP_RAND_MULTIPLE:
case OP_MIN:
case OP_MAX:
case OP_AVG:
case OP_GET_OBJECT_X:
case OP_GET_OBJECT_Y:
case OP_GET_OBJECT_Z:
case OP_SCRIPT_EVAL_NUM:
case OP_SCRIPT_EVAL_STRING:
case OP_STRING_TO_INT:
return OPR_NUMBER;
case OP_ABS:
case OP_TIME_SHIP_DESTROYED:
case OP_TIME_SHIP_ARRIVED:
case OP_TIME_SHIP_DEPARTED:
case OP_TIME_WING_DESTROYED:
case OP_TIME_WING_ARRIVED:
case OP_TIME_WING_DEPARTED:
case OP_MISSION_TIME:
case OP_TIME_DOCKED:
case OP_TIME_UNDOCKED:
case OP_AFTERBURNER_LEFT:
case OP_WEAPON_ENERGY_LEFT:
case OP_SHIELDS_LEFT:
case OP_HITS_LEFT:
case OP_HITS_LEFT_SUBSYSTEM:
case OP_SIM_HITS_LEFT:
case OP_DISTANCE:
case OP_DISTANCE_SUBSYSTEM:
case OP_NUM_WITHIN_BOX:
case OP_NUM_PLAYERS:
case OP_NUM_KILLS:
case OP_NUM_ASSISTS:
case OP_SHIP_DEATHS:
case OP_RESPAWNS_LEFT:
case OP_SHIP_SCORE:
case OP_NUM_TYPE_KILLS:
case OP_NUM_CLASS_KILLS:
case OP_SHIELD_RECHARGE_PCT:
case OP_ENGINE_RECHARGE_PCT:
case OP_WEAPON_RECHARGE_PCT:
case OP_PRIMARY_AMMO_PCT:
case OP_SECONDARY_AMMO_PCT:
case OP_GET_PRIMARY_AMMO:
case OP_GET_SECONDARY_AMMO:
case OP_SPECIAL_WARP_DISTANCE:
case OP_IS_SHIP_VISIBLE:
case OP_TEAM_SCORE:
case OP_NUM_SHIPS_IN_BATTLE:
case OP_NUM_SHIPS_IN_WING:
case OP_CURRENT_SPEED:
case OP_NAV_DISTANCE:
case OP_GET_DAMAGE_CAUSED:
return OPR_POSITIVE;
case OP_COND:
case OP_WHEN:
case OP_WHEN_ARGUMENT:
case OP_EVERY_TIME:
case OP_EVERY_TIME_ARGUMENT:
case OP_INVALIDATE_ARGUMENT:
case OP_VALIDATE_ARGUMENT:
case OP_DO_FOR_VALID_ARGUMENTS:
case OP_CHANGE_IFF:
case OP_CHANGE_AI_CLASS:
case OP_CLEAR_SHIP_GOALS:
case OP_CLEAR_WING_GOALS:
case OP_CLEAR_GOALS:
case OP_ADD_SHIP_GOAL:
case OP_ADD_WING_GOAL:
case OP_ADD_GOAL:
case OP_REMOVE_GOAL:
case OP_PROTECT_SHIP:
case OP_UNPROTECT_SHIP:
case OP_BEAM_PROTECT_SHIP:
case OP_BEAM_UNPROTECT_SHIP:
/* case OP_INT3: */
case OP_NOP:
case OP_GOALS_ID:
case OP_SEND_MESSAGE:
case OP_SELF_DESTRUCT:
case OP_NEXT_MISSION:
case OP_END_CAMPAIGN:
case OP_END_OF_CAMPAIGN:
case OP_SABOTAGE_SUBSYSTEM:
case OP_REPAIR_SUBSYSTEM:
case OP_INVALIDATE_GOAL:
case OP_VALIDATE_GOAL:
case OP_SEND_RANDOM_MESSAGE:
case OP_TRANSFER_CARGO:
case OP_EXCHANGE_CARGO:
case OP_SET_CARGO:
case OP_JETTISON_CARGO:
case OP_CARGO_NO_DEPLETE:
case OP_SET_SCANNED:
case OP_SET_UNSCANNED:
case OP_KEY_RESET:
case OP_KEY_RESET_MULTIPLE:
case OP_TRAINING_MSG:
case OP_SET_TRAINING_CONTEXT_FLY_PATH:
case OP_SET_TRAINING_CONTEXT_SPEED:
case OP_END_MISSION:
case OP_FORCE_JUMP:
case OP_SET_SUBSYSTEM_STRNGTH:
case OP_GOOD_REARM_TIME:
case OP_GRANT_PROMOTION:
case OP_GRANT_MEDAL:
case OP_ALLOW_SHIP:
case OP_ALLOW_WEAPON:
case OP_TECH_ADD_SHIP:
case OP_TECH_ADD_WEAPON:
case OP_TECH_ADD_INTEL:
case OP_TECH_RESET_TO_DEFAULT:
case OP_CHANGE_PLAYER_SCORE:
case OP_CHANGE_TEAM_SCORE:
case OP_WARP_BROKEN:
case OP_WARP_NOT_BROKEN:
case OP_WARP_NEVER:
case OP_WARP_ALLOWED:
case OP_FLASH_HUD_GAUGE:
case OP_GOOD_SECONDARY_TIME:
case OP_SHIP_VISIBLE:
case OP_SHIP_INVISIBLE:
case OP_SHIP_TAG:
case OP_SHIP_UNTAG:
case OP_SHIP_VULNERABLE:
case OP_SHIP_INVULNERABLE:
case OP_SHIP_BOMB_TARGETABLE:
case OP_SHIP_BOMB_UNTARGETABLE:
case OP_SHIP_GUARDIAN:
case OP_SHIP_NO_GUARDIAN:
case OP_SHIP_GUARDIAN_THRESHOLD:
case OP_SHIP_SUBSYS_GUARDIAN_THRESHOLD:
case OP_SHIP_VANISH:
case OP_SHIELDS_ON:
case OP_SHIELDS_OFF:
case OP_SHIP_STEALTHY:
case OP_SHIP_UNSTEALTHY:
case OP_FRIENDLY_STEALTH_INVISIBLE:
case OP_FRIENDLY_STEALTH_VISIBLE:
case OP_SHIP_SUBSYS_TARGETABLE:
case OP_SHIP_SUBSYS_UNTARGETABLE:
case OP_RED_ALERT:
case OP_MODIFY_VARIABLE:
case OP_BEAM_FIRE:
case OP_BEAM_FREE:
case OP_BEAM_FREE_ALL:
case OP_BEAM_LOCK:
case OP_BEAM_LOCK_ALL:
case OP_TURRET_FREE:
case OP_TURRET_FREE_ALL:
case OP_TURRET_LOCK:
case OP_TURRET_LOCK_ALL:
case OP_TURRET_CHANGE_WEAPON:
case OP_TURRET_SET_TARGET_ORDER:
case OP_SHIP_TURRET_TARGET_ORDER:
case OP_TURRET_SUBSYS_TARGET_DISABLE:
case OP_TURRET_SUBSYS_TARGET_ENABLE:
case OP_ADD_REMOVE_ESCORT:
case OP_DAMAGED_ESCORT_LIST:
case OP_DAMAGED_ESCORT_LIST_ALL:
case OP_AWACS_SET_RADIUS:
case OP_PRIMITIVE_SENSORS_SET_RANGE:
case OP_SEND_MESSAGE_LIST:
case OP_CAP_WAYPOINT_SPEED:
case OP_TURRET_TAGGED_ONLY_ALL:
case OP_TURRET_TAGGED_CLEAR_ALL:
case OP_SUBSYS_SET_RANDOM:
case OP_SUPERNOVA_START:
case OP_SET_SPECIAL_WARPOUT_NAME:
case OP_SHIP_VAPORIZE:
case OP_SHIP_NO_VAPORIZE:
case OP_DONT_COLLIDE_INVISIBLE:
case OP_COLLIDE_INVISIBLE:
case OP_CHANGE_SHIP_CLASS:
case OP_SHIP_COPY_DAMAGE:
case OP_DEACTIVATE_GLOW_POINTS:
case OP_ACTIVATE_GLOW_POINTS:
case OP_DEACTIVATE_GLOW_MAPS:
case OP_ACTIVATE_GLOW_MAPS:
case OP_DEACTIVATE_GLOW_POINT_BANK:
case OP_ACTIVATE_GLOW_POINT_BANK:
case OP_SET_SKYBOX_MODEL:
case OP_SET_SUPPORT_SHIP:
case OP_CHANGE_SOUNDTRACK:
case OP_PLAY_SOUND_FROM_FILE:
case OP_CLOSE_SOUND_FROM_FILE:
case OP_PLAY_SOUND_FROM_TABLE:
case OP_EXPLOSION_EFFECT:
case OP_WARP_EFFECT:
case OP_SET_OBJECT_POSITION:
case OP_SET_OBJECT_FACING:
case OP_SET_OBJECT_FACING_OBJECT:
case OP_HUD_DISABLE:
case OP_HUD_DISABLE_EXCEPT_MESSAGES:
case OP_KAMIKAZE:
case OP_NOT_KAMIKAZE:
case OP_TURRET_TAGGED_SPECIFIC:
case OP_TURRET_TAGGED_CLEAR_SPECIFIC:
case OP_LOCK_ROTATING_SUBSYSTEM:
case OP_FREE_ROTATING_SUBSYSTEM:
case OP_REVERSE_ROTATING_SUBSYSTEM:
case OP_ROTATING_SUBSYS_SET_TURN_TIME:
case OP_PLAYER_USE_AI:
case OP_PLAYER_NOT_USE_AI:
case OP_ALLOW_TREASON:
case OP_NAV_ADD_WAYPOINT:
case OP_NAV_ADD_SHIP:
case OP_NAV_DEL:
case OP_NAV_HIDE:
case OP_NAV_RESTRICT:
case OP_NAV_UNHIDE:
case OP_NAV_UNRESTRICT:
case OP_NAV_SET_VISITED:
case OP_NAV_UNSET_VISITED:
case OP_NAV_SET_CARRY:
case OP_NAV_UNSET_CARRY:
case OP_NAV_SET_NEEDSLINK:
case OP_NAV_UNSET_NEEDSLINK:
case OP_NAV_USECINEMATICS:
case OP_NAV_USEAP:
case OP_HUD_SET_TEXT:
case OP_HUD_SET_TEXT_NUM:
case OP_HUD_SET_COORDS:
case OP_HUD_SET_FRAME:
case OP_HUD_SET_COLOR:
case OP_HUD_SET_MAX_TARGETING_RANGE:
case OP_SHIP_CHANGE_ALT_NAME:
case OP_SET_DEATH_MESSAGE:
case OP_SCRAMBLE_MESSAGES:
case OP_UNSCRAMBLE_MESSAGES:
case OP_CUTSCENES_SET_CUTSCENE_BARS:
case OP_CUTSCENES_UNSET_CUTSCENE_BARS:
case OP_CUTSCENES_FADE_IN:
case OP_CUTSCENES_FADE_OUT:
case OP_CUTSCENES_SET_CAMERA:
case OP_CUTSCENES_SET_CAMERA_FACING:
case OP_CUTSCENES_SET_CAMERA_FACING_OBJECT:
case OP_CUTSCENES_SET_CAMERA_FOV:
case OP_CUTSCENES_SET_CAMERA_HOST:
case OP_CUTSCENES_SET_CAMERA_POSITION:
case OP_CUTSCENES_SET_CAMERA_ROTATION:
case OP_CUTSCENES_SET_CAMERA_TARGET:
case OP_CUTSCENES_SET_FOV:
case OP_CUTSCENES_RESET_FOV:
case OP_CUTSCENES_RESET_CAMERA:
case OP_CUTSCENES_SHOW_SUBTITLE:
case OP_CUTSCENES_SET_TIME_COMPRESSION:
case OP_CUTSCENES_RESET_TIME_COMPRESSION:
case OP_CUTSCENES_FORCE_PERSPECTIVE:
case OP_SET_CAMERA_SHUDDER:
case OP_JUMP_NODE_SET_JUMPNODE_COLOR:
case OP_JUMP_NODE_SET_JUMPNODE_MODEL:
case OP_JUMP_NODE_SHOW_JUMPNODE:
case OP_JUMP_NODE_HIDE_JUMPNODE:
case OP_SET_OBJECT_SPEED_X:
case OP_SET_OBJECT_SPEED_Y:
case OP_SET_OBJECT_SPEED_Z:
case OP_SHIP_CREATE:
case OP_WEAPON_CREATE:
case OP_MISSION_SET_NEBULA:
case OP_ADD_BACKGROUND_BITMAP:
case OP_REMOVE_BACKGROUND_BITMAP:
case OP_ADD_SUN_BITMAP:
case OP_REMOVE_SUN_BITMAP:
case OP_NEBULA_CHANGE_STORM:
case OP_NEBULA_TOGGLE_POOF:
case OP_SET_PRIMARY_AMMO:
case OP_SET_SECONDARY_AMMO:
case OP_SET_PRIMARY_WEAPON:
case OP_SET_SECONDARY_WEAPON:
case OP_SCRIPT_EVAL:
case OP_ENABLE_BUILTIN_MESSAGES:
case OP_DISABLE_BUILTIN_MESSAGES:
case OP_LOCK_PRIMARY_WEAPON:
case OP_UNLOCK_PRIMARY_WEAPON:
case OP_LOCK_SECONDARY_WEAPON:
case OP_UNLOCK_SECONDARY_WEAPON:
case OP_LOCK_AFTERBURNER:
case OP_UNLOCK_AFTERBURNER:
case OP_RESET_ORDERS:
case OP_SET_PERSONA:
case OP_CHANGE_SUBSYSTEM_NAME:
case OP_SET_RESPAWNS:
case OP_SET_AFTERBURNER_ENERGY:
case OP_SET_WEAPON_ENERGY:
case OP_SET_SHIELD_ENERGY:
case OP_SET_AMBIENT_LIGHT:
case OP_CHANGE_IFF_COLOR:
return OPR_NULL;
case OP_AI_CHASE:
case OP_AI_DOCK:
case OP_AI_UNDOCK:
case OP_AI_WARP: // this particular operator is obsolete
case OP_AI_WARP_OUT:
case OP_AI_WAYPOINTS:
case OP_AI_WAYPOINTS_ONCE:
case OP_AI_DESTROY_SUBSYS:
case OP_AI_CHASE_WING:
case OP_AI_DISABLE_SHIP:
case OP_AI_DISARM_SHIP:
case OP_AI_GUARD:
case OP_AI_GUARD_WING:
case OP_AI_CHASE_ANY:
case OP_AI_EVADE_SHIP:
case OP_AI_STAY_NEAR_SHIP:
case OP_AI_KEEP_SAFE_DISTANCE:
case OP_AI_IGNORE:
case OP_AI_IGNORE_NEW:
case OP_AI_STAY_STILL:
case OP_AI_PLAY_DEAD:
return OPR_AI_GOAL;
case OP_ANY_OF:
case OP_EVERY_OF:
case OP_RANDOM_OF:
case OP_RANDOM_MULTIPLE_OF:
case OP_NUMBER_OF:
case OP_IN_SEQUENCE:
return OPR_FLEXIBLE_ARGUMENT;
default:
Int3();
}
return 0;
}
// returns the data type of a specified argument to an operator. Argnum is 0 indexed.
int query_operator_argument_type(int op, int argnum)
{
int index = op;
if (op < FIRST_OP)
{
Assert(index >= 0 && index < Num_operators);
op = Operators[index].value;
} else {
Warning(LOCATION, "Possible unnecessary search for operator index. Trace out and see if this is necessary.\n");
for (index=0; index<Num_operators; index++)
if (Operators[index].value == op)
break;
Assert(index < Num_operators);
}
if (argnum >= Operators[index].max)
return OPF_NONE;
switch (op) {
case OP_TRUE:
case OP_FALSE:
case OP_MISSION_TIME:
/* case OP_INT3: */
case OP_NOP:
case OP_WAYPOINT_MISSED:
case OP_WAYPOINT_TWICE:
case OP_PATH_FLOWN:
case OP_GRANT_PROMOTION:
case OP_WAS_PROMOTION_GRANTED:
case OP_RED_ALERT:
case OP_END_MISSION:
case OP_FORCE_JUMP:
case OP_RESET_ORDERS:
return OPF_NONE;
case OP_AND:
case OP_AND_IN_SEQUENCE:
case OP_OR:
case OP_NOT:
return OPF_BOOL;
case OP_PLUS:
case OP_MINUS:
case OP_MOD:
case OP_MUL:
case OP_DIV:
case OP_EQUALS:
case OP_GREATER_THAN:
case OP_LESS_THAN:
case OP_RAND:
case OP_RAND_MULTIPLE:
case OP_ABS:
case OP_MIN:
case OP_MAX:
case OP_AVG:
return OPF_NUMBER;
case OP_STRING_EQUALS:
case OP_STRING_GREATER_THAN:
case OP_STRING_LESS_THAN:
case OP_STRING_TO_INT: // Karajorma
return OPF_STRING;
case OP_HAS_TIME_ELAPSED:
case OP_SPEED:
case OP_SET_TRAINING_CONTEXT_SPEED:
case OP_SPECIAL_CHECK:
case OP_AI_WARP_OUT:
case OP_TEAM_SCORE:
case OP_HUD_SET_MAX_TARGETING_RANGE:
case OP_MISSION_SET_NEBULA: //WMC
return OPF_POSITIVE;
case OP_AI_WARP: // this operator is obsolete
case OP_SET_TRAINING_CONTEXT_FLY_PATH:
if ( !argnum )
return OPF_WAYPOINT_PATH;
else
return OPF_NUMBER;
case OP_AI_WAYPOINTS:
case OP_AI_WAYPOINTS_ONCE:
if ( argnum == 0 )
return OPF_WAYPOINT_PATH;
else
return OPF_POSITIVE;
case OP_IS_DISABLED:
case OP_IS_DISARMED:
case OP_TIME_SHIP_DESTROYED:
case OP_TIME_SHIP_ARRIVED:
case OP_TIME_SHIP_DEPARTED:
case OP_AFTERBURNER_LEFT:
case OP_WEAPON_ENERGY_LEFT:
case OP_SHIELDS_LEFT:
case OP_HITS_LEFT:
case OP_SIM_HITS_LEFT:
case OP_CLEAR_SHIP_GOALS:
case OP_PROTECT_SHIP:
case OP_UNPROTECT_SHIP:
case OP_BEAM_PROTECT_SHIP:
case OP_BEAM_UNPROTECT_SHIP:
case OP_TRANSFER_CARGO:
case OP_EXCHANGE_CARGO:
case OP_SHIP_INVISIBLE:
case OP_SHIP_VISIBLE:
case OP_SHIP_INVULNERABLE:
case OP_SHIP_VULNERABLE:
case OP_SHIP_BOMB_TARGETABLE:
case OP_SHIP_BOMB_UNTARGETABLE:
case OP_SHIP_GUARDIAN:
case OP_SHIP_NO_GUARDIAN:
case OP_SHIP_VANISH:
case OP_SHIELDS_ON:
case OP_SHIELDS_OFF:
case OP_SHIP_STEALTHY:
case OP_SHIP_UNSTEALTHY:
case OP_FRIENDLY_STEALTH_INVISIBLE:
case OP_FRIENDLY_STEALTH_VISIBLE:
case OP_PRIMARIES_DEPLETED:
case OP_SECONDARIES_DEPLETED:
case OP_SPECIAL_WARP_DISTANCE:
case OP_SET_SPECIAL_WARPOUT_NAME:
case OP_IS_SHIP_VISIBLE:
case OP_IS_SHIP_STEALTHY:
case OP_IS_FRIENDLY_STEALTH_VISIBLE:
case OP_GET_DAMAGE_CAUSED:
return OPF_SHIP;
case OP_SHIP_CREATE:
if(argnum == 0)
return OPF_STRING;
else if(argnum == 1)
return OPF_SHIP_CLASS_NAME;
else
return OPF_NUMBER;
case OP_WEAPON_CREATE:
if (argnum == 0)
return OPF_SHIP_OR_NONE;
else if (argnum == 1)
return OPF_WEAPON_NAME;
else if (argnum == 8)
return OPF_SHIP;
else if (argnum == 9)
return OPF_SUBSYSTEM;
else
return OPF_NUMBER;
case OP_SHIP_GUARDIAN_THRESHOLD:
if (argnum == 0)
return OPF_POSITIVE;
else
return OPF_SHIP;
case OP_SHIP_SUBSYS_GUARDIAN_THRESHOLD:
if (argnum == 0)
return OPF_POSITIVE;
else if (argnum == 1)
return OPF_SHIP;
else
return OPF_SUBSYS_OR_GENERIC;
case OP_SHIP_SUBSYS_TARGETABLE:
case OP_SHIP_SUBSYS_UNTARGETABLE:
if (argnum == 0)
return OPF_SHIP;
else
return OPF_SUBSYS_OR_GENERIC;
case OP_IS_DESTROYED:
case OP_HAS_ARRIVED:
case OP_HAS_DEPARTED:
case OP_CLEAR_GOALS:
return OPF_SHIP_WING;
case OP_IS_DISABLED_DELAY:
case OP_IS_DISARMED_DELAY:
if ( argnum == 0 )
return OPF_POSITIVE;
else
return OPF_SHIP;
case OP_SHIP_TAG:
if (argnum == 0)
return OPF_SHIP;
else if (argnum == 7)
return OPF_IFF;
else
return OPF_POSITIVE;
case OP_SHIP_UNTAG:
return OPF_SHIP;
case OP_FACING:
if (argnum == 0)
return OPF_SHIP;
else
return OPF_POSITIVE;
case OP_FACING2:
if (argnum == 0) {
return OPF_WAYPOINT_PATH;
} else {
return OPF_POSITIVE;
}
case OP_ORDER:
if (argnum == 1)
return OPF_AI_ORDER;
else
return OPF_SHIP_WING; // arg 0 or 2
case OP_QUERY_ORDERS:
if (argnum == 0)
return OPF_ORDER_RECIPIENT;
if (argnum == 1)
return OPF_AI_ORDER;
if (argnum == 2)
return OPF_POSITIVE;
if (argnum == 5)
return OPF_SUBSYSTEM;
else
return OPF_SHIP_WING;
case OP_IS_DESTROYED_DELAY:
case OP_HAS_ARRIVED_DELAY:
case OP_HAS_DEPARTED_DELAY:
case OP_LAST_ORDER_TIME:
if ( argnum == 0 )
return OPF_POSITIVE;
else
return OPF_SHIP_WING;
case OP_SHIP_CHANGE_ALT_NAME:
if (argnum == 0)
return OPF_STRING;
else
return OPF_SHIP_WING;
case OP_SET_DEATH_MESSAGE:
if (argnum == 0)
return OPF_STRING;
case OP_DISTANCE:
return OPF_SHIP_WING_POINT;
case OP_SET_OBJECT_SPEED_X:
case OP_SET_OBJECT_SPEED_Y:
case OP_SET_OBJECT_SPEED_Z:
if (argnum == 0)
return OPF_SHIP_WING_POINT;
else if (argnum == 1)
return OPF_NUMBER;
else
return OPF_BOOL;
case OP_GET_OBJECT_X:
case OP_GET_OBJECT_Y:
case OP_GET_OBJECT_Z:
if (argnum == 0)
return OPF_SHIP_WING_POINT;
else if (argnum == 1)
return OPF_SUBSYSTEM_OR_NONE;
else
return OPF_NUMBER;
case OP_SET_OBJECT_POSITION:
if(argnum==0)
return OPF_SHIP_WING_POINT;
else
return OPF_NUMBER;
case OP_SET_OBJECT_FACING:
if (argnum == 0)
return OPF_SHIP_WING_POINT;
else if (argnum < 4)
return OPF_NUMBER;
else
return OPF_POSITIVE;
case OP_SET_OBJECT_FACING_OBJECT:
if (argnum == 0 || argnum == 1)
return OPF_SHIP_WING_POINT;
else
return OPF_POSITIVE;
case OP_MODIFY_VARIABLE:
if (argnum == 0) {
return OPF_VARIABLE_NAME;
} else {
return OPF_AMBIGUOUS;
}
case OP_HAS_DOCKED:
case OP_HAS_UNDOCKED:
case OP_HAS_DOCKED_DELAY:
case OP_HAS_UNDOCKED_DELAY:
case OP_TIME_DOCKED:
case OP_TIME_UNDOCKED:
if ( argnum < 2 )
return OPF_SHIP;
else
return OPF_POSITIVE;
case OP_TIME_WING_DESTROYED:
case OP_TIME_WING_ARRIVED:
case OP_TIME_WING_DEPARTED:
case OP_CLEAR_WING_GOALS:
return OPF_WING;
case OP_SET_SCANNED:
case OP_SET_UNSCANNED:
case OP_IS_SUBSYSTEM_DESTROYED:
if (!argnum)
return OPF_SHIP;
else
return OPF_SUBSYSTEM;
case OP_HITS_LEFT_SUBSYSTEM:
if (argnum == 0)
return OPF_SHIP;
else if (argnum == 1)
return OPF_SUBSYSTEM;
else
return OPF_BOOL;
case OP_DISTANCE_SUBSYSTEM:
if (argnum == 0)
return OPF_SHIP_WING_POINT;
else if (argnum == 1)
return OPF_SHIP;
else if (argnum == 2)
return OPF_SUBSYSTEM;
else
Int3(); // shouldn't happen
case OP_NUM_WITHIN_BOX:
if(argnum < 3)
return OPF_NUMBER;
else if(argnum < 6)
return OPF_POSITIVE;
else
return OPF_SHIP_WING;
// Sesquipedalian
case OP_MISSILE_LOCKED:
if (argnum == 0)
return OPF_POSITIVE;
else if (argnum == 1)
return OPF_SHIP;
else
return OPF_SUBSYSTEM;
case OP_TARGETED:
if (!argnum)
return OPF_SHIP;
else if (argnum == 1)
return OPF_POSITIVE;
else
return OPF_SUBSYSTEM;
case OP_IS_SUBSYSTEM_DESTROYED_DELAY:
if ( argnum == 0 )
return OPF_SHIP;
else if ( argnum == 1 )
return OPF_SUBSYSTEM;
else
return OPF_POSITIVE;
case OP_IS_IFF:
case OP_CHANGE_IFF:
if (!argnum)
return OPF_IFF;
else
return OPF_SHIP_WING;
case OP_ADD_SHIP_GOAL:
if (!argnum)
return OPF_SHIP;
else
return OPF_AI_GOAL;
case OP_ADD_WING_GOAL:
if (!argnum)
return OPF_WING;
else
return OPF_AI_GOAL;
case OP_ADD_GOAL:
case OP_REMOVE_GOAL:
if ( argnum == 0 )
return OPF_SHIP_WING;
else
return OPF_AI_GOAL;
case OP_COND:
case OP_WHEN:
case OP_EVERY_TIME:
if (!argnum)
return OPF_BOOL;
else
return OPF_NULL;
case OP_WHEN_ARGUMENT:
case OP_EVERY_TIME_ARGUMENT:
if (argnum == 0)
return OPF_FLEXIBLE_ARGUMENT;
else if (argnum == 1)
return OPF_BOOL;
else
return OPF_NULL;
case OP_DO_FOR_VALID_ARGUMENTS:
return OPF_NULL;
case OP_ANY_OF:
case OP_EVERY_OF:
case OP_RANDOM_OF:
case OP_RANDOM_MULTIPLE_OF:
case OP_IN_SEQUENCE:
return OPF_ANYTHING;
case OP_NUMBER_OF:
if (argnum == 0)
return OPF_POSITIVE;
else
return OPF_ANYTHING;
case OP_INVALIDATE_ARGUMENT:
case OP_VALIDATE_ARGUMENT:
return OPF_ANYTHING;
case OP_AI_DISABLE_SHIP:
case OP_AI_DISARM_SHIP:
case OP_AI_EVADE_SHIP:
case OP_AI_STAY_NEAR_SHIP:
case OP_AI_IGNORE:
case OP_AI_IGNORE_NEW:
if (!argnum)
return OPF_SHIP;
else
return OPF_POSITIVE;
case OP_AI_CHASE:
case OP_AI_GUARD:
if (!argnum)
return OPF_SHIP_WING;
else
return OPF_POSITIVE;
case OP_AI_KEEP_SAFE_DISTANCE:
return OPF_POSITIVE;
case OP_AI_DOCK:
if (!argnum)
return OPF_SHIP;
else if (argnum == 1)
return OPF_DOCKER_POINT;
else if (argnum == 2)
return OPF_DOCKEE_POINT;
else
return OPF_POSITIVE;
case OP_AI_UNDOCK:
if (argnum == 0)
return OPF_POSITIVE;
else
return OPF_SHIP;
case OP_AI_CHASE_WING:
case OP_AI_GUARD_WING:
if (!argnum)
return OPF_WING;
else
return OPF_POSITIVE;
case OP_AI_DESTROY_SUBSYS:
if (!argnum)
return OPF_SHIP;
else if (argnum == 1)
return OPF_SUBSYSTEM;
else
return OPF_POSITIVE;
case OP_GOALS_ID:
return OPF_AI_GOAL;
case OP_SET_CARGO:
case OP_IS_CARGO:
if (argnum == 0)
return OPF_CARGO;
else if (argnum == 1)
return OPF_SHIP;
else
return OPF_SUBSYSTEM;
case OP_CHANGE_AI_CLASS:
case OP_IS_AI_CLASS:
if (argnum == 0)
return OPF_AI_CLASS;
else if (argnum == 1)
return OPF_SHIP;
else
return OPF_SUBSYSTEM;
case OP_IS_SHIP_TYPE:
if (argnum == 0)
return OPF_SHIP_TYPE;
else
return OPF_SHIP;
case OP_IS_SHIP_CLASS:
if (argnum == 0)
return OPF_SHIP_CLASS_NAME;
else
return OPF_SHIP;
case OP_CHANGE_SOUNDTRACK:
return OPF_SOUNDTRACK_NAME;
case OP_PLAY_SOUND_FROM_TABLE:
return OPF_POSITIVE;
case OP_PLAY_SOUND_FROM_FILE:
if (argnum==0)
return OPF_STRING;
else
return OPF_POSITIVE;
case OP_CLOSE_SOUND_FROM_FILE:
return OPF_BOOL;
case OP_HUD_DISABLE:
case OP_HUD_DISABLE_EXCEPT_MESSAGES:
return OPF_POSITIVE;
case OP_HUD_SET_TEXT:
return OPF_STRING;
case OP_HUD_SET_TEXT_NUM:
case OP_HUD_SET_COORDS:
case OP_HUD_SET_FRAME:
case OP_HUD_SET_COLOR:
if(argnum == 0)
return OPF_STRING;
else
return OPF_POSITIVE;
case OP_PLAYER_USE_AI:
case OP_PLAYER_NOT_USE_AI:
return OPF_NONE;
case OP_ALLOW_TREASON:
return OPF_BOOL;
case OP_EXPLOSION_EFFECT:
if (argnum <= 2)
return OPF_NUMBER;
else
return OPF_POSITIVE;
case OP_WARP_EFFECT:
if (argnum <= 5)
return OPF_NUMBER;
else
return OPF_POSITIVE;
case OP_SEND_MESSAGE:
case OP_SEND_RANDOM_MESSAGE:
if ( argnum == 0 )
return OPF_WHO_FROM;
else if ( argnum == 1 )
return OPF_PRIORITY;
else
return OPF_MESSAGE;
case OP_SEND_MESSAGE_LIST:
int a_mod;
// every four, the value repeats
a_mod = argnum % 4;
// who from
if(a_mod == 0)
return OPF_WHO_FROM;
else if(a_mod == 1)
return OPF_PRIORITY;
else if(a_mod == 2)
return OPF_MESSAGE;
else if(a_mod == 3)
return OPF_POSITIVE;
case OP_TRAINING_MSG:
if (argnum < 2)
return OPF_MESSAGE;
else
return OPF_POSITIVE;
// Karajorma
case OP_ENABLE_BUILTIN_MESSAGES:
case OP_DISABLE_BUILTIN_MESSAGES:
return OPF_WHO_FROM;
case OP_SET_PERSONA:
if (argnum == 0)
return OPF_PERSONA;
else
return OPF_SHIP;
case OP_SELF_DESTRUCT:
return OPF_SHIP;
case OP_NEXT_MISSION:
return OPF_MISSION_NAME;
case OP_END_CAMPAIGN:
case OP_END_OF_CAMPAIGN:
return OPF_NONE;
case OP_PREVIOUS_GOAL_TRUE:
case OP_PREVIOUS_GOAL_FALSE:
if ( argnum == 0 )
return OPF_MISSION_NAME;
else if (argnum == 1 )
return OPF_GOAL_NAME;
else
return OPF_BOOL;
case OP_PREVIOUS_GOAL_INCOMPLETE:
return OPF_GOAL_NAME;
case OP_PREVIOUS_EVENT_TRUE:
case OP_PREVIOUS_EVENT_FALSE:
case OP_PREVIOUS_EVENT_INCOMPLETE:
if (!argnum)
return OPF_MISSION_NAME;
else if ( argnum == 1 )
return OPF_EVENT_NAME;
else
return OPF_BOOL;
case OP_SABOTAGE_SUBSYSTEM:
if (!argnum)
return OPF_SHIP; // changed from OPF_SHIP_NOT_PLAYER by Goober5000: now it can be the player ship also
else if (argnum == 1 )
return OPF_SUBSYS_OR_GENERIC;
else
return OPF_POSITIVE;
case OP_REPAIR_SUBSYSTEM:
case OP_SET_SUBSYSTEM_STRNGTH:
if (!argnum)
return OPF_SHIP; // changed from OPF_SHIP_NOT_PLAYER by Goober5000: now it can be the player ship also
else if (argnum == 1 )
return OPF_SUBSYS_OR_GENERIC;
else if (argnum == 2)
return OPF_POSITIVE;
else
return OPF_BOOL;
case OP_WAYPOINTS_DONE:
if ( argnum == 0 )
return OPF_SHIP_WING;
else
return OPF_WAYPOINT_PATH;
case OP_WAYPOINTS_DONE_DELAY:
if ( argnum == 0 )
return OPF_SHIP_WING;
else if ( argnum == 1 )
return OPF_WAYPOINT_PATH;
else
return OPF_POSITIVE;
case OP_INVALIDATE_GOAL:
case OP_VALIDATE_GOAL:
return OPF_GOAL_NAME;
case OP_SHIP_TYPE_DESTROYED:
if ( argnum == 0 )
return OPF_POSITIVE;
else
return OPF_SHIP_TYPE;
case OP_KEY_PRESSED:
if (!argnum)
return OPF_KEYPRESS;
else
return OPF_POSITIVE;
case OP_KEY_RESET:
case OP_KEY_RESET_MULTIPLE:
return OPF_KEYPRESS;
case OP_EVENT_TRUE:
case OP_EVENT_FALSE:
return OPF_EVENT_NAME;
case OP_EVENT_INCOMPLETE:
case OP_EVENT_TRUE_DELAY:
case OP_EVENT_FALSE_DELAY:
if (argnum == 0)
return OPF_EVENT_NAME;
else if (argnum == 1)
return OPF_POSITIVE;
else if (argnum == 2)
return OPF_BOOL;
case OP_GOAL_INCOMPLETE:
case OP_GOAL_TRUE_DELAY:
case OP_GOAL_FALSE_DELAY:
if (!argnum)
return OPF_GOAL_NAME;
else
return OPF_POSITIVE;
case OP_AI_PLAY_DEAD:
case OP_AI_CHASE_ANY:
return OPF_POSITIVE;
case OP_AI_STAY_STILL:
if (!argnum)
return OPF_SHIP_POINT;
else
return OPF_POSITIVE;
case OP_GOOD_REARM_TIME:
if ( argnum == 0 )
return OPF_IFF;
else
return OPF_POSITIVE;
case OP_NUM_PLAYERS:
return OPF_POSITIVE;
case OP_SKILL_LEVEL_AT_LEAST:
return OPF_SKILL_LEVEL;
case OP_GRANT_MEDAL:
case OP_WAS_MEDAL_GRANTED:
return OPF_MEDAL_NAME;
case OP_IS_CARGO_KNOWN:
return OPF_SHIP;
case OP_CARGO_KNOWN_DELAY:
if ( argnum == 0 )
return OPF_POSITIVE;
else
return OPF_SHIP;
case OP_HAS_BEEN_TAGGED_DELAY:
if ( argnum == 0 ) {
return OPF_POSITIVE;
} else {
return OPF_SHIP;
}
case OP_CAP_SUBSYS_CARGO_KNOWN_DELAY:
if ( argnum == 0 ) {
return OPF_POSITIVE;
} else if ( argnum == 1 ) {
return OPF_SHIP;
} else {
return OPF_SUBSYSTEM;
}
case OP_ALLOW_SHIP:
case OP_TECH_ADD_SHIP:
return OPF_SHIP_CLASS_NAME;
case OP_ALLOW_WEAPON:
case OP_TECH_ADD_WEAPON:
return OPF_WEAPON_NAME;
case OP_TECH_ADD_INTEL:
return OPF_INTEL_NAME;
case OP_TECH_RESET_TO_DEFAULT:
return OPF_NONE;
case OP_CHANGE_PLAYER_SCORE:
if (argnum == 0)
return OPF_NUMBER;
else
return OPF_SHIP;
case OP_CHANGE_TEAM_SCORE:
return OPF_NUMBER;
case OP_SHIP_VAPORIZE:
case OP_SHIP_NO_VAPORIZE:
return OPF_SHIP;
case OP_DONT_COLLIDE_INVISIBLE:
case OP_COLLIDE_INVISIBLE:
return OPF_SHIP;
case OP_WARP_BROKEN:
case OP_WARP_NOT_BROKEN:
case OP_WARP_NEVER:
case OP_WARP_ALLOWED:
return OPF_SHIP;
case OP_FLASH_HUD_GAUGE:
return OPF_HUD_GAUGE_NAME;
case OP_GOOD_SECONDARY_TIME:
if ( argnum == 0 )
return OPF_IFF;
else if ( argnum == 1 )
return OPF_POSITIVE;
else if ( argnum == 2 )
return OPF_HUGE_WEAPON;
else
return OPF_SHIP;
case OP_PERCENT_SHIPS_DEPARTED:
case OP_PERCENT_SHIPS_DESTROYED:
if ( argnum == 0 ){
return OPF_POSITIVE;
} else {
return OPF_SHIP_WING;
}
break;
case OP_PERCENT_SHIPS_DISARMED:
case OP_PERCENT_SHIPS_DISABLED:
if ( argnum == 0 ){
return OPF_POSITIVE;
} else {
return OPF_SHIP;
}
break;
case OP_DEPART_NODE_DELAY:
if ( argnum == 0 ){
return OPF_POSITIVE;
} else if ( argnum == 1 ){
return OPF_JUMP_NODE_NAME;
} else {
return OPF_SHIP;
}
case OP_DESTROYED_DEPARTED_DELAY:
if ( argnum == 0 ){
return OPF_POSITIVE;
} else {
return OPF_SHIP_WING;
}
case OP_JETTISON_CARGO:
if(argnum == 1){
return OPF_POSITIVE;
} else {
return OPF_SHIP;
}
case OP_CARGO_NO_DEPLETE:
if (argnum == 0) {
return OPF_SHIP;
} else {
return OPF_NUMBER;
}
case OP_BEAM_FIRE:
switch(argnum){
case 0:
return OPF_SHIP;
case 1:
return OPF_SUBSYSTEM;
case 2:
return OPF_SHIP;
case 3:
return OPF_SUBSYSTEM;
}
case OP_IS_TAGGED:
return OPF_SHIP;
case OP_IS_PLAYER:
if (argnum == 0) {
return OPF_BOOL;
} else {
return OPF_SHIP;
}
case OP_NUM_KILLS:
case OP_NUM_ASSISTS:
case OP_SHIP_SCORE:
case OP_SHIP_DEATHS:
case OP_RESPAWNS_LEFT:
return OPF_SHIP;
case OP_SET_RESPAWNS:
if (argnum == 0 ) {
return OPF_POSITIVE;
}
else {
return OPF_SHIP;
}
case OP_NUM_TYPE_KILLS:
if(argnum == 0){
return OPF_SHIP;
} else {
return OPF_SHIP_TYPE;
}
case OP_NUM_CLASS_KILLS:
if(argnum == 0){
return OPF_SHIP;
} else {
return OPF_SHIP_CLASS_NAME;
}
case OP_BEAM_FREE:
case OP_BEAM_LOCK:
case OP_TURRET_FREE:
case OP_TURRET_LOCK:
case OP_TURRET_TAGGED_SPECIFIC:
case OP_TURRET_TAGGED_CLEAR_SPECIFIC:
case OP_TURRET_SUBSYS_TARGET_DISABLE:
case OP_TURRET_SUBSYS_TARGET_ENABLE:
if(argnum == 0){
return OPF_SHIP;
} else {
return OPF_SUBSYSTEM;
}
case OP_TURRET_CHANGE_WEAPON:
if(argnum == 0) {
return OPF_SHIP;
} else if(argnum == 1) {
return OPF_SUBSYSTEM;
} else if(argnum == 2) {
return OPF_WEAPON_NAME;
} else if(argnum > 2) {
return OPF_POSITIVE;
}
case OP_TURRET_SET_TARGET_ORDER:
if(argnum == 0) {
return OPF_SHIP;
} else if(argnum == 1) {
return OPF_SUBSYSTEM;
} else {
return OPF_TURRET_TARGET_ORDER;
}
case OP_SHIP_TURRET_TARGET_ORDER:
if(argnum == 0) {
return OPF_SHIP;
} else {
return OPF_TURRET_TARGET_ORDER;
}
case OP_LOCK_ROTATING_SUBSYSTEM:
case OP_FREE_ROTATING_SUBSYSTEM:
case OP_REVERSE_ROTATING_SUBSYSTEM:
if (argnum == 0)
return OPF_SHIP;
else
return OPF_ROTATING_SUBSYSTEM;
case OP_ROTATING_SUBSYS_SET_TURN_TIME:
if (argnum == 0)
return OPF_SHIP;
else if (argnum == 1)
return OPF_ROTATING_SUBSYSTEM;
else if (argnum == 2)
return OPF_NUMBER;
else
return OPF_POSITIVE;
case OP_BEAM_FREE_ALL:
case OP_BEAM_LOCK_ALL:
case OP_TURRET_FREE_ALL:
case OP_TURRET_LOCK_ALL:
case OP_TURRET_TAGGED_ONLY_ALL:
case OP_TURRET_TAGGED_CLEAR_ALL:
return OPF_SHIP;
case OP_ADD_REMOVE_ESCORT:
if(argnum == 0){
return OPF_SHIP;
} else {
return OPF_NUMBER;
}
case OP_AWACS_SET_RADIUS:
if(argnum == 0){
return OPF_SHIP;
} else if(argnum == 1){
return OPF_AWACS_SUBSYSTEM;
} else {
return OPF_NUMBER;
}
case OP_PRIMITIVE_SENSORS_SET_RANGE:
if (!argnum)
return OPF_SHIP;
else
return OPF_NUMBER;
case OP_CAP_WAYPOINT_SPEED:
if (argnum == 0) {
return OPF_SHIP;
} else {
return OPF_NUMBER;
}
case OP_SUBSYS_SET_RANDOM:
if (argnum == 0) {
return OPF_SHIP;
} else if (argnum == 1 || argnum == 2) {
return OPF_NUMBER;
} else {
return OPF_SUBSYSTEM;
}
case OP_SUPERNOVA_START:
return OPF_NUMBER;
case OP_SHIELD_RECHARGE_PCT:
case OP_WEAPON_RECHARGE_PCT:
case OP_ENGINE_RECHARGE_PCT:
return OPF_SHIP;
case OP_SHIELD_QUAD_LOW:
if(argnum == 0){
return OPF_SHIP;
} else {
return OPF_NUMBER;
}
case OP_PRIMARY_AMMO_PCT:
case OP_SECONDARY_AMMO_PCT:
if(argnum == 0){
return OPF_SHIP;
} else {
return OPF_NUMBER;
}
// Karajorma
case OP_GET_PRIMARY_AMMO:
case OP_SET_PRIMARY_AMMO:
case OP_GET_SECONDARY_AMMO:
case OP_SET_SECONDARY_AMMO:
if(argnum == 0){
return OPF_SHIP;
} else {
return OPF_NUMBER;
}
// Karajorma
case OP_SET_PRIMARY_WEAPON:
case OP_SET_SECONDARY_WEAPON:
if(argnum == 0)
{
return OPF_SHIP;
}
else if (argnum == 2)
{
return OPF_WEAPON_NAME;
}
else
{
return OPF_NUMBER;
}
// Karajorma
case OP_LOCK_PRIMARY_WEAPON:
case OP_UNLOCK_PRIMARY_WEAPON:
case OP_LOCK_SECONDARY_WEAPON:
case OP_UNLOCK_SECONDARY_WEAPON:
// KeldorKatarn
case OP_LOCK_AFTERBURNER:
case OP_UNLOCK_AFTERBURNER:
return OPF_SHIP;
case OP_SET_AFTERBURNER_ENERGY:
case OP_SET_WEAPON_ENERGY:
case OP_SET_SHIELD_ENERGY:
if (argnum == 0) {
return OPF_POSITIVE;
}
else {
return OPF_SHIP;
}
case OP_SET_AMBIENT_LIGHT:
return OPF_POSITIVE;
case OP_CHANGE_SUBSYSTEM_NAME:
if (argnum == 0) {
return OPF_SHIP;
}
else if (argnum == 1) {
return OPF_STRING;
}
else {
return OPF_SUBSYSTEM;
}
case OP_IS_SECONDARY_SELECTED:
case OP_IS_PRIMARY_SELECTED:
if(argnum == 0){
return OPF_SHIP;
} else {
return OPF_NUMBER;
}
case OP_DAMAGED_ESCORT_LIST:
if (argnum < 2)
{
return OPF_NUMBER;
}
else
{
return OPF_SHIP;
}
case OP_DAMAGED_ESCORT_LIST_ALL:
return OPF_POSITIVE;
case OP_CHANGE_SHIP_CLASS:
if (!argnum)
return OPF_SHIP_CLASS_NAME;
else
return OPF_SHIP;
case OP_SHIP_COPY_DAMAGE:
return OPF_SHIP;
case OP_DEACTIVATE_GLOW_POINTS: //-Bobboau
case OP_ACTIVATE_GLOW_POINTS: //-Bobboau
case OP_DEACTIVATE_GLOW_MAPS: //-Bobboau
case OP_ACTIVATE_GLOW_MAPS: //-Bobboau
return OPF_SHIP; //a list of ships that are to be activated/deactivated
case OP_DEACTIVATE_GLOW_POINT_BANK:
case OP_ACTIVATE_GLOW_POINT_BANK:
if (!argnum)
return OPF_SHIP; //the ship
else
return OPF_POSITIVE; //the glow bank to disable
// taylor
case OP_SET_SKYBOX_MODEL:
if (argnum == 0)
return OPF_SKYBOX_MODEL_NAME;
else
return OPF_STRING;
// Goober5000 - this is complicated :)
case OP_SET_SUPPORT_SHIP:
if ((argnum == 0) || (argnum == 2))
return OPF_DEPARTURE_LOCATION; // use this for both because we don't want Near Ship or In Front of Ship
if ((argnum == 1) || (argnum == 3))
return OPF_SHIP_WITH_BAY; // same - we don't want to anchor around anything without a docking bay
if (argnum == 4)
return OPF_SUPPORT_SHIP_CLASS;
if (argnum == 5)
return OPF_NUMBER;
case OP_KAMIKAZE:
if (argnum==0)
return OPF_POSITIVE;
else
return OPF_SHIP_WING;
case OP_NOT_KAMIKAZE:
return OPF_SHIP_WING;
case OP_NUM_SHIPS_IN_BATTLE:
return OPF_IFF;
case OP_NUM_SHIPS_IN_WING: // Karajorma
return OPF_WING;
case OP_CURRENT_SPEED:
return OPF_SHIP_WING;
case OP_PRIMARY_FIRED_SINCE:
case OP_SECONDARY_FIRED_SINCE:
if (argnum == 0)
return OPF_SHIP;
else
return OPF_POSITIVE;
case OP_NAV_IS_VISITED: //Kazan
case OP_NAV_DISTANCE: //kazan
case OP_NAV_DEL: //kazan
case OP_NAV_HIDE: //kazan
case OP_NAV_RESTRICT: //kazan
case OP_NAV_UNHIDE: //kazan
case OP_NAV_UNRESTRICT: //kazan
case OP_NAV_SET_VISITED: //kazan
case OP_NAV_UNSET_VISITED: //kazan
return OPF_STRING;
// return OPF_NAV_POINT;
case OP_NAV_SET_CARRY: //kazan
case OP_NAV_UNSET_CARRY: //kazan
return OPF_SHIP_WING;
case OP_NAV_SET_NEEDSLINK: // kazan
case OP_NAV_UNSET_NEEDSLINK:
case OP_NAV_ISLINKED:
return OPF_SHIP;
case OP_NAV_USECINEMATICS:
case OP_NAV_USEAP:
return OPF_BOOL;
case OP_NAV_ADD_WAYPOINT: //kazan
if (argnum==0)
// return OPF_NAV_POINT;
return OPF_STRING;
else if (argnum==1)
return OPF_WAYPOINT_PATH;
else
return OPF_POSITIVE;
case OP_NAV_ADD_SHIP: //kazan
if (argnum==0)
// return OPF_NAV_POINT;
return OPF_STRING;
else
return OPF_SHIP;
//<Cutscenes>
case OP_SCRAMBLE_MESSAGES:
case OP_UNSCRAMBLE_MESSAGES:
return OPF_NONE;
case OP_CUTSCENES_SET_CUTSCENE_BARS:
case OP_CUTSCENES_UNSET_CUTSCENE_BARS:
case OP_CUTSCENES_FADE_IN:
case OP_CUTSCENES_FADE_OUT:
case OP_CUTSCENES_SET_TIME_COMPRESSION:
return OPF_POSITIVE;
case OP_CUTSCENES_SET_FOV:
return OPF_NUMBER;
case OP_CUTSCENES_SET_CAMERA:
return OPF_STRING;
case OP_CUTSCENES_SET_CAMERA_POSITION:
case OP_CUTSCENES_SET_CAMERA_FACING:
case OP_CUTSCENES_SET_CAMERA_ROTATION:
if(argnum < 3)
return OPF_NUMBER;
else
return OPF_POSITIVE;
case OP_CUTSCENES_SET_CAMERA_FACING_OBJECT:
if(argnum < 1)
return OPF_SHIP_WING_POINT;
else
return OPF_POSITIVE;
case OP_CUTSCENES_SET_CAMERA_FOV:
return OPF_POSITIVE;
case OP_CUTSCENES_SET_CAMERA_HOST:
case OP_CUTSCENES_SET_CAMERA_TARGET:
if(argnum < 1)
return OPF_SHIP_WING_POINT_OR_NONE;
else
return OPF_SUBSYSTEM_OR_NONE;
case OP_CUTSCENES_RESET_CAMERA:
return OPF_BOOL;
case OP_CUTSCENES_RESET_FOV:
case OP_CUTSCENES_RESET_TIME_COMPRESSION:
return OPF_NONE;
case OP_CUTSCENES_FORCE_PERSPECTIVE:
if(argnum==0)
return OPF_BOOL;
else
return OPF_POSITIVE;
case OP_SET_CAMERA_SHUDDER:
return OPF_POSITIVE;
case OP_CUTSCENES_SHOW_SUBTITLE:
if(argnum < 2)
return OPF_NUMBER;
else if(argnum == 2)
return OPF_STRING;
else if(argnum == 3)
return OPF_POSITIVE;
else if(argnum == 4)
return OPF_STRING;
else if(argnum == 5)
return OPF_POSITIVE;
else if(argnum < 8)
return OPF_BOOL;
else if(argnum < 12)
return OPF_POSITIVE;
//</Cutscenes>
case OP_JUMP_NODE_SET_JUMPNODE_COLOR:
if(argnum==0)
return OPF_JUMP_NODE_NAME;
else
return OPF_POSITIVE;
case OP_JUMP_NODE_SET_JUMPNODE_MODEL:
if(argnum==0)
return OPF_JUMP_NODE_NAME;
else
return OPF_STRING;
case OP_JUMP_NODE_SHOW_JUMPNODE:
case OP_JUMP_NODE_HIDE_JUMPNODE:
return OPF_JUMP_NODE_NAME;
case OP_ADD_BACKGROUND_BITMAP:
if (argnum == 0)
return OPF_BACKGROUND_BITMAP;
else if (argnum == 8) return OPF_VARIABLE_NAME;
else return OPF_POSITIVE;
case OP_REMOVE_BACKGROUND_BITMAP:
return OPF_POSITIVE;
case OP_ADD_SUN_BITMAP:
if (argnum == 0)
return OPF_SUN_BITMAP;
else if (argnum == 5) return OPF_VARIABLE_NAME;
else return OPF_POSITIVE;
case OP_REMOVE_SUN_BITMAP:
return OPF_POSITIVE;
case OP_NEBULA_CHANGE_STORM:
return OPF_NEBULA_STORM_TYPE;
case OP_NEBULA_TOGGLE_POOF:
if (argnum == 1) return OPF_BOOL;
else return OPF_NEBULA_POOF;
case OP_SCRIPT_EVAL_NUM:
case OP_SCRIPT_EVAL_STRING:
case OP_SCRIPT_EVAL:
return OPF_STRING;
case OP_CHANGE_IFF_COLOR:
if ((argnum == 0) || (argnum == 1))
return OPF_IFF;
else if ((argnum >= 2) && (argnum <=4))
return OPF_POSITIVE;
else return OPF_SHIP_WING;
default:
Int3();
}
return 0;
}
void update_block_names(const char *old_name, const char *new_name)
{
int i;
for (i=0; i<MAX_SEXP_VARIABLES; i++) {
if (Sexp_variables[i].type & SEXP_VARIABLE_BLOCK) {
if ( !stricmp(old_name, Sexp_variables[i].variable_name) ) {
strcpy(Sexp_variables[i].variable_name, new_name);
}
}
}
}
// DA: 1/7/99 Used to rename ships and waypoints, not variables
// Strictly used in FRED
void update_sexp_references(char *old_name, char *new_name)
{
int i;
// update_block_names
update_block_names(old_name, new_name);
Assert(strlen(new_name) < TOKEN_LENGTH);
for (i = 0; i < Num_sexp_nodes; i++)
{
if ((SEXP_NODE_TYPE(i) == SEXP_ATOM) && (Sexp_nodes[i].subtype == SEXP_ATOM_STRING))
if (!stricmp(CTEXT(i), old_name))
strcpy(CTEXT(i), new_name);
}
}
// DA: 1/7/99 Used to rename event names, goal names, not variables
// Strictly used in FRED
void update_sexp_references(char *old_name, char *new_name, int format)
{
int i;
Assert(strlen(new_name) < TOKEN_LENGTH);
for (i = 0; i < Num_sexp_nodes; i++)
{
if (is_sexp_top_level(i))
update_sexp_references(old_name, new_name, format, i);
}
}
// DA: 1/7/99 Used to rename event names, goal names, not variables
// recursive function to update references to a certain type of data
void update_sexp_references(char *old_name, char *new_name, int format, int node)
{
int i, n, op;
if (node < 0)
return;
if ((SEXP_NODE_TYPE(node) == SEXP_LIST) && (Sexp_nodes[node].subtype == SEXP_ATOM_LIST))
{
if (Sexp_nodes[node].first)
update_sexp_references(old_name, new_name, format, Sexp_nodes[node].first);
if (Sexp_nodes[node].rest)
update_sexp_references(old_name, new_name, format, Sexp_nodes[node].rest);
return;
}
if (SEXP_NODE_TYPE(node) != SEXP_ATOM)
return;
if (Sexp_nodes[node].subtype != SEXP_ATOM_OPERATOR)
return;
op = get_operator_index(CTEXT(node));
Assert(Sexp_nodes[node].first < 0);
n = Sexp_nodes[node].rest;
i = 0;
while (n >= 0)
{
if (SEXP_NODE_TYPE(n) == SEXP_LIST)
{
update_sexp_references(old_name, new_name, format, Sexp_nodes[n].first);
}
else
{
Assert((SEXP_NODE_TYPE(n) == SEXP_ATOM) && ((Sexp_nodes[n].subtype == SEXP_ATOM_NUMBER) || (Sexp_nodes[n].subtype == SEXP_ATOM_STRING)));
if (query_operator_argument_type(op, i) == format)
{
if (!stricmp(CTEXT(n), old_name))
strcpy(CTEXT(n), new_name);
}
}
n = Sexp_nodes[n].rest;
i++;
}
}
int query_referenced_in_sexp(int mode, char *name, int *node)
{
int i, n, j;
for (n=0; n<Num_sexp_nodes; n++){
if ((SEXP_NODE_TYPE(n) == SEXP_ATOM) && (Sexp_nodes[n].subtype == SEXP_ATOM_STRING)){
if (!stricmp(CTEXT(n), name)){
break;
}
}
}
if (n == Num_sexp_nodes){
return 0;
}
if (node){
*node = n;
}
// so we know it's being used somewhere.. Time to find out where..
for (i=0; i<MAX_SHIPS; i++)
if (Ships[i].objnum >= 0) {
if (query_node_in_sexp(n, Ships[i].arrival_cue)){
return i | SRC_SHIP_ARRIVAL;
}
if (query_node_in_sexp(n, Ships[i].departure_cue)){
return i | SRC_SHIP_DEPARTURE;
}
}
for (i=0; i<MAX_WINGS; i++){
if (Wings[i].wave_count) {
if (query_node_in_sexp(n, Wings[i].arrival_cue)){
return i | SRC_WING_ARRIVAL;
}
if (query_node_in_sexp(n, Wings[i].departure_cue)){
return i | SRC_WING_DEPARTURE;
}
}
}
for (i=0; i<Num_mission_events; i++){
if (query_node_in_sexp(n, Mission_events[i].formula)){
return i | SRC_EVENT;
}
}
for (i=0; i<Num_goals; i++){
if (query_node_in_sexp(n, Mission_goals[i].formula)){
return i | SRC_MISSION_GOAL;
}
}
for (j=0; j<Num_teams; j++) {
for (i=0; i<Debriefings[j].num_stages; i++) {
if (query_node_in_sexp(n, Debriefings[j].stages[i].formula)){
return i | SRC_DEBRIEFING;
}
}
}
for (j=0; j<Num_teams; j++) {
for (i=0; i<Briefings[j].num_stages; i++) {
if (query_node_in_sexp(n, Briefings[j].stages[i].formula)){
return i | SRC_BRIEFING;
}
}
}
return SRC_UNKNOWN;
}
int verify_vector(char *text)
{
char *str;
int i, z, len = 0;
if (text == NULL)
return -1;
for (i=0; i<Num_waypoint_lists; i++) {
len = strlen(str = Waypoint_lists[i].name);
if (!strnicmp(str, text, len)){
if (!text[len] || text[len] == ':'){
break;
}
}
}
if (i < Num_waypoint_lists) {
if (!text[len]){
return 0; // a valid waypoint path
}
str = &text[len + 1];
while (*str){
if (!isdigit(*str++)){
return -1; // not a valid number
}
}
z = atoi(&text[len + 1]);
if (z < 1 || z > Waypoint_lists[i].count){
return -1; // out of range
}
return 0; // a valid waypoint
}
len = strlen(text);
if (text[0] != '(' || text[len - 1] != ')'){
return -1;
}
str = &text[0];
skip_white(&str);
if (*str != '('){
return -1;
}
str++;
skip_white(&str);
if (validate_float(&str)){
return -1;
}
skip_white(&str);
if (validate_float(&str)){
return -1;
}
skip_white(&str);
if (validate_float(&str)){
return -1;
}
skip_white(&str);
if (*str != ')'){
return -1;
}
str++;
skip_white(&str);
if (*str){
return -1;
}
return 0;
}
void skip_white(char **str)
{
if ((**str == ' ') || (**str == '\t')){
(*str)++;
}
}
int validate_float(char **str)
{
int count = 0, dot = 0;
while (isdigit(**str) || **str == '.') {
if (**str == '.') {
if (dot){
return -1;
}
dot = 1;
}
(*str)++;
count++;
}
if (!count){
return -1;
}
return 0;
}
// check if operator return type opr is a valid match for operator argument type opf
int sexp_query_type_match(int opf, int opr)
{
switch (opf) {
case OPF_NUMBER:
return ((opr == OPR_NUMBER) || (opr == OPR_POSITIVE));
case OPF_POSITIVE:
// Goober5000's number hack
return ((opr == OPR_POSITIVE) || (opr == OPR_NUMBER));
case OPF_BOOL:
return (opr == OPR_BOOL);
case OPF_NULL:
return (opr == OPR_NULL);
// Goober5000
case OPF_FLEXIBLE_ARGUMENT:
return (opr == OPR_FLEXIBLE_ARGUMENT);
// Goober5000
case OPF_ANYTHING:
// don't match any operators, only data
return 0;
case OPF_AI_GOAL:
return (opr == OPR_AI_GOAL);
}
return 0;
}
char *sexp_error_message(int num)
{
switch (num) {
case SEXP_CHECK_NONOP_ARGS:
return "Data shouldn't have arguments";
case SEXP_CHECK_OP_EXPECTED:
return "Operator expected instead of data";
case SEXP_CHECK_UNKNOWN_OP:
return "Unrecognized operator";
case SEXP_CHECK_TYPE_MISMATCH:
return "Argument type mismatch";
case SEXP_CHECK_BAD_ARG_COUNT:
return "Argument count is illegal";
case SEXP_CHECK_UNKNOWN_TYPE:
return "Unknown operator argument type";
case SEXP_CHECK_INVALID_NUM:
return "Not a number";
case SEXP_CHECK_INVALID_SHIP:
return "Invalid ship name";
case SEXP_CHECK_INVALID_WING:
return "Invalid wing name";
case SEXP_CHECK_INVALID_SUBSYS:
return "Invalid subsystem name";
case SEXP_CHECK_INVALID_IFF:
return "Invalid team name";
case SEXP_CHECK_INVALID_AI_CLASS:
return "Invalid AI class name";
case SEXP_CHECK_INVALID_POINT:
return "Invalid point";
case SEXP_CHECK_NEGATIVE_NUM:
return "Negative number not allowed";
case SEXP_CHECK_INVALID_SHIP_WING:
return "Invalid ship/wing name";
case SEXP_CHECK_INVALID_SHIP_TYPE:
return "Invalid ship type";
case SEXP_CHECK_UNKNOWN_MESSAGE:
return "Invalid message name";
case SEXP_CHECK_INVALID_PRIORITY:
return "Invalid priority";
case SEXP_CHECK_INVALID_MISSION_NAME:
return "Invalid mission filename";
case SEXP_CHECK_INVALID_GOAL_NAME:
return "Invalid goal name";
case SEXP_CHECK_INVALID_LEVEL:
return "Mission level too low in tree";
case SEXP_CHECK_INVALID_MSG_SOURCE:
return "Invalid message source";
case SEXP_CHECK_INVALID_DOCKER_POINT:
return "Invalid docker point";
case SEXP_CHECK_INVALID_DOCKEE_POINT:
return "Invalid dockee point";
case SEXP_CHECK_ORDER_NOT_ALLOWED:
return "Ship not allowed to have this order";
case SEXP_CHECK_DOCKING_NOT_ALLOWED:
return "Ship can't dock with target ship";
case SEXP_CHECK_NUM_RANGE_INVALID:
return "Number is out of range";
case SEXP_CHECK_INVALID_EVENT_NAME:
return "Event name is invalid (not known)";
case SEXP_CHECK_INVALID_SKILL_LEVEL:
return "Skill level name is invalid (not known)";
case SEXP_CHECK_INVALID_MEDAL_NAME:
return "Invalid medal name";
case SEXP_CHECK_INVALID_WEAPON_NAME:
return "Invalid weapon name";
case SEXP_CHECK_INVALID_INTEL_NAME:
return "Invalid intel name";
case SEXP_CHECK_INVALID_SHIP_CLASS_NAME:
return "Invalid ship class name";
case SEXP_CHECK_INVALID_GAUGE_NAME:
return "Invalid HUD gauges name";
case SEXP_CHECK_INVALID_JUMP_NODE:
return "Invalid Jump Node name";
case SEXP_CHECK_UNKNOWN_ERROR:
return "Unknown error";
case SEXP_CHECK_INVALID_SUPPORT_SHIP_CLASS:
return "Invalid support ship class";
case SEXP_CHECK_INVALID_SHIP_WITH_BAY:
return "Ship does not have a fighter bay";
case SEXP_CHECK_INVALID_ARRIVAL_LOCATION:
return "Invalid arrival location";
case SEXP_CHECK_INVALID_DEPARTURE_LOCATION:
return "Invalid departure location";
case SEXP_CHECK_INVALID_ARRIVAL_ANCHOR_ALL:
return "Invalid universal arrival anchor";
case SEXP_CHECK_INVALID_SOUNDTRACK_NAME:
return "Invalid soundtrack name";
case SEXP_CHECK_INVALID_PERSONA_NAME:
return "Invalid persona name";
case SEXP_CHECK_INVALID_VARIABLE:
return "Invalid variable name";
case SEXP_CHECK_INVALID_VARIABLE_TYPE:
return "Invalid variable type";
}
sprintf(Sexp_error_text, "Sexp error code %d", num);
return Sexp_error_text;
}
int query_sexp_ai_goal_valid(int sexp_ai_goal, int ship)
{
int i, op;
for (op=0; op<Num_operators; op++)
if (Operators[op].value == sexp_ai_goal)
break;
Assert(op < Num_operators);
for (i=0; i<Num_sexp_ai_goal_links; i++)
if (Sexp_ai_goal_links[i].op_code == sexp_ai_goal)
break;
Assert(i < Num_sexp_ai_goal_links);
return ai_query_goal_valid(ship, Sexp_ai_goal_links[i].ai_goal);
}
// Takes an Sexp_node.text pointing to a variable (of form "Sexp_variables[xx]=string" or "Sexp_variables[xx]=number")
// and returns the index into the Sexp_variables array of the actual value
int extract_sexp_variable_index(int node)
{
char *text = Sexp_nodes[node].text;
char char_index[8];
char *start_index;
int variable_index;
// get past the '['
start_index = text + 15;
Assert(isdigit(*start_index));
int len = 0;
while ( *start_index != ']' ) {
char_index[len++] = *(start_index++);
Assert(len < 3);
}
Assert(len > 0);
char_index[len] = 0; // append null termination to string
variable_index = atoi(char_index);
Assert( (variable_index >= 0) && (variable_index < MAX_SEXP_VARIABLES) );
return variable_index;
}
// wrapper around Sexp_node[xx].text for normal and variable
char *CTEXT(int n)
{
int sexp_variable_index = -1;
char variable_name[TOKEN_LENGTH];
char *current_argument;
if ( n < 0 ) {
Int3();
return NULL;
}
// Goober5000 - MWAHAHAHAHAHAHAHA! Thank you, Volition programmers! Without
// the CTEXT wrapper, when-argument would probably be infeasibly difficult to code.
if (!strcmp(Sexp_nodes[n].text, SEXP_ARGUMENT_STRING))
{
if (Fred_running)
{
// CTEXT is used when writing sexps to savefiles, so don't translate the argument
return Sexp_nodes[n].text;
}
else
{
// make sure we have an argument to replace it with
Assert(!(Sexp_replacement_arguments.empty()));
if (Sexp_replacement_arguments.empty())
return Sexp_nodes[n].text;
}
// if the replacement argument is a variable name, get the variable index
sexp_variable_index = get_index_sexp_variable_name(Sexp_replacement_arguments.back());
current_argument = Sexp_replacement_arguments.back();
// if the replacement argument is a formatted variable name, get the variable index
if (current_argument[0] == SEXP_VARIABLE_CHAR)
{
get_unformatted_sexp_variable_name(variable_name, current_argument);
sexp_variable_index = get_index_sexp_variable_name(variable_name);
}
// if we have a non-block variable, return the variable value, else return the regular argument
if ((sexp_variable_index != -1) && !(Sexp_variables[sexp_variable_index].type & SEXP_VARIABLE_BLOCK))
return Sexp_variables[sexp_variable_index].text;
else
return Sexp_replacement_arguments.back();
}
// Goober5000 - if not special argument, proceed as normal
if (Sexp_nodes[n].type & SEXP_FLAG_VARIABLE)
{
if (Fred_running)
{
sexp_variable_index = get_index_sexp_variable_name(Sexp_nodes[n].text);
Assert(sexp_variable_index != -1);
}
else
{
// sexp_variable_index = extract_sexp_variable_index(n);
sexp_variable_index = atoi(Sexp_nodes[n].text);
}
// Reference a Sexp_variable
// string format -- "Sexp_variables[xx]=number" or "Sexp_variables[xx]=string", where xx is the index
Assert( !(Sexp_variables[sexp_variable_index].type & SEXP_VARIABLE_NOT_USED) );
Assert(Sexp_variables[sexp_variable_index].type & SEXP_VARIABLE_SET);
return Sexp_variables[sexp_variable_index].text;
}
else
{
return Sexp_nodes[n].text;
}
}
// Set all Sexp_variables to type uninitialized
void init_sexp_vars()
{
for (int i=0; i<MAX_SEXP_VARIABLES; i++) {
// if ( !(Sexp_nodes[i].type & SEXP_FLAG_PERSISTENT) )
// Sexp_nodes[i].type = SEXP_NOT_USED;
Sexp_variables[i].type = SEXP_VARIABLE_NOT_USED;
}
}
// Adds an Sexp_variable to be used in a mission.
// This should be called from within mission parse.
int sexp_add_variable(const char *text, const char *var_name, int type, int index)
{
// if index == -1, find next open slot
if (index == -1) {
for (int i=0; i<MAX_SEXP_VARIABLES; i++) {
if (Sexp_variables[i].type == SEXP_VARIABLE_NOT_USED) {
index = i;
break;
}
}
} else {
Assert( (index >= 0) && (index < MAX_SEXP_VARIABLES) );
}
if (index >= 0) {
strcpy(Sexp_variables[index].text, text);
strcpy(Sexp_variables[index].variable_name, var_name);
Sexp_variables[index].type &= ~SEXP_VARIABLE_NOT_USED;
Sexp_variables[index].type = (type | SEXP_VARIABLE_SET);
}
return index;
}
// Modifies and Sexp_variable to be used in a mission
// This should be called in mission when an sexp_variable is to be modified
void sexp_modify_variable(char *text, int index, bool sexp_callback)
{
Assert(index >= 0 && index < MAX_SEXP_VARIABLES);
Assert(Sexp_variables[index].type & SEXP_VARIABLE_SET);
Assert( !MULTIPLAYER_CLIENT );
strcpy(Sexp_variables[index].text, text);
Sexp_variables[index].type |= SEXP_VARIABLE_MODIFIED;
// do multi_callback_here
// if we're called from the sexp code send a SEXP packet (more efficient)
if( MULTIPLAYER_MASTER && (Sexp_variables[index].type & SEXP_VARIABLE_NETWORK) && sexp_callback) {
multi_start_packet();
multi_send_int(index);
multi_send_string(Sexp_variables[index].text);
multi_end_packet();
}
// otherwise send a SEXP variable packet
else if ( MULTIPLAYER_MASTER && (Sexp_variables[index].type & SEXP_VARIABLE_NETWORK) ) {
send_variable_update_packet(index, Sexp_variables[index].text);
}
}
void multi_sexp_modify_variable()
{
char value[TOKEN_LENGTH];
int variable_index = -1;
// get the data
multi_get_int(variable_index);
if (!multi_get_string(value)) {
return;
}
// set the sexp_variable
if ( (variable_index >= 0) && (variable_index < sexp_variable_count()) ) {
strcpy(Sexp_variables[variable_index].text, value);
}
}
void sexp_modify_variable(int n)
{
int sexp_variable_index;
int new_number;
char *new_text;
char number_as_str[TOKEN_LENGTH];
// Only do single player of multi host
if ( MULTIPLAYER_CLIENT )
return;
if (n != -1)
{
// get sexp_variable index
Assert(Sexp_nodes[n].first == -1);
sexp_variable_index = atoi(Sexp_nodes[n].text);
// verify variable set
Assert(Sexp_variables[sexp_variable_index].type & SEXP_VARIABLE_SET);
if (Sexp_variables[sexp_variable_index].type & SEXP_VARIABLE_NUMBER)
{
// get new numerical value
new_number = eval_sexp(CDR(n));
sprintf(number_as_str, "%d", new_number);
// assign to variable
sexp_modify_variable(number_as_str, sexp_variable_index);
}
else if (Sexp_variables[sexp_variable_index].type & SEXP_VARIABLE_STRING)
{
// get new string
new_text = CTEXT(CDR(n));
// assign to variable
sexp_modify_variable(new_text, sexp_variable_index);
}
else
{
Error(LOCATION, "Invalid variable type.\n");
}
}
}
// Different type needed for Fred (1) allow modification of type (2) no callback required
void sexp_fred_modify_variable(const char *text, const char *var_name, int index, int type)
{
Assert(index >= 0 && index < MAX_SEXP_VARIABLES);
Assert(Sexp_variables[index].type & SEXP_VARIABLE_SET);
Assert( (type & SEXP_VARIABLE_NUMBER) || (type & SEXP_VARIABLE_STRING) );
strcpy(Sexp_variables[index].text, text);
strcpy(Sexp_variables[index].variable_name, var_name);
Sexp_variables[index].type = (SEXP_VARIABLE_SET | SEXP_VARIABLE_MODIFIED | type);
}
// given a sexp node returns the index of the variable at that node, -1 if not found
int get_index_sexp_variable_from_node (int node)
{
int var_index;
if (!(Sexp_nodes[node].type & SEXP_FLAG_VARIABLE)) {
return -1;
}
if (Fred_running) {
var_index = get_index_sexp_variable_name(Sexp_nodes[node].text);
}
else {
var_index = atoi(Sexp_nodes[node].text);
}
return var_index;
}
// return index of sexp_variable_name, -1 if not found
int get_index_sexp_variable_name(const char *temp_name)
{
for (int i=0; i<MAX_SEXP_VARIABLES; i++) {
if (Sexp_variables[i].type & SEXP_VARIABLE_SET) {
// check case sensitive
if ( !strcmp(Sexp_variables[i].variable_name, temp_name) ) {
return i;
}
}
}
// not found
return -1;
}
// Goober5000 - tests whether a variable name starts here
// return index of sexp_variable_name, -1 if not found
int get_index_sexp_variable_name_special(const char *startpos)
{
for (int i = MAX_SEXP_VARIABLES - 1; i >= 0; i--) {
if (Sexp_variables[i].type & SEXP_VARIABLE_SET) {
// check case sensitive
// check number of chars in variable name
if ( !strncmp(startpos, Sexp_variables[i].variable_name, strlen(Sexp_variables[i].variable_name)) ) {
return i;
}
}
}
// not found
return -1;
}
// Goober5000
bool sexp_replace_variable_names_with_values(char *text, int max_len)
{
Assert(text != NULL);
Assert(max_len >= 0);
bool replaced_anything = false;
char *pos = text;
do {
// look for the meta-character
pos = strchr(pos, '$');
// found?
if (pos != NULL)
{
// see if a variable starts at the next char
int var_index = get_index_sexp_variable_name_special(pos+1);
if (var_index >= 0)
{
// get the replacement string ($variable)
char what_to_replace[TOKEN_LENGTH+1];
memset(what_to_replace, 0, TOKEN_LENGTH+1);
strncpy(what_to_replace, pos, strlen(Sexp_variables[var_index].variable_name) + 1);
// replace it
pos = text + replace_one(text, what_to_replace, Sexp_variables[var_index].text, max_len);
replaced_anything = true;
}
// no match... so keep iterating along the string
else
{
pos++;
}
}
} while (pos != NULL);
return replaced_anything;
}
// returns the index of the nth variable of the type given or -1 if there aren't that many
// NOTE : Not 0th order. If you want the 4th string variable call it as get_nth_variable_index(4, SEXP_VARIABLE_STRING)
int get_nth_variable_index(int nth, int variable_type)
{
// Loop through Sexp_variables until we have found the one corresponding to the argument
Assert ((nth > 0) && (nth < MAX_SEXP_VARIABLES));
for (int i=0; i < MAX_SEXP_VARIABLES; i++) {
if ((Sexp_variables[i].type & variable_type)) {
nth--;
}
if (!nth) {
return i;
}
}
return -1;
}
// counts number of sexp_variables that are set
int sexp_variable_count()
{
int count = 0;
for (int i=0; i<MAX_SEXP_VARIABLES; i++) {
if ( (Sexp_variables[i].type & SEXP_VARIABLE_SET) && !(Sexp_variables[i].type & SEXP_VARIABLE_BLOCK) ) {
count++;
}
}
return count;
}
// counts number of campaign-persistent sexp_variables that are set
int sexp_campaign_persistent_variable_count()
{
int count = 0;
for (int i=0; i<MAX_SEXP_VARIABLES; i++) {
if ( (Sexp_variables[i].type & SEXP_VARIABLE_SET) && !(Sexp_variables[i].type & SEXP_VARIABLE_BLOCK) && (Sexp_variables[i].type & SEXP_VARIABLE_CAMPAIGN_PERSISTENT) ) {
count++;
}
}
return count;
}
// given an index in Sexp_variables, returns the number variables of a type in the array until this point
int sexp_variable_typed_count(int sexp_variables_index, int variable_type)
{
Assert ((sexp_variables_index >= 0) && (sexp_variables_index < MAX_SEXP_VARIABLES));
// Loop through Sexp_variables until we have found the one corresponding to the argument
int count = 0;
for (int i=0; i < MAX_SEXP_VARIABLES; i++) {
if (!(Sexp_variables[i].type & variable_type)) {
continue;
}
if (i == sexp_variables_index) {
return count ;
}
count++;
}
// shouldn't ever get here
Int3();
return -1;
}
// deletes sexp_variable from active
void sexp_variable_delete(int index)
{
Assert(Sexp_variables[index].type & SEXP_VARIABLE_SET);
Sexp_variables[index].type = SEXP_VARIABLE_NOT_USED;
}
int sexp_var_compare(const void *var1, const void *var2)
{
int set1, set2;
sexp_variable *sexp_var1, *sexp_var2;
sexp_var1 = (sexp_variable*) var1;
sexp_var2 = (sexp_variable*) var2;
set1 = sexp_var1->type & SEXP_VARIABLE_SET;
set2 = sexp_var2->type & SEXP_VARIABLE_SET;
if (!set1 && !set2) {
return 0;
} else if (set1 && !set2) {
return -1;
} else if (!set1 && set2) {
return 1;
} else {
return stricmp( sexp_var1->variable_name, sexp_var2->variable_name);
}
}
// Count number of variables in block
int sexp_variable_block_count()
{
int count = 0;
for (int i=0; i<MAX_SEXP_VARIABLES; i++) {
if (Sexp_variables[i].type & SEXP_VARIABLE_BLOCK) {
count++;
}
}
return count;
}
// Sort sexp_variable list lexigraphically, with set before unset
void sexp_variable_sort()
{
insertion_sort( (void *)Sexp_variables, (size_t)(MAX_SEXP_VARIABLES - sexp_variable_block_count()), sizeof(sexp_variable), sexp_var_compare );
}
int sexp_variable_allocate_block(const char* block_name, int block_type)
{
int num_blocks, block_count, var_count, start;
block_count = sexp_variable_block_count();
var_count = sexp_variable_count();
if (block_type & SEXP_VARIABLE_BLOCK_EXP) {
num_blocks = BLOCK_EXP_SIZE;
} else if (block_type & SEXP_VARIABLE_BLOCK_HIT) {
num_blocks = BLOCK_HIT_SIZE;
} else {
Int3(); // add new block type here with size
return -1;
}
if (block_count + var_count > (MAX_SEXP_VARIABLES - num_blocks)) {
// not enough free space
return -1;
}
// squeeze all variables to front of array
sexp_variable_sort();
// squeeze all block to end of array
sexp_variable_condense_block();
start = MAX_SEXP_VARIABLES - block_count - num_blocks;
for (int idx=start; idx<start+num_blocks; idx++) {
Assert(Sexp_variables[idx].type == SEXP_VARIABLE_NOT_USED);
Sexp_variables[idx].type = SEXP_VARIABLE_BLOCK | block_type;
strcpy(Sexp_variables[idx].variable_name, block_name);
}
return start;
}
// squeeze all blocks to top of array
void sexp_variable_condense_block()
{
int temp_idx, idx, var_count, i;
var_count = sexp_variable_count();
temp_idx = MAX_SEXP_VARIABLES-1;
for (idx=MAX_SEXP_VARIABLES-1; idx>var_count-1; idx--) {
if (Sexp_variables[idx].type & SEXP_VARIABLE_BLOCK) {
if (temp_idx > idx) {
Sexp_variables[temp_idx] = Sexp_variables[idx];
Sexp_variables[idx].type = SEXP_VARIABLE_NOT_USED;
// now we need to check that nothing actually used this block
for (i = 0; i < MAX_SHIPS; i++) {
if (Ships[i].special_exp_index == idx) {
Ships[i].special_exp_index = temp_idx;
}
if (Ships[i].special_hitpoint_index == idx) {
Ships[i].special_hitpoint_index = temp_idx;
}
}
}
temp_idx--;
}
}
}
void sexp_variable_block_free(const char *ship_name, int start_index, int block_type)
{
int num_blocks;
if (block_type & SEXP_VARIABLE_BLOCK_EXP) {
num_blocks = BLOCK_EXP_SIZE;
} else if (block_type & SEXP_VARIABLE_BLOCK_HIT) {
num_blocks = BLOCK_HIT_SIZE;
} else {
Int3(); // new type of block
return;
}
for (int i=start_index; i<(start_index + num_blocks); i++) {
Assert(!stricmp(Sexp_variables[i].variable_name, ship_name));
Assert(Sexp_variables[i].type & block_type);
Sexp_variables[i].type = SEXP_VARIABLE_NOT_USED;
}
sexp_variable_condense_block();
}
// evaluate number which may result from an operator or may be text
int eval_num(int n)
{
if (n < 0)
{
Int3();
return 0;
}
if (CAR(n) != -1) // if argument is a sexp
return eval_sexp(CAR(n));
else
return atoi(CTEXT(n)); // otherwise, just get the number
}
// Goober5000 - for FRED2 menu subcategories
int get_subcategory(int sexp_id)
{
switch(sexp_id)
{
case OP_SEND_MESSAGE_LIST:
case OP_SEND_MESSAGE:
case OP_SEND_RANDOM_MESSAGE:
case OP_INVALIDATE_GOAL:
case OP_VALIDATE_GOAL:
case OP_SCRAMBLE_MESSAGES:
case OP_UNSCRAMBLE_MESSAGES:
case OP_ENABLE_BUILTIN_MESSAGES:
case OP_DISABLE_BUILTIN_MESSAGES:
case OP_SET_PERSONA:
return CHANGE_SUBCATEGORY_MESSAGING_AND_MISSION_GOALS;
case OP_ADD_GOAL:
case OP_REMOVE_GOAL:
case OP_CLEAR_GOALS:
case OP_GOOD_REARM_TIME:
case OP_GOOD_SECONDARY_TIME:
case OP_CHANGE_IFF:
case OP_CHANGE_AI_CLASS:
case OP_PROTECT_SHIP:
case OP_UNPROTECT_SHIP:
case OP_BEAM_PROTECT_SHIP:
case OP_BEAM_UNPROTECT_SHIP:
case OP_KAMIKAZE:
case OP_NOT_KAMIKAZE:
case OP_PLAYER_USE_AI:
case OP_PLAYER_NOT_USE_AI:
case OP_ALLOW_TREASON:
case OP_CHANGE_IFF_COLOR:
return CHANGE_SUBCATEGORY_AI_AND_IFF;
case OP_SABOTAGE_SUBSYSTEM:
case OP_REPAIR_SUBSYSTEM:
case OP_SET_SUBSYSTEM_STRNGTH:
case OP_SUBSYS_SET_RANDOM:
case OP_SELF_DESTRUCT:
case OP_TRANSFER_CARGO:
case OP_EXCHANGE_CARGO:
case OP_SET_CARGO:
case OP_JETTISON_CARGO:
case OP_CARGO_NO_DEPLETE:
case OP_SET_SCANNED:
case OP_SET_UNSCANNED:
case OP_LOCK_ROTATING_SUBSYSTEM:
case OP_FREE_ROTATING_SUBSYSTEM:
case OP_REVERSE_ROTATING_SUBSYSTEM:
case OP_ROTATING_SUBSYS_SET_TURN_TIME:
case OP_SET_PRIMARY_AMMO: // Karajorma
case OP_SET_SECONDARY_AMMO: // Karajorma
case OP_SET_PRIMARY_WEAPON: // Karajorma
case OP_SET_SECONDARY_WEAPON: // Karajorma
case OP_LOCK_PRIMARY_WEAPON:
case OP_UNLOCK_PRIMARY_WEAPON:
case OP_LOCK_SECONDARY_WEAPON:
case OP_UNLOCK_SECONDARY_WEAPON:
case OP_CHANGE_SUBSYSTEM_NAME:
case OP_LOCK_AFTERBURNER: // KeldorKatarn
case OP_UNLOCK_AFTERBURNER: // KeldorKatarn
case OP_SET_AFTERBURNER_ENERGY:
case OP_SET_WEAPON_ENERGY:
case OP_SET_SHIELD_ENERGY:
return CHANGE_SUBCATEGORY_SUBSYSTEMS_AND_CARGO;
case OP_SHIP_INVULNERABLE:
case OP_SHIP_VULNERABLE:
case OP_SHIP_BOMB_TARGETABLE:
case OP_SHIP_BOMB_UNTARGETABLE:
case OP_SHIP_GUARDIAN:
case OP_SHIP_NO_GUARDIAN:
case OP_SHIP_GUARDIAN_THRESHOLD:
case OP_SHIP_SUBSYS_GUARDIAN_THRESHOLD:
case OP_SHIP_INVISIBLE:
case OP_SHIP_VISIBLE:
case OP_SHIP_STEALTHY:
case OP_SHIP_UNSTEALTHY:
case OP_FRIENDLY_STEALTH_INVISIBLE:
case OP_FRIENDLY_STEALTH_VISIBLE:
case OP_SHIP_SUBSYS_TARGETABLE:
case OP_SHIP_SUBSYS_UNTARGETABLE:
case OP_WARP_BROKEN:
case OP_WARP_NOT_BROKEN:
case OP_WARP_NEVER:
case OP_WARP_ALLOWED:
return CHANGE_SUBCATEGORY_SHIP_STATUS;
case OP_BEAM_FIRE:
case OP_BEAM_FREE:
case OP_BEAM_FREE_ALL:
case OP_BEAM_LOCK:
case OP_BEAM_LOCK_ALL:
case OP_TURRET_FREE:
case OP_TURRET_FREE_ALL:
case OP_TURRET_LOCK:
case OP_TURRET_LOCK_ALL:
case OP_TURRET_TAGGED_ONLY_ALL:
case OP_TURRET_TAGGED_CLEAR_ALL:
case OP_TURRET_TAGGED_SPECIFIC:
case OP_TURRET_TAGGED_CLEAR_SPECIFIC:
case OP_TURRET_CHANGE_WEAPON:
case OP_TURRET_SET_TARGET_ORDER:
case OP_SHIP_TURRET_TARGET_ORDER:
case OP_TURRET_SUBSYS_TARGET_DISABLE:
case OP_TURRET_SUBSYS_TARGET_ENABLE:
return CHANGE_SUBCATEGORY_BEAMS_AND_TURRETS;
case OP_RED_ALERT:
case OP_END_MISSION:
case OP_FORCE_JUMP:
case OP_END_CAMPAIGN:
case OP_GRANT_PROMOTION:
case OP_GRANT_MEDAL:
case OP_ALLOW_SHIP:
case OP_ALLOW_WEAPON:
case OP_TECH_ADD_SHIP:
case OP_TECH_ADD_WEAPON:
case OP_TECH_ADD_INTEL:
case OP_TECH_RESET_TO_DEFAULT:
case OP_CHANGE_PLAYER_SCORE:
case OP_CHANGE_TEAM_SCORE:
return CHANGE_SUBCATEGORY_MISSION_AND_CAMPAIGN;
case OP_DONT_COLLIDE_INVISIBLE:
case OP_COLLIDE_INVISIBLE:
case OP_CHANGE_SHIP_CLASS:
case OP_DEACTIVATE_GLOW_POINTS:
case OP_ACTIVATE_GLOW_POINTS:
case OP_DEACTIVATE_GLOW_MAPS:
case OP_ACTIVATE_GLOW_MAPS:
case OP_DEACTIVATE_GLOW_POINT_BANK:
case OP_ACTIVATE_GLOW_POINT_BANK:
return CHANGE_SUBCATEGORY_MODELS_AND_TEXTURES;
case OP_SET_OBJECT_POSITION:
case OP_SET_OBJECT_FACING:
case OP_SET_OBJECT_FACING_OBJECT:
case OP_SET_OBJECT_SPEED_X:
case OP_SET_OBJECT_SPEED_Y:
case OP_SET_OBJECT_SPEED_Z:
return CHANGE_SUBCATEGORY_COORDINATE_MANIPULATION;
case OP_CHANGE_SOUNDTRACK:
case OP_PLAY_SOUND_FROM_TABLE:
case OP_PLAY_SOUND_FROM_FILE:
case OP_CLOSE_SOUND_FROM_FILE:
return CHANGE_SUBCATEGORY_MUSIC_AND_SOUND;
case OP_ADD_REMOVE_ESCORT:
case OP_AWACS_SET_RADIUS:
case OP_PRIMITIVE_SENSORS_SET_RANGE:
case OP_CAP_WAYPOINT_SPEED:
case OP_SET_SPECIAL_WARPOUT_NAME:
case OP_SHIP_CREATE:
case OP_WEAPON_CREATE:
case OP_SHIP_VANISH:
case OP_SHIP_VAPORIZE:
case OP_SHIP_NO_VAPORIZE:
case OP_SHIELDS_ON:
case OP_SHIELDS_OFF:
case OP_SHIP_TAG:
case OP_SHIP_UNTAG:
case OP_DAMAGED_ESCORT_LIST:
case OP_DAMAGED_ESCORT_LIST_ALL:
case OP_SET_SUPPORT_SHIP:
case OP_SHIP_CHANGE_ALT_NAME:
case OP_SET_DEATH_MESSAGE:
case OP_EXPLOSION_EFFECT:
case OP_WARP_EFFECT:
case OP_SHIP_COPY_DAMAGE:
return CHANGE_SUBCATEGORY_SPECIAL;
case OP_SET_SKYBOX_MODEL:
case OP_MISSION_SET_NEBULA:
case OP_ADD_BACKGROUND_BITMAP:
case OP_REMOVE_BACKGROUND_BITMAP:
case OP_ADD_SUN_BITMAP:
case OP_REMOVE_SUN_BITMAP:
case OP_NEBULA_CHANGE_STORM:
case OP_NEBULA_TOGGLE_POOF:
case OP_SET_AMBIENT_LIGHT:
return CHANGE_SUBCATEGORY_BACKGROUND_AND_NEBULA;
case OP_HUD_DISABLE:
case OP_HUD_DISABLE_EXCEPT_MESSAGES:
case OP_HUD_SET_TEXT:
case OP_HUD_SET_TEXT_NUM:
case OP_HUD_SET_COORDS:
case OP_HUD_SET_FRAME:
case OP_HUD_SET_COLOR:
case OP_HUD_SET_MAX_TARGETING_RANGE:
return CHANGE_SUBCATEGORY_HUD;
case OP_CUTSCENES_SET_CUTSCENE_BARS:
case OP_CUTSCENES_UNSET_CUTSCENE_BARS:
case OP_CUTSCENES_FADE_IN:
case OP_CUTSCENES_FADE_OUT:
case OP_CUTSCENES_SET_CAMERA:
case OP_CUTSCENES_SET_CAMERA_FACING:
case OP_CUTSCENES_SET_CAMERA_FACING_OBJECT:
case OP_CUTSCENES_SET_CAMERA_FOV:
case OP_CUTSCENES_SET_CAMERA_HOST:
case OP_CUTSCENES_SET_CAMERA_POSITION:
case OP_CUTSCENES_SET_CAMERA_ROTATION:
case OP_CUTSCENES_SET_CAMERA_TARGET:
case OP_CUTSCENES_SET_FOV:
case OP_CUTSCENES_RESET_FOV:
case OP_CUTSCENES_RESET_CAMERA:
case OP_CUTSCENES_SHOW_SUBTITLE:
case OP_CUTSCENES_SET_TIME_COMPRESSION:
case OP_CUTSCENES_RESET_TIME_COMPRESSION:
case OP_CUTSCENES_FORCE_PERSPECTIVE:
case OP_SET_CAMERA_SHUDDER:
case OP_SUPERNOVA_START:
return CHANGE_SUBCATEGORY_CUTSCENES;
case OP_JUMP_NODE_SET_JUMPNODE_COLOR:
case OP_JUMP_NODE_SET_JUMPNODE_MODEL:
case OP_JUMP_NODE_SHOW_JUMPNODE:
case OP_JUMP_NODE_HIDE_JUMPNODE:
return CHANGE_SUBCATEGORY_JUMP_NODES;
case OP_NUM_PLAYERS:
case OP_TEAM_SCORE:
case OP_SHIP_DEATHS:
case OP_RESPAWNS_LEFT:
case OP_IS_PLAYER:
return STATUS_SUBCATEGORY_MULTIPLAYER;
case OP_SHIELD_RECHARGE_PCT:
case OP_ENGINE_RECHARGE_PCT:
case OP_WEAPON_RECHARGE_PCT:
case OP_SHIELD_QUAD_LOW:
case OP_PRIMARY_AMMO_PCT:
case OP_SECONDARY_AMMO_PCT:
case OP_IS_PRIMARY_SELECTED:
case OP_IS_SECONDARY_SELECTED:
case OP_GET_PRIMARY_AMMO:
case OP_GET_SECONDARY_AMMO:
case OP_AFTERBURNER_LEFT:
case OP_WEAPON_ENERGY_LEFT:
case OP_PRIMARY_FIRED_SINCE:
case OP_SECONDARY_FIRED_SINCE:
return STATUS_SUBCATEGORY_SHIELDS_ENGINES_AND_WEAPONS;
case OP_CARGO_KNOWN_DELAY:
case OP_CAP_SUBSYS_CARGO_KNOWN_DELAY:
case OP_IS_CARGO:
return STATUS_SUBCATEGORY_CARGO;
case OP_HAS_BEEN_TAGGED_DELAY:
case OP_IS_TAGGED:
case OP_IS_SHIP_VISIBLE:
case OP_IS_SHIP_STEALTHY:
case OP_IS_FRIENDLY_STEALTH_VISIBLE:
return STATUS_SUBCATEGORY_SHIP_STATUS;
case OP_SHIELDS_LEFT:
case OP_HITS_LEFT:
case OP_HITS_LEFT_SUBSYSTEM:
case OP_SIM_HITS_LEFT:
case OP_GET_DAMAGE_CAUSED:
return STATUS_SUBCATEGORY_DAMAGE;
case OP_DISTANCE:
case OP_DISTANCE_SUBSYSTEM:
case OP_GET_OBJECT_X:
case OP_GET_OBJECT_Y:
case OP_GET_OBJECT_Z:
case OP_NUM_WITHIN_BOX:
return STATUS_SUBCATEGORY_DISTANCE_AND_COORDINATES;
case OP_WAS_PROMOTION_GRANTED:
case OP_WAS_MEDAL_GRANTED:
case OP_NUM_KILLS:
case OP_NUM_ASSISTS:
case OP_NUM_TYPE_KILLS:
case OP_NUM_CLASS_KILLS:
case OP_SHIP_SCORE:
return STATUS_SUBCATEGORY_KILLS_AND_SCORING;
default:
return -1; // sexp doesn't have a subcategory
}
}
sexp_help_struct Sexp_help[] = {
{ OP_PLUS, "Plus (Arithmetic operator)\r\n"
"\tAdds numbers and returns results.\r\n\r\n"
"Returns a number. Takes 2 or more numeric arguments." },
{ OP_MINUS, "Minus (Arithmetic operator)\r\n"
"\tSubtracts numbers and returns results.\r\n\r\n"
"Returns a number. Takes 2 or more numeric arguments." },
{ OP_MOD, "Mod (Arithmetic operator)\r\n"
"\tDivides numbers and returns the remainer.\r\n\r\n"
"Returns a number. Takes 2 or more numeric arguments." },
{ OP_MUL, "Multiply (Arithmetic operator)\r\n"
"\tMultiplies numbers and returns results.\r\n\r\n"
"Returns a number. Takes 2 or more numeric arguments." },
{ OP_DIV, "Divide (Arithmetic operator)\r\n"
"\tDivides numbers and returns results.\r\n\r\n"
"Returns a number. Takes 2 or more numeric arguments." },
{ OP_RAND, "Rand (Arithmetic operator)\r\n"
"\tGets a random number. This number will not change on successive calls to this sexp.\r\n\r\n"
"Returns a number. Takes 2 or 3 numeric arguments...\r\n"
"\t1:\tLow range of random number.\r\n"
"\t2:\tHigh range of random number.\r\n"
"\t3:\t(optional) A seed to use when generating numbers. (Setting this to 0 is the same as having no seed at all)" },
// Goober5000
{ OP_RAND_MULTIPLE, "Rand-multiple (Arithmetic operator)\r\n"
"\tGets a random number. This number can and will change between successive calls to this sexp.\r\n\r\n"
"Returns a number. Takes 2 or 3 numeric arguments...\r\n"
"\t1:\tLow range of random number.\r\n"
"\t2:\tHigh range of random number.\r\n"
"\t3:\t(optional) A seed to use when generating numbers. (Setting this to 0 is the same as having no seed at all)" },
// -------------------------- Nav Points --- Kazan --------------------------
{ OP_NAV_IS_VISITED, "Takes 1 argument: The Nav Point Name\r\n"
"Returns whether that nav point has been visited (player within 1000 meters)" },
{ OP_NAV_DISTANCE, "Takes 1 argument: The Nav point Name\r\n"
"Returns the distance from the player ship to that nav point" },
{ OP_NAV_ADD_WAYPOINT, "Takes 3 Arguments: NavPoint Name, Waypoint Path Name, Waypoint Path Point #\r\n"
"IE Setting up 'Nav 1' to be on the first Waypoint on Wapoint Path 'Intercept' the arguments would be:\r\n"
"'Nav 1', 'Intercept', '1'" },
{ OP_NAV_ADD_SHIP, "Takes 2 Arguments: NavPoint Name, Ship Name\r\n"
"Binds the named navpoint to the named ship - when the ship moves, the waypoint moves with it\r\n" },
{ OP_NAV_DEL, "Takes 1 Argument: NavPoint Name, and deletes that NavPoint" },
{ OP_NAV_HIDE, "Takes 1 Argument: NavPoint Name, it then 'hides' that Nav Point\n\r"
"This causes the nav point to be unselectable, if in the future the Nav Map screen is implemented\r\n"
"then a hidden nav point will not be displayed on it\r\n" },
{ OP_NAV_RESTRICT, "Takes 1 Argument: NavPoint Name, it then 'restricts' that Nav Point\n\r"
"This causes the nav point to be unselectable, if in the future the Nav Map screen is implemented\r\n"
"then a restrict nav point will be displayed on it, but unselectable\r\n" },
{ OP_NAV_UNHIDE, "Takes 1 Argument: NavPoint Name, it then unhides it\r\n" },
{ OP_NAV_UNRESTRICT, "Takes 1 Argument: NavPoint Name, it then unrestricts it\r\n" },
{ OP_NAV_SET_VISITED, "Takes 1 Argument: NavPoint Name, it then sets its visited flag\r\n" },
{ OP_NAV_UNSET_VISITED, "Takes 1 Argument: NavPoint Name, it then unsets its visited flag\r\n" },
{ OP_NAV_SET_CARRY, "Takes at least 1 argument, but can take as many as you give it.\r\n"
"It takes ship and/or wing names as sets their Nav Carry flag -- a ship with the nav carry flag\r\n"
"will autopilot with the player\r\n" },
{ OP_NAV_UNSET_CARRY, "Takes atleast 1 argument, but can take as many as you give it.\r\n"
"It takes ship and/or wing names and unsets their Nav Carry flag\r\n" },
{ OP_NAV_SET_NEEDSLINK, "Takes atleast 1 argument, but can take as many as you give it.\r\n"
"It takes ships and marks them as needing AutoNav linkup (approach within link distance)"},
{ OP_NAV_UNSET_NEEDSLINK, "Takes atleast 1 argument, but can take as many as you give it.\r\n"
"It takes ships and unmarks them as needing AutoNav linkup"},
{ OP_NAV_ISLINKED, "Takes 1 argument.\r\n"
"Determines if a ship is linked for autopilot (\"set-nav-carry\" or \"set-nav-needslink\" + linked)"},
{ OP_NAV_USECINEMATICS, "Takes 1 boolean argument.\r\n"
"Set to true to enable automatic cinematics, set to false to disable automatic cinematics." },
{ OP_NAV_USEAP, "Takes 1 boolean argument.\r\n"
"Set to true to enable autopilot, set to false to disable autopilot." },
// -------------------------- -------------------------- --------------------------
// Goober5000
{ OP_ABS, "Absolute value (Arithmetic operator)\r\n"
"\tReturns the absolute value of a number. Takes 1 numeric argument.\r\n" },
// Goober5000
{ OP_MIN, "Minimum value (Arithmetic operator)\r\n"
"\tReturns the minimum of a set of numbers. Takes 1 or more numeric arguments.\r\n" },
// Goober5000
{ OP_MAX, "Maximum value (Arithmetic operator)\r\n"
"\tReturns the maximum of a set of numbers. Takes 1 or more numeric arguments.\r\n" },
// Goober5000
{ OP_AVG, "Average value (Arithmetic operator)\r\n"
"\tReturns the average (rounded to the nearest integer) of a set of numbers. Takes 1 or more numeric arguments.\r\n" },
{ OP_SET_OBJECT_SPEED_X, "set-object-speed-x\r\n"
"\tSets the X speed of a ship, wing, or waypoint."
"Takes 2 or 3 arguments...\r\n"
"\t1: The name of the object.\r\n"
"\t2: The speed to set.\r\n"
"\t3: Whether the speed should be set subjectively; i.e. from the object's point of view (optional; defaults to false).\r\n" },
{ OP_SET_OBJECT_SPEED_Y, "set-object-speed-y\r\n"
"\tSets the Y speed of a ship, wing, or waypoint."
"Takes 2 or 3 arguments...\r\n"
"\t1: The name of the object.\r\n"
"\t2: The speed to set.\r\n"
"\t3: Whether the speed should be set subjectively; i.e. from the object's point of view (optional; defaults to false).\r\n" },
{ OP_SET_OBJECT_SPEED_Z, "set-object-speed-z\r\n"
"\tSets the Z speed of a ship, wing, or waypoint."
"Takes 2 or 3 arguments...\r\n"
"\t1: The name of the object.\r\n"
"\t2: The speed to set.\r\n"
"\t3: Whether the speed should be set subjectively; i.e. from the object's point of view (optional; defaults to false).\r\n" },
// Goober5000
{ OP_GET_OBJECT_X, "get-object-x\r\n"
"\tReturns the absolute X coordinate of a set of coordinates relative to a particular object (or object's "
"subsystem). The input coordinates are the coordinates relative to the object's position and orientation. "
"If no input coordinates are specified, the coordinate returned is the coordinate of the object (or object's "
"subsystem) itself. Takes 1 to 5 arguments...\r\n"
"\t1: The name of a ship, wing, or waypoint.\r\n"
"\t2: A ship subsystem (or \""SEXP_NONE_STRING"\" if the first argument is not a ship - optional).\r\n"
"\t3: The relative X coordinate (optional).\r\n"
"\t4: The relative Y coordinate (optional).\r\n"
"\t5: The relative Z coordinate (optional).\r\n" },
// Goober5000
{ OP_GET_OBJECT_Y, "get-object-y\r\n"
"\tReturns the absolute Y coordinate of a set of coordinates relative to a particular object (or object's "
"subsystem). The input coordinates are the coordinates relative to the object's position and orientation. "
"If no input coordinates are specified, the coordinate returned is the coordinate of the object (or object's "
"subsystem) itself. Takes 1 to 5 arguments...\r\n"
"\t1: The name of a ship, wing, or waypoint.\r\n"
"\t2: A ship subsystem (or \""SEXP_NONE_STRING"\" if the first argument is not a ship - optional).\r\n"
"\t3: The relative X coordinate (optional).\r\n"
"\t4: The relative Y coordinate (optional).\r\n"
"\t5: The relative Z coordinate (optional).\r\n" },
// Goober5000
{ OP_GET_OBJECT_Z, "get-object-z\r\n"
"\tReturns the absolute Z coordinate of a set of coordinates relative to a particular object (or object's "
"subsystem). The input coordinates are the coordinates relative to the object's position and orientation. "
"If no input coordinates are specified, the coordinate returned is the coordinate of the object (or object's "
"subsystem) itself. Takes 1 to 5 arguments...\r\n"
"\t1: The name of a ship, wing, or waypoint.\r\n"
"\t2: A ship subsystem (or \""SEXP_NONE_STRING"\" if the first argument is not a ship - optional).\r\n"
"\t3: The relative X coordinate (optional).\r\n"
"\t4: The relative Y coordinate (optional).\r\n"
"\t5: The relative Z coordinate (optional).\r\n" },
// Goober5000
{ OP_SET_OBJECT_POSITION, "set-object-position\r\n"
"\tInstantaneously sets an object's spatial coordinates."
"Takes 4 arguments...\r\n"
"\t1: The name of an object.\r\n"
"\t2: The new X coordinate.\r\n"
"\t3: The new Y coordinate.\r\n"
"\t4: The new Z coordinate." },
{ OP_TRUE, "True (Boolean operator)\r\n"
"\tA true boolean state\r\n\r\n"
"Returns a boolean value." },
{ OP_FALSE, "False (Boolean operator)\r\n"
"\tA false boolean state\r\n\r\n"
"Returns a boolean value." },
{ OP_AND, "And (Boolean operator)\r\n"
"\tAnd is true if all of its arguments are true.\r\n\r\n"
"Returns a boolean value. Takes 2 or more boolean arguments." },
{ OP_OR, "Or (Boolean operator)\r\n"
"\tOr is true if any of its arguments are true.\r\n\r\n"
"Returns a boolean value. Takes 2 or more boolean arguments." },
{ OP_EQUALS, "Equals (Boolean operator)\r\n"
"\tIs true if all of its arguments are equal.\r\n\r\n"
"Returns a boolean value. Takes 2 or more numeric arguments." },
{ OP_GREATER_THAN, "Greater Than (Boolean operator)\r\n"
"\tTrue if the first argument is greater than the second argument.\r\n\r\n"
"Returns a boolean value. Takes 2 numeric arguments." },
{ OP_LESS_THAN, "Less Than (Boolean operator)\r\n"
"\tTrue if the first argument is less than the second argument.\r\n\r\n"
"Returns a boolean value. Takes 2 numeric arguments." },
// Goober5000
{ OP_STRING_EQUALS, "String Equals (Boolean operator)\r\n"
"\tIs true if all of its arguments are equal.\r\n\r\n"
"Returns a boolean value. Takes 2 or more string arguments." },
// Goober5000
{ OP_STRING_GREATER_THAN, "String Greater Than (Boolean operator)\r\n"
"\tTrue if the first argument is greater than the second argument.\r\n\r\n"
"Returns a boolean value. Takes 2 string arguments." },
// Goober5000
{ OP_STRING_LESS_THAN, "String Less Than (Boolean operator)\r\n"
"\tTrue if the first argument is less than the second argument.\r\n\r\n"
"Returns a boolean value. Takes 2 string arguments." },
// Goober5000 - added wing capability
{ OP_IS_IFF, "Is IFF (Boolean operator)\r\n"
"\tTrue if ship(s) or wing(s) are all of the specified team.\r\n\r\n"
"Returns a boolean value. Takes 2 or more arguments...\r\n"
"\t1:\tTeam (\"friendly\", \"hostile\", \"neutral\", or \"unknown\").\r\n"
"\tRest:\tName of ship or wing to check." },
// Goober5000
{ OP_IS_AI_CLASS, "Is AI Class (Boolean operator)\r\n"
"\tTrue if ship or ship subsystem(s) is/are all of the specified AI class.\r\n\r\n"
"Returns a boolean value. Takes 2 or more arguments...\r\n"
"\t1:\tAI class (\"None\", \"Coward\", \"Lieutenant\", etc.)\r\n"
"\t2:\tName of ship to check.\r\n"
"\tRest:\tName of ship subsystem(s) to check (optional)" },
// Goober5000
{ OP_IS_SHIP_TYPE, "Is Ship Type (Boolean operator)\r\n"
"\tTrue if ship or ships is/are all of the specified ship type.\r\n\r\n"
"Returns a boolean value. Takes 2 or more arguments...\r\n"
"\t1:\tShip type (\"fighter\", \"bomber\", etc.)\r\n"
"\t2:\tName of ship to check.\r\n" },
// Goober5000
{ OP_IS_SHIP_CLASS, "Is Ship Class (Boolean operator)\r\n"
"\tTrue if ship or ships is/are all of the specified ship class.\r\n\r\n"
"Returns a boolean value. Takes 2 or more arguments...\r\n"
"\t1:\tShip class\r\n"
"\t2:\tName of ship to check.\r\n" },
{ OP_HAS_TIME_ELAPSED, "Has time elapsed (Boolean operator)\r\n"
"\tBecomes true when the specified amount of time has elapsed (Mission time "
"becomes greater than the specified time).\r\n"
"Returns a boolean value. Takes 1 numeric argument...\r\n"
"\t1:\tThe amount of time in seconds." },
{ OP_NOT, "Not (Boolean operator)\r\n"
"\tReturns opposite boolean value of argument (True becomes false, and "
"false becomes true).\r\n\r\n"
"Returns a boolean value. Takes 1 boolean argument." },
{ OP_PREVIOUS_GOAL_TRUE, "Previous Mission Goal True (Boolean operator)\r\n"
"\tReturns true if the specified goal in the specified mission is true "
"(or succeeded). It returns false otherwise.\r\n\r\n"
"Returns a boolean value. Takes 2 required arguments and 1 optional argument...\r\n"
"\t1:\tName of the mission.\r\n"
"\t2:\tName of the goal in the mission.\r\n"
"\t3:\t(Optional) True/False which signifies what this sexpession should return when "
"this mission is played as a single mission." },
{ OP_PREVIOUS_GOAL_FALSE, "Previous Mission Goal False (Boolean operator)\r\n"
"\tReturns true if the specified goal in the specified mission "
"is false (or failed). It returns false otherwise.\r\n\r\n"
"Returns a boolean value. Takes 2 required arguments and 1 optional argument...\r\n"
"\t1:\tName of the mission.\r\n"
"\t2:\tName of the goal in the mission.\r\n"
"\t3:\t(Optional) True/False which signifies what this sexpession should return when "
"this mission is played as a single mission." },
{ OP_PREVIOUS_GOAL_INCOMPLETE, "Previous Mission Goal Incomplete (Boolean operator)\r\n"
"\tReturns true if the specified goal in the specified mission "
"is incomplete (not true or false). It returns false otherwise.\r\n\r\n"
"Returns a boolean value. Takes 2 required arguments and 1 optional argument...\r\n"
"\t1:\tName of the mission.\r\n"
"\t2:\tName of the goal in the mission.\r\n"
"\t3:\t(Optional) True/False which signifies what this sexpession should return when "
"this mission is played as a single mission." },
{ OP_PREVIOUS_EVENT_TRUE, "Previous Mission Event True (Boolean operator)\r\n"
"\tReturns true if the specified event in the specified mission is true "
"(or succeeded). It returns false otherwise.\r\n\r\n"
"Returns a boolean value. Takes 2 required arguments and 1 optional argument...\r\n"
"\t1:\tName of the mission.\r\n"
"\t2:\tName of the event in the mission.\r\n"
"\t3:\t(Optional) True/False which signifies what this sexpession should return when "
"this mission is played as a single mission." },
{ OP_PREVIOUS_EVENT_FALSE, "Previous Mission Event False (Boolean operator)\r\n"
"\tReturns true if the specified event in the specified mission "
"is false (or failed). It returns false otherwise.\r\n\r\n"
"Returns a boolean value. Takes 2 required arguments and 1 optional argument...\r\n"
"\t1:\tName of the mission.\r\n"
"\t2:\tName of the event in the mission.\r\n"
"\t3:\t(Optional) True/False which signifies what this sexpession should return when "
"this mission is played as a single mission." },
{ OP_PREVIOUS_EVENT_INCOMPLETE, "Previous Mission Event Incomplete (Boolean operator)\r\n"
"\tReturns true if the specified event in the specified mission "
"is incomplete (not true or false). It returns false otherwise.\r\n\r\n"
"Returns a boolean value. Takes 2 required arguments and 1 optional argument...\r\n"
"\t1:\tName of the mission.\r\n"
"\t2:\tName of the event in the mission.\r\n"
"\t3:\t(Optional) True/False which signifies what this sexpession should return when "
"this mission is played as a single mission." },
{ OP_GOAL_TRUE_DELAY, "Mission Goal True (Boolean operator)\r\n"
"\tReturns true N seconds after the specified goal in the this mission is true "
"(or succeeded). It returns false otherwise.\r\n\r\n"
"Returns a boolean value. Takes 2 required arguments and 1 optional argument...\r\n"
"\t1:\tName of the event in the mission.\r\n"
"\t2:\tNumber of seconds to delay before returning true."},
{ OP_GOAL_FALSE_DELAY, "Mission Goal False (Boolean operator)\r\n"
"\tReturns true N seconds after the specified goal in the this mission is false "
"(or failed). It returns false otherwise.\r\n\r\n"
"Returns a boolean value. Takes 2 required arguments and 1 optional argument...\r\n"
"\t1:\tName of the event in the mission.\r\n"
"\t2:\tNumber of seconds to delay before returning true."},
{ OP_GOAL_INCOMPLETE, "Mission Goal Incomplete (Boolean operator)\r\n"
"\tReturns true if the specified goal in the this mission is incomplete. This "
"sexpression will only be useful in conjunction with another sexpression like"
"has-time-elapsed. Used alone, it will return true upon misison startup."
"Returns a boolean value. Takes 1 argument...\r\n"
"\t1:\tName of the event in the mission."},
{ OP_EVENT_TRUE_DELAY, "Mission Event True (Boolean operator)\r\n"
"\tReturns true N seconds after the specified event in the this mission is true "
"(or succeeded). It returns false otherwise.\r\n\r\n"
"Returns a boolean value. Takes 2 required arguments and 1 optional argument...\r\n"
"\t1:\tName of the event in the mission.\r\n"
"\t2:\tNumber of seconds to delay before returning true.\r\n"
"\t3:\t(Optional) True/False which signifies this is a current event, whether true, false, or unknown, for use as a directive."},
{ OP_EVENT_FALSE_DELAY, "Mission Event False (Boolean operator)\r\n"
"\tReturns true N seconds after the specified event in the this mission is false "
"(or failed). It returns false otherwise.\r\n\r\n"
"Returns a boolean value. Takes 2 required arguments and 1 optional argument...\r\n"
"\t1:\tName of the event in the mission.\r\n"
"\t2:\tNumber of seconds to delay before returning true.\r\n"
"\t3:\t(Optional) True/False which signifies this is a current event, whether true, false, or unknown, for use as a directive."},
{ OP_EVENT_INCOMPLETE, "Mission Event Incomplete (Boolean operator)\r\n"
"\tReturns true if the specified event in the this mission is incomplete. This "
"sexpression will only be useful in conjunction with another sexpression like"
"has-time-elapsed. Used alone, it will return true upon misison startup."
"Returns a boolean value. Takes 1 argument...\r\n"
"\t1:\tName of the event in the mission."},
{ OP_IS_DESTROYED_DELAY, "Is destroyed delay (Boolean operator)\r\n"
"\tBecomes true <delay> seconds after all specified ships have been destroyed.\r\n\r\n"
"Returns a boolean value. Takes 2 or more arguments...\r\n"
"\t1:\tTime delay in seconds (see above).\r\n"
"\tRest:\tName of ship (or wing) to check status of." },
{ OP_IS_SUBSYSTEM_DESTROYED_DELAY, "Is subsystem destroyed delay (Boolean operator)\r\n"
"\tBecomes true <delay> seconds after the specified subsystem of the specified "
"ship is destroyed.\r\n\r\n"
"Returns a boolean value. Takes 3 arguments...\r\n"
"\t1:\tName of ship the subsystem we are checking is on.\r\n"
"\t2:\tThe name of the subsystem we are checking status of.\r\n"
"\t3:\tTime delay in seconds (see above)." },
{ OP_IS_DISABLED_DELAY, "Is disabled delay (Boolean operator)\r\n"
"\tBecomes true <delay> seconds after the specified ship(s) are disabled. A "
"ship is disabled when all of its engine subsystems are destroyed. All "
"ships must be diabled for this function to return true.\r\n\r\n"
"Returns a boolean value. Takes 2 or more arguments...\r\n"
"\t1:\tTime delay is seconds (see above).\r\n"
"\tRest:\tNames of ships to check disabled status of." },
{ OP_IS_DISARMED_DELAY, "Is disarmed delay (Boolean operator)\r\n"
"\tBecomes true <delay> seconds after the specified ship(s) are disarmed. A "
"ship is disarmed when all of its turret subsystems are destroyed. All "
"ships must be disarmed for this function to return true.\r\n\r\n"
"Returns a boolean value. Takes 2 or more arguments...\r\n"
"\t1:\tTime delay is seconds (see above).\r\n"
"\tRest:\tNames of ships to check disarmed status of." },
{ OP_HAS_DOCKED_DELAY, "Has docked delay (Boolean operator)\r\n"
"\tBecomes true <delay> seconds after the specified ships have docked the "
"specified number of times.\r\n\r\n"
"Returns a boolean value. Takes 4 arguments...\r\n"
"\t1:\tThe name of the docker ship\r\n"
"\t2:\tThe name of the dockee ship\r\n"
"\t3:\tThe number of times they have to have docked\r\n"
"\t4:\tTime delay in seconds (see above)." },
{ OP_HAS_UNDOCKED_DELAY, "Has undocked delay (Boolean operator)\r\n"
"\tBecomes true <delay> seconds after the specified ships have undocked the "
"specified number of times.\r\n\r\n"
"Returns a boolean value. Takes 4 arguments...\r\n"
"\t1:\tThe name of the docker ship\r\n"
"\t2:\tThe name of the dockee ship\r\n"
"\t3:\tThe number of times they have to have undocked\r\n"
"\t4:\tTime delay in seconds (see above)." },
{ OP_HAS_ARRIVED_DELAY, "Has arrived delay (Boolean operator)\r\n"
"\tBecomes true <delay> seconds after the specified ship(s) have arrived into the mission\r\n\r\n"
"Returns a boolean value. Takes 2 or more arguments...\r\n"
"\t1:\tTime delay in seconds (see above).\r\n"
"\tRest:\tName of ship (or wing) we want to check has arrived." },
{ OP_HAS_DEPARTED_DELAY, "Has departed delay (Boolean operator)\r\n"
"\tBecomes true <delay> seconds after the specified ship(s) or wing(s) have departed "
"from the mission by warping out. If any ship was destroyed, this operator will "
"never be true.\r\n\r\n"
"Returns a boolean value. Takes 2 or more arguments...\r\n"
"\t1:\tTime delay in seconds (see above).\r\n"
"\tRest:\tName of ship (or wing) we want to check has departed." },
{ OP_WAYPOINTS_DONE_DELAY, "Waypoints done delay (Boolean operator)\r\n"
"\tBecomes true <delay> seconds after the specified ship has completed flying the "
"specified waypoint path.\r\n\r\n"
"Returns a boolean value. Takes 3 arguments...\r\n"
"\t1:\tName of ship we are checking.\r\n"
"\t2:\tWaypoint path we want to check if ship has flown.\r\n"
"\t3:\tTime delay in seconds (see above)." },
{ OP_SHIP_TYPE_DESTROYED, "Ship Type Destroyed (Boolean operator)\r\n"
"\tBecomes true when the specified percentage of ship types in this mission "
"have been destroyed. The ship type is a generic type such as fighter/bomber, "
"transport, etc. Fighters and bombers count as the same type.\r\n\r\n"
"Returns a boolean value. Takes 2 arguments...\r\n"
"\t1:\tPercentage of ships that must be destroyed.\r\n"
"\t2:\tShip type to check for." },
{ OP_TIME_SHIP_DESTROYED, "Time ship destroyed (Time operator)\r\n"
"\tReturns the time the specified ship was destroy.\r\n\r\n"
"Returns a numeric value. Takes 1 argument...\r\n"
"\t1:\tName of ship we want to check." },
{ OP_TIME_SHIP_ARRIVED, "Time ship arrived (Time operator)\r\n"
"\tReturns the time the specified ship arrived into the mission.\r\n\r\n"
"Returns a numeric value. Takes 1 argument...\r\n"
"\t1:\tName of ship we want to check." },
{ OP_TIME_SHIP_DEPARTED, "Time ship departed (Time operator)\r\n"
"\tReturns the time the specified ship departed the mission by warping out. Being "
"destroyed doesn't count departed.\r\n\r\n"
"Returns a numeric value. Takes 1 argument...\r\n"
"\t1:\tName of ship we want to check." },
{ OP_TIME_WING_DESTROYED, "Time wing destroyed (Time operator)\r\n"
"\tReturns the time the specified wing was destroy.\r\n\r\n"
"Returns a numeric value. Takes 1 argument...\r\n"
"\t1:\tName of wing we want to check." },
{ OP_TIME_WING_ARRIVED, "Time wing arrived (Time operator)\r\n"
"\tReturns the time the specified wing arrived into the mission.\r\n\r\n"
"Returns a numeric value. Takes 1 argument...\r\n"
"\t1:\tName of wing we want to check." },
{ OP_TIME_WING_DEPARTED, "Time wing departed (Time operator)\r\n"
"\tReturns the time the specified wing departed the mission by warping out. All "
"ships in the wing have to have warped out. If any are destroyed, the wing can "
"never be considered departed.\r\n\r\n"
"Returns a numeric value. Takes 1 argument...\r\n"
"\t1:\tName of ship we want to check." },
{ OP_MISSION_TIME, "Mission time (Time operator)\r\n"
"\tReturns the current time into the mission.\r\n\r\n"
"Returns a numeric value." },
{ OP_TIME_DOCKED, "Time docked (Time operator)\r\n"
"\tReturns the time the specified ships docked.\r\n\r\n"
"Returns a numeric value. Takes 3 arguments...\r\n"
"\t1:\tThe name of the docker ship.\r\n"
"\t2:\tThe name of the dockee ship.\r\n"
"\t3:\tThe number of times they must have docked to be true." },
{ OP_TIME_UNDOCKED, "Time undocked (Time operator)\r\n"
"\tReturns the time the specified ships undocked.\r\n\r\n"
"Returns a numeric value. Takes 3 arguments...\r\n"
"\t1:\tThe name of the docker ship.\r\n"
"\t2:\tThe name of the dockee ship.\r\n"
"\t3:\tThe number of times they must have undocked to be true." },
{ OP_AFTERBURNER_LEFT, "Afterburner left\r\n"
"\tReturns a ship's current engine energy as a percentage.\r\n"
"\t1: Ship name\r\n" },
{ OP_WEAPON_ENERGY_LEFT, "Weapon energy left\r\n"
"\tReturns a ship's current weapon energy as a percentage.\r\n"
"\t1: Ship name\r\n" },
{ OP_SHIELDS_LEFT, "Shields left (Status operator)\r\n"
"\tReturns the current level of the specified ship's shields as a percentage.\r\n\r\n"
"Returns a numeric value. Takes 1 argument...\r\n"
"\t1:\tName of ship to check." },
{ OP_HITS_LEFT, "Hits left (Status operator)\r\n"
"\tReturns the current level of the specified ship's hull as a percentage.\r\n\r\n"
"Returns a numeric value. Takes 1 argument...\r\n"
"\t1:\tName of ship to check." },
{ OP_HITS_LEFT_SUBSYSTEM, "Hits left subsystem (Status operator)\r\n"
"\tReturns the current level of the specified ship's subsystem integrity as a percentage\r\n"
"of the damage done to all subsystems of the same type.\r\n\r\n"
"Returns a numeric value. Takes 2 arguments...\r\n"
"\t1:\tName of ship to check.\r\n"
"\t2:\tName of subsystem on ship to check.\r\n"
"\t3:\t(Optional) True/False. When set to true only the subsystem supplied will be tested." },
{ OP_SIM_HITS_LEFT, "Simulated Hits left (Status operator)\r\n"
"\tReturns the current level of the specified ship's simulated hull as a percentage.\r\n\r\n"
"Returns a numeric value. Takes 1 argument...\r\n"
"\t1:\tName of ship to check." },
{ OP_DISTANCE, "Distance (Status operator)\r\n"
"\tReturns the distance between two objects. These objects can be either a ship, "
"a wing, or a waypoint.\r\n"
"When a wing or team is given (for either argument) the answer will be the shortest distance. \r\n\r\n"
"Returns a numeric value. Takes 2 arguments...\r\n"
"\t1:\tThe name of one of the objects.\r\n"
"\t2:\tThe name of the other object." },
{ OP_DISTANCE_SUBSYSTEM, "Distance from ship subsystem (Status operator)\r\n"
"\tReturns the distance between an object and a ship subsystem. The object can be either a ship, "
"a wing, or a waypoint.\r\n\r\n"
"Returns a numeric value. Takes 3 arguments...\r\n"
"\t1:\tThe name of the object.\r\n"
"\t2:\tThe name of the ship which houses the subsystem.\r\n"
"\t3:\tThe name of the subsystem." },
{ OP_NUM_WITHIN_BOX, "Number of specified objects in the box specified\r\n"
"\t1: Box center (X)\r\n"
"\t2: Box center (Y)\r\n"
"\t3: Box center (Z)\r\n"
"\t4: Box width\r\n"
"\t5: Box height\r\n"
"\t6: Box depth\r\n"
"\tRest:\tShips or wings to check" },
{ OP_GET_DAMAGE_CAUSED, "Get damage caused (Status operator)\r\n"
"\tReturns the amount of damage one or more ships have done to a ship.\r\n\r\n"
"Takes 2 or more arguments...\r\n"
"\t1:\tShip that has been damaged.\r\n"
"\t2:\tName of ships that may have damaged it." },
{ OP_LAST_ORDER_TIME, "Last order time (Status operator)\r\n"
"\tReturns true if <count> seconds have elapsed since one or more ships have received "
"a meaningful order from the player. A meaningful order is currently any order that "
"is not the warp out order.\r\n\r\n"
"Returns a boolean value. Takes 2 or more arguments...\r\n"
"\t1:\tTime in seconds that must elapse.\r\n"
"\tRest:\tName of ship or wing to check for having received orders." },
{ OP_WHEN, "When (Conditional operator)\r\n"
"\tPerforms specified actions when a condition becomes true\r\n\r\n"
"Takes 2 or more arguments...\r\n"
"\t1:\tBoolean expression that must be true for actions to take place.\r\n"
"\tRest:\tActions to take when boolean expression becomes true." },
{ OP_COND, "Blah" },
// Goober5000
{ OP_WHEN_ARGUMENT, "When-argument (Conditional operator)\r\n"
"\tPerforms specified actions when a condition, given a set of arguments, becomes true.\r\n\r\n"
"Takes 3 or more arguments...\r\n"
"\t1:\tThe arguments to evaluate (see any-of, every-of, random-of, etc.).\r\n"
"\t2:\tBoolean expression that must be true for actions to take place.\r\n"
"\tRest:\tActions to take when the boolean expression becomes true." },
// Goober5000
{ OP_EVERY_TIME, "Every-time (Conditional operator)\r\n"
"\tThis is a version of \"when\" that will always evaluate its arguments. It's useful "
"in situations where you need to repeatedly check things that may become true more than "
"once. Since this sexp will execute every time it's evaluated, you may need to use it as "
"an argument to \"when\" if you want to impose restrictions on how it's called.\r\n\r\n"
"Takes 2 or more arguments...\r\n"
"\t1:\tBoolean expression that must be true for actions to take place.\r\n"
"\tRest:\tActions to take when boolean expression is true." },
// Goober5000
{ OP_EVERY_TIME_ARGUMENT, "Every-time-argument (Conditional operator)\r\n"
"\tThis is a version of \"when-argument\" that will always evaluate its arguments. It's useful "
"in situations where you need to repeatedly check things that may become true more than "
"once. Since this sexp will execute every time it's evaluated, you may need to use it as "
"an argument to \"when\" (not \"when-argument\") if you want to impose restrictions on how it's called.\r\n\r\n"
"Takes 3 or more arguments...\r\n"
"\t1:\tThe arguments to evaluate (see any-of, all-of, random-of, etc.).\r\n"
"\t2:\tBoolean expression that must be true for actions to take place.\r\n"
"\tRest:\tActions to take when the boolean expression becomes true." },
// Karajorma
{ OP_DO_FOR_VALID_ARGUMENTS, "Do-for-valid-arguments (Conditional operator)\r\n"
"\tPerforms specified actions once for each valid " SEXP_ARGUMENT_STRING " in the parent conditional.\r\n"
"\tMust not be used for any SEXP that actually contains " SEXP_ARGUMENT_STRING " as these are already being executed\r\n"
"\tmultiple times without using Do-for-valid-arguments. Any use of " SEXP_ARGUMENT_STRING " and will \r\n"
"\tprevent execution of the entire SEXP unless it is nested inside another when(or every-time)-argument SEXP.\r\n\r\n"
"Takes 1 or more arguments...\r\n"
"\tAll:\tActions to take." },
// Goober5000
{ OP_ANY_OF, "Any-of (Conditional operator)\r\n"
"\tSupplies arguments for the " SEXP_ARGUMENT_STRING " special data item. Any of the supplied arguments can satisfy the expression(s) "
"in which " SEXP_ARGUMENT_STRING " is used.\r\n\r\n"
"Takes 1 or more arguments...\r\n"
"\tAll:\tAnything that could be used in place of " SEXP_ARGUMENT_STRING "." },
// Goober5000
{ OP_EVERY_OF, "Every-of (Conditional operator)\r\n"
"\tSupplies arguments for the " SEXP_ARGUMENT_STRING " special data item. Every one of the supplied arguments will be evaluated to satisfy the expression(s) "
"in which " SEXP_ARGUMENT_STRING " is used.\r\n\r\n"
"Takes 1 or more arguments...\r\n"
"\tAll:\tAnything that could be used in place of " SEXP_ARGUMENT_STRING "." },
// Goober5000
{ OP_RANDOM_OF, "Random-of (Conditional operator)\r\n"
"\tSupplies arguments for the " SEXP_ARGUMENT_STRING " special data item. A random supplied argument will be selected to satisfy the expression(s) "
"in which " SEXP_ARGUMENT_STRING " is used. The same argument will be returned by all subsequent calls\r\n\r\n"
"Takes 1 or more arguments...\r\n"
"\tAll:\tAnything that could be used in place of " SEXP_ARGUMENT_STRING "." },
// Karajorma
{ OP_RANDOM_MULTIPLE_OF, "Random-multiple-of (Conditional operator)\r\n"
"\tSupplies arguments for the " SEXP_ARGUMENT_STRING " special data item. A random supplied argument will be selected to satisfy the expression(s) "
"in which " SEXP_ARGUMENT_STRING " is used.\r\n\r\n"
"Takes 1 or more arguments...\r\n"
"\tAll:\tAnything that could be used in place of " SEXP_ARGUMENT_STRING "." },
// Goober5000
{ OP_NUMBER_OF, "Number-of (Conditional operator)\r\n"
"\tSupplies arguments for the " SEXP_ARGUMENT_STRING " special data item. Any [number] of the supplied arguments can satisfy the expression(s) "
"in which " SEXP_ARGUMENT_STRING " is used.\r\n\r\n"
"Takes 2 or more arguments...\r\n"
"\t1:\tNumber of arguments, as above\r\n"
"\tRest:\tAnything that could be used in place of " SEXP_ARGUMENT_STRING "." },
// Karajorma
{ OP_IN_SEQUENCE, "In-Sequence (Conditional operator)\r\n"
"\tSupplies arguments for the " SEXP_ARGUMENT_STRING " special data item. The first argument in the list will be selected to satisfy the expression(s) "
"in which " SEXP_ARGUMENT_STRING " is used. The same argument will be returned by all subsequent calls\r\n\r\n"
"Takes 1 or more arguments...\r\n"
"\tAll:\tAnything that could be used in place of " SEXP_ARGUMENT_STRING "." },
// Goober5000
{ OP_INVALIDATE_ARGUMENT, "Invalidate-argument (Conditional operator)\r\n"
"\tRemoves an argument from future consideration as a " SEXP_ARGUMENT_STRING " special data item.\r\n"
"Takes 1 or more arguments...\r\n"
"\tAll:\tThe argument to remove from the preceding argument list." },
// Karajorma
{ OP_VALIDATE_ARGUMENT, "Validate-argument (Conditional operator)\r\n"
"\tRestores an argument for future consideration as a " SEXP_ARGUMENT_STRING " special data item.\r\n"
"\tIf the argument hasn't been previously invalidated, it will do nothing.\r\n"
"Takes 1 or more arguments...\r\n"
"\tAll:\tThe argument to restore to the preceding argument list." },
// Goober5000 - added wing capability
{ OP_CHANGE_IFF, "Change IFF (Action operator)\r\n"
"\tSets the specified ship(s) or wing(s) to the specified team.\r\n"
"Takes 2 or more arguments...\r\n"
"\t1:\tTeam to change to (\"friendly\", \"hostile\" or \"unknown\").\r\n"
"\tRest:\tName of ship or wing to change team status of." },
// Wanderer
{ OP_CHANGE_IFF_COLOR, "Change IFF Color (Action operator)\r\n"
"\tSets the specified ship(s) or wing(s) apparent color.\r\n"
"Takes 6 or more arguments...\r\n"
"\t1:\tName of the team from which target is observed from.\r\n"
"\t2:\tName of the team of the observed target to receive the alternate color.\r\n"
"\t3:\tRed color (value from 0 to 255).\r\n"
"\t4:\tGreen color (value from 0 to 255).\r\n"
"\t5:\tBlue color (value from 0 to 255).\r\n"
"\tRest:\tName of ship or wing to change team status of." },
// Goober5000
{ OP_CHANGE_AI_CLASS, "Change AI Class (Action operator)\r\n"
"\tSets the specified ship or ship subsystem(s) to the specified ai class.\r\n"
"Takes 2 or more arguments...\r\n"
"\t1:\tAI Class to change to (\"None\", \"Coward\", \"Lieutenant\", etc.)\r\n"
"\t2:\tName of ship to change AI class of\r\n"
"\tRest:\tName of subsystem to change AI class of (optional)" },
{ OP_MODIFY_VARIABLE, "Modify-variable (Misc. operator)\r\n"
"\tModifies variable to specified value\r\n\r\n"
"Takes 2 arguments...\r\n"
"\t1:\tName of Variable.\r\n"
"\t2:\tValue to be set." },
{ OP_PROTECT_SHIP, "Protect ship (Action operator)\r\n"
"\tProtects a ship from being attacked by any enemy ship. Any ship"
"that is protected will not come under enemy fire.\r\n\r\n"
"Takes 1 or more arguments...\r\n"
"\tAll:\tName of ship(s) to protect." },
{ OP_UNPROTECT_SHIP, "Unprotect ship (Action operator)\r\n"
"\tUnprotects a ship from being attacked by any enemy ship. Any ship"
"that is not protected can come under enemy fire. This function is the opposite"
"of protect-ship.\r\n\r\n"
"Takes 1 or more arguments...\r\n"
"\tAll:\tName of ship(s) to protect." },
{ OP_BEAM_PROTECT_SHIP, "Beam Protect ship (Action operator)\r\n"
"\tProtects a ship from being attacked with beam weapon. Any ship"
"that is beam protected will not come under enemy beam fire.\r\n\r\n"
"Takes 1 or more arguments...\r\n"
"\tAll:\tName of ship(s) to protect." },
{ OP_BEAM_UNPROTECT_SHIP, "Beam Unprotect ship (Action operator)\r\n"
"\tUnprotects a ship from being attacked with beam weapon. Any ship"
"that is not beam protected can come under enemy beam fire. This function is the opposite"
"of beam-protect-ship.\r\n\r\n"
"Takes 1 or more arguments...\r\n"
"\tAll:\tName of ship(s) to protect." },
{ OP_SEND_MESSAGE, "Send message (Action operator)\r\n"
"\tSends a message to the player. Can be send by a ship, wing, or special "
"source. To send it from a special source, make the first character of the first "
"argument a \"#\".\r\n\r\n"
"Takes 3 arguments...\r\n"
"\t1:\tName of who the message is from.\r\n"
"\t2:\tPriority of message (\"Low\", \"Normal\" or \"High\").\r\n"
"\t3:\tName of message (from message editor)." },
// Karajorma
{ OP_ENABLE_BUILTIN_MESSAGES, "Enable builtin messages (Action operator)\r\n"
"\tTurns the built in messages sent by command or pilots on\r\n"
"Takes 0 or more arguments...\r\n"
"If no arguments are supplied any ships not given individual silence orders will be able\r\n"
"to send built in messages. Command will also be unsilenced\r\n"
"Using the Any Wingman option cancels radio silence for all ships in wings.\r\n"
"\tAll:\tName of ship to allow to talk." },
// Karajorma
{ OP_DISABLE_BUILTIN_MESSAGES, "Disable builtin messages (Action operator)\r\n"
"\tTurns the built in messages sent by command or pilots off\r\n"
"Takes 0 or more arguments....\r\n"
"If no arguments are supplied all built in messages are disabled.\r\n"
"Using the Any Wingman option silences for all ships in wings.\r\n"
"\tAll:\tName of ship to be silenced." },
// Karajorma
{ OP_SET_PERSONA, "Set Persona (Action operator)\r\n"
"\tSets the persona of the supplied ship to the persona supplied\r\n"
"Takes 2 or more arguments...\r\n"
"\t1:\tPersona to use."
"\tRest:\tName of the ship." },
{ OP_SELF_DESTRUCT, "Self destruct (Action operator)\r\n"
"\tCauses the specified ship(s) to self destruct.\r\n\r\n"
"Takes 1 or more arguments...\r\n"
"\tAll:\tName of ship to self destruct." },
{ OP_NEXT_MISSION, "Next Mission (Action operator)\r\n"
"\tThe next mission operator is used for campaign branching in the campaign editor. "
"It specifies which mission should played be next in the campaign. This operator "
"generally follows a 'when' or 'cond' statment in the campaign file.\r\n\r\n"
"Takes 1 argument...\r\n"
"\t1:\tName of mission (filename) to proceed to." },
{ OP_CLEAR_GOALS, "Clear goals (Action operator)\r\n"
"\tClears the goals for the specified ships and/or wings.\r\n\r\n"
"Takes 1 or more arguments...\r\n"
"\tAll:\tName of ship or wing." },
{ OP_ADD_GOAL, "Add goal (Action operator)\r\n"
"\tAdds a goal to a ship or wing.\r\n\r\n"
"Takes 2 arguments...\r\n"
"\t1:\tName of ship or wing to add goal to.\r\n"
"\t2:\tGoal to add." },
// Goober5000
{ OP_REMOVE_GOAL, "Remove goal (Action operator)\r\n"
"\tRemoves a goal from a ship or wing.\r\n\r\n"
"Takes 2 arguments...\r\n"
"\t1:\tName of ship or wing to remove goal from.\r\n"
"\t2:\tGoal to remove." },
{ OP_SABOTAGE_SUBSYSTEM, "Sabotage subystem (Action operator)\r\n"
"\tReduces the specified subsystem integrity by the specified percentage."
"If the percntage strength of the subsystem (after completion) is less than 0%,"
"subsystem strength is set to 0%.\r\n\r\n"
"Takes 3 arguments...\r\n"
"\t1:\tName of ship subsystem is on.\r\n"
"\t2:\tName of subsystem to sabotage.\r\n"
"\t3:\tPercentage to reduce subsystem integrity by." },
{ OP_REPAIR_SUBSYSTEM, "Repair Subystem (Action operator)\r\n"
"\tIncreases the specified subsystem integrity by the specified percentage."
"If the percntage strength of the subsystem (after completion) is greater than 100%,"
"subsystem strength is set to 100%.\r\n\r\n"
"Takes 4 arguments...\r\n"
"\t1:\tName of ship subsystem is on.\r\n"
"\t2:\tName of subsystem to repair.\r\n"
"\t3:\tPercentage to increase subsystem integrity by.\r\n"
"\t4:\tRepair turret submodel. Optional argument that defaults to true."},
{ OP_SET_SUBSYSTEM_STRNGTH, "Set Subsystem Strength (Action operator)\r\n"
"\tSets the specified subsystem to the the specified percentage."
"If the percentage specified is < 0, strength is set to 0. If the percentage is "
"> 100 % the subsystem strength is set to 100%.\r\n\r\n"
"Takes 3 arguments...\r\n"
"\t1:\tName of ship subsystem is on.\r\n"
"\t2:\tName of subsystem to set strength.\r\n"
"\t3:\tPercentage to set subsystem integrity to.\r\n"
"\t4:\tRepair turret submodel. Optional argument that defaults to true."},
{ OP_INVALIDATE_GOAL, "Invalidate goal (Action operator)\r\n"
"\tMakes a mission goal invalid, which causes it to not show up on mission goals "
"screen, or be evaluated.\r\n"
"Takes 1 or more arguments...\r\n"
"\tAll:\tName of mission goal to invalidate." },
{ OP_VALIDATE_GOAL, "Validate goal (Action operator)\r\n"
"\tMakes a mission goal valid again, so it shows up on mission goals screen.\r\n"
"Takes 1 or more arguments...\r\n"
"\tAll:\tName of mission goal to validate." },
{ OP_SEND_RANDOM_MESSAGE, "Send random message (Action operator)\r\n"
"\tSends a random message to the player from those supplied. Can be send by a "
"ship, wing, or special source. To send it from a special source, make the first "
"character of the first argument a \"#\".\r\n\r\n"
"Takes 3 or more arguments...\r\n"
"\t1:\tName of who the message is from.\r\n"
"\t2:\tPriority of message (\"Low\", \"Normal\" or \"High\")."
"\tRest:\tName of message (from message editor)." },
{ OP_TRANSFER_CARGO, "Transfer Cargo (Action operator)\r\n"
"\tTransfers the cargo from one ship to another ship.\r\n\r\n"
"Takes 2 arguments...\r\n"
"\t1:\tName of ship that cargo is being transferred from.\r\n"
"\t2:\tName of ship that cargo is being transferred to." },
{ OP_EXCHANGE_CARGO, "Exchange Cargo (Action operator)\r\n"
"\tExchanges the cargos of two ships. If one of the two ships contains no cargo, "
"the cargo is transferred instead.\r\n"
"Takes 2 arguments...\r\n"
"\t1:\tName of one of the ships.\r\n"
"\t2:\tName of the other ship." },
// Goober5000
{ OP_SET_CARGO, "Set Cargo (Action operator)\r\n"
"\tSets the cargo on a ship or ship subsystem. The cargo-no-deplete flag status is carried through to the new cargo.\r\n"
"Takes 2 or 3 arguments...\r\n"
"\t1:\tName of the cargo\r\n"
"\t2:\tName of the ship\r\n"
"\t3:\tName of the ship subsystem (optional)" },
// Goober5000
{ OP_IS_CARGO, "Is Cargo (Status operator)\r\n"
"\tChecks whether the specified ship or ship subsystem contains a particular cargo.\r\n"
"Takes 2 or 3 arguments...\r\n"
"\t1:\tName of the cargo\r\n"
"\t2:\tName of the ship\r\n"
"\t3:\tName of the ship subsystem (optional)" },
// Goober5000
{ OP_CHANGE_SOUNDTRACK, "change-soundtrack\r\n"
"\tChanges the mission music. Takes 1 argument...\r\n"
"\1: Name of the music selection (taken from music.tbl)" },
// Goober5000
{ OP_PLAY_SOUND_FROM_TABLE, "play-sound-from-table\r\n"
"\tPlays a sound listed in the Game Sounds section of sounds.tbl. Takes 4 arguments...\r\n"
"\t1: Origin X\r\n"
"\t2: Origin Y\r\n"
"\t3: Origin Z\r\n"
"\t4: Sound (index into sounds.tbl)" },
// Goober5000
{ OP_PLAY_SOUND_FROM_FILE, "play-sound-from-file\r\n"
"\tPlays a sound, such as a music soundtrack, from a file. Important: Only one sound at a time can be played with this sexp!\r\n"
"Takes 1 or 2 arguments...\r\n"
"\t1: Sound (file name)\r\n"
"\t2: Enter a non-zero number to loop. default is off (optional)."
},
// Goober5000
{ OP_CLOSE_SOUND_FROM_FILE, "close-sound-from-file\r\n"
"\tCloses the currently playing sound started by play-sound-from-file, if there is any. Takes 1 argument...\r\n"
"\t1: Fade (default is true)" },
// Goober5000
{ OP_EXPLOSION_EFFECT, "explosion-effect\r\n"
"\tCauses an explosion at a given origin, with the given parameters. "
"Takes 11 or 13 arguments...\r\n"
"\t1: Origin X\r\n"
"\t2: Origin Y\r\n"
"\t3: Origin Z\r\n"
"\t4: Damage\r\n"
"\t5: Blast force\r\n"
"\t6: Size of explosion (if 0, explosion will not be visible)\r\n"
"\t7: Inner radius to apply damage (if 0, explosion will not be visible)\r\n"
"\t8: Outer radius to apply damage (if 0, explosion will not be visible)\r\n"
"\t9: Shockwave speed (if 0, there will be no shockwave)\r\n"
"\t10: Type (0 = medium, 1 = large1, 2 = large2)\r\n"
"\t11: Sound (index into sounds.tbl)\r\n"
"\t12: EMP intensity (optional)\r\n"
"\t13: EMP duration in seconds (optional)" },
// Goober5000
{ OP_WARP_EFFECT, "warp-effect\r\n"
"\tCauses a subspace warp effect at a given origin, facing toward a given location, with the given parameters.\r\n"
"Takes 12 arguments...\r\n"
"\t1: Origin X\r\n"
"\t2: Origin Y\r\n"
"\t3: Origin Z\r\n"
"\t4: Location X\r\n"
"\t5: Location Y\r\n"
"\t6: Location Z\r\n"
"\t7: Radius\r\n"
"\t8: Duration in seconds\r\n"
"\t9: Warp opening sound (index into sounds.tbl)\r\n"
"\t10: Warp closing sound (index into sounds.tbl)\r\n"
"\t11: Type (0 for standard blue [default], 1 for Knossos green)\r\n"
"\t12: Shape (0 for 2-D [default], 1 for 3-D)" },
// Goober5000
{ OP_SET_OBJECT_FACING, "set-object-facing\r\n"
"\tSets an object's orientation to face the specified coordinates. "
"Takes 4 arguments...\r\n"
"\t1: The name of an object.\r\n"
"\t2: The X coordinate to face.\r\n"
"\t3: The Y coordinate to face.\r\n"
"\t4: The Z coordinate to face.\r\n"
"\t5: Turn time (optional)\r\n"
"\t6: Bank (optional)" },
// Goober5000
{ OP_SET_OBJECT_FACING_OBJECT, "set-object-facing-object\r\n"
"\tSets an object's orientation to face the specified object. "
"Takes 2 arguments...\r\n"
"\t1: The name of an object.\r\n"
"\t2: The object to face.\r\n"
"\t3: Turn time (optional)\r\n"
"\t4: Bank (optional)" },
// Goober5000
{ OP_SHIP_TAG, "ship-tag\r\n"
"\tTags a ship. Takes 3 or 8 arguments...\r\n"
"\t1: The name of a ship.\r\n"
"\t2: The tag level (currently 1, 2, or 3).\r\n"
"\t3: The tag time (in seconds).\r\n"
"\t4: A SSM missile (optional - used only for TAG-C).\r\n"
"\t5: The X origin of the SSM missile (optional - used only for TAG-C).\r\n"
"\t6: The Y origin of the SSM missile (optional - used only for TAG-C).\r\n"
"\t7: The Z origin of the SSM missile (optional - used only for TAG-C).\r\n"
"\t8: The team the SSM missile belongs to (optional - used only for TAG-C).\r\n" },
/* made obsolete by Goober5000 - it only works in debug builds anyway
{ OP_INT3, "Error (Debug directive)\r\n"
"Causes the game to halt with an error." },
*/
{ OP_AI_CHASE, "Ai-chase (Ship goal)\r\n"
"\tCauses the specified ship to chase and attack the specified target.\r\n\r\n"
"Takes 2 arguments...\r\n"
"\t1:\tName of ship to chase.\r\n"
"\t2:\tGoal priority (number between 0 and 89)." },
{ OP_AI_DOCK, "Ai-dock (Ship goal)\r\n"
"\tCauses one ship to dock with another ship.\r\n\r\n"
"Takes 4 arguments...\r\n"
"\t1:\tName of dockee ship (The ship that \"docker\" will dock with).\r\n"
"\t2:\tDocker's docking point - Which dock point docker uses to dock.\r\n"
"\t3:\tDockee's docking point - Which dock point on dockee docker will move to.\r\n"
"\t4:\tGoal priority (number between 0 and 89)." },
{ OP_AI_UNDOCK, "Ai-undock (Ship goal)\r\n"
"\tCauses the specified ship to undock from who it is currently docked with.\r\n\r\n"
"Takes 1 or 2 arguments...\r\n"
"\t1:\tGoal priority (number between 0 and 89).\r\n"
"\t2 (optional):\tShip to undock from. If none is specified, the code will pick the first docked ship." },
{ OP_AI_WARP_OUT, "Ai-warp-out (Ship/Wing Goal)\r\n"
"\tCauses the specified ship/wing to warp out of the mission. Currently, the ship will "
"warp out at its current location. This behavior will change. Currently, the first "
"argument means nothing.\r\n\r\n"
"Takes 2 arguments...\r\n"
"\t1:\tName of waypoint path to follow to warp out (not used).\r\n"
"\t2:\tGoal priority (number between 0 and 89)." },
{ OP_AI_WAYPOINTS, "Ai-waypoints (Ship goal)\r\n"
"\tCauses the specified ship to fly a waypoint path continuously.\r\n\r\n"
"Takes 2 arguments...\r\n"
"\t1:\tName of waypoint path to fly.\r\n"
"\t2:\tGoal priority (number between 0 and 89)." },
{ OP_AI_WAYPOINTS_ONCE, "Ai-waypoints once (Ship goal)\r\n"
"\tCauses the specified ship to fly a waypoint path.\r\n\r\n"
"Takes 2 arguments...\r\n"
"\t1:\tName of waypoint path to fly.\r\n"
"\t2:\tGoal priority (number between 0 and 89)." },
{ OP_AI_DESTROY_SUBSYS, "Ai-destroy subsys (Ship goal)\r\n"
"\tCauses the specified ship to attack and try and destroy the specified subsystem "
"on the specified ship.\r\n\r\n"
"Takes 3 arguments...\r\n"
"\t1:\tName of ship subsystem is on.\r\n"
"\t2:\tName of subsystem on the ship to attack and destroy.\r\n"
"\t3:\tGoal priority (number between 0 and 89)." },
{ OP_AI_CHASE_WING, "Ai-chase wing (Ship goal)\r\n"
"\tCauses the specified ship to chase and attack the specified target.\r\n\r\n"
"Takes 2 arguments...\r\n"
"\t1:\tName of wing to chase.\r\n"
"\t2:\tGoal priority (number between 0 and 89)." },
{ OP_AI_DISABLE_SHIP, "Ai-disable-ship (Ship/wing goal)\r\n"
"\tThis AI goal causes a ship/wing to destroy all of the engine subsystems on "
"the specified ship. This goal is different than ai-destroy-subsystem since a ship "
"may have multiple engine subsystems requiring the use of > 1 ai-destroy-subsystem "
"goals.\r\n\r\n"
"Takes 2 arguments...\r\n"
"\t1:\tName of ship whose engine subsystems should be destroyed\r\n"
"\t2:\tGoal priority (number between 0 and 89)." },
{ OP_AI_DISARM_SHIP, "Ai-disarm-ship (Ship/wing goal)\r\n"
"\tThis AI goal causes a ship/wing to destroy all of the turret subsystems on "
"the specified ship. This goal is different than ai-destroy-subsystem since a ship "
"may have multiple turret subsystems requiring the use of > 1 ai-destroy-subsystem "
"goals.\r\n\r\n"
"Takes 2 arguments...\r\n"
"\t1:\tName of ship whose turret subsystems should be destroyed\r\n"
"\t2:\tGoal priority (number between 0 and 89)." },
{ OP_AI_GUARD, "Ai-guard (Ship goal)\r\n"
"\tCauses the specified ship to guard a ship from other ships not on the same team.\r\n\r\n"
"Takes 2 arguments...\r\n"
"\t1:\tName of ship to guard.\r\n"
"\t2:\tGoal priority (number between 0 and 89)." },
{ OP_AI_CHASE_ANY, "Ai-chase-any (Ship goal)\r\n"
"\tCauses the specified ship to chase and attack any ship on the opposite team.\r\n\r\n"
"Takes 1 argument...\r\n"
"\t1:\tGoal priority (number between 0 and 89)." },
{ OP_AI_GUARD_WING, "Ai-guard wing (Ship goal)\r\n"
"\tCauses the specified ship to guard a wing of ships from other ships not on the "
"same team.\r\n\r\n"
"Takes 2 arguments...\r\n"
"\t1:\tName of wing to guard.\r\n"
"\t2:\tGoal priority (number between 0 and 89)." },
{ OP_NOP, "Do-nothing (Action operator)\r\n"
"\tDoes nothing. This is used as the default for any required action arguments "
"of an operator." },
{ OP_KEY_PRESSED, "Key-pressed (Boolean training operator)\r\n"
"\tBecomes true when the specified default key has been pressed. Default key "
"refers to the what the key normally is when not remapped. FreeSpace will "
"automatically account for any keys that have been remapped. If the optional "
"delay is specified, becomes true that many seconds after the key has been pressed.\r\n\r\n"
"Returns a boolean value. Takes 1 or 2 arguments...\r\n"
"\t1:\tDefault key to check for.\r\n"
"\t2:\tDelay before operator registers as true (optional).\r\n" },
{ OP_KEY_RESET, "Key-reset (Training operator)\r\n"
"\tMarks the specified default key as having not been pressed, so key-pressed will be false "
"until the player presses it again. See key-pressed help for more information about "
"what a default key is.\r\n\r\n"
"\tNote that this sexp will not work properly in repeating events. Use key-reset-multiple "
"if this is to be called multiple times in one event.\r\n\r\n"
"Returns a boolean value. Takes 1 or more arguments...\r\n"
"\tAll:\tDefault key to reset." },
// Goober5000
{ OP_KEY_RESET_MULTIPLE, "Key-reset-multiple (Training operator)\r\n"
"\tMarks the specified default key as having not been pressed, so key-pressed will be false "
"until the player presses it again. See key-pressed help for more information about "
"what a default key is.\r\n\r\n"
"\tThis sexp, unlike key-reset, will work properly if called multiple times in one event.\r\n\r\n"
"Returns a boolean value. Takes 1 or more arguments...\r\n"
"\tAll:\tDefault key to reset." },
{ OP_TARGETED, "Targeted (Boolean training operator)\r\n"
"\tIs true as long as the player has the specified ship (or ship's subsystem) targeted, "
"or has been targeted for the specified amount of time.\r\n\r\n"
"Returns a boolean value. Takes 1 to 3 arguments (first required, rest optional):\r\n"
"\t1:\tName of ship to check if targeted by player.\r\n"
"\t2:\tLength of time target should have been kept for (optional).\r\n"
"\t3:\tName of subsystem on ship to check if targeted (optional)." },
// Sesquipedalian
{ OP_MISSILE_LOCKED, "Missile-locked (Boolean training operator)\r\n"
"\tIs true as long as the player has had a missile lock for the specified amount of time. "
"Optional arguments require lock to be maintained on a specified ship (or ship's subsystem).\r\n\r\n"
"Returns a boolean value. Takes 1 to 3 arguments (first required, rest optional):\r\n"
"\t1:\tLength of time missile lock should have been kept for.\r\n"
"\t2:\tName of ship to check if locked onto by player (optional).\r\n"
"\t3:\tName of subsystem on ship to check if locked onto (optional)." },
{ OP_SPEED, "Speed (Boolean training operator)\r\n"
"\tBecomes true when the player has been within the specified speed range set by "
"set-training-context-speed for the specified amount of time.\r\n\r\n"
"Returns a boolean value. Takes 1 argument...\r\n"
"\t1:\tTime in seconds." },
{ OP_FACING, "Facing (Boolean training operator)\r\n"
"\tIs true as long as the specified ship is within the player's specified "
"forward cone. A forward cone is defined as any point that the angle between the "
"vector of the point and the player, and the forward facing vector is within the "
"given angle.\r\n\r\n"
"Returns a boolean value. Takes 2 argument...\r\n"
"\t1:\tShip to check is withing forward cone.\r\n"
"\t2:\tAngle in degrees of the forward cone." },
{ OP_FACING2, "Facing Waypoint(Boolean training operator)\r\n"
"\tIs true as long as the specified first waypoint is within the player's specified "
"forward cone. A forward cone is defined as any point that the angle between the "
"vector of the point and the player, and the forward facing vector is within the "
"given angle.\r\n\r\n"
"Returns a boolean value. Takes 2 argument...\r\n"
"\t1:\tName of waypoint path whose first point is withing forward cone.\r\n"
"\t2:\tAngle in degrees of the forward cone." },
// fixed by Goober5000 and then deprecated by Karajorma
{ OP_ORDER, "Order (Boolean training operator)\r\n"
"\tDeprecated - Use Query-Orders in any new mission.\r\n\r\n"
"\tBecomes true when the player had given the specified ship or wing the specified order.\r\n\r\n"
"Returns a boolean value. Takes 2 or 3 arguments...\r\n"
"\t1:\tName of ship or wing to check if given order to.\r\n"
"\t2:\tName of order to check if player has given.\r\n"
"\t3:\tName of the target of the order (optional)." },
{ OP_QUERY_ORDERS, "Query-Orders (Boolean training operator)\r\n"
"\tBecomes true when the player had given the specified ship or wing the specified order.\r\n\r\n"
"Returns a boolean value. Takes 2 or more arguments...\r\n"
"\t1:\tName of ship or wing to check if given order to.\r\n"
"\t2:\tName of order to check if player has given.\r\n"
"\t3:\tMaximum length of time since order was given. Use 0 for any time in the mission.\r\n"
"\t4:\tName of the target of the order (optional).\r\n"
"\t2:\tName of player ship giving the order(optional).\r\n"
"\t3:\tName of the subsystem for Destroy Subsystem orders.(optional)" },
// Karajorma
{ OP_RESET_ORDERS, "Reset-Orders (Action training operator)\r\n"
"\tResets the list of orders the player has given.\r\n"
"Takes no arguments." },
{ OP_WAYPOINT_MISSED, "Waypoint-missed (Boolean training operator)\r\n"
"\tBecomes true when a waypoint is flown, but the waypoint is ahead of the one "
"they are supposed to be flying. The one they are supposed to be flying is the "
"next one in sequence in the path after the last one they have hit.\r\n\r\n"
"Returns a boolean value. Takes no arguments." },
{ OP_PATH_FLOWN, "Path-flown (Boolean training operator)\r\n"
"\tBecomes true when all the waypoints in the path have been flown, in sequence.\r\n\r\n"
"Returns a boolean value. Takes no arguments." },
{ OP_WAYPOINT_TWICE, "Waypoint-twice (Boolean training operator)\r\n"
"\tBecomes true when a waypoint is hit that is before the last one hit, which "
"indicates they have flown a waypoint twice.\r\n\r\n"
"Returns a boolean value. Takes no arguments." },
{ OP_TRAINING_MSG, "Training-msg (Action training operator)\r\n"
"\tSends the player a training message. Uses the same messages as normal messages, "
"only they get displayed differently using this operator. If a secondary message "
"is specified, it is sent the last time, while the primary message is sent all other "
"times (event should have a repeat count greater than 1).\r\n\r\n"
"Takes 1-3 arguments...\r\n"
"\t1:\tName of primary message to send.\r\n"
"\t2:\tName of secondary message to send (optional).\r\n"
"\t3:\tDelay (in seconds) to wait before sending message. (optional)\r\n"
"\t4:\tAmount of Time (in seconds) to display message (optional)." },
{ OP_SET_TRAINING_CONTEXT_FLY_PATH, "Set-training-context-fly-path (Training context operator)\r\n"
"\tTells FreeSpace that the player is expected to fly a waypoint path. This must be "
"executed before waypoint-missed, waypoint-twice and path-flown operators become valid.\r\n\r\n"
"Takes 2 arguments...\r\n"
"\t1:\tName of waypoint path player should fly.\r\n"
"\t2:\tDistance away a player needs to be from a waypoint for it to be registered as flown." },
{ OP_SET_TRAINING_CONTEXT_SPEED, "Set-training-context-speed (Training context operator)\r\n"
"\tTells FreeSpace that the player is expected to fly within a certain speed range. Once "
"this operator has been executed, you can measure how long they have been within this "
"speed range with the speed operator.\r\n\r\n"
"Takes 2 arguments...\r\n"
"\t1:\tMinimum speed of range player is to fly between.\r\n"
"\t2:\tMaximum speed of range player is to fly between." },
// Karajorma
{ OP_STRING_TO_INT, "String-to-int \r\n"
"\tConverts a string into an integer. The string must only contain numeric characters "
"or zero is returned \r\n"
"Takes 1 argument...\r\n"
"\t1:\tString to convert." },
{ OP_GRANT_PROMOTION, "Grant promotion (Action operator)\r\n"
"\tIn a single player game, this function grants a player an automatic promotion to the "
"next rank which the player can obtain. If he is already at the highest rank, this "
"operator has no effect. It takes no arguments." },
{ OP_GRANT_MEDAL, "Grant medal (Action operator)\r\n"
"\tIn single player missions, this function grants the given medal to the player. "
"Currently, only 1 medal will be allowed to be given per mission.\r\n\r\n"
"Takes 1 argument...\r\n"
"\t1:\tName of medal to grant to player." },
{ OP_GOOD_SECONDARY_TIME, "Set prefered secondary weapons\r\n"
"\tThis sexpression is used to inform the AI about prefered secondary weapons to "
"fire during combat. When this expression is evaulated, any AI ships of the given "
"team prefer to fire the given weapon at the given ship. (Prefered over other "
"secondary weapons)\r\n\r\n"
"Takes 4 argument...\r\n"
"\t1:\tTeam name which will prefer firing given weapon\r\n"
"\t2:\tMaximum number of this type of weapon above team can fire.\r\n"
"\t3:\tWeapon name (list includes only the valid weapons for this expression\r\n"
"\t4:\tShip name at which the above named team should fire the above named weapon." },
{ OP_AND_IN_SEQUENCE, "And in sequence (Boolean operator)\r\n"
"\tReturns true if all of its arguments have become true in the order they are "
"listed in.\r\n\r\n"
"Returns a boolean value. Takes 2 or more boolean arguments." },
{ OP_SKILL_LEVEL_AT_LEAST, "Skill level at least (Boolean operator)\r\n"
"\tReturns true if the player has selected the given skill level or higher.\r\n\r\n"
"Returns a boolean value. Takes 1 argument...\r\n"
"\t1:\tName of the skill level to check." },
{ OP_NUM_PLAYERS, "Num players (Status operator)\r\n"
"\tReturns the current number of players (multiplayer) playing in the current mission.\r\n\r\n"
"Returns a numeric value. Takes no arguments." },
{ OP_IS_CARGO_KNOWN, "Is cargo known (Boolean operator)\r\n"
"\tReturns true if all of the specified objects' cargo is known by the player (i.e. they "
"have scanned each one.\r\n\r\n"
"Returns a boolean value. Takes 1 or more arguments...\r\n"
"\tAll:\tName of ship to check if its cargo is known." },
{ OP_HAS_BEEN_TAGGED_DELAY, "Has ship been tagged (delay) (Boolean operator)\r\n"
"\tReturns true if all of the specified ships have been tagged.\r\n\r\n"
"Returns a boolean value after <delay> seconds when all ships have been tagged. Takes 2 or more arguments...\r\n"
"\t1:\tDelay in seconds after which sexpression will return true when all cargo scanned."
"\tRest:\tNames of ships to check if tagged.." },
{ OP_CAP_SUBSYS_CARGO_KNOWN_DELAY, "Is capital ship subsystem cargo known (delay) (Boolean operator)\r\n"
"\tReturns true if all of the specified subsystem cargo is known by the player.\r\n"
"\tNote: Cargo must be explicitly named.\r\n\r\n"
"Returns a boolean value after <delay> seconds when all cargo is known. Takes 3 or more arguments...\r\n"
"\t1:\tDelay in seconds after which sexpression will return true when all cargo scanned.\r\n"
"\t2:\tName of capital ship\r\n"
"\tRest:\tNames of subsystems to check for cargo known.." },
{ OP_CARGO_KNOWN_DELAY, "Is cargo known (delay) (Boolean operator)\r\n"
"\tReturns true if all of the specified objects' cargo is known by the player (i.e. they "
"have scanned each one.\r\n\r\n"
"Returns a boolean value after <delay> seconds when all cargo is known. Takes 2 or more arguments...\r\n"
"\t1:\tDelay in seconds after which sexpression will return true when all cargo scanned."
"\tRest:\tNames of ships/cargo to check for cargo known.." },
{ OP_WAS_PROMOTION_GRANTED, "Was promotion granted (Boolean operator)\r\n"
"\tReturns true if a promotion was granted via the 'Grant promotion' operator in the mission.\r\n\r\n"
"Returns a boolean value. Takes no arguments." },
{ OP_WAS_MEDAL_GRANTED, "Was medal granted (Boolean operator)\r\n"
"\tReturns true if a medal was granted via via the 'Grant medal' operator in the mission. "
"If you provide the optional argument to this operator, then true is only returned if the "
"specified medal was granted.\r\n\r\n"
"Returns a boolean value. Takes 0 or 1 arguments...\r\n"
"\t1:\tName of medal to specifically check for (optional)." },
{ OP_GOOD_REARM_TIME, "Good rearm time (Action operator)\r\n"
"\tInforms the game logic that right now is a good time for a given team to attempt to "
"rearm their ships. The time parameter specified how long the \"good time\" will last.\r\n\r\n"
"Takes 2 arguments...\r\n"
"\t1:\tTeam Name\r\n"
"\t2:\tTime in seconds rearm window should last" },
{ OP_ALLOW_SHIP, "Allow ship (Action operator)\r\n"
"\tThis operator makes the given ship type available to the Terran team. Players will be "
"able to have ships of this type in their starting wings in all future missions of this "
"campaign.\r\n\r\n"
"Takes 1 argument...\r\n"
"\t1:\tName of ship type (or ship class) to allow." },
{ OP_ALLOW_WEAPON, "Allow weapon (Action operator)\r\n"
"\tThis operator makes the given weapon available to the Terran team. Players will be "
"able to equip ships with in all future missions of this campaign.\r\n\r\n"
"Takes 1 argument...\r\n"
"\t1:\tName of weapon (primary or secondary) to allow." },
{ OP_TECH_ADD_SHIP, "Tech add ship (Action operator)\r\n"
"\tThis operator makes the given ship type available in the techroom database. Players will "
"then be able to view this ship's specs there.\r\n\r\n"
"Takes 1 or more arguments...\r\n"
"\tAll:\tName of ship type (or ship class) to add." },
{ OP_TECH_ADD_WEAPON, "Tech add weapon (Action operator)\r\n"
"\tThis operator makes the given weapon available in the techroom database. Players will "
"then be able to view this weapon's specs there.\r\n\r\n"
"Takes 1 or more arguments...\r\n"
"\tAll:\tName of weapon (primary or secondary) to add." },
{ OP_TECH_ADD_INTEL, "Tech add intel (Action operator)\r\n"
"\tThis operator makes the given intel entry available in the techroom database. Players will "
"then be able to view this intel entry there.\r\n\r\n"
"Takes 1 or more arguments...\r\n"
"\tAll:\tName of intel entry to add." },
{ OP_TECH_RESET_TO_DEFAULT, "Tech reset to default (Action operator)\r\n"
"\tThis operator resets the tech room to the default represented in the tables. This is "
"useful for starting new campaigns, so that the player will not see tech entries carried over "
"from previous campaigns.\r\n\r\n"
"Takes no arguments." },
{ OP_CHANGE_PLAYER_SCORE, "Change Player Score (Action operator)\r\n"
"\tThis operator allows direct alteration of the player's score for this mission.\r\n\r\n"
"Takes 2 or more arguments."
"\t1:\tAmount to alter the player's score by.\r\n"
"\tRest:\tName of ship the player is flying."},
{ OP_CHANGE_TEAM_SCORE, "Change Team Score (Action operator)\r\n"
"\tThis operator allows direct alteration of the team's score for a TvT mission (Does nothing otherwise).\r\n\r\n"
"Takes 2 arguments."
"\t1:\tAmount to alter the team's score by.\r\n"
"\t2:\tThe team to alter the score for. (0 will add the score to all teams!)"},
{ OP_AI_EVADE_SHIP, "Ai-evade ship (Ship goal)\r\n"
"\tCauses the specified ship to go into evade mode and run away like the weak "
"sally-boy it is.\r\n\r\n"
"Takes 2 arguments...\r\n"
"\t1:\tName of ship to evade from.\r\n"
"\t2:\tGoal priority (number between 0 and 89)." },
{ OP_AI_STAY_NEAR_SHIP, "Ai-stay near ship (Ship goal)\r\n"
"\tCauses the specified ship to keep itself near the given ship and not stray too far "
"away from it.\r\n\r\n"
"Takes 2 arguments...\r\n"
"\t1:\tName of ship to stay near.\r\n"
"\t2:\tGoal priority (number between 0 and 89)." },
{ OP_AI_KEEP_SAFE_DISTANCE, "Ai-keep safe distance (Ship goal)\r\n"
"\tTells the specified ship to stay a safe distance away from any ship that isn't on the "
"same team as it.\r\n\r\n"
"Takes 1 argument...\r\n"
"\t1:\tGoal priority (number between 0 and 89)." },
{ OP_AI_IGNORE, "Ai-ignore (Ship goal)\r\n"
"\tTells all ships to ignore the given ship and not consider it as a valid "
"target to attack.\r\n\r\n"
"Takes 2 arguments...\r\n"
"\t1:\tName of ship to ignore.\r\n"
"\t2:\tGoal priority (number between 0 and 89)." },
// Goober5000
{ OP_AI_IGNORE_NEW, "Ai-ignore-new (Ship goal)\r\n"
"\tTells the specified ship to ignore the given ship and not consider it as a valid "
"target to attack.\r\n\r\n"
"Takes 2 arguments...\r\n"
"\t1:\tName of ship to ignore.\r\n"
"\t2:\tGoal priority (number between 0 and 89)." },
{ OP_AI_STAY_STILL, "Ai-stay still (Ship goal)\r\n"
"\tCauses the specified ship to stay still. The ship will do nothing until attacked at "
"which time the ship will come to life and defend itself.\r\n\r\n"
"Takes 2 arguments...\r\n"
"\t1:\tShip or waypoint the ship staying still will directly face (currently not implemented)\r\n"
"\t2:\tGoal priority (number between 0 and 89)." },
{ OP_AI_PLAY_DEAD, "Ai-play dead (Ship goal)\r\n"
"\tCauses the specified ship to pretend that it is dead and not do anything. This "
"expression should be used to indicate that a ship has no pilot and cannot respond "
"to any enemy threats. A ship playing dead will not respond to any attack. This "
"should really be named ai-is-dead\r\n\r\n"
"Takes 1 argument...\r\n"
"\t1:\tGoal priority (number between 0 and 89)." },
{ OP_FLASH_HUD_GAUGE, "Ai-flash hud gauge (Training goal)\r\n"
"\tCauses the specified hud gauge to flash to draw the player's attention to it.\r\n\r\n"
"Takes 1 argument...\r\n"
"\t1:\tName of hud gauge to flash." },
{ OP_SHIP_VISIBLE, "ship-visible\r\n"
"\tCauses the ships listed in this sexpression to be visible with player sensors.\r\n\r\n"
"Takes 1 or more arguments...\r\n"
"\t1+:\tName of ships to make visible to sensors." },
{ OP_SHIP_INVISIBLE, "ship-invisible\r\n"
"\tCauses the ships listed in this sexpression to be invisible to player sensors.\r\n\r\n"
"Takes 1 or more arguments...\r\n"
"\t1+:\tName of ships to make invisible to sensors." },
{ OP_SHIP_VULNERABLE, "ship-vulnerable\r\n"
"\tCauses the ship listed in this sexpression to be vulnerable to weapons.\r\n\r\n"
"Takes 1 or more arguments...\r\n"
"\t1+:\tName of ships to make vulnerable to weapons." },
{ OP_SHIP_INVULNERABLE, "ship-invulnerable\r\n"
"\tCauses the ships listed in this sexpression to be invulnerable to weapons. Use with caution!!!!\r\n\r\n"
"Takes 1 or more arguments...\r\n"
"\t1+:\tName of ships to make invulnerable to weapons." },
{ OP_SHIP_BOMB_TARGETABLE, "ship-targetable-as-bomb\r\n"
"\tCauses the ships listed in this sexpression to be targetable with bomb targetting key.\r\n\r\n"
"Takes 1 or more arguments...\r\n"
"\t1+:\tName of ships to make targetable with bomb targeting key." },
{ OP_SHIP_BOMB_UNTARGETABLE, "ship-untargetable-as-bomb\r\n"
"\tCauses the ships listed in this sexpression to not be targetable with bomb targetting key.\r\n\r\n"
"Takes 1 or more arguments...\r\n"
"\t1+:\tName of ships to make nontargetable with bomb targeting key." },
{ OP_SHIELDS_ON, "shields-on\r\n" //-Sesquipedalian
"\tCauses the ship listed in this sexpression to have their shields activated.\r\n\r\n"
"Takes 1 or more arguments...\r\n"
"\t1+:\tName of ships to activate shields on." },
{ OP_SHIELDS_OFF, "shields-off\r\n" //-Sesquipedalian
"\tCauses the ships listed in this sexpression to have their shields deactivated. \r\n\r\n"
"Takes 1 or more arguments...\r\n"
"\t1+:\tName of ships to deactivate shields on." },
{ OP_SHIP_GUARDIAN, "ship-guardian\r\n"
"\tCauses the ships listed in this sexpression to not be killable by weapons. Use with caution!!!!\r\n\r\n"
"Takes 1 or more arguments...\r\n"
"\t1+:\tName of ships to make unkillable." },
{ OP_SHIP_NO_GUARDIAN, "ship-no-guardian\r\n"
"\tCauses the ships listed in this sexpression to be killable by weapons, if not invulnerable.\r\n\r\n"
"Takes 1 or more arguments...\r\n"
"\t1+:\tName of ships to make killable." },
// Goober5000
{ OP_SHIP_GUARDIAN_THRESHOLD, "ship-guardian-threshold\r\n"
"\tSame as ship-guardian, except the lowest possible hull value is specified by the sexp rather than defaulting to 1.\r\n"
"Call with a threshold of 0 (or use ship-no-guardian) to deactivate.\r\n\r\n"
"Takes 2 or more arguments...\r\n"
"\t1:\tThreshold value.\r\n"
"\t2+:\tName of ships to make unkillable." },
// Goober5000
{ OP_SHIP_SUBSYS_GUARDIAN_THRESHOLD, "ship-subsys-guardian-threshold\r\n"
"\tSame as ship-guardian-threshold, but works on subsystems.\r\n"
"Call with a threshold of 0 to deactivate.\r\n\r\n"
"Takes 3 or more arguments...\r\n"
"\t1:\tThreshold value.\r\n"
"\t2:\tShip housing the subsystem(s).\r\n"
"\t3+:\tSubsystems to make unkillable." },
// Goober5000
{ OP_SHIP_STEALTHY, "ship-stealthy\r\n"
"\tCauses the ships listed in this sexpression to become stealth ships (i.e. invisible to radar).\r\n\r\n"
"Takes 1 or more arguments...\r\n"
"\tAll:\tName of ships to make stealthy." },
// Goober5000
{ OP_SHIP_UNSTEALTHY, "ship-unstealthy\r\n"
"\tCauses the ships listed in this sexpression to become non-stealth ships (i.e. visible to radar).\r\n\r\n"
"Takes 1 or more arguments...\r\n"
"\tAll:\tName of ships to make non-stealthy." },
// Goober5000
{ OP_FRIENDLY_STEALTH_INVISIBLE, "friendly-stealth-invisible\r\n"
"\tCauses the friendly ships listed in this sexpression to be invisible to radar, just like hostile stealth ships."
"It doesn't matter if the ship is friendly at the time this sexp executes: as long as it is a stealth ship, it will"
"be invisible to radar both as hostile and as friendly.\r\n\r\n"
"Takes 1 or more arguments...\r\n"
"\tAll:\tName of ships" },
// Goober5000
{ OP_FRIENDLY_STEALTH_VISIBLE, "friendly-stealth-visible\r\n"
"\tCauses the friendly ships listed in this sexpression to resume their normal behavior of being visible to radar as"
"stealth friendlies. Does not affect their visibility as stealth hostiles.\r\n\r\n"
"Takes 1 or more arguments...\r\n"
"\tAll:\tName of ships" },
// Goober5000
{ OP_SHIP_SUBSYS_TARGETABLE, "ship-subsys-targetable\r\n"
"\tCauses the specified ship subsystem(s) to be targetable on radar.\r\n"
"Takes 2 or more arguments...\r\n"
"\t1:\tName of a ship\r\n"
"\tRest: Name of the ship's subsystem(s)" },
// Goober5000
{ OP_SHIP_SUBSYS_UNTARGETABLE, "ship-subsys-untargetable\r\n"
"\tCauses the specified ship subsystem(s) to not be targetable on radar.\r\n"
"Takes 2 or more arguments...\r\n"
"\t1:\tName of a ship\r\n"
"\tRest: Name of the ship's subsystem(s)" },
// Goober5000
{ OP_SHIP_CHANGE_ALT_NAME, "ship-change-alt-name\r\n"
"\tChanges the alternate ship class name displayed in the HUD target window. Takes 2 or more arguments...\r\n"
"\t1:\tThe ship class name to display\r\n"
"\tRest:\tThe ships to display the new class name" },
// Goober5000
{ OP_SET_DEATH_MESSAGE, "set-death-message\r\n"
"\tSets the message displayed when the specified players are killed. Takes 1 or more arguments...\r\n"
"\t1:\tThe message\r\n"
"\tRest:\tThe players for whom this message is displayed (optional) (currently not implemented)" },
{ OP_PERCENT_SHIPS_DEPARTED, "percent-ships-departed\r\n"
"\tBoolean function which returns true if the percentage of ships in the listed ships and wings "
"which have departed is greater or equal to the given percentage. For wings, all ships of all waves "
"are used for calculation for the total possible ships to depart.\r\n\r\n"
"Takes 2 or more arguments...\r\n"
"\t1:\tPercentge of departed ships at which this function will return true.\r\n"
"\t2+:\tList of ships/wings whose departure status should be determined." },
{ OP_PERCENT_SHIPS_DESTROYED, "percent-ships-destroyed\r\n"
"\tBoolean function which returns true if the percentage of ships in the listed ships and wings "
"which have been destroyed is greater or equal to the given percentage. For wings, all ships of all waves "
"are used for calculation for the total possible ships to be destroyed.\r\n\r\n"
"Takes 2 or more arguments...\r\n"
"\t1:\tPercentge of destroyed ships at which this function will return true.\r\n"
"\t2+:\tList of ships/wings whose destroyed status should be determined." },
// Goober5000
{ OP_PERCENT_SHIPS_DISARMED, "percent-ships-disarmed\r\n"
"\tBoolean function which returns true if the percentage of ships in the listed ships "
"which have been disarmed is greater or equal to the given percentage.\r\n\r\n"
"Takes 2 or more arguments...\r\n"
"\t1:\tPercentge of disarmed ships at which this function will return true.\r\n"
"\t2+:\tList of ships whose disarmed status should be determined." },
// Goober5000
{ OP_PERCENT_SHIPS_DISABLED, "percent-ships-disabled\r\n"
"\tBoolean function which returns true if the percentage of ships in the listed ships "
"which have been disabled is greater or equal to the given percentage.\r\n\r\n"
"Takes 2 or more arguments...\r\n"
"\t1:\tPercentge of disabled ships at which this function will return true.\r\n"
"\t2+:\tList of ships whose disabled status should be determined." },
{ OP_RED_ALERT, "red-alert\r\n"
"\tCauses Red Alert status in a mission. This function ends the current mission, and moves to "
"the next mission in the campaign under red alert status. There should only be one branch from "
"a mission that uses this expression\r\n\r\n"
"Takes no arguments."},
{ OP_MISSION_SET_NEBULA, "mission-set-nebula\r\n"
"\tTurns nebula on/off\r\n"
"\tTakes1 argument...\r\n"
"\t1:\t0 for nebula off, 1 for nebula on" },
//-Sesquipedalian
{ OP_END_MISSION, "end-mission\r\n"
"\tEnds the mission as if the player had engaged his subspace drive, but without him doing so. Dumps the player back into a normal debriefing. Does not invoke red-alert status.\r\n"
"Takes no arguments." },
// Goober5000
{ OP_FORCE_JUMP, "force-jump\r\n"
"\tForces activation of the player's subspace drive, thus ending the mission. Takes no arguments."
},
// Goober5000
{ OP_SET_SCANNED, "set-scanned\r\n"
"\tSets the cargo on the specified ship or ship subsystem as known or scanned. Takes 1 or more arguments...\r\n"
"\t1:\tName of a ship\r\n"
"\tRest:\tName of a subsystem on that ship (optional)\r\n" },
// Goober5000
{ OP_SET_UNSCANNED, "set-unscanned\r\n"
"\tSets the cargo on the specified ship or ship subsystem as unknown or unscanned. Takes 1 or more arguments...\r\n"
"\t1:\tName of a ship\r\n"
"\tRest:\tName of a subsystem on that ship (optional)\r\n" },
{ OP_DEPART_NODE_DELAY, "depart-node-delay\r\n"
"\tReturns true N seconds after the listed ships depart, if those ships depart within the "
"radius of the given jump node. The delay value is given in seconds.\r\n\r\n"
"Takes 3 or more arguments...r\n"
"\t1:\tDelay in seconds after the last ship listed departed before this expression can return true.\r\n"
"\t2:\tName of a jump node\r\n"
"\t3+:\tList of ships to check for departure within radius of the jump node." },
{ OP_DESTROYED_DEPARTED_DELAY, "destroyed-or-departed-delay\r\n"
"\tReturns true N seconds after all the listed ships or wings have been destroyed or have "
"departed.\r\n\r\n"
"Takes 2 or more arguments...\r\n"
"\t1:\tDelay in seconds after the last ship/wing is destroyed or departed before this expression can return true.\r\n"
"\t2+:\tName of a ship or wing" },
// description added by Goober5000
{ OP_SPECIAL_CHECK, "Special-check\r\n"
"\tMike K.'s special training sexp. Returns a boolean value. Takes 1 argument as follows:\r\n"
"\t0: Ship \"Freighter 1\" is aspect locked by the player\r\n"
"\t1: Player has fired Interceptor#Weak at Freighter 1\r\n"
"\t2: Ship \"Freighter 1\", subsystem \"Weapons\" is aspect locked by the player\r\n"
"\t3: Apply 10 points of damage to player's forward shields (action operator)\r\n"
"\t4: Player's front shields are nearly gone\r\n"
"\t5: Quickly recharge player's front shields (action operator)\r\n"
"\t6: Reduce all shield quadrants except front to 0 (action operator)\r\n"
"\t7: Front shield quadrant is near maximum strength\r\n"
"\t8: Rear shield quadrant is near maximum strength\r\n"
"\t9: Reduce left and right shield quadrants to 0 (action operator)\r\n"
"\t10: Player has fewer than 8 missiles left\r\n"
"\t11: Player has 8 or more missiles left\r\n"
"\t12: Player has fewer than 4 missiles left\r\n"
"\t13: Reduce front shield quadrant to 0 (action operator)\r\n"
"\t100: Player is out of countermeasures\r\n"
"\t2000: Training failed"
},
{ OP_END_CAMPAIGN, "end-campaign\r\n"
"\tEnds the builtin campaign. Should only be used by the main FreeSpace campaign\r\n" },
{ OP_SHIP_VAPORIZE, "ship-vaporize\r\n"
"\tSets the ship to vaporize when it is destroyed. Does not actually destroy the ship - use self-destruct for that.\r\n"
"Takes 1 or more arguments...\r\n"
"\tAll:\tList of ships on which to set the vaporize flag" },
{ OP_SHIP_NO_VAPORIZE, "ship-no-vaporize\r\n"
"\tSets the ship to not vaporize when it is destroyed. Does not actually destroy the ship - use self-destruct for that.\r\n"
"Takes 1 or more arguments...\r\n"
"\tAll:\tList of ships on which to unset the vaporize flag" },
{ OP_DONT_COLLIDE_INVISIBLE, "don't-collide-invisible\r\n"
"\tSets the \"dont collide invisible\" flag on a list of ships. Takes 1 or more arguments..."
"\tAll:\tList of ships on which to set the \"dont collide invisible\" flag" },
{ OP_COLLIDE_INVISIBLE, "collide-invisible\r\n"
"\tUnsets the \"dont collide invisible\" flag on a list of ships. Takes 1 or more arguments..."
"\tAll:\tList of ships on which to unset the \"dont collide invisible\" flag" },
{ OP_WARP_BROKEN, "break-warp\r\n"
"\tBreak the warp drive on the specified ship. A broken warp drive can be repaired by "
"a repair ship. Takes 1 or more arguments...\r\n"
"\tAll:\tList of ships to break the warp drive on" },
{ OP_WARP_NOT_BROKEN, "fix-warp\r\n"
"\tFixes a broken warp drive instantaneously. This option applies to warp drives broken with "
"the break-warp sepxression. Takes 1 or more arguments...\r\n"
"\tAll:\tList of ships whose warp drive should be fixed"},
{ OP_WARP_NEVER, "never-warp\r\n"
"\tNever allows a ship to warp out. When this sexpression is used, the given ships will "
"never be able to warp out. The warp drive cannot be repaired. Takes 1 or more arguments...\r\n"
"\tAll:\tList of ships whose are not allowed to warp out under any condition"},
{ OP_WARP_ALLOWED, "allow-warp\r\n"
"\tAllows a ship which was previously not allowed to warp out to do so. When this sexpression is "
"used, the given ships will be able to warp out again. Takes 1 or more arguments...\r\n"
"\tAll:\tList of ships whose are allowed to warp out"},
{ OP_JETTISON_CARGO, "jettison-cargo-delay\r\n"
"\tCauses a cargo carrying ship to jettison its cargo without the undocking procedure. Takes 2 or more arguments...\r\n"
"\t1: Ship to jettison cargo\r\n"
"\t2: Delay after which to jettison cargo (note that this isn't actually used)\r\n"
"\tRest (optional): Cargo to jettison. If no optional arguments are specified, the ship jettisons all cargo.\r\n"
},
{ OP_BEAM_FIRE, "beam-fire\r\n"
"\tFire a beam weapon from a specified subsystem\r\n"
"\t1:\tShip which will be firing\r\n"
"\t2:\tTurret which will fire the beam (note, this turret must have at least 1 beam weapon on it)\r\n"
"\t3:\tShip which will be targeted\r\n"
"Use add-data to add a specific subsystem to target on the specified target ship"},
{ OP_IS_TAGGED, "is-tagged\r\n"
"\tReturns whether a given ship is tagged or not\r\n"},
{ OP_IS_PLAYER, "is-player\r\n"
"\tReturns true if all the ships specified are currently under control of a player.\r\n"
"\t1 \t(SinglePlayer) When true ships under AI control return false even if they are the player ship\r\n"
"\t \t(Multiplayer) When true ships that are respawning return true if the player is still connected\r\n"
"\tRest \tList of ships to test"},
{ OP_NUM_KILLS, "num-kills\r\n"
"\tReturns the # of kills a player has. The ship specified in the first field should be the ship the player is in.\r\n"
"\tSo, for single player, this would be Alpha 1. For multiplayer, it can be any ship with a player in it. If, at any\r\n"
"\ttime there is no player in a given ship, this sexpression will return 0"},
{ OP_NUM_ASSISTS, "num-assists\r\n"
"\tReturns the # of assists a player has. The ship specified in the first field should be the ship the player is in.\r\n"
"\tSo, for single player, this would be Alpha 1. For multiplayer, it can be any ship with a player in it. If, at any\r\n"
"\ttime there is no player in a given ship, this sexpression will return 0"},
{ OP_SHIP_SCORE, "ship-score\r\n"
"\tReturns the score a player has. The ship specified in the first field should be the ship the player is in.\r\n"
"\tSo, for single player, this would be Alpha 1. For multiplayer, it can be any ship with a player in it. If, at any\r\n"
"\ttime there is no player in a given ship, this sexpression will return 0"},
{ OP_SHIP_DEATHS, "ship-deaths\r\n"
"\tReturns the # times a ship that is a player start has died.\r\n"
"\tThe ship specified in the first field should be the ship that could have a player in.it\r\n"
"\tOnly really useful for multiplayer."},
{ OP_RESPAWNS_LEFT, "respawns-left\r\n"
"\tReturns the # respawns a player (or AI that could have been a player) has remaining.\r\n"
"\tThe ship specified in the first field should be the player start.\r\n"
"\tOnly really useful for multiplayer."},
{ OP_SET_RESPAWNS, "set-respawns\r\n"
"\tSet the # respawns a player (or AI that could have been a player) has used.\r\n"
"\t1: Number of respawns used up\r\n"
"\tRest: The player start ship to operate on.\r\n"
"\tOnly really useful for multiplayer."},
{ OP_NUM_TYPE_KILLS, "num-type-kills\r\n"
"\tReturns the # of kills a player has on a given ship type (fighter, bomber, cruiser, etc).\r\n"
"The ship specified in the first field should be the ship the player is in.\r\n"
"\tSo, for single player, this would be Alpha 1. For multiplayer, it can be any ship with a player in it. If, at any\r\n"
"\ttime there is no player in a given ship, this sexpression will return 0"},
{ OP_NUM_CLASS_KILLS, "num-class-kills\r\n"
"\tReturns the # of kills a player has on a specific ship class (Ulysses, Hercules, etc).\r\n"
"The ship specified in the first field should be the ship the player is in.\r\n"
"\tSo, for single player, this would be Alpha 1. For multiplayer, it can be any ship with a player in it. If, at any\r\n"
"\ttime there is no player in a given ship, this sexpression will return 0"},
{ OP_BEAM_FREE, "beam-free\r\n"
"\tSets one or more beam weapons to allow firing for a given ship\r\n"
"\t1: Ship to be operated on\r\n"
"\t2, 3, etc : List of turrets to activate\r\n"},
{ OP_BEAM_FREE_ALL, "beam-free-all\r\n"
"\tSets all beam weapons on the specified ship to be active\r\n"},
{ OP_BEAM_LOCK, "beam-lock\r\n"
"\tSets one or more beam weapons to NOT allow firing for a given ship\r\n"
"\t1: Ship to be operated on\r\n"
"\t2, 3, etc : List of turrets to deactivate\r\n"},
{ OP_BEAM_LOCK_ALL, "beam-lock-all\r\n"
"\tSets all beam weapons on the specified ship to be deactivated\r\n"},
{ OP_TURRET_FREE, "turret-free\r\n"
"\tSets one or more turret weapons to allow firing for a given ship\r\n"
"\t1: Ship to be operated on\r\n"
"\t2, 3, etc : List of turrets to activate\r\n"},
{ OP_TURRET_FREE_ALL, "turret-free-all\r\n"
"\tSets all turret weapons on the specified ship to be active\r\n"},
{ OP_TURRET_LOCK, "turret-lock\r\n"
"\tSets one or more turret weapons to NOT allow firing for a given ship\r\n"
"\t1: Ship to be operated on\r\n"
"\t2, 3, etc : List of turrets to deactivate\r\n"},
{ OP_TURRET_LOCK_ALL, "turret-lock-all\r\n"
"\tSets all turret weapons on the specified ship to be deactivated\r\n"},
{ OP_TURRET_CHANGE_WEAPON, "turret-change-weapon\r\n"
"\tSets a given turret weapon slot to the specified weapon\r\n"
"\t1: Ship turret is on\r\n"
"\t2: Turret\r\n"
"\t3: Weapon to set slot to\r\n"
"\t4: Primary slot (or 0 to use secondary)\r\n"
"\t5: Secondary slot (or 0 to use primary)"},
{ OP_TURRET_SET_TARGET_ORDER, "turret-set-target-order\r\n"
"\tSets targeting order of a given turret\r\n"
"\t1: Ship turret is on\r\n"
"\t2: Turret\r\n"
"\trest: Target order type (Bombs,ships,asteroids)"},
{ OP_SHIP_TURRET_TARGET_ORDER, "ship-turret-target-order\r\n"
"\tSets targeting order of all turrets on a given ship\r\n"
"\t1: Ship turrets are on\r\n"
"\trest: Target order type (Bombs,ships,asteroids)"},
{ OP_TURRET_SUBSYS_TARGET_DISABLE, "turret-subsys-target-disable\r\n"
"\tPrevents turrets from targeting only the subsystems when targeting large targets\r\n"
"\t1: Ship to be operated on\r\n"
"\trest: List of turrets that are affected\r\n"},
{ OP_TURRET_SUBSYS_TARGET_ENABLE, "turret-subsys-target-enable\r\n"
"\tSets turret to target the subsystems when targeting large targets\r\n"
"\t1: Ship to be operated on\r\n"
"\trest: List of turrets that are affected\r\n"},
{ OP_ADD_REMOVE_ESCORT, "add-remove-escort\r\n"
"\tAdds or removes a ship from an escort list.\r\n"
"\t1: Ship to be added or removed\r\n"
"\t2: 0 to remove from the list, any positive value will be used as the escort priority\r\n"
"NOTE : it _IS_ safe to add a ship which may already be on the list or remove\r\n"
"a ship which is not on the list\r\n"},
{ OP_AWACS_SET_RADIUS, "awacs-set-radius\r\n"
"\tSets the awacs radius for a given ship subsystem. NOTE : does not work properly in multiplayer\r\n"
"\t1: Ship which has the awacs subsystem\r\n"
"\t2: Awacs subsystem\r\n"
"\t3: New radius\r\n"},
// Goober5000
{ OP_PRIMITIVE_SENSORS_SET_RANGE, "primitive-sensors-set-range\r\n"
"\tSets the range of the primitive sensors on a ship. Ships outside of this range will not appear on "
"sensors. Has no effect on ships that do not have the \"primitive-sensors\" flag2 set. Takes 2 arguments...\r\n"
"\t1: Ship on which to set range\r\n"
"\t2: Range, in meters\r\n" },
{ OP_SEND_MESSAGE_LIST, "send-message-list\r\n"
"\tSends a series of delayed messages. All times are accumulated"
"\t1:\tName of who the message is from.\r\n"
"\t2:\tPriority of message (\"Low\", \"Normal\" or \"High\").\r\n"
"\t3:\tName of message (from message editor).\r\n"
"\t4:\tDelay from previous message in list (if any) in ms\r\n"
"Use Add-Data for multiple messages"
"IMPORTANT : each additional message in the list MUST HAVE 4 entries;\r\n"
"any message without the 4 proper fields will be ignored, as will any\r\n"
"successive messages"},
{ OP_CAP_WAYPOINT_SPEED, "cap-waypoint-speed\r\n"
"\tSets the maximum speed of a ship while flying waypoints.\r\n"
"\t1: Ship name\r\n"
"\t2: Maximum speed while flying waypoints\r\n"
"\tNOTE: This will only work if the ship is already in the game\r\n"
"\tNOTE: Set to -1 to reset\r\n"},
{ OP_TURRET_TAGGED_ONLY_ALL, "turret-tagged-only\r\n"
"\tMakes turrets target and hence fire strictly at tagged objects\r\n"
"\t1: Ship name\r\n"
"\tNOTE: Will not stop a turret already firing at an untagged ship\r\n"},
{ OP_TURRET_TAGGED_CLEAR_ALL, "turret-tagged-clear\r\n"
"\tRelaxes restriction on turrets targeting only tagged ships\r\n"
"\t1: Ship name\r\n"},
{ OP_PRIMARIES_DEPLETED, "primaries-depleted\r\n"
"\tReturns true if ship is out of primary weapons\r\n"
"\t1: Ship name\r\n"},
{ OP_SECONDARIES_DEPLETED, "secondaries-depleted\r\n"
"\tReturns true if ship is out of secondary weapons\r\n"
"\t1: Ship name\r\n"},
{ OP_SUBSYS_SET_RANDOM, "subsys-set-random\r\n"
"\tSets ship subsystem strength in a given range\r\n"
"\t1: Ship name\r\n"
"\t2: Low range\r\n"
"\t3: High range\r\n"
"\t4: List of subsys names not to be randomized\r\n"},
{ OP_SUPERNOVA_START, "supernova-start\r\n"
"\t1: Time in seconds until the supernova shockwave hits the player\r\n"},
{ OP_WEAPON_RECHARGE_PCT, "weapon-recharge-pct\r\n"
"\tReturns a percentage from 0 to 100\r\n"
"\t1: Ship name\r\n" },
{ OP_SHIELD_RECHARGE_PCT, "shield-recharge-pct\r\n"
"\tReturns a percentage from 0 to 100\r\n"
"\t1: Ship name\r\n" },
{ OP_ENGINE_RECHARGE_PCT, "engine-recharge-pct\r\n"
"\tReturns a percentage from 0 to 100\r\n"
"\t1: Ship name\r\n" },
{ OP_CARGO_NO_DEPLETE, "cargo-no-deplete\r\n"
"\tCauses the named ship to have unlimited cargo.\r\n"
"\tNote: only applies to BIG or HUGE ships\r\n"
"Takes 1 or more arguments...\r\n"
"\t1:\tName of one of the ships.\r\n"
"\t2:\toptional: 1 disallow depletion, 0 allow depletion." },
{ OP_SHIELD_QUAD_LOW, "shield-quad-low\r\n"
"\tReturns true if the specified ship has a shield quadrant below\r\n"
"\tthe specified threshold percentage\r\n"
"\t1: Ship name\r\n"
"\t2: Percentage\r\n" },
{ OP_PRIMARY_AMMO_PCT, "primary-ammo-pct\r\n"
"\tReturns the percentage of ammo remaining in the specified ballistic primary bank (0 to 100). Non-ballistic primary banks return as 100%.\r\n"
"\t1: Ship name\r\n"
"\t2: Bank to check (from 0 to N-1, where N is the number of primary banks in the ship; N or higher will return the cumulative average for all banks)" },
// Karajorma
{ OP_GET_PRIMARY_AMMO, "get-primary-ammo\r\n"
"\tReturns the amount of ammo remaining in the specified bank (0 to 100)\r\n"
"\t1: Ship name\r\n"
"\t2: Bank to check (from 0 to N-1, where N is the number of primary banks in the ship; N or higher will return the cumulative average for all banks)" },
{ OP_SECONDARY_AMMO_PCT, "secondary-ammo-pct\r\n"
"\tReturns the percentage of ammo remaining in the specified bank (0 to 100)\r\n"
"\t1: Ship name\r\n"
"\t2: Bank to check (from 0 to N-1, where N is the number of secondary banks in the ship; N or higher will return the cumulative average for all banks)" },
// Karajorma
{ OP_GET_SECONDARY_AMMO, "get-secondary-ammo\r\n"
"\tReturns the amount of ammo remaining in the specified bank (0 to 100)\r\n"
"\t1: Ship name\r\n"
"\t2: Bank to check (from 0 to N-1, where N is the number of secondary banks in the ship; N or higher will return the cumulative average for all banks)" },
{ OP_IS_SECONDARY_SELECTED, "is-secondary-selected\r\n"
"\tReturns true if the specified bank is selected (0 .. num_banks - 1)\r\n"
"\t1: Ship name\r\n"
"\t2: Bank to check (0 .. num_banks - 1)\r\n"},
{ OP_IS_PRIMARY_SELECTED, "is-primary-selected\r\n"
"\tReturns true if the specified bank is selected (0 .. num_banks - 1)\r\n"
"\t1: Ship name\r\n"
"\t2: Bank to check (0 .. num_banks - 1)\r\n"},
{ OP_SPECIAL_WARP_DISTANCE, "special-warp-dist\r\n"
"\tReturns distance to the plane of the knossos device in percent length of ship\r\n"
"\t(ie, 100 means front of ship is 1 ship length from plane of knossos device)\r\n"
"\t1: Ship name\r\n"},
{ OP_SET_SPECIAL_WARPOUT_NAME, "special-warpout-name\r\n"
"\tSets the name of the knossos device to be used for warpout\r\n"
"\t1: Ship name to exit\r\n"
"\t2: Name of knossos device\r\n"},
{ OP_SHIP_VANISH, "ship-vanish\r\n"
"\tMakes the named ship vanish (no log and vanish)\r\n"
"\tSingle Player Only! Warning: This will cause ship exit not to be logged, so 'has-departed', etc. will not work\r\n"
"\t1: List of ship names to vanish\r\n"},
{ OP_SHIP_CREATE, "ship-create\r\n"
"\tCreates a new ship\r\n"
"\tTakes 5 to 8 arguments...\r\n"
"\t1: Name of new ship (use \"" SEXP_NONE_STRING "\" for a default name)\r\n"
"\t2: Class of new ship\r\n"
"\t3: X position\r\n"
"\t4: Y position\r\n"
"\t5: Z position\r\n"
"\t6: Pitch (optional)\r\n"
"\t7: Bank (optional)\r\n"
"\t8: Heading (optional)\r\n"
},
// Goober5000
{ OP_WEAPON_CREATE, "weapon-create\r\n"
"\tCreates a new weapon\r\n"
"\tTakes 5 to 10 arguments...\r\n"
"\t 1: Name of parent ship (or \"" SEXP_NONE_STRING "\" for no parent)\r\n"
"\t 2: Class of new weapon\r\n"
"\t 3: X position\r\n"
"\t 4: Y position\r\n"
"\t 5: Z position\r\n"
"\t 6: Pitch (optional)\r\n"
"\t 7: Bank (optional)\r\n"
"\t 8: Heading (optional)\r\n"
"\t 9: Targeted ship (optional)\r\n"
"\t10: Targeted subsystem (optional)\r\n"
},
{ OP_IS_SHIP_VISIBLE, "is-ship-visible\r\n"
"\tCheck whether ship is visible on Player's radar\r\n"
"\tSingle Player Only! Returns 0 - not visible, 1 - partially visible, 2 - fully visible.\r\n"
"\t1: Name of ship to check\r\n"},
// Goober5000
{ OP_IS_SHIP_STEALTHY, "is-ship-stealthy\r\n"
"\tCheck whether ship is currently stealthy.\r\n"
"\tTrue if stealth flag set, false otherwise. Takes 1 argument...\r\n"
"\t1: Name of ship to check\r\n"},
// Goober5000
{ OP_IS_FRIENDLY_STEALTH_VISIBLE, "is-friendly-stealth-visible\r\n"
"\tCheck whether ship will be visible to radar as a stealth friendly.\r\n"
"\tTakes 1 argument...\r\n"
"\t1: Name of ship to check\r\n"},
{ OP_TEAM_SCORE, "team-score\r\n"
"\tGet the score of a multi team vs team game.\r\n"
"\t1: Team index (1 for team 1 and 2 for team 2)\r\n"},
// phreak
{ OP_DAMAGED_ESCORT_LIST, "damaged-escort-list\r\n"
"\tSets the most damaged ship in <ship list> to <priority1>, sets the others to <priority2>. Don't use this sexp in the same mission as damaged-escort-list-all, or strange results might occur.\r\n"
"\t1: Priority1\r\n"
"\t2: Priority2\r\n"
"\tRest: <ship_list>\r\n\r\n"
},
// Goober5000
{ OP_DAMAGED_ESCORT_LIST_ALL, "damaged-escort-list-all\r\n"
"\tSets the most damaged ship in the entire existing escort list (even what's not shown onscreen) to <priority1>, the next most damaged to <priority2>, and so on. "
"If there are more ships than priorities, the least most damaged ships are all set to the last priority in the list. Don't use this sexp in the same mission as damaged-escort-list, or strange results might occur.\r\n"
"\tTakes between 1 and MAX_COMPLETE_ESCORT_LIST (currently 20) arguments...\r\n"
"\t1: Priority 1\r\n"
"\tRest: Priorities 2 through 20 (optional)\r\n\r\n"
},
// Goober5000
{ OP_CHANGE_SHIP_CLASS, "change-ship-class\r\n"
"\tCauses the listed ships' classes to be changed to the specified ship class. Takes 2 or more arguments...\r\n"
"\t1: The name of the new ship class\r\n"
"\tRest: The list of ships to change the classes of"
},
// Goober5000
{ OP_SHIP_COPY_DAMAGE, "ship-copy-damage\r\n"
"\tCopies the damage (hull, shields, and subsystems) from the first ship in the list to the rest. The initial ship must be currently "
"present in the mission, but the target ships may be either in-mission or on the arrival list. Takes 2 or more arguments...\r\n"
"\t1: The name of the ship that supplies the damage stats\r\n"
"\tRest: The list of ships to be modified"
},
// Goober5000
{ OP_SET_SUPPORT_SHIP, "set-support-ship\r\n"
"\tSets information for all support ships in a mission. Takes 6 arguments...\r\n"
"\t1: Arrival location\r\n"
"\t2: Arrival anchor\r\n"
"\t3: Departure location\r\n"
"\t4: Departure anchor\r\n"
"\t5: Ship class\r\n"
"\t6: Maximum number of support ships in this mission (use a negative number for infinity)\r\n"
"\r\n"
"Note: The support ship will emerge from or depart into hyperspace if the location is set as hyperspace *or* the anchor is set as <no anchor>."
},
// Bobboau
{ OP_DEACTIVATE_GLOW_POINTS, "deactivate-glow-points\r\n"
"\tDeactivates all glow points on a ship. Takes 1 or more arguments...\r\n"
"\tAll: Name of ship on which to deactivate glow points\r\n"
},
// Bobboau
{ OP_ACTIVATE_GLOW_POINTS, "activate-glow-points\r\n"
"\tActivates all glow points on a ship. Takes 1 or more arguments...\r\n"
"\tAll: Name of ship on which to activate glow points\r\n"
},
// Bobboau
{ OP_DEACTIVATE_GLOW_MAPS, "deactivate-glow-maps\r\n"
"\tDeactivates the glow maps for a ship. Takes 1 or more arguments...\r\n"
"\tAll: Name of ship on which to deactivate glow maps\r\n"
},
// Bobboau
{ OP_ACTIVATE_GLOW_MAPS, "activate-glow-maps\r\n"
"\tActivates the glow maps for a ship. Takes 1 or more arguments...\r\n"
"\tAll: Name of ship on which to activate glow maps\r\n"
},
// Bobboau
{ OP_DEACTIVATE_GLOW_POINT_BANK, "deactivate-glow-point-bank\r\n"
"\tDeactivates one or more glow point bank(s) on a ship. Takes 2 or more arguments...\r\n"
"\t1: Name of ship on which to deactivate glow point bank(s)\r\n"
"\tRest: Name of glow point bank to deactivate\r\n"
},
// Bobboau
{ OP_ACTIVATE_GLOW_POINT_BANK, "activate-glow-point-bank\r\n"
"\tActivates one or more glow point bank(s) on a ship. Takes 2 or more arguments...\r\n"
"\t1: Name of ship on which to activate glow point bank(s)\r\n"
"\tRest: Name of glow point bank to activate\r\n"
},
//-Sesquipedalian
{ OP_KAMIKAZE, "kamikaze\r\n"
"\tTells ships to perform a kamikaze on its current target. Takes 2 or more arguments...\r\n"
"\t1: Damage dealt when kamikaze is done\r\n"
"\tRest: Names of ships to perform kamikaze\r\n"
},
//-Sesquipedalian
{ OP_NOT_KAMIKAZE, "not-kamikaze\r\n"
"\tTells ships abort a kamikaze run Takes 1 or more arguments....\r\n"
"\tAll: Names of ships to abort kamikaze\r\n"
},
//phreak
{ OP_TURRET_TAGGED_SPECIFIC, "turret-tagged-specific\r\n"
"\tSpecific turrets on a ship only fire at tagged targets, as opposed to all turrets doing this using turret-tagged-only\r\n"
"\tIt is safe to slave turrets already slaved\r\n"
"\tTakes 2 or more arguments...\r\n"
"\t1: Name of ship to slave some turrets to target only tagged ships\r\n"
"\tRest: Turrets to slave\r\n"
},
//phreak
{ OP_TURRET_TAGGED_CLEAR_SPECIFIC, "turret-tagged-clear-specific\r\n"
"\tSpecific turrets on a ship are free to fire on untagged ships, as opposed to all turrets doing this using turret-tagged-clear\r\n"
"\tIt is safe to unslave turrets already free\r\n"
"\tTakes 2 or more arguments...\r\n"
"\t1: Name of ship to unslave some turrets to target any hostile ship\r\n"
"\tRest: Turrets to unslave\r\n"
},
// Goober5000
{ OP_LOCK_ROTATING_SUBSYSTEM, "lock-rotating-subsystem\r\n"
"\tInstantaneously locks a rotating subsystem so that it cannot rotate unless freed by free-rotating-subsystem. "
"Takes 2 or more arguments...\r\n"
"\t1:\tName of the ship housing the subsystem\r\n"
"\tRest:\tName of the rotating subsystem to lock"
},
// Goober5000
{ OP_FREE_ROTATING_SUBSYSTEM, "free-rotating-subsystem\r\n"
"\tInstantaneously frees a rotating subsystem previously locked by lock-rotating-subsystem. "
"Takes 2 or more arguments...\r\n"
"\t1:\tName of the ship housing the subsystem\r\n"
"\tRest:\tName of the rotating subsystem to free"
},
// Goober5000
{ OP_REVERSE_ROTATING_SUBSYSTEM, "reverse-rotating-subsystem\r\n"
"\tInstantaneously reverses the rotation direction of a rotating subsystem. "
"Takes 2 or more arguments...\r\n"
"\t1:\tName of the ship housing the subsystem\r\n"
"\tRest:\tName of the rotating subsystem to reverse"
},
// Goober5000
{ OP_ROTATING_SUBSYS_SET_TURN_TIME, "rotating-subsys-set-turn-time\r\n"
"\tSets the turn time of a rotating subsystem. "
"Takes 3 or 4 arguments...\r\n"
"\t1:\tName of the ship housing the subsystem\r\n"
"\t2:\tName of the rotating subsystem to configure\r\n"
"\t3:\tThe time for one complete rotation, in milliseconds (positive is counterclockwise, negative is clockwise)\r\n"
"\t4:\tThe acceleration (x1000, just as #3 is seconds x1000) to change from the current turn rate to the desired turn rate. "
"Not sure of the units on this one. (FS2 defaults to 0.5, which would be 500 in this sexp.) Omit this argument if you want an instantaneous change."
},
// Karajorma
{ OP_SET_PRIMARY_AMMO, "set-primary-ammo\r\n"
"\tSets the amount of ammo for the specified ballistic bank\r\n"
"\t1: Ship name\r\n"
"\t2: Bank to check (0, 1, and 2 are legal banks)\r\n"
"\t3: Number to set this bank to (If this is larger than the maximimum, bank will be set to maximum).\r\n"
"\t4: Rearm Limit. Support ships will only supply this number of weapons (If this is larger than the maximimum, bank will be set to maximum)"
},
// Karajorma
{ OP_SET_SECONDARY_AMMO, "set-secondary-ammo\r\n"
"\tSets the amount of ammo for the specified bank\r\n"
"\t1: Ship name\r\n"
"\t2: Bank to check (0, 1, 2 and 3 are legal banks)\r\n"
"\t3: Number to set this bank to (If this is larger than the maximimum, bank will be set to maximum).\r\n"
"\t4: Rearm Limit. Support ships will only supply this number of weapons (If this is larger than the maximimum, bank will be set to maximum)"
},
// Karajorma
{ OP_SET_PRIMARY_WEAPON, "set-primary-weapon\r\n"
"\tSets the weapon for the specified bank\r\n"
"\t1: Ship name\r\n"
"\t2: Bank to check (0, 1 and 2 are legal banks)\r\n"
"\t3: Name of the primary weapon \r\n"
"\t4: Number to set this bank to (If this is larger than the maximimum, bank will be set to maximum)\r\n"
"\t5: Rearm Limit. Support ships will only supply this number of weapons (If this is larger than the maximimum, bank will be set to maximum)"
},
// Karajorma
{ OP_SET_SECONDARY_WEAPON, "set-secondary-weapon\r\n"
"\tSets the weapon for the specified bank\r\n"
"\t1: Ship name\r\n"
"\t2: Bank to check (0, 1, 2 and 3 are legal banks)\r\n"
"\t3: Name of the secondary weapon \r\n"
"\t4: Number to set this bank to (If this is larger than the maximimum, bank will be set to maximum)\r\n"
"\t5: Rearm Limit. Support ships will only supply this number of weapons (If this is larger than the maximimum, bank will be set to maximum)"
},
// Karajorma
{ OP_LOCK_PRIMARY_WEAPON, "lock-primary-weapon\r\n"
"\tLocks the primary banks for the specified ship(s)\r\n"
"\tTakes 1 or more arguments\r\n"
"\t(all): Name(s) of ship(s) to lock"
},
// Karajorma
{ OP_UNLOCK_PRIMARY_WEAPON, "unlock-primary-weapon\r\n"
"\tUnlocks the primary banks for the specified ship(s)\r\n"
"\tTakes 1 or more arguments\r\n"
"\t(all): Name(s) of ship(s) to lock"
},
// Karajorma
{ OP_LOCK_SECONDARY_WEAPON, "lock-secondary-weapon\r\n"
"\tLocks the secondary banks for the specified ship(s)\r\n"
"\tTakes 1 or more arguments\r\n"
"\t(all): Name(s) of ship(s) to lock"
},
// Karajorma
{ OP_UNLOCK_SECONDARY_WEAPON, "unlock-secondary-weapon\r\n"
"\tUnlocks the secondary banks for the specified ship(s)\r\n"
"\tTakes 1 or more arguments\r\n"
"\t(all): Name(s) of ship(s) to lock"
},
// KeldorKatarn
{ OP_LOCK_AFTERBURNER, "lock-afterburner\r\n"
"\tLocks the afterburners on the specified ship(s)\r\n"
"\tTakes 1 or more arguments\r\n"
"\t(all): Name(s) of ship(s) to lock"
},
// KeldorKatarn
{ OP_UNLOCK_AFTERBURNER, "unlock-afterburner\r\n"
"\tUnlocks the afterburners on the specified ship(s)\r\n"
"\tTakes 1 or more arguments\r\n"
"\t(all): Name(s) of ship(s) to lock"
},
// Karajorma
{ OP_SET_AFTERBURNER_ENERGY, "set-afterburner-energy\r\n"
"\tSets the afterburner energy for the specified ship(s)\r\n"
"\tTakes 2 or more arguments\r\n"
"\t1: percentage of maximum afterburner energy.\r\n"
"\t(rest): Name(s) of ship(s)"
},
{ OP_SET_WEAPON_ENERGY, "set-weapon-energy\r\n"
"\tSets the weapon energy for the specified ship(s)\r\n"
"\tTakes 2 or more arguments\r\n"
"\t1: percentage of maximum weapon energy.\r\n"
"\t(rest): Name(s) of ship(s)"
},
{ OP_SET_SHIELD_ENERGY, "set-shield-energy\r\n"
"\tSets the shield energy for the specified ship(s)\r\n"
"\tTakes 2 or more arguments\r\n"
"\t1: percentage of maximum shield energy.\r\n"
"\t(rest): Name(s) of ship(s)"
},
{ OP_SET_AMBIENT_LIGHT, "set-ambient-light\r\n"
"\tSets the ambient light level for the mission\r\n"
"\tTakes 3 arguments\r\n"
"\t1: Red (0 - 255).\r\n"
"\t2: Green (0 - 255).\r\n"
"\t3: Blue (0 - 255)."
},
{ OP_CHANGE_SUBSYSTEM_NAME, "change-subsystem-name\r\n"
"\tChanges the name of the specified subsystem on the specified ship\r\n"
"\tTakes 3 or more arguments\r\n"
"\t1: Name of the ship.\r\n"
"\t2: New name for the subsystem (names larger than the maximum display size will be truncated\r\n"
"\t3: Name(s) of subsystem(s) to rename\r\n"
},
//phreak
{ OP_NUM_SHIPS_IN_BATTLE, "num-ships-in-battle\r\n"
"\tReturns the number of ships in battle or the number of ships in battle for a given team. Takes 1 argument...\r\n"
"\t1:\tTeam to query (optional)"
},
// Karajorma
{ OP_NUM_SHIPS_IN_WING, "num-ships-in-wing\r\n"
"\tReturns the number of ships in battle which belong to a given wing. Takes 1 or more arguments...\r\n"
"\t(all):\tName of wing(s) to check"
},
// Goober5000
{ OP_HUD_DISABLE, "hud-disable\r\n"
"\tSets whether the hud is disabled. Takes 1 argument...\r\n"
"\t1: Flag (1 to disable, 0 to re-enable)"
},
// Goober5000
{ OP_HUD_DISABLE_EXCEPT_MESSAGES, "hud-disable-except-messages\r\n"
"\tSets whether the hud (except for messages) is disabled. Takes 1 argument...\r\n"
"\t1: Flag (1 to disable, 0 to re-enable)"
},
// Goober5000
{ OP_HUD_SET_MAX_TARGETING_RANGE, "hud-set-max-targeting-range\r\n"
"\tSets the farthest distance at which an object can be targeted. Takes 1 argument...\r\n"
"\1: Maximum targeting distance (0 for infinite)\r\n"
},
// Goober5000
{ OP_PLAYER_USE_AI, "player-use-ai\r\n"
"\tCauses the player's ship to be controlled by the FreeSpace AI. Takes 0 arguments.\r\n"
},
// Goober5000
{ OP_PLAYER_NOT_USE_AI, "player-not-use-ai\r\n"
"\tCauses the player's ship to not be controlled by the FreeSpace AI. Takes 0 arguments.\r\n"
},
// Karajorma
{ OP_ALLOW_TREASON, "allow-treason\r\n"
"\tTurns the Allow Traitor switch on or off in mission. Takes 0 arguments.\r\n"
"\t1:\tTrue/False."
},
//WMC
{ OP_HUD_SET_TEXT, "hud-set-text\r\n"
"\tSets the text value of a given HUD gauge. Works for custom and certain retail gauges. Takes 2 arguments...\r\n"
"\t1:\tHUD gauge to be modified\r\n"
"\t2:\tText to be set"
},
{ OP_HUD_SET_TEXT_NUM, "hud-set-text-num\r\n"
"\tSets the text value of a given HUD gauge to a number. Works for custom and certain retail gauges. Takes 2 arguments...\r\n"
"\t1:\tHUD gauge to be modified\r\n"
"\t2:\tNumber to be set"
},
//WMC
{ OP_HUD_SET_COORDS, "hud-set-coord\r\n"
"\tSets the coordinates of a given HUD gauge. Works for custom and retail gauges. Takes 3 arguments...\r\n"
"\t1:\tHUD gauge to be modified\r\n"
"\t2:\tCoordinate X component\r\n"
"\t2:\tCoordinate Y component"
},
//WMC
{ OP_HUD_SET_FRAME, "hud-set-frame\r\n"
"\tSets the frame of a given HUD gauge's associated image. Works for custom and certain retail gauges. Takes 2 arguments...\r\n"
"\t1:\tHUD gauge to be modified\r\n"
"\t2:\tFrame number to be changed to"
},
//WMC
{ OP_HUD_SET_COLOR, "hud-set-color\r\n"
"\tSets the color of a given HUD gauge. Works only for custom gauges Takes 4 arguments...\r\n"
"\t1:\tHUD gauge to be modified\r\n"
"\t2:\tRed component (0-255)\r\n"
"\t3:\tGreen component (0-255)\r\n"
"\t4:\tBlue component (0-255)"
},
//WMC
{ OP_CURRENT_SPEED, "current-speed\r\n"
"\tReturns the speed of the given object. Takes 1 argument...\r\n"
"\t1:\tHUD gauge to be modified"
},
// Karajora
{ OP_PRIMARY_FIRED_SINCE, "primary-fired-since\r\n"
"\tReturns true if the primary weapon bank specified has been fired within the supplied time. Takes 3 arguments...\r\n\r\n"
"\t1:\tShip name\r\n"
"\t2:\tWeapon bank number\r\n"
"\t3:\tDelay (in millieconds)\r\n"
},
// Karajora
{ OP_SECONDARY_FIRED_SINCE, "primary-fired-since\r\n"
"\tReturns true if the primary weapon bank specified has been fired within the supplied time. Takes 3 arguments...\r\n\r\n"
"\t1:\tShip name\r\n"
"\t2:\tWeapon bank number\r\n"
"\t3:\tDelay (in millieconds)\r\n"
},
//phreak
{ OP_SCRAMBLE_MESSAGES, "scramble-messages\r\n"
"\tCauses messages to be sent as if the player has sustained communications subsystem or EMP damage. Takes no arguments.\r\n"
"\tThis effect can be reversed using unscramble-messages."
},
//phreak
{ OP_UNSCRAMBLE_MESSAGES, "unscramble-messages\r\n"
"\tUndoes the effects of scramble-messages, causing messages to be sent clearly. Takes no arguments."
},
{ OP_CUTSCENES_SET_CUTSCENE_BARS, "set-cutscene-bars\r\n"
"\tShows bars at the top and bottom of screen "
"Takes 0 or 1 arguments...\r\n"
"\t1:\tMilliseconds for bars to slide in\r\n"
},
{ OP_CUTSCENES_UNSET_CUTSCENE_BARS, "unset-cutscene-bars\r\n"
"\tRemoves cutscene bars "
"Takes 0 or 1 arguments...\r\n"
"\t1:\tMilliseconds for bars to slide out\r\n"
},
{ OP_CUTSCENES_FADE_IN, "fade-in\r\n"
"\tFades in "
"Takes 0 or 1 arguments...\r\n"
"\t1:\tTime to fade in (in milliseconds)\r\n"
},
{ OP_CUTSCENES_FADE_OUT, "fade-out\r\n"
"\tFades out "
"Takes 0 to 2 arguments...\r\n"
"\t1:\tTime to fade in (in milliseconds)\r\n"
"\t2:\tColor to fade to - 1 for white, 2 for red, default is black\r\n"
},
{ OP_CUTSCENES_SET_CAMERA, "set-camera\r\n"
"\tSets SEXP camera, or another specified cutscene camera "
"Takes 0 to 1 arguments...\r\n"
"\t(optional)\r\n"
"\t1:\tCamera name (created if nonexistent)\r\n"
},
{ OP_CUTSCENES_SET_CAMERA_FACING, "set-camera-facing\r\n"
"\tMakes the camera face the given point "
"Takes 3 to 6 arguments...\r\n"
"\t1:\tX position to face\r\n"
"\t2:\tY position to face\r\n"
"\t3:\tZ position to face\r\n"
"\t(optional)\r\n"
"\t4:\tTotal turn time (milliseconds)\r\n"
"\t5:\tTime to spend accelerating/decelerating (milliseconds)\r\n"
"\t6:\tTime to spend decelerating (milliseconds)\r\n"
},
{ OP_CUTSCENES_SET_CAMERA_FACING_OBJECT, "set-camera-facing-object\r\n"
"\tMakes the camera face the given object "
"Takes 1 to 4 arguments...\r\n"
"\t1:\tObject to face\r\n"
"\t(optional)\r\n"
"\t2:\tTotal turn time (milliseconds)\r\n"
"\t3:\tTime to spend accelerating/decelerating (milliseconds)\r\n"
"\t4:\tTime to spend decelerating (milliseconds)\r\n"
},
{ OP_CUTSCENES_SET_CAMERA_FOV, "set-camera-fov\r\n"
"\tSets the camera field of view "
"Takes 1 to 4 arguments...\r\n"
"\t1:\tNew FOV (degrees)\r\n"
"\t(optional)\r\n"
"\t2:\tTotal zoom time (milliseconds)\r\n"
"\t3:\tTime to spend accelerating/decelerating (milliseconds)\r\n"
"\t4:\tTime to spend decelerating (milliseconds)\r\n"
},
{ OP_CUTSCENES_SET_CAMERA_HOST, "set-camera-host\r\n"
"\tSets the object and subystem camera should view from. Camera position is offset from the host. "
"Camera orientation is also offset from host, unless a valid camera target is set."
"Takes 1 to 2 arguments...\r\n"
"\t1:\tShip to mount camera on\r\n"
"\t(optional)\r\n"
"\t2:\tSubystem to mount camera on\r\n"
},
{ OP_CUTSCENES_SET_CAMERA_POSITION, "set-camera-position\r\n"
"\tSets the camera position to a spot in mission space "
"Takes 3 to 6 arguments...\r\n"
"\t1:\tX position\r\n"
"\t2:\tY position\r\n"
"\t3:\tZ position\r\n"
"\t(optional)\r\n"
"\t4:\tTotal turn time (milliseconds)\r\n"
"\t5:\tTime to spend accelerating/decelerating (milliseconds)\r\n"
"\t6:\tTime to spend decelerating (milliseconds)\r\n"
},
{ OP_CUTSCENES_SET_CAMERA_ROTATION, "set-camera-rotation\r\n"
"\tSets the camera rotation "
"Takes 3 to 6 arguments...\r\n"
"\t1:\tPitch (degrees)\r\n"
"\t2:\tBank (degrees)\r\n"
"\t3:\tHeading (degrees)\r\n"
"\t(optional)\r\n"
"\t4:\tTotal turn time (milliseconds)\r\n"
"\t5:\tTime to spend accelerating/decelerating (milliseconds)\r\n"
"\t6:\tTime to spend decelerating (milliseconds)\r\n"
},
{ OP_CUTSCENES_SET_CAMERA_TARGET, "set-camera-target\r\n"
"\tSets the object and subystem camera should track. Camera orientation is offset from the target "
"Takes 1 to 2 arguments...\r\n"
"\t1:\tShip to track\r\n"
"\t(optional)\r\n"
"\t2:\tSubystem to track\r\n"
},
{ OP_CUTSCENES_SET_FOV, "set-fov\r\n"
"\tSets the field of view - overrides all camera settings "
"Takes 1 argument...\r\n"
"\t1:\tNew FOV (degrees)\r\n"
},
{ OP_CUTSCENES_RESET_FOV, "reset-fov\r\n"
"\tResets the field of view "
},
{ OP_CUTSCENES_RESET_CAMERA, "reset-camera\r\n"
"\tReleases cutscene camera control "
"Takes 1 optional argument...\r\n"
"\t(optional)\r\n"
"\t1:\tReset camera data (Position, facing, FOV...) (default: false)"
},
{ OP_CUTSCENES_SHOW_SUBTITLE, "show-subtitle\r\n"
"\tShows a subtitle "
"Takes 4 to 12 arguments...\r\n"
"\t1:\tX position (negative value to be from right of screen)\r\n"
"\t2:\tY position (negative value to be from bottom of screen)\r\n"
"\t3:\tText to display\r\n"
"\t4:\tTime to be displayed, not including fadein/out\r\n"
"\t(optional)\r\n"
"\t5:\tImage name\r\n"
"\t6:\tFade in time\r\n"
"\t7:\tCenter horizontally?\r\n"
"\t8:\tCenter vertically?\r\n"
"\t9:\tWidth\r\n"
"\t10:\tText red component (0-255)\r\n"
"\t11:\tText green component (0-255)\r\n"
"\t12:\tText blue component (0-255)"
},
{ OP_CUTSCENES_SET_TIME_COMPRESSION, "set-time-compression\r\n"
"\tSets the time compression "
"Takes 1 to 3 arguments...\r\n"
"\t1:\tNew time compression (% of 1x)\r\n"
"\t2:\tTime in ms for change to take\r\n"
"\t3:\tTime compression to start from\r\n"
},
{ OP_CUTSCENES_RESET_TIME_COMPRESSION, "reset-time-compression\r\n"
"\tResets the time compression; always call when done with set-time-compression "
},
{ OP_CUTSCENES_FORCE_PERSPECTIVE, "lock-perspective\r\n"
"\tPrevents or allows the player from changing the view mode "
"Takes 1 or 2 arguments...\r\n"
"\t1:\tTrue to lock the view mode, false to unlock it\r\n"
"\t2:\tWhat view mode to lock; 0 for first-person, 1 for chase, 2 for external, 3 for top-down"
},
{ OP_SET_CAMERA_SHUDDER, "set-camera-shudder\r\n"
"\tCauses the camera to shudder. Currently this will only work if the camera is showing the player's viewpoint (i.e. the HUD).\r\n\r\n"
"Takes 2 arguments...\r\n"
"\t1: Time (in milliseconds)\r\n"
"\t2: Intensity. For comparison, the Maxim has an intensity of 1440."
},
{ OP_JUMP_NODE_SET_JUMPNODE_COLOR, "set-jumpnode-color\r\n"
"\tSets the color of a jump node "
"Takes 5 arguments...\r\n"
"\t1:\tJump node to change color for\r\n"
"\t2:\tRed value\r\n"
"\t3:\tGreen value\r\n"
"\t4:\tBlue value\r\n"
"\t5:\tAlpha value\r\n"
},
{ OP_JUMP_NODE_SET_JUMPNODE_MODEL, "set-jumpnode-model\r\n"
"\tSets the model of a jump node "
"Takes 3 arguments...\r\n"
"\t1:\tJump node to change model for\r\n"
"\t2:\tModel filename\r\n"
"\t3:\tShow as normal model\r\n"
},
{ OP_JUMP_NODE_SHOW_JUMPNODE, "show-jumpnode\r\n"
"\tSets the model of a jump node "
"Takes 1 arguments..\r\n"
"\t1:\tJump node to show\r\n"
},
{ OP_JUMP_NODE_HIDE_JUMPNODE, "hide-jumpnode\r\n"
"\tSets the model of a jump node "
"Takes 1 arguments...\r\n"
"\t1:\tJump node to hide\r\n"
},
// taylor
{ OP_SET_SKYBOX_MODEL, "set-skybox-model\r\n"
"\tSets the current skybox model\r\n\r\n"
"Takes 1 argument...\r\n"
"\t1:\tModel filename (with .pof extension) to switch to\r\n\r\n"
"If the model filename is set to \"default\" with no extension then it will switch to the mission supplied default skybox."
},
{ OP_ADD_BACKGROUND_BITMAP, "add-background-bitmap\r\n"
"\tAdds a background bitmap to the sky. Returns an integer that is stored in a variable so it can be deleted using remove-background-bitmap\r\n\r\n"
"Takes 9 arguments...\r\n"
"\t1:\tBackground bitmap name\r\n"
"\t2:\tPitch\r\n"
"\t3:\tBank\r\n"
"\t4:\tHeading\r\n"
"\t5:\tX scale (expressed as a percentage of the original size of the bitmap)\r\n"
"\t6:\tY scale (expressed as a percentage of the original size of the bitmap)\r\n"
"\t7:\tX divisions.\r\n"
"\t8:\tY divisions.\r\n"
"\t9:\tVariable in which to store result\r\n"
},
{ OP_REMOVE_BACKGROUND_BITMAP, "remove-background-bitmap\r\n"
"\tRemoves the nth background bitmap from the mission\r\n\r\n"
"Takes 1 argument...\r\n"
"\t1:\tZero based bitmap index from the \'Bitmap\' box in the background editor\r\n"
"\t\t\tYou can also use the result of a previous call to add-background-bitmap to remove that added bitmap\r\n"
},
{ OP_ADD_SUN_BITMAP, "add-sun-bitmap\r\n"
"\tAdds a sun bitmap to the sky. Returns an integer that is stored in a variable so it can be deleted using remove-sun-bitmap\r\n\r\n"
"Takes 6 arguments...\r\n"
"\t1:\tSun bitmap name\r\n"
"\t2:\tPitch\r\n"
"\t3:\tBank\r\n"
"\t4:\tHeading\r\n"
"\t5:\tScale (expressed as a percentage of the original size of the bitmap)\r\n"
"\t6:\tVariable in which to store result\r\n"
},
{ OP_REMOVE_SUN_BITMAP, "remove-sun-bitmap\r\n"
"\tRemoves the nth sun from the mission\r\n\r\n"
"Takes 1 argument...\r\n"
"\t1:\tZero based sun index from the \'Suns\' box in the background editor\r\n"
"\t\t\tYou can also use the result of a previous call to add-sun-bitmap to remove that added sun\r\n"
},
{ OP_NEBULA_CHANGE_STORM, "nebula-change-storm\r\n"
"\tChanges the current nebula storm\r\n\r\n"
"Takes 1 argument...\r\n"
"\t1:\tNebula storm to change to\r\n"
},
{ OP_NEBULA_TOGGLE_POOF, "nebula-toggle-poof\r\n"
"\tToggles the state of a nebula poof\r\n\r\n"
"Takes 2 arguments...\r\n"
"\t1:\tName of nebula poof to toggle\r\n"
"\t2:\tA True boolean expression will toggle this poof on. A false one will do the opposite."
},
{OP_SCRIPT_EVAL_NUM, "script-eval-num\r\n"
"\tEvaluates script to return a number"
"Takes 1 argument...\r\n"
"\t1:\tScript\r\n"
},
{OP_SCRIPT_EVAL_STRING, "script-eval-string\r\n"
"\tEvaluates script to return a string"
"Takes 1 argument...\r\n"
"\t1:\tScript\r\n"
},
{OP_SCRIPT_EVAL, "script-eval\r\n"
"\tEvaluates script"
"Takes at least 1 argument...\r\n"
"\t1:\tScript to evaluate\r\n"
},
};
op_menu_struct op_menu[] =
{
{ "Objectives", OP_CATEGORY_OBJECTIVE },
{ "Time", OP_CATEGORY_TIME },
{ "Logical", OP_CATEGORY_LOGICAL },
{ "Arithmetic", OP_CATEGORY_ARITHMETIC },
{ "Status", OP_CATEGORY_STATUS },
{ "Change", OP_CATEGORY_CHANGE },
{ "Conditionals", OP_CATEGORY_CONDITIONAL },
/* { "Debugging", OP_CATEGORY_DEBUG }, discontinued by Goober5000 */
{ "Ai goals", OP_CATEGORY_AI },
{ "Event/Goals", OP_CATEGORY_GOAL_EVENT },
{ "Autopilot/NavPoints", OP_CATEGORY_NAVPOINTS},
{ "Training", OP_CATEGORY_TRAINING },
};
// Goober5000's subcategorization of the Change menu (and possibly other menus in the future,
// if people so choose - see sexp.h)
op_menu_struct op_submenu[] =
{
{ "Messaging and Mission Goals", CHANGE_SUBCATEGORY_MESSAGING_AND_MISSION_GOALS },
{ "AI and IFF", CHANGE_SUBCATEGORY_AI_AND_IFF },
{ "Subsystems and Cargo", CHANGE_SUBCATEGORY_SUBSYSTEMS_AND_CARGO },
{ "Ship Status", CHANGE_SUBCATEGORY_SHIP_STATUS },
{ "Beams and Turrets", CHANGE_SUBCATEGORY_BEAMS_AND_TURRETS },
{ "Mission and Campaign", CHANGE_SUBCATEGORY_MISSION_AND_CAMPAIGN },
{ "Models and Textures", CHANGE_SUBCATEGORY_MODELS_AND_TEXTURES },
{ "Coordinate Manipulation", CHANGE_SUBCATEGORY_COORDINATE_MANIPULATION },
{ "Music and Sound", CHANGE_SUBCATEGORY_MUSIC_AND_SOUND },
{ "Hud", CHANGE_SUBCATEGORY_HUD },
{ "Cutscenes", CHANGE_SUBCATEGORY_CUTSCENES },
{ "Jump Nodes", CHANGE_SUBCATEGORY_JUMP_NODES },
{ "Special", CHANGE_SUBCATEGORY_SPECIAL },
{ "Backgrounds and Nebula", CHANGE_SUBCATEGORY_BACKGROUND_AND_NEBULA },
{ "Multiplayer", STATUS_SUBCATEGORY_MULTIPLAYER },
{ "Weapons, Shields, and Engines", STATUS_SUBCATEGORY_SHIELDS_ENGINES_AND_WEAPONS },
{ "Cargo", STATUS_SUBCATEGORY_CARGO },
{ "Ship Status", STATUS_SUBCATEGORY_SHIP_STATUS },
{ "Damage", STATUS_SUBCATEGORY_DAMAGE },
{ "Distance and Coordinates", STATUS_SUBCATEGORY_DISTANCE_AND_COORDINATES },
{ "Kills and Scoring", STATUS_SUBCATEGORY_KILLS_AND_SCORING },
};
int Num_sexp_help = sizeof(Sexp_help) / sizeof(sexp_help_struct);
int Num_op_menus = sizeof(op_menu) / sizeof(op_menu_struct);
int Num_submenus = sizeof(op_submenu) / sizeof(op_menu_struct);
//Internal file used by output_sexps, should not be called from output_sexps
static void output_sexp_html(int sexp_idx, FILE *fp)
{
if(sexp_idx < 0 || sexp_idx > Num_operators)
return;
bool printed=false;
for(int i = 0; i < Num_sexp_help; i++)
{
if(Sexp_help[i].id == Operators[sexp_idx].value)
{
char* new_buf = new char[2*strlen(Sexp_help[i].help)];
char* dest_ptr = new_buf;
char* curr_ptr = Sexp_help[i].help;
char* end_ptr = curr_ptr + strlen(Sexp_help[i].help);
while(curr_ptr < end_ptr)
{
if(*curr_ptr == '\n')
{
strcpy(dest_ptr, "\n<br>");
dest_ptr+=5;
}
else
{
*dest_ptr++ = *curr_ptr;
}
curr_ptr++;
}
*dest_ptr = '\0';
fprintf(fp, "<dt><b>%s</b></dt>\n<dd>%s</dd>\n", Operators[sexp_idx].text, new_buf);
delete[] new_buf;
printed = true;
}
}
if(!printed)
fprintf(fp, "<dt><b>%s</b></dt>\n<dd>Min arguments: %d, Max arguments: %d</dd>\n", Operators[sexp_idx].text, Operators[sexp_idx].min, Operators[sexp_idx].max);
}
//Outputs sexp.html file
bool output_sexps(char *filepath)
{
FILE *fp = fopen(filepath,"w");
if(fp == NULL)
{
MessageBox(NULL,"Error creating SEXP operator list", "Error", MB_OK);
return false;
}
//Header
fprintf(fp, "<html>\n<head>\n\t<title>SEXP Output: %d.%d.%d</title>\n</head>\n", FS_VERSION_MAJOR, FS_VERSION_MINOR, FS_VERSION_BUILD);
fputs("<body>", fp);
fprintf(fp,"\t<h1>Sexp Output - Build %d.%d.%d</h1>\n", FS_VERSION_MAJOR, FS_VERSION_MINOR, FS_VERSION_BUILD);
std::vector<int> done_sexp_ids;
int x,y,z;
//Output an overview
fputs("<dl>", fp);
for(x = 0; x < Num_op_menus; x++)
{
fprintf(fp, "<dt><a href=\"#%d\">%s</a></dt>", (op_menu[x].id & OP_CATEGORY_MASK), op_menu[x].name);
for(y = 0; y < Num_submenus; y++)
{
if(((op_submenu[y].id & OP_CATEGORY_MASK) == op_menu[x].id))
{
fprintf(fp, "<dd><a href=\"#%d\">%s</a></dd>", op_submenu[y].id & (OP_CATEGORY_MASK | SUBCATEGORY_MASK), op_submenu[y].name);
}
}
}
fputs("</dl>", fp);
//Output the full descriptions
fputs("<dl>", fp);
for(x = 0; x < Num_op_menus; x++)
{
fprintf(fp, "<dt id=\"%d\"><h2>%s</h2></dt>\n", (op_menu[x].id & OP_CATEGORY_MASK), op_menu[x].name);
fputs("<dd>", fp);
fputs("<dl>", fp);
for(y = 0; y < Num_submenus; y++)
{
if(((op_submenu[y].id & OP_CATEGORY_MASK) == op_menu[x].id))
{
fprintf(fp, "<dt id=\"%d\"><h3>%s</h3></dt>\n", op_submenu[y].id & (OP_CATEGORY_MASK | SUBCATEGORY_MASK), op_submenu[y].name);
fputs("<dd>", fp);
fputs("<dl>", fp);
for(z = 0; z < Num_operators; z++)
{
if(((Operators[z].value & OP_CATEGORY_MASK) == op_menu[x].id)
&& (get_subcategory(Operators[z].value) != -1)
&& (get_subcategory(Operators[z].value) == op_submenu[y].id))
{
output_sexp_html(z, fp);
}
}
fputs("</dl>", fp);
fputs("</dd>", fp);
}
}
for(z = 0; z < Num_operators; z++)
{
if(((Operators[z].value & OP_CATEGORY_MASK) == op_menu[x].id)
&& (get_subcategory(Operators[z].value) == -1))
{
output_sexp_html(z, fp);
}
}
fputs("</dl>", fp);
fputs("</dd>", fp);
}
for(z = 0; z < Num_operators; z++)
{
if(!(Operators[z].value & OP_CATEGORY_MASK))
{
output_sexp_html(z, fp);
}
}
fputs("</dl>", fp);
fputs("</body>\n</html>\n", fp);
fclose(fp);
return true;
}
Reference in new issue View Git Blame Copy Permalink