Click above to get retro games delivered to your door ever month!

##############################################################################
###+--------+#################################################################
#+-| 15.3.9 |---------------------------+#####################################
#| +--------+ Pick List Functions Table |#####################################
#+--------------------------------------+#####################################
##############################################################################
##############################################################################
#####+------------------------------------------------------------------+#####
#####| To use a pick list, follow these steps:                          |#####
#####|                                                                  |#####
#####| * Initialize a pick list through the pick_init() function.  This |#####
#####| function allocates a small block of memory for the pick list and |#####
#####| returns a handle.  All subsequent pick list functions must use   |#####
#####| the returned handle.                                             |#####
#####| ---------------------------------------------------------------- |#####
#####| * Add items to the pick list by using the pick_add() procedure.  |#####
#####| Add as many strings as necessary from any source.  The pick list |#####
#####| manager allocates as much memory as required.                    |#####
#####| ---------------------------------------------------------------- |#####
#####| * Allow a user to select an item through the pick_list procedure.|#####
#####| ---------------------------------------------------------------- |#####
#####| * Free all memory associated with the pick list through the      |#####
#####| pick_clear procedure.  Once the pick_clear procedure has been    |#####
#####| issued, the pick handle is no longer active.                     |#####
#####+------------------------------------------------------------------+#####
##############################################################################
##############################################################################
######+--| Function |------------| Usage |-----------------------------+######
######| pick_add ........... Inserts a string into a pick list.        |######
######| pick_clear ......... Frees memory associated with a pick list. |######
######| pick_init .......... Initializes a pick list.  Allocates       |######
######|                      system memory for the pick list a returns |######
######|                      a pick list "handle".                     |######
######| pick_list .......... Presents a pick list on the screen and    |######
######|                      optionally allows a user to select        |######
######|                      a pick list item.                         |######
######| pick_str ........... Returns the string associated with the    |######
######|                      return integer value from pick list.      |######
######+----------------------------------------------------------------+######
##############################################################################