---
title: "Vision Client Parameters"
---

# Vision Client Parameters

> By default, error messages in the Designer and Client report a stack trace, which provides granular information about the source of the error. However in some cases, these stack traces may include sensitive information from the Gateway. You can restrict the amount of information presented in these error messages with the following parameter:

## Gateway Configuration File Parameters
The following parameters should be placed in the Gateway's configuration file

### Suppressing Error Message Details

```js title="Example"
wrapper.java.additional.#=-Dignition.xmlrpc.errorDetailSuppression=%Value%
```

Where %Value% is one of the following values:

|Value|Description|
|:---|:---|
|NONE|Errors are not suppressed at all. This is functionally the same as not specifying the parameter at all. (default behavior)|
|CLIENT|Error messages for client sessions will be suppressed, but not designer sessions. |
|ALL|Error messages for both clients and the designer will be suppressed.|

### Route Handling

The following parameters are used to modify route handling for Vision Clients. Changing the values for these parameters is not necessary, but increasing the values may help improve Vision Client launching in extremely busy systems, resulting in fewer browser timeouts.

|System Property|Description|
|:---|:---|
|`-Dvision.fetch-concurrency`|Determines the number of concurrency Clients. Defaults to 25,|
|`-Dvision.fetch-timeout`|Determines the timeout period when receiving project updates. Defaults to 5000 milliseconds.|

## Vision Launcher File Parameters
The following parameters should be placed in the [Vision Client Launcher's configuration file](launchers-and-workstation\deploying-pre-configured-launchers\deploying-pre-configured-launchers.md#three-key-pieces-to-a-configured-launcher)

### Timeout Thresholds

The following parameters will modify Vision connection default wait times. These timeout settings are available to change under [Vision Project Property > Timing](ignition-modules\vision\vision-project-properties\vision-project-properties.md#vision-timing-properties), but changes inside the Designer will only take effect after the project is downloaded. Using a timeout threshold parameter will override the default settings to increase maximum wait times immediately. 

|System Property|Description|
|:---|:---|
|`-Dignition.gateway.connectTimeout`|The maximum amount of time to wait for connections to the Gateway to be established. Specified in milliseconds. Default is 10,000.|
|`-Dignition.gateway.readTimeout`|The maximum amount of time for socket connection to the Gateway to remain open. Specified in milliseconds. Default is 60,000.|
|`-Dignition.gateway.opcBrowseTimeout`|Maximum amount of time, in milliseconds, to wait for the response to a request. Default is 120,000.|

### Long Press Delay

The following system property allows the long press delay to be configured per client for the [Vision Touchscreen Keyboard](ignition-modules\vision\vision-project-properties\using-touch-screen-mode\using-touch-screen-mode.md). 

|System Property|Description|
|:---|:---|
|`-Dignition.touchscreen.longPressDelay`|The amount of time in milliseconds needed for a user to press and hold before a long press action is enabled. Default is 1000.  A value less than or equal to 0 will disable long press behavior entirely.|

### Keyboard Font Scaling

The following parameters change the scaling and size of the [Vision Touchscreen Keyboard](ignition-modules\vision\vision-project-properties\using-touch-screen-mode\using-touch-screen-mode.md).

|System Property|Description|
|:---|:---|
|`-Dignition.touchscreen.keyboardWidth`|The percentage of the client window the touch screen keyboard displays. You can also set the "Touch Screen Keyboard Width" in Vision's Project Properties for all machines running the Vision project. Default is 75%.|
|`-Dignition.touchscreen.keyboardFontSize`|Customize touchscreen keyboard font size. You can also set the "Touch Screen Keyboard Font Size" in Vision's Project Properties for all machines running the Vision project. Default is 30.|

### Synthetica Screen Share Warnings

When running a Designer in Linux Wayland, you may receive screen sharing warnings that can cause the Designer to stop working. These warnings can be prevented by adding a custom Synthetica XML file to your Designer Launcher JVM arguments. Your XML file should look like the following:

```python title="test"
<synth>
    <defaultsProperty key="Synthetica.popupRobot.enabled" type="boolean" value="false"/>
</synth>
```

|System Property|Description|
|:---|:---|
|<pre>-Dignition.synthetica.customXml</pre>| Applies the referenced XML file to disable the `Synthetica.popupRobot.enabled` UIManager key, which causes the warnings to appear.  |

```python title="Example"
-Dignition.synthetica.customXml=C:\Users\username\Desktop\test.xml
```