beautypg.com

BrightSign Object Reference Manual (FW 5.1) User Manual

Page 267

background image

259

stores a list of all channels that are obtained using the

CreateChannelDescriptor() method (described below).

The list is cleared on each call to

Scan() by default, but this behavior can be overridden.


Each channel takes approximately one second to scan; you can limit the scope of the channel scan with the
following parameters:

o ["ChannelMap"] = "ATSC" or "QAM": Limits the frequency scan to either QAM or ATSC.
o ["ModulationType"] = "QAM64" or "QAM256": Limits the modulation type of the scan to QAM64 or

QAM256.

o ["FirstRfChannel"] = Integer and/or ["LastRfChannel"] = Integer: Limits the scan to the

specified range of channels. The high end of the channel range is an optional parameter.

o ["ChannelStore"] = "DISCARD ALL" or "MERGE": Controls how the script handles previous channel

scan information. The default setting is

DISCARD ALL, which clears all channel data prior to scanning. On

the other hand,

MERGE overwrites the data only for channels specified in the scan.

GetChannelCount() As Integer: Returns the number of found channels.

ClearChannelData() As Boolean: Clears all stored channel scanning data, including that which persists in
the registry. This method also cancels any

AsyncScan() calls that are currently running.

GetCurrentSnr() As Integer: Returns the SNR (in centibels) of the currently tuned channel.

ExporttoXML() As String: Serializes the contents of RF channels into XML. You can write the XML to a file
that can be used at a later point on the same or other units. See below for an example of XML output.

ImportFromXML(a As String) As Boolean: Retrieves the RF channel contents stored as XML. The
formatting of the XML is controlled using version tags.
Example




2