Matrix Library Documentation

Introduction:

This describes the commands that can be used to control the
video input/outputs of the matrix switcher.  To use it, simply source
matrix-lib.tcl.  Note that if you want to use the commands through the
server, you do not need to source the matrix-lib.tcl file.  Simply
call the commands below using the TclDP interface (Mash or Tcl).

Sources:

To keep the system flexible, and to make the interface more
understandable, descriptive strings are used.  Possible inputs and
outputs are listed below.  These can be used in calls to matrix
library functions.

Inputs:
	mbonePC
	sgiPC
	frontPC
	liveboard
	laptop
	rackVCR
	frontVCR
	speakerCamera
	wideCamera
	audienceCamera

Outputs:
	htsr
	htsr2


Commands:

The commands below can be invoked directly from amxd, or remotely
using the TclDP interface.  Examples are shown only for the TclDP case
only.

matrix_switchVideoStream input output
    - args:
	input - [one of valid inputs (see above)]
	      - which input source should be connected to output
	output - [one of valid outputs (see above)]
	       - which output source is being changed
    - return value:
	none
    - desc:
	Routes the specified input to the specified output.

matrix_rawSwitchVideoStream level input output
    - args:
	level - [1,2]
	      - which level will be switched
	input - [1,8]
	      - which input will be routed to the output
	output - [1,8]
	       - which output source is being changed
    - return values:
	none
    - desc:
	Allows you to modify the matrix switch settings manually,
	specifying inputs and outputs.

# FIXME - need to document the getStatus stuff

