FrameBuilder.h

#pragma once
 
#include "mc/_HeaderOutputPredefine.h"
 
// auto generated inclusion list
#include "mc/deps/core/checked_resource_service/CheckedResourceService.h"
#include "mc/deps/core/checked_resource_service/ClientResourcePointer.h"
#include "mc/deps/core/file/PathBuffer.h"
#include "mc/deps/core/utility/EnableNonOwnerReferences.h"
#include "mc/deps/minecraft_renderer/framebuilder/AsyncLoadResult.h"
#include "mc/deps/minecraft_renderer/game/FrustumCullerType.h"
#include "mc/deps/minecraft_renderer/game/LevelCullerType.h"
#include "mc/deps/renderer/hal/enums/RenderFeature.h"
#include "mc/external/render_dragon/mesh/IndexSize.h"
#include "mc/external/render_dragon/platform/DebugModeFlags.h"
#include "mc/external/render_dragon/platform/RenderAPI.h"
#include "mc/external/render_dragon/platform/VerticalSync.h"
#include "mc/external/render_dragon/rendering/ClipSpaceDepthMode.h"
#include "mc/external/render_dragon/rendering/LightingModels.h"
#include "mc/external/render_dragon/resources/ServerResourcePointer.h"
#include "mc/external/render_dragon/tasks/DeferredResult.h"
#include "mc/external/render_dragon/texture_streaming/texture_cache/TextureCache.h"
 
