AActor::IsHLODRelevant

function Engine Since 4.14

#include "GameFramework/Actor.h"

Access: public Specifiers: virtual

Description

Returns whether this actor should contribute geometry to Hierarchical Level of Detail (HLOD) mesh generation. The base implementation checks the `bEnableAutoLODGeneration` flag and whether the actor has any HLOD-relevant components.

Caveats & Gotchas

• Actors that return false are ignored during HLOD build passes — override to force inclusion or exclusion of specific actor types that the heuristic misclassifies.
• Returning true when the actor has no visible mesh components is harmless but may cause the HLOD builder to waste time evaluating this actor during generation passes.
• HLOD relevance is evaluated during the HLOD build in the editor; changes to this override will not take effect on existing built HLOD clusters until the HLOD is rebuilt.

Signature

ENGINE_API virtual bool IsHLODRelevant() const;

Return Type

bool

Example

Force an actor to be excluded from HLOD C++

bool AMyTransientActor::IsHLODRelevant() const
{
	// This actor is placed at runtime and should never appear in static HLOD meshes
	return false;
}

Version History

Introduced in: 4.14

Version	Status	Notes
5.6	stable	—

Feedback

Was this helpful?