VCAM – Desktop Application

Run: desktop/VCamDesktop.exe

This application receives live data from the joystick devices, customizes and interprets what each button is to do and passes the interpreted message on to the 3D application.

The Desktop app must run on the PC that the usb dongle is connected to. When the dongle is connected, click “Connect”. When the connection is successful, “CONNECTED” will appear at the top right.

If the desktop app does not receive data from the joystick for more than a second, the background color will change to brown.

Enter the ID numbers at the top for each joysticks if they do not populate correctly or are in the wrong left/right order.

The desktop application can be used to simulate the joystick controls for testing. For example the circle representing the joystick can be clicked and dragged to simulate the user operating the joystick and the buttons can be “pressed”.

Revision 1 Configuration

Legend

A/B/C/D	Button Assignment
E/F/G/H	Joystick Axis Assignment. Setting one side will clear the other, allowing for positive/negative mappings. For example setting E will clear G.
I	Visual indicator of current joystick position
Trigger	Button on the backside of the joystick
Joystick	Similar to L3/R3 on PlayStation controllers the analog sticks are clickable by pressing down
Scroll	Scroll wheel on the back of the controller
LED1	Upper LED
LED2	Lower LED

Bindings

Binding Options	Description
Zoom	Adjusts focal length.
Focus	Adjusts focus distance (only supported for UE).
Translate X/Y/Z	Translates Camera along the corresponding axis.
Rotate X/Y/Z	Rotates Camera along the corresponding axis.
Value 1/2/3/4	Sends the raw value of that input without any interpretation to your 3D application.
Zero Magic Carpet	Move camera back to origin.
Prime Up	Jump up to the next focal length on the “Primes” list.
Prime Down	Jump down to the next focal length on the “Primes” list.
Zoom In	Increment focal length.
Zoom Out	Decrement focal length.
Record	Trigger record on all devices added to your PeelCapture session(see here for more details).
Play	Trigger Play on all devices added to your PeelCapture session(see here for more details).
Stop	Trigger Stop on all devices added to your PeelCapture session(see here for more details).
Debug Focus	Turns on the Debug Focus Plane in UE
180	Flips the camera 180 degrees
Button 1/2/3/4	Sends the raw value of this button without any interpretation to your 3D application.
Transport	Visual indicator of the recording status.
Online	Visual indicator that the joysticks are online.

Settings

The settings can be customized via Options Menu -> Settings.

The Layout dropdown controls how many joysticks are shown – A single one, a pair, or two pairs. The two pairs can be shown horizontally or vertically in the main window.

The Revision dropdown controls which joystick revision is available in each panel. Use “Rev1” for the joystick that has a switch control and 4 buttons. Use “Rev2” for the playstation joystick that has the scroll wheel and trigger button.

The first Targets group is for the first pair or joysticks. Add the host name and IP address of any PC’s that need to receive the messages – i.e. instances of Motion Builder or Unreal Engine.

The second Targets group is for the second set of joysticks. Add the host name and IP address of any PC’s that need those messages. Make sure to use a different port number if the are running on the same PC.

The listen port is where the software listens for messages, specifically from PeelCapture. Set this to a unique port.

Connecting to Peel Capture

To trigger Record/Stop/Playback from VCAM follow these steps:

1. In the Desktop application, add a target by navigating to Options -> Settings -> Targets -> Click the ‘+’ button.
2. In the ‘Host’ field, enter the IP address of the machine running PeelCapture.
3. In the ‘Port’ field, enter a port number that is currently unused.
4. Click ‘OK’ to confirm.
5. In PeelCapture, add a new device in the Devices Panel.
6. Select ‘peelvcam’ from the dropdown menu.
7. In the ‘Address’ field, enter the IP address of the machine running the Desktop Application.
8. In the ‘Port’ field, enter the ‘Listen Port’ value found in the Desktop Application’s settings.
9. For the ‘Listen IP,’ select the IP address you mentioned in step 2.
10. In the ‘Listen Port’ field, enter the port number you entered in step 3.