home *** CD-ROM | disk | FTP | other *** search
/ Current Shareware 1994 January / SHAR194.ISO / helpfile / fterm201.zip / FRACTERM.DOC next >
Text File  |  1992-10-23  |  22KB  |  520 lines

  1.  
  2.                               FracTerm
  3.                      The Fractal Terminal Program
  4.                           Copyright (c) 1992
  5.                              Fracterm Inc.
  6.  
  7.                            What is FracTerm?
  8.  
  9.    FracTerm is a communcations program, with a twist.  Like many other
  10. communications programs, FracTerm uses ANSI terminal emulation, allows
  11. file transfers using the Zmodem protocol, has a dialing dorectory,
  12. settings menu, and several other features.
  13.  
  14.    What sets FracTerm apart from the rest, however, is its ability to
  15. view fractally compressed images.  So what's the big deal about fractally
  16. compressed images?  Well, consider being able to send a clear, full-color
  17. image over a communications line in as little as 6 seconds.
  18.  
  19.    Sounds impossible, or at least unlikely?  Well, until recently, it was.
  20. Now, thanks to a method known as fractal transform technology, it is not
  21. just possible, it is here.
  22.  
  23.    Now that we have the technology, what can be done with it?  Well, the
  24. commercial applications are virtually unlimited.  A simple example would
  25. be in the real estate field.  A potential customer could call in, from
  26. his or her own living room, and see actual photographs of the houses
  27. available, without ever having a saleperson involved.
  28.  
  29.    However, this, in itself, is a limited approach - little more than
  30. looking at pictures.  We've taken the idea one step further.  To continue
  31. the real estate example, wouldn't it be nice if the user could select the
  32. type of house they were looking for, and  the price range, and then only
  33. see the pictures that related to their needs?
  34.  
  35.    Our FracTerm program offers this capability and more.  Using a simple
  36. three level structure, the user can easily track down exactly what they
  37. want, and only receive the images that apply to them.
  38.  
  39.    However, that is not the end of FracTerm's talents.  Along with each
  40. image can be a text file, which will be sent along with the image, and
  41. which the user can view while viewing the image.
  42.  
  43.  
  44.                         How does FracTerm work?
  45.  
  46.    Well, there are two modes of operation for FracTerm.  The default
  47. mode, the mode FracTerm starts up in, is called terminal mode.  From
  48. here, you can change your configuration, call a remote system, or exit
  49. FracTerm.
  50.  
  51.    The other mode is the online store, or catalogue mode.  In this mode
  52. you can take advantage of the fractal images, graphical interface, and
  53. the other special features.
  54.  
  55.       Commands available in terminal mode
  56.  
  57.    From the terminal mode screen, you can access the following functions.
  58.  
  59.       Dialing directory
  60.  
  61.          Under this menu, you can add, delete, insert, or sort the names
  62.          and numbers of remote systems, or you can call a remote system.
  63.          This menu is available by pressing ALT+D.  Note that if you
  64.          are already connected to a remote system, this menu
  65.          will not appear.
  66.  
  67.       Settings Menu
  68.  
  69.          Under this menu, you can change your communications port,
  70.          modem baud rate, initialization, dialling and hangup strings,
  71.          and one or two other minor options.  This menu is available
  72.          by pressing ALT+S
  73.  
  74.       Exit FracTerm
  75.  
  76.          You can exit FracTerm from the terminal screen by pressing
  77.          ALT+X.  If you are still connected to a remote system,
  78.          a message window will pop up asking you if you really want
  79.          to exit.
  80.  
  81.       Hangup Modem
  82.  
  83.          You can hangup the modem from the terminal window by pressing
  84.          ALT+H.  Note that if you are still connected to a remote system,
  85.          a message area will pop up asking you if you really want to
  86.          disconnect.
  87.  
  88.       Miscellaneous functions
  89.  
  90.          Currently there is only one other useful function available
  91.          from terminal mode.  If you press CTRL+F1, the screen will
  92.          clear, and a message saying "Coreleft: xxxxx" will appear.
  93.  
  94.          If you plan to use the FracTerm online store mode, you should
  95.          try this and note the numeric value returned.  If the value
  96.          is less than abour 300,000 you will likely not be able to
  97.          view any images, as the decompression routines require a
  98.          lot of free memory.
  99.  
  100.  
  101.       Key Mappings in Terminal Mode
  102.  
  103.          After several requests from users, we have installed more
  104.          robust keyboard handling in FracTerm.  Now supported are a
  105.          subset of the ANSI and VT-100 keystroke maps.  The keymap
  106.          we use is as follows:
  107.  
  108.         Press           VT-100 Equivalent               Values Sent
  109.  
  110.         Tab             Horizontal Tab                  9
  111.         Delete          Character Delete                127
  112.         Insert          Select Insert mode              22
  113.         Home            Home Cursor                     ^[H
  114.         Cursor Up       Cursor Up                       ^[A
  115.         Cursor Down     Cursor Down                     ^[B
  116.         Cursor Left     Cursor Left                     ^[D
  117.         Cursor Right    Cursor Right                    ^[C
  118.         Alt-C           Clear screen                    ^[H^[2J
  119.         End             Erase end of line               ^[K
  120.  
  121.         F1              Keypad Application mode 1       ^OP
  122.         F2              Keypad Application mode 2       ^OQ
  123.         F3              Keypad Application mode 3       ^OR
  124.         F4              Keypad Application mode 4       ^OS
  125.         F5              Keypad Application mode 5       ^Ot
  126.         F6              Keypad Application mode 6       ^Ou
  127.         F7              Keypad Application mode 7       ^Oq
  128.         F8              Keypad Application mode 8       ^Or
  129.         F9              Keypad Application mode 9       ^Op
  130.         F10             Keypad Application mode 0       ^OM
  131.  
  132.         Ctrl-F1         Display memory available        n/a
  133.         Ctrl-F10        Send password for current BBS   n/a
  134.  
  135.         Note:   in the above list, the caret "^" symbol is
  136.                 used to denote the ESCape character, ASCII
  137.                 value 27.  Entries marked with "n/a" have
  138.                 no equivalence in VT-100 or ANSI emulation.
  139.                 Entries with only a numeric value will send
  140.                 the ASCII character denoted by the decimal
  141.                 value which is displayed.
  142.  
  143.                   A closer examination of terminal mode menus
  144.  
  145.                               Dialing menu
  146.  
  147.    The dialling menu allows you to manipulate a small phone book, with
  148. names and phone numbers.  You can add, delete, edit, or sort the entries
  149. in the phone book.
  150.  
  151.    If you look at the bottom of the screen, you will see a number of
  152. highlighted options.  In order to access the function you want, simply
  153. press the highlighted key. For example, to sort the dialing directory,
  154. press S.  Not all of the options are currently functional.  The ones that
  155. are will be discussed here.
  156.  
  157.    Edit
  158.  
  159.       This allows you to edit an entry.  A window will pop up on the
  160.       screen, with a highlight bar to show you which field is currently
  161.       being edited.  You can move around the entry using thr cursor keys.
  162.  
  163.       Once you have finished editing an entry, you must decide whether
  164.       to accept or discard the changes.  To save them, press F10.  To
  165.       throw them away, press the ESC key.
  166.  
  167.    Sort
  168.  
  169.       Using this option, you can sort the entries in the phone book.  In
  170.       order to use this, there must be at least three entries with data in
  171.       them.  Currently, the sort is automatic, sorting on the name field.
  172.  
  173.    Insert
  174.  
  175.       This allows you to insert a blank entry just ahead of the currently
  176.       hilighted entry.  It presumes that there is still at least one free
  177.       slot available in the directory, which is currently set to a
  178.       maximum of 45 entries.
  179.  
  180.    Delete
  181.  
  182.       This allows you to delete an entry from the dialing directory.  If
  183.       the entry actually contains data, a message window will pop up
  184.       asking if you really want to delete the entry.
  185.  
  186.    Dial
  187.  
  188.       This is the final supported function.  To dial the currently hilighted
  189.       entry, simply press RETURN or ENTER.  Near the bottom of the screen,
  190.       a message saying "Dialing xxx-xxx" will become visible.  This message
  191.       will remain visible until one of three things happens - you press
  192.       a key, the attempt to connect fails, or the attempt to connect
  193.       succeeds.
  194.  
  195.       If the dial succeeds, and you actually connect to a remote system,
  196.       the entire dialing directory is removed from the screen, and you are
  197.       placed back in terminal mode, where you can interact with the remote
  198.       system.
  199.  
  200.       If the dial fails, or if you press a key, the "Dialing xxx-xxxx"
  201.       message disappears, but you remain in the dialing directory,
  202.       where you can either dial again, or select a different entry
  203.       to call, or you can exit.
  204.  
  205.  
  206.                               Settings Menu
  207.  
  208.    The settings menu allows you to configure FracTerm for your system,
  209. selecting such things as the port your modem is connected to, the
  210. baud rate at which your modem communicates, and the commands necessary
  211. to dial, initialize, or hang up your modem.
  212.  
  213.    Init String
  214.  
  215.       This is the string needed to initialize your modem.  This depends
  216.       on the make and model of your modem.  A typical example might be:
  217.  
  218.          AT E0 X3 &C1 M1 L3
  219.  
  220.    Dial String
  221.  
  222.       This is the string needed to dial your modem.  Generally, this will
  223.       be either ATDT (for touch-tone dialing) or ATDP (for pulse dialing).
  224.  
  225.       However, you may have a PBX system that requires a 9 followed by
  226.       a pause, or some similar setup, and this is where you set the
  227.       options necessary for your system.  Note that any special requirements
  228.       will depend upon your make and model of modem.
  229.  
  230.    Hangup String
  231.  
  232.       This is the string needed to hang up your modem.  Generally, the
  233.       string
  234.  
  235.          ~~~+++ATH0
  236.  
  237.       will do the job, but your particular modem may differ.  For those of
  238.       you whose modems need to have DTR lowered to hang up, this is done
  239.       automatically.
  240.  
  241.    Com Port
  242.  
  243.       This is the port through which your modem communicates.  The valid
  244.       range is 1 to 4.
  245.  
  246.    Baud Rate
  247.  
  248.       This is the speed at which your modem communicates.  For example,
  249.       if you have a 1200 baud modem, set this value to 1200.  For those
  250.       of you with the newer high-speed modems, you can set the baud
  251.       rate to 38400 and it will remain locked at that rate.
  252.  
  253.  
  254.  
  255.  
  256.                           The online catalogue
  257.  
  258.  
  259.    For commercial purposes, this is the most important mode.  As an end
  260. user, you cannot directly access this mode.  It is started automatically
  261. by the remote system, assuming it is configured for use by our FracBBS
  262. software package.
  263.  
  264.    This mode is entirely graphical, with simple, easy to navigate menus
  265. and controls.  When it first starts, you will see a graphical menu, with
  266. a blue box in the top left, displaying the remote system's name and
  267. licensing information.
  268.  
  269.    At the top right of the screen, you will see a number of button
  270. controls, and near the bottom, you will see a list of categories ("areas")
  271. to choose from.
  272.  
  273.    A real estate system may have a list of areas similar to the following:
  274.  
  275.       Townhouses
  276.       Duplexes
  277.       Condominiums
  278.       Single-level houses
  279.       Multi-level houses
  280.       Commercial properties
  281.  
  282.    You can move the hilight bar with the cursor keys, selecting one of the
  283. categories by pressing ENTER.  If you look at the middle right of the screen,
  284. you will see a message saying "Requesting file" followed by "Initializing",
  285. then a list of percentage values up to 100%.  If everything works according
  286. to plan, this should finish with a message saying "Transfer complete".
  287.  
  288.    Once the requested information is available for use, the sub-categories
  289. ("dirs") are displayed, and you can then select from them.  In our example,
  290. if you had chosen "Townhouses" as an area, the dir list might be something
  291. like:
  292.  
  293.       Under $50,000
  294.       $50,000 - $100,000
  295.       $100,000 - $250,000
  296.       $250,000 - $500,000
  297.       Over $500,000
  298.  
  299.    Now, you can select the appropriate subcategory, or dir, to examine, and
  300. press ENTER.  The information for that dir is requested, and will then be
  301. displayed.  Had you picked the "$100,000 - $250,000" dir, you might see
  302. a list as follows:
  303.  
  304.       Four rooms, two baths, fireplace, jacuzzi
  305.       Three rooms, near school, needs repairs
  306.       Brand new five rooms, near downtown
  307.  
  308.    Finally, you can select the appropriate item and press ENTER.  A last
  309. file request, and in a very few seconds, your image will be displayed, as
  310. well as any text that comes along with it.
  311.  
  312.    With the image and text on the screen, you can use the cursor keys to
  313. move around the text display, or you can use the button commands to either
  314. navigate the dir and area tree, zoom the image, or exit to terminal mode.
  315.  
  316.    Two of the buttons, Previous and Next, work in the current dir.  If
  317. you are viewing, say, the third image in the current dir, pressing previous
  318. will display the second image, requesting it from the remote system if
  319. needed.  Similarly, the Next button would advance you to the fourth, then
  320. the fifth, image in the current dir.
  321.  
  322.    The Dir button allows you to "back up" one level, so that you can change
  323.    your dir selection - from "$100,000 - $250,000" to "over $500,000", say.
  324.  
  325.    The Area button allows you to jump back to the first menu, so that you
  326.    could change from "Townhouses" to "Commercial properties".
  327.  
  328.    The Zoom button allows you to expand the image to full-screen, where it
  329.    will remain until you press a key.
  330.  
  331.    Lastly, the Exit button will shut down the catalogue, returning you to
  332.    text mode and normal remote interaction.
  333.  
  334.    So how do you use the buttons?  Simple.  One letter on each button is
  335. highlited, by a captial letter and an underline.  To activate the associated
  336. function, simply press the highlighted letter.  So, to zoom the image,
  337. you would just press 'Z'.
  338.  
  339.    Note that if you already have the CONFIG.BBS file, the area files,
  340.    and the images, you can use this feature without connecting to a
  341.    BBS.  Simply run FracTerm and press CTRL-PGDN.
  342.  
  343.  
  344.                           Auto-View Mode
  345.  
  346.    FracTerm also supports an interactive image viewing mode which does
  347. not require that the remote system has a complete online catalogue set
  348. up.
  349.  
  350.    Let's say all you wanted to do is view the images in a given area.
  351. All you would have to do is tell the remote system to send '*.FIF',
  352. or perhaps 'NAME*.FIF', and it will send all the appropriate images.
  353.  
  354.    As soon as FracTerm sees the '.FIF' extension on a filename, it
  355. puts the name in a queue, and pops up the interface.
  356.  
  357.    From within the interface, in this mode, the Area and Dir buttons
  358. have no effect.  Exit, Zoom, Previous and Next are operational, and
  359. work just as they do in the online catalogue.
  360.  
  361.    There is also an added feature in this mode that is not available in
  362. catalogue mode.  The image names are stored in a queue, so that you can
  363. move forwards and backwards through the images.  But, you may well have
  364. a dozen or more images, and you may wish to quickly move to the last (or
  365. the first) image, without viewing all the intermediate images.
  366.  
  367.    No problem.  To jump to the first image in the list, press CTRL-P.
  368. To jump to the last image, press CTRL-N.
  369.  
  370.    One thing to note here.  The queue is maintained during multiple
  371. downloads, and even during multiple calls.  So, if you have downloaded
  372. one set of images, then exit the interface and start to download another,
  373. don't be surprised if the first image displayed is not the one you
  374. expected.  It will be the last one you viewed, not the first of the
  375. new batch.
  376.  
  377.    One last note about this mode.  There is currently no method to pop
  378. up the interface in this mode once you have exited it.  This means that
  379. you cannot, for example, download 200 images, view 10, exit to terminal
  380. mode, disconnect the modem, then return to your viewing.  We do hope
  381. to add this in the near future, but its not there yet.
  382.  
  383.    Please be advised that this feature has been disabled in FracTerm
  384.    releases 1.11 and 1.12.
  385.  
  386.  
  387.                         Installing FracTerm
  388.  
  389.    Installing FracTerm is a simple process.  First, copy all the files
  390. into an empty directory on your hard disk.  We'll use C:\FRACTERM as an
  391. example.
  392.  
  393.    There is a small utility, called "WHICHVGA.COM", that comes with FracTerm.
  394. It is used to determine what video adapter you have, so that we can make
  395. the most of your video support.  Simply run WHICHVGA, and it will tell you
  396. what VGA adapter you have.  The currently supported cards are:
  397.  
  398.          ATI VGA Wonder series                  (ISIATI88.SYS)
  399.          Tseng 3000 (eg Orchid Prodesigner)     (ISITSNG3.SYS)
  400.          Tseng 4000 (eg Pixel Turbo)            (ISITSNG4.SYS)
  401.          Paradise                               (ISIPRDS.SYS)
  402.          Trident 8900                           (ISITRI89.SYS)
  403.  
  404.    If you have a supported video card, note the filename in parentheses
  405. beside your card.  This file is a device driver, which we need to support
  406. extended graphics capabilities on your system.
  407.  
  408.    Using a text editor, edit the file C:\CONFIG.SYS.  At some point in
  409. the file, add a new line to it, reading:
  410.  
  411.       DEVICE=C:\FRACTERM\ISIATI88.SYS
  412.  
  413.    Remember to change "C:\FRACTERM\" to the directory where you are installing
  414. fracterm, and to change "ISIATI88.SYS" to the appropriate filename for your
  415. video card.  For example, if you installed FracTerm into E:\TEMP, and you
  416. have a Paradise video card, your new line in C:\CONFIG.SYS would read:
  417.  
  418.       DEVICE=E:\TEMP\ISIPRDS.SYS
  419.  
  420.    Save the changes to the file, exit your text editor, and reboot your
  421. system.  You should see the device driver install, and away you go.  You
  422. can now run FracTerm in high-resolution, 256 color mode.
  423.  
  424.    If you don't have a supported video card, or cannot get the device driver
  425. to install, no fear.  FracTerm will still work for you.  The only difference
  426. is that unless zoomed, the images will only be displayed in 11 colours,
  427. instead of 251.
  428.  
  429.  
  430.  
  431.                            WARNINGS
  432.  
  433.    FracTerm requires a minimum of an 80286-based system with a VGA video
  434. card.  Any attempt to run it on an 80186 or 8086/8088 system, or a system
  435. eqipped with an MDA, Hercules, CGA or EGA video card will lead to
  436. unpredictable results - it may work in terminal mode, it will NOT work
  437. properly in catalogue mode.
  438.  
  439.    FracTerm also does not like most disk-caching software.  Specifically,
  440. do not try to run FracTerm with a write-back or staged-write disk cache.
  441. Remove the disk cache first, or, if you forget, exit FracTerm and then
  442. remove or disable the cache.  Do not try to disable the cache from
  443. within FracTerm.
  444.  
  445.    One problem we have tracked down in our latest tests is with
  446. faster systems, notably 386 40Mhz systems.  Occasionally, a "Drive not
  447. ready reading/writing drive C:" message will pop up, effectively
  448. locking FracTerm operation.  We have found that changing the wait
  449. states on the system memory cache will generally fix this.
  450.  
  451.    It may also be necessary to change the wait states on RAM access.  A
  452. zero-wait-state 386-40 will not, apparently, run FracTerm properly.  As
  453. a recommended minimum, set cache wait states to 1, and memory wait
  454. states to 2.
  455.  
  456.    FracTerm now (as of V1.13) has fixed the network incompatibility
  457. problem with LanTastic.  This problem was actually found to be not a
  458. problem with the network, but with our method of font support in
  459. graphics mode.  Further, it turned out to be not related to the network
  460. at all, but to our memory manager and re-mapped ROM areas.  Note,
  461. however, that FracTerm does not run properly if you are logged on
  462. to your own system (i.e. if your system is a server, and you log
  463. into it).
  464.  
  465.    If you find a situation in which FracTerm simply will not run, please
  466. jot down your system configuration, with the contents of your CONFIG.SYS
  467. and AUTOEXEC.BAT files, plus any other information you may feel is relevant,
  468. and we'll see what we can do.  If you get a "Drive not ready..." error,
  469. please also include the makes and models of your hard drive(s) and
  470. controller(s).
  471.  
  472.  
  473.                      A few notes to keep in mind
  474.  
  475.    The "two-run" glitch - which caused FracTerm to bomb out the first time
  476. you ran it, has now been fixed.  It was a timing problem, and the order
  477. of operations has been changed so that it should not happen.
  478.  
  479.    When in catalogue mode, it is possible that a file may not be received
  480. correctly, in which case, you should see a message in the blue status bar
  481. saying "Transfer failed".  Rather than trying to use a corrupt file,
  482. FracTerm deletes the file.  Simply selecting the same file again should
  483. make it work.
  484.  
  485.    If you have a fairly slow system, and a high-speed modem, you may get
  486. more errors than you might otherwise expect.  This could be because of
  487. the overhead in the multitasker.  There is a fix for this: you need to
  488. get a special chip, called a "16550 UART", for your serial port.  Any
  489. computer store should be able to get this for you and install it for you.
  490.  
  491.  
  492.                        Quick Key Summary
  493.  
  494.    Terminal mode:
  495.  
  496.       ALT-C     Clear Screen
  497.       ALT-D     Dialing directory
  498.       ALT-H     Hangup modem
  499.       ALT-S     Settings menu
  500.       ALT-X     Exit FracTerm
  501.       CTRL-F1   Find free memory (should be at least 300,000)
  502.       CTRL-PGDN Start the offline catalogue.
  503.  
  504.       Note: ANSI cursor keys and function keys are supported in
  505.             terminal mode.
  506.  
  507.    Catalogue mode:
  508.  
  509.       A         Go to main area listing
  510.       D         Go to dir listing for current area
  511.       E         Exit calatlogue mode
  512.       N         Select next image in current dir
  513.       P         Select previous image in current dir
  514.       Z         Zoom
  515.  
  516.       Note: pressing ESC will "back up" one level - from images to the
  517.             dir list, and from the dir list to the area list.
  518.  
  519.  
  520.