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.


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)

When Occlusion Culling is enabled objects that are hidden by other objects will not be rendered. It depends on the model how much occlusion culling will improve performance.

Occlusion Geometry allows you to specify what is used to check if a mesh is occluded. Bounding Box option is faster but less accurate while the Mesh option is slower but more accurate. Bounding Box should be sufficient in most cases.

Occlusion Query Frequency determines how many times a second meshes are checked if they are occluded. A lower value will increase performance but meshes will take longer to reappear.

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.

With a Distance Factor above 1 nearby objects are given preference when allocating triangles. A value below 1 gives preference to further away objects and a value of 1 is neutral.

It will stop improving geometry when it reaches the Maximum Quality. This can be used to stop far away objects from showing more detail than is necessary. Setting a value of 0 means there is no limit on quality apart from the triangle budget.

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

Last updated

Was this helpful?