beautypg.com

BrightSign Object Reference Manual (FW 5.1) User Manual

Page 120

background image

112

All value comparisons are case-insensitive, and all integer values must have no leading zeroes.

Numerical values must match the stream description exactly. For example, the pattern

pid=016 will never match

the stream PID value of 16.

To indicate logical negation, apply the "!" exclamation mark to the beginning of a pattern. For example, specifying

SetPreferredVideo("!codec=H265") will match only streams that are not encoded using H.265.

Apply the ">" greater-than symbol before an integer to indicate that, for a successful match, the value in the stream

description must be greater than the value following the symbol. For example, specifying
SetPreferredVideo("width=<1921,height=<1081") will match only videos that are no larger than full-HD.

Apply the "<" less-than symbol before an integer to indicate that, for a successful match, the value in the stream

description must be less than the value following the symbol.


The following examples illustrate some of the pattern matching behavior described above:

The following template list contains three patterns:

lang=eng, lang=spa, and an empty template. The first pattern

specifies an English language channel; if the English channel does not exist, the second pattern specifies a
Spanish language channel. The third pattern specifies any other channel if the first two don't exist (the empty
template matches anything).
SetPreferredAudio("lang=eng;lang=spa;;")

Since the following template list is empty, no captions are specified. This can be used to disable captions

altogether.
SetPreferredCaptions("")

The following template list contains an empty template. Since an empty template matches anything, the first video

stream encountered will be played. This is the default behavior of all attributes.
SetPreferredVideo(";")