TYPE: CHOP
TITLE: Keyboard CHOP

This CHOP receives input from the ASCII keyboard, and outputs channels for
several keys. It creates a single-frame channel representing the current state
of each key.

The channel for a key is created by putting a channel name string in one of
the Name parameters, and selecting that key from the corresponding Key menus.

The Type menus determine which of the several key modes is chosen:

Note that the Keyboard CHOP can only be used while in "Intercept" mode.
Intercept mode is turned on when the Scroll Lock key at the top-right of the
ASCII keyboard has been pressed. When in Intercept mode, the Houdini play bar
will change color and all keyboard input will be redirected to Keyboard CHOPs.
This means that, when Intercept is on, you cannot access viewing hotkeys, edit
any OP parameters or use the textport. Press Scroll Lock again to leave
Intercept mode. The scroll bar should return to its normal grey color.
In addition, to make the 10 Key Pad keys work with the Keyboard CHOP, you
need to have the Num Lock key (on the keypad) on.

The Mouse and Keyboard CHOPs are often connected to the Position and Active
inputs of the Record CHOP to enable the recording of channels.

The Channel tab lets you set the Sample Rate and the Extend Conditions.

There are no local variables.

Parameters
Keys 1 to Keys 3
    Name 1-9 - The name of the channel that monitors the selected key.
	       If blank, a channel will not be created. 
    Type 1-9 - Determines which of the several key modes is chosen:
        Momentary - This is simply the up/down state of a key. 0 is up and
                    1 is down.
        Toggle    - This toggles the key state. Push once and it goes on (1),
                    push again and it goes off (0).
        Count     - This increments the channel value by one every time the
                    key is pressed. If the ALT key is also pressed, the
                    channel value is decremented instead.
        Pulse     - This  produces a one-frame pulse when a key is pressed.
        Time      - This returns the length of time that the key has been
                    held down. It only works when the time bar is playing.
    Key 1-9  - The Key selector, where valid keys are the numbers 0-9,
	       letters A-Z, and keypad 0-9.

See also: Audio In(audioin), MIDI In(midiin), Pipe In(pipein), Mouse
