GEMini Atari/GEMini_Atari_CD-ROM_Walnut_Creek_December_1993.iso/files/program/readme12/menu.trb

Text File | 1988-06-29 | 6.3 KB | 281 lines

*      SAMPLE MENU TREE FOR POPHELP (Todd Burkey/5-30-88)      */
/* menu for level 0 help */
#:0
X:20
Y:2
T:    POPHELP By Todd Burkey
T:
T:Uh-oh. You need HELP for POPHELP?
T:OK, the first thing to remember is
T:that in POPHELP, you really only
T:need to use the four arrow keys
T:and the ESC key. The up and down
T:arrows will move you up and down in
T:the current pop-up...but only when
T:there is selectable (blue) text in
T:the popup. Note that this popup has
T:NO selectable text...you can just
T:read it and exit. Which brings us
T:to the left and right arrow keys.
T:The right key gets you into a menu,
T:while the left key moves you back
T:out of a menu. The ESC key? It gets
T:you out of the popups altogether.
T:You can press the LEFT ARROW now.
#:1
X:5
Y:15
T:WELCOME TO POPHELP
+:HELP ON POPHELP
=:3
+:POPHELP MANIFESTO
=:40
+:Who made this mess
=:41
+:ABOUT README
=:50
+:Some Error Testing
=:42
+:Other menu #4
=:4
+:Other Menu #6
=:6

#:50
X:4
Y:4
1:530
T:README is a generic application that I hope you find useful in setting
T:up useful on-line documentation for programs you develop. Feel free to
T:give out copies of README to others who are learning C or who you feel
T:could use a better help mechanism. I will try to keep the pophelp file
T:formats upwards compatible, so keep your eyes open for future releases
T:of improved versions of this program.

#:40
X:2
Y:4
T:This program shows one use of the POPHELP mechanism (Copyright 1988 by
T:Todd Burkey). POPHELP is intended to be a 'clean' way of presenting help
T:to users of a program and was also written to demonstrate in source code
T:how to do those confusing linea/vdi/etc things that all of our books kind
T:of gloss over. I am not saying that my methods are proper coding or even
T:close, but at least it works. In order to ensure that this code and the
T:techniques involved stay accessible to the public at large, I have to
T:make the following stipulations:
T:
T: 1) This program and source code may be freely distributed as long as no
T:    profits are made in the process (Club Disks of the Month and BBSs are
T:    excepted, of course.)
T: 2) All derivatives of the routines in this code must include this notice
T:    verbatim and are similarly subject to the conditions in 1, above.
T: 3) No warrantees are made as to the usefulness or safety of using this
T:    code. The user uses it at his/her own risk.

#:41
1:030
2:540
X:14
Y:15
T: Todd Burkey                 A member of STdNET
T: 3546 Pilgrim Lane        The ST developers' Network
T: Plymouth, MN 55441            ([e-mail])

#:42
X:10
Y:6
T:  SIMPLE TESTING
+:Look at sample.txt
=:10
+:Look at bad file
=:11
+:Open Menu >100
=:120
+:Menu Doesn't exist
=:88
+:Goto myself (loop)
=:42

/* Real help for POPHELP */
#:3
X:12
Y:8
T:GETTING STARTED
+:Moving Around
=:22
+:Some Comments
=:23
+:Technical Info
=:26

#:26
X:30
Y:10
+:MENU.TRB Format
=:27
+:COLOR Tables
=:28

#:27
X:3
Y:4
T:The file MENU.TRB is processed by POPHELP's build_menu routine and
T:drives the entire menu structure of POPHELP. The format of MENU.TRB
T:is very simple. For example, the following is a sample 2 level menu
T:with comments (note the comments can't really be part of the line):
T:#:1             <-we are defining menu # 1
T:X:10            <-the popup box will start at cursor column 10
T:Y:4             <-and at cursor row number 4
T:T:WELCOME       <-just some text to put in red (color #1)
T:+:More Help     <-text for another menu selection
T:=:2             <-go to menu 2 when the above text is selected
T:#:2             <-all done with menu 1, so lets define menu 2 now
T:X:5             <-new coordinates
T:Y:6             <-new coordinates
T:1:070           <-redefine color 1 (the text) to be green (RGB)
T:<:afile.txt     <-menu 2 popup text is read from a file

#:60
X:20
Y:8
1:530
2:053
T:For RGB users only
T:  You were warned
+:Some soft colors
=:61
+:Some Putrid ones
=:62
+:Late night colors
=:63

#:61
X:5
Y:3
0:054
1:410
2:046
3:222
T:Pastels?
T:0:054
T:1:500
T:2:066
T:3:333

#:62
X:5
Y:3
0:070
1:770
2:077
3:707
T:Putrid
T:0:070
T:1:770
T:2:077
T:3:707

#:63
X:5
Y:3
0:000
1:700
2:007
3:770
T:Brighter
T:0:000
T:1:700
T:2:007
T:3:770

#:28
X:2
Y:4
T:Colors can be changed from the default setup dynamically within the menus,
T:but extreme care should be taken so you don't screw things up for people
T:who use monochrome monitors. The technique is quite simple. Within the
T:MENU.TRB file, include the following fields when you want a new color:
T:0:006          <--change color 0 to light blue (normal background)
T:1:600          <--change color 1 to red (non-selectable text)
T:2:000          <--change color 2 to black (for the shadow)
T:3:775          <--change color 3 to off white (popup background).
T:Note that the default color can be over-ridden by specifying a new color
T:for menu # 1 (the first popup that is displayed by POPHELP).
+:Some sample colors maps.
=:60

#:22
X:14
Y:10
+:ARROW KEYS
=:24
+:HOW TO QUIT
=:25

#:25
X:40
Y:12
T:1) Press the ESC key.  This takes
T:   you out of the help selection.
T:2) Press the Q (not q) key. This
T:   exits you from the demo.

#:24
X:30
Y:12
T:RIGHT ARROW = Select the hilited menu
T:LEFT ARROW  = Move to menu we came from
T:UP ARROW    = Move up in the menu list
T:DOWN ARROW  = Move down in the list

#:23
X:15
Y:11
T:POPHELP is a simple, but clean, mechanism
T:for both externalized and internally held
T:help information. It was written only for
T:fun, but may prove useful in standardized
T:help utilities as its' features are tuned
T:up and refined.  Any comments from anyone
T:out there? Or is this idea just too wierd
T:and far-fetched.

/* lower level menu that is all text */
#:4
X:30
Y:14
T:This is all Text, so you
T:can't really do much but
T:look at it and then push
T:the left arrow key.

/* small menu */
#:6
X:50
Y:3
T:Menu 6
+:GOTO 5
=:5
+:GOTO 1
=:1

/* menu that is really a file */
#:10
X:3
Y:5
<:sample.txt

/* just a test to show what a missing file will do */
#:11
X:3
Y:5
<:hl.txt

/* another little text menu */
#:5
X:70
Y:20
T:JUST
T:MORE
T:Text