RenderableAtmosphere

Inherits Renderable

Members

Name	Documentation	Type	Description	Optional
AtmosphereHeight	The thickness of the atmosphere in km	Double	Value of type ‘Double’	No
GroundRadianceEmission	Multiplier of the ground radiance color during the rendering phase	Double	Value of type ‘Double’	No
Mie		Table	Table parameters	No
PlanetAverageGroundReflectance		Double	Value of type ‘Double’	No
PlanetRadius	The radius of the planet in meters	Double	Value of type ‘Double’	No
Rayleigh		Table	Table parameters	No
AtmosphereDimmingHeight	Percentage of the atmosphere where other objects, such as the stars, are faded	Double	Value of type ‘Double’	Yes
Debug		Table	Table parameters	Yes
LightSourceNode	This value is the name of a scene graph node that should be used as the source of illumination for the atmosphere. If this value is not specified, the solar system’s Sun is used instead	String	Value of type ‘String’	Yes
MieScatteringExtinctionPropCoefficient	Mie Scattering/Extinction Proportion Coefficient (%)	Double	Value of type ‘Double’	Yes
Ozone		Table	Table parameters	Yes
ShadowGroup	Declares shadow groups, meaning which nodes are considered in shadow calculations	Table	Table parameters	Yes
SunAngularSize	Specifies the angular size of the Sun in degrees	Double	In range: ( 0,180 )	Yes
SunIntensity	Unitless for now	Double	Value of type ‘Double’	Yes
SunsetAngle	The angle (degrees) between the Camera and the Sun where the sunset starts, and the atmosphere starts to fade in objects such as the stars	Vector2<double>	Value of type ‘Vector2’	Yes

Inherited members from Renderable

Name	Documentation	Type	Description	Optional
DimInAtmosphere	Enables/Disables if the object should be dimmed when the camera is in the sunny part of an atmosphere	Boolean	Value of type ‘Boolean’	Yes
Enabled	This setting determines whether this object will be visible or not	Boolean	Value of type ‘Boolean’	Yes
Opacity	This value determines the opacity of this renderable. A value of 0 means completely transparent	Double	In range: ( 0,1 )	Yes
RenderBinMode	This value specifies if the renderable should be rendered in the Background,Opaque, Pre/PostDeferredTransparency, or Overlay rendering step	String	In list { Background, Opaque, PreDeferredTransparent, PostDeferredTransparent, Overlay }	Yes
Tag	A single tag or a list of tags that this renderable will respond to when setting properties	Table, or String	Value of type ‘Table’, or Value of type ‘String’	Yes
Type	This tells the type of the renderable	String	Value of type ‘String’	Yes

Table parameters for Mie

• Optional: No

Name	Documentation	Type	Description	Optional
Coefficients		Table	Table parameters	No
G		Double	In range: ( -1,1 )	No
H_M		Double	Value of type ‘Double’	No

Table parameters for Coefficients

• Optional: No

Name	Documentation	Type	Description	Optional
Extinction		Vector3<double>	Value of type ‘Vector3’	No
Scattering		Vector3<double>	Value of type ‘Vector3’	No

Table parameters for Rayleigh

• Optional: No

Name	Documentation	Type	Description	Optional
Coefficients		Table	Table parameters	No
H_R		Double	Value of type ‘Double’	No

Table parameters for Coefficients

• Optional: No

Name	Documentation	Type	Description	Optional
Scattering		Vector3<double>	Value of type ‘Vector3’	No
Wavelengths		Vector3<double>	Value of type ‘Vector3’	No

Table parameters for Debug

• Optional: Yes

Name	Documentation	Type	Description	Optional
PreCalculatedTextureScale		Double	In range: ( 0,1 )	Yes
SaveCalculatedTextures		Boolean	Value of type ‘Boolean’	Yes

Table parameters for Ozone

• Optional: Yes

Name	Documentation	Type	Description	Optional
Coefficients		Table	Table parameters	Yes
H_O		Double	Value of type ‘Double’	Yes

Table parameters for Coefficients

• Optional: Yes

Name	Documentation	Type	Description	Optional
Extinction		Vector3<double>	Value of type ‘Vector3’	Yes

Table parameters for ShadowGroup

Declares shadow groups, meaning which nodes are considered in shadow calculations

• Optional: Yes

Name	Documentation	Type	Description	Optional
Casters	A list of objects that cast light on this atmosphere	Table	Table parameters	No
Sources	A list of light sources	Table	Table parameters	No

Table parameters for Casters

A list of objects that cast light on this atmosphere

• Optional: No

Name	Documentation	Type	Description	Optional
*	Individual shadow casters	Table	Table parameters	Yes

Table parameters for *

Individual shadow casters

• Optional: Yes

Name	Documentation	Type	Description	Optional
Name	The scene graph node name of the source	String	Value of type ‘String’	No
Radius	The radius of the object in meters	Double	Value of type ‘Double’	No

Table parameters for Sources

A list of light sources

• Optional: No

Name	Documentation	Type	Description	Optional
*	Individual light sources	Table	Table parameters	Yes

Table parameters for *

Individual light sources

• Optional: Yes

Name	Documentation	Type	Description	Optional
Name	The scene graph node name of the source	String	Value of type ‘String’	No
Radius	The radius of the object in meters	Double	Value of type ‘Double’	No

Asset Examples

local transforms = asset.require("./titan")



local Atmosphere = {
  Identifier = "TitanAtmosphere",
  Parent = transforms.Titan.Identifier,
  Renderable = {
    Type = "RenderableAtmosphere",
    -- Atmosphere radius in Km
    AtmosphereHeight = 2666.0 - 2576.0,
    PlanetRadius = 2576.0,
    PlanetAverageGroundReflectance = 0.1,
    GroundRadianceEmission = 0.9,
    SunIntensity = 6.9,
    Rayleigh = {
      Coefficients = {
        -- Wavelengths are given in 10^-9m
        Wavelengths = { 680, 550, 440 },
        -- Reflection coefficients are given in km^-1
        Scattering = { 0.005349578367831898, 0.01265595939366191, 0.03133178295339324 }
      },
      -- Thickness of atmosphere if its density were uniform, in Km
      H_R = 20.0
    },
    Mie = {
        Coefficients = {
          -- Reflection coefficients are given in km^-1
          Scattering = { 0.005, 0.012, 0.08 },
          -- Extinction coefficients are a fraction of the Mie coefficients
          Extinction = { 0.004 / 0.37, 0.004 / 0.37, 0.004 / 0.37 }
        },
        -- Height scale (atmosphere thickness for constant density) in km
        H_M = 14.85,
        -- Mie Phase Function Value
        -- (G e [-1.0, 1.0]. If G = 1.0, Mie phase function = Rayleigh Phase Function)
        G = -0.52
    },
    Debug = {
        PreCalculatedTextureScale = 1.0,
        SaveCalculatedTextures = false
    }
  },
  GUI = {
    Name = "Titan Atmosphere",
    Path = "/Solar System/Planets/Saturn/Major Moons/Titan"
  }
}


asset.onInitialize(function()
  openspace.addSceneGraphNode(Atmosphere)
end)

asset.onDeinitialize(function()
  openspace.removeSceneGraphNode(Atmosphere)
end)

asset.export(Atmosphere)



asset.meta = {
  Name = "Titan Atmosphere",
  Version = "1.1",
  Description = "RenderableAtmosphere for Titan",
  Author = "OpenSpace Team",
  URL = "http://openspaceproject.com",
  License = "MIT license"
}