home *** CD-ROM | disk | FTP | other *** search
/ Frozen Fish 1: Amiga / FrozenFish-Apr94.iso / bbs / alib / d8xx / d869 / cl_sep92.lha / CL_SEP92 / FullView_doc < prev    next >
Text File  |  1993-03-14  |  12KB  |  298 lines
  1.  
  2.             --------------------------------------
  3.             -       FullView v3.04       -
  4.             -                    -
  5.             - (c) Copyright 1991 Jonathan Potter -
  6.             --------------------------------------
  7.  
  8.         -- See the bottom of this file for changes --
  9.  
  10.     FullView is a text viewer that offers fast, smooth-scrolling
  11.   ANSI compatible text displays. This is now Megadisc's text viewer of
  12.   choice and to get the most out of it, read through this doc, and check
  13.   out the menus (with right mouse button).
  14.  
  15.     FullView opens up to the full size of the Workbench screen
  16.   (non-interlaced).  Because there is no slider gadget at the side of the
  17.   screen, you are able to view full 80 column text with a standard
  18.   Workbench configuration (many text viewers only show 78 columns across).
  19.  
  20.     To start FullView from the CLI, simple type
  21.  
  22.         FullView filename
  23.  
  24.     or from the Workbench, double-click on a project icon that has
  25.   FullView as its default tool.
  26.  
  27.     FullView will load text and pictures that have been crunched
  28.   with PowerPacker, by Nico Francois.
  29.  
  30.     FullView has a built-in help screen that can instantly explain
  31.   its functions, as well as remind you of the keyboard equivalent of many
  32.   commands. However, here are brief instructions on the operation of the
  33.   commands. They are listed with the command name (if this command is
  34.   accessed from a menu, this is also the name of the menu item), and any
  35.   keyboard equivalents the command may have.
  36.  
  37.         Load...            AMIGA-L or l key
  38.  
  39.     This command allows you to load a new text file using the built-in
  40.   file requester. The file requester is similar to the Commodore ASL
  41.   requester and to the ARP file requester, and thus most users should be
  42.   familiar with its operation.
  43.  
  44.         Show Pic...        AMIGA-H or h key
  45.  
  46.     This command allows you to display an IFF ILBM picture file. A wide
  47.   variety of formats is supported, including HAM, Overscan, EHB and
  48.   Dynamic-HiRes.
  49.  
  50.         Save As...         AMIGA-V or v key
  51.  
  52.     This command allows you to save the currently displayed text file
  53.   under a new name. This can also be useful for converting
  54.   PowerPacker-crunched text into plain ASCII text.
  55.  
  56.         Print all          AMIGA-P or p key
  57.  
  58.     This command will print the current text file to the printer (PRT:).
  59.  
  60.         Print screen   AMIGA-C or c key
  61.  
  62.     This command will print the currently displayed page of text to the
  63.   printer (PRT:).
  64.  
  65.         Search for...  AMIGA-S or s key
  66.  
  67.     This command allows you to search the current text file for a text
  68.   string.  Wildcard characters are not supported. The search takes place
  69.   from the top of the currently displayed page.
  70.  
  71.         Repeat search  AMIGA-R or r key
  72.  
  73.     This command repeats the last text search, from the current position
  74.   in the file.
  75.  
  76.         About
  77.  
  78.     This function displays some information about the program, including
  79.   version number and how to contact the author.
  80.  
  81.         Help           HELP key
  82.  
  83.     This function displays a brief list of commands and their keyboard
  84.   equivalents.
  85.  
  86.         Iconify            AMIGA-I or i key
  87.  
  88.     This command closes the FullView screen and opens a small
  89.   window on the Workbench screen. This allows you to keep your text file
  90.   in memory and refer to it at any time, but saves on memory when it is
  91.   not actually being accessed. To return to the text file, click where
  92.   the iconified window tells you to. Clicking the close gadget will
  93.   remove the text file from memory without returning.
  94.  
  95.         Quit           AMIGA-Q or q, x, or ESCape key
  96.  
  97.     This command will remove FullView from memory.
  98.  
  99.         Auto scroll        SPACE bar or left mouse button
  100.  
  101.     FullView will auto-scroll text at four different speeds. The
  102.   speed is determined by the vertical position of the mouse; the center of
  103.   the screen is "neutral", and the further away from the center you move
  104.   the mouse, the faster FullView will scroll in that direction.
  105.  
  106.     To toggle auto-scrolling, either press the SPACE bar or press
  107.   the left mouse button. The mouse pointer will disappear
  108.   while FullView is auto-scrolling, and reappear when scrolling
  109.   stops (when you either stop it manually or the text reaches the top or
  110.   bottom).
  111.  
  112.         Line up            Cursor up key or /\ gadget
  113.  
  114.     This function scrolls one line up through the text. If you continue
  115.   to hold down the key or the gadget, this function will repeat after a
  116.   brief interval.
  117.  
  118.         Line down          Cursor down key or \/ gadget
  119.  
  120.     This function scrolls one line down through the text. If you continue
  121.   to hold down the key or the gadget, this function will repeat after a
  122.   brief interval.
  123.  
  124.         Page up            Shift + Cursor up key, u key or U gadget
  125.  
  126.     This function moves one full page up through the text.
  127.  
  128.         Page down          Shift + Cursor down key, d key or D gadget
  129.  
  130.     This function moves one full page down through the text.
  131.  
  132.         Top of text        Control + Cursor up key, t key or T gadget
  133.  
  134.     This function moves to the beginning of the current text file.
  135.  
  136.         Bottom of text Control + Cursor down key, b key or B gadget
  137.  
  138.     This function moves to the end of the current text file.
  139.  
  140.         Jump to line   j key or line gadget
  141.  
  142.     This function allows you to jump to a specified line number. The
  143.   line gadget is the number that displays the current line being
  144.   viewed in the status bar at the bottom of the screen (xxxxx > yyyyy; it
  145.   is the xxxxx value)
  146.  
  147.         Jump to percent    J key or percent gadget
  148.  
  149.     This function allows you to jump a specified percentage into the file.
  150.   This percent gadget is the number that displays the current
  151.   percentage of text being viewed in the status bar (xxx%)
  152.  
  153.  
  154.     IFF routines
  155.  
  156.     FullView can show many different IFF ILBM formats, including
  157.   HAM, Overscan, Extra Half Brite, and Dynamic-HiRes. There are four main
  158.   ways to show an IFF picture with FullView.
  159.  
  160.         a) Run FullView with no arguments, and select an IFF picture with the
  161.            file requester.
  162.  
  163.         b) Once FullView has loaded a text file, select the Show Pic... command
  164.            and select an IFF picture with the file requester.
  165.  
  166.         c) Run FullView from the CLI with the name of an IFF picture and use
  167.            the +p argument.
  168.  
  169.     The +p tells FullView that it is a picture you want to
  170.   show, not a text file to read. The +p goes on the command line,
  171.   after the filename.  For example,
  172.  
  173.                FullView dh0:Picture.iff +p
  174.  
  175.         d) From the Workbench, specify FullView as the default tool of a
  176.            picture file, and add the ToolType :
  177.  
  178.                FILETYPE=ILBM
  179.  
  180.            This has the same effect as the +p argument from the CLI.
  181.  
  182.     When a picture is displayed, there are several key presses that do
  183.   different things. You can turn the mouse pointer on or off with the
  184.   . key. You can stop/start colour cycling (if the file has
  185.   colour cycling information) with the TAB key. Pressing the
  186.   p key will print the picture. If a picture is larger than the
  187.   screen, you can scroll around it using the cursor keys; by
  188.   themselves they move in single steps, in conjunction with Shift
  189.   they move a page, and in conjunction with Control they move to
  190.   the start (or end). To return from a displayed picture, press the
  191.   left mouse button, or the q or ESCape key.
  192.  
  193.  
  194.     TAB size
  195.  
  196.     The default size of tab characters in FullView is 8 spaces.
  197.   You may, if running from the Workbench, specify the tab size yourself.
  198.   To do this, add the following ToolType to the project icon :
  199.  
  200.         TABSIZE=size
  201.  
  202.     size is the number of spaces a tab character is to be
  203.   equivalent to, and may be any number from 1 to 10.
  204.  
  205.  
  206.     ANSI codes
  207.  
  208.     FullView supports the ANSI codes used to change colour and
  209.   type style. Because of the way FullView displays its text,
  210.   there is a limitation on the changing of colour and type style; the
  211.   colour and style is reset at the start of every line. This should not
  212.   cause any major problems, but it does mean that if you wanted a
  213.   rectangle of colour, you would have to specify the ANSI codes for every
  214.   line, instead of just at the start and end of the rectangle. An example
  215.   of this is the rectangular header of this document file.
  216.  
  217.     For your information, the applicable ANSI codes are :
  218.  
  219.           0       reset
  220.           1       boldface
  221.           3       italic
  222.           4       underscore
  223.           7       inverse video
  224.  
  225.           30      foreground pen colour 0
  226.           31      foreground pen colour 1
  227.           32      foreground pen colour 2
  228.           33      foreground pen colour 3
  229.  
  230.  
  231.           40      background pen colour 0
  232.           41      background pen colour 1
  233.           42      background pen colour 2
  234.           43      background pen colour 3
  235.  
  236.  
  237.     ANSI codes are included in text using an escape code. This
  238.   code looks like :
  239.  
  240.         <CSI>code[;code[;code]]m
  241.  
  242.     CSI is the Control Sequence Introducer, and it
  243.   consists of an ESCape character and a [ character. For
  244.   instance, to set the foreground colour to pen colour 2, the background
  245.   colour to pen colour 3, and the style to italics and underscore, the
  246.   control sequence would be :
  247.  
  248.         [[32;43;3;4m
  249.  
  250.         And here it is!!!
  251.  
  252.     You do not need to specify the [[0m reset sequence at the end
  253.   of every line, as colours and styles are reset automatically for each
  254.   line.
  255.  
  256.  
  257.     Word wrapping
  258.  
  259.     FullView will wrap-around to the next line any words that do
  260.   not fit on the current line. This should normally not cause a problem.
  261.   It could, however, cause trouble if FullView wraps words that
  262.   are supposed to be a different colour and style. As colours and styles
  263.   are reset for each line, any words that were wrapped would not be in the
  264.   desired colour/style. There is no easy way out of this; all you can do
  265.   is preview your text to make sure that this has not occurred. If it
  266.   has, or you perceive it likely to happen, you can specify the escape
  267.   code for each individual word. For instance,
  268.  
  269.         [[1mEach [[1mIndividual [[1mWord
  270.  
  271.  
  272.     Speaking of wrapping...
  273.  
  274.     That about wraps it up for this document file. FullView is
  275.   largely self-explanatory, and I hope that I have covered all of the
  276.   necessary points in this text. If you ever have trouble with
  277.   FullView, please contact me at the address below.
  278.  
  279.     FullView is copyright, but is freely distributable. If you
  280.   wish to use it in a commercial venture, however, you must contact me.
  281.  
  282.  
  283.                    Jonathan Potter
  284.                  P.O. Box 289
  285.                   Goodwood, SA 5034
  286.                   Australia
  287.  
  288.                  Phone : (08) 2932788
  289.                   Fax : (08) 2938941
  290.  
  291.                  FidoNET : 3:680/829
  292.             Internet : jpotter@itd.adelaide.edu.au
  293.  
  294.  
  295.  
  296.  
  297.  
  298.