# Calibration (Gloves & Controller)

This chapter takes the connection of a pair of gloves as an example, and multi-pairs of gloves are used in the same way.

## 1. Calibration of Movement

### **Function Description**

* Before displaying and recording actions, it is necessary to perform action calibration. According to the graphic and text guidance of the system interface, make corresponding gestures for action calibration. After successful calibration, the hand model can be driven for display and action recording.
* The calibration of a single glove connected within a character is workable.
* The calibration results can be reused, and you can decide whether to recalibrate when reopening the software.

### **Shortcut Calibration**

For the square glove, press the switch for about 0.5 second to trigger the calibration function, which is equivalent to clicking the "Calibration" button. This function makes it more convenient to perform re-calibration when necessary due to reasons such as improper movements during use.

### **Operating Steps**

Follow these steps to perform action calibration in the software (it is <mark style="color:red;">**HIGHLY recommended to keep your palms down when calibrating**</mark>):

{% stepper %}
{% step %}
Wear gloves, make sure the receiver and gloves are normally turned on.
{% endstep %}

{% step %}
At least one pair of gloves is properly connected to the software. At this time, the calibration button in the left device list bar is blue. Click the "Calibration" button to calibrate the action.
{% endstep %}

{% step %}
After entering the calibration process, according to the system graphic guidance, perform three calibration actions in turn. Each action lasts about 3 seconds for calibration. When performing the calibration action, observe the Progress Bar below the guidance text. After the Progress Bar below is completed, switch to the next action. During the calibration process, the "Calibration" button is no longer available until the calibration is completed.
{% endstep %}

{% step %}
If you are not satisfied with the calibration results, you can click the "Calibration" button again to repeat the calibration.
{% endstep %}

{% step %}
If calibration fails due to unexpected circumstances, repeat the above steps to re-calibrate.
{% endstep %}

{% step %}
After calibration is completed, if the gloves are accidentally disconnected, there is no need to re-calibrate after reconnection.

{% endstep %}

{% step %}
When calibrating, if there are gloves that do not participate in the calibration, the glove model will not be driven after the calibration is completed and will remain in its initial state.
{% endstep %}

{% step %}
**When using multiple pairs of gloves, do not insert the second pair of glove receivers during the calibration period of the first pair. It is recommended to insert both pairs before calibration, or wait until the first pair is calibrated before inserting the second pair.**
{% endstep %}
{% endstepper %}

{% file src="/files/eLONH8V4WpaWg4hf7pfb" %}
**Reference video**
{% endfile %}

{% file src="/files/sdT94hkh9RIMtNotH4V9" %}

### **User Interface**

{% stepper %}
{% step %}
The interface after the device is connected and paired normally.

<figure><img src="/files/ZwVQwOtl3cQsMfJ9fHB4" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}
After normal connection pairing, the button "Calibrate" will be enabled. Click the "Calibrate" button to do calibration.
{% endstep %}

{% step %}
Calibrate according to the graphic guidance.

* Make a fist

<figure><img src="/files/EpkCMxuLJels0ieTmezz" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/gNzBFJgcW7BfkYGlXiA1" alt="" width="375"><figcaption></figcaption></figure>

* Fingers Straight and Together

<figure><img src="/files/PULeIWU5XY0nb0TdDvuz" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/ipefv8vVjGR0WMu2xEsw" alt="" width="375"><figcaption></figcaption></figure>

* Spread your fingers (as much as possible)

<figure><img src="/files/BlPoXHEUgEvDvAkMwNDI" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/9VdfNuQqM2C8vrmwduK6" alt="" width="375"><figcaption></figcaption></figure>
{% endstep %}

{% step %}
After successful calibration, it shows successful calibration:

<figure><img src="/files/kLS9mVUuR4KS6j4pWCSY" alt=""><figcaption></figcaption></figure>

or shows fail if the calibration fails.
{% endstep %}
{% endstepper %}

## 2. Action Display

Drive the hand model to display hand movements.

Ensure that the device is properly paired and connected, and the action calibration is successful.

{% stepper %}
{% step %}
After the action calibration is completed, when the user performs a hand action, the hand model in the software synchronously displays the action.
{% endstep %}

{% step %}
Hold the right mouse button and drag the mouse to rotate the hand model. Click the reset direction button to return to its original position.
{% endstep %}
{% endstepper %}

