RealDocs

UActorComponent::IsRenderInstancesDirty

function Engine Since 4.20
#include "Components/ActorComponent.h"
Access: public Specifiers: inline

Description

Returns true if per-instance render data (such as instance transforms or custom data for instanced meshes) is marked dirty and awaiting an update to the renderer.

Caveats & Gotchas

  • This flag is set by MarkRenderInstancesDirty() and cleared after DoDeferredRenderUpdates_Concurrent() sends the data to the render thread. Calling this between those two points will return true.
  • Checking this flag is useful in editor tooling or custom update loops, but in gameplay code you rarely need to query it — the engine flushes dirty state automatically at end of frame.

Signature

inline bool IsRenderInstancesDirty() const

Return Type

bool

Example

Querying dirty state before a manual flush C++
if (MyInstancedMeshComponent->IsRenderInstancesDirty())
{
	// Defer heavy work until the render state is clean
	UE_LOG(LogTemp, Verbose, TEXT("Instance data still pending flush"));
}

Version History

Introduced in: 4.20

Version Status Notes
5.6 stable

Feedback

Was this helpful?

Suggest an edit

Select a field above to begin editing.