Object insertion flags.
Detailed Description
These are flags passed to
insert_ob_in_map() and
insert_ob_in_ob(). Note that all flags may not be meaningful for both functions. Most are fairly explanatory:
- INS_NO_MERGE: don't try to merge inserted object with ones alrady on space.
- INS_ABOVE_FLOOR_ONLY: Put object immediatly above the floor.
- INS_NO_WALK_ON: Don't call check_walk_on against the originator - saves cpu time if you know the inserted object is not meaningful in terms of having an effect.
- INS_ON_TOP: Always put object on top. Generally only needed when loading files from disk and ordering needs to be preserved.
- INS_BELOW_ORIGINATOR: Insert new object immediately below originator - Use for treasure chests so the new object is the highest thing beneath the player, but not actually above it. Note - the map and x,y coordinates for the object to be inserted must match the originator.
- INS_MAP_LOAD: disable lots of checkings done at insertion to speed up map loading process, as we assume the ordering in loaded map is correct.
Note that INS_BELOW_ORIGINATOR, INS_ON_TOP, INS_ABOVE_FLOOR_ONLY are mutually exclusive. The behaviour for passing more than one should be considered undefined - while you may notice what happens right now if you pass more than one, that could very well change in future revisions of the code.
Define Documentation
| #define INS_ABOVE_FLOOR_ONLY 0x0002 |
| #define INS_BELOW_ORIGINATOR 0x0010 |
| #define INS_MAP_LOAD 0x0020 |
| #define INS_NO_MERGE 0x0001 |
| #define INS_NO_WALK_ON 0x0004 |
| #define INS_ON_TOP 0x0008 |
