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