# Performance Scaling Component The `RealityPerformanceScaling` Component *** ### Reality Performance | Setting | What it Does | | -------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Enabled | Enables/Disables the Component | | Update Scaling at Start |

If true, runs the scaling evaluation immediately on BeginPlay instead of waiting for the first tick interval.
(Useful so actors aren't in full detail for one frame before the scaling)

| | Base Check Interval | How often (in seconds) the component re-evaluates which scaling tier the actor should be at. | | Use End Frame Tick |

Defers the component's tick to the end of the frame (after physics and animation).
(Useful for when you want scaling decisions to occur AFTER movement is finished.)

| | Location From |

Where the component samples the actor's position for distance calculations.

Collide Bound: The Actor's Collision Bounds
Global Bound: Uses the actors full render bounds center
Specified Relative: Uses a manual offset from the actor origin.

| | Relative Origin | The manual offset vector, only relevant when Location From = Specified Relative. | | Add Bound for Get Distance | If true, adds the actor's bound radius to the raw distance calculation. This means large actors (vehicles, buildings) start scaling at further effective distance than small ones, even if their origins are the same distance from the camera. | | Predicted Future Location | Uses the Actor's Velocity to predict where it will be next frame and calculates distance from that predicted position. | ### Default Scaling / Pause Scaling | Setting | What it Does | | --------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Default Scaling | The tier applied when the mesh is returned to its default state (Distance 0.0, Full quality) | | Pause Scaling | The tier applied when the actor is "paused" by the system (e.g., too far away or culled). | | Change Check Interval | If true, this tier overrides the base check interval with the value in new check interval. So distance actors can check less frequently while nearby actors check more often. | | New Check Interval | The override interval in seconds when Change Check Interval is enabled. | *** ### Scaling Off Name This is an array of scaling tier names that are treated as "off" states: Hidden, Cull, LOD3. \ When the actor enters any tier thats Scaling Name matches one of these, the component knows the actor is invisible/not relevant and can skip work (stop ticking, disable collision, whatever) ### Distance Scaling Four LOD tiers with more aggressive scaling as you go along it.
TierDistanceOut ValueCheck Interval
LOD050010.075 (about 13 times a sec)
LOD110000.650.12 (about 8 times a sec)
LOD220000.350.35 (about 3 times a sec)
LOD335000.010.75 (about 1 time a second)
*** ### HiddenOcclusion | Setting | What it Does | | -------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Use on Hidden Scaling | Enables scaling response when the actor is hidden/occluded | | Check Actor is Hidden | Queries whether the actor's `bHidden` flag is set | | Check Actor is Hidden Allow on Listen Server | Opts the Listen Server into Actor Visibility Checks | | Check Occlusion | Uses an Occlusion System to detect if the actor is behind something. | | Check Occlusion Allow on Listen server | Opts the Listen server into Occlusion Checks | | On Hidden Scaling | The tier applies when hidden: Distance 0.0 Out Value 0.01 check interval 0.05s. Scales down hidden actors but checks frequently so they come back fast when revealed. | ### AngleCulling | Setting | What it Does | | ------------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Use Angle Culling | Toggle | | Angle Culling allow on Listen Server | Opts the Listen server in to the Angle Culling | | Max Half Angle |

The max angle between the player camera's forward vector and the direction to the actor.

(e.g., if the actor is more than 65 degrees off from where the camera is looking, it gets culled.)

| | Angle Stating on Cull | This tier gets applied when it fails the angle check (its angle from the player camera is higher than the given max half angle) | --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://beyond-sandbox.gitbook.io/realitysdk/documentation/performance/performance-scaling-component.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.