// auto generated forward declare list
// clang-format off
struct RangeIndices;
struct RenderChunkDirectIndexData;
struct RenderChunkDirectVertexData;
namespace cg { struct ImageDescription; }
namespace dragon { class ResolvedImageResource; }
namespace dragon { class ResolvedMaterialResource; }
namespace dragon { class ResolvedTextureResource; }
namespace dragon { struct RenderMetadata; }
namespace dragon { struct ResolvedIndexBufferResource; }
namespace dragon { struct ResolvedShaderBufferResource; }
namespace dragon { struct ResolvedVertexBufferResource; }
namespace dragon { struct TextureDescription; }
namespace dragon::materials { class MaterialResourceManager; }
namespace dragon::platform { struct GLTextureWrapper; }
namespace dragon::platform { struct Statistics; }
namespace dragon::rendering { class RayTracingFeatureConfiguration; }
namespace dragon::rendering { class RayTracingResources; }
namespace dragon::rendering { struct SharedTextureHandle; }
namespace dragon::texturestreaming { struct DragonTextureCacheContext; }
namespace mce { struct ClientTexture; }
namespace mce { struct TextureShiftBuffer; }
namespace mce { struct VertexLayout; }
namespace mce::framebuilder { class DynamicResolutionController; }
namespace mce::framebuilder { class FrameBuilderContext; }
namespace mce::framebuilder { class PBRTextureDataManager; }
namespace mce::framebuilder { class RenderingFeatureConfiguration; }
namespace mce::framebuilder { struct BiomeBlendingData; }
namespace mce::framebuilder { struct BlitFlipbookTextureDescription; }
namespace mce::framebuilder { struct BlockChangesDescription; }
namespace mce::framebuilder { struct BufferClearDescription; }
namespace mce::framebuilder { struct CameraDescriptionOrthographic; }
namespace mce::framebuilder { struct CameraDescriptionPerspective; }
namespace mce::framebuilder { struct FadeToBlackDescription; }
namespace mce::framebuilder { struct FrameBuilderInitDependencies; }
namespace mce::framebuilder { struct FrameLightingModelCapabilities; }
namespace mce::framebuilder { struct FullscreenEffectDescription; }
namespace mce::framebuilder { struct LightAmbientDescription; }
namespace mce::framebuilder { struct LightDirectionalDescription; }
namespace mce::framebuilder { struct LightPointDescription; }
namespace mce::framebuilder { struct RenderAtmosphereDescription; }
namespace mce::framebuilder { struct RenderBatchActorDescription; }
namespace mce::framebuilder { struct RenderBlockSelectionOverlayBlockEntityDescription; }
namespace mce::framebuilder { struct RenderCameraAimAssistHighlightDescription; }
namespace mce::framebuilder { struct RenderCelestialBodyDescription; }
namespace mce::framebuilder { struct RenderChunkGeometryDescription; }
namespace mce::framebuilder { struct RenderChunkOccludersDescription; }
namespace mce::framebuilder { struct RenderCloudsDescription; }
namespace mce::framebuilder { struct RenderCrackDescription; }
namespace mce::framebuilder { struct RenderCubemapDescription; }
namespace mce::framebuilder { struct RenderEditorBlockVolumeBoundingBoxDescription; }
namespace mce::framebuilder { struct RenderEditorBlockVolumeOutlineDescription; }
namespace mce::framebuilder { struct RenderEditorGizmoHandleArrowDescription; }
namespace mce::framebuilder { struct RenderEditorGizmoHandleCubeDescription; }
namespace mce::framebuilder { struct RenderEditorGizmoHandlePaneDescription; }
namespace mce::framebuilder { struct RenderEditorSelectionCursorDescription; }
namespace mce::framebuilder { struct RenderEndSkyDescription; }
namespace mce::framebuilder { struct RenderEnvironmentalTextDescription; }
namespace mce::framebuilder { struct RenderFlameBillboardDescription; }
namespace mce::framebuilder { struct RenderItemInHandDescription; }
namespace mce::framebuilder { struct RenderLegacyCubemapDescription; }
namespace mce::framebuilder { struct RenderMeshFallbackDescription; }
namespace mce::framebuilder { struct RenderParticleDescription; }
namespace mce::framebuilder { struct RenderPlayerVisionDescription; }
namespace mce::framebuilder { struct RenderShadowDescription; }
namespace mce::framebuilder { struct RenderSkinnedMeshDescription; }
namespace mce::framebuilder { struct RenderSkyDescription; }
namespace mce::framebuilder { struct RenderStarsDescription; }
namespace mce::framebuilder { struct RenderUIGamefaceDescription; }
namespace mce::framebuilder { struct RenderUIHudIconDescription; }
namespace mce::framebuilder { struct RenderUIImGuiDescription; }
namespace mce::framebuilder { struct RenderUIMeshDescription; }
namespace mce::framebuilder { struct RenderUITextDescription; }
namespace mce::framebuilder { struct RenderVolumetricFogDescription; }
namespace mce::framebuilder { struct RenderWeatherDescription; }
namespace mce::framebuilder { struct ShadowProbeDescription; }
namespace mce::framebuilder { struct SkyAmbientSamplesDescription; }
namespace mce::framebuilder { struct VoxelVolumeDescription; }
namespace mce::framebuilder::bgfxbridge { struct EntityCreationContext; }
namespace mce::framebuilder::gamecomponents { struct EditorHighlightConfiguration; }
namespace mce::framebuilder::gamecomponents { struct GameplayMetadata; }
namespace mce::framebuilder::gamecomponents { struct ServerGraphicsOverrideParameters; }
// clang-format on
 
namespace mce::framebuilder {
 
class FrameBuilder : public ::Bedrock::EnableNonOwnerReferences {
public:
    // FrameBuilder inner types declare
    // clang-format off
    struct FrameTimings;
    class InitializationState;
    // clang-format on
 
    // FrameBuilder inner types define
    struct FrameTimings {
    public:
        // member variables
        // NOLINTBEGIN
        ::ll::TypedStorage<8, 8, double> renderThreadDurationInSeconds;
        ::ll::TypedStorage<8, 8, double> waitUntilCompletedDurationInSeconds;
        ::ll::TypedStorage<8, 8, double> flipTimestampInMilliseconds;
        // NOLINTEND
    };
 
    class InitializationState {
    public:
        // virtual functions
        // NOLINTBEGIN
        virtual ~InitializationState() = default;
        // NOLINTEND
    };
 
    using InitializationStatePointer = ::std::shared_ptr<::mce::framebuilder::FrameBuilder::InitializationState>;
 
public:
    // virtual functions
    // NOLINTBEGIN
    virtual ~FrameBuilder() /*override*/ = default;
 
    virtual bool enabled() const = 0;
 
    virtual ::std::optional<::dragon::platform::Statistics> getStatistics() = 0;
 
    virtual double getAverageGPUTime() const = 0;
 
