Solve common problems when using occlusion culling, such as incorrect culling and slow processing.
Objects are reported as visible in the occlusion data but are visibly occluded.
Occlusion data represents a conservatively simplified version of the sceneA Scene contains the environments and menus of your game. Think of each unique Scene file as a unique level. In each Scene, you place your environments, obstacles, and decorations, essentially designing and building your game in pieces. More info
See in Glossary’s occluders, meaning some of the occlusion erodes and loses detail. Precise occlusion culling costs significant time and resources, so Unity doesn’t try to be 100% accurate with culling by default. Unity tries to cull as much as possible in the minimum amount of time, which can cause false positives.
Decrease the value of the Smallest Occluder parameter. This will produce higher-resolution data that’s less conservative. However, culling will decrease in speed and occlusion data will increase in size.
Objects are occluded incorrectly.
Visible objects can be culled if the Smallest Hole value is too high compared to the actual size of the holes in your scene. A hole in your scene can range from an actual hole in a meshThe main graphics primitive of Unity. Meshes make up a large part of your 3D worlds. Unity supports triangulated or Quadrangulated polygon meshes. Nurbs, Nurms, Subdiv surfaces must be converted to polygons. More info
See in Glossary to a small gap between two objects. If visible objects are being culled incorrectly, the hole is being incorrectly interpreted as full and acting as an occluder.
Objects are not occluded correctly.
Unintentional holes in your occluding geometry are retained by voxelization and magnified in the occlusion data.
Make sure your geometry is modeled to be as watertight as possible.
The culling process is too slow.
Occlusion culling can take a lot of time if your occlusion data resolution is very high.
Increase the value of the Smallest Occluder parameter.
The baking process is too slow.
The occlusion culling parameters can have a large impact on baking time. The higher the resolution of your occlusion culling data, the longer it will take to bake them.
Increase the value of the Smallest Hole parameter.
The size of the occlusion data is too large.
Occlusion culling can take a lot of data if your occlusion data resolution is very high.
Baking fails with the Failure in split phase
error.
The initial step of the bake tries to subdivide the scene into computation tiles. The subdivision is based on the Smallest Occluder parameter and when the scene is large in size, too many computation tiles can be created, resulting in an out of memory error.
Increase the value of the Smallest Occluder parameter and split up the scene into smaller chunks.
Did you find this page useful? Please give it a rating:
Thanks for rating this page!
What kind of problem would you like to report?
Thanks for letting us know! This page has been marked for review based on your feedback.
If you have time, you can provide more information to help us fix the problem faster.
Provide more information
You've told us this page needs code samples. If you'd like to help us further, you could provide a code sample, or tell us about what kind of code sample you'd like to see:
You've told us there are code samples on this page which don't work. If you know how to fix it, or have something better we could use instead, please let us know:
You've told us there is information missing from this page. Please tell us more about what's missing:
You've told us there is incorrect information on this page. If you know what we should change to make it correct, please tell us:
You've told us this page has unclear or confusing information. Please tell us more about what you found unclear or confusing, or let us know how we could make it clearer:
You've told us there is a spelling or grammar error on this page. Please tell us what's wrong:
You've told us this page has a problem. Please tell us more about what's wrong:
Thank you for helping to make the Unity documentation better!
Your feedback has been submitted as a ticket for our documentation team to review.
We are not able to reply to every ticket submitted.