### **User Interface**

{% stepper %}
{% step %}
Hand model movement:

<figure><img src="/files/erfET5l24sGkC8i0zwtX" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}
After clicking the reset direction button, the hand model returns to the initial position:

<figure><img src="/files/8e7KHcU7W5BFK3vT0ovC" alt="" width="303"><figcaption></figcaption></figure>
{% endstep %}
{% endstepper %}

## 3. Thumb Root Node Adjustment

Adjust the thumb root node for optimal action.

Adjust the thumb root node in the software according to the following steps:

{% stepper %}
{% step %}
Ensure that the device is properly paired and connected, and the action calibration is successful.
{% endstep %}

{% step %}
Find the glove that needs to be adjusted in the equipment list and click the expand button to the left of the glove name.
{% endstep %}

{% step %}
By pulling the slider behind the thumb root node coefficient or typing a number in the number box behind it (accurate to 2 decimal places), adjust the degree to which the thumb root node bends into the palm, with a modification range of 0 to 1. The larger the value, the greater the bending degree; the smaller the value, the smaller the bending degree.
{% endstep %}

{% step %}
X, Y, and Z below the deviation of the thumb root node correspond to the X, Y, and Z axes of the thumb root node, respectively. Adjust the rotation of the thumb root node by pulling the slider behind each axis or typing a number in the number box behind (only integers are supported). The range of the thumb rotation value is -180° to 180°.
{% endstep %}
{% endstepper %}

### **User Interface**

1. The thumb root node adjustment interface is as follows:

<figure><img src="/files/x4wukq0ZOXutuqnPdNI0" alt="" width="274"><figcaption></figcaption></figure>

2. **Thumb Root Ratio:**&#x20;

{% stepper %}
{% step %}
By pulling the slider behind the thumb root ratio, the degree of bending of the thumb root node into the palm can be adjusted:

<figure><img src="/files/4HtMSvgSAGf4u8PtTyzh" alt="" width="272"><figcaption></figcaption></figure>
{% endstep %}

{% step %}
Adjust the degree of bending of the thumb root node into the palm by typing a number in the number box behind the slider.

<figure><img src="/files/uaAB9ESpnyWysAPJE4r7" alt="" width="274"><figcaption></figcaption></figure>
{% endstep %}
{% endstepper %}

3. **Thumb Root Offset adjustment:**&#x20;

{% stepper %}
{% step %}
By pulling the slider behind X, Y, and Z, modify the rotation direction of the X, Y, and Z axes of the thumb root node:

<figure><img src="/files/rAwx4oBP80uDgmT0wldr" alt="" width="279"><figcaption></figcaption></figure>
{% endstep %}

{% step %}
Modify the rotation direction of the X-axis, Y-axis, and Z-axis of the thumb root node by typing a number in the number box behind the slider.
{% endstep %}
{% endstepper %}

## 4. Controller Management

### Function Description

Manage the controller for gloves with controllers (joystick buttons and vibration feedback). The controller includes:

* Joystick: Push the joystick to control the direction; the joystick can also be pressed, that is, the joystick key.
* Joystick Deadzone: Drag the slider to adjust the joystick deadzone. The default value is 15%.
* A/B button: A and B buttons.
* Vibration feedback: Vibrator 1 is under the button, vibrator 2 is under the joystick.

### Operating Steps

{% stepper %}
{% step %}
After calibrating gloves with controllers, you can click the "Controller" button.
{% endstep %}

{% step %}
In the controller interface, you can push the joystick, press the button, and click the vibration feedback trial button. The corresponding Functional Button on the interface will respond.
{% endstep %}

{% step %}
Drag the slider to adjust the joystick deadzone. Clicking "Reset" will restore it to the default value (15%).
{% endstep %}

{% step %}
Click on the joystick calibration and follow the system instructions to calibrate the joystick.
{% endstep %}

{% step %}
Access Unity/UE plug-in or "C++ SDK joint angle Linux version" to obtain the data of each Functional Button of the controller.
{% endstep %}
{% endstepper %}

<figure><img src="/files/ngqxdkQ6eFoboB2YhgIN" alt="" width="563"><figcaption><p>User Interface</p></figcaption></figure>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://udexreal.gitbook.io/udexreal-docs/software-instruction/software-instruction/calibration-gloves-and-controller.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.