home *** CD-ROM | disk | FTP | other *** search
/ Monster Media 1994 #1 / monster.zip / monster / HAM / MPP110A.ZIP / USERMAN.TXT < prev   
Text File  |  1994-01-03  |  45KB  |  997 lines

  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.                                Morse Practice Program
  15.  
  16.                                     User's Manual
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.  
  25.  
  26.  
  27.  
  28.  
  29.  
  30.  
  31.  
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.        Dennis R. McManus  W3IMA
  43.  
  44.  
  45.        January 3, 1994
  46.  
  47.  
  48.        Notices                                                             ii
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.           This program was designed and written by  Dennis R. McManus, W3IMA.
  56.        Permission is granted to distribute this program free of charge to all
  57.        who wish to use it for non-commercial purposes.  Its intended  purpose
  58.        is to assist  individuals or classes  who are studying  Morse code  in
  59.        order to obtain an amateur radio license.  Although the program may be
  60.        freely distributed,  all rights  to the  program are  retained by  the
  61.        author.  It may not be modified in any manner without express  written
  62.        permission from the author.
  63.  
  64.  
  65.  
  66.        Copyright 1992 - 1994 by Dennis R. McManus, W3IMA
  67.  
  68.  
  69.        Table Of Contents                                                  iii
  70.  
  71.  
  72.  
  73.  
  74.  
  75.  
  76.                                   TABLE OF CONTENTS
  77.  
  78.  
  79.  
  80.        1. GENERAL OVERVIEW .................................................1
  81.  
  82.            1.1. System Requirements ........................................1
  83.            1.2. Program Installation .......................................1
  84.            1.3. General Features ...........................................1
  85.  
  86.        2. PROGRAM OPERATION ................................................3
  87.  
  88.            2.1. Starting The Program .......................................3
  89.            2.2. Controlling The Program ....................................4
  90.                2.2.1. Selection With The TAB And Cursor Keys ...............4
  91.                2.2.2. Selection With "Hot Keys" ............................4
  92.                2.2.3. Selection Using The Mouse ............................5
  93.                2.2.4. Typing Entries In Input Boxes ........................5
  94.  
  95.        3. THE CONFIGURATION SCREEN .........................................6
  96.  
  97.            3.1. Setting The Code Characteristics ...........................6
  98.                3.1.1. Setting The Character Speed ..........................6
  99.                3.1.2. Setting The Sending Speed ............................7
  100.                3.1.3. Setting The Tone Frequency ...........................7
  101.            3.2. Selecting A Serial Port ....................................7
  102.            3.3. Loading A Configuration File ...............................8
  103.            3.4. Setting The Random Alphabet ................................8
  104.            3.5. Setting The Emphasis Alphabet ..............................8
  105.            3.6. Switching To The Practice Screen ...........................9
  106.            3.7. Saving A Configuration File ................................9
  107.            3.8. Testing The Code Configuration .............................9
  108.            3.9. Stopping Sending ...........................................9
  109.            3.10. Exiting From The Program ..................................9
  110.  
  111.        4. THE PRACTICE SCREEN .............................................10
  112.  
  113.            4.1. Practice Modes ............................................10
  114.                4.1.1. ( ) Random Group ....................................10
  115.                4.1.2. ( ) 5 Char AABAA ....................................10
  116.                4.1.3. ( ) Flash Card ......................................11
  117.                4.1.4. ( ) Text File .......................................11
  118.                4.1.5. ( ) Keyboard Out ....................................11
  119.            4.2. Special Options ...........................................11
  120.                4.2.1. [ ] Hide Text .......................................12
  121.                4.2.2. [ ] Compress Spaces .................................12
  122.                4.2.3. [ ] Stop On '@' .....................................12
  123.            4.3. Loading A Text File .......................................13
  124.            4.4. The Display Window ........................................13
  125.                4.4.1. Display Of Random Groups ............................13
  126.  
  127.  
  128.        Table Of Contents                                                   iv
  129.  
  130.  
  131.                4.4.2. Display Of 5 Char AABAA .............................14
  132.                4.4.3. Display Of Flash Card ...............................14
  133.                4.4.4. Display Of Text File ................................14
  134.                4.4.5. Display Of Keyboard Out .............................14
  135.            4.5. Switching To The Configuration Screen .....................15
  136.            4.6. Clearing Text In The Display Window .......................15
  137.            4.7. Sending Text ..............................................15
  138.            4.8. Stopping Sending ..........................................15
  139.            4.9. Exiting From The Program ..................................15
  140.  
  141.        A. SPECIAL CODES ...................................................16
  142.  
  143.  
  144.        General Overview                                                     1
  145.  
  146.  
  147.  
  148.  
  149.  
  150.  
  151.                                   GENERAL OVERVIEW
  152.  
  153.  
  154.  
  155.        1. GENERAL OVERVIEW
  156.  
  157.           The Morse Practice Program was designed to make it easy to practice
  158.        copying Morse code.  It concentrates mainly on copying on paper  which
  159.        is the mode used when taking  the license examinations.  There are  no
  160.        special modes that create example code  tests or methods that  require
  161.        the user to type the copied code on  the keyboard.  The intent of  the
  162.        program was to offer clean, well-timed code in a program that is  easy
  163.        to set up and use.
  164.  
  165.  
  166.        1.1. System Requirements
  167.  
  168.           The program is intended  to run on all  levels of IBM  PC/XT/AT and
  169.        100% compatible systems with at least 160K of free memory and at least
  170.        one floppy  disk drive.   It  will run  on monochrome  or color  video
  171.        systems as well as LCD laptop displays.
  172.  
  173.  
  174.        1.2. Program Installation
  175.  
  176.           The program may be installed on  a hard disk by  simply copying all
  177.        the files from the  floppy disk to the  desired directory on the  hard
  178.        disk.  The  main program file  is MPP.EXE.   There is  also a  default
  179.        initialization file called MPP.INI  which is used  to set the  initial
  180.        configuration each time the program is  started.  There are also  some
  181.        text files that  can be  used for practice.   These  were copied  from
  182.        several sources in magazines and instruction manuals.
  183.  
  184.  
  185.        1.3. General Features
  186.  
  187.           The program  display  is  divided into  two  main  screens.   These
  188.        screens allow  the  user  to configure  the  system  and  specify  the
  189.        practice mode to  use.   All the features  available to  the user  are
  190.        displayed on one of these two screens at all times.  There is no  need
  191.        to remember which  menu has  which command in  it.   The first  screen
  192.        allows the user to  set the configuration  parameters for the  program
  193.        and to  save and  restore selected  configuration  sets.   The  second
  194.        screen is used to control the  practice session.  It allows  selection
  195.        from among five operating modes.  It also allows special conditions to
  196.        be set that control how the text is sent and displayed.
  197.  
  198.           Three of  the  five  operating  modes  involve  sending  of  random
  199.        characters.  One mode allows sending standard ASCII text files and one
  200.        allows sending text that is input from the keyboard.
  201.  
  202.  
  203.        General Overview                                                     2
  204.  
  205.  
  206.           The timing of the code  is completely independent of  the CPU speed
  207.        of the PC.   This allows  the program to  be run on  all levels of  PC
  208.        without having to calibrate the speed.  All timings are developed from
  209.        a one millisecond time base that is achieved by reconfiguring the  DOS
  210.        time-of-day clock.  The frequency of this clock is standard across all
  211.        IBM PC compatible machines.
  212.  
  213.           Code can be sent with spacing between characters different than the
  214.        actual character speed.  This method, known as the Farnsworth  Method,
  215.        allows characters to be sent at a faster speed and have longer  spaces
  216.        between characters  while  still  maintaining  the  specified  overall
  217.        sending speed.
  218.  
  219.           The program can optionally be  controlled using a mouse  as well as
  220.        the keyboard.  All operations that  do not require the typing of  text
  221.        can be activated by the mouse.
  222.  
  223.           It is hoped  that some day  an on-line help  system will  be added.
  224.        This has not been done as of this release.  The F1:Help option on  the
  225.        bottom of  each  screen will  currently  just  pop up  a  message  box
  226.        indicating the feature has not been implemented yet.
  227.  
  228.  
  229.        Program Operation                                                    3
  230.  
  231.  
  232.  
  233.  
  234.  
  235.  
  236.                                   PROGRAM OPERATION
  237.  
  238.  
  239.  
  240.        2. PROGRAM OPERATION
  241.  
  242.           This chapter describes the program operation in detail.
  243.  
  244.  
  245.        2.1. Starting The Program
  246.  
  247.           The easiest way to  start the program is  to just type  the program
  248.        name on the command line without any parameters:
  249.  
  250.            MPP
  251.  
  252.        and the program will start with the configuration parameters that were
  253.        in effect when the program was last exited.
  254.  
  255.           If  you  want  to  start  the  program  with   a  specific  set  of
  256.        configuration parameters that were  saved in a  disk file, supply  the
  257.        configuration file name as a parameter.  For example:
  258.  
  259.            MPP GENERAL
  260.  
  261.        will cause the program to read  the configuration file GENERAL.CFG  to
  262.        set its initial  parameters.  If  no file extension  is supplied,  the
  263.        default is .CFG.  Three such configuration files are included that set
  264.        up the parameters for code practice  for the various license  classes.
  265.        These  are   NOVICE.CFG,  GENERAL.CFG,   and  EXTRA.CFG.      Creating
  266.        configuration files  will  be  explained  in  the  subsection  on  the
  267.        Configuration Screen.
  268.  
  269.           If you  are using  an LCD  screen or  a monochrome  monitor with  a
  270.        driver that emulates color using different  levels of gray shade,  the
  271.        screen may be hard to read.   If this is  the case, start the  program
  272.        with the -b command line switch to force monochrome operation:
  273.  
  274.            MPP -b
  275.  
  276.        or if also specifying a configuration file:
  277.  
  278.            MPP -b filename
  279.  
  280.           Another command line switch has been added  to overcome a potential
  281.        problem with the video system.  The -v command line switch will  force
  282.        the program to not try to configure  the video mode in case the  video
  283.        card in the PC does not support all the mode setting commands.  If the
  284.        screen does not display properly, try using this switch.
  285.  
  286.  
  287.        Program Operation                                                    4
  288.  
  289.  
  290.           If the -b and/or -v switch is used with  a configuration file name,
  291.        it must come before the configuration file name.
  292.  
  293.  
  294.        2.2. Controlling The Program
  295.  
  296.           When the  program  starts, it  displays  the Configuration  Screen.
  297.        This is one of the two screens that are used to control all aspects of
  298.        the program operation.  The other screen is the Practice Screen.   All
  299.        operations that can be performed and options that can be selected  are
  300.        displayed on one or the other of these two screens.
  301.  
  302.           The options fall into five general categories:
  303.  
  304.           1.  Options that require values to be entered in input boxes.
  305.  
  306.           2.  Options that require selection of one item from a group.
  307.  
  308.           3.  Options that are individually turned on or off
  309.  
  310.           4.  Options that are performed immediately using function keys
  311.  
  312.           5.  Operations in the Display Window on the Practice Screen
  313.  
  314.           The blinking  text cursor  is always  positioned  on the  "current"
  315.        selection option.   There are three  ways to select  the operation  to
  316.        perform on these screens other than those that are activated using the
  317.        function keys:
  318.  
  319.           1.  By using the TAB and cursor keys
  320.  
  321.           2.  By using special "hot keys" (ALT key combinations)
  322.  
  323.           3.  By using the mouse.
  324.  
  325.  
  326.        2.2.1. Selection With The TAB And Cursor Keys
  327.  
  328.           All the related  options are  grouped within  boxes on  the screen.
  329.        The TAB key moves from one box to  the next.  The Shift-TAB key  moves
  330.        in the reverse direction.  Within a  box, the Up and Down cursor  keys
  331.        move from one item to the next in the respective  direction.  Once the
  332.        blinking cursor is positioned on the option you wish to perform, press
  333.        either the space bar or the enter key to activate it.
  334.  
  335.  
  336.        2.2.2. Selection With "Hot Keys"
  337.  
  338.           Each option has  one of its  characters displayed in  a highlighted
  339.        attribute.  Holding down  the ALT key  while pressing the  highlighted
  340.        character both selects and activates the specified option.
  341.  
  342.  
  343.        Program Operation                                                    5
  344.  
  345.  
  346.        2.2.3. Selection Using The Mouse
  347.  
  348.           The program is designed to use a Microsoft mouse  or any mouse that
  349.        emulates the Microsoft  mouse interface.   The  mouse can  be used  to
  350.        select and  activate any  of the  options including  the function  key
  351.        options by  moving  the  mouse cursor  over  the  desired  option  and
  352.        clicking the left button.  The option is only performed when the mouse
  353.        button is released so it important to keep the mouse cursor positioned
  354.        over the option while releasing the button.
  355.  
  356.  
  357.        2.2.4. Typing Entries In Input Boxes
  358.  
  359.           When an option is  selected that requires  text to be  entered from
  360.        the keyboard, the current  value, if there is  one, is displayed in  a
  361.        highlighted mode with the  text cursor on the  first character of  the
  362.        entry.  If any cursor movement key is pressed such as a right or  left
  363.        arrow key or the  Home or End  key, the highlight  is removed and  the
  364.        original text stays in the input box.  This allows existing entries to
  365.        be modified  without  having  to  completely  retype  them.    If  any
  366.        printable character is  typed, the original  text is  removed and  any
  367.        text that is typed replaces the original entry.
  368.  
  369.           While entering and  modifying text  in an  input box,  various line
  370.        editing options are available:
  371.  
  372.           1.  The right and  left arrow  keys may be  used to  move back  and
  373.               forth through the text.
  374.  
  375.           2.  The Ctrl-right and Ctrl-left arrow keys  move a full word at  a
  376.               time in the respective direction.
  377.  
  378.           3.  The Home and  End keys  move to the  beginning and  end of  the
  379.               input text respectively.
  380.  
  381.           4.  The Ins key toggles  between overtype mode (underscore cursor)
  382.               and insert mode (block cursor).
  383.  
  384.           Pressing the Enter key or clicking on the OK button will accept the
  385.        current input line.   Pressing the Esc key  or clicking on the  Cancel
  386.        button will retain the original entry unchanged.
  387.  
  388.  
  389.        The Configuration Screen                                             6
  390.  
  391.  
  392.  
  393.  
  394.  
  395.  
  396.                               THE CONFIGURATION SCREEN
  397.  
  398.  
  399.  
  400.        3. THE CONFIGURATION SCREEN
  401.  
  402.           The  Configuration   Screen  allows   the  user   to  set   up  the
  403.        characteristics of the code  speed and tone,  select specific sets  of
  404.        characters to use for random code generation, specify a serial port to
  405.        use to drive an external oscillator,  and load and save  configuration
  406.        files which contain all these parameters.
  407.  
  408.  
  409.        3.1. Setting The Code Characteristics
  410.  
  411.           The first group  of options  on the  Configuration Screen  sets the
  412.        character speed,  sending  speed,  and tone  frequency  for  the  PC's
  413.        internal speaker.
  414.  
  415.           The character  speed  and  sending  speed  can be  set  separately.
  416.        Specifying the character speed to be faster than the sending speed  is
  417.        often  referred  to  as  the  Farnsworth  Method.    This  allows  the
  418.        characters  to  be  heard  as  a  single  sound  pattern  rather  than
  419.        individual dots and dashes and allows a longer time to recognize which
  420.        character was sent.   The two speed settings  are described in  detail
  421.        below.
  422.  
  423.           Although the two  speed numbers  may be  set to  a resolution  of a
  424.        tenth of a word  per minute, this accuracy  is only guaranteed at  the
  425.        lower speeds.  As  the speed is increased,  one millisecond time  base
  426.        becomes a larger portion of each character element.  The 0.1 word  per
  427.        minute resolution is  good up to  about 10 words  per minute.   Up  to
  428.        about 40 words per minute, the resolution is accurate to at least  1.0
  429.        word per minute.  Above those speeds, who is counting exactly  anyway?
  430.        The accuracy is  good enough  for the  speeds required  for Ham  Radio
  431.        tests.
  432.  
  433.  
  434.        3.1.1. Setting The Character Speed
  435.  
  436.           The character  speed is  the speed  in words  per minute  that each
  437.        individual character is sent at.  The character speed may be set  from
  438.        13.0 to 99.9 words per minute.  The reason the lower limit is 13.0  is
  439.        because below  this  speed, it  is  difficult to  concentrate  on  the
  440.        overall sound pattern of  a character and too  easy to count dots  and
  441.        dashes.  The standard license tests are usually given with a character
  442.        speed of  either 15.0  or 18.0  words per  minute depending  on  which
  443.        Volunteer Examination Coordinator the testing is being given  through.
  444.        Note that  the 20  word per  minute  test is  usually given  with  the
  445.        character and sending speeds both the same.
  446.  
  447.  
  448.        The Configuration Screen                                             7
  449.  
  450.  
  451.           The character  speed is  not allowed  to be  less than  the sending
  452.        speed.  If a value less than the sending speed is entered, the sending
  453.        speed will be lowered to match the new character speed.
  454.  
  455.  
  456.        3.1.2. Setting The Sending Speed
  457.  
  458.           The sending speed is the  actual overall speed in  words per minute
  459.        that the code is sent at.  The valid range for this speed is from  1.0
  460.        to 99.9 words  per minute.   When  the character  speed is  set to  be
  461.        faster  than  the  sending  speed,  the  spacing  between   individual
  462.        characters is made longer in order to maintain the overall speed.
  463.  
  464.           The sending speed is not  allowed to be greater  than the character
  465.        speed.  If a  value greater than the  character speed is entered,  the
  466.        character speed will be raised to match the new sending speed.
  467.  
  468.  
  469.        3.1.3. Setting The Tone Frequency
  470.  
  471.           If the internal  speaker in  the PC  is being  used to  produce the
  472.        code, its frequency may be specified in Hertz  from 20 to 9999.  If  a
  473.        value of zero  is entered, the  internal speaker is  turned off.   The
  474.        option of  turning off  the speaker  is intended  to be  used when  an
  475.        external oscillator is being  keyed using one of  the serial ports  as
  476.        described below.
  477.  
  478.  
  479.        3.2. Selecting A Serial Port
  480.  
  481.           The second group of options on the  Configuration Screen allows the
  482.        selection of one of the standard  serial ports to control an  external
  483.        code oscillator.  The options are:
  484.  
  485.           1.  ( ) None
  486.  
  487.           2.  ( ) COM1:
  488.  
  489.           3.  ( ) COM2:
  490.  
  491.           The parentheses  indicate that  only one  of these  options may  be
  492.        selected at a time.  Selecting any one of these options  automatically
  493.        deselects any  other one  in the  group.   A *  character between  the
  494.        parentheses indicates which option is currently selected.
  495.  
  496.           Various circuits have appeared  in magazines and other  sources for
  497.        keying an external oscillator from a serial port.  To date, none  have
  498.        been tried with this program.  Both the DTR and RTS control lines  are
  499.        keyed by this program on the  selected serial port.  The author  would
  500.        appreciate being informed of any success in this area.
  501.  
  502.           Note that  when one  of the  serial ports  is selected,  it is  not
  503.        reconfigured by the program until the first code is sent.  This allows
  504.        for the  case where  a serial  mouse  is being  used and  the  program
  505.  
  506.  
  507.        The Configuration Screen                                             8
  508.  
  509.  
  510.        happens to start with  the mouse's port selected.   Simply select  the
  511.        other port or None before sending  any code and the mouse will  remain
  512.        functional.  If the  None option is selected,  neither serial port  is
  513.        changed from its current configuration.
  514.  
  515.  
  516.        3.3. Loading A Configuration File
  517.  
  518.           Each time  the  program exits  to  DOS,  the current  configuration
  519.        parameters are saved on  the disk in a  file called MPP.INI.   Special
  520.        configurations can be saved  to the disk and  recalled at any time  to
  521.        set up the program.  Selecting the Load Config File option displays an
  522.        input box requesting the name of the saved configuration file to load.
  523.        Files specified for this option must have been saved using the F3:Save
  524.        Config option  that is  explained  below.   If  no file  extension  is
  525.        supplied, the default is .CFG.
  526.  
  527.           The information contained  in the  configuration files  consists of
  528.        all the options that  are displayed on the  Configuration Screen.   As
  529.        stated earlier,  three  configuration  files  are  supplied  with  the
  530.        program.  These are NOVICE.CFG, GENERAL.CFG, and EXTRA.CFG.
  531.  
  532.  
  533.        3.4. Setting The Random Alphabet
  534.  
  535.           The Random  Alphabet  is  used  along  with the  Emphasis  Alphabet
  536.        (described below) in all practice  modes that send random  characters.
  537.        These two strings list the only characters that will be sent in  these
  538.        modes.  The Random Alphabet specifies the normal set of characters  to
  539.        select from.  When  you select this  option, an input  box pops up  in
  540.        which you may enter the characters  that you want to use when  sending
  541.        random characters.  This string is not permitted to be empty.
  542.  
  543.           Characters that have no Morse code equivalent  in this program will
  544.        show up in the  input box as they  are typed but  will not be  entered
  545.        into the saved string.  Some procedural signals such as AR and SK have
  546.        single punctuation characters that are used  to represent them in  the
  547.        program.  These characters are listed just above the function key list
  548.        at the bottom of the screen.   Other punctuation characters  translate
  549.        directly into their Morse  equivalent.  See Appendix  A for a list  of
  550.        punctuation  characters  and  procedural  signals  supported  by   the
  551.        program.
  552.  
  553.           If the  input  box  contains only  characters  for  which no  Morse
  554.        equivalent has been  defined, the  string ABC  will be  placed in  the
  555.        Random Alphabet to keep it from being empty.
  556.  
  557.  
  558.        3.5. Setting The Emphasis Alphabet
  559.  
  560.           The Emphasis  Alphabet  is  used  along  with the  Random  Alphabet
  561.        (described above).   This string lists  characters that  will be  sent
  562.        more often in  the random  character sequences  in order  to get  more
  563.  
  564.  
  565.        The Configuration Screen                                             9
  566.  
  567.  
  568.        practice with them.  This string may be empty in which case all random
  569.        characters are selected from the Random Alphabet.
  570.  
  571.           The characters that are allowed  to be included in  this string are
  572.        the same as those described under the Random Alphabet above.
  573.  
  574.  
  575.        3.6. Switching To The Practice Screen
  576.  
  577.           To switch to the Practice Screen, either press the  F2 key or click
  578.        the mouse on the F2:Practice option on the bottom line.
  579.  
  580.  
  581.        3.7. Saving A Configuration File
  582.  
  583.           The current configuration options may  be saved to a  disk file and
  584.        recalled later to set the program back to the saved state.  When F3 is
  585.        pressed or the mouse  is clicked on the  F3:Save Config option on  the
  586.        bottom line, an input box is displayed asking for the name of the file
  587.        to save the  configuration information in.   If no  file extension  is
  588.        specified, the default is .CFG.
  589.  
  590.  
  591.        3.8. Testing The Code Configuration
  592.  
  593.            While on the Configuration Screen,  if F8 is pressed  or the mouse
  594.        is clicked on the F8:Test option on the bottom line, the message  "VVV
  595.        TEST" is sent to give  an example of the  current code speed and  tone
  596.        frequency.   This  allows  the  code  options  to  be  adjusted  to  a
  597.        comfortable configuration before beginning a practice session.
  598.  
  599.  
  600.        3.9. Stopping Sending
  601.  
  602.           To stop sending  at any time,  press F9 or  click the mouse  on the
  603.        F9:Stop option on the bottom line.
  604.  
  605.  
  606.        3.10. Exiting From The Program
  607.  
  608.           To exit  from the  program, press  F10 or  click the  mouse on  the
  609.        F10:Exit option on the bottom line.  If code is currently being  sent,
  610.        this option will  pop up an  error box indicating  that you must  stop
  611.        sending  before  exiting.     This  prevents  accidental  exit   while
  612.        practicing.  After  pressing Enter  or clicking  on the  OK button  to
  613.        clear the error box, if you really want to exit, just stop sending  as
  614.        described above and select the F10 option again.
  615.  
  616.  
  617.        The Practice Screen                                                 10
  618.  
  619.  
  620.  
  621.  
  622.  
  623.  
  624.                                  THE PRACTICE SCREEN
  625.  
  626.  
  627.  
  628.        4. THE PRACTICE SCREEN
  629.  
  630.           The Practice Screen is used to define the mode in which the code is
  631.        sent (random character groups, text files, keyboard input, etc...) and
  632.        also allows  the user  to set  up special  conditions for  sending  or
  633.        displaying the characters.  This is  the screen on which all  practice
  634.        sessions will be controlled.
  635.  
  636.  
  637.        4.1. Practice Modes
  638.  
  639.           There are five modes for sending  the code.  The  first three modes
  640.        send random characters selected from the Random and Emphasis Alphabets
  641.        that are defined on the Configuration  Screen.  The fourth mode  sends
  642.        text from  any  standard  ASCII  text file.    The  fifth  mode  sends
  643.        characters that are typed on the keyboard.
  644.  
  645.           The parentheses  indicate that  only one  of these  options may  be
  646.        selected at a time.  Selecting any one of these options  automatically
  647.        deselects any  other one  in the  group.   A *  character between  the
  648.        parentheses indicates which option is currently selected.
  649.  
  650.  
  651.        4.1.1. ( ) Random Group
  652.  
  653.           In this mode, random groups of characters are sent.  The characters
  654.        are randomly selected from the  Random Alphabet with special  emphasis
  655.        on any  characters  in  the Emphasis  Alphabet.    The  "words"  range
  656.        randomly between three  and eight  characters in  length.   Characters
  657.        from the Emphasis Alphabet, if it is not empty, are randomly  inserted
  658.        with  two to  five characters from the  Random Alphabet between  them.
  659.        The characters are displayed in the Display Window as they are sent if
  660.        the Hide Text option is not currently active.
  661.  
  662.  
  663.        4.1.2. ( ) 5 Char AABAA
  664.  
  665.           In this mode, random characters  are sent in groups  with a special
  666.        pattern.  Each group is five  characters in length in the form  AABAA.
  667.        The first  two  and last  two  characters are  all  the same  and  are
  668.        selected from the Random Alphabet.   The middle character is  selected
  669.        from the Emphasis  Alphabet if it  is not empty.   Otherwise it  comes
  670.        from the Random Alphabet  also.  The characters  are displayed in  the
  671.        Display Window  as  they are  sent  if the  Hide  Text option  is  not
  672.        currently active.
  673.  
  674.  
  675.        The Practice Screen                                                 11
  676.  
  677.  
  678.        4.1.3. ( ) Flash Card
  679.  
  680.           In this mode, characters are sent randomly one by one and displayed
  681.        in a large format  in the Display Window  like a flash  card.  If  the
  682.        Hide Text option is not active,  the characters are displayed as  they
  683.        are sent.  If the Hide Text  option is active, each character is  sent
  684.        and not displayed until the next  character would normally be sent  at
  685.        the current sending speed.  This  allows the user to try to  recognize
  686.        the character before it is shown.
  687.  
  688.           NOTE:  Characters are  not sent at the  normal speed in  this mode.
  689.        Characters are displayed for the duration of a space between words and
  690.        then after the character is removed from the screen another word space
  691.        occurs before the next character is  sent.  This mode is intended  for
  692.        individual character recognition practice and not "at speed" practice.
  693.  
  694.  
  695.        4.1.4. ( ) Text File
  696.  
  697.           In this mode,  a selected ASCII  text file may  be sent.   The file
  698.        that is sent  is selected using  the Load Text  File option  described
  699.        below.  If the  Hide Text option is  not currently active, the  entire
  700.        text (or as much as will fit in the window) is displayed and a special
  701.        cursor tracks the characters as they are sent.  The point in the  file
  702.        at which sending starts may be  selected by placing the cursor at  the
  703.        desired location before starting.  If no text file has been  selected,
  704.        nothing is sent when the F8:Send option is selected.
  705.  
  706.  
  707.        4.1.5. ( ) Keyboard Out
  708.  
  709.           In this mode, the text that  is sent is entered  from the keyboard.
  710.        If sending is active,  the characters will be  sent as they are  typed
  711.        (or as fast as the sending speed  allows).  If sending is not  active,
  712.        text can be entered  and edited as  desired and then  sent when it  is
  713.        complete.  The Hide Text and Compress Spaces options have no effect on
  714.        this sending mode.
  715.  
  716.           Characters for which there  are no Morse code  translations in this
  717.        program will be entered  into the Display Window  but will be  skipped
  718.        when they are encountered while sending.  Some procedural signals such
  719.        as AR  and SK  have single  punctuation characters  that are  used  to
  720.        represent them in the program.  These characters are listed just above
  721.        the function key list at the bottom of the screen.  Other  punctuation
  722.        characters translate  directly  into  their  Morse  equivalent.    See
  723.        Appendix A for a list of punctuation characters and procedural signals
  724.        supported by the program.
  725.  
  726.  
  727.        4.2. Special Options
  728.  
  729.           The second group of options on the  Practice Screen allow selecting
  730.        special modes of displaying and sending the text.  In this group,  the
  731.        square brackets indicate  that each option  may be turned  on and  off
  732.  
  733.  
  734.        The Practice Screen                                                 12
  735.  
  736.  
  737.        individually in any combination.  An X in the brackets indicates  that
  738.        the option is active.
  739.  
  740.  
  741.        4.2.1. [ ] Hide Text
  742.  
  743.           The main purpose  of this  option is to  indicate whether  the text
  744.        that is being sent should be  visible on the screen  or not.  This  is
  745.        true for Random Groups, 5 Char AABAA, and Text File modes of  sending.
  746.        If the option is active, no text is shown in the Display Window.
  747.  
  748.           In the  Flash Card  sending mode,  it controls  whether there  is a
  749.        delay between sending the character and displaying it or not.  If  the
  750.        option is active,  a normal inter-character  delay is inserted  before
  751.        the character is displayed.   This gives the  user the same amount  of
  752.        time to recognize a character that would normally occur when receiving
  753.        text "at  speed".    If  the option  is  inactive,  the  character  is
  754.        displayed immediately as it is sent.
  755.  
  756.  
  757.        4.2.2. [ ] Compress Spaces
  758.  
  759.           This option is  only used in  the Text File  sending mode.   If the
  760.        option  is  active,  groups  of  consecutive  white  space  characters
  761.        (spaces, tabs, and  line endings) are  sent as a  single space.   This
  762.        allows general text files  that may have large  spacing in them to  be
  763.        sent at  a normal  speed without  having  to send  each space  in  the
  764.        groups.  This  option does  not have any  effect on  the Keyboard  Out
  765.        sending mode because it is assumed that if multiple spaces are  keyed,
  766.        it is desired that they be sent.
  767.  
  768.  
  769.        4.2.3. [ ] Stop On '@'
  770.  
  771.           When this  option is  active,  if an  @  character is  encountered,
  772.        sending stops automatically  at that point.   This works  in both  the
  773.        Text File and the  Keyboard Out sending modes.   This allows  multiple
  774.        short messages to be grouped in a single file or to be keyed in at the
  775.        same time and be sent one at a time.  The message that is sent may  be
  776.        selected by placing the  cursor at the  desired point before  starting
  777.        sending.
  778.  
  779.           In the Text File  mode, the cursor  automatically moves past  the @
  780.        character before it stops so that the next message will begin properly
  781.        when sending is started again without moving the cursor.
  782.  
  783.           Because the keyboard cursor  does not move with  the sending cursor
  784.        in the Keyboard Out  mode, starting again after  an @ character  stops
  785.        sending would repeat the last message.
  786.  
  787.  
  788.        The Practice Screen                                                 13
  789.  
  790.  
  791.        4.3. Loading A Text File
  792.  
  793.           This option is used to select the ASCII text file that will be used
  794.        in the Text File sending mode.  When you select this option, an  input
  795.        box pops up asking for the  name of the text file  to use.  After  the
  796.        text file  is opened,  its name  is displayed  in the  Load Text  File
  797.        selection box.   If the sending  mode is set  to Text  File, the  file
  798.        contents will show up in the Display Window if the Hide Text option is
  799.        not active.  If no file has been selected since starting the  program,
  800.        the string "-- None --" is displayed.
  801.  
  802.  
  803.        4.4. The Display Window
  804.  
  805.           The Display Window is the area  on the bottom half  of the Practice
  806.        Screen.  It  is used to  display the characters  that are  sent.   The
  807.        cursor may be moved around in the  window while not sending.  If  more
  808.        text is present than will fit in the Display Window, the normal cursor
  809.        movement keys may be used to move around in the window as long as  the
  810.        cursor is in the Display Window.  The  mouse may be used to place  the
  811.        cursor on any  character that is  currently visible in  the window  by
  812.        clicking on the desired location.
  813.  
  814.           The arrow keys  move one  character or one  row in  the appropriate
  815.        direction.  The  Ctrl-Left and Ctrl-Right  keys move one  word in  the
  816.        appropriate direction.  The  PgUp and PgDn keys  move one window at  a
  817.        time in the appropriate direction.  The Home and End keys move to  the
  818.        beginning and end of the current line respectively.  The Ctrl-Home and
  819.        Ctrl-End keys  move  to the  beginning  and  end of  the  entire  text
  820.        respectively.
  821.  
  822.           The data in the Display Window behaves differently depending on the
  823.        sending mode that  is currently selected.   The following  subsections
  824.        describe the behavior in each mode.
  825.  
  826.  
  827.        4.4.1. Display Of Random Groups
  828.  
  829.           In this sending mode, the characters are displayed as they are sent
  830.        if the Hide Text option is not currently active.  The text remains  in
  831.        the window after sending is stopped as long as the sending mode is not
  832.        changed.  If code was being  copied with the Hide Text option  active,
  833.        disabling the Hide Text option will  display the characters that  were
  834.        sent so that copy may be checked against what was sent.
  835.  
  836.           The cursor may  be placed  anywhere in the  displayed text  in this
  837.        mode if  not  currently  sending.   When  sending  is  started  again,
  838.        however, the new characters will be  started at the end of those  that
  839.        are already displayed.
  840.  
  841.           The contents of the Display  Window may be cleared  by either using
  842.        the F3:Clear Text option on the bottom of the screen or changing to  a
  843.        different sending mode.   The Display  Window is  always cleared  when
  844.        this mode is entered.
  845.  
  846.  
  847.        The Practice Screen                                                 14
  848.  
  849.  
  850.        4.4.2. Display Of 5 Char AABAA
  851.  
  852.           The behavior of the Display Window in this sending mode is the same
  853.        as for the Random Group sending mode described above.
  854.  
  855.  
  856.        4.4.3. Display Of Flash Card
  857.  
  858.           In the Flash Card sending mode, a box is displayed in the middle of
  859.        the window.   As  characters are  sent, they  are displayed  in  large
  860.        format in  this box.   If  the Hide  Text option  is not  active,  the
  861.        characters are displayed immediately  as they are sent.   If the  Hide
  862.        Text option is active,  the character is not  displayed until after  a
  863.        delay equal to the time between characters within a word.  This  gives
  864.        you the  amount  of  time  you would  normally  have  to  recognize  a
  865.        character before it is  displayed.  In this  sending mode, the  cursor
  866.        may not be moved in the Display Window.
  867.  
  868.           Procedural signals  that  are  normally thought  of  as  a pair  of
  869.        characters like SK or AR are shown as their respective pair instead of
  870.        the punctuation characters that represent them in the program.
  871.  
  872.  
  873.        4.4.4. Display Of Text File
  874.  
  875.           In the Text File sending  mode, the contents of  the selected ASCII
  876.        file are  displayed in  the window  if  the Hide  Text option  is  not
  877.        active.  If the text is visible in the window,  a special cursor shows
  878.        which character  is currently  being sent  while sending.   While  not
  879.        sending, the cursor can be placed at any point in the text file  using
  880.        the methods described at the beginning  of the section on the  Display
  881.        Window above.  Sending  always starts at the  location of the  cursor.
  882.        This allows you to select where to start sending in a file.
  883.  
  884.           The text of  the current file  remains available until  a different
  885.        file is  selected in  its place  or the  program is  terminated.   The
  886.        F3:Clear Text option at the bottom of the screen does not work in this
  887.        sending mode.
  888.  
  889.  
  890.        4.4.5. Display Of Keyboard Out
  891.  
  892.           In the Keyboard Out sending mode, the text that is displayed in the
  893.        Display Window  is  whatever is  entered  through the  keyboard.    If
  894.        sending is active while  typing, the characters will  be sent as  they
  895.        are typed (or as fast as the sending speed allows).  A special  cursor
  896.        shows the characters that are being sent.  The normal text cursor  can
  897.        be placed at any point in the existing  text and text can be added  or
  898.        changed even while sending.  This will not change what characters  are
  899.        being sent unless the changes are being made where the sending  cursor
  900.        is or sending is stopped and restarted.
  901.  
  902.           As with the  Text File  mode, sending always  starts at  the cursor
  903.        location.  This mode is useful for setting up special text to be  sent
  904.  
  905.  
  906.        The Practice Screen                                                 15
  907.  
  908.  
  909.        in a class or group study session.  The Hide Text option has no effect
  910.        on this sending mode because you  already know what you are typing  in
  911.        anyway.
  912.  
  913.           The text that you  type in this  mode remains available  even after
  914.        switching to  a different  mode and  back again.   You  can clear  any
  915.        existing text from the Display Window in this mode using the  F3:Clear
  916.        Text option on the bottom of the screen.
  917.  
  918.  
  919.        4.5. Switching To The Configuration Screen
  920.  
  921.           To switch to the Configuration  Screen, either press the  F2 key or
  922.        click the mouse on the F2:Configure option on the bottom line.
  923.  
  924.  
  925.        4.6. Clearing Text In The Display Window
  926.  
  927.           The text that  is currently  in the Display  Window for  the Random
  928.        Group, 5 Char AABAA, or Keyboard  Out sending modes may be cleared  by
  929.        pressing F3 or by  clicking the mouse on  the F3:Clear Text option  at
  930.        the bottom of  the screen.   This option has  no effect  on any  other
  931.        sending mode.    This option  also  does  not work  while  program  is
  932.        sending.
  933.  
  934.  
  935.        4.7. Sending Text
  936.  
  937.           To start sending in any of the five sending  modes, either press F8
  938.        or click the mouse on the F8:Send option at the bottom of the screen.
  939.  
  940.  
  941.        4.8. Stopping Sending
  942.  
  943.           To stop sending  at any time,  press F9 or  click the mouse  on the
  944.        F9:Stop option on the bottom line.
  945.  
  946.  
  947.        4.9. Exiting From The Program
  948.  
  949.           To exit  from the  program, press  F10 or  click the  mouse on  the
  950.        F10:Exit option on the bottom line.  If code is currently being  sent,
  951.        this option will  pop up an  error box indicating  that you must  stop
  952.        sending  before  exiting.     This  prevents  accidental  exit   while
  953.        practicing.  After  pressing Enter  or clicking  on the  OK button  to
  954.        clear the error,  if you  really want to  exit, just  stop sending  as
  955.        described above and select the F10 option again.
  956.  
  957.  
  958.        Appendix A  Special Codes                                           16
  959.  
  960.  
  961.  
  962.  
  963.  
  964.  
  965.                               APPENDIX A  SPECIAL CODES
  966.  
  967.  
  968.  
  969.        A. SPECIAL CODES
  970.  
  971.           The Morse  code characters  supported by  the  program include  the
  972.        normal alphabet, A  - Z, the numbers 1 - 9, the following punctuation
  973.        characters:
  974.  
  975.           "    Quote                 di-dah-di-di-dah-dit
  976.           $    Dollar                di-di-di-dah-di-di-dah
  977.           '    Apostrophe            di-dah-dah-dah-dah-dit
  978.           (    Left Paren            dah-di-dah-dah-di-dah
  979.           )    Right Paren           dah-di-dah-dah-di-dah
  980.           ,    Comma                 dah-dah-di-di-dah-dah
  981.           -    Hyphen                dah-di-di-di-di-dah
  982.           .    Period                di-dah-di-dah-di-dah
  983.           /    Fraction Bar          dah-di-di-dah-dit
  984.           :    Colon                 dah-dah-dah-di-di-dit
  985.           ;    Semicolon             dah-di-dah-di-dah-dit
  986.           ?    Question              di-di-dah-dah-di-dit
  987.           _    Underscore            di-di-dah-dah-di-dah
  988.  
  989.        and several  procedural  signals  that  are  represented  using  other
  990.        punctuation characters:
  991.  
  992.           !    Attention (KA)        dah-di-dah-di-dah
  993.           #    Wait (AS)             di-dah-di-di-dit
  994.           &    Understood (SN)       di-di-di-dah-dit
  995.           *    End of contact (SK)   di-di-di-dah-di-dah
  996.           +    End of message (AR)   di-dah-di-dah-dit
  997.           =    Double dash (--)      dah-di-di-di-dah