002 038 186 200 237 260 279 000 000 000 000 000 000 000 000 000 000 000 000
 Command:  Setup/Macros/Play OR CTRL ]            < SMP >
 Purpose:  Play a keystroke Macro file on disk.
 Information:
     A "Macro" is a recorded collection of keystrokes.  This 
     option presents a pick window of macro files on the current 
     directory.  Select a file with the arrow keys or mouse, just 
     as you would load other types of files.  After the file is 
     loaded Patternland replays all keystrokes contained in the 
     file.   

     Patternland uses the selected mode--Tutorial, Automatic, or 
     neither--to play the macro.  If neither Tutorial nor 
     Automatic modes are checked, you press any key to play each 
     keystroke.  Tutorial and Automatic mode are described under 
     the help for each option.

     In Automatic mode, you can pause the playback by pressing 
     Space (or another key); press Space again to resume. 
     
     In any mode, press CTRL ESC once or twice to cancel the 
     macro. 
 Comments:
     You can also use the "hotkey" combination Control "]" to 
     activate the Play option from any menu.  HOWEVER, you must 
     replay a macro at the same location from which it was 
     recorded or UNPREDICTABLE consequences will result.  Usually 
     you will only use the hotkey to play back macros which you 
     recorded with the Record hotkey, e.g. a threading or 
     treadling block.  Just move the cursor to the starting 
     thread where you want to play the input, press ESC for the 
     menu, and press Ctrl "]" to pick the macro file to play. 

 See Also:  Setup/Macros/Record 
 ______________________________________________________________


 Command:  Setup/Macros/Record OR CTRL \          < SMR >
 Purpose:  Record a new keystroke Macro to disk.
 Information:
     A "Macro" is a recorded collection of keystrokes.  This 
     option presents a file name window for you to type the name 
     of a new macro file.  If the file exists, Patternland will 
     warn you before overwriting the file.  After you specify the 
     file name and press ENTER, you are in recording mode.  If 
     the Key line option is ON (highly recommended for 
     recording), the Key line appears as soon as you record the 
     first key.  It tells you what key you pressed along with the 
     status of the keyboard.  See the help under Key Line for a 
     detailed description of the Key Line indicators. 
 
     To create the rest of the macro, simply press each key you 
     want to record.  When you are done recording, return the 
     Macro menu and select <Stop>. The Key line disappears when 
     you stop recording.  You can also stop recording with the 
     "hotkey" Ctrl ESC.  (Use Ctrl [ from MS-Windows.)

     EXTENDED MACROS -- recorded with Num Lock ON 

     An eXtended Macro is one with an associated window of text 
     information; and an optionally modified delay or timed 
     interval.  To record an extended macro, simply turn the 
     NumLock ON before pressing the key you want.  A window 
     appears with the current header and footer and text from the 
     last recorded keystroke.  The available options are NOT 
     displayed; you must refer to this document until you 
     memorize them.  These are the XMacro commands:
     
     MOVEMENT:   Press the Left and Right, Up and Down Arrows to 
                 move the window on the screen.  PgUp and PgDn 
                 also move the window up and down.  Text mode 
                 windows refresh the screen underneath; Graphics 
                 mode windows obliterate the screen contents as 
                 they are moved.
     
     SIZING:     Press Control plus Left Arrow to reduce the 
                 width; Control Right Arrow to increase width.  
                 Press Control PgUp to reduce height; Control 
                 PgDn Increase height.  First use the movement 
                 commands to put the upper left corner of the 
                 window where you want it; then use the sizing 
                 commands to resize it.
                 
     TEXT:       Press BACKSPACE to Erase the current text and 
                 write new text. Press ESC ONCE to end text 
                 input. 
                   
                 If you are in a text mode macro window, write 
                 the text without carriage returns except to 
                 force a new line or paragraph.  While you are 
                 writing, the text wraps at the end of each      
                 line, even in the middle of words; when you are 
                 done, Press ESC ONCE:  the text will be 
                 rewritten with a one space margin and wrapping 
                 whole words to the next line.  You can resize 
                 the window to adjust how the text wraps.
                 
                 For a Graphics mode macro, you must press ENTER 
                 at the end of each line at the length that you 
                 want.  You can still resize the window later, 
                 but the text doesn't care how big it is and will 
                 overwrite the window frame if the window is too 
                 small.
                        
     HEADER:     Press <H> to rewrite the Header text.  The 
                 window text is temporarily erased for you to 
                 write the header.  Press ENTER when you are 
                 done.  The header text is replaced and the 
                 window text is redisplayed.  Headers are carried 
                 over from one window to the next until you 
                 rewrite them. 

     FOOTER:     Press <H> to rewrite the Footer text.  The 
                 window text is temporarily erased for you to 
                 write the footer.  Press ENTER when you are 
                 done.  The footer text is replaced and the 
                 window text is redisplayed.  Footers are carried 
                 over from one window to the next until you 
                 rewrite them.
                 
     DELAY:      Press <D> <value> <ENTER> to set a specific 
                 Delay Factor for this keystroke only.  During 
                 Automatic Mode, this value will be used instead 
                 of the overall delay factor set from the menu.  
                 Multiply the Delay Factor you set by 100 to get 
                 the actual time in milliseconds.  A Delay Factor 
                 of 10 creates a delay of 1 second.             

     TIMED:      Press <T> <value> <ENTER> to set a specific 
                 Timed Interval for this keystroke only.  During 
                 ANY mode, Patternland will continue activity for 
                 the amount of time you specify BEFORE playing 
                 back the recorded keystroke.  This feature is 
                 mostly useful for demonstrations of the color 
                 cycling in the VGA palette editor.  Use ASCII 
                 255 (ALT plus NumPad 255) for a Timed Macro that 
                 does nothing.  As with the Delay Factor, 
                 multiply the value you set by 100 to get the 
                 actual time in milliseconds.  A Timed Keystroke 
                 does NOT wait for user input before playing the 
                 next recorded keystroke, regardless of the mode 
                 of playback. 

     DONE:       Press ESC to stop defining an XMacro keystroke.

 Comments:
     You can also use the "hotkey" combination Control "\" to 
     begin Recording from any menu.  HOWEVER, the user must 
     replay a macro at the same location from which it was 
     recorded or UNPREDICTABLE consequences will result.  Usually 
     you will only use the hotkey to record macros that create a 
     block of threading or treadling.  In this case it may be 
     preferable to use the function and other top row numeric 
     keys to enter the threading/treadling, rather than the space 
     bar with smart cursor directional commands.  With F-key 
     input it doesn't matter which harness the cursor is on when 
     you ESC to the menu to record a macro.  Just move the cursor 
     to the thread where you want to record the input; press ESC 
     for the menu; and press Ctrl "\" to specify the name of the 
     macro file to record.  Press Enter to begin recording. 
     
     NOTE:  You must have an enhanced style keyboard to record 
     extended macro directional keys; and all numeric NumPad keys 
     are extended macros by default.  Use the top row number keys 
     to record non-extended numeric keystrokes. You can edit the 
     macro file with a text editor if you don't have an enhanced 
     keyboard and want to record extended macro directional keys. 

     If you need to edit an existing Macro, you can use 
     Patternland's Write/File option (use F3 to change the File 
     Mask from *.pnf to *.pxm to display existing macro files, or 
     use F4 to type the name if you know it).  Note that 
     Patternland's File/Write editor is limited to 249 characters 
     per line.  Text mode macro text is usually entered without 
     carriage returns except between paragraphs to allow word 
     wrap to function as you resize the window.  If you do edit a 
     macro file with lines longer than 249 characters, 
     Patternland will insert carriage returns as needed.  You may 
     need to move them to an appropriate place in your text. 

 See Also:  Setup/Macros/all options
            the file "Macro.doc" for details on file format
 ______________________________________________________________


 Command:  Setup/Macros/Stop OR CTRL ESC or [     < SMS >
 Purpose:  Stop recording or playing a keystroke Macro.
 Information:
     This option turns off the Macro recorder.
 Comments:
     With the "hotkey" combination Control ESC you can stop
     recording at any time.  Then, when the macro is played,
     it ends without returning to the Macro menu.  Note:  From
     MS-Windows, PWS.PIF must reserve CTRL ESC; or use CTRL [.

 See Also:  Setup/Macros/Record 
 ______________________________________________________________


 Command:  Setup/Macros/Key line                  < SMK > 
 Purpose:  Toggle the display of the keystroke name status line.
 Information:
     If the Key line option is ON (highly recommended for 
     recording), the Key line appears as soon as you press the 
     first key.  It tells you what key you pressed along with the 
     status of the keyboard.  During Playback the Key line tells 
     you what key will be played next, along with the status of 
     the keyboard.   

         Example Key Line showing all possible indicators:
     ╔══════════════════════════════════════════════════════╗
     ║    Key Status Line:    "key" + Shf Ctl Alt CL SL 1   ║     
     ║                          │      │   │   │  │  │  │   ║
     ║    Name of key pressed───┘      │   │   │  │  │  │   ║
     ║        Shift key was down───────┘   │   │  │  │  │   ║
     ║            Control key was down─────┘   │  │  │  │   ║
     ║                 Alt key was down────────┘  │  │  │   ║
     ║                    Caps Lock was ON────────┘  │  │   ║
     ║                       Scroll Lock was ON──────┘  │   ║
     ║                         Keystroke count = one────┘   ║
     ╚══════════════════════════════════════════════════════╝

 Comments:
     If you create Extended Macro tutorials which prompt the user 
     for the key to press within the window text, you may wish to 
     turn the Key Line off for playback.  One way to control the 
     status of all Patternland settings when a macro is played is 
     to begin the macro by loading a weaving file which contains 
     the settings as you want them to be at the start of the 
     macro.  This assures you that all recorded keystrokes will 
     result in the actions you intended.

 See Also:  Setup/Macros/other options 
 ______________________________________________________________


 Command:  Setup/Macros/Tutorial                  < SMT > 
 Purpose:  Toggle Tutorial Mode, which gives you three tries.
 Information:
     Tutorial Mode pauses before executing each keystroke (except 
     Timed keys), and waits for the correct key input from the 
     user.  If the first user keystroke is incorrect, Patternland 
     beeps once.  After the second incorrect keystroke, 
     Patternland beeps twice.  With the third incorrect key, 
     three beeps "and you're out": Patternland provides the 
     correct key and moves on to the next one.

     Note that the status of the keyboard (Shift, Control, Alt, 
     Scroll Lock, and Caps Lock) must also match the recorded 
     keyboard status for the key to be "correct."  
 Comments:
     This is the mode to use for the Online Tutorial; it is 
     optional for the Demo.  Weaving teachers may find this mode 
     useful in preparing on-line lessons for their students.

 See Also:  Setup/Macros/Automatic 
 ______________________________________________________________


 Command:  Setup/Macros/Automatic                 < SMA > 
 Purpose:  Toggle Automatic Mode, which plays without user input.
 Information:
     Automatic Mode uses the Delay Factor to pause for the 
     specified amount of time before executing each keystroke 
     (except Timed keys, which execute AFTER the timed interval). 
     
     This mode is useful for demonstrations and for "hotkey" 
     macros which you record to create useful threadings and 
     treadlings or perform other commonly used keystrokes.   
 Comments:
     If you set the Delay Factor for a specific extended macro 
     keystroke, that delay is used instead of the overall Delay 
     factor set from the menu.
     
 See Also:  Setup/Macros/Delay 
 ______________________________________________________________


 Command:  Setup/Macros/Delay                     < SMD > 
 Purpose:  Set Macro Delay.  Value X 100 = Time in milliseconds 
 Information:
     This setting is used by Automatic Mode during playback, 
     unless an extended macro keystroke has a specified delay 
     factor, in which case that value overrides this one.

     The Delay factor is in 10ths of a second, i.e., a value of 
     10 = 1 second.  
     
 Comments:
     The maximum allowable delay is 255, or 25.5 seconds.  Use 
     several "do nothing" keystrokes (like ASCII 255--ALT NumPad 
     255) if you require a delay longer than 25 seconds. 

     If you set the Delay Factor for a specific extended macro 
     keystroke, that delay is used instead of the overall Delay 
     factor set with this option.
     
 See Also:  Setup/Macros/Record--Delay and Timed 
 ______________________________________________________________
