UKismetSystemLibrary::DrawDebugSphere

function Engine Blueprint Since 4.0

#include "Kismet/KismetSystemLibrary.h"

Access: public Specifiers: staticUFUNCTIONBlueprintCallable

Description

Draws a wireframe debug sphere built from three orthogonal circles, commonly used to visualize a radius such as a sphere trace or overlap check.

Caveats & Gotchas

• Compiled out entirely in Shipping and Test builds since the UFUNCTION is DevelopmentOnly.
• High Segments values on many simultaneous spheres (e.g. one per Tick per actor) can visibly impact frame time in PIE/editor — keep Duration and Segments modest for per-frame debug draws.

Signature

static void DrawDebugSphere(const UObject* WorldContextObject, const FVector Center, float Radius=100.f, int32 Segments=12, FLinearColor LineColor = FLinearColor::White, float Duration=0.f, float Thickness = 0.f, EDrawDebugSceneDepthPriorityGroup DepthPriority = EDrawDebugSceneDepthPriorityGroup::World)

Parameters

Name	Type	Description	Default
WorldContextObject	const UObject*	World context used to resolve which world to draw in.	—
Center	const FVector	World-space center of the sphere.	—
Radius	float	Radius of the sphere.	100.f
Segments	int32	Number of segments used per great circle when approximating the sphere.	12
LineColor	FLinearColor	Color of the drawn sphere.	FLinearColor::White
Duration	float	How long the sphere persists, in seconds. 0 draws for a single frame.	0.f
Thickness	float	Line thickness in screen pixels.	0.f
DepthPriority	EDrawDebugSceneDepthPriorityGroup	Whether the sphere is depth-tested against the scene or always drawn in the foreground.	EDrawDebugSceneDepthPriorityGroup::World

Return Type

void

Example

Visualize an overlap radius C++

UKismetSystemLibrary::DrawDebugSphere(
    this,
    GetActorLocation(),
    OverlapRadius,
    16,
    FLinearColor::Yellow,
    0.f);

Version History

Introduced in: 4.0

Version	Status	Notes
5.6	stable	—

Feedback

Was this helpful?