Positional Audio / Vic Window Highlighting for AG 2.4

Installation instructions for two-machine configuration:
   Windows video consumer (i.e., "display machine")
   Linux video producer + audio

Robert Putnam
11/8/05

1. On the Windows display machine, copy the windows "multi-computer"
   HighlightVideoConsumerService.zip into C:\Program Files\AGTk-2.4\NodeServices.

2. On the Linux audio machine, copy the linux "multi-computer"
   PositionalAudioService.zip into /etc/AccessGrid/NodeServices. 

3. Make sure that "AGServiceManager.py" is running on the Linux machine.

4. Start the AG venue client on the Windows machine.  Go into
   "[Preferences][Manage My Node...]".  Remove VideoConsumerService from
   the Windows service manager and add HighlightVideoConsumerService.
   Remove AudioService from the Linux service manager and add
   PositionalAudioService.  Save this configuration ("[File][Store
   Configuration]") under a new name (e.g., "positional audio").

5. While still in the "Access Grid Node Management window, right-click on
   HighlightVideoConsumerService, then choose "Configure".  Set the
   minxpixel and maxxpixel values for your display.  On a single monitor
   system, minxpixel should probably be 0, and maxxpixel should probably be
   one less than the width of the display (e.g., 799, 1023, or 1279).
   Click OK.  Save the configuration again ("[File][Store Configuration]")
   under the new name (e.g., "positional audio"). [necessary?]

6. Make sure that the left and right outputs from the Linux audio computer
   are connected to separate inputs on the Gentner.  In the Gentner matrix,
   assign both of these inputs to a single output channel and make that
   channel your EC reference.  Also, make sure that there are also separate
   output channels for the left and right speakers.  (I.e., the EC
   reference is set to the sum of left+right, but the left and right
   loudspeakers get their own, different, feeds.)  (See gentner-matrix.jpg,
   which contains a portion of the matrix for a XAP 800.)

The positional audio software should now be configured.  When the system is
operating, it outlines the current speaker's window with a light green
border and pans the audio to the relative position of the window on the
display.  (If a given site's window is on the left side of the screen, for
instance, the audio should seem to be coming from the left.)