DayNight.h

浏览该文件的文档.

#pragma once
#include "common/Export.h"
 
 
#include "common/Module.h"
#include "common/Result.h"
 
#include <string>
#include <vector>
 
namespace eve::graphics {
class Graphics;
class Light3D;
class ReflectionProbeCapture;
class Volumetric;
}  // namespace eve::graphics
 
namespace eve::daynight {
 
struct PcgManualSunState {
    bool enabled = false;
    float pitchDegrees = 75.f;
    float rotationDegrees = 0.f;
    float intensity = 1.f;
    float red = 1.f;
    float green = 1.f;
    float blue = 1.f;
    float kelvin = 6500.f;
};
 
struct PcgSkyboxState {
    bool enabled = false;
    float rotationDegrees = 0.f;
    float exposure = 1.f;
    float tintRed = 0.f;
    float tintGreen = 0.f;
    float tintBlue = 0.f;
};
 
struct PcgFogState {
    float additionalLinearDistance = 0.f;
    float additionalExponentialDensity = 0.f;
    bool overrideFog = false;
    int mode = 1;
    float red = 0.f, green = 0.f, blue = 0.f;
    float density = 0.01f;
    float startDistance = 100.f;
    float endDistance = 1000.f;
    float globalDensityMultiplier = 1.f;
    bool overrideDensityVolume = false;
    float densityAlbedoRed = 1.f, densityAlbedoGreen = 1.f, densityAlbedoBlue = 1.f;
    float densityVolumeDistance = 250.f;
    int densityVolumeEffect = 1;
    int densityVolumeTiling = 3;
};
 
struct PcgAmbientLightState {
    bool active = false;
    float intensity = 1.f;
    float skyRed = 0.7027151f, skyGreen = 0.881016f, skyBlue = 1.001631f;
    float equatorRed = 0.6302439f, equatorGreen = 0.7919513f, equatorBlue = 0.85f;
    float groundRed = 0.5f, groundGreen = 0.4142857f, groundBlue = 0.3321428f;
    float globalLightMultiplier = 1.f;
};
 
class EVENGINE_API_WORLD DayNight : public Module {
public:
    Module_REG(DayNight);
 
    DayNight();
    ~DayNight() override;
 
    void init(graphics::Graphics *gfx);
    void update(float dt, graphics::Graphics *gfx);
 
    // ---- clock ----
    void setTimeOfDay(float hours);   // 0..24
    float getTimeOfDay() const;
    void setSpeed(float hoursPerRealHour);   // default 1.0
    float getSpeed() const;
    void setPaused(bool paused);
    bool isPaused() const;
    bool isNight() const;
 
    // ---- sun ----
    float getSunElevation() const;
    float getSunAzimuth() const;
    float getSunDirX() const;
    float getSunDirY() const;
    float getSunDirZ() const;
    float getSunIntensity() const;
    float getSunR() const;
    float getSunG() const;
    float getSunB() const;
    [[nodiscard]] Result<void> setPcgManualSun(const PcgManualSunState &state);
    PcgManualSunState getPcgManualSun() const noexcept;
    [[nodiscard]] Result<void> setPcgSkybox(const PcgSkyboxState &state);
    PcgSkyboxState getPcgSkybox() const noexcept;
    [[nodiscard]] Result<void> setPcgFog(const PcgFogState &state);
    PcgFogState getPcgFog() const noexcept;
    [[nodiscard]] Result<void> setPcgAmbientLight(const PcgAmbientLightState &state);
    PcgAmbientLightState getPcgAmbientLight() const noexcept;
 
    // ---- atmosphere ----
    void setTurbidity(float turbidity);
    float getTurbidity() const;
    void setSkyExposure(float exposure);
    float getSkyExposure() const;
    void setMieStrength(float strength);
    float getMieStrength() const;
 
    // ---- sky / ambient (sampled by the scene) ----
    float getSkyR() const;
    float getSkyG() const;
    float getSkyB() const;
    float getAmbientR() const;
    float getAmbientG() const;
    float getAmbientB() const;
    float getAmbientBrightness() const;
 
    void applyAtmosphere(graphics::Volumetric *fog) const;
    void applyReflectionProbeSky(graphics::ReflectionProbeCapture *probe) const;
 
    // ---- weather coupling ----
    void setWeatherInfluence(float cloudiness, float lightningFlash);
    float getWeatherCloudiness() const;
    float getWeatherFlash() const;
 
    // ---- skybox ----
    void setSkyboxEnabled(bool enabled);
    bool isSkyboxEnabled() const;
 
    // ---- night lighting ----
    void setNightLight(const std::string &name, bool enabled);
    bool isNightLight(const std::string &name) const;
    static const char *const kNamedLights[];
    static const int kNamedLightCount;
 
    void setFirePosition(float x, float y, float z);
    void addFirefly(float x, float y, float z);
    void clearFireflies();
    int getFireflyCount() const;
 
private:
    struct Impl;
    Impl *impl_ = nullptr;
};
 
}  // namespace eve::daynight