home *** CD-ROM | disk | FTP | other *** search
/ Best Objectech Shareware Selections / UNTITLED.iso / boss / word / text / 004 / sdes.doc < prev    next >
Text File  |  1993-05-05  |  62KB  |  1,154 lines
  1. ]
  2.                                                                 SDES v1.40
  3.                                                       ANSI Screen Designer
  4.  
  5.                                                        by James Holderness
  6.                                                        and Greg Mahlknecht
  7.                                                             Fido: 5:7103/7
  8.                                              mahlknec@beastie.cs.und.ac.za
  9.                                               holdern@beastie.cs.und.ac.za
  10.                                               (c) 1993 Vironix Corporation
  11.  
  12. ═══════════════════════════════════════════════════════════════════════════
  13.  1.  INTRODUCTION
  14.  
  15.  This utility is basically just an ANSI screen designer. It was meant for
  16.  designing ANSI screens quickly and efficiently, producing the most compact
  17.  ANSI code possible. Initially you may find it difficult to use, but once
  18.  you become accustomed to the interface, you will find it a very powerful
  19.  tool.
  20.  
  21. ═══════════════════════════════════════════════════════════════════════════
  22.  2.  LIMITATIONS
  23.  
  24.  Although this program is probably the greatest ANSI editor in the known
  25.  universe, it does have its limitations. It was originally written for in
  26.  house use, so it has an interface that can at best be described as
  27.  cryptic. It also probably has a fair selection of bugs, features that
  28.  don't work as documented (or don't exist), and many features that aren't
  29.  documented.
  30.  
  31. ═══════════════════════════════════════════════════════════════════════════
  32.  3.  INSTALLATION
  33.  
  34.  Since there probably isn't an installation program included, there are a
  35.  couple of things you will need to do before getting started. The main
  36.  program (SDES.EXE) should be copied to some directory in your path, or
  37.  the directory that it is in should be added to your PATH statement in
  38.  your AUTOEXEC.BAT file.
  39.  
  40.  If you are planning on using the Norton Guides online help, then you
  41.  should copy the file SDES.NG into the directory containing all your other
  42.  Norton Guides files (see the appendix explaining MEMORY RESIDENT HELP).
  43.  
  44.  All the files with PAT and SET extentions should be placed in a directory
  45.  of their own, (e.g. C:\SDES). You should then create an environment
  46.  variable called SDES that is set to the name of this directory. For
  47.  example if you are using the directory given above, then you would add
  48.  the line "SET SDES=C:\SDES" to your AUTOEXEC.BAT file.
  49.  
  50.  Once you have done this, you should reboot your computer so that the
  51.  changes made to your AUTOEXEC.BAT file take effect. You will then be ready
  52.  to begin using SDES.
  53.  
  54. ═══════════════════════════════════════════════════════════════════════════
  55.  4.  GETTING STARTED
  56.  
  57.  Once SDES is installed, you can start it up by simply typing SDES (for the
  58.  more ambitious, the full command line usage is explained in one of the
  59.  appendices). Once loaded, there will be very little to see, except for a
  60.  multicolored cursor flashing in the top left corner. Note that there is
  61.  no fancy menu system - everything is done via hotkeys. If you're the sort
  62.  of person that want's to get started straight away, all you really need to
  63.  know is that the cursor keys move the cursor around, and F1 pops up a list
  64.  of hotkeys, but it would be best if you at least read the following
  65.  section on BASIC USAGE.
  66.  
  67. ═══════════════════════════════════════════════════════════════════════════
  68.  5.  BASIC USAGE
  69.  
  70.  SDES has two main modes of usages - a normal size mode where you work with
  71.  units the size of a character, and a tiny mode that works with units half
  72.  the size of a characters (namely ▀ and ▄). The size of the cursor will
  73.  reflect which mode you are currently in, and you can press F9 to toggle
  74.  from one mode to the other. Note that many of the hotkeys have different
  75.  meanings depending on the mode you are in.
  76.  
  77.  Other than these two main modes, there are also various lower level modes
  78.  that you will change into when performing certain functions, however these
  79.  are all really sub-modes of the normal mode - they will described in one
  80.  of the later sections. Note that a mode is defined as a particular program
  81.  state in which the standard keystrokes take on different meanings.
  82.  
  83.  Since most of what you do is dependant on the position of your cursor, it
  84.  is important that you be able to move it around. For this you can use the
  85.  arrow keys, as well as <Home> to jump to the first column, <End> to jump
  86.  to the last column, <PgUp> to jump to the first line, and <PgDn> to jump
  87.  to the last line.
  88.  
  89.  Almost everything else is dependant on your current mode, and will be
  90.  explained in detail below, but for now, you may also want to remember that
  91.  F1 brings up a help screen (some of the time at least).
  92.  
  93. ═══════════════════════════════════════════════════════════════════════════
  94.  6.  NORMAL MODE
  95.  
  96.  In this mode, basically whatever you type at the keyboard will be sent to
  97.  the screen. Note, however, that text is not inserted - if there is already
  98.  something below the cursor where you are typing, it will be overwritten.
  99.  However, there are some special keystrokes to help with this editing:
  100.  
  101.    <Ctrl>+<RightArrow> .. Insert a space before the current character
  102.                           position moveing everything else up one column.
  103.    <Ctrl>+<LeftArrow> ... Delete the current character, moveing the rest
  104.                           of the line left one column.
  105.    <Ins> ................ Same as <Ctrl>+<RightArrow> except that it only
  106.                           effects the current sentence².
  107.    <Del> ................ Same as <Ctrl>+<LeftArrow> except that it only
  108.                           effects the current sentence².
  109.    <Shift>+<RightArrow> . Shifts the entire screen right one column start-
  110.                           ing at the current column. A blank column in the
  111.                           current background colour is inserted.
  112.    <Shift>+<LeftArrow> .. The current column is deleted and the screen to
  113.                           right of it is shifted left one column. A blank
  114.                           column in the current background colour is
  115.                           inserted in the last column.
  116.    <Shift>+<DownArrow> .. Shifts the entire screen down one line starting
  117.                           on the current line. A blank line in the current
  118.                           background colour is inserted.
  119.    <Shift>+<UpArrow> .... The current line is deleted and the screen below
  120.                           it is shifted up one line. A blank line in the
  121.                           current background colour is inserted at the
  122.                           bottom of the screen.
  123.  
  124.    ² A sentence is defined as a string of words seperated by no more than
  125.      on space.
  126.  
  127.  Other than these basic editing keys, there are also a number of special
  128.  operations that can be performed in this mode. These will be explained
  129.  in detail below.
  130.  
  131. ───────────────────────────────────────────────────────────────────────────
  132.  6.1.  ATTRIBUTE CHANGE                                            <Alt>+A
  133.  
  134.  This function changes the current foreground and background colours. These
  135.  are the colours used when writing text to the screen. A small window will
  136.  popup showing all the possible colours, the current colour being marked
  137.  with a rotating cursor. You can change the colours using the arrow keys,
  138.  <Home>, <End>, <PgUp> and <PgDn>. Just press <Enter> to select the new
  139.  colour or <Esc> to leave the colour settings as they were.
  140.  
  141. ───────────────────────────────────────────────────────────────────────────
  142.  6.2.  DRAW A BOX                                                  <Alt>+B
  143.  
  144.  This function allows you to draw a filled box in the current colours. You
  145.  will first be given a selection of which character you wish to use to fill
  146.  the box, after which you can begin adjusting the size with the arrow keys,
  147.  <Home>, <End>, <PgUp> and <PgDn>. <Tab> swaps between adjusting the top
  148.  left corner and the bottom right corner. Press <Enter> to draw the box, or
  149.  <Esc> to abort.
  150.  
  151. ─────────────────────────────────────────────