KEY(OPCS)               Optical Printer Control System          KEY(OPCS)

    NAME
        key - shoot camera/projector frames by button control

    USAGE
        key [no arguments]

    DESCRIPTION
        KEY(OPCS) gives the operator button controls to run camera, projector,
        and fader for simple shooting. These are the defaults defined by the
        KEYFUNC(OPCSDEFS) command in the OPCSDEFS.OPC file:


        AERIAL (PRO2)              MAIN (PRO1)              CAMERA (CAM)
    _____________________     _____________________     _____________________
   /                     \   /                     \   /                     \
    ___   ___   ___   ___     ___   ___   ___   ___     ___   ___   ___   ___
   |F1 | |F2 | |F3 | |F4 |   |F5 | |F6 | |F7 | |F8 |   |F9 | |F10| |F11| |F12|
   |___| |___| |___| |___|   |___| |___| |___| |___|   |___| |___| |___| |___| 
    Fwd   Rev   Fwd   Rev     Fwd   Rev   Fwd   Rev     Fwd   Rev   Fwd   Rev
    Slew  Slew  +1    -1      Slew  Slew  +1    -1      Slew  Slew  +1    -1      
   

          PRINTING         COUNTERS         FADE       DISSOLVE    OPN/CLS
      _______________   _______________    _______     _______    _________
     /               \ /               \  /       \   /       \  /         \
      ___   ___   ___   ___   ___   ___   ___   ___   ___   ___   ___   ___
     | 1 | | 2 | | 3 | | 4 | | 5 | | 6 | | 7 | | 8 | | 9 | | 0 | | - | | + |
     |___| |___| |___| |___| |___| |___| |___| |___| |___| |___| |___| |___| 
      REP   REP   RAT   RES   RES   RES   FDI   FDO   DXI   DXO   CLS   OPN
      Fwd   Rev   Set   pro2  pro1  cam   Set   Set   Set   Set   Fader Fader

      ________________     _______   _______   ______
     |Backspace       |   |Ins    | |Home   | |PgUp  |
     |          Seek  |   |    x  | |  Load | |   x  |
     |________________|   |_______| |_______| |______|
                           _______   _______   ______
                          |Del    | |End    | |PgDn  |
                          |    x  | |     x | |   x  |
                          |_______| |_______| |______|


     'x' indicates no default is configured, but can be customized
     using 'keydef' commands in the OPCSDEFS.OPC file

     For a non-diagrammatic description:
                                                _
            F1 =  projector2 continuous run fwd  |
            F2 =  projector2 continuous run rev  |  AERIAL PROJECTOR SHOOT
            F3 =  projector2 fwd single frame    |         (PRO2)
            F4 =  projector2 rev single frame   _|
                                                _
            F5 =  projector1 continuous run fwd  |
            F6 =  projector1 continuous run rev  |  MAIN PROJECTOR SHOOT
            F7 =  projector1 fwd single frame    |         (PRO1) 
            F8 =  projector1 rev single frame   _|
                                                _
            F9  =  camera continuous run fwd     |
            F10 =  camera continuous run rev     |  CAMERA SHOOT
            F11 =  camera fwd single frame       |
            F12 =  camera rev single frame      _|
                                                _
            1 =  run positive ratio shoot        |
            2 =  run negative ratio shoot        | RATIOS
            3 =  set ratio to new values        _|
                                                _
            4 =  set projector2 counter          |
            5 =  set projector1 counter          | COUNTERS
            6 =  set camera counter             _|
                                                _    
            7 =  set fade in                     |  FADES
            8 =  set fade out                   _|
                                                _    
            9 =  set dissolve in                 |  DISSOLVES           
            0 =  set dissolve out               _|
                                                _    
            - =  close fader                     |  OPEN/CLS            
            = =  open fader                     _|
                                                _
    BACKSPACE =  seek pro/cam                   _|  CAPPED SEEK
         HOME =  unlock (deenergize) motors
          ESC =  quit to OPCS command line

        It is advised you add a keyboard template with the above values,
        or use a relegendable keypad like the "XKEYS Desktop PS/2 Keypad".

        On most IBM keyboards, function keys (F1 - F12) are arranged across
        the top of the keyboard in 3 groups, 4 keys per group:

             Axis        F-Key
             ----------  ---------
             Aerial Pro  F1 - F4
               Main Pro  F5 - F8
                 Camera  F9 - F12

        In each group, the first two keys shoot fwd/rev as long as you hold
        the key down. The others shoot single frame forward/reverse.

        Use KEYFUNC(OPCSDEFS) to define external port bits so your own custom
        hardware buttons can control the motors. You can also tie your own
        custom commands and run scripts to buttons and keys.
        
        EXAMPLE. To define the TAB key to invoke a DOS 'dir /p' command, put 
        the following in your OPCSDEFS.OPC file:

            keyfunc -add "! dir /p" 0060 ff 0f  0060 80 80
                         ---------- ----------  ----------
                             |             |           |
                             |             |           Key release
                     OPCS command to run   Tab down keycode "0f"

        Then restart opcs and run the 'key' command. Hitting TAB will show
        a directory listing, then you will be prompted to hit a key, then
        you're returned to the key mode.

    SEE ALSO
        JOG(OPCS)         - jog to new positions (in pulses) interactively
        QUICKREF(DOCS)    - See PUSH BUTTON SHOOTING for examples
        KEYFUNC(OPCSDEFS) - Lets you define which keys control motors
	MOTORS(OPCS)      - Disable motor hardware, simulates shutter runs

    ORIGIN
        Gregory Ercolano, Los Feliz California 02/15/91
© Copyright 1997 Greg Ercolano. All rights reserved.