Other Features

This section covers additional features of VirtualLens2.

Preset Recall

You can recall preset settings that you prepared during setup. This allows you to quickly configure commonly used values for focal length, aperture, exposure, or a combination of these. For more details about preset settings, refer to the Configuration Reference.

Hide Specified Meshes

You can hide specified meshes, which you set up during the configuration. Hiding these meshes affects all other players, but it won’t work if safety settings have disabled animations.

Preview Screen Info Display Settings

You can configure the information displayed on the preview screen. To change the default settings, adjust the parameters during setup.

Grid

This option lets you display gridlines on the preview screen. You can choose between options such as Hidden, 3x3, 3x3 with Diagonals, 6x4, or a Custom Grid.

Configuration Info

This setting displays values like focal length, aperture, etc., in common units rather than percentage notation.

Level

It shows a visual level that indicates the camera’s tilt.

Focus Peaking

Focus peaking highlights the area in focus. You can choose to enable this feature at all times, only in manual focus mode, or disable it.

Mask Settings

When shooting with VirtualLens2, you can select which objects should be visible through the camera.

Local Player

Choose whether to display the shooter’s own avatar.

Remote Players

Choose whether to display avatars of other players.

UI Elements

You can select whether to show UI elements like nameplates and personal mirrors on the camera feed.

Preview HUD

This feature prominently displays the preview screen at the center of your view.

Internal Resolution Settings

Select the resolution for images used internally by VirtualLens2. It is recommended to match this setting with the resolution set on the VRChat standard camera.

Dealing with Scene-Dependent Issues

The constraints imposed by avatars incorporating cameras can lead to unexpected behavior depending on the world and instances. In such cases, VirtualLens2 includes options to address these issues, albeit with some trade-offs in performance or usability.

Clipping Plane Adjustment

Temporarily relaxes the far clipping plane limit. If distant objects are not being captured in extremely large worlds, try adjusting this setting.

However, unnecessarily increasing this limit may lead to increased rendering load and visual artifacts such as Z-fighting. Please be mindful of these issues when making adjustments.

Configuration Options

Default: Uses the Far Plane value specified during setup as the upper limit.
10x: Uses 10 times the specified Far Plane value as the upper limit.
100x: Uses 100 times the specified Far Plane value as the upper limit.

Technical Background

In VRChat, the maximum rendering distance for a player’s view or the built-in camera is determined by the world settings. However, since avatar-integrated cameras cannot reference world settings, VirtualLens2 applies a predefined limit (default: 5000m) as the upper boundary.

Arbitrarily increasing this value can lead to visual degradation due to precision loss, but some worlds require greater viewing distances. This feature allows users to temporarily adjust the limit, balancing both needs.

Enable Depth Texture Generation

Forces the generation of depth textures during VirtualLens2 capture to stabilize the operation of visual effects that depend on them.

Configuration Options

Disable: Does not force depth texture generation.
Enable: Forces depth texture generation. (Default setting)

Technical Background

Some worlds utilize custom shaders for special visual effects that rely on depth textures (_CameraDepthTexture). If depth textures are not generated, the expected visual results may not be achieved. This feature enables a faint directional light to ensure that depth textures are generated even for avatar-integrated cameras, improving effect stability within VirtualLens2.

However, if certain objects in a scene are highly affected by weak lighting, their appearance may change significantly. In such cases, temporarily disabling this setting is recommended.

Filling Depth Textures

Reduces the impact of effects that use depth textures (_CameraDepthTexture) on the built-in camera by clearing the depth texture with a uniform value during built-in camera rendering.

Configuration Options

Disable: Does not clear the depth texture of the standard camera.
Nearest: Clears the standard camera’s depth texture using its Near Plane value.
Farthest: Clears the standard camera’s depth texture using its Far Plane value. (Default setting)

Technical Background

Some worlds apply post-processing effects such as depth-of-field simulation and Screen-Space Ambient Occlusion, which rely on depth textures (_CameraDepthTexture). If these effects use depth textures captured from the built-in camera’s viewpoint, unintended artifacts may appear.

This feature minimizes such unintended effects by filling the depth texture with a uniform value, rendering these effects largely ineffective, and thus reducing their impact on the output.