AMX TPI-PRO-4, Operation/Reference Manual

Page: 154 / 218

NetLinx Programming
148 TPI-PRO/DVI (Total Presentation Interface)
Dynamic Image Commands
The following table describes Dynamic Image Commands.
A device must first be defined in the NetLinx programming language with values for
the Device: Port: System (in all programming examples - Panel is used in place of
these values and represents all compatible G4 devices).
Dynamic Image Commands
^BBR
Set the bitmap of
a button to use a
particular
resource.
Syntax:
"'^BBR-<vt addr range>,<button states range>,<resource name>'"
Variable:
variable text address range = 1 - 4000.
button states range = 1 - 256 for multi-state buttons (0 = All states, for General buttons
1 = Off state and 2 = On state).
resource name = 1 - 50 ASCII characters.
Example:
SEND_COMMAND Panel,"'^BBR-700,1,Sports_Image'"
Sets the resource name of the button to ’Sports_Image’.
^RAF
Add new
resources.
Adds any and all resource parameters by sending embedded codes and data.
Since the embedded codes are preceded by a '%' character, any '%' character contained
in the URL must be escaped with a second '%' character (see example).
The file name field (indicated by a %F embedded code) may contain special escape
sequences as shown in the ^RAF, ^RMF - Embedded Codes table below.
Syntax:
"'^RAF-<resource name>,<data>'"
Variables:
• resource name = 1 - 50 ASCII characters.
• data = Refers to the embedded codes, see the ^RAF, ^RMF - Embedded Codes section
on page 149.
Example:
SEND_COMMAND Panel,"'^RAF-New Image,%P0%HAMX.COM%ALab/
Test%%5Ffile%Ftest.jpg'"
Adds a new resource.
• The resource name is ’New Image’
• %P (protocol) is an HTTP
• %H (host name) is AMX.COM
• %A (file path) is Lab/Test_file
• %F (file name) is test.jpg .
Note that the %%5F in the file path is actually encoded as %5F .
^RFR
Force a refresh for
a given resource.
Syntax:
"'^RFR-<resource name>'"
Variable:
resource name = 1 - 50 ASCII characters.
Example:
SEND_COMMAND Panel,"'^RFR-Sports_Image'"
Forces a refresh on ’Sports_Image’.