home *** CD-ROM | disk | FTP | other *** search
- ____________________________________________________________________________
- | |
- | ACCESS! |
- | ~~~~~~~ |
- |____________________________________________________________________________|
-
- Author: Keith Young
- Version: .20
- Date: 8/31/87
- Status: BETA
- Size: 75260 (damn, getting up there! :-)
-
-
- Credits:
- ~~~~~~~~
- D.James -> for the origianal source to "Comm1.34" (thanx Dan, I
- couldn't have made this mess without it! (grin))
-
- D.Salas -> for answering some dumb questions.(and some good ideas)
-
- Tim Roach-> BETA tester, Icon maker, Moral Support.
-
-
- Access! is freely distributable provided the following files remain
- UNCHANGED and AS A WHOLE in ARCHIVE FORM!
-
-
- Files in this archive:
-
- Name Size Function
- ~~~~ ~~~~ ~~~~~~~~
- Access! 75260 This is the Terminal program: "Access!"
- Access!.info 3160 Icon for...
- Acc!.color 302 Sample color file for...
- Acc!.keys 303 Sample macro-key file for...
- Acc!.phone 1494 Sample phone-lib file for...
- Access!me 25403 This is what you are reading now...
-
-
- Disclaimer!:
- ~~~~~~~~~~~~
- This Program is in BETA Testing, I assume NO responsibility for
- any damage whatsoever, caused by the use of it.
-
- Nuff Said, Now on to bussiness....
-
-
- Access!:
- ~~~~~~~
- A "16 Color Terminal Program" based on D.J.James's "Comm1.34".
-
- (NOTE: Although I list myself as "author", the "origianal" author
- of "Comm1.34" is D.J.James. This is a Modified Version of that
- program.
-
-
- Usage:
- ~~~~~~
- from the cli promt:
-
- 1> access! [-i] [-s] [phone.file]
-
- where optional "-i" sets interlace
- optional "-s" sets interlace AND "Split Screen"
- (see "SPLIT" below under "FAST MENU")
- optional "phone.file" loads the phone file listed.
- (default is "comm.phone" and in "Comm1.34"
- format.)
- (NOTE Ver.19: Default is NOW "Acc!.phone"(still "Comm1.34"
- format.))
-
- Examples: Sets:
-
- 1> access! -> med-res, full-screen, comm.phone
- 1> access! -i -> interlace, full-screen, comm.phone
- 1> access! -s -> interlace, split-screen, comm.phone
- 1> access! phone.file -> med-res, full-screen, phone.file
- 1> access! -i phone.file -> interlace, full-screen, phone.file
- 1> access! -s myphone.file -> interlace, split-screen, myphone.file
- 1> accessories -> loads some program called "accessories"?
-
- (NOTE: also works with "Comm1.34" tpye icon from WBench)(I haven't drawn one
- yet so rename one of your old ones if you prefer WBench)
-
- (NOTE: Ver.18: Access! now has an Icon... Compliments of:
-
- Tim Roach of CrawfordsVille, Ind.
- Thanks Tim, Looks good, I might have never gotten around to it...)
-
- (NOTE: Ver.19: You can NOW specify "SPLIT-SCREEN" at start-up in the ICON...
-
- Features available using "TOOL-TYPES" in ICON:
-
- PHONE="myphone.file" -> looks for "myphone.file" in current then SYS:
- dirs.
- KEYS="my.keys" -> uses "my.keys" for keymacros.
-
- INTERLACE=ON -> hmm....
-
- SPLIT=ON -> sets interlace on and then splits sceen at
- start-up.
-
- History:
- ~~~~~~~~
- Ver.20
- ~~~~~~
- Additions:
-
- 1) NEW "Phone Book" added. (see "Phone Book:" below for details)
-
- 2) Now supports 60 phone numbers (as compared to 44)
-
- 3) bug fix in "color palette" (see "Load" under "Color Palette"
- below)
-
- 4) modified "Redial" option (slightly)
-
-
- Ver.19 (limited posting on AMIC)
- ~~~~~~
- Additions:
-
- 1) Load/Save option added to "Palette" window! (see below)
-
- 2) Split-Screen option now supported from WBench ICON.
-
- 3) "Help" window updates more often to help monitor Memory Available.
-
- 4) "Cleaned-up" gadgets a little...
-
- Ver.18
- ~~~~~~
- Additions:
-
- 1) New "Macro Window" added (see Macros: below)
-
- 2) Fixed "CHAT" mode (now works on 512K machines, see below)
-
- 3) Once again, minor code changes and "window dressing"
-
-
- Ver.17
- ~~~~~~
- Additions:
-
- 1) Second "Fast-Menu" (see Fast Menu: below)
-
- 2) TRUE "Split-Screen" mode (see Fast Menu: below)
-
- 3) Minor code optimizing and "window dressing"
-
-
-
- Ver.16 (first "public" BETA release)
- ~~~~~~
-
- While learning "C" I decided to "Hack-up" someone else's
- (EXCELENT) program....
- This program is essentually "Comm 1.34e", with the changes listed
- below.
-
- When I first started modifying it, I had it open up on a three
- bit-plane screen, giving me 8 colors to play with (and support for
- 8 color BBS's). I then proceeded to add custom gadgets and more color
- to the menus ect...ect...
-
- Well, I wasn't happy with JUST 8 colors (I'm greedy! :-) so...
- I changed it to 4 bit-planes and 16 colors! (this seems to satisfy
- my needs for now :-).
-
-
-
- Additions:
- ~~~~~~~~~~
- 1) It now supports 16 Colors!
- ~~~~~~~~~~~~~~~~~~~~~~~~~~
- Access! now opens up on a 4 bit-plane screen, giving
- a total of 16 colors (1 background and 15 foreground).
-
- Colors 0-7 can be used for Text foreground/background
- color combinations. (see "Color Menu" below).
-
- Colors 8-15 are used for various menu/gadget colors.
-
- (shame there aren't ANSI codes for colors 8-15:-)
-
- 2) "Color" menu item
- ~~~~~~~~~~~~~~~~
- a) "Reset Text Colors"-> Selecting this will reset both the foreground
- and background colors (colors 1,0 respectively).
- This is usefull if you make a selection on a "Color" BBS in the
- middle of a color change and you get a "bad" color combination.
- (this ever happen to you? :-)
-
- b) "ForeGround Text Color" -> Here you can select the color for text
- in the "receive" window. This color will stay the same until...
- 1:You select another color.
- 2:A BBS (or other terminal) sends an ansi code that changes it.
-
- (NOTE: in split screen mode, the TOP (receive) window will use this
- color,but the BOTTOM (transfer) window will be color #1.)
-
- c) "BackGround Text Color" -> Same as above but for the text
- background color.
-
- (NOTE: see note above :-)
-
- d) "Sample Text Colors" -> This option lets you test your
- foreground/background color selections to see what works best...
-
- EXAMPLE: Select a foreground color, go to "Sample Text Colors",
- select "Background Colors" and your selected foreground
- color will be displayed on 8 different background colors.
- Now try the opposite for background. (confused yet?)
-
- e) "Modify Palette" -> Yep, you guessed it, this will bring up a
- color palette for you to set the colors YOU like. (the colors
- I like are already there).
-
- 1a) "OKAY"-> Selecting this gadget tells the system that the
- current/modified (or not modified) colors are the ones
- you would like to use.
-
- 1b) "RESET"-> This gadget brings back the original "system"
- colors (the ones I like :-). If you get things all messed
- up, you can always get back to where you started.
-
- 1c) "CANCEL"-> This gadget tells the system that you changed
- your mind and it will return you to the last colors that
- were "OKAYed".
-
- EXAMPLE: If you have modified the colors (and hit OKAY)
- and then want the "default/system colors",
- 1. Open the Palette.
- 2. select "RESET"
- 3. select "OKAY" (if you select "CANCEL" instead,
- it will return to the last colors)
- IMPORTANT!
- ~~~~~~~~~~
- ONLY AFTER selecting your colors and CLOSING the palette, open
- up the file-requester and/or menus and check out the colors.
-
- Many of the colors are dependent on each other for the
- gadgets and menus to look "esthitically" pleasing.(in my
- humble opinion anyway :-) But if you find a combination that
- works well, SAVE THEM for later use.
-
- 1d) "LOAD"-> NEW Ver.19
-
- This will load the colors in the given file name. (provided
- they were either "saved" by "Access!" or they are in the
- CORRECT format...
-
- Format for "Color" text files:
-
- 1) Any text you chose may be at the TOP of the file but
- NOT the '%' char. (unless there is no other text and the
- "color values" follow)
-
- 2) There MUST be a '%' char. DIRECTLY proceding the "color
- values" along with a new-line or space between it and
- the values.
-
- 3) The "color values" are writen in "hex" ie:
- %
- 0x000
- 0xf00
- 0x0f0
- 0x00f
- ect... each seporated by either a new-line or a space,
- with NO text between them.(see the file "Acc!.color" for
- an example) (or why go through all the trouble...find the
- colors you like and let "Access!" save them for you :-)
- (NOTE: Please READ the docs in future versions for possible changes in
- this format!)
-
- (NOTE Ver.20: There was a slight "bug" in ver.19... if you selected "Load" and
- then changed your mind and hit "Cancel" (on the file requester)
- you were reset to the "System" colors! instead of the current
- colors. (amazing what a couple of "{","}" brackets will do in the
- code :-)
-
- 1e) "SAVE"-> NEW Ver.19
-
- The "save" option will save the currently selected color
- values to a text file with the given name. (see the format
- listed above for details)
-
-
- (NOTE Ver.18: the "Color Palette" option is seeming more and more like a
- double-edged sword... It's nice to be able to CHANGE the colors
- but (as you might have already noticed) I keep using different
- color schemes for different funtions! And so when you think
- you've got some colors you like... BAM!, they don't ALWAYS look
- good on some other menu/window/gadget/text ect... OH Well, such
- is life :-) (that's the REASON for the RESET button)
-
-
- 3) FAST MENU
- ~~~~~~~~~
- (NEW Ver.17: There are now 2 Fast menus!, the items on them may move around
- (even from one to the other) but both menus work the same so
- I'll just list them and you should find them on one menu or
- the other (unless I delete it altogether :-)).
-
- You might (should) (will) notice a New "FAST MENU BAR" accross the
- bottom of the screen. Most of these are self explanitory(sp) and are
- just short-cuts to the menu-items. There are a few that need further
- explanation....
-
- a) "QUIT" -> hmmmmmm.....
- b) "INFO" -> brings up the "Status Window" (same as <Help> key)
- c) "PRINT" -> Starts Printer (if you have one hooked up :-)
- d) "CAPT" -> Starts Capture (with file name)
- e) "XUP" -> " XModem (or WXModem) send
- f) "XDOWN" -> " XModem download
- g) "WXDOWN"-> " WXModem download
- h) "CHAT" -> Chat Mode (Split Screen mode on Comm1.34)
- i) "COLOR" -> Brings up the Color Palette
- j) "NEWCLI"-> Starts a NewCli (flip back to WBench to find it)
- k) "MACROS"-> New (Ver.18) Opens "Macro Window" (see below)
-
- l) " ^ " -> (Up Arrow) This gadget will send the "FAST MENU" to the
- top of the screen (and back again)(NOTE: if your cursor
- is at the top of the screen when you send the menu bar
- up there, it will "hide" the cursor. (if for some reason
- you can't find the cursor, move the fast menu and it will
- probably be there.) If you select "CHAT" AFTER the menu
- is at the top, the cursor will move down for you.
- (NOTE Ver.17: this gadget works the same for both "FAST MENUS")
-
- //
- m) "\X/ " -> (check mark) This gadget will bring the "Status Line"
- (which is at the bottom under the "Fast Menu") to the
- top. If you want info about the last file you downloaded
- or the last number you dialed, it will show up there.
- (there is also an "invisable" gadget on the "Status Line"
- to let you flip back and fourth)
- (NOTE: the status line does not move with the fast menu,
- it stays at the bottom.)
-
- (NOTE Ver.17: this gadget is now essentually a "back" gadget,)
- (NOTE Ver.18: this gadget is now "visable" in the status line)
-
- n) "ASEND" -> Starts ASCII "Send" mode (same as normal menu selection).
- o) "HANGUP" -> Sends out "hang-up" string to modem.
-
- p) "DIAL" -> NEW Ver.20!
-
- Although not yet in "finished" form, There is now a
- "Phone Book" window.
-
- Usage is fairly straight-foward but I'll expand a little
- anyway... When the "Phone Book" opens, you'll see 30
- phone numbers list along with some other gadgets/info...
-
- 1) "ADD" -> N/A (this version) will allow you to add numbers
- (up to 60 total) to the "Phone Book".
-
- 2) "DELETE"-> N/A (this version) opposite of "ADD" (above)
-
- 3) "EDIT" -> currently loads the current "Phone Book" into "ED"
- for editing. (future versions will allow editing
- single phone numbers without leaving the "Phone Book")
-
- 4) "LOAD" -> brings up the file requester for loading in new
- "Phone Books" ("Comm1.34" format, but now up to 60
- numbers (used to be a 44 number limit))
-
- 5) "SAVE" -> N/A (this version)
-
- 6) " ^ " -> (up arrow) This will shift the display between
- numbers 1-30 and 31-60. (this variable is stored so
- that the next time you open the window, you will see
- the previously selected set of numbers)
-
- 7) "CANCEL"-> This will close the window without dialing any
- number (possibly numberS in the future)
-
- 8) "OKAY!" -> Dials Currently selected number (if any)(possibly
- numberS in the future)
-
- (NOTE: BTW, to select a number, just click on it :-)
-
-
- q) "REDIAL" -> Simply "re-dials" last number dialed...
- r) "FONT" -> still N/A (this version)
- s) "SERIAL" -> still N/A (this version)
- t) "ABOUT" -> short text about "Access!"
- u) "CLOCK" -> N/A (this version)(somebody got a small clock routine?)
-
- v) "SPLIT" -> NEW Ver.17
-
- I saved this one for last so I can explain it in a little
- more detail(and 'cause I think it's the best thing I've
- done so far! :-).
-
- Selecting "SPLIT" (currently not a normal menu item)
- will give you a TRUE split screen!, which means no more
- swapping back and forth to the WorkBench screen to see
- how your "unarcing" is coming along (know of a good,
- small "DirUtil"? like one that takes up half of a
- screen... ? )( hint, hint ).
-
- What it actually does is shrink the term down to normal,
- non-interlaced size (640*200) and moves the screen
- half-way down. Thus giving you a 23 line (interlaced)
- terminal on the bottom of the screen w/out losing any of
- the normal terminal display area ( of course you dont
- get as many lines as a "full/sized/interlace/display"
- but you can swap back and forth as you like!)
-
- Seleting "SPLIT" again returns you to a Full/Sized/
- Interlace screen again (it's a toggle switch).
-
- (NOTE: this option works very well when used with the
- "NEWCLI" option above or with a "half-screen
- DirUtil" if there's one around or better yet,
- with WBench set to interlace also.(although I
- haven't taken the time to try it.))
-
- (ANOTHER NOTE: this option can be selected at start-up by using
- the "-s" (or "-S") as a command-line argument.
- ( example: at the prompt, 1> Access! -s )
-
- (ONE MORE NOTE: this option is currently only supported in
- "interlace" mode.
- 1> Access! -i (sets interlace on)
- or
- 1> Access! -s (which also sets interlace on)
-
- (NOTE Ver.18: the cursor now moves down one if one of the "Fast-Menus"
- is at the top when you select "SPLIT")(as it should!)
- (NEW Ver.19: this option also available from WBench ICON (see above))
-
- 4) Macro Window
- ~~~~~~~~~~~~
- (New Ver.18) Selecting this option (from the "Fast-Menu") now opens up a
- "Macro Window" that will let you see/edit/load/save all currently
- defined macro keys (F1-F10,<shift>F1-F10).
-
- usage: When the window opens, you will see 10 funtion key definitions.
- Hit the "arrow" gadget to toggle between shifted/non-shifted keys.
-
- To edit one, simply point to it and "click". It will then move
- down to the editing line where you can make your changes. When
- your through, be sure to hit <return> before moving on or your
- changes will be lost!
-
- The new definitions will be in effect until you either quit the
- program, change them again, load in new ones, or (heaven forbid)
- crash. Select "Save" to save them to disk for future use.
-
- BTW, if for some reason while you're editing you hit the
- "switch" gadget (arrow) and THEN hit <return> your changes will
- go onto the current page at the same location.(might be useful
- for "copying" from F1->S1 ect.. but not much else :-)
-
- a) "OKAY" -> when your done editing/loading/saving ect.. this will
- close the window.
-
- b) "SAVE" -> brings up the "Input" window and saves macros to the
- name you supply. (access! currently looks for
- "Acc!.keys" at startup, unless you specify otherwise
- on the comand line or in the Icon from WBench.)
-
- c) "LOAD" -> opposite of "SAVE" (above)
-
- d) "CANCEL"-> currently acts the same as "OKAY" above (selcting this
- gadget COULD be used for "undoing" any current changes,
- but this would take a little more "overhead" and I left
- that option out for now...)
-
- e) " ^ " -> (arrow) click on this to toggle between "shifted" and
- "non-shifted" funtion key definitions.
-
- (NOTE: the menu options regarding "keymacros" still operate as they used
- to, these option will be taken out of future versions to cut down
- program size.)
-
- (NOTE Ver.19: as stated above, the "menu" options regarding "keymacros"
- HAVE NOW been taken out.)(didn't cut down the size that much but
- every little bit helps :-)
-
-
-
- Other:
- ~~~~~~
- 1) Now checks for ".ZOO / .zoo" extension and for disabling auto-chop.
-
- 2) Routine added to "Confirm()" downloaded file, displayed in "Status-Line"
- (size may be off by a byte or so but if it shows "0" bytes, then you
- know you didn't get the file :-)
-
- 3) File-Requester now supports up to six devices.(currently DF0:,DF1:,DF2:
- DH0:,RAM:,VD0: but future versions will "Dynamically" set up for devices
- you actually have mounted) (I'm still learning :-)
-
- 4) Various graphic/gadget enhancements. (let me know what you think)
-
-
- (Ver.18)
- ~~~~~~
- 5) Older versions (even the original "Comm1.34") had problams with eating
- too much memory when going into "CHAT" mode (split-screen on Comm1.34).
- Thus, if you only had 512K, chances were that you could not use this
- feature. I've re-writen that routine and it should now be possible to
- use this option (even in interlace) with a 512K machine. If you STILL
- have problems with this option (or other windows not opening) try
- shrinking down any windows you have open in the background (yes, even
- "empty" CLI windows eat up mem.)
-
- (NOTE Ver.19: I've shortened the delay in the splitting process... let
- me know if it cause's the problem mentioned above)
-
- Deletions:
- ~~~~~~~~~~
- Yes, I'm guilty.... I took out the "Veiw Window" and the "Debug Functions"
- I never used them and I'm trying to keep the file size down.
-
- Ver.20-> The "phone" menu item seems to have "vanished", I don't know where
- it went (grin) but it's just as well since all these funtions are
- now handled in the new "Phone Book" feature.
-
- Known Bugs:
- ~~~~~~~~~~~
- I don't know of any "REAL" bugs, but the error checking is not what it
- should be.
-
- For example you CAN open every window/requester at the same time...
- This is NOT good and SHOULD be AVOIDED! (or you might see a number to
- meditate over :-)(although if you close them back down in the right order,
- it should be OK, as long as you don't fiddle with a bunch of gadgets while
- they're open)
-
- (Ver.18)
- ~~~~~~
- still haven't added any more error checking....that's kinda' like doing
- the dishes after eating a good meal... (I'll get around to it...)
-
- (Ver.19)
- ~~~~~~
- I quess it goes without saying... I haven't gotten around... BTW, DON'T
- PLAY WITH THE GADGETS DURING A TRANSFER! (it doesn't really hurt anything
- but you might get a LOT of NAKS or no file at all!)
-
- (Ver.20)
- ~~~~~~
- Hmmm... ( I'm tired now, maybe next time...)
-
- That's It For Now:
- ~~~~~~~~~~~~~~~~~~
-
- Besides these changes, it's good ole 100% "Comm 1.34" under the hood, so
- refer to your "Comm134e.docs" for info on the other features of this FINE
- term.
-
- Like I Said to start with, I'm working on this as an exorcise in "C".
- I was/am inspired by what David Salas has done (is doing) with "AMICTB"
- terminal program.(FANTASTIC, Dave. Keep up the good work! and THANKS for
- answering some DUMB questions:-)
-
- This is not meant to COPY what anyone else is doing, it's
- just what I'D like to see in a term. (of course I'd LIKE to see a lot more,
- but I'm still working on it).
-
- Please send all BUG REPORTS, KUDO'S, HELP, SUGGESTIONS, INSULTS (grin) to...
-
- AMIC: Keith Young
- GENIE: K. Young
-
- ( or anywhere else you see my name listed )
-
- Snail Mail: K. Young
- RT. 2 BOX 13G
- MONETA, VA.
- 24121
-
-
- ___________I CODE TO BE FRUSTRATED, DON'T WE ALL? AND ISN'T IT FUN?___________
-