home *** CD-ROM | disk | FTP | other *** search
/ World of Ham Radio 1997 / WOHR97_AmSoft_(1997-02-01).iso / cw / cw_26 / prog / lesson.hlp < prev    next >
Text File  |  1997-02-01  |  4KB  |  109 lines
  1.                   
  2.                   MODIFYING AND CREATING LESSONS
  3.  
  4.  
  5. Lesson Names
  6.  
  7.      The lessons sounded by the program are DOS Text files, stored
  8. in the Lessons directory. The name of a lesson is dependant apon which
  9. program is is targeted, MKLESSON.n is for Morse Keyboard, MTLESSON.n
  10. is for Morse Transmit and MSLESSON.nn is for Voice Morse. Where n is
  11. an integer number.
  12.  
  13.  
  14. Lesson Codes
  15.  
  16.      Codes are used within each lesson to set the speed of the
  17. morse, time delay between symbols, lesson passmark, to introduce
  18. symbols and to display messages to the user.  Following is an
  19. explanation of the codes used and an example (MKLESSON.1):
  20.  
  21.  
  22. Text Codes     Explanation
  23.  
  24. ~              Tilde - indicates the START and END of text to be
  25.                displayed to the user. Other codes may also be used
  26.                within the tildes.  When a tilde is encountered the
  27.                cursor will be moved to the top left corner of the
  28.                Text Box (See example next page).
  29.  
  30. @h or @H       High Text Colour (Yellow) - The text after this code
  31.                will be yellow.
  32.  
  33. @l or @L       Line Feed - Forces a line feed, used to format the
  34.                text within the Text Box.
  35.  
  36. @n or @N       Normal Text Colour (White) - The text after this code
  37.                will be low intensity white.
  38.  
  39. @p or @P       Prompt - Writes the prompt "Press any Key..." on the
  40.                screen and waits for the user to press a key before
  41.                program execution continues.
  42.  
  43. @r or @R       Remove - Clears the Text Box, any text displayed will
  44.                be removed.
  45.  
  46. @w or @W       Wait - Wait 1 second before continuing, delays
  47.                program execution.
  48.  
  49.  
  50. Morse Codes    Explanation
  51.  
  52. []             Square Brackets - Enclose symbols to be formally
  53.                introduced at the start of a lesson, a maximum of 10
  54.                symbols may be inserted. 
  55.  
  56. @Cnnn          Character Delay - Delay between symbols in 1000ths of
  57.                seconds.
  58.  
  59. @Dnn           Dit Speed in Words Per Minute. 
  60.                
  61. @Pnn           Passmark - Sets the percentage passmark for the
  62.                lesson.   
  63.  
  64. @V             Voice On, for VOICE MORSE LESSONS only, phonetic name 
  65.                of symbol is pronounced after sounding if this switch
  66.                is included.
  67.  
  68. Lesson Codes Example
  69.  
  70. NOTE:     The curly brackets are used to enclose explanation remarks
  71.           and are not part of the normal lesson.
  72.  
  73. ~         {Start of message to display to user}
  74. @h        {Use High text colour - Yellow} 
  75.                                LESSON 1 
  76. @w@w@w    {Wait for 3 seconds}
  77. @r        {Remove message}
  78. ~         {End of message}
  79. @P75      {Set Passmark at 75%}
  80. @D20      {Set symbol speed to 20 wpm} 
  81. @C400     {Set delay between characters to 4 seconds} 
  82.  
  83. [PULXYF]  {Symbols to be introduced}
  84.  
  85. PPUULLXXYYFFXFLYXPULPXYPF  {Morse Symbols to be sounded}
  86. PLLYFFXUUXLPYFPYFLUXYYXFX 
  87. FFYYXXLLUUPPLPUXPUYFFYXLL 
  88. XFPYUXYFLUXYFPULPXYPFPXFF 
  89. ~         {Start of Message to user}
  90. @w@w      {Wait 2 seconds}
  91. @r        {Remove morse run from screen / clear screen}
  92. @h        {Use High text colour}
  93. @l@l@l    {Three line feeds}
  94.                            END OF LESSON 1 
  95. @w@w@w    {Wait 3 seconds}
  96. @r        {Remove message from screen}
  97. ~         {End of Message}
  98.  
  99.  
  100.      The above example is the first lesson encountered when running
  101. Morse Keyboard. For an insight into formatting a lesson attempt
  102. lesson 1.  Later lessons contain more complex examples of the use
  103. of codes.
  104.  
  105.  
  106.  
  107.  
  108.  
  109.