    virtual void resetGPUTimeData() = 0;
 
    virtual bool supportsRenderFeature(::mce::RenderFeature const feature) const = 0;
 
    virtual ::mce::framebuilder::FrameBuilder::FrameTimings getLastFrameTimings() const = 0;
 
    virtual ::std::weak_ptr<::mce::framebuilder::DynamicResolutionController> getDynamicResolutionController() = 0;
 
    virtual bool isDeviceRemoved();
 
    virtual ::std::optional<::std::shared_ptr<::mce::framebuilder::FrameBuilder::InitializationState>>
    init(::mce::framebuilder::FrameBuilderInitDependencies&& deps) = 0;
 
    virtual ::std::optional<::std::shared_ptr<::mce::framebuilder::FrameBuilder::InitializationState>>
    continueInit(::std::shared_ptr<::mce::framebuilder::FrameBuilder::InitializationState> state) = 0;
 
    virtual bool initialized() const = 0;
 
    virtual void destroy() = 0;
 
    virtual void loadCoreAssets(
        ::Core::PathBuffer<::std::string> const&                                   dataDirectory,
        ::std::function<::std::string(::std::string const&, ::std::string const&)> loadFileDataCallback
    ) = 0;
 
    virtual ::mce::framebuilder::AsyncLoadResult loadAsyncAssets() = 0;
 
    virtual void startFrame() = 0;
 
    virtual void endFrame(::mce::framebuilder::FrameBuilderContext&& frameBuilderContext) = 0;
 
    virtual void discardFrame(bool wait) = 0;
 
    virtual void setTerrainAtlasTexture(::mce::ClientTexture const& texture) = 0;
 
    virtual void setDefaultActorMERSUniforms(
        float const metalnessUniform,
        float const emissiveUniform,
        float const roughnessUniform,
        float const subsurfaceUniform
    ) = 0;
 
    virtual void setDefaultParticleMERSUniforms(
        float const metalnessUniform,
        float const emissiveUniform,
        float const roughnessUniform,
        float const subsurfaceUniform
    ) = 0;
 
    virtual void setBiomeBlendingData(::mce::framebuilder::BiomeBlendingData const& biomeBlendingData) = 0;
 
    virtual void updateSurfaceParameters(::std::variant<::HWND__*, ::std::monostate> const& surfaceParams) = 0;
 
    virtual void updateWindowSize(uint const width, uint const height) = 0;
 
    virtual void updateClientViewSize(::glm::vec2 const& clientViewSize) = 0;
 
    virtual bool updateMsaaLevel(uchar const level) = 0;
 
    virtual void updateFrameRateLimit(::std::optional<int> const frameRate) = 0;
 
    virtual void updateVSync(::dragon::platform::VerticalSync verticalSync) = 0;
 
    virtual void updateFramePacing(bool enabled) = 0;
 
    virtual bool enableDynamicTextureHandles() = 0;
 
    virtual void setDebugMode(::dragon::platform::DebugModeFlags debugFlags) = 0;
 
    virtual void suspend() = 0;
 
    virtual void resume() = 0;
 
    virtual ::dragon::tasks::DeferredResult<::dragon::rendering::SharedTextureHandle> createExternalTexture(
        ::std::optional<::std::variant<::std::monostate, ::dragon::platform::GLTextureWrapper>> nativeTexture
    ) = 0;
 
    virtual void updateExternalTexture(
        ::dragon::tasks::DeferredResult<::dragon::rendering::SharedTextureHandle>               texture,
        ::std::optional<::std::variant<::std::monostate, ::dragon::platform::GLTextureWrapper>> nativeTexture,
        ::std::function<void(::dragon::rendering::SharedTextureHandle)> rendererCallbackUpdateDelegate
    ) = 0;
 
    virtual ::mce::ServerResourcePointer<::dragon::ResolvedTextureResource> wrapExternalTexture(
        ::dragon::platform::RenderAPI       api,
        ::dragon::TextureDescription const& desc,
        void*                               externalTexture
    ) = 0;
 
    virtual void createRenderChunk(::dragon::RenderMetadata const& renderMetadata) = 0;
 
    virtual void destroyRenderChunk(::dragon::RenderMetadata const& renderMetadata) = 0;
 
