Polygon Streaming Project Settings

This page details how to control the global settings of VIVERSE Polygon Streaming within your PlayCanas project when using the VIVERSE PlayCanvas extension.

---

Polygon Streaming project settings are only available when using the VIVERSE extension of the PlayCanvas editor.

Stream Controller Component

The Stream Controller or Polygon Streaming Settings (VIVERSE SDK) manages the streaming of models and streaming parameters inside your project. It can be found under Viverse Scene Settings.

Polygon Streaming Settings (VIVERSE SDK)

Camera Type allows you to choose between Player camera or Non-player camera. In case you use an avatar it should be set as a Player camera. In case you use just a viewer camera, without an avatar or character attached, it should be set to Non-player camera.

Next you can customize Occlusion Culling options, it's recommended to keep as default.

The Triangle Budget is a limit on the amount of triangles that will be drawn per frame. Increasing this will lead to better visual quality, but of course also higher processing and memory utilization. It's recommended to keep Triangle Budget to at least 30% of the full amount of polygons that you are going to stream. For example, if you are going to stream a 3D model of 10 million polygons, it's recommended to use a Triangle Budget of at least 3 million.

The Mobile Triangle Budget is the same as Triangle Budget, however it will be applied in case the system identifies the user is visiting the experience via a mobile device.

Minimum Distance and Maximum Quality should be kept as default.

The Distance Factor is a factor between the distance of the camera to the object being streamed. The default value of 1.1 has a neutral preference. A higher value, such as 3 or 5, will have a preference for nearby objects over objects further away. These parameters can be changed at runtime to find the sweet spot for your scene.

The Distance Type can be set to Bounding Box or Bounding Box Center. In case it's set to Bounding Box it will calculate the distance between the camera and object based on the edges of the bounding box of the object. In case it's set to Bounding Box Center, it will calculate the distance from the center of the object. It's recommended to use Bounding Box for single objects, and Bounding Box Center for full environments in which the user will be walking inside the object.

The Close Up Distance is a change in the distance factor between camera and streaming object when the camera gets too close. For example, when the camera is at 3 units or less of distance from the object, it will use the value at Close Up Distance Factor, when the camera is further than 3 units from the object, it will use the value at Distance Factor. That way the system forces a strong streaming of data when the camera is very close to an object.

Details of parameters are also set on the Supported Parameters section.

Supported Parameters

Name	Description	Default Value
Camera Type	The viewer camera to be set, the system will calculate distances based on the selected camera.	Player Camera
Occlusion Culling	Enable Dynamic Occlusion Culling.	True
Occlusion Culling Geometry	Mesh: Use the mesh to check if it's occluded Bounding Box: Use the bounding box of the mesh to check if it's occluded.	Bounding Box
Occlusion Query Frequency	Value is in times per second. A value of 0 means will it run on every frame.	8
Triangle Budget	The maximum amount of triangles that you want to be in the scene at any single point.	5000000
Mobile Triangle Budget	The triangle budget used on a mobile device. If it is set to 0 it will use the non-mobile triangle budget.	3000000
Distance Factor	Preference for nearby objects over objects further away. Values above one mean a preference for nearby objects. Values below one mean a preference for objects further away. One is neutral.	1.1
Distance Type	Distance type from camera to the meshes bounding boxes.	Bounding Box
Maximum Quality	Stops improving geometry that exceeds the maximum quality. This can be used to stop far away objects from showing more detail which can be wasteful. Leaving this at 0 means there is no maximum quality.	15000
Close Up Distance	The distance where it starts using close-up distance factor. Set it to 0 to not use close-up distance factor.	3
Close Up Distance Factor	The distance factor used when close-up to an object. Should be higher than the standard distance factor.	5