VgaGames 3 - System-menu man-pages

[.. upper level ..]

VG3_sysmenu_savestring_find()

Return the key/button/axis from the serialized savestring of the system-menu via a reference number.
SYNTAX
int VG3_sysmenu_savestring_find(struct vg3_sysmenu *sysm, const char *svdata, int jid, int keyref, int default_keyidx)

FUNCTION PARAMETERS
sysm System-menu-struct
svdata Savestring (read from file)
jid Joystick-ID or 0 = keyboard
keyref Reference number of the entry to be searched
default_keyidx Key/button/axis to return if keyref cannot be found
- for keyboard: one of the values of VGAG3_KEYS
- for gamecontrollers: one of the values of VGAG3_GCS
- for joysticks: joystick-input-keynumber (starting from 1)

RETURN VALUE
Returns key/button/axis - for keyboard: one of the values of VGAG3_KEYS - for gamecontrollers: one of the values of VGAG3_GCS - for joysticks: joystick-input-keynumber (starting from 1)

DESCRIPTION
Return the key/button/axis from the serialized savestring of the system-menu via a reference number. This function is used to retrieve values from the savestring instead of the system-menu and acts similar to VG3_sysmenu_getkeyval. If the reference number is not found, the default key default_keyidx is returned.

SEE ALSO
VG3_sysmenu_savestring_insert() VG3_sysmenu_getkeyval()