    virtual void generateRenderChunkVertexData(
        ::RenderChunkDirectVertexData&          renderChunkDirectVertexData,
        ::std::array<::RangeIndices, 24> const& layerRanges,
        ::gsl::span<uchar const> const&         chunkData,
        uint64 const&                           vertexCount,
        ::mce::VertexLayout const&              mceLayout,
        int const*                              absoluteBlockPosition
    ) = 0;
 
    virtual void generateRenderChunkIndexData(
        ::RenderChunkDirectIndexData&           renderChunkDirectIndexData,
        ::std::array<::RangeIndices, 24> const& layerRanges,
        ::gsl::span<uchar const> const&         indexData,
        ::dragon::mesh::IndexSize const         indexSize
    ) = 0;
 
    virtual void freeRenderChunkVertexData(::RenderChunkDirectVertexData& renderChunkDirectVertexData) = 0;
 
    virtual void freeRenderChunkIndexData(::RenderChunkDirectIndexData& renderChunkDirectIndexData) = 0;
 
    virtual void debugPrintToScreen(::std::function<void(char const*)> printFunction) = 0;
 
    virtual void debugDeclareSceneCamera(
        ::mce::framebuilder::CameraDescriptionPerspective const& cameraDescription,
        ::mce::framebuilder::BufferClearDescription const&       bufferClearDescription
    ) = 0;
 
    virtual void debugDeclareSceneCamera(
        ::mce::framebuilder::CameraDescriptionOrthographic const& cameraDescription,
        ::mce::framebuilder::BufferClearDescription const&        bufferClearDescription
    ) = 0;
 
    virtual ::glm::vec3 getSunDir() const = 0;
 
    virtual void setSunDir(::glm::vec3 const& sunDir) = 0;
 
    virtual ::dragon::rendering::ClipSpaceDepthMode getClipSpace() const = 0;
 
    virtual ::mce::CheckedResourceService<::dragon::ResolvedVertexBufferResource>* getVertexBufferResourceService() = 0;
 
    virtual ::mce::CheckedResourceService<::dragon::ResolvedIndexBufferResource>* getIndexBufferResourceService() = 0;
 
    virtual ::mce::CheckedResourceService<::dragon::ResolvedShaderBufferResource>* getShaderBufferResourceService() = 0;
 
    virtual ::mce::CheckedResourceService<::dragon::ResolvedMaterialResource>* getMaterialResourceService() = 0;
 
    virtual void initializeTextureCache() = 0;
 
    virtual void initializeTextureStreamer() = 0;
 
    virtual bool isTextureStreamingEnabled() const = 0;
 
    virtual ::std::shared_ptr<
        ::dragon::texturestreaming::TextureCache<::dragon::texturestreaming::DragonTextureCacheContext>>
    getTextureCache() = 0;
 
    virtual ::std::monostate getTextureStreamingDebugControl() = 0;
 
    virtual ::dragon::materials::MaterialResourceManager* getMaterialResourceManager() = 0;
 
    virtual ::mce::framebuilder::FrameLightingModelCapabilities getFrameLightingModelCapabilities() const = 0;
 
    virtual bool isRayTracingCapable() const = 0;
 
    virtual bool isRayTracingEnabled() const = 0;
 
    virtual bool isDeferredCapable() const = 0;
 
    virtual bool isDeferredEnabled() const = 0;
 
    virtual bool isVSyncEnabled_DEPRECATED() const = 0;
 
    virtual bool isFrameDiscardWhileRenderingCapable() const = 0;
 
    virtual bool isFrameDiscardWhileRenderingEnabled() const = 0;
 
    virtual ::std::shared_ptr<::dragon::rendering::RayTracingResources> const getRayTracingResources() const = 0;
 
    virtual ::std::shared_ptr<::dragon::rendering::RayTracingResources> getRayTracingResources() = 0;
 
    virtual ::std::shared_ptr<::dragon::rendering::RayTracingFeatureConfiguration> const
    getRayTracingFeatureConfiguration() const = 0;
 
    virtual ::std::shared_ptr<::dragon::rendering::RayTracingFeatureConfiguration>
    getRayTracingFeatureConfiguration() = 0;
 
