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)

The Occlusion Culling option is 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.

Maximum Quality should be kept as default.

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	Min Value	Default Value	Max Value	Low-End PC (Mobile)	Mid Range PC	High-End PC
Occlusion Culling	Enable Dynamic Occlusion Culling.	FALSE	FALSE	TRUE	FALSE	FALSE	FALSE
Occlusion 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	Bounding Box	Bounding Box	Bounding Box	Bounding Box	Bounding Box
Occlusion Query Frequency	Value is in times per second. A value of 0 means will it run on every frame.	0	8	60	5	8	12
Triangle Budget	The maximum amount of triangles that you want to be in the scene at any single point.	0	5000000	Depends on device	Mobile won't use this parameter	5000000	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.	0	3000000	Depends on device	3000000	PC won't use this parameter	PC won't use this parameter
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.	0	1.1	10	1.1	1.1	1.1
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.	0	15000	300000	15000	15000	0