Loading...

Features of the App

The free "Widget Designer Remote" App for Apple devices such as the iPhone, the iPad or iPod allows to remote control a running Widget Designer with your mobile device. You may send
- single or multi-touch data to remote control the mouse or work directly in various controls such as the "Multi Touch Panel"
- commands to execute a certain function, either by clicking a button or via a text field
- images taken with your mobile device
- acceleration data from the in-build accelerometer, e.g. to track an object

It might be of interest that Widget Designer offers another feature to be remote controlled by mobile devices. The in-build Web Server is capable to export any page as a page that can be viewed by any web browser such as Safari.

Settings within the device

After downloading and installing the App, please open the "Settings" menu. Under "Wi‑Fi", make sure that you share the same wireless network as the PC Widget Designer is running on. Afterwards, scroll down the "Settings" list and search for "coolux", here you may set up the optional settings for this App. Protocol: Choose the connection type: TCP or UDP. For sending touch and tracking data, UDP is the better choice - for the button and command data TCP is more reliable. If you would like to use the camera mode, TCP must be used. Please see this chapter for detailed info about these two protocols. IP Address: Enter the IP address from Widget Designer. If you are not sure, have a look into the dialog "Pandoras Box Network Configuration". Port: Enter the listening port for the TCP or UDP connection. The same port needs to be set in Widget Designer, per default it is already set to 23. Accelerometer: Enable this option if you would like to transmit XYZ acceleration values. Button Settings: Per default all buttons are labeled with the numbers 1-20. Enter a new name to change this. In the "Script" field, a command can be allocated to each button. It is mandatory to enclose the command in parentheses. It does not matter whether it is written in capitals or lower-cased. Please refer to the command list for more details. Please note that you can enter a command in the App itself as well. The buttons screen includes a text field, when clicking into it you may enter a command without parentheses and click "Send" on the keyboard. If you would like to send more than one command at once, you can either send one command that executes a macro or clicks a Custom Script Button that holds these commands. Both, the macro and the Custom Script Button need to be set up in Widget Designer. If you are using iOS 5 and encounter problems with the App, please update to a newer operating system, e.g. iOS 6; so far no problems were reported with that version.

Settings within Widget Designer

Go to the Tools menu and open the "Remoting" dialog. The section "iPhone WD Remote" offers the following settings.

Port:
Enter the listening port for the TCP or UDP connection. The same port needs to be set in the settings for the App, per default it is already set to 23.

TCP / UDP:
Decide which protocol you want to use, again it needs to be the same as set in the App. For more details, see the above.

Enable:
Tick the check box to enable the connection.

Mouse:
This option allows to remote control the position of the mouse cursor with the touch data from the WD Remote App user interface. Regardless of that setting many controls like the "Multi Touch Panel" allow to enable the input mode "iPhone" to receive the touch data.

Click 2x:
This option allows receiving a mouse click when the WD Remote App user interface is touched twice.

Click 4x:
This option allows receiving a mouse right-click when the WD Remote App user interface is touched four times in a row.

If you wish to work with the acceleration values, please create an input node: Input > Device > iPhone Remote.

If you would like to use the camera mode, please follow these steps. First, pick an image using the App and send it to Widget Designer. It then appears in the Image Resource Manager under Style: User, Control: User. With the help of commands, you may then display it in the Image / Picture Box, use it on a Custom Script Button or save it directly on the hard drive before adding it to your Pandoras Box project. The commands including "Recent" refer to the last image send from the App.

Some helpful commands could be:
- WDCustomScriptReleaseImageResource(ID,ResourceName)
- WDPictureBoxLoadResource(ID,Resource)
- WDPictureBoxLoadRecentResource(ID)
- WDResourceSave,Resource(Path)
- WDResourceRecentSave(Path)