Component: wn_dest

Description

This component is part of the BBC Academy at Wood Norton version 4.5 BNCS system. The hardware installation in various buildings and areas uses both audio and video routers. The router sizes are minimised to keep costs low, so we do not have a simple association between the destination crosspoints on the video and audio roters (eg video destination 23 and audio destination 11 may feed the same logical entity). Whilst the BNCS packager could be used to manage the crosspoint packages, the packager only provides tally from a selected single level. Experience shows that in the Wood Norton installation tally data is needed from all levels.

There are 4 BNCS drivers used to manage the source and destination packages:

1) Package names.
The package names are arranged in logical groups of 30 sources or destinations per group. Databases 0 and 1 hold the long names, databases 2 and 3 hold the short name. Databases 5 and 6 hold the group names.

2) Package crosspoints.
The format of an entry is 0006=3,7  where 3 is the video crosspoint and 7 is the audio crosspoint.
A non-existant element (eg a video only source) has a hypen in place of the number for the level eg 0009=17,-

3) Video Router.
This is a standard BNCS router ini file, but using databases 0 and 1 for long names, and databses 2 and 3 for short names.

4) Audio Router.
This is a standard BNCS router ini file, but using databases 0 and 1 for long names, and databses 2 and 3 for short names.

Component wn_dest acts as a "smart" button that displays both the audio and video tally data from a destination, and the destination name for the chosen destination id. The visual editor is used to set up the 4 database entries, and the destination id in the package names database.

Commands

You can pass commands to this component in the format:
<parameter>=<button_id>

Name	Type	Use
return=all	String	Returns all of the parameters to the script host.
return=destination_id	String	Returns the assigned destination_id. Feteched by textGet("destination_id", panel_id, control_id, &return_var);
return=video_id	String	Returns the video destination for the assigned destination_id.
return=audio_id	String	Returns the audio destination for the assigned destination_id.
destination_id	Number	The destination id for the smart control. This will be an entry in the package names list.
package_name_id	Number	The BNCS driver id for the package names.
package_xpts_id	Number	The BNCS driver id for the comma deliminated crosspoints in the packages named in package_name_id
video_matrix_id	Number	The BNCS driver id for the video level.
index	Number	The index value is sent by the host panel system. An index value=-1 clears the button selection if it is active. An index value that is greater than 0 is compared with the destination_id. If the values do not match, any active button selection is cleared. If the index value matches the destination number, the destination is selected.
buttonaction	Logic State	If the buttonlogic value is "true" the button emits notifications when pressed. If the buttonlogic value is "false" the notification happens on button release.
buttonstyle	Name String	The default stylesheet for the button.
buttonhigh	Name String	Set the statesheet name to use when the button is "active".
buttonlow	Name String	Set the statesheet name to use when the button is inactive.
videotallystate	Name String	Set the stylesheet name to use for the selected item of the item selection buttons.
audiotallystate	Name String	Set the stylesheet name to use for the deselected item of the item selection buttons.

Notifications

Name	Use
select=<destination_id>	The destination id for this button control, or -1 when the active button is deselected.

Stylesheets

No default stylesheets used.

Developers Notes

Nothing to put here (yet!)