    virtual ::std::shared_ptr<::mce::framebuilder::RenderingFeatureConfiguration> const
    getRenderingFeatureConfiguration() const = 0;
 
    virtual ::std::shared_ptr<::mce::framebuilder::RenderingFeatureConfiguration>
    getRenderingFeatureConfiguration() = 0;
 
    virtual void setLightingModel(::dragon::rendering::LightingModels lightingModel, bool& modified) = 0;
 
    virtual ::glm::vec<2, ushort> getRenderResolution() const = 0;
 
    virtual ::std::vector<::dragon::platform::RenderAPI> getSupportedRenderers() const = 0;
 
    virtual bool isUpscalingAvailable() const = 0;
 
    virtual void setUpscaling(bool upscale) = 0;
 
    virtual bool isUpscalingEnabled() const = 0;
 
    virtual float getUpscalingFactor() const = 0;
 
    virtual ::std::string_view const getUpscalingInfo() const = 0;
 
    virtual void custom(
        ::std::function<void(::mce::framebuilder::bgfxbridge::EntityCreationContext const&)> const& insertCallback
    ) = 0;
 
    virtual void queuePreFrameTask(::std::function<void()> const& task) = 0;
 
    virtual ::LevelCullerType getLevelCullerType() const = 0;
 
    virtual ::LevelCullerType getShadowLevelCullerType() const = 0;
 
    virtual ::FrustumCullerType getFrustumCullerType() const = 0;
 
    virtual void clearRenderingResourcesCache() = 0;
 
    virtual void updatePBRData(::mce::framebuilder::PBRTextureDataManager& pbrTextureDataManager) = 0;
 
    virtual void updateTextureShiftData(::std::vector<::mce::TextureShiftBuffer> const& shiftBuffers) = 0;
 
    virtual bool shouldRenderPersistentUI(uint64 viewCount) const = 0;
 
    virtual bool shouldFlipTextureOrigin() const = 0;
 
    virtual uint getMaxVertexCount() const = 0;
 
    virtual void queueMaterialReload() = 0;
 
    virtual void registerWindowHandle(
        ::std::variant<::HWND__*, ::std::monostate> const& windowHandle,
        ushort const                                       viewId,
        int const                                          width,
        int const                                          height
    ) = 0;
 
    virtual void unregisterWindowHandle(ushort const viewId) = 0;
 
    virtual ::std::string getGraphicsCapabilitiesJsonString() = 0;
 
    virtual bool hasGpuTimerSupport() const = 0;
 
    virtual ::mce::ClientResourcePointer<::dragon::ResolvedImageResource>
    readBackTexture(::cg::ImageDescription const& destinationImageDescription, ::std::string const& name) = 0;
 
    virtual ::mce::CheckedResourceService<::dragon::ResolvedTextureResource>* _getTextureResourceService() = 0;
 
    virtual void _insert(
        ::std::variant<
            ::std::reference_wrapper<::mce::framebuilder::LightAmbientDescription const>,
            ::std::reference_wrapper<::mce::framebuilder::LightDirectionalDescription const>,
            ::std::reference_wrapper<::mce::framebuilder::gamecomponents::GameplayMetadata const>,
            ::std::reference_wrapper<::mce::framebuilder::LightPointDescription const>,
            ::std::reference_wrapper<::mce::framebuilder::ShadowProbeDescription const>,
            ::std::reference_wrapper<::mce::framebuilder::gamecomponents::ServerGraphicsOverrideParameters const>,
            ::std::reference_wrapper<::mce::framebuilder::VoxelVolumeDescription const>> description
    ) = 0;
 
    virtual void _insert(
        ::std::variant<
            ::std::reference_wrapper<::mce::framebuilder::RenderEnvironmentalTextDescription const>,
            ::std::reference_wrapper<::mce::framebuilder::RenderMeshFallbackDescription const>,
            ::std::reference_wrapper<::mce::framebuilder::RenderChunkGeometryDescription const>,
            ::std::reference_wrapper<::mce::framebuilder::RenderChunkOccludersDescription const>,
            ::std::reference_wrapper<::mce::framebuilder::RenderCrackDescription const>,
            ::std::reference_wrapper<::mce::framebuilder::RenderItemInHandDescription const>,
            ::std::reference_wrapper<::mce::framebuilder::RenderSkinnedMeshDescription const>,
            ::std::reference_wrapper<::mce::framebuilder::RenderBlockSelectionOverlayBlockEntityDescription const>,
            ::std::reference_wrapper<::mce::framebuilder::BlockChangesDescription const>,
            ::std::reference_wrapper<::mce::framebuilder::RenderBatchActorDescription const>> description
    ) = 0;
 
