MagentaDolphin
e04f4dac78
Measured figures are kept; only the studio-specific level and asset names are generalised, and the Perforce rationale is reworded to describe the class of setups rather than this one project. Co-Authored-By: Claude Code <noreply@anthropic.com>
62 lines
2.4 KiB
C++
62 lines
2.4 KiB
C++
// MagentaDolphin 2026. Asset Usage Audit.
|
|
|
|
#pragma once
|
|
|
|
#include "CoreMinimal.h"
|
|
#include "Kismet/BlueprintFunctionLibrary.h"
|
|
#include "AssetUsageAuditLibrary.generated.h"
|
|
|
|
/**
|
|
* Blueprint and Python entry points for the audit.
|
|
*
|
|
* Phase 1 uses these as the only way to run the analysis, before the Slate panel exists. They
|
|
* remain useful afterwards: a TA can script a one-off audit from an Editor Utility Widget without
|
|
* touching the main tool, and the same calls drive the Python bridge.
|
|
*
|
|
* These are thin wrappers. All logic lives in AssetUsageAuditCore so that the panel, these
|
|
* functions and a future commandlet cannot drift apart.
|
|
*/
|
|
UCLASS()
|
|
class ASSETUSAGEAUDITEDITOR_API UAssetUsageAuditLibrary : public UBlueprintFunctionLibrary
|
|
{
|
|
GENERATED_BODY()
|
|
|
|
public:
|
|
/**
|
|
* Run a full audit and write JSON + CSV reports.
|
|
*
|
|
* @param LevelPackageNames Levels to analyse, e.g. "/Game/Maps/WP_Example". Empty means all.
|
|
* @param OutputDirectory Destination. Empty uses the configured default.
|
|
* @param OutReportPath Absolute path of the JSON report on success.
|
|
* @return true when both reports were written.
|
|
*/
|
|
UFUNCTION(BlueprintCallable, Category = "Asset Usage Audit", meta = (AutoCreateRefTerm = "LevelPackageNames"))
|
|
static bool RunAudit(const TArray<FString>& LevelPackageNames, const FString& OutputDirectory, FString& OutReportPath);
|
|
|
|
/**
|
|
* Assets reachable from one level, resolved transitively through Blueprints and other assets.
|
|
*
|
|
* This is the question the tool exists to answer, exposed on its own for scripting.
|
|
*/
|
|
UFUNCTION(BlueprintCallable, Category = "Asset Usage Audit")
|
|
static TArray<FString> GetAssetsUsedOnLevel(const FString& LevelPackageName);
|
|
|
|
/**
|
|
* Levels that use the given asset.
|
|
*
|
|
* Includes both a sublevel and its parent map when the asset sits in a sublevel, because the
|
|
* parent's traversal reaches through ULevelStreaming::WorldAsset.
|
|
*/
|
|
UFUNCTION(BlueprintCallable, Category = "Asset Usage Audit")
|
|
static TArray<FString> GetLevelsUsingAsset(const FString& AssetPackageName);
|
|
|
|
/**
|
|
* Time a full sweep and log the breakdown.
|
|
*
|
|
* Exists to answer the open question in the plan: whether an in-memory graph cache is needed
|
|
* at all. Measure before adding one.
|
|
*/
|
|
UFUNCTION(BlueprintCallable, Category = "Asset Usage Audit")
|
|
static float MeasureFullSweepSeconds();
|
|
};
|