Documentation
Hey , first time here? You can find the installation guide and first run in the getting started section.
Take a deep breath and have a look at the user interface. At a glance, it may look a bit complex. It is due to many tweakable parameters and fancy names like Kelvins, radiance, and absorption that we use to standardize variable names.
Sun¶
Rotation
Horizontal and vertical movement of the sun.Allow to position sun in specific position creating feeling that it is a morning, midday or an evening.
Sun disk
Choose to see a physical sun disk in the sky.Disk can be removed in a specific edge cases when sun disk in renders appears too bright.
Sun lamp
Choose to use a sun lamp or sun disk in the world for illumination.Enabling this will ensure that there are sun shadows present in Eevee, as well as potentially help Cycles render quicker by requiring slightly fewer samples. Disabling this will mostly benefit Cycles renders, where the result will be more accurate with better matching reflections.
Angular diameter
The size of the sun disk.Affects shadow and lighting softness and the visual appearance of the sun disk.
Temperature K
Physical temperature (in Kelvins) of the sun changes the color of the sun disk.The bigger the value, the bluer the sun.
Intensity
Intensity of the binary sun emission.Higher intensity makes the sun brighter, thus illuminating the scene more.
Binary sun
Enables a second sun that is bound to the main sun.In a binary star system, there are two stars that orbit around a common center of mass.
Binary Sun¶
Distance
Distance from the main sun.More accurately the distance between the primary and binary sun.
Phase
The angle at which the binary sun is placed relative to the main sun.The phase angle is the angle formed between the two suns relative to the observer.
Angular diameter
The size of the binary sun disc.The angular diameter is the angle formed between two imaginary lines that extend from the observer's eye to opposite edges of the binary sun disc. Larger the angular diameter, less bright the sun disc will appear, and softer the shadows will form.
Temperature K
Physical temperature (in Kelvins) of the binary sun changes the color of the binary sun disk.The bigger the value, the bluer the sun.
Intensity
Intensity of the binary sun emission.Changes the binary sun radiance intensity in Watt·sr/m2.
Atmosphere¶
Density
Control how much atmosphere is present on the planet.For example, 0 is the vacuum of the space, but 1.22 kg/m3 is the atmosphere density for the Earth.
Scale Height
Determines how high the atmosphere goes in the scene, affecting density distribution.Mostly affects vertical transitions in the atmosphere, where lower scale heights will make effects of changing altitude appear quicker.
Intensity
Artistical control that affects how bright the atmosphere appears.Atmosphere intensity multiplier.
Night Intensity
Artistical control that affects how bright the atmosphere appears at night.Atmosphere intensity multiplier.
Color
Artistical control that gives a tint to the atmosphere particle.The tint or hue of the atmospheric particles, that are added to the scene, simulate the appearance of a realistic sky. This can include the color of the sky during different times of the day, such as blue during the day, orange and red during sunset, and dark blue or black during the night.
Inscattering
Control how much light is scattered through the particle for each wavelength (RGB).Atmosphere scattering coefficients.
Absorption
In real life situation, this should be an invert of inscattering value to give a physically accurate appearance.This control is exposed to give more artistic freedom.
Mie Scattering Intensity
Aura around the sun.Light scattering around the sun in the lower atmospheric layer.
Mie Scattering Anisotropy
How concentrated is the light scattering around the sun.It refers to the concentration of scattered light around the sun as viewed from a particular point in space. Mie scattering is a type of scattering that occurs when light interacts with particles that are of a larger size than the wavelength of the light.
Stars¶
Type
Use procedurally generated stars or image texture for the stars.Procedurally stars are generated using noise texture. When using image texture it is applied using equirectangular projection.
Radiance Intensity
Artistic control that affects how bright the stars are.Radiance intensity refers to the brightness of stars and can be adjusted for artistic effect or to simulate the actual brightness of stars in the night sky, allowing for the creation of different moods or atmospheres in a star field scene.
Radiance Gamma
How dense stars appear in the sky.Changes star brightness distribution curve.
Amount
Magnitude of stars in the night sky.Magnitude measures celestial object brightness, affected by luminosity, distance from Earth, and atmospheric absorption. Adjusting star objects brightness in PSA can simulate the night sky and represent relative brightness. How big of a % of the scene is filled with stars.
Scale
Global scale of the star texture.The bigger the scale the smaller the stars and more clustered together they appear. If the stars are too large or too sparse, or if they are too small or too dense, the scene may look unrealistic or cluttered.
Seed
Randomly redistributed star texture for different star configurations/placement.Different seed values can generate a new star texture with unique configurations and placements, where the seed value determines the starting point of randomization. In PSA, this technique allows for creating diverse star configurations and placements with the same texture and settings.
Temperature
How hot or bright the stars appear.Black body temperature is measured in kelvins. A "black body" absorbs all electromagnetic radiation, appearing black. They aid in understanding radiation and are used to measure temperature and energy standards in physics
Clouds¶
Type
Use procedurally generated clouds or image texture for the clouds.Clouds with PSA can be created using either procedurally generated algorithms or image texture-based methods. Procedural clouds offer greater control over the appearance and are quick to render, while image texture-based clouds can achieve a specific look or style but are limited by the chosen image or texture.
Seed
Randomly generated codes for different cloud configurations/placement.Procedural cloud generation uses algorithms that determine the cloud's shape, size, and density, but the same set of parameters will always produce the same cloud formation due to determinism. Use seed to create different variations.
Scale
Changes scale of the cloud noise texture.Changes the scale of the cloud texture
Thickness
Control how opaque clouds appear overall.Adjusting the thickness parameter can affect the appearance of clouds, making them more or less opaque by controlling how much light passes through. Thicker clouds block more light, appearing more opaque, while thinner clouds appear more transparent.
Detail
How detailed the clouds appear.The detail parameter adjusts the complexity of cloud texture, allowing the creation of clouds with varying levels of intricacy using noise textures. It controls the size of shapes and contrast between them.
Dimension
How dimensional the clouds appear to be (flat to rough).Adjust the amount of the detail level of the main texture. Smaller the dimension the more detailed the clouds will appear.
Lacunarity
The degree of spatial variability or patchiness of the cloud cover.Adjust the scales of the detail texture. Increasing lacunarity will increase the detail of the smaller clouds
Coverage
Control minimum and maximum of how much clouds are covering the sky.Adjust the coverage parameter to control the minimum and maximum coverage of clouds in the sky, allowing you to create various weather conditions and atmospheric effects, ranging from a completely clear sky to a sky that is completely covered by clouds.
Lighting Intensity
Artistic control that allows control over how much sunlight is affecting the clouds.Control cloud brightness and contrast, along with creating atmospheric effects using the lighting intensity parameter.
Self Shadowing
Control the amount of shadows forming on clouds.The self-shadowing parameter simulates light passing through and around the clouds, adding depth and realism to the scene. Directly influences how much the shadows the cloud casts against itself are expressed.
Directional Power
How much light is concentrated around the sun.This parameter adjusts the sun's effect on cloud appearance. A higher directional power focuses more light around the sun, making clouds brighter near it. Lower values distribute light more evenly across the sky for a less bright, diffuse appearance.
Inscattering
Control how much light is scattered through the particle for each wavelength (RGB).Cloud scattering coefficients.
Location
Cloud coordinate position offset.The location parameter moves clouds from their default position to create dynamic formations or achieve a specific visual effect.
Rotation
Cloud coordinate rotation offset.Rotation parameter rotates clouds around their center or pivot point. It's useful for creating dynamic cloud formations or visual effects.
Object Fog¶
Type
Chose manually or automatically to apply fog material node for every material in the scene.Manual allows to chose when fog material node is applied for materials. Auto applies fog material node whenever new material is added to an object.
Apply / Clear
Adds or removes fog material from every material in the scene.If user has manually disconnected fog node for material or relinked it in a different way we apply custom property
psa_user_modified
to object. This prevents our script from overriding user changes.
Ground¶
Color
Control the base color of the ground plane.Ground color/texture parameter controls the hue, saturation, and brightness of the ground plane, affecting the overall mood, lighting, and environment of the scene.
Ground
If enabled, creates an infinite ground plane. Makes the horizon visible.Enabling this option creates a continuous ground plane, useful for outdoor scenes, landscapes, and visible horizon.
Ground offset
Move the ground plane vertically by offset.Useful for low orbit and aerial shots.
Horizon offset
Move only horizon line up or down.Adjusting the horizon offset can change the horizon line position, affecting the scene's appearance. It creates the illusion of a higher or lower viewpoint, emphasizing specific elements and producing atmospheric effects.
Artistic Controls¶
Distance scalar
Control all distance values globally.This parameter adjusts the distance between objects in a scene, and is useful for large scenes. Decreasing it creates more distance and a spacious feel, while increasing it creates less distance and a crowded feel.
Falloff
Control how fast the atmospheric mist changes density.Atmospheric fog distance falloff curve.
Sun radiance gamma
Control how intense Sun color appears.Sun color gamma curve.