    virtual void _insert(
        ::std::variant<
            ::std::reference_wrapper<::mce::framebuilder::RenderAtmosphereDescription const>,
            ::std::reference_wrapper<::mce::framebuilder::RenderCloudsDescription const>,
            ::std::reference_wrapper<::mce::framebuilder::RenderCubemapDescription const>,
            ::std::reference_wrapper<::mce::framebuilder::RenderEndSkyDescription const>,
            ::std::reference_wrapper<::mce::framebuilder::RenderLegacyCubemapDescription const>,
            ::std::reference_wrapper<::mce::framebuilder::RenderSkyDescription const>,
            ::std::reference_wrapper<::mce::framebuilder::RenderStarsDescription const>,
            ::std::reference_wrapper<::mce::framebuilder::RenderCelestialBodyDescription const>,
            ::std::reference_wrapper<::mce::framebuilder::RenderVolumetricFogDescription const>,
            ::std::reference_wrapper<::mce::framebuilder::RenderWeatherDescription const>,
            ::std::reference_wrapper<::mce::framebuilder::SkyAmbientSamplesDescription const>> description
    ) = 0;
 
    virtual void _insert(
        ::std::variant<
            ::std::reference_wrapper<::mce::framebuilder::RenderUIGamefaceDescription const>,
            ::std::reference_wrapper<::mce::framebuilder::RenderUIHudIconDescription const>,
            ::std::reference_wrapper<::mce::framebuilder::RenderUIMeshDescription const>,
            ::std::reference_wrapper<::mce::framebuilder::RenderUITextDescription const>,
            ::std::reference_wrapper<::mce::framebuilder::RenderUIImGuiDescription const>> description
    ) = 0;
 
    virtual void _insert(
        ::std::variant<
            ::std::reference_wrapper<::mce::framebuilder::RenderFlameBillboardDescription const>,
            ::std::reference_wrapper<::mce::framebuilder::BlitFlipbookTextureDescription const>,
            ::std::reference_wrapper<::mce::framebuilder::RenderParticleDescription const>,
            ::std::reference_wrapper<::mce::framebuilder::RenderPlayerVisionDescription const>,
            ::std::reference_wrapper<::mce::framebuilder::RenderShadowDescription const>,
            ::std::reference_wrapper<::mce::framebuilder::FadeToBlackDescription const>,
            ::std::reference_wrapper<::mce::framebuilder::RenderCameraAimAssistHighlightDescription const>,
            ::std::reference_wrapper<::mce::framebuilder::FullscreenEffectDescription const>,
            ::std::reference_wrapper<::mce::framebuilder::gamecomponents::EditorHighlightConfiguration const>>
            description
    ) = 0;
 
    virtual void _insert(
        ::std::variant<
            ::std::reference_wrapper<::mce::framebuilder::RenderEditorBlockVolumeBoundingBoxDescription const>,
            ::std::reference_wrapper<::mce::framebuilder::RenderEditorGizmoHandleArrowDescription const>,
            ::std::reference_wrapper<::mce::framebuilder::RenderEditorGizmoHandleCubeDescription const>,
            ::std::reference_wrapper<::mce::framebuilder::RenderEditorGizmoHandlePaneDescription const>,
            ::std::reference_wrapper<::mce::framebuilder::RenderEditorSelectionCursorDescription const>,
            ::std::reference_wrapper<::mce::framebuilder::RenderEditorBlockVolumeOutlineDescription const>> description
    ) = 0;
 
    virtual void _initiateTDR() = 0;
    // NOLINTEND
 
public:
    // virtual function thunks
    // NOLINTBEGIN
 
    // NOLINTEND
};
 
} // namespace mce::framebuilder