PhysicsUtilities.h

Go to the documentation of this file.

// Copyright (c) 2023 FrostBit Software Lab at the Lapland University of Applied Sciences
//
// This work is licensed under the terms of the MIT license.
// For a copy, see <https://opensource.org/licenses/MIT>.
 
#pragma once
 
#include "CoreMinimal.h"
#include "Kismet/BlueprintFunctionLibrary.h"
#include "CollisionQueryParams.h"
#include "Engine/StaticMesh.h"
 
#include "PhysicsUtilities.generated.h"
 
class AActor;
 
UCLASS()
class AGRARSENSE_API UPhysicsUtilities : public UBlueprintFunctionLibrary
{
    GENERATED_BODY()
 
public:
 
    UFUNCTION(BlueprintCallable, Category = "Physics Utilities")
    static bool SnapActorToGround(AActor* Actor, float StartZOffset = 600.0f, float EndZOffset = 600.0f);
 
    UFUNCTION(BlueprintCallable, Category = "Physics Utilities")
    static bool SnapActorAboveGround(AActor* Actor, float AboveOffset = 50.0f);
 
    UFUNCTION(BlueprintCallable, Category = "Physics Utilities")
    static bool DoesTopPercentageMeshOverlap(AActor* Actor, const UStaticMesh* Mesh, float TopPercentage, ECollisionChannel CollisionChannel);
 
    UFUNCTION(BlueprintCallable, Category = "Physics Utilities")
    static bool HasOverlappingActors(const UStaticMesh* StaticMesh, const FTransform& Transform);
 
    UFUNCTION(BlueprintCallable, Category = "Physics Utilities")
    static TArray<AActor*> FindOverlappingActorsInSphere(const FTransform& ActorTransform, float Radius, bool DebugVisualizeRadius = false);
 
    /*
    * Adjusts the transform's Z position so the actor is placed at the specified height above ground.
    * The incoming Transform.Z is treated as the desired height **in meters** above the terrain.
    * Performs a downward trace to find the ground and sets Z accordingly.
    */
    UFUNCTION(BlueprintCallable, Category = "Physics Utilities")
    static bool AlignTransformFromGroundInMeters(AActor* Actor, FTransform& InTransform);
 
    template<typename T>
    static TArray<T*> FindOverlappingActorsOfClass(const FTransform& ActorTransform, float Radius, bool DebugVisualizeRadius = false);
 
};