mirror of
https://github.com/Eragon-Brisingr/UShaderLab.git
synced 2026-09-15 14:54:36 +00:00
52 lines
2.3 KiB
C++
52 lines
2.3 KiB
C++
// Copyright UShaderLab. All Rights Reserved.
|
|
|
|
#pragma once
|
|
|
|
#include "CoreMinimal.h"
|
|
|
|
class UMaterial;
|
|
struct FShaderLabModel;
|
|
|
|
/**
|
|
* Editor-only builder that turns a parsed FShaderLabModel into a UMaterial expression graph:
|
|
* property parameter nodes + a Custom HLSL node for the Surface body wired into a Substrate
|
|
* Slab BSDF (-> FrontMaterial), plus an optional Vertex Custom node for WPO/displacement/UVs.
|
|
*
|
|
* The build is fully deterministic for a given model (node creation order, input/output order,
|
|
* generated HLSL) so the cook-time and editor-time graphs — and therefore the baked uniform
|
|
* expression set — match.
|
|
*/
|
|
class USHADERLABEDITOR_API FShaderLabGraphBuilder
|
|
{
|
|
public:
|
|
/**
|
|
* Clear `Material`'s expression graph and rebuild it from `Model`, applying settings
|
|
* (domain/blend/two-sided) and updating cached expression data. Does NOT trigger shader
|
|
* compilation — callers decide when to compile. Returns false with diagnostics on failure.
|
|
*/
|
|
static bool BuildInto(UMaterial& Material, const FShaderLabModel& Model, TArray<FString>& OutErrors);
|
|
|
|
/**
|
|
* Replace `Material`'s graph with a minimal Substrate material whose single Custom node emits a
|
|
* `#line`-mapped `#error` for `Diagnostics`, so it deliberately fails to compile with those messages
|
|
* mapped back to `SrcPath` (an absolute, forward-slashed .usl path). This routes .usl parse/build
|
|
* errors through the standard shader-compile path — MIC editor red text, GetCompileErrors, cook —
|
|
* instead of dropping them. The graph itself is always valid; the failure is intentional and happens
|
|
* at shader compile. Does NOT trigger compilation (the caller decides when).
|
|
*/
|
|
static void BuildPoisonInto(UMaterial& Material, const TArray<FString>& Diagnostics, const FString& SrcPath);
|
|
|
|
/**
|
|
* Virtual shader root under which per-shader generated local-code headers live
|
|
* (e.g. "/UShaderLabGen"). The editor module maps it to GetGeneratedShaderDir() at startup.
|
|
*/
|
|
static const TCHAR* GetGeneratedVirtualRoot();
|
|
|
|
/**
|
|
* Absolute disk directory backing GetGeneratedVirtualRoot(): the plugin's
|
|
* `Intermediate/ShaderLabGen`. A build-time artifact only (never staged into a pak); the cooked
|
|
* runtime never builds graphs and skips the mapping. Empty string if the plugin can't be found.
|
|
*/
|
|
static FString GetGeneratedShaderDir();
|
|
};
|