![]() |
VR-Forces 4.8 Class Documentation
|
The DtEnvironment configures the environmental effects for a scene. More...

Public Member Functions | |
| DtEnvironment (DtDe &de) | |
| CTOR. More... | |
| virtual | ~DtEnvironment () |
| Virtual DTOR. More... | |
| virtual void | init () |
| Initialize the Environment object (like preloading all known cloud layers) before the first environment record is loaded. More... | |
| virtual void | getRecord (makArchives::DtEnvironmentRecord &record) |
| Put the current environment conditions into a record. More... | |
| virtual void | setFromRecord (const makArchives::DtEnvironmentRecord &record) |
| Set the current environment conditions from a record. More... | |
| virtual makArchives::DtEnvironmentRecord | environmentConditionRecord (const std::string &) |
| Returns the environment record for the environment condition name. More... | |
| virtual float | lightLevel () const |
| Get the current prevailing ambient light value Allows thing to be activated/deactivated by light level; values gp from 0. More... | |
| const DtSettingsBackup * | settingsBackup () const |
| DtSettingsBackup * | settingsBackup () |
| virtual bool | getIsUnderwater () const |
| Water visibility when below water. More... | |
| virtual bool | isOverWater (const DtVector &localPosition, bool isVisible=true) |
| Returns whether we are currently over water. More... | |
| virtual float | getMaximumWaveHeight () |
| Returns maximum wave height just based on the sea state. More... | |
| virtual float | seaLevel () const |
| Returns the current sea level. More... | |
| virtual void | setOceanManager (DtOceanStateInterface *oceanManager) |
| Set the current ocean manager which fulfills the DtOceanManagerInterface. More... | |
| virtual void | deleteOceanManager () |
| Use to get rid of the current (usually default) ocean manager. More... | |
| virtual void | initializeEnvironmentSettings () |
| Initialize environment settings (cloud cover and settings from default record) More... | |
| virtual void | saveEnvironment (const std::string &name) |
| virtual void | setEnvironment (const std::string &name) |
| Set the current environment to the environment of the given name. More... | |
| virtual void | removeEnvironment (const std::string &name) |
| Remove an environment with the given name. More... | |
| virtual void | renameEnvironment (const std::string &oldName, const std::string &newName) |
| Rename an environment entry. More... | |
| virtual void | getEnvironmentNames (std::vector< std::string > &names) |
| Get the names of all the environment conditions. More... | |
| virtual void | setDefaultEnvironmentName (const std::string &name) |
| Set the name of the default environment conditions. More... | |
| virtual std::string | defaultEnvironmentName () const |
| Get the name of the default environment conditions. More... | |
| virtual void | setCloudCover (makArchives::DtCloudCoverType cloudCover) |
| Set / get which cloud cover to use. More... | |
| virtual makArchives::DtCloudCoverType | cloudCover () const |
| virtual void | setAirTurbidity (float turbidity) |
| Set / get the air turbidity (haziness) More... | |
| virtual float | airTurbidity () const |
| virtual void | setVisibleDistance (float distance) |
| Set / get the visible distance in meters. More... | |
| virtual float | visibleDistance () const |
| virtual void | setPrecipitationType (PrecipitationType type) |
| Set / get the precipitation type. More... | |
| virtual PrecipitationType | precipitationType () const |
| virtual void | setPrecipitationIntensity (float intensity) |
| Set / get the precipitation intensity. More... | |
| virtual float | precipitationIntensity () const |
| virtual void | setWindSpeed (float speed) |
| Set / get the wind speed in meters per second. More... | |
| virtual float | windSpeed () const |
| virtual void | setWindDirection (float direction) |
| Set / get the wind direction in radians from north (clockwise). More... | |
| virtual float | windDirection () const |
| virtual void | setAmbientAirTemperature (float temperature) |
| Set / get the ambient air temperature in Celsius. More... | |
| virtual float | ambientAirTemperature () const |
| virtual void | setFogHeight (float height) |
| Set / get the fog ceiling height in meters. More... | |
| virtual float | fogHeight () const |
| virtual void | setFogColor (const DtVector &color) |
| Set / get the fog color in normalized color components. More... | |
| virtual DtVector | fogColor () const |
| virtual void | setSeaState (int state) |
| Set / get the sea state according to the Beaufort Scale. More... | |
| virtual int | seaState () const |
| virtual void | setSeaStateDirection (float dir) |
| Set / get the sea state direction in radians from north. More... | |
| virtual float | seaStateDirection () const |
| virtual void | setWindDrivenSeaState (bool enabled) |
| Set / get if sea state is wind driven or manually driven. More... | |
| virtual bool | windDrivenSeaState () const |
| virtual void | setSwellState (int state) |
| Set / get the sea-swell state according to the Douglas Scale. More... | |
| virtual int | swellState () const |
| virtual void | setSwellStateDirection (float dir) |
| Set / get the sea-swell state direction in radians from north. More... | |
| virtual float | swellStateDirection () const |
| virtual void | setWindFetch (float distance) |
| Set / get the ocean fetch. More... | |
| virtual float | windFetch () const |
| virtual void | setSeaChoppiness (float chop) |
| Set / get the amount of chop on the sea. More... | |
| virtual float | seaChoppiness () const |
| void | setUnderwaterVisibilityEnabled (bool enabled) |
| bool | underwaterVisibilityEnabled () const |
| virtual void | setUnderwaterVisibility (float distance) |
| Set / get the maximum visibility under water in meters. More... | |
| virtual float | underwaterVisibility () const |
| virtual void | setWaterSurfaceTransparency (float normalizedValue) |
| Set / get the transparency value of water surface. More... | |
| virtual float | waterSurfaceTransparency () const |
| virtual void | setSurgeDepth (float meters) |
| Set / Get the surge depth in distance. More... | |
| virtual float | surgeDepth () const |
| virtual void | setDepthOffset (float meters) |
| Set / Get the depth offset in distance. More... | |
| virtual float | depthOffset () const |
| virtual void | setAmbientWaterTemperature (float temperature) |
| Set / get the ambient water temperature in celsius. More... | |
| virtual float | ambientWaterTemperature () const |
| virtual void | setWaterCurrentSpeed (float speed) |
| Set / get the speed of water currents in meters per second. More... | |
| virtual float | waterCurrentSpeed () const |
| virtual void | setWaterCurrentDirection (float direction) |
| Set / get the direction of water currents in radians from north (clockwise). More... | |
| virtual float | waterCurrentDirection () const |
| virtual void | setTidalOffset (float meters) |
| Set / get the current tidal offset from mean-sea-level in meters. More... | |
| virtual float | tidalOffset () const |
| virtual void | setTidalDirection (bool inOut) |
| Set / get the current direction of tidal flow (0=out, 1=in). More... | |
| virtual bool | tidalDirection () const |
| virtual void | setThermoclineDepth (unsigned int layer, float depth) |
| Set / get the thermocline depths. More... | |
| virtual float | thermoclineDepth (unsigned int layer) const |
| virtual void | setThermoclinePermeability (unsigned int layer, float permeability) |
| Set / get the thermocline permeability. More... | |
| virtual float | thermoclinePermeability (unsigned int layer) const |
| virtual void | setGroundSnowAccumulation (float depth) |
| Set / get the ground snow accumulation depth. More... | |
| virtual float | groundSnowAccumulation () const |
| virtual void | setRoadSnowAccumulation (float depth) |
| Set / get the road snow accumulation depth. More... | |
| virtual float | roadSnowAccumulation () const |
| virtual void | setSnowMinimumElevation (float elevation) |
| Set / get the snow minimum elevation. More... | |
| virtual float | snowMinimumElevation () const |
| virtual void | setSnowElevationTransition (float elevation) |
| virtual float | snowElevationTransition () const |
| virtual void | setGroundRainAccumulation (float depth) |
| Set / get the ground rain accumulation depth. More... | |
| virtual float | groundRainAccumulation () const |
| void | loadDefaults (bool loadOnlyFactorySettings=false) |
| void | restore () |
| Restores to backup settings from startup default. More... | |
| void | saveAsDefaults () |
| Save the current settings as the default settings. More... | |
| virtual void | exportSettings (const std::string &filename) |
| Import / export the list of named conditions (.enlx file) More... | |
| virtual void | importSettings (const std::string &filename) |
Public Member Functions inherited from makVrv::DtEnvironmentInterface | |
| DtEnvironmentInterface () | |
| CTOR. More... | |
| virtual | ~DtEnvironmentInterface () |
| Virtual DTOR. More... | |
Protected Types | |
| typedef std::vector< DtCloudLayer > | CloudLayersVector |
Protected Member Functions | |
| virtual void | clearCloudsFromSky () |
| Pre-load all the cloud layers and send them to the sky object. More... | |
| virtual void | resetClouds () |
| virtual void | sendToSkyAllCloudLayers () |
| virtual void | sendToSkyCloudLayerAdded (DtCloudLayerId layerId) |
| virtual void | sendToSkyCloudLayerEnabled (DtCloudLayerId layerId, bool enabled) |
| virtual void | sendToSkyCloudLayerRemoved (DtCloudLayerId layerId) |
| virtual void | sendToSkyCloudLayerModified (DtCloudLayerId layerId) |
| DtDe & | myDe |
| DtAgentManagerInterface & | mySceneInterface |
| DtSkyObjectAgent * | mySkyObject |
| DtDynamicOceanObjectAgent * | myDynamicOceanObject |
| DtWeatherEffectsObjectAgent * | myWeatherEffectsObject |
| DtRecordSettingsBackupInterface * | mySettingsBackup |
| DtSignalConnectionManager | myConnections |
| makArchives::DtEnvironmentRecord | myCurrentSettings |
| DtEnvironmentList | myEnvironmentList |
| DtOceanStateInterface * | myOceanManager |
| virtual void | slot_cloudCoverReset () |
| Slots connected to the Sky Conditions Manager. More... | |
| virtual void | slot_cloudCoverCloudCoverToBeRemoved (makArchives::DtCloudCoverType coverType) |
| virtual void | slot_cloudCoverCloudLayerEnabledChanged (DtCloudLayerId layerId, bool enableState) |
| virtual void | slot_cloudCoverCloudLayerModified (DtCloudLayerId layerId) |
| virtual void | slot_cloudCoverCloudLayerPositionAndOrientationChanged (DtCloudLayerId layerId, const DtVector &position, float orientation) |
| virtual void | slot_cloudCoverCloudLayerAdded (DtCloudLayerId layerId) |
| virtual void | slot_cloudCoverCloudLayerToBeRemoved (DtCloudLayerId layerId) |
| virtual void | slot_coordinateSystemChanged () |
| Called when the current coordinate system changes. More... | |
| virtual void | slot_oceanLayerAdded (const DtOceanLayer &layer) |
| Called by signal when an ocean layer is added. More... | |
| virtual void | slot_oceanLayerToBeDeleted (const DtOceanLayer &layer) |
| Called by signal when an ocean layer is about to be removed. More... | |
| virtual void | slot_oceanLayerSeaLevelChanged (const DtOceanLayer &layer, double seaLevel) |
| Called by signal when an ocean layer's sea level changes. More... | |
| virtual void | slot_oceanLayerLodRangeChanged (const DtOceanLayer &layer, int range) |
| Called by signal when an ocean layer's lod range (the altitude at which we LOD out dynamic ocean) changes. More... | |
| virtual void | slot_surgeDepthChanged (double depth) |
| Called by signal when the surge depth changes. More... | |
| virtual void | slot_depthOffsetChanged (double offset) |
| Called by signal when the depth offset changes. More... | |
| virtual void | updateEnvironment () |
| Update the environment settings for the current environment. More... | |
| virtual void | initializeOcean () |
| Initialize the (distributed) dynamic ocean object with the current environmental values. More... | |
| virtual void | enableCurrentCloudCoverLayers () |
| enables selected cloud cover More... | |
| virtual void | disableCurrentCloudCoverLayers () |
| virtual void | autoSave () |
| virtual void | sendMarineEnvironmentToOceanObject () |
| Helper function to set the appropriate marine environment on a dynamic ocean object. More... | |
| virtual void | sendWeatherEnvironmentToSkyObject () |
| Helper function to set the appropriate weather environment on a sky object. More... | |
Additional Inherited Members | |
Public Types inherited from makVrv::DtEnvironmentInterface | |
| enum | PrecipitationType { None = DtSkyObject::None, Rain = DtSkyObject::Rain, Snow = DtSkyObject::SnowWet, Hail = DtSkyObject::Hail } |
The DtEnvironment configures the environmental effects for a scene.
Environmental effects include clouds, precipitation, air turbidity, ambient air temperature and visibility
|
protected |
| makVrv::DtEnvironment::DtEnvironment | ( | DtDe & | de | ) |
CTOR.
|
virtual |
Virtual DTOR.
|
virtual |
Initialize the Environment object (like preloading all known cloud layers) before the first environment record is loaded.
|
virtual |
Put the current environment conditions into a record.
| [out] | record | is the record to be populated with data. |
Implements makVrv::DtEnvironmentInterface.
|
virtual |
Set the current environment conditions from a record.
| [in] | record | is the record to read the data from. |
Implements makVrv::DtEnvironmentInterface.
|
virtual |
Returns the environment record for the environment condition name.
|
virtual |
Save the current environment with the given name.
| [in] | name | is the name of the environment to save. |
Implements makVrv::DtEnvironmentInterface.
|
virtual |
Set the current environment to the environment of the given name.
| [in] | name | is the name of the environment to set. |
Implements makVrv::DtEnvironmentInterface.
|
virtual |
Remove an environment with the given name.
| [in] | name | is the name of the environment to remove. |
Implements makVrv::DtEnvironmentInterface.
|
virtual |
Rename an environment entry.
Implements makVrv::DtEnvironmentInterface.
|
virtual |
Get the names of all the environment conditions.
Implements makVrv::DtEnvironmentInterface.
Referenced by makVrf::DtDisabledEnvironment::getEnvironmentNames().
|
virtual |
Set the name of the default environment conditions.
| [in] | name | is the name of the default environment. |
Implements makVrv::DtEnvironmentInterface.
|
virtual |
Get the name of the default environment conditions.
Implements makVrv::DtEnvironmentInterface.
|
virtual |
Set / get which cloud cover to use.
This chooses one of the NOAA-defined cloud conditions. cloudCover is one of: DtCloudCoverTypeClear DtCloudCoverTypeMostlyClear DtCloudCoverTypeCloudy DtCloudCoverTypePartlyCloudy DtCloudCoverTypeMostlyCloudy DtCloudCoverTypeOvercast DtCloudCoverTypeThunderstorm
Implements makVrv::DtEnvironmentInterface.
|
virtual |
Implements makVrv::DtEnvironmentInterface.
|
virtual |
Set / get the air turbidity (haziness)
Implements makVrv::DtEnvironmentInterface.
|
virtual |
Implements makVrv::DtEnvironmentInterface.
|
virtual |
Set / get the visible distance in meters.
Implements makVrv::DtEnvironmentInterface.
|
virtual |
Implements makVrv::DtEnvironmentInterface.
|
virtual |
Set / get the precipitation type.
Implements makVrv::DtEnvironmentInterface.
|
virtual |
Implements makVrv::DtEnvironmentInterface.
|
virtual |
Set / get the precipitation intensity.
Implements makVrv::DtEnvironmentInterface.
|
virtual |
Implements makVrv::DtEnvironmentInterface.
|
virtual |
Set / get the wind speed in meters per second.
Implements makVrv::DtEnvironmentInterface.
|
virtual |
Implements makVrv::DtEnvironmentInterface.
|
virtual |
Set / get the wind direction in radians from north (clockwise).
Implements makVrv::DtEnvironmentInterface.
|
virtual |
Implements makVrv::DtEnvironmentInterface.
|
virtual |
Set / get the ambient air temperature in Celsius.
Implements makVrv::DtEnvironmentInterface.
|
virtual |
Implements makVrv::DtEnvironmentInterface.
|
virtual |
Set / get the fog ceiling height in meters.
Implements makVrv::DtEnvironmentInterface.
|
virtual |
Implements makVrv::DtEnvironmentInterface.
|
virtual |
Set / get the fog color in normalized color components.
Implements makVrv::DtEnvironmentInterface.
|
virtual |
Implements makVrv::DtEnvironmentInterface.
|
virtual |
Set / get the sea state according to the Beaufort Scale.
Implements makVrv::DtEnvironmentInterface.
|
virtual |
Implements makVrv::DtEnvironmentInterface.
|
virtual |
Set / get the sea state direction in radians from north.
Implements makVrv::DtEnvironmentInterface.
|
virtual |
Implements makVrv::DtEnvironmentInterface.
|
virtual |
Set / get if sea state is wind driven or manually driven.
Implements makVrv::DtEnvironmentInterface.
|
virtual |
Implements makVrv::DtEnvironmentInterface.
|
virtual |
Set / get the sea-swell state according to the Douglas Scale.
Implements makVrv::DtEnvironmentInterface.
|
virtual |
Implements makVrv::DtEnvironmentInterface.
|
virtual |
Set / get the sea-swell state direction in radians from north.
Implements makVrv::DtEnvironmentInterface.
|
virtual |
Implements makVrv::DtEnvironmentInterface.
|
virtual |
Set / get the ocean fetch.
Implements makVrv::DtEnvironmentInterface.
|
virtual |
Implements makVrv::DtEnvironmentInterface.
|
virtual |
Set / get the amount of chop on the sea.
Implements makVrv::DtEnvironmentInterface.
|
virtual |
Implements makVrv::DtEnvironmentInterface.
|
virtual |
Set / Get underwater visibility enabled.
Implements makVrv::DtEnvironmentInterface.
|
virtual |
Implements makVrv::DtEnvironmentInterface.
|
virtual |
Set / get the maximum visibility under water in meters.
Implements makVrv::DtEnvironmentInterface.
|
virtual |
Implements makVrv::DtEnvironmentInterface.
|
virtual |
Set / get the transparency value of water surface.
Implements makVrv::DtEnvironmentInterface.
|
virtual |
Implements makVrv::DtEnvironmentInterface.
|
virtual |
Set / Get the surge depth in distance.
Implements makVrv::DtEnvironmentInterface.
|
virtual |
Implements makVrv::DtEnvironmentInterface.
|
virtual |
Set / Get the depth offset in distance.
Implements makVrv::DtEnvironmentInterface.
|
virtual |
Implements makVrv::DtEnvironmentInterface.
|
virtual |
Set / get the ambient water temperature in celsius.
Implements makVrv::DtEnvironmentInterface.
|
virtual |
Implements makVrv::DtEnvironmentInterface.
|
virtual |
Set / get the speed of water currents in meters per second.
Implements makVrv::DtEnvironmentInterface.
|
virtual |
Implements makVrv::DtEnvironmentInterface.
|
virtual |
Set / get the direction of water currents in radians from north (clockwise).
Implements makVrv::DtEnvironmentInterface.
|
virtual |
Implements makVrv::DtEnvironmentInterface.
|
virtual |
Set / get the current tidal offset from mean-sea-level in meters.
Implements makVrv::DtEnvironmentInterface.
|
virtual |
Implements makVrv::DtEnvironmentInterface.
|
virtual |
Set / get the current direction of tidal flow (0=out, 1=in).
Implements makVrv::DtEnvironmentInterface.
|
virtual |
Implements makVrv::DtEnvironmentInterface.
Set / get the thermocline depths.
Implements makVrv::DtEnvironmentInterface.
Implements makVrv::DtEnvironmentInterface.
|
virtual |
Set / get the thermocline permeability.
Implements makVrv::DtEnvironmentInterface.
Implements makVrv::DtEnvironmentInterface.
|
virtual |
Set / get the ground snow accumulation depth.
Implements makVrv::DtEnvironmentInterface.
|
virtual |
Implements makVrv::DtEnvironmentInterface.
|
virtual |
Set / get the road snow accumulation depth.
Implements makVrv::DtEnvironmentInterface.
|
virtual |
Implements makVrv::DtEnvironmentInterface.
|
virtual |
Set / get the snow minimum elevation.
Implements makVrv::DtEnvironmentInterface.
|
virtual |
Implements makVrv::DtEnvironmentInterface.
|
virtual |
get/set the snow elevation transition which specifies how long it takes to go from no snow to the full snow depth.
Implements makVrv::DtEnvironmentInterface.
|
virtual |
Implements makVrv::DtEnvironmentInterface.
|
virtual |
Set / get the ground rain accumulation depth.
Implements makVrv::DtEnvironmentInterface.
|
virtual |
Implements makVrv::DtEnvironmentInterface.
|
virtual |
Get the current prevailing ambient light value Allows thing to be activated/deactivated by light level; values gp from 0.
(total darkness) to 1. (noon-day sun )
|
virtual |
Load default settings.
| [in] | loadOnlyFactorySettings | flag to load factory settings. |
Implements makVrv::DtEnvironmentInterface.
|
virtual |
Restores to backup settings from startup default.
Implements makVrv::DtEnvironmentInterface.
|
virtual |
Save the current settings as the default settings.
Implements makVrv::DtEnvironmentInterface.
|
virtual |
Import / export the list of named conditions (.enlx file)
Implements makVrv::DtEnvironmentInterface.
|
virtual |
Implements makVrv::DtEnvironmentInterface.
|
inline |
|
inline |
|
virtual |
Water visibility when below water.
|
virtual |
Returns whether we are currently over water.
This can't be implemented correctly until we have coastal boundaries. For now, we use the returned height of an terrain intersect call - sea level is water, anything higher is not. The isVisible flag allows for an optimization when Triton ocean is used. The optimization is used by default; the isVisible flag says that the query position is close enought to an observer so that a height map should be available for use. This is often the case when doing intersections involving objects/effects that are LOD's in/out; if the object is close enough to an observer to be of interest (a rotor wash or wake, say) then it can use the height map optimization. If you do not know if the query position is close to an observer, than set isVisible to false, in which case the terrain intersection method will be used.
|
virtual |
Returns maximum wave height just based on the sea state.
|
virtual |
Returns the current sea level.
|
virtual |
Set the current ocean manager which fulfills the DtOceanManagerInterface.
|
virtual |
Use to get rid of the current (usually default) ocean manager.
|
virtual |
Initialize environment settings (cloud cover and settings from default record)
|
protectedvirtual |
Pre-load all the cloud layers and send them to the sky object.
Clear all clouds
|
protectedvirtual |
|
protectedvirtual |
|
protectedvirtual |
|
protectedvirtual |
|
protectedvirtual |
|
protectedvirtual |
|
protectedvirtual |
Slots connected to the Sky Conditions Manager.
|
protectedvirtual |
|
protectedvirtual |
|
protectedvirtual |
|
protectedvirtual |
|
protectedvirtual |
|
protectedvirtual |
|
protectedvirtual |
Called when the current coordinate system changes.
Implements makVrv::DtEnvironmentInterface.
|
protectedvirtual |
Called by signal when an ocean layer is added.
Implements makVrv::DtEnvironmentInterface.
|
protectedvirtual |
Called by signal when an ocean layer is about to be removed.
Implements makVrv::DtEnvironmentInterface.
|
protectedvirtual |
Called by signal when an ocean layer's sea level changes.
Implements makVrv::DtEnvironmentInterface.
|
protectedvirtual |
Called by signal when an ocean layer's lod range (the altitude at which we LOD out dynamic ocean) changes.
Implements makVrv::DtEnvironmentInterface.
|
protectedvirtual |
Called by signal when the surge depth changes.
Implements makVrv::DtEnvironmentInterface.
|
protectedvirtual |
Called by signal when the depth offset changes.
Implements makVrv::DtEnvironmentInterface.
|
protectedvirtual |
Update the environment settings for the current environment.
|
protectedvirtual |
Initialize the (distributed) dynamic ocean object with the current environmental values.
|
protectedvirtual |
enables selected cloud cover
|
protectedvirtual |
|
protectedvirtual |
|
protectedvirtual |
Helper function to set the appropriate marine environment on a dynamic ocean object.
|
protectedvirtual |
Helper function to set the appropriate weather environment on a sky object.
|
protected |
|
protected |
|
protected |
|
protected |
|
protected |
|
protected |
|
protected |
|
protected |
|
protected |
|
protected |