NetLinx Programming
92
TPI-PRO-DVI - Instruction Manual
Button Commands (Cont.)
^BMF Set any/all button parameters by sending embedded codes and data.
Syntax:
"'^BMF-<vt addr range>,<button states range>,<data>'"
Variables:
• variable text address char array = 1 - 4000.
• button states range = 1 - 256 for multi-state buttons (0 = All states, for General buttons, 1 = Off state and 2 = On state).
• level range = 1 - 600 (level value is 1 - 65535).
• data: See the Button Commands With Embedded Codes section on page 85.
^BMI Set the button mask image. Mask image is used to crop a borderless button to a non-square shape. This is typically used
with a bitmap.
Syntax:
"'^BMI-<vt addr range>,<button states range>,<mask image>'"
Variables:
• 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).
• mask image = Graphic file used.
Example:
SEND_COMMAND Panel,"'^BMI-530,1&2,newMac.png'"
Sets the button with variable text 530 ON/OFF state mask image to 'newmac.png'.
^BML Set the maximum length of the text area button. If this value is set to zero (0) there is no max length. The maximum length
available is 2000.
Note: This is only for a Text area input button and not for a Text area input masking button.
Syntax:
"'^BML-<vt addr range>,<max length>'"
Variables:
• variable text address range = 1 - 4000.
• max length = 2000 (0=no max length).
Example:
SEND_COMMAND Panel,"'^BML-500,20'"
Sets the maximum length of the text area input button to 20 characters.
^BMP Assign a picture to those buttons with a defined address range.
Syntax:
"'^BMP-<vt addr range>,<button states range>,<name of bitmap/picture>'"
Variables:
• 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).
• name of bitmap/picture = 1 - 50 ASCII characters.
Example:
SEND_COMMAND Panel,"'^BMP-500.504&510.515,1,bitmap.png'"
Sets the OFF state picture for the buttons with variable text ranges of 500-504 & 510-515.
?BMP Get the current bitmap name.
Syntax:
"'?BMP-<vt addr range>,<button states range>'"
Variables:
• 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).
• custom event type 1002:
Flag - Zero
Value1 - Button state number
Value2 - Actual length of string
Value3 - Zero
Text - String that represents the bitmap name
Text length - Bitmap name text length (should be 9)
Example:
SEND COMMAND Panel,"'?BMP-529,1'"
Gets the button 'OFF state' bitmap information.
The result sent to the Master would be:
ButtonGet Id = 529 Type = 1002
Flag = 0
VALUE1 = 1
VALUE2 = 9
VALUE3 = 0
TEXT = Buggs.png
TEXT LENGTH = 9