Environmental Settings Profile
Environmental Settings Profiles store a variety of settings that affect how a scene is rendered. The main advantage of environmental settings profiles is that they make it easy to load presets into a camera. Use FxCamera to load and save profiles.
Properties
| Name | Type | Default | Access | Description |
|---|---|---|---|---|
atmIntensity | 1f | 1.0 | 🟩🟥 | Atmospheric scattering intensity |
atmMieColor | 1c | 0xFFFFFFFF | 🟩🟥 | Atmospheric scattering mie color |
atmMieDensity | 1f | 1.0 | 🟩🟥 | Atmospheric scattering mie density |
atmOzoneColor | 1c | 0xFF69FF6E | 🟩🟥 | Atmospheric scattering ozone color |
atmOzoneDensity | 1f | 1.0 | 🟩🟥 | Atmospheric scattering ozone density |
atmPhase | 1f | 1.0 | 🟩🟥 | Atmospheric scattering phase (aka MieG) |
atmRayleighColor | 1c | 0xFF2D68FF | 🟩🟥 | Atmospheric scattering rayleigh color |
atmRayleighDensity | 1f | 1.0 | 🟩🟥 | Atmospheric scattering rayleigh density |
bgColor | 1c | 0xff555555 | 🟩🟥 | Background color |
bgVisible | 1b | true | 🟩🟥 | Turn on background |
groundColor | 1c | 0xFF4444 | 🟩🟥 | Ground color |
groundHorizon | 1f | 0.4 | 🟩🟥 | Ground horizon size |
groundVisible | 1b | true | 🟩🟥 | Display ground |
iblBlur | 1f | 0.0 | 🟩🟥 | Image base lighting blur amount |
iblFile | 1s | "default" | 🟩🟥 | Image base lighting Cubemap FileID (no list, wildcard or filter) |
iblIntensity | 1f | 1.0 | 🟩🟥 | Image base lighting intensity |
iblRotation | i1 | 0 | 🟩🟥 | Image base lighting cubemap rotation angle in degrees |
skyMode | i1 | 0 | 🟩🟥 | SkyMode |
sunAzimuth | 1f | -110 | 🟩🟥 | Sun azimuth in degrees |
sunCastShadows | 1b | true | 🟩🟥 | Turn on shadows cast by sun |
sunColor | 1c | 0xffffffff | 🟩🟥 | Sunlight color |
sunDiskVisible | 1b | true | 🟩🟥 | Show sun disk |
sunDiskRadius | 1f | 10 | 🟩🟥 | Radius of the sun disk |
sunElevation | 1f | 50 | 🟩🟥 | Sun inclination in degrees |
sunIntensity | 1f | 0.5 | 🟩🟥 | Sunlight intensity |
unilightColor | 1c | 0xffffffff | 🟩🟥 | Uniform lighting color |
unilightIntensity | 1f | 0.5 | 🟩🟥 | Uniform lighting intensity |
Details
Type1b: boolean1c: color (integer)1i: integer1f: float1s: string2b: 2-component boolean vector2i: 2-component integer vector2f: 2-component float vector3b: 3-component boolean vector3i: 3-component integer vector3f: 3-component float vector
Access
🟩 : Property value can be read with FxFile.Get
🟥 : Property value can be changed with FxFile.Set
❌ : Property value is read-only and can't be changed
Create
To create a new environmental settings profile use FxFile.Create with FileType 557.
profileID = FxFile.Create(557);
profileID = FxFile.Rename(557, profileID, "MyProfile"); -- rename new profile
FxFile.Open(557, profileID); -- open new profileFiles
The global environmental settings profile is located at documents\Foxel\default.fxlenv. It saves the settings of the main editing viewport. Other custom profiles are saved as shared files in Shared\EnvironmentalSettings\ with the extension .fxlenv.