Unigine.Plugins.VrpnButtonDevice Class
A class for the VRPN Plugin that allows receiving data about states of input device buttons.
See Also#
- Article on VRPN Plugin
- A set of UnigineScript API samples located in the <UnigineSDK>/data/samples/plugins/ folder:
- vrpn_client_00
- vrpn_client_01
VrpnButtonDevice Class
Properties
int NumButtons#
The Total number of buttons of the input device.
Members
void setButtonCallback ( string name ) #
Sets the world script callback function that receives data about input device buttons.The callback function should be defined in the world script and receive 2 arguments - a button number and state.
void callback_func(int button,int state) {
// function logic
}
Arguments
- string name - Callback function name.
Examples
VrpnButtonDevice vrpn_button;
int init() {
// create an instance of VrpnButtonDevice
vrpn_button = new VrpnButtonDevice("device_name@server_addr");
// set a callback
vrpn_button.setButtonCallback("button_callback");
return 1;
}
int shutdown() {
delete vrpn_button;
return 1;
}
int update() {
vrpn_button.update();
return 1;
}
// a callback function
void button_callback(int button,int state) {
log.message("Device button %d: %d\n",button,state);
}
string getButtonCallback ( ) #
Returns a name of the world script callback function that receives data about input device buttons. The callback function should be defined in the world script and receive 2 arguments - a button number and state.void callback_func(int button,int state) {
// function logic
}
Return value
Callback function name.void update ( ) #
Updates the internal state of the device and receives input data.This function should be called each frame.
int GetNumButtons ( ) #
Returns the total number of buttons of the input device.Return value
Total number of buttons of the input device.int GetButtonState ( int num ) #
Returns the current state for a button with the specified index.Arguments
- int num - Button index.
Return value
Button state.VrpnButtonDevice ( string name ) #
Constructor.Arguments
- string name - Path to the device in the format device_name@server_address.
Last update:
2024-12-13
Help improve this article
Was this article helpful?
(or select a word/phrase and press Ctrl+Enter)