EVENT DISPLAYMENU

From EDukeWiki
Revision as of 05:36, 4 February 2022 by Doom64hunter (talk | contribs)
Jump to navigation Jump to search
Event ID player# THISACTOR RETURN
EVENT_DISPLAYMENU Current Player player->i yes (4-5 values)

EVENT_DISPLAYMENU is a Menu Event.

This event is called before the active menu, i.e., the recently accessed menu is drawn.

Everything drawn within this event is drawn under the main menu text and shown a bit darker than the menu.

This event takes several values as arguments, which can be accessed through the return_(userdef) array.

Return Values

userdef.return 0
Same as RETURN. Contains the ID of the currently active menu. See the listing below for the complete list of available IDs. Read-only.
userdef.return 1
Contains the x-coordinate of the origin of the current menu. Changes made to this value will be propagated back to the menu.
userdef.return 2
Contains the y-coordinate of the origin of the current menu. Changes made to this value will be propagated back to the menu.
userdef.return 3
Contains the index of the menu entry that is selected on the current menu. Read-only.
userdef.return 4
Only defined if the current menu entry is MENU_NEWGAMECUSTOMSUB or MENU_NEWGAMECUSTOML3. Holds the selected menu entry index of MENU_NEWGAMECUSTOM or MENU_NEWGAMECUSTOMSUB respectively. Read-only.

Menu Identities

The following values are used with current_menu, cmenu, EVENT_CHANGEMENU and EVENT_DISPLAYMENU.

