Version 17 (modified by piotr.domagalski, 8 years ago) (diff)


Vitrall RC

General information

Vitrall RC is an Android remote controller for the Vitrall Visualization Server. It is able to connect to server and send information gained from device's sensors (accelerometer, magnetic field sensor and touchscreen) allowing the user to control the rendered model manually. It can also display the model.

Look here for implementation details. When establishing connection with the Vitrall Visualization server, an xml-based handshake is carried out.


To maintain the application the Android SDK is required ( Android SDK). Using IntelliJ IDE is recommended (whole IDE project is placed in repository). To install the application on Android based device you have to transfer generated VitrallRC.apk file to your device. You can do it directly from IDE or by running shell command

(Android SDK directory)/platform-tools/adb install <path to you .apk file> 


There are a few constants contained in .xml files (res/values/ folder) which can be changed to configure the client, all listed below:


  • all of the strings being used in application can be changed here (including default URLs used in settings), at the moment only English language is supported.


  • threshold_sensors (default 3), a value which decides if the sensors' values change was big enough to send data to server,
  • threshold_touch (default 3), number of pixels, which decides if the move of finger touching the screen was big enough to send data to server,
  • sending_frequency (default 30), a frequency (in hertz) of messages being sent to server,
  • test_mode, binary value deciding if the test mode is on (1), or off (0). In test mode the built in barcode scanner is disabled, application connects to server with address chosen in settings (change default values in strings.xml file).

These options can also be changed when application is running by XML handshake.



Vitrall RC is accessible at ( Intellij IDEA project).

Technical reports

2Q2011 Vitrall Android Report (format: pdf/language: English) Download