Exposed Value Name Description / Notes
No -2147483648 MENU_NULL Do nothing
No -2 MENU_CLOSE Close the menu
No -1 MENU_PREVIOUS Go to previous menu
No 0 MENU_MAIN Base menu accessed when not in an active game.
No 50 MENU_MAIN_INGAME Differs from the above by displaying "Save Game" and "Quit to Title" options.
No 100 MENU_EPISODE Normally accessed when selecting the "New Game" option if newgamechoices are NOT defined.
No 101 MENU_USERMAP -
No 102 MENU_NEWGAMECUSTOM Normally accessed when selecting the "New Game" option if newgamechoices ARE defined.
No 103 MENU_NEWGAMECUSTOMSUB Second layer of newgamechoices entries.
No 104 MENU_NEWGAMECUSTOML3 Third layer of newgamechoices entries.
No 110 MENU_SKILL -
No 200 MENU_GAMESETUP Has no menu entry in Retail builds. (e.g. the build included for Ion Fury)
No 202 MENU_OPTIONS -
No 203 MENU_VIDEOSETUP -
No 204 MENU_KEYBOARDSETUP -
No 205 MENU_MOUSESETUP -
No 206 MENU_JOYSTICKSETUP Corresponding menu entry is called "Gamepad Setup".
No 207 MENU_JOYSTICKBTNS Only reachable if a gamepad or joystick is available.
No 208 MENU_JOYSTICKAXES Only reachable if a gamepad or joystick is available.
No 209 MENU_KEYBOARDKEYS -
No 210 MENU_MOUSEBTNS -
No 212 MENU_MOUSEADVANCED -
No 213 MENU_JOYSTICKAXIS Normally accessed over MENU_JOYSTICKAXES.
No 214 MENU_TOUCHSETUP Android builds only.
No 215 MENU_TOUCHSENS Android builds only.
No 216 MENU_TOUCHBUTTONS Android builds only.
No 220 MENU_CONTROLS Parent menu for keyboard, mouse and gamepad controls.
No 230 MENU_POLYMOST Normally only accessible from the Display menu when Polymost is active.
No 231 MENU_COLCORR -
No 232 MENU_COLCORR_INGAME Only accessed when pressing the F11 key ingame. Closes the menu on ESC. Otherwise equivalent to the above.
No 233 MENU_SCREENSETUP Corresponding menu entry is called "HUD Setup".
No 234 MENU_DISPLAYSETUP -
No 240 MENU_POLYMER Normally only accessible from the Display menu when Polymer is active.
No 300 MENU_LOAD -
No 350 MENU_SAVE -
No 400 MENU_STORY Normally accessible over the "Help" menu entry.
No 401 MENU_F1HELP Default controls info screen, reachable from MENU_STORY. Not actually accessed when F1 is pressed, instead MENU_STORY is reached.
No 500 MENU_QUIT -
No 501 MENU_QUITTOTITLE Corresponding menu entry only displayed when inside an active game.
No 502 MENU_QUIT_INGAME Normally accessed when pressing F10 ingame. Closes the menu when exited out of. Otherwise equivalent to MENU_QUIT.
No 600 MENU_NETSETUP Netgames only.
No 601 MENU_NETWAITMASTER Netgames only.
No 603 MENU_NETWAITVOTES Netgames only.
No 700 MENU_SOUND -
No 701 MENU_SOUND_INGAME Normally accessed when pressing F4 ingame. Closes the menu when exited out of. Otherwise equivalent to MENU_SOUND.
No 702 MENU_ADVSOUND -
No 750 MENU_SAVESETUP Normally only accessible for Retail builds. (e.g. the build included for Ion Fury)
No 751 MENU_SAVECLEANVERIFY Normally only accessible for Retail builds.
No 752 MENU_RESETSTATSVERIFY Resets achievements. Normally only accessible for Retail builds with a connection to the Steam servers.
No 800 MENU_CHEATS Cheat unlock menu. Once an ingame cheat is typed in, will display it as a menu option here.
No 801 MENU_CHEATENTRY Entry field to type cheats in.
No 802 MENU_CHEAT_WARP Reached through the "warp" option in the cheat menu, which is unlocked after the "DNSCOTTY###" cheat has been entered for the first time.
No 803 MENU_CHEAT_SKILL Reached through the "skill level" option in the cheat menu, which is unlocked after the "DNSKILL#" cheat has been entered for the first time.
No 990 MENU_CREDITS Plutonium Pack credits.
No 991 MENU_CREDITS2 v1.3d credits.
No 992 MENU_CREDITS3 Special Thanks page.
No 993 MENU_CREDITS4 eduke32 credits. Working around, hiding, or skipping this is a violation of the EDuke32 license.
No 994 MENU_CREDITS5 eduke32 credits. Working around, hiding, or skipping this is a violation of the EDuke32 license.
No 1000 MENU_LOADVERIFY -
No 1100 MENU_LOADDELVERIFY Accessed when deleting saves from the "load" menu. Functionally equivalent to MENU_SAVEDELVERIFY.
No 1500 MENU_NEWVERIFY Accessed when selecting "New Game" while in an active game.
No 2000 MENU_SAVEVERIFY -
No 2100 MENU_SAVEDELVERIFY Accessed when deleting saves from the "save" menu. Functionally equivalent to MENU_LOADDELVERIFY.
No 2200 MENU_COLCORRRESETVERIFY -
No 2201 MENU_KEYSRESETVERIFY -
No 2202 MENU_KEYSCLASSICVERIFY -
No 2203 MENU_JOYSTANDARDVERIFY Reached when selecting the "standard" gamepad default controls.
No 2204 MENU_JOYPROVERIFY Reached when selecting the "pro" gamepad default controls.
No 2205 MENU_JOYCLEARVERIFY -
No 10001 MENU_ADULTPASSWORD -
No 15000 MENU_RESETPLAYER Screen normally only reached after pressing the 'use' key while dead. Prompts you to reload the latest savegame. Will crash if no current save available.
No 20000 MENU_BUYDUKE Screen normally only reached when trying to play episode 2 or 3 using the Shareware version of Duke 3D.
No 20001 MENU_NETWORK Netgames only.
No 20002 MENU_PLAYER -
No 20004 MENU_MACROS -
No 20010 MENU_NETHOST Netgames only.
No 20011 MENU_NETOPTIONS Netgames only.
No 20012 MENU_NETUSERMAP Netgames only.
No 20020 MENU_NETJOIN Netgames only.
Defines
define MENU_NULL                        -2147483648
define MENU_CLOSE                       -2
define MENU_PREVIOUS                    -1
define MENU_MAIN                        0
define MENU_MAIN_INGAME                 50
define MENU_EPISODE                     100
define MENU_USERMAP                     101
define MENU_NEWGAMECUSTOM               102
define MENU_NEWGAMECUSTOMSUB            103
define MENU_NEWGAMECUSTOML3             104
define MENU_SKILL                       110
define MENU_GAMESETUP                   200
define MENU_OPTIONS                     202
define MENU_VIDEOSETUP                  203
define MENU_KEYBOARDSETUP               204
define MENU_MOUSESETUP                  205
define MENU_JOYSTICKSETUP               206
define MENU_JOYSTICKBTNS                207
define MENU_JOYSTICKAXES                208
define MENU_KEYBOARDKEYS                209
define MENU_MOUSEBTNS                   210
define MENU_MOUSEADVANCED               212
define MENU_JOYSTICKAXIS                213
define MENU_TOUCHSETUP                  214
define MENU_TOUCHSENS                   215
define MENU_TOUCHBUTTONS                216
define MENU_CONTROLS                    220
define MENU_POLYMOST                    230
define MENU_COLCORR                     231
define MENU_COLCORR_INGAME              232
define MENU_SCREENSETUP                 233
define MENU_DISPLAYSETUP                234
define MENU_POLYMER                     240
define MENU_LOAD                        300
define MENU_SAVE                        350
define MENU_STORY                       400
define MENU_F1HELP                      401
define MENU_QUIT                        500
define MENU_QUITTOTITLE                 501
define MENU_QUIT_INGAME                 502
define MENU_NETSETUP                    600
define MENU_NETWAITMASTER               601
define MENU_NETWAITVOTES                603
define MENU_SOUND                       700
define MENU_SOUND_INGAME                701
define MENU_ADVSOUND                    702
define MENU_SAVESETUP                   750
define MENU_SAVECLEANVERIFY             751
define MENU_RESETSTATSVERIFY            752
define MENU_CHEATS                      800
define MENU_CHEATENTRY                  801
define MENU_CHEAT_WARP                  802
define MENU_CHEAT_SKILL                 803
define MENU_CREDITS                     990
define MENU_CREDITS2                    991
define MENU_CREDITS3                    992
define MENU_CREDITS4                    993
define MENU_CREDITS5                    994
define MENU_LOADVERIFY                  1000
define MENU_LOADDELVERIFY               1100
define MENU_NEWVERIFY                   1500
define MENU_SAVEVERIFY                  2000
define MENU_SAVEDELVERIFY               2100
define MENU_COLCORRRESETVERIFY          2200
define MENU_KEYSRESETVERIFY             2201
define MENU_KEYSCLASSICVERIFY           2202
define MENU_JOYSTANDARDVERIFY           2203
define MENU_JOYPROVERIFY                2204
define MENU_JOYCLEARVERIFY              2205
define MENU_ADULTPASSWORD               10001
define MENU_RESETPLAYER                 15000
define MENU_BUYDUKE                     20000
define MENU_NETWORK                     20001
define MENU_PLAYER                      20002
define MENU_MACROS                      20004
define MENU_NETHOST                     20010
define MENU_NETOPTIONS                  20011
define MENU_NETUSERMAP                  20012
define MENU_NETJOIN                     20020